extjs 学习笔记（一） 一些基础知识

我在项目中已经频繁使用了jquery，这次主要是学习使用extjs，但现有的教程基本都是针对2.0的，而且后台用到的语言也很少是.net平台下的C#，所以我打算针对3.0版，后台使用C#，记录下自己的学习过程，希望能和志同道合的朋友一起探讨，共同进步。
extjs的官方网站是http://www.extjs.com，目前最高版本是3.0.2，但是只有3.0.0的才没有任何下载限制，可以点击这里下载3.0版的。下载来的压缩包里边包含压缩后的extjs库，调试时用到的库，具有可读性的源代码，文档和例子。在开始之前，不妨先看下examples文件夹下的例子，对extjs有一个感性的认识，如果你觉得例子里边的效果让你心动，那么就一起开始extjs的学习之旅吧。
首先明确下我们需要引用的文件，包括adpter/ext/ext-base-debug.js,ext-all-debug.js和整个resource文件夹，当然，多数情况下，我们还需要ext-lang-zh_CN.js进行中文的本地化，该文件在src/locale目录下。因为是学习阶段，所以我们使用了debug版本，在实际的项目中，发布的时候要使用压缩后的版本以减小文件体积。接下来，我们就秉承编程界的一贯传统，开始我们的第一个Hello world程序。
新建一个文本文件，文件名改为Hello.htm，用文本编辑器打开，写下如下代码：

Hello.htm


代码如下:

<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<title>Extjs hello world dialog</title>
<link rel="stylesheet" type="text/css" href="extjs/resources/css/ext-all.css" />
<script type="text/javascript" src="extjs/ext-base-debug.js"></script>
<script type="text/javascript" src="extjs/ext-all-debug.js"></script>
<script type="text/javascript" src="extjs/ext-lang-zh_CN.js"></script>
<script type="text/javascript" src="js/daben.js"></script>
</head>
<body>
<div id="hello"></div>
</body>
</html>

daben.js的内容如下：


代码如下:

/**//*
*作者：大笨
*日期：2009-10-10
*版本：1.0
*/
Ext.onReady(function(){
Ext.MessageBox.alert("信息","Hello world");
});

使用ie或者ff打开Hello.htm，可以看到一个弹出的对话框，和js的alert对话框一样，但是漂亮了许多。
我们看看代码，在html页面中首先引用extjs的相关库文件，注意引用顺序，接下来是引用我们自己的js文件。我们简单看下，Ext.onReady是在文档加载完之后触发的，它有一个参数是一个函数类型，该函数在事件出发的时候被调用。在这里我们用了匿名的函数，当然也可以把函数在外部定义好，然后把函数的名字作为参数传递进来。Ext.MessageBox.alert是一个弹出消息的对话框函数，第一个参数是标题，第二个参数是对话框的内容。Ext.Message类下还有模拟js的prompt对话框和comfirm对话框的方法，我们改动下daben.js看看confirm方法的效果：


代码如下:

Ext.onReady(function(){
//Ext.MessageBox.alert("信息","Hello world");
Ext.MessageBox.confirm("comfirm","模拟js的comfirm对话框",function(btn){
alert("点击了"+btn+"按钮");
});
});

光看对话框并不是很有趣，实际的web程序中，需要向服务器提交数据并根据服务器的响应来更新页面中的内容，我们来看看extjs是如何实现的。下边的例子中，我们将在页面上放置一个编辑框和一个按钮，当点击按钮之后，服务器将编辑框中输入的内容转化为大写并显示在页面的一个div中。打开vs2008，新建一个web应用程序ExtjsDemo，删掉自动添加的default.aspx文件。添加我们的hello.htm和daben.js文件以及我们要用到的extjs库，添加完成后如图所示：

可以看到在js目录下边，加了一个vvswd-ext_2.0.2.js的文件，从这里可以下载，这个文件可以实现vs2008对于extjs库的智能提示，方便编程（不过我没找到针对3.0版的，如果哪位朋友找到了麻烦发一份给我）。我们先来看下extjs中实现和服务器端通信的一个函数Ext.Ajax.request，该函数接受一个json对象作为参数，该对象有几个常用的属性:
    url:字符串类型，指明请求的地址
    params:请求时传递给服务器段的参数，可以是对象，字符串
    method:请求的方法，字符串类型，“GET"或者"POST"，注意必须是大写的
    success:函数类型，请求成功后会执行的函数，该函数有一个参数，是一个包含服务器端响应数据的XMLHttpRequest 对象
    failure:函数类型，请求失败后会执行的函数，该函数有一个参数，是一个包含服务器端响应数据的XMLHttpRequest 对象
    callback:函数类型，无论请求的结果如何都会执行
    好，我们就具体来看看extjs是如何实现和服务器端的交互吧。先把我们的hello.htm页面做如下改动：


代码如下:

<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<title>Extjs hello world dialog</title>
<link rel="stylesheet" type="text/css" href="extjs/resources/css/ext-all.css" />
<script type="text/javascript" src="extjs/ext-base-debug.js"></script>
<script type="text/javascript" src="extjs/ext-all-debug.js"></script>
<script type="text/javascript" src="extjs/ext-lang-zh_CN.js"></script>
<script type="text/javascript" src="js/daben.js"></script>
</head>
<body>
<input type="text" id="txt" /><input type="button" id="btn" value="提交" />
<div id="div"></div>
</body>
</html>

然后是更改我们的daben.js文件了，改动之后的代码如下：


代码如下:

///<reference path="vswd-ext_2.0.2.js" />
/**//*
*作者：大笨
*日期：2009-10-10
*版本：1.0
*/

Ext.onReady(function() {
//Ext.MessageBox.alert("信息","Hello world");
/**//*Ext.MessageBox.confirm("comfirm","模拟js的comfirm对话框",function(btn){
alert("点击了"+btn+"按钮");
});*/
Ext.get("btn").on("click", function() {
var data = Ext.fly("txt").getValue();
if (data == "") {
Ext.Msg.alert("警告", "请输入字符串");
}
else {
Ext.Ajax.request({
url: "hello.aspx",
params: { data: data },
method: "POST",
success: function(response) {
Ext.fly("div").update(response.responseText);
},
failure: function(response) {
Ext.Msg.alert("错误", "请求失败，错误代码为：" + response.status);
}
});
}
});
});

我们来简单分析下这个文件：第一行是为了使用vs的智能提示，注意把路径写对，而且必须要加在第一行。Ext.onReady已经介绍过了，Ext.fly是Ext.Element.fly的简写，该方法可以根据id获得Element对象，Element类是Ext中一个非常重要的类，它对Dom进行了封装，增加了一些操作以方便使用，并且兼容主流浏览器。getValue是Element类的方法，获得元素的值，比较郁闷的是没有相应的setValue方法，所以在后边使用了update方法来更新元素的值。在向服务器端传值之前进行客户端的验证是一个良好的编程习惯，这里只是简单进行了字符串不为空的验证，然后就使用了前边说到的Ext.Ajax.request方法了，使用这个方法向页面hello.aspx以post方式发送了数据，我们这里是以json对象的形式发送的，也可以写成字符串形式，对于成功的响应，把响应的文本显示在div中，对于失败的响应，弹出一个对话框并且给出了错误码。
接下来要进行服务器端的编程了。服务器端可以通过两种方式接受客户端传递过来的数据并且作出响应：使用aspx页面和web服务。我们先介绍如何使用aspx页来进行处理。在项目中增加一个页面Hello.aspx，把页面中除了第一行的页面处理指令部分<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Hello.aspx.cs" Inherits="ExtjsDemo.hello" %>全部删去。按下F7切换到代码页，开始编写后台的代码。我们首先通过Request.Params["data"]来获取前台传递过来的数据，同样，在对数据进行处理之前我们先进行数据的有效性验证，这里只是简单判断了是否为空或者空字符串，然后我们就将处理后的结果用Response.Write方法发送给客户端。后台代码如下：


代码如下:

using System;

/**//*
*作者：大笨
*日期：2009-10-10
*版本：1.0
*/
namespace ExtjsDemo
{
public partial class Hello : System.Web.UI.Page
{
页面加载#region 页面加载
/**//// <summary>
/// 页面加载
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
protected void Page_Load(object sender, EventArgs e)
{
string data = Request.Params["data"];
if(!string.IsNullOrEmpty(data))
{
Response.Write(data.ToUpper());
}
}
#endregion
}
}

运行后在编辑框输入字符串，可以看到在下边的div里边以大写的形式显示了出来，通过FF的Firebug我们可以看到数据的交互。
除了使用aspx页面来接受并处理客户端传递过来的数据，我们还可以使用web服务的方式来进行。在项目中添加一个web服务，代码如下：


代码如下:

using System;
using System.Web.Services;

/**//*
*作者：大笨
*日期：2009-10-10
*版本：1.0
*/

namespace ExtjsDemo
{
/**//// <summary>
/// HelloService 的摘要说明
/// </summary>
[WebService(Namespace = "http://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
[System.ComponentModel.ToolboxItem(false)]
// 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务，请取消对下行的注释。
// [System.Web.Script.Services.ScriptService]
public class HelloService : System.Web.Services.WebService
{
将传入的字符串改为大写#region 将传入的字符串改为大写
/**//// <summary>
/// 将传入的字符串改为大写
/// </summary>
/// <param name="data">需要转为大写的字符串</param>
/// <returns>大写字符串</returns>
[WebMethod]
public string ToUpper(string data)
{
if(!string.IsNullOrEmpty(data))
return data.ToUpper();
throw new Exception("字符串不能为空！");
}
#endregion
}
}

当然，默认情况下，web服务是以xml格式来传递数据的，我们可以通过Firebug看到。xml很好很强大，不过有时我们只需要更小巧的json就足够了，那么如何让web服务传递的是json格式呢？我们只需要把请求头中的Content-Type设置为application/json并且把参数使用Ext.util.JSON.encode进行编码或者使用jsonData来代替params.