当前位置:首页 > 开发 > 开源软件 > 正文

wink restful服务 第一个例子记录

发表于: 2013-08-29   作者:一炮送你回车库   来源:转载   浏览:
摘要:   REST(Representational State Transfer)  based Web Service是相对于传统的Web Service(SOAP+WSDL+UDDI)而提出的。传统的Web Service可以很好的解决异构系统之间的通信问题,但是需要首先定义好XML格式的合同(WSDL),client和server都必须严格遵守协议,不容易升级以及集

  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.csdn.net/kimylrong/article/details/7687593

 

这里还有一个不错的wink例子:http://download.csdn.net/download/kehongyong/4167213

 

wink restful服务 第一个例子记录

  • 0

    开心

    开心

  • 0

    板砖

    板砖

  • 0

    感动

    感动

  • 0

    有用

    有用

  • 0

    疑问

    疑问

  • 0

    难过

    难过

  • 0

    无聊

    无聊

  • 0

    震惊

    震惊

编辑推荐
使用 Apache Wink、Eclipse 和 Maven 开发 RESTful Web 服务 Gabriel Mateescu , 计算科学家, Natio
使用 Apache Wink、Eclipse 和 Maven 开发 RESTful Web 服务 Apache Wink 是一个促进创建和使用 RES
这几天读《Rest in Practice》,第5章的例子用了Jersey+Grizzly构建示例。随书代码中给的例子中没有
如何构建Apache Wink REST服务(转) 转自:http://www.searchsoa.com.cn/showcontent_35288.htm  
一直以来都想找一种数据通信方式,就像是asp.net中的*ashx程序一样的应用,什么意思呢,就是不论是
RESTful API 设计指南 作者: 阮一峰 网络应用程序,分为前端和后端两个部分。当前的发展趋势,就是
使用WCF创建Restful服务 公司项目需要做一个Android和服务器交互的应用,并且服务端越简单越好,最
构建RESTful风格的WCF服务 RESTful Wcf是一种基于Http协议的服务架构风格。 相较 WCF、WebService
目的 使用Wcf(C#)搭建一个Restful Service 背景 最近接到一个项目,客户要求使用Restful 方式接收
RESTful Wcf是一种基于Http协议的服务架构风格。 相较 WCF、WebService 使用 SOAP、WSDL、WS-* 而言
版权所有 IT知识库 CopyRight © 2009-2015 IT知识库 IT610.com , All Rights Reserved. 京ICP备09083238号