1. 程式人生 > 其它 >04 Spring的@Autowired註解、@Resource註解、@Service註解

04 Spring的@Autowired註解、@Resource註解、@Service註解

什麼是註解

傳統的Spring做法是使用.xml檔案來對bean進行注入或者是配置aop、事務,這麼做有兩個缺點:

1、如果所有的內容都配置在.xml檔案中,那麼.xml檔案將會十分龐大;如果按需求分開.xml檔案,那麼.xml檔案又會非常多。總之這將導致配置檔案的可讀性與可維護性變得很低。

2、開發中需要在.java檔案和.xml檔案之間不斷切換,是一件麻煩的事,同時這種思維上的不連貫也會降低開發的效率。

為了解決這兩個問題,Spring引入了註解,通過@XXX的方式,讓註解與Java Bean 緊密結合,既大大減少了配置檔案的體積,又增加了Java Bean 的可讀性與內聚性。

本篇文章,講講最重要的三個Spring註解,也就是@Autowired

@Resource@Service

不使用註解

先看一個不使用註解的 Spring 示例,在這個示例的基礎上,再改成註解版本,這樣也能看出使用與不使用註解之間的區別,先定義一個老虎類:

public class Tiger
{
    private String tigerName = "TigerKing";
    
    public String toString()
    {
        return "TigerName:" + tigerName;
    }
}

再定義一個猴子類:

public class Monkey
{
    private String monkeyName = "MonkeyKing";
    
    public String toString()
    {
        return "MonkeyName:" + monkeyName;
    }
}

再定義一個動物園類:

public class Zoo
{
    private Tiger tiger;
    private Monkey monkey;
    
    public void setTiger(Tiger tiger)
    {
        this.tiger = tiger;
    }
    
    public void setMonkey(Monkey monkey)
    {
        this.monkey = monkey;
    }
    
    public Tiger getTiger()
    {
        return tiger;
    }
    
    public Monkey getMonkey()
    {
        return monkey;
    }
    
    public String toString()
    {
        return tiger + "n" + monkey;
    }
}

在Spring的配置檔案中這麼寫:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"   
    xmlns="http://www.springframework.org/schema/beans"  
    xmlns:context="http://www.springframework.org/schema/context"  
    xsi:schemaLocation="http://www.springframework.org/schema/beans 
        http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context-4.2.xsd"
    default-autowire="byType">
    
    <bean id="zoo" class="com.nnngu.bean.Zoo" >
        <property name="tiger" ref="tiger" />
        <property name="monkey" ref="monkey" />
    </bean>
    
    <bean id="tiger" class="com.nnngu.domain.Tiger" />
    <bean id="monkey" class="com.nnngu.domain.Monkey" />
    
</beans>

都很熟悉,權當複習一遍了。

@Autowired

@Autowired顧名思義,就是自動裝配,其作用是為了消除Java程式碼裡面的getter/setter與bean屬性中的property。當然,getter看個人需求,如果私有屬性需要對外提供的話,應當保留該getter

因此,引入@Autowired註解,先看一下Spring的配置檔案怎麼寫:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"   
    xmlns="http://www.springframework.org/schema/beans"  
    xmlns:context="http://www.springframework.org/schema/context"  
    xsi:schemaLocation="http://www.springframework.org/schema/beans 
        http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context-4.2.xsd">
    
    <context:component-scan base-package="com.nnngu" />
    
    <bean id="zoo" class="com.nnngu.bean.Zoo" />
    <bean id="tiger" class="com.nnngu.domain.Tiger" />
    <bean id="monkey" class="com.nnngu.domain.Monkey" />
    
</beans>

注意上面程式碼中的<context:component-scan base-package="com.nnngu" /> ,作用是告訴Spring我要使用註解了,Spring會自動掃描com.nnngu路徑下的註解。

之前在zoo這個bean裡面應當注入的兩個屬性tigermonkey,現在不需要注入了。再看一下 Zoo.java 也很方便,把getter/setter 都可以去掉:

public class Zoo
{
    @Autowired
    private Tiger tiger;
    
    @Autowired
    private Monkey monkey;
    
    public String toString()
    {
        return tiger + "n" + monkey;
    }
}

上面程式碼中@Autowired註解的意思是,當Spring發現@Autowired註解時,將自動在程式碼上下文中找到和其匹配(預設是型別匹配)的Bean,並自動注入到相應的地方去。

(有一個細節性的問題是,假如配置檔案的bean裡面有兩個property,Zoo.java裡面又去掉了屬性的getter/setter並使用@Autowired註解標註這兩個屬性那會怎麼樣?答案是Spring會按照xml優先的原則去Zoo.java中尋找這兩個屬性的getter/setter,導致的結果就是初始化bean報錯。)

此時如果我把.xml檔案的<bean id="tiger" class="com.nnngu.domain.Tiger" /><bean id="monkey" class="com.nnngu.domain.Monkey" /> 去掉,再執行,會丟擲如下異常:

org.springframework.beans.factory.BeanCreationException: Could not autowire field

因為,@Autowired註解要去尋找的是一個bean,Tiger 和 Monkey 的bean定義都給去掉了,自然就不是一個bean了,Spring容器找不到也很好理解。那麼,如果屬性的bean找不到,我又不想讓Spring容器丟擲異常,而只顯示null,可以嗎?答案是可以的,只要將@Autowired註解的required屬性設定為 false 即可,如下:

public class Zoo
{
    @Autowired(required = false)
    private Tiger tiger;
    
    @Autowired(required = false)
    private Monkey monkey;
    
    public String toString()
    {
        return tiger + "n" + monkey;
    }
}

此時,就算找不到 tiger、monkey 這兩個屬性的 bean,Spring容器也不再丟擲異常,而是認為這兩個屬性為null。

@Autowired介面注入

上面的比較簡單,我們只是簡單注入一個Java類,那麼如果有一個介面,有多個實現,Bean裡引用的是介面名,又該怎麼做呢?比如有一個Car介面:

public interface Car
{
    public String carName();
}

兩個實現類BMW和Benz:

public class BMW implements Car
{
    public String carName()
    {
        return "BMW car";
    }
}
public class Benz implements Car
{
    public String carName()
    {
        return "Benz car";
    }
}

寫一個CarFactory,引用Car:

public class CarFactory
{
    @Autowired
    private Car car;
    
    public String toString()
    {
        return car.carName();
    }
}

不用說,一定是報錯的,Car介面有兩個實現類,Spring並不知道應當引用哪個實現類。這種情況通常有兩個解決辦法:

1、刪除其中一個實現類,Spring會自動去base-package下尋找Car介面的實現類,發現Car介面只有一個實現類,便會直接引用這個實現類。

2、實現類就是有多個該怎麼辦?此時可以使用@Qualifier註解:

public class CarFactory
{
    @Autowired
    @Qualifier("BMW")
    private Car car;
    
    public String toString()
    {
        return car.carName();
    }
}

注意@Qualifier註解括號裡面的應當是Car介面實現類的類名,我之前試的時候一直以為是bean的名字,所以寫了"bMW",結果一直報錯。

@Resource

@Resource註解放在@Autowired下面說,是因為它們的作用非常相似。先看一下@Resource,直接在Zoo.java中寫:

public class Zoo
{
    @Resource(name = "tiger")
    private Tiger tiger;
    
    @Resource(type = Monkey.class)
    private Monkey monkey;
    
    public String toString()
    {
        return tiger + "n" + monkey;
    }
}

說一下@Resource的裝配順序:

1、@Resource後面如果沒有任何內容,預設是通過name屬性去匹配bean,找不到再按type去匹配

2、指定了name或者type則根據指定的型別去匹配bean

3、指定了name和type則根據指定的name和type去匹配bean,任何一個不匹配都將報錯

然後,區分一下@Autowired@Resource兩個註解的區別:

1、@Autowired預設按照byType方式進行bean匹配,@Resource預設按照byName方式進行bean匹配

2、@Autowired是Spring的註解,@Resource是J2EE的註解,這個可以看一下匯入註解的時候這兩個註解的包名就一清二楚了

Spring屬於第三方的,J2EE是Java自己的東西,因此,建議使用@Resource註解,以減少程式碼和Spring之間的耦合。

@Service

上面動物園這個例子,還可以繼續簡化,因為Spring的配置檔案裡面還有三個bean,下一步的簡化是把這三個bean也給去掉,使得Spring配置檔案裡面只有一個自動掃描的標籤。這樣做增強了Java程式碼的內聚性並進一步減少配置檔案。

先看一下配置檔案(三個bean都刪除了):

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"   
    xmlns="http://www.springframework.org/schema/beans"  
    xmlns:context="http://www.springframework.org/schema/context"  
    xsi:schemaLocation="http://www.springframework.org/schema/beans 
        http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context-4.2.xsd">
    
    <context:component-scan base-package="com.nnngu" />
    
</beans>

下面以Zoo.java為例,其餘的Monkey.javaTiger.java都一樣:

@Service
public class Zoo
{
    @Autowired
    private Tiger tiger;
    
    @Autowired
    private Monkey monkey;
    
    public String toString()
    {
        return tiger + "n" + monkey;
    }
}

這樣,Zoo.java在Spring容器中存在的形式就是zoo,即可以通過 ApplicationContextgetBean("zoo")方法來得到Zoo.java@Service註解,其實做了兩件事情:

1、宣告Zoo.java是一個bean,這點很重要,因為Zoo.java是一個bean,其他的類才可以使用@Autowired將Zoo作為一個成員變數自動注入

2、Zoo.java在bean中的id是zoo,即類名且首字母小寫

如果我不想用這種形式,而想讓Zoo.java在Spring容器中的名字就叫做Zoo,可以嗎?答案是可以的:

@Service("Zoo")
@Scope("prototype")
public class Zoo
{
    @Autowired
    private Monkey monkey;
    @Autowired
    private Tiger tiger;
    
    public String toString()
    {
        return tiger + "n" + monkey;
    }
}

這樣,就可以通過ApplicationContextgetBean("Zoo")方法來得到Zoo.java了。

這裡我還多加了一個@Scope註解,應該很好理解。因為Spring預設產生的bean是單例的,假如我不想使用單例怎麼辦,xml檔案裡面可以在bean裡面配置scope屬性。註解也一樣,配置@Scope即可,預設是"singleton"即單例,"prototype"表示原型即每次都會new一個新的物件出來。

補充細節

最後再補充一個細節。假如animal包下有Tiger,domain包下也有Tiger,它們二者都加了@Service註解,那麼在Zoo.java中即使明確表示我要引用的是domain包下的Tiger,程式執行的時候依然會報錯。

因為兩個Tiger都使用@Service註解標註,意味著兩個bean的名字都是"tiger",那麼我在Zoo.java中自動裝配的是哪個tiger呢?不明確,因此,Spring容器會丟擲ConflictingBeanDefinitionException異常。


本文永久更新地址:https://github.com/nnngu/LearningNotes/blob/master/Spring/04%20Spring%E7%9A%84%40Autowired%E6%B3%A8%E8%A7%A3%E3%80%81%40Resource%E6%B3%A8%E8%A7%A3%E3%80%81%40Service%E6%B3%A8%E8%A7%A3.md