SCA Service Component Architecture SCA服务构件架构 ——2008.9

Transcription

1 SCA Service Component Architecture SCA 服 务 构 件 架 构 装 配 模 型 规 范 满 江 红 redsaga.com SCA v1.00,

2 SCA Service Component Architecture Assembly Model Specification SCA Version 1.00, March Technical Contacts: Michael Beisiegel IBM Corporation Henning Blohm SAP AG Dave Booz IBM Corporation Mike Edwards IBM Corporation Oisin Hurley IONA Technologies plc. Sabin Ielceanu TIBCO Software Inc. Alex Miller BEA Systems, Inc. Anish Karmarkar Oracle Ashok Malhotra Oracle Jim Marino BEA Systems, Inc. Martin Nally IBM Corporation Eric Newcomer IONA Technologies plc. Sanjay Patil SAP AG Greg Pavlik Oracle Martin Raepple SAP AG Michael Rowley BEA Systems, Inc. Ken Tam BEA Systems, Inc. Scott Vorthmann TIBCO Software Inc. Peter Walker Sun Microsystems Inc. Lance Waterman Sybase, Inc.

3 Copyright Notice Copyright BEA Systems, Inc., Cape Clear Software, International Business Machines Corp, Interface21, IONA Technologies, Oracle, Primeton Technologies, Progress Software, Red Hat, Rogue Wave Software, SAP AG., Siemens AG., Software AG., Sun Microsystems, Inc., Sybase Inc., TIBCO Software Inc., 2005, All rights reserved. License The Service Component Architecture Specification is being provided by the copyright holders under the following license. By using and/or copying this work, you agree that you have read, understood and will comply with the following terms and conditions: Permission to copy, display and distribute the Service Component Architecture Specification and/or portions thereof, without modification, in any medium without fee or royalty is hereby granted, provided that you include the following on ALL copies of the Service Component Architecture Specification, or portions thereof, that you make: 1. A link or URL to the Service Component Architecture Specification at this location: 2. The full text of the copyright notice as shown in the Service Component Architecture Specification. BEA, Cape Clear, IBM, Interface21, IONA, Oracle, Primeton, Progress Software, Red Hat, Rogue Wave, SAP, Siemens, Software AG., Sun, Sybase, TIBCO (collectively, the Authors ) agree to grant you a royalty-free license, under reasonable, non-discriminatory terms and conditions to patents that they deem necessary to implement the Service Component Architecture Specification. THE Service Component Architecture SPECIFICATION IS PROVIDED "AS IS," AND THE AUTHORS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, REGARDING THIS SPECIFICATION AND THE IMPLEMENTATION OF ITS CONTENTS, INCLUDING, BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT OR TITLE. THE AUTHORS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR RELATING TO ANY USE OR DISTRIBUTION OF THE Service Components Architecture SPECIFICATION. The name and trademarks of the Authors may NOT be used in any manner, including advertising or publicity pertaining to the Service Component Architecture Specification or its contents without specific, written prior permission. Title to copyright in the Service Component Architecture Specification will at all times remain with the Authors. No other rights are granted by implication, estoppel or otherwise. 3 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

4 Status of this Document This specification may change before final release and you are cautioned against relying on the content of this specification. The authors are currently soliciting your contributions and suggestions. Licenses are available for the purposes of feedback and (optionally) for implementation. IBM is a registered trademark of International Business Machines Corporation in the United States, other countries, or both. BEA is a registered trademark of BEA Systems, Inc. Cape Clear is a registered trademark of Cape Clear Software IONA and IONA Technologies are registered trademarks of IONA Technologies plc. Oracle is a registered trademark of Oracle USA, Inc. Progress is a registered trademark of Progress Software Corporation Primeton is a registered trademark of Primeton Technologies, Ltd. Red Hat is a registered trademark of Red Hat Inc. Rogue Wave is a registered trademark of Quovadx, Inc SAP is a registered trademark of SAP AG. SIEMENS is a registered trademark of SIEMENS AG Software AG is a registered trademark of Software AG Sun and Sun Microsystems are registered trademarks of Sun Microsystems, Inc. Sybase is a registered trademark of Sybase, Inc. TIBCO is a registered trademark of TIBCO Software Inc. Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others. 4 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

5 目 录 License... 3 Status of this Document... 4 目 录 装 配 模 型 简 介 概 述 描 述 SCA 工 件 图 构 件 例 子 构 件 实 现 构 件 类 型 接 口 本 地 和 远 程 接 口 双 向 接 口 会 话 接 口 WSDL 接 口 的 SCA 相 关 方 面 组 合 构 件 属 性 - 定 义 和 配 置 引 用 服 务 Wire 将 组 合 构 件 作 为 构 件 实 现 使 用 通 过 包 含 使 用 组 合 构 件 包 含 多 种 类 型 构 件 实 现 的 组 合 构 件 强 制 类 型 绑 定 包 含 了 并 未 在 服 务 接 口 中 定 义 的 数 据 的 消 息 已 部 署 绑 定 的 URI 形 式 SCA Binding Web Service 绑 定 JMS 绑 定 SCA 定 义 扩 展 模 型 定 义 一 个 接 口 类 型 定 义 一 个 实 现 类 型 定 义 一 个 绑 定 类 型 打 包 以 及 部 署 域 Contributions 已 安 装 的 contribution 对 contribution 的 操 作 对 已 存 在 ( 非 SCA) 的 工 件 解 析 机 制 的 使 用 域 级 组 合 构 件 附 录 XML Schemas sca.xsd / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

6 2.1.2 sca-core.xsd sca-binding-sca.xsd sca-interface-java.xsd sca-interface-wsdl.xsd sca-implementation-java.xsd sca-implementation-composite.xsd sca-definitions.xsd sca-binding-webservice.xsd sca-binding-jms.xsd sca-policy.xsd SCA 概 念 绑 定 构 件 服 务 引 用 实 现 接 口 组 合 构 件 组 合 构 件 包 含 属 性 域 连 线 附 录 2: 参 考 文 献 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

7 1. 装 配 模 型 1.1 简 介 该 文 档 描 述 SCA 装 配 模 型, 其 覆 盖 如 下 内 容 : 服 务 的 装 配 模 型, 既 适 合 紧 耦 合 也 适 合 松 散 耦 合 应 用 基 础 设 施 功 能 于 服 务 与 服 务 交 互 模 型, 包 括 安 全 性 和 事 务 性 本 文 档 首 先 简 短 概 述 SCA 装 配 模 型 然 后 描 述 了 SCA 的 核 心 元 素,SCA component 和 SCA composite 文 档 的 最 后 部 分 定 义 SCA 装 配 模 型 是 如 何 扩 展 的 1.2 概 述 SCA 为 构 建 基 于 SOA 的 应 用 和 解 决 方 案 提 供 了 编 程 模 型 它 基 于 这 样 的 理 念 : 将 业 务 功 能 作 为 一 系 列 的 服 务 而 提 供, 并 由 这 一 系 列 的 服 务 组 装 起 来 的 解 决 方 案 来 满 足 特 定 业 务 需 求 这 些 组 合 的 应 用 既 包 括 为 应 用 而 新 创 建 的 特 定 服 务, 也 包 括 源 自 已 已 存 在 系 统 和 应 用 的 业 务 逻 辑, 这 些 业 务 逻 辑 作 为 组 合 构 件 的 一 部 分 被 复 用 SCA 既 为 服 务 的 组 合 也 为 服 务 构 件 的 创 建 提 供 了 模 型, 包 括 对 SCA 组 组 合 构 件 中 对 已 存 在 应 用 功 能 的 复 用 SCA 就 是 一 个 致 力 于 为 服 务 构 件 以 及 连 接 各 服 务 构 件 的 访 问 方 式 而 包 容 各 种 广 泛 的 技 术 模 型 对 于 构 件, 不 仅 仅 只 是 不 同 的 编 程 语 言, 还 包 括 那 些 编 程 语 言 普 遍 使 用 的 框 架 和 环 境 对 于 访 问 方 式,SCA 组 合 允 许 使 用 广 泛 采 用 的 各 种 通 讯 和 服 务 访 问 技 术 其 中 包 括 如 Web service Messaging 系 统 以 及 远 程 过 程 调 用 (RPC) 技 术 等 SCA 装 配 模 型 由 一 系 列 工 件 组 成 这 些 工 件 定 义 了 SCA 域 的 配 置 信 息, 域 中 的 组 合 构 件 组 合 构 件 组 合 构 件 包 含 了 服 务 构 件 集 连 接 以 及 描 述 它 们 是 如 何 被 连 接 在 一 起 的 相 关 工 件 SCA 的 基 础 工 件 就 是 component, 它 是 SCA 的 构 成 单 元 构 件 (component) 由 一 个 实 现 的 可 配 置 (implementation) 实 例 所 组 成 在 该 构 件 中, 实 现 是 提 供 业 务 功 能 的 程 序 代 码 片 段 该 业 务 功 能 作 为 服 务 (service) 而 提 供, 为 其 他 构 件 所 使 用 实 现 也 许 依 赖 于 由 其 他 构 件 所 提 供 的 服 务, 这 些 依 赖 被 称 作 引 用 (reference) 实 现 可 以 有 一 个 可 设 置 的 属 性 (properties), 该 属 性 是 可 以 影 响 业 务 功 能 操 作 的 数 据 值 构 件 通 过 提 供 属 性 值 和 连 线 (wire) 到 由 其 他 构 件 提 供 服 务 的 引 用 来 配 置 实 现 SCA 允 许 各 种 广 泛 采 用 的 实 现 技 术, 比 如 传 统 的 编 程 语 言, 如 Java,C++,BPEL, 也 包 括 脚 本 语 言, 如 PHP, Javascript, 还 包 括 声 明 性 语 言, 如 XQuery 和 SQL 7 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

8 SCA 把 在 装 配 应 用 中 的 内 容 和 联 接 称 为 组 合 构 件 (composite) 组 合 构 件 能 包 含 构 件, 服 务, 引 用, 属 性 声 明 以 及 描 述 这 些 元 素 间 连 接 的 连 线 (wire) 组 合 构 件 可 以 分 组 并 连 接 以 不 同 技 术 实 现 的 构 件, 其 允 许 为 每 个 业 务 任 务 使 用 相 应 的 技 术 反 过 来, 组 合 构 件 能 作 为 完 整 的 构 件 实 现 来 使 用 : 提 供 服 务, 依 赖 引 用 以 及 可 设 置 的 属 性 值 这 样 的 组 合 构 件 实 现 能 用 于 其 他 组 合 构 件 中 的 构 件, 支 持 业 务 解 决 方 案 的 分 层 构 建 在 该 解 决 方 案 中, 高 层 服 务 内 部 是 由 一 系 列 的 低 层 服 务 实 现 的 组 合 构 件 的 内 容 能 作 为 元 素 组 来 使 用 该 元 素 组 通 过 包 含 于 高 层 的 组 合 构 件 中 发 挥 作 用 组 合 构 件 被 部 署 于 SCA Domain 中 典 型 地,SCA 域 描 述 了 一 系 列 的 服 务, 这 些 服 务 提 供 了 由 某 个 单 一 组 织 控 制 的 业 务 功 能 区 域 举 例 来 说, 对 于 商 务 中 的 会 计 部 门,SCA 域 也 许 会 涵 盖 所 有 与 财 务 相 关 的 功 能, 也 可 能 包 含 一 系 列 处 理 特 定 会 计 范 围 的 组 合 构 件, 一 个 处 理 客 户 帐 户, 另 一 个 处 理 帐 户 支 付 为 了 方 便 构 建 和 配 置 SCA 域, 组 合 构 件 被 用 于 分 组 和 配 置 相 关 的 工 件 SCA 为 它 的 工 件 定 义 了 XML 文 件 格 式 这 些 XML 文 件 定 义 了 SCA 工 件 的 可 移 植 描 述 SCA 运 行 时 可 以 拥 有 由 这 些 XML 文 件 所 表 示 工 件 的 其 他 描 述 特 别 地, 采 用 某 种 编 程 语 言 构 件 实 现 可 以 有 属 性 或 用 于 指 定 SCA 装 配 模 型 中 某 些 元 素 的 注 解 (annotation) 这 些 XML 为 SCA 域 的 配 置 定 义 了 一 个 静 态 的 格 式 SCA 运 行 时 也 允 许 动 态 地 修 改 域 的 配 置 描 述 SCA 工 件 图 该 文 档 引 入 图 来 描 述 各 种 SCA 工 件, 可 视 化 在 组 合 件 中 工 件 之 间 的 关 系 这 些 图 用 来 配 合 并 说 明 SCA 工 件 的 案 例 下 图 说 明 了 SCA 构 件 的 一 些 特 征 : 8 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

9 Figure 1: SCA Component Diagram 下 图 阐 述 了 使 用 一 系 列 构 件 组 装 的 组 合 构 件 的 一 些 特 征 : 9 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

10 Figure 2: SCA Composite Diagram 下 图 说 明 了 由 一 系 列 高 层 组 合 构 件 装 配 而 成 的 SCA 域, 其 中 某 些 高 层 组 合 构 件 是 由 低 层 组 合 构 件 依 次 实 现 的 10 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

11 1.3 构 件 Component 是 SCA 组 合 件 中 业 务 功 能 的 基 础 元 素 其 通 过 SCA 组 合 构 件 联 合 成 完 整 的 业 务 解 决 方 案 Component 是 实 现 的 可 配 置 实 例 构 件 提 供 和 消 费 服 务 多 个 构 件 可 以 使 用 和 配 置 为 同 一 个 实 现, 而 每 个 构 件 又 可 以 对 实 现 有 不 同 的 配 置 构 件 在 xxx.composite 文 件 中 作 为 组 合 构 件 的 子 元 素 来 声 明 component 元 素 代 表 构 件, 它 是 组 合 构 件 (composite) 元 素 的 子 元 素 在 composite 中 可 以 有 零 个 或 多 个 component 元 素 以 下 片 段 展 示 了 带 有 component 子 元 素 schema 的 composite schema <?xml version="1.0" encoding="utf-8"?> <!-- Component schema snippet --> <composite xmlns=" targetnamespace="xs:anyuri" name="xs:ncname" local="xs:boolean"? autowire="xs:boolean"? constrainingtype="qname"? requires="list of xs:qname"? policysets="list of xs:qname"?>... <component name="xs:ncname" requires="list of xs:qname"? autowire="xs:boolean"? requires="list of xs:qname"? policysets="list of xs:qname"? constrainingtype="xs:qname"?>* <implementation/>? <service name="xs:ncname" requires="list of xs:qname"? policysets="list of xs:qname"?>* <interface/>? <binding uri="xs:anyuri"? requires="list of xs:qname"? policysets="list of xs:qname"?/>* </service> <reference name="xs:ncname" multiplicity="0..1 or 1..1 or 0..n or 1..n"? autowire="xs:boolean"? target="list of xs:anyuri"? policysets="list of xs:qname"? wiredbyimpl="xs:boolean"? requires="list of xs:qname"?>* <interface/>? <binding uri="xs:anyuri"? requires="list of xs:qname"? policysets="list of xs:qname"?/>* </reference> <property name="xs:ncname" (type="xs:qname" element="xs:qname")? mustsupply="xs:boolean"? many="xs:boolean"? source="xs:string"? file="xs:anyuri"?>* property-value? </property> </component>... </composite> 11 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

12 Component 元 素 有 如 下 属 性 : name( 必 须 ) 构 件 的 名 字 在 同 一 组 合 构 件 里 的 所 有 构 件 中 名 字 必 须 唯 一 autowire( 可 选 ) 指 示 包 含 的 构 件 引 用 是 否 自 动 连 线, 默 认 是 false,autowire 在 自 动 连 线 节 介 绍 requires( 可 选 ) 策 略 意 图 的 列 表 查 看 策 略 框 架 规 范 对 该 属 性 的 描 述 policyset( 可 选 ) 策 略 集 列 表 查 看 策 略 框 架 规 范 对 该 属 性 的 描 述 constrainingtype( 可 选 ) 强 制 类 型 的 名 字 当 指 定 时, 构 件 的 服 务 引 用 和 属 性 的 集 合, 加 之 相 关 的 意 图 将 被 限 定 为 强 制 类 型 定 义 的 集 合 更 多 细 节 请 查 看 强 制 类 型 节 component 元 素 有 零 个 或 一 个 implementation 子 元 素, 该 子 元 素 指 定 构 件 所 使 用 的 实 现 没 有 implementaion 子 元 素 的 component 是 不 能 运 行 的, 但 这 种 构 件 也 许 在 自 顶 向 下 的 开 发 过 程 中, 在 实 现 被 开 发 出 来 之 前 作 为 一 种 定 义 实 现 的 特 定 需 求 的 手 段 还 是 有 用 的 Component 元 素 有 零 个 或 多 个 service 子 元 素, 用 于 配 置 构 件 的 服 务 可 配 置 的 服 务 是 由 实 现 定 义 的 service 元 素 有 如 下 属 性 : name( 必 须 ) 服 务 名 字 必 须 匹 配 由 实 现 定 义 的 服 务 名 requires( 可 选 ) -- 策 略 意 图 的 列 表 查 看 策 略 框 架 规 范 [11] 对 该 属 性 的 描 述 注 意 : 服 务 的 有 效 的 策 略 意 图 集 包 含 由 该 requires 属 性 中 任 意 显 式 声 明 的 意 图, 和 由 实 现 为 服 务 所 指 定 的 任 意 意 图 policysets ( 可 选 ) -- 策 略 集 列 表 查 看 策 略 框 架 规 范 [11] 对 该 属 性 的 描 述 service 有 零 个 或 一 个 接 口 该 接 口 描 述 了 服 务 提 供 的 操 作 接 口 是 由 作 为 service 元 素 的 子 元 素 interface 元 素 来 描 述 的 如 果 没 有 指 定 接 口, 那 么 实 现 为 服 务 指 定 的 接 口 有 效 如 果 指 定 了 接 口, 就 必 须 提 供 一 个 与 实 现 提 供 的 接 口 相 兼 容 的 子 集 比 如, 为 服 务 提 供 一 个 由 实 现 定 义 的 操 作 的 子 集 Interface 元 素 的 细 节 信 息, 请 看 接 口 节 service 元 素 有 零 个 或 多 个 binding 子 元 素 如 没 有 指 定 binding, 那 么 实 现 为 服 务 指 定 的 binding 有 效 如 果 指 定 了, 那 些 绑 定 会 覆 盖 实 现 所 指 定 的 绑 定 binding 元 素 的 细 节 信 息, 请 查 看 绑 定 节 Binding 与 任 意 有 效 的 PolicySet 结 合, 必 须 满 足 服 务 上 的 策 略 意 图 集 如 Policy Framework specification [10] 中 所 述 component 元 素 有 一 个 或 多 个 reference 子 元 素, 用 于 配 置 构 件 的 引 用 可 以 配 置 的 引 用 是 由 实 现 定 义 的 reference 元 素 有 如 下 属 性 : name ( 必 须 ) 引 用 名 必 须 匹 配 实 现 中 定 义 的 引 用 名 称 autowire( 可 选 ) 指 示 引 用 是 否 自 动 连 线, 默 认 是 false,autowire 在 自 动 连 线 节 会 讲 到 requires ( 可 选 ) 策 略 意 图 的 列 表 查 看 策 略 框 架 规 范 [10] 对 该 属 性 的 描 述 注 意 : 引 用 的 有 效 的 策 略 意 图 集 由 该 requires 属 性 中 任 意 显 式 定 义 的 意 图, 与 任 何 由 实 现 为 引 用 所 指 定 的 意 图 组 合 而 成 policyset( 可 选 ) 策 略 集 列 表 查 看 策 略 框 架 规 范 [10] 对 该 属 性 的 描 述 12 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

13 multiplicity( 可 选 ) 定 义 了 能 连 接 到 目 标 服 务 的 引 用 的 连 线 数 目 覆 盖 实 现 上 的 引 用 指 定 的 多 重 性 其 值 只 能 遵 循 或 更 进 一 步 的 限 制 : 比 如 0..n 则 0..1 或 1..n 则 1..1 multiplicity 可 以 是 如 下 取 值 : o 1..1 作 为 源, 只 能 有 一 个 引 用 的 连 线 o 0..1 作 为 源, 能 有 0 个 或 1 个 引 用 的 连 线 o 1..n 作 为 源, 能 有 1 个 或 多 个 引 用 的 连 线 o 0..n - 作 为 源, 能 有 0 个 或 多 个 引 用 的 连 线 target ( 可 选 ) 一 个 或 多 个 目 标 服 务 URI 的 列 表, 依 赖 于 multiplicty 的 设 置 每 个 值 都 将 引 用 连 线 到 解 析 该 引 用 的 构 件 服 务 具 体 细 节 查 看 连 线 节 覆 盖 实 现 中 为 引 用 所 指 定 的 任 意 目 标 wiredbyimpl( 可 选 ) 一 个 boolean 值 默 认 false, 指 示 实 现 动 态 地 连 线 该 引 用 如 果 设 置 为 true, 表 示 这 个 引 用 的 目 标 由 实 现 代 码 在 运 行 时 设 置 ( 比 如, 由 代 码 用 某 种 方 式 来 得 到 端 点 引 用, 并 通 过 使 用 相 关 的 客 户 程 序 和 实 现 规 范 中 定 义 的 编 程 接 口 作 为 引 用 的 目 标 来 设 置 ) 如 果 设 置 为 true, 那 么 组 合 构 件 中 引 用 不 应 该 被 静 态 地 连 线, 而 是 不 要 连 线 引 用 有 零 个 或 一 个 接 口, 描 述 引 用 必 须 的 操 作 接 口 用 作 为 reference 元 素 的 子 元 素 interface 元 素 来 描 述 如 果 没 有 指 定 接 口, 那 么 实 现 为 引 用 指 定 的 接 口 有 效 如 果 指 定 了 接 口, 实 现 就 必 须 提 供 一 个 兼 容 接 口 的 超 集 比 如, 提 供 一 个 实 现 为 引 用 定 义 的 操 作 超 集 Interface 元 素 的 细 节 信 息, 请 看 接 口 节 reference 有 0 个 或 多 个 binding 子 元 素 如 没 有 指 定 binding, 那 么 实 现 为 引 用 指 定 的 binding 有 效 如 果 指 定 了, 那 些 绑 定 会 覆 盖 所 有 由 实 现 指 定 的 绑 定 binding 元 素 的 细 节 信 息, 请 查 看 绑 定 节 binding 与 对 于 binding 来 说 有 效 的 任 意 PolicySet 结 合, 必 须 满 足 引 用 的 策 略 意 图 集, 如 Policy Framework specification [10] 所 述 注 意 :binding 元 素 可 以 指 定 端 点, 该 端 点 是 绑 定 的 目 标 引 用 必 须 不 能 混 用 通 过 binding 元 素 指 定 的 端 点 和 通 过 target 属 性 指 定 的 目 标 端 点 如 果 设 置 了 target 属 性, 那 么 binding 元 素 只 能 列 出 一 个 或 多 个 绑 定 类 型, 该 绑 定 类 型 用 于 由 target 属 性 所 标 识 的 连 线 这 种 情 况 下, 所 有 被 标 识 的 绑 定 类 型 可 用 于 每 条 连 线 上 如 果 在 binding 元 素 中 指 定 了 端 点, 那 么 每 个 端 点 必 须 使 用 binding 元 素 中 定 义 的 绑 定 类 型 除 此 之 外, 这 种 情 况 下, 每 个 binding 元 素 必 须 指 定 端 点 component 元 素 有 零 个 或 多 个 property 子 元 素 该 子 元 素 用 于 配 置 实 现 的 属 性 数 据 值 每 个 property 元 素 都 为 命 名 的 属 性 提 供 了 一 个 传 递 给 实 现 的 值 可 配 置 的 属 性 及 其 类 型 在 实 现 中 定 义 实 现 可 以 声 明 某 个 属 性 为 multi-valued( 多 值 ), 在 这 种 情 况 下, 给 定 的 属 性 会 存 在 多 个 属 性 值 属 性 值 可 以 按 以 下 三 种 方 式 之 一 来 指 定 : 其 值 由 属 性 元 素 的 内 容 通 过 引 用 包 含 构 件 的 组 合 构 件 的 属 性 值 该 引 用 通 过 property 元 素 的 source 属 性 指 定 Source 属 性 值 可 以 是 某 个 XPath 表 达 式 的 形 式 该 形 式 允 许 组 合 构 件 特 定 的 属 性 可 以 通 过 name 来 定 位 在 属 性 复 杂 的 地 方, 能 扩 展 XPath 表 达 式 来 指 定 复 杂 值 的 子 部 分 13 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

14 所 以, 比 如,source= $currency 用 于 引 用 称 为 currency 的 组 合 构 件 属 性, 而 source= $currency/a 用 于 引 用 称 为 currency 的 复 杂 组 合 构 件 属 性 的 a 子 部 分 通 过 使 用 file 属 性 指 定 一 个 指 向 含 有 属 性 值 的 文 件 的 浏 览 器 可 打 开 的 URI 引 用 文 件 的 内 容 作 为 属 性 值 使 用 ( 译 者 注 : 原 文 为 :By specifying a dereferencable URI to a file containing the property value through the file attribute. The contents of the referenced file are used as the value of the property.) 如 果 存 在 多 于 一 个 的 属 性 值,source 属 性 优 先, 然 后 是 file 属 性 可 选 地, 属 性 的 类 型 可 以 按 以 下 两 种 方 式 之 一 来 指 定 : 通 过 在 XML schema 中 定 义 的 类 型 qualified name, 使 用 type 属 性 通 过 在 XML schema 中 的 全 局 元 素 的 qualified name, 使 用 element 属 性 指 定 的 属 性 类 型 必 须 兼 容 实 现 中 声 明 的 属 性 类 型 如 果 没 有 指 定 类 型, 则 使 用 实 现 中 声 明 的 属 性 类 型 property 元 素 有 以 下 属 性 : ƒ name( 必 须 ) property 的 名 字, 必 须 匹 配 实 现 中 定 义 的 属 性 名 ƒ type( 可 选 ) 属 性 的 类 型 定 义 为 XML Schema 类 型 的 qualified name ƒ element( 可 选 ) 属 性 的 类 型 定 义 为 XML Schema 全 局 元 素 的 qualified name,type 即 是 全 局 元 素 的 类 型 ( 译 者 注 : 原 文 为 :element (optional) the type of the property defined as the qualified name of an XML schema global element the type is the type of the global element ) ƒ source( 可 选 ) 一 个 XPath 表 达 式, 指 向 组 合 构 件 所 包 含 的 属 性 该 构 件 的 属 性 值 源 自 包 含 该 构 件 的 组 合 构 件 的 属 性 值 ƒ file ( 可 选 ) 一 个 指 向 包 含 了 属 性 值 的 文 件 的 浏 览 器 可 打 开 的 URI ƒ many (optional) false 指 定 属 性 为 单 值,true 为 多 值 可 以 覆 盖 实 现 中 为 属 性 所 指 定 的 many 其 值 只 能 是 等 效 于 或 更 进 一 步 的 限 定 比 如, 如 果 实 现 指 定 many 为 true, 那 么 构 件 可 以 配 置 为 false 在 多 值 属 性 的 情 况 下, 则 在 实 现 中 以 属 性 值 的 集 合 形 式 存 在 ( 译 者 注 : 原 文 为 :many (optional) (optional) whether the property is single-valued (false) or multi-valued (true). Overrides the many specified for this property on the implementation. The value can only be equal or further restrict, i.e. if the implementation specifies many true,then the component can say false. In the case of a multi-valued property, it is presented to the implementation as a Collection of property values.) 例 子 构 件 下 图 展 示 了 在 装 配 图 中 用 于 描 述 构 件 的 component 符 号 14 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

15 Figure 4: Component symbol 下 图 展 示 包 含 MyValueServiceComponent 构 件 的 MyValueComposite 组 合 构 件 的 装 配 图 Figure 5: Assembly diagram for MyValueComposite 如 下 片 段 为 包 含 MyValueServiceComponent 的 component 元 素 的 MyValueComposite 展 示 了 MyValueComposite.composite 文 件 内 容 为 名 为 currency 的 属 性 设 置 一 个 值, 并 提 升 (promote) 15 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

16 customerservice 和 stockquoteservice 引 用 <?xml version="1.0" encoding="ascii"?> <!-- MyValueComposite_1 example --> <composite xmlns=" targetnamespace=" name="myvaluecomposite" > <service name="myvalueservice" promote="myvalueservicecomponent"/> <component name="myvalueservicecomponent"> <implementation.java class="services.myvalue.myvalueserviceimpl"/> <property name="currency">euro</property> <reference name="customerservice"/> <reference name="stockquoteservice"/> </component> <reference name="customerservice" promote="myvalueservicecomponent/customerservice"/> <reference name="stockquoteservice" promote="myvalueservicecomponent/stockquoteservice"/> </composite> 注 意, 显 式 地 声 明 MyValueServiceComponent 引 用 只 是 为 了 清 晰 的 目 的 引 用 由 MyValueServiceImpl 实 现 定 义, 没 有 必 要 在 component 上 重 新 声 明, 除 非 想 连 线 它 们 或 覆 盖 它 们 的 某 些 方 面 如 果 既 要 currency 属 性 为 多 值 又 要 MyValueServiceComponent 的 customerservice 引 用 声 明 为 多 值 ( 即 : 该 属 性 的 many=true 并 且 引 用 的 multiplicity=0..n 或 1..n), 如 下 片 段 给 出 了 一 个 composite 文 件 样 式 的 例 子 <?xml version="1.0" encoding="ascii"?> <!-- MyValueComposite_2 example --> <composite xmlns=" targetnamespace=" name="myvaluecomposite" > <service name="myvalueservice" promote="myvalueservicecomponent"/> <component name="myvalueservicecomponent"> <implementation.java class="services.myvalue.myvalueserviceimpl"/> <property name="currency">euro</property> <property name="currency">yen</property> <property name="currency">usdollar</property> <reference name="customerservice" target="internalcustomer/customerservice"/> <reference name="stockquoteservice"/> </component>... <reference name="customerservice" promote="myvalueservicecomponent/customerservice"/> <reference name="stockquoteservice" 16 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

17 promote="myvalueservicecomponent/stockquoteservice"/> </composite> 这 里 假 设 组 合 构 件 有 另 一 个 称 为 InternalCustomer ( 这 里 没 有 展 示 ) 的 构 件 该 构 件 有 一 个 服 务 MyValueSerivceComponent 的 customerservice 引 用 连 线 到 该 服 务, 同 时 在 外 部, 该 customerservice 引 用 通 过 组 合 构 件 的 CustomerService 引 用 被 提 升 1.4 实 现 构 件 实 现 是 提 供 服 务 或 引 用 其 他 地 方 所 提 供 的 服 务 的 业 务 功 能 的 具 体 实 现 另 外, 某 个 实 现 可 以 有 一 些 可 设 置 的 属 性 值 SCA 允 许 你 从 广 泛 的 实 现 类 型 中 选 择 任 何 一 种 技 术, 比 如 Java BPEL 或 C++ 这 每 种 类 型 都 代 表 了 特 定 的 实 现 技 术 该 技 术 不 仅 仅 简 单 定 义 实 现 语 言, 如 Java, 而 且 也 可 以 定 义 使 用 某 个 特 定 的 框 架 或 运 行 时 环 境 例 如 包 括 使 用 Spring framework 或 Java EE EJB 技 术 的 Java 实 现 例 如, 在 一 个 composite 文 件 中 的 component 的 声 明 中, 元 素 implementation.java 和 implementation.bpel 分 别 指 定 Java 和 BPEL 实 现 类 型 Implementation.composite 指 定 将 SCA composite 作 为 实 现 来 使 用 Implementation.spring 和 implementation.ejb 分 别 用 于 指 定 使 用 Spring framework 和 Java EE EJB 技 术 编 写 的 Java 构 件 如 下 片 段 为 Java 和 BPEL 实 现 类 型 以 及 将 composite 作 为 实 现 的 方 式 时 的 implementation 元 素 <implementation.java class="services.myvalue.myvalueserviceimpl"/> <implementation.bpel process="moneytransferprocess"/> <implementation.composite name="foo:myvaluecomposite"/> service,reference 和 property 是 实 现 的 可 配 置 的 部 分 SCA 将 它 们 一 起 作 为 component type Service,reference 和 property 的 特 性 在 构 件 节 描 述 依 赖 于 实 现 类 型, 实 现 可 以 声 明 其 服 务, 引 用 和 属 性, 并 能 为 所 有 的 那 些 服 务, 引 用 以 及 属 性 特 性 设 置 值 举 例 : 对 于 服 务, 实 现 可 以 定 义 接 口, 绑 定,URI 地 址, 意 图 和 策 略 集, 包 括 绑 定 的 细 节 信 息 对 于 引 用, 实 现 可 以 定 义 接 口, 绑 定, 目 标 URI 地 址, 意 图 和 策 略 集, 包 括 绑 定 的 细 节 信 息 对 于 属 性, 实 现 可 以 定 义 它 的 类 型 以 及 默 认 值 实 现 自 身 可 以 定 义 意 图 和 策 略 集 服 务, 引 用 和 属 性 的 大 多 数 特 征 都 可 以 通 过 使 用 和 配 置 实 现 的 component 来 覆 盖, 或 者 component 决 定 并 不 覆 17 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

18 盖 那 些 特 征 某 些 特 征 不 能 覆 盖, 比 如 意 图 而 其 他 的 特 征, 如 接 口, 只 能 以 特 定 可 控 的 方 式 来 覆 盖 ( 细 节 信 息, 查 看 component 节 ) 一 个 实 现 声 明 服 务, 引 用 和 属 性 的 方 式 依 赖 于 实 现 的 类 型 比 如, 某 些 语 言, 如 Java, 提 供 了 注 解 用 于 在 代 码 中 嵌 入 声 明 信 息 在 运 行 时 期, 实 现 的 实 例 是 实 现 的 特 定 运 行 时 的 实 例 - 其 运 行 时 的 形 式 依 赖 于 所 用 的 实 现 技 术 实 现 的 实 例 从 其 基 于 的 实 现 派 生 出 业 务 逻 辑, 但 其 属 性 值 和 引 用 则 来 源 于 配 置 该 实 现 的 构 件 Figure 6: Relationship of Component and Implementation 构 件 类 型 Component Type 表 示 实 现 的 可 配 置 的 方 面 一 个 component type 由 提 供 的 服 务 被 连 线 的 对 其 他 服 务 的 引 用 以 及 可 设 置 的 属 性 组 成 使 用 了 该 实 现 的 构 件 来 配 置 可 设 置 的 属 性 以 及 可 设 置 的 对 服 务 的 引 用 Component type 通 过 两 步 来 确 定 第 二 步 补 充 在 第 一 步 中 发 现 的 信 息 第 一 步 是 内 省 实 现 ( 如 果 可 能 的 话 ), 包 括 实 现 的 注 解 的 内 省 ( 如 果 可 用 的 话 ) 第 二 步 解 决 那 些 通 过 实 现 的 内 省 不 可 能 的 情 况, 或 者 无 法 提 供 完 整 信 息, 需 要 查 找 一 个 SCA component type 文 件 的 情 况 在 component type 文 件 中 找 到 的 Component type 信 息 必 须 与 从 实 现 内 省 来 的 等 效 信 息 兼 容 component type 文 件 可 以 列 出 部 分 信 息, 其 他 的 信 息 则 来 源 于 实 现 在 理 想 的 情 况 下,component type 信 息 是 通 过 内 省 实 现 确 定 的, 比 如 代 码 注 解 component type 文 件 提 供 了 通 过 内 省 实 现 而 无 法 得 到 信 息 的 情 况 下 的 后 备 方 式, 即 对 实 现 类 型 提 供 构 件 类 型 信 息 的 机 制 18 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

19 component type 文 件 与 实 现 文 件 有 相 同 的 名 字, 只 是 扩 展 名 不 同, 是.componentType component type 在 文 件 中 是 通 过 componenttype 元 素 来 定 义 的 component type 文 件 的 位 置 依 赖 于 构 件 的 实 现 类 型 : 它 在 各 自 实 现 类 型 客 户 程 序 与 实 现 模 型 规 范 (client and implementation model specification) 中 描 述 componenttype 元 素 能 包 含 Service 元 素,Reference 元 素 和 Property 元 素 以 下 片 段 展 现 了 componenttype schema <?xml version="1.0" encoding="ascii"?> <!-- Component type schema snippet --> <componenttype xmlns=" constrainingtype="qname"? > <service name="xs:ncname" requires="list of xs:qname"? policysets="list of xs:qname"?>* <interface/> <binding uri="xs:anyuri"? requires="list of xs:qname"? policysets="list of xs:qname"?/>* </service> <reference name="xs:ncname" target="list of xs:anyuri"? multiplicity="0..1 or 1..1 or 0..n or 1..n"? wiredbyimpl="xs:boolean"? requires="list of xs:qname"? policysets="list of xs:qname"?>* <interface/>? <binding uri="xs:anyuri"? requires="list of xs:qname"? policysets="list of xs:qname"?/>* </reference> <property name="xs:ncname" (type="xs:qname" element="xs:qname") many="xs:boolean"? mustsupply="xs:boolean"? policysets="list of xs:qname"?>* default-property-value? </property> <implementation requires="list of xs:qname"? policysets="list of xs:qname"?/>? </componenttype> ComponentType 只 有 一 个 属 性 : constrainingtype( 可 选 ) constrainingtype 的 名 字 当 指 定 的 时 候, 实 现 的 服 务, 引 用 和 属 性 的 集 合, 再 加 上 相 关 的 意 图, 都 会 受 限 于 costrainingtype 所 定 义 的 集 合 查 看 ConstrainingType 节 可 以 查 看 更 多 的 细 节 信 息 Service 描 述 了 实 现 的 可 寻 址 的 接 口 服 务 通 过 componenttype 元 素 的 service 子 元 素 来 描 述 在 componenttype 中 可 以 有 0 个 或 多 个 service 元 素 具 体 细 节, 请 查 看 服 务 节 Reference 描 述 了 实 现 需 要 其 他 组 件 所 提 供 的 服 务 reference 通 过 componenttype 元 素 的 reference 子 元 素 来 描 述 component type 定 义 中 可 以 有 0 个 或 多 个 reference 元 素 具 体 细 节, 请 查 看 reference 节 19 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

20 Property 允 许 通 过 外 部 设 置 值 来 配 置 实 现 每 个 属 性 都 作 为 property 元 素 定 义 componenttype 元 素 可 以 有 0 个 或 多 个 property 子 元 素 具 体 细 节, 请 查 看 property 节 Implementation 描 述 了 实 现 自 身 固 有 的 特 性, 特 别 是 意 图 和 策 略 意 图 和 策 略 的 描 述 信 息, 请 查 看 策 略 框 架 规 范 Policy Framework specification[10] componenttype 案 例 如 下 片 段 为 MyValueServiceImpl 实 现 展 示 了 componenttype 文 件 的 内 容 componenttype 文 件 展 示 了 MyValueServiceImpl 实 现 的 服 务, 引 用 和 属 性 在 这 个 案 例 中, 使 用 Java 来 定 义 接 口 : <?xml version="1.0" encoding="ascii"?> <componenttype xmlns=" <service name="myvalueservice"> <interface.java interface="services.myvalue.myvalueservice"/> </service> <reference name="customerservice"> <interface.java interface="services.customer.customerservice"/> </reference> <reference name="stockquoteservice"> <interface.java interface="services.stockquote.stockquoteservice"/> </reference> <property name="currency" type="xsd:string">usd</property> </componenttype> 实 现 案 例 以 下 是 一 个 用 java 编 码 的 案 例 实 现 具 体 细 节 查 看 SCA 案 例 代 码 文 档 SCA Example Code document [3] AccoutServiceImpl 实 现 了 AccountService 接 口, 该 接 口 是 通 过 Java 接 口 定 义 的 : package public interface AccountService{ } public AccountReport getaccountreport(string customerid); 20 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

21 以 下 是 AccountServiceImpl 类 的 完 整 列 表, 展 现 了 其 实 现 的 服 务, 加 上 其 服 务 引 用 和 可 设 置 的 属 性 注 意 标 注 代 码 SCA 方 面 的 Java 注 解 的 使 用, 包 标 记 : package services.account; import java.util.list; import commonj.sdo.datafactory; import org.osoa.sca.annotations.property; import org.osoa.sca.annotations.reference; import services.accountdata.accountdataservice; import services.accountdata.checkingaccount; import services.accountdata.savingsaccount; import services.accountdata.stockaccount; import services.stockquote.stockquoteservice; public class AccountServiceImpl implements AccountService 译 者 注 : 此 annotation 不 能 应 用 于 private 的 属 性 上 ) private String currency = 译 者 注 : 此 annotation 不 能 应 用 于 private 的 属 性 上 ) private AccountDataService 译 者 注 : 此 annotation 不 能 应 用 于 private 的 属 性 上 ) private StockQuoteService stockquoteservice; public AccountReport getaccountreport(string customerid) { DataFactory datafactory = DataFactory.INSTANCE; AccountReport accountreport = (AccountReport)dataFactory.create(AccountReport.class); List accountsummaries = accountreport.getaccountsummaries(); CheckingAccount checkingaccount = accountdataservice.getcheckingaccount(customerid); AccountSummary checkingaccountsummary = (AccountSummary)dataFactory.create(AccountSummary.class); checkingaccountsummary.setaccountnumber(checkingaccount.getaccountnumber()); checkingaccountsummary.setaccounttype("checking"); checkingaccountsummary.setbalance(fromusdollartocurrency(checkingaccount.getbalance ())); accountsummaries.add(checkingaccountsummary); 21 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

22 SavingsAccount savingsaccount = accountdataservice.getsavingsaccount(customerid); AccountSummary savingsaccountsummary = (AccountSummary)dataFactory.create(AccountSummary.class); savingsaccountsummary.setaccountnumber(savingsaccount.getaccountnumber()); savingsaccountsummary.setaccounttype("savings"); savingsaccountsummary.setbalance(fromusdollartocurrency(savingsaccount.getbalance() )); accountsummaries.add(savingsaccountsummary); StockAccount stockaccount = accountdataservice.getstockaccount(customerid); AccountSummary stockaccountsummary = (AccountSummary)dataFactory.create(AccountSummary.class); stockaccountsummary.setaccountnumber(stockaccount.getaccountnumber()); stockaccountsummary.setaccounttype("stock"); float balance= (stockquoteservice.getquote(stockaccount.getsymbol()))*stockaccount.getquantity(); stockaccountsummary.setbalance(fromusdollartocurrency(balance)); accountsummaries.add(stockaccountsummary); return accountreport; } private float fromusdollartocurrency(float value){ } if (currency.equals("usd")) return value; else if (currency.equals("euro")) return value * 0.8f; else return 0.0f; } 对 于 AccountServiceImpl, 以 下 是 等 效 的 SCA componenttype 定 义, 通 过 对 以 上 代 码 反 射 出 来 的 : <?xml version="1.0" encoding="ascii"?> <componenttype xmlns=" xmlns:xsd=" <service name="accountservice"> <interface.java interface="services.account.accountservice"/> </service> <reference name="accountdataservice"> <interface.java interface="services.accountdata.accountdataservice"/> </reference> <reference name="stockquoteservice"> <interface.java interface="services.stockquote.stockquoteservice"/> </reference> 22 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

23 <property name="currency" type="xsd:string">usd</property> </componenttype> 对 于 关 于 Java 实 现 的 完 整 细 节, 请 查 看 Java 客 户 程 序 与 实 现 规 范 Java Client and Implementation Specification 和 SCA 例 子 代 码 文 档 其 他 的 实 现 类 型 有 各 自 的 规 范 文 档 1.5 接 口 Interface 定 义 了 一 个 或 多 个 业 务 功 能 这 些 业 务 功 能 是 通 过 服 务 提 供 或 通 过 引 用 来 使 用 的 为 了 其 他 组 件 的 使 用, 一 个 服 务 提 供 了 严 格 的 单 一 接 口 的 业 务 功 能 每 个 接 口 都 定 义 了 一 个 或 多 个 服 务 操 作, 每 个 operation 都 有 0 个 或 1 个 请 求 ( 输 入 ) 消 息 和 0 个 或 1 个 响 应 ( 输 出 ) 消 息 请 求 和 响 应 消 息 可 以 是 简 单 类 型, 如 string 值, 也 可 以 是 复 杂 类 型 SCA 当 前 支 持 如 下 的 接 口 类 型 系 统 : Java interfaces WSDL 1.1 porttypes WSDL 2.0 interfaces (WSDL: Web Services Definition Language [8]) SCA 在 接 口 类 型 (interface type) 方 面 也 是 可 以 扩 展 的 可 以 通 过 SCA 的 扩 展 机 制 支 持 其 它 的 接 口 类 型 系 统, 这 些 在 扩 展 模 型 节 会 讲 到 以 下 片 段 展 示 了 Java interface 元 素 的 schema <interface.java interface="ncname" /> Interface.java 元 素 有 如 下 属 性 : interface Java interface 的 全 限 定 名 (qualified name) 以 下 样 例 为 Java interface 元 素 展 示 了 使 用 例 子 <interface.java interface="services.stockquote.stockquoteservice"/> 这 里,java interface 定 义 在./services/stockquote/StockQuoteService.class 的 java 类 文 件 中 该 文 件 的 根 目 录 是 由 Interface 所 在 的 contribution 定 义 的 23 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

24 对 于 Java 接 口 类 型 系 统,service 方 法 的 参 数 和 返 回 值 都 使 用 Java 类 或 简 单 Java 类 型 来 描 述 SDO(Service Data Objects [2]) 是 Java 类 的 首 选 形 式, 因 为 它 们 与 XML 技 术 的 集 成 需 要 更 多 的 关 于 Java 接 口 的 信 息, 包 括 SCA 规 范 的 注 解 细 节, 请 查 看 Java 客 户 程 序 与 实 现 规 范 the Java Client and Implementation specification [1] 以 下 片 段 给 出 了 WSDL porttype(wsdl 1.1) 或 WSDL interface(wsdl2.0) 元 素 <interface.wsdl interface="xs:anyuri" /> interface.wsdl 元 素 有 如 下 属 性 : interface porttype/interface 如 下 格 式 的 URI 地 址 o <WSDL-namespace-URI>#wsdl.interface(<portTypeOrInterface-name>) 如 下 片 段 为 WSDL porttype/interface 元 素 给 出 了 一 个 使 用 样 例 : <interface.wsdl interface= wsdl.interface(stockquote) /> 对 于 WSDL 1.1,interface 属 性 指 向 WSDL 中 的 某 个 porttype 对 于 WSDL 2.0,interface 属 性 指 向 WSDL 里 的 某 个 interface 对 于 WSDL1.1 porttype 和 WSDL2.0 接 口 类 型 系 统, 服 务 操 作 的 参 数 和 返 回 值 都 是 使 用 XML schema 描 述 的 本 地 和 远 程 接 口 一 个 远 程 服 务 是 被 运 行 于 不 同 于 服 务 本 身 的 某 个 操 作 系 统 进 程 的 客 户 程 序 所 调 用 的 ( 这 也 可 以 是 运 行 于 与 服 务 不 同 的 机 器 的 客 户 程 序 ) 构 件 实 现 的 服 务 是 否 是 远 程 的 是 由 服 务 的 接 口 定 义 的 如 果 使 用 java, 则 通 过 在 java 接 口 上 添 注 解 来 定 义 远 程 接 口 ( 查 看 Java 客 户 程 序 与 实 现 模 型 规 范 ) WSDL 定 义 的 接 口 总 是 远 程 的 远 程 接 口 的 风 格 是 典 型 的 粗 粒 度 的, 松 耦 合 的 交 互 模 式 远 程 服 务 接 口 禁 止 使 用 方 法 或 操 作 的 重 载 不 管 远 程 服 务 是 从 进 程 外 被 远 程 调 用 还 是 被 其 他 运 行 于 同 一 个 进 程 的 构 件 所 调 用, 数 据 交 换 语 义 都 是 传 值 的 方 式 远 程 服 务 的 实 现 可 以 在 调 用 期 间 或 之 后 修 改 输 入 消 息 ( 参 数 ), 在 调 用 之 后 修 改 返 回 的 消 息 ( 结 果 ) 如 果 远 程 服 务 被 本 地 或 远 程 地 调 用,SCA 容 器 负 责 确 保 对 输 入 消 息 的 修 改 和 返 回 消 息 的 调 用 后 修 改, 对 调 用 者 来 说, 是 透 明 的 ( 译 者 注 : 即 调 用 者 看 到 的 就 象 不 存 在 对 输 入 消 息 的 修 改 和 返 回 消 息 的 调 用 后 修 改 这 回 事 ) 24 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

25 这 里 是 一 个 片 段, 展 现 了 远 程 java 接 口 的 例 子 : package public interface HelloService { } String hello(string message); 当 被 同 一 个 进 程 中 的 构 件 调 用 时, 远 程 服 务 的 实 现 可 能 使 用 传 引 用 的 数 据 交 换 语 义 这 可 以 改 善 运 行 于 同 一 进 程 的 构 件 间 服 务 调 用 的 性 能 使 注 解 ( 查 看 Java 客 户 程 序 与 实 现 规 范 ) 来 完 成 此 功 能 本 地 接 口 类 型 的 服 务 只 能 被 运 行 于 与 实 现 本 地 服 务 的 构 件 处 于 同 一 个 进 程 的 客 户 程 序 调 用 本 地 服 务 不 能 通 过 所 在 composite 的 远 程 服 务 来 发 布 在 Java 接 口 时, 本 地 服 务 是 通 过 Java interface definition 来 定 义, 不 需 注 解 本 地 接 口 的 风 格 是 典 型 的 细 粒 度 用 于 紧 耦 合 的 交 互 本 地 服 务 接 口 可 以 使 用 方 法 或 操 作 的 重 载 对 于 本 地 接 口 类 型 服 务 的 调 用, 其 数 据 交 换 语 义 是 传 引 用 双 向 接 口 一 个 业 务 服 务 与 另 一 个 业 务 服 务 的 关 系 总 是 点 对 点 的, 在 服 务 级 要 求 双 路 依 赖 换 句 话 说, 一 个 业 务 服 务 既 是 某 个 业 务 服 务 合 作 者 所 提 供 服 务 的 消 费 者, 同 时 又 为 服 务 合 作 者 提 供 服 务 特 别 是 在 基 于 异 步 消 息 而 非 远 程 过 程 调 用 (RPC) 的 交 互 情 形 下 双 向 接 口 的 理 念 在 SCA 中 用 于 直 接 地 建 模 点 对 点 双 向 业 务 服 务 关 系 对 于 特 定 的 接 口 类 型 系 统 的 interface 元 素 必 须 要 求 一 个 可 选 的 回 调 接 口 规 范 如 果 指 定 了 一 个 回 调 接 口, 那 么 SCA 将 该 接 口 整 体 作 为 一 个 双 向 接 口 如 下 片 段 展 示 了 使 用 带 有 一 个 可 选 的 callbackinterface 属 性 Java 接 口 定 义 的 interface 元 素 <interface.java interface="services.invoicing.computeprice" callbackinterface="services.invoicing.invoicecallback"/> 如 果 一 个 服 务 是 使 用 一 个 双 向 接 口 元 素 定 义 的, 那 么 其 实 现 实 现 该 接 口, 并 且 通 过 回 调 接 口 来 与 调 用 服 务 接 口 的 客 户 程 序 进 行 交 互 25 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

26 如 果 使 用 双 向 接 口 元 素 定 义 一 个 引 用, 那 么 使 用 该 引 用 的 客 户 构 件 实 现 会 通 过 该 接 口 来 调 用 被 引 用 的 服 务 客 户 构 件 实 现 必 须 实 现 该 回 调 接 口 回 调 既 能 用 于 远 程 也 能 用 于 本 地 服 务 一 个 双 向 服 务 接 口 必 须 要 么 都 为 远 程 的, 要 么 都 为 本 地 的 一 个 双 向 服 务 不 能 同 时 混 用 本 地 服 务 和 远 程 服 务 SCA 中 提 供 这 样 的 方 式, 允 许 与 源 服 务 调 用 的 客 户 构 件 不 同 的 构 件 提 供 一 个 回 调 接 口 这 些 是 如 何 做 到 的 请 查 看 SCA java 客 户 程 序 与 实 现 规 范 ( 将 会 话 服 务 作 为 参 数 传 递 章 节 ) 会 话 接 口 服 务 有 时 并 不 能 简 单 地 定 义, 以 便 每 个 操 作 都 自 治 而 完 全 不 依 赖 于 同 一 服 务 的 其 他 操 作 相 反 地, 为 达 到 更 高 级 别 的 目 标, 得 有 一 个 操 作 调 用 的 序 列 SCA 称 此 操 作 序 列 为 会 话 conversation 如 果 服 务 使 用 了 双 向 接 口, 那 么 会 话 同 时 包 含 操 作 和 回 调 这 些 会 话 服 务 一 般 是 通 过 使 用 会 话 标 识 来 管 理 的 这 些 会 话 标 识 既 可 以 是 1) 应 用 数 据 ( 消 息 部 分 或 操 作 的 参 数 ) 的 一 部 分, 也 可 以 是 2) 与 应 用 数 据 隔 离 的 通 讯 部 分 ( 可 能 在 头 部 信 息 中 ) SCA 为 了 描 述 上 述 第 二 种 形 式 的 会 话 服 务 接 口 合 约, 引 入 了 会 话 接 口 conversational interface 这 个 概 念 以 这 种 形 式, 运 行 时 环 境 可 以 在 部 署 时 所 指 定 的 相 应 绑 定 机 制 的 帮 助 下 自 动 管 理 会 话 SCA 并 不 强 制 通 过 应 用 数 据 来 维 护 会 话 服 务 的 任 何 方 面 的 标 准 SCA 会 话 服 务 的 支 持 对 通 过 应 用 数 据 维 护 会 话 的 会 话 服 务 不 起 任 何 作 用 ( 译 者 注 : 因 为 SCA 是 使 用 上 述 第 2 种 方 式 管 理 会 话 的 ) 典 型 地, 会 话 服 务 关 心 与 正 在 进 行 的 会 话 相 关 的 状 态 数 据 会 话 状 态 数 据 的 创 建 和 管 理 对 客 户 程 序 以 及 会 话 服 务 的 实 现 都 有 重 大 的 影 响 一 般 来 说, 有 开 发 会 话 服 务 需 求 的 应 用 开 发 者 要 求 书 写 许 多 基 础 代 码 他 们 需 要 : - 选 择 或 定 义 客 户 与 提 供 者 间 通 讯 会 话 信 息 的 协 议 - 在 提 供 者 端, 将 会 话 消 息 路 由 到 可 以 处 理 会 话 的 机 器 上, 同 时 处 理 并 发 数 据 访 问 问 题 - 在 客 户 程 序 中 编 写 代 码 来 使 用 和 编 码 会 话 信 息 - 在 实 现 以 及 客 户 程 序 中, 维 护 与 会 话 相 关 的 状 态, 有 时 是 持 久 化 和 事 务 性 SCA 为 许 多 角 色 之 间 划 分 与 会 话 服 务 相 关 的 职 责 提 供 了 可 能 : - 应 用 开 发 者 : 声 明 服 务 接 口 是 会 话 的 ( 具 体 协 议 的 细 节 信 息 留 给 绑 定 ) 使 用 生 命 周 期 语 义,API 或 其 他 的 编 码 机 制 ( 由 所 使 用 的 实 现 类 型 来 定 义 ) 来 管 理 会 话 的 状 态 - 应 用 装 配 者 : 选 择 支 持 会 话 的 绑 定 - 绑 定 提 供 者 : 实 现 一 个 协 议, 该 协 议 可 以 传 递 与 每 个 操 作 请 求 / 响 应 相 关 的 会 话 信 息 - 实 现 类 型 提 供 者 : 为 应 用 开 发 者 定 义 API 以 及 其 他 的 编 程 机 制, 以 便 可 以 访 问 会 话 信 息 可 选 地, 实 现 实 例 生 命 26 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

27 周 期 语 义 该 生 命 周 期 语 义 自 动 管 理 基 于 绑 定 的 会 话 信 息 的 实 现 状 态 该 规 范 要 求 以 一 个 名 为 conversational 的 策 略 意 图 的 方 式, 来 标 注 接 口 为 会 话 的 这 种 意 图 标 注 的 形 式 依 赖 与 接 口 类 型 注 意, 当 使 用 并 未 标 注 conversational 意 图 的 接 口 时, 也 可 能 为 服 务 或 引 用 设 置 coversational 意 图 在 复 用 某 个 已 存 在 但 并 不 包 含 SCA 信 息 的 接 口 定 义 时, 这 一 点 很 有 用 conversational 意 图 的 意 思 是 : 无 论 是 接 口 的 客 户 还 是 提 供 者 都 假 定 消 息 ( 在 每 个 方 向 上 ) 都 会 被 作 为 正 在 进 行 的 会 话 的 一 部 分 来 处 理, 而 不 依 赖 于 在 消 息 体 中 的 标 识 信 息 ( 比 如 在 操 作 的 参 数 中 ) 实 际 上, 会 话 接 口 指 定 某 个 高 层 抽 象 协 议 必 须 满 足 服 务 所 用 的 任 意 实 际 上 的 绑 定 / 策 略 组 合 支 持 会 话 接 口 的 绑 定 / 策 略 组 合 例 子 如 下 : - 带 有 WS-RM policy 的 Web service 绑 定 - 带 有 WS-Addressing policy 的 Web service 绑 定 - 带 有 WS-Context policy 的 Web service 绑 定 - 带 有 使 用 了 JMS correlationid 头 部 信 息 的 conversation policy 的 JMS 绑 定 会 话 发 生 于 某 个 客 户 与 某 个 目 标 服 务 之 间 因 此, 来 自 一 个 客 户 的 请 求 到 达 多 个 目 标 会 话 服 务, 将 导 致 多 个 会 话 比 如, 如 果 客 户 A 调 用 了 服 务 B 和 C( 这 两 个 服 务 都 实 现 了 会 话 接 口 ), 两 个 会 话 结 果, 一 个 是 A 与 B 之 间 的, 另 一 个 是 A 与 C 之 间 的 同 样 地, 经 由 多 个 实 现 实 例 的 请 求 会 导 致 多 个 会 话 比 如, 从 A 到 B 的 请 求, 然 后 又 经 由 B 到 C, 会 产 生 两 个 会 话 (A 和 B,B 和 C) 在 前 面 的 例 子 中, 如 果 请 求 再 从 C 到 A 发 起, 那 么 会 产 生 第 三 个 会 话 ( 并 且 A 的 实 现 实 例 不 同 于 发 起 源 请 求 的 那 个 实 例 A) 一 个 会 话 接 口 的 任 意 操 作 调 用 都 可 能 会 启 动 一 个 会 话 一 个 操 作 是 否 会 启 动 一 个 会 话 依 赖 于 构 件 的 实 现 及 其 实 现 类 型 实 现 类 型 可 能 支 持 会 话 性 服 务 构 件 如 果 一 个 实 现 类 型 确 实 提 供 了 该 支 持, 那 么 就 必 须 提 供 一 个 机 制, 确 定 什 么 时 候 一 个 新 会 话 会 用 于 一 个 操 作 ( 比 如, 在 java 中, 在 第 一 次 使 用 某 个 注 入 的 引 用 时, 生 成 一 个 新 的 会 话 ; 在 BPEL 中, 当 客 户 的 partnerlink 进 入 作 用 域 时, 生 成 一 个 新 会 话 ) 会 话 接 口 中 的 一 个 或 多 个 操 作 可 能 会 用 endsconversation 注 解 注 释 ( 注 解 接 口 的 机 制 依 赖 于 接 口 类 型 ) 当 一 个 接 口 是 双 向 的 时 候, 也 可 以 以 这 种 方 式 在 一 个 回 调 接 口 的 操 作 上 进 行 注 解 当 一 个 会 话 结 束 操 作 被 调 用 时, 指 示 客 户 和 服 务 提 供 者 会 话 已 经 完 成 任 意 的 尝 试 调 用 同 一 个 会 话 相 关 的 操 作 或 回 调 的 后 续 行 为 都 会 引 发 一 个 sca:conversationviolation 错 误 sca:conversationviolation 错 误 在 以 下 错 误 之 一 发 生 时 被 抛 出 : - 在 特 定 会 话 结 束 后 接 收 到 一 个 消 息 - 会 话 标 识 无 效 ( 不 唯 一 超 出 范 围 等 等 ) - 在 结 束 会 话 操 作 的 输 入 消 息 中 不 存 在 会 话 标 识 - 客 户 程 序 或 服 务 尝 试 在 会 话 结 束 之 后 发 送 会 话 消 息 该 错 误 使 用 SCA 命 名 空 间 标 准 的 sca 前 缀, 该 前 缀 与 的 URI 相 关 联 27 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

28 资 源 的 生 命 周 期 以 及 唯 一 标 识 符 与 会 话 之 间 的 关 系 都 是 由 服 务 的 实 现 类 型 决 定 的, 并 且 endconversation 注 解 有 可 能 不 直 接 影 响 它 们 比 如, 一 个 WS-BPEL 流 程 可 能 比 大 多 数 的 会 话 生 命 周 期 都 要 长 尽 管 会 话 接 口 并 不 要 求 任 何 标 识 信 息 做 为 消 息 体 部 分 传 递, 但 其 实 概 念 上 是 存 在 一 个 与 会 话 关 联 的 标 识 的 个 别 的 实 现 类 型 可 能 提 供 一 个 API 来 访 问 与 会 话 相 关 的 ID, 尽 管 并 不 假 定 标 识 的 结 构 实 现 类 型 也 可 能 为 客 户 程 序 或 服 务 提 供 者 提 供 一 种 设 置 conversation ID 的 手 段, 尽 管 这 种 操 作 仅 仅 被 某 些 绑 定 / 策 略 组 合 所 支 持 鼓 励 实 现 类 型 规 范 为 实 现 了 会 话 接 口 的 构 件, 定 义 并 提 供 会 话 性 实 例 的 生 命 周 期 管 理 然 而, 实 现 也 可 以 手 工 管 理 会 话 状 态 WSDL 接 口 的 SCA 相 关 方 面 一 般 来 说,SCA 有 许 多 方 面 应 用 到 接 口 上, 比 如 标 注 它 们 为 conversational 这 些 方 面 应 用 于 接 口 本 身, 胜 过 它 们 在 SCA 中 特 定 位 置 的 使 用 提 供 标 注 接 口 定 义 自 身 的 适 当 手 段 是 一 个 附 加 的 需 求, 该 需 求 超 出 了 接 口 定 义 语 言 提 供 的 基 本 功 能 对 于 WSDL 接 口, 存 在 一 个 扩 展 机 制, 允 许 附 加 信 息 被 包 含 于 WSDL 文 档 之 中 SCA 利 用 了 该 扩 展 机 制 为 了 使 用 SCA 扩 展 机 制,SCA 命 名 空 间 必 须 在 WSDL 文 档 中 声 明 首 先,SCA 在 SCA 命 名 空 间 中 声 明 了 一 个 全 局 属 性, 该 全 局 属 性 提 供 了 附 加 策 略 意 图 -@requires 的 机 制 该 属 性 的 定 义 如 下 : <attribute name="requires" type="sca:listofqnames"/> <simpletype name="listofqnames"> <list itemtype="qname"/> 属 性 可 以 应 用 于 WSDL porttype 元 素 (WSDL1.1) 和 WSDL Interface 元 素 (WSDL2.0) 中 该 属 性 包 含 一 个 或 多 个 意 图 名 字, 这 些 意 图 名 字 在 策 略 框 架 规 范 [10] 中 定 义 了 任 何 使 用 了 带 有 required 意 图 接 口 的 服 务 或 引 用, 都 会 隐 式 地 增 加 这 些 意 图 到 其 自 身 列 表 中 为 了 指 定 WSDL 接 口 是 会 话 的, 在 WSDL porttype 或 WSDL Interface 上 使 用 如 下 属 性 设 定 : requires="conversational" SCA 定 义 了 一 个 endsconversation 属 性, 该 属 性 用 于 在 WSDL 接 口 声 明 中 标 记 特 定 的 操 作 会 结 束 会 话 这 仅 仅 对 于 那 些 也 标 注 为 conversational 的 WSDL 接 口 有 意 义 这 个 endsconversataion 属 性 在 SCA 命 名 空 间 中 是 全 局 属 性, 其 定 义 如 下 : <attribute name="endsconversation" type="boolean" default="false"/> 28 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

29 如 下 片 段 是 在 porttype 上 标 注 requires 属 性, 在 一 个 operation 上 标 注 endsconversation 属 性 的 WSDL PortType 的 样 例... <porttype name="loanservice" sca:requires="conversational"> <operation name="apply"> <input message="tns:applicationinput"/> <output message="tns:applicationoutput"/> </operation> <operation name="cancel" sca:endsconversation="true"> </operation>... </porttype> 组 合 构 件 SCA 组 合 构 件 被 用 于 在 逻 辑 分 组 中 装 配 SCA 元 素 其 在 SCA 域 中 是 组 合 的 基 本 单 元 SCA 组 合 构 件 包 含 一 系 列 的 构 件, 服 务, 引 用 以 及 内 连 它 们 的 连 线, 外 加 上 用 于 配 置 构 件 的 一 系 列 属 性 组 合 构 件 可 以 在 更 高 层 的 组 合 构 件 里 作 为 构 件 实 现 的 形 式 换 句 话 说, 高 层 的 组 合 构 件 可 以 包 含 由 组 合 构 件 实 现 的 构 件 关 于 将 组 合 构 件 作 为 构 件 实 现 使 用 的 更 详 细 的 信 息, 请 查 看 将 组 合 构 件 作 为 构 件 实 现 使 用 这 一 节 组 合 构 件 的 内 容 可 以 通 过 inclusion 在 其 他 组 合 构 件 中 使 用 当 一 个 组 合 构 件 被 另 一 个 组 合 构 件 包 含 时, 全 部 内 容 可 以 在 其 上 级 组 合 构 件 中 被 有 效 地 使 用 其 内 容 完 全 可 见, 并 能 被 上 级 组 合 构 件 中 的 其 他 元 素 所 引 用 关 于 将 一 个 组 合 构 件 包 含 进 另 一 个 组 合 构 件 的 更 详 细 的 信 息, 请 查 看 通 过 包 含 使 用 组 合 构 件 节 一 个 组 合 构 件 可 以 作 为 部 署 的 单 元 来 使 用 用 这 种 方 式 使 用 的 时 候, 组 合 构 件 contribute 元 素 到 一 个 SCA 域 中 一 个 组 合 构 件 既 能 通 过 inclusion 的 方 式 部 署 到 SCA 域 中, 也 能 通 过 将 组 合 构 件 作 为 一 个 实 现 部 署 到 域 中 更 多 组 合 构 件 部 署 的 细 节, 请 查 看 处 理 SCA 域 节 ( 译 者 注 : 原 文 为 :A composite can be used as a unit of deployment. When used in this way, composites contribute elements to an SCA domain. A composite can be deployed to the SCA domain either by inclusion, or a composite can be deployed to the domain as an implementation. For more detail on the deployment of composites, see the section dealing with the SCA Domain.) 组 合 构 件 在 xxx.composite 文 件 中 定 义 组 合 构 件 用 composite 元 素 来 描 述 如 下 片 段 展 示 了 composite 元 素 的 schema <?xml version="1.0" encoding="ascii"?> <!-- Composite schema snippet --> <composite xmlns=" targetnamespace="xs:anyuri" name="xs:ncname" local="xs:boolean"? autowire="xs:boolean"? constrainingtype="qname"? requires="list of xs:qname"? policysets="list of xs:qname"?> 29 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

30 <include name="xs:qname"/>* <service name="xs:ncname" promote="xs:anyuri" requires="list of xs:qname"? policysets="list of xs:qname"?>* <interface/>? <binding uri="xs:anyuri"? name="xs:qname"? requires="list of xs:qname"? policysets="list of xs:qname"?/>* <callback>? <binding uri="xs:anyuri"? name="xs:qname"? requires="list of xs:qname"? policysets="list of xs:qname"?/>+ </callback> </service> <reference name="xs:ncname" target="list of xs:anyuri"? promote="list of xs:anyuri" wiredbyimpl="xs:boolean"? multiplicity="0..1 or 1..1 or 0..n or 1..n"? requires="list of xs:qname"? policysets="list of xs:qname"?>* <interface/>? <binding uri="xs:anyuri"? name="xs:qname"? requires="list of xs:qname"? policysets="list of xs:qname"?/>* <callback>? <binding uri="xs:anyuri"? name="xs:qname"? requires="list of xs:qname"? policysets="list of xs:qname"?/>+ </callback> </reference> <property name="xs:ncname" (type="xs:qname" element="xs:qname") many="xs:boolean"? mustsupply="xs:boolean"?>* default-property-value? </property> <component name="xs:ncname" autowire="xs:boolean"? requires="list of xs:qname"? policysets="list of xs:qname"?>* <implementation/>? <service name="xs:ncname" requires="list of xs:qname"? policysets="list of xs:qname"?>* <interface/>? <binding uri="xs:anyuri"? name="xs:qname"? requires="list of xs:qname"? policysets="list of xs:qname"?/>* <callback>? <binding uri="xs:anyuri"? name="xs:qname"? requires="list of xs:qname"? policysets="list of xs:qname"?/>+ </callback> </service> <property name="xs:ncname" (type="xs:qname" element="xs:qname") source="xs:string"? file="xs:anyuri"?>* property-value </property> <reference name="xs:ncname" target="list of xs:anyuri"? autowire="xs:boolean"? wiredbyimpl="xs:boolean"? requires="list of xs:qname"? policysets="list of xs:qname"? multiplicity="0..1 or 1..1 or 0..n or 1..n"?/>* <interface/>? <binding uri="xs:anyuri"? name="xs:qname"? requires="list of xs:qname"? policysets="list of xs:qname"?/>* 30 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

31 <callback>? </callback> <binding uri="xs:anyuri"? name="xs:qname"? requires="list of xs:qname"? policysets="list of xs:qname"?/>+ </reference> </component> <wire source="xs:anyuri" target="xs:anyuri" />* </composite> composite 元 素 有 如 下 属 性 : name ( 必 须 ) 组 合 构 件 的 名 字 组 合 构 件 名 字 的 形 式 是 一 个 XML QName, 在 由 targetnamespace 属 性 标 识 的 命 名 空 间 中 targetnamespace ( 可 选 ) composite 声 明 所 在 的 目 标 命 名 空 间 标 识 符 local ( 可 选 ) 组 合 构 件 中 的 所 有 构 件 是 否 必 须 运 行 于 同 一 个 操 作 系 统 进 程 Local= true 指 示 所 有 的 构 件 运 行 于 同 一 进 程 Local= false, 是 默 认 值, 指 示 组 合 构 件 里 的 不 同 的 构 件 运 行 于 不 同 的 操 作 系 统 进 程, 这 些 构 件 可 能 运 行 在 某 个 网 络 的 不 同 节 点 上 autowire ( 可 选 ) 被 包 含 的 构 件 引 用 是 否 自 动 连 线, 默 认 为 false, 在 自 动 连 线 节 描 述 constrainingtype ( 可 选 ) constrainingtype 的 名 字 当 指 定 的 时 候, 组 合 构 件 的 服 务, 引 用 和 属 性 的 集 合, 再 加 上 相 关 的 意 图, 都 会 受 限 于 costrainingtype 所 定 义 的 设 置 查 看 ConstrainingType 节 可 以 查 看 更 多 的 细 节 信 息 requires ( 可 选 ) 策 略 意 图 的 列 表 查 看 策 略 框 架 规 范 对 该 属 性 的 描 述 policysets ( 可 选 ) 策 略 集 列 表 查 看 策 略 框 架 规 范 对 该 属 性 的 描 述 组 合 构 件 包 含 0 个 或 多 个 属 性, 服 务, 构 件, 引 用, 连 线 以 及 内 含 的 组 合 构 件 这 些 工 件 具 体 的 细 节 在 以 下 章 节 会 描 述 构 件 包 含 配 置 化 的 实 现, 该 实 现 承 载 其 组 合 构 件 的 业 务 逻 辑 构 件 提 供 服 务 并 引 用 其 他 的 服 务 组 合 构 件 服 务 定 义 了 组 合 构 件 所 提 供 的 公 开 服 务, 并 能 被 组 合 构 件 的 外 部 访 问 组 合 构 件 引 用 描 述 该 组 合 构 件 依 赖 于 其 外 部 其 他 地 方 所 提 供 的 服 务 连 线 描 述 组 合 构 件 中 的 构 件 服 务 与 构 件 引 用 之 间 的 连 接 被 包 含 的 组 合 构 件 contribute 它 们 所 包 含 的 元 素 给 使 用 它 们 的 组 合 构 件 ( 译 者 注 : 这 里 的 它 们 指 代 那 些 被 包 含 的 组 合 构 件 ) 组 合 构 件 服 务 是 对 组 合 构 件 中 某 一 个 构 件 的 某 一 服 务 的 提 升 (promotion) 这 意 味 着, 组 合 构 件 服 务 实 际 上 是 由 其 内 部 的 一 个 构 件 所 提 供 的 组 合 构 件 引 用 是 对 一 个 或 多 个 构 件 的 一 个 或 多 个 引 用 的 提 升 只 要 所 有 的 构 件 引 用 相 互 兼 容, 多 个 构 件 引 用 能 被 提 升 为 同 一 个 组 合 构 件 的 引 用 在 多 个 构 件 引 用 被 提 升 为 同 一 个 组 合 构 件 的 引 用 的 地 方, 它 们 都 共 享 相 同 的 配 置, 包 括 相 同 的 目 标 服 务 组 合 构 件 的 服 务 和 引 用 分 别 使 用 它 们 被 提 升 的 服 务 与 引 用 的 配 置 ( 比 如 绑 定 和 策 略 集 ) 可 选 地, 通 过 对 组 合 构 件 服 务 或 引 用 的 绑 定 与 其 它 方 面 的 配 置, 组 合 构 件 的 服 务 与 引 用 可 以 覆 盖 被 提 升 的 服 务 和 引 用 的 全 部 或 某 些 配 置 构 件 的 服 务 和 引 用 可 以 提 升 为 组 合 构 件 的 服 务 和 引 用, 同 时 也 可 以 在 组 合 构 件 的 内 部 被 连 线 对 于 一 个 引 用, 只 有 该 31 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

32 引 用 支 持 大 于 1 的 multiplicity 才 有 意 义 属 性 - 定 义 和 配 置 属 性 允 许 通 过 外 部 设 置 数 据 值 对 实 现 进 行 配 置 一 个 实 现, 包 括 组 合 构 件, 可 以 定 义 0 个 或 多 个 属 性 每 个 属 性 都 一 个 类 型, 可 以 是 简 单 类 型 也 可 以 是 复 杂 类 型 实 现 也 可 以 为 属 性 定 义 一 个 默 认 值 属 性 可 以 用 构 件 中 的 值 进 行 配 置 组 合 构 件 中 属 性 的 声 明 遵 从 如 下 schema 片 段 所 描 述 的 形 式 : <?xml version="1.0" encoding="ascii"?> <composite xmlns=" name="xs:qcname"... >... <property name="xs:ncname" (type="xs:qname" element="xs:qname") many="xs:boolean"? mustsupply="xs:boolean"?>* default-property-value? </property>... </composite> 属 性 元 素 有 下 列 属 性 : ƒ name( 必 须 ) 属 性 的 名 字 ƒ 以 下 之 一 ( 必 须 ) o type 属 性 的 类 型 XML schema 类 型 的 限 定 名 o element 属 性 的 类 型 为 某 个 XML schema 全 局 元 素 的 类 型 ƒ many ( 可 选 ) 属 性 是 单 值 ( 指 定 为 false) 或 多 值 ( 指 定 为 true). 默 认 值 为 false. 多 值 属 性 的 情 况 下, 在 实 现 中 以 属 性 值 的 集 合 出 现 ƒ mustsupply ( 可 选 ) 属 性 值 是 否 必 须 由 构 件 提 供 - 当 mustsupply= true 时, 构 件 必 须 提 供 一 个 值, 因 为 实 现 对 于 该 属 性 没 有 默 认 值 当 mustsupply= false 时 (mustsupply 属 性 的 默 认 设 置 ), 只 能 提 供 默 认 的 属 性 值, 因 为 默 认 值 的 含 义 是 当 使 用 该 属 性 的 构 件 没 有 提 供 值 时, 才 能 使 用 默 认 值 property 元 素 可 以 包 含 一 个 可 选 的 default-property-value, 它 为 属 性 提 供 一 个 默 认 值 默 认 值 必 须 匹 配 属 性 声 明 的 类 型 : o 字 符 串, 如 果 type 是 简 单 类 型 ( 必 须 匹 配 声 明 的 类 型 ) o 匹 配 通 过 type 声 明 的 复 杂 类 型 o 匹 配 由 element 指 定 的 元 素 类 型 o 如 果 指 定 了 many="true", 则 允 许 多 值 对 于 非 composite 类 型 的 构 件 实 现, 能 以 与 具 体 实 现 相 关 的 形 式 ( 如 java 类 中 的 注 解 ) 或 通 过 在 某 个 32 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00

33 componenttype 文 件 中 的 属 性 声 明, 来 声 明 属 性 (componenttype 在 前 面 描 述 过 ) 当 构 件 使 用 某 个 实 现, 可 以 配 置 实 现 的 属 性 值 属 性 的 配 置 形 式 在 构 件 节 展 现 属 性 例 子 对 于 如 下 属 性 声 明 以 及 设 置 值 的 案 例, 用 到 了 复 杂 类 型 : <xsd:schema xmlns=" targetnamespace=" xmlns:tns=" <!-- ComplexProperty schema --> <xsd:element name="fooelement" type="mycomplextype"/> <xsd:complextype name="mycomplextype"> <xsd:sequence> <xsd:element name="a" type="xsd:string"/> <xsd:element name="b" type="anyuri"/> </xsd:sequence> <attribute name="attr" type="xsd:string" use="optional"/> </xsd:complextype> </xsd:schema> 下 述 组 合 构 件 展 示 了 带 有 默 认 值, 复 杂 类 型 属 性 的 声 明, 同 时 也 展 示 了 构 件 中 复 杂 类 型 属 性 值 的 设 置 : <?xml version="1.0" encoding="ascii"?> <composite xmlns=" xmlns:foo=" targetnamespace=" name="accountservices"> <!-- AccountServices Example1 -->... <property name="complexfoo" type="foo:mycomplextype"> <MyComplexPropertyValue xsi:type="foo:mycomplextype"> <foo:a>avalue</foo:a> <foo:b>interestinguri</foo:b> </MyComplexPropertyValue> </property> <component name="accountservicecomponent"> <implementation.java class="foo.accountserviceimpl"/> <property name="complexbar" source="$complexfoo"/> <reference name="accountdataservice" target="accountdataservicecomponent"/> <reference name="stockquoteservice" target="stockquoteservice"/> </component>... </composite> AccountServices 组 合 构 件 中, 名 为 complexfoo 的 属 性 声 明, 属 性 被 定 义 为 foo:mycomplextype 类 型 组 合 构 件 中 定 义 了 命 名 空 间 foo, 该 命 名 空 间 引 用 了 example XSD MyComplexType 定 义 在 该 命 名 空 间 中 complexfoo 的 声 明 包 含 一 个 默 认 值 该 默 认 值 作 为 property 元 素 的 内 容 被 定 义 在 这 个 例 子 中, 默 认 值 由 类 型 为 foo:mycomplextype 的 MyComplexPropertyValue 元 素 和 它 的 两 个 子 元 素 <foo:a> <foo:b>, 再 加 33 / 91 SCA Assembly Model Specification V1.00, SCA 装 配 模 型 规 范 V1.00