Spring Bean 自動裝配：byName、byType、constructor 模式深度解析與局限

自動裝配簡介

Spring 容器可自動解析 Bean 依賴關係，減少 XML 中 <constructor-arg>、<property> 手工配置。在 <bean> 元素上指定 autowire 屬性啟用。

四種自動裝配模式

1. byName：按屬性名匹配

容器查找 Bean id 與屬性名相同 的 Bean 注入。

<bean id="textEditor" class="com.example.TextEditor" autowire="byName">
    <property name="name" value="Generic Editor"/> <!-- 簡單值仍需手工 -->
</bean>
<bean id="spellChecker" class="com.example.SpellChecker"/> <!-- id = spellChecker，匹配屬性名 -->

• 適用：Setter 注入
• 缺點：Bean id 必須與屬性名完全一致，重構風險大

2. byType：按類型匹配

容器查找 類型兼容 的 Bean (僅有一個匹配時)。

<bean id="textEditor" class="com.example.TextEditor" autowire="byType">
    <property name="name" value="Generic Editor"/>
</bean>
<bean id="mySpellChecker" class="com.example.SpellChecker"/> <!-- 類型匹配，id 可任意 -->

• 適用：Setter 注入
• 缺點：若有多個同類型 Bean 會拋異常，需配合 primary 或 qualifier

3. constructor：建構子參數按類型匹配

類似 byType，但作用於 建構子參數。

public class TextEditor {
    private SpellChecker spellChecker;
    private String name;
    public TextEditor(SpellChecker spellChecker, String name) { ... }
}

<bean id="textEditor" class="com.example.TextEditor" autowire="constructor">
    <constructor-arg value="Generic Editor"/> <!-- 簡單值仍需手工 -->
</bean>
<bean id="spellChecker" class="com.example.SpellChecker"/>

4. autodetect (已棄用)

嘗試 constructor 失敗則回退 byType。Spring 3.0+ 不推薦使用。

5. default (預設)

無自動裝配，需顯式配置。繼承自父 <beans default-autowire="...">。

完整對比範例

public class TextEditor {
    private SpellChecker spellChecker;
    private String name;
    
    // 建構子 (constructor 模式用)
    public TextEditor(SpellChecker spellChecker, String name) { ... }
    
    // Setter (byName/byType 用)
    public void setSpellChecker(SpellChecker sc) { this.spellChecker = sc; }
    public void setName(String name) { this.name = name; }
    
    public void spellCheck() { spellChecker.checkSpelling(); }
}

XML 配置對比

自動裝配的局限與缺點

1. 模糊性：byType 多候選時拋異常；byName 重命名屬性即失效
2. 文檔性差：XML 不再清晰表達依賴關係，維護困難
3. 覆蓋風險：顯式 <property>/<constructor-arg> 會覆蓋自動裝配結果
4. 簡單值無法自動裝配：基本類型、String 仍需手工 value
5. 工具支援弱：IDE 重構、依賴圖分析難以識別自動裝配關係

@Component
public class TextEditor {
    @Autowired  // byType，可配合 @Qualifier 指定名稱
    private SpellChecker spellChecker;
    
    @Value("${editor.name}")  // 簡單值注入
    private String name;
}

@Resource(name = "mySpellChecker")  // 指定 Bean 名稱
private SpellChecker spellChecker;

@Component
public class TextEditor {
    private final SpellChecker spellChecker;
    private final String name;
    
    public TextEditor(SpellChecker spellChecker, @Value("${editor.name}") String name) {
        this.spellChecker = spellChecker;
        this.name = name;
    }
}