上节课我们一起搭建了内容服务工程,这节课我们一起学习如何添加内容分类。
我们到后台管理页面看看关于内容管理的内容,如下图所示。
我们再来看下content-category.jsp页面,这个页面就是内容分类页面,页面中<ul id="contentCategory" class="easyui-tree">用来展示内容分类树,$(function()是在页面加载完后要调用的js,下面这段代码是用来获取分类列表数据的,发起的url请求是/content/category/list,animate:true的意思是设置动画,如果设置为true,展开树形结构时是慢慢展开的效果。如果设置为false展开树形结构就一下子展开了。method:"GET"指定发起的是GET请求。
$("#contentCategory").tree({
url : '/content/category/list',
animate: true,
method : "GET",
在com.taotao.content.service包下新建接口类ContentCategoryService.java,在接口类中添加一个接口getContentCategoryList。
返回值是EasyUITreeNode的集合,EasyUITreeNode类的内容如下所示。id是树节点的id,text是节点的名称,state是指树形是闭合的还是打开的,如果当前节点还有子节点,那么state的值是"closed",如果当前节点已经是叶子节点了,那么state的值是"open"。
下面我们实现上面的接口,我们在taotao-content-service的com.taotao.content.service.impl包下新建ContentCategoryServiceImpl实现类,该类实现ContentCategoryService接口类。如下图所示。
为方便复制,实现类代码如下:
package com.taotao.content.service.impl;
import java.util.ArrayList;
import java.util.List;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import com.taotao.common.pojo.EasyUITreeNode;
import com.taotao.content.service.ContentCategoryService;
import com.taotao.mapper.TbContentCategoryMapper;
import com.taotao.pojo.TbContentCategory;
import com.taotao.pojo.TbContentCategoryExample;
import com.taotao.pojo.TbContentCategoryExample.Criteria;
@Service
public class ContentCategoryServiceImpl implements ContentCategoryService {
@Autowired
private TbContentCategoryMapper contentCategoryMapper;
@Override
public List<EasyUITreeNode> getContentCategoryList(long parentId) {
//创建一个查询类
TbContentCategoryExample contentCategoryExample = new TbContentCategoryExample();
//设置查询条件
Criteria criteria = contentCategoryExample.createCriteria();
criteria.andParentIdEqualTo(parentId);
//查询
List<TbContentCategory> categoryList = contentCategoryMapper.selectByExample(contentCategoryExample);
//将categoryList转换为List<EasyUITreeNode>
List<EasyUITreeNode> resultList = new ArrayList<>();
for(TbContentCategory contentCategory : categoryList){
EasyUITreeNode easyUITreeNode = new EasyUITreeNode();
easyUITreeNode.setId(contentCategory.getId());
easyUITreeNode.setText(contentCategory.getName());
easyUITreeNode.setState(contentCategory.getIsParent() ? "closed":"open");
resultList.add(easyUITreeNode);
}
return resultList;
}
}
下面我们发布一下该服务的这个接口,我们在taotao-content-service工程的spring目录下的applicationContext-service.xml文件中发布<dubbo:service interface="com.taotao.content.service.ContentCategoryService" ref="ContentCategoryServiceImpl" timeout="300000"/>
下面我们需要在taotao-manager-web工程添加Controller类来实现内容分类展示,前提是我们需要先添加对taotao-content-interface的依赖,如下图所示。
接着我们需要在taotao-manager-web的springmvc.xml中添加对ContentCategoryService的引用,添加的内容:<dubbo:reference interface="com.taotao.content.service.ContentCategoryService" id="contentCategoryService" />,如下图所示。
下面我们在ContentCategoryController类中调用服务接口。@RequestMapping("/content/category/list")的url是从content-category.jsp当中粘贴过来的。
代码如下,这里需要注意的是,第一次查询内容分类的时候没有参数的,因此需要指定一个默认值0,后续点击要展开某个节点的话,就会把节点id传过来了。还有就是参数parentId与id名称不一致,因此需要@RequestParam(name="id",defaultValue="0")这样来把id的值赋值给"parentId"。
package com.taotao.controller;
import java.util.List;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import com.taotao.common.pojo.EasyUITreeNode;
import com.taotao.content.service.ContentCategoryService;
@Controller
public class ContentCategoryController {
@Autowired
private ContentCategoryService contentCategoryService;
@RequestMapping("/content/category/list")
@ResponseBody
public List<EasyUITreeNode> getContentCategoryList(@RequestParam(name="id",defaultValue="0") Long parentId){
List<EasyUITreeNode> list = contentCategoryService.getContentCategoryList(parentId);
return list;
}
}
在启动测试之前,我们需要先打包taotao-content到本地maven仓库,方法是在工程上右键------->Run As------>Maven install。
由于查询内容分类列表涉及到了两个服务和taotao-manager-web,因此需要启动taotao-manager服务和taotao-content服务和taotao-manager-web。
在启动之前先打包taotao-manager和taotao-content到本地maven仓库,然后依次启动taotao-manager和taotao-content,然后是taotao-manager-web,启动好之后我们访问后台,如下图所示,发现可以正常显示内容分类列表了。
分类列表展示出来了,我们下面要做的便是管理内容分类,比如增加、重命名、删除等操作,这些操作可以在某个节点上右键,在右键菜单中操作(当然,现在还没有实现这三个功能),如下图所示。
右键菜单是在content-category.jsp页面的一个<div>中定义的,如下图所示。onContextMenu: function(e,node){这行代码的意思是当我们鼠标点击右键的时候触发该js方法,方法的参数中"e"代表事件,node代表鼠标在哪个节点上。e.preventDefault();代表事件传递,$(this).tree('select',node.target);这行代码的意思是$(this)指定鼠标所在的节点转变为jquery对象,.tree('select',node.target);意思是选中这个节点(node这行会添加背景颜色)。$('#contentCategoryMenu').menu('show',{这行代码的意思是让右键菜单显示出来,下面的left和top是指坐标。
对节点进行操作的流程是,当我们点击右键菜单中的任何一个操作的时候,data-options="onClick:menuHandler"告诉我们它会触发menuHandler方法。function menuHandler(item)这行代码的意思是定义menuHandler方法,参数item是指右键菜单这个对象,下面通过item.name来判断用户选择的是哪个操作。var tree = $("#contentCategory");这行代码当然就是获取分类树了,var node = tree.tree("getSelected");这行代码是获取选中的节点,tree.tree('append', {这行代码的意思是我们点击"添加"的时候会在这个节点下面追加一个节点,parent: (node?node.target:null),是为新节点指定父节点,data里面的text是指新建的节点名称叫"新建分类",id:0,表示新建的节点暂时定义id为0,parentId:node.id是指新建节点的parentId是我们操作的节点。var _node = tree.tree('find',0);的意思是在树种找到id为0的节点(由于新建的节点暂时定义id为0,因此会找到刚添加的节点),tree.tree("select",_node.target).tree('beginEdit',_node.target);这行代码的意思是让新建的节点处于可编辑状态。可以看到实际添加节点的操作不在menuHandler这个方法中,这个方法真正执行的操作是删除节点,$.post("/content/category/delete/",{parentId:node.parentId,id:node.id},function(){这行代码的意思便是去发起url为"/content/category/delete/"的请求,传递的参数是父级id和要删除的节点的id。function()是指回调函数,tree.tree("remove",node.target);意思就是从树形结构中删掉这个节点。
那么,实际进行添加节点到数据库的操作是在哪儿控制的呢?如下图所示,onAfterEdit : function(node){意思很明显了,就是我们编辑完之后鼠标离开编辑节点后触发的事件,参数node是指新建的节点,var _tree = $(this);是指得到tree,if(node.id == 0){的意思是如果node的id是0,(我们新建的节点id就暂时是0,因此会进入这个if当中),$.post("/content/category/create"的意思是添加节点会去请求"/content/category/create"这个url。{parentId:node.parentId,name:node.text}是指传递的参数有两个,分别是父级id和节点的名称。function(data)是回调函数,data是返回的对象。if(data.status == 200){很显然是指操作成功。_tree.tree("update",{target : node.target,id : data.data.id});的意思是如果操作成功了,那么就要去更新一下新添加的节点的id,data.data.id是指添加到数据库中的节点的Id。如果if(node.id == 0)条件不成立,说明不是添加新节点操作,而是更新节点操作。$.post("/content/category/update",{id:node.id,name:node.text});意思是请求url为"/content/category/update",传递的参数有节点id、节点名称。
分析完了js代码,下面我们便来一一实现内容分类的添加、修改、删除功能
首先是添加功能,由于都是单表操作,因此使用逆向工程生成的代码就可以满足要求,我们直接修改服务层即可,我们到taotao-content-interface工程添加一个接口,如下图所示。
下面我们到taotao-content-service工程中去实现这个接口,不过在此之前,由于逆向工程自动生成的insert方法不会自动帮我们给主键的值赋值,因此我们需要在mapper.xml文件中新增一段sql,id取值为"saveAndGetId",这段sql的意思是保存内容分类并且自动给对象的id属性赋值,之所以这样做是因为我们需要用到这个id给树形结构中新增加的节点id赋值,<selectKey keyProperty="id" resultType="long" order="AFTER">就是给新添加的对象的主键赋值的,如下图所示。
为方便复制,现粘贴如下
<insert id="saveAndGetId" parameterType="com.taotao.pojo.TbContentCategory"
useGeneratedKeys="true" keyProperty="id">
insert into tb_content_category (parent_id, name, status, sort_order, is_parent, created, updated)
values (#{parentId,jdbcType=BIGINT}, #{name,jdbcType=VARCHAR},
#{status,jdbcType=INTEGER}, #{sortOrder,jdbcType=INTEGER}, #{isParent,jdbcType=BIT},
#{created,jdbcType=TIMESTAMP}, #{updated,jdbcType=TIMESTAMP})
<selectKey keyProperty="id" resultType="long" order="AFTER">
SELECT LAST_INSERT_ID()
</selectKey>
</insert>
在TbContentCategoryMapper.xml添加完sql语句之后,我们需要到TbContentCategoryMapper类中添加对应的方法,如下图所示。
做好以上准备后,我们到ContentCategoryServiceImpl类中实现添加内容分类接口了,如下所示。
实现类代码如下
@Override
public TaotaoResult addContentCategory(long parentId, String name) {
//实例化一个对象
TbContentCategory contentCategory = new TbContentCategory();
//填充属性值
contentCategory.setParentId(parentId);
contentCategory.setName(name);
//状态。可选值:1(正常),2(删除),刚添加的节点肯定是正常的
contentCategory.setStatus(1);
//刚添加的节点肯定不是父节点
contentCategory.setIsParent(false);
//数据库中现在默认的都是1,所以这里我们也写成1
contentCategory.setSortOrder(1);
//保存当前操作时间
contentCategory.setCreated(new Date());
contentCategory.setUpdated(new Date());
//插入节点到数据库
contentCategoryMapper.saveAndGetId(contentCategory);
//添加一个节点需要判断父节点是不是叶子节点,如果父节点是叶子节点的话,
//需要改成父节点状态
TbContentCategory parent = contentCategoryMapper.selectByPrimaryKey(parentId);
if(!parent.getIsParent()){
parent.setIsParent(true);
contentCategoryMapper.updateByPrimaryKey(parent);
}
return TaotaoResult.ok(contentCategory);
}
服务层写完后,我们再写Controller层,我们到taotao-manager-web工程的ContentCategoryController.java当中添加Controller方法,如下图所示。
由于taotao-manager-dao工程和taotao-content工程都做了修改,因此我们重新打包taotao-manager-dao和taotao-content工程,然后重启taotao-manager、taotao-content和taotao-manager-web工程。重启后,我们到后台管理系统去增加两个分类,如下图所示,完全正确。
做完了内容分类添加,下面我们实现以下内容分类修改和删除,其中我们需要先修改下content-category.jsp页面的删除请求的参数,因为树形结构的节点只有id、name、sate三个属性,并没有parentId属性,只有新增的节点给parentId赋值了,对于页面刚加载完的树形目录,节点是没有parentId属性的,因此我们把parentId这个参数去掉,我们只通过节点id便可以删除节点了。删除parentId参数后变为"$.post("/content/category/delete/",{id:node.id},function(){"
下面我们到taotao-content-interface添加两个接口,分别是修改分类和删除分类接口,如下图所示。
接口类代码如下:
package com.taotao.content.service;
import java.util.List;
import com.taotao.common.pojo.EasyUITreeNode;
import com.taotao.common.pojo.TaotaoResult;
public interface ContentCategoryService {
//获取内容分类列表
List<EasyUITreeNode> getContentCategoryList(long parentId);
//添加内容分类,注意参数名称要与content-category.jsp页面指定的参数名称一致
TaotaoResult addContentCategory(long parentId,String name);
//修改内容分类,注意参数名称要与content-category.jsp页面指定的参数名称一致
TaotaoResult updateContentCategory(long id,String name);
//删除内容分类,注意参数名称要与content-category.jsp页面指定的参数名称一致
TaotaoResult deleteContentCategory(long id);
}
接着,我们到taotao-content-service来实现这两个接口,ContentCategoryServiceImpl全部代码如下所示。
package com.taotao.content.service.impl;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import com.taotao.common.pojo.EasyUITreeNode;
import com.taotao.common.pojo.TaotaoResult;
import com.taotao.content.service.ContentCategoryService;
import com.taotao.mapper.TbContentCategoryMapper;
import com.taotao.pojo.TbContentCategory;
import com.taotao.pojo.TbContentCategoryExample;
import com.taotao.pojo.TbContentCategoryExample.Criteria;
@Service
public class ContentCategoryServiceImpl implements ContentCategoryService {
@Autowired
private TbContentCategoryMapper contentCategoryMapper;
@Override
public List<EasyUITreeNode> getContentCategoryList(long parentId) {
//创建一个查询类
TbContentCategoryExample contentCategoryExample = new TbContentCategoryExample();
//设置查询条件
Criteria criteria = contentCategoryExample.createCriteria();
criteria.andParentIdEqualTo(parentId);
//查询
List<TbContentCategory> categoryList = contentCategoryMapper.selectByExample(contentCategoryExample);
//将categoryList转换为List<EasyUITreeNode>
List<EasyUITreeNode> resultList = new ArrayList<>();
for(TbContentCategory contentCategory : categoryList){
EasyUITreeNode easyUITreeNode = new EasyUITreeNode();
easyUITreeNode.setId(contentCategory.getId());
easyUITreeNode.setText(contentCategory.getName());
easyUITreeNode.setState(contentCategory.getIsParent() ? "closed":"open");
resultList.add(easyUITreeNode);
}
return resultList;
}
@Override
public TaotaoResult addContentCategory(long parentId, String name) {
//实例化一个对象
TbContentCategory contentCategory = new TbContentCategory();
//填充属性值
contentCategory.setParentId(parentId);
contentCategory.setName(name);
//状态。可选值:1(正常),2(删除),刚添加的节点肯定是正常的
contentCategory.setStatus(1);
//刚添加的节点肯定不是父节点
contentCategory.setIsParent(false);
//数据库中现在默认的都是1,所以这里我们也写成1
contentCategory.setSortOrder(1);
//保存当前操作时间
contentCategory.setCreated(new Date());
contentCategory.setUpdated(new Date());
//插入节点到数据库
contentCategoryMapper.saveAndGetId(contentCategory);
//添加一个节点需要判断父节点是不是叶子节点,如果父节点是叶子节点的话,
//需要改成父节点状态
TbContentCategory parent = contentCategoryMapper.selectByPrimaryKey(parentId);
if(!parent.getIsParent()){
parent.setIsParent(true);
contentCategoryMapper.updateByPrimaryKey(parent);
}
return TaotaoResult.ok(contentCategory);
}
@Override
public TaotaoResult updateContentCategory(long id, String name) {
//通过id查询节点对象
TbContentCategory contentCategory = contentCategoryMapper.selectByPrimaryKey(id);
//判断新的name值与原来的值是否相同,如果相同则不用更新
if(name != null && name.equals(contentCategory.getName())){
return TaotaoResult.ok();
}
contentCategory.setName(name);
//设置更新时间
contentCategory.setUpdated(new Date());
//更新数据库
contentCategoryMapper.updateByPrimaryKey(contentCategory);
//返回结果
return TaotaoResult.ok();
}
//通过父节点id来查询所有子节点,这是抽离出来的公共方法
private List<TbContentCategory> getContentCategoryListByParentId(long parentId){
TbContentCategoryExample example = new TbContentCategoryExample();
Criteria criteria = example.createCriteria();
criteria.andParentIdEqualTo(parentId);
List<TbContentCategory> list = contentCategoryMapper.selectByExample(example);
return list;
}
//递归删除节点
private void deleteNode(long parentId){
List<TbContentCategory> list = getContentCategoryListByParentId(parentId);
for(TbContentCategory contentCategory : list){
contentCategory.setStatus(2);
contentCategoryMapper.updateByPrimaryKey(contentCategory);
if(contentCategory.getIsParent()){
deleteNode(contentCategory.getId());
}
}
}
@Override
public TaotaoResult deleteContentCategory(long id) {
//删除分类,就是改节点的状态为2
TbContentCategory contentCategory = contentCategoryMapper.selectByPrimaryKey(id);
//状态。可选值:1(正常),2(删除)
contentCategory.setStatus(2);
contentCategoryMapper.updateByPrimaryKey(contentCategory);
//我们还需要判断一下要删除的这个节点是否是父节点,如果是父节点,那么就级联
//删除这个父节点下的所有子节点(采用递归的方式删除)
if(contentCategory.getIsParent()){
deleteNode(contentCategory.getId());
}
//需要判断父节点当前还有没有子节点,如果有子节点就不用做修改
//如果父节点没有子节点了,那么要修改父节点的isParent属性为false即变为叶子节点
TbContentCategory parent = contentCategoryMapper.selectByPrimaryKey(contentCategory.getParentId());
List<TbContentCategory> list = getContentCategoryListByParentId(parent.getId());
//判断父节点是否有子节点是判断这个父节点下的所有子节点的状态,如果状态都是2就说明
//没有子节点了,否则就是有子节点。
boolean flag = false;
for(TbContentCategory tbContentCategory : list){
if(tbContentCategory.getStatus() == 0){
flag = true;
break;
}
}
//如果没有子节点了
if(!flag){
parent.setIsParent(false);
contentCategoryMapper.updateByPrimaryKey(parent);
}
//返回结果
return TaotaoResult.ok();
}
}
我们到ContentCategoryController暴露两个接口,如下图所示。
代码如下:
@RequestMapping("/content/category/create")
@ResponseBody
public TaotaoResult addContentCategory(Long parentId,String name){
TaotaoResult taotaoResult = contentCategoryService.addContentCategory(parentId, name);
return taotaoResult;
}
@RequestMapping("/content/category/update")
@ResponseBody
public TaotaoResult updateContentCategory(Long id,String name){
TaotaoResult taotaoResult = contentCategoryService.updateContentCategory(id, name);
return taotaoResult;
}
@RequestMapping("/content/category/delete/")
@ResponseBody
public TaotaoResult deleteContentCategory(Long id){
TaotaoResult taotaoResult = contentCategoryService.deleteContentCategory(id);
return taotaoResult;
}
代码写完了,我们重新打包taotao-content工程,然后重启taotao-content工程和taotao-manager-web工程。增加、修改、删除就都好使了。