作者:87zd
使用 XML 小服务程序配置文件配置小服务程序
这种替代的小服务程序配置方法涉及到创建一个 XML 小服务程序配置文件(该配置文件是一个 XML 文档,它的名称为 servlet_instance_name.servlet),它包括:
小服务程序类文件的文件名
小服务程序说明
小服务程序初始化参数
包含小服务程序可以调用的 JavaServer Pages(jsps)的 URL(统一资源定位器)的页面列表。该页面列表可以包括一个缺省页面、一个出错页面、一个或多个已装入的目标页面(假如它们的名称出现在 HTTP 请求中)。
在 Application Server 版本 3 中,.servlet 文件存储在应用程序的类路径中。
当 Application Server 接收到一个对小服务程序实例的请求时,它将在其 .servlet 文件中获得该小服务程序的配置信息。为了调用 JSP,XML 小服务程序配置文件的 page-list 元素和 PageListServlet 类(将在下一章节中讨论)消除对所调用 JSPs 的 URL 硬编码。假如引用的页面发生更改时,您只需更新 .servlet 文件,而无需更新小服务程序代码和重新编译该小服务程序。每当 .servlet 文件发生更改时,Application Server 就会自动装入此小服务程序实例。
WebSphere Application Studio 提供了用于生成小服务程序的向导。这些向导为每个 Studio 生成的小服务程序创建一个 XML 小服务程序配置文件(即 .servlet 文件)。假如您不能访问 Studio,并且希望手工实现 XML 小服务程序配置,则请:
创建一个扩展 PageListServlet 类的小服务程序。
使用 XMLServletConfig类创建小服务程序实例的 XML 小服务程序配置文件
展开经编译的小服务程序及其 XML 小服务程序配置文件于 Application Server 上。
使用 PageListServlet 类
PageListServlet 是小服务程序的超级类,这些小服务程序装入 XML 小服务程序配置文件的 <page-list> 元素中包含的页面。该页面列表使您能避免对所调用 JSP 的 URI 进行硬编码。该列表可以包含一个缺省页面、出错页面和其它根据 HTTP 请求而调用的 JavaServer Page。
PageListServlet 包含一种 callPage() 方法,该方法调用了一个 JavaServer Page,并将其作为对页面列表中某个页面的 HTTP 请求的响应。当输入 XML 配置文件的 page-list 元素中的页面名称时,PageListServlet.callPage() 方法接收 HttpServletRequest 对象和 HttpServletResponse 对象。
调用 PageListServlet.callPage() 方法后并不退出。紧跟 callPage() 方法调用之后的所有小服务程序代码将在调用后运行。当您架构您的小服务程序代码时请考虑这一点。
SimplePageListServlet 是一个扩展 PageListServlet 类和使用其 callPage() 方法来调用 JSP 的小服务程序示例:
public class SimplePageListServlet extends com.ibm.servlet.PageListServlet {
public void service(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException
{
try{
setRequestAttribute("testVar", "test value", req);
setRequestAttribute("otherVar", "other value", req);
String pageName = getPageNameFromRequest(req);
callPage(pageName, req, resp);
}
catch(Exception e){
handleError(req, resp, e);
}
}
}
使用 XMLServletConfig 类
使用 XMLServletConfig 类创建 XML 小服务程序配置文件(servlet_instance_name.servlet)。如下为一个配置文件:
<?xml version="1.0" ?>
<servlet>
<code>SimplePageListServlet</code>
<description>Shows how to use PageListServlet class</description>
<init-parameter name="name1" value="value2"/>
<page-list>
<default-page>
<uri>/index.jsp</uri>
</default-page>
<error-page>
<uri>/error.jsp</uri>
</error-page>
<page>
<uri>/TemplateA.jsp</uri>
<page-name>page1</page-name>
</page>
<page>
<uri>templateB.jsp</uri>
<page-name>page2</page-name>
</page>
</page-list>
</servlet>
元素 <servlet> 是 XML 配置文件的基本元素。每个 XML 配置文件必须是良好格式的 XML 文档。这些文件未根据文档类型定义(DTD)进行验证。
为了使 Application Server 能使用 XML 小服务程序配置文件装入小服务程序实例,该配置文件中至少必须包含 code 元素。对于 PageListServlet,XML 配置文件则至少必须包含 code 元素和 page-list 元素。虽然其中没有 DTD,但仍建议按元素在示例中显示的顺序来显示所有元素。这些元素(也称为标记)为:
servlet
基本元素。该元素是由 XMLServletConfig 类自动生成的。
code
小服务程序(无 .class 扩展名)的类名, 即使该小服务程序位于 JAR 文件中
描述
用户定义的小服务程序描述
init-parameter
该元素的属性指定了一个作为初始化参数的“名称-值”对。一个小服务程序可以有多个初始化参数,每个参数都有它自己的 init-parameter 元素。
page-list
它根据 HTTP 请求中的路径信息来标识要调用的 JavaServer Page。page-list 元素可以包含下列子元素:
default-page:假如 HTTP 请求中未包含路径信息,那么该元素中会包含一个 uri 元素,此元素指出了装入页面的位置
error-page:假如 handleError() 方法将请求属性设置为“error”,那么该元素中会包含一个 uri 元素,此元素指出了装入页面的位置
page:假如 HTTP 请求中包含了页面名称的话,那么该元素中会包含一个 uri 元素,此元素指出了要装入页面的位置。一个 page-list 元素中可以包含多个 page 元素。
您可以编写一个使用 XMLServletConfig 类来生成小服务程序配置文件的 Java 程序。XMLServletConfig 类提供了关于设置和获取文件元素及其内容的方法。
展开服务器上的小服务程序和 .servlet 文件
为了在 Application Server 上使用经编译的小服务程序和其 XML 小服务程序配置文件:
将经编译的小服务程序和其 .servlet 文件放置在应用程序类路径中。假如该小服务程序有一个软件包名,请确保该小服务程序被放置在该类路径的正确子目录下。
请确保在页面列表中引用的 JavaServer Page(JSP 文件)位于该应用程序的文档根目录中。