我开源了团队内部基于SpringBoot Web快速开发的API脚手架stater

我们现在使用SpringBoot 做Web 开发已经比之前SprngMvc 那一套强大很多了。
但是 用SpringBoot Web 做API 开发还是不够简洁有一些。

每次Web API常用功能都需要重新写一遍。或者复制之前项目代码。于是我封装了这么一个

我开源了团队内部基于SpringBoot Web快速开发的API脚手架stater_第1张图片

抽出SpringBoot Web API 每个项目必备需要重复写的模块，和必备功能。
并且扩展了我工作中用到的 所有工具库。

基于它,你可以轻松开发SpringBoot WEB API,提高效率。不在去关心一些繁琐。重复工作，而是把重点聚焦到业务。

目前更新版本到1.5.2 功能如下

  1. 支持一键配置自定义RestFull API 统一格式返回
  2. 支持RestFull API 错误国际化
  3. 支持全局异常处理，全局参数验证处理
  4. 业务错误断言工具封装，遵循错误优先返回原则
  5. 封装Redis key,value 操作工具类。统一key管理 spring cache缓存实现
  6. RestTemplate 封装 POST,GET 请求工具
  7. 日志集成。自定义日志路径，按照日志等级分类，支持压缩和文件大小分割。按时间显示
  8. 工具库集成 集成了lombok，hutool，commons-lang3，guava。不需要自己单个引入
  9. 集成mybatisPlus一键代码生成
  10. 日志记录，服务监控，支持日志链路查询。自定义数据源
  11. OpenApi3文档一键配置。支持多种文档和自动配置
  12. 接口限流，Ip城市回显
  13. HttpUserAgent请求设备工具封装
  14. RequestUtil参数解析封装工具

后续会持续更新。项目中重复使用，必备模块和工具。

rest-api-spring-boot-starter 适用于SpringBoot Web API 快速构建让开发人员快速构建统一规范的业务RestFull API 不在去关心一些繁琐。重复工作，而是把重点聚焦到业务。

快速开始

  1. 项目pom中引入依赖

    
 cn.soboys
 rest-api-spring-boot-starter
 1.5.0

  2. 在SpringBoot启动类或者配置类上通过 @EnableRestFullApi注解开启rest-api

    
@SpringBootApplication
@EnableRestFullApi
public class SuperaideApplication {

 public static void main(String[] args) {
     SpringApplication.run(SuperaideApplication.class, args);
 }
}
````

到此你项目中就可以使用所有的功能了。

## RestFull API
在`Controller`中我们写普通的请求接口如:

    @PostMapping("/chat")
    public HashMap chatDialogue() {
    HashMap m = new HashMap();
    m.put("age", 26);
    m.put("name", "Judy");
    return m;
    }

    返回的就是全局统一RestFull API

    {
    "success": true,
    "code": "OK",
    "msg": "操作成功",
    "requestId": "IPbHLE5SZ1fqI0lgNXlB",
    "timestamp": "2023-07-09 02:39:40",
    "data": {

     "name": "judy",
 "hobby": "swing",
 "age": 18

    }
    }

    
也可以基于`Result`构建

    @PostMapping("/chat")
    public Result chatDialogue(@Validated EntityParam s) {
    return Result.buildSuccess(s);
    }

    ## 分页支持

我们在日常中分页是一个比较特殊返回。也是非常常用的。

    @PostMapping("/page")
    @Log("分页查询用户数据")
    public Result page(@Validated EntityParam s) {
    ResultPage> resultPage=new ResultPage<>();
    List a=new ArrayList();
    a.add(s);
    resultPage.setPageData(a);
    return ResultPage.buildSuccess(resultPage);
    }

  3. 构建自定义自己的分页数据

    ResultPage> resultPage=new ResultPage<>();

  4. 通过ResultPage.buildSuccess(resultPage)进行构建返回

    返回统一响应格式

    {
 "previousPage": 1,
 "nextPage": 1,
 "pageSize": 1,
 "totalPageSize": 1,
 "hasNext": "false",
 "success": true,
 "code": "OK",
 "msg": "操作成功",
 "requestId": "D9AMALgkZ6gVfe6Pi0Oh",
 "timestamp": "2023-07-09 02:39:40",
 "data": [
     {
         "name": "judy",
         "hobby": "swing",
         "age": 18
     }
 ]
}

    自定义返回格式

    {
 "previousPage": 1,
 "nextPage": 1,
 "pageSize": 1,
 "totalPageSize": 1,
 "hasNext": "false",
 "success": true,
 "code": "OK",
 "msg": "操作成功",
 "requestId": "D9AMALgkZ6gVfe6Pi0Oh",
 "timestamp": "2023-07-09 02:39:40",
 "data": [
     {
         "name": "judy",
         "hobby": "swing",
         "age": 18
     }
 ]
}

    上述统一返回格式，可能不符合你项目中接口统一格式如：

    {
 "success": true,
 "code": "OK",
 "msg": "操作成功",
 "requestId": "ztf4S-lP9yrtKPSiwldZ",
 "timestamp": "2023-07-11 13:46:53",
 "data": {
     "previousPage": 1,
     "nextPage": 1,
     "pageSize": 1,
     "totalPageSize": 1,
     "hasNext": "false",
     "pageData": [
         {
             "name": "judy",
             "hobby": "swing",
             "age": 18
         }
     ]
 }
}

    page分页数据是在data里面你可以定义pageWrap属性true包装返回定义pageData的key值如records等

    你需要自定义key如 msg你可能对应message,success你可能对应status只需要在配置文件中配置自定义key

    自定义返回成功值你的成功返回可能是200你可以配置code-success-value值

    rest-api:
  enabled: false
  msg: msg
  code: code
  code-success-value: OK
  success: success
  previousPage: previousPage
  nextPage: nextPage
  pageSize: pageSize
  hasNext: hasNext
  totalPageSize: totalPageSize
  data: info

    当 enabled开启后会读取你自定义配置的key 如

    rest-api:
  enabled: true
  msg: msg1
  code: code1
  code-success-value: 200
  success: success1
  previousPage: previousPage1
  nextPage: nextPage1
  pageSize: pageSize1
  hasNext: hasNext1
  totalPageSize: totalPageSize1
  data: info

    对应返回内容

    {
 "success": true,
 "code": "OK",
 "msg": "操作成功",
 "requestId": "ztf4S-lP9yrtKPSiwldZ",
 "timestamp": "2023-07-11 13:46:53",
 "data": {
     "previousPage": 1,
     "nextPage": 1,
     "pageSize": 1,
     "totalPageSize": 1,
     "hasNext": "false",
     "pageData": [
         {
             "name": "judy",
             "hobby": "swing",
             "age": 18
         }
     ]
 }
}

    自定义返回

    有时候我们需要自定义返回。不去包装统一响应RestFull API格式

  5. 可以通过注解@NoRestFulApi实现如

    @GetMapping("/test")
@NoRestFulApi
public Map chatDialogue() {
 Map  m= new HashMap<>();
 m.put("name","judy");
 m.put("age",26);
 return m;
}

  6. 通过类扫描去实现
    默认会过滤String类型认为是页面路径。

    通过属性配置文件include-packages需要统一返回包。exclude-packages不需统一返回的包

    include-packages: cn.soboys.superaide.controller
exclude-packages: xx.xxx.xxx

    OpenApi文档生成

    已经内置自动支持。swagger文档。和最新的OpenApi3 文档。项目启动后即可访问。

  7. swagger-ui.html 文档。路径/swagger-ui.html
  8. 基于spring-doc 文档UI增强 路径/doc.html

  9. 接口文档属性信息

      openapi:
 description:
 title:
 version:
 license: 
 contact:
   name:
   email:
   url:
  10. 启动项目后，访问 http://server:port/context-path/swagger-ui.html 即可进入 Swagger UI 页面，OpenAPI 描述将在以下 json 格式的 url 中 提供：http://server:port/context-path/v3/api-docs
  11. server：域名 或 IP
  12. port：服务器端口
  13. context-path：应用程序的上下文路径，springboot 默认为空

  14. 文档也可以 yaml 格式提供，位于以下路径：/v3/api-docs.yaml

    如果嫌弃官方提供的 swagger-ui 不美观，或者使用不顺手，可以选择关闭 ui，还可以剔除掉 ui 相关的 webjar 的引入。

    springdoc:
  swagger-ui:
 enabled: false

    OpenAPI 文档信息，默认可在此 url 中获取： http://server:port/context-path/v3/api-docs。
    可以利用其他支持 OpenAPI 协议的工具，通过此地址，进行 API 展示，如 Apifox。
    （ Postman 的 api 测试也可以利用此地址进行导入生成 ）

    Knife4j (原 swagger-bootstrap-ui) 3.x 版本提供了对于 OpenAPI 协议的部分支持。

    ::: tip
    Knife4j 很多地方没有按照协议规范实现，所以使用起来会有很多问题，另外项目也很久没有维护了，不推荐使用。
    :::

    由于 knife4j 对于规范支持的不全面，无法直接使用单文档源数据，所以必须进行分组或者 urls 的指定。 
    # urls
springdoc:
  swagger-ui:
 urls:
   - { name: 'sample', url: '/v3/api-docs' }

    或者

    #分组
springdoc:
  group-configs:
 - { group: 'sample', packages-to-scan: 'com.example' }

    Knife4j 的 UI 访问地址有所不同，页面映射在 doc.html 路径下，启动项目后，访问 http://server:port/context-path/doc.html

    即可进入 Knife4j 的 Swagger UI 页面。

    全局错误拦截，参数校验

    帮你封装好了所有http常见错误，和所有请求参数验证错误。

    如请求错误

    {
 "success": false,
 "code": "405",
 "msg": "方法不被允许",
 "timestamp": "2023-07-03 22:36:47",
 "data": "Request method 'GET' not supported"
}

    请求资源不存在等

    {
 "success": false,
 "code": "404",
 "msg": "请求资源不存在",
 "timestamp": "2023-07-03 22:42:35",
 "data": "/api"
}
    如果需要拦截上面错误请在springboot 配置文件中加入 
    #出现错误时, 直接抛出异常
spring.mvc.throw-exception-if-no-handler-found=true
#不要为我们工程中的资源文件建立映射
spring.web.resources.add-mappings=false

    参数校验错误

    验证Studen对象参数

    /**
 * @author 公众号 程序员三时
 * @version 1.0
 * @date 2023/6/26 22:10
 * @webSite https://github.com/coder-amiao
 */
@Data
public class Student {
 @NotBlank
 private String nam;
 @NotBlank
 private String hobby;
}
     @PostMapping("/chat")
 public HashMap chatDialogue(@Validated  Student student) {
     HashMap m = new HashMap();
     m.put("age", 26);
     m.put("name", "Judy");
     return m;
 }

    请求结果
    我开源了团队内部基于SpringBoot Web快速开发的API脚手架stater_第2张图片

    JSON Body参数

     @PostMapping("/chat")
 public HashMap chatDialogue(@RequestBody @Validated  Student student) {
     HashMap m = new HashMap();
     m.put("age", 26);
     m.put("name", "Judy");
     return m;
 }

    我开源了团队内部基于SpringBoot Web快速开发的API脚手架stater_第3张图片

    我开源了团队内部基于SpringBoot Web快速开发的API脚手架stater_第4张图片

    错误国际化

    内置封装错误默认支持英文和中文两种国际化。你不做任何配置自动支持

    如果需要内置支持更多语言，覆盖即可。

    自定义自己错误国际化和语言

      i18n:
 # 若前端无header传参则返回中文信息
 i18n-header: Lang
 default-lang: cn
 message:
   # admin
   internal_server_error:
     en: Internal Server Error
     cn: 系统错误
   not_found:
     en: Not Found
     cn: 请求资源不存在

    message 对应错误提示
    对应internal_server_error 自定义
    下面语言自己定义 和前端传入i18n-header 对应上，就显你定义错误语言

    我不传错误国际化默认就是中文在 default-lang: cn
    进行配置

    我开源了团队内部基于SpringBoot Web快速开发的API脚手架stater_第5张图片

    当我传入 指定语言 就会按照你配置的国际化自定义返回错误提示

    我开源了团队内部基于SpringBoot Web快速开发的API脚手架stater_第6张图片

    日志链路追踪

    RestFull API 统一返回有一个requestId 它是每个接口唯一标识。用于接口请求日志链路追踪。日志查询。 如：

    {
 "msg": "操作成功",
 "code": "OK",
 "previousPage": 1,
 "success": true,
 "requestId": "udYNdbbMFE45R84OPu9m",
 "nextPage": 1,
 "pageSize": 1,
 "totalPageSize": 1,
 "hasNext": "false",
 "timestamp": "2023-07-09 03:00:27",
 "info": [
     {
         "name": "judy",
         "hobby": "swing",
         "age": 18
     }
 ]
}

    通过requestId你可以很轻松的在你的日志文件查询定位到每次错误的请求。

    通过Log注解记录你想要记录请求

    @PostMapping("/page")
@Log(value = "查询用户数据",apiType= LogApiTypeEnum.USER,CURDType= LogCURDTypeEnum.RETRIEVE)
public Result page(@Validated EntityParam s) {
 ResultPage> resultPage=new ResultPage<>();
 List a=new ArrayList();
 a.add(s);
 resultPage.setPageData(a);
 return ResultPage.buildSuccess(resultPage);
}
    系统默认日志记录数据源为日志文件。如 
    2023-07-13 11:21:25 INFO  http-nio-8888-exec-2 cn.soboys.restapispringbootstarter.aop.LimitAspect IP:192.168.1.8 第 1 次访问key为 [_kenx:chat192.168.1.8]，描述为 [接口限流] 的接口
2023-07-13 11:21:26 INFO  http-nio-8888-exec-2 cn.soboys.restapispringbootstarter.log.LogFileDefaultDataSource {
 "description": "日志记录测试",
 "method": "cn.soboys.restapispringbootstarter.controller.ApiRestController.chatDialogue()",
 "params": {
 },
 "logType": "INFO",
 "requestIp": "192.168.1.8",
 "path": "/chat",
 "address": "0|0|0|内网IP|内网IP",
 "time": 128,
 "os": "Mac",
 "browser": "Chrome",
 "result": {
     "success": true,
     "code": "OK",
     "msg": "操作成功",
     "requestId": "5RgKzWGFNa9XSPwhw2Pi",
     "timestamp": "2023-07-13 11:21:25",
     "data": "接口限流测试"
 },
 "apiType": "USER",
 "device": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36"
}

    你可以自定义自己的日志数据源实现LogDataSource接口 日志操作支持异步。需要在配置类。或者启动类加上@EnableAsync
    注解

    package cn.soboys.restapispringbootstarter.log;

import org.springframework.scheduling.annotation.Async;

import java.util.Map;

/**
 * @Author: kenx
 * @Since: 2021/6/23 13:55
 * @Description:
 */
public interface LogDataSource {

 /**
  * 获取拓展数据
  * @return
  * @param logEntry
  */
 @Async
 void  save(LogEntry logEntry);
}

    或者你可以继承我默认的日志数据源实现类LogFileDefaultDataSource 重写save(LogEntry logEntry)方法。

    @Slf4j
public class LogFileDefaultDataSource implements LogDataSource {

 /**
  * 自定义保存数据源
  *
  * @param
  * @return LogEntry
  */
 @Override
 public void save(LogEntry logEntry) {
     log.info(JSONUtil.toJsonPrettyStr(logEntry));
 }
}
    如果是自定义日志数据源实现需要再配置文件，配置日志数据源。如： 
    logging:
 path: ./logs   #日志存储路径（服务器上绝对）
 max-history: 90 # 保存多少天
 max-file-size: 3MB  # 每个文件大小
 max-total-size-cap: 1GB  #总文件大小超过多少压缩
 level-root: INFO    # 这里的INFO可以替换为其他日志等级，如DEBUG, WARN, ERROR, TRACE, FATAL, OFF等。 日志等级由低到高分别是debugger-info-warn-error
 logDataSourceClass: cn.soboys.restapispringbootstarter.log.LogFileDefaultDataSource # 日志数据源

    Ip城市记录

    日志记录提供Ip城市回显记录

    @PostMapping("/page")
@Log(value = "查询用户数据", apiType = LogApiTypeEnum.USER, CURDType = LogCURDTypeEnum.RETRIEVE,ipCity = true)
public Result page(@Validated EntityParam s) {
 ResultPage> resultPage = new ResultPage<>();
 List a = new ArrayList();
 a.add(s);
 resultPage.setPageData(a);
 return ResultPage.buildSuccess(resultPage);
}

    通过配置ipCity属性，默认是true会记录IP对应物理地址详细信息即国家城市等
    Ip城市查询通过ip2region获取。

    你可配置属性 location 配置自己的ip2region.xdb文件。

      ip2region:
 external: false
 location: classpath:ip2region/ip2region.xdb

    默认不配置会帮你自动生成一个。基于2.7.x最新的数据
    获取最新自定义ip数据 Github 仓库

    当然也帮你封装了。你可以通过工具类HttpUserAgent的静态方法getIpToCityInfo(String ip) 去获取查询ip对应城市信息

    属性配置

    配置语言国际化,日志等,

    ::: tip
    默认不用配置任何参数。会使用默认的，配置了会使用你项目中的配置。
    :::

    默认配置

    rest-api:
  enabled: false
  msg: msg
  code: code
  code-success-value: OK
  success: success
  previousPage: previousPage
  nextPage: nextPage
  pageSize: pageSize
  hasNext: hasNext
  totalPageSize: totalPageSize
  data: info
  include-packages: cn.soboys.superaide.controller
  exclude-packages: xx.xxx.xxx
  redis:
 key-prefix: rest
  openapi:
 description:
 title:
 version:
 license: 
 contact:
   name:
   email:
   url:
  logging:
 path: ./logs   #日志存储路径（服务器上绝对）
 max-history: 90 # 保存多少天
 max-file-size: 3MB  # 每个文件大小
 max-total-size-cap: 1GB  #总文件大小超过多少压缩
 level-root: INFO    # 这里的INFO可以替换为其他日志等级，如DEBUG, WARN, ERROR, TRACE, FATAL, OFF等。 日志等级由低到高分别是debugger-info-warn-error
 logDataSourceClass: cn.soboys.restapispringbootstarter.log.LogFileDefaultDataSource # 日志数据源
  i18n:
 # 若前端无header传参则返回中文信息
 i18n-header: Lang
 default-lang: cn
 message:
   # admin
   internal_server_error:
     en: Internal Server Error
     cn: 系统错误
   bad_gateway:
     en: Bad Gateway
     cn: 错误的请求
   unauthorized:
     en: Unauthorized
     cn: 未授权
   forbidden:
     en: Forbidden
     cn: 资源禁止访问
   method_not_allowed:
     en: Method Not Allowed
     cn: 方法不被允许
   request_timeout:
     en: Request Timeout
     cn: 请求超时
   invalid_argument:
     en: Invalid Argument {}
     cn: 参数错误 {}
   argument_analyze:
     en: Argument Analyze {}
     cn: 参数解析异常 {}
   business_exception:
     en: Business Exception
     cn: 业务错误
   not_found:
     en: Not Found
     cn: 请求资源不存在

    代码生成配置

    支持MybatisPlus代码一键生成 默认不引入MybatisPlus生成依赖需要手动引入

    package cn.soboys.restapispringbootstarter.config;

import lombok.Data;

/**
 * @author 公众号 程序员三时
 * @version 1.0
 * @date 2023/7/5 00:05
 * @webSite https://github.com/coder-amiao
 */
@Data
public class GenerateCodeConfig {
 /**
  * 数据库驱动
  */
 private String driverName;
 /**
  * 数据库连接用户名
  */
 private String username;
 /**
  * 数据库连接密码
  */
 private String password;
 /**
  * 数据库连接url
  */
 private String url;
 /**
  * 生成代码 保存路径。默认当前项目下。
  * 如需修改，使用觉得路径
  */
 private String projectPath;
 /**
  * 代码生成包位置
  */
 private String packages;
}

    RestFull API

    Controller中直接使用

    @PostMapping("/chat")
public HashMap chatDialogue() {
 HashMap m = new HashMap();
 m.put("age", 26);
 m.put("name", "Judy");
 return m;
}

    Result构建返回

    @PostMapping("/chat")
public Result chatDialogue() {
 HashMap m = new HashMap();
 m.put("age", 26);
 m.put("name", "Judy");
 return Result.buildSuccess(m);
}

    分页支持

    我们在日常中分页是一个比较特殊返回。也是非常常用的。

    @PostMapping("/page")
@Log("分页查询用户数据")
public Result page(@Validated EntityParam s) {
 ResultPage> resultPage=new ResultPage<>();
 List a=new ArrayList();
 a.add(s);
 resultPage.setPageData(a);
 return ResultPage.buildSuccess(resultPage);
}

  15. 构建自定义自己的分页数据

    ResultPage> resultPage=new ResultPage<>();
  16. 通过ResultPage.buildSuccess(resultPage)进行构建返回

返回统一响应格式

{
    "previousPage": 1,
    "nextPage": 1,
    "pageSize": 1,
    "totalPageSize": 1,
    "hasNext": "false",
    "success": true,
    "code": "OK",
    "msg": "操作成功",
    "requestId": "D9AMALgkZ6gVfe6Pi0Oh",
    "timestamp": "2023-07-09 02:39:40",
    "data": [
        {
            "name": "judy",
            "hobby": "swing",
            "age": 18
        }
    ]
}

自定义返回格式

{
    "previousPage": 1,
    "nextPage": 1,
    "pageSize": 1,
    "totalPageSize": 1,
    "hasNext": "false",
    "success": true,
    "code": "OK",
    "msg": "操作成功",
    "requestId": "D9AMALgkZ6gVfe6Pi0Oh",
    "timestamp": "2023-07-09 02:39:40",
    "data": [
        {
            "name": "judy",
            "hobby": "swing",
            "age": 18
        }
    ]
}

上述统一返回格式，可能不符合你项目中接口统一格式如：

{
    "success": true,
    "code": "OK",
    "msg": "操作成功",
    "requestId": "ztf4S-lP9yrtKPSiwldZ",
    "timestamp": "2023-07-11 13:46:53",
    "data": {
        "previousPage": 1,
        "nextPage": 1,
        "pageSize": 1,
        "totalPageSize": 1,
        "hasNext": "false",
        "pageData": [
            {
                "name": "judy",
                "hobby": "swing",
                "age": 18
            }
        ]
    }
}

page分页数据是在data里面你可以定义pageWrap属性true包装返回定义pageData的key值如records等

你需要自定义key如 msg你可能对应message,success你可能对应status只需要在配置文件中配置自定义key

自定义返回成功值你的成功返回可能是200你可以配置code-success-value值

rest-api:
  enabled: false
  msg: msg
  code: code
  code-success-value: OK
  success: success
  previousPage: previousPage
  nextPage: nextPage
  pageSize: pageSize
  hasNext: hasNext
  totalPageSize: totalPageSize
  data: info

当 enabled开启后会读取你自定义配置的key 如

rest-api:
  enabled: true
  msg: msg1
  code: code1
  code-success-value: 200
  success: success1
  previousPage: previousPage1
  nextPage: nextPage1
  pageSize: pageSize1
  hasNext: hasNext1
  totalPageSize: totalPageSize1
  data: info

对应返回内容

{
    "success": true,
    "code": "OK",
    "msg": "操作成功",
    "requestId": "ztf4S-lP9yrtKPSiwldZ",
    "timestamp": "2023-07-11 13:46:53",
    "data": {
        "previousPage": 1,
        "nextPage": 1,
        "pageSize": 1,
        "totalPageSize": 1,
        "hasNext": "false",
        "pageData": [
            {
                "name": "judy",
                "hobby": "swing",
                "age": 18
            }
        ]
    }
}

自定义返回

有时候我们需要自定义返回。不去包装统一响应RestFull API格式

  1. 可以通过注解@NoRestFulApi实现如

    @GetMapping("/test")
@NoRestFulApi
public Map chatDialogue() {
 Map  m= new HashMap<>();
 m.put("name","judy");
 m.put("age",26);
 return m;
}
  2. 通过类扫描去实现
    默认会过滤String类型认为是页面路径。

通过属性配置文件include-packages需要统一返回包。exclude-packages不需统一返回的包

include-packages: cn.soboys.superaide.controller
exclude-packages: xx.xxx.xxx

错误国际化支持

内置常见的错误。可以看HttpStatus。默认错误支持中文和英文两种国际化。配置如下

  i18n:
    # 若前端无header传参则返回中文信息
    i18n-header: Lang
    default-lang: cn
    message:
      # admin
      internal_server_error:
        en: Internal Server Error
        cn: 系统错误
      bad_gateway:
        en: Bad Gateway
        cn: 错误的请求
      unauthorized:
        en: Unauthorized
        cn: 未授权
      forbidden:
        en: Forbidden
        cn: 资源禁止访问
      method_not_allowed:
        en: Method Not Allowed
        cn: 方法不被允许
      request_timeout:
        en: Request Timeout
        cn: 请求超时
      invalid_argument:
        en: Invalid Argument {}
        cn: 参数错误 {}
      argument_analyze:
        en: Argument Analyze {}
        cn: 参数解析异常 {}
      business_exception:
        en: Business Exception
        cn: 业务错误
      not_found:
        en: Not Found
        cn: 请求资源不存在

可以自行覆盖扩充

全局错误拦截和响应

默认拦所有未知错误异常和validation参数校验失败异常,以及Http请求异常。
还有全局自定义BusinessException 业务异常 自动集成spring-boot-starter-validation 你项目中不需要再单独引入



    org.springframework.boot
    spring-boot-starter-validation

也内置扩展了许多自定义参数校验参考
我开源了团队内部基于SpringBoot Web快速开发的API脚手架stater_第7张图片

第三方请求

有时候我们项目中需要调用第三方接口服务。基于RestTemplate 进一步封装了直接的POST,GET,请求。

在需要使用地方注入RestFulTemp

@Resource
private RestFulTemp restFulTemp;

GET请求

@GetMapping("/doGet")
public Result doGet() {
    ResponseEntity response = restFulTemp.doGet("http://127.0.0.1:9000/redis/get");
    return Result.buildSuccess();
}

POST 请求

/**
 * POST 请求参 数为body json体格式
 * @return
 */
@PostMapping("/doPost")
public Result doPost() {
    Student s=new Student();
    s.setHobby("swing");
    s.setNam("judy");
    //自动把对象转换为JSON
    ResponseEntity response = 
            restFulTemp.doPost("http://127.0.0.1:9000/redis/get",s);
    return Result.buildSuccess();
}
/**
 * POST请求 参数为FORM 表单参数
 * @return
 */
@PostMapping("/doPost")
public Result doPostForm() {
    EntityParam s=new EntityParam();
    s.setAge(19);
    s.setHobby("swing");
    s.setName("judy");

    ResponseEntity response =
            restFulTemp.doPostForm("http://127.0.0.1:8000/chat", BeanUtil.beanToMap(s));
    return Result.buildSuccess(response.getBody());
}

DELETE请求

@GetMapping("/doDelete")
public Result doDelete() {
    restFulTemp.doDelete("http://127.0.0.1:8000/chat");
    return Result.buildSuccess();
}

PUT请求

@GetMapping("/doPut")
public Result doPut() {
    EntityParam s=new EntityParam();
    restFulTemp.doPut("http://127.0.0.1:8000/chat",s);
    return Result.buildSuccess(s);
}

错误异常自定义

我内置错误异常和业务异常可能无法满足你自身接口业务异常需要。你可以自定义错误异常类,和错误响应枚举码。

自定义错误枚举 需要实现ResultCode接口 
package cn.soboys.restapispringbootstarter;

import cn.soboys.restapispringbootstarter.i18n.I18NKey;

/**
* @author 公众号 程序员三时
* @version 1.0
* @date 2023/6/26 10:21
* @webSite https://github.com/coder-amiao
* 响应码接口，自定义响应码，实现此接口
*/
public interface ResultCode extends I18NKey {

   String getCode();

   String getMessage();

}
````

如果要支持国际化还需要实现国际化接口**I18NKey** 参考我内部**HttpStatus**实现即可

package cn.soboys.restapispringbootstarter;

import cn.soboys.restapispringbootstarter.i18n.I18NKey;

/**

public enum HttpStatus implements ResultCode, I18NKey {

/**
 * 系统内部错误
 */
INTERNAL_SERVER_ERROR("500", "internal_server_error"),
BAD_GATEWAY("502", "bad_gateway"),
NOT_FOUND("404", "not_found"),
UNAUTHORIZED("401", "unauthorized"),
FORBIDDEN("403", "forbidden"),
METHOD_NOT_ALLOWED("405", "method_not_allowed"),
REQUEST_TIMEOUT("408", "request_timeout"),

INVALID_ARGUMENT("10000", "invalid_argument"),
ARGUMENT_ANALYZE("10001", "argument_analyze"),
BUSINESS_EXCEPTION("20000", "business_exception");


private final String value;

private final String message;

HttpStatus(String value, String message) {
    this.value = value;
    this.message = message;
}


@Override
public String getCode() {
    return value;
}

@Override
public String getMessage() {
    return message;
}


@Override
public String key() {
    return message;
}

}

rest-api:
enabled: false
i18n:

# 若前端无header传参则返回中文信息
i18n-header: Lang
default-lang: cn
message:
  # admin
  internal_server_error:
    en: Internal Server Error
    cn: 系统错误
  bad_gateway:
    en: Bad Gateway
    cn: 错误的请求
  unauthorized:
    en: Unauthorized
    cn: 未授权
  forbidden:
    en: Forbidden
    cn: 资源禁止访问
  method_not_allowed:
    en: Method Not Allowed
    cn: 方法不被允许
  request_timeout:
    en: Request Timeout
    cn: 请求超时
  invalid_argument:
    en: Invalid Argument {}
    cn: 参数错误 {}
  argument_analyze:
    en: Argument Analyze {}
    cn: 参数解析异常 {}
  business_exception:
    en: Business Exception
    cn: 业务错误
  not_found:
    en: Not Found
    cn: 请求资源不存在


![](https://images.soboys.cn/202307040127708.png)

![](https://images.soboys.cn/202307040127574.png)

![](https://images.soboys.cn/202307042336110.png)

![](https://images.soboys.cn/202307042337644.png)

## 业务断言
封装了业务错误断言工具。`Assert` 遵循错误优先返回原则。

你要自定义自己的业务异常。继承`BusinessException`
重写对应方法

package cn.soboys.restapispringbootstarter.exception;

import cn.soboys.restapispringbootstarter.HttpStatus;
import cn.soboys.restapispringbootstarter.ResultCode;
import lombok.Data;

/**

@Data
public class BusinessException extends RuntimeException {

/**
 * 错误码
 */
private String code="20000";

/**
 * 错误提示
 */
private String message;


public BusinessException(String message) {
    this.message = message;

}

public BusinessException(String message, String code) {
    this.message = message;
    this.code = code;

}

public BusinessException(ResultCode resultCode) {
    this.message = resultCode.getMessage();
    this.code = resultCode.getCode();

}

}


项目中日志是非常常用的，而且还是必须的。已经自动配置集成`spring-boot-starter-logging` 你不需要在项目中单独引入


org.springframework.boot
spring-boot-starter-logging

## 默认日志配置

logging:

path: ./logs   #日志存储路径（服务器上绝对）
max-history: 90 # 保存多少天
max-file-size: 3MB  # 每个文件大小
max-total-size-cap: 1GB  #总文件大小超过多少压缩
level-root: INFO    # 这里的INFO可以替换为其他日志等级，如DEBUG, WARN, ERROR, TRACE, FATAL, OFF等。 日志等级由低到高分别是debugger-info-warn-error
logDataSourceClass: cn.soboys.restapispringbootstarter.log.LogFileDefaultDataSource # 日志数据源
## 日志记录与追踪
RestFull API 统一返回有一个`requestId `它是每个接口唯一标识。用于接口请求日志链路追踪。日志查询。 如：

{

"msg": "操作成功",
"code": "OK",
"previousPage": 1,
"success": true,
"requestId": "udYNdbbMFE45R84OPu9m",
"nextPage": 1,
"pageSize": 1,
"totalPageSize": 1,
"hasNext": "false",
"timestamp": "2023-07-09 03:00:27",
"info": [
    {
        "name": "judy",
        "hobby": "swing",
        "age": 18
    }
]

}

通过requestId你可以很轻松的在你的日志文件查询定位到每次错误的请求。

通过`Log`注解记录你想要记录请求

@PostMapping("/page")
@Log(value = "查询用户数据",apiType= LogApiTypeEnum.USER,CURDType= LogCURDTypeEnum.RETRIEVE)
public Result page(@Validated EntityParam s) {

ResultPage> resultPage=new ResultPage<>();
List a=new ArrayList();
a.add(s);
resultPage.setPageData(a);
return ResultPage.buildSuccess(resultPage);

}


>系统默认日志记录数据源为日志文件。如

2023-07-09 03:00:32 INFO http-nio-8000-exec-2 cn.soboys.restapispringbootstarter.log.LogFileDefaultDataSource {

"description": "查询用户数据",
"method": "cn.soboys.restapispringbootstarter.controller.ApiRestController.page()",
"logType": "INFO",
"time": 3,
"result": {
    "success": true,
    "code": "OK",
    "msg": "操作成功",
    "requestId": "udYNdbbMFE45R84OPu9m",
    "timestamp": "2023-07-09 03:00:27",
    "data": {
        "previousPage": 1,
        "nextPage": 1,
        "pageSize": 1,
        "totalPageSize": 1,
        "hasNext": "false",
        "pageData": [
            {
                "name": "judy",
                "hobby": "swing",
                "age": 18
            }
        ],
        "requestId": "qJTOejQmY-OOf7fagegB",
        "timestamp": "2023-07-09 03:00:27"
    }
},
"apiType": "USER"

}
2023-07-09 03:08:03 INFO http-nio-8000-exec-4 cn.soboys.restapispringbootstarter.log.LogFileDefaultDataSource {

"description": "查询用户数据",
"method": "cn.soboys.restapispringbootstarter.controller.ApiRestController.page()",
"logType": "INFO",
"time": 1,
"result": {
    "success": true,
    "code": "OK",
    "msg": "操作成功",
    "requestId": "kP3yPP-H7wI2x1ak6YFA",
    "timestamp": "2023-07-09 03:00:27",
    "data": {
        "previousPage": 1,
        "nextPage": 1,
        "pageSize": 1,
        "totalPageSize": 1,
        "hasNext": "false",
        "pageData": [
            {
                "name": "judy",
                "hobby": "swing",
                "age": 18
            }
        ],
        "requestId": "pGbbiEj8GQ1eTxQpF2Jr",
        "timestamp": "2023-07-09 03:00:27"
    }
},
"apiType": "USER"

}

你可以自定义自己的日志数据源实现`LogDataSource`接口 日志操作支持异步。需要在配置类。或者启动类加上`@EnableAsync`
注解

package cn.soboys.restapispringbootstarter.log;

import org.springframework.scheduling.annotation.Async;

import java.util.Map;

/**

  • @Author: kenx
  • @Since: 2021/6/23 13:55
  • @Description:
    */

public interface LogDataSource {

/**
 * 获取拓展数据
 * @return
 * @param logEntry
 */
@Async
void  save(LogEntry logEntry);

}


或者你可以继承我默认的日志数据源实现类`LogFileDefaultDataSource` 重写`save(LogEntry logEntry)`方法。

@Slf4j
public class LogFileDefaultDataSource implements LogDataSource {

/**
 * 自定义保存数据源
 *
 * @param
 * @return LogEntry
 */
@Override
public void save(LogEntry logEntry) {
    log.info(JSONUtil.toJsonPrettyStr(logEntry));
}

}

>如果是自定义日志数据源实现需要再配置文件，配置日志数据源。如：

logging:

path: ./logs   #日志存储路径（服务器上绝对）
max-history: 90 # 保存多少天
max-file-size: 3MB  # 每个文件大小
max-total-size-cap: 1GB  #总文件大小超过多少压缩
level-root: INFO    # 这里的INFO可以替换为其他日志等级，如DEBUG, WARN, ERROR, TRACE, FATAL, OFF等。 日志等级由低到高分别是debugger-info-warn-error
logDataSourceClass: cn.soboys.restapispringbootstarter.log.LogFileDefaultDataSource # 日志数据源

# 缓存和redis

项目中缓存使用是非常常见的。用的最多的是基于`Redis`缓存。于是我封装了对于`Redis`Key和Value常用操作。

::: tip
默认不引入Redis依赖，如果要使用Redis需要自己单独引入
:::


org.springframework.boot
spring-boot-starter-data-redis


## 项目使用

注入`redisTempUtil`

@Autowired
private RedisTempUtil redisTempUtil;


如示列

@Autowired
private RedisTempUtil redisTempUtil;

@GetMapping("/redis")
public Result chatDialogue( ) {

redisTempUtil.set("test","111");
redisTempUtil.get("test");
redisTempUtil.set("user","userObj",7200l);
redisTempUtil.getAllKey("xx");  //*表达式
redisTempUtil.clean();
redisTempUtil.deleteObject("test");
redisTempUtil.hasKey("");
return Result.buildSuccess();

}

## 统一缓存管理
上面我们是直接通过工具类`redisTempUtil`直接自己定义`key`然后去存储,这种方式是不可取的如果`key很多随意定义就会很混乱`。我提供了统一缓存key管理接口`CacheTmp` 参考实现`CacheKey` 基于枚举形式，把所有key集中管理

package cn.soboys.restapispringbootstarter.cache;

import lombok.Getter;

/**

@Getter
public enum CacheKey implements CacheTmp {

// 密码的重置码
PWD_RESET_CODE("reset:code:", true),
;

private String key;

/**
 * Key是否是Key前缀, true时直接取key=key，如果false时key=key+suffix
 */
private boolean hasPrefix;

CacheKey(String key, boolean hasPrefix) {
    this.key = key;
    this.hasPrefix = hasPrefix;
}


@Override
public Boolean getHasPrefix() {
    return this.hasPrefix;
}

@Override
public String getKey() {
    return this.key;
}

}


使用
1. 存储对于key

@GetMapping("/redis")
public Result chatDialogue() {

CacheKey.PWD_RESET_CODE.valueSetAndExpire("test", 60l, TimeUnit.SECONDS, "judy");
return Result.buildSuccess();

}

2. 获取对应的key

@GetMapping("/redis/get")
public Result redisGet() {

String a = CacheKey.PWD_RESET_CODE.valueGet("judy");
return Result.buildSuccess(a);

}


## spring Cache实现

封装了`spring Cache`进一步使用 项目中在配置类或者启动类通过注解`@EnableCaching`开启直接使用即可

@Cacheable(cacheNames = "testCache", keyGenerator = "keyGeneratorStrategy")
@GetMapping("/redis/springCache")
public Result springCache() {

String a = "test cache";
return Result.buildSuccess(a);

}

工具类使用`springCacheUtil` 支持提供不是基于注解的使用方式

@GetMapping("/redis/springCache")
public Result redisSpringCache() {

String a = "111344";
springCacheUtil.putCache("test","key","121e1");
return Result.buildSuccess(a);

}

::: tip
默认不引入Redis依赖，缓存基于内存实现（你项目引入redis依赖后会自定切换数据源为Redis缓存）
:::

## redis配置
多个项目或者模块使用一个key可能会造成混乱，于是提供了一个全局配置key。

redis:

key-prefix: rest 
代码中添加一个 String 类型的 `key：testKey`，其实际在 redis 中存储的 key name 为 `rest:testKey`

全局 key 前缀的配置，并不影响对 key 的其他操作，例如获取对应的 value 时，依然是传入 `testKey`，而不是 `rest:testKey`

String key = "testKey";
String value = redisTempUtil.get(key);
String value1 = CacheKey.PWD_RESET_CODE.valueGet(key);


## OpenApi文档生成
已经内置自动支持。`swagger`文档。和最新的`OpenApi3 `文档。项目启动后即可访问。

1. swagger-ui.html 文档。路径`/swagger-ui.html`
2. 基于spring-doc 文档UI增强 路径`/doc.html`

3. 接口文档属性信息

openapi:

description:
title:
version:
license: 
contact:
  name:
  email:
  url: 

- 启动项目后，访问 http://server:port/context-path/swagger-ui.html 即可进入 Swagger UI 页面，OpenAPI 描述将在以下 json 格式的 url 中 提供：http://server:port/context-path/v3/api-docs
- server：域名 或 IP
- port：服务器端口
- context-path：应用程序的上下文路径，springboot 默认为空
- 文档也可以 yaml 格式提供，位于以下路径：/v3/api-docs.yaml

如果嫌弃官方提供的 swagger-ui 不美观，或者使用不顺手，可以选择关闭 ui，还可以剔除掉 ui 相关的 webjar 的引入。

springdoc:
swagger-ui:

enabled: false

OpenAPI 文档信息，默认可在此 url 中获取： http://server:port/context-path/v3/api-docs。
可以利用其他支持 OpenAPI 协议的工具，通过此地址，进行 API 展示，如 Apifox。
（ Postman 的 api 测试也可以利用此地址进行导入生成 ）

Knife4j (原 swagger-bootstrap-ui) 3.x 版本提供了对于 OpenAPI 协议的部分支持。

::: tip
Knife4j 很多地方没有按照协议规范实现，所以使用起来会有很多问题，另外项目也很久没有维护了，不推荐使用。
::: 

>由于 knife4j 对于规范支持的不全面，无法直接使用单文档源数据，所以必须进行分组或者 urls 的指定。

urls

springdoc:
swagger-ui:

urls:
  - { name: 'sample', url: '/v3/api-docs' }
或者

分组

springdoc:
group-configs:

- { group: 'sample', packages-to-scan: 'com.example' }

Knife4j 的 UI 访问地址有所不同，页面映射在 `doc.html` 路径下，启动项目后，访问 `http://server:port/context-path/doc.html`

即可进入 Knife4j 的 Swagger UI 页面。

# 代码自动生成
项目中我们使用`mybatis` 或者`mybatisPlus` 一些简单的单表业务代码，增删改成。我们可以一键生成。不需要重复写。 我封装了`mybatisPlus` 代码生成工具

::: tip
默认不引入`mybatisPlus`代码生成依赖，如果要使用`mybatisPlus`代码生成需自行单独引入
:::


com.baomidou
mybatis-plus-generator
3.4.1



mysql
mysql-connector-java
8.0.28



org.freemarker
freemarker
2.3.31


## 项目使用
1.  代码生成配置类

package cn.soboys.restapispringbootstarter.config;

import lombok.Data;

/**

@Data
public class GenerateCodeConfig {

/**
 * 数据库驱动
 */
private String driverName;
/**
 * 数据库连接用户名
 */
private String username;
/**
 * 数据库连接密码
 */
private String password;
/**
 * 数据库连接url
 */
private String url;
/**
 * 生成代码 保存路径。默认当前项目下。
 * 如需修改，使用绝对路径
 */
private String projectPath;
/**
 * 代码生成包位置
 */
private String packages;

}


示列如：

public class Test {

public static void main(String[] args) {
    GenerateCodeConfig config=new GenerateCodeConfig();
    config.setDriverName("com.mysql.cj.jdbc.Driver");
    config.setUsername("root");
    config.setPassword("root");
    config.setUrl("jdbc:mysql://127.0.0.1:3306/ry?useUnicode=true&useSSL=false&characterEncoding=utf8");
    //config.setProjectPath("superaide");
    config.setPackages("cn.soboys.superaide");
    MyBatisPlusGenerator.generate(config);
}

}



# 常见问题

在使用过程中尽量使用最新版本。我会持续更新更多的内容。 会第一时间发布在我的公众号
程序员三时。全网同名


可以关注 公众号 **程序员三时**。用心分享持续输出优质内容。希望可以给你带来一点帮助

你可能感兴趣的:(我开源了团队内部基于SpringBoot Web快速开发的API脚手架stater)

  • 斤斤计较的婚姻到底有多难？ 白心之岂必有为
    很多人私聊我会问到在哪个人群当中斤斤计较的人最多？我都会回答他，一般婚姻出现问题的斤斤计较的人士会非常多，以我多年经验，在婚姻落的一塌糊涂的人当中，斤斤计较的人数占比在20～30%以上，也就是说10个婚姻出现问题的斤斤计较的人有2-3个有多不减。在婚姻出问题当中，有大量的心理不平衡的、尖酸刻薄的怨妇。在婚姻中仅斤斤计较有两种类型：第一种是物质上的，另一种是精神上的。在物质与精神上抠门已经严重的影响
  • 情绪觉察日记第37天 露露_e800
    今天是家庭关系规划师的第二阶最后一天，慧萍老师帮我做了个案，帮我处理了埋在心底好多年的一份恐惧，并给了我深深的力量！这几天出来学习，爸妈过来婆家帮我带小孩，妈妈出于爱帮我收拾东西，并跟我先生和婆婆产生矛盾，妈妈觉得他们没有照顾好我…。今晚回家见到妈妈，我很欣赏她并赞扬她，妈妈说今晚要跟我睡我说好，当我们俩躺在床上准备睡觉的时候，我握着妈妈的手对她说:妈妈这几天辛苦你了，你看你多利害把我们的家收拾得
  • 芦花鞋一四 许叶晗
    又是在一个寒冷的夏日里，青铜和葵花决定今天一起去卖芦花鞋，奶奶亲手给他们做了一碗热乎乎的粥对他们说:“就靠你们两挣生活费了这碗粥赶紧趁热喝了吧！”于是青铜和葵花喝完了奶奶给她们做的粥，就准备去镇上卖卢花鞋，这回青铜和葵花穿着新的芦花鞋来到了镇上。青铜这回看到了很多人都在卖，用手势表达对葵花说:“这回有好多人在抢我们生意呢！我们必须得吆喝起来。”葵花点了点头。可是谁知他们也大声的叫，卖芦花喽！卖芦花
  • QQ群采集助手，精准引流必备神器 2401_87347160 其他经验分享
    功能概述微信群查找与筛选工具是一款专为微信用户设计的辅助工具，它通过关键词搜索功能，帮助用户快速找到相关的微信群，并提供筛选是否需要验证的群组的功能。主要功能关键词搜索：用户可以输入关键词，工具将自动查找包含该关键词的微信群。筛选功能：工具提供筛选机制，用户可以选择是否只显示需要验证或不需要验证的群组。精准引流：通过上述功能，用户可以更精准地找到目标群组，进行有效的引流操作。3.设备需求该工具可以
  • 关于沟通这件事，项目经理不需要每次都面对面进行 流程大师兄
    很多项目经理都会遇到这样的问题，项目中由于事情太多，根本没有足够的时间去召开会议，那在这种情况下如何去有效地管理项目中的利益相关者？当然，不建议电子邮件也不需要开会的话，建议可以采取下面几种方式来形成有效的沟通，这几种方式可以帮助你努力的通过各种办法来保持和各方面的联系。项目经理首先要问自己几个问题，项目中哪些利益相关者是必须要进行沟通的？可以列出项目中所有的利益相关者清单，同时也整理出项目中哪些
  • 机器学习与深度学习间关系与区别 ℒℴѵℯ心·动ꦿ໊ོ꫞ 人工智能学习深度学习python
    一、机器学习概述定义机器学习（MachineLearning,ML）是一种通过数据驱动的方法，利用统计学和计算算法来训练模型，使计算机能够从数据中学习并自动进行预测或决策。机器学习通过分析大量数据样本，识别其中的模式和规律，从而对新的数据进行判断。其核心在于通过训练过程，让模型不断优化和提升其预测准确性。主要类型1.监督学习（SupervisedLearning）监督学习是指在训练数据集中包含输入
  • 铭刻于星（四十二） 随风至
    69夜晚，绍敏同学做完功课后，看了眼房外，没听到动静才敢从书包的夹层里拿出那个心形纸团。折痕压得很深，都有些旧了，想来是已经写好很久了。绍敏同学慢慢地、轻轻地捏开折叠处，待到全部拆开后，又反复抚平纸张，然后仔细地一字字默看。只是开头的三个字是第一次看到，让她心漏跳了几拍。“亲爱的绍敏：从四年级的时候，我就喜欢你了，但是我一直不敢说，怕影响你学习。六年级的时候听说有人跟你表白，你接受了，我很难过，但
  • 底层逆袭到底有多难，不甘平凡的你准备好了吗？让吴起给你说说 造命者说
    底层逆袭到底有多难，不甘平凡的你准备好了吗？让吴起给你说说我叫吴起，生于公元前440年的战国初期，正是群雄并起、天下纷争不断的时候。后人说我是军事家、政治家、改革家，是兵家代表人物。评价我一生历仕鲁、魏、楚三国，通晓兵家、法家、儒家三家思想，在内政军事上都有极高的成就。周安王二十一年（公元前381年），因变法得罪守旧贵族，被人乱箭射死。我出生在卫国一个“家累万金”的富有家庭，从年轻时候起就不甘平凡
  • 2020-01-25 晴岚85
    郑海燕坚持分享590天2020.1.24在生活中只存在两个问题。一个问题是：你知道想要达成的目标是什么，但却不知道如何才能达成；另一个问题是：你不知道你的目标是什么。前一个是行动的问题，后一个是结果的问题。通过制定具体的下一步行动，可以解决不知道如何开始行动的问题。而通过去想象结果，对结果做预估，可以解决找不着目标的问题。对于所有吸引我们注意力，想要完成的任务，你可以先想象一下，预期的结果究竟是什
  • 随笔 | 仙一般的灵气 海思沧海
    仙岛今天，我看了你全部，似乎已经进入你的世界我不知道，这是否是梦幻，还是你仙一般的灵气吸引了我也许每一个人都要有一份属于自己的追求，这样才能够符合人生的梦想，生活才能够充满着阳光与快乐我不知道，我为什么会这样的感叹，是在感叹自己的人生，还是感叹自己一直没有孜孜不倦的追求只感觉虚度了光阴，每天活在自己的梦中，活在一个不真实的世界是在逃避自己，还是在逃避周围的一切有时候我嘲笑自己，嘲笑自己如此的虚无，
  • 想家 爆米花机
    也许不同于大家对家乡的思念，我对家乡甚至是疯狂的不舍。还未踏出车站就感觉到幸福，我享受这里的夕阳、这里的浓烈柴火味、这里每一口家常菜。我是宅女，我贪恋家的安逸。刚刚踏出大学校门，初出茅庐，无法适应每年只能国庆和春节回家。我焦虑、失眠、无端发脾气，是无法适应工作的节奏，是无法接受我将一步步离开家乡的事实。我不想承认自己胸无大志，选择再次踏上征程。图片发自App
  • 【iOS】MVC设计模式 Magnetic_h iosmvc设计模式objective-c学习ui
    MVC前言如何设计一个程序的结构，这是一门专门的学问，叫做"架构模式"（architecturalpattern），属于编程的方法论。MVC模式就是架构模式的一种。它是Apple官方推荐的App开发架构，也是一般开发者最先遇到、最经典的架构。MVC各层controller层Controller/ViewController/VC（控制器）负责协调Model和View，处理大部分逻辑它将数据从Mod
  • OC语言多界面传值五大方式 Magnetic_h iosui学习objective-c开发语言
    前言在完成暑假仿写项目时，遇到了许多需要用到多界面传值的地方，这篇博客来总结一下比较常用的五种多界面传值的方式。属性传值属性传值一般用前一个界面向后一个界面传值，简单地说就是通过访问后一个视图控制器的属性来为它赋值，通过这个属性来做到从前一个界面向后一个界面传值。首先在后一个界面中定义属性@interfaceBViewController:UIViewController@propertyNSSt
  • 一百九十四章. 自相矛盾 巨木擎天
    唉！就这么一夜，林子感觉就像过了很多天似的，先是回了阳间家里，遇到了那么多不可思议的事情儿。特别是小伙伴们，第二次与自己见面时，僵硬的表情和恐怖的气氛，让自己如坐针毡，打从心眼里难受！还有东子，他现在还好吗？有没有被人欺负？护城河里的小鱼小虾们，还都在吗？水不会真的干枯了吧？那对相亲相爱漂亮的太平鸟儿，还好吧！春天了，到了做窝、下蛋、喂养小鸟宝宝的时候了，希望它们都能够平安啊！虽然没有看见家人，也
  • UI学习——cell的复用和自定义cell Magnetic_h ui学习
    目录cell的复用手动（非注册）自动（注册）自定义cellcell的复用在iOS开发中，单元格复用是一种提高表格（UITableView）和集合视图（UICollectionView）滚动性能的技术。当一个UITableViewCell或UICollectionViewCell首次需要显示时，如果没有可复用的单元格，则视图会创建一个新的单元格。一旦这个单元格滚动出屏幕，它就不会被销毁。相反，它被添
  • element实现动态路由+面包屑 软件技术NINI vue案例vue.js前端
    el-breadcrumb是ElementUI组件库中的一个面包屑导航组件，它用于显示当前页面的路径，帮助用户快速理解和导航到应用的各个部分。在Vue.js项目中，如果你已经安装了ElementUI，就可以很方便地使用el-breadcrumb组件。以下是一个基本的使用示例：安装ElementUI（如果你还没有安装的话）:你可以通过npm或yarn来安装ElementUI。bash复制代码npmi
  • 10月|愿你的青春不负梦想-读书笔记-01 Tracy的小书斋
    本书的作者是俞敏洪，大家都很熟悉他了吧。俞敏洪老师是我行业的领头羊吧，也是我事业上的偶像。本日摘录他书中第一章中的金句：『一个人如果什么目标都没有，就会浑浑噩噩，感觉生命中缺少能量。能给我们能量的，是对未来的期待。第一件事，我始终为了进步而努力。与其追寻全世界的骏马，不如种植丰美的草原，到时骏马自然会来。第二件事，我始终有阶段性的目标。什么东西能给我能量？答案是对未来的期待。』读到这里的时候，我便
  • C语言宏函数 南林yan C语言c语言
    一、什么是宏函数？通过宏定义的函数是宏函数。如下，编译器在预处理阶段会将Add(x,y)替换为((x)*(y))#defineAdd(x,y)((x)*(y))#defineAdd(x,y)((x)*(y))intmain(){inta=10;intb=20;intd=10;intc=Add(a+d,b)*2;cout<
  • 地推话术，如何应对地推过程中家长的拒绝 校师学
    相信校长们在做地推的时候经常遇到这种情况：市场专员反馈家长不接单，咨询师反馈难以邀约这些家长上门，校区地推疲软，招生难。为什么？仅从地推层面分析，一方面因为家长受到的信息轰炸越来越多，对信息越来越“免疫”；而另一方面地推人员的专业能力和营销话术没有提高，无法应对家长的拒绝，对有意向的家长也不知如何跟进，眼睁睁看着家长走远；对于家长的疑问，更不知道如何有技巧地回答，机会白白流失。由于回答没技巧和专业
  • 谢谢你们，爱你们！ 鹿游儿
    昨天家人去泡温泉，二个孩子也带着去，出发前一晚，匆匆下班，赶回家和孩子一起收拾。饭后，我拿出笔和本子（上次去澳门时做手帐的本子）写下了1\2\3\4\5\6\7\8\9,让后让小壹去思考，带什么出发去旅游呢？她在对应的数字旁边画上了，泳衣、泳圈、肖恩、内衣内裤、tapuy、拖鞋……画完后，就让她自己对着这个本子，将要带的，一一带上，没想到这次带的书还是这本《便便工厂》(晚上姑婆发照片过来，妹妹累得
  • C语言如何定义宏函数？ 小九格物 c语言
    在C语言中，宏函数是通过预处理器定义的，它在编译之前替换代码中的宏调用。宏函数可以模拟函数的行为，但它们不是真正的函数，因为它们在编译时不会进行类型检查，也不会分配存储空间。宏函数的定义通常使用#define指令，后面跟着宏的名称和参数列表，以及宏展开后的代码。宏函数的定义方式：1.基本宏函数：这是最简单的宏函数形式，它直接定义一个表达式。#defineSQUARE(x)((x)*(x))2.带参
  • 微服务下功能权限与数据权限的设计与实现 nbsaas-boot 微服务java架构
    在微服务架构下，系统的功能权限和数据权限控制显得尤为重要。随着系统规模的扩大和微服务数量的增加，如何保证不同用户和服务之间的访问权限准确、细粒度地控制，成为设计安全策略的关键。本文将讨论如何在微服务体系中设计和实现功能权限与数据权限控制。1.功能权限与数据权限的定义功能权限：指用户或系统角色对特定功能的访问权限。通常是某个用户角色能否执行某个操作，比如查看订单、创建订单、修改用户资料等。数据权限：
  • 理解Gunicorn：Python WSGI服务器的基石 范范0825 ipythonlinux运维
    理解Gunicorn：PythonWSGI服务器的基石介绍Gunicorn，全称GreenUnicorn，是一个为PythonWSGI（WebServerGatewayInterface）应用设计的高效、轻量级HTTP服务器。作为PythonWeb应用部署的常用工具，Gunicorn以其高性能和易用性著称。本文将介绍Gunicorn的基本概念、安装和配置，帮助初学者快速上手。1.什么是Gunico
  • 小丽成长记（四十三） 玲玲54321
    小丽发现，即使她好不容易调整好自己的心态下一秒总会有不确定的伤脑筋的事出现，一个接一个的问题，人生就没有停下的时候，小问题不断出现。不过她今天看的书，她接受了人生就是不确定的，厉害的人就是不断创造确定性，在Ta的领域比别人多的确定性就能让自己脱颖而出，显示价值从而获得的比别人多的利益。正是这样的原因，因为从前修炼自己太少，使得她现在在人生道路上打怪起来困难重重，她似乎永远摆脱不了那种无力感，有种习
  • 学点心理知识，呵护孩子健康 静候花开_7090
    昨天听了华中师范大学教育管理学系副教授张玲老师的《哪里才是学生心理健康的最后庇护所，超越教育与技术的思考》的讲座。今天又重新学习了一遍，收获匪浅。张玲博士也注意到了当今社会上的孩子由于心理问题导致的自残、自杀及伤害他人等恶性事件。她向我们普及了一个重要的命题，她说心理健康的一些基本命题，我们与我们通常的一些教育命题是不同的，她还举了几个例子，让我们明白我们原来以为的健康并非心理学上的健康。比如如果
  • 2021年12月19日，春蕾教育集团团建活动感受——黄晓丹 黄错错加油
    感受:1.从陌生到熟悉的过程。游戏环节让我们在轻松的氛围中得到了锻炼，也增长了不少知识。2.游戏过程中，我们贡献的是个人力量，展现的是团队的力量。它磨合的往往不止是工作的熟悉，更是观念上契合度的贴近。3.这和工作是一样的道理。在各自的岗位上，每个人摆正自己的位置、各司其职充分发挥才能，并团结一致劲往一处使，才能实现最大的成功。新知:1.团队精神需要不断地创新。过去，人们把创新看作是冒风险，现在人们
  • Cell Insight | 单细胞测序技术又一新发现，可用于HIV-1和Mtb共感染个体诊断 尐尐呅
    结核病是艾滋病合并其他疾病中导致患者死亡的主要原因。其中结核病由结核分枝杆菌（Mycobacteriumtuberculosis,Mtb）感染引起，获得性免疫缺陷综合症（艾滋病）由人免疫缺陷病毒（Humanimmunodeficiencyvirustype1,HIV-1）感染引起。国家感染性疾病临床医学研究中心/深圳市第三人民医院张国良团队携手深圳华大生命科学研究院吴靓团队，共同研究得出单细胞测序
  • c++ 的iostream 和 c++的stdio的区别和联系 黄卷青灯77 c++算法开发语言iostreamstdio
    在C++中，iostream和C语言的stdio.h都是用于处理输入输出的库，但它们在设计、用法和功能上有许多不同。以下是两者的区别和联系：区别1.编程风格iostream（C++风格）：C++标准库中的输入输出流类库，支持面向对象的输入输出操作。典型用法是cin（输入）和cout（输出），使用>操作符来处理数据。更加类型安全，支持用户自定义类型的输入输出。#includeintmain(){in
  • 瑶池防线 谜影梦蝶
    冥华虽然逃过了影梦的军队，但他是一个忠臣，他选择上报战况。败给影梦后成逃兵，高层亡尔还活着，七重天失守......随便一条，即可处死冥华。冥华自然是知道以仙界高层的习性此信一发自己必死无疑，但他还选择上报实情，因为责任。同样此信送到仙宫后，知道此事的人，大多数人都认定冥华要完了，所以上到仙界高层，下到扫大街的，包括冥华自己，全都准备好迎接冥华之死。如果仙界现在还属于两方之争的话，冥华必死无疑。然而
  • 爬山后遗症 璃绛
    爬山，攀登，一步一步走向制高点，是一种挑战。成功抵达是一种无法言语的快乐，在山顶吹吹风，看看风景，这是从未有过的体验。然而，爬山一时爽，下山腿打颤，颠簸的路，一路向下走，腿部力量不够，走起来抖到不行，停不下来了！第二天必定腿疼，浑身酸痛，坐立难安！
  • LeetCode[位运算] - #137 Single Number II Cwind javaAlgorithmLeetCode题解位运算
    原题链接：#137 Single Number II  要求： 给定一个整型数组，其中除了一个元素之外，每个元素都出现三次。找出这个元素 注意：算法的时间复杂度应为O(n)，最好不使用额外的内存空间   难度：中等   分析： 与#136类似，都是考察位运算。不过出现两次的可以使用异或运算的特性 n XOR n = 0, n XOR 0 = n，即某一
  • 《JavaScript语言精粹》笔记 aijuans JavaScript
    0、JavaScript的简单数据类型包括数字、字符创、布尔值（true/false）、null和undefined值，其它值都是对象。 1、JavaScript只有一个数字类型，它在内部被表示为64位的浮点数。没有分离出整数，所以1和1.0的值相同。 2、NaN是一个数值，表示一个不能产生正常结果的运算结果。NaN不等于任何值，包括它本身。可以用函数isNaN(number)检测NaN,但是
  • 你应该更新的Java知识之常用程序库 Kai_Ge java
    在很多人眼中，Java 已经是一门垂垂老矣的语言，但并不妨碍 Java 世界依然在前进。如果你曾离开 Java，云游于其它世界，或是每日只在遗留代码中挣扎，或许是时候抬起头，看看老 Java 中的新东西。 Guava Guava[gwɑ:və]，一句话，只要你做Java项目，就应该用Guava（Github）。 guava 是 Google 出品的一套 Java 核心库，在我看来，它甚至应该
  • HttpClient 120153216 httpclient
    /** * 可以传对象的请求转发，对象已流形式放入HTTP中 */ public static Object doPost(Map<String,Object> parmMap,String url) { Object object = null; HttpClient hc = new HttpClient(); String fullURL
  • Django model字段类型清单 2002wmj django
    Django 通过 models 实现数据库的创建、修改、删除等操作，本文为模型中一般常用的类型的清单，便于查询和使用： AutoField：一个自动递增的整型字段，添加记录时它会自动增长。你通常不需要直接使用这个字段；如果你不指定主键的话，系统会自动添加一个主键字段到你的model。(参阅自动主键字段) BooleanField：布尔字段,管理工具里会自动将其描述为checkbox。 Cha
  • 在SQLSERVER中查找消耗CPU最多的SQL 357029540 SQL Server
    返回消耗CPU数目最多的10条语句 SELECT TOP 10    total_worker_time/execution_count AS avg_cpu_cost, plan_handle,    execution_count,    (SELECT SUBSTRING(text, statement_start_of
  • Myeclipse项目无法部署，Undefined exploded archive location 7454103 eclipseMyEclipse
    做个备忘！ 错误信息为：       Undefined exploded archive location 原因：           在工程转移过程中，导致工程的配置文件出错； 解决方法：    
  • GMT时间格式转换 adminjun GMT时间转换
    普通的时间转换问题我这里就不再罗嗦了，我想大家应该都会那种低级的转换问题吧，现在我向大家总结一下如何转换GMT时间格式，这种格式的转换方法网上还不是很多，所以有必要总结一下，也算给有需要的朋友一个小小的帮助啦。 1、可以使用 SimpleDateFormat SimpleDateFormat    EEE-三位星期 d-天 MMM-月 yyyy-四位年
  • Oracle数据库新装连接串问题 aijuans oracle数据库
    割接新装了数据库，客户端登陆无问题，apache/cgi-bin程序有问题，sqlnet.log日志如下： Fatal NI connect error 12170.   VERSION INFORMATION:         TNS for Linux: Version 10.2.0.4.0 - Product
  • 回顾java数组复制 ayaoxinchao java数组
    在写这篇文章之前，也看了一些别人写的，基本上都是大同小异。文章是对java数组复制基础知识的回顾，算是作为学习笔记，供以后自己翻阅。首先，简单想一下这个问题：为什么要复制数组？我的个人理解：在我们在利用一个数组时，在每一次使用，我们都希望它的值是初始值。这时我们就要对数组进行复制，以达到原始数组值的安全性。java数组复制大致分为3种方式：①for循环方式 ②clone方式 ③arrayCopy方
  • java web会话监听并使用spring注入 bewithme Java Web
            在java web应用中，当你想在建立会话或移除会话时，让系统做某些事情，比如说，统计在线用户，每当有用户登录时，或退出时，那么可以用下面这个监听器来监听。        import java.util.ArrayList; import java.ut
  • NoSQL数据库之Redis数据库管理(Redis的常用命令及高级应用) bijian1013 redis数据库NoSQL
    一 .Redis常用命令         Redis提供了丰富的命令对数据库和各种数据库类型进行操作，这些命令可以在Linux终端使用。         a.键值相关命令         b.服务器相关命令 1.键值相关命令       &
  • java枚举序列化问题 bingyingao java枚举序列化
    对象在网络中传输离不开序列化和反序列化。而如果序列化的对象中有枚举值就要特别注意一些发布兼容问题: 1.加一个枚举值 新机器代码读分布式缓存中老对象，没有问题，不会抛异常。 老机器代码读分布式缓存中新对像，反序列化会中断，所以在所有机器发布完成之前要避免出现新对象，或者提前让老机器拥有新增枚举的jar。 2.删一个枚举值 新机器代码读分布式缓存中老对象，反序列
  • 【Spark七十八】Spark Kyro序列化 bit1129 spark
    当使用SparkContext的saveAsObjectFile方法将对象序列化到文件，以及通过objectFile方法将对象从文件反序列出来的时候，Spark默认使用Java的序列化以及反序列化机制，通常情况下，这种序列化机制是很低效的，Spark支持使用Kyro作为对象的序列化和反序列化机制，序列化的速度比java更快，但是使用Kyro时要注意，Kyro目前还是有些bug。 Spark
  • Hybridizing OO and Functional Design bookjovi erlanghaskell
      推荐博文： Tell Above, and Ask Below - Hybridizing OO and Functional Design 文章中把OO和FP讲的深入透彻，里面把smalltalk和haskell作为典型的两种编程范式代表语言，此点本人极为同意，smalltalk可以说是最能体现OO设计的面向对象语言，smalltalk的作者Alan kay也是OO的最早先驱，
  • Java-Collections Framework学习与总结-HashMap BrokenDreams Collections
            开发中常常会用到这样一种数据结构，根据一个关键字，找到所需的信息。这个过程有点像查字典，拿到一个key，去字典表中查找对应的value。Java1.0版本提供了这样的类java.util.Dictionary(抽象类)，基本上支持字典表的操作。后来引入了Map接口，更好的描述的这种数据结构。  &nb
  • 读《研磨设计模式》-代码笔记-职责链模式-Chain Of Responsibility bylijinnan java设计模式
    声明： 本文只为方便我个人查阅和理解，详细的分析以及源代码请移步 原作者的博客http://chjavach.iteye.com/ /** * 业务逻辑：项目经理只能处理500以下的费用申请，部门经理是1000，总经理不设限。简单起见，只同意“Tom”的申请 * bylijinnan */ abstract class Handler { /*
  • Android中启动外部程序 cherishLC android
    1、启动外部程序 引用自： http://blog.csdn.net/linxcool/article/details/7692374 //方法一 Intent intent=new Intent(); //包名 包名+类名（全路径） intent.setClassName("com.linxcool", "com.linxcool.PlaneActi
  • summary_keep_rate coollyj SUM
    BEGIN /*DECLARE minDate varchar(20) ; DECLARE maxDate varchar(20) ;*/ DECLARE stkDate varchar(20) ; DECLARE done int default -1; /* 游标中 注册服务器地址 */ DE
  • hadoop hdfs 添加数据目录出错 daizj hadoophdfs扩容
    由于原来配置的hadoop data目录快要用满了，故准备修改配置文件增加数据目录，以便扩容，但由于疏忽，把core-site.xml, hdfs-site.xml配置文件dfs.datanode.data.dir 配置项增加了配置目录，但未创建实际目录，重启datanode服务时，报如下错误： 2014-11-18 08:51:39,128 WARN org.apache.hadoop.h
  • grep 目录级联查找 dongwei_6688 grep
           在Mac或者Linux下使用grep进行文件内容查找时，如果给定的目标搜索路径是当前目录，那么它默认只搜索当前目录下的文件，而不会搜索其下面子目录中的文件内容，如果想级联搜索下级目录，需要使用一个“-r”参数： grep -n -r "GET" .   上面的命令将会找出当前目录“.”及当前目录中所有下级目录
  • yii 修改模块使用的布局文件 dcj3sjt126com yiilayouts
    方法一：yii模块默认使用系统当前的主题布局文件，如果在主配置文件中配置了主题比如: 'theme'=>'mythm', 那么yii的模块就使用 protected/themes/mythm/views/layouts 下的布局文件； 如果未配置主题，那么 yii的模块就使用  protected/views/layouts 下的布局文件， 总之默认不是使用自身目录 pr
  • 设计模式之单例模式 come_for_dream 设计模式单例模式懒汉式饿汉式双重检验锁失败无序写入
                    今天该来的面试还没来，这个店估计不会来电话了，安静下来写写博客也不错，没事翻了翻小易哥的博客甚至与大牛们之间的差距，基础知识不扎实建起来的楼再高也只能是危楼罢了，陈下心回归基础把以前学过的东西总结一下。   *********************************
  • 8、数组 豆豆咖啡 二维数组数组一维数组
      一、概念       数组是同一种类型数据的集合。其实数组就是一个容器。   二、好处       可以自动给数组中的元素从0开始编号，方便操作这些元素   三、格式   //一维数组 1,元素类型[] 变量名 = new 元素类型[元素的个数] int[] arr =
  • Decode Ways hcx2013 decode
    A message containing letters from A-Z is being encoded to numbers using the following mapping: 'A' -> 1 'B' -> 2 ... 'Z' -> 26 Given an encoded message containing digits, det
  • Spring4.1新特性——异步调度和事件机制的异常处理 jinnianshilongnian spring 4.1
    目录 Spring4.1新特性——综述 Spring4.1新特性——Spring核心部分及其他 Spring4.1新特性——Spring缓存框架增强 Spring4.1新特性——异步调用和事件机制的异常处理 Spring4.1新特性——数据库集成测试脚本初始化 Spring4.1新特性——Spring MVC增强 Spring4.1新特性——页面自动化测试框架Spring MVC T
  • squid3(高命中率)缓存服务器配置 liyonghui160com
        系统:centos 5.x   需要的软件:squid-3.0.STABLE25.tar.gz 1.下载squid wget http://www.squid-cache.org/Versions/v3/3.0/squid-3.0.STABLE25.tar.gz tar zxf squid-3.0.STABLE25.tar.gz &&
  • 避免Java应用中NullPointerException的技巧和最佳实践 pda158 java
    1) 从已知的String对象中调用equals()和equalsIgnoreCase()方法，而非未知对象。 　　总是从已知的非空String对象中调用equals()方法。因为equals()方法是对称的，调用a.equals(b)和调用b.equals(a)是完全相同的，这也是为什么程序员对于对象a和b这么不上心。如果调用者是空指针，这种调用可能导致一个空指针异常 Object unk
  • 如何在Swift语言中创建http请求 shoothao httpswift
    概述：本文通过实例从同步和异步两种方式上回答了”如何在Swift语言中创建http请求“的问题。 如果你对Objective-C比较了解的话，对于如何创建http请求你一定驾轻就熟了，而新语言Swift与其相比只有语法上的区别。但是，对才接触到这个崭新平台的初学者来说，他们仍然想知道“如何在Swift语言中创建http请求？”。 在这里,我将作出一些建议来回答上述问题。常见的
  • Spring事务的传播方式 uule spring事务
    传播方式：        新建事务       required       required_new   - 挂起当前         非事务方式运行       supports   &nbs
按字母分类： ABCDEFGHIJKLMNOPQRSTUVWXYZ其他