Windows Azure Marketplace入门教学-通过代码操作DataMarket数据源
Windows® AzureMarketplace （先前名为"Dallas"，本博客也写过一篇入门教学"初探Dallas"）的DataMarket是一个信息市场，简化了发布以及使用各种类型数据的步骤。DataMarket方便开发者和信息工作者发现，购买以及管理所订购的Premium数据。
DataMarket 内的数据的暴露格式为OData，并对于数据查询提供了2种模式：
- Flexible 查询：允许用户添加可选的名值对参数来查询数据，例如 (columnName=foo) 等。
- Fixed 查询：用户只能通过内容提供商所预定义的操作来进行数据查询。
本文会简单的介绍一下如何利用Windows Azure Marketplace构建一个Flexible查询的应用。
预备工作：
- 1. 一个有效的Windows Live ID 账户，如果没有，请通过Windows Live主页注册 。
- 2. 一个有效的DataMarket 账户。如果没有，请访问Windows Azure Marketplace DataMarket，用您的Live ID登陆。接受若干使用条款之后，便会拥有一个与Live ID绑定的DataMarket账户。
- 3. 在Account Keys页面获取您的Account Keys，这是您使用服务的凭证。
- 4. 访问 DataMarket 的数据源列表页面，列出了所有DataMarket内的数据源，选择感兴趣的数据源，点击，进入数据源的详细页面。在该页面的右侧，点击Sign Up按钮来订购该数据源（一般都为免费数据源）。接受若干使用条款后，我们便完成了数据源的订购。
- 5. 我们订购2006 - 2008 Crime in the United States 服务以作后续项目演示之用。
代码：
步骤1：在Visual Studio中创建新项目
以管理员权限运行Visual Studio
- 1. 以管理员权限运行Visual Studio
创建新项目
- 1.新建Visual C# Console应用。
- 2. 将项目的目标框架选（Target Framework）为 .NET Framework 4。
- 3. 将项目命名为USCrime2006and2007。
- 4. 点击OK 按钮。
步骤2：为项目添加服务引用
获取服务的根 URL
- 1. 访问Windows Azure Marketplace DataMarket首页，并以Live ID 登陆。
- 2. 点击My Data标签页。
- 3. 找到2006 - 2008 Crime in the United States数据服务。
- 4. 点击该服务列表内右侧的Use链接。
- 5. 将网页拖至页面中部，点击Details标签页。
- 6. 找到该服务的根URL。
为项目添加服务引用
- 1. 右击步骤1中的项目，选择Add Service Reference... 。
- 2. 将上步的URL输入至对话框的地址栏内。点击Go 按钮。
- 3. 将该服务的命名空间设为DataGovCrimes。
- 4. 点击OK按钮。
在代码中添加服务引用
- 1. 打开项目的Program.cs文件。
- 2. 在文件内加入如下引用语句：
using USCrime2006and2007.DataGovCrimes;
步骤 3:用托管代码来使用数据
创建一个辅助类
- 1. 创建一个公有类，名为
CrimeData`` 。 - 2. 为该类增加2个私有变量：
- 一个表示服务的根URL。
- 一个存储了服务上下文中服务凭证的服务容器。
class CrimeData
{
private Uri serviceURI;
private datagovCrimesContainer context;
}
- 3. 为
CrimeData创建一个构造函数。构造函数初始化私有变量以及用户凭证。
class CrimeData
{
private Uri serviceURI;
private datagovCrimesContainer context;
// constructor for the CrimeData class
public CrimeData()
{
serviceURI = new Uri(ROOT_URL);
context = new datagovCrimesContainer(serviceURI);
context.Credentials = new NetworkCredential(USER_ID,
SECURE_ACCOUNT_ID);
}
}
ROOT_URL 是上文所提到的服务的根URL。
USER_ID 是您的 Live ID账户名。
SECURE_ACCOUNT_KEY 您在DataMarket 内的Account Keys （参考预备工作章节）。
- 4. 创建一个返回泛型类型为
CityCrime的泛型列表的共有方法。
class CrimeData
{
private Uri serviceURI;
private datagovCrimesContainer context;
// constructor for the CrimeData class
public CrimeData()
{
serviceURI = new Uri(ROOT_URL);
context = new datagovCrimesContainer(serviceURI);
context.Credentials = new NetworkCredential(USER_ID,
SECURE_ACCOUNT_ID);
}
// -- public method that returns the list of crime data
public IList<CityCrime> GetCrimeData()
{
IEnumerable<CityCrime> query = context.CityCrime.Where(crime => crime.City == "Newport").OrderBy(crime => crime.Year);
try
{
return query.ToList();
}
catch (Exception ex)
{
Console.WriteLine("Error: {0}", ex.Message);
return null;
}
}
}
该查询可以是任何有效的DataMarket LINQ 查询，可以包括可选的where (Where) 或者是orderby (Order By)方法。
- 5. 在
Main()函数中用CrimeData类，以及GetCrimeData()方法来使用数据，并显示函数返回的结果。
static void Main(string[] args)
{
IList<CityCrime> crimeList; // CityCrime is the entity type returned by the service
CrimeData crimeData = new CrimeData();
crimeList = crimeData.GetCrimeData();
if (crimeList != null)
{
Console.WriteLine("{0,4} {1,-12} {2,-15} {3,10} {4,13}","Year",
"City",
"State",
"Population",
"Violent Crime");
foreach (CityCrime c in crimeList)
Console.WriteLine("{0,4} {1,-12} {2,-15} {3,10} {4,13}", c.Year,
c.City,
c.State,
c.Population,
c.ViolentCrime);
}
Console.Write("Tap any key to exit. ");
Console.ReadKey();
}
- 6. 运行程序，在Console中会显示操作返回的结果。
总结：
我们看到在代码方便对于数据源的使用是非常简单的，开发者可以结合实际应用的需求，轻松的将应用与这些实时的数据源相集成，构建出具有丰富内容的应用来。