知識星球作者：張豐哲
來自：www.jianshu.com/p/ab6a9eaacaf3
前言
本文章詳細的列出了開發一個傳統JavaWeb專案需要註意的要點，從環境準備開始到三層架構搭建，需要註意的地方全部羅列出來。
第一部分：環境準備
1. Maven命令建立web骨架
mvn archetype:create -DgroupId=net.rocketa -DartifactId=mywebapp -DarchetypeArtifactId=maven-archetype-webapp
註意web servlet版本（web.xml，3.1），Junit版本指定為4.X（這樣Spring好透過註解的方式來執行單元測試）
2. 註意在IDEA中需要設定好MAVEN工程的Sources/Tests/Resources/Test Resources屬性。
3. 日誌依賴
slf4j：規範和介面
具體的日誌實現有：
log4j、logback、common-logging
因此我們一般是使用slf4j介面+一種具體的日誌實現+slf4j和這個具體日誌實現的依賴整合
4. 資料庫依賴
有2個依賴，需要註意，一個是驅動，一個是資料庫連線池（C3P0，DBCP…）。
驅動JAR包是執行期需要包含，編譯期不需要的。
5. 持久層框架依賴
說白了，DAO層的框架依賴：MyBatis or Hibernate or ….
比如除MyBatis本身的依賴需要引入之外，還需要引入MyBatis和Spring的整合依賴。
6. Web層依賴
比如，JSP中使用到的一些JSTL、標簽、Ajax訪問JSON等，還有需要註意的是，在編譯期需要引入servlet-api。
7. Spring核心依賴
spring-core、spring-beans、spring-context
8. Spring和DB之間的整合依賴
Spring是需要介入DB的管理的，比如它的宣告式事務。
spring-jdbc、spring-tx
9. Spring對Web的一些整合依賴
spring-web、spring-webmvc
10. Spring對Junit的支援依賴
spring-test
NOSQL對事務的支援不是很好，它主要追求的是效能、高可用、分散式。
MySQL等關係型資料庫對事務的支援是很成熟的，也是很可靠的落地方案。
第二部分：DAO層
NOSQL對事務的支援不是很好，它主要追求的是效能、高可用、分散式。
MySQL等關係型資料庫對事務的支援是很成熟的，也是很可靠的落地方案。
1. 表
可以在專案中建立一個SQL檔案，便於SQL的管理。
註意，表的儲存引擎（事務的支援：innodb）、自動增長的特性、編碼、主鍵和索引。
一個良好的習慣是：為所有的表都新增一個建立時間欄位，用於記錄，方便排查。
應該為表名、列名新增註釋，方便其他工程師查閱。
應該註意SQL技巧，比如插入存在唯一約束的表中，如果出現衝突不想報錯的話，可以：insert ignore into ….（可以透過傳回的影響行數來進行判斷）
2. Dao層物體
一些業務物件的建立，setter/getter/toString等就不說了，需要特別註意的是，除了表的欄位之外，還需要什麼屬性？這裡涉及到一個一對一、一對多，多對多的概念！
3. Dao層介面和mapper sql
MyBatis的特點：從SQL(引數+sql)對映到Entity/List（定製SQL、自由傳遞引數、結果集自動賦值）
使用MyBatis的方式：SQL寫在XML中，或者註解提供SQL。更加推薦的是XML，因為更加靈活，XML提供的動態拼接功能也是比註解簡單的多。
一個全域性的mybatis配置檔案+具體的SQL檔案+DAO介面：讓我們只需要設計介面，關註業務邏輯，解放出來。
在全域性mybatis配置檔案中重點註意：是否開啟駝峰轉換，獲取資料庫自增主鍵，列別名替換列名等。
註意DAO介面和具體的SQL檔案之間的對應關係。
具體SQL寫法中，比如#{}，等需要引起註意。
輸入引數型別parameterType，如果是多個基本型別，那麼不用給出來。
即便傳回的是List物件，我們的resultType依然指定的是集合中的物件型別。
在Mybatis的SQL檔案中是可以透過OGNL運算式來對物件中的一些物件型別的屬性進行賦值的！
表名.xxx 或者 表名.xxx as yyy 對於Mybatis而言，會忽略表名.字首，也會忽略as。
另外，註意在Dao介面中，如果方法有多個基本型別引數，別忘了透過@Param來進行執行期引數標記！
總結：Dao層的工作逐漸演變成介面設計和SQL編寫了，這種程式碼和SQL的分離方式，便於我們進行review，而Dao的拼接將在Service層完成。
4. 一些最佳化配置
比如，對帶包路徑的型別進行簡化，透過配置掃描包。
比如，批次掃描SQL檔案，透過自動掃描配置檔案。
5. mybatis和spring需要整合
spring需要接管資料庫
JDBC的一些連線資訊，資料庫連線池的一些配置資訊，就是配置DataSource的過程。
spring和mybatis整合的核心
SqlSessionFactory是MyBatis的配置核心，把DataSource註入，並指明MyBatis的全域性配置檔案位置，typeAliasesPackage掃描，mapper檔案位置掃描等。
spring透過動態代理幫助生成Dao的代理實現類（MapperScannerConfigurer）
註入SqlSessionFactory（透過sqlSessionFactoryBeanName），指明Dao介面的包路徑basePackage
總之，配置的一項原則是：約定優於配置！！！
第三部分：進行Spring Junit單元測試
當我們進行了一些配置，寫了一些SQL，Dao介面後，應該要進行Spring Junit單元測試，可以透過IDEA快速的生成測試用例（很好用的一個功能，因為IDEA可以幫助我們快速在test下建立與dao/service介面的同級目錄下生成用例）
在用例中，我們只需要在類上打上註解：
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration({“classpath:spring配置檔案”})
載入Spring容器後，我們就可以在用例中註入物件，開始測試了！！！
第四部分：Service層
Service層需要關註幾個要點：
業務物件的封裝、web和service之間進行資料傳遞的DTO、異常的處理（業務異常）
註意Spring事務回退的預設機制是：執行時異常。
因此，我們在service層預設定義的業務異常一般extends RuntimeException。
一般而言，透過：
try{
}catch(業務異常1 e1){
}catch(業務異常2 e2){
}catch(Exception e){
throw new 業務異常(...);
}要知道，service層可能會發生業務異常，也可能發生一些其他異常，為了Spring都可以感知到，這裡會把Exception異常轉化成執行時異常
第五部分：Controller層
1. Restful
一種優雅的URI表述方式；資源的狀態；狀態的轉移
Restful示例：
GET /product/list 查詢操作
GET /product/{productId}/detail
GET /product/time/now
POST /product/{productId}/execution 新增、修改操作【非冪等性】
POST /product/{productId}/{userId}/order
DELETE /product/{productId}/delete 刪除操作
PUT 修改操作【冪等性】
URL設計：
/模組/資源/{標示}/集合1/…
2.Controller中請求方法的細節處理
考慮幾個方面：請求引數系結、請求方式限制、轉發與重定向、資料模型賦值、JSON資料傳回、Cookie訪問
@RequestMapping(value="/{productId:\d+}/detail",method=RequestMethod.GET,produces={"application/json;charset=UTF-8"})
@ResponseBody
public String detail(
@PathVariable("productId") Long productId,@CookieValue(value="userId",required=false) Long userId,Model model){
# return "rediect:/xxx/yyy"
# return "forward:/xxx/yyy"
# return "view"
}3.整合配置Spring MVC
在web.xml中配置DispatcherServlet攔截請求，並指出Spring相關的配置檔案。
開啟Spring MVC的註解樣式：
靜態資源請求採用預設的servlet配置
配置JSP、ViewResolver的prefix「如/WEB-INF/jsp」suffix「如.jsp」
掃描web相關的Controller：
OK，先整理到這裡。
●編號769，輸入編號直達本文
●輸入m獲取文章目錄
Web開發
更多推薦《18個技術類微信公眾號》
涵蓋：程式人生、演演算法與資料結構、駭客技術與網路安全、大資料技術、前端開發、Java、Python、Web開發、安卓開發、iOS開發、C/C++、.NET、Linux、資料庫、運維等。
