实现对客户表做增删改查后端部分

实现对客户表做增删改查后端部分

Timber 3,306 2021-06-21

实现对客户表做增删改查后端部分

1.1项目信息

作者：Timber

指导教师：lina

操作系统：Windows 10

开发工具：IntelliJ IDEA 2021.1 x64

1.2项目需求

1.2.1使用MySQL数据库，创建客户表

create table t_customer(

id int primary key auto_increment,

username varchar(200),

jobs varchar(200),

phone varchar(200));

1.2.2使用MySQL中insert语句新增3~5条客户数据到t_customer表中并完成如下功能:

  • 查询所有的客户信息，以列表方式进行显示。
  • 新增客户信息。
  • 根据客户Id修改客户username,jobs,phone.
  • 根据客户Id删除客户

1.3项目结构

实现对客户表做增删改查后端API接口文档

1.1. API V1 接口说明

  • 接口基准地址：http://127.0.0.1:8888/api/customer
  • 服务端已开启 CORS 跨域支持
  • 数据返回格式统一使用 JSON

1.1.1. 支持的请求方法

  • GET（SELECT）：从服务器取出资源（一项或多项）。

  • POST（CREATE）：在服务器新建一个资源。

  • PUT（UPDATE）：在服务器更新资源（客户端提供改变后的完整资源）。

  • DELETE（DELETE）：从服务器删除资源。

    1.1.2. 通用返回状态说明

    状态码含义说明
    200OK请求成功
    400FAILURE请求失败

1.2. 客户管理

1.2.1. 客户列表

  • 请求路径：selectall

  • 请求方法：GET

  • 响应数据说明

    • id：客户ID（Integer）
    • username：用户名（String）
    • jobs：工作（String）
    • phone：电话（String）

  • 响应数据

[
    {
        "id": 1,
        "username": "Timber",
        "jobs": "架构师",
        "phone": "18888888888"
    },
    {
        "id": 2,
        "username": "MinatoAqua",
        "jobs": "VTuber",
        "phone": "14454454455"
    },
    {
        "id": 3,
        "username": "Mea",
        "jobs": "VTuber",
        "phone": "16666666666"
    },
    {
        "id": 4,
        "username": "嘉然今天吃什么",
        "jobs": "VUP",
        "phone": "15555555555"
    },
    {
        "id": 5,
        "username": "安德森少校",
        "jobs": "铁驭（Pilot）",
        "phone": "16666666666"
    }
]

1.2.2. 添加客户

  • 请求路径：add
  • 请求方法：POST
  • 请求参数
参数名参数说明备注
username客户名称不能为空
jobs客户工作不能为空
phone客户电话不能为空
  • 响应参数
参数名参数说明备注
200添加成功
400添加失败
  • 响应数据
200

1.5.3. 根据 ID 查询客户

  • 请求路径：info/:id
  • 请求方法：GET
  • 请求参数
参数名参数说明备注
:id角色 ID不能为空携带在url中
  • 响应参数
参数名参数说明备注
id客户 ID
username客户名称
jobs客户工作
phone客户电话
  • 响应数据
{
    "id": 2,
    "username": "MinatoAqua",
    "jobs": "VTuber",
    "phone": "14454454455"
}

1.5.4. 编辑提交客户

  • 请求路径：update
  • 请求方法：PUT
  • 请求参数
参数名参数说明备注
id客户 ID不能为空
username客户名称不能为空
jobs客户工作不能为空
phone客户电话不能为空
  • 响应数据
200 // 修改成功
400 // 修改失败

1.5.5. 删除客户

  • 请求路径：delete
  • 请求方法：DELETE
  • 请求参数
参数名参数说明备注
:id角色 ID不能为空携带在url中
  • 响应数据
200 // 删除成功
400 // 删除失败
JavaWeb