This is an XML Schema Definition for Geronimo resource adapter
deployment plan. In case the Geronimo resource adapter deployment
plan is provided internally in the resource adapter archive, it
should be names META-INF/geronimo-ra.xml. In case the Geronimo
resource adapter deployment plan is provided externally, the
deployment descriptor can be named anything and provided to the
deploy tool. Alternatively it can be included in the EAR and
referenced by an alt-dd element of the EAR deployment plan. All the
Geronimo resource adapter deployment plan must specify the top level
element as connector with namespace specified as xmlns=
"http://geronimo.apache.org/xml/ns/j2ee/connector-1.2". The default
location for this document is
http://geronimo.apache.org/schemas-1.2/geronimo-connector-1.2.xsd
Import partial schema containing common naming elements, the
imported plan declares elements like ejb-ref, ejb-local-ref,
service-ref,resource-ref, and resource-env-ref required by this
plan schema.
Import Geronimo Services deployment plans. The imported plan
includes complex types like moduleType, environmentType,
dependenciesType, etc. required by this plan schema.
@(#)geronimo-connector_1_5.xsds
]]>
The connector element is the root element of the deployment
descriptor for the resource adapter. Note that the sub-elements
of this element should be as in the given order in a sequence.
It includes geronimo specific information for the resource
adapter library.
The resourceadapter-instance element must have a unique
name.
The connectiondefinition-instance element must have a unique
name.
The admin-object-instance element must have a unique name.
This complex type maps back to adminobjectType complex type in
connectors xsd.
The element adminobject-interface maps back to an
adminobject-interface element in ra.xml. It specifies
the fully qualified name of Java interface of the
administrated object.
The element adminobject-class maps back to an
adminobject-class element in ra.xml. It specifies the
fully qualified name of Java class of the administrated
object.
The element adminobject-instance contains the
configuration for this specific instance of the
administered object type, with a unique name, and values
for any configuration properties necessary for that
administered object type.
A unique name for admin object instance. Used in object
name of gbean for it. Matches message-destination-name
in ejb-jar.xml assembly descriptor.
The element config-property-setting specifies the set of
properties for admin object instance.
The config-property-settingType contains a name-value pair for a
config-property or required-config-property
The name of the property in name-value pair. It
should match the config-property-name in a
config-property in the adminobject element of the
ra.xml file.
The connection-definitionType defines a set of connection
interfaces and classes pertaining to a particular connection
type. This also includes configurable properties for
ManagedConnectionFactory instances that may be produced out of
this set.
The name element uniquely identifies this instance
The connectionfactory-interface is unique in ra.xml so
is used to index into ra.xml. It provides the fully
qualified name of java interface used as
connectionfactory for resource adapter.
The connectiondefinition-instance provides the
configuration for a specific connection.
The unique name of the connection definition instance
used to identify the connection configuration specified
here.
Additional fully qualified name of java interfaces
implemented by the connectionfactory used by the
application apart from the connectionfactory-interface
specified before.
The element config-property-setting specifies the set of
properties for connection instance.
The connectionmanager element specifies the connection
specific settings like transaction, security, and
connection pool.
The connectionmanager element specifies the connection specific
settings like transaction, security, and connection pool.
This empty element indicates that the connection is
authenticated by container and no user authentication is
required. This setting is ignored if res-auth is
provided inr resource-ref.
This empty element indicates no participation of
connection in any transactions.
This empty element indicates participation of
connection in only local transactions involving only
this connection.
The xa-transaction element indicates participation
of connection in multi resource transactions. This
element provides caching information for XA
transaction.
This empty element indicates participation JDBC
resource of local transaction type in XA
transactions.
This empty element indicates connection will not be
pooled at all, which mean every connection request
will open a connection for its own purpose.
This element indicates connection will pooled in
only one connection pool. This element provides
information about single connection pool being
deployed.
This element indicates connection will pooled in
multiple connection pools. This element provides
information about multiple connection pools being
deployed.
This empty element indicates the sharing of same
connection in same transaction if multiple connections
are requested in same transaction.
This empty element indicates the sharing of same
connection in same thread if multiple connections are
requested in same thread.
The maximum number of connection in a connection pool
being deployed. The connection pool will stop filling
once reached this value.
The minimum number of connection in a connection pool
being deployed. The connection pool will try to fill
itself if the number of connections fall below this
value.
The time after which timeout will be thrown if no
connections are available to be loaned in a connection
pool.
The time after which connection will be automatically
considered released.
This element indicates that only one connection
needs to be checked for matching the connection
request. If the connection does not match, it throws
an error to the effect of "please adjust your
configuration and try again".
This element indicates that all the connections need
to be checked for matching the connection request.
This empty field indicated that no connection
settings need to checked and matched, and assumes
that all connections are same and one of them will
be returned back to client.
This empty partition-by-subject field indicates
that connection pool has to be partitioned by
subject field.
This empty partition-by-connectionrequestinfo
field indicates that connection pool has to be
partitioned by connection request information.
The connector element is the root element of the deployment
descriptor for the resource adapter. Note that the sub-elements
of this element should be as in the given order in a sequence.
It includes geronimo specific information for the resource
adapter library.
Reference to environment element defined in imported
"geronimo-module-1.2.xsd"
The element resourceadapter defines the resource
adapters for the connector defined in the document.
The element adminobject maps back to adminobject defined
in ra.xml. It provides specific instance information for
administer object defined in ra.xml. For example, if
topic is declared in the ra.xml this could provide topic
instance information.
Reference to service element defined in imported
"geronimo-module-1.2.xsd".
The outbound-resourceadapterType specifies information about an
outbound resource adapter. The information includes fully
qualified names of classes/interfaces required as part of the
connector architecture specified contracts for connection
management, level of transaction support provided, one or more
authentication mechanisms supported and additional required
security permissions.
If there is no authentication-mechanism specified as part of
resource adapter element then the resource adapter does not
support any standard security authentication mechanisms as part
of security contract. The application server ignores the
security part of the system contracts in this case.
The connection-definitionType defines a set of
connection interfaces and classes pertaining to a
particular connection type. This also includes
configurable properties for ManagedConnectionFactory
instances that may be produced out of this set.
The name element uniquely identifies this instance.
The resourceadapter instance provide resource adapter
instance specific information like configuration
properties and workmanager implementation.
The outbound-resourceadapterType specifies information
about an outbound resource adapter. The information
includes fully qualified names of classes/interfaces
required as part of the connector architecture specified
contracts for connection management, level of
transaction support provided, one or more authentication
mechanisms supported and additional required security
permissions.
If there is no authentication-mechanism specified as
part of resource adapter element then the resource
adapter does not support any standard security
authentication mechanisms as part of security contract.
The application server ignores the security part of the
system contracts in this case.
The resourceadapter instance info is put in a separate optional
element to provide easier more consistent support for 1.0
adapters. The resourceadapter instance provide resource adapter
instance specific information like configuration properties and
workmanager implementation.
The element resourceadapter-name provides a name for
this resource adapter, and it is used to index back to
the resourceadapter-name specified in ra.xml.
The element config-property-setting specifies the set of
properties for resource adapter instance.
Reference to workmanager element defined in imported
"geronimo-naming-1.2.xsd"