home *** CD-ROM | disk | FTP | other *** search
/ Internet Magazine 2003 October / INTERNET108.ISO / pc / software / windows / building / xmlspy / xmlspyentcomplete5.exe / Data1.cab / _94BA216EAA12433EAA701A8A080EBFF6 < prev    next >
Encoding:
Text File  |  2002-08-22  |  19.7 KB  |  578 lines
  1. <!--
  2. Copyright (c) 2000 Sun Microsystems, Inc.,
  3. 901 San Antonio Road,
  4. Palo Alto, California 94303, U.S.A.
  5. All rights reserved.
  6.  
  7. Sun Microsystems, Inc. has intellectual property rights relating to
  8. technology embodied in the product that is described in this document.
  9. In particular, and without limitation, these intellectual property
  10. rights may include one or more of the U.S. patents listed at
  11. http://www.sun.com/patents and one or more additional patents or
  12. pending patent applications in the U.S. and in other countries.
  13.  
  14. This document and the product to which it pertains are distributed
  15. under licenses restricting their use, copying, distribution, and
  16. decompilation.  This document may be reproduced and distributed but may
  17. not be changed without prior written authorization of Sun and its
  18. licensors, if any.
  19.  
  20. Third-party software, including font technology, is copyrighted and
  21. licensed from Sun suppliers.
  22.  
  23. Sun,  Sun Microsystems,  the Sun logo,  Java,  JavaServer Pages,  Java
  24. Naming and Directory Interface,  JDBC,  JDK,  JavaMail and  and
  25. Enterprise JavaBeans are trademarks or registered trademarks of Sun
  26. Microsystems, Inc. in the U.S. and other countries.
  27.  
  28. Federal Acquisitions: Commercial Software - Government Users Subject to
  29. Standard License Terms and Conditions.
  30.  
  31. DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED
  32. CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED
  33. WARRANTY OF MERCHANTABILITY, FITNESS FOR FOR A PARTICULAR PURPOSE OR
  34. NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH
  35. DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.
  36.  
  37.  
  38. _________________________________________________________________________
  39.  
  40. Copyright (c) 2000 Sun Microsystems, Inc.,
  41. 901 San Antonio Road,
  42. Palo Alto, California 94303, E'tats-Unis.
  43. Tous droits re'serve's.
  44.  
  45. Sun Microsystems, Inc. a les droits de proprie'te' intellectuels
  46. relatants a` la technologie incorpore'e dans le produit qui est de'crit
  47. dans ce document. En particulier, et sans la limitation, ces droits de
  48. proprie'te' intellectuels peuvent inclure un ou plus des brevets
  49. ame'ricains e'nume're's a` http://www.sun.com/patents et un ou les
  50. brevets plus supple'mentaires ou les applications de brevet en attente
  51. dans les E'tats-Unis et dans les autres pays.
  52.  
  53. Ce produit ou document est prote'ge' par un copyright et distribue'
  54. avec des licences qui en restreignent l'utilisation, la copie, la
  55. distribution, et la de'compilation.  Ce documention associe n peut
  56. e^tre reproduite et distribuer, par quelque moyen que ce soit, sans
  57. l'autorisation pre'alable et e'crite de Sun et de ses bailleurs de
  58. licence, le cas e'che'ant.
  59.  
  60. Le logiciel de'tenu par des tiers, et qui comprend la technologie
  61. relative aux polices de caracte`res, est prote'ge' par un copyright et
  62. licencie' par des fournisseurs de Sun.
  63.  
  64. Sun,  Sun Microsystems,  le logo Sun,  Java,  JavaServer Pages,  Java
  65. Naming and Directory Interface,  JDBC,  JDK,  JavaMail et  and
  66. Enterprise JavaBeans sont des marques de fabrique ou des marques
  67. de'pose'es de Sun Microsystems, Inc. aux E'tats-Unis et dans d'autres
  68. pays.
  69.  
  70. LA DOCUMENTATION EST FOURNIE "EN L'E'TAT" ET TOUTES AUTRES CONDITIONS,
  71. DECLARATIONS ET GARANTIES EXPRESSES OU TACITES SONT FORMELLEMENT
  72. EXCLUES, DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE, Y COMPRIS
  73. NOTAMMENT TOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A
  74. L'APTITUDE A UNE UTILISATION PARTICULIERE OU A L'ABSENCE DE
  75. CONTREFAC,ON.
  76. -->
  77. <!--
  78. This is the XML DTD for the Connector 1.0 deployment descriptor.
  79. All Connector 1.0 deployment descriptors must include a DOCTYPE
  80. of the following form:
  81.  
  82.   <!DOCTYPE connector PUBLIC
  83.     "-//Sun Microsystems, Inc.//DTD Connector 1.0//EN"
  84.     "http://java.sun.com/dtd/connector_1_0.dtd">
  85.  
  86. -->
  87. <!--
  88. The following conventions apply to all J2EE deployment descriptor
  89. elements unless indicated otherwise.
  90.  
  91. - In elements that contain PCDATA, leading and trailing whitespace
  92.   in the data may be ignored.
  93.  
  94. - In elements whose value is an "enumerated type", the value is
  95.   case sensitive.
  96.  
  97. - In elements that specify a pathname to a file within the same
  98.   JAR file, relative filenames (i.e., those not starting with "/")
  99.   are considered relative to the root of the JAR file's namespace.
  100.   Absolute filenames (i.e., those starting with "/") also specify
  101.   names in the root of the JAR file's namespace.  In general, relative
  102.   names are preferred.  The exception is .war files where absolute
  103.   names are preferred for consistency with the servlet API.
  104. -->
  105. <!--
  106. The connector element is the root element of the deployment descriptor
  107. for the resource adapter. This element includes general information - vendor
  108. name, version, specification version supported, icon -  about the
  109. resource adapter module. It also includes information specific to the
  110. implementation of the resource adapter library as specified through
  111. the element resourceadapter.
  112. -->
  113. <!ELEMENT connector (display-name?, description?, icon?, vendor-name, spec-version, eis-type, version, license?, resourceadapter)>
  114. <!--
  115. The element authentication-mechanism specifies an authentication mechanism
  116. supported by the resource adapter. Note that this support is for
  117. the resource adapter and not for the underlying EIS instance. The
  118. optional description specifies any resource adapter specific requirement
  119. for the support of security contract and authentication mechanism.
  120.  
  121. Note that BasicPassword mechanism type should support the
  122. javax.resource.spi.security.PasswordCredential interface.
  123. The Kerbv5 mechanism type should support the
  124. javax.resource.spi.security.GenericCredential interface.
  125.  
  126. Used in: resourceadapter
  127. -->
  128. <!ELEMENT authentication-mechanism (description?, authentication-mechanism-type, credential-interface)>
  129. <!--
  130. The element authentication-mechanism-type specifies type of an authentication
  131. mechanism.
  132.  
  133. The example values are:
  134.    <authentication-mechanism-type>BasicPassword
  135.                    </authentication-mechanism-type>
  136.    <authentication-mechanism-type>Kerbv5
  137.                    </authentication-mechanism-type>
  138.  
  139. Any additional security mechanisms are outside the scope of the
  140. Connector architecture specification.
  141.  
  142. Used in: authentication-mechanism
  143. -->
  144. <!ELEMENT authentication-mechanism-type (#PCDATA)>
  145. <!--
  146. The element config-property contains a declaration of a single
  147. configuration property for a ManagedConnectionFactory instance.
  148.  
  149. Each ManagedConnectionFactory instance creates connections to a
  150. specific EIS instance based on the properties configured on the
  151. ManagedConnectionFactory instance. The configurable properties are
  152. specified only once in the deployment descriptor, even though a
  153. resource adapter can be used to configure multiple ManagedConnnection-
  154. Factory instances (that create connections to different instances of
  155. the same EIS).
  156.  
  157. The declaration consists of an optional description, name, type
  158. and an optional value of the configuration property. If the resource
  159. adapter provider does not specify a value than the deployer is
  160. responsible for providing a valid value for a configuration property.
  161.  
  162. Any bounds or well-defined values of properties should be described
  163. in the description element.
  164.  
  165. Used in: resourceadapter
  166. -->
  167. <!ELEMENT config-property (description?, config-property-name, config-property-type, config-property-value?)>
  168. <!--
  169. The element config-property-name contains the name of a configuration
  170. property.
  171.  
  172. The connector architecture defines a set of well-defined properties
  173. all of type java.lang.String. These are as follows:
  174.      <config-property-name>ServerName</config-property-name>
  175.      <config-property-name>PortNumber</config-property-name>
  176.      <config-property-name>UserName</config-property-name>
  177.      <config-property-name>Password</config-property-name>
  178.      <config-property-name>ConnectionURL</config-property-name>
  179.  
  180. A resource adapter provider can extend this property set to include
  181. properties specific to the resource adapter and its underlying EIS.
  182.  
  183. Used in: config-property
  184.  
  185. Example: <config-property-name>ServerName</config-property-name>
  186. -->
  187. <!ELEMENT config-property-name (#PCDATA)>
  188. <!--
  189. The element config-property-type contains the fully qualified Java
  190. type of a configuration property as required by ManagedConnection-
  191. Factory instance.
  192.  
  193. The following are the legal values of config-property-type:
  194.    java.lang.Boolean, java.lang.String, java.lang.Integer,
  195.    java.lang.Double, java.lang.Byte, java.lang.Short,
  196.    java.lang.Long, java.lang.Float, java.lang.Character
  197.  
  198. Used in: config-property
  199.  
  200. Example: <config-property-type>java.lang.String</config-property-type>
  201. -->
  202. <!ELEMENT config-property-type (#PCDATA)>
  203. <!--
  204. The element config-property-value contains the value of a configuration
  205. entry.
  206.  
  207. Used in: config-property
  208.  
  209. Example: <config-property-value>WombatServer</config-property-value>
  210. -->
  211. <!ELEMENT config-property-value (#PCDATA)>
  212. <!--
  213. The element connection-impl-class specifies the fully-qualified
  214. name of the Connection class that implements resource adapter
  215. specific Connection interface.
  216.  
  217. Used in: resourceadapter
  218.  
  219. Example: <connection-impl-class>com.wombat.ConnectionImpl
  220.          </connection-impl-class>
  221. -->
  222. <!ELEMENT connection-impl-class (#PCDATA)>
  223. <!--
  224. The element connection-interface specifies the fully-qualified
  225. name of the Connection interface supported by the resource
  226. adapter.
  227.  
  228. Used in: resourceadapter
  229.  
  230. Example: <connection-interface>javax.resource.cci.Connection
  231.          </connection-interface>
  232. -->
  233. <!ELEMENT connection-interface (#PCDATA)>
  234. <!--
  235. The element connectionfactory-impl-class specifies the fully-qualified
  236. name of the ConnectionFactory class that implements resource adapter
  237. specific ConnectionFactory interface.
  238.  
  239. Used in: resourceadapter
  240.  
  241. Example: <connectionfactory-impl-class>com.wombat.ConnectionFactoryImpl
  242.          </connectionfactory-impl-class>
  243. -->
  244. <!ELEMENT connectionfactory-impl-class (#PCDATA)>
  245. <!--
  246. The element connectionfactory-interface specifies the fully-qualified
  247. name of the ConnectionFactory interface supported by the resource
  248. adapter.
  249.  
  250. Used in: resourceadapter
  251.  
  252. Example: <connectionfactory-interface>com.wombat.ConnectionFactory
  253.          </connectionfactory-interface>
  254. OR
  255. <connectionfactory-interface>javax.resource.cci.ConnectionFactory
  256.          </connectionfactory-interface>
  257. -->
  258. <!ELEMENT connectionfactory-interface (#PCDATA)>
  259. <!--
  260. The element credential-interface specifies the interface that the
  261. resource adapter implementation supports for the representation
  262. of the credentials. This element should be used by application server
  263. to find out the Credential interface it should use as part of the
  264. security contract.
  265.  
  266. The possible values are:
  267.    <credential-interface>javax.resource.spi.security.PasswordCredential
  268.         </credential-interface>
  269.    <credential-interface>javax.resource.spi.security.GenericCredential
  270.         </credential-interface>
  271.  
  272. Used in: authentication-mechanism
  273. -->
  274. <!ELEMENT credential-interface (#PCDATA)>
  275. <!--
  276. The description element is used to provide text describing the parent
  277. element.  The description element should include any information that
  278. the resource adapter rar file producer wants to provide to the consumer of
  279. the resource adapter rar file (i.e., to the Deployer). Typically, the tools
  280. used by the resource adapter rar file consumer will display the description
  281. when processing the parent element that contains the description.
  282.  
  283. Used in: authentication-mechanism, config-property, connector, license,
  284. security-permission
  285. -->
  286. <!ELEMENT description (#PCDATA)>
  287. <!--
  288. The display-name element contains a short name that is intended to be
  289. displayed by tools.  The display name need not be unique.
  290.  
  291. Used in: connector
  292.  
  293. Example:
  294.  
  295. <display-name>Employee Self Service</display-name>
  296. -->
  297. <!ELEMENT display-name (#PCDATA)>
  298. <!--
  299. The element eis-type contains information about the type of the
  300. EIS. For example, the type of an EIS can be product name of EIS
  301. independent of any version info.
  302.  
  303. This helps in identifying EIS instances that can be used with
  304. this resource adapter.
  305.  
  306. Used in: connector
  307. -->
  308. <!ELEMENT eis-type (#PCDATA)>
  309. <!--
  310. The icon element contains small-icon and large-icon elements that
  311. specify the file names for small and a large GIF or JPEG icon images
  312. used to represent the parent element in a GUI tool.
  313.  
  314. Used in: connector
  315. -->
  316. <!ELEMENT icon (small-icon?, large-icon?)>
  317. <!--
  318. The large-icon element contains the name of a file
  319. containing a large (32 x 32) icon image. The file
  320. name is a relative path within the resource adapter's
  321. rar file.
  322.  
  323. The image may be either in the JPEG or GIF format.
  324. The icon can be used by tools.
  325.  
  326. Used in: icon
  327.  
  328. Example:
  329.  
  330. <large-icon>employee-service-icon32x32.jpg</large-icon>
  331. -->
  332. <!ELEMENT large-icon (#PCDATA)>
  333. <!--
  334. The element license specifies licensing requirements for the resource
  335. adapter module. This element specifies whether a license is required
  336. to deploy and use this resource adapter, and an optional description
  337. of the licensing terms (examples: duration of license, number of
  338. connection restrictions).
  339.  
  340. Used in: connector
  341. -->
  342. <!ELEMENT license (description?, license-required)>
  343. <!--
  344. The element license-required specifies whether a license is required
  345. to deploy and use the resource adapter. This element must be one of
  346. the following:
  347.  
  348.     <license-required>true</license-required>
  349.     <license-required>false</license-required>
  350.  
  351. Used in: license
  352. -->
  353. <!ELEMENT license-required (#PCDATA)>
  354. <!--
  355. The element managedconnectionfactory-class specifies the fully qualified
  356. name of the Java class that implements the javax.resource.spi.Managed-
  357. ConnectionFactory interface. This Java class is provided as part of
  358. resource adapter's implementation of connector architecture specified
  359. contracts.
  360.  
  361. Used in: resourceadapter
  362.  
  363. Example:
  364.   <managedconnectionfactory-class>com.wombat.ManagedConnectionFactoryImpl
  365.   </managedconnectionfactory-class>
  366. -->
  367. <!ELEMENT managedconnectionfactory-class (#PCDATA)>
  368. <!--
  369. The element reauthentication-support specifies whether the resource
  370. adapter implementation supports re-authentication of existing Managed-
  371. Connection instance. Note that this information is for the resource
  372. adapter implementation and not for the underlying EIS instance.
  373.  
  374. This element must be one of the following:
  375.         <reauthentication-support>true</reauthentication-support>
  376.         <reauthentication-support>false</reauthentication-support>
  377. Used in: resourceadapter
  378. -->
  379. <!ELEMENT reauthentication-support (#PCDATA)>
  380. <!--
  381. The element resourceadapter specifies information about the resource
  382. adapter. The information includes fully-qualified names of
  383. class/interfaces required as part of the connector architecture
  384. specified contracts, level of transaction support provided,
  385. configurable properties for ManagedConnectionFactory instances,
  386. one or more authentication mechanisms supported and additional
  387. required security permissions.
  388.  
  389. If there is no authentication-mechanism specified as part of
  390. resource adapter element then the resource adapter does not
  391. support any standard security authentication mechanisms as part
  392. of security contract. The application server ignores the security
  393. part of the system contracts in this case.
  394.  
  395. Used in: connector
  396. -->
  397. <!ELEMENT resourceadapter (managedconnectionfactory-class, connectionfactory-interface, connectionfactory-impl-class, connection-interface, connection-impl-class, transaction-support, config-property*, authentication-mechanism*, reauthentication-support, security-permission*)>
  398. <!--
  399. The element security permission specifies a security permission that
  400. is required by the resource adapter code.
  401.  
  402. The security permission listed in the deployment descriptor are ones
  403. that are different from those required by the default permission set
  404. as specified in the connector specification. The optional description
  405. can mention specific reason that resource adapter requires a given
  406. security permission.
  407.  
  408. Used in: resourceadapter
  409. -->
  410. <!ELEMENT security-permission (description?, security-permission-spec)>
  411. <!--
  412. The element permission-spec specifies a security permission based
  413. on the Security policy file syntax. Refer to the following URL for
  414. Sun's implementation of the security permission specification:
  415.  
  416. http://java.sun.com/products/jdk/1.3/docs/guide/security/PolicyFiles.html#FileSyntax
  417.  
  418. Used in: security-permission
  419. -->
  420. <!ELEMENT security-permission-spec (#PCDATA)>
  421. <!--
  422. The small-icon element contains the name of a file
  423. containing a small (16 x 16) icon image. The file
  424. name is a relative path within the resource adapter's
  425. rar file.
  426.  
  427. The image may be either in the JPEG or GIF format.
  428. The icon can be used by tools.
  429.  
  430. Used in: icon
  431.  
  432. Example:
  433.  
  434. <small-icon>employee-service-icon16x16.jpg</small-icon>
  435. -->
  436. <!ELEMENT small-icon (#PCDATA)>
  437. <!--
  438. The element spec-version specifies the version of the connector
  439. architecture specification that is supported by this resource
  440. adapter. This information enables deployer to configure the resource
  441. adapter to support deployment and runtime requirements of the
  442. corresponding connector architecture specification.
  443.  
  444. Used in: connector
  445.  
  446. Example:
  447.   <spec-version>1.0</spec-version>
  448. -->
  449. <!ELEMENT spec-version (#PCDATA)>
  450. <!--
  451. The transaction-support element specifies the level of transaction
  452. support provided by the resource adapter.
  453. The value of transaction-support must be one of the following:
  454.  <transaction-support>NoTransaction</transaction-support>
  455.  <transaction-support>LocalTransaction</transaction-support>
  456.  <transaction-support>XATransaction</transaction-support>
  457.  
  458. Used in: resourceadapter
  459. -->
  460. <!ELEMENT transaction-support (#PCDATA)>
  461. <!--
  462. The element vendor-name specifies the name of resource adapter provider
  463. vendor.
  464.  
  465. Used in: connector
  466.  
  467. Example:
  468.   <vendor-name>Wombat Corp.</vendor-name>
  469. -->
  470. <!ELEMENT vendor-name (#PCDATA)>
  471. <!--
  472. The element version specifies a string-based version of the
  473. resource adapter from the resource adapter provider.
  474.  
  475. Used in: connector
  476.  
  477. Example:
  478.   <version>1.0</version>
  479. -->
  480. <!ELEMENT version (#PCDATA)>
  481. <!--
  482. The ID mechanism is to allow tools that produce additional deployment
  483. information (i.e., information beyond the standard deployment
  484. descriptor information) to store the non-standard information in a
  485. separate file, and easily refer from these tool-specific files to the
  486. information in the standard deployment descriptor.
  487.  
  488. Tools are not allowed to add the non-standard information into the
  489. standard deployment descriptor.
  490. -->
  491. <!ATTLIST authentication-mechanism
  492.     id ID #IMPLIED
  493. >
  494. <!ATTLIST authentication-mechanism-type
  495.     id ID #IMPLIED
  496. >
  497. <!ATTLIST config-property
  498.     id ID #IMPLIED
  499. >
  500. <!ATTLIST config-property-name
  501.     id ID #IMPLIED
  502. >
  503. <!ATTLIST config-property-type
  504.     id ID #IMPLIED
  505. >
  506. <!ATTLIST config-property-value
  507.     id ID #IMPLIED
  508. >
  509. <!ATTLIST connection-impl-class
  510.     id ID #IMPLIED
  511. >
  512. <!ATTLIST connection-interface
  513.     id ID #IMPLIED
  514. >
  515. <!ATTLIST connectionfactory-impl-class
  516.     id ID #IMPLIED
  517. >
  518. <!ATTLIST connectionfactory-interface
  519.     id ID #IMPLIED
  520. >
  521. <!ATTLIST connector
  522.     id ID #IMPLIED
  523. >
  524. <!ATTLIST credential-interface
  525.     id ID #IMPLIED
  526. >
  527. <!ATTLIST description
  528.     id ID #IMPLIED
  529. >
  530. <!ATTLIST display-name
  531.     id ID #IMPLIED
  532. >
  533. <!ATTLIST eis-type
  534.     id ID #IMPLIED
  535. >
  536. <!ATTLIST icon
  537.     id ID #IMPLIED
  538. >
  539. <!ATTLIST large-icon
  540.     id ID #IMPLIED
  541. >
  542. <!ATTLIST license
  543.     id ID #IMPLIED
  544. >
  545. <!ATTLIST license-required
  546.     id ID #IMPLIED
  547. >
  548. <!ATTLIST managedconnectionfactory-class
  549.     id ID #IMPLIED
  550. >
  551. <!ATTLIST reauthentication-support
  552.     id ID #IMPLIED
  553. >
  554. <!ATTLIST resourceadapter
  555.     id ID #IMPLIED
  556. >
  557. <!ATTLIST security-permission
  558.     id ID #IMPLIED
  559. >
  560. <!ATTLIST security-permission-spec
  561.     id ID #IMPLIED
  562. >
  563. <!ATTLIST small-icon
  564.     id ID #IMPLIED
  565. >
  566. <!ATTLIST spec-version
  567.     id ID #IMPLIED
  568. >
  569. <!ATTLIST transaction-support
  570.     id ID #IMPLIED
  571. >
  572. <!ATTLIST vendor-name
  573.     id ID #IMPLIED
  574. >
  575. <!ATTLIST version
  576.     id ID #IMPLIED
  577. >
  578.