• 最新稳定版本: v1.0
• 使用文档详见官网，点击跳转使用手册

Once架构是一套后端应用的顶层架构，架构本身只约束了工程结构和开发过程，对后端应用的基础技术无任何改造和深度封装。

Once架构关注的是开发效率和维护成本，保证业务开发人员以近似千人一面的方式完成业务功能的开发。

Once架构是具备成长性的，A项目积累下来的模块代码，可以直接使用在B项目中，实现项目复利。

虽然Once架构提倡代码生成，但是，在排查错误时，仍然建议从代码本身找出出错原因，再重新生成正确的代码。

此架构是一种顶层架构，架构本身只约束了工程结构和开发过程，对基础技术无任何改造和深度封装。

架构中采用的基础技术如下：

• 开发语言：Java(JDK8或以上)
• 基础框架：SpringBoot 2.2.0.M5
• 项目自动构建工具：Gradle 5.6
• Tomcat版本：8.5以上

其中，由于Once架构只是一种规则，基础技术甚至是开发语言都是可以替换的，可联系官方打造个性化架构。

在使用Once架构前，请学习SpringBoot、Java程序、Http请求等相关知识。

Once架构只是一种规则，实际上还是一个SpringBoot工程，要想真正使用起来、或者排查一些错误，还是需要先学习这些知识。

Once架构的设计**可以直白地理解为：所有代码只写一次，如果不能，则用代码生成器生成它。另外，对于同样使用Once架构的两个项目，A项目积累下来的模块代码，可以直接使用在B项目中。

从宏观上讲，后端应用程序是多个请求的集合。而对单个请求来讲，是多个步骤的集合。

以一个审核博客的接口为例，可以对其理解为：第一步“用户鉴权”、第二步“检查必要参数”、第三步“填充默认参数”、第四步“数据库操作”。

如果从“单个请求就是多个步骤的集合”出发的话，代码可以分成两层：

• 业务代码：指定该业务请求的步骤，且指定每一步调用的模块，例如：第一步“调用xx模块”、第二步“调用yy模块”；
• 模块代码：实现某种具体功能的代码块，例如用户鉴权模块、检查必要参数模块等。模块代码与业务功能无关，只关心被使用的场景。

这样的话，模块代码是可以只写一次的（所有接口都可以使用）。但是，业务代码部分仍然需要编写大量的代码，而这些代码其实是高度重复的。那么，如果加入“数据池”的话，则可以进一步简化业务代码。

业务代码每次调用模块时，都把“数据池”和模块参数传入模块中，模块代码根据模块参数实现逻辑，模块代码可直接对“数据池”进行处理（可以从“数据池”中获取或更新数据），当模块发生错误时，错误码会被存放到数据池中。模块处理完后，把数据池返回业务代码，业务代码判断是否需要截断下一步逻辑（数据池中是否有错误码）。工作原理如图所示。

经过以上规范化后，业务代码可以简化为json的表达形式，如代码所示。简化业务代码后，即可通过代码生成器把业务代码还原成Java代码。这样，即可减少重复代码的编写，又让业务代码更加清晰明了。

"接口列表"{
	"接口一": {
         "接口路径": "/xx/xx" ,
         "请求方式": "POST" ,
         "调用模块": [
				{
					"模块名":"检查必要参数",
					"模块参数":{            //模块代码会自动识别数据池中是否有以下字段
						"abc":"abs",   //abc字段为必填
						"bcd":"opt"    //bcd字段为选填
					}
				},
				{
					"模块名":"数据库操作",
					"模块参数":{
					     "control":"update",				        //更新操作
				             "query":"UPDATE t_blog SET state='pass' WHERE id='@id@'"	//sql语句，其中@id@会替换成数据池中的id的值
				}
		 ],
	},
	"接口二":{
		...
	}
}