http://longtangwan.iteye.com/blog/806834
- <ejb-jar><!--EJB发布描述器的根元素,它包含一个可选的EJB-JAR文件的描述,可选显示的名称,可选小图标的文件名,可选的大图标的文件名,必须的所有被包含的enterprisebean的结构信息,可选的应用装配描述器,可选的针对当前ejb-jar文件的ejb-client-jar文件的名称-->
- description>Ashortdescription</<!--ejb-jar文件的描述性的说明-->
- display-name>Aname<!--ejb-jar文件显示的名称-->
- small-icon>employee-service-icon16x16.jpg<!--small-icon元素包含小图标(16x16)的名字,这个名称是在ejb-jar文件的相对路经,文件必须是jpg或者是gif格式,文件名必须以.jpg.或者gif为后缀,图标可以被工具使用-->
- large-icon>employee-service-icon32x32.jpg<!--large-icon元素包含小图标(32x32)的名字,153); font-weight:bold">enterprise-beans<!--enterprise-beans元素包含了多个enterprisebeans的声明描述-->
- session<!--Session元素声明了一个sessionbean.声明由以下这些组成:一个可选的描述符,可选的显示名称;可选的小图标文件名,可选的大图标文件名,在发布描述符中分配给这个企业bean的名字,当前sessionBean的home及remote接口的名称,sessionBean的实现类的名,sessionBean的状态管理类型,sessionBean的事务类型,一个可选的bean的环境条目,一个可选的引用的EJB的声明,一个可选的安全角色的引用声明,一个可选的资源工厂的引用声明,那些称为可选的元素当它们描述的内容为空时,可以将它们省略掉的-->
- >
- <!--要显示的名称,这个名字可以被别的工具引用到-->
- ejb-name>EmployeeService<!--ejb-name元素指明了企业bean的名称,它是由ejb-jar文件的编写者命名的,这个名称在同一个ejb-jar文件中必须是唯一的,企业bean的代码不依赖于它,与它隔离的,所以企业bean的名称可以在应用装配的过程中改变而不会影响企业bean的功能.在发布描述器中的ejb-name与应用发布者即将分配给企业bean的home接口的JNDI的名称没有结构性的关系.名称必须定义的有意义-->
- home>com.aardvark.payroll.PayrollHome<!--home元素包含企业bean的具有完全的路经(具有完整的包名)的home接口-->
- remote>com.wombat.empl.EmployeeService<!--remote元素包含企业bean的具有完全的路经(具有完整的包名)的remote接口-->
- ejb-class>com.wombat.empl.EmployeeServiceBean<!--ejb-class元素包含企业bean的具有完全的路经(具有完整的包名)的实现类-->
- session-type>Stateful/Stateless<!--session-type元素描述sessionbean是stateful的还是stateless的,必须是两者中的一种.-->
- transaction-type>Bean/Container<!--transaction-type元素的值必须是Bean和Container中的一个,也就是说事务类型必须它们中的一种.-->
- env-entry<!--env-entry元素包含了企业bean的环境条目(environmententries)的声明,声明的内容包括可选的描述符,环境条目的名称,及可选的值-->
- env-entry-name>minAmount<!--一个企业bean的environmententry的名称-->
- env-entry-type>java.lang.String<!--env-entry-type元素包含了具有`完全限制的企业bean代码期望得到的Java类型值,别的合法的类型值:java.lang.Boolean,java.lang.String,java.lang.Integer,java.lang.Double,java.lang.Byte,java.lang.Short,java.lang.Long,java.lang.Float.-->
- env-entry-value>100.00<!--env-entry-value元素描述了一个企业bean的环境条目的值-->
- ejb-ref<!--ejb-ref元素描述对的别的企业bean的home接口的引用.描述由以下部分组成:可选的描述符,使用的引用(参照)的EJB的名称,引用的企业bean的期望的类型及home和remote接口,可选的ejb-link信息-指定引用的企业bean的标示-->
- ejb-ref-name>ejb/Payroll<!--表示引用的企业bean的名称,EJB参照是企业bean环境中的一条条目,记住名称是以”ejb/”为前缀的-->
- ejb-ref-type>Entity/Session<!--引用的企业bean的类型,它的值必须是Entity和Session两者之一-->
- ejb-link>EmployeeRecord<!--链接到被引用的企业bean,它的值(有联系企业bean)必须在同一个ejb-jar文件中,或者是在同一J2EEApplication中的别的ejb-jar中(就是<ejb-name>元素定义的被引用的企业bean名称)-->
- security-role-ref<!--包含在企业bean中被引用的安全角色的声明,声明包括以下各项:可选的描述符,安全角色的名称,可选的到一个已经定义的安全角色的连接ole-name元素的值必须是个string,可以作为参数传给EJBContext.isCallerInRole(StringroleName)方法,role-link元素的值必须是在security-role元素中定义过的-->
- role-name>name<!--角色的名字,名字要有意义-->
- role-link<!--一个已经定义的安全角色的连接,153); font-weight:bold">resource-ref<!--包含企业bean对外部资源引用的声明,描述,它以下各项组成:可选的描述符,引用资源工厂名,资源工厂的类型定义,认证的类型(bean或者container)-->
- <!--简短的描述-->
- res-ref-name<!--指定引用资源工厂名-->
- res-type>javax.sql.DataSource<!--指定数据源的类型,而它就是要使用数据源的Java接口(或者类)所期望的-->
- res-auth>Application/Container<!--res-auth元素定义是由企业bean的代码作为资源管理器,还是由容器作为资源管理器.后一个选择,发布者可以对容器提供支持,这个元素的值必须是Application和Container中的一个-->
- entity<!--entity元素描述entitybean的,这些描述性的声明有以下各项组成:可选的描述符,可选的显示名称,可选的小图标文件名,在发布描述中指定企业bean的名称;entitybean的home和remote接口的名称,entitybean的实现类;entitybean持久性管理的类型;主键类的名称;EntityBean'sreentrancy的声明;可选的容器管理的字段的列表;可选的指定的primarykey的字段名;bean环境条目的声明;bean参照的声明,安全角色参照的声明,资源工厂的参照声明(可选).等等;如果entity持久管理类型是container的话,在描述中就可以将primarykey-field元素表示出来.至少有一个cmpfield元素,而bean管理的持久性,就不能有这些了.-->
- <!--一个简短的描述-->
- persistence-type<!--persistence-type元素指定entitybean的持久性管理的类型,它必须是下面两个之一:Bean,Container-->
- prim-key-class>com.wombat.empl.EmployeeID<!--prim-key-class元素指定了具有完全限定的entitybean的主键类的名称,如果主键类的定义依赖发布的时间,主键类元素的值应该是java.lang.Object;-->
- reentrant>True/False<!--Thereentrantelementspecifieswhetheranentitybeanisreentrantornot.Thereentrantelementmustbeoneofthetwofollowing:TrueorFalse-->
- cmp-field<!--cmp-field描述容器管理的字段.包括一个可选的字段描述,字段的名称.-->
- field-name>firstName<!--field-name元素指定容器管理的字段的名,名称必须企业bean的公共字段或者是它的超类中的公共字段.-->
- primkey-field>fieldName<!--primkey-field元素指定容器管理的Bean的主键字段.它必须是在cmp-field元素中声明过的,类型必须和主键类的一样,如果主键映射为多个容器管理的字段(也就是说是一个复合主键),那么就地取材没必要条件使用这个元素了.在这种情况下,主键类的字段必须是公共的,它们的名字必须与包含主键的entitybean的字段名相符合.-->
- <!--env-entry元素包含了企业bean的环境入口(environmententries)的声明,环境入口的名称,0); padding:0px; margin:0px; width:auto; border:0px"><!--env-entry-value元素描述了一个企业bean的环境入口的值-->
- 文件中典型的包含一个应用的组装.-->
- <!--home元素包含被引用的企业bean的具有完全的路经(具有完整的包名)的home接口-->
- <!--remote元素包含被引用的企业bean的具有完全的路经(具有完整的包名)的remote接口-->
- 名称)-->
- assembly-descriptor<!--assembly-descriptor元素包含了应用配置信息.应用的装配信息由以下部分组成:安全角色的定义,许可访问的方法的定义,容器管理的事务属性的定义,所有的部分都是可选的,提供装配描述符在整个ejb-jar文件中也是可选的.-->
- security-role<!--提供安全角色的定义,定义的内容包括角色的描述,角色的名称-->
- <!--安全角色的名称,名称要有意义-->
- method-permission<!--指定企业bean的某个方法允许被哪个安全的角色访问,调用.这个元素由以下各项组成:可选的描述符,一个安全角色的名称列表,一个方法元素列表;在这里使用的安全角色必须在security-role元素中定义过的,而方法必须是在企业bean的home/remote接口中定义过的-->
- method<!--1.<method>-->
- >EJBNAMEmethod-name>*<!--这种类型的定义将涉及到指定的企业bean的home及remote所有方法-->
- >METHOD<!--这种定义涉及到特定的方法,如果bean有方法重载的话,那么这种定义就表示将涉及到所有的具有相同方法名的重载方法-->
- method-paramsmethod-param>PARAM-1>PARAM-n<!--使用这种方法只指定了一个方法,根据参数的不同来选择,参数的值是带全路经的java类型,如果方法无参,method-params元素里不包含任何method-param元素-->
- method-intf>Home/Remote<!--method-intf元素可以区分同时定义在home和remote接口中的方法,它的值必须是Home和Remote两者之一-->
- >nameOfMethod<!--theenterprisebean'sremoteandhomeinterfaces中定义的方法名称,如果它的值是’*’的话,表示所有的方法-->
- <!--包含一系列的方法参数的全路经JAVA类型名-->
- >int[]<!--包含方法参数的全路经JAVA类型名-->
- container-transaction<!--container-transaction指定容器在企业bean方法论被调用的时候,是如何管理的事务领域的.由以下各项组成:可选的描述符,一系列方法元素,事务属性.应用事务属性到所有被指定的方法中.-->
- trans-attribute>Supports<!--trans-attribute元素指定了容器如何管理必须管理的事务界线,在一个企业bean的业务方法被调用的时候;它的值必须是下面几中之一:NotSupported,Supports,required,RequiresNew,MandatoryorNever-->
- ejb-client-jar>employee_service_client.jar<!--可选的ejb-client-jar元素指定一个JAR文件,这个文件包含了一个客户端程序访问EJB-JAR文件中定义的企业Bean时所需要的类文件.发布者使得EJBCLIENTJAR文件对于客户端的类装载器来说变得容易访问了-->
- > @H_701_403@