做个开源博客学习Vite2 + Vue3 （三）博客设计和代码设计

项目搭建好了之后是不是可以编码了呢？
等等不要着急，我们是不是应该先设计一下？比如博客的功能等？

博客设计

先做个简单的个人博客，因为是个人版，所以可以省略注册、登录这些功能，表结构也可以简单一点。
基础功能：添加博文、显示博文、博文列表+查询+分页、讨论列表和添加讨论。
虽然功能弱了一点，但是麻雀虽小五脏俱全，vite2 和 vue3 的基础用法也可以体现一些。

功能设计

001博客功能

是不是做成图更明显一些？

代码设计

002代码结构.png

model设计

003model设计.png

model代码

先来看看 model 的代码。
/src/model/blogModel.js

/**
 * 显示博文用，建表用
 * @returns 博文的全部的属性
 */
export const blog = () => {
  return {
    // id: 0,
    title: '', // 这是一个博客标题
    groupId: 0, // 分组ID
    addTime: new Date(), // 添加时间
    introduction: '', // 这是博客的简介
    concent: '', // 这是博客的详细内容
    state: 1, // 1：草稿；2：发布；3：删除
    viewCount: 0, // 浏览量
    agreeCount: 0, // 点赞数量
    discussCount: 0 // 讨论数量
  }
}

/**
 * 表单用的博文，绑定表单用。
 * * title：文章标题
 * @returns 添加博文需要的属性
 */
 export const blogForm = () => {
  return {
    // id: new Date().valueOf(),
    title: '', // 这是一个博客标题
    addTime: new Date(), // 添加时间
    introduction: '', // 这是博客的简介
    concent: '', // 这是博客的详细内容
    state: 1 // 1：草稿；2：发布；3：删除
  }
}

/**
 * 首页用的博文列表，按需设置字段
 * @returns 博文列表
 */
 export const blogList = () => {
  return {
    id: 0,
    title: '', // 这是一个博客标题
    addTime: '', // 添加时间
    introduction: '', // 这是博客的简介
    viewCount: 0, // 浏览量
    agreeCount: 0, // 点赞数量
    discussCount: 0 // 讨论数量
  }
}

/**
 * 编辑博文用的列表
 * @returns 文章标题列表
 */
 export const articleList = () => {
  return {
    id: 0,
    title: '', // 这是一个博客标题
    addTime: '', // 添加时间
    viewCount: 0, // 浏览量
    agreeCount: 0, // 点赞数量
    discussCount: 0 // 讨论数量
  }
}

/**
 * 建表用的讨论
 * @returns 讨论表
 */
 export const discuss = () => { 
  return {
    // id: 0,
    blogId: 0,
    discusser: '' , // 昵称
    addTime: new Date(), // 时间
    concent: '', // 内容
    agreeCount: 0
  }
}

/**
 * @returns 讨论的model
 */
export const discussList = () => { 
  return {
    id: 0,
    discusser: '' , // 昵称
    addTime: '', // 时间
    concent: '', // 内容
    agreeCount: 0
  }
}

原生js是不需要先定义对象的，只是我感觉把需要的对象放在一起集中管理一下，还是比较方便的，虽然这么做用处不大，因为不是ts，没有任何强制性也没有检查机制，但是还是想集中管理一下。

状态设计

004状态设计.png

状态嘛，简单地说就是多个组件共享的数据，当然这么说不够严谨。

/src/model/blogState.js

import { inject } from "vue"

export const blogState = {
  currentGroupId: 0, // 选择的分组ID。0：没选择
  currentArticleId: 0, // 选择的文章ID。
  editArticleId: 0, // 当前修改的文章ID
  findQuery: { }, // 查询条件
  page: { // 分页参数
    pageTotal: 100,
    pageSize: 2,
    pageIndex: 1,
    orderBy: { id: false }
  }, 
  isReloadDiussList: false
}

/**
* 状态的管理
* * 获取状态
* * 设置当前选择的分组
* * 设置当前选择的文章
* * 设置当前编辑的文章
*/
export default function blogStateManage() {
  // 先把状态取出来，否则在 function 里面无法读取。
  const state = inject('blogState')

  // 子组件里面获取状态
  const getBlogState = (id) => {
    return state 
  }

  // 设置当前选择的分组   
  const setCurrentGroupId = (id) => {
    state.currentGroupId = id
  }

  // 设置当前编辑的文章  
  const setEditArticleId = (id) => {
    state.editArticleId = id
  }

  // 设置更新讨论列表
  const setReloadDiussList = () => {
    state.isReloadDiussList = !state.isReloadDiussList
  }

  return {
    setReloadDiussList, // 设置更新讨论列表
    getBlogState, // 获取状态
    setEditArticleId, // 设置当前编辑的文章
    setCurrentGroupId // 设置当前选择的分组
  }
}

算是一个简易的状态管理吧，先定义一下需要的状态，在main里面注入状态，然后用 inject 提取状态，再写几个设置状态的函数，基本就可以搞定了。

后续想写成插件的形式，当然会完善一些功能，不会这么单薄。

感觉 Vuex 有点太厚重了，这里也不需要那么强大的功能，所以就自己实现了一个简单的。

未完待续，后面更精彩。

源码

https://gitee.com/naturefw/vue3-blog

在线演示

https://naturefw.gitee.io/vue3-blog