restlet jax-rs配置
配置基于 RESTlet JAX-RS Extension 的 Web Service 也就是部署该架构下的 Web Service。RESTlet 架构提供两种部署 Web Service 的方式。两种方式都方便简单，用户可以根据自己的需求选择任意一种部署方式。
- 将 Web Service 当做单独的 Java 程序进行部署
- 将 Web Service 部署到 Servelet Container 中
两种方式都方便简单，用户可以根据自己的需求选择任意一种部署方式。
将 Web Service 部署成一个单独运行的 Java 应用非常的简单，只需要完成以下几个步骤。
- 导入需要的 JAR 包，org.restlet.jar，以及org.restlet.ext.jaxrs_1.0.jar。
- 为 HTTP Server 创建相应 Java 类。在新建的 Java 类中依次完成以下工作，引入 org.restlet.jar 包中需要的类，新建 HTTP Server，定义该 Server 监听的端口，将 Web Service 的配置类加入到 HTTP 服务器中。
- 编译运行 HTTP Server。
将基于 RESTlet Jax-Rs Extension 的 Web Service 部署到 Servelet Container 中的过程和部署一个基本的 Servelet 极其相似。不同的是，部署过程中，用户需要注意添加需要的 Jar 包。以下 Jar 是该部署方式所需要的。
- org.restlet.jar
- org.restlet.ext.jaxrs_1.0.jar
- com.noelios.restlet.jar
- com.noelios.restlet.ext.servlet_2.5.jar
为了成功将基于 RESTlet Jax-Rs Extension 的 Web Service 部署为 Servelet，用户需要完成以下动作。
- 编译基于 RESTlet Jax-Rs Extension 的 Web Service 包含的代码。
- 将需要的 JAR 包存放于 /WEB-INF/lib 中。
- 创建 Servelet 的配置文件 web.xml。
- 将所有相关内容打包成 WAR 包，并部署到用户选定的 Servelet 容器中。
package com.resource;
import java.util.ArrayList;
import java.util.List;
import javax.ws.rs.*;
import com.model.User;
import com.model.UserGroup;
import com.model.UserGroupManager;
import com.model.UserManager;
@Path("users")
public class JaxRsExtensionResource {
@GET
@Path("usergroup")
public String getUserGroup() {
return "Group are used to classify different kind of users!";
}
@GET
@Path("user")
public String getUser(){
return "Users inlcudes the information of registered user!";
}
@GET
@Path("user/{id}")
public String findUser(@PathParam("id") String id){
User temp = UserManager.get().getDetails(id);
if(temp != null)
return temp.toString();
else
return "The user you queried(ID:" + id + ") doesn't existed!";
}
@GET
@Path("usergroup/{id}")
public String findUserGroup(@PathParam("id") String id){
UserGroup group = UserGroupManager.get().getDetails(id);
if(group != null)
return group.toString();
else
return "The group you queried(ID:" + id + ") doesn't existed!";
}
}
@path指定资源的路由,可以有资源的路由和资源方法的路由。
@GET指定请求的类型（get,put,post,delete)
@PathParam与@path中的参数对应
首先由jax-rs管理resource
package com.application;
import java.util.HashSet;
import java.util.Set;
import javax.ws.rs.core.Application;
import com.resource.JaxRsExtensionResource;
public class ExampleApplication extends Application {
@Override
public Set<Class<?>> getClasses() {
Set<Class<?>> rrcs = new HashSet<Class<?>>();
rrcs.add(JaxRsExtensionResource.class);
return rrcs;
}
}
注意这里继承的是jax-rs的Application，不是restlet的。
再交给restlet管理
RESTlet 架构为了更好的支持 JAX-RS 规范，定了 JaxRsApplication 类来初始化基于 JAX-RS 的 Web Service 运行环境。JaxRSApplication 类使用起来非常的方便，只需要将原本基于 RESTlet 架构的应用类加入到用户自己实现的 JaxRsApplication 子类中即可。如果需要认证功能的话，使用 JaxRsApplication 的 setGuard(...) 或者 setAuthentication(...) 方法即可。本例中不设置到认证功能，所以只需要将 ExampleApplication 类加入到本例实现 JaxRsApplication 子类中即可
package com.application;
import org.restlet.Context;
import org.restlet.ext.jaxrs.JaxRsApplication;
public class JaxRsExtensionApplication extends JaxRsApplication {
public JaxRsExtensionApplication(Context context) {
super(context);
this.add(new ExampleApplication());
}
public static void main(){
System.out.println("Hello");
}
}
将 Web Service 当做单独的 Java 程序进行部署
public class JaxRsExtensionServer {
public static void main(String[] args){
try{
Component component = new Component();
component.getServers().add(Protocol.HTTP, 8182);
component.getDefaultHost().attach(new JaxRsExtensionApplication(null));
component.start();
}catch(Exception e){
e.printStackTrace();
}
}
}
运行代码，打开浏览器输入http://localhost:portnum/users/usergroup 调用getUserGroup方法
将 Web Service 部署到 Servelet Container 中
将基于 RESTlet Jax-Rs Extension 的 Web Service 部署到 Servelet Container 中的过程和部署一个基本的 Servelet 极其相似。
不同的是，部署过程中，用户需要注意添加需要的 Jar 包。然后，创建 Servelet 的配置文件 web.xml。下面是为本例所写的配置文件。
最后用户需要将这些一起打包成 WAR 包，并部署到用户选定的 Servelet 容器中
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5"
xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
<context-param>
<param-name>org.restlet.application</param-name>
<param-value>
com.application.JaxRsExtensionApplication
</param-value>
</context-param>
<!-- Restlet adapter -->
<servlet>
<servlet-name>RestletServlet</servlet-name>
<servlet-class>
com.noelios.restlet.ext.servlet.ServerServlet
</servlet-class>
</servlet>
<!-- Catch all requests -->
<servlet-mapping>
<servlet-name>RestletServlet</servlet-name>
<url-pattern>/*</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>
原文地址：http://www.ibm.com/developerworks/cn/java/j-lo-jsr311/index.html