ejb-jar_2_1.xsd

jsp开发 com.objectlearn.jdt.j2ee_3.0.1

	    The cmr-field-name element specifies the name of a
	    logical relationship field in the entity bean
	    class. The name of the cmr-field must begin with a
	    lowercase letter. This field is accessed by methods
	    whose names consist of the name of the field
	    specified by cmr-field-name in which the first
	    letter is uppercased, prefixed by "get" or "set".

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
      <xsd:element name="cmr-field-type"
		   type="j2ee:cmr-field-typeType"
		   minOccurs="0"/>
    </xsd:sequence>
    <xsd:attribute name="id" type="xsd:ID"/>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="container-transactionType">
    <xsd:annotation>
      <xsd:documentation>

	The container-transactionType specifies how the container
	must manage transaction scopes for the enterprise bean's
	method invocations. It defines an optional description, a
	list of method elements, and a transaction attribute. The
	transaction attribute is to be applied to all the specified
	methods.

      </xsd:documentation>
    </xsd:annotation>

    <xsd:sequence>
      <xsd:element name="description"
		   type="j2ee:descriptionType"
		   minOccurs="0"
		   maxOccurs="unbounded"/>
      <xsd:element name="method"
		   type="j2ee:methodType"
		   maxOccurs="unbounded"/>
      <xsd:element name="trans-attribute"
		   type="j2ee:trans-attributeType"/>
    </xsd:sequence>
    <xsd:attribute name="id" type="xsd:ID"/>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="ejb-classType">
    <xsd:annotation>
      <xsd:documentation>
	<![CDATA[

	  The ejb-classType contains the fully-qualified name of the
	  enterprise bean's class. It is used by ejb-class elements.

	  Example:

	      <ejb-class>com.wombat.empl.EmployeeServiceBean</ejb-class>

	  ]]>
      </xsd:documentation>
    </xsd:annotation>
    <xsd:simpleContent>
      <xsd:restriction base="j2ee:fully-qualified-classType"/>
    </xsd:simpleContent>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="ejb-jarType">
    <xsd:annotation>
      <xsd:documentation>

	The ejb-jarType defines the root element of the EJB
	deployment descriptor. It contains

	    - an optional description of the ejb-jar file
	    - an optional display name
	    - an optional icon that contains a small and a large
	      icon file name
	    - mandatory structural information about all included
	      enterprise beans
	    - a descriptor for container managed relationships,
	      if any
	    - an optional application-assembly descriptor
	    - an optional name of an ejb-client-jar file for the
	      ejb-jar.

      </xsd:documentation>
    </xsd:annotation>

    <xsd:sequence>
      <xsd:group ref="j2ee:descriptionGroup"/>
      <xsd:element name="enterprise-beans"
		   type="j2ee:enterprise-beansType"/>
      <xsd:element name="relationships"
		   type="j2ee:relationshipsType"
		   minOccurs="0">
	<xsd:unique name="relationship-name-uniqueness">
	  <xsd:annotation>
	    <xsd:documentation>

	      The ejb-relation-name contains the name of a
	      relation. The name must be unique within
	      relationships.

	    </xsd:documentation>
	  </xsd:annotation>
	  <xsd:selector xpath="j2ee:ejb-relation"/>
	  <xsd:field    xpath="j2ee:ejb-relation-name"/>
	</xsd:unique>
      </xsd:element>
      <xsd:element name="assembly-descriptor"
		   type="j2ee:assembly-descriptorType"
		   minOccurs="0">
	<xsd:annotation>
	  <xsd:documentation>

	    Providing an assembly-descriptor in the deployment
	    descriptor is optional for the ejb-jar file
	    producer.

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
      <xsd:element name="ejb-client-jar"
		   type="j2ee:pathType"
		   minOccurs="0">
	<xsd:annotation>
	  <xsd:documentation>
	    <![CDATA[

	      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.

	      Example:

		  <ejb-client-jar>employee_service_client.jar
		  </ejb-client-jar>

	      ]]>
	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
    </xsd:sequence>
    <xsd:attribute name="version"
		   type="j2ee:dewey-versionType"
		   fixed="2.1"
		   use="required">
      <xsd:annotation>
	<xsd:documentation>

	  The version specifies the version of the
	  EJB specification that the instance document must
	  comply with. This information enables deployment tools
	  to validate a particular EJB Deployment
	  Descriptor with respect to a specific version of the EJB
	  schema.

	</xsd:documentation>
      </xsd:annotation>
    </xsd:attribute>
    <xsd:attribute name="id" type="xsd:ID"/>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="ejb-nameType">
    <xsd:annotation>
      <xsd:documentation>
	<![CDATA[

	  The ejb-nameType specifies an enterprise bean's name. It is
	  used by ejb-name elements. 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.

	  There is no architected relationship between the used
	  ejb-name in the deployment descriptor and the JNDI name that
	  the Deployer will assign to the enterprise bean's home.

	  The name for an entity bean must conform to the lexical
	  rules for an NMTOKEN.

	  Example:

	  <ejb-name>EmployeeService</ejb-name>

	  ]]>
      </xsd:documentation>
    </xsd:annotation>
    <xsd:simpleContent>
      <xsd:restriction base="j2ee:xsdNMTOKENType"/>
    </xsd:simpleContent>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="ejb-relationType">
    <xsd:annotation>
      <xsd:documentation>

	The ejb-relationType describes a relationship between two
	entity beans with container-managed persistence.  It is used
	by ejb-relation elements. It contains a description; an
	optional ejb-relation-name element; and exactly two
	relationship role declarations, defined by the
	ejb-relationship-role elements. The name of the
	relationship, if specified, is unique within the ejb-jar
	file.

      </xsd:documentation>
    </xsd:annotation>

    <xsd:sequence>
      <xsd:element name="description"
		   type="j2ee:descriptionType"
		   minOccurs="0"
		   maxOccurs="unbounded"/>
      <xsd:element name="ejb-relation-name"
		   type="j2ee:string"
		   minOccurs="0">
	<xsd:annotation>
	  <xsd:documentation>

	    The ejb-relation-name element provides a unique name
	    within the ejb-jar file for a relationship.

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
      <xsd:element name="ejb-relationship-role"
		   type="j2ee:ejb-relationship-roleType"/>
      <xsd:element name="ejb-relationship-role"
		   type="j2ee:ejb-relationship-roleType"/>
    </xsd:sequence>
    <xsd:attribute name="id" type="xsd:ID"/>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="ejb-relationship-roleType">
    <xsd:annotation>
      <xsd:documentation>
	<![CDATA[

	  The ejb-relationship-roleType describes a role within a
	  relationship. There are two roles in each relationship.

	  The ejb-relationship-roleType contains an optional
	  description; an optional name for the relationship role; a
	  specification of the multiplicity of the role; an optional
	  specification of cascade-delete functionality for the role;
	  the role source; and a declaration of the cmr-field, if any,
	  by means of which the other side of the relationship is
	  accessed from the perspective of the role source.

	  The multiplicity and role-source element are mandatory.

	  The relationship-role-source element designates an entity
	  bean by means of an ejb-name element. For bidirectional
	  relationships, both roles of a relationship must declare a
	  relationship-role-source element that specifies a cmr-field
	  in terms of which the relationship is accessed. The lack of
	  a cmr-field element in an ejb-relationship-role specifies
	  that the relationship is unidirectional in navigability and
	  the entity bean that participates in the relationship is
	  "not aware" of the relationship.

	  Example:

	  <ejb-relation>
	      <ejb-relation-name>Product-LineItem</ejb-relation-name>
	      <ejb-relationship-role>
		  <ejb-relationship-role-name>product-has-lineitems
		  </ejb-relationship-role-name>
		  <multiplicity>One</multiplicity>
		  <relationship-role-source>
		  <ejb-name>ProductEJB</ejb-name>
		  </relationship-role-source>
	       </ejb-relationship-role>
	  </ejb-relation>

	  ]]>
      </xsd:documentation>
    </xsd:annotation>

    <xsd:sequence>
      <xsd:element name="description"
		   type="j2ee:descriptionType"
		   minOccurs="0"
		   maxOccurs="unbounded"/>
      <xsd:element name="ejb-relationship-role-name"
		   type="j2ee:string"
		   minOccurs="0">
	<xsd:annotation>
	  <xsd:documentation>

	    The ejb-relationship-role-name element defines a
	    name for a role that is unique within an
	    ejb-relation. Different relationships can use the
	    same name for a role.

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
      <xsd:element name="multiplicity"
		   type="j2ee:multiplicityType"/>
      <xsd:element name="cascade-delete"
		   type="j2ee:emptyType"
		   minOccurs="0">
	<xsd:annotation>
	  <xsd:documentation>

	    The cascade-delete element specifies that, within a
	    particular relationship, the lifetime of one or more
	    entity beans is dependent upon the lifetime of
	    another entity bean. The cascade-delete element can
	    only be specified for an ejb-relationship-role
	    element contained in an ejb-relation element in
	    which the other ejb-relationship-role
	    element specifies a multiplicity of One.

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
      <xsd:element name="relationship-role-source"
		   type="j2ee:relationship-role-sourceType"/>
      <xsd:element name="cmr-field"
		   type="j2ee:cmr-fieldType"
		   minOccurs="0"/>
    </xsd:sequence>
    <xsd:attribute name="id" type="xsd:ID"/>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="enterprise-beansType">
    <xsd:annotation>
      <xsd:documentation>

	The enterprise-beansType declares one or more enterprise
	beans. Each bean can be a session, entity or message-driven
	bean.

      </xsd:documentation>
    </xsd:annotation>

    <xsd:choice maxOccurs="unbounded">
      <xsd:element name="session"
		   type="j2ee:session-beanType">
	<xsd:unique name="session-ejb-local-ref-name-uniqueness">
	  <xsd:annotation>
	    <xsd:documentation>

	      The ejb-ref-name element contains the name of
	      an EJB reference. The EJB reference is an entry in
	      the component's environment and is relative to the
	      java:comp/env context.  The name must be unique within
	      the component.

	      It is recommended that name be prefixed with "ejb/".

	    </xsd:documentation>
	  </xsd:annotation>
	  <xsd:selector xpath="j2ee:ejb-local-ref"/>
	  <xsd:field    xpath="j2ee:ejb-ref-name"/>
	</xsd:unique>

	<xsd:unique name="session-ejb-ref-name-uniqueness">
	  <xsd:annotation>
	    <xsd:documentation>

	      The ejb-ref-name element contains the name of an EJB
	      reference. The EJB reference is an entry in the
	      component's environment and is relative to the
	      java:comp/env context. The name must be unique
	      within the component.

	      It is recommended that name is prefixed with "ejb/".

	    </xsd:documentation>
	  </xsd:annotation>
	  <xsd:selector xpath="j2ee:ejb-ref"/>
	  <xsd:field    xpath="j2ee:ejb-ref-name"/>
	</xsd:unique>

	<xsd:unique name="session-resource-env-ref-uniqueness">
	  <xsd:annotation>
	    <xsd:documentation>

	      The resource-env-ref-name element specifies the name
	      of a resource environment reference; its value is
	      the environment entry name used in the component
	      code. The name is a JNDI name relative to the
	      java:comp/env context and must be unique within an
	      component.

	    </xsd:documentation>
	  </xsd:annotation>
	  <xsd:selector xpath="j2ee:resource-env-ref"/>
	  <xsd:field    xpath="j2ee:resource-env-ref-name"/>
	</xsd:unique>

	<xsd:unique name="session-message-destination-ref-uniqueness">
	  <xsd:annotation>
	    <xsd:documentation>

	      The message-destination-ref-name element specifies the name
	      of a message destination reference; its value is
	      the message destination reference name used in the component
	      code. The name is a JNDI name relative to the
	      java:comp/env context and must be unique within an