這篇文章給大家介紹使用Rest如何對API進行處理,內容非常詳細,感興趣的小伙伴們可以參考借鑒,希望對大家能有所幫助。
南湖ssl適用于網站、小程序/APP、API接口等需要進行數據傳輸應用場景,ssl證書未來市場廣闊!成為創(chuàng)新互聯的ssl證書銷售渠道,可以享受市場價格4-6折優(yōu)惠!如果有意向歡迎電話聯系或者加微信:028-86922220(備注:SSL證書合作)期待與您的合作!一、項目目標
動靜分離的架構,即客戶端和服務器端的分離,客戶端可以是IOS、android或者靜態(tài)的頁面。需要服務器端提供webservice服務,并且為了方便編寫api接口文檔,所以引入了swagger。
二、技術選型
為什么使用jersey而不用spring mvc
雖然spring-web提供了REST的功能,但是沒有實現JAX-RS的標準。
二、maven配置
Java代碼
<properties> <jetty.version>8.1.16.v20140903</jetty.version> <jersey.version>2.9</jersey.version> <spring.version>4.0.1.RELEASE</spring.version> </properties> <dependency> <groupId>io.swagger</groupId> <artifactId>swagger-jersey2-jaxrs</artifactId <version>1.5.9</version> <exclusions> <exclusion> <groupId>javax.ws.rs</groupId> <artifactId>jsr311-api</artifactId> </exclusion> </exclusions> </dependency> <dependency> <groupId>org.glassfish.jersey.containers</groupId> <artifactId>jersey-container-servlet</artifactId> <version>${jersey.version}</version> </dependency> <dependency> <groupId>org.glassfish.jersey.media</groupId> <artifactId>jersey-media-json-jackson</artifactId> <version>${jersey.version}</version> </dependency> <!-- jersey-spring --> <dependency> <groupId>org.glassfish.jersey.ext</groupId> <artifactId>jersey-spring3</artifactId> <version>${jersey.version}</version> <exclusions> <exclusion> <groupId>org.springframework</groupId> <artifactId>spring-beans</artifactId> </exclusion> <exclusion> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> </exclusion> <exclusion> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> </exclusion> </exclusions> </dependency> 還需要引入spring的包,作者使用的是4.0.1.RELEASE
三、swagger的操作
3.1swagger ui 準備
下載地址:https://github.com/swagger-api/swagger-ui
swagger其實就是一套靜態(tài)頁面,自定義了一套api的json格式,通過解析json將api展現出來。
下載之后將靜態(tài)頁面放在webapp目錄下即可,還需要改一下index.html中的url地址,改成本地的api接口地址即可。
3.2注冊
注冊swagger,即將swagger的rest服務注冊到jersey中。
register(io.swagger.jaxrs.listing.ApiListingResource.class);
register(io.swagger.jaxrs.listing.AcceptHeaderApiListingResource.class);
register(io.swagger.jaxrs.listing.SwaggerSerializers.class);
四、swagger集成過程中遇到的坑
4.1 jackson中報類型找不到,class java.lang.String
解決方法:更新jackson包
Java代碼
<dependency> <groupId>com.fasterxml.jackson.jaxrs</groupId> <artifactId>jackson-jaxrs-json-provider</artifactId> <version>2.7.4</version> </dependency> <dependency> <groupId>com.fasterxml.jackson.jaxrs</groupId> <artifactId>jackson-jaxrs-base</artifactId> <version>2.7.4</version> </dependency> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-annotations</artifactId> <version>2.7.4</version> </dependency> <dependency> <groupId>com.fasterxml.jackson.datatype</groupId> <artifactId>jackson-datatype-joda</artifactId> <version>2.7.4</version> </dependency>
4.2 swagger-ui.js中報的錯誤
4.2.1 operation is null, 大概在2338行
Java代碼
operation = path[method]; [b]if (operation === null) continue;[/b] var sharedParameters = path.parameters || []; var parameters = operation.parameters || []; for (i in sharedParameters) { var parameter = sharedParameters[i]; parameters.unshift(parameter); } if(method !== 'parameters' && _.isObject(operation)) { operation.parameters = operation.parameters || parameters; }
4.2.2 enumValues is null, 大概在4383行
Java代碼
if ([b]enumValues != null &&[/b] typeof enumValues !== 'undefined') { var id; param.allowableValues = {}; param.allowableValues.values = []; param.allowableValues.descriptiveValues = []; for (id = 0; id < enumValues.length; id++) { var value = enumValues[id]; var isDefault = (value === param.default || value+'' === param.default); param.allowableValues.values.push(value); // Always have string for descriptive values.... param.allowableValues.descriptiveValues.push({value : value+'', isDefault: isDefault}); }
關于使用Rest如何對API進行處理就分享到這里了,希望以上內容可以對大家有一定的幫助,可以學到更多知識。如果覺得文章不錯,可以把它分享出去讓更多的人看到。
當前標題:使用Rest如何對API進行處理-創(chuàng)新互聯
轉載來于:http://jinyejixie.com/article10/ccphgo.html
成都網站建設公司_創(chuàng)新互聯,為您提供網站設計公司、企業(yè)建站、網站設計、做網站、Google、網站維護
聲明:本網站發(fā)布的內容(圖片、視頻和文字)以用戶投稿、用戶轉載內容為主,如果涉及侵權請盡快告知,我們將會在第一時間刪除。文章觀點不代表本網站立場,如需處理請聯系客服。電話:028-86922220;郵箱:631063699@qq.com。內容未經允許不得轉載,或轉載時需注明來源: 創(chuàng)新互聯