此篇为项目作结之笔记,关于注解。
项目启动入口
@SpringBootApplication[必选]
取消SpringBoot启动时默认检查的数据库连接配置
@SpringBootApplication(exclude={DataSourceAutoConfiguration.class,HibernateJpaAutoConfiguration.class})
@ServletComponentScan[可选]
注解后: Servlet、Filter、Listener 可以直接通过 * @WebServlet、@WebFilter、@WebListener 注解自动注册,无需其他代码。
@RunWith(SpringRunner.class) //与@SpringBootTest测试时,搭配使用
@SpringBootTest
路由与网络
@Controller
@RestController
@ResponseBody //组合控制器[@Controller + @ResponseBody]
// 返回结果直接写入HTTP response body中,响应输出json、非html格式输出时需要此注解
//比如:异步获取json数据,加上@responsebody后,会直接返回json数据
@RequestMapping(value= {"/helloworld/{pathItem}", "/hw/{pathItem}"}, method = RequestMethod.GET) //改成POST时,此URL访问将失败
@GetMapping(value={"/duapc", "/duapc"})
@PostMapping(value="")
@PathVariable("id") //用于将请求URL中的模板变量映射到功能处理方法的参数上
serviceName{@PathVariable("id") Integer ID)
+ 配置url和方法的一个关系@RequestMapping("servicePath/{pathItem}")【必须配合使用】
@RequestParam("param") //获取请求参数的值
serviceName{@RequestParam("param") Integer Param)
@CrossOrigin 解决细粒度(到具体某个/某些action级)的配置跨域
数据持久层
【Hibernate】
@Entity
说明这个class是实体类,并且使用默认的orm规则,即class名即数据库表中表名,class字段名即表中的字段名
注意:实体类必须用 @javax.persistence.Entity 进行注解
如果想改变这种默认的orm规则,就要使用:
@Table来改变class名与数据库中[表名]的映射规则;
@Column来改变class中字段名与db中表的[字段名]的映射规则
@Table(name="tb_boy")
指定了Entity所要映射带数据库表,其中@Table.name()用来指定映射表的表名。
如果缺省@Table注释,系统默认采用类名作为映射表的表名。
实体Bean的每个实例代表数据表中的一行数据,行中的一列对应实例中的一个属性。
@Id
@GeneratedValue //定义了标识字段生成方式,默认自增
@Column(name="pk_boy_id")注释定义了将成员属性映射到关系表中的哪一列和该列的结构信息,属性如下:
1)name:映射的列名。如:映射tbl_user表的name列,可以在name属性的上面或getName方法上面加入;
2)unique:是否唯一;
3)nullable:是否允许为空;
4)length:对于字符型列,length属性指定列的最大字符长度;
5)insertable:是否允许插入;
6)updatetable:是否允许更新;
7)columnDefinition:定义建表时创建此列的DDL;Eg:columnDefinition="varchar(30) comment '主键'"
8)secondaryTable:从表名。如果此列不建在主表上(默认是主表),该属性定义该列所在从表的名字。
@OneToOne(fetch = FetchType.LAZY, cascade=CascadeType.ALL)//
@Where(clause = "is_delete=0")
@JoinColumn(name = "fk_boy_id", referencedColumnName = "pk_boy_id")
//永远为主控端
//boy中的fk_boy_id字段参考boy表中的pk_boy_id字段
@Temporal(value=TemporalType.TIME)
指定java.util.Date或java.util.Calender属性与数据库类型date、time或timestamp中的那一种类型进行映射
@Transient //临时字段,映射时忽略
//其他
@JsonIgnore //在不需要的转化json的属性上面设置@JsonIgnore,避免出现无线循环
Spring IOC容器
特别注:如无特别配置,Spring IOC无法主动注入Bean到Filter或者拦截器
@Value("${cupSize}") // 绑定application.yml配置文件中的属性到Spring容器中
不通过配置文件的注入属性的情况
Eg:@Value("${object.name}") or @Value("hello world")
通过@Value将外部的值动态注入到Bean中,使用的情况有:
- 注入普通字符串
- 注入操作系统属性
- 注入表达式结果
- 注入其他Bean属性:注入beanInject对象的属性another
- 注入文件资源
注入URL资源
@Autowired //从容器中取值,对类成员变量、方法及构造函数进行标注,完成自动装配的工作
//从Spring容器取值使用【前提:Component生效】
@Component:
将本Bean置入Spring容器中,形成绑定
把普通pojo实例化到spring容器中,相当于配置文件中的<bean id="" class=""/>
定义Spring管理Bean.
@Component("beanName")//可附加指定Bean的名字
@Configuration
@Configuration中所有带@Bean注解的方法都会被动态代理,调用该方法返回的都是同一个实例。
@Configuration注解本质上还是@Component
@ConfigurationProperties(prefix="boy")
使本Bean与application.yml配置文件中前缀为boy的实体的属性值形成属性与值一一映射
即 将application.yml的属性值【通过本Bean形成实体规约】
@Component
@ConfigurationProperties(prefix="boy")
public class BoyProperties { ... }
//@Configuration中所有带@Bean注解的方法都会被动态代理,调用该方法返回的都是同一个实例。
//@Configuration注解本质上还是@Componen入无特别配置,Spring IOC无法主动注入Bean到Filter或者拦截器
推荐文献
[1] Spring Data JPA 之 一对一,一对多,多对多 关系映射
[2] [十]SpringBoot 之 普通类获取Spring容器中的bean
[3] 从content-type设置看Spring MVC处理header的一个坑
[4] 取消spring boot启动时连接数据库配置
[5] spring boot 搭建web项目常见五种返回形式