Guns二次開發(十):商品分類管理之【刪】字訣

 

關於博客中使用的Guns版本問題請先閱讀   Guns二次開發目錄   

 

       上一篇博客中,我們實現了商品分類的修改功能,這篇博客我們繼續實現增刪改查裏最後的刪除功能。首先要明確,我們平時所說的刪除功能,其實可以區分爲兩種:物理刪除和邏輯刪除。所謂物理刪除,就是執行的“delete from mall_category where ...?”開頭的sql語句,然後執行成功之後,就真的刪除了(其實也不是真的刪除,因爲數據庫底層做的其實也是邏輯刪除,專業的DBA其實還是可以恢復被刪除的記錄的)。而邏輯刪除,底層的sql執行的其實是 “update mall_category set ...?”語句,只不過是將數據庫中的記錄的某個狀態字段設置成我們定義的表示已刪除的值。拿我們 的 mall_category 表來說,表示狀態的字段是 status,我這裏對status的值的定義是:1,正常;2,停用;3,已刪除。本項目中,我使用的是邏輯刪除,而且我也推薦使用邏輯刪除。理由如下:


(1)從用戶的角度考慮刪除的定義:一旦刪除成功,用戶餘生都將看不到被刪除的數據。因此,作爲開發者,我是否可以理解爲:你發起刪除操作之後,我不讓你再看到這條記錄就行了,至於記錄是否真的被刪除,其實用戶根本不在乎,即便在乎,那也沒用,因爲數據的擁有者並不僅僅只是用戶,平臺服務的提供者(公司)纔是甲方!!!
(2)某些數據,比如電商平臺的商品,已經決定不再售賣了,所以運營人員執行了刪除操作,如果此時使用的是物理刪除,那麼就會導致前臺用戶查詢歷史訂單的時候,無法查看到以前購買過的商品的信息,這樣明顯就是不合理的。所以需要使用邏輯刪除。
(3)實際的開發環境和生產環境中,系統bug是永遠存在的,舊的bug被解決,新的bug總會不經意間被創造。假設有這麼一個bug,bug出現的地方恰巧已經成功執行了物理刪除,那麼你後期即便修補了這個bug,前期被物理刪除的數據要恢復也是很困難的(特別是你的用戶量很大的時候)。相比之下,如果使用的是邏輯刪除,那技術人員恢復數據時只需要修改狀態字段的值便可以了。
(4)對於數據擁有者(也就是公司)來說,用戶的所有數據都是有價值的,因爲大數據時代來了,所以不管是前臺系統的用戶,還是後臺系統的管理員,都不應該具備擁有直接刪除數據庫數據的權限,而刪除功能又必須提供給用戶,於是使用邏輯刪除就顯得合情合理了。
當然了,以上純屬本人自己的觀點,大家見仁見智。

 

繼續我們今日的主題。

 

1、分類管理列表添加隱藏字段

       上一篇博客中有講到使用樂觀鎖字段(verision)來做修改,刪除的時候也是需要的,但是前面只是直接給出了代碼,並沒有具體的解釋如何實現的,這裏我來做補充說明。

(1)預期實現的效果圖

       如下圖,這是實現成功之後的效果圖。從圖中可以看出,我每條記錄只顯示8個字段,但實際上每行記錄攜帶了9個字段,我們的目的,就是可以隨心所欲的在頁面中攜帶一些不需要展示出來的隱藏字段。

 

如果按照原有的方法,要想在每條記錄中展示某個值,只需要在 category.js中 添加相應的字段就可以,但是這樣會有一個問題,那就是被添加的字段也會同時顯示在列表頁面中,而我的需求是:我只是需要這個字段,而並不需要展示這個字段。

 

 

(2)實現步驟

爲了實現這個效果,我可是死磕了幾個夜晚,讀了N遍bootstrap-treeable.js的源碼啊。我的實現方式如下:

①首先在初始化表格的時候,添加一個自定義的屬性 hiddenField ,這個hiddenField 的值是所有需要隱藏的字段,注意它的格式是:每個字段都由中括號[]括起來,如果有多個值,則用逗號分開。舉例:假設要隱藏的字段有兩個,是 version 和 name ,那麼最終拼接好的 hiddenField : "[version],[name],"。同時不要忘記,下圖中的B步驟也是必不可少的,否則會沒有數據。

 

②然後是對boostrap-treeable.js源碼的修改,主要有三處修改,請看截圖:

 

 

 

 

到這裏,功能就已經實現了。

 

 

2、實現刪除功能

(1)前端【刪除】按鈕的點擊事件

 

 

 

 

 

(2)後端刪除接口的實現

 

 

注意,此處我刪除業務的邏輯是這樣定義的:刪除當前分類的時候,需要遞歸刪除當前分類下的所有子分類,同時因爲我的商品是掛載在葉子節點分類下的,所以如果當前分類是葉子節點,或者當前分類的子分類是葉子節點,再刪除他們之前都要額外判斷這些葉子節點是否掛載有上架商品。如果有,則不允許刪除,整個事務都應該回滾。

 

 

 

具體的實現邏輯,請直接讀源碼。

 

3、源碼

同樣的,有些文件可能沒有粘貼出來,主要還是前面的博客中都已經粘貼出來了,此處不想重複無用的操作,而且貼出來的代碼只是作爲一種參考,爲了幫助理解本篇博客的主題。真正完整的代碼,會在這個系列的博客結束之時貼出來,可能還有一段很長的時間。

 

 

 

 

 

 

 

 

 

 

(1)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
 */
@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("id") int id,
                         @RequestParam("version")int version) {

        /**
         * 刪除商品分類的邏輯:
         * (1)只能做邏輯刪除,不能做物理刪除,因爲有可能商品管理中用到了這個分類,
         * 如果做了物理刪除,以後映射查詢商品的時候可能會出錯
         * (2)刪除的時候不能只刪除當前分類,還要將當前分類下的所有子類做遞歸邏輯刪除,
         * 爲了保證數據安全,前端要做二次確認的提示,防止用戶誤操作
         */

        //操作流水和授權暫時不實現,後面篇幅介紹

        categoryService.deleteCategoryById(id,version);
        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 = "/selectCategoryTreeList")
    @ResponseBody
    public List<ZTreeNode> selectMenuTreeList() {
        List<ZTreeNode> roleTreeList = categoryService.categoryTreeList();
        roleTreeList.add(ZTreeNode.createParent());
        return roleTreeList;
    }
}

 

(2)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.core.log.LogObjectHolder;
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.dao.ProductAttachMapper;
import cn.stylefeng.guns.elephish.dao.ProductAttributeGroupMapper;
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.model.ProductAttach;
import cn.stylefeng.guns.elephish.model.ProductAttributeGroup;
import cn.stylefeng.guns.elephish.service.ICategoryService;
import cn.stylefeng.guns.elephish.service.IProductAttributeGroupService;
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;

    @Autowired
    private IProductAttributeGroupService productAttributeGroupService;

    @Autowired
    private ProductAttributeGroupMapper productAttributeGroupMapper;

    @Autowired
    private ProductAttachMapper productAttachMapper;

    @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 categoryId
     * @param version
     */
    @Transactional
    @Override
    public void deleteCategoryById(int categoryId, int version) {

        //檢驗數據是否合法
        Category category = DBUtil.selectById(categoryId,"分類id",CategoryMapper.class);

        //判斷版本是否衝突,如果衝突,則直接返回
        if(version != category.getVersion()){
//            FAIL_DELETE_CONCURRENT(500,"併發刪除異常,請稍後重試"),
            throw new ServiceException(BizExceptionEnum.FAIL_DELETE_CONCURRENT);
        }

        //判斷是否已經刪除的,如果已經刪除了,那麼也不做錯誤提示,直接返回成功
        if(category.getStatus() == PRODUCT_CATEGORY_STATUS_DELETE){

            // ERROR_REPEAT_DELETE(500,"當前記錄已刪除,請勿重複操作"),
            throw new ServiceException(BizExceptionEnum.ERROR_REPEAT_DELETE);
        }

        recursionDelete(categoryId,version);
    }

    /**
     * 遞歸刪除所有的子節點
     */
    private void recursionDelete(int id, int version){

        //判斷當前分類下是否有上架中的商品,
        //......
        

        //對當前分類做邏輯刪除,只要有一個刪除失敗了,就全部失敗
        Category param = new Category();
        param.setId(id);
        param.setVersion(version);
        param.setStatus(PRODUCT_CATEGORY_STATUS_DELETE);
        count = categoryMapper.updateById(param);
        if(count==0){
            //FAIL_DELETE_CONCURRENT(500,"併發刪除異常,請稍後重試"),
            throw new ServiceException(BizExceptionEnum.FAIL_DELETE_CONCURRENT);
        }

        //查詢所有未被刪除的子類,遞歸刪除所有的子類菜單
        Wrapper<Category> wrapper = new EntityWrapper<>();
        wrapper.eq("parent_id",param.getId())
                .ne("status",PRODUCT_CATEGORY_STATUS_DELETE)
                .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);
            recursionDelete(temp.getId(),temp.getVersion());
        }
    }

    /**
     * 更新分類管理菜單的信息
     * @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);
        }

        //日誌需要
//        LogObjectHolder.me().set(category);


        //因爲我前面接收id的時候,用的是int類型的,所以如果程序能走到這裏,
        //那麼說明,此時至少不會造成空指針異常。


        //封裝要修改的內容,默認不更換父類菜單,只是修改名稱或修改排序編號
        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;
    }
}

 

(3)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 categoryId
     */
    void deleteCategoryById(int id, int categoryId);

    /**
     * 停用或啓用商品分類及其所有子類
     * @param id
     * @param version
     * @param status
     */
    void updateStatus(int id, int version, int status);
}

 

 

 

(4)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);

 

 

(5)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+"&currentPage="+$("#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
        +"&currentPage="+$("#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;//獲取列表頁面中記錄的id的值
    var version = this.seItem.version;//獲取列表頁面隱藏的version字段的值

    var operation =function () {
        var ajax = new $ax(Feng.ctxPath + "/category/delete", 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.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);
    }
}

 

 

(6)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二次開發目錄

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章