接口地址: http://192.168.1.2:2000

人员管理

添加人员

  • 接口地址：/user
  • 请求方式：POST

  • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | token | String | | Header | 是 | | name | String | | body | 否 | | libraryCardNum | String | 借书证号，必须唯一 | body | 是 | | userAge | Int | | body | 否 | | sex | String | 0是男，1是女 | body | 否 | | password | String | | body | 是 | | role | Int | 0是管理员，1是普通用户 | body | 是 |

  • 返回结果

    1. {
    2. "message": "添加用户成功",
    3. "data": null
    4. }

更新用户

  • 接口地址：/user
  • 请求方式：PUT

  • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | name | String | | body | 否 | | libraryCardNum | String | 借书证号，必须唯一 | body | 是 | | userAge | Int | | body | 否 | | sex | String | 0是男，1是女 | body | 否 | | password | String | | body | 是 | | role | Int | 0是管理员，1是普通用户 | body | 是 |

  • 返回结果

    1. {
    2. "message": "更新成功",
    3. "data": null
    4. }

    查询所有用户

  • 接口地址：/user

  • 请求方式：GET

  • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | token | String | | Header | 是 | | name | String | 用户姓名 | Params | 否 | | libraryCardNum | String | 借书证号 | Params | 否 |

  • 返回结果

    1. {
    2. "message": "查询用户成功",
    3. "data": [
    4.    {
    5.        "id": 1,
    6.        "name": "李华",
    7.        "libraryCardNum": "123456789",
    8.        "libraryCardExpire": "2022-03-03T11:00:00",
    9.        "userAge": 12,
    10.        "sex": "0",
    11.        "password": "123456789",
    12.        "role": 1,
    13.        "borrowingRecords": null
    14.    },
    15.    {
    16.        "id": 2,
    17.        "name": "管理员1",
    18.        "libraryCardNum": "admin",
    19.        "libraryCardExpire": "2022-06-01T11:00:00",
    20.        "userAge": 33,
    21.        "sex": 0,
    22.        "password": "123456",
    23.        "role": 0,
    24.        "borrowingRecords": null
    25.    }
    26. ]
    27. }

删除用户

  • 接口地址：/user
  • 请求方式：DELETE

  • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | token | String | | Header | 是 | | userId | Int | 用户ID | Params | 是 |

  • 返回结果

    1. {
    2. "message": "删除用户成功",
    3. "data": null
    4. }

用户登录

  • 接口地址：/user/login
  • 请求方式：POST
  • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | libraryCardNum | String | 借书证号(唯一) | body | 是 | | password | String | 密码 | body | 是 |

用户退出

  • 接口地址：/user/logout
  • 请求方式：POST

  • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | token | String |
    | Header | 是 |

  • 返回结果

    1. {
    2. "message": "退出成功",
    3. "data": null
    4. }

    获取用户信息

  • 接口地址：/user/getOneUser

  • 请求方式：POST

  • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | token | String |
    | Header | 是 |

  • 返回结果

    1. {
    2. "message": "查询成功",
    3. "data": {
    4.    "id": 1,
    5.    "name": "李华",
    6.    "libraryCardNum": "123456789",
    7.    "libraryCardExpire": "2022-03-03T11:00:00",
    8.    "userAge": 12,
    9.    "sex": 0,
    10.    "password": "123456789",
    11.    "role": 1,
    12.    "borrowingRecords": null
    13. }
    14. }

    图书管理

    添加图书

  • 接口地址：/library

  • 请求方式：POST

  • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | token | String |
    | Header | 是 | | bookName | String | 书名 | body | 是 | | author | String | 作者 | body | 否 | | publisher | String | 出版社 | body | 否 | | language | String | 语言 | body | 否 |

  • 返回结果

    1. {
    2. "message": "添加图书成功",
    3. "data": null
    4. }

查询所有图书

  • 接口地址：/library
  • 请求方式：GET

  • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | publisher | String | 出版社 | Params | 否 | | bookName | String | 书名 | Params | 否 | | author | String | 作者 | Params | 否 |

  • 返回结果

    1. {
    2. "message": "查询图书列表成功",
    3. "data": [
    4.    {
    5.        "bid": 1,
    6.        "bookName": "平凡的世界",
    7.        "bookNum": null,
    8.        "author": "路遥",
    9.        "publisher": "清华大学出版社",
    10.        "publishDate": "2020-01-01",
    11.        "status": 0, // 未借阅,已借出,已损坏, // 0,1,2
    12.        "language": "中文"
    13.    },
    14.    {
    15.        "bid": 2,
    16.        "bookName": "计算机网络",
    17.        "bookNum": null,
    18.        "author": "谢希仁",
    19.        "publisher": "电子工业出版社",
    20.        "publishDate": "2021-06-01",
    21.        "status": 0,
    22.        "language": "中文"
    23.    },
    24.    {
    25.        "bid": 4,
    26.        "bookName": "操作系统",
    27.        "bookNum": null,
    28.        "author": "沈晓红",
    29.        "publisher": "电子工业出版社",
    30.        "publishDate": "2020-11-11",
    31.        "status": 0,
    32.        "language": "中文"
    33.    },
    34.    {
    35.        "bid": 1050726403,
    36.        "bookName": "计算机网络3",
    37.        "bookNum": null,
    38.        "author": "谢希仁",
    39.        "publisher": "电子工业出版社",
    40.        "publishDate": "2022-05-05",
    41.        "status": 0,
    42.        "language": "中文"
    43.    },
    44.    {
    45.        "bid": 1050726404,
    46.        "bookName": "计算机网络4",
    47.        "bookNum": null,
    48.        "author": "谢希仁",
    49.        "publisher": "电子工业出版社",
    50.        "publishDate": null,
    51.        "status": 0,
    52.        "language": "中文"
    53.    },
    54.    {
    55.        "bid": 1050726405,
    56.        "bookName": "计算机网络5",
    57.        "bookNum": null,
    58.        "author": null,
    59.        "publisher": null,
    60.        "publishDate": null,
    61.        "status": 0,
    62.        "language": null
    63.    }
    64. ]
    65. }

查询图书数量

  • 接口地址：/library/num
  • 请求方式：POST

  • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | bookName | String | 书名 | Params | 是 |

  • 返回结果

    {
"message": "查询成功",
"data": 1
}

更新某一本书

  • 接口地址：/library
  • 请求方式：PUT

  • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | token | String |
    | Header | 是 | | bid | Int | 书ID | body | 是 | | bookName | String | 书名 | body | 是 | | author | String | 作者 | body | 否 | | publisher | String | 出版社 | body | 否 | | publishDate | LocalDate | 发布时间 | body | 否 | | language | String | 语言 | body | 否 |

  • 返回结果

    {
"message": "更新成功",
"data": null
}

删除某一本书

  • 接口地址：/library
  • 请求方式：DELETE

  • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | token | String | | Header | 是 | | bookId | Int | 书ID | Params | 是 |

  • 返回结果

    {
"message": "删除成功",
"data": null
}

查询用户借阅记录

查询用户借阅记录

  • 接口地址：/user/book
  • 请求方式：GET

  • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | libraryCardNum | String | 借书证号 | Params | 是 | | borrowBookStatus | Int | 借书状态 | Params | 否 |

  • 返回结果

    {
"message": "查询成功",
"data": [
   {
       "id": 11,
       "userId": 2,
       "bookId": 1,
       "borrowBooksTime": "2022-05-06T16:32:22",
       "library": [
           {
               "bid": 1,
               "bookName": "平凡的世界",
               "bookNum": null,
               "author": null,
               "publisher": null,
               "publishDate": null,
               "borrowBookStatus": null,
               "language": null
           }
       ],
       "borrowBookStatus": 0,
       "returnBooksTime": "2022-05-06T16:57:25"
   },
   {
       "id": 12,
       "userId": 2,
       "bookId": 4,
       "borrowBooksTime": "2022-05-06T16:55:47",
       "library": [
           {
               "bid": 4,
               "bookName": "操作系统",
               "bookNum": null,
               "author": null,
               "publisher": null,
               "publishDate": null,
               "borrowBookStatus": null,
               "language": null
           }
       ],
       "borrowBookStatus": 0,
       "returnBooksTime": "2022-05-06T16:57:25"
   }
]
}

管理员查询所有借阅记录

  • 接口地址：/user/book/findAllHistory
  • 请求方式：GET

  • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | token | String | | Header | 是 | | borrowBookStatus | Int | 借书状态(0和1，未借阅和已借出) | Params | 否 |

  • 返回结果

    {
"message": "查询成功",
"code": 0,
"data": [
   {
       "id": 19,
       "userId": 2,
       "bookId": 1,
       "borrowBooksTime": "2022-05-11T03:57:37",
       "borrowBookStatus": 0,
       "returnBooksTime": "2022-10-11T21:14:28",
       "name": "管理员",
       "libraryCardNum": "admin",
       "bookName": "平凡的世界",
       "author": "路遥",
       "publishDate": null,
       "publisher": "清华大学出版社"
   },
   {
       "id": 20,
       "userId": 2,
       "bookId": 4,
       "borrowBooksTime": "2022-05-11T21:11:38",
       "borrowBookStatus": 0,
       "returnBooksTime": "2022-05-11T21:14:28",
       "name": "管理员",
       "libraryCardNum": "admin",
       "bookName": "操作系统",
       "author": "沈晓红",
       "publishDate": null,
       "publisher": "电子工业出版社"
   },
   {
       "id": 21,
       "userId": 2,
       "bookId": 4,
       "borrowBooksTime": "2022-05-11T21:16:48",
       "borrowBookStatus": 1,
       "returnBooksTime": "2022-09-11T21:16:48",
       "name": "管理员",
       "libraryCardNum": "admin",
       "bookName": "操作系统",
       "author": "沈晓红",
       "publishDate": null,
       "publisher": "电子工业出版社"
   }
]
}

借书

  • 接口地址：/user/book/out

    • 请求方式：POST

    • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | bookIDList | Array | 书ID列表 | Body | 是 | | libraryCardNum | String | 借书证号 | Params | 是 |

    • 返回结果

      {
"message": "借书成功",
"data": null
}

      还书

    • 接口地址：/user/book/in

    • 请求方式：POST

    • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | libraryCardNum | String | 借书证号 | Params | 是 | | status | Int | 是否损坏，不传递则视为已归还 | Params | 否 | | bookIDList | Array | 书ID列表 | Body | 是 |

    • 返回结果

      {
"message": "还书成功",
"data": null
}

      续借

    • 接口地址：/user/book

    • 请求方式：PUT

    • 请求参数 | 参数 | 类型 | 说明 | 请求类型 | 是否必选 | | —- | —- | —- | —- | —- | | libraryCardNum | String | 借书证号 | Params | 是 |

    • 返回结果

      {
"message": "续借成功",
"code": 0,
"data": null
}