步骤 1:使用 WCF LOB 适配器开发向导创建 Echo 适配器项目

Step 1 of 9

完成时间: 15 分钟

在此步骤中,将使用Visual Studio和适配器开发向导创建项目。 适配器开发向导将指导你完成为系统开发自定义适配器所涉及的步骤。 它收集有关消息交换模式、元数据功能、适配器属性和连接属性的信息。 向导成功完成后,会生成一组文件。

先决条件

必须具备 在开始教程之前 介绍的知识,并且已使用 WCF LOB 适配器 SDK 成功为适配器开发设置计算机。

选择 WCF LOB 适配器插件Visual Studio

  1. 开始Visual Studio,然后在“文件”菜单上,指向“新建”,然后单击“Project”。

  2. 在“新建项目” 对话框中执行以下操作:

    使用此选项 要执行此操作
    Project类型 单击 “Visual C#”。
    模板 单击 WCF LOB 适配器
    名称 键入 EchoAdapter
    位置 键入 C:\Tutorials
    为解决方案创建目录 选中此复选框以便为解决方案文件创建目录。
    解决方案名称 类型 EchoAdapterSampleV2

    下图显示了“新建Project”对话框。

    Screenshot that shows the New Project dialog box.

  3. 单击“确定”。

  4. 在“欢迎”页面上,单击“下一步”。 下图显示了 “欢迎 ”页。

    Screenshot that shows the Welcome page.

  5. 单击“下一步”。

输入方案和命名空间信息

  1. “方案”、“命名空间和 URI 信息 ”页上,执行以下操作:

    使用此选项 要执行此操作
    方案 键入 echov2
    Project命名空间 键入 Microsoft.Adapters.Samples.EchoV2

    下图显示了 方案、命名空间和 URI 信息 页。

    Screenshot that shows the Scheme, Namespace, and URI Information page.

  2. 单击“下一步”。

输入数据流和元数据功能

  1. “数据流元数据功能 ”页上,执行以下操作:

    消息交换模式

    使用此选项 要执行此操作
    同步出站 选择此复选框。
    同步入站 选择此复选框。

    元数据功能

    使用此选项 要执行此操作
    检索 选择此复选框。
    “浏览” 选择此复选框。
    搜索 选择此复选框。

    注意

    此上下文中的数据流意味着与消息交换模式相同,即概念主题中使用的术语。

    下图显示了 “数据流元数据功能 ”页。

    Screenshot that shows the Data Flows and Metadata Features page.

  2. 单击“下一步”。

输入适配器属性

  1. “适配器属性” 页上,执行以下操作:

  2. 添加名为 Count 的属性。 此数字由回显适配器的每个操作使用。 每个操作将返回输入值 计数 次数。

    使用此选项 要执行此操作
    属性名称 类型 计数
    Data type 选择 System.Int32
    默认值 类型 5.
    添加 单击可添加新适配器属性。
  3. 添加名为 EnableConnectionPooling 的属性。 WCF LOB 适配器 SDK 使用此标志启用或禁用运行时连接池。

    使用此选项 要执行此操作
    属性名称 键入 EnableConnectionPooling
    Data type 选择 System.Boolean
    默认值 键入 true
    添加 单击可添加新适配器属性。
  4. 添加名为 InboundFileFilter 的属性。 FileSystemWatcher 使用此属性监视此扩展的文件。 此属性仅适用于入站方案。

    使用此选项 要执行此操作
    属性名称 键入 InboundFileFilter
    Data type 选择 System.String
    默认值 键入 *.txt
    添加 单击可添加新适配器属性。
  5. 添加名为 InboundFileSystemWatcherFolder 的属性。 此属性用于设置文件将被删除的文件夹,以便 FileSystemWatcher 向适配器发出通知。 此属性仅适用于入站方案。

    使用此选项 要执行此操作
    属性名称 键入 InboundFileSystemWatcherFolder
    Data type 选择 System.String
    默认值 键入 C:\\inbound\\watcher
    添加 单击可添加新适配器属性。

    下图显示了 “适配器属性” 页。

    Screenshot that shows the Adapter Properties page.

  6. 单击“下一步”。

输入连接属性

  1. “连接属性” 页上,执行以下操作:

  2. 添加名为 Application 的属性。 此属性仅用于说明目的。 回显适配器不涉及任何 LOB 系统。

    使用此选项 要执行此操作
    属性名称 键入 应用程序
    Data type 选择 System.String
    默认值 类型 lobapplication
    添加 单击可添加新适配器属性。
  3. 添加名为 EnableAuthentication 的属性。 当 true,适配器需要客户端凭据中的用户名字段中的值。

    使用此选项 要执行此操作
    属性名称 键入 EnableAuthentication
    Data type 选择 System.Boolean
    默认值 键入 false
    添加 单击可添加新适配器属性。
  4. 添加名为 HostName 的属性。 此属性仅用于说明目的,类似于属性 应用程序

    使用此选项 要执行此操作
    属性名称 键入 主机名
    Data type 选择 System.String
    默认值 类型 lobhostname
    添加 单击可添加新适配器属性。
  5. 添加名为 EchoInUpperCase 的属性。 此属性控制某些操作是将回显字符串转换为大写字符串,还是将其保留为原始格式。

    使用此选项 要执行此操作
    属性名称 键入 EchoInUpperCase
    Data type 选择 System.Boolean
    默认值 键入 False
    添加 单击可添加新适配器属性。
  6. 单击“下一步”。

结束向导

  1. “概要”页上,单击“完成”。 下图显示了具有 EchoAdapter 项目的解决方案资源管理器

    Screenshot that shows the Solution Explorer with the EchoAdapter project.

    项目应包含相同的文件。 如果没有,请退出Visual Studio,删除 EchoAdapterSampleV2 文件夹,然后重启本教程的此步骤。

  2. 在Visual Studio的“文件”菜单上,单击“全部保存”。

    注意

    保存所做的工作。 此时可以安全地关闭Visual Studio,或转到下一步步骤步骤 2:对适配器和连接属性进行分类

我刚刚做什么?

在此步骤中,使用Visual Studio和适配器开发向导创建了回显适配器解决方案。 下表包含一组文件和每个文件的用途。

文件名 说明
EchoAdapter.cs 这是继承自 Microsoft.ServiceModel.Channels.Common.Adapter主适配器类。

回显适配器无需任何更改。
EchoAdapterBinding.cs 这是为适配器创建绑定时使用的类。

回显适配器无需任何更改。
EchoAdapterBindingCollectionElement.cs 这是实现 . 的 System.ServiceModel.Configuration.StandardBindingCollectionElementBinding Collection 元素类。

回显适配器无需任何更改。
EchoAdapterBindingElement.cs 这为配置元素提供基类。

若要对回显适配器的适配器和连接属性进行分类,请按照 步骤 2:对适配器和连接属性进行分类
EchoAdapterBindingElementExtensionElement.cs 提供此类以将适配器表示为绑定元素,以便可在用户定义的 WCF 自定义绑定中使用。

若要对回显适配器的适配器和连接属性进行分类,请按照 步骤 2:对适配器和连接属性进行分类
EchoAdapterHandlerBase.cs 这是用于存储基类公开的公共属性/帮助程序函数的处理程序的基类。

若要对回显适配器的适配器和连接属性进行分类,请按照 步骤 2:对适配器和连接属性进行分类
EchoAdapterConnection.cs 这会定义与目标系统的连接。

若要支持回显适配器与目标系统的连接,请按照 步骤 3:实现 Echo 适配器的连接
EchoAdapterConnectionFactory.cs 这会定义目标系统的连接工厂。

若要支持回显适配器与目标系统的连接,请按照 步骤 3:实现 Echo 适配器的连接
EchoAdapterConnectionUri.cs 这是表示适配器连接 URI 的类。

若要支持回显适配器与目标系统的连接,请按照 步骤 3:实现回显适配器) 的连接
EchoAdapterMetadataBrowseHandler.cs 此类在对目标系统中的元数据执行基于连接的浏览时使用。

若要支持回显适配器的元数据浏览功能,请按照 步骤 4:为 Echo 适配器实现元数据浏览处理程序
EchoAdapterMetadataSearchHandler.cs 此类用于对目标系统中的元数据执行基于连接的搜索。

若要支持回显适配器的元数据搜索功能,请按照 步骤 5:为 Echo 适配器实现元数据搜索处理程序
EchoAdapterMetadataResolve.cs 此类用于从目标系统执行基于连接的元数据检索。

若要支持回显适配器的元数据解析功能,请按照 步骤 6:为 Echo 适配器实现元数据解析处理程序
EchoAdapterOutboundHandler.cs 此类用于将数据发送到目标系统。

若要支持回显适配器的出站消息交换,请按照 步骤 7:为 Echo 适配器实现同步出站处理程序
EchoAdapterInboundHandler.cs 此类实现用于侦听或轮询数据的接口。

若要支持回显适配器的入站消息交换,请按照 步骤 8:为 Echo 适配器实现同步入站处理程序
EchoAdapterTrace.cs 此类实现适配器跟踪,以便进行调试和故障排除。

后续步骤

为它们的 UI 逻辑分组对适配器和连接属性进行分类,然后实现连接、元数据浏览、搜索和解析功能,以及出站和入站消息交换。 最后,生成并部署回显适配器。

另请参阅

步骤 2:对适配器和连接属性分类
教程 1:开发 Echo 适配器