【javaWeb】軟件工程課程設計後臺接口規範

原創 Alearn_ 2018-08-22 06:02

knowledge-sharing-system

知識分享系統

目錄

文件

用戶創建文件關係

1.顯示

url:http://localhost:8088/demo/user_createf_ile/list
type: post
//根據類別查該類別的所有文件，直接用文件數據—討論

request

    無參數pageNum,PageSize

response

success

    {
        "status": 0,
        "msg": "",
        "data": {
            "list" : [
                {
                    "user_id":"9512101",
                    "username" : "XX"
                    "gmt_create": "2019-09-09 23:22:11",
                    "down_count":  ,
                    "collect_count" :   ,
                    "like_count" :              
                },
                {
                    "user_id":"9512102",
                    "username" : "XX"
                    "gmt_create": "2019-09-09 23:22:11",
                    "down_count":  ,
                    "collect_count" :   ,
                    "like_count" :              
                }
            ]
        },
        "success" : true

    }

fail

    {
    "status": 1,
    "msg": "",
    "data" : null,
    "success" : false
    }

2.添加文件

url:http://localhost:8088/demo/course_fileType/{user_id}
type: post
//根據類別查該類別的所有文件,然後添加文件

request

 user_name,user_id,file(文件信息)

response

success

    {
        "status": 0,
        "msg": "插入成功",
        "data": {},
        "success" : tru
    }

fail

    {
    "status": 1,
    "msg": "插入失敗",
    "data" : null,
    "success" : false
    }

用戶操作文件關係

1.刪除文件

url:http://localhost:8088/demo/course_fileType/{user_id}, {file_hash}
type: delete
//根據類別查該類別的所有文件,然後添加文件

request

 user_id，file_hash

response

success

    {
        "status": 0,
        "msg": "刪除成功",
        "data": {},
        "success" : true

    }

fail

    {
    "status": 1,
    "msg": "刪除失敗",
    "data" : null,
    "success" : false
    }

文件和文件類別

1.顯示

url:http://localhost:8088/demo/course_fileType/{file_type_id}
type: post
//根據類別查該類別的所有文件，直接用文件數據—討論

request

 file_type_id,
 pageNum,PageSize

response

success

    {
        "status": 0,
        "msg": "",
        "data": {
            "list" : [
                {
                    "file_name",

                }
            ]
        },
        "success" : true

    }

fail

    {
    "status": 1,
    "msg": "",
    "data" : null,
    "success" : false
    }

2.添加文件

url:http://localhost:8088/demo/course_fileType/{file_type_id}
type: post
//根據類別查該類別的所有文件,然後添加文件

request

 file_type_id，file.(文件信息)

response

success

    {
        "status": 0,
        "msg": "",
        "data": {
            file_type_id,
            //文件信息
        },
        "success" : true

    }

fail

    {
    "status": 1,
    "msg": "",
    "data" : null,
    "success" : false
    }

3.刪除文件

url:http://localhost:8088/demo/course_fileType/{file_hash}
type: delete

request

 file_type_id，file.(文件信息)

response

success

    {
        "status": 0,
        "msg": "",
        "data": {}
        "success" : true    
    }

fail

    {
        "status": 1,
        "msg": "",
        "data" : null,
        "success" : false
    }

4.修改文件信息

url:http://localhost:8088/demo/course_fileType/{file_type_id}，{file_hash}
type: put

request

  修改的信息

response

success

    {
        "status": 0,
        "msg": "",
        "data": {
            文件名,文件點擊次數，收藏次數（惡意修改而）
        }
        "success" : true    
    }

fail

    {
        "status": 1,
        "msg": "",
        "data" : null,
        "success" : false
    }

課程和文件

1.課程和文件重點內容列表信息

url : http://localhost:8088/demo/manage/course_file/list
type : post
//要顯示的內容： 課程編號、課程名稱、該課程下存在的文件信息 (1 – n)
// 文件信息包括：文件名，文件路徑、文件類型

request

    參數信息： file_name,courseName,fileType //此處到時候還需要討論
    pageNum,PageSize

response

success

{
    "status" : 0,
    "msg" : {},
    "data" : {
        //total爲數據庫查詢的數據
        "total" : 5
        "list" : [
            {
                "course_id" : "020420",
                "course_name" : "C語言程序設計",
                "file_name" : "filename",
                "file_url" : "file_url"
                "file_type" : "file_type"
            },
            {
                "course_id" : "020460",
                "course_name" : "計算機組成原理",
                "file_name" : "filename",
                "file_url" : "file_url",
                "file_type" : "file_type"
        ],
        "pageNum": 1,
        "pageSize": 10,
        "size": 5,
        "startRow": 1,
        "endRow": 5,
        "pages": 1,
        "prePage": 0,
        "nextPage": 0,
        "isFirstPage": true,
        "isLastPage": true,
        "hasPreviousPage": false,
        "hasNextPage": false,
        "navigatePages": 8,
        "navigatepageNums": [
            1
        ],
        "navigateFirstPage": 1,
        "navigateLastPage": 1,
        "firstPage": 1,
        "lastPage": 1   
        },
        "success" : true
    }
}

fail

{
    "status" : 0,
    "msg" : "查詢失敗",
    "data" : null,
    "success" : false
}

2.課程和文件的添加

url : http://localhost:8088/demo/manage/course_file/
type : post
//課程和文件添加處理：用戶上傳點擊

request

        course_id, course_name, file,file_type    //程序生成hash值,路徑

response

success

    {
        "status" : 0,
        "msg" : "添加成功",
        "data" : {},
        "success" : true
    }

fail

    {
        "status" : 0,
        "msg" : "失敗",
        "data" : null,
        "success" : false
    }

3.課程和文件刪除

//想法是查詢課程下所有文件，刪除根據文件的hash值
url : http://localhost:8088/demo/manage/course_file/{file_hash}
type : delete

request

file_hash

response

success

    {

        "status" : 0,
        "msg" : "刪除成功",
        "data" : {},
        "success" : true
    }

fail 


    {
        "status" : 0,
        "msg" : "刪除失敗",
        "data" : null,
        "success" : false
    }

4.課程和文件關係修改

url : http://localhost:8088/demo/manage/course_file/{course_id},{file_hash}
type : put

request

course_id,file_hash

response

success

    {
        "status" : 0,
        "msg" : "修改成功",
        "data" : {},
        "success" : true
    }

fail

    {
        "status" : 0,
        "msg" : "修改失敗",
        "data" : null,
        "success" : false
    }

學校

1.學校列表信息

url:http://localhost:8088/demo/manage/school/list
type:post

request

pageNum,pageSize

response

success

    {
        "status": 0,
        "msg": null,
        "data" : {
             "total" : 5
             "list" : [
                 {
                     "school_Id" : 99991
                    "school_name" :  "湖北汽車工業學院"
                },
                {
                     "school_Id" : 99992
                    "school_name" :  "湖北商業學院"
                }
             ],
        "pageNum": 1,
        "pageSize": 10,
        "size": 5,
        "startRow": 1,
        "endRow": 5,
        "pages": 1,
        "prePage": 0,
        "nextPage": 0,
        "isFirstPage": true,
        "isLastPage": true,
        "hasPreviousPage": false,
        "hasNextPage": false,
        "navigatePages": 8,
        "navigatepageNums": [
            1
        ],
        "navigateFirstPage": 1,
        "navigateLastPage": 1,
        "firstPage": 1,
        "lastPage": 1   
        },
        "success" : true
    }

2.刪除學校信息

url : http://localhost:8088/demo/manage/school/{school_id}
type : delete

reqeust 無參數信息 school_id可以爲數組

    無參數

response

success 

 {
        "status" : 0,
        "msg" : "刪除成功",
        "data" : {},
        "success" : true
}

fail 

{
        "status" : 0,
        "msg" : "刪除失敗",
        "data" : null,
        "success" : false
}

3.修改學校信息

url : http://localhost:8088/demo/manage/school/{school_id}
type : put

request : 

    school_name //注：由於school_id是主碼，所以爲了保證主碼唯一性，只能修改學校名

response

success

 {
        "status" : 0,
        "msg" : "修改成功",
        "data" : {},
        "success" : true
 }

fail

{
        "status" : 0,
        "msg" : "修改失敗",
        "data" : {},
        "success" : false
}

4.添加學校記錄

url : http://localhost:8088/demo/manage/school/
*type : post

request

school_id, school_name

response

success 

    {


    }

fail 

    {

    }

1.用戶列表信息

url:http://localhost:8088/demo/manage/user/list
type: post
//後臺請求學校列表信息數據

request

 pageNum,pageSize

response

success

{
    "status": 0,
    "msg": null,
    "data": {
        "total": 5,
        "list": [
            {
                "userId": 2,
                "nickname": null,
                "username": "?",
                "password": "8C491AA8E35D13E9DFC7768B9B76829E",
                "email": null,
                "userSchool": null,
                "userNo": null,
                "userMajor": null,
                "integral": null,
                "gmtCreate": "2018-06-24 10:57:23"
            },
            {
                "userId": 5,
                "nickname": null,
                "username": "和21",
                "password": "8C491AA8E35D13E9DFC7768B9B76829E",
                "email": null,
                "userSchool": null,
                "userNo": null,
                "userMajor": null,
                "integral": null,
                "gmtCreate": "2018-06-27 11:42:03"
            },
            {
                "userId": 6,
                "nickname": null,
                "username": "和212",
                "password": "8C491AA8E35D13E9DFC7768B9B76829E",
                "email": null,
                "userSchool": null,
                "userNo": null,
                "userMajor": null,
                "integral": null,
                "gmtCreate": "2018-06-27 11:42:04"
            },
            {
                "userId": 7,
                "nickname": null,
                "username": "和2121",
                "password": "8C491AA8E35D13E9DFC7768B9B76829E",
                "email": null,
                "userSchool": null,
                "userNo": null,
                "userMajor": null,
                "integral": null,
                "gmtCreate": "2018-06-27 11:42:05"
            },
            {
                "userId": 8,
                "nickname": null,
                "username": "qqq",
                "password": "5240358412DC9CB103BA5BD40947D1A6",
                "email": null,
                "userSchool": null,
                "userNo": null,
                "userMajor": null,
                "integral": null,
                "gmtCreate": "2018-06-28 17:10:04"
            }
        ],
        "pageNum": 1,
        "pageSize": 10,
        "size": 5,
        "startRow": 1,
        "endRow": 5,
        "pages": 1,
        "prePage": 0,
        "nextPage": 0,
        "isFirstPage": true,
        "isLastPage": true,
        "hasPreviousPage": false,
        "hasNextPage": false,
        "navigatePages": 8,
        "navigatepageNums": [
            1
        ],
        "navigateFirstPage": 1,
        "navigateLastPage": 1,
        "firstPage": 1,
        "lastPage": 1
    },
    "success": true
}

fail

2.刪除用戶

url:http://10.10.57.62:8088/demo/manage/user/{id}
type: delete

request id可爲數組 如: 01,02,02

 無參數

response

success

  {
    "status": 0,
    "msg": "刪除成功",
    "data": {},
    "success": true
   }

fail

{
    "status": 1,
    "msg": "刪除失敗",
    "data": null,
    "success": false
}

3.修改用戶

url:http://10.10.57.62:8088/demo/manage/user/{id}
type: put

request (只需要提交需要修改的數據)

 userId,nickname,username,password,email,userSchool,userNo,userMajor,integral

response

success

   {
    "status": 0,
    "msg": "修改成功",
    "data": {},
    "success": true
   }

fail 有很多種情況 具體再討論

{
    "status": 1,
    "msg": "刪除失敗",
    "data": null,
    "success": false
}

4.添加用戶

url:http://10.10.57.62:8088/demo/manage/user/
type: post

request 

 userId,nickname,username,password,email,userSchool,userNo,userMajor,integral

response

success

   {
    "status": 0,
    "msg": "添加成功成功",
    "data": null,
    "success": true
   }

fail 有很多種情況 具體再討論

{
    "status": 1,
    "msg": "添加失敗",
    "data": null,
    "success": false
}

{
    "status": 1,
    "msg": "用戶名已存在",
    "data": null,
    "success": false
}

課程

1.課程列表信息

url:http://localhost:8088/demo/manage/course/list
type: post

request

 pageNum,pageSize,majorName

response

success

{
    "status": 0,
    "msg": null,
    "data": {
        "total": 4,
        "list": [
            {
                "courseId": "011",
                "courseName": "計算機網絡"
            },
            {
                "courseId": "012",
                "courseName": "軟件工程"
            },
            {
                "courseId": "013",
                "courseName": "操作系統"
            },
            {
                "courseId": "014",
                "courseName": "數據結構"
            }
        ],
        "pageNum": 1,
        "pageSize": 10,
        "size": 4,
        "startRow": 1,
        "endRow": 4,
        "pages": 1,
        "prePage": 0,
        "nextPage": 0,
        "isFirstPage": true,
        "isLastPage": true,
        "hasPreviousPage": false,
        "hasNextPage": false,
        "navigatePages": 8,
        "navigatepageNums": [
            1
        ],
        "navigateFirstPage": 1,
        "navigateLastPage": 1,
        "firstPage": 1,
        "lastPage": 1
    },
    "success": true
}

fail

2.刪除課程

url:http://10.10.57.62:8088/demo/manage/course/{id}
type: delete

request id可爲數組 如: 01,02,02

 無參數

response

success

  {
    "status": 0,
    "msg": "刪除成功",
    "data": {},
    "success": true
   }

fail

{
    "status": 1,
    "msg": "刪除失敗",
    "data": null,
    "success": false
}

3.修改課程

url:http://10.10.57.62:8088/demo/manage/course/{id}
type: put

request (只需要提交需要修改的數據)

 courseId,courseName

response

success

   {
    "status": 0,
    "msg": "修改成功",
    "data": {},
    "success": true
   }

fail 有很多種情況 具體再討論

{
    "status": 1,
    "msg": "修改失敗",
    "data": null,
    "success": false
}

專業

url:http://localhost:8088/demo/manage/major/list
type: post

request

 pageNum,pageSize,majorName

response

success

{
    "status": 0,
    "msg": null,
    "data": {
        "total": 4,
        "list": [
            {
                "majorId": "10000",
                "majorName": "數學"
            },
            {
                "majorId": "10001",
                "majorName": "計算機"
            },
            {
                "majorId": "10002",
                "majorName": "英語"
            },
            {
                "courseId": "10003",
                "courseName": "物理"
            }
        ],
        "pageNum": 1,
        "pageSize": 10,
        "size": 4,
        "startRow": 1,
        "endRow": 4,
        "pages": 1,
        "prePage": 0,
        "nextPage": 0,
        "isFirstPage": true,
        "isLastPage": true,
        "hasPreviousPage": false,
        "hasNextPage": false,
        "navigatePages": 8,
        "navigatepageNums": [
            1
        ],
        "navigateFirstPage": 1,
        "navigateLastPage": 1,
        "firstPage": 1,
        "lastPage": 1
    },
    "success": true
}

fail

2.刪除專業

url:http://10.10.57.62:8088/demo/manage/major/{major_id}
type: delete

request id可爲數組 如: 01,02,02

 無參數

response

success

  {
    "status": 0,
    "msg": "刪除成功",
    "data": {},
    "success": true
   }

fail

{
    "status": 1,
    "msg": "刪除失敗",
    "data": null,
    "success": false
}

3.修改專業

url:http://10.10.57.62:8088/demo/manage/course/{major_id}
type: put

request (只需要提交需要修改的數據)

 courseId,courseName

response

success

   {
    "status": 0,
    "msg": "修改成功",
    "data": {},
    "success": true
   }

fail 有很多種情況 具體再討論

{
    "status": 1,
    "msg": "修改失敗",
    "data": null,
    "success": false
}

5.模板

url:http://10.10.57.62:8088/demo/user/list
type: post

request

 無參數

response

success

{
    "status": 0,
    "msg": "",
    "data": {}
}

fail

{
"status": 1,
"msg": ""
}
發表評論
所有評論
還沒有人評論，想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章

軟件工程詳解

Vince_Lee 2019-02-23 13:53:01

依賴注入的那些事兒（下）[轉載]

xiaovfight 2019-02-23 13:06:55

依賴注入那些事兒（上）[轉載]

xiaovfight 2019-02-23 13:06:55

軟件工程（C編碼實踐篇）學習總結

siwanghu 2019-02-23 00:37:02

10個調試和排錯的小建議

yufenghang 2019-02-23 00:05:19

success is most failure

bigfool007 2019-02-22 23:27:14

AgileEAS.NET SOA 中間件平臺.Net Socket通信框架-介紹

agilelab 2019-02-22 23:20:10

軟考中高項學員：2016年4月11日作業

栐夜 2019-02-22 23:06:39

怎樣才能開發出好的軟件

XeoMiracle 2019-02-22 23:06:16

沒那麼難，談CSS的設計模式

kingZXY2009 2019-02-22 22:32:01

如何成爲一名優秀的軟件測試工程師

周文秋 2019-02-22 22:14:08

軟考信息系統監理師：2016年4月22日作業

翟夢佼 2019-02-22 22:06:45

Facebook 沒有QA 如何發佈代碼 (How Facebook Ships Code 譯文)

kiddymeet 2019-02-22 21:22:49

第十一次作業

羅瀟瀟 2019-02-22 21:00:05

Web前端開發的前世和未來

qq580dc235202c7 2019-02-22 17:38:14