基于FreeMarker的框架脚手架生成组件，可以轻松快速实现对框架代码的一键创建（例如业务部门实现对基础架构部提供的框架快速搭建），实现对Spring Cloud的脚手架一键生成
1. 严格遵照Maven结构进行脚手架编排
2. 支持任何文件文件的逆向创建，包括Java类文件，配置文件，脚本文件，XML文件，YAML文件等
3. 使用者只需要关注模板原型文件的编辑（遵循FreeMarker语法），并设置动态变量
4. 使用者根据模板原型文件创建Generator类，进行动态创建和替换
5. 基于Spring Cloud的调用，Spring Cloud中国社区的spring-cloud-codegen将采用本框架，参考https://github.com/SpringCloud/spring-cloud-codegen
1. skeleton-data.properties
用来描述模板文件的全局配置值，里面的值替换模板文件里的动态变量(用${}表示)
2. skeleton-description.properties
用来描述模skeleton-data.properties里面，每个Key对应的中文名。里面的值前缀可以如下特殊符号，用来渲染界面上每个组件的Label，
<*> - 标识为高亮项，一般组件渲染成高亮方式，例如Label红色字体，提示使用者着重关注
<#> - 标识为默认项，一般组件渲染成默认项方式，提示使用者可以不修改对应值
<^> - 标识为留空项，一般组件渲染成留空项方式，提示使用者对应值可以为空
<$> - 标识为不可编辑项，一般组件渲染成不可编辑项方式，如果false则把组件灰掉，提示使用者对应值不可编辑
3. skeleton-item-list.properties
用来描述模skeleton-data.properties里面，对应项如果是下来菜单方式的时候，里面的值列表，通过“;”分隔，例如版本号，1.0.0;1.0.1;1.0.2，可让使用者选取
1. 下载脚手架Zip文件的接口，返回Zip文件的byte数组方式
@RequestMapping(value = "/download", method = RequestMethod.POST)
public byte[] download(@RequestBody String config)
在Postman上对http://localhost:2222/download进行POST调用，Body的内容为src\main\resources\config\skeleton-data.properties，如图1，将返回一键创建后的zip文件的byte数组格式
1. 根据配置文件进行界面驱动的元数据接口
@RequestMapping(value = "/getMetaData", method = RequestMethod.GET)
public Map<String, SkeletonGroup> getMetaData()
在Postman上对http://localhost:2222/getMetaData进行GET调用，如图2，将返回JSON格式的文件，简单介绍一下格式：
{
"key": "moduleName", // 组件所对应的唯一Key
"label": "【必改项】工程的模块名，首字母必须小写，中间只允许出现“-”", // 组件的标签
"value": "payment-ccb", // 组件内容
"type": "TEXTFIELD", // 组件类型，包括TEXTFIELD，CHECKBOX，COMBOBOX
"options": null, // 对应项如果是下来菜单方式的时候，里面的值列表，可以为null
"highlightable": true, // 渲染成高亮方式
"defaultable": false, // 渲染成默认项方式
"emptiable": false, // 渲染成留空项方式
"editable": true // 渲染成不可编辑项方式
},
图1
图2
模板文件示例，用${}表示为动态变量
package ${package};
/**
* <p>Title: ${title}</p>
* <p>Description: ${description}</p>
* <p>Copyright: ${copyright}</p>
* <p>Company: ${company}</p>
* @author ${author}
* @email ${email}
* @version ${version}
*/
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.context.annotation.ComponentScan;
import ${MyContextAwareClassPath};
import ${MyServiceClassPath};
@EnableAutoConfiguration
@ComponentScan(basePackages = { "com.nepxion.matrix.test.simple" })
public class MyApplication {
public static void main(String[] args) throws Exception {
SpringApplication.run(MyApplication.class, args);
MyService1 myService = MyContextAware.getBean(MyService.class);
myService1.doA("A");
myService1.doB("B");
}
}Generator类示例
package com.nepxion.skeleton.demo.server.java;
/**
* <p>Title: Nepxion Skeleton Generator</p>
* <p>Description: Nepxion Skeleton Generator For Freemarker</p>
* <p>Copyright: Copyright (c) 2017</p>
* <p>Company: Nepxion</p>
* @author Haojun Ren
* @email [email protected]
* @version 1.0
*/
import java.util.Map;
import com.nepxion.skeleton.constant.SkeletonConstant;
import com.nepxion.skeleton.generator.SkeletonJavaGenerator;
import com.nepxion.skeleton.property.SkeletonProperties;
public class MyApplicationClassGenerator extends SkeletonJavaGenerator {
/**
* 构造方法
* @param generatePath 创建文件的顶级路径
* @param projectType 工程类型
* @param skeletonProperties 全局配置文件对象
*/
public MyApplicationClassGenerator(String generatePath, String projectType, SkeletonProperties skeletonProperties) {
super(generatePath, projectType, MyApplicationClassGenerator.class, skeletonProperties);
}
/**
* 构造方法
* @param generatePath 创建文件的顶级路径
* @param projectType 工程类型
* @param baseTemplatePath 模板文件的等级路径
* @param skeletonProperties 全局配置文件对象
*/
public MyApplicationClassGenerator(String generatePath, String projectType, String baseTemplatePath, SkeletonProperties skeletonProperties) {
super(generatePath, projectType, baseTemplatePath, skeletonProperties);
}
/**
* 设置Java类的包路径，如果没特殊处理，则按照默认顶级包路径来处理，不需要Override该方法
*/
/*@Override
protected String getPackage() {
return super.getPackage() + "." + "abc";
}*/
/**
* 设置Java类名
*/
@Override
protected String getClassName() {
return "MyApplication";
}
/**
* 设置模板名
*/
@Override
protected String getTemplateName() {
return "MyApplication.java.template";
}
/**
* 设置Java类的输出路径，如果没特殊处理，则按照默认输出路径来处理，不需要Override该方法
*/
/*@Override
protected String getOutputPath() {
return super.getOutputPath() + "/" + "xyz";
}*/
/**
* 设置Java类到main目录下，还是在test目录下
*/
@Override
protected boolean isMainCode() {
return true;
}
/**
* 设置Java类创建的所依赖数据模型，主要做动态变量到原型模板的替换（任何文本的替换都支持）
*/
@Override
protected Object getDataModel() {
Map<String, Object> dataModel = generateDataModel();
// 注意：根据freemarker的规范，dataModel中的key似乎只能支持字母和数字，不支持符号，例如MyContextAware.ClassPath，MyContextAware-ClassPath都会抛错
dataModel.put(SkeletonConstant.PACKAGE, getPackage());
dataModel.put("MyContextAwareClassPath", "com.nepxion.matrix.test.simple.context.MyContextAware");
dataModel.put("MyServiceClassPath", "com.nepxion.matrix.test.simple.service.MyService");
return dataModel;
}
}Generator类示例 配置全局配置文件skeleton-data.properties
# 工程的模块名，首字母必须小写，中间只允许出现“-”
# moduleName=payment
moduleName=payment-ccb
# 上层包路径，该路径会作为所有Java代码的上层路径。moduleName、basePackage和projectType三者组合起来解析出相关目录和结构规则，例如moduleName=payment-ccb，basePackage=com.nepxion，projectType=server，那么工程名为payment-ccb-server，类路径为com.nepxion.payment.ccb.server
basePackage=com.nepxion
# 类信息-标题
title=Nepxion Skeleton Generator
# 类信息-描述
description=Nepxion Skeleton Generator For Freemarker
# 类信息-版权信息
copyright=Copyright (c) 2017
# 类信息-公司
company=Nepxion
# 类信息-作者
author=Haojun Ren
# 类信息-作者邮箱
email=1394997@qq.com
# 类信息-版本
version=1.0运行程序
package com.nepxion.skeleton.demo;
/**
* <p>Title: Nepxion Skeleton Generator</p>
* <p>Description: Nepxion Skeleton Generator For Freemarker</p>
* <p>Copyright: Copyright (c) 2017</p>
* <p>Company: Nepxion</p>
* @author Haojun Ren
* @email [email protected]
* @version 1.0
*/
import com.nepxion.skeleton.property.SkeletonProperties;
import com.nepxion.skeleton.server.java.MyApplicationClassGenerator;
import com.nepxion.skeleton.service.resources.MybatisGeneratorXmlGenerator;
public class MyGenerator1 {
public static void main(String[] args) {
try {
// 创建文件的输出的路径
String generatePath = "E:/Download/Skeleton/";
// 描述规则的配置文件所在的路径
String propertiesPath = "config/skeleton-data.properties";
// 构造全局配置文件对象
SkeletonProperties skeletonProperties = new SkeletonProperties(propertiesPath);
// 创建Java类文件
// 模板文件MyApplication.java.template必须和MyApplicationClassGenerator放在同一个目录下
new MyApplicationClassGenerator(generatePath, "server", skeletonProperties).generate();
// 创建文件到resources目录下
// 模板文件mybatis-generator.xml.template必须和MybatisGeneratorXmlGenerator放在同一个目录下
new MybatisGeneratorXmlGenerator(generatePath, "service", skeletonProperties).generate();
} catch (Exception e) {
e.printStackTrace();
}
}
}