本节以TCP穿透场景为例,讲述了TCP协议场景的创建过程,包括创建工程、创建TCP协议相关的服务、并测试运行。通过本节你将了解到如下内容:
- 如何创建完整的TCP协议场景;
- 如何在Studio中测试运行开发的业务逻辑;
- 如何运行并测试TCP穿透;
本示例中通过SocketTool模拟TCP请求方与提供方,通过SocketTool的TCP Client发送请求消息,经过APIGateway穿透后SocketTool的TCP Server接收到请求消息,然后通过SocketTool的TCP Server发送响应消息,经过APIGateway穿透后SocketTool的TCP Clientr接收到响应消息。
项目源码如附件所示:tcp.zip
# 创建工程
打开ESB Studio,在资源管理器中,点击右键,选择"创建 > ESB项目"菜单项,创建工程,如下图所示。
在工程创建向导中,填写工程的基本信息,如工程名称等,这里我们创建一个名为"http"的工程,如下图所示。
单击“下一步”,设置工程的引用库,这里使用缺省设置,如下图所示。
单击“完成”,完成创建工程。创建工程后,资源管理器如下图所示。
# 创建公共Module
在资源管理器中,选中创建好的项目,鼠标右键选择“创建 > 公共Module”,创建公共Module,如下图所示。
在“公共Module”对话框中,填写Module名称等信息,如下图所示。
单击“完成”,公共Module创建完成,如下图所示。
# 创建TCP Transport
在创建的ESB项目的“Transport”上,右键选择“创建 > TCP类型Transport”,如下图所示。
在弹出的“创建TCP类型Transport”界面,选择当前的工程、Module,并输入文件名及显示名称,如下图所示。
单击“完成”,TCP Transport创建完成,如下图所示。
在资源管理器中,双击创建的TCP Transport,打开TCP Transport编辑器,修改相关参数。如下所示。
TCP Transport配置完成后,单击工具栏中的保存图标。
# 创建TCP Endpoint
在创建的ESB项目的“Endpoint”上,右键选择“创建 > TCP类型Endpoint”,如下图所示。
在弹出的“创建TCP类型Endpoint”界面,选择当前的工程、Module,并输入文件名及显示名称,如下图所示。
单击“完成”,TCP Endpoint创建完成,如下图所示。
在资源管理器中,双击创建的TCP Endpoint,打开TCP Endpoint编辑器,修改相关参数。如下所示。
# 创建业务Module
在资源管理器中,选中创建好的项目,鼠标右键选择“创建 > 业务Module”,创建业务Module,如下图所示。
在“业务Module”对话框中,填写Module名称等信息,如下图所示。
单击“完成”,业务Module创建完成,如下图所示。
# 创建TCP业务服务
在资源管理器中,在新建的“业务服务”上,鼠标右键选择“创建 > TCP业务服务”,创建TCP业务服务,如下图所示。
在打开的“创建TCP 业务服务”对话框中,输入类别信息,如下图所示。
单击“完成”,在打开的“TCP业务服务”的编辑界面中,设置显示名称、Endpoint,如下图所示。
单击工具栏的保存。
# 创建TCP代理服务
在资源管理器中,在“代理服务”上,鼠标右键选择“创建 > TCP代理服务”,创建TCP代理服务,如下图所示。
在打开的“创建TCP代理服务”对话框中,输入类别信息,如下图所示。
单击“完成”,在TCP代理服务的编辑界面中,设置TCP代理服务的配置,如下图所示。
单击工具栏的保存,完成TCP代理服务的创建。
# 部署运行
在资源管理器中,选中创建好的项目,鼠标右键单击“部署”,如下图所示。
部署完成后,ESB Studio将公共Module和业务Module部署Studio内置的ESB Server上,然后启动ESB Server,如下图所示。
在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窗口会接收到相应信息,如下图所示。