用户手册适配器开发.pdfVIP

一、前言

eStarSmartAdaptors是基于服务体系架构和组件结构的应用适配器系

统，主要是为了解决应用系统与中间件系统之间的连接与信息传送等问题。

eStarSmartAdaptors采用组件式架构和标准的数据结构，大幅度地提高了适

配器的重用性和统一性。

适配器系统设计思想采用以数据流向为主线，配置代替编程，功能组件代

替整体程序的方式，使智能适配器系统紧凑，灵活和易于扩展。

此文档的目的是让读者了解适配器中信息组件的开发，及如何部署到

eStar设计环境ServiceWorks中，该文档针对组件的类型做了分类阐述。

本文档面向的读者主要是开发人员。

二、总体说明

2.1数据流

数据的流向决定了适配器的功能，从总体上看数据流方向分为数据的输出

流向和数据的输入流向。流向不同实现的功能也就有可能不同，例如数据输出

时，要对数据进行打包和封装，数据输入时要认证与拆包，同时数据流的位置

所完成的功能也有所不同。例如在传输前要根据数据的内容进行过滤，如果所

有功能编写在一个程序中，将使程序变得庞大而不灵活，任何的更改都要更改

整个程序。智能适配器采用单向通道结构与功能组件结构，这样的设计是为了

降低适配器的复杂度，增大灵活性和可扩展性。

2.2组件

适配器是按照数据流的某一方向串联不同的信息组件所组成的。根据功能

不同，信息组件可分为四类。一类是信息源，称为信息输出源；一类是信息的

目的地，称为信息输入源；一类是在信息输出源与信息输入源之间的信息通

道；一类是控制与管理。

信息输出组件（信息源）负责从某一应用系统中提取或接收应用系统输出

的信息。它提供的功能包括根据应用系统支持的通讯协议与应用系统建立连

接，通过应用系统支持的信息协议提取或接收信息，同时它也负责建立事务进

程等技术协议，输出的信息经过打包封装成标准格式。智能适配器系统支持

XML标准封装格式，也可采用行业标准格式如ebXML和ResettaNet等。

信息输入组件（信息目的地）负责把接收到的信息传送到某一应用系统之

中，它提供的功能包括根据应用系统支持的通讯协议与应用系统建立连接，通

过应用系统支持的信息协议传送信息，同时它也负责建立事务进程等技术协

议。组件收到的信息作为输入信息，按照标准格式拆包，并用应用系统所支持

的格式封装，然后传送到应用系统中。

信息通道组件就像通道一样，信息从一端流入从另一端流出，在此过程中

信息可以被加工与整理。信息通道可以像套管一样一个套一个。信息通道主要

是功能扩展的组件。

三、配置文件

每个自定义组件需要一个ini配置文件和一个class文件，其中ini配置文

件提供对组件的描述，class文件提供运行逻辑。本章主要介绍ini配置文件

的编写。

Ini配置文件主要由四部分组成：[Component]，[GUI]，[Mandatory

Properties]及[OptionalProperties]。示例如下：

[Component]组件的基本信息：

a)Name组件名称。

b)Type组件类型，三个选项：Source（信息源组件）,Channel（信息通

道组件）,Target（信息目的组件）

c)Java组件对应的类，用类的全路径表示。

[GUI]组件在ServiceWorks中的布局信息：

a)PalettePath组件的显示分类。

b)ComponentToolTipText组件说明，当鼠标放到组件名称上时显示的简

单提示。

[MandatoryProperties]列出该组件必须配置的属性，配置时该部分

的每个属性必须正确配置，否则可能导致配出的适配器无法工作，具体属

性开发时自定义。

[OptionalProperties]列出该组件可选的属性，该部分的属性在配置

时不是必须的，但是它们可以