本篇隨筆的內容涉及到幾種工具與框架應用技術,其實每一種都可以無限拓展出來單獨講。以后會認真琢磨研究之后再做記錄。
異常處理
原系統里對異常沒有做任何處理(顯然也沒有任何事務處理),系統出錯直接不響應任何頁面。于是便增加如下異常處理方案:
@ControllerAdvice
public class ExceptionHandleAdvice {
@ExceptionHandler(Exception.class)
public ModelAndView exception(Exception e) {
ModelAndView mav = new ModelAndView("errorpage/500");
mav.addObject("exception", e);
mav.addObject("type", "Exception");
return mav;
}
@ExceptionHandler(ServiceException.class)
public ModelAndView serviceException(ServiceException e) {
ModelAndView mav = new ModelAndView("errorpage/500");
mav.addObject("exception", e);
mav.addObject("type", "ServiceException");
return mav;
}
}
在errorpage/500.jsp中,可在文本框中輸出異常堆棧:
<textarea style="width: 100%" id="error-info" rows="20" class="form-control">錯誤信息:${exception.message}
<c:forEach var="trace" items="${exception.stackTrace}">${trace}
</c:forEach>
全局配置信息攔截器
需要在每個頁面輸入當前運行環境的配置信息,可通過攔截器在ModelAndView里注入配置。
定義攔截器
@Component
public class EnvInterceptor implements HandlerInterceptor {
@Autowired
private SystemConfig systemConfig;
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
if (modelAndView != null) {
modelAndView.getModelMap().addAttribute("CONFIG", systemConfig);
}
}
}
配置攔截器
其中通過 mvc:exclude-mapping
去除不要攔截的路徑,如:靜態資源文件。
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**"/>
<mvc:exclude-mapping path="/assets/**"/>
<bean class="com.xyz.intercept.EnvInterceptor">
</bean>
</mvc:interceptor>
</mvc:interceptors>
配置完成后,可在jsp頁面中可以通過${CONFIG.fieldName}
取注入的配置信息。
環境參數與配置類
最開始項目是基于xml進行配置的,不吹不黑,在配置類已經出現那么多年的情況下,還在堅持用xml配置感覺真是一件挺扯淡的事。反正xml給本人的第一感覺是相當的不干凈,java需要純粹的配置類。例如nodejs的配置就直接可是js文件,看上去非常統一。
配置文件目錄結構如下,不同環境的配置處于不同的文件下:
src
main
resources
conf
application-default.properties
application-local.properties
application-test.properties
application-prod.properties
如果是在SpringBoot 項目下,文件會被默認讀取,但是對于普通的SpringMVC項目來說,需要如下配置配置文件的讀取方式:
<context:property-placeholder
location="classpath:conf/application-default.properties,classpath:conf/application-${spring.profiles.active}.properties"
ignore-unresolvable="true"/>
其中${spring.profiles.active}
表示當前profiles,需要從java啟動參數里加入。文件會按照配置順序讀取,如果多個文件中含有同名配置,后者會覆蓋前者。
之后可以已配置類的形式讀取配置文件:
@Configuration
public class SystemConfig {
@Value("${businessHost}")
private String businessHost;
}
這里的businessHost
會自動從載入的配置文件中提取。
mybatis分頁插件
PageHelper是很常用的mybatis分頁插件。
maven配置
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper</artifactId>
<version>4.1.6</version>
</dependency>
插件配置
在mybatis的配置文件的plugins節點下加入如下配置:
<!-- com.github.pagehelper為PageHelper類所在包名 -->
<plugin interceptor="com.github.pagehelper.PageHelper">
<!-- 4.0.0以后版本可以不設置該參數 -->
<property name="dialect" value="mysql"/>
<!-- 該參數默認為false -->
<!-- 設置為true時,會將RowBounds第一個參數offset當成pageNum頁碼使用 -->
<!-- 和startPage中的pageNum效果一樣-->
<property name="offsetAsPageNum" value="true"/>
<!-- 該參數默認為false -->
<!-- 設置為true時,使用RowBounds分頁會進行count查詢 -->
<property name="rowBoundsWithCount" value="true"/>
<!-- 設置為true時,如果pageSize=0或者RowBounds.limit = 0就會查詢出全部的結果 -->
<!-- (相當于沒有執行分頁查詢,但是返回結果仍然是Page類型)-->
<property name="pageSizeZero" value="true"/>
<!-- 3.3.0版本可用 - 分頁參數合理化,默認false禁用 -->
<!-- 啟用合理化時,如果pageNum<1會查詢第一頁,如果pageNum>pages會查詢最后一頁 -->
<!-- 禁用合理化時,如果pageNum<1或pageNum>pages會返回空數據 -->
<property name="reasonable" value="false"/>
<!-- 3.5.0版本可用 - 為了支持startPage(Object params)方法 -->
<!-- 增加了一個`params`參數來配置參數映射,用于從Map或ServletRequest中取值 -->
<!-- 可以配置pageNum,pageSize,count,pageSizeZero,reasonable,orderBy,不配置映射的用默認值 -->
<!-- 不理解該含義的前提下,不要隨便復制該配置 -->
<!--<property name="params" value="pageNum=pageHelperStart;pageSize=pageHelperRows;"/>-->
<!-- 支持通過Mapper接口參數來傳遞分頁參數 -->
<property name="supportMethodsArguments" value="false"/>
<!-- always總是返回PageInfo類型,check檢查返回類型是否為PageInfo,none返回Page -->
<property name="returnPageInfo" value="none"/>
</plugin>
使用方式
下邊是一種使用示例,其他使用方式參考源碼文檔,其基本原理是在通過硬編碼在ThreadLocal
加入分頁信息,之后根據存儲的ThreadLocal信息構建分頁sql。
PageHelper.startPage(pageNum,pageSize);
List<SomeModel> list=dao.query();
PageInfo<SomeModel> page=new PageInfo<Goods>(list);
總結
本篇設涉及到的幾種技術、工具為項目優化的一部分,有的確實必要引入,有的是為了偷懶加入的。有點意思,本篇只是蜻蜓點水似的做使用記錄,接下來會記錄一些詳細的使用與研究心得。