Restlet实战（三）使用Component让不同的Application对应不同的资源

在Restlet实战（二）我给出的例子中，把Order和Customer两个资源attach到Order Application上，看如下代码：

 

public class OrderApplication extends Application {   
   
    @Override  
    public synchronized Restlet createRoot() {   
        Router router = new Router(getContext());   
  
        router.attach("/order/{orderId}/{subOrderId}", OrderResource.class);   
        router.attach("/customer/{custId}", CustomerResource.class);   
        return router;   
    }   
  
}  

 

 

这显而易见不是一个好的应用，从关注点来看，Order Resource应该attach到Order Application，那么对应Customer Resource应该有一个Customer Application与之对应。

 

ok，基于这样的思路，我们从OrderApplication删除如下代码：

router.attach("/customer/{custId}", CustomerResource.class);   

 

另外我们创建一个CustomerApplication，并包含上述代码：

public class CustomerApplication extends Application{
	@Override
	public synchronized Restlet createRoot() {
		Router router = new Router(getContext());
		
		router.attach("/customers/{custId}", CustomerResource.class);
		return router;
	}
}

 

 有了CustomerApplication,那么如何设置才能生效呢？根据之前的配制，很容易想到的是在web.xml中把CustomerApplication配制进去，事实上是不行的，看看ServerServlet类里面这段代码：

private static final String APPLICATION_KEY = "org.restlet.application";   

 protected Application createApplication(Context parentContext) {
        Application application = null;

        final String applicationClassName = getInitParameter(APPLICATION_KEY,
                null);

 

这段代码是根据参数名org.restlet.application来获得配制在web.xml中application，而之前我们已经配制了OrderApplication,所以，我们不能再把CustomerApplication配制的参数名设置为org.restlet.application。那么在ServerServlet加载application的时候，就加载不到。

 

那么怎么作能让这两个Application生效呢？答案是Component，实际上，从上一篇文章中的图可以看出，一个Component可以设置多个Virtual Host，而一个Virtual Host能attach多个Application。

 

至于使用Component的做法有两种，一种是在web.xml中配制一个名字为“org.restlet.component”的context参数，例如：

<context-param>
                 <param-name>org.restlet.component</param-name>
                 <param-value>com.mycompany.MyComponent</param-value>
         </context-param>

 

另外一种是，WEB-INF/下存在restlet.xml,可以在这个xml文件里定义包含application和connector的Commponent。

 

下面就第二种方式来解决上面出现的问题，首先在WEB-INF/下建立一个名为restlet.xml，这个名字不能改变成别的名字，为啥呢？仍然看一下ServerServlet里面的一段代码：

    protected Component createComponent() {
        Component component = null;

        // Look for the Component XML configuration file.
        Client client = createWarClient(new Context(), getServletConfig());
        Response response = client.get("war:///WEB-INF/restlet.xml");

 

既然不让改，不改好了，在restlet.xml里面放入配制Component的代码：

<?xml version="1.0"?>
 <component xmlns="http://www.restlet.org/schemas/1.1/Component"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xsi:schemaLocation="http://www.restlet.org/schemas/1.1/Component">
    <!-- 
    <client protocol="CLAP" />
    <client protocol="FILE" />
    <client protocols="HTTP HTTPS" />
    <server protocols="HTTP HTTPS" port="8080"/>
     -->
     
    <defaultHost>
       <attach uriPattern="/customers/{custId}" 
                  targetClass="com.mycompany.restlet.application.CustomerApplication" />
       <attach uriPattern="/orders/{orderId}/{subOrderId}" 
                  targetClass="com.mycompany.restlet.application.OrderApplication" />           
       <!-- <attach uriPattern="/efgh/{xyz}" targetDescriptor="clap://class/org/restlet/test/MyApplication.wadl" /> -->
    </defaultHost>
 </component>

 

看上面的配制文件，很清楚的我们能知道，如果在浏览器输入http://localhost:8080/restlet/customers/1,那么CustomerApplication这个类应该被访问到。

 

咦，好象有点不对，好像CustomerApplication里面在attach资源的时候，也指定了同样的URL（/customers/{custId}）,那么是当前这两个URL定义的URL重复了？还是有别的含义？

 

我们可以这样理解，在restlet.xml中定义的URL附加到Context上，而在application里面定义的URL会附加到restlet.xml中定义的URL上。

 

例如，如果想通过http://localhost:8080/restlet/customers/1 来使用CustomerResource，则需要在CustomerApplication中有如下代码：

router.attach("", CustomerResource.class);

 而如果想通过http://localhost:8080/restlet/customers/1/orders/2 来使用CustomerResource，则需要在CustomerApplication中定义如下代码：

 

router.attach("/orders/{orderId}", CustomerResource.class);

 

Ok，让我们测试一下，首先修改

CustomerApplication.java

 

public class CustomerApplication extends Application{
	@Override
	public synchronized Restlet createRoot() {
		Router router = new Router(getContext());
		
		//router.attach("", CustomerResource.class);
		router.attach("/orders/{orderId}", CustomerResource.class);
		return router;
	}
}

 

CustomerResource.java

 

public class CustomerResource extends Resource {
	String customerId;
	String orderId;

	public CustomerResource(Context context, Request request, Response response) {
		super(context, request, response);
		customerId = (String) request.getAttributes().get("custId");
		orderId = (String) request.getAttributes().get("orderId");
		// This representation has only one type of representation.
		getVariants().add(new Variant(MediaType.TEXT_PLAIN));
	}

	@Override
	public Representation getRepresentation(Variant variant) {
		Representation representation = new StringRepresentation(
				"The customer which id is " + customerId
						+ " has the order which id  : " + orderId,
				MediaType.TEXT_PLAIN);
		return representation;
	}
}

 

 输入http://localhost:8080/restlet/customers/1/orders/2,结果如下：

 

The customer which id is 1 has the order which id  : 2

 

请注意，上面CustomerApplicaiton被注释的一行代码

router.attach("", CustomerResource.class);

如果反注释这行代码，则所有基于http://localhost:8080/restlet/customers/1/****（除了/customers/{custId}/orders/{orderId} ）的访问都会路由到同一个资源(CustomerResource),换句话说，如果我访问一个我没有定义的URL，如/customers/{customerId}/orders，则也会被路由到CustomerResource，这是不对的。。所以，应慎用之。

 

总结，现在我们可以分别用不同的Application来管理不同的资源了，并采用restlet.xml这种方式来定义包含applicaiton和connector的component.

评论

6 楼 nalanjia 2011-02-06  

偶测试到这里也遇到问题了，因为要用到restlet.xml。

查了一下，原因是版本不对，偶的版本太低，到官网下了1.1.9,就没问题了。

但是，别用2.0以上的，偶知道2.0改变挺多，许多类都不见了。

5 楼 fengzhiyu_sh 2010-12-22  

请教问题：
我现在用的是restlet.2.0.3版本
老是无法加载restlet.xml配置的component！

web.xml内容：
<!-- Restlet adapter --> 
   <servlet> 
      <servlet-name>RestletServlet</servlet-name> 
      <servlet-class>org.restlet.ext.servlet.ServerServlet</servlet-class> 
      <init-param>
   <param-name>org.restlet.autoWire</param-name>
        <param-value>true</param-value>
    </init-param>
   </servlet> 
  
   <!-- Catch all requests --> 
   <servlet-mapping> 
      <servlet-name>RestletServlet</servlet-name> 
      <url-pattern>/ws/*</url-pattern> 
   </servlet-mapping>

web-inf/restlet.xml内容：
<?xml version="1.0" encoding="UTF-8"?>
<component xmlns="http://www.restlet.org/schemas/2.0/Component" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xsi:schemaLocation="http://www.restlet.org/schemas/2.0/Component">
<defaultHost> 
       <attach uriPattern="/hello/" targetClass="com.odmenus.web.core.HelloWorldApplication" /> 
       <attach uriPattern="/menu/" targetClass="com.odmenus.web.core.MenuManageApplication" />
    </defaultHost>
</component>

我访问：http://localhost:9000/odmenu/ws/hello 老是报404错误！ 正常应该返回hello world!
帮忙分析下~~  多谢！

4 楼 liyf155 2010-03-11  

liyf155 写道

为什么会出现404错误呢？ web.xml里面的application我已经去掉了啊，restlet.xml里面设置端口号那段代码我去掉了注释，把端口号改成了8888，其它的不变，但是却出现了404错误

找到错误了，web.xml应该改一下：

<servlet>
         <servlet-name>RestletServlet</servlet-name>
	<servlet-class>com.noelios.restlet.ext.servlet.ServerServlet
	</servlet-class>
	<init-param>  
    	<param-name>org.restlet.component</param-name>  
    	<param-value>component</param-value>  
	</init-param>
</servlet>

但是我访问http://localhost:8080/restlet/orders/1/2 怎么会出现404错误呢？还有http://localhost:8080/restlet/customers/1

3 楼 liyf155 2010-03-11  

为什么会出现404错误呢？ web.xml里面的application我已经去掉了啊，restlet.xml里面设置端口号那段代码我去掉了注释，把端口号改成了8888，其它的不变，但是却出现了404错误

2 楼 ajax 2009-07-03  

web.xml中去掉阿application 和Component的定义就可以了，其它的跟之前一样就行。因为Component和application的定义在xml中完成。

1 楼 liuxujim 2009-07-03  

这个情况下, web.xml应该怎么写？