Spring 基於註解的 Bean 配置全攻略：掃描路徑、@Repository/@Service/@Component/@Controller 實戰

核心配置：開啟組件掃描

<!-- applicationContext.xml -->
<context:component-scan base-package="com.example.service, com.example.dao" />

• base-package：多包用逗號/分號/空格分隔，掃描該包及子包下所有帶註解的類。
• 需引入 context 命名空間：xmlns:context="https://www.springframework.org/schema/context"。

四大核心註解語義區分

💡 本質上四者都是 @Component，Spring 通過類名掃描識別，語義區分便於 AOP 切點表達式精準匹配 (如 execution(* com.example.service.*.*(..)))。

實戰代碼示例

DAO 層

@Repository("commodityDao") // 指定 Bean 名稱，默認類名首字母小寫 commodityDaoImpl
public class CommodityDaoImpl implements CommodityDao {
    @Autowired private JdbcTemplate jdbcTemplate; // 注入模板
    // CRUD 方法...
}

Service 層

@Service("commodityService")
public class CommodityServiceImpl implements CommodityService {
    @Autowired private CommodityDao commodityDao; // 按類型注入
    // 業務方法...
}

Controller 層 (Spring MVC)

@Controller
@RequestMapping("/commodity")
public class CommodityController {
    @Autowired private CommodityService commodityService;
    
    @GetMapping("/list")
    public String list(Model model) {
        model.addAttribute("list", commodityService.findAll());
        return "commodity/list"; // 視圖名
    }
}

進階配置技巧

1. 排除/包含過濾器：

   <context:component-scan base-package="com.example">
       <context:include-filter type="annotation" expression="org.springframework.stereotype.Service"/>
       <context:exclude-filter type="regex" expression="com.example.ignore.*"/>
   </context:component-scan>

2. 自定義註解掃描：元註解 @Component 定義業務註解 @MyService，掃描器識別同樣生效。
3. 屬性占位符：<context:property-placeholder location="classpath:jdbc.properties"/> 解析 ${jdbc.url}。

Spring Boot 時代的簡化 (對比參考)

@SpringBootApplication // 等價於 @Configuration + @EnableAutoConfiguration + @ComponentScan
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}
// 無需 XML，主類所在包及子包自動掃描，application.yml 替代 properties/xml

常見錯誤與排查