blob: 26d19129c48435b3b4b58681899f21e968bc40b8 [file] [log] [blame]
david_williamse073de12007-04-28 04:01:44 +00001<?xml version="1.0" encoding="UTF-8"?>
2
3<xsd:schema xmlns="http://www.w3.org/2001/XMLSchema"
4 targetNamespace="http://java.sun.com/xml/ns/j2ee"
5 xmlns:j2ee="http://java.sun.com/xml/ns/j2ee"
6 xmlns:xsd="http://www.w3.org/2001/XMLSchema"
7 elementFormDefault="qualified"
8 attributeFormDefault="unqualified"
9 version="1.5">
10 <xsd:annotation>
11 <xsd:documentation>
12 @(#)connector_1_5.xsds 1.27 06/17/03
13 </xsd:documentation>
14 </xsd:annotation>
15
16 <xsd:annotation>
17 <xsd:documentation>
18
19 Copyright 2003 Sun Microsystems, Inc., 901 San Antonio
20 Road, Palo Alto, California 94303, U.S.A. All rights
21 reserved.
22
23 Sun Microsystems, Inc. has intellectual property rights
24 relating to technology described in this document. In
25 particular, and without limitation, these intellectual
26 property rights may include one or more of the U.S. patents
27 listed at http://www.sun.com/patents and one or more
28 additional patents or pending patent applications in the
29 U.S. and other countries.
30
31 This document and the technology which it describes are
32 distributed under licenses restricting their use, copying,
33 distribution, and decompilation. No part of this document
34 may be reproduced in any form by any means without prior
35 written authorization of Sun and its licensors, if any.
36
37 Third-party software, including font technology, is
38 copyrighted and licensed from Sun suppliers.
39
40 Sun, Sun Microsystems, the Sun logo, Solaris, Java, J2EE,
41 JavaServer Pages, Enterprise JavaBeans and the Java Coffee
42 Cup logo are trademarks or registered trademarks of Sun
43 Microsystems, Inc. in the U.S. and other countries.
44
45 Federal Acquisitions: Commercial Software - Government Users
46 Subject to Standard License Terms and Conditions.
47
48 </xsd:documentation>
49 </xsd:annotation>
50
51 <xsd:annotation>
52 <xsd:documentation>
53 <![CDATA[
54
55 This is the XML Schema for the Connector 1.5 deployment
56 descriptor. The deployment descriptor must be named
57 "META-INF/ra.xml" in the connector's rar file. All Connector
58 deployment descriptors must indicate the connector resource
59 adapter schema by using the J2EE namespace:
60
61 http://java.sun.com/xml/ns/j2ee
62
63 and by indicating the version of the schema by
64 using the version element as shown below:
65
66 <connector xmlns="http://java.sun.com/xml/ns/j2ee"
67 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
68 xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
69 http://java.sun.com/xml/ns/j2ee/connector_1_5.xsd"
70 version="1.5">
71 ...
72 </connector>
73
74 The instance documents may indicate the published version of
75 the schema using the xsi:schemaLocation attribute for J2EE
76 namespace with the following location:
77
78 http://java.sun.com/xml/ns/j2ee/connector_1_5.xsd
79
80 ]]>
81 </xsd:documentation>
82 </xsd:annotation>
83
84 <xsd:annotation>
85 <xsd:documentation>
86
87 The following conventions apply to all J2EE
88 deployment descriptor elements unless indicated otherwise.
89
90 - In elements that specify a pathname to a file within the
91 same JAR file, relative filenames (i.e., those not
92 starting with "/") are considered relative to the root of
93 the JAR file's namespace. Absolute filenames (i.e., those
94 starting with "/") also specify names in the root of the
95 JAR file's namespace. In general, relative names are
96 preferred. The exception is .war files where absolute
97 names are preferred for consistency with the Servlet API.
98
99 </xsd:documentation>
100 </xsd:annotation>
101
102 <xsd:include schemaLocation="j2ee_1_4.xsd"/>
103
104
105<!-- **************************************************** -->
106
107
108 <xsd:element name="connector" type="j2ee:connectorType">
109 <xsd:annotation>
110 <xsd:documentation>
111
112 The connector element is the root element of the deployment
113 descriptor for the resource adapter. This element includes
114 general information - vendor name, resource adapter version,
115 icon - about the resource adapter module. It also includes
116 information specific to the implementation of the resource
117 adapter library as specified through the element
118 resourceadapter.
119
120 </xsd:documentation>
121 </xsd:annotation>
122
123 </xsd:element>
124
125<!-- **************************************************** -->
126
127 <xsd:complexType name="activationspecType">
128 <xsd:annotation>
129 <xsd:documentation>
130
131 The activationspecType specifies an activation
132 specification. The information includes fully qualified
133 Java class name of an activation specification and a set of
134 required configuration property names.
135
136 </xsd:documentation>
137 </xsd:annotation>
138
139 <xsd:sequence>
140 <xsd:element name="activationspec-class"
141 type="j2ee:fully-qualified-classType">
142 <xsd:annotation>
143 <xsd:documentation>
144 <![CDATA[
145
146 The element activationspec-class specifies the fully
147 qualified Java class name of the activation
148 specification class. This class must implement the
149 javax.resource.spi.ActivationSpec interface. The
150 implementation of this class is required to be a
151 JavaBean.
152
153 Example:
154 <activationspec-class>com.wombat.ActivationSpecImpl
155 </activationspec-class>
156
157 ]]>
158 </xsd:documentation>
159 </xsd:annotation>
160 </xsd:element>
161 <xsd:element name="required-config-property"
162 type="j2ee:required-config-propertyType"
163 minOccurs="0"
164 maxOccurs="unbounded"/>
165 </xsd:sequence>
166 <xsd:attribute name="id" type="xsd:ID"/>
167 </xsd:complexType>
168
169<!-- **************************************************** -->
170
171 <xsd:complexType name="adminobjectType">
172 <xsd:annotation>
173 <xsd:documentation>
174
175 The adminobjectType specifies information about an
176 administered object. Administered objects are specific to a
177 messaging style or message provider. This contains
178 information on the Java type of the interface implemented by
179 an administered object, its Java class name and its
180 configuration properties.
181
182 </xsd:documentation>
183 </xsd:annotation>
184
185 <xsd:sequence>
186 <xsd:element name="adminobject-interface"
187 type="j2ee:fully-qualified-classType">
188 <xsd:annotation>
189 <xsd:documentation>
190 <![CDATA[
191
192 The element adminobject-interface specifies the
193 fully qualified name of the Java type of the
194 interface implemented by an administered object.
195
196 Example:
197 <adminobject-interface>javax.jms.Destination
198 </adminobject-interface>
199
200 ]]>
201 </xsd:documentation>
202 </xsd:annotation>
203
204 </xsd:element>
205 <xsd:element name="adminobject-class"
206 type="j2ee:fully-qualified-classType">
207 <xsd:annotation>
208 <xsd:documentation>
209 <![CDATA[
210
211 The element adminobject-class specifies the fully
212 qualified Java class name of an administered object.
213
214 Example:
215 <adminobject-class>com.wombat.DestinationImpl
216 </adminobject-class>
217
218 ]]>
219 </xsd:documentation>
220 </xsd:annotation>
221 </xsd:element>
222
223 <xsd:element name="config-property"
224 type="j2ee:config-propertyType"
225 minOccurs="0"
226 maxOccurs="unbounded"/>
227 </xsd:sequence>
228 <xsd:attribute name="id" type="xsd:ID"/>
229 </xsd:complexType>
230
231<!-- **************************************************** -->
232
233 <xsd:complexType name="authentication-mechanismType">
234 <xsd:annotation>
235 <xsd:documentation>
236
237 The authentication-mechanismType specifies an authentication
238 mechanism supported by the resource adapter. Note that this
239 support is for the resource adapter and not for the
240 underlying EIS instance. The optional description specifies
241 any resource adapter specific requirement for the support of
242 security contract and authentication mechanism.
243
244 Note that BasicPassword mechanism type should support the
245 javax.resource.spi.security.PasswordCredential interface.
246 The Kerbv5 mechanism type should support the
247 org.ietf.jgss.GSSCredential interface or the deprecated
248 javax.resource.spi.security.GenericCredential interface.
249
250 </xsd:documentation>
251 </xsd:annotation>
252
253 <xsd:sequence>
254 <xsd:element name="description"
255 type="j2ee:descriptionType"
256 minOccurs="0"
257 maxOccurs="unbounded"/>
258 <xsd:element name="authentication-mechanism-type"
259 type="j2ee:xsdStringType">
260 <xsd:annotation>
261 <xsd:documentation>
262 <![CDATA[
263
264 The element authentication-mechanism-type specifies
265 type of an authentication mechanism.
266
267 The example values are:
268
269 <authentication-mechanism-type>BasicPassword
270 </authentication-mechanism-type>
271
272 <authentication-mechanism-type>Kerbv5
273 </authentication-mechanism-type>
274
275 Any additional security mechanisms are outside the
276 scope of the Connector architecture specification.
277
278 ]]>
279 </xsd:documentation>
280 </xsd:annotation>
281
282 </xsd:element>
283 <xsd:element name="credential-interface"
284 type="j2ee:credential-interfaceType"/>
285 </xsd:sequence>
286 <xsd:attribute name="id" type="xsd:ID"/>
287 </xsd:complexType>
288
289<!-- **************************************************** -->
290
291 <xsd:complexType name="config-property-nameType">
292 <xsd:annotation>
293 <xsd:documentation>
294 <![CDATA[
295
296 The config-property-nameType contains the name of a
297 configuration property.
298
299 The connector architecture defines a set of well-defined
300 properties all of type java.lang.String. These are as
301 follows.
302
303 ServerName
304 PortNumber
305 UserName
306 Password
307 ConnectionURL
308
309 A resource adapter provider can extend this property set to
310 include properties specific to the resource adapter and its
311 underlying EIS.
312
313 Possible values include
314 ServerName
315 PortNumber
316 UserName
317 Password
318 ConnectionURL
319
320 Example: <config-property-name>ServerName</config-property-name>
321
322 ]]>
323 </xsd:documentation>
324 </xsd:annotation>
325 <xsd:simpleContent>
326 <xsd:restriction base="j2ee:xsdStringType"/>
327 </xsd:simpleContent>
328 </xsd:complexType>
329
330<!-- **************************************************** -->
331
332 <xsd:complexType name="config-property-typeType">
333 <xsd:annotation>
334 <xsd:documentation>
335 <![CDATA[
336
337 The config-property-typeType contains the fully
338 qualified Java type of a configuration property.
339
340 The following are the legal values:
341 java.lang.Boolean, java.lang.String, java.lang.Integer,
342 java.lang.Double, java.lang.Byte, java.lang.Short,
343 java.lang.Long, java.lang.Float, java.lang.Character
344
345 Used in: config-property
346
347 Example:
348 <config-property-type>java.lang.String</config-property-type>
349
350 ]]>
351 </xsd:documentation>
352 </xsd:annotation>
353 <xsd:simpleContent>
354 <xsd:restriction base="j2ee:string">
355 <xsd:enumeration value="java.lang.Boolean"/>
356 <xsd:enumeration value="java.lang.String"/>
357 <xsd:enumeration value="java.lang.Integer"/>
358 <xsd:enumeration value="java.lang.Double"/>
359 <xsd:enumeration value="java.lang.Byte"/>
360 <xsd:enumeration value="java.lang.Short"/>
361 <xsd:enumeration value="java.lang.Long"/>
362 <xsd:enumeration value="java.lang.Float"/>
363 <xsd:enumeration value="java.lang.Character"/>
364 </xsd:restriction>
365 </xsd:simpleContent>
366 </xsd:complexType>
367
368<!-- **************************************************** -->
369
370 <xsd:complexType name="config-propertyType">
371 <xsd:annotation>
372 <xsd:documentation>
373
374 The config-propertyType contains a declaration of a single
375 configuration property that may be used for providing
376 configuration information.
377
378 The declaration consists of an optional description, name,
379 type and an optional value of the configuration property. If
380 the resource adapter provider does not specify a value than
381 the deployer is responsible for providing a valid value for
382 a configuration property.
383
384 Any bounds or well-defined values of properties should be
385 described in the description element.
386
387 </xsd:documentation>
388 </xsd:annotation>
389 <xsd:sequence>
390 <xsd:element name="description"
391 type="j2ee:descriptionType"
392 minOccurs="0"
393 maxOccurs="unbounded"/>
394 <xsd:element name="config-property-name"
395 type="j2ee:config-property-nameType"/>
396 <xsd:element name="config-property-type"
397 type="j2ee:config-property-typeType"/>
398 <xsd:element name="config-property-value"
399 type="j2ee:xsdStringType"
400 minOccurs="0">
401 <xsd:annotation>
402 <xsd:documentation>
403 <![CDATA[
404
405 The element config-property-value contains the value
406 of a configuration entry. Note, it is possible for a
407 resource adapter deployer to override this
408 configuration information during deployment.
409
410 Example:
411 <config-property-value>WombatServer</config-property-value>
412
413 ]]>
414 </xsd:documentation>
415 </xsd:annotation>
416 </xsd:element>
417 </xsd:sequence>
418 <xsd:attribute name="id" type="xsd:ID"/>
419 </xsd:complexType>
420
421<!-- **************************************************** -->
422
423 <xsd:complexType name="connection-definitionType">
424 <xsd:annotation>
425 <xsd:documentation>
426
427 The connection-definitionType defines a set of connection
428 interfaces and classes pertaining to a particular connection
429 type. This also includes configurable properties for
430 ManagedConnectionFactory instances that may be produced out
431 of this set.
432
433 </xsd:documentation>
434 </xsd:annotation>
435
436 <xsd:sequence>
437 <xsd:element name="managedconnectionfactory-class"
438 type="j2ee:fully-qualified-classType">
439 <xsd:annotation>
440 <xsd:documentation>
441 <![CDATA[
442
443 The element managedconnectionfactory-class specifies
444 the fully qualified name of the Java class that
445 implements the
446 javax.resource.spi.ManagedConnectionFactory interface.
447 This Java class is provided as part of resource
448 adapter's implementation of connector architecture
449 specified contracts. The implementation of this
450 class is required to be a JavaBean.
451
452 Example:
453 <managedconnectionfactory-class>
454 com.wombat.ManagedConnectionFactoryImpl
455 </managedconnectionfactory-class>
456
457 ]]>
458 </xsd:documentation>
459 </xsd:annotation>
460 </xsd:element>
461 <xsd:element name="config-property"
462 type="j2ee:config-propertyType"
463 minOccurs="0"
464 maxOccurs="unbounded"/>
465 <xsd:element name="connectionfactory-interface"
466 type="j2ee:fully-qualified-classType">
467 <xsd:annotation>
468 <xsd:documentation>
469 <![CDATA[
470
471 The element connectionfactory-interface specifies
472 the fully qualified name of the ConnectionFactory
473 interface supported by the resource adapter.
474
475 Example:
476 <connectionfactory-interface>com.wombat.ConnectionFactory
477 </connectionfactory-interface>
478
479 OR
480
481 <connectionfactory-interface>javax.resource.cci.ConnectionFactory
482 </connectionfactory-interface>
483
484 ]]>
485 </xsd:documentation>
486 </xsd:annotation>
487 </xsd:element>
488
489 <xsd:element name="connectionfactory-impl-class"
490 type="j2ee:fully-qualified-classType">
491 <xsd:annotation>
492 <xsd:documentation>
493 <![CDATA[
494
495 The element connectionfactory-impl-class specifies
496 the fully qualified name of the ConnectionFactory
497 class that implements resource adapter
498 specific ConnectionFactory interface.
499
500 Example:
501
502 <connectionfactory-impl-class>com.wombat.ConnectionFactoryImpl
503 </connectionfactory-impl-class>
504
505 ]]>
506 </xsd:documentation>
507 </xsd:annotation>
508 </xsd:element>
509 <xsd:element name="connection-interface"
510 type="j2ee:fully-qualified-classType">
511 <xsd:annotation>
512 <xsd:documentation>
513 <![CDATA[
514
515 The connection-interface element specifies the fully
516 qualified name of the Connection interface supported
517 by the resource adapter.
518
519 Example:
520
521 <connection-interface>javax.resource.cci.Connection
522 </connection-interface>
523
524 ]]>
525 </xsd:documentation>
526 </xsd:annotation>
527 </xsd:element>
528 <xsd:element name="connection-impl-class"
529 type="j2ee:fully-qualified-classType">
530 <xsd:annotation>
531 <xsd:documentation>
532 <![CDATA[
533
534 The connection-impl-classType specifies the fully
535 qualified name of the Connection class that
536 implements resource adapter specific Connection
537 interface. It is used by the connection-impl-class
538 elements.
539
540 Example:
541
542 <connection-impl-class>com.wombat.ConnectionImpl
543 </connection-impl-class>
544
545 ]]>
546 </xsd:documentation>
547 </xsd:annotation>
548 </xsd:element>
549 </xsd:sequence>
550 <xsd:attribute name="id" type="xsd:ID"/>
551 </xsd:complexType>
552
553<!-- **************************************************** -->
554
555 <xsd:complexType name="connectorType">
556 <xsd:annotation>
557 <xsd:documentation>
558
559 The connectorType defines a resource adapter.
560
561 </xsd:documentation>
562 </xsd:annotation>
563
564 <xsd:sequence>
565 <xsd:group ref="j2ee:descriptionGroup"/>
566 <xsd:element name="vendor-name"
567 type="j2ee:xsdStringType">
568 <xsd:annotation>
569 <xsd:documentation>
570
571 The element vendor-name specifies the name of
572 resource adapter provider vendor.
573
574 </xsd:documentation>
575 </xsd:annotation>
576 </xsd:element>
577 <xsd:element name="eis-type"
578 type="j2ee:xsdStringType">
579 <xsd:annotation>
580 <xsd:documentation>
581
582 The element eis-type contains information about the
583 type of the EIS. For example, the type of an EIS can
584 be product name of EIS independent of any version
585 info.
586
587 This helps in identifying EIS instances that can be
588 used with this resource adapter.
589
590 </xsd:documentation>
591 </xsd:annotation>
592 </xsd:element>
593 <xsd:element name="resourceadapter-version"
594 type="j2ee:xsdStringType">
595 <xsd:annotation>
596 <xsd:documentation>
597
598 The element resourceadapter-version specifies a string-based version
599 of the resource adapter from the resource adapter
600 provider.
601
602 </xsd:documentation>
603 </xsd:annotation>
604
605 </xsd:element>
606 <xsd:element name="license"
607 type="j2ee:licenseType"
608 minOccurs="0"/>
609 <xsd:element name="resourceadapter"
610 type="j2ee:resourceadapterType"/>
611
612 </xsd:sequence>
613 <xsd:attribute name="version"
614 type="j2ee:dewey-versionType"
615 fixed="1.5"
616 use="required">
617 <xsd:annotation>
618 <xsd:documentation>
619
620 The version specifies the version of the
621 connector architecture specification that is
622 supported by this resource adapter. This information
623 enables deployer to configure the resource adapter to
624 support deployment and runtime requirements of the
625 corresponding connector architecture specification.
626
627 </xsd:documentation>
628 </xsd:annotation>
629 </xsd:attribute>
630 <xsd:attribute name="id" type="xsd:ID"/>
631 </xsd:complexType>
632
633<!-- **************************************************** -->
634
635 <xsd:complexType name="credential-interfaceType">
636 <xsd:annotation>
637 <xsd:documentation>
638
639 The credential-interfaceType specifies the
640 interface that the resource adapter implementation
641 supports for the representation of the
642 credentials. This element(s) that use this type,
643 i.e. credential-interface, should be used by
644 application server to find out the Credential
645 interface it should use as part of the security
646 contract.
647
648 The possible values are:
649
650 javax.resource.spi.security.PasswordCredential
651 org.ietf.jgss.GSSCredential
652 javax.resource.spi.security.GenericCredential
653
654 </xsd:documentation>
655 </xsd:annotation>
656 <xsd:simpleContent>
657 <xsd:restriction base="j2ee:fully-qualified-classType">
658 <xsd:enumeration
659 value="javax.resource.spi.security.PasswordCredential"/>
660 <xsd:enumeration
661 value="org.ietf.jgss.GSSCredential"/>
662 <xsd:enumeration
663 value="javax.resource.spi.security.GenericCredential"/>
664 </xsd:restriction>
665 </xsd:simpleContent>
666 </xsd:complexType>
667
668<!-- **************************************************** -->
669
670 <xsd:complexType name="inbound-resourceadapterType">
671 <xsd:annotation>
672 <xsd:documentation>
673
674 The inbound-resourceadapterType specifies information
675 about an inbound resource adapter. This contains information
676 specific to the implementation of the resource adapter
677 library as specified through the messageadapter element.
678
679 </xsd:documentation>
680 </xsd:annotation>
681
682 <xsd:sequence>
683 <xsd:element name="messageadapter"
684 type="j2ee:messageadapterType"
685 minOccurs="0">
686 <xsd:unique name="messagelistener-type-uniqueness">
687 <xsd:annotation>
688 <xsd:documentation>
689
690 The messagelistener-type element content must be
691 unique in the messageadapter. Several messagelisteners
692 can not use the same messagelistener-type.
693
694 </xsd:documentation>
695 </xsd:annotation>
696 <xsd:selector xpath="j2ee:messagelistener"/>
697 <xsd:field xpath="j2ee:messagelistener-type"/>
698 </xsd:unique>
699 </xsd:element>
700 </xsd:sequence>
701 <xsd:attribute name="id" type="xsd:ID"/>
702 </xsd:complexType>
703
704<!-- **************************************************** -->
705
706 <xsd:complexType name="licenseType">
707 <xsd:annotation>
708 <xsd:documentation>
709
710 The licenseType specifies licensing requirements for the
711 resource adapter module. This type specifies whether a
712 license is required to deploy and use this resource adapter,
713 and an optional description of the licensing terms
714 (examples: duration of license, number of connection
715 restrictions). It is used by the license element.
716
717 </xsd:documentation>
718 </xsd:annotation>
719
720 <xsd:sequence>
721 <xsd:element name="description"
722 type="j2ee:descriptionType"
723 minOccurs="0"
724 maxOccurs="unbounded"/>
725 <xsd:element name="license-required"
726 type="j2ee:true-falseType">
727 <xsd:annotation>
728 <xsd:documentation>
729
730 The element license-required specifies whether a
731 license is required to deploy and use the
732 resource adapter. This element must be one of
733 the following, "true" or "false".
734
735 </xsd:documentation>
736 </xsd:annotation>
737 </xsd:element>
738 </xsd:sequence>
739 <xsd:attribute name="id" type="xsd:ID"/>
740 </xsd:complexType>
741
742<!-- **************************************************** -->
743
744 <xsd:complexType name="messageadapterType">
745 <xsd:annotation>
746 <xsd:documentation>
747
748 The messageadapterType specifies information about the
749 messaging capabilities of the resource adapter. This
750 contains information specific to the implementation of the
751 resource adapter library as specified through the
752 messagelistener element.
753
754 </xsd:documentation>
755 </xsd:annotation>
756
757 <xsd:sequence>
758 <xsd:element name="messagelistener"
759 type="j2ee:messagelistenerType"
760 maxOccurs="unbounded"/>
761 </xsd:sequence>
762 <xsd:attribute name="id" type="xsd:ID"/>
763 </xsd:complexType>
764
765<!-- **************************************************** -->
766
767 <xsd:complexType name="messagelistenerType">
768 <xsd:annotation>
769 <xsd:documentation>
770
771 The messagelistenerType specifies information about a
772 specific message listener supported by the messaging
773 resource adapter. It contains information on the Java type
774 of the message listener interface and an activation
775 specification.
776
777 </xsd:documentation>
778 </xsd:annotation>
779
780 <xsd:sequence>
781 <xsd:element name="messagelistener-type"
782 type="j2ee:fully-qualified-classType">
783 <xsd:annotation>
784 <xsd:documentation>
785 <![CDATA[
786
787 The element messagelistener-type specifies the fully
788 qualified name of the Java type of a message
789 listener interface.
790
791 Example:
792
793 <messagelistener-type>javax.jms.MessageListener
794 </messagelistener-type>
795
796 ]]>
797 </xsd:documentation>
798 </xsd:annotation>
799
800 </xsd:element>
801 <xsd:element name="activationspec"
802 type="j2ee:activationspecType"/>
803 </xsd:sequence>
804 <xsd:attribute name="id" type="xsd:ID"/>
805 </xsd:complexType>
806
807<!-- **************************************************** -->
808
809 <xsd:complexType name="outbound-resourceadapterType">
810 <xsd:annotation>
811 <xsd:documentation>
812
813 The outbound-resourceadapterType specifies information about
814 an outbound resource adapter. The information includes fully
815 qualified names of classes/interfaces required as part of
816 the connector architecture specified contracts for
817 connection management, level of transaction support
818 provided, one or more authentication mechanisms supported
819 and additional required security permissions.
820
821 If there is no authentication-mechanism specified as part of
822 resource adapter element then the resource adapter does not
823 support any standard security authentication mechanisms as
824 part of security contract. The application server ignores
825 the security part of the system contracts in this case.
826
827 </xsd:documentation>
828 </xsd:annotation>
829
830 <xsd:sequence>
831 <xsd:element name="connection-definition"
832 type="j2ee:connection-definitionType"
833 maxOccurs="unbounded"/>
834 <xsd:element name="transaction-support"
835 type="j2ee:transaction-supportType"/>
836 <xsd:element name="authentication-mechanism"
837 type="j2ee:authentication-mechanismType"
838 minOccurs="0"
839 maxOccurs="unbounded"/>
840 <xsd:element name="reauthentication-support"
841 type="j2ee:true-falseType">
842 <xsd:annotation>
843 <xsd:documentation>
844
845 The element reauthentication-support specifies
846 whether the resource adapter implementation supports
847 re-authentication of existing Managed- Connection
848 instance. Note that this information is for the
849 resource adapter implementation and not for the
850 underlying EIS instance. This element must have
851 either a "true" or "false" value.
852
853 </xsd:documentation>
854 </xsd:annotation>
855
856 </xsd:element>
857 </xsd:sequence>
858 <xsd:attribute name="id" type="xsd:ID"/>
859 </xsd:complexType>
860
861<!-- **************************************************** -->
862
863 <xsd:complexType name="required-config-propertyType">
864 <xsd:annotation>
865 <xsd:documentation>
866 <![CDATA[
867
868 The required-config-propertyType contains a declaration
869 of a single configuration property used for specifying a
870 required configuration property name. It is used
871 by required-config-property elements.
872
873 Example:
874
875 <required-config-property>Destination</required-config-property>
876
877 ]]>
878 </xsd:documentation>
879 </xsd:annotation>
880
881 <xsd:sequence>
882 <xsd:element name="description"
883 type="j2ee:descriptionType"
884 minOccurs="0"
885 maxOccurs="unbounded"/>
886 <xsd:element name="config-property-name"
887 type="j2ee:config-property-nameType"/>
888 </xsd:sequence>
889 <xsd:attribute name="id" type="xsd:ID"/>
890 </xsd:complexType>
891
892<!-- **************************************************** -->
893
894 <xsd:complexType name="resourceadapterType">
895 <xsd:annotation>
896 <xsd:documentation>
897
898 The resourceadapterType specifies information about the
899 resource adapter. The information includes fully qualified
900 resource adapter Java class name, configuration properties,
901 information specific to the implementation of the resource
902 adapter library as specified through the
903 outbound-resourceadapter and inbound-resourceadapter
904 elements, and an optional set of administered objects.
905
906 </xsd:documentation>
907 </xsd:annotation>
908
909 <xsd:sequence>
910 <xsd:element name="resourceadapter-class"
911 type="j2ee:fully-qualified-classType"
912 minOccurs="0">
913 <xsd:annotation>
914 <xsd:documentation>
915
916 The element resourceadapter-class specifies the
917 fully qualified name of a Java class that implements
918 the javax.resource.spi.ResourceAdapter
919 interface. This Java class is provided as part of
920 resource adapter's implementation of connector
921 architecture specified contracts. The implementation
922 of this class is required to be a JavaBean.
923
924 </xsd:documentation>
925 </xsd:annotation>
926
927 </xsd:element>
928 <xsd:element name="config-property"
929 type="j2ee:config-propertyType"
930 minOccurs="0"
931 maxOccurs="unbounded"/>
932 <xsd:element name="outbound-resourceadapter"
933 type="j2ee:outbound-resourceadapterType"
934 minOccurs="0">
935 <xsd:unique name="connectionfactory-interface-uniqueness">
936 <xsd:annotation>
937 <xsd:documentation>
938
939 The connectionfactory-interface element content
940 must be unique in the outbound-resourceadapter.
941 Multiple connection-definitions can not use the
942 same connectionfactory-type.
943
944 </xsd:documentation>
945 </xsd:annotation>
946 <xsd:selector xpath="j2ee:connection-definition"/>
947 <xsd:field xpath="j2ee:connectionfactory-interface"/>
948 </xsd:unique>
949 </xsd:element>
950 <xsd:element name="inbound-resourceadapter"
951 type="j2ee:inbound-resourceadapterType"
952 minOccurs="0"/>
953 <xsd:element name="adminobject"
954 type="j2ee:adminobjectType"
955 minOccurs="0"
956 maxOccurs="unbounded"/>
957 <xsd:element name="security-permission"
958 type="j2ee:security-permissionType"
959 minOccurs="0"
960 maxOccurs="unbounded"/>
961 </xsd:sequence>
962 <xsd:attribute name="id" type="xsd:ID"/>
963 </xsd:complexType>
964
965<!-- **************************************************** -->
966
967 <xsd:complexType name="security-permissionType">
968 <xsd:annotation>
969 <xsd:documentation>
970
971 The security-permissionType specifies a security
972 permission that is required by the resource adapter code.
973
974 The security permission listed in the deployment descriptor
975 are ones that are different from those required by the
976 default permission set as specified in the connector
977 specification. The optional description can mention specific
978 reason that resource adapter requires a given security
979 permission.
980
981 </xsd:documentation>
982 </xsd:annotation>
983
984 <xsd:sequence>
985 <xsd:element name="description"
986 type="j2ee:descriptionType"
987 minOccurs="0"
988 maxOccurs="unbounded"/>
989 <xsd:element name="security-permission-spec"
990 type="j2ee:xsdStringType">
991 <xsd:annotation>
992 <xsd:documentation>
993
994 The element security-permission-spec specifies a security
995 permission based on the Security policy file
996 syntax. Refer to the following URL for Sun's
997 implementation of the security permission
998 specification:
999
1000 http://java.sun.com/products/jdk/1.4/docs/guide/security/PolicyFiles.html#FileSyntax
1001 </xsd:documentation>
1002 </xsd:annotation>
1003 </xsd:element>
1004 </xsd:sequence>
1005 <xsd:attribute name="id" type="xsd:ID"/>
1006 </xsd:complexType>
1007
1008<!-- **************************************************** -->
1009
1010 <xsd:complexType name="transaction-supportType">
1011 <xsd:annotation>
1012 <xsd:documentation>
1013
1014 The transaction-supportType specifies the level of
1015 transaction support provided by the resource adapter. It is
1016 used by transaction-support elements.
1017
1018 The value must be one of the following:
1019
1020 NoTransaction
1021 LocalTransaction
1022 XATransaction
1023
1024 </xsd:documentation>
1025 </xsd:annotation>
1026 <xsd:simpleContent>
1027 <xsd:restriction base="j2ee:string">
1028 <xsd:enumeration value="NoTransaction"/>
1029 <xsd:enumeration value="LocalTransaction"/>
1030 <xsd:enumeration value="XATransaction"/>
1031 </xsd:restriction>
1032 </xsd:simpleContent>
1033 </xsd:complexType>
1034
1035</xsd:schema>
1036