Java个人博客系统项目文档

项目名称

        Java个人博客系统

项目概述

        该博客系统是一个多功能的Java应用程序。该系统支持用户发布新文章、浏览他人文章、管理个人文章收藏和删除不再需要的文章。通过该博客系统，用户可以享受一个安全、便捷的在线写作和阅读体验。

运行环境

• 编程语言：Java SE 22
• 操作系统：Windows 11
• 集成开发环境（IDE）：Eclipse IDE

项目部署

        本项目不包含其它依赖包，无需数据库等。要运行本项目，在Eclipse中打开本项目选择MainApp.java文件，run as 1 Java application即可。

需求分析

用户管理

• 注册功能：

        系统需支持用户注册，用户在注册时必须提供用户名、密码和邮箱信息。系统应验证用户名的唯一性，以防止重复注册。

• 登录功能：

        系统需支持用户登录，通过验证用户名和密码的正确性来确认用户身份。

文章管理

• 发布文章：

        已登录用户应能够发布文章，需要输入文章的标题和内容。

• 查看文章：

        已登录用户应能够查看自己发布的所有文章。

• 编辑文章：

        已登录用户应能够编辑自己发布的文章。

• 删除文章：

        已登录用户应能够删除自己发布的文章。

评论管理

• 发表评论：

        读者可以对文章发表评论，无需登录，只需输入评论内容。

• 查看评论：

        已登录用户应能够查看自己发布文章的所有评论。

• 回复评论：

        已登录用户应能够回复评论，形成评论链。

用户界面

• 控制台操作：

        系统应使用Java控制台进行所有的输入输出操作，不使用前端页面技术。

项目结构

图 1 项目结构图

        基于低耦合和模块化的原则，项目入口文件为MainApp.java，主要流程处理分为ArticleHandler.java、CommentHandler.java以及MenuHandler.java三个文件。其它的模型、服务、工具分别被分到models、services、utils包中。项目结构清晰，易于管理与扩展。

操作指南

启动系统

图 2 博客系统主页

        启动系统后，可以输入数字分别进行注册、登录、浏览文章。选择4可退出博客系统。

用户注册

图 3 用户注册功能

        在博客系统主页，输入1进入注册流程。按要求输入用户名、密码、邮箱进行注册，注册成功直接登录博客系统。格式要求不匹配会输出对应提示并需要重新完整输入。

用户登录

图 4 用户登录功能

        在博客系统主页，输入2进入登录流程。按照注册的用户和密码输入，匹配成功即可登录博客系统。格式与匹配错误都会输出对应提示。

浏览文章

图 5 浏览文章功能

        在博客系统主页，输入3进入浏览。会显示出当前可浏览的所有文章，可以看到文章的标题、作者、点赞数、发布时间、文章具体内容、评论。选择具体文章可以进行点赞、收藏、评论。如果没有可浏览的文章则输出“暂无文章！”

退出系统

图 6 退出系统功能

        在博客系统主页，输入4退出系统，程序结束。

发布文章

图 7 发布文章功能

        已登录用户在用户菜单选择1，可以在该博客系统发布博客。输入文章的标题和内容，就可以发布文章，并查看发布的文章。按回车回到用户菜单。

查看文章

图 8 查看文章功能

        已登录用户在用户菜单选择2，可以在该博客系统查看已发布博客，展示文章的标题、内容、发布时间。

删除文章

图 9 删除文章功能

        已登录用户在用户菜单选择3，可以在该博客系统删除已发布博客，展示用户已发布的所有文章，选择文章的序号即可删除对应文章。误选本选项输入0则返回用户菜单页。

浏览文章

图 10 浏览文章功能

        已登录用户在用户菜单选择5，可以在该博客系统浏览所有用户发布的博客，此功能与博客系统主页功能一样，此处略。

点赞、收藏、评论

图 11 点赞、收藏、评论功能

        已登录用户在用户菜单选择5，再根据序号选择文章，即可对该文章进行点赞、收藏、评论。

图 12 点赞 收藏 评论效果演示

查看收藏的文章

图 13 查看收藏文章功能

        已登录用户在用户菜单选择4，即可查看收藏的所有文章，再选择对应文章序号即可查看对应文章细节。

项目优势

• 项目结构清晰，定义入口文件，模型、服务分离，整体架构易于扩展。
• 项目文件注解清晰，所有类的方法均有清晰注解，项目可读性和可维护性强。
• 项目做了充分的输入检查与错误处理机制，减少崩溃可能，系统稳定性和可靠性强。
• 基于课程内容实现，充分利用面向对象开发的特性，包括Override重写（多态性）等。
• 针对控制台输出做了UI优化和高亮提示，用户体验感舒适。