歡迎光臨
每天分享高質量文章

從零開發一個Java Web專案要點

作者:張豐哲

來自: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 ….(可以通過傳回的影響行數來進行判斷)

2Dao層物體

一些業務物件的建立,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、資料庫、運維等。

赞(0)

分享創造快樂