springboot中一些比較常用的註解總結
springboot常用註解
1、@SpringBootApplication
這個註解是Spring Boot最核心的註解,用在 Spring Boot的主類上,標識這是一個 Spring Boot 應用,用來開啟 Spring Boot 的各項能力。實際上這個註解是@Configuration,@EnableAutoConfiguration,@ComponentScan三個註解的組合。由於這些註解一般都是一起使用,所以Spring Boot提供瞭一個統一的註解@SpringBootApplication。
2、@EnableAutoConfiguration
允許 Spring Boot 自動配置註解,開啟這個註解之後,Spring Boot 就能根據當前類路徑下的包或者類來配置 Spring Bean。
如:當前類路徑下有 Mybatis 這個 JAR 包,MybatisAutoConfiguration 註解就能根據相關參數來配置 Mybatis 的各個 Spring Bean。
@EnableAutoConfiguration實現的關鍵在於引入瞭AutoConfigurationImportSelector,其核心邏輯為selectImports方法,邏輯大致如下:
● 從配置文件META-INF/spring.factories加載所有可能用到的自動配置類;
● 去重,並將exclude和excludeName屬性攜帶的類排除;
● 過濾,將滿足條件(@Conditional)的自動配置類返回;
3、@Configuration
用於定義配置類,指出該類是 Bean 配置的信息源,相當於傳統的xml配置文件,一般加在主類上。如果有些第三方庫需要用到xml文件,建議仍然通過@Configuration類作為項目的配置主類——可以使用@ImportResource註解加載xml配置文件。
4、@ComponentScan
組件掃描。讓spring Boot掃描到Configuration類並把它加入到程序上下文。
@ComponentScan註解默認就會裝配標識瞭@Controller,@Service,@Repository,@Component註解的類到spring容器中。
5、@Repository
用於標註數據訪問組件,即DAO組件。
使用@Repository註解可以確保DAO或者repositories提供異常轉譯,這個註解修飾的DAO或者repositories類會被ComponetScan發現並配置,同時也不需要為它們提供XML配置項。
6、@Service
一般用於修飾service層的組件
7、@RestController
用於標註控制層組件(如struts中的action),表示這是個控制器bean,並且是將函數的返回值直 接填入HTTP響應體中,是REST風格的控制器;它是@Controller和@ResponseBody的合集。
8、@ResponseBody
表示該方法的返回結果直接寫入HTTP response body中
一般在異步獲取數據時使用,在使用@RequestMapping後,返回值通常解析為跳轉路徑,加上@responsebody後返回結果不會被解析為跳轉路徑,而是直接寫入HTTP response body中。比如異步獲取json數據,加上@responsebody後,會直接返回json數據。
9、@Component
泛指組件,當組件不好歸類的時候,我們可以使用這個註解進行標註。
10、@Bean
相當於XML中的,放在方法的上面,而不是類,意思是產生一個bean,並交給spring管理。
11、@AutoWired
默認是byType方式。把配置好的Bean拿來用,完成屬性、方法的組裝,它可以對類成員變量、方法及構造函數進行標註,完成自動裝配的工作。
當加上(required=false)時,就算找不到bean也不報錯。
12、@Qualifier
當有多個同一類型的Bean時,可以用@Qualifier(“name”)來指定。與@Autowired配合使用
13、@Resource(name=”name”,type=”type”)
沒有括號內內容的話,默認byName,通過名稱找不到再去通過類型去查找。與@Autowired幹相似的事。
14、@RequestMapping
RequestMapping是一個用來處理請求地址映射的註解;提供路由信息,負責URL到Controller中的具體函數的映射,可用於類或方法上。用於類上,表示類中的所有響應請求的方法都是以該地址作為父路徑。
15、@RequestParam
用在方法的參數前面。例:
@RequestParam String a =request.getParameter("a")。
16、@PathVariable
路徑變量。參數用到入參,與大括號裡的名字一樣要相同。如:
RequestMapping("user/get/mac/{macAddress}") public String getById(@PathVariable String id){ .... }
17、@Profiles
Spring Profiles提供瞭一種隔離應用程序配置的方式,並讓這些配置隻能在特定的環境下生效。
任何@Component或@Configuration都能被@Profile標記,從而限制加載它的時機。
@Configuration @Profile("prod") public class ProductionConfiguration { // ... }
18、@ConfigurationProperties
Spring Boot可使用註解的方式將自定義的properties文件映射到實體bean中,比如config.properties文件。
@Data @ConfigurationProperties("rocketmq.consumer") public class RocketMQConsumerProperties extends RocketMQProperties { private boolean enabled = true; private String consumerGroup; private MessageModel messageModel = MessageModel.CLUSTERING; private ConsumeFromWhere consumeFromWhere = ConsumeFromWhere.CONSUME_FROM_LAST_OFFSET; private int consumeThreadMin = 20; private int consumeThreadMax = 64; private int consumeConcurrentlyMaxSpan = 2000; private int pullThresholdForQueue = 1000; private int pullInterval = 0; private int consumeMessageBatchMaxSize = 1; private int pullBatchSize = 32; }
19、@Conditional
這是 Spring 4.0 添加的新註解,用來標識一個 Spring Bean 或者 Configuration 配置文件,當滿足指定的條件才開啟配置。
相關註解:(
1)、@ConditionalOnBean
組合 @Conditional 註解,當容器中有指定的 Bean 才開啟配置。
2)、@ConditionalOnMissingBean
組合 @Conditional 註解,和 @ConditionalOnBean 註解相反,當容器中沒有指定的 Bean 才開啟配置。
3)、@ConditionalOnClass
組合 @Conditional 註解,當容器中有指定的 Class 才開啟配置。
4)、@ConditionalOnMissingClass
組合 @Conditional 註解,和 @ConditionalOnMissingClass 註解相反,當容器中沒有指定的 Class 才開啟配置。
5、@ConditionalOnWebApplication
組合 @Conditional 註解,當前項目類型是 WEB 項目才開啟配置。
當前項目有以下 3 種類型。
enum Type { /** * Any web application will match. */ ANY, /** * Only servlet-based web application will match. */ SERVLET, /** * Only reactive-based web application will match. */ REACTIVE }
6)、@ConditionalOnNotWebApplication
組合 @Conditional 註解,和 @ConditionalOnWebApplication 註解相反,當前項目類型不是 WEB 項目才開啟配置。
7)、@ConditionalOnProperty
組合 @Conditional 註解,當指定的屬性有指定的值時才開啟配置。
8)、@ConditionalOnExpression
組合 @Conditional 註解,當 SpEL 表達式為 true 時才開啟配置。
9)、@ConditionalOnJava
組合 @Conditional 註解,當運行的 Java JVM 在指定的版本范圍時才開啟配置。
10)、@ConditionalOnResource
組合 @Conditional 註解,當類路徑下有指定的資源才開啟配置。
11)、@ConditionalOnJndi
組合 @Conditional 註解,當指定的 JNDI 存在時才開啟配置。
12)、@ConditionalOnCloudPlatform
組合 @Conditional 註解,當指定的雲平臺激活時才開啟配置。
13)、@ConditionalOnSingleCandidate
組合 @Conditional 註解,當指定的 class 在容器中隻有一個 Bean,或者同時有多個但為首選時才開啟配置。
20、@ConfigurationProperties
用來加載額外的配置(如 .properties 文件),可用在 @Configuration
註解類,或者 @Bean
註解方法上面。
21、@EnableConfigurationProperties
一般要配合 @ConfigurationProperties
註解使用,用來開啟對 @ConfigurationProperties
註解配置 Bean 的支持。
22、@AutoConfigureAfter
用在自動配置類上面,表示該自動配置類需要在另外指定的自動配置類配置完之後。
如 Mybatis 的自動配置類,需要在數據源自動配置類之後。
@AutoConfigureAfter(DataSourceAutoConfiguration.class) public class MybatisAutoConfiguration {
23、@AutoConfigureBefore
這個和 @AutoConfigureAfter
註解使用相反,表示該自動配置類需要在另外指定的自動配置類配置之前。
24、@Import
這是 Spring 3.0 添加的新註解,用來導入一個或者多個 @Configuration
註解修飾的類,這在 Spring Boot 裡面應用很多。
25、@ImportResource
這是 Spring 3.0 添加的新註解,用來導入一個或者多個 Spring 配置文件,這對 Spring Boot 兼容老項目非常有用,因為有些配置無法通過 Java Config 的形式來配置就隻能用這個註解來導入。
到此這篇關於springboot中一些比較常用的註解總結的文章就介紹到這瞭,更多相關springboot註解內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!
推薦閱讀:
- 全面匯總SpringBoot和SpringClould常用註解
- java進階之瞭解SpringBoot的配置原理
- Spring Boot詳解配置文件有哪些作用與細則
- 聊聊SpringBoot自動裝配的魔力
- SpringBoot對不同Bean註解的區別和使用場景說明