Weblogic使用手册大全详解(中文)

客户端的IP地址 s-ip

服务器的IP地址 与DNS相关的字段

这些字段给出了客户端与服务器的域名。字段的类型为W3C规范定义的类型。所支持的前缀有：

- 76 -

WebLogic管理指南

c-dns 客户端的域名 s-dns

被请求服务器的域名 sc-status

响应的状态代码。例如（404）表示状态为“文件没有找到”。该字段的类型为W3C规范所定义的类型 sc-comment

状态码的注释。例如，“文件没有找到”。该字段的类型为类型 cs-method

请求方式，例如GET或POST。该字段的类型为W3C规范所定义的类型 cs-uri

请求的完整URI。该字段的类型为W3C规范所定义的类型 cs-uri-stem

URI的主干部分（省略了查询）。该字段的类型为W3C规范所定义的类型 cs-uri-query

URI的查询部分。该字段的类型为W3C规范所定义的类型

定制字段标识符

扩展日志格式的HTTP访问日志可以使用用户定义的字段。要创建一个定制字段，你必须在扩展日志格式（即ELF格式）的日志文件中使用Fields指令来标识定制的字段，同时定义与该字段匹配的Java类以生成所需要的输出。你可以为每个字段创建一个Java类，也可以用一个Java类匹配多个字段。本文提供了这种Java类的代码示例。详细内容，请参见7-18页的“Java类与创建定制ELF字段”。 要创建一个定制字段，

1． 在Fields指令中包含该字段的名字，形式如下： x-myCustomField

其中myCustomField为类的完整名字

有关Fields指令的详细信息，请参见7-12页的“创建Fields指令”

2． 创建一个与定制字段同名的Java类（例如myCustomField）。这个类定义了要记录自定制字段中的信息。该Java类必须实现以下接口： weblogic.servlet.logging.CustomELFLogger

- 77 -

WebLogic管理指南

这个Java类必须实现logField()方法，该方法使用HttpAccountingInfo对象与FormatStringBuffer对象作为参数。

用HttpAccountingInfo对象访问HTTP请求与响应的数据，这些数据将被输出到所定制的字段中。它提供了许多Get方法来访问这些信息。Get方法的完整列表请参见7-15页的“HttpAcountingInfo对象的Get方法”。

用FormatStringBuffer类创建定制字段的内容。他提供了创建定制字段的合适的方法。有关这些方法的详细内容，请参见FomatStringBuffer类的Java文档。（见以下网页：http://e-docs.bea.com/wls/docs60/javadocs/weblogic/servlet/logging/FormatStringBuffer.html）

3． 编译Java类，并把它加到启动WebLogic服务器的CLASSPATH语句中。如果用脚本启动WebLogic服务器，那么要修改脚本中的CLASSPATH语句 注意：不要将这个类放在扩展格式的Web应用或企业应用中。

4． 对WebLogic服务器进行配置，让它使用扩展日志格式。详细内容，参见7-11页“使用扩展日志格式”。

注意：在编写定制字段的Java类时，务必不要在这个类中执行降低系统性能的代码（例如，访问DBMS，以及执行繁重的I/O或网络调用。）记住，对于每一个HTTP请求，系统都会相应地创建一条HTTP访问日志记录。

注意：如果要输出到多个字段，那么这些字段之间应该用制表符分隔开。有关字段分隔以及扩展日志格式的更多内容，请参见以下网页的“扩展日志格式”部分

http://www.w3.org/TR/WD-logfile-960221.html HttpAccountingInfo对象的Get方法

以下方法返回与HTTP请求相关的数据。这些方法与javax.servlet.ServletRequest,

javax.servlet.http.Http.ServletRequest以及javax.servlet.http.HttpServletResponse等类的方法相似。

这些方法在Java接口中定义，下表列出了这些方法以及从什么地方可以找到有关这些方法的信息。

表7-1 HttpAccountingInfo的Getter方法 HttpAccountingInfo Object getAttribute Enumeration getAttributeName() String getCharacterEncoding() Int getResponseContentLength() 参考以下类中的相应方法 javax.servlet.ServletRequest javax.servlet.ServletRequest javax.servlet.ServletRequest Javax.servlet.servletResponse.setContentLength- 78 -

WebLogic管理指南

() 该方法返回响应的长度，该长度由setContentLenth()方法设置 javax.servlet.ServletRequest javax.servlet.ServletRequest javax.servlet.ServletRequest javax.servlet.ServletRequest javax.servlet.ServletRequest javax.servlet.ServletRequest javax.servlet.ServletRequest javax.servlet.ServletRequest javax.servlet.ServletRequest javax.servlet.ServletRequest javax.servlet.ServletRequest javax.servlet.ServletRequest javax.servlet.ServletRequest javax.servlet.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest javax.servlet.http.Http.ServletRequest 返回HTTP请求的第一行。例如GET/index.html HTTP/1.0 返回查找servlet的service()方法所花费的方法，这个servlet的作用是把数据回写到- 79 -

String getResponseContentLength() Strng getContentType(); Locale getLocale(); Enumeration getLocales(); String getParameter(String name); Enumeration getParameterNames(); String[] getParameterValues(String name); String getProtocol(); String getRemoteAddr(); String getRemoteHost(); String getScheme(); String getServerName(); int getServerPort(); boolean isSecure(); String getAuthType(); HttpAccountingInfo Methods String getContextPath(); Cookie[] getCookies(); long getDateHeader(String name); String getHeader(String name); Enumeration getHeaderNames(); Enumeration getHeaders(String name); int getIntHeader(String name); String getMethod(); String getPathInfo(); String getPathTranslated(); String getQueryString(); String getRemoteUser(); String getRequestURI(); String getRequestedSessionId(); String getServletPath(); Principal getUserPrincipal(); boolean isRequestedSessionIdFromCookie(); boolean isRequestedSessionIdFromURL(); boolean isRequestedSessionIdFromUrl(); boolean isRequestedSessionIdValid(); String getFirstLine(); HttpAccountingInfo Methods long getInvokeTime();

WebLogic管理指南

int getResponseStatusCode(); String getResponseHeader(String name); 客户端 javax.servlet.http.HttpServletResponse javax.servlet.http.HttpServletResponse 列表7-1 用于创建ELF字段的Java类

Import weblogic.servlet.logging.CustomELFLogger; import weblogic.servlet.logging.FormatStringBuffer; import weblogic.servlet.logging.HttpAccountingInfo; /* This example outputs the User-Agent field into a custom field called MyCustomField */

public class MyCustomField implements CustomELFLogger{ public void logField(HttpAccountingInfo metrics, FormatStringBuffer buff) {

buff.appendValueOrDash(metrics.getHeader(\"User-Agent\")); } }

防止“POST拒绝服务”攻击

拒绝服务工具是通过假冒请求造成服务器过载的一种恶意攻击。这种攻击类型通常采用HTTP的POST方法发送大量数据。在WebLogic服务器中，你可以通过设置三个属性来防止这种攻击。这三个属性可以在管理控制台的Servers或virtural hosts节点下设置。如果为一个虚拟主机定义了这些属性，那么所设置的值将覆盖Servers节点中的设置

PostTimeoutSecs

通过这个属性，你可以限制WebLogic服务器接收HTTP POST数据段之间的等待时间 MaxPostTimeSecs

限制WebLogic服务器用于接收POST数据的时间。如果触发了该限制，那么将会引发PostTimeoutException异常并将以下信息发送到服务器日志中。 Post time exceeded MaxPostTimeSecs MaxPostSize

限制每个请求中的POST数据量。当请求中的POST数据量超过该限制时，将引发MaxPostSizeExceeded异常并将以下信息发送到服务器日志中。 POST size exceeded the parameter MaxPostSize 同时向客户端返回HTTP 413错误代码

- 80 -

WebLogic管理指南

如果客户端使用了监听模式，那么它将得到这个信息。如果没有采用监听模式，则断开连接。

设置WebLogic服务器的HTTP隧道

如果你只能采用HTTP协议连接WebLogic服务器与Java客户端，那么可以用HTTP隧道功能来模拟有状态的套接字连接。HTTP隧道通常被用来穿越安全防火墙的HTTP端口。HTTP是一种无状态协议，因此WebLogic服务器所提供的隧道功能使得连接看上去象是一个T3连接。但比起标准的套接字连接，这会造成性能的下降。

配置HTTP隧道连接

当使用HTTP协议时，客户端只能发送请求，然后接收服务器的响应。服务器不能主动地与客户端通信，并且HTTP协议是无状态的，这就意味这服务器与客户端之间不可能发生连续的双向连接。

WebLogic HTTP隧道通过HTTP协议模拟T3Connection协议，从而克服上述限制。有两个属性与隧道连接的性能有关。这两个属性可以通过管理控制台的Servers部分的Configuration标签页的Tunning标签页来设置。大多数情况下，你应该使用这两个属性的缺省值，除非你对在处理连接问题方面非常有经验。服务器通过这些属性来决定一个客户端连接是否有效以及客户端是否是活动的。 Enable Tunneling

启用或禁用HTTP隧道。缺省情况下，HTTP隧道是被禁用的 Tunneling Ping

在建立HTTP隧道连接时，客户端会自动地向服务器发一个请求，使服务器可以主动响应客户端。客户端可以在请求中包含指示，无论客户端应用是否需要与服务器进行通信。如果服务器没有在由该属性所设置的时间内响应客户端，那么它就会主动地给客户端一个响应，客户端接收该响应并立即发送另一个请求。 缺省值为45秒；有效的范围为20至900秒 Tunning Timeout

在继上次客户端请求之后，如果在该属性所指定的时间内，客户端还没有发出新的请求，那么服务器就认为客户端已经死了并结束该HTTP隧道连接。在服务器响应客户端请求时，它会按该属性所指定的时间间隔来检测继上一次请求后所过去的时间。 缺省值为40秒，有效范围为10至900秒

- 81 -

WebLogic管理指南

建立客户端与WebLogic服务器之间的连接

如果客户端要与WebLogic服务器建立HTTP隧道连接，那么只需要URL中指定HTTP协议。例如：

Hashtable env = new Hashtable();

env.put(Context.PROVIDER_URL, \"http://wlhost:80\"); Context ctx = new InitialContext(env);

客户端会在HTTP协议后面附加一个特殊标签，这样WebLogic服务器就知道这是一个隧道连接而不是普通的HTTP请求，这些都是自动的，你的应用不需要做额外的工作。 客户端必须在URL中指定端口号，即便是使用80端口。尽管WebLogic服务器可以在任何端口监听HTTP请求，但一般使用80端口，因为通常只有该端口才能穿越防火墙。 你可以在管理控制台的Servers节点的Network标签页配置WebLogic服务器的简听端口。

用本地I/O提供静态文件服务（只适用于Windows）

当你在Windows NT/2000上运行WebLogic服务器，可以让WebLogic服务器通过本地操作系统调用Tramsmitfile来代替Java方法服务静态页面，例如HTML文件，文本文件以及图象文件。在服务较大的静态页面时，使用本地I/O会提高服务器的性能。 要使用本地I/O，那么需要在Web应用的分发描述符web.xml中增加两个I/O参数。参数weblogic.http.nativeIOEnabled应该设置为TRUE以启用本地I/O文件服务。参数weblogic.http.minimumNativeFileSize指定要用本地I/O进行服务的文件的最小长度。如果一个文件的长度大于该参数所设置的值，那么就会用本地I/O来服务该文件。如果没有指定该参数的值，那么默认为400个字节。

一般而言，对于较大的文件，使用本地I/O会提高服务的效率。但随着运行服务器的计算机的负载的增大，这种效益会消失。因此需要通过实验来寻求weblogic.http.minimumNativeFilesize参数的最佳值。

下面的例子演示了如何在web.xml中添加本地I/O的相关参数的配置。这些设置必须放在元素与元素之间。

weblogic.http.nativeIOEnabled

- 82 -

WebLogic管理指南

TRUE

weblogic.http.minimumNativeFileSize 500

有关编写分发描述符的详细内容，请参见以下页面的“Writing Web Application Deployment Descriptors”:

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.html.

- 83 -

WebLogic管理指南

7 代理对另一个HTTP服务器的请求

概述

如果把WebLogic服务器作为主Web服务器，通过配置，可以让它把请求委托给另一个HTTP服务器处理，例如Netscape Enterprise服务器,Apache或者是 Microsoft Internet Information 服务器。任何被代理的请求都会重定向到一个指定的URL。被代理的Web服务器可以位于其它机器上。我们一般基于请求的URL来决定把请求委托给哪个服务器处理。

HttpProxyServlet将HTTP请求重定向到代理URL上，然后通过WebLogic服务器将响应返回给浏览器。要使用代理功能，必须在Web应用中配置该功能，并把它分发到一个重定向请求的WebLogic服务器中。

设置从服务器的代理

要设置从服务器的代理：

1．在Web应用分发描述符（见“使用ProxyServet的web.xml示例”）注册代理servlet。Web应用必须是响应请求的服务器的缺省应用。代理servlet的类名为weblogic.t3.srvr.HttpProxyServlet。详细信息可以参见以下资源中的“分发与配置Web应用”

http://e-docs.bea.com/wls/docs60/adminguide/config_web_app.html

2． 定义ProxyServlet的初始化参数。为redirectURL， 为从服务器的URL。

3． 在Web应用分发描述符web.xml中使用元素把ProxyServlet映射到。特别地，把文件扩展名映射到ProxyServlet，例如*.jsp，或*.html。 如果设置为“/”，那么任何不能被WebLogic服务器所解析的请求都会

- 84 -

WebLogic管理指南

委托给远程服务器处理。如果你只希望代理特定扩展名的文件，那么应该映射以下扩展：*.jsp， .html以及*.htm。

代理Servlet的分发描述符示例

以下是使用Proxy servlet的Web应用分发描述符示例。 表8-4 使用ProxyServlet的web.xml示例

ProxyServlet

weblogic.t3.srvr.ProxyServlet

redirectURL

tehama1:7736:7737|tehama2:7736:7737|tehama:7736:7737

ProxyServlet /

ProxyServlet *.jsp

ProxyServlet

- 85 -

WebLogic管理指南

*.htm

ProxyServlet *.html

- 86 -

WebLogic管理指南

8 代理对WebLogic集群的请求

本章将介绍如何代理对WebLogic集群的请求，主要有以下内容：

 概述

 设置HttpClusterServlet  HttpClusterServlet示例

概述

HttpClusterServlet负责把请求从一个WebLogic服务器代理到WebLogic集群中的服务器成员，同时HttpClusterServlet还为代理的HTTP请求提供负载平衡与失败转移。有关servlets与WEbLogic集群的更多内容，可以参见以下页面的“理解HTTP会话状态复制”部分： http://e-docs.bea.com/wls/docs60/cluster/servlet.html.

设置HttpClusterServlet

以下是使用HttpClusterServlet所需要的配置：

1．在WebLogic服务器的管理控制台配置一个代理HTTP请求的WebLogic服务器实例，该服务器实例负责把请求重定向到WebLogic服务器。 a. 新建一个域。

b. 在新建的域中新建一个应用

c. 在新建的域中新建一个服务器，或使用缺省的服务器

d. 把在步骤b中创建的Web应用设置为新建服务器的缺省Web应用。

2．在步骤1所创建的Web应用的分发描述符中注册HttpClusterServlet。（见本章的“HttpServlet的分发描述符示例”）。该Web应用必须是响应请求的服务器的缺省Web应用。相关信息参见第8章的“指定一个缺省Web应用”。

HttpClusterServlet的类名是weblogic.servlet.internal.HttpClusterServlet。HttpClusterServlet的分发描述符示例见下文

- 87 -

WebLogic管理指南

3． 定义HttpClusterServlet的初始化参数。初始化参数用web.xml的元素定义。defaultServers参数是必须定义的，其它参数视需要而定。有关HttpClusterServlet的参数可以参见本章表10-1 “HttpClusterServlet Parameters”中的内容。

4．把代理servlet映射到一个。特别地，映射要代理的文件扩展名，例如“*.jsp”或*.html。

如果设置为“/”，那么任何不能被WebLogic服务器所解析的请求都将交给远程服务器处理。如果你只希望代理特定扩展名的文件，那么应该映射以下扩展名文件：*.jsp， .html以及*.htm。

设置URL模式的另一方式是：首先映射一个url模式，例如/foo，然后把pathTrim参数设置为foo，该设置的作用是把foo从被代理的URL中删除。

表10-1 HttpClusterServlet的参数

缺省值 defaultServlets （必须设置该参数）一组代理请求的服务器，采用以下形式：hostname1:HTTP port1:HTTPS port1 | hostname2:HTTP port2:HTTPS port2 如果secureProxy参数设置为ON（见下面的secureProxy参数），那么HTTPS端口将在运行HttpClusterServlet的WebLogic服务器与集群的成员服务器之间使用SSL协议。即使把secureProxy参数设为OFF，你也必须定义HTTPS端口 secureProxy ON/OFF。如果设置为ON，那么HTTPClusterServlet与WebLogic服务器集群成员之间的连接将使用SSL协议 DebugConfigInfo ON/OFF。如果设置为on，那么在请求中加上一个请求参数?_WebLogicBridgeConfig就可以查询HttoClusterServlet的调试信息。因为安全性的原因，建议在生产环境中把该参数设置为OFF。 connectionTimeout 套接字等待读入数据的时间，单位为微秒。超时会引发java.io.InterruptedIOException异常 numOfRetries HttpClusterServlet重试一个失败连接的次数 PathTrim 从原始URL的开头部分裁减的字符串 TrimExt 从原始URL的最后裁减掉的文件扩展名 pathPrepend 在PathTrim被裁减后，在请求被代理到一个WebLogic服务器集群成员之前，附加在原始URL之前的字符串。 None OFF OFF 0（即没有限制） 5 None None None HttpClusterServlet的分发描述符示例

以下是使用HttpClusterServlet的Web应用分发描述符示例：

- 88 -

WebLogic管理指南

列表10-1 使用HttpClusterServlet的web.xml示例

HttpClusterServlet

weblogic.servlet.internal.HttpClusterServlet

defaultServers

myserver1:7736:7737|myserver2:7736:7737|myserver:7736:7737

DebugConfigInfo ON

HttpClusterServlet /

HttpClusterServlet *.jsp

HttpClusterServlet *.htm

- 89 -

WebLogic管理指南

HttpClusterServlet *.html

- 90 -

WebLogic管理指南

9

配置Web应用的安全性

通过验证，限制对Web应用中某些资源的访问或者在servlet中使用安全调用，你可以保护你的应用。WebLogic定义了几种安全域，有关安全域的讨论见以下资源的“安全基础知识”：

http://e-docs.bea.com/wls/docs60/security/concepts.html

注意，安全域为多个虚拟主机所共享。

设置对Web应用的授权

Web应用的验证在web.xml的元素中定义。用该元素定义安全域。安全域包含用户证书、验证方式与需要进行验证的资源所在的位置。有关设置安全域的更多内容，请参见以下资源中的“安全基础”部分。 要设置Web应用的安全验证： 1．选择一种验证方式。有以下几种选项 BASIC

BASIC验证通过Web浏览器显示一个用户名/口令对话框。然后依照安全域对用户名及口令进行验证。 FORM

基于表单的验证需要一个包含用户名与口令的HTML表单。该表单所返回的字段必须是j_username与j_password，表单的action属性必须设为j_security_check，以下是一个用FORM授权的HTML示例：

产生该表单的资源可能是HTML页面、JSP或者是servlet。你必须用

- 91 -

WebLogic管理指南

元素定义产生该表单的资源。

会话对象在返回登录页面时创建。因此在验证通过后，从被服务的页面中调用session.isNew()方法，该方法将返回FALSE。 CLIENT-CERT

使用客户端验证对请求进行验证。详细内容，参见以下资源的“配置SSL协议”部分：

http://e-docs.bea.com/wls/docs60/adminguide/cnfgsec.html#cnfgsec015

2．如果选用FORM验证，那么还需要定义生成HTML页面的资源所在的位置与响应验证失败的资源。有关配置表单验证的详细信息，请参见以下网页中的“”的内容：

http://e-docs.bea.com/wls/docs60/programming/web_xml.html#login –config.

3．定义用来验证的域。如果没有指定域，将使用缺省的WebLogic FileRealm域。详细内容，参见以下网页发“”部分：

http://e-docs.bea.com/wls/docs60/programming/web_xml.html#login-config

多Web应用、Cookies与身份验证

缺省情况下，所有Web应用都使用一样的cookie名字（JSESSIONID）。无论你用何种验证方式，所有使用相同cookie名的应用对授权都采用单点签到的方式。即一旦一个用户验证通过后，那么该验证对于其它使用同样cookie名字的Web应用的请求也是有效的，用户不会被要求重新验证。

如果要对一个应用单独授权，那么应该为这个应用指定一个不同的cookie名字。该名字由weblogic.xml的元素中的CookieName参数定义。详细内容，参见以下网页“session-descriptor元素”中的内容：

http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#session-descriptor.

限制对Web应用资源的访问

你可以对Web应用中的资源（servlets, JSPs, 或者HTML页面）应用安全约束。要使用安全约束，你应该：

1、定义一个角色，该角色对应于安全域里的一到多个准则（principal）。角色在web.xml中的元素中定义（见http://e-docs.bea.com/wls/docs60/programming/

- 92 -

WebLogic管理指南

web_xml.html#security-role）。然后在weblolgic.xml中，用元素把这些角色映射到域中的准则(见http://e-docs.bea.com/wls/docs60 /programming/weblogic_xml.html#security-role-assignment)。

2．用元素的子元素定义Web应用中需要实施安全限制的资源。可以是一个目录、文件名或者是一个 要对整个应用实施安全限制，那么应该用以下: /*

3、使用元素中的子元素定义需要应用安全限制的HTTP方法（Get或Post）

4、使用元素中的子元素设置客户端与服务器端的通信是否使用SSL。

列表8-6 资源限制示例

web.xml entries:

SecureOrdersEast

Security constraint for resources in the orders/east directory

/orders/east/* POST GET

constraint for east coast sales east manager

SSL not required

- 93 -

WebLogic管理指南

NONE ...

east coast sales east

managers manager weblogic.xml中的条目: east tom jane javier maria

manager peter georgia

在servlet中使用用户和角色

你可以在servlet中javax.servlet.http.HttpServletRequest.isUserInRole

用

- 94 -

WebLogic管理指南

(String role)方法访问用户与角色。字符串role对应于Web应用分发描述符的元素的子元素所定义的名字，元素位于声明中。元素映射到Web应用分发描述符的元素所定义的元素。 例如

列表 8-7 安全角色映射示例

Servlet代码:

isUserInRole(\"manager\"); web.xml 中的条目: . . .

manager mgr ...

mgb weblogic.xml中的条目: mgr al george ralph

- 95 -

WebLogic管理指南

配置Web应用的外部资源

在访问外部资源时，例如通过JNDI从Web应用访问数据源，你可以让代码中使用的JNDI名字映射到绑定在JNDI树中的实际名字。这种映射是通过web.xml以及Weblogic.xml分发描述符来实现的。这样当这些资源发生变化时，就不需要更新应用程序的代码。你应该为这些资源提供一个由代码使用的名字，即资源在JNDI树中所绑定的名字，以及资源的Java类型；并且还应该指出是否应该由servlet以编程的方式来处理该资源的安全性还是通过HTTP请求加密来保证资源的安全。 要配置外部资源：

1．在分发描述符中定义资源的名字、Java类型以及安全验证类型。有关编写分发描述符的内容请参见以下网页中的“引用外部资源”部分：

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.html#resource-ref.

2．将资源名映射到JNDI名。有关编写分发描述符的内容请参见以下网页的“Map external resources ”部分:

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.html#resource-description.

下面的例子假定你定义了一个名字为accountDataSource的资源。详细内容，参见以下页面的“JDBC数据源”部分：

http://e-docs.bea.com/wls/docs60/ConsoleHelp/jdbcdatasource.html.

表8-8 Example of Using a DataSource

Servlet代码:

javax.sql.DataSource ds = (javax.sql.DataSource) ctx.lookup(\"myDataSource\");

web.xml 中的设置:

...

myDataSource javax.sql.DataSource

- 96 -

WebLogic管理指南

CONTAINER ...

weblogic.xml中的设置：

myDataSource accountDataSource

在Web应用中引用EJBs

当Web应用要引用EJB时，你应该在web应用分发描述符中为所引用EJB的定义一个名字，这个名字应该与webloigc-ejb-jar.xml文件中所定义的EJB的JNDI名相同，然后你就可以在程序中用所定义的名字来引用EJB。 要在Web应用中使用EJB，需要进行以下配置：

1．在Web应用分发描述符的元素中定义EJB的引用名（程序用这个名字来查找EJB）、Java类名以及home接口与remote接口的类名。有关如何编写分发描述符的条目，参见以下页面的“引用EJB资源”部分：

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.html#ejb-ref.

2．将在weblogic.xml的元素中所定义的引用名映射到weblogic-ejb-jar.xml文件中定义的JNDI名。关于如何编写分发描述符中的条目，你可以参见以下页面的“Map EJB resources”部分：

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.html#ejb-reference-description.

如果Web应用是企业应用的组成部分，你可以用元素通过名称来引用.ear文件中的EJB。

- 97 -

WebLogic管理指南

配置会话管理

WebLogic服务器被缺省设置为处理会话跟踪，因此要使用会话跟踪，不需要配置任何以下将要提到的属性。但WebLogic服务器如何管理会话对于提升应用的性能非常关键。性能提升与以下因素有关：

 预期会有多少个用户访问一个servlet。  会有多少个并发用户访问一个servlet。  每个会话持续的时间  为每个用户存储的数据量

HTTP会话属性

你可以在特定于WebLogic的分发描述符中配置HTTP会话属性，配置WebLogic服务器的会话跟踪。详细内容，参见以下网页的“定义会话参数”部分：

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.html#session-descriptor.

会话属性的完整列表可在以下网页获得：

http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#session-descriptor.

会话超时

你可以指定HTTP会话隔多长时间失效。在会话失效后，所有保存在会话中的数据都将丢失。以下两种方式可以配置会话失效的时间间隔。

TimeoutSecs属性在特定于WebLogic的分发描述符——weblogic.xml文件的元素中定义，属性值以秒为单位。你可以参见以下资源：

http://e-docs.bea.com/wls/ #session-descriptor

docs60/programming/ weblogic_xml.html

- 98 -

WebLogic管理指南

也可以用Web应用分发描述符——web.xml文件中的元素定义会话超时，以分钟为单位。该属性会覆盖在weblogic.xml的元素中所设置的属性。有关在web.xml中定义超时属性的内容可以参见以下资源：

http://e-docs.bea.com/wls/docs60/programming/web_xml.html#web_xml_session-config）

配置会话Cookies

如果客户的浏览器支持cookies，那么WebLogic服务器将用Cookies来管理会话。

缺省情况下，WebLogic服务器把跟踪会话的cookies设置为暂态的，即浏览器关闭时，cookie丢失并且会话的生命期便被看作是结束了。这种行为是使用会话的精髓所在，推荐你以这种方式使用会话。

通过定义weblogic.xml中的有关属性，你可以配置cookies的方方面面。有关会话与cookie的属性的完整列表可以参见:

http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#session-descriptor

有关如何编辑weblogic.xml的内容，可以参见以下资源的“定义会话参数”部分：

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.htm l#session-descriptor.

使用长效 cookies

对于长效的客户端数据，应用程序应该通过HTTP servlet API创建自己的cookies，并且尽量让这个cookie与HTTP会话存在什么关联。应用程序可能要用cookie来实现用户从某一机器上的自动登录功能，这种情况下就需要创建一个长效的cookie。记住，该cookie只能由该用户的机器发送。如果该用户要从多台机器上访问，那么必须把数据保存在服务器端。

注意，浏览器cookie的生命周期与会话的生命周期没有直接的联系。如果，一个cookie先于它所关联的会话失效，那么该会话就成了孤儿。如果会话先

- 99 -

WebLogic管理指南

于它所关联的cookie失效，那么servlet就找不到会话。此时，当getSession()方法被调用时，会创建一个新的会话。

配置持久化会话

持久会话有以下四种实现：

 内存（单服务器，不存在复制）  文件系统  JDBC

 内存复制（在集群中的服务器之间）

这里只介绍前面三种实现；有关内存复制的方式参见以下资源的“HTTP会话状态的复制”部分：

http://e-docs.bea.com/wls/docs60/cluster/servlet.html

要通过文件系统、JDBC或者内存复制来实现持久会话，那么需要设置包括PersistentStoreType在内的一些属性。每种实现方式都有一组自己的属性。

通用属性

在weblogic.xml中，以下属性设置保存在内存中的会话数量。只有在使用持久会话时，这些属性才是有效的 CacheSize

该属性限制了缓存在内存中的活动会话的数量。如果可能会有大量并发的活动会话，而又不希望活动会话占用太多的内存使得内存页面交换频繁发生而导致性能问题，那么可以通过这个属性来控制。当缓冲区满了时，最少使用的那些会话将被保存在持久存储设备中，当需要时，会话被自动地装载到缓冲区中。如果不使用持久会话，那么该属性被忽略，并且不限制内存中的会话数量。缺省情况下，缓存会话的数量为1024个，最小为16个，最大为Integer.MAX_Value个。一个空会话所使用的字节数少于100个字节，但随着数据的加入，它所使用的内存数量也虽之增加

SwapIntervalSecs

当内存中会话的数量达到cacheEntries界限时，服务器每隔多长时间把新近最少使用的

- 100 -

WebLogic管理指南

会话保存到持久存储器中。

该属性缺省为10秒，最小为1秒，最大为604800秒（一个星期）。

InvalidationIntervalSecs

该属性设置了WebLogic服务器检查超时与失效会话并删除这些会话以释放内存空间的时间间隔。该属性值应该大于元素中设置的值。该参数可以用来对WebLogic服务器的性能进行优化。

最小设置为1秒一次，最大设置为一星期一次（604800秒），缺省为60秒。

在web.xml的元素中设置，详细内容见以下资源：

http://e-docs.bea.com/wls/docs60/programming/web_xml.html#web_xml_session-config

使用基于内存的、单服务器的、非复制的持久存储

如果要用基于内存的、单服务器的、非复制的方式来实现持久会话，那么应该把PersistentStoreType属性设置为memory。对于这种实现方式，所有的会话数据都保存在内存中。因此当你终止并重启WebLogic服务器时，所有的会话数据都将丢失。

使用基于文件的持久存储

要以基于文件存储的方式实现持久会话：

1．将PersistentStoreType属性设置为file

2．设置存储会话的目录。有关如何设置该目录的详细内容，请参见以下资源中的“PersistentStoreDir”部分：

http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#persistentStroeDir

如果没有设置该属性，WebLogic服务器会创建一个临时目录保存会话。

如果在集群中，持久会话采用基于文件存储的实现方式，那么必须明确设置一个能被集群中所有成员访问的共享目录，而且你必须自己创建该目录。

- 101 -

WebLogic管理指南

使用基于数据库的持久存储

要以基于JDBC的方式实现持久会话：

1．将PersistentStoreType属性设置为jdbc

2． 设置PersistentStorePool属性，该属性被设置为一个在控制台中定义的连接池。通过设置该属性，持久会话将使用JDBC连接池。

所使用的连接池必须是仅被用于JTS驱动器的JDBC连接。也就是说，一个被非JTS驱动器所使用的JDBC连接池不能用于会话的持久化。为保险起见，你应该为持久会话单独创建一个JDBC连接池。不过，持久会话可以与servlet持久会话以及EJB共用一个JDBC连接池，因为后两者都要用到JTS驱动器

有关设置数据库连接池的详细内容请参见以下资源的“管理JDBC连接”部分：

http://e-docs.bea.com/wls/docs60/adminguide/jdbc.html

总结一下：尽管servlet可以用非-JTS连接访问数据库，但是你不能在持久会话中使用该连接。

3．设置连接的ACL。只有那些有权限的用户才能使用该连接。有关设置数据库连接的详细内容，请参见以下资源的“管理数据库连接”部分：

http://e-docs.bea.com/wls/docs60/adminguide/jdbc.html.

4．创建一个名字为wl_servlet_sessions的数据库表。基于JDBC实现的持久会话要用到这个表。数据库连接池应该具有该表的读/写权限。下表列出了wl_servlet_sessions表的字段及其类型。

表8-4 wl_servlet_sessions表

列名 Wl_id 类型 长度不超过100的可变字符串型。例如Oracle的VARCHAR2(100)。主键必须设置为wl_id + wl_context_path 长度不超过100的可变字符串型。例如Oracle的VARCHAR2(100)。该列是主键的组成部分 单字符型。例如，Oracle的 CHAR(1) 长度为20的数值型。例如，Oracle的NUMBER(20) 单字符型。例如，Oracle的CHAR(1) Large binary column。例如，Oracle的Long RAW类型 长度为20的数值型。例如，Oracle的NUMBER(20) 整数型。例如Oracle的Integer类型。该列指的是两次客户端请求的最大时间间隔（单位为秒），超过该时间间隔会话就变为无效。如果该列的值为- 102 -

Wl_context_path Wl_is_new Wl_create_time Wl_is_valid Wl_session_values Wl_access_time Wl_max_inactive_interval

WebLogic管理指南

负数，表明会话永远不过期。 如果使用Oracle数据库管理系统，那么可以用以下SQL语句创建wl_servlet_session表。

create table wl_servlet_sessions ( wl_id VARCHAR2(100) NOT NULL,

wl_context_path VARCHAR2(100) NOT NULL, wl_is_new CHAR(1),

wl_create_time NUMBER(20), wl_is_valid CHAR(1),

wl_session_values LONG RAW, wl_access_time NUMBER(20), wl_max_inactive_interval INTEGER,

PRIMARY KEY (wl_id, wl_context_path) );

对上述SQL语句作一些改动，就可以用于其它数据库管理系统上。

注意：JDBCConnectionTimeoutSecs属性设置了JDBC持久会话在连接池中的连接装载数据失败前的最长等待时间。详细内容，参见以下网页：

http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#JDBCConnectionTimeoutSecs)

使用URL重写

某些情况下，因为浏览器不支持cookies，从而不能用cookie来跟踪会话。在这种情况下，WebLogic服务器检测到浏览器不支持cookie时，它会自动起用URL重写来进行会话跟踪。URL 重写将会话号编写在页面的超级链接中，你的servlet把这个页面返回到浏览器。当用户点击页面上的链接时，WebLogic服务器从URL地址中抽取出会话号并在servlet调用getSession()方法时找到合适的HttpSession。

要在WebLogic中启用URL重写，需要在特定于WebLogic的分发描述符——weblogic.xml中把元素的URLRewritingEnabled属性设置为true（该属性的缺省值为true）。有关URLRewritingEnabled属性的信息，请参见以下网页中的内容：

http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#URLRewritingEnabled

- 103 -

WebLogic管理指南

URL重写的编码指南

以下是在使用URL重写时如何在代码中处理URL的指导性规则：

 不要将URL直接输出到输出流中，就象下面这样：

out.println(\"catalog\");

而是应该使用HTTPServletResponse.encodeURL()方法。例如：

out.println(\"catalog\");

encodeURL()方法会确定是否要重写URL，如果需要重写，该方法会在URL中加上会话号。会话号附加在URL后并且以分号开头

 除了作为响应返回到Weblogic的URL外，还要对需要redirect的URL重编码。例如 :

if (session.isNew())

response.sendRedirect(response.encodeRedirectUrl(welcomeURL));

对于新建的会话，即使浏览器支持cookies，WebLogic服务器也会使用URL重写，因为服务器在第一次访问一个会话时，不能区分浏览器是否支持cookies。

 通过检测HttpServletRequest.isRequestedSessionIdFromCookie()方法返回的值，Servlet可以确定所会话号是否是来自于cookie。应用程序可以对此作出合适的响应，或者只是使用WebLogic服务器的URL重写。

URL重写与无线访问协议(WAP)

如果要编写WAP应用，那么就必须使用URL重写，因为WAP协议不支持cookies。而且某些WAP设备把URL的长度限制在128个字符（包括参数在内），从而限制了URL重写所能传送的数据量。要使参数能有更多的空间，你可以设置IDLength属性来限制WebLogic服务器随机产生的会话号的长度。有关该属性的详细内容，请参见以下网页中的内容

http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#IDLength

使用字符集与POST数据

对于一个使用Post方法的表单，你可以设置处理该表单数据的字符集。通过在处理表单数据的URL中加上特定的“信号”字符（在

信号字符串应该在Web应用名（也被称为上下文路径，上面的例子中为myWebApp）与URL的其它部分之间。

有关Web应用分发描述符的详细内容，请参见以下网页的“上下文参数”部分：

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.html#context-param.

- 105 -

WebLogic管理指南

10 配置Apache-Weblogic服务器插件

本章将介绍如何配置Apache-WebLogic Server插件。主要有以下内容：

 概述  平台支持  安装库

 配置httpd.conf文件

 Apache-WebLogic Server插件的配置参数  使用SSL

 与SSL-Apache配置有关的问题  httpd.conf文件示例

 分发Apache-WebLogic Server插件

概述

本章描述如何安装与配置Apache-Weblogic Server插件。该插件可以把Weblogic服务器的HTTP功能平滑地集成到Apache服务器中。因为可以透明地访问Weblogic Server的servlet引擎，从而增强了原有Apache服务器的功能。

插件用于这样一种环境中：Apache服务器提供静态页面的服务，而把文档树中的另一部分转交给工作在另一个进程也可能是在另一个主机中的Weblogic服务器。对于终端用户即浏览器而言，转交给webLogic服务器的HTTP请求是来自相同的源；后端的WebLogic Server是不可见的。因为WebLogic服务器的客户-服务器协议的HTTP-隧道部件可以在插件中运行，因此插件可以访问包括HTTP servlets在内的所有WebLogic Server服务。 Apache-WebLogic Server插件在Aparhe服务器中作为一个Apache模块运行。Apache Server在启动时会装载Apache模块，然后把HTTP请求交给被装载的Apache模块来处理。Apache模块类似于HTTP(Java) servlets，只是Apache模块是与平台相关的。Apache插件已经过测试，并且可以与Apache Server1.3.9一同使用。

- 106 -

WebLogic管理指南

平台支持

Linux，Solaris与HPUX11等平台都支持Apache-WebLogic Server插件。该插件可以与Apache Server 1.3.9以及Apache Server 1.3.12一起使用。

安装库

在Solaris、Linux以及HPUX11平台上，Apache插件是一个共享对象（.so）。这些文件位于weblogic/lib目录中。

在Solaris上，Apache插件由weblogic/lib/solaris目录中的以下共享对象文件组成：

mod_wl.so mod_wl_ssl.so mod_wl_ssl_raven.so

在Linux上，Apache插件由weblogic/lib/linux目录中的以下共享对象文件组成：

mod_wl.so mod_wl_ssl.so mod_wl_ssl_raven.so

在HPUX11上，Apache插件由weblogic/lib/hpux11目录中的以下共享对象文件组成：

mod_wl.so mod_wl_ssl.so

mod_wl.so是标准Apache(没有EAPI)共享对象。Mod_wl_ssl.so用于Apache+SSL/EAPI安装（Stronghole, modssl等）。Mod_wl_ssl_raven.so用在Apache+Raven安装。此时，需要mod_wl_ssl_raven.so，因为Raven使用了frontpage的补丁，使之与mod_wl_ssl.so不兼容。

上述二进制文件通过了C2Net的Stronghold/3.0 (Apache/1.3.12)以及Covalen的Raven/1.4.3 (Apache/1.3.12)认证。

- 107 -

WebLogic管理指南

安装后的Apache插件是一个Apache DSO（动态共享对象）。Apache对DSO的支持依赖于一个名为mod_so.c的模块，你必须在装载mod_wl.so之前先启用该模块。如果你用所提供的脚本在Solaris上安装Apache，那么mod_so.c已经启用。要确定是否启用了mod_so.c，运行以下命令：

APACHE_HOME/conf/http –l

该命令列出所有已启用的模块，如果其中包含了mod_so.c，那么安照本节末列出的六个步骤来完成Apache插件的安装。如果该命令没有列出mod-so.c，那么请按照相关说明用以下参数手工配置Apache：

./configure –prefix= --enable-module=so

--enable-rule=SHARED_CORE

然后，根据Apache安装指南安装该产品。

安装完Apache并启用了mod_so.c后，你可以用一个名为apxs（Apache eXtenSion）的支持程序来安装Apache插件，该程序会在Apache源文件树之外构建DSO，并在httpd.conf文件中加入这样一个条目：addModule mod_so.c。以下是安装Apache_Weblogic Server插件的步骤：

1．进入weblogic/lib/PLATFORM目录，用以下命令激活weblogic_module：

APACHE_HOME/bin/apxs –i –a –n weblogic mod_wl.so

注意这是一个perl脚本，因此在运行该脚本前，先要安装Perl:

perl APACHE_HOME/bin/apxs –i –a –n weblogic mod_wl.so

2．该命令将把mod-wl.so文件复制到APACHE_HOME/libexec目录，并在httpd.conf文件的weblogic_module块添加了两条语句，同时激活了该模块。验证APACHE_HOME/conf/httpd.conf文件是否加入了以下行：

LoadModule weblogic_module AddModule mod_weblogic.c

3．用以下命令验证APACHE_HOME/conf/httpd.conf 文件的语法是否正确：

APACHE——HOME/bin/apachect1 start

4．配置Apache的httpd.conf配置文件（下节将介绍该文件） 5．启动Weblogic服务器 6．启动Apache

- 108 -

WebLogic管理指南

配置httpd.conf文件

安装完库后，需要修改httpd.conf文件来配置Apache插件。修改httpd.conf文件是为了通知Apache web服务器应该以Apache 模块的形式来装载插件的本地库。该配置文件位于APACHE_HOME/conf/目录中（APACHE_HOMES是安装Apache的根目录）。

在httpd.conf文件中添加设置WebLogic Apache插件的以下信息：

 weblogic_module的配置信息（是由apxs工具所添加的）：

LoadModule weblogic_module libexec/mod_wl.so AddModule mod_weblogic.c（该行不总是被加上）

 确定由Apache插件交给WebLogic处理的HTTP请求类型。你可以通过URL或MIME文件扩展类型来转交该类型的请求。下面将讨论这些选项。

通过URL代理

如果用URL的形式转交HTTP请求，那么要使用位置块与SetHandler。SetHandler指出了Weblogic 模块的处理器，如下所示：

setHandler weblogic_handler

例如：

SetHandler weblogic-handler

SetHandler weblogic-handler

通过这种方式，某些形式的URL被传递到WebLogic Server中进行语义分析。因为PathTrim设置为从URL中剥离/weblogic，因此转发到WebLogic服务器的URL为：

http://myenterprise.server.com:7001

注意，Apache-WebLogic 服务器插件不能将请求转发到multiple

- 109 -

WebLogic管理指南

WebLogic Cluseter。但你可以通过多虚拟主机来实现相同的功能。与位置块中所指定的任何URL匹配的请求将被转发到同一集群中。

通过MIME文件类型代理

如果以MIMI文件扩展类型的方式转发HTTP请求，那么应该在IfModule块中加上MatchExpression语句。例如：

MatchExpression *.jsp ...

在MatchExpression语句可以包含多个表达式，表达式之间用逗号隔开。例如：

example:

MatchExpression *.jsp,*.xyz ...

Apache-WebLogic Server插件的参数

Apache的Weblogic模块识别以下参数。要改变Apache-WebLogic Server插件的属性，你应该把这些参数放在在IfModule中或包含在IfModule中的Weblogic.conf文件。

# Config file for Weblogic which defines the parameters Include conf/weblogic.conf

或者

# define your parameters here.

注意一行只能包含一个参数，在参数与值列表之间不能使用‘=’。例如：

PARAM_1 value1

- 110 -

WebLogic管理指南

PARAM_2 value2 PARAM_3 value3

WebLogicHost domain name

必须使用该参数（如果是WebLogic集群，则应该用WebLogicCluster参数）。HTTP请求将递交到该WebLogic Server主机。

WebLogicPort port

必须使用该参数（如果是WebLogic集群，则应该使用WebLogicCluster参数）。WebLogic Server主机将在该端口监听WebLogic连接请求。

WebLogicCluster cluster list

必须使用该参数（如果你正在使用一个WebLogic集群），该参数列出了在集群中进行负载平衡的WebLogic服务器。集群列表是由冒号分割的host:port条目的一个列表。例如，

WebLogicCluster myweblogic.com:7001,

yourweblogic.com:6999,theirweblogic.com:6001

应该用该参数取代WebLogicHost与WebLogicPort参数。WebLogic Server将首先查找WebLogicCluster参数，如果没有找到该参数，它将寻找并使用WebLogicHost与WebLogicPort参数。

Aparche插件在所有可利用的集群成员中进行简单的负载平衡计算，然后将包含cookie的HTTP请求递交到集群中创建该cookie的服务器。

PathTrim string

要裁减掉的字符串，缺省为“weblogic”。

PathPrepend string

在去除了PathTrim字符串后并在请求被递交到WebLogic之前，将该字符串加到原始URL的前面。缺省为“”。

ConnectTimeoutSecs seconds

Weblogic模块进行WebLogic Server主机连接尝试的最大时间间隔，缺省为10秒，应该大于ConnectRetrysecs。如果超过了ConnectTimeoutSecs所指定的时间还未能连接上，那么将把HTTP 501/Service Unavailable回复发送到客户端。

ConnectRetrySecs seconds

该参数确定了在进行连接WebLogic Server主机尝试之间模块应该休眠的时间。缺省为

- 111 -

WebLogic管理指南

2秒，该参数的值应该小于connectTimeoutSecs参数的值。在将HTTP503/Service Unavailable回复返回到客户端之前，Apache插件每ConnectRetruSecs会进行一次连接尝试。如果ConnectRetrySecs参数的值等于ConnectTimeoutSecs参数的值，那么只会进行一次连接尝试。

StatPath boolean

如果该参数设置为真，那么Apache-Weblogic Server插件会在把请求传递到WebLogic服务器之前检查翻译路径是否存在及其可读权限。

缺省值为false。如果文件不存在，那么把HTTP 404/Not found回复返

回到客户端。如果存在该文件，但是它的读权限不是设置为world-readable，那么将返回HTTP 403/Forbidden回复。在这两种情况下，Apache服务器处理这些回复的缺省机制是完成回复中提的内容。如果WebLogic Server servlet引擎以及Apache Server具有相同的文档根的话，将使用这个选项。

ErrorPage URL

你也可以创建自己的错误页面，当Apache服务器无法将请求递交给WebLogic服务器时，将显示这个页面。把URL设置为错误页面所在的位置。

使用SSL协议

使用安全套接层（SSL）协议可以保护WebLogic服务器代理插件以及Apache服务器之间的连接，保护在WebLogic服务器代理插件与Apache服务器之间所传输的数据的机密性与完整性。此外，使用SSL协议还可以让WebLogic服务器代理插件向Apache服务器进行自我身份验证，从而保证信息被传递到一个truested principal。

WebLogic服务器代理插件不会用传输协议（http或https）来确定代理插件与Apache插件之间的连接是否使用了SSL协议保护。要使用SSL协议，必须把使用代理插件的WebLogic服务器配置为使用SSL协议。WebLogic服务器插件代理使用WebLogic服务器监听SSL通信的端口与Apache服务器通信。

在WebLogic服务器代理插件使用SSL协议，必须在httpd.conf文件中指定以下参数：

SecureProxy ON/OFF

如果WebLogic服务器代理插件与Apache之间的通信采用SSL协议，那么这个参数应该设置为ON，该参数缺省为OFF。在定义这个参数之前，不要忘了先定义WebLogic服务器

- 112 -

WebLogic管理指南

监听SSL请求的端口。

该参数可以在两个层次上定义：在主服务器配置或在虚拟主机配置中定义。如果没有在虚拟主机的配置中指定这个参数，那么它将从主服务器的配置中继承SSL配置。

TrustedCAFile=filename

数字证书所在的文件，该数字证书由可靠的证书管理机构发放并被WebLogic服务器插件使用。如果SecurityProxy参数设置为ON，那么必须设置这个参数。该参数没有缺省值。 文件名必须是数字证书文件的全路径文件名。

RequireSSLHostMatch TRUE/FALSE

该参数决定WebLogic服务器代理插件连接的主机名是否必须与连接代理插件的WebLogic服务器所使用的数字证书中的Subject Distinguished Name字段匹配。参数缺省为TRUE。

SSLHostMatchOID Integer

This parameter is the ASN.1 Object ID (OID) that identifies which field in theSubject Distinguished Name of the peer digital certificate is to be used toperform the host match comparison.缺省为22，对应于Subject Distinguished Name中的CommonName字段。Common OID有以下值：Sur Name—23，Common Name—22，Email—13，Organizational Unit—30，Organization—29，and Locality—26。

与SSL-Apache配置有关的问题

在Apache插件中使用SSL时，应该注意以下两个问题：

 标签中必须使用PathTrim。以下的配置是不正确的：

SetHandler weblogic-handler

WebLogicHost localhost WebLogicPort 7001 PathTrim /weblogic

以下才是正确的配置

SetHandler weblogic-handler

- 113 -

WebLogic管理指南

PathTrim /weblogic

 指令对apache SSL不起作用。避免在apache SSL中使用以下设置：

MatchExpression *.jsp Include weblogic.conf

Httpd.conf文件示例

下面是一个httpd.conf文件的例子。你可以把它作为模板，然后在此基础上对该文件进行修改以与你的环境与服务器相适应。以#开始的行是注释行。请注意apache不区分大小写，apxs工具会自动添加LoadModule与AddModule行。

#################################################### APACHE-HOME/conf/httpd.conf file

####################################################

LoadModule weblogic_module libexec/mod_wl.so

SetHandler weblogic-handler PathTrim /weblogic

ErrorPage http://myerrorpage1.mydomain.com

SetHandler weblogic-handler PathTrim /something

ErrorPage http://myerrorpage1.mydomain.com

MatchExpression *.jsp

WebLogicCluster w1s1.com:7001,w1s2.com:7001,w1s3.com:7001 ErrorPage http://myerrorpage.mydomain.com

# The following line is not always added:

- 114 -

WebLogic管理指南

AddModule mod_weblogic.c

配置文件示例

当然，也可以不在httpd.conf文件中的location块中定义Weblogic参数，而是在weblogic.conf文件中定义Weblogic参数，该文件由httpd.conf文件的IfModule装载。你可以将以下的示例作为模板，然后针对你所使用的环境与服务器做适当的修改。以 ‘#’开始的行是注释。

使用WebLogic集群的例子

# These parameters are common for all URLs which are # directed to the current module. If you want to override # these parameters for each URL, you can set them again in # the or blocks. (Except WebLogicHost, # WebLogicPort, WebLogicCluster, and CookieName.)

WebLogicCluster w1s1.com:7001,w1s2.com:7001,w1s3.com:7001 ErrorPage http://myerrorpage.mydomain.com MatchExpression *.jsp

####################################################

不使用WebLogic集群的例子

# These parameters are common for all URLs which are # directed to the current module. If you want to override # these parameters for each URL, you can set them again in # the or blocks (Except WebLogicHost, # WebLogicPort, WebLogicCluster, and CookieName.)

WebLogicHost myweblogic.server.com WebLogicPort 7001 MatchExpression *.jsp

- 115 -

WebLogic管理指南

配置虚拟主机的例子

NameVirtualHost 172.17.8.1

WebLogicCluster tehama1:4736,tehama2:4736,tehama:4736 PathTrim /x1

ConnectTimeoutSecs 30

WeblogicCluster green1:4736,green2:4736,green3:4736 PathTrim /y1

ConnectTimeoutSecs 20

分发Apache-WebLogic Server插件

在你安装并配置了Apache-WebLogic Server插件后，按照以步骤进行分发与测试：

1．启动WebLogic服务器

2．如果Apache服务器已经运行，为了使新配置生效，必须重启Apache服务器 3．测试Apache插件：打开浏览器，并将URL设置为Apache服务器+ “/weblogic”，这将使用缺省的WebLogic HTTP servlet，如这个例子：

http://myenterprise.server.com/weblogic/

- 116 -

WebLogic管理指南

11 配置Microsoft-IIS插件

本章将介绍如何在Microsoft Internet Information Server中安装与配置WebLogic Server插件。通过插件，可以把WebLogic服务器的HTTP功能平滑地集成到Microsoft IIS中。通过WebLogic-to-IIS插件，客户端可以透明地访问WebLogic中的资源，从而增强了IIS的功能。 主要介绍以下内容：

 概述  安装库

 更新IIS设置使代理可以代理到WebLogic  创建iisproxy.ini文件  使用SSL协议

 将servlets从IIS代理到WebLogic Server  安装测试

概述

如果要让IIS处理静态页面而把动态页面如HTTP Servlets与JSP交给WebLogic服务器处理，那么就需要用到IIS插件。WebLogic服务器可能运行在另一个进程，也可能是在另一主机上。但对于终端即浏览器用户而言，转交给WebLogic处理的HTTP请求与由IIS处理的请求都来自相同的服务器。运行在后端的WebLogic服务器是不可见的。WebLogic客户-服务器协议的HTTP隧道功能可以在插件中使用，因而也就提供了对所有WebLogic服务的访问，而不仅仅是HTTP servlets

连接池以及保持活动状态

通过把插件和WebLogic服务器的连接放在一个可重用的连接池中，可以使得WebLogic Server ISAPI插件具有极高的性能。ISAPI插件会自动保持插件与WebLogic服务器连接的活动状态。如果一个连接处于非活动状态的时间

- 117 -

WebLogic管理指南

超过30秒，那么该连接将自动关闭。

有关兼容WebLogicISAPI插件的平台的最新信息，请见以下网站中的“平台支持”页面：

http://www.weblogic.com/platforms/index.html

安装库

在NT上，WebLogic ISAPI是作为一个动态链接库“iisproxy.dll”来分发的。该文件位于weblogic/bin目录下。 要安装ISAPI插件：

1．启动WebLogic服务器 2．启动IIS

3.按照下面的说明修改IIS设置 4．创建初始化文件 5．测试安装

更新IIS设置使请求转给WebLogic

要使用IIS能与webLogic服务器ISAPI一同工作，你需要做以下配置：

1． 将iisproxy.dll文件复制到一个可以被IIS所使用的目录中，而且该目录中应该包含iisporix.ini文件

2． 选择Microsoft IIS启动菜单，启动IIS服务管理器

3． 在服务管理器的左窗格中，选择你的web站点（缺省为“缺省Web站点”）。 4． 选工具栏中的“Play”(编者注:中文版应该为”启动项目”)箭头来启动站点

5． 在左窗格中，用鼠标右键点选你所选择的web站点，打开这个站点的属性设置。在Properties(属性)窗格中，选择Home Directory(编者注:中文版为”主目录”)标签，在Applications Setting(编者注:中文版为”应用程序设置”)部分点Configuration(编者注:中文版为”配置”)按钮。

6． 在App Mapping(应用程序映射)标签页中，点Add按钮选择要转交给WebLogic服务

- 118 -

WebLogic管理指南

器处理的文件类型。

在对话框中，找到“iisproxy.dll”文件，缺省情况下，该文件位于WebLogic服务器产品的weblogic/bin目录下

7． 设置要委托给WebLogic服务器处理的文件类型的扩展名。 a. 不选”Script engine”(编者注:中文版为”脚本引擎”)复选框。

b. 不选“Check that file exists”(编者注:中文版为”检查文件是否存在”)复选框 c. 设定”Method exclusions”符合安装的安全惯例.

e. 完成上述步骤后，点OK按扭保存所做的设置，然后对每一种要交给WebLogic处理的文件类型都重复上述步骤。

注意与NSAPI插件不同的是，NSAPI可以基于目录结构提供文件服务，而ISAPI插件可以基于文件类型（文件扩展名）或者路径来提供文件服务。通常的配置是使IIS通过JSP扩展名来提供JSP页面服务。详细内容，你可以参见10-8页的“通过路径代理页面请求”

在配置完所有要代理的文件类型后，点OK按钮关闭Properties窗格

创建iisProxy.ini文件

必须为iisproxy.dll创建一个.ini文件。WebLogic服务器会按照以下顺序来寻找iisproxy.ini文件。

1． iisproxy.dll所在的目录

2. 被Windows注册表所引用的WebLogic服务器最新版本所在的目录。如果WebLogic服务器在这个目录下没有找到iisproxy.ini文件，那么它会在Windows注册表中所引用老WebLogic服务器版本所在的安装目录下查找iisproxy.ini文件。 3． C:\\weblogic

我们建议你把该初始化文件放在与iisproxy.dll相同的目录中。 初始化文件包含了以下变量的设置，其形式为:名字=值 WebLogicHost=域名或者虚拟主机名

HTTP请求被转交到的WebLogic主机（或者是运行在WebLogic服务器中的Web服务器中所定义的虚拟主机名）。例如：WebLogicHost=localhost。

WebLogicPort=端口号

- 119 -

WebLogic管理指南

WebLogic主机监听WebLogic连接请求的端口。例如：WebLogicPort=7001。

WebLogiCluster=集群列表

一个集群中的所有WebLogic服务器列表。该列表是一组由逗号分隔开的host:port条目。例如：myweblogic.com:7001,yourweblogic.com:7001。

插件可以在集群的所有成员之间通过轮询算法实现简单的负载平衡。该列表是服务器以及插件维护动态集群列表的起始点。WebLogic服务器同插件一起根据新加入的、失败的与恢复了的集群成员来自动地更新集群列表。

此外，插件会把包含cookie的HTTP请求引导到最初创建该cookie的集群成员。

ConnectTimeoutSecs=秒数

插件对WebLogic服务器主机进行连接尝试的最大时间间隔。缺省为10秒。该属性值应该大于ConnectRetrySecs属性值。如果超过了ConnecTimeoutSecs属性所指定的时间，即使进行了适当次数连接尝试，还未能成功（见ConnectRetrySecs），那么将返回HTTP 503/Service Unavaiable给客户端。例如，ConnectTimeSecs=20。

ConnectRetrySecs=秒数

在两次连接尝试之间的时间间隔。缺省为2秒，该参数值应该不大于ConnectTimeoutSecs参数值。在将HTTO 503/Service UnavailableSecs返回给客户端之前，插件会做ConnectTimeoutSecs/ConnectRetrySecs次连接尝试。如果不想让插件重试，那么把ConnectRetrySecs设为与ConnectTimeoutSecs相等。例如，ConnectRetrySecs=5。

ErrorPage=url

你可以创建一个错误页面，当IIS不能把请求转交给WebLogic服务器时，它就用这个页面来响应请求。将url设为错误页面所在的位置。

CookieName=cname

如果你在WebLogic服务器中改变了会话cookie的名字，相应地要在iisproxy.ini文件中加上这个属性。WebLogic会话cookie在特定于WebLogic的分发描述符文件，weblogic.xml的元素中用CookieName属性定义（参见http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#session-descriptor）

Debug ON/OFF/HFC/HTW/HFW/HTC/ALL

该属性设置了进行调试时的日志记录类型，不建议在生产系统中使用这些调试选项。 调试信息保存在c:/temp/wlproxy.log文件中

该参数的设置有以下选项（HFC, HTW, HFW以及HTC选项可以联合使用，选项之间用逗

- 120 -

WebLogic管理指南

号隔开，例如“HFC, HTW”）： ON

只记录报告性消息与错误消息

OFF

不记录调试信息

HFC

记录来自客户端消息、报告性消息以及错误消息的消息头。

HTW

记录发送到WebLogic服务器消息的消息头，报告性消息以及错误消息

HFW

记录来自WebLogic服务器消息的消息头，报告性消息与错误消息

HTC

记录发送到客户端消息的消息头，报告性消息与错误消息

ALL

记录发送到客户端以及客户端发送的消息的头，发送到WebLogic服务器以及WebLogic服务器发送的消息的消息头，报告性消息，错误消息。 缺省值为“OFF”

DebugConfigInfo=ON/OFF

该参数的设置决定是否启用特殊查询参数“__WebLogicBridgeConfig”。用这个查询参数获得插件的配置参数。

例如，如果把DebugConfigInfo设置为ON，那么“__WebLogicBridgeConfig”查询参数被起用。发送一个如下的请求：

http://www.mywebserver.com:8000/weblogic/foo.jsp?__WebLogicBridgeConfig

插件会把配置信息返回到浏览器。注意这种情况下，不能连接到WebLogic服务器。 该参数只用在调试过程中，消息的输出格式随版本的变化而不同。处于安全性的考虑，建议你在生产系统中把该参数设置为OFF

DefaultFileName=filename

如果URI是“/”，那么缺省的文件名被附加在URL后面，这样可以防止WebLogic服务器的重定向。DefaultFileName应该设置为WebLogic服务器的缺省欢迎也面。如果DefaultFileName设置为welcom.html，那么下面的这个HTTP请求：“http://somehost/weblogic” 变为:

- 121 -

WebLogic管理指南

http://somehost/weblogic/welcome.html” 。只有当所有被重定向到的Web应用指定相同的欢迎页面，该参数才起作用。例如，把欢迎页面都设置为welcome.html

HungServerRecoverSecs =seconds

该参数定义了插件等待WebLogic服务器响应的时间。如果过了HungServerRecoverSecs时间，WebLogic服务器没有响应请求，插件就认为该服务器死了,并失败转移(fail over)到另一台服务器。该参数的最小设置为10，最大设置为600，缺省为300。

Idempotent =ON/OFF

这是一个URL级别的标志。缺省值为”ON”，这意味着如果服务器没有在HungServerRecoverSecs时间内响应，那么插件会进行失败转移。如果设置为”OFF”，插件不会进行失败转移。根据不同的URL或Mime类性，该参数可以有不同的设置。该参数应该设为一个比较大的值。如果是设置的值小于servlet的处理时间，就会得到意想不到的结果。

PathPrepend=string

在PathTrim被裁减(trim)之后，请求转交给WebLogic之前，加在原始URL之前的字符串。该参数的缺省值为””。

WlForwardPath=string

如果wlForwardPath设置为空，那么iis把所有请求交给iis.proxy处理。如果只转交某一特定字符串开头的请求，那么应该设置wlForwardPath参数。例如，把wlForwardPath设置为/weblogic，那么所有以/weblogic开头的请求都被转交给WebLogic服务器。该参数的缺省值为””。如果使用路径方式的请求代理，那么必须设置该参数。

MaxPostSize

如果内容的长度超过MaxPostSize，插件会返回一个错误消息。如果设置为-1，不会检查那么Post数据的长度。设置该参数可以防止通过发送大量数据使服务器超载的拒绝服务攻击。该参数的缺省值为-1。

文件扩展名方式的请求代理

ISAPI模块能够把那些在Internet Service Manager注册的代理文件类型的文件转交给WebLogic服务器处理。例如，你注册了”.jsp”类型代理，那么所有扩展名为”.jsp”的请求都将转交给WebLogic处理。

位于URL的服务器与端口部分后面的路径信息会直接传递给WebLogic。例如

- 122 -

WebLogic管理指南

从IIS请求以下URL：“http://myiis.com:80/jspfiles/myfile.jsp” ，转交给WebLogic的URL变为：

http://WebLogic:7001/jspfiles/myfile.jsp

路径方式的请求代理

如果以路径的方式代理请求：

1．把iisforward.dll放在iisproxy.dll所在的目录中，并且在IIS中加入iisfoward.dll作为过滤器服务(WebSite “Properties” -\"ISAPI Filters\" tab -> “Add” the iisforward.dll）。 2．把.wlforward注册为由iisproxy.dll处理的一种特殊文件类型。

3．在iisproxy.ini文件中添加“wlForwardPath”属性。例如：WlForwardPath=/weblogic。 4．如果需要，在iisproxy.ini文件加入PathTrim参数。例如使用WlForwardPath=/weblogic, PathTrim=/weblogic对要转发到WebLogic服务器的请求URL进行裁减，因此/weblogic/session转变为/session。

5．如果用户希望直接用http://someroot.com/ 把请求转交给WebLogic服务器处理，那么还应该在iisproxy.ini文件中设置DefaultFileName参数。

6．如果要改变参数设置，特别是DefaultFileName, Debug, PathTrim, PathPrepend以及WlForwardPath参数，那么应该启动“IIS管理服务”（在控制窗格的services下）。 7．如果在iisproxy.ini文件中Debug参数设置为ON，那么会生成一个用于调试的”c:\mp\\iisfoward.log”文件。

.ini文件示例

这是一个不使用WebLogic集群情况下的iisproxy.ini文件示例。注释行以‘#’号开始。

# This file contains initialization name/value pairs

# for the IIS/WebLogic plug-in. WebLogicHost=localhost WebLogicPort=7001 ConnectTimeoutSecs=20 ConnectRetrySecs=2

- 123 -

WebLogic管理指南

下面是使用了weblogic集群情况下的iisproxy.ini文件示例。注释行以‘#’号开始。

# This file contains initialization name/value pairs # for the IIS/WebLogic plug-in.

WebLogicCluster=myweblogic.com:7001,yourweblogic.com:7001 ConnectTimeoutSecs=20 ConnectRetrySecs=2

使用SSL

使用安全套接层（SSL）协议可以保护WebLogic服务器代理插件以及IIS服务器之间的连接，保护在WebLogic服务器代理插件与IIS服务器之间所传输的数据的机密性与完整性。此外，使用SSL协议还可以让WebLogic服务器代理插件向IIS服务器进行自我身份验证，从而保证信息被传递给可靠委托人(truested principal)。

WebLogic服务器代理插件不会用传输协议（http或https）来确定代理插件与IIS插件之间的连接是否使用了SSL协议保护。要使用SSL协议，必须把使用代理插件的WebLogic服务器配置为使用SSL协议。WebLogic服务器插件代理使用WebLogic服务器监听SSL通信的端口与IIS服务器通信。 在WebLogic服务器代理插件使用SSL协议，必须在iisproxy.ini文件中指定以下参数： SecureProxy ON/OFF

如果WebLogic服务器代理插件与IIS之间的通信采用SSL协议，那么这个参数应该设置为ON，该参数缺省为OFF。在定义这个参数之前，不要忘了先定义WebLogic服务器监听SSL请求的端口。

该参数可以在两个层次上定义：在主服务器配置或在虚拟主机配置中定义。如果没有在虚拟主机的配置中指定这个参数，那么它将从主服务器的配置中继承SSL配置。

TrustedCAFile=filename

数字证书所在的文件，该数字证书由可靠的证书管理机构发放并被WebLogic服务器插件使用。如果SecurityProxy参数设置为ON，那么必须设置这个参数。该参数没有缺省值。 文件名必须是数字证书文件的全路径文件名。

RequireSSLHostMatch TRUE/FALSE

该参数决定WebLogic服务器代理插件连接的主机名是否必须与连接代理插件的

- 124 -

WebLogic管理指南

WebLogic服务器所使用的数字证书中的Subject Distinguished Name字段匹配。参数缺省为TRUE。

SSLHostMatchOID Integer

This parameter is the ASN.1 Object ID (OID) that identifies which field in theSubject Distinguished Name of the peer digital certificate is to be used toperform the host match comparison.缺省为22，对应于Subject Distinguished Name中的CommonName字段。Common OID有以下值：Sur Name—23，Common Name—22，Email—13，Organizational Unit—30，Organization—29，and Locality—26。

将servlets请求转交给WebLogic服务器处理

如果把iisforward.dll注册成一个过滤器，就可以使用路径方式代理Servlets请求。你可以用类似以下格式的URL调用servlet http:\\\\weblogic:7001\\weblogic\\snoop

如果没有注册iisforward.dll，那么必须以扩展名方式代理servlets请求。以下是使用扩展方式将servlet请求转交给WebLogic服务器处理的三个步骤：

1．在IIS注册一种文件类型（扩展名）。详细内容，可以参见“更新IIS设置使请求转给WebLogic”。

2．在Web应用中注册servlet。有关注册servlets的详细内容，可以参见“配置Servlets”中的内容。

3．用以下模式的URL访问servlet

http://www.myserver.com/virtualName/anyfile.ext

virturalName是在Web应用分发描述符的元素中为servlet定义的URL模式。Ext是在IIS中注册的文件类型（文件扩展名），这种文件类型由WebLogic服务器处理。URL的anyfile部分被忽略。 注意：

 servlet调用的所有图形连接也必须在IIS中注册相应类型(例如:.gif和.jpg)以能够代理。

 如果被调用的servlet调用了其它servlets，那么这些链接也必须使用上面所提

- 125 -

WebLogic管理指南

到的URL模式。

安装测试

在安装并配置了ISAPI插件后，按以下步骤分发并测试ISAPI插件：

1．运行WebLogic与IIS

2．在Web应用的文档根下保存一个用来测试ISAPI插件的JSP文件。打开浏览器，URL设置为IIS+filename.jsp。例如：

http://myii.server.com/filename.jsp

- 126 -

WebLogic管理指南

12 配置Netscape插件

本章将介绍如何配置Netscape Enterprise Server(NES)代理插件。通过插件，可以把WebLogic的HTTP功能平滑地集成到NES中，客户端可以透明地访问webLogic中的资源，从而增强了NES的功能。 主要介绍以下内容：

 概述  配置插件  使用SSL

 使用NASAPI时，有关WebLogic服务器集群失败转移的注意事项  obj.con文件示例（不使用WebLogic集群）  obj.con文件示例（使用WebLogic集群）

概述

插件用于这样的环境之中：NES提供静态网页服务，而WebLogic服务器（运行在另一个进程之中，也可能是另一主机之中）则负责提供对动态页面的服务（例如JSP以及HTTP Servlet生成的页面）。WebLogic服务器与NSAPI插件之间的通信可以是明文的也可以使用SSL。对于终端用户即浏览器而言，提交给WebLogic服务器的HTTP请求与静态网页来自相同的源。也就是说，后端的WebLogic是不可见的。而且WebLogic客户-服务器协议的HTTP-隧道功能可以作为插件运行，因此，通过它可以访问所有WebLogic服务（而不仅仅是动态网页）。

WebLogic插件在Enterprise服务器中被当作一个NSAPI模块运行。NES在启动时会装载NSAPI模块，然后某些类型的HTTP请求就交由该模块处理。NSAPI类似于HTTP(Java) servlet。只是NSAPI模块是与平台有关的。

连接池和保持激活

通过使用插件到WebLogic服务器的可重用连接池，WebLogic Server

- 127 -

WebLogic管理指南

NSAPI插件提供了高效率的性能。NSAPI插件自动实现了在插件和WebLogic 服务器之间“保持激活”的连接。如果连接超过30秒不活动，连接将被关闭。

插件的配置

配置NSAPI插件有以下四个步骤：

1．把相关的NSAPI库文件复制到NES的安装目录中。 2．修改obj.conf文件

3．更改NES配置目录中的mimes.types文件 4．分发并测试NSAPI插件

步骤1：复制库

在UNIX平台上WebLogic NSAPI插件模块作为共享对象（.so文件）分发，在Windows平台上作为动态连接库分发。这些文件分别位于WebLogic分发的/lib于/bin目录中。从平台支持表(http://e-docs.bea.com/wls/docs60/../platforms/index.html#plugin)中选择适合于您的环境的库文件。然后将所选择的库文件复制到NES所在的文件系统中。

步骤2：设置obj.conf文件

为了使用NSAPI插件，需要修改NES的obj.conf文件。包括以下改动：

 指示NES将本地库装载为NSAPI模块的代码  应该交由NSAPI插件处理的请求类型的对象定义

 允许通过NSAPI插件使用WebLogic协议的HTTP-协议隧道功能的可选代码。

以下是配置obj.conf文件的步骤

a． 找到并打开obj.conf文件

用于NES实例的obj.conf文件位于以下位置：

NETSCAPE_HOME/https-INSTANCE_NAME/config/obj.conf

其中，NETSCAPE_HOME是安装NES的根目录，INSTANCE_HOME是正在使用的特定实例

- 128 -

WebLogic管理指南

或服务器配置。例如，在一台叫作goldengate的UNIX机器中，你可以在以下位置找到obj.conf文件。

/usr/local/netscape/enterprise-351/https-goldengate/config/obj.conf

b． 指示NES将本地库装载为一个NSAPI模块

在obj.conf文件的开头加入以下代码行。这些行指示NES应该把本地库（共享对象或dll）装载为一个NSAPI模块。

Init fn=\"load-modules\" funcs=\"wl-proxy,wl-init\"\\ shlib=/usr/local/netscape/plugins/SHARED_LIBRARY Init fn=\"wl-init\"

这里的SHARD_LIBRARY是你在第一步中所安装的共享对象或dll（例如libproxy.so）。功能“load-modules”表明在NES启动时要装载的共享库。值“wl-proxy”与“wl-init”标识了NSAPI插件将执行的功能。

c． 声明交由NSAPI插件处理的请求

所有经过NSAPI插件传递给WebLogic服务器的请求都必须在位于obj.conf文件中的对象定义中声明。有两种方式识别这些请求：通过MIME文件扩展，或者通过请求的URL中的特定字符串（被称为ppath）

无论是使用MIME方式还是ppath方式来代理请求，你都应该在