校内网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 重典 阅读(3535) 评论(21)  编辑 收藏 网摘

  回复  引用  查看    
#1楼2008-08-15 09:31 | Gray Zhang      
要做一个好的API,最起码命名规则符合一下.NET的约定吧,做.NET的人似乎不太喜欢getInfo这种Camel风格
  回复  引用    
#2楼2008-08-15 10:20 | llgg[未注册用户]
只要在Url的QueryString加上你的 xnsigsessionkey与xnsigapikey就行了获取的方法是在你校内应用上点右键,得到你IFrame中的地址,看看它的查询字符串
???????????

  回复  引用    
#3楼2008-08-15 10:22 | 迷惘[未注册用户]
--引用--------------------------------------------------
llgg: 只要在Url的QueryString加上你的 xnsigsessionkey与xnsigapikey就行了获取的方法是在你校内应用上点右键,得到你IFrame中的地址,看看它的查询字符串
???????????
--------------------------------------------------------
同上,找不到xnsigsessionkey与xnsigapikey

  回复  引用  查看    
#4楼[楼主]2008-08-15 10:29 | 重典      
@Gray Zhang
因为是开源版本,所以风格也无所谓吧,我这里只是想保留一下原有的名

  回复  引用  查看    
#6楼[楼主]2008-08-15 10:32 | 重典      
@迷惘
进入你的应用那页
http://apps.xiaonei.com/你的应用的地址/

其实是一个IFrame,对着框架内点右键属性,会得到一个地址,如:http://www.eice.com.cn/xiaonei/chtrain" target="_new">http://www.eice.com.cn/xiaonei/chtrain /default.aspx?xn_sig_in_iframe=1&xn_sig_method=get&xn_sig_time=1218767363668&xn_sig_added=1&xn_sig_user=45102821&xn_sig_session_key=4Lsl6wlkiM1Ifjwv0H0EV%2BOcMtOAyr5tqGXHP0N%2FxgpP3srz1vpRc9oY5yafkwyM-45102821&xn_sig_expires=0&xn_sig_api_key=78332aaba86f4e11a0475e936428d4fe

取?之后的连接字符串中的xn_sig_session_key与xn_sig_api_key,附加在你的本地调试网址的后面

http://localhost/default.aspx?xn_sig_session_key=4Lsl6wlkiM1Ifjwv0H0EV%2BOcMtOAyr5tqGXHP0N%2FxgpP3srz1vpRc9oY5yafkwyM-45102821&xn_sig_api_key=78332aaba86f4e11a0475e936428d4fe

就可以了

  回复  引用  查看    
#7楼[楼主]2008-08-15 10:41 | 重典      
呵呵,新的见地。。。
  回复  引用  查看    
#8楼2008-08-15 13:16 | Zhuang miao      
很好!!很好
  回复  引用  查看    
#9楼[楼主]2008-08-15 13:33 | 重典      
@Zhuang miao
谢谢支持

  回复  引用    
#10楼2008-08-15 14:59 | jsxiaoli@hotmail.com[未注册用户]
不知道是做什么的呢?这个怎么没有开发说明。
  回复  引用  查看    
#11楼[楼主]2008-08-15 15:01 | 重典      
@jsxiaoli@hotmail.com
开发校内网应用的,在校内网上有些说明

  回复  引用  查看    
#12楼2008-08-15 19:40 | Gray Zhang      
开源不是你不讲究风格的借口,不是开源了做得不好就可以理直气壮,正是因为开源的,大家都看得到你的源码,才更要在代码风格上做到更好
  回复  引用  查看    
#13楼2008-08-15 20:18 | Shiny Zhu      
It's you.
嘿嘿。
我也刚刚写了个校内的API封装。

  回复  引用  查看    
#14楼[楼主]2008-08-15 21:12 | 重典      
@Gray Zhang
好吧,做不同风格的重载吧

  回复  引用  查看    
#15楼[楼主]2008-08-15 21:13 | 重典      
@Gray Zhang
多谢指教,一定 好好 约束代码风格

  回复  引用  查看    
#16楼[楼主]2008-08-15 21:28 | 重典      
@Gray Zhang
已经改为统一风格^^

  回复  引用  查看    
#17楼2008-08-15 22:21 | Gray Zhang      
用序列化的方案的思想很好,我当时在校内的群里就是这么提的
http://group.xiaonei.com/GetThread.do?id=326995365&parentpage=&curpage=0&label=&tribeId=249310165
我已经解决了序列化成JSON的问题,但校内号称有JSON其实是没有的,现在校内的API可用性差,实在没兴趣做,预感未来会有一次非常大的变动以致现在的都失效

  回复  引用  查看    
#18楼[楼主]2008-08-15 22:36 | 重典      
@Gray Zhang
幸会幸会,你的这个文章我读过了,我也是觉得用属性来标识序列化比较方便才这么做的

JSON序列化比较方便而且体积还小,不知道XN因为什么不支持的

校内的API可用性的确不敢恭维,但是我感觉还是有一定发展的,现在的体制显得太松散了

^^

  回复  引用  查看    
#20楼2008-08-22 23:45 | DJ尐舞      
哎··好东西··不过貌似支持.net framework 3.5的免费空间找不到呢~哎··
  回复  引用  查看    
#21楼[楼主]2008-08-22 23:53 | 重典      
@DJ尐舞
最新的版本改为支持2.0了,而且如果你想,也可以自己 改为1.0

发表评论

昵称: [登录] [注册]

主页:

邮箱:(仅博主可见)

评论内容:

  登录  注册

[使用Ctrl+Enter键快速提交评论]

0 1268307




相关文章:

相关链接: