注解(annotations)列表
- @ResponseBody
用该注解修饰的函数,会将结果直接填充到HTTP的响应体中,一般用于构建RESTful的api;
- @Controller
用于定义控制器类,在spring 项目中由控制器负责将用户发来的URL请求转发到对应的服务接口(service层)。
- @RestController
@ResponseBody和@Controller的合集
- @RequestMapping
提供路由信息,负责URL到Controller中的具体函数的映射。
- @Autowired
自动导入依赖的bean
- @Service
一般用于修饰service层的组件
- @Repository
使用@Repository注解可以确保DAO或者repositories提供异常转译,这个注解修饰的DAO或者repositories类会被ComponetScan发现并配置,同时也不需要为它们提供XML配置项。
8
@ComponentScan
你可以自由地使用任何标准的Spring框架技术去定义beans和它们注入的依赖。简单起见,我们经常使用 @ComponentScan 注解搜索beans,并结合 @Autowired 构造器注入。
如果使用上面建议的结构组织代码(将应用类放到根包下),你可以添加 @ComponentScan 注解而不需要任何参数。你的所有应用程序组件( @Component , @Service , @Repository , @Controller 等)将被自动注册为Spring Beans。
9.
@ConfigurationProperties
@Component@ConfigurationProperties(prefix="connection")
public
class
ConnectionSettings {
private
String username;
private
InetAddress remoteAddress;
// ... getters and setters
}
这个注解作用是把application.properties 里 前缀为connection 的属性赋值到到当前ConnectionSettings类创建的对象里。如果其他类中注入了这个类,则这个对象的username,remoteAddress两个属性是有值的。
@Component 是表示当前类为一个 组件。
正如使用@ConfigurationProperties注解一个类,你也可以在@Bean方法上使用它。当你需要绑定属性到不受你控制的第三方组件时,这种方式非常有用。
@ConfigurationProperties(prefix = "foo")@Bean
public
FooComponent fooComponent() {...}
和上面ConnectionSettings的示例方式相同,任何以foo为前缀的属性定义都会被映射到FooComponent上。
Spring Boot将尝试校验外部的配置,默认使用JSR-303(如果在classpath路径中)。你可以轻松的为你的@ConfigurationProperties类添加JSR-303 javax.validation约束注解:
@Component@ConfigurationProperties(prefix="connection")
public
class
ConnectionSettings {@NotNull
private
InetAddress remoteAddress;
// ... getters and setters
}
10
@Configuration
Spring Boot提倡基于Java的配置。尽管你可以使用一个XML源来调用 SpringApplication.run() ,我们通常建议你
1 使用 @Configuration 类作为主要源。一般定义 main 方法的类也是主要 @Configuration 的一个很好候选。
2你不需要将所有的 @Configuration 放进一个单独的类。
@Import 注解可以用来导入其他配置类。
@ImportResource 用来加载xml配置文件。
3 @ComponentScan 注解自动收集所有的Spring组件,包括 @Configuration 类。
4如果你绝对需要使用基于XML的配置,我们建议你仍旧从一个 @Configuration 类开始。你可以使用附加的 @ImportResource 注解加载XML配置文件。
5 @Configuration注解该类,等价 与XML中配置beans;用@Bean标注方法等价于XML中配置bean
6 @Configureation 注解的类里 一般会有
@ConfigurationProperties 注解标识的类 作为 属性。
11
@EnableConfigurationProperties
作用就是如果
@Configuration 类里注入了
@ConfigurationProperties标识的类。需要@EnableConfigurationProperties这个注解来 注册@ConfigurationProperties 标识的类。
当@EnableConfigurationProperties注解应用到你的@Configuration时,
任何被@ConfigurationProperties注解的beans将自动被Environment属性配置
你可以通过在@EnableConfigurationProperties注解中直接简单的列出属性类来快捷的注册@ConfigurationProperties bean的定义。
@Configuration@EnableConfigurationProperties(ConnectionSettings.
class
)
public
class
MyConfiguration {
ConnectionSettings connectionSettings;}
12
@Component和@Bean
@Component被用在要被自动扫描和装配的类上。@Component类中使用方法或字段时不会使用CGLIB增强(及不使用代理类:调用任何方法,使用任何变量,拿到的是原始对象)Spring 注解@Component等效于@Service,@Controller,@Repository
@Bean主要被用在方法上,来显式声明要用生成的类;用@Configuration注解该类,等价 与XML中配置beans;用@Bean标注方法等价于XML中配置bean。
现在项目上,本工程中的类,一般都使用
@Component
来生成bean。在把通过web service取得的类,生成Bean时,使用
@Bean
和getter方法来生成bean
13
@EnableAutoConfiguration注解
第二个类级别的注解是 @EnableAutoConfiguration 。这个注解告诉Spring Boot根据添加的jar依赖猜测你想如何配置Spring。由于 spring-boot-starter-web 添加了Tomcat和Spring MVC,所以auto-configuration将假定你正在开发一个web应用并相应地对Spring进行设置。Starter POMs和Auto-Configuration:设计auto-configuration的目的是更好的使用"Starter POMs",但这两个概念没有直接的联系。你可以自由地挑选starter POMs以外的jar依赖,并且Spring Boot将仍旧尽最大努力去自动配置你的应用。
你可以通过将 @EnableAutoConfiguration 或 @SpringBootApplication 注解添加到一个 @Configuration 类上来选择自动配置。
注:你只需要添加一个 @EnableAutoConfiguration 注解。我们建议你将它添加到主 @Configuration 类上。
@EnableAutoConfiguration 注解 会根据依赖的jar包判断需要执行 springboot 中哪些 已经实现好的autoConfig 类。这些类都是@Configuration 注解的,换句话说就是 根据依赖的jar 包判断需要加载哪些配置文件。
如果发现应用了你不想要的特定自动配置类,你可以使用 @EnableAutoConfiguration 注解的排除属性来禁用它们。
import
org.springframework.boot.autoconfigure.*;
import
org.springframework.boot.autoconfigure.jdbc.*;
import
org.springframework.context.annotation.*;@Configuration@EnableAutoConfiguration(exclude={DataSourceAutoConfiguration.
class
})
public
class
MyConfiguration {}
14
@SpringBootApplication
很多Spring Boot开发者总是使用 @Configuration , @EnableAutoConfiguration 和 @ComponentScan 注解他们的main类。由于这些注解被如此频繁地一块使用(特别是你遵循以上最佳实践时),Spring Boot提供一个方便的 @SpringBootApplication 选择。
该 @SpringBootApplication 注解等价于以默认属性使用 @Configuration , @EnableAutoConfiguration 和 @ComponentScan 。
package
com.example.myproject;
import
org.springframework.boot.SpringApplication;
import
org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication
// same as @Configuration @EnableAutoConfiguration @ComponentScan
public
class
Application {
public
static
void
main(String[] args) { SpringApplication.run(Application.
class
, args); }}
15
@Profiles
Spring Profiles提供了一种隔离应用程序配置的方式,并让这些配置只能在特定的环境下生效。任何@Component或@Configuration都能被@Profile标记,从而限制加载它的时机。
@Configuration@Profile("production")
public
class
ProductionConfiguration {
// ...
}
以正常的Spring方式,你可以使用一个spring.profiles.active的Environment属性来指定哪个配置生效。你可以使用平常的任何方式来指定该属性,例如,可以将它包含到你的application.properties中:
spring.profiles.active=dev,hsqldb