百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 编程字典 > 正文

手把手教你最简单方式开发属于自己的代码生成工具不依赖模板引擎

toyiye 2024-06-21 12:18 10 浏览 0 评论

概述

有个玩笑说:“程序员的键盘只要CTL+C和CTL+V就够了”。

可见程序员工作中大部分的是重复的工作,对于重复且有规律的工作任务,我们应该想办法让代码去代替我们做。

一个合格的程序员,应该具备简化自己工作任务的能力,程序员的大部分时间应该是在研究技术提升技术,而不是整天做复制粘贴的码农工作。

今天以Java语言为例手把手教你开发一款属于自己的代码生成工具,实现以代码写代码。

需求分析

  1. 能满足各种需求场景
  2. 添加新需求尽可能操作简单
  3. 不依赖第三方jar包

设计

我们知道一般的代码生成工具都是会定义模版,然后通过模版引擎及上下文变量来生成最终的代码。所以我们的代码生成工具也将采用模版的方式生成代码。

  1. 模版设计

为了能满足多种需求场景的代码生成,及添加新需求尽可能操作简单,模版采用最简单的文本格式即常用的txt格式,通过添加不同的模版文件来实现增加新的需求

  1. 模版引擎设计

通过Java中String类的replace和replaceAll方法,实现对模版文件中变量的填充。

代码编写

以复制如下代码用于Role为例,可以看出该业务是对用户表进行分页查询的操作。当业务需求需要增加新的表时,对于新的表也需要分页查询,传统的做法是自己实现这段逻辑,这样使得代码实现样式不统一,同时每次都重新实现增加了更多的人的操作,也是的代码的错误几率增加。更好的方法是复制成熟经过产线验证的代码过来替换其中的参数为新的表即可。而这样的工作交给程序来做非常合适。

/**
 * 列表页面数据
 * @return 数据 JSON
 * @author tech-farmer 2021-11-10 14:51:12
 */
@RequestMapping(value = "/list",method = RequestMethod.POST)
@ResponseBody
public String list(PageDTO pageDTO,@FormModel("condition") User user){
    userService.listForPage(pageDTO,user);
    return JSON.toJSONString(pageDTO);
}

1. 将成熟的代码片段制成模版文件

在项目templates目录下添加模本文件testTemplate.txt,将上面的成熟代码片段拷贝到模版文件中,使用变量(形如“${var}”)替换代码片段中的参数值即可,文件内容如下:

/**
 * 列表页面数据
 * @return 数据 JSON
 * @author ${author} ${createTime}
 */
@RequestMapping(value = "/list",method = RequestMethod.POST)
@ResponseBody
public String list(PageDTO pageDTO,@FormModel("condition") ${bigEntityName} ${littleEntityName}){
    ${littleEntityName}Service.listForPage(pageDTO,${littleEntityName});
    return JSON.toJSONString(pageDTO);
}

2. 编写简单的模版引擎处理

模版引擎主要逻辑在于获取上下文中的变量值,动态填充模版中的变量,然后将填充后的代码输出。

完整代码如下:

public static void main(String[] args) throws Exception {
    Map<String,String> context = new HashMap<>();
    context.put("littleEntityName","role");
    context.put("bigEntityName","Role");
    context.put("author","tech-farmer");
    context.put("createTime",new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()));
    generateCode(context);
}

private static void generateCode(Map<String, String> context) throws Exception {
    File dir = new File(TestGenerator.class.getClassLoader().getResource("templates").getPath());
    if(!dir.exists() || !dir.isDirectory() || Objects.requireNonNull(dir.listFiles()).length <=0){
        throw new RuntimeException("没有找到templates文件夹,无法生成代码");
    }
    String str;
    for (File file : dir.listFiles()) {
        System.out.println(file.getName() + " start ===========================================================================");
        try(final FileReader in = new FileReader(file);
            final BufferedReader bufferedReader = new BufferedReader(in);){
            while ((str = bufferedReader.readLine()) != null){
                for (Map.Entry<String, String> entry : context.entrySet()) {
                    str = str.replaceAll("\\$\\{\\s*"+entry.getKey().replace(".","\\.")+"\\s*\\}",entry.getValue());
                }
                System.out.println(str);
            }
        }
        System.out.println(file.getName() + " end ===========================================================================");
    }
}

运行效果

完整控制台输出如下:

"D:\Program Files\Java\jdk1.8.0_212\bin\java.exe" -agentlib:jdwp=transport=dt_socket,address=127.0.0.1:60907,suspend=y,server=n -javaagent:C:\Users\dong.chengsong\.IntelliJIdea2019.2\system\captureAgent\debugger-agent.jar -Dfile.encoding=UTF-8 -classpath "D:\Program Files\Java\jdk1.8.0_212\jre\lib\charsets.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\deploy.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\ext\access-bridge-64.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\ext\cldrdata.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\ext\dnsns.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\ext\jaccess.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\ext\jfxrt.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\ext\localedata.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\ext\nashorn.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\ext\sunec.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\ext\sunjce_provider.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\ext\sunmscapi.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\ext\sunpkcs11.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\ext\zipfs.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\javaws.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\jce.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\jfr.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\jfxswt.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\jsse.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\management-agent.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\plugin.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\resources.jar;D:\Program Files\Java\jdk1.8.0_212\jre\lib\rt.jar;D:\workspace\farmer-generator\target\classes;D:\maven\repository\org\mybatis\generator\mybatis-generator-maven-plugin\1.3.6\mybatis-generator-maven-plugin-1.3.6.jar;D:\maven\repository\org\apache\maven\maven-plugin-api\3.5.0\maven-plugin-api-3.5.0.jar;D:\maven\repository\org\apache\maven\maven-model\3.5.0\maven-model-3.5.0.jar;D:\maven\repository\org\codehaus\plexus\plexus-utils\3.0.24\plexus-utils-3.0.24.jar;D:\maven\repository\org\apache\commons\commons-lang3\3.5\commons-lang3-3.5.jar;D:\maven\repository\org\apache\maven\maven-artifact\3.5.0\maven-artifact-3.5.0.jar;D:\maven\repository\org\eclipse\sisu\org.eclipse.sisu.plexus\0.3.3\org.eclipse.sisu.plexus-0.3.3.jar;D:\maven\repository\javax\enterprise\cdi-api\1.0\cdi-api-1.0.jar;D:\maven\repository\javax\annotation\jsr250-api\1.0\jsr250-api-1.0.jar;D:\maven\repository\javax\inject\javax.inject\1\javax.inject-1.jar;D:\maven\repository\org\eclipse\sisu\org.eclipse.sisu.inject\0.3.3\org.eclipse.sisu.inject-0.3.3.jar;D:\maven\repository\org\codehaus\plexus\plexus-component-annotations\1.5.5\plexus-component-annotations-1.5.5.jar;D:\maven\repository\org\codehaus\plexus\plexus-classworlds\2.5.2\plexus-classworlds-2.5.2.jar;D:\maven\repository\org\mybatis\generator\mybatis-generator-core\1.3.6\mybatis-generator-core-1.3.6.jar;D:\maven\repository\org\slf4j\slf4j-api\1.7.32\slf4j-api-1.7.32.jar;D:\maven\repository\mysql\mysql-connector-java\5.1.49\mysql-connector-java-5.1.49.jar;D:\maven\repository\org\jsoup\jsoup\1.11.3\jsoup-1.11.3.jar;D:\Program Files\JetBrains\IntelliJ IDEA 2019.2.1\lib\idea_rt.jar" com.farmer.TestGenerator
Connected to the target VM, address: '127.0.0.1:60907', transport: 'socket'
testTemplate.txt start ===========================================================================
/**
 * 列表页面数据
 * @return 数据 JSON
 * @author tech-farmer 2021-11-10 15:19:32
 */
@RequestMapping(value = "/list",method = RequestMethod.POST)
@ResponseBody
public String list(PageDTO pageDTO,@FormModel("condition") Role role){
    roleService.listForPage(pageDTO,role);
    return JSON.toJSONString(pageDTO);
}
testTemplate.txt end ===========================================================================
Disconnected from the target VM, address: '127.0.0.1:60907', transport: 'socket'

Process finished with exit code 0

总结

代码量不是很大,但思路很重要,最简单的代码生成工具是不是很简单!做个小节。

  1. 可以创建新的模版适应新的业务
  2. 模版可以是完整的类
  3. 模版可以用来生成html前端页面
  4. 模版可以用来生成其他程序语言代码

相关推荐

为何越来越多的编程语言使用JSON(为什么编程)

JSON是JavascriptObjectNotation的缩写,意思是Javascript对象表示法,是一种易于人类阅读和对编程友好的文本数据传递方法,是JavaScript语言规范定义的一个子...

何时在数据库中使用 JSON(数据库用json格式存储)

在本文中,您将了解何时应考虑将JSON数据类型添加到表中以及何时应避免使用它们。每天?分享?最新?软件?开发?,Devops,敏捷?,测试?以及?项目?管理?最新?,最热门?的?文章?,每天?花?...

MySQL 从零开始:05 数据类型(mysql数据类型有哪些,并举例)

前面的讲解中已经接触到了表的创建,表的创建是对字段的声明,比如:上述语句声明了字段的名称、类型、所占空间、默认值和是否可以为空等信息。其中的int、varchar、char和decimal都...

JSON对象花样进阶(json格式对象)

一、引言在现代Web开发中,JSON(JavaScriptObjectNotation)已经成为数据交换的标准格式。无论是从前端向后端发送数据,还是从后端接收数据,JSON都是不可或缺的一部分。...

深入理解 JSON 和 Form-data(json和formdata提交区别)

在讨论现代网络开发与API设计的语境下,理解客户端和服务器间如何有效且可靠地交换数据变得尤为关键。这里,特别值得关注的是两种主流数据格式:...

JSON 语法(json 语法 priority)

JSON语法是JavaScript语法的子集。JSON语法规则JSON语法是JavaScript对象表示法语法的子集。数据在名称/值对中数据由逗号分隔花括号保存对象方括号保存数组JS...

JSON语法详解(json的语法规则)

JSON语法规则JSON语法是JavaScript对象表示法语法的子集。数据在名称/值对中数据由逗号分隔大括号保存对象中括号保存数组注意:json的key是字符串,且必须是双引号,不能是单引号...

MySQL JSON数据类型操作(mysql的json)

概述mysql自5.7.8版本开始,就支持了json结构的数据存储和查询,这表明了mysql也在不断的学习和增加nosql数据库的有点。但mysql毕竟是关系型数据库,在处理json这种非结构化的数据...

JSON的数据模式(json数据格式示例)

像XML模式一样,JSON数据格式也有Schema,这是一个基于JSON格式的规范。JSON模式也以JSON格式编写。它用于验证JSON数据。JSON模式示例以下代码显示了基本的JSON模式。{"...

前端学习——JSON格式详解(后端json格式)

JSON(JavaScriptObjectNotation)是一种轻量级的数据交换格式。易于人阅读和编写。同时也易于机器解析和生成。它基于JavaScriptProgrammingLa...

什么是 JSON:详解 JSON 及其优势(什么叫json)

现在程序员还有谁不知道JSON吗?无论对于前端还是后端,JSON都是一种常见的数据格式。那么JSON到底是什么呢?JSON的定义...

PostgreSQL JSON 类型:处理结构化数据

PostgreSQL提供JSON类型,以存储结构化数据。JSON是一种开放的数据格式,可用于存储各种类型的值。什么是JSON类型?JSON类型表示JSON(JavaScriptO...

JavaScript:JSON、三种包装类(javascript 包)

JOSN:我们希望可以将一个对象在不同的语言中进行传递,以达到通信的目的,最佳方式就是将一个对象转换为字符串的形式JSON(JavaScriptObjectNotation)-JS的对象表示法...

Python数据分析 只要1分钟 教你玩转JSON 全程干货

Json简介:Json,全名JavaScriptObjectNotation,JSON(JavaScriptObjectNotation(记号、标记))是一种轻量级的数据交换格式。它基于J...

比较一下JSON与XML两种数据格式?(json和xml哪个好)

JSON(JavaScriptObjectNotation)和XML(eXtensibleMarkupLanguage)是在日常开发中比较常用的两种数据格式,它们主要的作用就是用来进行数据的传...

取消回复欢迎 发表评论:

请填写验证码