REST(Representational State Transfer) based Web Service是相对于传统的Web Service(SOAP+WSDL+UDDI)而提出的。传统的Web Service可以很好的解决异构系统之间的通信问题,但是需要首先定义好XML格式的合同(WSDL),client和server都必须严格遵守协议,不容易升级以及集群伸缩。REST Web Service不需要事先定义格式,传输的内容也可以依据不同的client变化(json,xml,html等),最重要的是使用源URL来唯一定位资源,对资源的增删改查映射为HTTP的四个方法,无状态传输,具有非常好的伸缩性。
Apache Wink就是一个纯Java的REST框架。它完整的实现了JSR 311并扩展了部分功能,此外还提供了良好的扩展性,难能可贵的是还可以与流行的Java框架Spring无缝集成。目前该项目还在开发中。所谓框架无非就是定义好格式,提供一些工具和钩子,让开发人员可以专注于业务逻辑的开发。本文将试图简单的介绍一下Wink。
1、下载wink官网包
当前 apache-wink-1.3.0
jar包引入:
在一个搭好了spring的环境里,添加:
1、wink-1.3.0.jar apache-wink-1.3.0\dist\路径下,该包包含了主要的wink逻辑,有了这个无需再引入wink-client-1.3.0.jar、wink-common-1.3.0.jar、wink-server-1.3.0.jar
2、slf4j-api-1.6.1.jar javax.ws.rs支持,apache-wink-1.3.0\lib下
3、slf4j-simple-1.6.1.jar javax.ws.rs支持,apache-wink-1.3.0\lib下
4、jsr311-api-1.1.1.jar apache-wink-1.3.0\lib下
提供对普通pojo转成json的支持需要加入jackson包:
jackson-core-asl-1.9.2.jar 自己找
jackson-jaxrs-1.9.2.jar
jackson-mapper-asl-1.9.2.jar
jackson-xc-1.9.2.jar
以及wink的jackson转换包
wink-jackson-provider-1.3.0.jar apache-wink-1.3.0\ext\wink-jackson-provider 下
2、配置
Web Service当然是Web程序了,所以入口就是一个Servlet,在web.xml里面配置一下,把REST的访问都安排给Wink来处理。代码如下:
<servlet> <servlet-name>restSdkService</servlet-name> <servlet-class>org.apache.wink.server.internal.servlet.RestServlet</servlet-class> <load-on-startup>0</load-on-startup> </servlet> <servlet-mapping> <servlet-name>restSdkService</servlet-name> <url-pattern>/rest/*</url-pattern> </servlet-mapping>
与Spring的集成,需要讲wink包里的wink-core-context.xml载入,配置如下:
<context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:META-INF/server/wink-core-context.xml,classpath:config/spring/spring-config.xml</param-value> </context-param>
其中wink-core-context.xml是wink-spring-support模块里面的一个Spring配置文件
spring的配置文件app-context.xml添加bean如下:
<bean class="org.apache.wink.spring.Registrar"> <property name="classes"> <set value-type="java.lang.Class"> <!--<value>org.codehaus.jackson.jaxrs.JacksonJaxbJsonProvider</value>--> </set> </property> <property name="instances"> <set> <ref local="helloWorldResource" /> </set> </property> </bean> <bean id="helloWorldResource" class="training.HelloWorldResource" />
HelloWorldResource是一个REST里面的Resource,用Annotation配置路径等信息:
package training;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;
import org.apache.wink.common.annotations.Workspace;
import org.springframework.stereotype.Service;
import training.module.xuelei.data.Xuelei;
@Workspace(workspaceTitle = "Workspace Title", collectionTitle = "Collection Title")
@Path("/testWink")
@Service
public class HelloWorldResource {
@GET
public String getMessage() {
return "HelloWorld";
}
@GET
@Path("/getjson/{id}")
@Produces(MediaType.APPLICATION_JSON)
public XueleiNew getById(@PathParam("id") String id)
{
XueleiNew xl = new XueleiNew();
xl.setId("123");
xl.setName("小李子");
return xl;
}
@GET
@Path("/getxml/{id}")
@Produces(MediaType.APPLICATION_XML)
public Book getBook(@PathParam("id") String id){
Book b = new Book();
b.setId(123111);
b.setISBN("sdfjlsjdf2kj234");
b.setTitle("一个农民工的江湖");
return b;
}
}
pojo对象:
转成的json的对象无需作任何处理
package training;
import java.io.Serializable;
public class XueleiNew implements Serializable {
/**
*
*/
private static final long serialVersionUID = 1L;
private String id;
private String name;
public XueleiNew(){
}
public String getId() {
return id;
}
public void setId(String id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
转成xml的对象需要添加注释
package training;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlAttribute;
import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
@XmlRootElement(name="book")
@XmlAccessorType(XmlAccessType.FIELD)
public class Book {
@XmlAttribute(name="id")
private int id;
@XmlElement(name="title")
private String title;
@XmlElement(name="isbn")
private String ISBN;
public Book() { }
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getTitle() {
return title;
}
public void setTitle(String title) {
this.title = title;
}
public String getISBN() {
return ISBN;
}
public void setISBN(String ISBN) {
this.ISBN = ISBN;
}
}
这样启动web服务器,输入http://localhost:8080/weat/rest/即可看到web service信息,服务列表里面可以看到HelloWorldResource服务。
http://localhost:8080/training.web/rest/testWink/getjson/123123 获得对象转换成的json
{"id":"123","name":"小李子"}
http://localhost:8080/training.web/rest/testWink/getxml/1235345 获得对象转换成的xml
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> <book id="123111"> <title>一个农民工的江湖</title> <isbn>sdfjlsjdf2kj234</isbn> </book>
部分内容抄袭自:http://blog.youkuaiyun.com/kimylrong/article/details/7687593
这里还有一个不错的wink例子:http://download.youkuaiyun.com/download/kehongyong/4167213