Spring註解(轉載&補充)
Spring部分
1.宣告bean的註解
@Component 元件,沒有明確的角色
@Service 在業務邏輯層使用(service層)
@Repository 在資料訪問層使用(dao層)
@Controller 在展現層使用,控制器的宣告(C)
2.注入bean的註解
@Autowired:由Spring提供
@Inject:由JSR-330提供
@Resource:由JSR-250提供
都可以註解在set方法和屬性上,推薦註解在屬性上(一目瞭然,少寫程式碼)。
3.java配置類相關注解
@Bean 註解在方法上,聲明當前方法的返回值為一個bean,替代xml中的方式(方法上)
@Configuration 聲明當前類為配置類,其中內部組合了@Component註解,表明這個類是一個bean(類上)
@Import 匯入一個類中的配置,此類不載入進beanFactory容器中。
@ComponentScan 用於對Component進行掃描,相當於xml中的(類上)
@WishlyConfiguration 為@Configuration與@ComponentScan的組合註解,可以替代這兩個註解
4.切面(AOP)相關注解
Spring支援AspectJ的註解式切面程式設計。
@Aspect 宣告一個切面(類上) 使用@After、@Before、@Around定義建言(advice),可直接將攔截規則(切點)作為引數。
@After 在方法執行之後執行(方法上) @Before 在方法執行之前執行(方法上) @Around 在方法執行之前與之後執行(方法上)
@PointCut 宣告切點 在java配置類中使用@EnableAspectJAutoProxy註解開啟Spring對AspectJ代理的支援(類上)
[email protected]的屬性支援
@Scope 設定Spring容器如何新建Bean例項(方法上,得有@Bean) 其設定型別包括:
Singleton (單例,一個Spring容器中只有一個bean例項,預設模式), Protetype (每次呼叫新建一個bean), Request (web專案中,給每個http request新建一個bean), Session (web專案中,給每個http session新建一個bean), GlobalSession(給每一個 global http session新建一個Bean例項)
@StepScope 在Spring Batch中還有涉及
@PostConstruct 由JSR-250提供,在建構函式執行完之後執行,等價於xml配置檔案中bean的initMethod
@PreDestory 由JSR-250提供,在Bean銷燬之前執行,等價於xml配置檔案中bean的destroyMethod
@Value 為屬性注入值(屬性上) 支援如下方式的注入: 》注入普通字元
@Value("Michael Jackson")String name;
》注入作業系統屬性
@Value("#{systemProperties['os.name']}")String osName;
》注入表示式結果
@Value("#{ T(java.lang.Math).random() * 100 }") String randomNumber;
》注入其它bean屬性
@Value("#{domeClass.name}")String name;
》注入檔案資源
@Value("classpath:com/hgs/hello/test.txt")String Resource file;
》注入網站資源
@Value("http://www.cznovel.com")Resource url;
》注入配置檔案
Value("${book.name}")String bookName;
注入配置使用方法: ① 編寫配置檔案(test.properties)
book.name=《三體》
② @PropertySource 載入配置檔案(類上)
@PropertySource("classpath:com/hgs/hello/test/test.propertie")
③ 還需配置一個PropertySourcesPlaceholderConfigurer的bean。
7.環境切換
@Profile 通過設定Environment的ActiveProfiles來設定當前context需要使用的配置環境。(類或方法上)
@Conditional Spring4中可以使用此註解定義條件話的bean,通過實現Condition介面,並重寫matches方法,從而決定該bean是否被例項化。(方法上)
8.非同步相關
@EnableAsync 配置類中,通過此註解開啟對非同步任務的支援,敘事性AsyncConfigurer介面(類上)
@Async 在實際執行的bean方法使用該註解來申明其是一個非同步任務(方法上或類上所有的方法都將非同步,需要@EnableAsync開啟非同步任務)
9.定時任務相關
@EnableScheduling 在配置類上使用,開啟計劃任務的支援(類上)
@Scheduled 來申明這是一個任務,包括cron,fixDelay,fixRate等型別(方法上,需先開啟計劃任務的支援)
[email protected]*註解說明
這些註解主要用來開啟對xxx的支援。 @EnableAspectJAutoProxy 開啟對AspectJ自動代理的支援
@EnableAsync 開啟非同步方法的支援
@EnableScheduling 開啟計劃任務的支援
@EnableWebMvc 開啟Web MVC的配置支援
@EnableConfigurationProperties 開啟對@ConfigurationProperties註解配置Bean的支援
@EnableJpaRepositories 開啟對SpringData JPA Repository的支援
@EnableTransactionManagement 開啟註解式事務的支援
@EnableTransactionManagement 開啟註解式事務的支援
@EnableCaching 開啟註解式的快取支援
11.測試相關注解
@RunWith 執行器,Spring中通常用於對JUnit的支援
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration 用來載入配置ApplicationContext,其中classes屬性用來載入配置類
@ContextConfiguration(classes={TestConfig.class})
SpringMVC部分
@EnableWebMvc 在配置類中開啟Web MVC的配置支援,如一些ViewResolver或者MessageConverter等,若無此句,重寫WebMvcConfigurerAdapter方法(用於對SpringMVC的配置)。
@Controller 宣告該類為SpringMVC中的Controller
@RequestMapping 用於對映Web請求,包括訪問路徑和引數(類或方法上)
@ResponseBody 支援將返回值放在response內,而不是一個頁面,通常使用者返回json資料(返回值旁或方法上)
@RequestBody 允許request的引數在request體中,而不是在直接連線在地址後面。(放在引數前)
@PathVariable 用於接收路徑引數,比如@RequestMapping(“/hello/{name}”)申明的路徑,將註解放在引數中前,即可獲取該值,通常作為Restful的介面實現方法。
@RestController 該註解為一個組合註解,相當於@Controller和@ResponseBody的組合,註解在類上,意味著,該Controller的所有方法都預設加上了@ResponseBody。
@ControllerAdvice 通過該註解,我們可以將對於控制器的全域性配置放置在同一個位置,註解了@Controller的類的方法可使用@ExceptionHandler、@InitBinder、@ModelAttribute註解到方法上, 這對所有註解了 @RequestMapping的控制器內的方法有效。
@ExceptionHandler 用於全域性處理控制器裡的異常
@InitBinder 用來設定WebDataBinder,WebDataBinder用來自動繫結前臺請求引數到Model中。
@ModelAttribute 本來的作用是繫結鍵值對到Model裡,在@ControllerAdvice中是讓全域性的@RequestMapping都能獲得在此處設定的鍵值對。