这篇文章给大家介绍使用Rest如何对API进行处理，内容非常详细，感兴趣的小伙伴们可以参考借鉴，希望对大家能有所帮助。
创新互联公司主要从事成都网站建设、成都做网站、网页设计、企业做网站、公司建网站等业务。立足成都服务安乡,十年网站建设经验,价格优惠、服务专业,欢迎来电咨询建站服务:028-86922220
一、项目目标
动静分离的架构，即客户端和服务器端的分离，客户端可以是IOS、android或者静态的页面。需要服务器端提供webservice服务，并且为了方便编写api接口文档，所以引入了swagger。
二、技术选型
为什么使用jersey而不用spring mvc
虽然spring-web提供了REST的功能，但是没有实现JAX-RS的标准。
二、maven配置
Java代码
8.1.16.v20140903 2.9 4.0.1.RELEASE io.swagger swagger-jersey2-jaxrs1.5.9 javax.ws.rs jsr311-api org.glassfish.jersey.containers jersey-container-servlet ${jersey.version} org.glassfish.jersey.media jersey-media-json-jackson ${jersey.version} 还需要引入spring的包，作者使用的是4.0.1.RELEASE org.glassfish.jersey.ext jersey-spring3 ${jersey.version} org.springframework spring-beans org.springframework spring-core org.springframework spring-web
三、swagger的操作
3.1swagger ui 准备
下载地址:https://github.com/swagger-api/swagger-ui
swagger其实就是一套静态页面，自定义了一套api的json格式，通过解析json将api展现出来。
下载之后将静态页面放在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代码
com.fasterxml.jackson.jaxrs jackson-jaxrs-json-provider 2.7.4 com.fasterxml.jackson.jaxrs jackson-jaxrs-base 2.7.4 com.fasterxml.jackson.core jackson-annotations 2.7.4 com.fasterxml.jackson.datatype jackson-datatype-joda 2.7.4
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进行处理就分享到这里了，希望以上内容可以对大家有一定的帮助，可以学到更多知识。如果觉得文章不错，可以把它分享出去让更多的人看到。
