基于SpringMVC+Spring+MyBatis (SSM) 架构的高效率便捷开发框架.zip

本项目是一个整合 **SpringMVC+Spring+MyBatis（SSM）** 框架的 **Demo**。<br> 拥有高效率便捷开发模式，使开发人员更专注于业务，达到面向业务开发。<br> 项目使用 **Maven** 构建，便于项目管理，支持 **Oracle、MySql** 等主流数据库。<br> 前端展示界面采用基于 **Boostrap** 实现的响应式布局，并集成了一系列的动画效果插件，整体界面简洁、美观大方并可优雅的与后台完成交互操作。<br> 项目封装了一系列常用方法、部署运行简单，便于个人或企业进行高效开发。 ## 一、项目开发环境&工具（Environment&Tools） * MacOS Sierra / Windows 7 * MySql 5.7 * JDK 1.8 * CentOS 7 * IntelliJ IDEA 2017.2.5 / Eclipse 4.6.1 * Navicat Premium 11.1.12 * Maven 3.3.9 * Jetty 9.4.6.v20170531 / Tomcat 9.0.1 ## 二、技术选型（Technology） #### 1.服务端技术（Server） 名称 | 版本号 | 网址 --- | --- | --- Spring Framework | 4.3.13.RELEASE | [http://projects.spring.io/spring-framework/](http://projects.spring.io/spring-framework/) Shiro | 1.4.0 | [http://shiro.apache.org](http://shiro.apache.org) AspectJ | 1.8.13 | [http://www.eclipse.org/aspectj/](http://www.eclipse.org/aspectj/) MyBatis | 3.4.5 | [http://www.mybatis.org/mybatis-3/zh/index.html](http://www.mybatis.org/mybatis-3/zh/index.html) MyBatis Generator | 1.3.6 | [http://www.mybatis.org/generator/index.html](http://www.mybatis.org/generator/index.html) PageHelper | 5.1.2 | [http://git.oschina.net/free/Mybatis_PageHelper](http://git.oschina.net/free/Mybatis_PageHelper) Druid | 1.1.6 | [https://github.com/alibaba/druid](https://github.com/alibaba/druid) Jackson | 2.9.3 | [https://github.com/FasterXML/jackson](https://github.com/FasterXML/jackson) Dom4j | 1.6.1 | [http://www.dom4j.org](http://www.dom4j.org) Ehcache | 2.6.11| [http://www.ehcache.org/](http://www.ehcache.org/) Logback | 1.2.3 | [https://logback.qos.ch](https://logback.qos.ch) Maven | 3.3.9 | [http://maven.apache.org/](http://maven.apache.org/) #### 2.前端技术（Web） 名称 | 版本号 | 网址 --- | --- | --- angular | - | [https://angularjs.org](https://angularjs.org) awesome-bootstrap-checkbox | - | [https://github.com/flatlogic/awesome-bootstrap-checkbox](https://github.com/flatlogic/awesome-bootstrap-checkbox) bootstrap | 3.3.7 | [http://www.bootcss.com](http://www.bootcss.com) bootstrap-datetimepicker | - | [http://www.bootcss.com/p/bootstrap-datetimepicker/](http://www.bootcss.com/p/bootstrap-datetimepicker/) bootstrap-select | 1.12.4 | [http://silviomoreto.github.io/bootstrap-select/](http://silviomoreto.github.io/bootstrap-select/) bootstrap-table | 1.11.1 | [http://bootstrap-table.wenzhixin.net.cn/zh-cn/documentation/](http://bootstrap-table.wenzhixin.net.cn/zh-cn/documentation/) bootstrapvalidator | 0.5.3 | [https://github.com/nghuuphuoc/bootstrapvalidator/](https://github.com/nghuuphuoc/bootstrapvalidator/) font-awesome | 4.7.0 | [http://fontawesome.io/icons/](http://fontawesome.io/icons/) fontIconPicker | 2.0.0 | [https://codeb.it/fonticonpicker/](https://codeb.it/fonticonpicker/) fullPage | - | [https://alvarotrigo.com/fullPage/](https://alvarotrigo.com/fullPage/) jquery-confirm | 3.3.0 | [https://github.com/craftpip/jquery-confirm](https://github.com/craftpip/jquery-confirm) malihu-custom-scrollbar-plugin | - | [https://github.com/videoMonkey/malihu-custom-scrollbar-plugin](https://github.com/videoMonkey/malihu-custom-scrollbar-plugin) material-design-iconic-font | 2.2.0 | [https://github.com/zavoloklom/material-design-iconic-font](https://github.com/zavoloklom/material-design-iconic-font) waves | 0.7.5 | [https://github.com/fians/Waves](https://github.com/fians/Waves) zTree_v3 | 3.5.26 | [http://www.treejs.cn/v3/main.php#_zTreeInfo](http://www.treejs.cn/v3/main.php#_zTreeInfo) BootstrapMenu | - | [https://mobirise.com/bootstrap-menu](https://mobirise.com/bootstrap-menu) device | - | [https://github.com/matthewhudson/device.js](https://github.com/matthewhudson/device.js) jquery | 3.2.1 | [http://jquery.com](http://jquery.com) jquery-cookie | - | [https://github.com/carhartl/jquery-cookie](https://github.com/carhartl/jquery-cookie) ## 三、组织树（Tree） ```lua yan-demo -- 项目 ├── src -- 源文件路径 | ├── main -- 主模块路径 | | ├── java -- java类路径 | | | ├── com.yan.common -- 通用功能模块 | | | ├── com.yan.core -- 框架核心模块 | | | ├── com.yan.demo -- 业务模块 | | ├── resources -- 资源配置路径 | | | ├── database -- 数据库sql文件 | | | ├── mybatis -- mapper映射文件 | | | ├── properties -- 配置文件 | | | ├── spring -- spring的配置文件 | | ├── webapp -- web应用根路径 | | | ├── common -- 公共路径 | | | ├── resources -- 静态资源路径 | | | ├── views -- 视图路径 | ├── test -- 测试模块路径 | | ├── com.yan.junit -- 撰写单元测试类 ``` ## 四、项目结构（Construction） > * com.yan.common：通用功能模块（包含：用户登录、菜单、后台管理等...） > * com.yan.core：框架核心模块（包括基础的控制器、过滤器、拦截器、类加载器、注入器、注解、以及框架封装的核心方法部分） > * com.yan.demo：业务模块（根据实际项目名称换掉demo名称，所有业务模块均在该路径下） > * com.yan.**.controller：控制器路径，存放自己编写业务处理的控制器（继承BaseController） > * com.yan.**.mapper：持久层映射接口类路径（mbg生成mybatis对应的Mapper映射接口类） > * com.yan.**.model：模型类路径（mbg生成的模型以及自定义模型） > * com.yan.junit：单元测试模块（便于撰写单元测试代码） > * resources/database：数据库sql文件（数据库表结构的*.sql文件，包含Yan Frame框架所需的基本系统数据表，如：用户表、权限表、菜单表等...） > * resources/mybatis：mapper映射文件（所有mybatis的sql模板*.xml文件） > * resources/properties：配置文件（如：系统基本配置、数据库配置、日志配置、MyBatis generator配置） > * resources/spring：spring的配置文件（命名规范：spring-*.xml） > * webapp/common：公共路径（前台框架的通用*.jsp头文件，页面仅需引入这里面对应的jsp即可） > * webapp/resources：静态资源路径（包含了js、css、images、doc、plugins等） > * webapp/views：视图路径（所有业务功能的*.jsp页面） ## 五、项目入门（Introduction） > 1. 使用 **Maven** 构建项目 > 2. 创建数据库并执行 **resources/database** 路径下的 **.sql** 文件，创建框架必要的表（如：用户表、资源表、日志记录表等...） > 3. 修改 **resources/properties** 路径下的 **.properties** 配置文件（具体修改方法，详见 - 六、配置说明） > 4. 完成以上步骤就可以正常部署启动服务了（使用 **jetty / tomcat** 均可），接下来进入开发阶段 > 5. 根据实际业务需求，在对应的数据库中创建业务表，表命名规范：“模块名_表名” 如：**SYS_RESOURCE**（系统模块资源表） > 6. 修改 **resources** 路径下的 **generatorConfig.xml** 中的 *targetPackage* 包名及 *tableName* 表名，使用 **MyBatis generator** 插件生成对应的持久层模块代码（Maven 执行命令：**mvn mybatis-generator:generate**），具体配置请参考[MyBatis GeneratorXML Configuration](http://www.mybatis.org/generator/configreference/xmlconfig.html) > 7. 在业务模块包下创建对应的 **controller** 包，并在包中创建控制器类，控制器类命名规范以 **Controller** 结尾，并继承于 **BaseController** 类 > 8. 编写控制器业务处理代码，具体使用参考 - 八、示例代码 > 9. 创建对