关于博客中使用的Guns版本问题请先阅读 Guns二次开发目录
在上一篇博客中,我们实现了后台管理系统的商品分类管理模块的添加功能,这篇博客我们开始来实现修改的功能。
1、预期实现的效果
这是预期实现的效果图:
此时能够修改的字段其实只有两个,而分类状态的修改则被我独立出来,一方面是为了提高体验,更主要的其实只是为了简化后端接口的逻辑,将复杂的逻辑拆分为两个独立的事件,并交由两个接口去实现。分类状态的值有两个,一个是启用,一个是停用。启用的时候需要同时启用被停用的父级分类;停用则要判断当前分类下是否有商品,只有在没有上架商品的情况下才能停用当前分类(当然,这个逻辑不是现在考虑的,只是预留出一个位置,等待商品模块开发出来后再做补充)。
2、修改分类功能的实现
(1)首先是修改按钮的点击事件
当点击【修改】按钮时 ,会调用下面的这个 Category.openCategoryDetail()函数,因为我数据库保存的时间都是13位的unix时间戳,所以需要格式化时间,要格式化时间,就要获取当前浏览器的时区偏移量。而下面的这个moment()函数在前面的博客中有介绍过,引用的是moment.js中函数。
(2)查询分类详情的后端接口
上面的函数执行完成之后,会跳转到分类详情的接口,这个接口的主要作用是根据分类id查询到当前分类的详情信息,为beetl的页面渲染(springboot,确切的说是由springmvc自动完成模板渲染)提供数据。
获取数据的操作,有两个地方要说明,一个是 DBUtil.selectById()方法,这个工具方法主要是用来判断前端传来的id字段是否合法,也就是能否在数据库中查到记录,因为后续很多模块的接口都要执行此操作,所以我将他单独抽取出来作为一个工具类,其核心功能是使用反射实现的,同时也涉及到一个非spring管理的类调用spring管理的类的实现方法。TimeUtil.unixTimestampToLocalDate()方法则是我自定义的时间格式化函数。工具类具体的实现逻辑,可以查看代码。
(3)分类详情页面
分类详情页面,需要对字段进行填充,使用的是beetl模板的语法。除此之外,我还加了一些input隐藏标签,用来存储一些重要的数据,这些数据都是在提交修改分类接口的时候后端需要的。
(4)修改页面提交按钮调用的js函数
提交修改的js逻辑和添加时一样,不过需要注意修改成功之后,关闭模态框和刷新列表的操作。 因为category_info.js 是在 category_edit.html页面引入的,而 category.js则没有在 category_edit.html页面引入,在category_edit.html页面要想调用 category.js的函数,需要加一个 window.parent 前缀:
(5)商品分类修改接口的实现
修改商品分类接口有使用到乐观锁,其逻辑是:假设我们在分类详情页面看到的数据是version=3的版本,此时修改的时候,也要携带这个version=3这个参数,意思是我要修改的是version=3这个版本的数据。在编写修改的 sql语句的时候,要同步更新version(即 sql的set 子句部分 要加上 version=version+1),同时其 where子句也要添加一个 version=3 的条件。并发情况下,当你点击提交按钮之前,假设这条记录被另一个人修改过了,此时记录的version就必然会大于3,那么version=3这个条件就不成立,所以修改就不能成功,抛出运行时异常后,前面已经执行的sql都将会被事务回滚。此时前端再提示用户重新打开详情一面,一方面是为了查看最新的详情信息,另一方面也是为了让页面获取最新的version字段的值,只有携带最新的version才能修改成功。关于乐观锁的使用,Mybatis-plus提供了更简便的方法,可以参考这篇博客 mybatis-plus中使用乐观锁 。我在项目中使用的方法可能显得有些笨拙,但这也是由实际需求决定的。
3、启用/停用功能的实现
(1)在页面添加【启用/停用】
首先,这个这个按钮的实现不是简单的在页面加一行显示按钮的代码就可以了,而应该遵守【修改】和【删除】按钮的规范,如下图:
具体实现的步骤是:
最后退出当前账号后重新登录,就能看到这个 【启用/停用】按钮了。
(2)编写【启用/停用】按钮的点击事件
点击【启用/停用】按钮后触发的js函数的内部逻辑,要通过当前记录的状态,如果当前状态是“停用”,那么此时的请求就是“启用”,反之,如果当前记录的状态已经是“启用”,那这个点击事件触发的就是“停用”请求。启用与停用的操作,也需要携带乐观锁字段(本例的字段名是 version),乐观锁的使用前面已经提过,此处不再赘述。
启用/停用 按钮触发的点击事件:
这里有一点要说明,这里的version字段其实是隐藏值,这个需要修改bootstrap源码才能实现,修改的bootstrap源码文件是下面这个,此处我先分享出来,具体修改的过程留到下一篇博客说明,因为这一篇的篇幅有点大。
(3)启用/停用的后端接口
启用和停用接口的逻辑会有些复杂,前面已经分析过,此处不再赘述,大家直接看后面的代码即可。
4、实现修改时的更新时间自动填充
首先请看下面这段代码,这是我执行修改商品分类时拼接的语句:
然后看具体执行的sql:
可以发现,我虽然没有设置updateTime这个字段的值,但是执行sql的时候却自动加上了。
这是通过 mybatis-plus的公共字段自动填充 功能实现的。下面是具体的实现代码:
(1)首先是实体类中对要自动填充的自动添加注解
(2)自定义实现类 MyMetaObjectHandler
5、源码
注:此处分享的代码,只跟本篇博客的主题 ,即修改商品分类的实现有关,所以,即使你全部照搬这篇博客里提供的代码,也可能会出现因为缺少某些类而导致项目无法启动,因为有些代码要在前面几遍博客中才会出现。建议你看的时候,重点关注修改点相对于的代码,这才是本篇博客的灵魂啊。
(1)StatusConstant.java
package cn.stylefeng.guns.elephish.constants;
/**
* 数据库中的表格的 status字段状态的值的常量
*/
public interface StatusConstant {
/**
* 商品分类表 mall_product_category 中的status字段:
* 1,启用中;2,停用中;3,已删除
*/
int PRODUCT_CATEGORY_STATUS_START = 1;//表示 启用中 含义的值。
int PRODUCT_CATEGORY_STATUS_STOP = 2;//表示 停用中 含义的值
int PRODUCT_CATEGORY_STATUS_DELETE = 3;//表示 已删除 含义的值
}
(2)CategoryController.java
package cn.stylefeng.guns.elephish.controller;
import cn.stylefeng.guns.core.common.annotion.BussinessLog;
import cn.stylefeng.guns.core.common.annotion.Permission;
import cn.stylefeng.guns.core.common.node.ZTreeNode;
import cn.stylefeng.guns.core.log.LogObjectHolder;
import cn.stylefeng.guns.elephish.bean.PageInfo;
import cn.stylefeng.guns.elephish.bean.QueryParam;
import cn.stylefeng.guns.elephish.constants.dictmaps.CategoryDict;
import cn.stylefeng.guns.elephish.form.CategoryForm;
import cn.stylefeng.guns.elephish.utils.DBUtil;
import cn.stylefeng.guns.elephish.wrapper.CategoryWrapper;
import cn.stylefeng.roses.core.base.controller.BaseController;
import com.alibaba.fastjson.JSONObject;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.ui.Model;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestParam;
import cn.stylefeng.guns.elephish.service.ICategoryService;
import javax.servlet.http.HttpServletRequest;
import javax.validation.Valid;
import java.util.List;
import java.util.Map;
/**
* 分类管理控制器
*
* @author fengshuonan
* @Date 2020-04-13 11:02:46
*/
@Controller
@RequestMapping("/category")
public class CategoryController extends BaseController {
private Logger logger = LoggerFactory.getLogger(getClass());
private String PREFIX = "/elephish/category/";
@Autowired
private ICategoryService categoryService;
/**
* 跳转到添加分类管理
*/
@RequestMapping("/category_add")
public String categoryAdd(Integer parentId,String parentName,Integer depth,
Integer currentPage,HttpServletRequest request) {
request.setAttribute("parentId",parentId);
request.setAttribute("parentName",parentName);
request.setAttribute("depth",depth);
request.setAttribute("currentPage",currentPage);
return PREFIX + "category_add.html";
}
/**
* 跳转到修改分类管理
*/
@RequestMapping("/category_update")
public String categoryUpdate(@RequestParam("id") int id,@RequestParam("timeZone") String timeZone,
@RequestParam("currentPage") int currentPage,Model model) {
// Category map = categoryService.selectById(categoryId);
// LogObjectHolder.me().set(category);
Map<String,Object> map = categoryService.getCategoryDetails(id,timeZone);
map.put("currentPage",currentPage);//当前页码
model.addAttribute("item",map);
return PREFIX + "category_edit.html";
}
/**
* 跳转到分类管理首页
*/
@RequestMapping("")
public String index() {
return PREFIX + "category.html";
}
/**
* 获取分类管理列表
*/
@RequestMapping(value = "/list")
@ResponseBody
public Object list(QueryParam queryParam,PageInfo pageInfo) {
List<Map<String, Object>> list = categoryService.listCategory(queryParam,pageInfo);
//因为是自定义分页,所以返回的数据格式需要做特殊封装,主要是两个属性名的定义要固定
JSONObject jo=new JSONObject();//也可以使用 Map<String,Object>
//属性名必须是【data】,对应的值是List<Map<String, Object>>格式
jo.put("data",new CategoryWrapper(list).wrap());
jo.put("pageInfo",pageInfo);//属性名必须是 pageInfo,
return jo;
}
/**
* 停用或启用商品分类及其所有子类
* @param id
* @param version
* @param status
* @return
*/
@RequestMapping(value = "/status")
@ResponseBody
public Object updateStatus(@RequestParam("id")int id,
@RequestParam("version")int version,
@RequestParam("status")int status) {
categoryService.updateStatus(id,version,status);
return SUCCESS_TIP;
}
/**
* 新增分类管理
*/
@RequestMapping(value = "/add")
@ResponseBody
public Object add(@Valid CategoryForm categoryForm) {
/**
* 1、修改接收数据的实体类,因为如果直接使用DAO层的实体类来接收,
* 会导致一些不需要的数据被写进数据库
* 2、对必传数据要判断是否为空
* 3、只接收需要的数据,比如这个CategoryForm实体类,id这个字段我是不需要的,但是只是
* 添加这个接口不需要,我修改接口是需要的,此时不能在CategoryForm这个类中不定义id这个属性。
* 所以,正确的做法是,在添加接口的具体逻辑里,我不在乎你是否传了id,因为我压根不会操作这个字段
*/
categoryService.addCategory(categoryForm);
return SUCCESS_TIP;
}
/**
* 删除分类管理
*/
@RequestMapping(value = "/delete")
@ResponseBody
public Object delete(@RequestParam Integer categoryId) {
categoryService.deleteById(categoryId);
return SUCCESS_TIP;
}
/**
* 修改分类管理
*
* 逻辑:
* (1)已废弃的商品分类不能修改
* (2)允许修改的地方:分类名称,排序数字
* (3)如果修改的分类名称已经存在,修改失败
* (4)其它情况修改成功
*/
@RequestMapping(value = "/update")
@ResponseBody
public Object update(@Valid CategoryForm categoryForm) {
//修改流水暂时不处理,后面专门使用单独的篇幅演示
categoryService.updateCategory(categoryForm);
return SUCCESS_TIP;
}
/**
* 分类管理详情
*/
// @RequestMapping(value = "/detail/{categoryId}")
// @ResponseBody
// public Object detail(@PathVariable("categoryId") Integer categoryId) {
// return categoryService.selectById(categoryId);
// }
/**
* 获取菜单列表(选择父级菜单用)
*/
@RequestMapping(value = "/selectCategoryTreeList")
@ResponseBody
public List<ZTreeNode> selectMenuTreeList() {
List<ZTreeNode> roleTreeList = categoryService.categoryTreeList();
roleTreeList.add(ZTreeNode.createParent());
return roleTreeList;
}
}
(3)Category.java
package cn.stylefeng.guns.elephish.model;
import com.baomidou.mybatisplus.annotations.Version;
import com.baomidou.mybatisplus.enums.FieldFill;
import com.baomidou.mybatisplus.enums.IdType;
import com.baomidou.mybatisplus.annotations.TableId;
import com.baomidou.mybatisplus.annotations.TableField;
import com.baomidou.mybatisplus.activerecord.Model;
import com.baomidou.mybatisplus.annotations.TableName;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.experimental.Accessors;
import java.io.Serializable;
/**
* @author hqq
*/
@Data
@EqualsAndHashCode(callSuper = false)
@Accessors(chain = true)
@TableName("mall_category")
public class Category extends Model<Category> {
private static final long serialVersionUID = 1L;
/**
* 类别id
*/
@TableId(value = "id", type = IdType.AUTO)
private Integer id;
/**
* 父类别id,当id=0时,说明是根节点,一级类别
*/
@TableField("parent_id")
private Integer parentId;
/**
* 当前类别的所有父类别id,包含多层级别的父类别id,方便查找
*/
@TableField("parent_ids")
private String parentIds;
/**
* 类别名称
*/
private String name;
/**
* 类别状态。1,正常;2,已废弃
*/
private Integer status;
/**
* 排序编号,同类展示顺序,数值相等则自然排序
*/
@TableField("sort")
private Integer sort;
/**
* 深度,也就是菜单层级,1表示第一级,2表示第二级,以此类推
*/
private Integer depth;
/**
* 版本(乐观锁保留字段)
*/
@Version
private Integer version;
/**
* 创建时间,单位是毫秒
*/
@TableField(value = "create_time",fill = FieldFill.INSERT)
private Long createTime;
/**
* 更新时间,单位是毫秒
*/
@TableField(value="update_time",fill = FieldFill.UPDATE)
private Long updateTime;
@Override
protected Serializable pkVal() {
return this.id;
}
}
(4)CategoryServiceImpl.java
package cn.stylefeng.guns.elephish.service.impl;
import cn.stylefeng.guns.core.common.constant.factory.ConstantFactory;
import cn.stylefeng.guns.core.common.exception.BizExceptionEnum;
import cn.stylefeng.guns.core.common.node.ZTreeNode;
import cn.stylefeng.guns.elephish.bean.PageInfo;
import cn.stylefeng.guns.elephish.bean.QueryParam;
import cn.stylefeng.guns.elephish.constants.LimitationConstant;
import cn.stylefeng.guns.elephish.constants.StatusConstant;
import cn.stylefeng.guns.elephish.constants.WrapperDictNameConstant;
import cn.stylefeng.guns.elephish.form.CategoryForm;
import cn.stylefeng.guns.elephish.model.Category;
import cn.stylefeng.guns.elephish.dao.CategoryMapper;
import cn.stylefeng.guns.elephish.service.ICategoryService;
import cn.stylefeng.guns.elephish.utils.DBUtil;
import cn.stylefeng.guns.elephish.utils.StringUtil;
import cn.stylefeng.guns.elephish.utils.TimeUtil;
import cn.stylefeng.roses.kernel.model.exception.ServiceException;
import com.alibaba.fastjson.JSONObject;
import com.baomidou.mybatisplus.mapper.EntityWrapper;
import com.baomidou.mybatisplus.mapper.Wrapper;
import com.baomidou.mybatisplus.plugins.Page;
import com.baomidou.mybatisplus.service.impl.ServiceImpl;
import com.sun.javafx.sg.prism.NGEllipse;
import org.apache.commons.lang3.StringUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import java.util.*;
/**
* <p>
* 服务实现类
* </p>
*
* @author hqq
*/
@Service
public class CategoryServiceImpl extends ServiceImpl<CategoryMapper, Category>
implements ICategoryService,StatusConstant {
@Autowired
private CategoryMapper categoryMapper;
@Transactional
@Override
public void updateStatus(int id, int version, int status) {
//判断状态参数是否正确
if(!(status==PRODUCT_CATEGORY_STATUS_START || status == PRODUCT_CATEGORY_STATUS_STOP)){
//ILLEGAL_PARAM(400,"非法参数"),
throw new ServiceException(BizExceptionEnum.ILLEGAL_PARAM);
}
//判断id是否存在
Category category= DBUtil.selectById(id,"分类id",CategoryMapper.class);
//判断版本是否冲突,如果冲突,则直接返回
if(version != category.getVersion()){
// FAIL_UPDATE_CONCURRENT(500,"并发修改异常,请稍后重试"),
throw new ServiceException(BizExceptionEnum.FAIL_UPDATE_CONCURRENT);
}
//如果当前状态已经是这样了,则不需要修改
if(status == category.getStatus()){
return;
}
//如果是启用,并且当前分类不是顶级分类菜单,就要同时启用已停用的父类菜单,
// 如果父类菜单有被删除的,则无法启用当前分类
if(status == PRODUCT_CATEGORY_STATUS_START && category.getParentId()!= 0 ){
//判断当前分类的所有父类是否有已被删除的
List<Integer> ids = StringUtil.chunkSplitInt(category.getParentIds(), ",");
ids.remove(0);//去掉顶级菜单标识
Integer[] idArr = ids.toArray(new Integer[ids.size()]);
Wrapper<Category> wrapper = new EntityWrapper<>();
wrapper.ne("status",PRODUCT_CATEGORY_STATUS_DELETE)
.in("id",idArr);
Integer count = categoryMapper.selectCount(wrapper);
if(count != idArr.length){
//CATEGORY_PARENT_DELETED(500,"有父类菜单已被删除,无法执行此操作"),
throw new ServiceException(BizExceptionEnum.CATEGORY_PARENT_DELETED);
}
//同时启用当前分类的所有父类
Category cg = new Category();
cg.setStatus(PRODUCT_CATEGORY_STATUS_START);
wrapper = new EntityWrapper<>();
wrapper.eq("status",PRODUCT_CATEGORY_STATUS_STOP)
.in("id",idArr);
categoryMapper.update(cg,wrapper);
}
//递归修改所有的子节点状态
recursionUpdateStatus(id,version,status);
}
/**
* 递归修改所有的子节点的状态
* @param id
* @param version
* @param status
*/
private void recursionUpdateStatus(int id, int version, int status) {
if(status==PRODUCT_CATEGORY_STATUS_STOP){
//如果是停用,则要判断当前分类下是否有上架中的商品
//。。。。。。
}
//对当前分类状态做状态修改,只要有一个失败了,就全部失败
Category category = new Category();
category.setVersion(version+1);
category.setStatus(status);
Wrapper<Category> wrapper = new EntityWrapper<>();
wrapper.eq("id",id)
.eq("version",version)
.ne("status",PRODUCT_CATEGORY_STATUS_DELETE);
int count = categoryMapper.update(category,wrapper);
if(count==0){
//FAIL_UPDATE_CONCURRENT(500,"并发修改异常,请稍后重试"),
throw new ServiceException(BizExceptionEnum.FAIL_UPDATE_CONCURRENT);
}
//查询所有需要上架/下架的所有子类分类,并递归执行上架和下架的操作
wrapper = new EntityWrapper<>();
wrapper.eq("parent_id",id)
.eq("status",status == PRODUCT_CATEGORY_STATUS_START?
PRODUCT_CATEGORY_STATUS_STOP:PRODUCT_CATEGORY_STATUS_START)
.setSqlSelect("id","version");//只查询id和version字段,提高封装效率
List<Category> list = categoryMapper.selectList(wrapper);
Category temp = null;
for(int i = 0 ;i<list.size() ; i++){
temp = list.get(i);
recursionUpdateStatus(temp.getId(),temp.getVersion(),status);
}
}
/**
* 更新分类管理菜单的信息
* @param form
*/
@Transactional
@Override
public void updateCategory(CategoryForm form) {
/**
* 做到给商品分类添加属性组的时候,发现如果修改分类所属的父类时,
* 后期的业务逻辑会变得很复杂,为简化业务逻辑的复杂度,
* 修改商品分类的时候,不允许用户更换父类菜单。
*/
//校验参数合法性,其实可以省略,但是后面因为要校验同名记录时需要用到父类id
Category category = DBUtil.selectById(form.getId(),"分类id",CategoryMapper.class);
if(category.getStatus() == PRODUCT_CATEGORY_STATUS_DELETE){
//CATEGORY_ERROR_CATEGORY_DELETED(500,"不能修改已废弃的商品份分类"),
throw new ServiceException(BizExceptionEnum.CATEGORY_ERROR_CATEGORY_DELETED);
}
//封装要修改的内容,默认不更换父类菜单,只是修改名称或修改排序编号
Category cg = new Category();
cg.setName(form.getName());
cg.setSort(form.getSort());
cg.setVersion(form.getVersion()+1);
Wrapper<Category> wrapper = new EntityWrapper<>();
wrapper.eq("id",form.getId())
.eq("version", form.getVersion())
.ne("status",PRODUCT_CATEGORY_STATUS_DELETE);//不能修改已删除的记录
Integer count= categoryMapper.update(cg,wrapper);
if(count==0){
//FAIL_ADD_RECORD(500,"数据库中新增数据失败"),
throw new ServiceException(BizExceptionEnum.FAIL_ADD_RECORD);
}
//要判断除了自身之外,同一个父类菜单下,是否有重名记录,
//如果不加判断的修改,会产生重名记录
//判断分类名称是否已经存在。status=1 ,2 时才算重复
wrapper = new EntityWrapper<>();
wrapper.eq("parent_id",category.getParentId())
.eq("name",form.getName())
.in("status",new Integer[]{PRODUCT_CATEGORY_STATUS_START,PRODUCT_CATEGORY_STATUS_STOP});
count = categoryMapper.selectCount(wrapper);
if(count>1){
//ERROR_EXISTED_SAME_NAME_RECORD(500,"数据库中已经存在同名的记录"),
throw new ServiceException(BizExceptionEnum.ERROR_EXISTED_SAME_NAME_RECORD);
}
}
/**
* 获取分类管理的详情信息
*/
@Override
public Map<String, Object> getCategoryDetails(Integer categoryId, String timeZone) {
Category category = DBUtil.selectById(categoryId,"分类id",CategoryMapper.class);
JSONObject jo = JSONObject.parseObject(JSONObject.toJSONString(category), JSONObject.class);
//获取父类信息
Integer parentId = category.getParentId();
String parentName = "顶级";//顶级的分类信息
StringBuilder parentNames = new StringBuilder("[顶级]");//所有的分类信息
int parentDepth = 0;
//查找分类状态的字典解释
String statusName = ConstantFactory.me().getDictById(
WrapperDictNameConstant.MALL_CATEGORY_STATUS_ID, category.getStatus().toString());
jo.put("statusName",statusName);
//格式化时间的操作
int zoneHour = TimeUtil.formatZoneHour(timeZone);
if(category.getCreateTime()!=null){
jo.put("createTime",TimeUtil.unixTimestampToLocalDate(category.getCreateTime(),zoneHour));
}
if(category.getUpdateTime()!=null){
jo.put("updateTime",TimeUtil.unixTimestampToLocalDate(category.getUpdateTime(),zoneHour));
}
//获取所有的父类名称,并拼接成字符串如:'[体育]->[篮球]'
if(parentId!=0){
//获取父类信息
Category parent = DBUtil.selectById(parentId,"分类id",CategoryMapper.class);
parentName = parent.getName();
parentDepth = parent.getDepth();
//获取所有的父类信息
List<Integer> ids = StringUtil.chunkSplitInt(category.getParentIds(), ",");
String name = null;
int num = 0;
for(int i=0;i<ids.size();i++){
num = ids.get(i);
//顶级菜单栏不用查
if(num==0){
continue;
}
name = categoryMapper.findCategoryNameById(num);
if(StringUtils.isBlank(name)){
continue;
}
parentNames.append("->[").append(name).append("]");
}
}
//再加上自己
parentNames.append("->[").append(category.getName()).append("]");
jo.put("parentName",parentName);//保存父类名称
jo.put("parentDepth",parentDepth);//保存父类深度
jo.put("parentNames",parentNames.toString());//保存所有的父类名称
return jo;
}
@Override
public List<ZTreeNode> categoryTreeList() {
return categoryMapper.categoryTreeList(LimitationConstant.MALL_CATEGORY_TREE_MAX_DEPTH);
}
/**
* 自定义逻辑的添加商品分类实现
* @param form
*/
@Transactional
@Override
public void addCategory(CategoryForm form) {
int parentId = form.getParentId();
int status = form.getStatus();
//判断status字段是否合法
if(!(status==PRODUCT_CATEGORY_STATUS_START || status==PRODUCT_CATEGORY_STATUS_STOP)){
//ILLEGAL_PARAM(400,"非法参数"),
throw new ServiceException(BizExceptionEnum.ILLEGAL_PARAM);
}
/**
*虽然我前端做了必传字段的半段,但是我在以往的很多博客中都说过,
*永远不要相信前端传来的数据(即便前后端代码都是同一个人写),
*该做的判断还是要判断,
*/
//设置parentIds,默认值是0
String parentIds = "[0],";
int depth = 1;
//判断parentId是否合法
if(parentId>0){
Category cg = DBUtil.selectById(parentId,"分类id",CategoryMapper.class);
if(cg.getStatus() == PRODUCT_CATEGORY_STATUS_STOP){
//CATEGORY_ERROR_PARENT_DELETED(500,"不能为已废弃的父类菜单添加子菜单"),
throw new ServiceException(BizExceptionEnum.CATEGORY_ERROR_PARENT_DELETED);
}
//判断当前是否是叶子节点,如果是,则无法添加子分类
if(cg.getDepth() >= LimitationConstant.MALL_CATEGORY_TREE_MAX_DEPTH){
//CATEGORY_ERROR_NO_NEXT_NODE(500,"当前节点已是叶子节点,无法继续添加子分类"),
throw new ServiceException(BizExceptionEnum.CATEGORY_ERROR_NO_NEXT_NODE);
}
parentIds = cg.getParentIds()+ "["+parentId+"],";
depth = cg.getDepth()+1;
}
//开始执行添加操作
Category category = new Category();
category.setParentId(parentId);
category.setParentIds(parentIds);
category.setDepth(depth);
category.setSort(form.getSort());
category.setName(form.getName());
category.setVersion(1);
category.setStatus(status);//设置默认状态
int count = categoryMapper.insert(category);
if(count==0){
// ERROR_EXISTED_SAME_NAME_RECORD(500,"数据库中已经存在同名的记录"),
throw new ServiceException(BizExceptionEnum.ERROR_EXISTED_SAME_NAME_RECORD);
}
//判断分类名称是否已经存在。status=1 ,2 时才算重复
Wrapper<Category> wrapper = new EntityWrapper<>();
wrapper.eq("parent_id",parentId)
.eq("name",form.getName())
.in("status",new Integer[]{PRODUCT_CATEGORY_STATUS_START,PRODUCT_CATEGORY_STATUS_STOP});
count = categoryMapper.selectCount(wrapper);
//前面已经添加一次了,这时数据库应该只有一条同名记录,如果大于一条,说明名字重复
//此时抛出异常,那么整个事务都会回滚,添加操作失败
if(count>1){
//ERROR_EXISTED_SAME_NAME_RECORD(500,"数据库中已经存在同名的记录"),
throw new ServiceException(BizExceptionEnum.ERROR_EXISTED_SAME_NAME_RECORD);
}
}
@Override
public List<Map<String, Object>> listCategory(QueryParam queryParam, PageInfo pageInfo) {
//设置排序
String sortField = "sort";//排序字段
boolean isAsc = true;//是否正序排序
//构建查询条件
Wrapper<Category> wrapper = buildWrapper(queryParam, sortField,isAsc);
Page<Map<String,Object>> page=new Page<>(pageInfo.getCurrentPage(),pageInfo.getLimit());
List<Map<String, Object>> maps = categoryMapper.selectMapsPage(page, wrapper);
//设置总页数
int total = (int) page.getTotal();
pageInfo.setTotalPage((int)Math.ceil(1.0*total/pageInfo.getLimit()));//总页数
pageInfo.setTotalCount(total);//总记录数
if(maps.isEmpty()){
return maps;
}
//设置查询到的本页记录数,因为默认值为0,所以大于0的时候才需要设置
pageInfo.setSize(maps.size());
//如果不查询子类菜单,直接返回
if(!queryParam.isSearchChild()){
return maps;
}
//遍历查询其子类
List<Map<String, Object>> list = new ArrayList<>();
for(int i = 0; i<maps.size();i++){
findChildCategory(list, maps.get(i),sortField,isAsc,queryParam.getStatus());
}
return list;
}
/**
* 封装 category 的查询条件,
* 注意:这些查询条件是针对顶级菜单的,
* 子级菜单的查询条件只有一个parent_id和排序方式
* @param queryParam
* @return
*/
private Wrapper<Category> buildWrapper(QueryParam queryParam,String sortField,boolean isAsc){
int status = queryParam.getStatus();
Wrapper<Category> wrapper = new EntityWrapper<>();
//设置排序字段和排序方式
wrapper.orderBy(sortField,isAsc);
//是否按照层级查询
Integer depth =queryParam.getDepth();
if(depth != null){
wrapper.eq("depth", depth);
}
//是否按照分类名称查询
if(StringUtils.isNotBlank(queryParam.getName())){
wrapper.like("name",queryParam.getName());
}else{
//只有不按分类名称查询,并且没有指定深度,才设置默认的parentId为0
if(depth == null){
wrapper.eq("parent_id", 0);
}
}
//是否按照状态查询
if(status> 0){
if(!(status==PRODUCT_CATEGORY_STATUS_START || status==PRODUCT_CATEGORY_STATUS_STOP)){
//ILLEGAL_STATUS_VALUE(400,"状态字段的值异常"),
throw new ServiceException(BizExceptionEnum.ILLEGAL_STATUS_VALUE);
}
wrapper.eq("status",queryParam.getStatus());
}else{
//否则,只查询未删除的记录
wrapper.in("status",new Integer[]{PRODUCT_CATEGORY_STATUS_START,PRODUCT_CATEGORY_STATUS_STOP});
}
return wrapper;
}
/**
* 递归算法,算出子级菜单
*/
private List<Map<String, Object>> findChildCategory(List<Map<String, Object>> result,
Map<String, Object> category,String sortField, boolean isAsc, int status){
result.add(category);
//封装子级菜单的查询条件,
// 子级菜单的查询条件只有一个parent_id和排序方式
Wrapper<Category> wrapper = new EntityWrapper<>();
wrapper.orderBy(sortField,isAsc)
.eq("parent_id", new Integer(category.get("id").toString()));
if(status>0){
wrapper.eq("status",status);
}else{
//否则,只查询未删除的记录
wrapper.in("status",new Integer[]{PRODUCT_CATEGORY_STATUS_START,PRODUCT_CATEGORY_STATUS_STOP});
}
//查找子节点,递归算法一定要有一个退出的条件
List<Map<String, Object>> childList = categoryMapper.selectMaps(wrapper);
for (Map<String, Object> temp : childList) {
findChildCategory(result,temp,sortField,isAsc, status);
}
return result;
}
}
(5)ICategoryService.java
package cn.stylefeng.guns.elephish.service;
import cn.stylefeng.guns.core.common.node.ZTreeNode;
import cn.stylefeng.guns.elephish.bean.PageInfo;
import cn.stylefeng.guns.elephish.bean.QueryParam;
import cn.stylefeng.guns.elephish.form.CategoryForm;
import cn.stylefeng.guns.elephish.model.Category;
import com.baomidou.mybatisplus.service.IService;
import java.util.List;
import java.util.Map;
/**
* <p>
* 服务类
* </p>
*
* @author hqq
*/
public interface ICategoryService extends IService<Category> {
/**
* 获取分类管理列表
*/
List<Map<String,Object>> listCategory(QueryParam queryParam, PageInfo pageInfo);
/**
* 自定义逻辑的添加商品分类实现
*/
void addCategory(CategoryForm categoryForm);
/**
* 获取分类管理的详情信息
*/
Map<String,Object> getCategoryDetails(Integer categoryId, String timeZone);
/**
* 获取菜单列表树
*/
List<ZTreeNode> categoryTreeList();
/**
* 更新分类管理菜单的信息
* @param categoryForm
*/
void updateCategory(CategoryForm categoryForm);
/**
* 停用或启用商品分类及其所有子类
* @param id
* @param version
* @param status
*/
void updateStatus(int id, int version, int status);
}
(6)DBUtil.java
package cn.stylefeng.guns.elephish.utils;
import cn.hutool.core.util.ReflectUtil;
import cn.stylefeng.roses.core.util.SpringContextHolder;
import cn.stylefeng.roses.kernel.model.exception.ServiceException;
import org.springframework.util.ReflectionUtils;
import java.lang.reflect.Method;
/**
* 公共的db对象操作类
* Created by hqq
*/
public class DBUtil {
/**
* 通过id查询去数据库查询对应的记录。
* 建议只是校验参数是否合法时使用
* @param id 记录的id
* @param fieldName 出错字段的名称
* @param clazz 对应的mapper实现类的类型
* @return 如果获取的对象为null,则抛出异常,否则返回可用的对象
*/
public static <T,V>T selectById(int id,String fieldName,Class<V> clazz){
//获取对应的BaseMapper实现类
Object obj = SpringContextHolder.getBean(clazz);
//获取baseMapper的 selectById 方法对象
// Method method = ReflectionUtils.findMethod(obj.getClass(), "selectById", Integer.class);
Method method = ReflectUtil.getMethod(obj.getClass(), "selectById");
//Object invokeMethod(Method method, Object target, Object... args)
//在指定对象(target)上,使用指定参数(args),执行方法(method);
Object o = ReflectionUtils.invokeMethod(method, obj, id);
if(o==null){
//ILLEGAL_PARAM(400,"非法参数"),
throw new ServiceException(400,"参数【"+fieldName+"】不合法");
}
return (T)o;
}
}
(7)StringUtil.java
package cn.stylefeng.guns.elephish.utils;
import org.apache.commons.lang3.StringUtils;
import org.apache.commons.lang3.math.NumberUtils;
import org.apache.velocity.runtime.directive.Foreach;
import java.util.ArrayList;
import java.util.List;
/**
* 自定义的字符串工具类
* Created by hqq
*/
public class StringUtil {
/**
* 自定义字符串split方法,并去除每一个元素的首尾空格
* 如果传入的参数是null或空串,容量为0的字符串集合
* 如果分隔后的结果为null或空数组,返回容量为0的集合,防止调用者空指针异常
*
* 示例如:split("aa, bb ,c c," , ",");
* 得到结果: ["aa","bb","c c"]
*
* @param mutiString 需要进行分割的字符串
* @param separatorChars 分割标志
* @return
*/
public static List<String> split(String mutiString,final String separatorChars){
//定义一个list封装最后的结果
List<String> result = new ArrayList<>();
if(StringUtils.isBlank(mutiString)){
return result;
}
//使用性能更好的StringUtils.split方法
String[] split = StringUtils.split(mutiString,separatorChars);
if(split==null || split.length<1){
return result;
}
//去除首尾空格
for (int i = 0; i<split.length; i++) {
if(StringUtils.isBlank(split[i])){
continue;
}
result.add(split[i].trim());
}
return result;
}
/**
* 将字符串"[1],[2],[3]," 转换为集合封装 {1,2,3}
* 如果数组中有不能转换成int类型的元素,则会被忽略。如:"[1],[abc],[3],"得到的结果是:[1,3]
* 如果最终没有符合条件的数,返回容量为0的空集合,防止调用者空指针异常
* @param mutiString 需要进行分割的字符串
* @param separatorChars 分割标志
* @return
*/
public static List<Integer> chunkSplitInt(String mutiString,final String separatorChars){
//定义一个list封装最后的结果
List<Integer> result = new ArrayList<>();
//分割成数组
List<String> list = StringUtil.split(mutiString, separatorChars);
if(list.isEmpty()){
return result;
}
//操作每一个元素
String temp = null;
int length = 0;
for (int i = 0 ; i<list.size(); i++) {
temp = list.get(i);
length = temp.length();
//既然每个元素都是[]包围的,那么长度肯定大于2
if(length<3){
continue;
}
//去除首尾的"[]"
temp = temp.substring(1,length-1);
//判断字符串中是否全为数字,示例如下:
//NumberUtils.isDigits("0000000000.596");//false
//NumberUtils.isDigits("0000000000596");//true
if(!NumberUtils.isDigits(temp)){
continue;
}
result.add(new Integer(temp));
}
return result;
}
}
(8)TimeUtil.java
package cn.stylefeng.guns.elephish.utils;
import org.apache.commons.lang3.StringUtils;
import java.time.*;
import java.time.format.DateTimeFormatter;
/**
* Created by hqq
*/
public class TimeUtil {
private static final String DEFAULT_DATE_PATTERN = "yyyy-MM-dd HH:mm:ss";
/**
* 将 "+08:00"类型的字符串,转换成对应的数字 8
* 如果转换失败,会返回 -20 ,因为-20并不是时间偏移数,
* 如果运用到时间转换中,会报错
* @param zoneStr 要转化的参数
* @return
*/
public static int formatZoneHour(String zoneStr){
int errorNum = -20;
if(StringUtils.isBlank(zoneStr)){
return errorNum;
}
try{
return new Integer(zoneStr.replaceAll(":00", "").trim());
}catch (Exception e){
}
return errorNum;
}
/**
* 获取当前时间戳,注意,新建的项目,
* 后台统一使用这个方法生成的时间戳
* @return
*/
public static long currentTimeMillis(){
return Instant.now().toEpochMilli();
// return CurrentTimeMillisClock.getInstance().now();
}
public static void main(String[] args) {
System.out.println(currentTimeMillis());
System.out.println(System.currentTimeMillis());
System.out.println(Instant.now().toEpochMilli());
}
/**
* 将unix时间戳格式化为 yyyy-MM-dd HH:mm:ss 格式的时间
* 如果转换失败,原样返回时间戳
* @param unixTimestamp unix时间戳,单位是毫秒
* @param zoneHour 时区偏移的小时数,返回是 -12 到 +12
* @return
*/
public static String unixTimestampToLocalDate(long unixTimestamp , int zoneHour){
try {
//传入的时区范围错误
if(!(zoneHour >=-12 && zoneHour<=12)){
return ""+unixTimestamp;
}
Instant instant = Instant.ofEpochMilli(unixTimestamp);
DateTimeFormatter ftf = DateTimeFormatter
.ofPattern(DEFAULT_DATE_PATTERN).withZone(ZoneOffset.ofHours(zoneHour));
return ftf.format(instant);
} catch (Exception e) {
e.printStackTrace();
}
//如果失败,返回原时间戳
return ""+unixTimestamp;
}
}
(9)CategoryWrapper.java
package cn.stylefeng.guns.elephish.wrapper;
import cn.stylefeng.guns.core.common.constant.factory.ConstantFactory;
import cn.stylefeng.guns.elephish.constants.WrapperDictNameConstant;
import cn.stylefeng.roses.core.base.warpper.BaseControllerWrapper;
import java.util.List;
import java.util.Map;
/**
* 商品分类管理的包装类
*
* Created by hqq
*/
public class CategoryWrapper extends BaseControllerWrapper {
public CategoryWrapper(List<Map<String, Object>> multi) {
super(multi);
}
/**
* 此处自定义添加需要包装的字段的字典信息
*/
@Override
protected void wrapTheMap(Map<String, Object> map) {
//状态名称
map.put("statusName", ConstantFactory.me().getDictById(
WrapperDictNameConstant.MALL_CATEGORY_STATUS_ID, map.get("status").toString()));
}
}
(10)bootstrap-treetable.js
/**
* 查找当前这个节点的所有节点(包含子节点),并进行折叠或者展开操作
*
* @param item 被点击条目的子一级条目
* @param target 整个bootstrap tree table实例
* @param globalCollapsedFlag 如果为true,则表示当前操作是收缩(折叠),如果是false,表示当前操作是展开
* @param options 存放了一些常量,例如展开和收缩的class
*/
function extracted($, item, target, globalCollapsedFlag, options) {
var itemCodeName = $(item).find("td[name='"+options.code+"']").text();
// var itemCodeName = $(item).find("td[name='code']").text();
var subItems = target.find("tbody").find(".tg-" + itemCodeName);//下一级,改为下所有级别
if (subItems.size() > 0) {
$.each(subItems, function (nIndex, nItem) {
extracted($, nItem, target, globalCollapsedFlag, options);
});
}
$.each(subItems, function (pIndex, pItem) {
//如果是展开,判断当前箭头是开启还是关闭
var expander = $(item).find("td[name='name']").find(".treetable-expander");
if (!globalCollapsedFlag) {
var hasExpander = expander.hasClass(options.expanderExpandedClass);
if (hasExpander) {
$(pItem).css("display", "table");
} else {
$(pItem).css("display", "none");
}
} else {
//如果是折叠,就把当前开着的都折叠掉
$(pItem).css("display", "none");
expander.removeClass(options.expanderExpandedClass);
expander.addClass(options.expanderCollapsedClass);
}
});
}
(function ($) {
"use strict";
$.fn.bootstrapTreeTable = function (options, param) {
var allData = null;//用于存放格式化后的数据
// 如果是调用方法
if (typeof options == 'string') {
return $.fn.bootstrapTreeTable.methods[options](this, param);
}
// 如果是初始化组件
options = $.extend({}, $.fn.bootstrapTreeTable.defaults, options || {});
// 是否有radio或checkbox
var hasSelectItem = false;
var target = $(this);
// 在外层包装一下div,样式用的bootstrap-table的
var _main_div = $("<div class='bootstrap-tree-table fixed-table-container'></div>");
target.before(_main_div);
_main_div.append(target);
target.addClass("table table-hover treetable-table table-bordered");
if (options.striped) {
target.addClass('table-striped');
}
// 工具条在外层包装一下div,样式用的bootstrap-table的
if (options.toolbar) {
var _tool_div = $("<div class='fixed-table-toolbar'></div>");
var _tool_left_div = $("<div class='bs-bars pull-left'></div>");
_tool_left_div.append($(options.toolbar));
_tool_div.append(_tool_left_div);
_main_div.before(_tool_div);
}
// 格式化数据,优化性能
target.formatData = function (data) {
var _root = options.rootCodeValue ? options.rootCodeValue : null
$.each(data, function (index, item) {
// 添加一个默认属性,用来判断当前节点有没有被显示
item.isShow = false;
// 这里兼容几种常见Root节点写法
// 默认的几种判断
var _defaultRootFlag = item[options.parentCode] == '0'
|| item[options.parentCode] == 0
|| item[options.parentCode] == null
|| item[options.parentCode] == '';
if (!item[options.parentCode] || (_root ? (item[options.parentCode] == options.rootCodeValue) : _defaultRootFlag)) {
if (!allData["_root_"]) {
allData["_root_"] = [];
}
allData["_root_"].push(item);
} else {
if (!allData["_n_" + item[options.parentCode]]) {
allData["_n_" + item[options.parentCode]] = [];
}
allData["_n_" + item[options.parentCode]].push(item);
}
});
}
// 得到根节点
target.getRootNodes = function () {
return allData["_root_"];
};
// 递归获取子节点并且设置子节点
target.handleNode = function (parentNode, lv, tbody) {
var _ls = allData["_n_" + parentNode[options.code]];
var tr = target.renderRow(parentNode, _ls ? true : false, lv);
tbody.append(tr);
if (_ls) {
$.each(_ls, function (i, item) {
target.handleNode(item, (lv + 1), tbody)
});
}
};
//### 添加隐藏参数修改点1(共3处修改):获取需要修改的列
var hiddenFields = "";
//获取是否有需要隐藏的字段,获取到的值的示例如: "[version],"
if(options.columns[0] && options.columns[0].hiddenField ){
hiddenFields = options.columns[0].hiddenField;
//如果这个隐藏字段的类型不是字符串,则忽略,默认为没有需要修改的字段
if(typeof(hiddenFields)!='string' ){
hiddenFields = "";
}
}
//###
// 绘制行
target.renderRow = function (item, isP, lv) {
// 标记已显示
item.isShow = true;
var tr = $('<tr class="tg-' + item[options.parentCode] + '"></tr>');
var _icon = options.expanderCollapsedClass;
if (options.expandAll) {
tr.css("display", "table");
_icon = options.expanderExpandedClass;
} else if (options.expandFirst && lv <= 2) {
tr.css("display", "table");
_icon = (lv == 1) ? options.expanderExpandedClass : options.expanderCollapsedClass;
} else {
tr.css("display", "none");
_icon = options.expanderCollapsedClass;
}
$.each(options.columns, function (index, column) {
// 判断有没有选择列
if (index == 0 && column.field == 'selectItem') {
hasSelectItem = true;
var td = $('<td style="text-align:center;width:36px"></td>');
if (column.radio) {
var _ipt = $('<input name="select_item" type="radio" value="' + item[options.id] + '"></input>');
td.append(_ipt);
}
if (column.checkbox) {
var _ipt = $('<input name="select_item" type="checkbox" value="' + item[options.id] + '"></input>');
td.append(_ipt);
}
tr.append(td);
} else {
//### 添加隐藏参数修改点2(共3处修改):修改列中的数据为隐藏项
//判断一个字符串中是否包含另一个字符串,假设第一步获取到 hiddenFields="[version],"
//而此时的 column.field = 'version' ,前后拼接[]后得到的是 "[version]"
//此时 "[version],".indexOf("[version]") 得到的值肯定大于-1,于是这个if判断成立
if(hiddenFields.indexOf("["+column.field+"]")!=-1){
//拼装自定义的<td>标签,这个标签和其它的一样,不同点是多了一个隐藏属性 style="display: none;",
// 也正是通过这个属性达到隐藏效果,但这还不够,表头的列也必须加上隐藏属性,否则排版会出问题
var td=$('<td title="' + item[column.field] + '" name="' + column.field
+ '" style="display: none;">'+item[column.field]+'</td>');
tr.append(td);
return true;//结束本次循环,进入下一个循环
}
//###
var td = $('<td title="' + item[column.field] + '" name="' + column.field + '" style="'
+ ((column.width) ? ('width:' + column.width) : '') + '"></td>');
// 增加formatter渲染
if (column.formatter) {
td.html(column.formatter.call(this, item[column.field], item, index));
} else {
td.text(item[column.field]);
}
if (options.expandColumn == index) {
if (!isP) {
td.prepend('<span class="treetable-expander"></span>')
} else {
td.prepend('<span class="treetable-expander ' + _icon + '"></span>')
}
for (var int = 0; int < (lv - 1); int++) {
td.prepend('<span class="treetable-indent"></span>')
}
}
tr.append(td);
}
});
return tr;
}
// 加载数据
target.load = function (parms) {
// 加载数据前先清空
allData = {};
// 加载数据前先清空
target.html("");
// 构造表头
var thr = $('<tr></tr>');
$.each(options.columns, function (i, item) {
var th = null;
// 判断有没有选择列
if (i == 0 && item.field == 'selectItem') {
hasSelectItem = true;
th = $('<th style="width:36px"></th>');
} else {
th = $('<th style="' + ((item.width) ? ('width:' + item.width) : '') + '"></th>');
}
//### 添加隐藏参数修改点3(共3处修改):修改表头的列为隐藏
//为了保证排版不出问题,表头的列也必须有,这个这个列的属性也是隐藏的
if(hiddenFields.indexOf("["+item.field+"]")!= -1){
th = $('<th style="display: none;"></th>');
}
//###
th.text(item.title);
thr.append(th);
});
var thead = $('<thead class="treetable-thead"></thead>');
thead.append(thr);
target.append(thead);
// 构造表体
var tbody = $('<tbody class="treetable-tbody"></tbody>');
target.append(tbody);
// 添加加载loading
var _loading = '<tr><td colspan="' + options.columns.length + '"><div style="display: block;text-align: center;">正在努力地加载数据中,请稍候……</div></td></tr>'
tbody.html(_loading);
// 默认高度
if (options.height) {
tbody.css("height", options.height);
}
$.ajax({
type: options.type,
url: options.url,
data: parms ? parms : options.ajaxParams,
dataType: "JSON",
success: function (result, textStatus, jqXHR) {
//### 开始修改guns原来的bootstrap-treetable.js ###
var data =result ;
//判断是否是标准的列表查询,这个很重要,
// 因为我是直接在bootstrap-treetable.js修改的,
//新作的修改必须保证原来的功能不受影响。
if(result && typeof(result.pageInfo)!='undefined'){
data = result.data;
PageTool.buildPageDiv(result.pageInfo);
}
//### 结束修改gun v5.1-final 原来的bootstrap-treetable.js ###
// 加载完数据先清空
tbody.html("");
if (!data || data.length <= 0) {
var _empty = '<tr><td colspan="' + options.columns.length + '"><div style="display: block;text-align: center;">没有找到匹配的记录</div></td></tr>'
tbody.html(_empty);
return;
}
target.formatData(data);
// 开始绘制
var rootNode = target.getRootNodes();
if (rootNode) {
$.each(rootNode, function (i, item) {
target.handleNode(item, 1, tbody);
});
}
// 下边的操作主要是为了查询时让一些没有根节点的节点显示
$.each(data, function (i, item) {
if (!item.isShow) {
var tr = target.renderRow(item, false, 1);
tbody.append(tr);
}
});
target.append(tbody);
//动态设置表头宽度
thead.css("width", tbody.children(":first").css("width"));
// 行点击选中事件
target.find("tbody").find("tr").click(function () {
if (hasSelectItem) {
var _ipt = $(this).find("input[name='select_item']");
if (_ipt.attr("type") == "radio") {
_ipt.prop('checked', true);
target.find("tbody").find("tr").removeClass("treetable-selected");
$(this).addClass("treetable-selected");
} else {
if (_ipt.prop('checked')) {
_ipt.prop('checked', false);
$(this).removeClass("treetable-selected");
} else {
_ipt.prop('checked', true);
$(this).addClass("treetable-selected");
}
}
}
});
// 小图标点击事件--展开缩起
target.find("tbody").find("tr").find(".treetable-expander").click(function () {
var tr = $(this).parent().parent();
var _code = tr.find("input[name='select_item']").val();
if (options.id == options.code) {
_code = tr.find("input[name='select_item']").val();
} else {
_code = tr.find("td[name='" + options.code + "']").text();
}
var _ls = target.find("tbody").find(".tg-" + _code);//下一级,改为下所有级别
if (_ls && _ls.length > 0) {
var _flag = $(this).hasClass(options.expanderExpandedClass);
$.each(_ls, function (index, item) {
//查找当前这个节点的所有节点(包含子节点),如果是折叠都显示为不显示,如果是展开,则根据当前节点的状态
extracted($, item, target, _flag, options);
$(item).css("display", _flag ? "none" : "table");
});
if (_flag) {
$(this).removeClass(options.expanderExpandedClass)
$(this).addClass(options.expanderCollapsedClass)
} else {
$(this).removeClass(options.expanderCollapsedClass)
$(this).addClass(options.expanderExpandedClass)
}
}
});
},
error: function (xhr, textStatus) {
var _errorMsg = '<tr><td colspan="' + options.columns.length + '"><div style="display: block;text-align: center;">' + xhr.responseText + '</div></td></tr>'
tbody.html(_errorMsg);
debugger;
},
});
}
if (options.url) {
target.load();
} else {
// 也可以通过defaults里面的data属性通过传递一个数据集合进来对组件进行初始化....有兴趣可以自己实现,思路和上述类似
}
return target;
};
// 组件方法封装........
$.fn.bootstrapTreeTable.methods = {
// 返回选中记录的id(返回的id由配置中的id属性指定)
// 为了兼容bootstrap-table的写法,统一返回数组,这里只返回了指定的id
getSelections: function (target, data) {
// 所有被选中的记录input
var _ipt = target.find("tbody").find("tr").find("input[name='select_item']:checked");
var chk_value = [];
// 如果是radio
if (_ipt.attr("type") == "radio") {
var _data = {id: _ipt.val()};
var _tds = _ipt.parent().parent().find("td");
_tds.each(function (_i, _item) {
if (_i != 0) {
_data[$(_item).attr("name")] = $(_item).text();
}
});
chk_value.push(_data);
} else {
_ipt.each(function (_i, _item) {
var _data = {id: $(_item).val()};
var _tds = $(_item).parent().parent().find("td");
_tds.each(function (_ii, _iitem) {
if (_ii != 0) {
_data[$(_iitem).attr("name")] = $(_iitem).text();
}
});
chk_value.push(_data);
});
}
return chk_value;
},
// 刷新记录
refresh: function (target, parms) {
if (parms) {
target.load(parms);
} else {
target.load();
}
},
// 组件的其他方法也可以进行类似封装........
};
$.fn.bootstrapTreeTable.defaults = {
id: 'id',// 选取记录返回的值
code: 'id',// 用于设置父子关系
parentCode: 'parentId',// 用于设置父子关系
rootCodeValue: null,//设置根节点code值----可指定根节点,默认为null,"",0,"0"
data: [], // 构造table的数据集合
type: "GET", // 请求数据的ajax类型
url: null, // 请求数据的ajax的url
ajaxParams: {}, // 请求数据的ajax的data属性
expandColumn: null,// 在哪一列上面显示展开按钮
expandAll: true, // 是否全部展开
expandFirst: false, // 是否默认第一级展开--expandAll为false时生效
striped: false, // 是否各行渐变色
columns: [],
toolbar: null,//顶部工具条
height: 0,
expanderExpandedClass: 'glyphicon glyphicon-chevron-down',// 展开的按钮的图标
expanderCollapsedClass: 'glyphicon glyphicon-chevron-right'// 缩起的按钮的图标
};
})(jQuery);
(11)category.js
/**
* 分类管理管理初始化
*/
var Category = {
id: "CategoryTable", //表格id
seItem: null, //选中的条目
table: null,
layerIndex: -1,
maxDepth: 3 //最大的深度
};
/**
* 初始化表格的列
*/
Category.initColumn = function () {
return [
{field: 'selectItem', radio: true , hiddenField:"[version],"},
{title: '分类名称', field: 'name', visible: true, align: 'center', valign: 'middle'},
{title: '分类编号', field: 'id', visible: true, align: 'center', valign: 'middle'},
{title: '分类父编号', field: 'parentId', visible: true, align: 'center', valign: 'middle'},
{title: '层级', field: 'depth', align: 'center', valign: 'middle', sortable: true},
{title: '排序', field: 'sort', visible: true, align: 'center', valign: 'middle'},
{title: '状态', field: 'statusName', visible: true, align: 'center', valign: 'middle'},
{title: '创建时间', field: 'createTime', visible: true, align: 'center', valign: 'middle',
formatter: function (value) {
return typeof(value)=="undefined"?"":moment(+value).format('YYYY-MM-DD HH:mm:ss');
}
},
{title: '更新时间', field: 'updateTime', visible: true, align: 'center', valign: 'middle',
formatter: function (value) {
return typeof(value)=="undefined"?"":moment(+value).format('YYYY-MM-DD HH:mm:ss');
}
},
{title: '版本', field: 'version', align: 'center', valign: 'middle'}
];
};
/**
* 检查是否选中
*/
Category.check = function () {
var selected = $('#' + this.id).bootstrapTreeTable('getSelections');;
if(selected.length == 0){
Feng.info("请先选中表格中的某一记录!");
return false;
}else{
Category.seItem = selected[0];
return true;
}
};
/**
* 点击添加分类管理
*/
Category.openAddCategory = function () {
//默认用户是添加顶级分类
var parentId = 0;
var parentName = '顶级';
var depth = 1;
//尝试获取用户选中的item标签
var selected = $('#' + this.id).bootstrapTreeTable('getSelections');
//如果用户选中了某个单选框,说明是在这个单选框下添加
if(selected.length > 0){
var item = selected[0];
parentName = item.name;//分类名
//如果当前选中的分类已经被废弃了,那么就不允许添加子分类
if(item.statusName == "已废弃"){
Feng.info("分类【"+parentName+"】已被废弃,无法添加子分类!");
return;
}
parentId = item.id;//分类id
depth = item.depth;//分类的深度
//我项目设计了分类管理项目的最大层级是3级,如果超过3级就不能添加
if(depth >= Category.maxDepth){
Feng.error("当前节点已是叶子节点,无法继续添加子分类");
return ;
}
}
//拼接url上需要的参数
var urlParams = '?parentId='+parentId+'&parentName='+parentName
+'&depth='+depth+"¤tPage="+$("#currentPage").val();
var index = layer.open({
type: 2,
title: '添加分类管理',
area: ['800px', '420px'], //宽高
fix: false, //不固定
maxmin: true,
content: Feng.ctxPath + '/category/category_add'+urlParams
});
this.layerIndex = index;
};
/**
* 打开查看分类管理详情
*/
Category.openCategoryDetail = function () {
if(!this.check()){
return ;
}
//获取浏览器的当前时间偏移
var zoneHour = moment(new Date()).format('Z');
var id = Category.seItem.id.trim();
if(!id){
Feng.error("没有获取到id!");
}
//拼接需要的参数
var urlParams = "?id="+id+"&timeZone="+zoneHour
+"¤tPage="+$("#currentPage").val();
var index = layer.open({
type: 2,
title: '分类管理详情',
area: ['953px', '533px'], //宽高
fix: false, //不固定
maxmin: true,
content: Feng.ctxPath + '/category/category_update' + urlParams
});
this.layerIndex = index;
};
/**
* 重置查询条件条件
*/
Category.reset = function () {
$("#byStatus").find("option[text='正常']").attr("selected",true);
$("#byStatus").find("option[text!='正常']").attr("selected",false);
$("#searchChild").find("option[text='是']").attr("selected",true);
$("#searchChild").find("option[text!='是']").attr("selected",false);
$("#currentPage").val("1");//当前页
$("#limit").val("5");//每页查询条数
$("#byName").val("");//分类名称
$("#byDepth").val("");//层级
$("#searchChild").attr("disabled",false);
}
/**
* 修改分类的状态,停用或启用
*/
Category.changeStatus = function () {
if(!this.check()){
return;
}
var item =this.seItem;
var id = item.id;
var version = item.version;
var statusName = item.statusName;
var status ;
if(statusName =='正常'){//如果当前是正常,那么接下来的操作就是要停用
status =2;
statusName = "停用";
}else{//如果当前的状态是已停用了,那么接下来的操作就是要启用
status =1 ;
statusName = "启用";
}
var operation =function () {
var ajax = new $ax(Feng.ctxPath + "/category/status", function () {
Feng.success("修改成功!");
//删除成功之后,刷新当前页
var queryParams = Category.formParams();
queryParams['currentPage'] = $("#currentPage").val();
Category.table.refresh({query: queryParams});
}, function (data) {
Feng.error("操作失败:" + data.responseJSON.message + "!");
});
ajax.set("id",id);
ajax.set("version",version);
ajax.set("status",status);
ajax.start();
}
Feng.confirm("是否【"+statusName+"】分类【"+item.name+"】及其下的所有子分类?", operation);
}
/**
* 删除分类管理
*/
Category.delete = function () {
if(!this.check()){
return;
}
var id = this.seItem.id;
var version = this.seItem.version;
var operation =function () {
var ajax = new $ax(Feng.ctxPath + "/category/delete", function (data) {
Feng.success("删除成功!");
//删除成功之后,刷新当前页
var queryParams = Category.formParams();
queryParams['currentPage'] = $("#currentPage").val();
Category.table.refresh({query: queryParams});
}, function (data) {
Feng.error("操作失败:" + data.responseJSON.message + "!");
});
ajax.set("id",id);
ajax.set("version",version);
ajax.start();
}
Feng.confirm("是否刪除分类【"+this.seItem.name+"】及其所有子分类?", operation);
};
/**
* 条件查询分类管理列表
*/
Category.search = function () {
//当前页面刷新
var queryParams = Category.formParams();
queryParams['currentPage'] = $("#currentPage").val();
Category.table.refresh({query: queryParams});
};
$(function () {
var defaultColunms = Category.initColumn();
var table = new BSTreeTable(Category.id, "/category/list", defaultColunms);
table.setExpandColumn(1);//设置第一列展示下拉列表
table.setIdField("id");//分类编号
table.setCodeField("id");//分类父编号,用于设置父子关系
table.setParentCodeField("parentId");//分类父编号,用于设置父子关系
table.setExpandAll(true);
//设置请求时的参数
var queryData = Category.formParams();
queryData['limit'] = 5;//
table.setData(queryData);
table.init();
Category.table = table;
$("#limit").val("5");//设置每页的查询的默认条数
//设置当前对象的名称,分页时需要使用
PageTool.callerName="Category";
});
/**
* 查询表单提交参数对象
* @returns {{}}
*/
Category.formParams = function() {
var queryData = {};
queryData['name'] = $("#byName").val().trim();//名称条件
queryData['depth'] = $("#byDepth").val();//层级条件
queryData['status'] = $("#byStatus").val();//状态条件
queryData['searchChild'] = $("#searchChild").val();//是否查询子菜单
queryData['limit'] = $("#limit").val();//设置每页查询条数
return queryData;
}
/**
* 每页查询的页码数修改之后触发失去焦点事件,
* 将当前页码重置为 1 .
* 主要是为了解决以下情况:
* 假设总共10条记录,每页查询3条,那么总共就有4页,当用户在第三页的时候,
* 修改成每页查询10条,修改后点击查询,会出现没有数据显示的情况。
* 原因是,用户的当前页码 currentPage 的值依旧是3,
* 而每页查询10条后,总共只有1页,查询第三页时肯定没有数据啦
*/
$("#limit").on('blur',function(){
$("#currentPage").val(1);
});
/**
* 【分类名称】输入框失去焦点事件
*/
$("#byName").on('blur',function(){
Category.setSearchChildSelected();
});
/**
*【深度】输入框失去焦点事件
*/
$("#byDepth").on('blur',function(){
Category.setSearchChildSelected();
});
/**
* 设置【是否查询子菜单】选择框是否可用
*/
Category.setSearchChildSelected = function () {
var byName = $("#byName").val().trim();
var byDepth = $("#byDepth").val().trim();
if(byName && !byDepth){
//当选择分类名称查询,不选择层级查询时,默认无法查询子类菜单,这样是为了防止查重和查出不必要的数据
$("#searchChild").val("false");
$("#searchChild").attr("disabled",true);
}else{
//其它情况,都可以自主觉得是否查询子菜单
$("#searchChild").val("true");
$("#searchChild").attr("disabled",false);
}
}
(12)category_info.js
/**
* 初始化分类管理详情对话框
*/
var CategoryInfoDlg = {
ztreeInstance: null
};
/**
* 关闭此对话框
*/
CategoryInfoDlg.close = function() {
parent.layer.close(window.parent.Category.layerIndex);
}
/**
* 收集数据
*/
CategoryInfoDlg.collectData = function(type) {
var fieldArr;//定义一个数组,封装所有需要收集的数据的字段
var needArr;//定义一个数组,封装字段是否是必传字段,注意必须与 fieldArr数组中的容量保持一致
var fieldNameArr;//定义一个数组,封装对应字段的字段名称,用于收集信息出错时定位错误信息
var typeArr;//定义数组,封装需要收集的字段的值的类型
var strMaxLengthArr;//定义数组,指定字符串类型的字段的值的最大长度。-1表示该字段不用比较
if(type === 'add'){
//设置添加需要的字段
fieldArr = ['parentId','name','sort','status','parentName'];
needArr = [true,true,true,true,false];
fieldNameArr = ['父类编号','分类名称','排序编号','状态设置',''];
typeArr = ['number','','number','number',''];
strMaxLengthArr = [11,10,11,2,-1];
}else if(type==='edit'){
//设置修改需要的字段
fieldArr = ['id','parentId','name','sort','version'];
needArr = [true,true,true,true,true];
fieldNameArr = ['分类编号','父类编号','分类名称','排序编号','版本信息'];
typeArr = ['number','number','','number','number'];
strMaxLengthArr = [11,11,10,11,11];
}else{
return "收集信息出错啦";
}
return CommonTool.collectData(fieldArr,needArr,fieldNameArr,typeArr,strMaxLengthArr);
}
/**
* 提交添加
*/
CategoryInfoDlg.addSubmit = function() {
//重新采集数据
var result = this.collectData("add");
//如果返回的字段是字符串类型的,说明出错了,直接返回出错信息
if(typeof(result)=='string'){
Feng.error(result);
return ;
}
//提交信息
var ajax = new $ax(Feng.ctxPath + "/category/add", function(data){
Feng.success("添加成功!");
//修改成功之后,刷新数据,依旧跳转到原来的页面
var queryParams = window.parent.Category.formParams();
queryParams['currentPage'] = $("#currentPage").val()
window.parent.Category.table.refresh({query:queryParams });
CategoryInfoDlg.close();
},function(data){
Feng.error("添加失败:" + data.responseJSON.message + "!");
});
ajax.set(result);//设置请求参数
ajax.start();
}
/**
* 提交修改
*/
CategoryInfoDlg.editSubmit = function() {
var result = this.collectData("edit");
//如果返回的字段是字符串类型的,说明出错了,直接返回出错信息
if(typeof(result)=='string'){
Feng.error(result);
return ;
}
// if(result["id"]===result["parentId"]){
// Feng.error("子分类与父分类不能相同");
// return ;
// }
//提交信息
var ajax = new $ax(Feng.ctxPath + "/category/update", function(data){
Feng.success("修改成功!");
//修改成功之后,刷新数据,依旧跳转到原来的页面
var queryParams = window.parent.Category.formParams();
queryParams['currentPage'] = $("#currentPage").val();
window.parent.Category.table.refresh({query: queryParams});
CategoryInfoDlg.close();
},function(data){
Feng.error("修改失败!" + data.responseJSON.message + "!");
});
ajax.set(result);//设置请求参数
ajax.start();
}
$(function () {
});
(13)category_edit.html
@layout("/common/_container.html"){
<div class="ibox float-e-margins">
<div class="ibox-content">
<div class="form-horizontal">
<div class="row">
<div class="col-sm-6 b-r">
<h3 style="color:green;text-align:center;">父类信息</h3>
<#input id="parentName" disabled="disabled" value="${nvl(item.parentName,'无')}"
name="父类名称" underline="false"/>
<br/>
<#input id="parentId" disabled="disabled" value="${nvl(item.parentId,'无')}"
name="父类编号" underline="false"/>
<br/>
<#input id="parentDepth" disabled="disabled" value="${nvl(item.parentDepth,'无')}"
name="父类层级" underline="false"/>
<br/><br><br><br><br><br>
</div>
<div class="col-sm-6">
<h3 style="color:green;text-align:center;">当前分类信息</h3>
<input id="id" type="hidden" value="${item.id}"/>
<input id="currentPage" type="hidden" value="${item.currentPage}"/>
<input id="version" type="hidden" value="${item.version}">
<#input id="name" disabled="${item.status==1?'':'disabled'}"
name="分类名称" value="${nvl(item.name,'无')}" />
<#input id="sort" disabled="${item.status==1?'':'disabled'}"
name="排序编号" value="${nvl(item.sort,'无')}" />
<#input id="status" disabled="disabled" name="分类状态"
value="${nvl(item.statusName,'无')}" />
<#input id="depth" disabled="disabled" name="分类层级"
value="${nvl(item.depth,'无')}" />
<#input id="parentNames" disabled="disabled" name="层级详情"
value="${nvl(item.parentNames,'无')}" />
<#input id="createTime" disabled="disabled" name="创建时间"
value="${nvl(item.createTime,'无')}" />
<#input id="updateTime" disabled="disabled" name="更新时间"
value="${nvl(item.updateTime,'无')}" />
</div>
</div>
<div class="row btn-group-m-t">
<div class="col-sm-10">
@if(item.status ==1){
<#button btnCss="info" name="提交" id="ensure" icon="fa-check"
clickFun="CategoryInfoDlg.editSubmit()"/>
@}
<#button btnCss="danger" name="取消" id="cancel" icon="fa-eraser"
clickFun="CategoryInfoDlg.close()"/>
</div>
</div>
</div>
</div>
</div>
<script src="${ctxPath}/static/modular/elephish/category/category_info.js?j=${date().time}"></script>
@}
(14)BeanConfig.java
package cn.stylefeng.guns.elephish.config;
import cn.stylefeng.guns.elephish.utils.TimeUtil;
import com.baomidou.mybatisplus.mapper.MetaObjectHandler;
import org.apache.ibatis.reflection.MetaObject;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.time.Instant;
/**
*
* Created by hqq
*/
@Configuration
public class BeanConfig {
/**
* mybatis-plus自动填充新增是修改时间的时间字段
* @return
*/
@Bean
public MetaObjectHandler metaObjectHandler() {
return new MetaObjectHandler() {
@Override
public void insertFill(MetaObject metaObject) {
this.setFieldValByName("createTime", TimeUtil.currentTimeMillis(), metaObject);
// this.setFieldValByName("update_time", LocalDateTime.now(), metaObject);
}
/**
* 设置自动填充updateTime字段的值,为13位的unix时间戳。
* 这个方法必须设置,因为我的所有表中,时间字段存的是时间戳,
* 而mybatis-plus(也有可能是guns)这个字段默认填充的datetime类型的,
* 所以调用mybatis-plus自带的删除、更新等方法,会报错,为了解决这个问题,
* 所以使用了自己的配置覆盖前面的配置
* @param metaObject
*/
@Override
public void updateFill(MetaObject metaObject) {
//定义所有的updateTime字段的值为时间戳类型
this.setFieldValByName("updateTime", TimeUtil.currentTimeMillis(), metaObject);
}
};
}
}
(15)LimitationConstant.java
package cn.stylefeng.guns.elephish.constants;
/**
* Created by hqq
*/
public interface LimitationConstant {
/**
* 商品分类菜单树形结构的最大层级,也就是叶子节点所在的层级
*/
int MALL_CATEGORY_TREE_MAX_DEPTH = 3;
}
(16)WrapperDictNameConstant.java
package cn.stylefeng.guns.elephish.constants;
/**
*
* 字典包装类的字典名称常量
*
* Created by hqq
*/
public interface WrapperDictNameConstant {
/**
* sys_user 表中 sex 字段对应的字典名称 的ID
*/
int SYS_USER_SEX_ID = 127;
/**
* mall_product_category 表中status字段对应的 字典ID
*/
int MALL_CATEGORY_STATUS_ID = 130;
}
(17)category.html
@layout("/common/_container.html"){
<div class="row">
<div class="col-sm-12">
<div class="ibox float-e-margins">
<div class="ibox-title">
<h5 id="pageInfo">分类管理</h5>
</div>
<div class="ibox-content">
<div class="row row-lg">
<div class="col-sm-12">
<div class="row">
<div class="col-sm-2">
<#NameCon id="byName" name="分类名称" />
</div>
<div class="col-sm-2">
<#NameCon id="byDepth" name="层级" />
</div>
<div class="col-sm-2">
<!-- 默认查询正常的,所以将<option value="1">正常</option>放在最前 -->
<#SelectCon id="byStatus" name="状态" >
<option value="1">正常</option>
<option value="0">全部</option>
<option value="2">停用中</option>
</#SelectCon>
</div>
</div>
<div class="row">
<div class="col-sm-2">
<#SelectCon id="searchChild" name="是否查询子菜单" >
<option value="true">是</option>
<option value="false">否</option>
</#SelectCon>
</div>
<div class="col-sm-2">
<#NameCon id="limit" name="每页查询条数"/>
</div>
<div class="col-sm-2"></div>
<div class="col-sm-3">
<#button name="重置" icon="fa-repeat" clickFun="Category.reset()" space="true"/>
<#button id='searchBtn' name="搜索" icon="fa-search" clickFun="Category.search()"/>
</div>
</div>
<br/>
<div class="hidden-xs" id="CategoryTableToolbar" role="group">
@if(shiro.hasPermission("/category/add")){
<#button name="添加" icon="fa-plus" clickFun="Category.openAddCategory()"/>
@}
@if(shiro.hasPermission("/category/update")){
<#button name="修改" icon="fa-edit" clickFun="Category.openCategoryDetail()" space="true"/>
@}
@if(shiro.hasPermission("/category/delete")){
<#button name="删除" icon="fa-remove" clickFun="Category.delete()" space="true"/>
@}
@if(shiro.hasPermission("/category/status")){
<#button name="启用/停用" icon="fa-hourglass-start" clickFun="Category.changeStatus()" space="true"/>
@}
</div>
<#table id="CategoryTable"/>
</div>
</div>
<!--定义一个空的div标签,用于分页内容的位置-->
<br>
<div id="pageDiv"></div>
</div>
</div>
</div>
</div>
<!-- 自定义分页引入 -->
<script src="${ctxPath}/static/modular/elephish/common/paging.js?j=${date().time}"></script>
<script src="${ctxPath}/static/modular/elephish/category/category.js?j=${date().time}"/>
@}
该系列更多文章请前往 Guns二次开发目录