在 URL 中使用多字节字符 (CR092089)

通过 servlet 容器（Web 容器），现在可以在 URL 中使用多字节字符。根据所使用的用户代理（Web 浏览器等），可以根据需要对服务器进行设置。

例如，如果收到以下类型的 HTTP 请求，

http://myHostName:port/myContextPath/myRequest/?myRequestParameter

myContextPath 和 myRequest 部分将按如下进行处理。

注意： myRequestParameter 部分位于 URL 后面，可以通过指定为 Servlet 的 setCharacterEncoding() 的编码或指定为 weblogic.xml 的 input-charset 的编码进行解码。对于 myHostName 部分，建议采用符合 IESG 标准的国际域名。

默认操作（通过基于 UTF-8 的编码进行 URL 解码）

如果未进行任何设置，WebLogic Server 8.1 将按如下方式处理请求。

1. 对 myContextPath 和 myRequest 部分的 URL 进行解码
2. 解码为 UTF-8 字符串，并生成在步骤 1) 中获取的字节流的字符串

例如，如果用户代理（Web 浏览器）是 MS IE (Microsoft Internet Explorer)，则默认情况下，在地址栏中输入的多字节字符将首先编码为 UTF-8，然后进行 URL 编码。在 WebLogic Server 8.1 中，默认情况下，可以正确生成以 UTF-8 编码方式发送的此 URL 的字符串。

注意： 在 IE 的“Internet 选项”-->“高级”中，包含一个名为“总是以 UTF-8 发送 URL（需要重启动）”的选项，而且此选项必须处于启用状态（选中）。

对 URL 进行解码时指定字符编码的方法

当用户代理是 Netscape 时

如果用户代理是 Netscape，地址栏中的字符将按照 Netscape 运行环境中的字符集进行编码，然后，该字符串再次进行 URL 编码，并被发送到服务器。例如，在日语版 Windows 中编码为 Windows-31J 的字符串将进行 URL 编码。在 WebLogic Server 8.1 中，可以将此请求设置为在进行 URL 解码之后将字节流解码为 Windows-31J，从而正确接收此请求。通过下面的 WebLogicServer 启动选项，可以更改用于执行 URL 解码的编码方式。

-Dweblogic.http.URIDecodeEncoding=Windows-31J（默认值为 UTF-8）

但是，对于每个服务器实例，只能存在一个这样的设置。

使用专有的用户代理时

如果需要在请求 URI 中使用多字节字符，请将该字符串转换为 UTF-8 字节字符串，然后进行 URL 编码，再将其发送到 WebLogicServer。

W3C 建议在创建 URI 时基于 UTF-8 进行 URL 编码。(http://www.w3.org/TR/charmod/#sec-URIs)

按照 JSP J2EE 规范进行的更改（WebLogic Server 7.0 或更高版本）

在 JSP 1.2 规范中，如果存在多个 Page 指令，则产生“致命转换错误”。(CR066562)

摘自 JSP1.2 ---- JSP.2.10.1

JSP.2.10.1 page 指令

page 指令定义一些与页面相关的属性，并将这些属性传送到 JSP 容器。

转换单元（JSP 源文件及通过 include 指令包含的任何文件）可以包含 page 指令的多个实例，所有特性都将应用于整个转换单元（即 page 指令与位置无关）。但是，除 Import 特性之外，在给定的转换单元中，此指令定义的任何特性/值只应出现一次；Import 特性的使用次数将进行累计（使用有序集联合语义）。除此之外的其他多个特性/值定义（或重定义）将导致致命转换错误。

这就是说，如果一个编译单元出现多个 page 指令，将会产生致命转换错误。在 WebLogicServer Server 7.0 中，已对 JSP 操作进行了更改，使其符合此规范。

在将一个单独的 JSP 文件包括在静态包含文件 (<%@ include file=. . . %>) 中时，如果包含源与包含目标都有相应的 page 指令，这种更改会出现问题。在静态包含文件中，JSP 容器将计算所有的 jsp，从而会导致它们包括在一个编译单元中，而且这种情况下会生成多个 page 指令，并出现“致命转换错误”。

为避免这种问题，WebLogic Server 7.0 中准备了下列选项作为 weblogic.xml 的新参数。

代码列表 1-2：weblogic.xml 中新添加的参数

<jsp-param>

  <param-name>backwardCompatible</param-name>

  <param-value>true</param-value>

</jsp-param>

通过此参数，只要编码相同，即使一个编译单元中出现多个 page 指令，也不会出现错误。

J2EE 默认编码规范（WebLogic Server 7.0 或更高版本）

在 weblogic-application.xml 中，可以为整个 J2EE 企业应用程序的请求和响应指定默认字符编码。(CR065921)

在 weblogic-application.xml 中，可以通过以下参数来设置用于请求和响应的默认编码。

• webapp.encoding.usevmdefault = true | false
• webapp.encoding.default = java 编码名称

注意：在 webapp.encoding.default 中指定的值是 Java 编码名称，而不是 IANA 字符集名称。

如果同时设置了上述两个选项，将使用 webapp.encoding.usevmdefault。

可以分别设置这些响应和请求值。此外，这些选项仅会应用于响应和请求，它们不会应用于 JSP 编译过程中的编码读取操作。有关分别设置响应和请求值的方法以及 JSP 文件编码的详细信息

weblogic-application.xml 中的 webapp.encoding.usevmdefault 用法示例

<application-param>

  <description>webapp.usevmdefault</description>

  <param-name>webapp.encoding.usevmdefault</param-name>

  <param-value>true</param-value>

</application-param>

或者
weblogic_application.xml 中的 webapp.encoding.default 用法示例

<application-param>

  <description>default encoding</description>

  <param-name>webapp.encoding.default</param-name>

  <param-value>SJIS</param-value>

</application-param>

WTC TUXEDO 域的编码规范 (CR052022)（WebLogic Server 7.0 或更高版本）

可以为 TUXEDO 域指定 wtc 域编码。在启动时指定以下参数。更改服务器的启动脚本（StartWebLogic.cmd 文件等）。

-Dweblogic.wtc.encoding=Java encoding name

此编码规范对于整个 TUXEDO 域有效。

XML -- StreamParser 中的多字节字符处理（WebLogic Server 7.0 或更高版本）

为了将编码信息添加到使用 XML 流 API 生成的 XML 头中，请按如下方式使用 ElementFactory 类的“createStartDocument()”。

XMLOutputStreamFactory factory = XMLOutputStreamFactory.newInstance();

XMLOutputStream output = factory.newOutputStream(new

			OutputStreamWriter(new FileOutputStream(fname),"Shift_JIS")); 

output.add(ElementFactory.createStartDocument("Shift_JIS","1.0"));

output.flush();

与 xerces 解析器相似，使用 XML 流 API 解析包含日语的 XML 文档时，请注意以下几点。

• 在解析器输入中使用流时请使用字节流。

  通过使用字节流，可以使用解析器的 XML 编码自动身份验证功能。解析器在内部生成适合 XML 头编码规范的流，从而确保了解析的正确性。
  

• 在作为 Unicode 字符流传递时，解析器将忽略 XML 头中的编码规范。

  这种情况下，用户负责传递正确的字符流。
  

部署描述符文件中的编码处理

在 WebLogic Builder 或管理控制台中编辑和保存部署描述符文件时，会保存初始部署描述符的编码。如果在部署描述符文件的 XML 声明中没有指定编码特性，该文件将按 UTF-8 处理。