123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894 |
- <!--
- 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.
- -->
- <!--
- This is the XML DTD for the EJB 1.1 deployment descriptor.
- -->
- <!--
- The assembly-descriptor element contains application-assembly information.
- The application-assembly information consists of the following parts:
- the definition of security roles, the definition of method permissions,
- and the definition of transaction attributes for enterprise beans with
- container-managed transaction demarcation.
- All the parts are optional in the sense that they are omitted if the
- lists represented by them are empty.
- Providing an assembly-descriptor in the deployment descriptor is
- optional for the ejb-jar file producer.
- Used in: ejb-jar
- -->
- <!ELEMENT assembly-descriptor (security-role*, method-permission*,
- container-transaction*)>
- <!--
- The cmp-field element describes a container-managed field. The field
- element includes an optional description of the field, and the name of
- the field.
- Used in: entity
- -->
- <!ELEMENT cmp-field (description?, field-name)>
- <!--
- The container-transaction element specifies how the container must
- manage transaction scopes for the enterprise bean's method invocations.
- The element consists of an optional description, a list of method
- elements, and a transaction attribute.The transaction attribute is to
- be applied to all the specified methods.
- Used in: assembly-descriptor
- -->
- <!ELEMENT container-transaction (description?, method+,
- trans-attribute)>
- <!--
- The description element is used by the ejb-jar file producer to provide
- text describing the parent element.
- The description element should include any information that the ejb-jar
- file producer wants to provide to the consumer of the ejb-jar file
- (i.e. to the Deployer). Typically, the tools used by the ejb-jar file
- consumer will display the description when processing the parent
- element.
- Used in: cmp-field, container-transaction, ejb-jar, entity, env-entry,
- ejb-ref, method, method-permission, resource-ref, security-role,
- security-role-ref, and session.
- -->
- <!ELEMENT description (#PCDATA)>
- <!--
- The display-name element contains a short name that is intended to be
- display by tools.
- Used in: ejb-jar, session, and entity
- Example:
- <display-name>Employee Self Service</display-name>
- -->
- <!ELEMENT display-name (#PCDATA)>
- <!--
- The ejb-class element contains the fully-qualified name of the
- enterprise bean's class.
- Used in: entity and session
- Example:
- <ejb-class>com.wombat.empl.EmployeeServiceBean</ejb-class>
- -->
- <!ELEMENT ejb-class (#PCDATA)>
- <!--
- The optional ejb-client-jar element specifies a JAR file that contains
- the class files necessary for a client program to access the enterprise
- beans in the ejb-jar file. The Deployer should make the ejb-client JAR
- file accessible to the client's class-loader.
- Used in: ejb-jar
- Example:
- <ejb-client-jar>employee_service_client.jar</ejb-client-jar>
- -->
- <!ELEMENT ejb-client-jar (#PCDATA)>
- <!--
- The ejb-jar element is the root element of the EJB deployment
- descriptor. It contains an optional description of the ejb-jar file,
- optional display name, optional small icon file name, optional large
- icon file name, mandatory structural information about all included
- enterprise beans, optional application-assembly descriptor, and an
- optional name of an ejb-client-jar file for the ejb-jar.
- -->
- <!ELEMENT ejb-jar (description?, display-name?, small-icon?,
- large-icon?, enterprise-beans, assembly-descriptor?,
- ejb-client-jar?)>
- <!--
- The ejb-link element is used in the ejb-ref element to specify that an
- EJB reference is linked to another enterprise bean in the ejb-jar
- file.
- The value of the ejb-link element must be the ejb-name of an enterprise
- bean in the same ejb-jar file, or in another ejb-jar file in the same
- J2EE application unit.
- Used in: ejb-ref
- Example:
- <ejb-link>EmployeeRecord</ejb-link>
- -->
- <!ELEMENT ejb-link (#PCDATA)>
- <!--
- The ejb-name element specifies an enterprise bean's name. This name is
- assigned by the ejb-jar file producer to name the enterprise bean in
- the ejb-jar file's deployment descriptor. The name must be unique among
- the names of the enterprise beans in the same ejb-jar file.
- The enterprise bean code does not depend on the name; therefore the
- name can be changed during the application-assembly process without
- breaking the enterprise bean's function.
- There is no architected relationship between the ejb-name in the
- deployment descriptor and the JNDI name that the Deployer will assign
- to the enterprise bean's home.
- The name must conform to the lexical rules for an NMTOKEN.
- Used in: entity, method, and session
- Example:
- <ejb-name>EmployeeService</ejb-name>
- -->
- <!ELEMENT ejb-name (#PCDATA)>
- <!--
- The ejb-ref element is used for the declaration of a reference to
- another enterprise bean's home. The declaration consists of an optional
- description; the EJB reference name used in the code of the referencing
- enterprise bean; 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. It is used typically in ejb-jar files that contain an
- assembled application.
- Used in: entity and session
- -->
- <!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 enterprise bean'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 enterprise-beans element contains the declarations of one or more
- enterprise beans.
- -->
- <!ELEMENT enterprise-beans (session | entity)+>
- <!--
- The entity element declares an entity bean. The declaration consists
- of: an optional description; optional display name; optional small icon
- file name; optional large icon file name; a name assigned to the
- enterprise bean in the deployment descriptor; the names of the entity
- bean's home and remote interfaces; the entity bean's implementation
- class; the entity bean's persistence management type; the entity bean's
- primary key class name; an indication of the entity bean's reentrancy;
- an optional list of container-managed fields; an optional specification
- of the primary key field; an optional declaration of the bean's
- environment entries; an optional declaration of the bean's EJB
- references; an optional declaration of the security role references;
- and an optional declaration of the bean's resource manager connection
- factory references.
- The optional primkey-field may be present in the descriptor if the
- entity's persistency-type is Container.
- The other elements that are optional are "optional" in the sense that
- they are omitted if the lists represented by them are empty.
- At least one cmp-field element must be present in the descriptor if the
- entity's persistency-type is Container, and none must not be present if
- the entity's persistence-type is Bean.
- Used in: enterprise-beans
- -->
- <!ELEMENT entity (description?, display-name?, small-icon?,
- large-icon?, ejb-name, home, remote, ejb-class,
- persistence-type, prim-key-class, reentrant,
- cmp-field*, primkey-field?, env-entry*,
- ejb-ref*, security-role-ref*, resource-ref*)>
- <!--
- The env-entry element contains the declaration of an enterprise bean's
- environment entries. The declaration consists of an optional
- description, the name of the environment entry, and an optional value.
- Used in: entity and session
- -->
- <!ELEMENT env-entry (description?, env-entry-name, env-entry-type,
- env-entry-value?)>
- <!--
- The env-entry-name element contains the name of an enterprise bean's
- environment entry.
- Used in: env-entry
- Example:
- <env-entry-name>minAmount</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 enterprise bean'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 enterprise bean's
- environment entry.
- Used in: env-entry
- Example:
- <env-entry-value>100.00</env-entry-value>
- -->
- <!ELEMENT env-entry-value (#PCDATA)>
- <!--
- The field-name element specifies the name of a container managed field.
- The name must be a public field of the enterprise bean class or one of
- its superclasses.
- Used in: cmp-field
- Example:
- <field-name>firstName</field-Name>
- -->
- <!ELEMENT field-name (#PCDATA)>
- <!--
- The home element contains the fully-qualified name of the enterprise
- bean's home interface.
- Used in: ejb-ref, entity, and session
- Example:
- <home>com.aardvark.payroll.PayrollHome</home>
- -->
- <!ELEMENT home (#PCDATA)>
- <!--
- The large-icon element contains the name of a file containing a large
- (32 x 32) icon image. The file name is relative path within the ejb-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>employee-service-icon32x32.jpg</large-icon>
- -->
- <!ELEMENT large-icon (#PCDATA)>
- <!--
- The method element is used to denote a method of an enterprise bean's
- home or remote interface, or a set of methods. The ejb-name element
- must be the name of one of the enterprise beans in declared in the
- deployment descriptor; the optional method-intf element allows to
- distinguish between a method with the same signature that is defined in
- both the home and remote interface; the method-name element specifies
- the method name; and the optional method-params elements identify a
- single method among multiple methods with an overloaded method name.
- There are three possible styles of the method element syntax:
- 1. <method>
- <ejb-name>EJBNAME</ejb-name>
- <method-name>*</method-name>
- </method>
- This style is used to refer to all the methods of the specified
- enterprise bean's home and remote interfaces.
- 2. <method>
- <ejb-name>EJBNAME</ejb-name>
- <method-name>METHOD</method-name>
- </method>>
- This style is used to refer to the specified method of the
- specified enterprise bean. If there are multiple methods with
- the same overloaded name, the element of this style refers to
- all the methods with the overloaded name.
- 3. <method>
- <ejb-name>EJBNAME</ejb-name>
- <method-name>METHOD</method-name>
- <method-params>
- <method-param>PARAM-1</method-param>
- <method-param>PARAM-2</method-param>
- ...
- <method-param>PARAM-n</method-param>
- </method-params>
- <method>
- This style is used to refer to a single method within a set of
- methods with an overloaded name. PARAM-1 through PARAM-n are the
- fully-qualified Java types of the method's input parameters (if
- the method has no input arguments, the method-params element
- contains no method-param elements). Arrays are specified by the
- array element's type, followed by one or more pair of square
- brackets (e.g. int[][]).
- Used in: method-permission and container-transaction
- Examples:
- Style 1: The following method element refers to all the methods of
- the EmployeeService bean's home and remote interfaces:
- <method>
- <ejb-name>EmployeeService</ejb-name>
- <method-name>*</method-name>
- </method>
- Style 2: The following method element refers to all the create
- methods of the EmployeeService bean's home interface:
- <method>
- <ejb-name>EmployeeService</ejb-name>
- <method-name>create</method-name>
- </method>
- Style 3: The following method element refers to the
- create(String firstName, String LastName) method of the
- EmployeeService bean's home interface.
- <method>
- <ejb-name>EmployeeService</ejb-name>
- <method-name>create</method-name>
- <method-params>
- <method-param>java.lang.String</method-param>
- <method-param>java.lang.String</method-param>
- </method-params>
- </method>
-
- The following example illustrates a Style 3 element with
- more complex parameter types. The method
- foobar(char s, int i, int[] iar, mypackage.MyClass mycl,
- mypackage.MyClass[][] myclaar)
- would be specified as:
- <method>
- <ejb-name>EmployeeService</ejb-name>
- <method-name>foobar</method-name>
- <method-params>
- <method-param>char</method-param>
- <method-param>int</method-param>
- <method-param>int[]</method-param>
- <method-param>mypackage.MyClass</method-param>
- <method-param>mypackage.MyClass[][]</method-param>
- </method-params>
- </method>
- The optional method-intf element can be used when it becomes
- necessary to differentiate between a method defined in the home
- interface and a method with the same name and signature that is
- defined in the remote interface.
- For example, the method element
- <method>
- <ejb-name>EmployeeService</ejb-name>
- <method-intf>Remote</method-intf>
- <method-name>create</method-name>
- <method-params>
- <method-param>java.lang.String</method-param>
- <method-param>java.lang.String</method-param>
- </method-params>
- </method>
- can be used to differentiate the create(String, String) method
- defined in the remote interface from the create(String, String)
- method defined in the home interface, which would be defined as
- <method>
- <ejb-name>EmployeeService</ejb-name>
- <method-intf>Home</method-intf>
- <method-name>create</method-name>
- <method-params>
- <method-param>java.lang.String</method-param>
- <method-param>java.lang.String</method-param>
- </method-params>
- </method>
- -->
- <!ELEMENT method (description?, ejb-name, method-intf?, method-name,
- method-params?)>
- <!--
- The method-intf element allows a method element to differentiate
- between the methods with the same name and signature that are defined
- in both the remote and home interfaces.
- The method-intf element must be one of the following:
- <method-intf>Home</method-intf>
- <method-intf>Remote</method-intf>
- Used in: method
- -->
- <!ELEMENT method-intf (#PCDATA)>
- <!--
- The method-name element contains a name of an enterprise bean method,
- or the asterisk (*) character. The asterisk is used when the element
- denotes all the methods of an enterprise bean's remote and home
- interfaces.
- Used in: method
- -->
- <!ELEMENT method-name (#PCDATA)>
- <!--
- The method-param element contains the fully-qualified Java type name of
- a method parameter.
- Used in: method-params
- -->
- <!ELEMENT method-param (#PCDATA)>
- <!--
- The method-params element contains a list of the fully-qualified Java
- type names of the method parameters.
- Used in: method
- -->
- <!ELEMENT method-params (method-param*)>
- <!--
- The method-permission element specifies that one or more security roles
- are allowed to invoke one or more enterprise bean methods. The
- method-permission element consists of an optional description, a list
- of security role names, and a list of method elements.
- The security roles used in the method-permission element must be
- defined in the security-role element of the deployment descriptor, and
- the methods must be methods defined in the enterprise bean's remote
- and/or home interfaces.
- Used in: assembly-descriptor
- -->
- <!ELEMENT method-permission (description?, role-name+, method+)>
- <!--
- The persistence-type element specifies an entity bean's persistence
- management type.
- The persistence-type element must be one of the two following:
- <persistence-type>Bean</persistence-type>
- <persistence-type>Container</persistence-type>
- Used in: entity
- -->
- <!ELEMENT persistence-type (#PCDATA)>
- <!--
- The prim-key-class element contains the fully-qualified name of an
- entity bean's primary key class.
- If the definition of the primary key class is deferred to deployment
- time, the prim-key-class element should specify java.lang.Object.
- Used in: entity
- Examples:
- <prim-key-class>java.lang.String</prim-key-class>
- <prim-key-class>com.wombat.empl.EmployeeID</prim-key-class>
- <prim-key-class>java.lang.Object</prim-key-class>
- -->
- <!ELEMENT prim-key-class (#PCDATA)>
- <!--
- The primkey-field element is used to specify the name of the primary
- key field for an entity with container-managed persistence.
- The primkey-field must be one of the fields declared in the cmp-field
- element, and the type of the field must be the same as the primary key
- type.
- The primkey-field element is not used if the primary key maps to
- multiple container-managed fields (i.e. the key is a compound key). In
- this case, the fields of the primary key class must be public, and
- their names must correspond to the field names of the entity bean class
- that comprise the key.
- Used in: entity
- Example:
- <primkey-field>EmployeeId</primkey-field>
- -->
- <!ELEMENT primkey-field (#PCDATA)>
- <!--
- The reentrant element specifies whether an entity bean is reentrant or not.
- The reentrant element must be one of the two following:
- <reentrant>True</reentrant>
- <reentrant>False</reentrant>
- Used in: entity
- -->
- <!ELEMENT reentrant (#PCDATA)>
- <!--
- The remote element contains the fully-qualified name of the enterprise
- bean's remote interface.
- Used in: ejb-ref, entity, and session
- 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 a resource manager
- connection factory reference.
- 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 enterprise bean's
- reference to an external resource. It consists of an optional
- description, the resource manager connection factory reference name,
- the indication of the resource manager connection factory type expected
- by the enterprise bean code, and the type of authentication (bean or
- container).
- Used in: entity and session
- 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 role-link element is used to link a security role reference to a
- defined security role. The role-link element must contain the name of
- one of the security roles defined in the security-role elements.
- Used in: security-role-ref
- -->
- <!ELEMENT role-link (#PCDATA)>
- <!--
- The role-name element contains the name of a security role.
- The name must conform to the lexical rules for an NMTOKEN.
- Used in: method-permission, security-role, and security-role-ref
- -->
- <!ELEMENT role-name (#PCDATA)>
- <!--
- The security-role element contains the definition of a security role.
- The definition consists of an optional description of the security
- role, and the security role name.
- Used in: assembly-descriptor
- Example:
- <security-role>
- <description>
- This role includes all employees who
- are authorized to access the employee
- service application.
- </description>
- <role-name>employee</role-name>
- </security-role>
- -->
- <!ELEMENT security-role (description?, role-name)>
- <!--
- The security-role-ref element contains the declaration of a security
- role reference in the enterprise bean's code. The declaration consists
- of an optional description, the security role name used in the code,
- and an optional link to a defined security role.
- The value of the role-name element must be the String used as the
- parameter to the EJBContext.isCallerInRole(String roleName) method.
- The value of the role-link element must be the name of one of the
- security roles defined in the security-role elements.
- Used in: entity and session
- -->
- <!ELEMENT security-role-ref (description?, role-name, role-link?)>
- <!--
- The session-type element describes whether the session bean is a
- stateful session, or stateless session.
- The session-type element must be one of the two following:
- <session-type>Stateful</session-type>
- <session-type>Stateless</session-type>
- -->
- <!ELEMENT session-type (#PCDATA)>
- <!--
- The session element declares an session bean. The declaration consists
- of: an optional description; optional display name; optional small icon
- file name; optional large icon file name; a name assigned to the
- enterprise bean in the deployment description; the names of the session
- bean's home and remote interfaces; the session bean's implementation
- class; the session bean's state management type; the session bean's
- transaction management type; an optional declaration of the bean's
- environment entries; an optional declaration of the bean's EJB
- references; an optional declaration of the security role references;
- and an optional declaration of the bean's resource manager connection
- factory references.
- The elements that are optional are "optional" in the sense that they
- are omitted when if lists represented by them are empty.
- Used in: enterprise-beans
- -->
- <!ELEMENT session (description?, display-name?, small-icon?,
- large-icon?, ejb-name, home, remote, ejb-class,
- session-type, transaction-type, env-entry*,
- ejb-ref*, security-role-ref*, resource-ref*)>
- <!--
- The small-icon element contains the name of a file containing a small
- (16 x 16) icon image. The file name is relative path within the ejb-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>employee-service-icon16x16.jpg</small-icon>
- -->
- <!ELEMENT small-icon (#PCDATA)>
- <!--
- The transaction-type element specifies an enterprise bean's transaction
- management type.
- The transaction-type element must be one of the two following:
- <transaction-type>Bean</transaction-type>
- <transaction-type>Container</transaction-type>
- Used in: session
- -->
- <!ELEMENT transaction-type (#PCDATA)>
- <!--
- The trans-attribute element specifies how the container must manage the
- transaction boundaries when delegating a method invocation to an
- enterprise bean's business method.
- The value of trans-attribute must be one of the following:
- <trans-attribute>NotSupported</trans-attribute>
- <trans-attribute>Supports</trans-attribute>
- <trans-attribute>Required</trans-attribute>
- <trans-attribute>RequiresNew</trans-attribute>
- <trans-attribute>Mandatory</trans-attribute>
- <trans-attribute>Never</trans-attribute>
- Used in: container-transaction
- -->
- <!ELEMENT trans-attribute (#PCDATA)>
- <!--
- The ID mechanism is to allow tools that produce additional deployment
- information (i.e information beyond the standard EJB deployment
- descriptor information) to store the non-standard information in a
- separate file, and easily refer from these tools-specific files to the
- information in the standard deployment descriptor.
- The EJB architecture does not allow the tools to add the non-standard
- information into the EJB deployment descriptor.
- -->
- <!ATTLIST assembly-descriptor id ID #IMPLIED>
- <!ATTLIST cmp-field id ID #IMPLIED>
- <!ATTLIST container-transaction id ID #IMPLIED>
- <!ATTLIST description id ID #IMPLIED>
- <!ATTLIST display-name id ID #IMPLIED>
- <!ATTLIST ejb-class id ID #IMPLIED>
- <!ATTLIST ejb-client-jar id ID #IMPLIED>
- <!ATTLIST ejb-jar id ID #IMPLIED>
- <!ATTLIST ejb-link id ID #IMPLIED>
- <!ATTLIST ejb-name id ID #IMPLIED>
- <!ATTLIST ejb-ref id ID #IMPLIED>
- <!ATTLIST ejb-ref-name id ID #IMPLIED>
- <!ATTLIST ejb-ref-type id ID #IMPLIED>
- <!ATTLIST enterprise-beans id ID #IMPLIED>
- <!ATTLIST entity 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 field-name id ID #IMPLIED>
- <!ATTLIST home id ID #IMPLIED>
- <!ATTLIST large-icon id ID #IMPLIED>
- <!ATTLIST method id ID #IMPLIED>
- <!ATTLIST method-intf id ID #IMPLIED>
- <!ATTLIST method-name id ID #IMPLIED>
- <!ATTLIST method-param id ID #IMPLIED>
- <!ATTLIST method-params id ID #IMPLIED>
- <!ATTLIST method-permission id ID #IMPLIED>
- <!ATTLIST persistence-type id ID #IMPLIED>
- <!ATTLIST prim-key-class id ID #IMPLIED>
- <!ATTLIST primkey-field id ID #IMPLIED>
- <!ATTLIST reentrant 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 role-link id ID #IMPLIED>
- <!ATTLIST role-name id ID #IMPLIED>
- <!ATTLIST security-role id ID #IMPLIED>
- <!ATTLIST security-role-ref id ID #IMPLIED>
- <!ATTLIST session-type id ID #IMPLIED>
- <!ATTLIST session id ID #IMPLIED>
- <!ATTLIST small-icon id ID #IMPLIED>
- <!ATTLIST transaction-type id ID #IMPLIED>
- <!ATTLIST trans-attribute id ID #IMPLIED>
|