| <!-- |
| Copyright 1999 Sun Microsystems, Inc. 901 San Antonio Road, |
| Palo Alto, CA 94303, U.S.A. All rights reserved. |
| |
| This product or document is protected by copyright and distributed |
| under licenses restricting its use, copying, distribution, and |
| decompilation. No part of this product or documentation may be |
| reproduced in any form by any means without prior written authorization |
| of Sun and its licensors, if any. |
| |
| Third party software, including font technology, is copyrighted and |
| licensed from Sun suppliers. |
| |
| Sun, Sun Microsystems, the Sun Logo, Solaris, Java, JavaServer Pages, Java |
| Naming and Directory Interface, JDBC, JDK, JavaMail and Enterprise JavaBeans, |
| are trademarks or registered trademarks of Sun Microsystems, Inc in the U.S. |
| and other countries. |
| |
| All SPARC trademarks are used under license and are trademarks |
| or registered trademarks of SPARC International, Inc. |
| in the U.S. and other countries. Products bearing SPARC |
| trademarks are based upon an architecture developed by Sun Microsystems, Inc. |
| |
| PostScript is a registered trademark of Adobe Systems, Inc. |
| |
| |
| Federal Acquisitions: Commercial Software - Government Users Subject to |
| Standard License Terms and Conditions. |
| |
| |
| |
| DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED |
| CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY |
| IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR |
| PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT |
| TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY |
| INVALID. |
| |
| _________________________________________________________________________ |
| Copyright 1999 Sun Microsystems, Inc., |
| 901 San Antonio Road, Palo Alto, CA 94303, Etats-Unis. |
| Tous droits re'serve's. |
| |
| |
| Ce produit ou document est prote'ge' par un copyright et distribue' avec |
| des licences qui en restreignent l'utilisation, la copie, la distribution, |
| et la de'compilation. Aucune partie de ce produit ou de sa documentation |
| associe'e ne peut e^tre reproduite sous aucune forme, par quelque moyen |
| que ce soit, sans l'autorisation pre'alable et e'crite de Sun et de ses |
| bailleurs de licence, s'il y en a. |
| |
| Le logiciel de'tenu par des tiers, et qui comprend la technologie |
| relative aux polices de caracte`res, est prote'ge' par un copyright |
| et licencie' par des fournisseurs de Sun. |
| |
| Sun, Sun Microsystems, le logo Sun, Solaris, Java, JavaServer Pages, Java |
| Naming and Directory Interface, JDBC, JDK, JavaMail, et Enterprise JavaBeans, |
| sont des marques de fabrique ou des marques de'pose'es de Sun |
| Microsystems, Inc. aux Etats-Unis et dans d'autres pays. |
| |
| Toutes les marques SPARC sont utilise'es sous licence et sont |
| des marques de fabrique ou des marques de'pose'es de SPARC |
| International, Inc. aux Etats-Unis et dans |
| d'autres pays. Les produits portant les marques SPARC sont |
| base's sur une architecture de'veloppe'e par Sun Microsystems, Inc. |
| |
| Postcript est une marque enregistre'e d'Adobe Systems Inc. |
| |
| LA DOCUMENTATION EST FOURNIE "EN L'ETAT" ET TOUTES AUTRES CONDITIONS, |
| DECLARATIONS ET GARANTIES EXPRESSES OU TACITES SONT FORMELLEMENT EXCLUES, |
| DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE, Y COMPRIS NOTAMMENT |
| TOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A L'APTITUDE |
| A UNE UTILISATION PARTICULIERE OU A L'ABSENCE DE CONTREFACON. |
| --> |
| |
| <!-- |
| The application-client element is the root element of an application client |
| deployment descriptor. |
| The application client deployment descriptor describes the EJB components and |
| external resources referenced by the application client. |
| --> |
| <!ELEMENT application-client (icon?, display-name, description?, env-entry*, |
| ejb-ref*, resource-ref*)> |
| |
| <!-- |
| The description element is used to provide text describing the parent element. |
| The description element should include any information that the |
| application-client file producer wants to provide to the consumer of the |
| application-client file (i.e., to the Deployer). Typically, the tools used by |
| the application-client file consumer will display the description when |
| processing the parent element that contains the description. |
| --> |
| <!ELEMENT description (#PCDATA)> |
| |
| <!-- |
| The display-name element contains a short name that is intended to be displayed |
| by tools. |
| --> |
| <!ELEMENT display-name (#PCDATA)> |
| |
| <!-- |
| The ejb-link element is used in the ejb-ref element to specify that an EJB |
| reference is linked to an enterprise bean in the encompassing J2EE Application |
| package. The value of the ejb-link element must be the ejb-name of an enterprise |
| bean in the same J2EE Application package. Used in: ejb-ref |
| Example: <ejb-link>EmployeeRecord</ejb-link> |
| --> |
| <!ELEMENT ejb-link (#PCDATA)> |
| |
| <!-- |
| The ejb-ref element is used for the declaration of a reference to an enterprise |
| bean's home. The declaration consists of an optional description; the EJB |
| reference name used in the code of the referencing application client; the |
| expected type of the referenced enterprise bean; the expected home and remote |
| interfaces of the referenced enterprise bean; and an optional ejb-link |
| information. The optional ejb-link element is used to specify the referenced |
| enterprise bean. |
| --> |
| <!ELEMENT ejb-ref (description?, ejb-ref-name, ejb-ref-type, home, remote, |
| ejb-link?)> |
| |
| <!-- |
| The ejb-ref-name element contains the name of an EJB reference. The EJB |
| reference is an entry in the application client's environment. It is recommended |
| that name is prefixed with "ejb/". Used in: ejb-ref |
| Example: <ejb-ref-name>ejb/Payroll</ejb-ref-name> |
| --> |
| <!ELEMENT ejb-ref-name (#PCDATA)> |
| |
| <!-- |
| The ejb-ref-type element contains the expected type of the referenced enterprise |
| bean. The ejb-ref-type element must be one of the following: |
| <ejb-ref-type>Entity</ejb-ref-type> |
| <ejb-ref-type>Session</ejb-ref-type> |
| Used in: ejb-ref |
| --> |
| <!ELEMENT ejb-ref-type (#PCDATA)> |
| |
| <!-- |
| The env-entry element contains the declaration of an application client's |
| environment entries. The declaration consists of an optional description, the |
| name of the environment entry, and an optional value. |
| --> |
| <!ELEMENT env-entry (description?, env-entry-name, env-entry-type, |
| env-entry-value?)> |
| |
| <!-- |
| The env-entry-name element contains the name of an application client's |
| environment entry. Used in: env-entry |
| Example: <env-entry-name>EmployeeAppDB</env-entry-name> |
| --> |
| <!ELEMENT env-entry-name (#PCDATA)> |
| |
| <!-- |
| The env-entry-type element contains the fully-qualified Java type of the |
| environment entry value that is expected by the application client's code. The |
| following are the legal values of env-entry-type: java.lang.Boolean, |
| java.lang.String, java.lang.Integer, java.lang.Double, java.lang.Byte, |
| java.lang.Short, java.lang.Long, and java.lang.Float. |
| |
| Used in: env-entry |
| |
| Example: |
| <env-entry-type>java.lang.Boolean</env-entry-type> |
| --> |
| <!ELEMENT env-entry-type (#PCDATA)> |
| |
| <!-- |
| The env-entry-value element contains the value of an application client's |
| environment entry. The value must be a String that is valid for the constructor |
| of the specified type that takes a single String parameter. |
| |
| Used in: env-entry |
| |
| Example: |
| <env-entry-value>/datasources/MyDatabase</env-entry-value> |
| --> |
| <!ELEMENT env-entry-value (#PCDATA)> |
| |
| <!-- |
| The home element contains the fully-qualified name of the enterprise bean's home |
| interface. |
| Used in: ejb-ref |
| Example: <home>com.aardvark.payroll.PayrollHome</home> |
| --> |
| <!ELEMENT home (#PCDATA)> |
| |
| <!-- |
| The icon element contains a small-icon and large-icon element which specify the |
| URIs for a small and a large GIF or JPEG icon image used to represent the |
| application client in a GUI tool. |
| --> |
| <!ELEMENT icon (small-icon?, large-icon?)> |
| |
| <!-- |
| The large-icon element contains the name of a file containing a large (32 x 32) |
| icon image. The file name is a relative path within the application-client jar |
| file. The image must be either in the JPEG or GIF format, and the file name must |
| end with the suffix ".jpg" or ".gif" respectively. The icon can be used by |
| tools. |
| Example: |
| <large-icon>lib/images/employee-service-icon32x32.jpg</large-icon> |
| --> |
| <!ELEMENT large-icon (#PCDATA)> |
| |
| <!-- |
| The remote element contains the fully-qualified name of the enterprise bean's |
| remote interface. |
| Used in: ejb-ref |
| Example: |
| <remote>com.wombat.empl.EmployeeService</remote> |
| --> |
| <!ELEMENT remote (#PCDATA)> |
| |
| <!-- |
| The res-auth element specifies whether the enterprise bean code signs on |
| programmatically to the resource manager, or whether the Container will sign on |
| to the resource manager on behalf of the bean. In the latter case, the Container |
| uses information that is supplied by the Deployer. |
| The value of this element must be one of the two following: |
| <res-auth>Application</res-auth> |
| <res-auth>Container</res-auth> |
| --> |
| <!ELEMENT res-auth (#PCDATA)> |
| |
| <!-- |
| The res-ref-name element specifies the name of the resource factory reference |
| name. The resource factory reference name is the name of the application |
| client's environment entry whose value contains the JNDI name of the data |
| source. |
| Used in: resource-ref |
| --> |
| <!ELEMENT res-ref-name (#PCDATA)> |
| |
| <!-- |
| The res-type element specifies the type of the data source. The type is |
| specified by the Java interface (or class) expected to be implemented by the |
| data source. |
| Used in: resource-ref |
| --> |
| <!ELEMENT res-type (#PCDATA)> |
| |
| <!-- |
| The resource-ref element contains a declaration of application clients's |
| reference to an external resource. It consists of an optional description, the |
| resource factory reference name, the indication of the resource factory type |
| expected by the application client's code, and the type of authentication (bean |
| or container). |
| |
| Example: |
| <resource-ref> |
| <res-ref-name>EmployeeAppDB</res-ref-name> |
| <res-type>javax.sql.DataSource</res-type> |
| <res-auth>Container</res-auth> |
| </resource-ref> |
| --> |
| <!ELEMENT resource-ref (description?, res-ref-name, res-type, res-auth)> |
| <!-- |
| The small-icon element contains the name of a file containing a small (16 x 16) |
| icon image. The file name is a relative path within the application-client jar |
| file. The image must be either in the JPEG or GIF format, and the file name must |
| end with the suffix ".jpg" or ".gif" respectively. The icon can be used by |
| tools. |
| Example: |
| <small-icon>lib/images/employee-service-icon16x16.jpg</small-icon> |
| --> |
| <!ELEMENT small-icon (#PCDATA)> |
| |
| <!-- |
| The ID mechanism is to allow tools to easily make tool-specific references to |
| the elements of the deployment descriptor. |
| --> |
| <!ATTLIST application-client id ID #IMPLIED> |
| <!ATTLIST description id ID #IMPLIED> |
| <!ATTLIST display-name id ID #IMPLIED> |
| <!ATTLIST ejb-link id ID #IMPLIED> |
| <!ATTLIST ejb-ref id ID #IMPLIED> |
| <!ATTLIST ejb-ref-name id ID #IMPLIED> |
| <!ATTLIST ejb-ref-type id ID #IMPLIED> |
| <!ATTLIST env-entry id ID #IMPLIED> |
| <!ATTLIST env-entry-name id ID #IMPLIED> |
| <!ATTLIST env-entry-type id ID #IMPLIED> |
| <!ATTLIST env-entry-value id ID #IMPLIED> |
| <!ATTLIST home id ID #IMPLIED> |
| <!ATTLIST icon id ID #IMPLIED> |
| <!ATTLIST large-icon id ID #IMPLIED> |
| <!ATTLIST remote id ID #IMPLIED> |
| <!ATTLIST res-auth id ID #IMPLIED> |
| <!ATTLIST res-ref-name id ID #IMPLIED> |
| <!ATTLIST res-type id ID #IMPLIED> |
| <!ATTLIST resource-ref id ID #IMPLIED> |
| <!ATTLIST small-icon id ID #IMPLIED> |