创建自定义解析程序

项目
02/14/2024

Microsoft BizTalk ESB 工具包中的冲突解决程序和适配器提供程序框架实现使用名为 Dispatcher 的管道组件，以及名为 ItineraryReceive 和 ItinerarySend 的管道。

调度程序管道组件有四个属性： Validate、Enabled、EndPoint 和 MapName。 EndPoint 属性可以包含具有如下值的解析程序连接字符串，其中 UDDI：\\ 表示要使用的解析类型 (根名字对象) 。

UDDI:\\serverUrl=http://localhost/uddi;serviceName=OrderPurchaseToOrderPost;serviceProvider=Microsoft.Practices.ESB

其他支持的名字对象包括 XPATH：\\、STATIC：\\和BRE：\\。每个名字对象类型都使用实现 IResolveProvider 接口的特定类。可以为其他名字对象类型创建自己的自定义解析程序，并注册它们以供动态解析系统使用。

名字对象等同于解析程序连接字符串。单个架构定义参数及其根名字对象。解析程序将解析程序连接字符串，对其进行验证，并使用结果来查询和填充可用于路由、转换、行程选择或特定于服务的一些其他用途的 Dictionary 对象。

冲突解决程序配置

必须在 Esb.config 配置文件中注册所有解析程序。以下 XML 演示配置文件内容的示例。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
     <configSections>
          <section name="esb" type="Microsoft.Practices.ESB.Configuration.ESBConfigurationSection, Microsoft.Practices.ESB.Configuration, Version=2.0.0.0, Culture=neutral, PublicKeyToken=c62dd63c784d6e22"/>
          <!-- Other Section Definitions Here -->
     </configSections>

     <esb>
          <resolvers cacheManager= "Resolver Providers Cache Manager"  absoluteExpiration="3600">
               <resolver name="UDDI" type="Microsoft.Practices.ESB.Resolver.UDDI.ResolveProvider, Microsoft.Practices.ESB.Resolver.UDDI, Version=2.0.0.0, Culture=neutral, PublicKeyToken=c62dd63c784d6e22">
                    <resolverConfig>
                         <add name="cacheTimeoutValue" value="120" />
                         <add name="cacheName" value="UDDI Cache Manager" />
                    </resolverConfig>
               </resolver>
               <resolver name="XPATH" type="Microsoft.Practices.ESB.Resolver.XPATH.ResolveProvider, Microsoft.Practices.ESB.Resolver.XPATH, Version=2.0.0.0, Culture=neutral, PublicKeyToken=c62dd63c784d6e22"/>
               <!-- Other Resolver Definitions Here -->
          </resolvers>
          <!-- Other ESB Configuration Settings Here -->
     </esb>
     <!-- Other Configuration Sections Here -->
</configuration>

通过每个 解析程序节点下的 resolverConfig 部分，可以配置解析程序在特定环境中运行所需的其他属性。若要访问配置，解析程序必须公开一个构造函数，该构造函数采用 类型为 Microsoft.Practices.ESB.Configuration.Resolver 的参数。在解析程序实现中，可以使用 ResolverConfigHelper 类的 ReadResolverConfigByKey 方法访问配置属性;为此，请传入最初传递给构造函数的参数，然后传入有问题的值的名称。如果未在 resolverConfig 节点中指定名称/值对，则将使用默认无参数构造函数来实例化解析程序。

配置中定义了两个通用说明、发现和集成 (UDDI) 3 解析程序：UDDI 3 和 UDDI 3-SOASOFTWARE。这两个解析程序使用相同的基础程序集，但它们提供了不同的配置来支持具有不同统一资源标识符 (URI) 格式和安全要求的不同 UDDI 3.0 兼容注册表。如果需要为符合 UDDI 3.0 的注册表配置其他名字对象（除了已支持的注册表之外），可以使用以下配置属性：

cacheTimeoutValue
cacheName
publisherKey
useUddiAuth
baseUri
inquireUriSuffix
securityUriSuffix
securityMode。有关有效值，请参阅枚举 System.ServiceModel.BasicHttpSecurityMode (https://go.microsoft.com/fwlink/?LinkID=188284&clcid=0x409) 。默认值为 TransportCredentialOnly。
credentialType。有关有效值，请参阅枚举 System.ServiceModel.HttpClientCredentialType (https://go.microsoft.com/fwlink/?LinkId=188285) 。默认值为 Windows。
username
password

如果要创建依赖于 Unity 应用程序块的依赖项注入功能的解析程序，则需要其他配置。有关详细信息，请参阅使用 Unity 容器创建自定义冲突解决程序。

IResolveProvider 接口

所有解析程序都必须实现 IResolveProvider 接口。位于 Microsoft.Practices.ESB.Resolver 项目中的 IResolveProvider 接口由 Resolve 方法的三个重载组成，这些重载返回 Dictionary 类的实例，其中包含具体解析程序类的实例提供的解析事实。下面的代码示例演示这些方法重载的签名。

// <summary>
// This is the main interface that is called from the
// ResolverMgr class.
// This interface supports being called from a Microsoft BizTalk
// Server pipeline component.
// </summary>
// <param name="config">Configuration string entered into
// pipeline component as argument</param>
// <param name="resolver">Moniker representing the resolver
// to load</param>.
// <param name="message">IBaseMessage passed from pipeline</param>.
// <param name="pipelineContext">IPipelineContext passed from
// pipeline</param>.
// <returns>Dictionary object fully populated</returns>.
        Dictionary<string, string> Resolve(string config, string resolver,
              IBaseMessage message, IPipelineContext pipelineContext);

// <summary>
// This is the main interface that is called from the ResolverMgr
// class.
// This interface supports being called from a Web service interface.
// </summary>
// <param name="config">Configuration string entered into Web
// service as argument</param>.
// <param name="resolver">Moniker representing the resolver
// to load</param>.
// <param name="message">XML document passed from Web
// service</param>.
// <returns>Dictionary object fully populated</returns>.
        Dictionary<string,string> Resolve(string config, string resolver, System.Xml.XmlDocument message);

// <summary>
// This is the main interface that is called from the
// ResolverMgr class.
// This interface supports being called from an orchestration.
// </summary>
// <param name="resolverInfo">Configuration string containing
// configuration and resolver</param>.
// <param name="message">XLANGMessage passed from
// orchestration</param>.
// <returns>Dictionary object fully populated</returns>.
        Dictionary<string, string> Resolve(ResolverInfo resolverInfo, XLANGs.BaseTypes.XLANGMessage message);

位于 Microsoft.Practices.ESB.Resolver 项目中的 Resolution 结构还定义 存储在 Dictionary 实例中的名称/值对。 Resolution 结构公开多个属性：下表列出了其中最相关的内容。 ResolutionHelper 类的 CreateResolverDictionary 方法可用于生成包含最常用的键和空字符串值的解析程序字典。 Dictionary 实例支持通过 Resolver 类的具体实现添加自定义冲突解决程序名称/值对。

属性	数据类型	数据类型	数据类型
TransformType	String	ActionField	String
Success	布尔	EpmRRCorrelationTokenField	String
TransportNamespace	String	InboundTransportLocationField	String
TransportType	String	InterchangeIDField	String
TransportLocation	String	ReceiveLocationNameField	String
操作	String	ReceivePortNameField	String
MessageExchangePattern	String	InboundTransportTypeField	String
EndpointConfig	String	IsRequestResponseField	String
TargetNamespace	String	DocumentSpecStrongNameField	String
FixJaxRPC	布尔	DocumentSpecNameField	String
WindowUserField	String	MessageType	String
CacheTimeout	String	OutboundTransportCLSID	String
MethodNameField	String