{"repo":"yishuifengxiao/common-starter","free":true,"listed":false,"github":"https://github.com/yishuifengxiao/common-starter","clone":"git clone https://github.com/yishuifengxiao/common-starter.git","description":"易水公共组件是基于springboot的高度封装的通用型组件，在对spring security和spring security oauth2高度可定制化的功能封装外，还支持第三方登录和sso单点登录功能，使用户能够快速开启QQ登录和微信登录能力，搭建属于自己的认证/授权中心。此外，工具还提供各种常见的图形验证码、短信验证码和邮件验证码功能，并支持跨域设置和全局异常捕获功能，实现自定义异常信息提示。另外，组件还包含swagger接口文档功能，支持一键导出离线接口使用文档。最后，组件提供了大量丰富的配置属性，支持通过属性配置完成各项功能设置，真正实现零侵入、无缝接入功能","language":"Java","stars":24,"topics":["spring","security","spring-security","spring-security-oauth2","oauth2","oauth2-server","verification-code","code","filter"],"license":"Apache-2.0","category":"security-tools","readme_excerpt":"一 项目背景 在日常开发过程中，时常发现有一些简单的功能会被经常使用到，又没有一个比较好用的功能集合，因此在开发项目是需要反复配置，造成了大量不必要的重复性简单劳动，所以在从过往经验的基础上对日常使用到功能进行了一个通用封装，形成了 易水公共组件 ，方便后期项目开发。 本着\"一次开发,开箱即用\"的原则，组件在开发时遵守以下几点： - 开箱即用，可以选择性开启仅仅使用到的功能 - 基本配置, 在开启本组件功能后，无须二次配置即能使用组件的基本工功能。 - 个性配置，组件提供大量的配置属性，能通过预留的配置属性自定义组件功能。 - 高级配置，在系统默认配置和个性配置不能满足开发需要时，能通过自定义组件中的某些元件实现高级配置。 交流 QQ 群 : (群号 624646260) 易水公共组件是基于springboot的高度封装的通用型组件，在对spring security和spring security oauth2高度可定制化的功能封装外，还支持第三方登录和sso单点登录功能，使用户能够快速开启QQ登录和微信登录能力，搭建属于自己的认证/授权中心。 此外，工具还提供各种常见的图形验证码、短信验证码和邮件验证码功能，并支持跨域设置和全局异常捕获功能，实现自定义异常信息提示。 另外，组件还包含swagger接口文档功能，支持一键导出离线接口使用文档。 最后，组件提供了大量丰富的配置属性，支持通过属性配置完成各项功能设置，真正实现零侵入、防止暴力破解的无缝接入功能。 在保证功能灵活可用的基础上，易水公共组件还针对国人的使用习惯进行了一些本地化配置，提供了详细完整的中文使用说明文档。总的来说，易水公共组件在保证单机应用的高效性能同时，还能支持分布式署环境，能自动识别单体应用还是集群应用，是目前主流的微服务开发过程中不可或缺的重要伙伴。 二 快速启动 在项目中加入以下依赖 易水组件已经发布到maven中央仓库，最新版本的依赖可参见 https://mvnrepository.com/artifact/com.yishuifengxiao.common/common-spring-boot-starter。 在项目中引入上述依赖之后，就可以直接使用易水组件的相关功能了。 2.1 数据库操作 例如操作数据库时再也不需要编写简单的CURD的操作代码，只需要在项目中加入以下代码即可操作数据库了： 也可以使用静态工具类 JdbcUtil 对数据进行操作。 下面是数据库操作工具 JdbcHelper 的一些典型接口 2.2 spring security使用 在使用组件的安全管理功能时，需要依赖于spring security的功能。 1 在项目中加入 spring security依赖 2 在项目中加入以下启动代码 下面的代码用户应该保证能被 @ComponentScan 扫描到。 该代码的示例代码可参见 com.yishuifengxiao.common.security.SecurityConfig 实现 UserDetailsService 接口，完成自己的授权逻辑，然后按照名字 userDetailsService 将其注入到spring 之中。 【特别注意】 在用户未按照本步骤配置自己的授权逻辑时，组件会默认进行一个缺省实现。在缺省实现的情况下，用户能使用任意用户名配合密码(12345678)进行登录。 加入上述配置之后，只有组件中内置的默认路径能通过授权，访问其他的url都被重定向到 /index 这个地址，具体的配置及原因请参照后续说明。 注入的 Use","default_branch":null,"files":null,"tree":[],"storefront":"/r/yishuifengxiao","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/yishuifengxiao/common-starter/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}