Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/micyo202/yan-demo

本项目是基于 SpringMVC+Spring+MyBatis （SSM）架构的高效率便捷开发框架
https://github.com/micyo202/yan-demo
ajax aspectj bootstrap dom4j jackson jquery mybatis mybatis-generator pagehelper shiro spring springframework springmvc yan yan-frame
Last synced: 2 months ago
JSON representation
本项目是基于 SpringMVC+Spring+MyBatis （SSM）架构的高效率便捷开发框架
Host: GitHub
URL: https://github.com/micyo202/yan-demo
Owner: micyo202
License: mit
Created: 2017-09-13T07:01:40.000Z (about 7 years ago)
Default Branch: master
Last Pushed: 2018-10-19T00:58:01.000Z (about 6 years ago)
Last Synced: 2024-09-29T08:23:37.685Z (2 months ago)
Topics: ajax, aspectj, bootstrap, dom4j, jackson, jquery, mybatis, mybatis-generator, pagehelper, shiro, spring, springframework, springmvc, yan, yan-frame
Language: HTML
Homepage:
Size: 16.3 MB
Stars: 70
Watchers: 9
Forks: 35
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project

awesome-hacking-lists - micyo202/yan-demo - 本项目是基于 SpringMVC+Spring+MyBatis （SSM）架构的高效率便捷开发框架 (HTML)
README

        # Yan Demo 项目简介（Instruction）

### [English](https://github.com/micyo202/yan-demo/blob/master/README_EN.md) [中文文档](https://github.com/micyo202/yan-demo/blob/master/README.md)



  



[![Beta](https://img.shields.io/badge/beta-0.2.6-brightgreen.svg)](https://github.com/micyo202/yan-demo)

[![Downloads](https://img.shields.io/badge/downloads-4.3MB-yellow.svg)](https://github.com/micyo202/yan-demo/archive/master.zip)

[![Since](https://img.shields.io/badge/since-2017-blue.svg)](https://github.com/micyo202/yan-demo)

[![License MIT](https://img.shields.io/badge/license-MIT-lightgrey.svg)](https://github.com/micyo202/yan-demo/blob/master/LICENSE)

[![GitHub stars](https://img.shields.io/github/stars/micyo202/yan-demo.svg?style=social&label=Stars)](https://github.com/micyo202/yan-demo)

[![GitHub forks](https://img.shields.io/github/forks/micyo202/yan-demo.svg?style=social&label=Fork)](https://github.com/micyo202/yan-demo)

### 注：该项目已经重构，结构化更清晰，请移步至：[https://github.com/micyo202/yan](https://github.com/micyo202/yan)查看详情


本项目是一个整合 **SpringMVC+Spring+MyBatis（SSM）** 框架的 **Demo**。


拥有高效率便捷开发模式，使开发人员更专注于业务，达到面向业务开发。


项目使用 **Maven** 构建，便于项目管理，支持 **Oracle、MySql** 等主流数据库。


前端展示界面采用基于 **Boostrap** 实现的响应式布局，并集成了一系列的动画效果插件，整体界面简洁、美观大方并可优雅的与后台完成交互操作。


项目封装了一系列常用方法、部署运行简单，便于个人或企业进行高效开发。

### 为了方便大家更好的学习，特别提供了该项目的部署教程视频，请前往[http://v.youku.com/v_show/id_XMzI2MDg4Njk4NA==.html?spm=a2h3j.8428770.3416059.1](http://v.youku.com/v_show/id_XMzI2MDg4Njk4NA==.html?spm=a2h3j.8428770.3416059.1)进行观看，更多详细配置说明还请参考本文档中 ------ *六、配置说明（Properties）*

## 一、项目开发环境&工具（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. 创建对应jsp页面，并编写前端页面展示代码

## 六、配置说明（Properties）

| 名称（Key值）| 描述 |

| --- | :--- |

| **setting.upload** | 文件上传路径（绝对路径） |

| --- | :--- |

| log.name | 日志文件名称（绝对路径） |

| **log.dir** | 日志文件输出路径（绝对路径） |

| log.maxHistory | 日志文件保存最大天数 |

| log.maxSize | 日志文件大小 |

|- |- |

| **mbg.jar** | mgb插件链接数据库所需的jar包（绝对路径） |

| **mbg.path** | 生成代码的路径（绝对路径） |

| **mbg.username** | 数据库连接用户名 |

| **mbg.password** | 数据库链接密码 |

| **mbg.driverClassName** | 数据库连接驱动 |

| **mbg.url** | 数据库连接url |

|- |- |

| **default.db.username** | 默认数据库用户名 |

| **default.db.password** | 默认数据库密码 |

| **default.db.driverClassName** | 默认数据库驱动类 |

| **default.db.url** | 默认数据库链接地址 |

|- |- |

| **dextend.db.username** | 扩展数据库用户名（用于多数据源切换） |

| **dextend.db.password** | 扩展数据库密码（用于多数据源切换） |

| **dextend.db.driverClassName** | 扩展数据库驱动类（用于多数据源切换） |

| **dextend.db.url** | 扩展数据库链接地址（用于多数据源切换） |

|- |- |

| db.initialSize | 初始化时建立物理连接的个数 |

| db.minIdle | 最小连接池数量 |

| db.maxActive | 最大连接池数量 |

| db.maxWait | 获取连接时最大等待时间，单位毫秒 |

| db.timeBetweenEvictionRunsMillis | 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒 |

| db.minEvictableIdleTimeMillis | 配置一个连接在池中最小生存的时间，单位是毫秒 |

| db.validationQuery | 用来检测连接是否有效的sql |

| db.testWhileIdle | 建议配置为true，不影响性能，并且保证安全性 |

| db.testOnBorrow | 申请连接时执行validationQuery检测连接是否有效，做了这个配置会降低性能。 |

| db.testOnReturn | 归还连接时执行validationQuery检测连接是否有效，做了这个配置会降低性能 |

| db.poolPreparedStatements | 是否缓存preparedStatement，也就是PSCache |

| db.maxPoolPreparedStatementPerConnectionSize | 每个连接上PSCache的大小 |

| db.filters | 属性类型是字符串，通过别名的方式配置扩展插件，常用的插件有：监控统计用的filter:stat日志用的filter:log4j防御sql注入的filter:wall |

## 七、常用方法（Methods）

##### *方法均在继承于BaseController的controller类中使用this.metodName或直接使用methodName来进行调用（注：methodName代表需要调用的方法名称，方法名称见下表）*

| 方法名 | 参数 | 返回值 | 描述 |

| --- | :--- | :--- | :--- |

| getSession | 无 | HttpSession 服务器会话 | 获取服务器会话 session 对象 |

| setSession | session 服务器会话 | 无 | 设置服务器会话 session 对象 |

| getRequest | 无 | HttpServletRequest 用户请求 | 获取用户请求 request 对象 |

| setRequest | request 用户请求 | 无 | 设置用户请求 request 对象 |

| getResponse | 无 | HttpServletResponse 服务器响应结果 | 获取服务器响应结果 response 对象 |

| setResponse | response 服务器响应结果 | 无 | 设置服务器响应结果 response 对象 |

| **getSessionUser** | 无 | TbSysUser 用户对象 | 获取登录成功后 session 中的存储的用户信息 |

| **getMapper** | type 生成的 Mapper 接口对象类型 | T 泛型，传入参数对象的类型Mapper | 获取 mapper 对象 |

| **getMapper** | 无 | DelegateMapper 通用 mapper，查看自定义 sqlMap 的代理 mapper 对象 | 获取 delegateMapper 对象 |

| **setDataSource** | dataSource 数据源名称（必须是spring配置中包含的名称） | 无 | 动态切换数据源方法，设置数据源名称 |

| **clearDataSource** | 无 | 无 | 清除数据源，在切换完数据源后，进行清理，将数据源还原为默认数据源 |

| **offsetPage** | offset 起始数量；limit 限制条数 | 无 | 分页查询范围，参数均由 bootstrapTable 分页插件进行传入，无需人工控制，只需调用方法即可 |

| **resultPage** | list 查询到的分页结果，为 Page 对象 | PageModel 自定义的分页模型，T 为查询的对象 | 分页结果集对象 |

| **resultMsg** | status 状态值（可根据需求任意设置，无强制标准）；msg 消息内容；res 返回的对象 | MsgModel 自定义消息模型 | 消息返回对象 |

| **fileUpLoad** | request 上传方法中传递的 request 对象，并非父类中的 request 对象 | List 上传文件成功后的新文件名称，以集合形式返回 | 文件上传方法，支持多个文件上传 |

| **fileDownLoad** | fileName 需要下载的文件名称 | ResponseEntity 下载的文件，在浏览器会进行下载 | 文件下载方法 |

| isNull | obj 需要进行判断的对象 | boolean 为null或空返回 true，否则返回 false | 判断对象是否为null，或空 |

| obj2Str | obj 需要转换的对象 | String 对象的值（为null则返回""） | 对象转换为 String，通常用于获取 Map 集合中的对象时使用 |

| getUUID | 无 | String 32位主键字符串 | 生成 uuid 主键，长度为32位，且为大写模式 |

| base64Encoder | str 需要进行编码的字符串 | String 进行编码后的结果字符串 | 对字符串进行 base64 编码 |

| base64Decoder | str 已进行 base64 编码的编码字符串 | String 解码后的原字符串 | 对字符串进行 base64 解码 |

| md5 | str 需要进行 md5 加密的字符串 | String 加密后的结果 | 对字符串进行 md5 加密算法 |

| currentDate | pattern 获取系统时间的格式，如：yyyy-MM-dd HH:mm:ss | String 返回格式化后的当前时间 | 获取系统当前时间 |

| timeStamp2Date | timestamp 需要进行转换的时间戳；pattern 转换后的格式 | String 格式化后的日期 | 时间戳转换成日期 |

| date2TimeStamp | dateStr 需要进行转换的日期字符串；pattern 日期的格式 | String 转换后的时间戳 | 日期转换为时间戳 |

| readFromFile | filePath 文件路径（绝对路径） | String 读取的文件内容 | 从指定文件中读取文件内容 |

| writeToFile | content 需要写入文件中的内容 | filePath 文件路径（绝对路径） | 将内容写入到指定文件中（写入会覆盖文件原有内容，建议先读取，再写入，将读取的内容与需要写入的内容并在一起进行写入） |

| generatePath | path 文件夹路径（绝对路径） | 无 | 生成指定路径文件夹，先进行判断文件夹是否存在，若不存在则创建对应目录的文件夹，若存在则不进行任何操作 |

| generateFile | path 文件路径（绝对路径） | 无 | 生成指定路径的文件，先进行判断文件是否存在，若不存在则进行创建文件，若存在则不进行任何操作 |

| propertiesValue | key 资源文件中的 key 值 | String 读取到的 key 对应的 value 值 | 读取 properties 文件中的值，读取 classpath 下 /properties/setting.properties 配置文件 |

| propertiesValue | resource 资源文件路径（对应 classpath 中的路径）；key 资源文件中的 key 值 | String 读取到的 key 对应的 value 值 | 读取指定路径 properties 文件中的值，会从 classpath 路径下进行查找资源文件 |

## 八、示例代码（Codes）

##### 创建一个继承与BaseController的控制器

```java

@Controller

public class XxxController extends BaseController {

	...

}

```

##### 获取日志日志记录Logger对象

```java

// 使用注解获取

@LogInject

private static Logger log;

// 使用工厂方法获取

private static Logger log = LoggerFactory.getLogger(XxxController.class);

```

##### 获取mapper对象

```java

// 注解方式获取delegateMapper

@MapperInject

private DelegateMapper delegateMapper;

// 注解方式获取对象对应的mapper

@MapperInject(XxxMapper.class)

private XxxMapper mapper;

// 获取delegateMapper

this.getMapper();

// 获取对象对应的mapper

this.getMapper(XxxMapper.class);

```

##### 动态切换数据源

```java

// 注解切换数据源，默认切换扩展数据源

@DynamicDataSource

public String init(){

	...

}

// 注解切换数据源，传入ENUM类型的数据源名称

@DynamicDataSource(DataSourceName.EXTEND)

public String init(){

	...

}

// 调用父类方法执行切换数据源（参数名称建议使用框架中已经定义好的，DataSourceName.DEFAULT/EXTEND.getName()）

this.setDataSource("extendDataSource");

	...

this.clearDataSource();

```

##### 分页查询后台代码

```java

@RequestMapping("/list")

@ResponseBody

public PageModel list(int offset, int limit) {

	// 调用父类方法传入分页参数

	this.offsetPage(offset, limit);

	List list = mapper.selectByExample(null); // 调用查询方法

	return this.resultPage(list);

}

```

##### 分页查询前台代码

```javascript

$('#table').bsTable({

		url: '${pageContext.request.contextPath}/xxx/list',

		idField: 'id',

		columns: [

			{field: 'state', checkbox: true},

			{field: 'id', title: 'id', align: 'center'},

			...

			]

	});

```

##### 文件上传

```java

@RequestMapping("/upload")

public String upload(HttpServletRequest request) {

	// 调用父类的上传方法，在jsp中必须指定form为enctype="multipart/form-data"

	List fileNames = this.fileUpLoad(request);

	return "success";

}

```

##### 文件下载（在jsp页面使用通用的下载方法，使用restful风格）

```html

文件下载

```

##### 自定义文件下载后台方法

```java

@RequestMapping("/download")

public ResponseEntity download(String fileName) {

	// 调用父类文件下载方法

	return this.fileDownLoad(fileName);

}

```

##### 常用DelegateMapper及对象Mapper方法

```java

// 使用自定义sql模板查询单个对象

Demo demo = delegateMapper.selectOne(statement);

Demo demo = delegateMapper.selectOne(statement, parameter);

		

// 使用自定义sql模板查询对象集合

List list = delegateMapper.selectList(statement);

List list = delegateMapper.selectList(statement, parameter);

// 使用自定义sql模板有范围的查询，（每次返回指定的对象条数集合）

List list = delegateMapper.selectList(statement, parameter, rowBounds);

// 使用自定义sql模板进行分页查询

PageModel page = delegateMapper.selectPagination(statement, offset, limit);

PageModel page = delegateMapper.selectPagination(statement, parameter, offset, limit);

// 使用自定义sql模板保存

int res = delegateMapper.insert(statement);

int res = delegateMapper.insert(statement, parameter);

// 使用自定义sql模板修改

int res = delegateMapper.update(statement);

int res = delegateMapper.update(statement, parameter);

// 使用自定义sql模板删除

int res = delegateMapper.delete(statement);

int res = delegateMapper.delete(statement, parameter);

// 使用对象方法根据主键查询

Demo demo = mapper.selectByPrimaryKey(id);

// 使用对象方法根据criteria查询

List list = mapper.selectByExample(example);

// 使用对象方法根据criteria分页查询

this.offsetPage(offset, limit);

List list = mapper.selectByExample(example);

this.resultPage(list); // 返回的结果集

// 使用对象方法添加

int res = mapper.insert(record);

int res = mapper.insertSelective(record);

// 使用对象方法根据主键修改

int res = mapper.updateByPrimaryKey(record);

int res = mapper.updateByPrimaryKeySelective(record);

// 使用对象方法根据criteria修改

int res = mapper.updateByExample(record, example);

int res = mapper.updateByExampleSelective(record, example);

// 使用对象方法根据主键删除

int res = mapper.deleteByPrimaryKey(productCode);

// 使用对象方法删除根据criteria删除

int res = mapper.deleteByExample(example);

```

*更多方法使用请参考项目中API文档或demo模块下的代码*

## 九、效果预览（Preview）







## 十、许可证（License）

[MIT License](https://github.com/micyo202/yan-demo/blob/master/LICENSE)