记一次大作业中出现的问题
本文最后更新于 170 天前,其中的信息可能已经有所发展或是发生改变。

零、 前言

大段纯文本字又没有图片警告。虽然我知道这样可能阅读兴趣不高,但是实在没有配图了,请当故事看吧

这次大作业是Web应用系统开发技术与实践的大作业,有很多选题可以选择,我们小组选择的是企业级论坛系统。本来老师要求的是使用Java + Spring(或者再加一个Spring Boot)用MVC框架实现,需求很简单,就是基本你能想到的论坛该有的功能,其他需求的表述老师自己可能都不知道。我们准备模仿百度贴吧和Discuz

后来我们觉得JSP页面开发起来有些麻烦,就改用了前后端分离的写法,前端使用Vue 3开发,后端使用Spring加一些后端的东西来开发接口,接口使用Restful API规范。前后端分离的写法最大的好处就是它可以让前后端分别注重自己开发的部分,不需要后端根据前端页面进行修改,不需要前端在页面中进行逻辑操作,并且JSTL的自定义标签和Vue的自定义组件我认为在一定程度上其实是一样的,这种方式的缺点也很明显,其他开发者想对这套系统添加新功能时不好开发补丁插件(因为要同时修改前端和后端的东西)。例如Wordpress就是前后不分离的程序(当然Wordpress提供的Restful API接口,想的话还是可以分离的),因此想要添加功能仅需要安装插件就行,当然也要得益于Wordpress提供了非常多的钩子。

我负责的是前端的部分,项目使用vue-cli创建,使用Element Plus;API接口文档及调试使用Apifox

一、 最大的问题:时间分配

大概是11月初布置的大作业,原定于11月28日提交,在DDL前,依次分布着:网络与分布计算考试(11月14日)、软件测试考试(11月19日)、算法分析与设计考试(11月29日),还有以上课程实验课的作业。最后因为一些同学的请求,实验截止时间改为了12月5日

因为各种各样的事情交加,后端根据基本初步完成了API的编写,但是我们前端一直没能给出原型图和初稿,导致了后期很多字段不匹配的问题,一定程度拖延了进度。

二、 组内合作问题

在项目创建之初,我就在Gitee仓库中初始化了项目,使用Vue3,但是中间另一个和我合作的同学(没有系统学习过前端),自己新建了一个项目,明明在一开始有教过Git基本操作,npm基本操作和使用,想不明白为什么要新建一个项目,如果还是Vue3的也好,她的新项目是 Vue2 + Element UI,导致后期她的代码push不到仓库,又整合不起来,花了很长时间重构。虽然说是初学,但是也应该在已有仓库项目上操作啊,如果安装依赖包的时候安装不上也应该及时来问啊,为什么还要新建一个项目,导致后面版本和以来都不一样了,做了很多无用功。(Element UI在Vue3中为Element Plus,语法和迁移都有一定困难)。其实她还自己按照网上的方法封装了axios请求和Vuex的store,但是本来Vue全局就已经导入了axios并配置了默认Authorization的Header,并且store的结构也是网上的,而不是项目的user结构。

在最开始的时候分工也没有分配好任务,最开始分配给那个同学写某一个组件,后来没有了音讯,没有做好项目管理,没有及时跟进进度。后来那个同学没有写那个组件,我也把前台静态页面写完了,好在她写的管理员后台,没有冲突(假设整合不了不算冲突)。

三、 接口问题

3.1 接口命名

在完成前端的设计稿、绑接口之前,根本没有注意过接口内容,等到绑接口的时候才知道接口的命名有多奇怪。例如帖子blog而不是post,板块tag而不是forum(并且也没有预想中的板块头像、板块描述,当然这是因为UI设计图没有给到),获取所有一级二级评论叫做 ‘/firstLevel’, ‘/secondLevel’,而不是’/comment’, ‘/subcomment’,诸如此类。虽然说影响不大,但是主要是看起来别扭。

3.2 接口请求参数

以下是一个样例:

重置邮箱验证码API

明明是一个POST请求,参数却放到了query里(就是url中?后面的部分),如果不仔细看可能就直接放到POST body里了,感觉很反常。

更严重的是下面这张图:

注册接口

不同注册信息直接放到了不同位置,既有query又有body,非常难搞。(而且password还在query中)

另外还需要注意的一点:如果参数规定格式是application/x-www-form-urlencoded,则应该使用qs.stringify(data)对参数进行序列化,否则Spring收到的对象请求对象就会是null

登录接口
import qs from 'qs'
// ...
this.$axios.post('/user/login',qs.stringify({email: email, password: password})).then(resp => /*...*/)

3.3 接口返回值问题

和后端沟通的时候一定要确保他们理解了你的意思!!!

最开始与后端沟通的时候,本来预想的是每个一级评论中包含2条二级评论,以防止一级评论获取后再重复发送请求再获取二级评论,等待用户点击显示更多时再去获取,这是我预想的结构

data: { // 返回的一级评论结构
  // ...
  subComment: [{}, {}]
}

后端成功的理解成了:

data: [
  {}, // 获取的一级评论
  {}, // 第一条二级评论
  {}, // 第二条二级评论
]

因为的的组件只能接受一个参数,所以多余的两条二级评论直接废弃了。

<PostReply :replyObject="data[0]" />

然后后来突然什么时候接口给改了,数组没了,页面突然崩了,就是那个我好好的什么都没干就崩了,怎么回事呢的那种感觉,一检查发现data变成一个对象了,要把绑定内容从data[0]改成data。所以后端改接口的时候也要及时说。


还有一个地方,就是返回文章列表的时候,我们感觉常识应该是返回文章对象数组,所以没有说,也就是这种格式:

data: [{}, {}, {}, {}]

结果后端成功给我们返回成了对象:

data: {
  "Blog1": {},
  "Blog2": {},
  // ...
}

我使用的时原生v-for,对这种还是支持的,但是写管理员页面的同学使用Element Plus 的 el-table就不是很支持了,导致页面频频出错,后来只得让后端去改接口返回值,才解决问题。

<el-table :data="data"> <!-- 这里的data只能是数组 -->
  <!-- ... -->
</el-table>

四、 总结

最终在赶DDL中,我们成功在12月5日23:56 提交作业,虽然还有很多bug没有修复……

在这里还是总结以下出现的问题:

  1. 前期一定要定好需求文档、界面原型图和接口文档
  2. 一定要做好项目管理跟踪进度,最好使用一些DevOps平台监工
  3. 组内合作一定要明确,并且流程要清楚。

今晚就先写到这吧,希望本片文章可以帮助一些团队避免一些开发中的问题。项目成果展示之后再贴在这里。


代码时间统计:(截止2021年12月6日)

wakatimewakatimewakatime41 hrs 48 mins41 hrs 48 mins

项目成果展示:

首页
个人中心
板块页
贴子内页
文章首发于https://blog.orangii.cn/2021/web-course-project/,转载请注明出处。博客所有文章遵循CC BY-NC 4.0协议

评论

  1. iPhone Safari
    4月前
    2022-1-27 12:00:09

    专业 厉害

  2. Windows Chrome
    5月前
    2021-12-17 23:51:49

    有些看不懂,但从中看到的小组辛酸,太有感同身受了呜呜呜

    • 博主
      DragonAdd
      Windows Chrome
      5月前
      2021-12-18 19:10:12

      大学很多小组作业就是这样,或者更是只有几个人干剩下的摆烂

      • 橙梓
        Windows Chrome
        5月前
        2021-12-19 13:40:03

        我们学校重视小组合作,导致我的课程除了数学,其他所有课程都是小组完成作业。。。。。。太难受了

  3. Windows Chrome
    6月前
    2021-12-09 23:50:25

    太牛了,虽然我看不懂,但给大佬点赞就对了~

  4. iPad Chrome
    6月前
    2021-12-09 16:52:02

    大佬太牛了 害怕

    • 博主
      常瑞
      Windows Chrome
      6月前
      2021-12-09 17:22:35

      没有很大佬,主要是想吐槽一下,很多东西研究的也没有很深

  5. Windows Chrome
    6月前
    2021-12-08 13:16:33

    原来这个博客模板大家都是这么用的…

    • 博主
      Temple
      Windows Chrome
      6月前
      2021-12-08 13:29:49

      emm没有太明白

      • 橙梓
        Android Chrome
        6月前
        2021-12-08 13:32:54

        哈,我的意思是我们网站用的都是同一个模板,但是在用法上有一些区别。这很有意思。

        • 博主
          Temple
          Windows Chrome
          6月前
          2021-12-08 15:03:59

          总归都是把自己的想法展现出来,这也是博客的最终目的了୧(๑•̀⌄•́๑)૭
          不过好像你的博客说说的feed没有标题,可能是因为说说没有设置标题吧

          • 橙梓
            Windows Chrome
            6月前
            2021-12-08 15:06:30

            对,想过一些办法,但是以我的能力确实没办法实现有标题的Feed,后来也懒得折腾了。

            • 博主
              Temple
              Windows Chrome
              6月前
              2021-12-08 18:53:58

              可能目前最简单的方法就是写标题了吧😂

              • 橙梓
                Android Chrome
                6月前
                2021-12-08 18:56:14

                不行,写标题的话每一条说说也会显示一个标题。观感非常不伦不类。

                • 博主
                  Temple
                  Windows Chrome
                  6月前
                  2021-12-08 19:10:16

                  那确实不好搞,其实也可以用CSS隐藏前端展示的标题

  6. ljh
    Windows Firefox
    6月前
    2021-12-07 23:22:43

    哇这么多字👍太认真辣。确实,沟通太重要了,之前做东西都是一个人做,一进入到小组里面就容易出现各种问题。。
    我之前有个组队小作业,为了达到最高效率,我就打算一个人做完,做着做着发现太累了,就想给队友一些事情干,于是叫某同学推导某个函数表达式,给他介绍完一堆背景后,结果他推的表达式还是给我把参数定死,白搞,最后还是我一人全包了…
    感觉还是要多多加入到团队里面,积累一些沟通和管理的经验😂

    • 博主
      ljh
      Windows Chrome
      6月前
      2021-12-08 11:36:49

      我们专业要学软件项目组织与管理,里面有很详细的分工、计划什么的,如果能掌握的话其实管理的问题不是很大,加上现在的工具又很多。现在大学里小组作业或者要组队的作业有很大的问题就是,很多人就为了学分去随便加一个队,什么也不干,摆烂,到最后整个人对项目的贡献度可能都是负的,最讨厌的就是这种,不学、不干、干也不好好干。当然如果本身成员水平不行的话,就得在招人的时候就考虑清楚了

发送评论 编辑评论

|´・ω・)ノ
ヾ(≧∇≦*)ゝ
(☆ω☆)
(╯‵□′)╯︵┴─┴
 ̄﹃ ̄
(/ω\)
∠( ᐛ 」∠)_
(๑•̀ㅁ•́ฅ)
→_→
୧(๑•̀⌄•́๑)૭
٩(ˊᗜˋ*)و
(ノ°ο°)ノ
(´இ皿இ`)
⌇●﹏●⌇
(ฅ´ω`ฅ)
(╯°A°)╯︵○○○
φ( ̄∇ ̄o)
ヾ(´・ ・`。)ノ"
( ง ᵒ̌皿ᵒ̌)ง⁼³₌₃
(ó﹏ò。)
Σ(っ °Д °;)っ
( ,,´・ω・)ノ"(´っω・`。)
╮(╯▽╰)╭
o(*////▽////*)q
>﹏<
( ๑´•ω•) "(ㆆᴗㆆ)
😂
😀
😅
😊
🙂
🙃
😌
😍
😘
😜
😝
😏
😒
🙄
😳
😡
😔
😫
😱
😭
💩
👻
🙌
🖕
👍
👫
👬
👭
🌚
🌝
🙈
💊
😶
🙏
🍦
🍉
😣
Source: github.com/k4yt3x/flowerhd
颜文字
Emoji
小恐龙
花!
甘城猫猫
上一篇
下一篇