DeveloperFire的博客

smart-doc是一款同时支持JAVA REST API和Apache Dubbo RPC接口文档生成的工具，smart-doc在业内率先提出基于JAVA泛型定义推导的理念， 完全基于接口源码来分析生成接口文档，不采用任何注解侵入到业务代码中。你只需要按照java-doc标准编写注释， smart-doc就能帮你生成一个简易明了的Markdown、HTML5、Postman Collection2.0+、OpenAPI 3.0+的文档。零注解、零学习成本、只需要写标准JAVA注释。

OpenAPI 规范（OAS）定义了一个标准的、语言无关的 RESTful API 接口规范，它可以同时允许开发人员和操作系统查看并理解某个服务的功能，而无需访问源代码，文档或网络流量检查（既方便人类学习和阅读，也方便机器阅读）。正确定义 OAS 后，开发者可以使用最少的实现逻辑来理解远程服务并与之交互。此外，文档生成工具可以使用 OpenAPI 规范来生成 API 文档，代码生成工具可以生成各种编程语言下的服务端和客户端代码，测试代码和其他用例。

有哪些控制接口多版本的方式？• 相同URL，用不同的版本参数区分 ◦ api.pdai.tech/user?version=v1 表示 v1版本的接口, 保持原有接口不动 ◦ api.pdai.tech/user?version=v2 表示 v2版本的接口，更新新的接口• 区分不同的接口域名，不同的版本有不同的子域名, 路由到不同的实例: ◦ v1.api.pdai.tech/user 表示 v1版本的接口, 保持原有接口不动, 路由到instance1 ◦ v2.api

DispatcherServlet中onRefresh方法是初始化ApplicationContext后的回调方法，它会调用initStrategies方法，主要更新一些servlet需要使用的对象，包括国际化处理，requestMapping，视图解析等等。具体来看，如果你是设计者，很显然容易想到：对于@ModelAttribute提供的参数预置和@InitBinder注解提供的预处理方法应该是放在一个方法中的，因为它们都是在进入requestMapping方法前做的操作。

软件的国际化：软件开发时，要使它能同时应对世界不同地区和国家的访问，并针对不同地区和国家的访问，提供相应的、符合来访者阅读习惯的页面或数据。国际化又称为 i18n：internationalization在Resources下添加如下：填写名称和资源语言类型添加中英文对应的message。

后端对前端传过来的参数也是需要进行校验的，如果在controller中直接校验需要用大量的if else做判断// ...针对这个普遍的问题，Java开发者在Java API规范 (JSR303) 定义了Bean校验的标准，但没有提供实现。hibernate validation是对这个规范的实现，并增加了校验注解如@Email、@Length等。Spring Validation是对hibernate validation的二次封装，用于支持spring mvc参数自动校验。

面向资源是 REST 最明显的特征，对于同一个资源的一组不同的操作。资源是服务器上一个可命名的抽象概念，资源是以名词为核心来组织的，首先关注的是名词。REST 要求，必须通过统一的接口来对资源执行各种操作。REST 架构设计，遵循的各项标准和准则，就是 HTTP 协议的表现，换句话说，HTTP 协议就是属于 REST 架构的设计模式。这里以常见的状态码为例，包含responseCode 和 description两个属性。包含公共的接口返回时间，状态status, 消息message， 以及数据data。

路由网关的主要目的是为了让所有的微服务对外只有一个接口，我们只需访问一个网关地址，即可由网关将所有的请求代理到不同的服务中。当找不到一个匹配的 Bean 时，Spring 容器将抛出 BeanCreationException 异常，并指出必须至少拥有一个匹配的 Bean。当不能确定 Spring 容器中一定拥有某个类的 Bean 时，可以在需要自动注入该类 Bean 的地方可以使用 @Autowired(required = false)，这等于告诉 Spring: 在找不到匹配 Bean 时也不报错。

热部署和热加载是在应用正在运行的时候，自动更新（重新加载或者替换class等）应用的一种能力。（PS：spring-boot-devtools提供的方案也是要重启的，只是无需手动重启能实现自动加载而已。严格意义上，我们需要区分下热部署和热加载, 对于Java项目而言：热部署在服务器运行时重新部署项目它是直接重新加载整个应用，这种方式会释放内存，比热加载更加干净彻底，但同时也更费时间。热加载在运行时重新加载class，从而升级应用。热加载的实现原理主要依赖java的类加载机制。

Pattern中添加用户自定义的MDC字段，比如用户信息(当前日志是由哪个用户的请求产生)，request信息。此种方式可以通过AOP切面控制，在MDC中添加requestID，在spring-logback.xml中配置Pattern。在学习这块时需要一些日志框架的发展和基础，同时了解日志配置时考虑的因素。日志控制配置通过application.yml下发。按天生成日志，当天的日志>50MB回滚。支持日志路径，日志level等配置。对控制台，Err和全量日志分别配置。生成的日志中Pattern自定义。

我们在启动Spring Boot程序时，有如下Banner信息：那么如何自定义成自己项目的名称呢？

H2是一个用Java开发的嵌入式数据库，它本身只是一个类库，可以直接嵌入到应用项目中。官方网站有哪些用途？H2最大的用途在于可以同应用程序打包在一起发布，这样可以非常方便地存储少量结构化数据。它的另一个用途是用于单元测试。启动速度快，而且可以关闭持久化功能，每一个用例执行完随即还原到初始状态。H2的第三个用处是作为缓存，作为NoSQL的一个补充。

三层架构(3-tier application) 通常意义上的三层架构就是将整个业务应用划分为：表现层（UI）、业务逻辑层（BLL）、数据访问层（DAL）。3、数据访问层（DAL）：该层所做事务直接操作数据库，针对数据的增添、删除、修改、更新、查找等。2、业务逻辑层（BLL）：针对具体问题的操作，也可以说是对数据层的操作，对数据业务逻辑处理。1、表现层（UI）：通俗讲就是展现给用户的界面，即用户在使用一个系统的时候他的所见所得。我们这里设计一个常见的用户增删查改项目，通常来说对应的包结构如下。

Spring Boot 所选择的第三方库是经过考虑的，是比较适合产品开发的选择。如前文所述，SpringBoot最强大的地方在于约定大于配置，只要你引入某个模块的xx-start包，它将自动注入配置，提供了这个模块的功能；Group: 是公司或者组织的名称，是一种命名空间的概念，比如网站，那么group可以是tech.pdai。我们安装Maven Helper的插件，用来查看spring-boot-starter-web模块的依赖。核心 POM，包含自动配置支持、日志库和对 YAML 配置文件的支持。

SpringBoot对上述Spring的缺点进行的改善和优化，基于约定优于配置的思想，可以让开发人员不必在配置与逻辑业务之间进行思维的切换，全身心的投入到逻辑业务的代码编写中，从而大大提高了开发的效率，一定程度上缩短了项目周期。