web server - Borland Technical Publications

web server - Borland Technical Publications web server - Borland Technical Publications

techpubs.borland.com
from techpubs.borland.com More from this publisher
12.11.2014 Views

Chapter 27 27Using VisiConnect Chapter Important The Java 2 Enterprise Edition (J2EE) Connector Architecture enables EIS vendors and third-party application developers to develop Resource Adapters that can be deployed to any application server supporting the J2EE 1.3 Platform Specification. The Resource Adapter provides platform-specific integration between the J2EE component and the EIS. When a Resource Adapter is deployed to the Borland Enterprise Server, it enables the development of robust J2EE applications which can access a wide variety of heterogeneous EISs. Resource Adapters encapsulate the Java components, and if necessary, the native components required to interact with the EIS. Before using VisiConnect, Borland recommends that you read the Connectors 1.0 specification. For documentation updates, go to www.borland.com/techpubs/bes. VisiConnect service Resource adapters are hosted by Partitions with the VisiConnect Partition Service enabled. Multiple Resource Adapters can be deployed in the same Partition. VisiConnect is responsible for making the connection factories of its deployed Resource Adapters available to the client through JNDI. Thus, the client can look up the connection factory for a specific Resource Adapter using JNDI. Service overview The VisiConnect Service is a complete implementation of the Connectors 1.0 specification, including all optional functionality. Every Resource Adapter object in the deployed Connector is simultaneously both a Resource Adapter object and a CORBA object. Unlike other Connectors implementations, VisiConnect has no restrictions on partitioning. Any number of Resource Adapters can go into any number of Partitions running on any number of machines. Plus, support for distributed transactions protocol allows Resource Adapters to be partitioned arbitrarily. Partitioning enables you to configure the application during deployment to optimize its overall performance. Chapter 27: Using VisiConnect 257

Connection management Connection management VisiConnect built on top of VisiBroker and RMI-IIOP VisiConnect is built on top of Borland VisiBroker. Communication between clients and Resource Adapters, among Resource Adapters, and between Resource Adapters and other CORBA-based applications is all done using IIOP by way of VisiBroker. VisiBroker is fully compliant with the CORBA 2.3 specification which specifies that RMIover-IIOP must be implemented in terms of objects-by-value. RMI-over-IIOP must be implemented in terms of objects-by-value for true interoperability. As such, VisiConnect is interoperable with any other server supporting RMI-over-IIOP. Security credentials are propagated by VisiBroker. This ensures that a client's credentials are propagated from the client to the server. Transactional context is propagated by VisiBroker. This ensures that when a CORBA client begins a transaction and then accesses the Partition, transactional context is propagated in the call to the server and the server uses this transaction context when making calls to various resources in its environment. Two-phased commit transactions are managed by Borland VisiTransact Transaction Manager. Two-phase commit is supported if the Resource Adapter supports it. If the Resource Adapter in use does not support it, then two-phase commit cannot be done. Important The ra.xml deployment descriptor file contains a config-property element to declare a single configuration setting for a ManagedConnectionFactory instance. The resource adapter provider typically sets these configuration properties. However, if a configuration property is not set, the resource adapter deployer is responsible for providing a value for the property. Borland provides its own deployment descriptor for defining connectors and their connection factory properties: ra-borland.xml. See Borland DTDs for more information on using the ra-borland.xml descriptor. In previous versions of BES, you configured the connection pool using the initialcapacity, capacity-delta, cleanup-enabled, and cleanup-delta properties in raborland.xml. They are replaced in BES 6.5 by the pool properties busy-timeout, idletimeout, and wait-timeout, listed in the table below. You do not have to delete the oldstyle properties from ra-borland.xml, but they will no longer have any effect. 258 BES Developer’s Guide

Connection management<br />

Connection management<br />

VisiConnect built on top of VisiBroker and RMI-IIOP<br />

VisiConnect is built on top of <strong>Borland</strong> VisiBroker. Communication between clients and<br />

Resource Adapters, among Resource Adapters, and between Resource Adapters and<br />

other CORBA-based applications is all done using IIOP by way of VisiBroker.<br />

VisiBroker is fully compliant with the CORBA 2.3 specification which specifies that RMIover-IIOP<br />

must be implemented in terms of objects-by-value. RMI-over-IIOP must be<br />

implemented in terms of objects-by-value for true interoperability. As such, VisiConnect<br />

is interoperable with any other <strong>server</strong> supporting RMI-over-IIOP.<br />

Security credentials are propagated by VisiBroker. This ensures that a client's<br />

credentials are propagated from the client to the <strong>server</strong>.<br />

Transactional context is propagated by VisiBroker. This ensures that when a CORBA<br />

client begins a transaction and then accesses the Partition, transactional context is<br />

propagated in the call to the <strong>server</strong> and the <strong>server</strong> uses this transaction context when<br />

making calls to various resources in its environment.<br />

Two-phased commit transactions are managed by <strong>Borland</strong> VisiTransact Transaction<br />

Manager. Two-phase commit is supported if the Resource Adapter supports it. If the<br />

Resource Adapter in use does not support it, then two-phase commit cannot be done.<br />

Important<br />

The ra.xml deployment descriptor file contains a config-property element to declare a<br />

single configuration setting for a ManagedConnectionFactory instance. The resource<br />

adapter provider typically sets these configuration properties. However, if a<br />

configuration property is not set, the resource adapter deployer is responsible for<br />

providing a value for the property.<br />

<strong>Borland</strong> provides its own deployment descriptor for defining connectors and their<br />

connection factory properties: ra-borland.xml. See <strong>Borland</strong> DTDs for more information<br />

on using the ra-borland.xml descriptor.<br />

In previous versions of BES, you configured the connection pool using the initialcapacity,<br />

capacity-delta, cleanup-enabled, and cleanup-delta properties in raborland.xml.<br />

They are replaced in BES 6.5 by the pool properties busy-timeout, idletimeout,<br />

and wait-timeout, listed in the table below. You do not have to delete the oldstyle<br />

properties from ra-borland.xml, but they will no longer have any effect.<br />

258 BES Developer’s Guide

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!