常用注解的属性以及作用

1、@RequestMapping是一个用来处理请求地址映射的注解，可用于类或方法上。用于类上，表示类中的所有响应请求的方法都是以该地址作为父路径。

RequestMapping注解有六个属性，下面分成三类进行说明。

value， method
value： 指定请求的实际地址，指定的地址可以是具体地址、可以RestFul动态获取、也可以使用正则设置；

method： 指定请求的method类型， 分为GET、POST、PUT、DELETE等；

consumes，produces
consumes： 指定处理请求的提交内容类型（Content-Type），例如application/json, text/html;

produces: 指定返回的内容类型，仅当request请求头中的(Accept)类型中包含该指定类型才返回；

params，headers
params： 指定request中必须包含某些参数值是，才让该方法处理。

headers： 指定request中必须包含某些指定的header值，才能让该方法处理请求。
2、@ApiOperation和@ApiParam

@ApiOperation不是spring自带的注解是swagger里的 
com.wordnik.swagger.annotations.ApiOperation;

@ApiOperation和@ApiParam为添加的API相关注解，参数说明如下： 
@ApiOperation(value = “接口说明”, httpMethod = “接口请求方式”, response = “接口返回参数类型”, notes = “接口发布说明”）；其他参数可参考源码； 
@ApiParam(required = “是否必须参数”, name = “参数名称”, value = “参数具体描述”）

3、@Transactional

配置：https://www.cnblogs.com/xd502djj/p/10940627.html原理：https://blog.csdn.net/u013929527/article/details/102596243

Spring事务管理分为编码式和声明式两种，编程式指的是通过编码方式实现事务，声明式事务基于AOP，将具体业务逻辑与事务处理解耦。声明式事务管理使业务代码逻辑不受污染，因此再实际使用中声明式事务使用的较多。声明式事务有两种方式，一种是再配置文件中做相关的事务规则声明，另一种是基于@Transaction注解的方式。该注解提供以下方便：
1）根据你的配置，设置是否自动开启事务2）自动提交事务或者遇到异常回滚。

4、@Value注解

作用：通过注解将常量、配置文件中的值、其他bean的属性值注入到变量中，作为变量的初始值。

4.1 常量注入

    @Value("normal")

    private String normal; // 注入普通字符串

    @Value("classpath:com/config.txt")

    private Resource resourceFile; // 注入文件资源

    @Value("http://www.baidu.com")

    private Resource testUrl; // 注入URL资源

4.2 bean属性、系统属性、表达式注入

形式：@Value("#{}")

bean属性注入需要注入者和被注入者属于同一个IOC容器，或者父子IOC容器关系，在同一个作用域内。

    @Value("#{beanInject.another}")

    private String fromAnotherBean; // 注入其他Bean属性：注入beanInject对象的属性another，类具体定义见下面

    @Value("#{systemProperties['os.name']}")

    private String systemPropertiesName; // 注入操作系统属性

    @Value("#{ T(java.lang.Math).random() * 100.0 }")

    private double randomNumber; //注入表达式结果

4.3 配置文件属性注入

形式@Value("${}")

•application.properties。application.properties在spring boot启动时默认加载此文件

•自定义属性文件。自定义属性文件通过@PropertySource加载。@PropertySource可以同时加载多个文件，也可以加载单个文件。如果相同第一个属性文件和第二属性文件存在相同key，则最后一个属性文件里的key启作用。加载文件的路径也可以配置变量，如下文的${anotherfile.configinject}，此值定义在第一个属性文件config.properties

第一个属性文件config.properties内容如下： 
${anotherfile.configinject}作为第二个属性文件加载路径的变量值

book.name=bookName

anotherfile.configinject=placeholder

第二个属性文件config_placeholder.properties内容如下：

book.name.placeholder=bookNamePlaceholder

5、关于Mybatis的@Param注解

官方文档: http://www.mybatis.org/mybatis-3/zh/java-api.html  @param部分的说明:

@Param Parameter N/A 如果你的映射器的方法需要多个参数, 这个注解可以被应用于映射器的方法 参数来给每个参数一个名字。

否则,多 参数将会以它们的顺序位置来被命名 (不包括任何 RowBounds 参数) 比如。 #{param1} , #{param2} 等 , 这 是 默 认 的 。 使 用 @Param(“person”),参数应该被命名为 #{person}。

5.1、传递单个参数,不使用 @Param 注解

当只有一个参数时，java 接口在Mpper.java中不使用 @Param 注解，同时 mapper .xml中也不需要使用 parameterType 这个参数，Mybatis会 根据实体类(entity)的类型自动识别并匹配javaBean(这一部分在 spring配置文件关于数据源那一部分)

5.2、传递单个参数,使用@Param注解

当使用javaBean作为对象的时候，在写 SQL 语句的时候，必须指定参数类型 parameterType="com.ljq.cs.entity.Commodity"，同时在 #{ } 取值的时候不能直接填入 javaBean 的属性，必须这样使用 commodity.id ;否则，会抛出参数类型不匹配异常
如果不是 javaBean,则需要在写 SQL 语句的时候, #{ } 中的属性必须与 @Param中定义的一致，eg: @Param("username") , #{username} ,这样才可以

5.3、传递多个参数，使用 @Param 注解

当需要多个传参的时候，在mapper.java中设置多个@Param

    Suggest suggest(@Param("suggest")Suggest suggest,@Param("common")String common);
    

对应mapper.xml中的不同值。

 

此处学习链接：https://blog.csdn.net/Mrqiang9001/article/details/79520436