【泛微E9开发】ESB开发1

1、ESB 介绍

企业服务总线，即ESB全称为Enterprise Service Bus，指的是传统中间件技术与XML、Web服务等技术结合的产物。ESB提供了网络中最基本的连接中枢，是构筑企业神经系统的必要元素。面向服务的体系结构已经逐渐成为IT集成的主流技术。面向服务的体系结构(service-oriented architecture，SOA)是一种软件系统设计方法，通过已经发布的和可发现的接口为终端用户应用程序或其它服务提供服务.

2、E9 ESB介绍

ESB中心是一个异构系统集成平台，用来支撑EC未来的异构系统集成，将大大降低集成开发人员的技术难度，集成开发人员不需要学习各种技术接口开发，只要掌握 ESB 规范，通过 SDK 几行代码即可完成异构系统的对接。

3、功能说明

非标编号：099 ESB中心

启用非标后，后台设置的顶部菜单出现ESB中心的入口：

未启用非标功能，直接访问ESB路由，会出现以下提示信息：

对不起，你暂时没有开启非标功能！

3.1配置文件

1. ecology\classbean\META-INF\xfire\services.xml新增以下内容：

    <service>
        <name>ESBServiceV2</name>  
        <namespace>webservicesv2.esb.weaver.com.cn</namespace>  
        <serviceClass>com.weaver.esb.server.api.EsbWebService</serviceClass>  
<implementationClass>com.weaver.esb.server.api.EsbWebServiceImpl</implementationClass>          <serviceFactory>org.codehaus.xfire.annotations.AnnotationServiceFactory</serviceFactory> 
    </service>

2. ecology\WEB-INF\prop\esb.properties

#OA与 ESB 集成模式(local:本地，http:通过http访问)
type=local
#ESB 服务地址（type不是local时必填）
serverUrl=
#ESB 分配的应用标识
appKey=64caed2d-ab47-4116-b1be-6caec02a2fa1

#开启签名(1：启用，0 不启用)
isSign=1
#密钥（isSign=1时必须）
sercetKey=468c912ca4bc9f9e43b51569da1b6797

#用户名（isAuth=1时必须）
userName=
#密码（isAuth=1时必须）
password=

#响应格式（json,xml）
format=json

encoding=UTF-8

3.2导航栏

导航主菜单的作用：
1.显示ESB中心中所有资源、接口、事件、应用的配置总数及在用资源、接口、事件、用用数量。
2. 提供配置导航步骤，方便项目人员进行配置。

3.3. 配置中心

3.3.1. 产品管理

系统默认产品标识：ecology
注意：请勿轻易删除默认产品，否则需要修改esb.properties后OA才能正常使用OA自身的ESB中心相关功能。

基本功能介绍：
1、管理客户使用的各个产品，每个产品必属于某个分部，产品在ESB中的作用类似于分类，在ESB中注册接口、事件时必须指定产品，后序权限管理时可根据产品进行权限控制。
2、每个产品必须指定所属分部。
3、产品包含正常、封存两种状态
 正常状态：可以被新建的模块、资源、接口、事件、常量、转换引用。
 封存状态：不可被被新建的模块、资源、接口、事件、常量、转换引用，但是不影响已有的功能正常使用。
4、删除：只有产品不被引用时，才能被删除
基础信息设置：

产品编码：必填，唯一值标识
编码规则：首位必须是字母，只可以输入字母、数字、下划线的组合【ESB中心所有的标识输入均为此规则】

产品名称：必填，产品的名称

所属机构：必填，选择OA中已有的一个有效分部

出品公司：产品的说明信息
安全设置：

App Key：新建产品时自动生成的主键，唯一值，不可更改。

认证：默认关闭。开启后使用对应产品下的应用需要用户名、密码的校验。

签名校验：默认关闭。开启后自动生成Secret Key，并可以点击重置键进行重置。
说明：安全设置用于保证异构系统通过 API触发 ESB 事件时 保证请求安全。具体使用方式参考相关文档中的【ESB API 接口说明】

IP限制：默认关闭。开启后可以设置白名单、黑名单。
1、白名单：允许列表中的IP地址访问该产品下的ESB服务，IP地址格式支持IP4和IP6
2、黑名单：不允许列表中的IP地址访问该产品下的ESB服务
备注：当一个IP同时出现在白名单和黑名单时，以黑名单中的设置内容优先