J2EE 配置文件 - ejb-jar.xml(中文)

J2EE 部署文件 - ejb-jar.xml pre] <ejb-jar> ejb-jar元素是EJB发布描述器的根元素,它包含一个可选的EJB-JAR文件的描述,可选显示的名称,可选小图标的文件名,可选的大图标的文件名,必须的所有被包含的enterprise bean 的结构信息 ,可选的应用装配描述器,可选的针对当前ejb-jar文件的ejb-client-jar 文件的名称 <description>A short description</description> ejb-jar 文件的描述性的说明 <display-name>A name</display-name> ejb-jar 文件显示的名称 <small-icon>employee-service-icon16x16.jpg</small-icon> small-icon 元素包含小图标(16 x 16)的名字,这个名称是在ejb-jar文件的相对路经,文件必须是jpg或者是gif格式,文件名必须以.jpg.或者gif为后缀,图标可以被工具使用 <large-icon>employee-service-icon32x32.jpg</large-icon> large-icon元素包含小图标(32 x 32)的名字,这个名称是在ejb-jar文件的相对路经,文件必须是jpg或者是gif格式,文件名必须以.jpg.或者gif为后缀,图标可以被工具使用 <enterprise-beans> enterprise-beans元素包含了多个enterprise beans的声明描述 <session> Session元素声明了一个session bean.声明由以下这些组成:一个可选的描述符,可选的显示名称;可选的小图标文件名,可选的大图标文件名,在发布描述符中分配给这个企业bean的名字,当前sessionBean的home及remote接口的名称,sessionBean的实现类的名,sessionBean的状态管理类型,sessionBean的事务类型,一个可选的bean的环境条目,一个可选的引用的EJB的声明,一个可选的安全角色的引用声明,一个可选的资源工厂的引用声明,那些称为可选的元素当它们描述的内容为空时,可以将它们省略掉的 <description>A short description</description> 一个简短的描述 <display-name>A name</display-name> 要显示的名称,这个名字可以被别的工具引用到 <small-icon>employee-service-icon16x16.jpg</small-icon> small-icon 元素包含小图标(16 x 16)的名字,这个名称是在ejb-jar文件的相对路经,文件必须是jpg或者是gif格式,文件名必须以.jpg.或者gif为后缀,图标可以被工具使用 <large-icon>employee-service-icon32x32.jpg</large-icon> large-icon元素包含小图标(32 x 32)的名字,这个名称是在ejb-jar文件的相对路经,文件必须是jpg或者是gif格式,文件名必须以.jpg.或者gif为后缀,图标可以被工具使用 <ejb-name>EmployeeService</ejb-name> ejb-name元素指明了企业bean的名称,它是由ejb-jar 文件的编写者命名的,这个名称在同一个ejb-jar文件中必须是唯一的,企业bean的代码不依赖于它,与它隔离的,所以企业bean的名称可以在应用装配的过程中改变而不会影响企业bean的功能.在发布描述器中的ejb-name与应用发布者即将分配给企业bean的home接口的JNDI的名称没有结构性的关系.名称必须定义的有意义 <home>com.aardvark.payroll.PayrollHome</home> home元素包含企业bean的具有完全的路经(具有完整的包名)的home接口 <remote>com.wombat.empl.EmployeeService</remote> remote元素包含企业bean的具有完全的路经(具有完整的包名)的remote接口 <ejb-class>com.wombat.empl.EmployeeServiceBean</ejb-class> ejb-class元素包含企业bean的具有完全的路经(具有完整的包名)的实现类 <session-type>Stateful/Stateless</session-type> session-type元素描述 sessionbean是stateful的还是stateless的,必须是两者中的一种. <transaction-type>Bean/Container</transaction-type> transaction-type元素的值必须是Bean和Container中的一个,也就是说事务类型必须它们中的一种. <env-entry> env-entry元素包含了企业bean的环境条目(environment entries)的声明,声明的内容包括可选的描述符,环境条目的名称,及可选的值 <description>A short description</description> 简短的描述 <env-entry-name>minAmount</env-entry-name> 一个企业bean 的 environment entry的名称 <env-entry-type>java.lang.String</env-entry-type> 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> env-entry-value元素描述了一个企业bean的环境条目的值 </env-entry> <ejb-ref> ejb-ref元素描述对的别的企业bean的home接口的引用.描述由以下部分组成:可选的描述符,使用的引用(参照)的EJB的名称,引用的企业bean的期望的类型及home和remote接口,可选的ejb-link 信息---指定引用的企业bean的标示 < description>A short description</description> 简短的描述 <ejb-ref-name>ejb/Payroll</ejb-ref-name> 表示引用的企业bean的名称,EJB参照是企业bean环境中的一条条目,记住名称是以”ejb/”为前缀的 <ejb-ref-type>Entity/Session</ejb-ref-type> 引用的企业bean的类型,它的值必须是Entity和Session两者之一 <home>com.aardvark.payroll.PayrollHome</home> home元素包含被引用的企业bean的具有完全的路经(具有完整的包名)的home接口 <remote>com.wombat.empl.EmployeeService</remote> remote元素包含被引用的企业bean的具有完全的路经(具有完整的包名)的remote接口 <ejb-link>EmployeeRecord</ejb-link> 链接到被引用的企业bean,它的值(有联系企业bean)必须在同一个ejb-jar文件中,或者是在同一J2EE Application中的别的ejb-jar中(就是<ejb-name>元素定义的被引用的企业bean名称) </ejb-ref> <security-role-ref> 包含在企业bean中被引用的安全角色的声明,声明包括以下各项:可选的描述符,安全角色的名称,,可选的到一个已经定义的安全角色的连接ole-name元素的值必须是个string,可以作为参数传给EJBContext.isCallerInRole(String roleName)方法, role-link元素的值必须是在security-role元素中定义过的 <description>A short description</description> 简短的描述 <role-name>name</role-name> 角色的名字,名字要有意义 <role-link>name</role-link> 一个已经定义的安全角色的连接, role-link元素的值必须是在security-role元素中定义过的 </ security-role-ref > <resource-ref> 包含企业bean对外部资源引用的声明,描述,它以下各项组成:可选的描述符, 引用资源工厂名,资源工厂的类型定义,认证的类型(bean或者container) <description>A short description</description> 简短的描述 <res-ref-name>name</res-ref-name> 指定引用资源工厂名 <res-type>javax.sql.DataSource</res-type> 指定数据源的类型,而它就是要使用数据源的Java接口(或者类)所期望的 <res-auth>Application/Container</res-auth> res-auth元素定义是由企业bean的代码作为资源管理器,还是由容器作为资源管理器.后一个选择, 发布者可以对容器提供支持,这个元素的值必须是Application和Container中的一个 </ resource-ref > </session> <entity> entity元素描述entity bean的,这些描述性的声明有以下各项组成:可选的描述符,可选的显示名称,可选的小图标文件名,可选的大图标文件名,在发布描述中指定企业bean的名称;entity bean的home和remote接口的名称,entity bean的实现类;entity bean持久性管理的类型;主键类的名称; Entity Bean's reentrancy 的声明;可选的容器管理的字段的列表;可选的指定的primary key的字段名;bean 环境条目的声明;bean参照的声明,安全角色参照的声明,资源工厂的参照声明(可选).等等;如果entity持久管理类型是container的话,在描述中就可以将primarykey-field元素表示出来.至少有一个cmpfield元素,而bean管理的持久性,就不能有这些了. <description>A short description</description> 一个简短的描述 <display-name>A name</display-name> 要显示的名称,这个名字可以被别的工具引用到 <small-icon>employee-service-icon16x16.jpg</small-icon> small-icon 元素包含小图标(16 x 16)的名字,这个名称是在ejb-jar 文件的相对路经,文件必须是jpg或者是gif格式,文件名必须以.jpg.或者gif为后缀,图标可以被工具使用