Sun eCommunity

Sun Java System Application Server 7 Web应用开发者指南

上一部分 | 目录 | 下一部分

类加载元素

有如下一些类加载元素：

class-loader

Class-loader

为web组件配置类的加载。

子元素

空

属性

下面的表格描述了class-loader元素的属性。左边的一列列出了属性名，中间一列指定默认值，右边一列对属性作了说明。

class-loader属性

属性名

默认值

说明

extra-class-path

null

（可选）为web组件指定额外的classpath设置。

delegate

false

（可选）如果为true，web组件按照标准的classloader授权模型，在本地classloader中查找之前首先授权给它的父classloader。如果为false，web组件按照servlet规格说明书中指定的授权模型，在父classloader中查找之前先在自己的classloader中查找。

对web服务的web组件而言，必须将该值设置为true。

合法的值有on，off，yes，no，1，0，ture，false。

JSP元素

有如下一些JSP元素：

jsp-config

Jsp-config

指定JSP配置信息。

子元素

下面的表格描述了jsp-config元素的子元素。左边一列列出了子元素的名称，中间一列指明了所需规则，右边一列对元素的功能作了描述。

jsp-config子元素

元素名

所需规则

说明

property

零或多个

指定一个属性

属性

空

性质

下面的表格描述了jsp-config元素的性质。左边一列列出了性质的名称，中间一列指定了默认值，右边一列对性质的功能作了说明。

jsp-config性质性质名	默认值	说明
ieClassId	clsid:8AD9C840-044E-11D1-B3E9-00805F499D93	用于Internet Explorer的java插入式COM类的ID。由<jsp:plugin>标记使用。
javaCompilerPlugin	内在的JDK编译器（javac）	将使用java编译器plug-in中完全合格的类名。对默认编译器是不必的。例如，是用jikes编译器来编译jsp页面，将javaCompilerPlugin属性设置成org.apache.jasper.compiler.JikesJavaCompiler，然后将javaCompilerPath属性设置成指向jikes可执行的页面。
javaCompilerPath	none	指定像jikes这样的可以使用于程序外的java编译器的执行路径。忽略默认的编译器。仅当javaCompilerPlugin属性被指定时需要。
javaEncoding	UTF8	为生成的java servlet指定编码。编码传递给java编译器，也用于编译servlet。缺省情况下，web容器尝试使用UTF8。如果失败，在尝试使用javaEncoding的值。可以使用的编码请参考：http://java.sun.com/j2se/1.4/docs/guide/intl/encoding.doc.html
classdebuginfo	false	指定生成的java servlets是否使用设置的调试选项来编译（javac –g等）。
keepgenerated	true	如果设置成true，将生成的java文件保存；如果为false，删除java文件。
largefile	false	如果设置成true，jsp编译后，静态HTML将保存成独立的数据文件。当jsp非常大时，这是非常有用的，因为它将生成的servlet的大小最小化了。
mappedfile	false	如果设置成true，为每个html行和描述jsp文件中每行位置的注释生成独立的写调用。默认情况下，临近的写调用被组合，不会生成位置注释。
scratchdir	Web应用的默认工作目录	为所有生成代码排序而生成的工作目录。
reload-interval	0	指定检查JSP文件是否修改的频率（秒的形式）。设置成0表示每次请求时都检查JSP文件的修改。设置成-1表示对JSP文件的修改和重编译不能检查。

Internationalization元素

Internationalization元素如下所示：

locale-charset-info
locale-charset-map
parameter-encoding

Locale-charset-info

指定应用的国际化设置的信息。

子元素

下面的表格描述了locale-charset-info元素的子元素。左边一列列出了子元素的名称，中间一列指定了所需的规则，右边一列对元素的功能作了说明。

locale-charset-info 子元素

元素名

所需规则

说明

locale-charset-map

一个或多个

将地区或代理映射到相应字符集中

parameter-encoding

零或一个

根据隐藏字段的值来确定web容器如何对来源于web应用的表单的参数进行解码。

属性

下面的表格描述了locale-charset-info元素的属性。左边一列列出了属性的名称，中间一列指定了默认值，右边一列对属性的功能作了说明。

Locale-charset-info属性

属性名

默认值

说明

default-locale

none

指定默认的地区

locale-charset-map

将本地和代理映射到相应字符集。

关于可以使用的编码请参考：http://java.sun.com/j2se/1.4/docs/guide/intl/encoding.doc.html

子元素

下面的表格描述了locale-charset-map元素的子元素。左边一列列出了子元素的名称，中间一列指明了所需的规则，右边一列对该元素的功能作了说明。

locale-charset-map子元素

元素名

所需规则

说明

description

零或一个

指定一个可选的关于映射的文本描述信息

属性

下面的表格描述了locale-charset-map元素的属性。左边一列列出了属性的名称，中间一列指定默认值，右边一列对属性的功能作了说明。

locale-charset-map 属性属性名	默认值	说明
locale	none	指定本地名称
agent	none	（可选）指定与应用服务器交互的客户的类型。对一个给定的locale，不同的代理可能使用的字符集不同。属性的值必须与客户端用户代理http请求头发送的值精确匹配。更多的信息请参考"example agent attribute values"（网页地址：http://docs.sun.com/source/816-7150-10/dwdeploy.html#68338）表格。
charset	none	指定字符集

例子代理

下面的表格指定了例子代理的属性值。左边一列给出了代理名称，右边一列给出了相应的属性的值。

例子代理的属性值属性名	用户代理头和代理属性值
Internet Explorer 5.00 for Windows 2000	Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)
Netscape 4.7.7 for Windows 2000	Mozilla/4.77 [en] (Windows NT 5.0; U)
Netscape 4.7 for Solaris	Mozilla/4.7 [en] (X11; u; Sun OS 5.6 sun4u)

Parameter-encoding

当字符集在请求的content-type中未指定时，用来指定隐藏字段来确定web容器使用的字符编码对request.getParameter调用的参数进行解码。

关于可以使用的编码请参考：http://java.sun.com/j2se/1.4/docs/guide/intl/encoding.doc.html。

子元素

空

属性

下面的表格描述了parameter-encoding元素的属性。左边一列列出了属性名称，中间一列指定默认值，右边一列描述了该属性的功能。

parameter-encoding 属性

属性名

默认值

说明

form-hint-field

none

表单中隐藏字段的名称，它用于指定参数编码方式。

Web组件XML文件示例

这部分包含下列部分：

web.xml文件示例
sun-web.xml文件示例

web.xml文件示例

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE web-app PUBLIC '-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN' 'http://java.sun.com/j2ee/dtds/web-app_2_2.dtd'>

<web-app>

<display-name>webapps-simple</display-name>

The jakarta-tomcat-4.0.3 sample apps ports over to S1AS.

</description>

<servlet-name>HelloWorldExample</servlet-name>

<servlet-class>

samples.webapps.simple.servlet.HelloWorldExample

</servlet-class>

</servlet>

<servlet-name>RequestHeaderExample</servlet-name>

<servlet-class>

samples.webapps.simple.servlet.RequestHeaderExample

</servlet-class>

</servlet>

<servlet-name>SnoopServlet</servlet-name>

<servlet-class>

samples.webapps.simple.servlet.SnoopServlet

</servlet-class>

</servlet>

<servlet-name>servletToJsp</servlet-name>

<servlet-class>

samples.webapps.simple.servlet.servletToJsp

</servlet-class>

</servlet>

<servlet-name>RequestInfoExample</servlet-name>

<servlet-class>

samples.webapps.simple.servlet.RequestInfoExample

</servlet-class>

</servlet>

<servlet-name>SessionExample</servlet-name>

<servlet-class>

samples.webapps.simple.servlet.SessionExample

</servlet-class>

</servlet>

<servlet-name>CookieExample</servlet-name>

<servlet-class>

samples.webapps.simple.servlet.CookieExample

</servlet-class>

</servlet>

<servlet-name>RequestParamExample</servlet-name>

<servlet-class>

samples.webapps.simple.servlet.RequestParamExample

</servlet-class>

</servlet>

<servlet-name>SendMailServlet</servlet-name>

<servlet-class>

samples.webapps.simple.servlet.SendMailServlet

</servlet-class>

</servlet>

<servlet-name>JndiServlet</servlet-name>

<servlet-class>

samples.webapps.simple.servlet.JndiServlet

</servlet-class>

</servlet>

<servlet-mapping>

<servlet-name>HelloWorldExample</servlet-name>

<url-pattern>/helloworld</url-pattern>

</servlet-mapping>

<servlet-mapping>

<servlet-name>RequestHeaderExample</servlet-name>

<url-pattern>/requestheader</url-pattern>

</servlet-mapping>

<servlet-mapping>

<servlet-name>SnoopServlet</servlet-name>

<url-pattern>/snoop</url-pattern>

</servlet-mapping>

<servlet-mapping>

<servlet-name>servletToJsp</servlet-name>

<url-pattern>/servletToJsp</url-pattern>

</servlet-mapping>

<servlet-mapping>

<servlet-name>RequestInfoExample</servlet-name>

<url-pattern>/requestinfo</url-pattern>

</servlet-mapping>

<servlet-mapping>

<servlet-name>SessionExample</servlet-name>

<url-pattern>/session</url-pattern>

</servlet-mapping>

<servlet-mapping>

<servlet-name>CookieExample</servlet-name>

<url-pattern>/cookie</url-pattern>

</servlet-mapping>

<servlet-mapping>

<servlet-name>RequestParamExample</servlet-name>

<url-pattern>/requestparam</url-pattern>

</servlet-mapping>

<servlet-mapping>

<servlet-name>SendMailServlet</servlet-name>

<url-pattern>/SendMailServlet</url-pattern>

</servlet-mapping>

<servlet-mapping>

<servlet-name>JndiServlet</servlet-name>

<url-pattern>/JndiServlet</url-pattern>

</servlet-mapping>

<welcome-file-list>

<welcome-file>index.html</welcome-file>

</welcome-file-list>

<taglib-uri>

http://java.apache.org/tomcat/examples-taglib

</taglib-uri>

<taglib-location>

/WEB-INF/tlds/example-taglib.tld

</taglib-location>

</taglib>

<resource-ref>

<res-ref-name>mail/Session</res-ref-name>

<res-type>javax.mail.Session</res-type>

<res-auth>Container</res-auth>

</resource-ref>

<security-constraint>

<web-resource-collection>

<web-resource-name>Protected Area</web-resource-name>

<url-pattern>/jsp/security/protected/*</url-pattern>

<http-method>DELETE</http-method>

<http-method>GET</http-method>

<http-method>POST</http-method>

<http-method>PUT</http-method>

</web-resource-collection>

<auth-constraint>

<role-name>tomcat</role-name>

<role-name>role1</role-name>

</auth-constraint>

</security-constraint>

<env-entry>

The maximum number of tax exemptions allowed to be set.

</description>

<env-entry-name>maxExemptions</env-entry-name>

<env-entry-value>15</env-entry-value>

<env-entry-type>java.lang.Integer</env-entry-type>

</env-entry>

<env-entry>

<env-entry-name>minExemptions</env-entry-name>

<env-entry-value>1</env-entry-value>

<env-entry-type>java.lang.Integer</env-entry-type>

</env-entry>

<env-entry>

<env-entry-name>foo/name1</env-entry-name>

<env-entry-value>value1</env-entry-value>

<env-entry-type>java.lang.String</env-entry-type>

</env-entry>

<env-entry>

<env-entry-name>foo/bar/name2</env-entry-name>

<env-entry-value>true</env-entry-value>

<env-entry-type>java.lang.Boolean</env-entry-type>

</env-entry>

<env-entry>

<env-entry-name>name3</env-entry-name>

<env-entry-value>1</env-entry-value>

<env-entry-type>java.lang.Integer</env-entry-type>

</env-entry>

<env-entry>

<env-entry-name>foo/name4</env-entry-name>

<env-entry-value>10</env-entry-value>

<env-entry-type>java.lang.Integer</env-entry-type>

</env-entry>

</web-app>

sun-web.xml文件示例

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE sun-web-app PUBLIC '-//Sun Microsystems, Inc.//DTD Sun Java System Application Server 7.0 Servlet 2.3//EN' 'http://www.sun.com/software/Sun Java System/appserver/dtds/sun-web-app_2_3- 0.dtd'>

<sun-web-app>

<session-config>

<session-manager/>

</session-config>

<resource-ref>

<res-ref-name>mail/Session</res-ref-name>

<jndi-name>mail/Session</jndi-name>

</resource-ref>

<jsp-config/>

</sun-web-app>

上一部分 | 目录 | 下一部分