易水公共組件是基於springboot的高度封裝的通用型組件,在對spring security和spring security oauth2高度可定製化的功能封裝外,還支持第三方登錄和sso單點登錄功能,使用戶能夠快速開啟QQ登錄和微信登錄能力,搭建屬於自己的認證/授權中心。
此外,工具還提供各種常見的圖形驗證碼、簡訊驗證碼和郵件驗證碼功能,並支持跨域設置和全局異常捕獲功能,實現自定義異常信息提示。
另外,組件還包含swagger接口文檔功能,支持一鍵導出離線接口使用文檔。
最後,組件提供了大量豐富的配置屬性,支持通過屬性配置完成各項功能設置,真正實現零侵入、防止暴力破解的無縫接入功能。
在保證功能靈活可用的基礎上,易水公共組件還針對國人的使用習慣進行了一些本地化配置,提供了詳細完整的中文使用說明文檔。總的來說,易水公共組件在保證單機應用的高效性能同時,還能支持分布式署環境,能自動識別單體應用還是集群應用,是目前主流的微服務開發過程中不可或缺的重要夥伴。
在項目中加入以下依賴
<dependency> <groupId>com.yishuifengxiao.common</groupId> <artifactId>common-spring-boot-starter</artifactId> <version>5.2.0</version></dependency>
易水組件已經發布到maven中央倉庫,最新版本的依賴可參見 https://mvnrepository.com/artifact/com.yishuifengxiao.common/common-spring-boot-starter。
在項目中引入上述依賴之後,就可以直接使用易水組件的相關功能了。
本次更新主要更新點如下:
資料庫操作
例如操作資料庫時再也不需要編寫簡單的CURD的操作代碼,只需要在項目中加入以下代碼即可操作資料庫了:
@Autowired private JdbcHelper jdbcHelper;
也可以使用靜態工具類JdbcUtil
對數據進行操作。
下面是資料庫操作工具JdbcHelper
的一些典型接口
/** * 根據主鍵從指定表查詢一條數據 * * @param <T> POJO類 * @param clazz POJO類 * @param primaryKey 主鍵 * @return 查詢到的數據 */ <T> T findByPrimaryKey(Class<T> clazz, Object primaryKey); /** * 查詢所有符合條件的數據 * * @param <T> POJO類 * @param t 查詢條件 * @return 符合條件的數據 */ <T> T findOne(T t); /** * 查詢所有符合條件的數據 * * @param <T> POJO類 * @param t 查詢條件 * @param order 排序條件 * @return 符合條件的數據 */ <T> List<T> findAll(T t, Order order); /** * 根據主鍵全屬性更新方式更新一條數據 * * @param <T> POJO類 * @param t 待更新的數據 * @return 受影響的記錄的數量 */ <T> int updateByPrimaryKey(T t); /** * 根據主鍵可選屬性更新方式更新一條數據 * * @param <T> POJO類 * @param t 待更新的數據 * @return 受影響的記錄的數量 */ <T> int updateByPrimaryKeySelective(T t); /** * 根據主鍵刪除一條數據 * * @param <T> POJO類 * @param clazz 操作的對象 * @param primaryKey 主鍵值 * @return 受影響的記錄的數量 */ <T> int deleteByPrimaryKey(Class<T> clazz, Object primaryKey); /** * 以全屬性方式新增一條數據 * * @param <T> POJO類 * @param t 待新增的數據 * @return 受影響的記錄的數量 */ <T> int insert(T t); /** * 以可選屬性方式新增一條數據 * * @param <T> POJO類 * @param t 待新增的數據 * @return 受影響的記錄的數量 */ <T> int insertSelective(T t);