Spring Boot常用注解

@CrossOrigin( origins = {" http://localhost:3031"})
//origin : 允许可访问的域列表
//maxAge：准备响应前的缓存持续的最大时间(s)
//跨域(CROS)支持
@ApiOperation( value = "接口说明",
			httpMethod = "接口请求方式",
			response = "接口返回类型",
			notes = "")
//构建Api文档，作用在接口方法上
@Api(tags = " ")//作用在模块类上
@ApiParam("")//作用在参数、方法和字段上，必传参数用required = true 表示
@ApiModel("")//作用在模型类上
@ApiModelProperty( value = "属性说明",
					hidden = true)
//作用在类方法和属性上
@PathVariable//获取路径参数
//i.e. @PathVariable(value = "userId") Long userId
@RequestParam//获取路径参数，适用于GET请求中，接收元素，数组，集合，对象
//@RequestParam(require = true)表示是否必须传
@RequestBody
//用于读取Request请求的body部分，并且Content-Type为application/json格式的唯一数据
//一般用于POST请求中
//系统会使用HttpMessageConverter
//或者自定义的HttpMessageConverter将请求的body中的json字符串转换为java对象
//@RequestBOdy和RequestParam的区别：如果参数放在请求体中，传入后台需要@RequestBody接收。
//如果不是放在请求体中，传入后台用@RequestParam接收
@RestController//用于标注控制层组件，表示控制器是Bean,使用Restful风格
@Value("${property}")//读取比较简单的配置信息
@ConfigurationProperties//读取配置文件并与bean绑定，将配置文件中对应的配置映射到对象的属性中
//i.e.
@ConfigurationProperties(prefix = "papi.account.summary")
//该注解用于自动配置绑定，将对象注入到IOC容器中才有配置绑定的功能，标注在组件类上使用时一定要有组件注解
@Configuration//定义配置类，指出该类是Bean配置的信息源，相当于传统的xml配置文件
@EnableAutoConfiguration//允许SprongBoot自动配置注解，开启这个注解后SpringBoot就能根据当前路径下的包或者类配置SpringBean
@JsonFormat(shape = JsonFormat.Shape.STRING, 
			pattern = "yyyy-MM-dd 'T' HH:mm:ss.SSS 'Z'",
			timezone = "GMT")//格式化json数据
@JsonProperty//用于实体类属性上，在反序列化的时候给属性重命名
@Valid//用于校验，对前端传进来的参数进行判断检查。在自定义类的参数字段上，加上校验条件注解
@Component//隐式Bean定义
@Service//修饰service层组件
@Transactional//开启事务，若使用默认设置，那么抛出异常后事务会自动回滚，数据不会插入到数据库
@SpringBootTest//测试类，必填
//i.e.
@SprngBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDON_PORT)//随机端口
//Junit
@BeforeAll//在全部测试案例之前执行
@AfterAll//全部测试案例之后执行
@BeforeEach//每个单元测试@Test之前执行
@AfterEach//每个单元测试@Test之后执行

@WithMockUser//Spring Security提供的，模拟一个真实用户，并赋予权限
//OpenJPA注解
@ManyToMany //注解用来定义具有多对多多重性的多值关联。
//fetch：关联是应该延迟加载还是必须马上加载。
//EAGER 策略表示必须马上获取关联的实体
//LAZY 策略表示用到关联对象时才去加载
//cascade：指定级联到关联目标的操作。
//当目标集合是 java.util.Map 时，级联元素适用于映射值（即 Map 中的 value）。

@RestController
@RequestMapping("/nation")
public class NationController{
	@ApiOperation("XXX")
	@GetMapping("/page.do")
	public List<Nation> page(@ApiParam("name") String name,
							 @ApiParam(value = "" , required = true) int pageNo){
			Logger logger = LoggerFactory.getLogger(SIController.class);
			List<Nation> list = new ArrayList<>();
			Nation nation = new Nation("" , 2 , "" , new Date() , new Date());
			list.add(nation);
			return list;
			}
}

-----------------------------------------------------美丽的分割线----------------------------------------------------