专三、mcg-helper一键生成jeecg框架单表功能模块

        今天给大家展示mcg-helper的魅力，既然是万能代码生成，那就小试牛刀一下，本次选择java开源快速开发框架jeecg（3.7.1版本）作为示例，一键生成jeecg单表业务模块，达到生成后无需二次编码即可运行的程度。首先，我们来看看mcg-helper流程图的实现：



        从流程图中“data控件”读取表结构信息自动转换映射为关系对象，“json控件”扩展数据（如：定义列表页面的有哪些查询条件字段，列表页面表格显示哪些字段，增加页面需要录入的字段，修改页面需要编辑的字段等等），再通过“js脚本控件”进行数据处理， 通常一个模块的业务数据紧密度较高，所以原则上使用一个js脚本控件就能够满足，当然你可以自己来设计，比如多个json控件或多个js脚本控件来将数据处理或划分得更细。“文本控件”获取到参数后，可自定义组装成你需要的代码。

        假设一个表结构，如下：

CREATE TABLE `mcg_helper_user` (
`id` int(11) NOT NULL AUTO_INCREMENT COMMENT '自增主键',
`user_name` varchar(50) NOT NULL COMMENT '用户名',
`user_pwd` varchar(255) DEFAULT NULL COMMENT '密码',
`age` int(11) DEFAULT NULL COMMENT '年龄',
`reg_time` datetime DEFAULT NULL COMMENT '注册时间',
`update_time` timestamp NULL DEFAULT NULL COMMENT '更新时间',
PRIMARY KEY (`id`,`user_name`)
) ENGINE=InnoDB AUTO_INCREMENT=19 DEFAULT CHARSET=utf8;

        指定生成的目录路径，一键生成后我们直接把jeecg运行起来，实际效果如下图！



        查询、新增、修改、详情、删除、分页功能均可以正常使用，在生成流程中定义哪些列表查询条件字段，表格显示哪些字段，新增显示哪些字段，修改显示哪些字段等等。当然只要你想做，实质上可以做得更细，更到位。单表业务生成相当简单，多表原理也一样。只要有标准、有规范、有规律可循，我们就能生成，越复杂麻烦的功能模块反而更值得去实现自动生成，假如一键生成后，这功能可以减少三天或以上的工作量，那就更值得拥有。

       

        我们来看看生成的代码（这里贴出几个生成后的完整代码文件）：

       

                    

package com.jeecg.mcghelperuser.entity;

import java.io.Serializable;
import java.util.Date;

/**
*
* @Description: 业务表基本信息
* @author:      mcg-helper
* @date:        2017-11-21 17:49:08
*
*/
public class McgHelperUserEntity implements Serializable {

private static final long serialVersionUID = 1L;
/* 自增主键  */
private Integer id;
/* 用户名  */
private String userName;
/* 密码  */
private String userPwd;
/* 年龄  */
private Integer age;
/* 注册时间  */
private Date regTime;
/* 更新时间  */
private Date updateTime;

public Integer getId() {
return this.id;
}
public String getUserName() {
return this.userName;
}
public String getUserPwd() {
return this.userPwd;
}
public Integer getAge() {
return this.age;
}
public Date getRegTime() {
return this.regTime;
}
public Date getUpdateTime() {
return this.updateTime;
}

public void setId(Integer id) {
this.id = id;
}
public void setUserName(String userName) {
this.userName = userName;
}
public void setUserPwd(String userPwd) {
this.userPwd = userPwd;
}
public void setAge(Integer age) {
this.age = age;
}
public void setRegTime(Date regTime) {
this.regTime = regTime;
}
public void setUpdateTime(Date updateTime) {
this.updateTime = updateTime;
}

}

 

package com.jeecg.mcghelperuser.dao;

import org.jeecgframework.minidao.annotation.Param;
import org.jeecgframework.minidao.annotation.ResultType;
import org.jeecgframework.minidao.annotation.Sql;
import org.jeecgframework.minidao.pojo.MiniDaoPage;
import org.springframework.stereotype.Repository;

import com.jeecg.mcghelperuser.entity.McgHelperUserEntity;

@Repository
public interface McgHelperUserDao{

@Sql("SELECT * FROM mcg_helper_user WHERE id = :id and user_name = :userName")
McgHelperUserEntity get(@Param("id") Integer id, @Param("userName") String userName);

int update(@Param("mcgHelperUserEntity") McgHelperUserEntity mcgHelperUserEntity);

void insert(@Param("mcgHelperUserEntity") McgHelperUserEntity mcgHelperUserEntity);

@ResultType(McgHelperUserEntity.class)
public MiniDaoPage<McgHelperUserEntity> getAll(@Param("mcgHelperUserEntity") McgHelperUserEntity mcgHelperUserEntity, @Param("page") int page, @Param("rows") int rows);

@Sql("DELETE from mcg_helper_user WHERE id = :mcgHelperUserEntity.id and user_name = :mcgHelperUserEntity.userName")
public void delete(@Param("mcgHelperUserEntity") McgHelperUserEntity mcgHelperUserEntity);

}

package com.jeecg.mcghelperuser.web;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.velocity.VelocityContext;
import org.jeecgframework.minidao.pojo.MiniDaoPage;
import org.jeecgframework.p3.core.common.utils.AjaxJson;
import org.jeecgframework.p3.core.page.SystemTools;
import org.jeecgframework.p3.core.util.plugin.ViewVelocity;
import org.jeecgframework.p3.core.web.BaseController;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;

import com.jeecg.mcghelperuser.entity.McgHelperUserEntity;
import com.jeecg.mcghelperuser.service.McgHelperUserService;

@Controller
@RequestMapping("/demo/mcgHelperUserController")
public class McgHelperUserController extends BaseController {
@Autowired
private McgHelperUserService mcgHelperUserService;

@RequestMapping(params = "list", method = { RequestMethod.GET, RequestMethod.POST })
public void list(@ModelAttribute McgHelperUserEntity mcgHelperUserEntity, HttpServletRequest request, HttpServletResponse response,
@RequestParam(required = false, value = "pageNo", defaultValue = "1") int pageNo, @RequestParam(required = false, value = "pageSize", defaultValue = "10") int pageSize)
throws Exception {
try {
// 分页数据
MiniDaoPage<McgHelperUserEntity> list = mcgHelperUserService.getAll(mcgHelperUserEntity, pageNo, pageSize);
VelocityContext velocityContext = new VelocityContext();
velocityContext.put("mcgHelperUserEntity", mcgHelperUserEntity);
velocityContext.put("pageInfos", SystemTools.convertPaginatedList(list));
String viewName = "demo/mcghelperuser/mcghelperuser-list.vm";
ViewVelocity.view(request, response, viewName, velocityContext);
} catch (Exception e) {
e.printStackTrace();
}
}

@RequestMapping(params = "toDetail", method = RequestMethod.GET)
public void mcgHelperUserEntityDetail(@RequestParam(required = true, value = "id") Integer id, @RequestParam(required = true, value = "userName") String userName, HttpServletResponse response, HttpServletRequest request) throws Exception {
VelocityContext velocityContext = new VelocityContext();
String viewName = "demo/mcghelperuser/mcghelperuser-detail.vm";
McgHelperUserEntity mcgHelperUserEntity = mcgHelperUserService.get(id, userName);
velocityContext.put("mcgHelperUserEntity", mcgHelperUserEntity);
ViewVelocity.view(request, response, viewName, velocityContext);
}

@RequestMapping(params = "toAdd", method = { RequestMethod.GET, RequestMethod.POST })
public void toAddDialog(HttpServletRequest request, HttpServletResponse response) throws Exception {
VelocityContext velocityContext = new VelocityContext();
String viewName = "demo/mcghelperuser/mcghelperuser-add.vm";
ViewVelocity.view(request, response, viewName, velocityContext);
}

@RequestMapping(params = "doAdd", method = { RequestMethod.GET, RequestMethod.POST })
@ResponseBody
public AjaxJson doAdd(@ModelAttribute McgHelperUserEntity mcgHelperUserEntity) {
AjaxJson j = new AjaxJson();
try {
mcgHelperUserService.insert(mcgHelperUserEntity);
j.setMsg("保存成功");
} catch (Exception e) {
log.info(e.getMessage());
j.setSuccess(false);
j.setMsg("保存失败");
}
return j;
}

@RequestMapping(params = "toEdit", method = RequestMethod.GET)

public void toEdit(@RequestParam(required = true, value = "id") Integer id, @RequestParam(required = true, value = "userName") String userName, HttpServletResponse response, HttpServletRequest request) throws Exception {
VelocityContext velocityContext = new VelocityContext();
McgHelperUserEntity mcgHelperUserEntity = mcgHelperUserService.get(id, userName);
velocityContext.put("mcgHelperUserEntity", mcgHelperUserEntity);
String viewName = "demo/mcghelperuser/mcghelperuser-edit.vm";
ViewVelocity.view(request, response, viewName, velocityContext);
}

@RequestMapping(params = "doEdit", method = { RequestMethod.GET, RequestMethod.POST })
@ResponseBody
public AjaxJson doEdit(@ModelAttribute McgHelperUserEntity mcgHelperUserEntity) {
AjaxJson j = new AjaxJson();
try {
mcgHelperUserService.update(mcgHelperUserEntity);
j.setMsg("编辑成功");
} catch (Exception e) {
log.info(e.getMessage());
j.setSuccess(false);
j.setMsg("编辑失败");
}
return j;
}

@RequestMapping(params = "doDelete", method = RequestMethod.GET)
@ResponseBody
public AjaxJson doDelete(@RequestParam(required = true, value = "id") Integer id, @RequestParam(required = true, value = "userName") String userName) {
AjaxJson j = new AjaxJson();
try {
McgHelperUserEntity mcgHelperUserEntity = new McgHelperUserEntity();
mcgHelperUserEntity.setId(id);
mcgHelperUserEntity.setUserName(userName);

mcgHelperUserService.delete(mcgHelperUserEntity);
j.setMsg("删除成功");
} catch (Exception e) {
log.info(e.getMessage());
j.setSuccess(false);
j.setMsg("删除失败");
}
return j;
}

}

#parse("content/base/back/common/macro.vm")
<!DOCTYPE html>
<html lang="en">
#parse("content/base/back/common/head.vm")
<link rel="stylesheet" href="$!{basePath}/plug-in-ui/hplus/css/font-awesome.css"/>
<body style='overflow:scroll;overflow-x:hidden'>
<div class="container bs-docs-container" style="width:100%;">
<div class="row">
<form role="form" class="form-inline" action="$!{basePath}/demo/mcgHelperUserController.do?list" method="post" id="formSubmit">
<div  class="col-md-10" style="width:100%">
<div class="panel panel-default">
<div class="panel-heading">列表</div>
<div class="panel-body">
<div class="search">

<div class="form-group col-sm-3">
<label for="name" class="control-label col-sm-3 line34">用户名</label>
<div class="col-sm-8">
<input type="text" name="userName" id="userName" value="$!{mcgHelperUserEntity.userName}" class="form-control">
</div>
</div>

<button type="submit" class="btn btn-primary"><i class="fa fa-search"></i> 搜  索</button>
<div class="clearfix"></div>
</div>
<div id="legend">
<legend  class="le"><button type="button" class="btn btn-primary" onclick="doUrl('$!{basePath}/demo/mcgHelperUserController.do?toAdd')" ><i class="fa fa-plus"></i> 新增</button></legend>
</div>
<table class="table table-striped">
<thead>
<th>
<input type="checkbox" name="ckAll" id="ckAll" />
</th>
<th>用户名</th>
<th>密码</th>
<th>注册时间</th>
<th>操作</th>
</thead>
<tbody>
#if($!{pageInfos})
#foreach($!{info} in $!{pageInfos})
<tr>
<td><input type="checkbox" name="ck" value="$!{info.id}" /></td>
<td>$!{info.userName}</td>
<td>$!{info.userPwd}</td>
<td>$!{info.regTime}</td>
<td class="last">
<a class="btn btn-success btn-xs" href="javascript:doUrl('$!{basePath}/demo/mcgHelperUserController.do?toEdit&id=$!{info.id}&userName=$!{info.userName}')" ><i class="fa fa-edit"></i> 编辑</a>
<a class="btn btn-danger btn-xs" href="javascript:delData('$!{basePath}/demo/mcgHelperUserController.do?doDelete&id=$!{info.id}&userName=$!{info.userName}')"><i class="fa fa-trash-o"></i> 删除</a>
<a class="btn btn-success btn-xs" href="javascript:doUrl('$!{basePath}/demo/mcgHelperUserController.do?toDetail&id=$!{info.id}&userName=$!{info.userName}')"><i class="fa fa-file-o"></i> 详情</a>
</td>
</tr>
#end
#end
</tbody>
</table>
<div class="text-right">
<!--公用翻页代码-->
#set($attr='formSubmit')
#showPageList($pageInfos $attr)
<!--END公用翻页代码-->
</div>
</div>
</div>
</div>
</form>
</div>
</div>
</body>
</html>
<script>
$("#ckAll").click(function(){
if($(this).prop("checked")){
$(":checkbox").prop("checked",true)
}else{
$(":checkbox").prop("checked",false)
}
});

//jquery获取复选框值
function getCkValue(){
var chk_value =[];
$('input[name="ck"]:checked').each(function(){
chk_value.push($(this).val());
});
//alert(chk_value.length==0 ?'你还没有选择任何内容！':chk_value);
}

</script>

      

        从代码生成实现的角度上，我相信优化的空间还很大，我们能够不断的摸索提炼，让代码生成的实现设计更简单，而且能够支持更复杂的需求。以后要是换公司或换研发框架，针对业务编写几套自动生成，虽然谈不上高枕无忧，但也会轻松不少。为让大家更好的认识和使用mcg-helper，现推出更具营养的“使用指南”视频教程，https://pan.baidu.com/s/1sliEqhJ#list/path=%2F%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97 ,
感谢大家的支持！最后贴上一份百度云盘的分享截图：