今天碰巧，用到了淘宝的在线IP地址查询的Rest API，它提供接口给用户查询IP地址的归宿地。数据库比较庞大，准确性也比较高。地址为：http://ip.taobao.com/instructions.php。
这是一个GET请求的接口，使用方式很简单，只要将这个URL复制到浏览器的地址栏就可以了。
可以看到接口返回的是一串JSON格式的字符串。关于如何解析JSON，参考我的这篇博文：http://blog.csdn.net/chinacsharper/article/details/9246627。
那么如何在程序中实现呢？我们新建一个控制台应用程序，并键入如下代码：
namespace RestServiceApp
{
class Program
{
static void Main(string[] args)
{
string url = "http://ip.taobao.com/service/getIpInfo.php?ip=210.75.225.254";
HttpWebRequest request = (HttpWebRequest)WebRequest.CreateDefault(new Uri(url));
WebResponse response = request.GetResponse();
StreamReader reader = new StreamReader(response.GetResponseStream());
Console.WriteLine(reader.ReadToEnd());
}
}
}
运行它可以看到：
关于如何解码\u4e2d\u56fd这样的字符串，可以参考我的这篇博文：http://blog.csdn.net/chinacsharper/article/details/9885165。
好了，如何调用这个淘宝IP地址的接口就到这，不过我由此想到了两个东西，一个是WCF Rest，一个是ASP.NET MVC中的Rest Api，这里先介绍一下WCF Rest。
我们在前文也简单的讲解过如何使用WCF，WCF最关键的要素就是A（Address地址）、B（Binding绑定）、C（Contract契约）。为了便于演示，我们直接用控制台应用程序作为WCF Rest的宿主程序，先建立一个类库项目，里面的代码如下。
namespace Service.Interface
{
[ServiceContract]
public interface IAddress
{
[WebGet(UriTemplate = "ip={ip}")]
Address Get(string ip);
} [DataContract]
public class Address
{
[DataMember]
public string IPAddress { get; set; } [DataMember]
public string Province { get; set; } [DataMember]
public string City { get; set; }
}
}
很简单，就是定义了一个契约，用于获取IP地址信息。需要说明一下，这个项目需要引用System.ServiceModel和System.Runtime.Serialization这两个dll。
接下来就是要创建一个WCF Rest服务端程序，用以提供服务。
先定义一个类AddressService，并实现我们刚刚定义的IAddress接口。
namespace Service
{
public class AddressService : IAddress
{
private static IList<Address> addresses = new List<Address>(); static AddressService()
{
//这里可以准备一个IP地址库并放入到IP地址列表中，以提供数据服务
addresses.Add(new Address() { IPAddress = "210.75.225.254", Province = "上海市", City = "上海市" });
} public Address Get(string ipAddress)
{
return addresses.FirstOrDefault(x => x.IPAddress == ipAddress);
}
}
}
接着在App.config配置文件中添加配置信息。
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
</startup> <system.serviceModel>
<services>
<service name="Service.AddressService">
<endpoint address="http://127.0.0.1:8888/addresses"
binding="webHttpBinding"
contract="Service.Interface.IAddress"/>
</service>
</services>
</system.serviceModel>
</configuration>
最后在Main方法中添加如下代码。
namespace Service
{
class Program
{
static void Main(string[] args)
{
using (WebServiceHost host = new WebServiceHost(typeof(AddressService)))
{
host.Open();
Console.Read();
}
}
}
}
然后我们就可以运行这个控制台项目了。注意：运行程序时，请确保你当前的用户为操作系统管理员用户。
服务端准备好，我们写一下客户端的调用代码，在控制台应用程序中测试一下这个WCF Rest服务。
同样的，我们需要先在客户端的App.config文件中配置一下这个服务（也可以在代码中通过硬编码的方式进行）。
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
</startup>
<system.serviceModel>
<client>
<endpoint name="addressService"
address="http://127.0.0.1:8888/addresses"
binding="webHttpBinding"
contract="Service.Interface.IAddress" />
</client>
</system.serviceModel>
</configuration>
这里要注意，绑定模型要跟服务端模型一致，否则会有绑定不匹配的异常产生。
客户端代码：
namespace RestServiceApp
{
class Program
{
static void Main(string[] args)
{
using (ChannelFactory<IAddress> channelFactory = new ChannelFactory<IAddress>("addressService"))
{
IAddress iAddress = channelFactory.CreateChannel();
Address address = iAddress.Get("210.75.225.254"); if (address != null)
{
Console.WriteLine(string.Format("IP来自{0}，{1}",address.Province,address.City));
}
}
}
}
}
保证之前建立的服务端程序在运行状态，然后我们运行一下这个客户端程序：
可以看到，我们调用WCF Rest服务成功的获得了IP地址的详细信息。
既然是Get请求型的Rest服务，那么应该可以在浏览器中直接调用，我们打开浏览器输入地址。
同样的获得了XML类型的数据。
那如果我们想提供JSON格式的数据给别人呢？很简单，只要在定义接口方法时，指定数据返回的格式即可。
[ServiceContract]
public interface IAddress
{
[WebGet(UriTemplate = "ip={ip}", ResponseFormat = WebMessageFormat.Json)]
Address Get(string ip);
}
看到这里，你是否觉得Rest非常简单易用呢?