使用 WCF LOB 适配器 SDK 时,选择 URI 方案和寻址格式

统一资源标识符 (URI) 唯一标识 Web 服务等资源,或者对于使用 WCF LOB 适配器 SDK 开发的适配器,则标识要连接到的系统以及要执行的操作。 本部分提供有关如何构造 URI 的建议,以唯一描述适配器的终结点地址和操作。

URI 剖析

URI 由以下三个组件组成:

  • 方案名称 是 URI 字符串的前导部分,是命名结构的第一级;示例包括 http、urn 和 contoso。

  • 分层部分 由通常分层的信息组成,可以包含可选的颁发机构、主机名和端口信息。 示例包括 www.microsoft.comUserName=User@microsoft.com:4099

  • 查询 包含用问号 ( ) ) 标记的可选信息,通常分组为键/值对,由与号和 (&) 分隔。 例如,contoso://microsoft.com/functions?name=Find。

  • 片段 用于存储适配器可能需要的额外标识信息。 片段由哈希 (#) 分隔;例如,contoso://microsoft.com/functions?name=Find#public。

    可能不会使用 URI 语法提供的所有功能。

设计 URI

作为适配器开发人员,你必须为目标业务线系统设计适当的 URI。 设计 URI 时,请务必使其具有唯一性和意义。

唯一 URI 是一个不与组织内部以及其他企业和 Internet 的现有 URI 冲突的 URI。 例如,选择当前可能已识别或已在广泛使用的方案名称(如“http”或“afs”)可能会导致连接或操作问题,因为请求可能会路由到其他系统,而不是路由到适配器。

URI 设计的另一个重要方面是使其对使用适配器的开发人员受众有意义。 例如,如果要为医疗声明处理系统编写适配器,则可以设计一个 URI 方案,其中包括公司名称、目标声明处理系统名称和系统版本:northwind.contoso.cps.v1.0://。

连接到目标系统

连接字符串具有以下语法:

<scheme>://[userinfo “@”]<LOB 连接字符串>

例如,可以使用以下命令连接到 contoso 目录订购系统 (示例业务线应用程序) :

northwind.contoso.v1.0://<servername>?Catalog=Contoso&Integrated Security=True

还可以在 URI 中提供可选的颁发机构信息,包括用户名和密码以及其他重要凭据。 但是,这会带来安全风险。

注意

不要在 URI 中传递用户凭据和其他敏感信息。 未经授权的用户可能会截获和查看此信息。

另请参阅

使用 WCF LOB 适配器 SDK 规划和设计适配器