WCF 第十三章 可编程站点 URI和UriTemplates

从.NET Framework v1.0开始微软就支持了URIs. System.Uri类允许开发人员在一个URI内定义并截取基本信息。这个类允许开发人员访问比如计划，路径和机器名等信息。向网络客户端比如System.Windows.Forms.WebBrowser控制或者System.Net.WebClient类传输一个URI是很好的。System.Uri类的依赖类是System.UriBuilder类。这个类提供了一种方式来修改System.Uri类而不用创建另外一个System.Uri实例。这些类是使用基于HTTP协议的URIs的基础。目前开发人员使用的话还需要额外的能力来支持REST架构类型。
表13.1显示了开发人员在URIs中嵌入字符串作为查询字符串参数或者作为路径的一部分。System.Uri或者System.UriBuilder类不允许在这个解决方案下创建和截取URIs. 另外一种解决方案已经用来创建和截取基于确定命名令牌模式的URIs。它们也定义了参数如何从URIs截取。.NET Framework 3.5介绍了一个新的可以提供一个持续的方式来创建和截取URIs基于模式的称作System.UriTemplate的类。这个类定义一个基于命名令牌的模式。令牌在一个模式中使用大括号表示。例如，模式/finance/info?q={symbol}确定了一个被作为一个查询字符串参数发送的股票符号。命名令牌也可以嵌入到URI路径中作为其一部分且不仅限于查询字符串参数。例如，下面的模式，/browse/{word},确定了一个URI路径内的参数。System.Uri实例可以基于这些模式创建或者截取。我们现在将检查我们如何使用System.UriTemplate类来实现这个。
创建URIs
列表13.1显示了我们可以如何创建基于System.UriTemplates类的System.Uri实例的例子。第一个例子使用BindByPosition方法来创建一个System.Uri实例去收集Yahoo!股票价格。第二个例子使用BindByName方法来传递一对键/值来创建一个System.Uri实例去收集Google股票价格。
列表13.1 使用UriTemplate创建参数

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Collections.Specialized;

namespace EssentialWCF
{
class Program
{
static void Main(string[] args)
{
string symbol = "MSFT";

//BindByPosition
Uri YahooStockBaseUri = new Uri("http://finance.yahoo.com");
UriTemplate yahooStockUriTemplate = new UriTemplate("/d/quotes?s={symbol}&f=sl1t1d1");
Uri YhaooStockUri = yahooStockUriTemplate.BindByPosition(YahooStockBaseUri, symbol);
Console.WriteLine(YhaooStockUri.ToString());

//BindByName
Uri GoogleStockBaseUri = new Uri("http://finance.google.com");
UriTemplate GoogleStockUriTemplate = new UriTemplate("/finance/info?q={symbol}");
NameValueCollection GoogleParams = new NameValueCollection();
GoogleParams.Add("symbol", symbol);
Uri GoogleStockUri = GoogleStockUriTemplate.BindByName(GoogleStockBaseUri, GoogleParams);

Console.WriteLine(GoogleStockUri.ToString());
Console.ReadLine();
}
}
}

截取URIs
我们刚刚看了创建基于模式的System.Uri实例是多么简单。列表13.2显示我们如何使用现有的URIs并截取出我们需要的参数。这次也是两个例子。第一个例子显示了我们可以如何截取基于查询字符串参数的参数。第二个例子显示我们如何截取基于一个路径的参数。在这两个例子中，我们可以解析出一系列基于一个模式的名/值对。我们将会在“为站点创建操作”部分看到如何使用UriTemplate来分发基于URIs的网络服务。
列表13.2 使用UriTemplate匹配参数

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace EssentialWCF.UriTemplate2
{
class Program2
{
static void Main(string[] args)
{
Uri YahooStockBaseUri = new Uri("http://finance.yahoo.com");
UriTemplate yahooStockUriTemplate = new UriTemplate("/d/quotes?s={symbol}");
Uri yahooStockUri = new Uri("http://finance.yahoo.com/d/quotes?s=MSFT&f=spt1d");;
UriTemplateMatch match = yahooStockUriTemplate.Match(YahooStockBaseUri, yahooStockUri);

foreach (string key in match.BoundVariables.Keys)
{
Console.WriteLine(String.Format("{0}: {1}", key, match.BoundVariables[key]));
}
Console.WriteLine();

Uri ReferenceDotComBaseUri = new Uri("http://dictionary.reference.com");
UriTemplate ReferenceDotComTemplate = new UriTemplate("/browse/{word}");

Uri referenceDotComUri = new Uri("http://dictionary.reference.com/browse/opaque");
match = ReferenceDotComTemplate.Match(ReferenceDotComBaseUri, referenceDotComUri);

foreach (string key in match.BoundVariables.Keys)
{
Console.WriteLine(String.Format("{0}: {1}", key, match.BoundVariables[key]));
}
Console.ReadLine();
}
}
}