這篇文章將為大家詳細講解有關api返回值的標準化案例分析,小編覺得挺實用的,因此分享給大家做個參考,希望大家閱讀完這篇文章后可以有所收獲。
讓客戶滿意是我們工作的目標,不斷超越客戶的期望值來自于我們對這個行業的熱愛。我們立志把好的技術通過有效、簡單的方式提供給客戶,將通過不懈努力成為客戶在信息化領域值得信任、有價值的長期合作伙伴,公司提供的服務項目有:域名注冊、虛擬空間、營銷軟件、網站建設、巢湖網站維護、網站推廣。api返回值的標準化
例如
{"status":200,"message":"操作成功","data":"{\"id\":1,\"name\":\"張三\"}"}封裝返回對象
對象被封裝在base.util.ResponseUtils類型下,返回值是標準的ResponseEntity對象,返回體
進行了二次封裝,主要有status,messsage和data組成,返回方法有ok和okMessage,如果
真是返回消息,不需要對象,可以選擇使用okMessage,反之使用ok方法。
封裝的返回對象:
@Builder @Getter @NoArgsConstructor @AllArgsConstructor static class ResponseBody { private int status; private String message; private Object data; }httpError和我們封裝的httpError
對于http error來說有很多種,基本可以定為code在400到500之間的,像客戶端參數問題就是400- bad request,而沒有認證就是401-Unauthorized,認證但沒有對應的權限就是403-Forbidden,請求的
資源沒有發現就是404-Not Found,請求方式錯誤(方法是post,你發起請求用了get)就是405- Method Not Allowed等。
@GetMapping(GET_HTTP_ERROR) ResponseEntity<?> getHttpError() throws IOException { return ResponseEntity.badRequest().build(); } @Test public void getHttpError() throws Exception { mockMvc .perform( get(LindDemo.GET_HTTP_ERROR) .accept(MediaType.APPLICATION_JSON_UTF8)) .andExpect(status().is(400)); }
響應的結果
MockHttpServletResponse: Status = 400 Error message = null Headers = {} Content type = null Body = Forwarded URL = null Redirected URL = null Cookies = []
@GetMapping(GET_ERROR) ResponseEntity<?> getError() throws IOException { return ResponseUtils.badRequest("傳入的參數非法!"); } @Test public void getError() throws Exception { mockMvc .perform( get(LindDemo.GET_ERROR) .accept(MediaType.APPLICATION_JSON_UTF8)) .andExpect(status().isOk()); }
響應的結果
MockHttpServletResponse: Status = 200 Error message = null Headers = {Content-Type=[application/json;charset=UTF-8]} Content type = application/json;charset=UTF-8 Body = {"status":400,"message":"傳入的參數非法!","data":{}} Forwarded URL = null Redirected URL = null Cookies = []
通過上面的響應結果可以看到,我們封裝的請求httpcode還是200,只不過把請求錯誤400狀態碼寫在了body
對象里,目前這種方法用的比較多,像一些第三方接口用的都是這種方式,他們會規定相應的響應規范。
關于api返回值的標準化案例分析就分享到這里了,希望以上內容可以對大家有一定的幫助,可以學到更多知識。如果覺得文章不錯,可以把它分享出去讓更多的人看到。
本文標題:api返回值的標準化案例分析-創新互聯
網址分享:http://vcdvsql.cn/article22/csisjc.html
成都網站建設公司_創新互聯,為您提供微信公眾號、網站維護、ChatGPT、域名注冊、虛擬主機、企業網站制作
聲明:本網站發布的內容(圖片、視頻和文字)以用戶投稿、用戶轉載內容為主,如果涉及侵權請盡快告知,我們將會在第一時間刪除。文章觀點不代表本網站立場,如需處理請聯系客服。電話:028-86922220;郵箱:631063699@qq.com。內容未經允許不得轉載,或轉載時需注明來源: 創新互聯