校内网API的.net版本XiaoNei.Net 1.0(非官方)

校内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类

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

二、如果不符合你的条件的话,可以使当前页面实现IXHandler接口并在调用 XiaoNeiApi.Init(this)方法

如我要在Asp.net MVC中使用XiaoNei.Net则我用以下代码让Controller支持校内网的API:

public class HomeController:Controller,IXHandler{
    
public XiaoNeiApi Api { getset; }
        
public HomeController(){
               XiaoNeiApi.Init(
this);
        }
}

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

public class XPage : System.Web.UI.Page{
    
public XiaoNeiApi Api { getset; }
    
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/

本程序完全开源可以随意更改,可以不保留作者信息。

posted @ 2008-08-15 02:55  重典  阅读(4687)  评论(22编辑  收藏  举报