Skip to content

BlueDriver/questionnaire_online

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

50 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

在线问卷系统

这是个前后端分离的、支持跨域访问的REST风格的Vue.js+Spring Boot项目,开发工具为IDEA,数据库为MySQL。由于当时时间匆忙及能力有限,部分功能实现有待进一步优化,可移步参考我最近整理的SpringBoot 2.x+Maven多模块项目示例进行修改。

前端地址

体验地址

数据库名称:questionnaire

字符集:UTF-8

user表

字段 类型 长度 Null 默认 主键 唯一 说明
id varchar 64 not Y 用户ID
username varchar 64 not 用户昵称
password varchar 64 not md5加密后的密码
email varchar 64 not Y 邮箱
create_time datetime not 用户创建时间
last_login_time datetime null null 用户最后登录时间
status int not 0 用户账号状态
0:未激活
1:已激活
random_code varchar 64 not Y 随机码(用户激活邮箱)

paper表

字段 类型 长度 Null 默认 主键 唯一 说明
id varchar 64 not Y 问卷ID
user_id varchar 64 not 用户ID,外键
title varchar 64 not 问卷标题
create_time datetime not 问卷创建时间
status int not 0 问卷状态
0:未发布
1:已发布
2:已结束
3:已删除
start_time datetime null null 开始时间
end_time datetime null null 截止时间

question表

字段 类型 长度 Null 默认 主键 唯一 说明
id varchar 64 not Y 问题ID
paper_id varchar 64 not 问卷ID,外键
create_time datetime not 问题创建时间
question_type int not 问题类型
1:单选
2:多选
3:简答
question_title varchar 128 not 问题标题
question_option varchar 512 not 问题选项
1:选择题,数组字符串
[option1,option2,option3...]
2:简答题,空数组字符串
[]

answer表

字段 类型 长度 Null 默认 主键 唯一 说明
id varchar 64 not Y 答案ID
paper_id varchar 64 not 问卷ID,外键
question_id varchar 64 not 问题ID,外键
question_type int not 问题类型
1:单选
2:多选
3:简答
create_time datetime not 答题时间
answer_option varchar 512 not 答题选项
1:选择题,来自question表的问题选项,单选题只有一个option,多选至少一个
[option1,option2,option3...]
2:简答题,至多一个元素的数组字符串
["只能有一个元素"]
若未达,则无元素
[]

API

编码方式均为UTF-8

1.管理员相关

1.1 注册

接口地址

domain/api/v1/register

请求方式

HTTP POST

请求示例

{
  "username": "Alice",
  "password": "123456",
  "email": "alice@gmail.com"
}

请求参数

参数 类型 是否必须 取值范围 说明
username String Y 2-64个字符 用户名(昵称)
password String Y 6-64个字符 登录密码
email String Y 5-64个字符且格式正确 邮箱

返回参数

返回示例

{
  "code": 0,
  "msg": "ok",
  "data": 0
}

参数说明

参数 类型 是否必须 取值范围 说明
code int Y - 请求状态码
msg String Y - 消息提示
data int N - 结果数据

code说明

状态值 说明
-1 token失效或未登录(用于需要登录后才能进行的操作)
0 请求成功(全文适用,下文不再赘述)
1 系统异常(全文适用,下文不再赘述)
2 参数不正确(全文适用,下文不再赘述)

code的补充

  • code非0时,无data参数,可通过msg判断问题原因
  • code取0时,若data中有值,则data参数存在,否则无data参数

data说明

状态值 说明
0 注册成功,等待邮件激活
1 邮箱已被注册过且被激活
2 邮箱被注册过,但未激活,重新发送激活邮件

1.2 激活

接口地址

domain/api/v1/activate

请求方式

HTTP GET 请求示例

domain/api/v1/activate/code

请求参数

参数 类型 是否必须 取值范围 说明
code String Y - 激活码(即随机码)

返回参数

说明

  1. 若激活成功,跳转success页面
  2. 若激活码已失效,跳转invalid页面

1.3 登录

接口地址

domain/api/v1/login

请求方式

HTTP POST

请求示例

{  
  "email": "alice@gmail.com",
  "password": "123456"  
}

请求参数

参数 类型 是否必须 取值范围 说明
email String Y 5-64个字符 邮箱
password String Y 6-64个字符 登录密码

返回参数

返回示例

//登录成功
{
  "code": 0,
  "msg": "ok",
  "data": {
    "result": 0,
    "token": "abcdefghijkl12345",
    "username": "Alice",
    "email": "abc@gmail.com
  }
}
//登录失败
{
  "code": 0,
  "msg": "password error",
  "data": {
    "result": 1
  }
}

参数说明

参数 类型 是否必须 取值范围 说明
code int Y - 请求状态码
msg String Y - 消息提示
data Object N - 结果

data说明

参数 类型 是否必须 取值范围 说明
result int Y - 结果
token String N - 登陆成功后用于身份识别,凡请求的URL中含admin都需要将token放入请求header
username String N - 昵称
email String N - 邮箱

result说明

取值 说明
0 登录成功
1 密码错误
2 用户不存在
3 账号未激活

header使用token示例

    ...
    headers: {'token': token }
    ...

1.4 退出登录

接口地址

domain/api/v1/admin/logout

请求方式

HTTP GET

请求示例

请求参数

返回参数

返回示例

{
  "code": 0,
  "msg": "ok",
  "data": 0
}

参数说明

参数 类型 是否必须 取值范围 说明
code int Y - 请求状态码
msg String Y - 消息提示
data int N - 结果:0.退出成功,1.失败(未登录或登录已超时)

2.问卷相关

2.1 管理员获取问卷列表

接口地址

domain/api/v1/admin/paper-lists

请求方式

HTTP GET

请求示例

请求参数

返回参数

返回示例

//成功
{
  "code": 0,
  "msg": "ok",
  "data": [
    {"id": "12345678910","title": "问卷", "status": 0, "createTime": 1536887397173, "startTime": "2018-09-20", "endTime": "2018-10-01"},
    {"id": "22345678910","title": "问卷标题", "status": 1, "createTime": 1536887397666, "startTime": "2018-09-10", "endTime": "2018-10-01"},
    {"id": "32345678910","title": "问题", "status": 2, "createTime": 1536887397888, "startTime": "2018-09-10", "endTime": "2018-09-12"},
    {"id": "42345678910","title": "标题", "status": 0, "createTime": 1536887397173, "startTime": "", "endTime": ""}
  ]
}
//失败
{ 
  "code": 1,
  "msg": "server exception"
}
//token过期或未登录,下同
{ 
  "code": -1,
  "msg": "token expired or not login",
}

参数说明

参数 类型 是否必须 取值范围 说明
id String Y - 问卷ID
title String Y - 问卷标题
status int Y - 问卷状态:0.未发布,1.已发布,2.已结束
createTime long Y - 问卷创建时的时间戳
startTime String Y - 问卷开达日期,若未设置则是空字符串
endTime String Y - 问卷结束日期,若未设置则是空字符串

2.2 查看问卷

接口地址

domain/api/v1/admin/view-paper

请求方式

HTTP POST

请求示例

{
  "id": "4askfj1093jfi9348oueir932"
}

请求参数

参数 类型 是否必须 取值范围 说明
id String Y - 问卷id

返回参数

返回示例

{
  "code": 0,
  "msg": "ok",
  "data": {
   "id": "4askfj1093jfi9348oueir932",
   "title": "你幸福吗的调查",
   "status": 0,
   "createTime": 1536887397173,
   "startTime": "2018-09-12",
   "endTime": "2018-10-01",   
   "questions": [
      {"id": "1234", "questionType":1, "questionTitle": "你的收入是多少?", "questionOption": ["2000以下", "2000-5000", "5000+"]},
      {"id": "2234", "questionType":2, "questionTitle": "你家里有哪些家电?", "questionOption": ["冰箱", "洗衣机", "空调", "麻将机"]},
      {"id": "3234", "questionType":3, "questionTitle": "说一说你觉得最幸福的事", "questionOption": []}
    ]
   }
}

data参数说明

参数 类型 是否必须 取值范围 说明
id String Y - 问卷ID
title String Y - 问卷标题
status int Y - 问卷状态:0.未发布,1.已发布,2.已结束
createTime long Y - 问卷创建时的时间戳
startTime String Y - 问卷开达日期,若未设置则是空字符串
endTime String Y - 问卷结束日期,若未设置则是空字符串
questions Array Y - 问题列表

questions参数说明

参数 类型 是否必须 取值范围 说明
id String Y - 问题ID
questionType int Y - 问题类型:1.单选题,2.多选题,3.简答题
questionTitle String Y - 问题标题
questionOption Array Y - 问题选项:简答题为空的Array

2.3 新增问卷

接口地址

//与更新问卷共用接口
domain/api/v1/admin/update-paper

请求方式

HTTP POST

请求示例

{
  "title": "你幸福吗的调查",
  "startTime": "2018-09-12",
  "endTime": "2018-10-01",
  "status": 0,
  "questions": [
      {"questionType":1, "questionTitle": "你的收入是多少?", "questionOption": ["2000以下", "2000-5000", "5000+"]},
      {"questionType":2, "questionTitle": "你家里有哪些家电?", "questionOption": ["冰箱", "洗衣机", "空调", "麻将机"]},
      {"questionType":3, "questionTitle": "说一说你觉得最幸福的事", "questionOption": []}
  ]
}

请求参数

参数 类型 是否必须 取值范围 说明
title String Y 2-64个字符 问卷名称
startTime String Y 10个字符 开始日期,若未设置则是空字符串
endTime String Y 10个字符 结束日期,若未设置则是空字符串
status int Y 0或1 问卷状态,0:不发布仅保存;1:发布(此时start_time和end_time必须有合法取值);

questions参数说明

参数 类型 是否必须 取值范围 说明
questionType int Y - 问题类型:1.单选题,2.多选题,3.简答题
questionTitle String Y 1-128字符 问题标题
questionOption Array Y - 问题选项, 是选择题则至少有两个元素,简答题无元素

返回参数

返回示例

{
  "code": 0,
  "msg": "ok",
  "data": 0
}

参数说明

参数 类型 是否必须 取值范围 说明
code int Y - -1.token失效或未登录,0.请求成功,1.系统异常
msg String Y - 提示消息
data int N - 0.成功

2.4 修改问卷

接口地址

//与新增问卷共用接口,仅多一个参数id
domain/api/v1/admin/update-paper

请求方式

HTTP POST

请求示例

//页面中的数据来自view-paper接口,若管理员选择更新,则删除原id的paper的问题,再为该id的paper插入questions的新题目
{
   "id": "4askfj1093jfi9348oueir932",   //在add-paper中无此参数
   "title": "你幸福吗的调查",
   "status": 0,
   "startTime": "2018-09-12",
   "endTime": "2018-10-01",   
   "questions": [
      {"questionType":1, "questionTitle": "你的收入是多少?", "questionOption": ["2000以下", "2000-5000", "5000+"]},
      {"questionType":2, "questionTitle": "你家里有哪些家电?", "questionOption": ["冰箱", "洗衣机", "空调", "麻将机"]},
      {"questionType":3, "questionTitle": "说一说你觉得最幸福的事", "questionOption": []}
    ]
   }
}

请求参数

参数说明

参数 类型 是否必须 取值范围 说明
id String Y - 问卷ID
title String Y - 问卷标题
status int Y - 问卷状态:0.未发布,1.发布
startTime String Y - 问卷开达日期,若未设置则是空字符串
endTime String Y - 问卷结束日期,若未设置则是空字符串
questions Array Y - 问题列表

questions参数说明

参数 类型 是否必须 取值范围 说明
questionType int Y - 问题类型:1.单选题,2.多选题,3.简答题
questionTitle String Y - 问题标题
questionOption Array Y - 问题选项, 是选择题则至少有两个元素,简答题无元素

返回参数

返回示例

{
    "code": 0,
    "msg": "ok",
    "data": 0
}

data参数说明

参数 类型 是否必须 取值范围 说明
data int Y - 0.操作成功,1.操作失败,2.paper的id非法(无此问卷)

2.5 删除问卷

接口地址

domain/api/v1/admin/delete-paper

请求方式

HTTP POST

请求示例

{
  "idList": ["4askfj1093jfi9348oueir932", "sfs6f465vfsdf65sf654s6sf"]
}

请求参数

参数 类型 是否必须 取值范围 说明
idList Array Y - 问卷id列表,至少一个元素

返回参数

返回示例

{
  "code": 0,
  "msg": "ok",
  "data": 0
}

data参数说明

参数 类型 是否必须 取值范围 说明
data int Y - 0.操作成功,1.操作失败,2.paper的id非法(无此问卷)

2.6 用户查看问卷(答卷页面)

接口地址

domain/api/v1/user/view-paper?id=4askfj1093jfi9348oueir932

请求方式

HTTP GET

请求示例

请求参数

参数 类型 是否必须 取值范围 说明
id String Y - 问卷id

返回参数

返回示例

{
  "code": 0,
  "msg": "ok",
  "data": {
   "status": 0,     //只有status为1时才可作答
   "id": "4askfj1093jfi9348oueir932",
   "title": "你幸福吗的调查",   
   "createTime": 1536887397173,
   "startTime": "2018-09-12",
   "endTime": "2018-10-01",
   "questions": [
      {"id": "1234", "questionType":1, "questionTitle": "你的收入是多少?", "questionOption": ["2000以下", "2000-5000", "5000+"]},
      {"id": "2234", "questionType":2, "questionTitle": "你家里有哪些家电?", "questionOption": ["冰箱", "洗衣机", "空调", "麻将机"]},
      {"id": "3234", "questionType":3, "questionTitle": "说一说你觉得最幸福的事", "questionOption": []}
    ]
   }
}

data参数说明

参数 类型 是否必须 取值范围 说明
status int Y - 问卷状态:0.未发布,1.发布中(可作答),2.已结束,3.无此问卷,4.已发布但未到开始时间
id String N - 问卷ID
title String N - 问卷标题
createTime long N - 问卷创建时的时间戳
startTime String N - 问卷开达日期,若未设置则是空字符串
endTime String N - 问卷结束日期,若未设置则是空字符串
questions Array N - 问题列表

questions参数说明

参数 类型 是否必须 取值范围 说明
id String Y - 问题ID
questionType int Y - 问题类型:1.单选题,2.多选题,3.简答题
questionTitle String Y - 问题标题
questionOption Array Y - 问题选项, 是选择题则至少有两个元素,简答题无元素

补充说明

  1. status为必须参数
  2. 若status为0或3,则data中除status外无其他参数
  3. 若status为1,data中包含全部参数,用户可正常作答
  4. 若status为2或4,data中只包含title、startTime、endTime,用于提示用户

2.7 提交问卷答案

接口地址

domain/api/v1/user/commit-paper

请求方式

HTTP POST

请求示例

//页面中的数据来自view-paper接口
{
   "id": "4askfj1093jfi9348oueir932",
   "answers": [
      {"id": "1234", "questionType":1,  "answerContent": ["2000-5000"]},  //单选题,Array中仅一个元素
      {"id": "2234", "questionType":2,  "answerContent": ["空调", "麻将机"]},  //多选,Array中至少一个元素
      {"id": "3234", "questionType":3,  "answerContent": ["上了王者"]}  //简答
    ]
   }
}

请求参数

参数 类型 是否必须 取值范围 说明
id String Y - 问卷ID
answers Array Y - 答案列表

answers参数说明

参数 类型 是否必须 取值范围 说明
id String Y - 问题id
questionType int Y - 问题类型:1.单选,2.多选,3.简答
answerContent - Y 0-512字符 答题选项, 是选择题则至少有一个元素,简答题最多一个元素(不答则为无元素)

返回参数

返回示例

{
    "code": 0,
    "msg": "ok"
}

data参数说明

参数 类型 是否必须 取值范围 说明
code int Y - 0.操作成功,1.操作失败,2.问卷id无效

2.8 查看问卷数据

接口地址

domain/api/v1/admin/paper-data

请求方式

HTTP POST

请求示例

{
  "id": "4askfj1093jfi9348oueir932"
}

请求参数

参数 类型 是否必须 取值范围 说明
id String Y - 问卷id

返回参数

返回示例

{
  "code": 0,
  "msg": "ok",
  "data": {
   "id": "4askfj1093jfi9348oueir932",
   "title": "你幸福吗的调查",
   "status": 0,
   "createTime": 1536887397173,
   "startTime": "2018-09-12",
   "endTime": "2018-10-01",   
   "totalCount": 140,
   "questions": [
      {
           "id": "1234", "questionType":1, 
           "questionTitle": "你的收入是多少?", 
           "questionOption": ["2000以下", "2000-5000", "5000+"],
           "answerContent": [10, 30, 100]
      },
      {    
           "id": "2234", "questionType":2, 
           "questionTitle": "你家里有哪些家电?", 
           "questionOption": ["冰箱", "洗衣机", "空调", "麻将机"],
           "answerContent": [30, 40, 80, 20]
      },
      {   
           "id": "3234", "questionType":3, 
           "questionTitle": "说一说你觉得最幸福的事", 
           "questionOption": [],
           "answerContent": [
               "从青铜",
               "到黄金",
               "到王者"              
           ]
      },
      {   
          "id": "4234", "questionType":3, 
          "questionTitle": "说一说你觉得最难过的事", 
          "questionOption": [],
          "answerContent": [
              "从王者",               
              "到青铜" 
          ]
      }
    ]
   }
}

data参数说明

参数 类型 是否必须 取值范围 说明
id String Y - 问卷ID
title String Y - 问卷标题
status int Y - 问卷状态:0.未发布,1.已发布,2.已结束
createTime long Y - 问卷创建时的时间戳
startTime String Y - 问卷开达日期,若未设置则是空字符串
endTime String Y - 问卷结束日期,若未设置则是空字符串
totalCount int Y - 问卷被达总次数(人次)
questions Array Y - 问题列表

questions参数说明

参数 类型 是否必须 取值范围 说明
id String Y - 问题ID
questionType int Y - 问题类型:1.单选题,2.多选题,3.简答题
questionTitle String Y - 问题标题
questionOption Array Y - 问题选项,选择题是Array,简答题为空字符串
answerContent Array Y - 答案内容,选择题中的元素为int,简答题为String

2.9 下载问卷模板文件

文件地址

domain/template.xls

使用方式

<a href="url">下载模板</a>

2.10 上传问卷模板文件生成问卷

接口地址

domain/api/v1/admin/upload

请求方式

HTTP POST

请求示例

{
   "file": FILE    //文件
}

请求参数

参数 类型 是否必须 取值范围 说明
file FILE Y - 文件模板文件(Excel)

返回参数

返回示例

{
    "code": 0,
    "msg": "ok"
}

data参数说明

参数 类型 是否必须 取值范围 说明
code int Y - 0.操作成功,1.系统异常,2.文件不合法

常见返回值情形

code msg
-1 账号未登录或登录已经失效
0 ok
1 异常的具体信息
2 未选择文件!
2 文件类型不支持!
2 文件大小限制在100KB以内!
2 文件转换失败,请注意格式要求!

About

springboot+mybatis在线问卷系统

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published