ESB文档库 ESB文档库
00 概述
01 产品安装指南
02 快速入门指南
03 ESB Studio使用指南
04 企业服务总线使用指南
05 高级配置指南
06 接口服务说明
07 升级&数据迁移指南
08 FAQ
  • 创建工程
  • 创建公共Module
  • 创建TCP Transport
  • 创建TCP Endpoint
  • 创建业务Module
  • 创建TCP业务服务
  • 创建TCP代理服务
  • 部署运行
  • 测试

本节以TCP穿透场景为例,讲述了TCP协议场景的创建过程,包括创建工程、创建TCP协议相关的服务、并测试运行。通过本节你将了解到如下内容:

  1. 如何创建完整的TCP协议场景;
  2. 如何在Studio中测试运行开发的业务逻辑;
  3. 如何运行并测试TCP穿透;

本示例中通过SocketTool模拟TCP请求方与提供方,通过SocketTool的TCP Client发送请求消息,经过APIGateway穿透后SocketTool的TCP Server接收到请求消息,然后通过SocketTool的TCP Server发送响应消息,经过APIGateway穿透后SocketTool的TCP Clientr接收到响应消息。

项目源码如附件所示:tcp.zip

# 创建工程

  1. 打开ESB Studio,在资源管理器中,点击右键,选择"创建 > ESB项目"菜单项,创建工程,如下图所示。

  2. 在工程创建向导中,填写工程的基本信息,如工程名称等,这里我们创建一个名为"http"的工程,如下图所示。

  3. 单击“下一步”,设置工程的引用库,这里使用缺省设置,如下图所示。

  4. 单击“完成”,完成创建工程。创建工程后,资源管理器如下图所示。

# 创建公共Module

  1. 在资源管理器中,选中创建好的项目,鼠标右键选择“创建 > 公共Module”,创建公共Module,如下图所示。

  2. 在“公共Module”对话框中,填写Module名称等信息,如下图所示。

  3. 单击“完成”,公共Module创建完成,如下图所示。

# 创建TCP Transport

  1. 在创建的ESB项目的“Transport”上,右键选择“创建 > TCP类型Transport”,如下图所示。

  2. 在弹出的“创建TCP类型Transport”界面,选择当前的工程、Module,并输入文件名及显示名称,如下图所示。

  3. 单击“完成”,TCP Transport创建完成,如下图所示。

  4. 在资源管理器中,双击创建的TCP Transport,打开TCP Transport编辑器,修改相关参数。如下所示。

  5. TCP Transport配置完成后,单击工具栏中的保存图标。

# 创建TCP Endpoint

  1. 在创建的ESB项目的“Endpoint”上,右键选择“创建 > TCP类型Endpoint”,如下图所示。

  2. 在弹出的“创建TCP类型Endpoint”界面,选择当前的工程、Module,并输入文件名及显示名称,如下图所示。

  3. 单击“完成”,TCP Endpoint创建完成,如下图所示。

  4. 在资源管理器中,双击创建的TCP Endpoint,打开TCP Endpoint编辑器,修改相关参数。如下所示。

# 创建业务Module

  1. 在资源管理器中,选中创建好的项目,鼠标右键选择“创建 > 业务Module”,创建业务Module,如下图所示。

  2. 在“业务Module”对话框中,填写Module名称等信息,如下图所示。

  3. 单击“完成”,业务Module创建完成,如下图所示。

# 创建TCP业务服务

  1. 在资源管理器中,在新建的“业务服务”上,鼠标右键选择“创建 > TCP业务服务”,创建TCP业务服务,如下图所示。

  2. 在打开的“创建TCP 业务服务”对话框中,输入类别信息,如下图所示。

  3. 单击“完成”,在打开的“TCP业务服务”的编辑界面中,设置显示名称、Endpoint,如下图所示。

  4. 单击工具栏的保存。

# 创建TCP代理服务

  1. 在资源管理器中,在“代理服务”上,鼠标右键选择“创建 > TCP代理服务”,创建TCP代理服务,如下图所示。

  2. 在打开的“创建TCP代理服务”对话框中,输入类别信息,如下图所示。

  3. 单击“完成”,在TCP代理服务的编辑界面中,设置TCP代理服务的配置,如下图所示。

  4. 单击工具栏的保存,完成TCP代理服务的创建。

# 部署运行

  1. 在资源管理器中,选中创建好的项目,鼠标右键单击“部署”,如下图所示。

  2. 部署完成后,ESB Studio将公共Module和业务Module部署Studio内置的ESB Server上,然后启动ESB Server,如下图所示。

  3. 在ESB Studio控制台,看到“ESB Server started successfully.”日志字样,表示ESB Server启动成功,如下图所示。

# 测试

1.通过SocketTool进行测试,创建TCP Server,监听端口对应TCP Endpoint配置的端口8001;创建TCP Client,如下图所示。

对方IP为ESB Server运行机器IP,对方端口对应TCP Transport配置的端口8000,如下图所示。

2.在TCP Client窗口发送请求,TCP Server窗口会接收到相应信息,如下图所示。

3.在TCP Server窗口发送响应,TCP Client窗口会接收到相应信息,如下图所示。

← 3.5.7.3 CUST自定义协议(以HL7为例) 3.5.9 UDP穿透 →