Web系统开发之——文章管理

原文地址：Web系统开发之——文章管理 - Pleasure的博客

下面是正文内容：

前言

经过一番考量，关于Web应用系统功能部分的开发，决定采取基础的文字文章管理为核心功能。

不再采取前后端分阶段完成的方式，而是以一个一个细节操作为单位，同时进行前端页面的架构以及后端工程的连接。

前后端同时推进，通过添加不同的操作来一点一点进行完善。前端采取Vue框架后端采取SpringBoot工程。

由于在之前的文章里关于Vue前端方面的描述主要局限于登录功能的实现，而且代码中也附有批注，所以就直接带过了。

正文

今天就主要来记录——文章管理系统之添加文章分类。就是通过点击“新建文章分类”按钮从而在服务端数据库中增加一个文章分类。

如果在存在错误，可能是由于部分文件的确实需要参考专栏之前的文章进行补齐。或者在浏览器界面按F12查看错误。

前端

控制面板部分，对组件进行了一些调整，与之前的面板代码实现存在一定的差异。

UI界面实现代码

<script setup>
import {House,Management,Promotion,UserFilled,User,Crop,EditPen,SwitchButton,CaretBottom
} from '@element-plus/icons-vue'
import avatar from '@/assets/default.png'</script><template><el-container class="layout-container"><el-header><div><strong>Yiming</strong>的文档管理系统</div><el-dropdown placement="bottom-end"><span class="el-dropdown__box"><el-avatar :src="avatar" /><el-icon><CaretBottom /></el-icon></span><template #dropdown><el-dropdown-menu><el-dropdown-item command="profile" :icon="User">基本资料</el-dropdown-item><el-dropdown-item command="avatar" :icon="Crop">更换头像</el-dropdown-item><el-dropdown-item command="password" :icon="EditPen">重置密码</el-dropdown-item><el-dropdown-item command="logout" :icon="SwitchButton">退出登录</el-dropdown-item></el-dropdown-menu></template></el-dropdown></el-header><el-container><el-container><el-aside width="200px"><div class="el-aside__logo"></div><el-menu active-text-color="#ffd04b" background-color="#f1f1f1" text-color="#999" router><el-menu-item index="/user/front"><el-icon><House /></el-icon><span>首页公告</span></el-menu-item><el-menu-item index="/article/category"><el-icon><Management /></el-icon><span>文章分类</span></el-menu-item><el-menu-item><el-icon><Promotion /></el-icon><span>文章管理</span></el-menu-item><el-sub-menu><template #title><el-icon><UserFilled /></el-icon><span>个人中心</span></template><el-menu-item index="/user/info"><el-icon><User /></el-icon><span>基本资料</span></el-menu-item><el-menu-item><el-icon><Crop /></el-icon><span>更换头像</span></el-menu-item><el-menu-item><el-icon><EditPen /></el-icon><span>重置密码</span></el-menu-item></el-sub-menu></el-menu></el-aside><el-container><el-main><router-view></router-view></el-main><el-footer>Yiming的文档管理系统@版权归yiming所有</el-footer></el-container></el-container></el-container></el-container>
</template><style lang="scss" scoped>
.layout-container {height: 100vh;.el-aside {background-color: #f1f1f1;&__logo {height: 120px;background: url('') no-repeat center / 120px auto;}.el-menu {border-right: none;}}.el-header {background-color: #dddddd;display: flex;align-items: center;justify-content: space-between;.el-dropdown__box {display: flex;align-items: center;.el-icon {color: #999;margin-left: 10px;}&:active,&:focus {outline: none;}}}.el-footer {display: flex;align-items: center;justify-content: center;font-size: 14px;color: #666;}
}
</style>

ArticleCategory.vue的代码

<script setup>
import {Edit,Delete
} from '@element-plus/icons-vue'
import { ref } from 'vue'
const categorys = ref([])
//声明一个异步的函数
import { articleCategoryListService, articleCategoryAddService } from '@/api/CreateCategory.js'
const articleCategoryList = async () => {let result = await articleCategoryListService();categorys.value = result.data;}
articleCategoryList();const dialogVisible = ref(false)
const rules = {categoryName: [{ required: true, message: '请输入分类名称', trigger: 'blur' },],categoryAlias: [{ required: true, message: '请输入分类别名', trigger: 'blur' },]
}
const categoryModel = ref({categoryName: '',categoryAlias: ''
})//调用接口,添加表单
import { ElMessage } from 'element-plus'
const addCategory = async () => {//调用接口let result = await articleCategoryAddService(categoryModel.value);ElMessage.success(result.msg ? result.msg : '添加成功')//调用获取所有文章分类的函数articleCategoryList();dialogVisible.value = false;
}
</script><template><el-page-header :icon="null"><template #content><div class="flex items-center"><el-avatar :size="32" class="mr-3"src="https://cube.elemecdn.com/0/88/03b0d39583f48206768a7534e55bcpng.png" /><span class="text-large font-600 mr-3"> 文章分类列表</span></div></template><template #extra><el-button type="primary" @click="dialogVisible = true">新建文章分类</el-button><el-dialog v-model="dialogVisible" title="新建文章分类" width="30%"><el-form :model="categoryModel" :rules="rules" label-width="100px" style="padding-right: 30px"><el-form-item label="分类名称" prop="categoryName"><el-input v-model="categoryModel.categoryName" minlength="1" maxlength="10"></el-input></el-form-item><el-form-item label="备注和说明" prop="categoryAlias"><el-input v-model="categoryModel.categoryAlias" minlength="1" maxlength="15"></el-input></el-form-item></el-form><template #footer><span class="dialog-footer"><el-button @click="dialogVisible = false">取消</el-button><el-button type="primary" @click="addCategory"> 确认 </el-button></span></template></el-dialog></template></el-page-header><el-divider></el-divider>
</template>

前端界面大致的实现思路就是：

当用户点击界面上的按钮后跳出一个弹窗，

填写完相关信息后点击确认触发按钮绑定的addCategory函数向后端发送表单，

addCategory函数在开头的script部分进行了声明是调用后端增加文章分类接口的异步函数，

addCategory函数中的articleCategoryAddService服务在api文件夹下的CreateCategory.js文件中进行了定义，以post的方式向后端“/category”发送categoryName，categoryAlias的值用来记录到数据库中。

CreateCategory.js的代码

import request from '@/utils/request.js'export const articleCategoryListService = ()=>{return request.get('/category')
}
//文章分类添加
export const articleCategoryAddService = (categoryData)=>{return request.post('/category',categoryData)
}

后端

前置知识

异步函数：在调用函数时不会阻塞程序的其他操作，而是会在后台执行，执行完成后会触发回调函数或返回结果。

同步函数：在调用函数时会阻塞程序的其他操作，直到函数执行完成并返回结果后，才会继续执行后续的代码。

异步函数可以用于改善服务器性能，提高用户的使用体验等等。

实现思路

数据库文章列表的格式

后端文件结构需要查看专栏之前的文章，这里就不重复进行申明了

数据访问层CategoryMapper.java，定义CategoryMapper函数用于向数据库添加数据，

服务层CategoryService.java中先声明接口，然后在CategoryServiceImpl.java中定义CategoryService函数通过调用ControllerMapper函数实现添加，（不要忘记在pojo文件夹下声明Category类）

请求层CategoryController.java，调用服务层的函数categoryService.add(category)通过post的方式实现添加

CategoryMapper.java的内容

package org.example.mapper;import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Mapper;
import org.example.pojo.Category;@Mapper
public interface CategoryMapper {@Insert("insert into category(category_name,category_alias,create_user,create_time,update_time)" +"values (#{categoryName},#{categoryAlias},#{createUser},#{createTime},#{updateTime})")void add(Category category);}

CategoryService.java的内容

package org.example.service;
import org.example.pojo.Category;
public interface CategoryService {//新增分类void add(Category category);
}

CategoryServiceImpl.java的内容

package org.example.service.impl;import org.example.mapper.CategoryMapper;
import org.example.pojo.Category;
import org.example.service.CategoryService;
import org.example.utils.ThreadLocalUtil;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;import java.time.LocalDateTime;
import java.util.Map;@Service
public class CategoryServiceImpl implements CategoryService {@Autowiredprivate CategoryMapper categoryMapper;@Overridepublic void add(Category category){category.setCreateTime(LocalDateTime.now());category.setUpdateTime(LocalDateTime.now());Map<String,Object> map = ThreadLocalUtil.get();Integer userId = (Integer) map.get("id");category.setCreateUser(userId);categoryMapper.add(category);}
}

CategoryController.java的内容

package org.example.controller;import org.apache.ibatis.annotations.Mapper;
import org.example.pojo.Result;
import org.example.pojo.Category;
import org.example.service.CategoryService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping("/category")
public class CategoryController {@Autowiredprivate CategoryService categoryService;@PostMappingpublic Result add(@RequestBody @Validated Category category){categoryService.add(category);return Result.success();}}

可以看到此时已经添加成功了，由于没有添加数据库回显的代码所以只能直接在服务端进行查看。