排除 J2CA 连接池故障

问题描述
根据其规范，J2EE 连接器体系结构 (J2EE Connector Architecture, J2CA) 定义了“一种用于将 J2EE (Java 2 Platform Enterprise Edition) 平台连接到异构 EIS 的标准体系结构。企业信息系统提供对企业的业务流程至关重要的信息基础结构。EIS 示例包括关系数据库、企业资源规划 (Enterprise resource planning, ERP) 系统、大型机事务处理系统和原有数据库系统”。作为 J2EE 的一部分，WebLogic Server J2CA 支持（在文档中也称为“连接器”支持或“资源适配器”支持）“扩展其系统...以支持连接器体系结构并继而保证与多个 EIS 的无缝连接”。

此支持模式显示 WebLogic Server 内的“连接器层 (layer)”与已部署的 J2CA 适配器和 WebLogic 的事务管理器进行交互的方式。它显示使用调试属性查看缓冲连接、本地事务和分布式 XA 事务的生命周期的过程。此模式内的信息基于在 WebLogic Server 8.1 版本内 J2CA 的实现方式。

本文档仅考虑 WebLogic Server 内的 J2CA 连接器层 (layer)。Weblogic Integration 中与外部系统实现互操作性的增值功能不在本文档考虑之列。

J2CA 故障排除
J2CA 是一种互操作性标准。某些特定故障排除步骤需要同时具有 WebLogic Server、J2CA 和所访问的企业信息系统 (Enterprise Information System, EIS) 等方面的知识，因此不在常规故障排除文档的范围之内。此模式并非演示而是试图找出 WebLogic 和 J2CA 适配器之间最复杂交互的两个领域的基线行为，这两个领域包括：连接处理和事务处理。这样，适配器开发人员和应用程序部署人员便可更容易地发现与此基线之间的偏差。

此“基线”使用 javasoft BlackBox Adapter，并具有可从 WebLogic“jconnector”API 示例中的 EJB 访问的保留为默认值的所有部署描述符。请参阅外部资源

快速链接

调试 WebLogic 和 J2CA 连接器之间的交互
以下为用于帮助排除故障的调试属性：

名称 输出（如果属性已设置为 true）
DebugConnectorDumpToLog 调试消息写入日志文件。
DebugConnectorDumpToConsole 调试消息写入标准输出。
DebugConnectorXAResource 将记录事务和连接的相关信息（不只包括 XA：还包括本地和非事务信息），例如，在使用此属性设置时连接事件将被记录。
DebugConnectorAllocConnection 连接代理测试、建立和破坏被管连接失败、连接终止、建立 ConnectionInfo、初始化 SecurityContext、附加资源主要资源参考管理、使用 Credential 类型映射以及使用应用程序托管的安全性。
DebugConnectorFreeConnection 连接超时/释放回池，强制清理期间出错。
DebugConnectorGetConnection 尝试从其它应用程序访问 EAR 中的 RAR。
DebugConnectorPoolManagement 连接共享/计数、ConnectionInfo 析构、连接匹配、保留/释放连接。备注：包含此属性目的仅在于保证完整性。其输出过于冗长而不适合大多数故障排除目的。

返回页首

WebLogic 的特定于容器的部署描述符 weblogic-ra.xml
WebLogic 自身的 J2CA 部署描述符类似于 EJB 的部署描述符 (weblogic-ejb-jar.xml) 和 Web 应用程序的部署描述符 (weblogic.xml)，某种程度上用于控制特定于 weblogic 的扩展规范，还可与 WebLogic 的 JDBC 连接池共享许多标志 (flage) 和底层代码，并且还可提供与 J2CA 适配器交互时可修改 WebLogic 连接器层 (layer) 默认行为的标志。这些属性大部分来自于规范所未涉及的领域，或来自于 BEA 在解释 J2CA 规范的实践中遇到分歧时所涉及的不十分明确的领域。

此份不完全列表显示可修改规范遵从性的描述符元素，因此可以允许实施某一解决办法而无需对适配器源代码进行修改。

元素 缺省值 作用
inactive-connection-timeout-seconds 0 经过指定秒数后向池内返回一个被管连接。用于解决应用程序不能将连接返回池内的情况。
match-connections-supported
 true 用于解决资源适配器的 matchManagedConnection() 方法不能与 WebLogic 一起工作的情况。
use-connection-proxies 执行测试 为了允许更智能化地登记事务中的被管连接，WebLogic 通过代理访问 ManagedConnection 对象。在使用某些资源适配器的情况下，这将导致 ResourceExceptions 或 ClassCastExceptions。设置为 false 将禁用测试，设置为 true 将总是使用代理。
res-auth null 允许部署人员忽略由客户端应用程序所指定的授权机制。

请参阅 weblogic-ra.xml。

返回页首
连接池
在 WebLogic Server 8.1 版本中，J2CA 和 JDBC 连接池共享同一个基础代码基进行池和管理，因为二者均使用通过网络连接 J2EE 应用程序服务器到外部系统的标准化 API。但二者之间存在重要差异：J2CA 必须要有适配器才能支持应用程序服务器连接缓冲机制，并且 J2CA 不必为与之交互的外部系统假定一个特定语法模型（JDBC 在其语句和 SQL 支持中需要特定语法模型）。

以下摘录来自使用 javasoft BlackBoxAdapter 成功运行的 WebLogic jconnector 示例（具有所有上述 J2CA 连接调试属性集），从 WebLogic 的角度显示这些生命周期事件。

部署/初始被管的连接创建事件
这些事件在部署“资源适配器”文档或启动 WebLogic Server 时发生。
?
部署/初始被管的连接创建事件 典型输出
A. 构造连接池实例。 ####<MMDDYY HH.MM.SS> <Debug> <Connector> <Hostname> <myserver> <main> <<WLS Kernel>> <> <BEA-190002> << BlackBoxNoTx_eis/BlackBoxNoTxConnectorJNDINAME > : Constructed the connection pool : BlackBoxNoTx_eis/BlackBoxNoTxConnectorJNDINAME:eis/BlackBoxNoTxConnectorJNDINAME>
B. 读取配置属性。 ####<MMDDYY HH.MM.SS> <Debug> <Connector> <Hostname> <myserver> <main> <<WLS Kernel>> <> <BEA-190002> << BlackBoxNoTx_eis/BlackBoxNoTxConnectorJNDINAME > : Found a config-property for a Bean method. configName=ConnectionURL, configValue="jdbc:pointbase:server://localhost/demo" ...>
C. 使用定义的安全认证逻辑开始分配初始被管的连接。循环步骤 C 至 E 直到建立了所有所需的初始连接。 ####<MMDDYY HH.MM.SS> <Debug> <Connector> <Hostname> <myserver> <main> <<WLS Kernel>> <> <BEA-190002> << BlackBoxNoTx_eis/BlackBoxNoTxConnectorJNDINAME > : Looking up credentials for initiating principal: weblogic_ra_default>
D. 创建相关事务级别的连接处理程序。 ####<MMDDYY HH.MM.SS> <Debug> <Connector> <Hostname> <myserver> <main> <<WLS Kernel>> <> <BEA-190002> << BlackBoxNoTx_eis/BlackBoxNoTxConnectorJNDINAME > : Creating connection handler with NoTransaction transaction support>
E. 检查被管的连接是否能够通过 weblogic 代理访问。请参阅 WebLogic 的部署描述符 weblogic-ra.xml ####<MMDDYY HH.MM.SS> <Info> <Connector> <Hostname> <myserver> <main> <<WLS Kernel>> <> <BEA-190081> <Testing resource adapter "eis/BlackBoxNoTxConnectorJNDINAME" for viability of connection proxies.>

返回页首

运行时/分配/匹配被管的连接事件
这些事件在客户端应用程序（通常为 servlet 或 ejb 实例）向 WebLogic 的连接器层 (layer) 请求被管的连接时发生。

运行时/分配/匹配被管的连接事件 典型输出
A. ManagedConnectionFactory 中的 allocateConnection()。 <BEA-190002> << ConnectionManagerImpl.allocateConnection() > : called with mcf=com.sun.connector.blackbox.NoTxManagedConnectionFactory@64b5973e, cxReqInfo=com.sun.connector.blackbox.JdbcConnectionRequestInfo@dda1df92>
B. 初始化 security context（为了应用程序托管的安全性，接收传播的 security context）。 <BEA-190002> << BlackBoxNoTx_eis/BlackBoxNoTxConnectorJNDINAME > : Initializing SecurityContext with AppName = BlackBoxNoTx, ModuleName = BlackBoxNoTx, EIS Type = , ResourceId = type=, application=BlackBoxNoTx, module=BlackBoxNoTx, eis=JDBC Database>
C. 使用定义的安全性逻辑为此调用设置 security Principal。 ####< MMDDYY HH.MM.SS> <Debug> <Connector> <Hostname> <myserver> <ExecuteThread: '14' for queue: 'weblogic.kernel.Default'> <<anonymous>> <BEA-190002> << BlackBoxNoTx_eis/BlackBoxNoTxConnectorJNDINAME > : No authenticated user, so looking up anonymous credentials>
D. 保留源自 WebLogic 的内部资源缓冲机制的资源（非特定于 J2CA）。 ####< MMDDYY HH.MM.SS> <Debug> <Connector> <Hostname> <myserver> <ExecuteThread: '14' for queue: 'weblogic.kernel.Default'> <<anonymous>> <BEA-190002> << BlackBoxNoTx_eis/BlackBoxNoTxConnectorJNDINAME > : Entering reserveResource( 10, weblogic.connector.common.internal.ConnectionReqInfo@1830ec7 )>>
E. 输入 WebLogic 的内部 matchResource（非特定于 J2CA，但受规范控制）。 ####< MMDDYY HH.MM.SS> <Debug> <Connector> <Hostname> <myserver> <ExecuteThread: '14' for queue: 'weblogic.kernel.Default'> <<anonymous>> <BEA-190002> << BlackBoxNoTx_eis/BlackBoxNoTxConnectorJNDINAME > : entering ConnectionPool.matchResource(weblogic.connector.common.internal.ConnectionReqInfo@1830ec7) >
F. 输入共享资源逻辑，允许在将重新使用的同一事务中进行多个连接（特定于 J2CA，请参阅“规范 6.9 资源共享”）。 ####< MMDDYY HH.MM.SS> <Debug> <Connector> <Hostname> <myserver> <ExecuteThread: '14' for queue: 'weblogic.kernel.Default'> <<anonymous>> <BEA-190002> << BlackBoxNoTx_eis/BlackBoxNoTxConnectorJNDINAME > : Entering addSharedConnection( weblogic.connector.common.internal.ConnectionInfo@2870b7 )>
G. 此处为在 EIS 系统上执行活动。 - WebLogic 不记录-
H. 在应用程序关闭被管连接时开始释放资源。 ####< MMDDYY HH.MM.SS> <Debug> <Connector> <Hostname> <myserver> <ExecuteThread: '14' for queue: 'weblogic.kernel.Default'> <<anonymous>> <BEA-190002> << BlackBoxNoTx_eis/BlackBoxNoTxConnectorJNDINAME > : Entering releaseOnConnectionClosed( weblogic.connector.common.internal.ConnectionInfo@2870b7 )>
I. 从共享列表中释放连接。 ####< MMDDYY HH.MM.SS> <Debug> <Connector> <Hostname> <myserver> <ExecuteThread: '14' for queue: 'weblogic.kernel.Default'> <<anonymous>> <BEA-190002> << BlackBoxNoTx_eis/BlackBoxNoTxConnectorJNDINAME > : Entering releaseSharedConnection( weblogic.connector.common.internal.ConnectionInfo@2870b7, transactionCompleted = false>
J. 从 WebLogic 内部资源池中释放资源。 ####< MMDDYY HH.MM.SS> <Debug> <Connector> <Hostname> <myserver> <ExecuteThread: '14' for queue: 'weblogic.kernel.Default'> <<anonymous>> <BEA-190002> << BlackBoxNoTx_eis/BlackBoxNoTxConnectorJNDINAME > : Entering releaseResource( weblogic.connector.common.internal.ConnectionInfo@2870b7)>

返回页首

外部资源

已知问题
您可以定期查看您的 WLS 版本的“发行说明”，以获得有关 Service Pack 中的“已知问题”或“已解决问题”的详细信息，而且还可浏览与 J2CA 连接池有关的问题。  方便起见，下面提供了这些发行说明的链接：
 搜索还将返回“发行说明”，以及其它“支持解决方法”和与 CR 相关的信息（在需要更多帮助？中说明）。如果客户签订了技术支持合同，则可以登录 http://support.bea.com/，登录后会看到为 Solutions 和 Bug Central 提供的 Browse portlet，可在其中按产品版本浏览最新提供的 CR。

返回页首
需要更多帮助？
如果您已经理解这个模式，但仍需要更多帮助，您可以：
  1. 在 http://support.bea.com/ 上查询 AskBEA（例如，使用“J2CA connection pool issues”）以查找其它已发布的解决办法。技术支持合同客户：确保已经登录，可以访问提供的与 CR 有关的信息。
  2. 在 http://newsgroups.bea.com上，向 BEA 的某个新闻组提出更详细具体的问题。
如果这还不能解决您的问题，并且您拥有有效的技术支持合同，您可以通过登录以下网站来打开支持案例：http://support.bea.com/。

反馈

请给我们提供您的意见，说明此支持诊断模式“排除 J2CA 连接池故障”一文是否有所帮助、您需要的任何解释，以及对支持诊断模式的新主题的任何要求。

免责声明：

依据 BEA 与您签署的维护和支持协议条款，BEA Systems, Inc. 在本网站上提供技术技巧和补丁供您使用。虽然您可以将这些信息和代码与您获得 BEA 授权的软件一起使用，但 BEA 并不对所提供的技术技巧和修补程序做任何形式的担保，无论是明确的还是隐含的。

本文档中引用的任何商标是其各自所有者的财产。有关完整的商标信息，请参考您的产品手册。