cetia4 1.1文档-2. Basic GET 访问

最新推荐文章于 2016-07-29 17:07:00 发布

最新推荐文章于 2016-07-29 17:07:00 发布 · 72 阅读

文章标签：

本文介绍Cetia4 REST框架中如何使用servlets响应用户请求，详细阐述了servlets的命名与URL之间的约定，以及如何通过配置文件进行定制。

在cetia4 REST 框架中，响应用户请求的主要组件是servlets，而不象其他框架一样使用帮助类。实际上，cetia4的servlets 是

com.acsinet_solutions.cetia4.controller.rest.RestServlet的子类, 它继承自javax.servlet.http.HttpServlet.

RestServlet 是一个实现doGet(), doPost(), doPut() 和doDelete()方法的抽象类，这些将在下面讨论。它还实现了init方法（没有参数），如果你想重写它，必须保证用super.init()调用父类的方法。

Cetia4 REST 框架使用了很到名称上的约定尽可能地避免过度的外部配置例如xml文件。如果代码约定不够用的话，还会使用j2se的注解-但是在大部分情况下不需要，因为得益于框架内的约定和合理的默认行为。框架的通过servlet初始参数设置的一些特性可以在标准的web部署描述文件( /WEB-INF/web.xml )中配置。上下文参数在配置主题中有详尽的说明。

在Rest Servlets中，约定如下：

1，以Servlet结尾的类，类名前面的部分第一个字符小写将和请求的url同名。

也就是说，例如一个servlet 叫做TopicsServlet（是RestServlet的子类）在forum应用中。那么这个servlet将和这样的url请求相对应例如：http://example.com/forum/topics 和

http://example.com/forum/topics/234.

但这不是必须的，如果servlet的名字和url不同的话也不会错误，但是为了保持一个项目中代码的一致性，这种做法是强烈推荐的。

2，在/WEB-INF/web.xml配置的servlet类的管理名字也要求和资源的url相同（解释如上）。例如：对于TopicsServlet，在web部署描述文件中配置的<servlet-name>也必须是topics。一些由框架生成的url将会使用这些servlet名字。( using the standard getServletName() method of javax.servlet.ServletConfig ).

3， servlet的映射必须包括对基本资源的和子资源的响应。例如：TopicsServlet

，servlet的名字是topics,servlet的映射必须匹配/topics/*.在没有子资源的情况下，映射可以不含有*，只映射/topics;但是这样情况下必须小心，如果子资源在随后被添加，那么这将会导致问题。

下面的图总结了上面这几点。框架对于servlet所在的资源包没有强制性的命名约定，但是推荐在开发小组使用一致的定义。