Spring的一個(gè)核心功能是IOC枝恋,就是將Bean初始化加載到容器中,Bean是如何加載到容器的便斥,可以使用Spring注解方式或者Spring XML配置方式米愿。
Spring注解方式減少了配置文件內(nèi)容,更加便于管理短绸,并且使用注解可以大大提高了開(kāi)發(fā)效率车吹!
下面按照分類(lèi)講解Spring中常用的一些注解。
一醋闭、 組件類(lèi)注解
思考:Spring怎么知道應(yīng)該把哪些Java類(lèi)當(dāng)成bean注冊(cè)到容器中呢窄驹?
答案:使用配置文件或者注解的方式進(jìn)行標(biāo)識(shí)需要處理的java類(lèi)!
1、注解類(lèi)介紹
@Component :標(biāo)注一個(gè)普通的spring Bean類(lèi)目尖。
@Repository:標(biāo)注一個(gè)DAO組件類(lèi)馒吴。
@Service:標(biāo)注一個(gè)業(yè)務(wù)邏輯組件類(lèi)。
@Controller:標(biāo)注一個(gè)控制器組件類(lèi)瑟曲。
這些都是注解在平時(shí)的開(kāi)發(fā)過(guò)程中出鏡率極高饮戳,@Component、@Repository洞拨、@Service扯罐、@Controller實(shí)質(zhì)上屬于同一類(lèi)注解,用法相同烦衣,功能相同歹河,區(qū)別在于標(biāo)識(shí)組件的類(lèi)型。@Component可以代替@Repository花吟、@Service秸歧、@Controller,因?yàn)檫@三個(gè)注解是被@Component標(biāo)注的衅澈。如下代碼
@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component
public @interface Controller {
String value() default "";
}
2键菱、舉例詳解
(1)當(dāng)一個(gè)組件代表數(shù)據(jù)訪問(wèn)層(DAO)的時(shí)候,我們使用@Repository進(jìn)行注解今布,如下
@Repository
public class HappyDaoImpl implements HappyDao{
private final static Logger LOGGER = LoggerFactory.getLogger(HappyDaoImpl .class);
public void club(){
//do something ,like drinking and singing
}
}
(2)當(dāng)一個(gè)組件代表業(yè)務(wù)層時(shí)经备,我們使用@Service進(jìn)行注解拭抬,如下
@Service(value="goodClubService")
//使用@Service注解不加value ,默認(rèn)名稱(chēng)是clubService
public class ClubServiceImpl implements ClubService {
@Autowired
private ClubDao clubDao;
public void doHappy(){
//do some Happy
}
}
(3)當(dāng)一個(gè)組件作為前端交互的控制層,使用@Controller進(jìn)行注解侵蒙,如下
@Controller
public class HappyController {
@Autowired //下面進(jìn)行講解
private ClubService clubService;
// Control the people entering the Club
// do something
}
/*Controller相關(guān)的注解下面進(jìn)行詳細(xì)講解造虎,這里簡(jiǎn)單引入@Controller*/
3、總結(jié)注意點(diǎn)
1纷闺、被注解的java類(lèi)當(dāng)做Bean實(shí)例算凿,Bean實(shí)例的名稱(chēng)默認(rèn)是Bean類(lèi)的首字母小寫(xiě),其他部分不變急但。@Service也可以自定義Bean名稱(chēng)澎媒,但是必須是唯一的!
2波桩、盡量使用對(duì)應(yīng)組件注解的類(lèi)替換@Component注解,在spring未來(lái)的版本中请敦,@Controller镐躲,@Service,@Repository會(huì)攜帶更多語(yǔ)義侍筛。并且便于開(kāi)發(fā)和維護(hù)萤皂!
3、指定了某些類(lèi)可作為Spring Bean類(lèi)使用后匣椰,最好還需要讓spring搜索指定路徑裆熙,在Spring配置文件加入如下配置:
<!-- 自動(dòng)掃描指定包及其子包下的所有Bean類(lèi) -->
<context:component-scan base-package="org.springframework.*"/>
二、裝配bean時(shí)常用的注解
1禽笑、注解介紹
@Autowired:屬于Spring 的org.springframework.beans.factory.annotation包下,可用于為類(lèi)的屬性入录、構(gòu)造器、方法進(jìn)行注值
@Resource:不屬于spring的注解佳镜,而是來(lái)自于JSR-250位于java.annotation包下僚稿,使用該annotation為目標(biāo)bean指定協(xié)作者Bean。
@PostConstruct 和 @PreDestroy 方法 實(shí)現(xiàn)初始化和銷(xiāo)毀bean之前進(jìn)行的操作
2蟀伸、舉例說(shuō)明
(1):@Autowired
@Target({ElementType.CONSTRUCTOR, ElementType.FIELD, ElementType.METHOD, ElementType.ANNOTATION_TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Autowired {
boolean required() default true;
}
@Controller
public class HappyController {
@Autowired //默認(rèn)依賴(lài)的ClubDao 對(duì)象(Bean)必須存在
//@Autowired(required = false) 改變默認(rèn)方式
@Qualifier("goodClubService")
private ClubService clubService;
// Control the people entering the Club
// do something
}
2):@Resource
@Target({TYPE, FIELD, METHOD})
@Retention(RUNTIME)
public @interface Resource {
String name() default "";
Class type() default java.lang.Object.class;
...
public class AnotationExp {
@Resource(name = "HappyClient")
private HappyClient happyClient;
@Resource(type = HappyPlayAno .class)
private HappyPlayAno happyPlayAno;
}
3蚀同、總結(jié)
(1):相同點(diǎn)
@Resource的作用相當(dāng)于@Autowired,均可標(biāo)注在字段或?qū)傩缘膕etter方法上啊掏。
(2):不同點(diǎn)
a:提供方 @Autowired是Spring的注解蠢络,@Resource是javax.annotation注解,而是來(lái)自于JSR-250迟蜜,J2EE提供刹孔,需要JDK1.6及以上。
b :注入方式 @Autowired只按照Type 注入小泉;@Resource默認(rèn)按Name自動(dòng)注入芦疏,也提供按照Type 注入冕杠;
c:屬性
@Autowired注解可用于為類(lèi)的屬性、構(gòu)造器酸茴、方法進(jìn)行注值分预。默認(rèn)情況下,其依賴(lài)的對(duì)象必須存在(bean可用)薪捍,如果需要改變這種默認(rèn)方式笼痹,可以設(shè)置其required屬性為false。
還有一個(gè)比較重要的點(diǎn)就是酪穿,@Autowired注解默認(rèn)按照類(lèi)型裝配凳干,如果容器中包含多個(gè)同一類(lèi)型的Bean,那么啟動(dòng)容器時(shí)會(huì)報(bào)找不到指定類(lèi)型bean的異常被济,解決辦法是結(jié)合@Qualified注解進(jìn)行限定救赐,指定注入的bean名稱(chēng)。
@Resource有兩個(gè)中重要的屬性:name和type只磷。name屬性指定byName经磅,如果沒(méi)有指定name屬性,當(dāng)注解標(biāo)注在字段上钮追,即默認(rèn)取字段的名稱(chēng)作為bean名稱(chēng)尋找依賴(lài)對(duì)象预厌,當(dāng)注解標(biāo)注在屬性的setter方法上,即默認(rèn)取屬性名作為bean名稱(chēng)尋找依賴(lài)對(duì)象元媚。
需要注意的是轧叽,@Resource如果沒(méi)有指定name屬性,并且按照默認(rèn)的名稱(chēng)仍然找不到依賴(lài)對(duì)象時(shí)刊棕, @Resource注解會(huì)回退到按類(lèi)型裝配炭晒。但一旦指定了name屬性,就只能按名稱(chēng)裝配了鞠绰。 d:@Resource注解的使用性更為靈活腰埂,可指定名稱(chēng),也可以指定類(lèi)型 蜈膨;@Autowired注解進(jìn)行裝配容易拋出異常屿笼,特別是裝配的bean類(lèi)型有多個(gè)的時(shí)候,而解決的辦法是需要在增加@Qualitied進(jìn)行限定翁巍。
Spring中 @Autowired注解與@Resource注解的區(qū)別
注意點(diǎn):使用@Resource也要注意添加配置文件到Spring驴一,如果沒(méi)有配置component-scan
<context:component-scan>
<!--<context:component-scan>的使用,是默認(rèn)激活<context:annotation-config>功能-->
則一定要配置 annotation-config
<context:annotation-config/>
三灶壶、@Component vs @Configuration and @Bean
1肝断、簡(jiǎn)單介紹
Spring的官方團(tuán)隊(duì)說(shuō)@Component可以替代 @Configuration注解,事實(shí)上我們看源碼也可以發(fā)現(xiàn)看到,如下
@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component //看這里P匦浮5F恕!
public @interface Configuration {
String value() default "";
雖然說(shuō)可以替代但是兩個(gè)注解之間還是有區(qū)別的趣钱!
Bean注解主要用于方法上涌献,有點(diǎn)類(lèi)似于工廠方法,當(dāng)使用了@Bean注解首有,我們可以連續(xù)使用多種定義bean時(shí)用到的注解燕垃,譬如用@Qualifier注解定義工廠方法的名稱(chēng),用@Scope注解定義該bean的作用域范圍井联,譬如是singleton還是prototype等卜壕。
Spring 中新的 Java 配置支持的核心就是@Configuration 注解的類(lèi)。這些類(lèi)主要包括 @Bean 注解的方法來(lái)為 Spring 的 IoC 容器管理的對(duì)象定義實(shí)例烙常,配置和初始化邏輯轴捎。
使用@Configuration 來(lái)注解類(lèi)表示類(lèi)可以被 Spring 的 IoC 容器所使用,作為 bean 定義的資源蚕脏。
@Configuration
public class AppConfig {
@Bean
public MyService myService() {
return new MyServiceImpl();
}
}
這和 Spring 的 XML 文件中的非常類(lèi)似
<beans>
<bean id="myService" class="com.acme.services.MyServiceImpl"/>
</beans>
@Bean 注解扮演了和元素相同的角色轮蜕。
2、舉例說(shuō)明@Component 和 @Configuration
@Configuration
public static class Config {
@Bean
public SimpleBean simpleBean() {
return new SimpleBean();
}
@Bean
public SimpleBeanConsumer simpleBeanConsumer() {
return new SimpleBeanConsumer(simpleBean());
}
}
@Component
public static class Config {
@Bean
public SimpleBean simpleBean() {
return new SimpleBean();
}
@Bean
public SimpleBeanConsumer simpleBeanConsumer() {
return new SimpleBeanConsumer(simpleBean());
}
}
第一個(gè)代碼正常工作蝗锥,正如預(yù)期的那樣,SimpleBeanConsumer將會(huì)得到一個(gè)單例SimpleBean的鏈接率触。第二個(gè)配置是完全錯(cuò)誤的终议,因?yàn)镾pring會(huì)創(chuàng)建一個(gè)SimpleBean的單例bean,但是SimpleBeanConsumer將獲得另一個(gè)SimpleBean實(shí)例(也就是相當(dāng)于直接調(diào)用new SimpleBean() 葱蝗,這個(gè)bean是不歸Spring管理的)穴张,既new SimpleBean() 實(shí)例是Spring上下文控件之外的。
3两曼、原因總結(jié)
使用@ configuration皂甘,所有標(biāo)記為@ bean的方法將被包裝成一個(gè)CGLIB包裝器,它的工作方式就好像是這個(gè)方法的第一個(gè)調(diào)用悼凑,那么原始方法的主體將被執(zhí)行偿枕,最終的對(duì)象將在spring上下文中注冊(cè)。所有進(jìn)一步的調(diào)用只返回從上下文檢索的bean户辫。
在上面的第二個(gè)代碼塊中渐夸,新的SimpleBeanConsumer(simpleBean())只調(diào)用一個(gè)純java方法。為了糾正第二個(gè)代碼塊渔欢,我們可以這樣做
@Component
public static class Config {
@Autowired
SimpleBean simpleBean;
@Bean
public SimpleBean simpleBean() {
return new SimpleBean();
}
@Bean
public SimpleBeanConsumer simpleBeanConsumer() {
return new SimpleBeanConsumer(simpleBean);
}
}
Spring @Configuration vs @Component
基本概念:@Configuration 和@Bean
四:spring MVC模塊注解
1墓塌、web模塊常用到的注解
- @Controller :表明該類(lèi)會(huì)作為與前端作交互的控制層組件,通過(guò)服務(wù)接口定義的提供訪問(wèn)應(yīng)用程序的一種行為,解釋用戶(hù)的輸入苫幢,將其轉(zhuǎn)換成一個(gè)模型然后將試圖呈獻(xiàn)給用戶(hù)访诱。
@Controller
public class HappyController {
//do something
...
}
Spring MVC 使用 @Controller 定義控制器,它還允許自動(dòng)檢測(cè)定義在類(lèi)路徑下的組件(配置文件中配置掃描路徑)并自動(dòng)注冊(cè)韩肝。
@RequestMapping : 這個(gè)注解用于將url映射到整個(gè)處理類(lèi)或者特定的處理請(qǐng)求的方法触菜。可以只用通配符伞梯!
@Controller
@RequestMapping("/happy")
public class HappyController {
@Autowired
private HappyService happyService;
@RequestMapping(/hello/*)
public void sayHello(){
//請(qǐng)求為 /happy/hello/* 都會(huì)進(jìn)入這個(gè)方法玫氢!
//例如:/happy/hello/123 /happy/hello/adb
//可以通過(guò)get/post 請(qǐng)求
}
@RequestMapping(value="/haha",method=RequestMethod.GET)
public void sayHaHa(){
//只能通過(guò)get請(qǐng)求
}
...
}
@RequestMapping 既可以作用在類(lèi)級(jí)別谜诫,也可以作用在方法級(jí)別。當(dāng)它定義在類(lèi)級(jí)別時(shí)生逸,標(biāo)明該控制器處理所有的請(qǐng)求都被映射到 /favsoft 路徑下。@RequestMapping中可以使用 method 屬性標(biāo)記其所接受的方法類(lèi)型且预,如果不指定方法類(lèi)型的話槽袄,可以使用 HTTP GET/POST 方法請(qǐng)求數(shù)據(jù)锋谐,但是一旦指定方法類(lèi)型,就只能使用該類(lèi)型獲取數(shù)據(jù)涮拗。
@RequestParam :將請(qǐng)求的參數(shù)綁定到方法中的參數(shù)上乾戏,有required參數(shù),默認(rèn)情況下三热,required=true,也就是改參數(shù)必須要傳就漾。如果改參數(shù)可以傳可不傳,可以配置required=false摆出。
@RequestMapping("/happy")
public String sayHappy(
@RequestParam(value = "name", required = false) String name,
@RequestParam(value = "age", required = true) String age) {
//age參數(shù)必須傳 夷野,name可傳可不傳
...
}
@PathVariable : 該注解用于方法修飾方法參數(shù),會(huì)將修飾的方法參數(shù)變?yōu)榭晒┦褂玫膗ri變量(可用于動(dòng)態(tài)綁定)悯搔。
@RequestMapping(value="/happy/{dayid}",method=RequestMethod.GET)
public String findPet(@PathVariable String dayid, Model mode) {
//使用@PathVariable注解綁定 {dayid} 到String dayid
}
@PathVariable中的參數(shù)可以是任意的簡(jiǎn)單類(lèi)型,如int, long, Date等等通危。Spring會(huì)自動(dòng)將其轉(zhuǎn)換成合適的類(lèi)型或者拋出 TypeMismatchException異常。當(dāng)然节芥,我們也可以注冊(cè)支持額外的數(shù)據(jù)類(lèi)型逆害。
@PathVariable支持使用正則表達(dá)式,這就決定了它的超強(qiáng)大屬性相艇,它能在路徑模板中使用占位符纯陨,可以設(shè)定特定的前綴匹配,后綴匹配等自定義格式咙轩。
@RequestBody : @RequestBody是指方法參數(shù)應(yīng)該被綁定到HTTP請(qǐng)求Body上阴颖。
@RequestMapping(value = "/something", method = RequestMethod.PUT)
public void handle(@RequestBody String body,@RequestBody User user){
//可以綁定自定義的對(duì)象類(lèi)型
}
@ResponseBody : @ResponseBody與@RequestBody類(lèi)似量愧,它的作用是將返回類(lèi)型直接輸入到HTTP response body中侠畔。
@ResponseBody在輸出JSON格式的數(shù)據(jù)時(shí)损晤,會(huì)經(jīng)常用到。
@RequestMapping(value = "/happy", method =RequestMethod.POST)
@ResponseBody
public String helloWorld() {
return "Hello World";//返回String類(lèi)型
}
@RestController :控制器實(shí)現(xiàn)了REST的API尤勋,只為服務(wù)于JSON最冰,XML或其它自定義的類(lèi)型內(nèi)容,@RestController用來(lái)創(chuàng)建REST類(lèi)型的控制器暖哨,與@Controller類(lèi)型。@RestController就是這樣一種類(lèi)型沛慢,它避免了你重復(fù)的寫(xiě)@RequestMapping與@ResponseBody。
-
@ModelAttribute :@ModelAttribute可以作用在方法或方法參數(shù)上逾冬,當(dāng)它作用在方法上時(shí)躺苦,標(biāo)明該方法的目的是添加一個(gè)或多個(gè)模型屬性(model attributes)。
該方法支持與@RequestMapping一樣的參數(shù)類(lèi)型嘀趟,但并不能直接映射成請(qǐng)求集乔。控制器中的@ModelAttribute方法會(huì)在@RequestMapping方法調(diào)用之前而調(diào)用尤溜。@ModelAttribute方法有兩種風(fēng)格:一種是添加隱形屬性并返回它汗唱。另一種是該方法接受一個(gè)模型并添加任意數(shù)量的模型屬性。用戶(hù)可以根據(jù)自己的需要選擇對(duì)應(yīng)的風(fēng)格哩罪。
五:Spring事務(wù)模塊注解
1际插、常用到的注解
在處理dao層或service層的事務(wù)操作時(shí),譬如刪除失敗時(shí)的回滾操作框弛。使用@Transactional 作為注解,但是需要在配置文件激活
<!-- 開(kāi)啟注解方式聲明事務(wù) -->
<tx:annotation-driven transaction-manager="transactionManager" />
2斗搞、舉例
@Service
public class CompanyServiceImpl implements CompanyService {
@Autowired
private CompanyDAO companyDAO;
@Transactional(propagation = Propagation.REQUIRED, readOnly = false, rollbackFor = Exception.class)
public int deleteByName(String name) {
int result = companyDAO.deleteByName(name);
return result;
}
...
}
3僻焚、總結(jié)
事務(wù)的傳播機(jī)制和隔離機(jī)制比較重要膝擂!
事務(wù)傳播行為類(lèi)型 | 說(shuō)明 |
---|---|
PROPAGATION_REQUIRED | 如果當(dāng)前沒(méi)有事務(wù)隙弛,就新建一個(gè)事務(wù)咐旧,如果已經(jīng)存在一個(gè)事務(wù)中,加入到這個(gè)事務(wù)中室埋。這是最常見(jiàn)的選擇伊约。 |
PROPAGATION_SUPPORTS | 支持當(dāng)前事務(wù),如果當(dāng)前沒(méi)有事務(wù)腌逢,就以非事務(wù)方式執(zhí)行超埋。 |
PROPAGATION_MANDATORY | 使用當(dāng)前的事務(wù),如果當(dāng)前沒(méi)有事務(wù)霍殴,就拋出異常来庭。 |
PROPAGATION_REQUIRES_NEW | 新建事務(wù),如果當(dāng)前存在事務(wù)月弛,把當(dāng)前事務(wù)掛起。 |
PROPAGATION_NOT_SUPPORTED | 以非事務(wù)方式執(zhí)行操作帽衙,如果當(dāng)前存在事務(wù),就把當(dāng)前事務(wù)掛起幌墓。 |
PROPAGATION_NEVER | 以非事務(wù)方式執(zhí)行冀泻,如果當(dāng)前存在事務(wù)蜡饵,則拋出異常 |
PROPAGATION_NESTED | 如果當(dāng)前存在事務(wù),則在嵌套事務(wù)內(nèi)執(zhí)行肢专。如果當(dāng)前沒(méi)有事務(wù),則執(zhí)行與PROPAGATION_REQUIRED類(lèi) 似的操作 |
readOnly : 事務(wù)的讀寫(xiě)屬性椿胯,取true或者false剃根,true為只讀、默認(rèn)為false
rollbackFor : 回滾策略廉油,當(dāng)遇到指定異常時(shí)回滾苗傅。譬如上例遇到異常就回滾
timeout (補(bǔ)充的) : 設(shè)置超時(shí)時(shí)間,單位為秒
isolation : 設(shè)置事務(wù)隔離級(jí)別嘶炭,枚舉類(lèi)型逊桦,一共五種
類(lèi)型 | 說(shuō)明 |
---|---|
DEFAULT | 采用數(shù)據(jù)庫(kù)默認(rèn)隔離級(jí)別 |
READ_UNCOMMITTED | 讀未提交的數(shù)據(jù)(會(huì)出現(xiàn)臟讀取) |
READ_COMMITTED | 讀已提交的數(shù)據(jù)(會(huì)出現(xiàn)幻讀宵呛,即前后兩次讀的不一樣) |
REPEATABLE_READ | 可重復(fù)讀夕凝,會(huì)出現(xiàn)幻讀 |
SERIALIZABLE 串行化 | (對(duì)資源消耗較大,一般不使用) |
透徹的掌握 Spring 中@transactional 的使用
Spring事務(wù)配置及事務(wù)的傳播性與隔離級(jí)別詳解