校内API开放也有一段时间了,也没有太关注,正好新版本的SNS开发到了API这一块,正好借鉴一下XiaoNei,FB,MySpace的API。
且闻校内API比较有前途,最近的API编程大赛也比较火,而且人气也较旺
于是顺手用了一下校内的API,发现校内只提供了php与jsp的API却并未提供.net。
当然也有不少朋友封装了.net 的API,但我感觉使用上略见复杂,于是我自己封装了一下。
DLL文件、源码、演示下载:http://www.codeplex.com/xn/Release/ProjectReleases.aspx?ReleaseId=16307
Codeplex开源项目 :http://www.codeplex.com/xn/
开始说明:
初始化API的方法如下:
一、最简单的,页面继承XPage类或XMasterPage类
如protected void Page_Load( object sender, EventArgs e) {
}
}
二、如果不符合你的条件的话,可以使当前页面实现IXHandler接口并在调用 XiaoNeiApi.Init(this)方法
如我要在Asp.net MVC中使用XiaoNei.Net则我用以下代码让Controller支持校内网的API:
public XiaoNeiApi Api { get ; set ; }
public HomeController(){
XiaoNeiApi.Init( this );
}
}
三、如果还是习惯那种老式的方法也可以,当然也可以写在Page_Load里,个人习习惯,不过我感觉这样的话代码真是不少
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属性。
如果你想调用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加上你的 xn_sig_session_key与xn_sig_api_key就行了获取的方法是在你校内应用上点右键,得到你IFrame中的地址,看看它的查 询字符串(就是?后面的内容),复制过来帖在地址后面即可
其它说明会一点一点补充的
另:
多谢 许哲兄 是他的API的封装使我产生了做这个的念头
命名与基本的初始化都始于许哲兄的API
校内群http://group.xiaonei.com/GetTribe.do?id=249310165
开发者:http://www.cnblogs.com/chsword/
本程序完全开源可以随意更改,可以不保留作者信息。