什么是样板代码?

样板代码是计算机语言文本,您可以在几种不同的上下文中进行少量修改或根本无需修改即可重复使用。该术语起源于文档管理,在这种管理中,您可以重复使用文档模板或样板,只需对不同的情况进行最少的更改。例如,律师使用可以为不同行业的客户快速定制的合同样板。同样,软件开发人员重复使用样板代码,只需对各种程序模块进行少量更改。对于某些现代编程语言,您可以通过将样板代码封装在函数、类和其他编程结构中最大限度地减少样板代码。

样板代码有哪些优点?

样板代码的范围从简单的定义到执行特定任务的软件函数。在开发应用程序时,程序员可能编写不必要重复的代码。开发人员使用样板代码来提高编程效率,同时确保软件质量。

接下来,我们将分享样板代码的几个优点。适当地使用样板代码时,它们可以起到很大的帮助作用。

启用代码可重用性

样板代码对于可重复使用的编程非常有用,开发人员可以在他们创建的后续模块中应用以前编写的代码。在编程时,开发人员可以识别看似重复的代码并将其转化为样板。他们不是从头开始编写整个源代码,而是根据需要随时复制和粘贴样板代码。 

提供适用的解决方案

样板代码为开发人员在编写自己不熟悉的软件函数时提供参考。按照惯例,开发人员需要从头开始编写整个代码并测试其是否有效。现在情况已有所变化。

例如,在启动 Web 开发项目时,可以将样板用于网页。您不必重新创建任何网页所需的基本 HTML 结构。

允许知识共享

开发人员在执行软件测试和质量检查时不断改进其代码。他们可以使用样板来整合这些改进。

例如,每当程序员发现样板代码中的错误时,他们都可以进行改进并记录样板中的更改。这样,每位应用可重复使用代码的程序员都将从优化中受益。 

提高代码质量

样板代码降低编码错误的风险并提高软件质量。使用样板代码时,您可以借助经过全面测试的代码启用软件功能。只需编写几行代码即可为软件添加自定义或次要功能。

此外,使用编程样板可以帮助软件团队在源代码中保持正确的编码标准和一致的编程语言风格。  

缩短编码时间

编程样板无需不必要地重复代码,从而简化软件开发过程。借助可重复使用的代码,即使是新手开发人员也可以快速启动类似的项目,而无需经历复杂的学习过程。他们可以插入和使用样板,只需很少改动或根本不做任何改动,即可添加通常需要更长时间才能构建的软件函数。 

样板代码有哪些示例?

样板是指在许多编程语言和应用程序中可用于提高编码效率和质量的代码部分。接下来我们将分享几个示例。

类声明

样板在面向对象编程(OOP)和用类表示对象的混合语言中很常见。

考虑以下代码片段。getNamesetName 都是样板代码,开发人员无需重写代码即可在多个 Customer 类声明中调用这些代码:

public class Customer{

private String name; 

   

  public String getName() {

     return name;

  }

  public void setName(String name) {

     this.name = name;

  }

   }

函数封装

还可以使用样板来封装应用程序中经常重复的软件功能。

例如,以下代码片段显示了可重复使用的代码,开发人员可以调用该代码来打开和读取文件。开发人员可以复制并粘贴整个代码,以及添加自己的代码来处理提取的信息:

try (BufferedReader reader = new BufferedReader(new FileReader(fileName))) {

    String text;

    while (Objects.nonNull(text = reader.readLine())) {

      // insert code to process read info

    

    }

} catch (IOException e) {

  String message = String.format(“read file(%s) exception”, fileName);

log.error(message, e);

  throw new ExampleException(message, e);

}

网页模板

Web 开发人员使用样板作为模板来构建网页。通常,样板包括开发人员可以修改的元声明、默认配置和标签。

以下样板代码是开发人员可能用来创建空白网页的示例:

<!DOCTYPE html>

<html lang="en">

 <head>

   <meta charset="UTF-8">

     <meta name="viewport" content="width=device-width, initial-scale=1.0">

     <meta http-equiv="X-UA-Compatible" content="ie=edge">

     <title>Webpage Title</title>

     <link rel="stylesheet" href="style.css">

 </head>

 <body>

<script src="index.js"></script>

 </body>

</html>

数据库管理

大多数应用程序在数据库中存储和处理数据。开发人员使用类似于以下代码片段的样板来简化用于数据库连接和数据查询的代码。他们可以在标准化代码结构中填充自定义的数据管理函数,这些函数可以在整个应用程序中重复使用。 举个例子:

public class Database { 

private Connection conn; 

public void connect() { 

// insert codes for database connection

public void disconnect() { 

// insert codes for database disconnection

public ResultSet runQuery(String query) 

// insert codes to run a query

return null; 

}

}

何时以及如何使用样板代码?

由于其多功能性,开发人员可以在各种类型和规模的项目中使用样板。接下来,我们将讨论一些可以从样板代码中受益的场景。

支架

支架是指将样板代码用于不涉及复杂软件组件抽象或集成的基本情况。

在较小的项目中,脚手架提供基本结构,因此开发人员可以专注于纳入新功能和业务逻辑。借助支架,开发人员可使用几乎所有的代码来创建软件或 Web 应用程序,而只需进行最少量的修改。

代码共享

一些开发人员构建样板代码并与开发社区共享。他们提供可下载的样板,并鼓励讨论以改进底层代码。

与此同时,一些组织创建自己的样板来支持大规模开发。这些样板代码更为复杂,并且具有以下要求:

  • 由有据可查的代码组成,因此开发人员可以轻松地重复使用它们
  • 遵守标准编码实践和结构以保持一致性
  • 提供用于在源代码中设置、原型设计和测试样板使用情况的工具
  • 包括支持第三方集成的 API 模块
  • 在协作环境中扩展

代码一致性

对于何时创建样板并在代码中使用它们,并没有严格的规则。但是,如果您在应用程序中多次编写相同的函数代码,则最好将它们转换为样板。

使用样板时,您可以一致地复制软件功能,同时降低犯下编码错误的风险。下面是一些示例:

  • 程序员使用样板在源文件顶部插入类似的前导声明
  • 新手程序员在相应项目和类似项目中使用经过现场验证的样板作为示例,他们稍后会对其进行修改
  • 开发人员使用样板调用 Java 类中封装的软件函数,而不是出于类似目的编写重复的代码

何时不应该使用样板代码?

虽然样板代码有助于优化软件开发过程,但在某些情况下,替代方法会更合适。

样板不应取代函数

不应使用样板来代替软件函数。如果程序员尽管应用样板,但仍必须编写大量代码,那么最好编写原始函数。同样,如果您发现自己对样板结构进行大量修改,那么创建软件函数是更合适的选择。 

样板不应取代框架

框架是可重复使用的软件组件的集合,能提高新应用程序的开发效率。如果您需要包含项目需求所需的所有技术堆栈的现成结构,请使用框架而非样板。框架可以让您标准化整个项目。

相比之下,样板代码在简化代码部分方面更有帮助。例如,Web 设计人员可以使用样板代码来提供简单的 PHP 函数。他们还可以使用框架将内容添加到随时可以发布的网站中。

阅读有关框架的信息 »

样板不应增加代码的复杂性

将样板用于软件函数时,请注意代码的重复。太多的重复会导致代码占用空间过大。

例如,假设您使用相同的代码副本,多次向外部服务发出 API 调用。相反,将重复内容提取到新的过程调用中可以更好地改善代码维护并减小应用程序的规模。 

同样,有些项目在采用技术变革时需要更加敏捷。样板代码可能不支持超出其构建目的之外的要求。在这种情况下,最好从头开始开发软件组件或使用提供的框架。 

AWS 如何支持您的样板代码要求?

云端普及了应用程序开发。通过 Amazon Web Services(AWS)等提供商,您可以按需访问基础设施资源。但是,构建软件应用程序的传统过程仍然要求开发人员花时间编写代码的样板部分。并且,这些部分与开发人员想要解决的核心问题没有直接关系。

即使是最有经验的开发人员也发现很难跟上多种编程语言、框架和软件库的发展步伐。并且,他们必须遵循正确的编程语法和最佳编码实践。因此,开发人员可能花费大量时间从网络上搜索和自定义代码片段。 

Amazon Q Developer 帮助开发人员和 IT 专业人员完成整个软件开发生命周期中的所有任务——从编码、测试和升级,到故障排除、执行安全扫描和修复、优化 AWS 资源以及创建数据工程管道。

立即创建账户,开始在 AWS 上进行人工智能支持的编码。

AWS 上的后续步骤

查看其他与产品相关的资源
查看开发人员工具服务 
注册免费账户

立即享受 AWS 免费套餐。

注册 
开始在控制台中构建

在 AWS 管理控制台中开始构建。

登录