TongWeb5.0配置说明手册.pdf
10墨值下载
1.1. 部署描述符的字符集
通常，部署描述字符文件 XML 头定义为：<?xml version=”1.0” encoding=”UTF-8” ?>。
如果在部署描述符文件中出现中文字样，譬如中文的 EJB 名、中文方法名、中文成员变量
名或中文数据库字段名等，会出现部署描述文件的解析问题。虽然不推荐在部署文件中支持
中文，但为了提供更广泛的支持，TongWeb 允许在 EJB 开发中使用上述的中文定义。在这
种情况下，需要将描述符文件的 XML 头定义为：<?xml version=”1.0” encoding=”UTF-8” ?>
1.2. ejb-jar.xml
ejb-jar.xml 是描述 EJB 应用的 J2EE 标准部署描述符文件
1.3. tongweb-ejb-jar.xml
tongweb-ejb-jar.xml 是 定 义 TongWeb 中 EJB 特 定 属 性 的 部 署 描 述 文 件 。
tongweb-ejb-jar.xml 的 DTD 文件 tongweb-ejb-jar_2_1-1.dtd 保存在<TongWeb-Root>/conf/dtd
目录下。
下面是对 tongweb-ejb-jar_2_1-1.dtd 文件的介绍:
tongweb-ejb-jar：tongweb-ejb-jar.xml 文件中的根元素。
security-role-mapping: 将角色映射到用户和组。
security-role-mapping 子元素：
子元素
必需
说明
role-name
仅一个
安全角色名称(唯一)，对应相应的 JavaEE 标准
部署描述符文件(ejb-jar.xml)中的 security-role 元
素
principal-name
至少需要一个
principal-name
或 group-name
拥有该角色的用户名
group-name
分配给该角色的组名
enterprise-beans: 为应用程序中的 EJB JAR 文件指定所有运行时的属性。
Enterprise-beans 子元素：
子元素
必需
说明
name
零或一个
指定 ejb 模块名称
unique-id
零或一个
指定唯一系统标识符。此数据在部署/重新部署时自
动生成和更新
ejb
（availability-enabled）
零或多个
定义应用程序内单个 Enterprise Bean 的属性。
availability-enabled 集群时使用，有状态 session bean
使用
pm-descriptors
零或一个
持久化管理器描述符。必须在规定时间内使用其中
一个描述符。
cmp-resource
零或一个
定义 CMP 的持久化相关配置（数据源）
message-destination
零或多个
定义消息目的地
webservice-description
零或多个
定义 webservicee 描述
property
零或多个
自定义属性
ejb: 定义应用程序内单个 Enterprise Bean 的运行时属性。下面列出的子元素使用与特
定的 Enterprise Bean:
所有 Bean 类 型 ： ejb-name, ejb-ref, local-jndi-name, jndi-name, resource-ref,
resource-env-ref, message-destination-ref, pass-by-reference, ior-security-config, gen-classes,
ws-ref;
有状态会话 Bean: bean-cache, webservice-endpoint;
无 状 态 会 话 Bean: bean-pool, webservice-endpoint, checkpointed-methods,
checkpoint-at -end-of-method;
实体 Bean （ BMP ） : is-ready-only-bean, refresh-period-in-seconds, cmp,
commit-option,bean-cache, bean-pool, flush-at-end-of-method;
消息驱动 Bean: mdb-resource-adapter, mdb-connection-factory,
jms-durable-subscription-name, jms-max-message-load, bean-pool
EJB 子元素：
子元素
必需
说明
ejb-name
仅一个
ejb 名称,对应标准部署描述符文件（ejb-jar.xml）中的
ejb-name 元素
local-jndi-name
零或一个
ejb 的 local 接口的 JNDI 名称。
当 ejb 实现了 local 接 口 ， 如 果 应 用 没 有 设 置
local-jndi-name，应用服务器会使用一个默认值作为
local-jndi-name，默认值的规则如下：
（1）针对 ejb3.0，将 local-jndi-name 设置为 local
Business 接口的类名；
（ 2 ） 针 对 ejb2.x ，将 local-jndi-name 设 置 为
local-home 接口的类名。
jndi-name
零或一个
ejb 的 remote 接口的 JNDI 名称。
当 ejb 实 现 了 remote 接 口 ， 如 果 应 用 没 有 设 置
jndi-name ，应用服 务 器 会 使 用 一 个 默 认 值 作 为
jndi-name，默认规则如下：
1. 针对 ejb3.0，将 jndi-name 设置为 remote Business
接口的类名；
2. 针对 ejb2.x，将 jndi-name 设置为 home 接口的类名。
ejb-ref
零或多个
定义一个 ejb 到另一个 ejb 的引用
of 16
10墨值下载
【版权声明】本文为墨天轮用户原创内容，转载时必须标注文档的来源（墨天轮），文档链接，文档作者等基本信息，否则作者和墨天轮有权追究责任。如果您发现墨天轮中有涉嫌抄袭或者侵权的内容，欢迎发送邮件至：contact@modb.pro进行举报，并提供相关证据，一经查实，墨天轮将立刻删除相关内容。
下载排行榜
评论