首先谢谢许哲兄一开始对校内API的无私贡献

因为感觉大家的封装虽然差不多,也可以说是各有千秋,不过使用起来有些麻烦,所以就尽可能在用户使用了简化了些

DLL文件、源码、演示下载:http://www.codeplex.com/xn/Release/ProjectReleases.aspx?ReleaseId=16307

Codeplex开源项目 :http://www.codeplex.com/xn/


首先就是初始化的问题,我这里提供了三种初始化,当然因为个人风格不一样所以还可能有很多方法

初始化API的方法如下:

一、最简单的,页面继承XPage类或XMasterPage类(这两个类都是在XiaoNei.Net类库中的)


public partial class Friends_get : XPage {
protected void Page_Load(object sender, EventArgs e) {
}
}

二、如果Page不符合你的条件的话,可以使当前页面实现IXHandler接口并调用 XiaoNeiApi.Init(this)方法(IXHandler也是在XiaoNei.Net类库中定义的)

如我要在Asp.net MVC中使用XiaoNei.Net则我用以下代码让Controller支持校内网的API:
public class HomeController:Controller,IXHandler{
public XiaoNeiApi Api { get; set; }
public HomeController(){
XiaoNeiApi.Init(this);
}
}

三、如果还是习惯那种Java的方法也可以,当然也可以写在Page_Load里,个人习习惯,不过我感觉这样的话代码真是不少

public class XPage : System.Web.UI.Page{
public XiaoNeiApi Api { get; set; }
protected override void OnInit(EventArgs e) {
base.OnInit(e);
string secret = Request.QueryString["xn_sig_session_key"].ToString();
secret = Server.UrlEncode(secret);
string apiKey = Request.QueryString["xn_sig_api_key"];
this.Api = new XiaoNeiApi(apiKey, secret);
}
}



API使用方法如下:

在初始化之后,即默认你继承了XPage。则页面类中会有一个Api属性。(你如果用另两种初始化方法也应该有Api属性)

如果你想调用users.getInfo方法,则Api.Users.getInfo()就可以得到

如果你想调用friends.areFriends方法则Api.Friends.areFriends("","")进行判断



具体每个方法的使用可以在演示中看到

其它扩展:

数据库访问:

这里我做了一个比较方便的方法

DataBaseExecutor dbe = new DataBaseExecutor(
new OleDbDataOpen(CONNECTIONSTRING)
);
DataList1.DataSource = dbe.GetTable("select * from user where role=@r and type=@t"
,"@r",1
,"@t","admin");

DataBaseExecutor 除了可以用GetTable外还有直接执行的Execute方法以及返回首行首列的ExecuteScalar方法

DataBaseExecutor使用什么数据库适配器全在于它的构造函数,在程序中我也提供了一个SqlServer的类SqlDataOpen。使用时只要将上面的OleDbDataOpen替换就行了。

出现错误的解决方法:



本程序为校内网应用程序,请登录后再使用:通常在本地调试时出现,只要在Url的QueryString加上你的 xnsigsessionkey与xnsigapikey就行了获取的方法是在你校内应用上点右键,得到你IFrame中的地址,看看它的查询字符串(就是?后面的内容),复制过来帖在地址后面即可(这里还是要再次谢谢许哲兄)




其它说明会一点一点补充的

Last edited Aug 14, 2008 at 8:09 PM by chsword, version 3

Comments

No comments yet.