web课程设计说明书

Web程序设计说明书

姓名LL

专业计算机科学与技术

考号0901051319

1需求分析

1.1 功能需求

本系统实现如下功能：

1.用户管理

a)用户分为管理员和普通用户

b)普通用户拥有创建并管理书架、上传并管理图书，评论、收藏、举

报图书等功能。

c)管理员除了拥有普通用户的所有功能外，还可以管理系统图书分

类、举报信息和用户信息。

d)管理员登录后，可以在管理中心中封锁、解锁用户。

2.分类管理

a)添加分类：管理员可以添加小说分类，分类不可以重名。

b)修改分类：管理员可以修改分类的名字，分类不可以重名。

c)删除分类：管理员可以删除分类，当分类下有小说存在时，无法成

功删除分类。

3.书架管理

a)添加书架：用户登录后可以添加书架，书架的名字可以重名。

b)修改书架：用户登录后可以修改自己创建的书架，书架名字可以重

名。

c)删除书架：用户登录后可以删除自己创建的书架，当书架下有小说

存在时，无法成功删除书架。

d)订阅书架：用户登录后可以订阅网站上的任意一个书架。

4.小说管理

a)上传小说：用户登录后可以上传TXT格式的小说，小说不得大于

5M，并且需要有固定格式的章节信息，比如“第X卷第X章

XXXX”。小说上传成功后会自动生成小说章节索引，方便用户按

章节阅读小说。如果上传小说时用户没有指定小说摘要，则会自动

以小说前六章的章节标题组成摘要。

b)修改小说：用户登录后可以修改自己上传的小说信息，更改小说的

所属分类和书架等信息。

c)删除小说：用户登录后可以删除自己上传的小说，小说删除时，会

连带删除小说的评论等信息。

d)收藏小说：用户登录后可以收藏网站上的任意一部小说。

e)举报小说：用户可以举报自己认为有不良信息或者不合法信息的小

说，管理员会及时处理举报信息。

f)评论小说：用户登录后可以对网站上的任意一部小说发表评论。

5.统计信息

a)统计小说阅读量：网站会对小说的阅读次数进行统计，以作为热门

小说的排名依据。

b)统计小说评论量：网站会对小说的评论次数进行统计，以作为热门

小说的排名依据。

c)统计小说收藏量：网站会对小说的收藏次数进行统计，以作为热门

小说的排名依据。

d)统计书架小说数：网站会对各个书架中小说的数量进行统计。

e)统计分类小说数：网站会对各个分类中小说的数量进行统计。

1.2 数据库需求分析

不管对数据库设计还是对系统设计来说，需求分析都是第一步。需求的目的就是搞清楚用户要做什么，如果需求做的仔细，可以在后面的设计和实现中少做很多无用功，其重要性是不言自明的。做需求分析需要有点心理学的知识，要能充分的跟客户进行交流，能抓住问题的关键所在，最终能够快速的搞清楚系统所要实现的业务。

需求分析的方法在软件工程中都有说明，不管哪种方法，最重要的都是与用户的沟通和交流，引导用户正确的确认问题。用户需求具体体现在各种信息的提供、保存、更新和查询，这就要求数据库结构能充分满足各种信息的输出和输入。

根据用户的需求设计数据库如下：

用户：编号，邮箱，昵称，密码，头像，角色，注册日期，状态，书架数，小说数。

分类：编号，名称，小说数。

小说：编号，书名，作者，大小，细节，状态，分类编号，书架编号，文件路径，上传日期，上传用户，阅读量，评论量，收藏量。

书架：编号，名称，创建者，创建日期，小说数。

3 数据库设计

3.1 数据库概念结构设计

在需求分析的基础上，设计出能够满足用户需求的各种实体以及它们之间的关系，现将各实体及实体之间的E-R 图描述如下：

（1）分类实体：

分类

分类名称

分类编号

图3.2 分类实体图

（2）用户实体：

用户

用户邮箱

用户编号

用户角色

用户头像

注册日期

用户密码

用户昵称

用户状态

图3.3 用户实体图

（3）书架实体：

书架

书架名称

书架编号

图3.4 书架实体图

（4）小说实体：

小说

小说名称

小说编号小说作者

小说大小

小说细节

小说状态

文件路径

上传日期

、

图3.5 小说实体图

（5）总体ER 图：

小说IP 地址

分类用户

书架

评论

阅读

举报

收藏

创建

m

n

内容

日期

n m

n m

理由

m

n 进度

1

n

日期

从属n 1从属1n 日期

图3-6 ER 图总图

3.2 数据库逻辑结构设计

现在把数据库概念设计的E-R 图转化为关系数据。在关系数据库中，数据

关系由数据表组成的，而表的结构体现在表的字段上。具体为：确定数据库中数据表的组成；确定数据表中字段的构成，主键字段和有关字段的约束条件；依据表中主键字段建立数据表之间的关系。数据的合理性问题：数据表内记录不重复；数据字段不可分割，具有最小数据单位的特点；数据表内字段或字段之间互不依赖。具体结构如下图所示：

1. 用户表

表3-1 用户表

字段名 标识 字段类型 长度 约束条件 可否为空

user_id 用户编号 Integer 30 PK N user_email 用户邮箱 Varchar 199 唯一 N user_name 用户昵称 Varchar 20 N user_pass 用户密码 Varchar 64 N user_devil 用户头像 Varchar 100 Y user_role

用户角色

Enum

N

user_reg_date 用户注册日期Timestamp N user_status 用户状态Integer 10 N user_shelf_count 用户书架数量Integer 10 N user_book_count 用户小说数量Integer 10 N

2. 分类表

表3-2 小说分类表

字段名标识字段类型长度约束条件可否为空cate_id 类别编号Integer 30 PK N cate_name 类别名称Varchar 20 唯一N cate_book_count 小说数量Integer 30 N

3.小说表

表3-3 小说表

字段名标识字段类型长度约束条件可否为空book_id 小说编号Integer 30 PK N

book_name 小说名称Varchar 100 N book_author 小说作者Varchar 20 N

book_size 小说大小Integer 30 N

book_detail 小说细节TEXT Y

Book_desc 小说描述Varchar 200 Y

book_status 小说状态Integer 10 N

book_cate 小说分类Integer 30 FK N

book_shelf 所属书架Integer 30 FK N book_upload_file 小说文件Varchar 100 N book_upload_date 上传日期Timestamp N book_upload_user 上传者Integer 30 FK N book_read_count 阅读量Integer 30 N

book_comment_count 评论量Integer 30 N book_starred_count 收藏量Integer 30 N

4.书架表

表3-4 书架表

字段名标识字段类型长度约束条件可否为空shelf_id 书架编号Integer 30 Pk N

shelf_name 书架名称Varchar 50 N shelf_creation_user 创建者Integer 30 FK N shelf_creation_date 创建日期Timestamp N shelf_book_count 小说数Integer 10 N

5.书架订阅表

表3-5 书架订阅表

字段名标识字段类型长度约束条件可否为空id 订阅编号Integer 30 PK N shelf_id 书架编号Integer 30 FK N

user_id 用户编号Integer 30 FK N

6.小说评论表

表3-6 小说评论表

字段名标识字段类型长度约束条件可否为空comment_id 评论编号Integer 30 PK N comment_ip 用户IP Varchar 15 N comment_book 小说编号Integer 30 N comment_parent 回复评论Integer 30 FK Y comment_author 用户编号Integer 30 FK N comment_content 评论内容Varchar 1000 N

comment_date 评论时间Timestamp N

7.小说收藏表

表3-7 小说收藏表

字段名标识字段类型长度约束条件可否为空Id 收藏编号Integer 30 Pk N book_id_ip 小说编号Integer 30 FK N user_id 用户编号Integer 30 FK N

8.小说举报表

表3-8 小说举报表

字段名标识字段类型长度约束条件可否为空report_id 举报编号Integer 30 PK N report_book 小说编号Integer 30 FK N user_id 用户编号Integer 30 FK N report_evidence 举报原因Varchar 1000 N report_date 举报日期Timestamp N

9小说阅读表

表3-9阅读表

字段名标识字段类型长度约束条件可否为空read_id 阅读编号Integer 30 PK N read_book 小说编号Integer 30 FK N read_user 用户编号Integer 30 FK N read_detail 阅读进度Varchar 1000 N

4界面描述和代码实现

4.1用户管理

用户管理模块主要包括用户注册、登录及信息修改。

(1) 用户注册：用户填写注册信息并通过校验后可以成功注册成为会员，

其中邮箱作为登录名，不能重复。

图4-1 用户注册页面

以Ajax的方式进行注册校验，成功后方才跳转页面，如果出错，则在不刷新的情况下在当前页面提示错误信息。

public String signup() throws Exception {

result = new HashMap();

Map errors = new HashMap();

// Validate email address

if (!ValidatorUtil.validEmail(user.getEmail())) {

errors.put("user.email", "邮箱格式不正确");

// If the email has been taken

} else if (userDao.findByEmail(user.getEmail()) != null) {

errors.put("user.email", "邮箱已经被占用");

}

// Validate username

if (!ValidatorUtil.validUsername(user.getName())) {

errors.put("https://www.360docs.net/doc/cb9222462.html,", "用户名格式不正确");

// Validate password

if (!ValidatorUtil.validPassword(user.getPass()))

errors.put("user.pass", "密码格式不正确");

}

https://www.360docs.net/doc/cb9222462.html,(String.format("signing up user[name=%s, email=%s]",

user.getName(), user.getEmail()));

// Add the user

if (!errors.isEmpty()) {

result.put("approved", false);

result.put("message", "注册失败，请检查注册信息是否填写正确");

result.put("errors", errors);

} else if (!userDao.insert(user)) {

result.put("approved", false);

result.put("message", "注册失败，服务器正忙，请稍后再试");

} else {

result.put("approved", true);

result.put("message", "注册成功，正在中转页面");

}

return SUCCESS;

}

(2) 用户登录：用户填写登录信息后点击登录，进行Ajax校验，成功后跳

转到个人页面。

图4-2 用户登录页面

用户登录的前台相关代码：

/**

* Script to implement user related works, such as signin, signup, validation and.. *

* @author GreatGhoul

* @version 1.0 2010-04-25 22:35

* @require

* : jquery.1.3.2.min.js

* : status-1.0.3.js

*/

$(function() {

var signupForm = $('#signup-form');

var signinForm = $('#signin-form');

function signup() {

$.ajax({

url: 'dosignup.do',

data: signupForm.serialize(),

type: 'POST',

dataType: 'json',

error: function() {

signupForm.lock(false, '注册失败，请检查您的网络连接');

},

success: function(data) {

signupForm.lock(false, data.result.message);

if (data.result.approved) {

setTimeout(function() {

window.location = 'signin.do';

}, 3000);

} else {

signupForm.errs(data.result.errors);

}

}

});

signupForm.lock(true, '正在提交注册信息...');

return false;

}

function signin() {

$.ajax({

url: 'dosignin.do',

data: signinForm.serialize(),

type: 'POST',

dataType: 'json',

error: function() {

signinForm.lock(false, '登录失败，请检查您的网络连接');

},

success: function(data) {

signinForm.lock(false, data.result.message);

if (data.result.approved) {

setTimeout(function() {

window.location = 'home.do';

}, 1000);

}

}

});

signinForm.lock(true, '正在提交注册信息...');

return false;

}

signupForm.submit(signup);

signinForm.submit(signin);

});

(3) 用户信息修改：提供原始密码后，用户可以修改昵称或者使用新的密

码。

图4.3 用户信息修改页面

4.2 分类管理

管理员有权利对系统的小说分类管理，小说的分类名不能重复。管理员可以添加分类、修改分类、删除分类，要删除含有小说的分类，需要先转移分类中的小说，否则不能成功删除分类。

图4-4 分类管理页面

以下这段代码用于更新分类，用于返回更新信息的JSON格式的结构是固定的，在书架，小说管理中都遵循这一格式，统一了操作接口。

public String update() {

https://www.360docs.net/doc/cb9222462.html,(String.format("updating cate[id=%d] ==> cate[name=%s]",

cate.getId(), cate.getName()));

result = new HashMap();

List errors = new ArrayList();

result.put("approved", false);

result.put("message", "更新分类失败");

if (cate == null || cate.getId() == null) {

errors.add("分类不存在");

} else if (!ValidatorUtil.validCateName(cate.getName())) {

errors.add("分类名的长度应该在1到20个字体之间，不能含有空格");

} else {

Cate cate1 = cateDao.findById(cate.getId());

if (cate1 == null) {

errors.add("要修改的分类不存在");

} else if (cate1.getName().equals(cate.getName())) {