Atlas快速入门之实战Atlas

   新近编译了一篇老外的作品,觉得对ATLAS的入门还不错，故翻译之，发表在
http://dev.yesky.com/msdn/488/2586488.shtml上，现全文转到这里

   随着ajax技术的出现，web 2.0时代已经来临，目前已经涌现了大量的web 2.0的网站，比如live.com,fclickr相册网站，google Map等等。那什么是ajax呢？AJAX技术其实是旧瓶装新酒了，它使用了异步JavaScript+XML。这种技术首先由微软在1999年引入，并以"使用远程调用的DHTML/JavaScript web应用程序"著称。这一技术的基本思想是，允许一个互联网浏览器向一个远程页面/服务作异步的HTTP调用，并且用收到的结果更新一个当前web页面而不必刷新整个页面。根据这种技术创建者的意见，这种技术应能够改进客户端的体验，使得HTTP页面外观与使用感觉很类似于Windows桌面应用程序。

　　目前，已经涌现出了不少关于ajax的技术框架。而在.net 方面，也有不少开源的框架，如ajax.net,magic ajax等。而微软也推出了自己的ajax框架----Atlas，目前的版本是6月份的CTP版本。在Atlas中，已经封装好了大量的ajax控件和功能，十分方便。本文中将以两个实例来说明如何使用Atlas来实现两个简单的ajax应用。

　　首先，我们要下载atlas,可以到 http://atlas.asp.net上去下载atlas的相关安装文件。我们先来看一个简单的例子，在这个例子中，
我们通过asp.net 2.0中的日历控件来说明如何使用atlas.先打开vs.net 2005,选择"新建web站点",如下图，这时会发现有"Atlas web site"的模版，这时我们可以输入要创建应用的名称，这里我们就用默认的名称AtlasWebSite1。
     

在方案解决器中，你会发现vs.net 2005已经预先放置了一些文件，其中，在bin文件夹下包含了Microsoft.Web.Atlas.dll文件，这是支持ajax功能的文件。为了能在设计中使用到ajax控件，必须在TOOLS工具箱中添加一个新的选项卡，命名为Atals,然后右键点击该选项卡，在弹出的菜单中选择"choose item",然后用浏览的功能，选择atals.dll文件，这样，就添加了一系列的Atals控件，如下图：
 

    我们将其中的ScriptManager控件拖拉到页面中去。ScriptManager控件可以看作是管理Atlas控件的集合，它用来处理页面上的所有Atlas组件以及局部页面的更新，生成相关的客户端脚本，所有需要支持Atlas的ASP.NET页面上有且只能有一个ScriptManager控件。在ScriptManager控件中我们可以指定需要的脚本库，或者指定通过JS来调用的Web Service，还可以指定页面错误处理等。

　　接着，我们拖拉一个日历控件到页面中去，放在刚才scriptmanager控件的下面，并且选择一个喜欢的样式，如下图所示：
 
  

    接下来，我们看下如何在这个日历控件中使用ajax技术。在.net 的日历控件中，人们经常抱怨的是，每次选定日历上的一个日期，都会引发一次postback页面回传，需要用户等待，十分不方便。下面，我们通过Atals控件，来对日历控件进行改造。

　　在default.aspx页中，切换到代码视图，在之前的＜atlas:ScriptManager＞控件中，加入EnablePartialRendering属性，以使得atlas可以对页面进行局部更新，如下所示

      ＜atlas:ScriptManager ID="ScriptManager1" runat="server"
EnablePartialRendering="true" /＞
    增加一个＜UpdatePanel＞控件，UpdatePanel是Atlas中一个很重要的控件，功能强大容易使用，可以只做很小的改动就可以向已有的ASP.NET站点添加Ajax功能,我们再将日历控件拖拉放到updatepanel控件中去，其中要注意到，日历控件是放到＜ContentTemplate＞的标签内的，该标签内放的就是受UpdatePanel控制的控件，如下代码所示：

＜atlas:UpdatePanel ID="id1" runat="server"＞ ＜ContentTemplate＞ ＜asp:Calendar ID="Calendar1" runat="server" BackColor="#FFFFCC" ... /＞ ＜/asp:Calendar＞ ＜/ContentTemplate＞ ＜/atlas:UpdatePanel＞

　　为了更好地看到效果，我们增加两个下拉选择框，可以让用户选择年份和月份，代码如下所示

＜form id="form1" runat="server"＞ ＜atlas:ScriptManager ID="ScriptManager1" runat="server" EnablePartialRendering="true" /＞ ＜asp:DropDownList ID="DropDownList1" runat="server" AutoPostBack="True"＞ 　＜asp:ListItem Value="1"＞Jan＜/asp:ListItem＞ 　＜asp:ListItem Value="2"＞Feb＜/asp:ListItem＞ 　＜asp:ListItem Value="3"＞Mar＜/asp:ListItem＞ 　＜asp:ListItem Value="4"＞Apr＜/asp:ListItem＞ 　＜asp:ListItem Value="5"＞May＜/asp:ListItem＞ 　＜asp:ListItem Value="6"＞Jun＜/asp:ListItem＞ 　＜asp:ListItem Value="7"＞Jul＜/asp:ListItem＞ 　＜asp:ListItem Value="8"＞Aug＜/asp:ListItem＞ 　＜asp:ListItem Value="9"＞Sep＜/asp:ListItem＞ 　＜asp:ListItem Value="10"＞Oct＜/asp:ListItem＞ 　＜asp:ListItem Value="11"＞Nov＜/asp:ListItem＞ 　＜asp:ListItem Value="12"＞Dec＜/asp:ListItem＞ ＜/asp:DropDownList＞ Year ＜asp:DropDownList ID="DropDownList2" runat="server" AutoPostBack="True"＞ ＜asp:ListItem＞2005＜/asp:ListItem＞ ＜asp:ListItem＞2006＜/asp:ListItem＞ ＜asp:ListItem＞2007＜/asp:ListItem＞ ＜/asp:DropDownList＞＜br /＞

　　然后在code-behind的代码中，写入如下代码：

Protected Sub DropDownList1_SelectedIndexChanged( _ ByVal sender As Object, _ ByVal e As System.EventArgs) _ Handles DropDownList1.SelectedIndexChanged With Calendar1 .VisibleDate = New Date( _ DropDownList2.SelectedValue, _ DropDownList1.SelectedValue, 1) End With End Sub Protected Sub DropDownList2_SelectedIndexChanged( _ ByVal sender As Object, _ ByVal e As System.EventArgs) _ Handles DropDownList2.SelectedIndexChanged With Calendar1 .VisibleDate = New Date( _ DropDownList2.SelectedValue, _ DropDownList1.SelectedValue, 1) End With End Sub

　　在上面的代码中，分别为月份和年份的下拉选择框的selectedindexchanged事件写入了代码，主要是控制当用户选择了月份和年份时，日历控件中显示相应的日期。但当我们F5运行时，会发觉页面依然会引起postback刷新的。因此，我们要定义触发器triggers。

　　所谓的触发器，指定了发生动作的事件源，UpdatePanel提供两种引发异步PostBack的Trigger ，分别是ControlEventTrigger和ControlEventTrigger。其中ControlEventTrigge是指当某个控件的某个指定的属性变化时更新，而ControlEventTrigger是指当指定的事件发生时进行更新。则我们修改代码如下：

＜atlas:UpdatePanel ID="id1" runat="server"＞ ＜ContentTemplate＞ ＜asp:Calendar ID="Calendar1" runat="server" BackColor="#FFFFCC" ... /＞ ＜/asp:Calendar＞ ＜/ContentTemplate＞ ＜Triggers＞ ＜atlas:ControlValueTrigger ControlID="DropDownList1" PropertyName="SelectedValue" /＞ ＜atlas:ControlEventTrigger ControlID="DropDownList2" EventName="SelectedIndexChanged" /＞ ＜/Triggers＞ ＜/atlas:UpdatePanel＞

　　这里，分别指定了月份下拉框的属性触发器和年份下拉框的事件触发器，使得无论当用户选择哪一个下拉框时，都会引发局部的刷新，而这些刷新全部都通过updatepanel控件来封装进行处理了。所以当运行程序时，页面不会象以前那样要进行一次postback和整体页面的刷新。

　　最后，我们再在日历控件下面，增加一个进度状态条控件UpdateProgress，用来向用户反映当前的进度，代码如下所示

＜atlas:UpdateProgress ID="pro" runat="server"＞ ＜ProgressTemplate＞ ＜asp:Label ID="Label1" runat="server" Text="Label"＞ Updating Calendar... ＜/asp:Label＞ ＜/ProgressTemplate＞ ＜/atlas:UpdateProgress＞

　　要注意的是，上面我们在进度状态控件的＜ProgressTemplate＞中，我们只是简单加入了一个标签控件，如果有实际需要的话，我们是可以加入 图片的。

　　到此，我们的程序大功告成了，运行这个日历程序，选择月份和年份下拉框，会看到日历控件没有象以前那样引起整个页面的刷新，而是很快在日历控件中显示出相应的日期。

    为了加深对Atlas的认识，我们再举一个例子来说明问题。我们的这个应用，将是在一个页面中，提供给用户能通过点选分类主题按钮的方式，获得站点上最新的新闻，这是通过读取站点上的RSS的形式来进行的。

　　我们首先新建另外的一个页面，其中也放入scriptmanager控件，接着我们要设计一个简单的页面了。比如添加一个好看的BANNER在页面头部，并且为了显示加载的进度，这次我们添加一个有Loading…动画的GIF，再建立一个一行两列的大表格，在表格的左边，放入若干个按钮。比如这里我们根据每个技术专题，放入了十个按钮。

　　然后再拖放一个xmldatasource控件到窗体中，因为我们要读取网站上的RSS XML文件进行解析。在表格的右边，放入一个DataList控件，并且将这个DataList控件绑定到xmldatasource控件中去。最后，大致的界面图如下所示：


   接下来对XMLDATASOURCE控件进行设置。我们点选控件右上方的智能感知功能，在弹出的窗口中的XPATH里，选择Xpath Expression,在这里，我们填入"rss/channel/item"。要注意的是，由于我们想浏览的网站提供的RSS 的XML文件里，我们只对每个频道的最新信息感兴趣，因此我磨恩这样填写，而完整的该网站的RSS信息在http://services.devx.com/outgoing/devxfeed.xml可以看到。最后，我们的页面前端代码如下所示：

＜atlas:UpdatePanel ID="id1" runat="server"＞ ＜ContentTemplate＞ ＜asp:Label ID="Label1" runat="server" Text="Label" Font-Bold="True"＞＜/asp:Label＞ ＜atlas:UpdateProgress ID="pro" runat="server"＞ ＜ProgressTemplate＞ ＜asp:Image ID="Image1" runat="server" ImageUrl="~/loading.gif" /＞ ＜/ProgressTemplate＞ ＜/atlas:UpdateProgress＞ ＜asp:DataList ID="DataList1" runat="server" BackColor="LightGoldenrodYellow" BorderColor="Tan" BorderWidth="1px" CellPadding="2" ForeColor="Black" Width="755px"＞ ＜FooterStyle BackColor="Tan" /＞ ＜SelectedItemStyle BackColor="DarkSlateBlue" ForeColor="GhostWhite" /＞ ＜AlternatingItemStyle BackColor="PaleGoldenrod" /＞ ＜HeaderStyle BackColor="Tan" Font-Bold="True" /＞ ＜ItemTemplate＞ ＜b＞ ＜%#XPath("title")%＞ ＜/b＞ ＜br /＞ ＜i＞ ＜%#XPath("description") %＞ ＜/i＞ ＜%#XPath("pubDate")%＞ ＜br /＞ ＜a href='＜%#XPath("link") %＞'＞Link＜/a＞ ＜br /＞ ＜br /＞ ＜/ItemTemplate＞ ＜/asp:DataList＞ ＜asp:XmlDataSource ID="XmlDataSource1" runat="server" XPath="rss/channel/item"＞＜/asp:XmlDataSource＞ ＜/ContentTemplate＞ ＜Triggers＞ ＜atlas:ControlEventTrigger ControlID="Button1" EventName="Click" /＞ ＜atlas:ControlEventTrigger ControlID="Button2" EventName="Click" /＞ ＜atlas:ControlEventTrigger ControlID="Button3" EventName="Click" /＞ ＜atlas:ControlEventTrigger ControlID="Button4" EventName="Click" /＞ ＜atlas:ControlEventTrigger ControlID="Button5" EventName="Click" /＞ ＜atlas:ControlEventTrigger ControlID="Button6" EventName="Click" /＞ ＜atlas:ControlEventTrigger ControlID="Button7" EventName="Click" /＞ ＜atlas:ControlEventTrigger ControlID="Button8" EventName="Click" /＞ ＜atlas:ControlEventTrigger ControlID="Button9" EventName="Click" /＞ ＜atlas:ControlEventTrigger ControlID="Button10" EventName="Click" /＞ ＜atlas:ControlEventTrigger ControlID="Button11" EventName="Click" /＞ ＜/Triggers＞ ＜/atlas:UpdatePanel＞ ...

　　在上面的代码中，我们除了为每一个button按钮都设置了事件触发器外，还在DataList控件中，通过＜%#XPath("description") %＞的方式，将读取并分析好的XML文件绑定显示出来。下面，我们就开始撰写后端的处理读取到的RSS XML文件的代码。
    首先，由于要处理XML，读取网站上的资源，所以要引入如下几个命名空间

Imports System.Net Imports System.IO Imports System.Xml

　　当用户点选某个分类主题的按钮时，将会自动下载该网站中符合主题的RSS XML文件，下载完后再进行解析，再显示到页面中去。代码如下：

Public Function SendRequest( _ ByVal URI As String, _ ByVal requestType As String) As HttpWebRequest Dim req As HttpWebRequest = Nothing Try //发起HTTP请求 req = HttpWebRequest.Create(URI) req.Method = requestType Catch ex As Exception Throw New Exception("Error") End Try Return req End Function Public Function GetResponse( _ ByVal req As HttpWebRequest) As String Dim body As String = String.Empty Try //从服务器中获得响应输出流 Dim resp As HttpWebResponse = req.GetResponse() Dim stream As Stream = resp.GetResponseStream() //使用streamreader去处理得到的服务器响应 Dim reader As StreamReader = _ New StreamReader(stream, Encoding.UTF8) body = reader.ReadToEnd() stream.Close() Catch ex As Exception Throw New Exception("Error") End Try Return body End Function

　　上面的两个方法，分别向网站服务器发出获取指定URL的信息的请求，并用IO流中的streamreader的方式获得服务器返回的输出信息。而下面的LoadRSS()方法，传入的参数是指定的URL地址，然后分别调用上面的两个方法，在最后获得服务器返回的输出流后，再通过解析XML的方式，选择合适的结点内容进行返回。代码如下：

Public Function LoadRSS( _ ByVal URI As String) As String Dim req As HttpWebRequest Dim xmlDoc As XmlDocument = Nothing Try XmlDataSource1.DataFile = URI //下载RSS XML文件 req = SendRequest(URI, "GET") Dim xmlData As String = GetResponse(req) xmlDoc = New XmlDocument() xmlDoc.LoadXml(xmlData) //选择合适的结点 Dim titleNode As XmlNode = _ xmlDoc.DocumentElement.SelectSingleNode("channel/title") Return titleNode.InnerText Catch ex As Exception 　Return String.Empty End Try End Function

　　接着，我们还有为10多个按钮编写响应的事件，当点选了某个分类主题的按钮后，则向服务器请求指定的分类主题的RSS XML，代码如下：

Public Sub Button_Click( _ ByVal sender As Object, ByVal e As System.EventArgs) _ Handles Button1.Click, Button2.Click, Button3.Click, _ Button4.Click, Button5.Click, Button6.Click, _ Button7.Click, Button8.Click, Button9.Click, _ Button10.Click, Button11.Click Dim URL As String = String.Empty Select Case CType(sender, Button).Text Case "Database" : URL = _ "http://services.devx.com/outgoing/databasefeed.xml" Case ".NET" : URL = _ "http://services.devx.com/outgoing/dotnet.xml" Case "C++" : URL = _ "http://services.devx.com/outgoing/cplusfeed.xml" Case "Recent Tips" : URL = _ "http://services.devx.com/outgoing/recentTipsFeed.xml" Case "Web Dev" : URL = _ "http://services.devx.com/outgoing/webdevfeed.xml" Case "Latest" : URL = _ "http://services.devx.com/outgoing/devxfeed.xml" Case "Enterprise" : URL = _ "http://services.devx.com/outgoing/enterprisefeed.xml" Case "Wireless / Mobile" : URL = _ "http://services.devx.com/outgoing/wirelessfeed.xml" Case "XML" : URL = _ "http://services.devx.com/outgoing/xmlfeed.xml" Case "Java" : URL = _ "http://services.devx.com/outgoing/javafeed.xml" Case "Open Source" : URL = _ "http://services.devx.com/outgoing/openSourceFeed.xml" End Select Label1.Text = LoadRSS(URL) End Sub

　　最后，在LOAD事件中,默认读取最新信息的RSS XML

Protected Sub Page_Load( _ ByVal sender As Object, _ ByVal e As System.EventArgs) Handles Me.Load Label1.Text = _ LoadRSS("http://services.devx.com/outgoing/devxfeed.xml") End Sub

　　运行后效果如下图所示,点选左边每个分类主题的按钮，都会自动去该网站下载最新的RSS XML 并且进行解析，最后展示到页面中去，而这一切都由于用了Atlas而是无刷新的。