Web 开发

<dependency>
    <groupId>top.continew.starter</groupId>
    <artifactId>continew-starter-web</artifactId>
</dependency>

continew-starter:
  web:
    cors:
      # 是否启用跨域配置（默认：false）
      enabled: true
      # 允许跨域的域名（Ant 风格通配符模式，与 allowed-origins 互斥，配置后仅本项生效）
      allowed-origin-patterns:
        - https://*.example.com
      # 允许跨域的域名（默认：*）
      allowed-origins: '*'
      # 允许跨域的请求方式（默认：*）
      allowed-methods: '*'
      # 允许跨域的请求头（默认：*）
      allowed-headers: '*'
      # 允许跨域的响应头
      exposed-headers: '*'

@EnableGlobalResponse
@SpringBootApplication
public class ExampleApplication {

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

continew-starter:
  web:
    response:
      # 是否开启国际化（默认：false）
      i18n: false
      # 失败时的 HTTP 状态码（默认：200，建议业务状态码与通信状态码区分）
      default-http-status-code-on-error: 200
      # 成功响应码（默认：0）
      default-success-code: 0
      # 成功提示（默认：ok）
      default-success-msg: ok
      # 失败响应码（默认：1）
      default-error-code: 1
      # 失败提示（默认：error）
      default-error-msg: error
      # 参数校验失败响应码（默认取 default-error-code）
      default-validate-error-code:
      # 是否打印异常日志（默认：false）
      print-exception-in-global-advice: false
      # 是否将原生异常错误信息填充到响应信息中（默认：false）
      origin-exception-using-detail-message: false
      # 例外包路径（支持数字、* 和 ** 通配符匹配），该包路径下的 Controller 将被忽略处理
      exclude-packages:
        - io.swagger.**
        - org.springdoc.**
        - org.springframework.boot.actuate.*

{
  "code": "0",
  "msg": "ok",
  "success": true,
  "timestamp": 1691453288000,
  "data": {}
}

@Bean
public GlobalResponseFactory globalResponseFactory() {
    return new GlobalResponseFactory() {

        @Override
        public Object newSuccess(Object data) {
            return new CustomResponse(200, data, null);
        }

        @Override
        public Object newFailure(String code, String msg) {
            return new CustomResponse(code, null, msg);
        }

        @Override
        public boolean isResponse(Object body) {
            return body instanceof CustomResponse;
        }

        @Override
        public String getCode(Object body) {
            return String.valueOf(((CustomResponse) body).getStatus());
        }

        @Override
        public void setMessage(Object body, String message) {
            ((CustomResponse) body).setMessage(message);
        }
    };
}

@ExcludeFromGlobalResponse
@GetMapping("/download")
public void download(HttpServletResponse response) {
    // 直接输出文件流
}

continew-starter:
  web:
    response:
      exception-alias-config-map:
        "[java.lang.IllegalStateException]":
          code: 4001
          msg: 状态异常
          http-status-code: 418

@ExceptionAliasFor(aliasFor = IllegalStateAliasException.class, code = "4001", msg = "状态异常")
public class IllegalStateAliasException extends RuntimeException {
}

@Bean
public ExceptionAliasRegister exceptionAliasRegister() {
    return new ExceptionAliasRegister().doRegisterExceptionAlias(IllegalStateAliasException.class);
}

spring:
  messages:
    # 消息文件基名，同时也是参数校验消息的基名
    basename: i18n/messages
    encoding: UTF-8

continew-starter:
  web:
    response:
      i18n: true

0=操作成功
1=服务器异常，请联系管理员

server:
  extension:
    # 是否启用（默认：true）
    enabled: true
    # 不允许的请求方式（默认禁用 CONNECT、TRACE、TRACK）
    disallowed-methods:
      - CONNECT
      - TRACE
      - TRACK

server:
  tomcat:
    # HTTP POST 请求内容大小上限（-1 不限制）
    max-http-form-post-size: -1
    threads:
      # 最大工作线程数
      max: 256