@Conditional 满足条件给容器注册Bean（在配置类 @Configuration 的类和方法上配置）
需要实现Condition接口, 实现matches方法
public class LdCondition implements Condition{
@Override
public boolean matches(ConditionContext context,AnnotatedTypeMetadata metadata) {
Environment environment = context.getEnvironment();
//从这里获取配置文件中 active 的值，根据当前的 active 值决定是否加载类
String[] activeProfiles = environment.getActiveProfiles();
for (String active : activeProfiles) {
if(active.equals(ActiveEnum.open_active.getActive().toString())){
return true;
}
}
return false;
}
}
标注在类上：
一个类中可以注入很多实例，@Conditional标注在类上就决定了一批bean是否注入。
标记在方法上
@Configuration
public class BeanConfig {
//只有一个类时，大括号可以省略
//如果LdCondition的实现方法返回true，则注入这个bean
@Conditional({LdCondition.class})
@Bean("person")
public Person person(){
return new Person("ld",22);
}
}
@ConditionalOnMissingBean：
容器中没有就注入，有就不注入。
@ConditionalOnMissingBean：
容器中没有就不注入，有就注入。
FilterRegistrationBean 自定义过滤器（配置类 @Configuration 中）
使用FilterRegistrationBean来注册Filter：
@Bean
public FilterRegistrationBean<CorsFilter> corsFilter() {
FilterRegistrationBean<CorsFilter> corsFilter = new FilterRegistrationBean<>();
//设置优先级
corsFilter.setOrder(Ordered.HIGHEST_PRECEDENCE + 10);
//注册过滤器
corsFilter.setFilter(new CorsFilter());
//拦截路径
corsFilter.addUrlPatterns("/api/*");
return corsFilter;
}
SpringBoot 整合 Swagger2（配置类 @Configuration 上）
依赖：
implementation "io.springfox:springfox-swagger2:$swaggerVersion"
implementation "io.springfox:springfox-swagger-ui:$swaggerVersion"
一般 swagger 需要的权限（需要在对应的模块进行排除）：
http://localhost:8080/swagger-resources/configuration/ui
http://localhost:8080/swagger-resources
http://localhost:8080/api-docs
http://localhost:8080/swagger-ui.html
http://localhost:8080/swagger-resources/configuration/security
registry.addResourceHandler("swagger-ui.html")
.addResourceLocations("classpath:/META-INF/resources/");
registry.addResourceHandler("/webjars/**")
.addResourceLocations("classpath:/META-INF/resources/webjars/");
@Api("评论接口")：
用在类上，说明该类的作用
@ApiOperation(value="获取评论", notes="根据id获取评论")：
用在方法上，说明方法的作用，标注在具体请求上。
value和notes的作用差不多，都是对请求进行说明；
tags则是对请求进行分类的，
比如你有好几个controller，分别属于不同的功能模块，那这里我们就可以使用tags来区分了。
@ApiImplicitParams：
用在方法上包含一组参数说明。
@ApiImplicitParam(name = "id", value = "12", required = true, dataType = "String")：
用在@ApiImplicitParams注解中，指定一个请求参数的各个方面。
@ApiResponses：
用于表示一组响应
@ApiResponse：
用在@ApiResponses中，一般用于表达一个错误的响应信息。
@ApiModel：
描述一个Model的信息
这种一般用在post创建的时候，使用@RequestBody这样的场景，请求参数无法使用@ApiImplicitParam注解进行描述时。
表明这是一个被swagger框架管理的model，用于class上。
@ApiModelProperty：
描述一个model的属性，就是标注在被标注了@ApiModel的class的属性上，
这里的value是对字段的描述，example是取值例子。
Swagger2配置：
@EnableSwagger2
@Configuration
public class SwaggerConfiguration {
@Bean
public Docket haloDefaultApi() {
return buildApiDocket("content",
"api.content",
"/api/content/**");
}
@Bean
public Docket haloAdminApi() {
return buildApiDocket("admin",
"api.admin",
"/api/admin/**");
}
private Docket buildApiDocket(@NonNull String groupName, @NonNull String basePackage, @NonNull String antPattern) {
Assert.hasText(groupName, "Group name must not be blank");
Assert.hasText(basePackage, "Base package must not be blank");
Assert.hasText(antPattern, "Ant pattern must not be blank");
return new Docket(DocumentationType.SWAGGER_2)
.groupName(groupName)
.select()
.apis(RequestHandlerSelectors.basePackage(basePackage))
.paths(PathSelectors.ant(antPattern))
.build()
.apiInfo(apiInfo());
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("API Documentation")
.description("Documentation for API")
.version("1.0")
.build();
}
}
启动后访问：
http://localhost:8080/swagger-ui.html
@EnableWebMvc 用于导入 Spring Web MVC configuration（配置类 @Configuration 上）
将此注释添加到 @Configuration 类将导入来自 WebMvcConfigurationSupport 的 Spring MVC配置。
@EnableWebMvc == @Import({DelegatingWebMvcConfiguration.class})
@Configuration
@EnableWebMvc
@ComponentScan(basePackages = "controller")
@PropertySource(value = "classpath:application.yaml", ignoreResourceNotFound = true, encoding = "UTF-8")
public class WebMvcAutoConfiguration implements WebMvcConfigurer {
//文件协议
private static final String FILE_PROTOCOL = "file:///";
//配置信息实体
private final HaloProperties haloProperties;
//自动注入HaloProperties
public WebMvcAutoConfiguration(HaloProperties haloProperties) {
this.haloProperties = haloProperties;
}
/**
* Spring Boot底层通过HttpMessageConverters（依靠Jackson库）将Java实体类输出为JSON格式。
*
* MappingJackson2HttpMessageConverter可以将Java对象转换为application/json。
*/
@Override
public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
converters.stream()
.filter(c -> c instanceof MappingJackson2HttpMessageConverter)
// ifPresent()：如果存在一个值，则使用该值执行给定的操作，否则什么也做不成
.findFirst().ifPresent(converter ->
{
// MappingJackson2HttpMessageConverter：读写Json转换器
MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter = (MappingJackson2HttpMessageConverter) converter;
Jackson2ObjectMapperBuilder builder = Jackson2ObjectMapperBuilder.json();
// JsonComponentModule 来扫描被 @JsonComponent 注解的类，
// 并自动注册 JsonSerializer 和 JsonDeserializer。
JsonComponentModule module = new JsonComponentModule();
// addSerializer()：为序列化模块添加自定义序列化程序来处理特定类型的值。
// PageJacksonSerializer：Page对象的序列化
module.addSerializer(PageImpl.class, new PageJacksonSerializer());
// builder.modules()：指定序列化模块
ObjectMapper objectMapper = builder.modules(module).build();
// 设置自定义 objectMapper，未设置则使用默认 objectMapper
mappingJackson2HttpMessageConverter.setObjectMapper(objectMapper);
});
}
/**
* 自定义参数处理器
*/
@Override
public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
resolvers.add(new AuthenticationArgumentResolver());
}
/**
* 配置静态资源路径
*/
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
String workDir = FILE_PROTOCOL + haloProperties.getWorkDir();
//映射 /** 的请求到 addResourceLocations() 指定的目录
registry.addResourceHandler("/**")
.addResourceLocations(workDir + "templates/themes/")
}
/**
* 添加转换器（Converter）和格式器（Formatters）
*/
@Override
public void addFormatters(FormatterRegistry registry) {
//ConverterFactory：range范围转换器的工厂（可以将对象从S转换为R的子类型）
registry.addConverterFactory(new StringToEnumConverterFactory());
}
/**
* 配置 freemarker
*/
@Bean
public FreeMarkerConfigurer freemarkerConfig(HaloProperties haloProperties) throws IOException, TemplateException {
FreeMarkerConfigurer configurer = new FreeMarkerConfigurer();
//设置模板路径与字符集
configurer.setTemplateLoaderPaths(FILE_PROTOCOL + haloProperties.getWorkDir() + "templates/", "classpath:/templates/");
configurer.setDefaultEncoding("UTF-8");
Properties properties = new Properties();
properties.setProperty("auto_import", "/common/macro/common_macro.ftl as common,/common/macro/global_macro.ftl as global");
configurer.setFreemarkerSettings(properties);
return configurer;
}
/**
* 配置视图解析器来转换基于字符串的视图名称
*/
@Override
public void configureViewResolvers(ViewResolverRegistry registry) {
FreeMarkerViewResolver resolver = new FreeMarkerViewResolver();
resolver.setCache(false);
resolver.setSuffix(HaloConst.SUFFIX_FTL);
resolver.setContentType("text/html; charset=UTF-8");
registry.viewResolver(resolver);
}
}
@PropertySource 加载指定的配置文件到 Spring 的 Environment 中（配置类 @Configuration 上）
@PropertySource(value = "classpath:application.yaml",
ignoreResourceNotFound = true, encoding = "UTF-8") //true表示属性源是可选的
用于 PropertySource 在 Spring 的上 添加 Environment。与 @Configuration 类一起使用。
获取配置文件中的值通过 Environment 具体使用方法：
@Autowired
private Environment env;
或者
使用 @value 注解，从配置文件读取值：
@Value("${test.value}")
HandlerMethodArgumentResolver 自定义参数解析
自定义解析器需要实现 HandlerMethodArgumentResolver 接口。
实现自定义参数解析器步骤：1、自定义注解 2、自定义参数解析器 3、注册 4、在需要注入属性的 controller 添加注解
自定义注解：
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.PARAMETER)
public @interface UserToken {String value() default "user";}
自定义参数解析器：
@Component
public class AuthenticationArgumentResolver implements HandlerMethodArgumentResolver {
/**
* 解析器是否支持当前参数
*/
@Override
public boolean supportsParameter(MethodParameter parameter) {
// 指定参数如果被应用 UserToken 注解，则使用该解析器。
// 如果直接返回true，则代表将此解析器用于所有参数
return parameter.hasParameterAnnotation(UserToken.class);
}
@Override
public Object resolveArgument(MethodParameter parameter,
ModelAndViewContainer mavContainer,
NativeWebRequest webRequest,
WebDataBinderFactory binderFactory) {}
}
注册：
public class WebMvcAutoConfiguration implements WebMvcConfigurer {
@Override
public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
resolvers.add(new AuthenticationArgumentResolver());
}
}
序列化和反序列化
层次低的一种是 Byte <---> Message，二进制与程序内部消息对象之间的转换，就是常见的序列化/反序列化。
另外一种是 Message <---> Message，程序内部对象之间的转换，比较高层次的序列化/反序列化。
Http序列化和反序列化（高层次）的核心是HttpMessageConverter。
@JsonSerialize @JsonDeserialize @JsonComponent
如果使用 Jackson 序列化和反序列化 JSON 数据，
您可能需要编写自己的 JsonSerializer 和 JsonDeserializer 类。
自定义序列化程序通常通过模块向 Jackson 注册，
但 Spring Boot 提供了另一种 @JsonComponent 注释，可以更容易地直接注册 Spring Beans。
您可以直接在 JsonSerializer 或 JsonDeserializer 实现上使用 @JsonComponent 注释。
您还可以在包含 JsonSerializer 或 JsonDeserializer 作为内部类的类上使用它。
@JsonSerialize：
可以实现数据转换功能，此注解用于属性或者 getter() 方法上。
@JsonDeserialize：
此注解用于属性或者 setter() 方法上，用于在反序列化时可以嵌入我们自定义的代码。
@JsonComponent：
注释允许我们将带注释的类公开为Jackson序列化器和/或反序列化器，而无需手动将其添加到ObjectMapper。
@JsonSerialize(using = JsonDateSerialize.class)
@JsonDeserialize(using = JsonDateDeserialize.class)
private Date birthday;