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

下面是正文内容:

前言

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

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

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

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

正文

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

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

前端

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

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

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)
}

后端

前置知识

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

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

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

实现思路

数据库文章列表的格式

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

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

数据访问层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();
    }

}

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

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

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

尾声

无论是否出于个人业余爱好,关于全栈开发的学习比重都得逐渐下调了。毕竟专业不完全是这个方向的。

这也意味着相应专栏的更新频率会降低,向其他编程语言转变。图个玩儿

03-29 12:53