Bootstrap

接口封装及调用

为了更好地让应用系统进行调用,有的时候需要对接口进行封装,把复杂的东西包起来,让应用系统接口开发者感觉越简单越好。这样你的系统才更容易被推广或应用。比如,现在的很多在线支付接口都提供了软件开发包。我们也可以通过封装来实现接口开发包,让开发人员简单开发,轻松调用。

1.接口封装

我们添加一个SSOLib类库项目,提供对应用系统接口代码的封装,从而使其他应用系统通过调用该类库,即可实现接入认证服务中心。SSOLib类库项目如图18-17所示,详细代码请参考本书配套光盘。

18-17 SSOClass类库项目

l Assistant类:辅助工具类。

l DESEncrypt类:加密/解密处理类。

l SynPageBase类:(接收认证中心)状态同步页面的基类,在应用系统中创建一个空白页面继承该类,即可实现同步功能。

l ValidatePageBase类:当前应用系统验证页面的基类。应用系统中的任一页面通过继承该类,都可实现对用户状态的验证功能。

2.应用系统调用接口开发步骤

下面看一下如何通过调用上面封装过的类库,来实现接入认证服务中心实现单点登录功能。

1)在Web.config里设定环境参数:

<appSettings>

<!--认证服务器验证请求地址-->

<add key="ServiceValidate" value="http://localhost:2999/Validate.aspx"/>

<!--认证服务器域名地址-->

<add key="ServiceUrl" value="http://localhost:2999"/>

<!--分配给应用系统的API代码-->

<add key="apikey" value="642386db7bf249018117e643522d6a05"/>

<!--是否加密传递 -->

<add key="IsEncrypt" value="false"/>

<!--加密密钥-->

<add key="EncryptKey" value="litianping"/>

</appSettings>

2)在Global.asax.csSession_Start添加:

protected void Session_Start(object sender, EventArgs e)

{

this.Session.Add("UserID", 0);

this.Session.Add("Pass", false);

this.Session.Add("Security", "");

this.Session.Add("Url", "");

}

3)引用组件SSOLib.DLL,如图18-18所示。

18-18 引用组件SSOLib.DLL

4)用户身份认证,验证当前状态。

将要进行验证的页面(AnyPage)基类由System.Web.UI.Page改为 SSOLib.ValidatePage

5)接收认证服务器的返回信息进行状态同步。

在项目中增加一个空白页面Synchronous.aspx,将页面基类继承自SSOLib.SynPageBase

6)更新认证服务器,保持Service认证服务器Session状态。

添加一个用户控件SynServerIFrame.ascx实现如下代码,并拖到所有的页面上。

<iframe width=0 height=0 src='<%= ServiceUrl%>/SessionState.aspx'></iframe>

SynServerIFrame.ascx.cs代码如下:

public partial class SynServerIFrame : System.Web.UI.UserControl

{

public string ServiceUrl = ConfigurationSettings.AppSettings["ServiceUrl"];

}

7)注销当前应用系统的登录。

Session.Clear();

Session.Abandon();

8)注销所有应用系统的登录。

直接转向服务器注销页面即可:

Response.Redirect(ConfigurationSettings.AppSettings["ServiceUrl"] +

"/logout.aspx");

通过上面方式的调用,应用系统的开发工作量大大减少,几分钟就可以实现了。当然,这里不仅仅是教给大家几行代码,更重要的是一种思想,一种为客户着想的思想。

本文节选自《项目中的.NET》一书

李天平编著

电子工业出版社出版

;