原文地址: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 {
@Autowired
private CategoryMapper categoryMapper;
@Override
public 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 {
@Autowired
private CategoryService categoryService;
@PostMapping
public Result add(@RequestBody @Validated Category category){
categoryService.add(category);
return Result.success();
}
}
可以看到此时已经添加成功了,由于没有添加数据库回显的代码所以只能直接在服务端进行查看。
尾声
无论是否出于个人业余爱好,关于全栈开发的学习比重都得逐渐下调了。毕竟专业不完全是这个方向的。
这也意味着相应专栏的更新频率会降低,向其他编程语言转变。图个玩儿