這幾個(gè)關(guān)于Spring 依賴注入的問題你清楚嗎焰轻?

image

前言

本章的內(nèi)容主要是想探討我們?cè)谶M(jìn)行Spring 開發(fā)過程當(dāng)中京闰,關(guān)于依賴注入的幾個(gè)知識(shí)點(diǎn)考蕾。感興趣的讀者可以先看下以下問題:

  • @Autowired, @Resource, @Inject 三個(gè)注解的區(qū)別
  • 當(dāng)你在使用@Autowired時(shí),是否有出現(xiàn)過Field injection is not recommended的警告吐咳?你知道這是為什么嗎逻悠?
  • Spring 依賴注入有哪幾種方式?官方是怎么建議使用的呢挪丢?

如果你對(duì)上述問題都了解蹂风,那我個(gè)人覺得你的開發(fā)經(jīng)驗(yàn)應(yīng)該是不錯(cuò)的??卢厂。

下面我們就依次對(duì)上述問題進(jìn)行解答乾蓬,并且總結(jié)知識(shí)點(diǎn)。

@Autowired, @Resource, @Inject 三個(gè)注解的區(qū)別

Spring 支持使用@Autowired, @Resource, @Inject 三個(gè)注解進(jìn)行依賴注入慎恒。下面來介紹一下這三個(gè)注解有什么區(qū)別任内。

@Autowired

@Autowired為Spring 框架提供的注解,需要導(dǎo)入包org.springframework.beans.factory.annotation.Autowired融柬。

這里先給出一個(gè)示例代碼死嗦,方便講解說明:

public interface Svc {

    void sayHello();
}

@Service
public class SvcA implements Svc {

    @Override
    public void sayHello() {
        System.out.println("hello, this is service A");
    }

}

@Service
public class SvcB implements Svc {

    @Override
    public void sayHello() {
        System.out.println("hello, this is service B");
    }

}

@Service
public class SvcC implements Svc {

    @Override
    public void sayHello() {
        System.out.println("hello, this is service C");
    }
}

測(cè)試類:

@SpringBootTest
public class SimpleTest {

    @Autowired
    // @Qualifier("svcA")
    Svc svc;

    @Test
    void rc() {
        Assertions.assertNotNull(svc);
        svc.sayHello();
    }

}

裝配順序:

  1. 按照type在上下文中查找匹配的bean

    查找type為Svc的bean
    
  2. 如果有多個(gè)bean,則按照name進(jìn)行匹配

    1. 如果有@Qualifier注解粒氧,則按照@Qualifier指定的name進(jìn)行匹配

      查找name為svcA的bean
      
    2. 如果沒有越除,則按照變量名進(jìn)行匹配

      查找name為svc的bean
      
  3. 匹配不到,則報(bào)錯(cuò)。(@Autowired(required=false)摘盆,如果設(shè)置requiredfalse(默認(rèn)為true)翼雀,則注入失敗時(shí)不會(huì)拋出異常)

@Inject

在Spring 的環(huán)境下,@Inject@Autowired 是相同的孩擂,因?yàn)樗鼈兊囊蕾囎⑷攵际鞘褂?code>AutowiredAnnotationBeanPostProcessor來處理的狼渊。

image

@Inject是 JSR-330 定義的規(guī)范,如果使用這種方式类垦,切換到Guice也是可以的狈邑。

Guice 是 google 開源的輕量級(jí) DI 框架

如果硬要說兩個(gè)的區(qū)別,首先@Inject是Java EE包里的蚤认,在SE環(huán)境需要單獨(dú)引入米苹。另一個(gè)區(qū)別在于@Autowired可以設(shè)置required=false@Inject并沒有這個(gè)屬性。

@Resource

@Resource是JSR-250定義的注解砰琢。Spring 在 CommonAnnotationBeanPostProcessor實(shí)現(xiàn)了對(duì)JSR-250的注解的處理驱入,其中就包括@Resource

image

@Resource有兩個(gè)重要的屬性:nametype氯析,而Spring 將@Resource注解的name屬性解析為bean的名字亏较,而type屬性則解析為bean的類型。

裝配順序:

  1. 如果同時(shí)指定了nametype掩缓,則從Spring上下文中找到唯一匹配的bean進(jìn)行裝配雪情,找不到則拋出異常。
  2. 如果指定了name你辣,則從上下文中查找名稱(id)匹配的bean進(jìn)行裝配巡通,找不到則拋出異常。
  3. 如果指定了type舍哄,則從上下文中找到類型匹配的唯一bean進(jìn)行裝配宴凉,找不到或是找到多個(gè),都會(huì)拋出異常表悬。
  4. 如果既沒有指定name弥锄,又沒有指定type,則默認(rèn)按照byName方式進(jìn)行裝配蟆沫;如果沒有匹配籽暇,按照byType進(jìn)行裝配。

IDEA 提示 Field injection is not recommended

在使用IDEA 進(jìn)行Spring 開發(fā)的時(shí)候饭庞,當(dāng)你在字段上面使用@Autowired注解的時(shí)候戒悠,你會(huì)發(fā)現(xiàn)IDEA 會(huì)有警告提示:

Field injection is not recommended

Inspection info: Spring Team Recommends: "Always use constructor based dependency injection in your beans. Always use assertions for mandatory dependencies".

image

翻譯過來就是這個(gè)意思:

不建議使用基于 field 的注入方式。

Spring 開發(fā)團(tuán)隊(duì)建議:在你的Spring Bean 永遠(yuǎn)使用基于constructor 的方式進(jìn)行依賴注入舟山。對(duì)于必須的依賴绸狐,永遠(yuǎn)使用斷言來確認(rèn)卤恳。

比如如下代碼:

@Service
public class HelpService {
    @Autowired
    @Qualifier("svcB")
    private Svc svc;

    public void sayHello() {
        svc.sayHello();
    }
}

public interface Svc {
    void sayHello();
}

@Service
public class SvcB implements Svc {
    @Override
    public void sayHello() {
        System.out.println("hello, this is service B");
    }
}

將光標(biāo)放到@Autowired處,使用Alt + Enter 快捷進(jìn)行修改之后寒矿,代碼就會(huì)變成基于Constructor的注入方式纬黎,修改之后

@Service
public class HelpService {
    private final Svc svc;
    
    @Autowired
    public HelpService(@Qualifier("svcB") Svc svc) {
        // Assert.notNull(svc, "svc must not be null");
        this.svc = svc;
    }
    
    public void sayHello() {
        svc.sayHello();
    }
}

如果按照Spring 團(tuán)隊(duì)的建議,如果svc是必須的依賴劫窒,應(yīng)該使用Assert.notNull(svc, "svc must not be null")來確認(rèn)本今。

修正這個(gè)警告提示固然簡(jiǎn)單,但是我覺得更重要是去理解為什么Spring 團(tuán)隊(duì)會(huì)提出這樣的建議主巍?直接使用這種基于 field 的注入方式有什么問題冠息?


首先我們需要知道,Spring 中有這么3種依賴注入的方式

  • 基于 field 注入(屬性注入)
  • 基于 setter 注入
  • 基于 constructor 注入(構(gòu)造器注入)

1. 基于 field 注入

所謂基于 field 注入孕索,就是在bean的變量上使用注解進(jìn)行依賴注入逛艰。本質(zhì)上是通過反射的方式直接注入到field。這是我平常開發(fā)中看的最多也是最熟悉的一種方式搞旭,同時(shí)散怖,也正是 Spring 團(tuán)隊(duì)所不推薦的方式。比如:

@Autowired
private Svc svc;

2. 基于 setter 方法注入

通過對(duì)應(yīng)變量的setXXX()方法以及在方法上面使用注解肄渗,來完成依賴注入镇眷。比如:

private Helper helper;

@Autowired
public void setHelper(Helper helper) {
    this.helper = helper;
}

注:在 Spring 4.3 及以后的版本中,setter 上面的 @Autowired 注解是可以不寫的翎嫡。

3. 基于 constructor 注入

將各個(gè)必需的依賴全部放在帶有注解構(gòu)造方法的參數(shù)中欠动,并在構(gòu)造方法中完成對(duì)應(yīng)變量的初始化,這種方式惑申,就是基于構(gòu)造方法的注入具伍。比如:

private final Svc svc;
    
@Autowired
public HelpService(@Qualifier("svcB") Svc svc) {
    this.svc = svc;
}

Spring 4.3 及以后的版本中,如果這個(gè)類只有一個(gè)構(gòu)造方法圈驼,那么這個(gè)構(gòu)造方法上面也可以不寫 @Autowired 注解人芽。

基于 field 注入的好處

正如你所見,這種方式非常的簡(jiǎn)潔绩脆,代碼看起來很簡(jiǎn)單萤厅,通俗易懂。你的類可以專注于業(yè)務(wù)而不被依賴注入所污染衙伶。你只需要把@Autowired扔到變量之上就好了祈坠,不需要特殊的構(gòu)造器或者set方法,依賴注入容器會(huì)提供你所需的依賴矢劲。

基于 field 注入的壞處

成也蕭何敗也蕭何

基于 field 注入雖然簡(jiǎn)單,但是卻會(huì)引發(fā)很多的問題慌随。這些問題在我平常開發(fā)閱讀項(xiàng)目代碼的時(shí)候就經(jīng)常遇見芬沉。

  • 容易違背了單一職責(zé)原則
    使用這種基于 field 注入的方式躺同,添加依賴是很簡(jiǎn)單的,就算你的類中有十幾個(gè)依賴你可能都覺得沒有什么問題丸逸,普通的開發(fā)者很可能會(huì)無意識(shí)地給一個(gè)類添加很多的依賴蹋艺。但是當(dāng)使用構(gòu)造器方式注入,到了某個(gè)特定的點(diǎn)黄刚,構(gòu)造器中的參數(shù)變得太多以至于很明顯地發(fā)現(xiàn)something is wrong捎谨。擁有太多的依賴通常意味著你的類要承擔(dān)更多的責(zé)任,明顯違背了單一職責(zé)原則(SRP:Single responsibility principle)憔维。

    這個(gè)問題在我司的項(xiàng)目代碼真的很常見涛救。

  • 依賴注入與容器本身耦合

    依賴注入框架的核心思想之一就是受容器管理的類不應(yīng)該去依賴容器所使用的依賴。換句話說业扒,這個(gè)類應(yīng)該是一個(gè)簡(jiǎn)單的POJO(Plain Ordinary Java Object)能夠被單獨(dú)實(shí)例化并且你也能為它提供它所需的依賴检吆。

    這個(gè)問題具體可以表現(xiàn)在:

    • 你的類和依賴容器強(qiáng)耦合,不能在容器外使用
    • 你的類不能繞過反射(例如單元測(cè)試的時(shí)候)進(jìn)行實(shí)例化程储,必須通過依賴容器才能實(shí)例化蹭沛,這更像是集成測(cè)試
  • 不能使用屬性注入的方式構(gòu)建不可變對(duì)象(final 修飾的變量)

Spring 開發(fā)團(tuán)隊(duì)的建議

Since you can mix constructor-based and setter-based DI, it is a good rule of thumb to use constructors for mandatory dependencies and setter methods or configuration methods for optional dependencies.

簡(jiǎn)單來說,就是

  • 強(qiáng)制依賴就用構(gòu)造器方式

  • 可選章鲤、可變的依賴就用setter 注入

    當(dāng)然你可以在同一個(gè)類中使用這兩種方法摊灭。構(gòu)造器注入更適合強(qiáng)制性的注入旨在不變性,Setter注入更適合可變性的注入败徊。

讓我們看看Spring 這樣推薦的理由斟或,首先是基于構(gòu)造方法注入,

The Spring team generally advocates constructor injection as it enables one to implement application components as immutable objects and to ensure that required dependencies are not null. Furthermore constructor-injected components are always returned to client (calling) code in a fully initialized state. As a side note, a large number of constructor arguments is a bad code smell, implying that the class likely has too many responsibilities and should be refactored to better address proper separation of concerns.

Spring 團(tuán)隊(duì)提倡使用基于構(gòu)造方法的注入集嵌,因?yàn)檫@樣一方面可以將依賴注入到一個(gè)不可變的變量中 (注:final 修飾的變量)萝挤,另一方面也可以保證這些變量的值不會(huì)是 null。此外根欧,經(jīng)過構(gòu)造方法完成依賴注入的組件 (注:比如各個(gè) service)怜珍,在被調(diào)用時(shí)可以保證它們都完全準(zhǔn)備好了。與此同時(shí)凤粗,從代碼質(zhì)量的角度來看酥泛,一個(gè)巨大的構(gòu)造方法通常代表著出現(xiàn)了代碼異味,這個(gè)類可能承擔(dān)了過多的責(zé)任嫌拣。

而對(duì)于基于 setter 的注入柔袁,他們是這么說的:

Setter injection should primarily only be used for optional dependencies that can be assigned reasonable default values within the class. Otherwise, not-null checks must be performed everywhere the code uses the dependency. One benefit of setter injection is that setter methods make objects of that class amenable to reconfiguration or re-injection later.

基于 setter 的注入,則只應(yīng)該被用于注入非必需的依賴异逐,同時(shí)在類中應(yīng)該對(duì)這個(gè)依賴提供一個(gè)合理的默認(rèn)值捶索。如果使用 setter 注入必需的依賴,那么將會(huì)有過多的 null 檢查充斥在代碼中灰瞻。使用 setter 注入的一個(gè)優(yōu)點(diǎn)是腥例,這個(gè)依賴可以很方便的被改變或者重新注入辅甥。

小結(jié)

以上就是本文的所有內(nèi)容,希望閱讀本文之后能讓你對(duì)Spring 的依賴注入有更深的理解燎竖。

如果本文有幫助到你璃弄,希望能點(diǎn)個(gè)贊,這是對(duì)我的最大動(dòng)力????????构回。

參考

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末夏块,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子纤掸,更是在濱河造成了極大的恐慌脐供,老刑警劉巖,帶你破解...
    沈念sama閱讀 216,544評(píng)論 6 501
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件茁肠,死亡現(xiàn)場(chǎng)離奇詭異患民,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)垦梆,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,430評(píng)論 3 392
  • 文/潘曉璐 我一進(jìn)店門匹颤,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人托猩,你說我怎么就攤上這事印蓖。” “怎么了京腥?”我有些...
    開封第一講書人閱讀 162,764評(píng)論 0 353
  • 文/不壞的土叔 我叫張陵赦肃,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我公浪,道長(zhǎng)他宛,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,193評(píng)論 1 292
  • 正文 為了忘掉前任欠气,我火速辦了婚禮厅各,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘预柒。我一直安慰自己队塘,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,216評(píng)論 6 388
  • 文/花漫 我一把揭開白布宜鸯。 她就那樣靜靜地躺著憔古,像睡著了一般。 火紅的嫁衣襯著肌膚如雪淋袖。 梳的紋絲不亂的頭發(fā)上鸿市,一...
    開封第一講書人閱讀 51,182評(píng)論 1 299
  • 那天,我揣著相機(jī)與錄音适贸,去河邊找鬼灸芳。 笑死涝桅,一個(gè)胖子當(dāng)著我的面吹牛拜姿,可吹牛的內(nèi)容都是我干的烙样。 我是一名探鬼主播,決...
    沈念sama閱讀 40,063評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼蕊肥,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼谒获!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起壁却,我...
    開封第一講書人閱讀 38,917評(píng)論 0 274
  • 序言:老撾萬榮一對(duì)情侶失蹤批狱,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后展东,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體赔硫,經(jīng)...
    沈念sama閱讀 45,329評(píng)論 1 310
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,543評(píng)論 2 332
  • 正文 我和宋清朗相戀三年盐肃,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了爪膊。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,722評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡砸王,死狀恐怖推盛,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情谦铃,我是刑警寧澤耘成,帶...
    沈念sama閱讀 35,425評(píng)論 5 343
  • 正文 年R本政府宣布,位于F島的核電站驹闰,受9級(jí)特大地震影響瘪菌,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜嘹朗,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,019評(píng)論 3 326
  • 文/蒙蒙 一师妙、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧骡显,春花似錦疆栏、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,671評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至溜歪,卻和暖如春若专,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背蝴猪。 一陣腳步聲響...
    開封第一講書人閱讀 32,825評(píng)論 1 269
  • 我被黑心中介騙來泰國(guó)打工调衰, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留膊爪,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 47,729評(píng)論 2 368
  • 正文 我出身青樓嚎莉,卻偏偏與公主長(zhǎng)得像米酬,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子趋箩,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,614評(píng)論 2 353

推薦閱讀更多精彩內(nèi)容