【IT168技术文档】
一、 简介
    ASP.NET AJAX框架的身份认证服务能够与ASP.NET 2.0的身份认证应用程序服务集成起来，并为其提供客户端的JavaScript调用代理。ASP.NET AJAX客户端部分身份认证代理的相关功能统一由客户端Sys.Services.AuthenticationService类提供。

    Sys.Services.AuthenticationService是一个静态类，定义于MicrosoftAjax.js文件中，通过调用该类中的方法，我们能够间接地使用ASP.NET 2.0内置的MemberShip应用服务来实现用户的身份认证并使用提供的身份认证的相关功能，例如用户登录和注销等。在后台方面，由ASP.NET AJAX框架将负责整个异步通讯的实现细节。通过这种方法，开发者可以沿用ASP.NET 2.0中的标准用户认证系统。

    在本文中，我们将对Sys.Services.AuthenticationService类的公共成员作全面分析，并给出应用注意事项。在下篇中，我们将给出一个具体的应用案例。

二、 AuthenticationService具体成员分析
首先，让我们使用Eilon Lipton编写的ASP.NET AJAX客户端JavaScript类浏览器来浏览这个类的轮廓信息：
internal class Sys.Services._AuthenticationService : Sys.Net.WebServiceProxy {
// Constructor
public Sys.Services._AuthenticationService();
// Fields
public static Object DefaultWebServicePath;
private static Boolean __class;
private static String __typeName;
private Object _authenticated;
private Object _defaultFailedCallback;
private Object _defaultLoginCompletedCallback;
private Object _defaultLogoutCompletedCallback;
private Object _path;
private Object _timeout;
// Properties
public override Object defaultFailedCallback { get; set; };
public Object defaultLoginCompletedCallback { get; set; };
public Object defaultLogoutCompletedCallback { get; set; };
public Object isLoggedIn { get; };
public override Object path { get; set; };
public override Object timeout { get; set; };
// Methods
private static Object __baseType();
private Object _onLoginComplete(Object result, Object context, Object methodName);
private Object _onLoginFailed(Object err, Object context, Object methodName);
private Object _onLogoutComplete(Object result, Object context, Object methodName);
private Object _onLogoutFailed(Object err, Object context, Object methodName);
private Object _setAuthenticated(Object authenticated);
public Object login(Object username, Object password, Object isPersistent, Object customInfo, Object redirectUrl, Object loginCompletedCallback, Object failedCallback, Object userContext);
public Object logout(Object redirectUrl, Object logoutCompletedCallback, Object failedCallback, Object userContext);
}
注意，上面把所有私有成员（带下划线的字段与方法）也一并列出。其实，这个AuthenticationService对象仅提供了两个公用方法：login()和logout()，分别用来实现用户登录和注销，还暴露了几个常用的属性。下面让我们逐一介绍。

(一) 方法
１、login()方法
    这个方法负责将用户名字和密码传递到服务器端进行验证，并返回是否通过验证的信息；必要的话，还可以设置相应的客户端Cookie等信息。这个方法的完整形式如下所示：
Sys.Services.AuthenticationService.login(userName, password, isPersistent, customInfo, redirectUrl,
inCompletedCallback, failedCallback, userContext);
下面表格1详细列出了上面各个参数的含义。  

(二) 公共属性
   AuthenticationService对象还提供了如表3所示几个经常用到的属性。 

属性	作用
defaultLoginCompletedCallback	获取或设定默认的调用认证服务完成之后的回调函数。
defaultLogoutCompletedCallback	获取或设定默认的注销用户完成之后的回调函数。
defaultFailedCallback	获取或设定默认的登录/注销失败之后的回调函数。
isLoggedIn	获取一个布尔值的属性，表示当前用户是否已经登录。
timeout	获取或设定认证请求的超时时间，单位为毫秒。

(三) 简单举例
１、设置AuthenticationService对象的timeout属性：
Sys.Services.AuthenticationService.set_timeout(3000);
２、若是预先设定了defaultLoginCompletedCallback、defaultLogoutCompletedCallback和 defaultFailedCallback属性，那么在调用AuthenticationService对象的login()和logout()方法时，则可省去专门指定各回调函数的操作。例如，如下代码就设定了AuthenticationService的这3个属性，并定义了相应的默认回调函数：

Sys.Services.AuthenticationService.set_defaultLoginCompletedCallback(onLoginCompleted);
Sys.Services.AuthenticationService.set_defaultLogoutCompletedCallback(onLogoutCompleted);
Sys.Services.AuthenticationService.set_defaultFailedCallback(onAuthenticationFailed);
function onLoginCompleted(validCredentials, userContext, methodName) {
//………… 
}
function onLogoutCompleted(result, userContext, methodName) {
//………… 
}
function onAuthenticationFailed(error, userContext, methodName) {
//………… 
} 

    随后，我们只需使用如下代码进行用户登录/注销就可以了。其中userName表示用户名，password表示密码：
   Sys.Services.AuthenticationService.login(userName, password, true);
    //…………
     Sys.Services.AuthenticationService.logout();
显然，这种编程思路清晰更有助于实现模块化，更值得推荐。

３、下面这个函数调用logout方法简单地清除表单中的认证cookie信息。
function OnClickLogout()
{
Sys.Services.AuthenticationService.logout(null, null, null, null);
}

４、下面这个函数调用认证服务的login方法校验用户输入的证书信息。如果认证成功，认证服务将产生一个表单认证相关cookie。

function OnClickLogin(){
//设置默认的回调函数 
SetDefaultLoginCompletedCallBack();
SetDefaultLogoutCompletedCallBack();
SetDefaultFailedCallBack();
//调用认证服务认证用户输入的证书信息 
Sys.Services.AuthenticationService.login(username.value,
password.value, false,null,null,null,null,"User Context");
} 

三、 总结
    在本篇中，我们仅罗列了ASP.NET AJAX框架的客户端认证服务中一些重要的公共成员及含义解释。并且，我们已经认识到进行以ASP.NET AJAX框架客户端中心型Web开发应当主动使用这一功能。在下篇中，我们将给出具体的示例演示。