Spring Boot框架本身并沒有對工程結(jié)構(gòu)有特別的要求,但是按照最佳實踐的工程結(jié)構(gòu)可以幫助我們減少可能會遇見的坑,尤其是Spring包掃描機制的存在,如果您使用最佳實踐的工程結(jié)構(gòu),可以免去不少特殊的配置工作。
典型示例
以下結(jié)構(gòu)是比較推薦的package組織方式:
com
+- example
+- myproject
+- Application.java
|
+- domain
| +- Customer.java
| +- CustomerRepository.java
|
+- service
| +- CustomerService.java
|
+- web
| +- CustomerController.java
|
root package
:com.example.myproject
,所有的類和其他package都在root package之下。- 應用主類:
Application.java
,該類直接位于root package
下。通常我們會在應用主類中做一些框架配置掃描等配置,我們放在root package下可以幫助程序減少手工配置來加載到我們希望被Spring加載的內(nèi)容 com.example.myproject.domain
包:用于定義實體映射關(guān)系與數(shù)據(jù)訪問相關(guān)的接口和實現(xiàn)com.example.myproject.service
包:用于編寫業(yè)務邏輯相關(guān)的接口與實現(xiàn)com.example.myproject.web
:用于編寫Web層相關(guān)的實現(xiàn),比如:Spring MVC的Controller等
上面的結(jié)構(gòu)中,root package
與應用主類的位置是整個結(jié)構(gòu)的關(guān)鍵。由于應用主類在root package
中,所以按照上面的規(guī)則定義的所有其他類都處于root package
下的其他子包之后。默認情況下,Spring Boot的應用主類會自動掃描root package
以及所有子包下的所有類來進行初始化。
什么意思呢?舉個例子,假設我們將com.example.myproject.web
包與上面所述的root package
:com.example.myproject
放在同一級,像下面這樣:
com
+- example
+- myproject
+- Application.java
|
+- domain
| +- Customer.java
| +- CustomerRepository.java
|
+- service
| +- CustomerService.java
|
+- web
| +- CustomerController.java
|
這個時候,應用主類Application.java
在默認情況下就無法掃描到com.example.myproject.web
中的Controller定義,就無法初始化Controller中定義的接口。
非典型結(jié)構(gòu)下的初始化
那么如果,我們一定要加載非root package
下的內(nèi)容怎么辦呢?
方法一:使用@ComponentScan
注解指定具體的加載包,比如:
@SpringBootApplication
@ComponentScan(basePackages="com.example")
public class Bootstrap {
public static void main(String[] args) {
SpringApplication.run(Bootstrap.class, args);
}
}
這種方法通過注解直接指定要掃描的包,比較直觀。如果有這樣的需求也是可以用的,但是原則上還是推薦以上面的典型結(jié)構(gòu)來定義,這樣也可以少寫一些注解,代碼更加簡潔。
方法二:使用@Bean
注解來初始化,比如:
@SpringBootApplication
public class Bootstrap {
public static void main(String[] args) {
SpringApplication.run(Bootstrap.class, args);
}
@Bean
public CustomerController customerController() {
return new CustomerController();
}
}
這種方法在業(yè)務開發(fā)的時候并不是特別推薦,更適合用于框架封裝等場景,關(guān)于更多封裝上的技巧,后面我們在進階教程中詳細講解。
注:本文轉(zhuǎn)載自“程序猿DD”,如有侵權(quán),請聯(lián)系刪除!