tyboot 1.1.0 發布,基於 Spring Boot 的快速開發腳手架

←手機掃碼閱讀     admin @ 2019-07-26 , reply:0

tyboot 1.1.0 

更新內容:

1.升級 swagger

2.事件觸發可獲取到方法名和參數

3.請求執行時間在攔截器中列印

4.介面級別統一使用用戶類型賦值

5.攔截器擴展驗證介面

6.請求頻次限制,實現簡單的固定時間窗口方式限制請求頻次

7.bug修復

8.資料庫腳本

9.整理示例項目介面,為下次前端開發準備。

--------------------------------------

特點

1.簡化基礎業務開發過程
    a.針對單表查詢,不用寫sql。列表,分頁,都不用寫。
    b.dao層的mapper只是一個空的介面,大部分業務不需要在mapper中寫任何代碼(除非複雜報表查詢),也不需要mapper的xml文件。
    c.baseService中有大量的泛型方法以供使用,單表單對象增刪改查在service層也不需要寫代碼,列表和分頁查詢也只需要一行代碼。
    d.提倡單表操作。不提倡使用複雜sql解決複雜的業務問題。
2.降低學習成本。新人快速上手,基礎知識過關的新人,可以快速進入業務開發狀態。
3.常用組件集成。redis,mq,事件,mongodb等等
4.通用業務模型的實現。開箱即用的業務模型,可以大大的縮減項目開發周期。計劃實現的通用業務模型有
  訂單系統,虛擬賬戶系統,支付網關,動態表單,報表系統,通用預約系統,優惠策略定製,
  基礎數據(驗證碼,字典,內部消息,地理位置信息,通用文件信息存儲,操作記錄與計數,)
5.集成常用第三方系統。簡訊(阿里大魚),存儲(七牛,阿里OSS),支付(微信公眾平台,支付寶)

項目結構

 tyboot 
  ├─tyboot-api
  │  ├─tyboot-api-boot                示例項目,實現了數據字典,許可權管理,其他項目通用的基礎功能
  ├─tyboot-component------組件
  │  ├─tyboot-component-activemq------集成activemq
  │  ├─tyboot-component-amqp----------對spring的amqp簡單集成
  │  ├─tyboot-component-cache---------緩存,對redis的進一步實現和封裝,地理位置,管道,zset實現分頁查詢,分散式鎖
  │  ├─tyboot-component-emq-----------集成mqtt服務 EMQ
  │  ├─tyboot-component-event---------利用spring的事件機制實現基於rest介面的事件處理機制
  │  ├─tyboot-component-mongo---------集成mongo
  │  ├─tyboot-component-opendata------集成常用第三方開放介面,七牛,阿里大魚,騰訊im,極光推送
  │  └─tyboot-component-validation----參數校驗
  ├─tyboot-core-----------核心包,一般情況下實例項目都會引用到
  │  ├─tyboot-core-auth---------------用戶認證,session共享
  │  ├─tyboot-core-foundation---------常用工具類庫,線程內上下文封裝;Bean、File,列錶轉樹結構,加密解密等等。。。。。
  │  ├─tyboot-core-rdbms--------------集成mybatis,mybatisplus,簡化orm和封裝servic通用操作
  │  └─tyboot-core-restful------------對restful風格的介面封裝,集成介面文檔,統一異常處理,請求攔截處理,返回數據封裝,上下文封裝
  └─tyboot-prototype------通用業務模型,針對特定業務場景進行封裝實現
      ├─tyboot-prototype-account------虛擬賬戶系統
      ├─tyboot-prototype-order--------通用訂單系統
      └─tyboot-prototype-trade--------簡單支付渠道實現,支付寶,微信

目錄約定:

示例:
tyboot-api-privilege----------------以下目錄為項目約定目錄結構
  	    org.typroject.api.privilege.
  	                            controller-------介面目錄 
  	                            face.------------業務層
  	                                model--------vo
  	                                orm.---------數據操作
  	                                    dao------mapper介面目錄
  	                                    entity---po目錄
  	                                service------業務實現類

約定

orm

1.entity需要繼承BaseEntity
    對應的數據表不能缺少通用欄位
 
     SEQUENCE_NBR    bigint	20    物理主鍵
     REC_USER_ID    varchar	32    最後更新者的id
     REC_DATE    datetime        最後更新時間
     
2.使用了mybatisplus,所以實例項目中不需要引入mapper.xml,baseMapper的方法足夠使用。
  除非要進行複雜查詢,可自行引入xml文件 
3.通常情況下dao層的mapper子介面只是一個空介面,除非要自己寫sql,或引入了xml,才會在其中寫代碼。

service

1.繼承baseService
  public class LocationInfoService extends BaseService{}
2.service中的方法不要重載,因為會只根據方法名通過反射獲取方法實例。
3.示例項目中的service層沒有寫介面,直接使用的實現類進行操作。需要介面的自行定奪。負責業務設計時候 設計原則還是要講究的。對於簡單業務,可視情況而定。
4.單表單對象的操作可以不需要在service中寫方法,也不需要引入mapper,泛型方法足夠用,
  分頁查詢和列表查詢也只需要一行代碼,示例如下:
  • 分頁:
public PagequeryDictPage(Page page, String agencyCode ,
                                                       String buType,
                                                       String dictAlias,
                                                       @Condition(Operator.like) String dictName,
                                                       String dictCode) throws Exception
            {
                return this.queryForPage(page,"排序欄位",false,agencyCode,buType,dictAlias,dictName,dictCode);
            }
  作為查詢條件的參數名稱需要和對應model中的屬性名稱一致。
      傳入baseService.queryForPage中的params參數列表需要和前置方法(queryDictPage)的參數順序一致,
      底層會自動解析前置方法參數名稱並對值判空,然後轉換為資料庫欄位名,用於構建條件組裝器。
      註解@Condition用於定義條件操作符,已實現的條件操作符詳見Operator,所有查詢條件的邏輯關係都是與關係
      目前還沒打算實現或關係。
  • 列表:(參數約定與分頁方法相同)
  public ListqueryDictList(String agencyCode ,
                                                     String buType,
                                                     String dictAlias,
                                                      @Condition(Operator.like)String dictName,
                                                     String dictCode) throws Exception
          {
              return this.queryForList("排序欄位",false,agencyCode,buType,dictAlias,dictName,dictCode);
          }

controller

1.統一返回值,所有介面統一使用ResponseModel封裝返回值。
2.自定義註解@TycloudOperation用來定義介面的訪問級別ApiLevel,鑒權控制needAuth
3.可以設置是否返回真實http狀態,或者全部返回200.

關於緩存

1.單表單對象緩存,單表列表緩存都已經集成到baseService的方法中,可以隨著對象的更新刷新或刪除緩存,可以查看方法備註以選擇是使用。
2.其他緩存場景建議直接使用rediTemplate進行操作
3.tyboot-component-cache模塊提供了基於redis Zset分頁查詢;地理位置計算和查詢;redis管道的使用

 





[admin ]

來源:OsChina
連結:https://www.oschina.net/news/108545/tyboot-1-1-0-released
tyboot 1.1.0 發布,基於 Spring Boot 的快速開發腳手架已經有58次圍觀

http://coctec.com/news/all/show-post-210882.html