声明：本文内容纯属个人观点，官方保留最终解释
在上文(Discuz!NT URL地址重写) 中， 聊到了“在线用户”功能，因为当时介绍的重点不是“在线”那一块，所以没做深入介绍。这就为今天这篇文章埋下了“伏笔”。因为在线这个功能太重要了，大家不妨用VS打开我们产品的最新源码，然后搜索一下“OnlineUsers.”这个内容就会看到它在产品中被使用的“频率”。一下用户在线功能。
首先请大家打开Discuz.Forum这个项目，从中找到”OnlineUsers.cs”这个文件，打开它找到”ResetOnlineList()”这个函数，它的代码如下：
1/**////<summary>2///复位在线表,如果系统未重启,仅是应用程序重新启动,则不会重新创建3///</summary>4///<returns></returns>5publicstaticintResetOnlineList()6{7try8{9//取得在线表最后一条记录的tickcount字段(因为本功能不要求特别精确)10//inttickcount=DatabaseProvider.GetInstance().GetLastTickCount();11//如果距离现在系统运行时间小于10分钟12if(System.Environment.TickCount<600000)13{14returnInitOnlineList();15}16return-1;17}18catch19{20try21{22returnInitOnlineList();23}24catch25{26return-1;27}28}2930}3132
这个函数本身就是在系统启动之后的10分钟内运行InitOnlineList函数，而为什么是10分钟（不是别的时间段呢?），主要是因为这个值是个“估计值”，因为在线功能是系统的核心功能之一，换句话说，系统在启动10分钟内，只要是用户在前台进行操作，绝对会用到这个核心功能，而这个功能本身是依赖于数据库中的“dnt_onlines”表的（如果大家想了解这个表的结构，可以下载我们产品的“数据字典”，里面有这方面内容的介绍）。所以创建(复位)和初始化这个数据表的责任就交给了ResetOnlineList()这个函数（因为它是在HttpModule.cs中被绑定的，可以看作是系统运行的起点，详情见上文）。
好了，即然清楚了这个函数的作用，不妨再了解一下代码中InitOnlineList()方法，它的作用就是运行下面这个SQL语句:
1//该函数位于Discuz.Data.SqlServer项目中的UserManage.cs文件中2publicintCreateOnlineTable()3{4try5{6StringBuildersb=newStringBuilder();7sb.Append(“IFEXISTS(SELECT*FROMSYSOBJECTSWHEREid=object_id(N'[dnt_online]’)ANDOBJECTPROPERTY(id,N’IsUserTable’)=1)DROPTABLE[dnt_online];”);8sb.Append(“CREATETABLE[dnt_online]([olid][int]IDENTITY(1,1)NOTNULL,[userid][int]NOTNULL,[ip][varchar](15)NOTNULL,[username][nvarchar](20)NOTNULL,[nickname][nvarchar](20)NOTNULL,[password][char](32)NOTNULL,[groupid][smallint]NOTNULL,[olimg][varchar](80)NOTNULL,[adminid][smallint]NOTNULL,[invisible][smallint]NOTNULL,[action][smallint]NOTNULL,[lastactivity][smallint]NOTNULL,[lastposttime][datetime]NOTNULL,[lastpostpmtime][datetime]NOTNULL,[lastsearchtime][datetime]NOTNULL,[lastupdatetime][datetime]NOTNULL,[forumid][int]NOTNULL,[forumname][nvarchar](50)NOTNULL,[titleid][int]NOTNULL,[title][nvarchar](80)NOTNULL,[verifycode][varchar](10)NOTNULL)ON[PRIMARY];”);9sb.Append(“ALTERTABLE[dnt_online]WITHNOCHECKADDCONSTRAINT[PK_dnt_online]PRIMARYKEYCLUSTERED([olid])ON[PRIMARY];”);10sb.Append(“ALTERTABLE[dnt_online]ADDCONSTRAINT[DF_dnt_online_userid]DEFAULT((-1))FOR[userid],CONSTRAINT[DF_dnt_online_ip]DEFAULT(‘0.0.0.0’)FOR[ip],CONSTRAINT[DF_dnt_online_username]DEFAULT(”)FOR[username],CONSTRAINT[DF_dnt_online_nickname]DEFAULT(”)FOR[nickname],CONSTRAINT[DF_dnt_online_password]DEFAULT(”)FOR[password],CONSTRAINT[DF_dnt_online_groupid]DEFAULT(0)FOR[groupid],CONSTRAINT[DF_dnt_online_olimg]DEFAULT(”)FOR[olimg],CONSTRAINT[DF_dnt_online_adminid]DEFAULT(0)FOR[adminid],CONSTRAINT[DF_dnt_online_invisible]DEFAULT(0)FOR[invisible],CONSTRAINT[DF_dnt_online_action]DEFAULT(0)FOR[action],CONSTRAINT[DF_dnt_online_lastactivity]DEFAULT(0)FOR[lastactivity],CONSTRAINT[DF_dnt_online_lastposttime]DEFAULT(‘1900-1-100:00:00’)FOR[lastposttime],CONSTRAINT[DF_dnt_online_lastpostpmtime]DEFAULT(‘1900-1-100:00:00’)FOR[lastpostpmtime],CONSTRAINT[DF_dnt_online_lastsearchtime]DEFAULT(‘1900-1-100:00:00’)FOR[lastsearchtime],CONSTRAINT[DF_dnt_online_lastupdatetime]DEFAULT(getdate())FOR[lastupdatetime],CONSTRAINT[DF_dnt_online_forumid]DEFAULT(0)FOR[forumid],CONSTRAINT[DF_dnt_online_forumname]DEFAULT(”)FOR[forumname],CONSTRAINT[DF_dnt_online_titleid]DEFAULT(0)FOR[titleid],CONSTRAINT[DF_dnt_online_title]DEFAULT(”)FOR[title],CONSTRAINT[DF_dnt_online_verifycode]DEFAULT(”)FOR[verifycode];”);11sb.Append(“CREATEINDEX[forum]ON[dnt_online]([userid],[forumid],[invisible])ON[PRIMARY];”);12sb.Append(“CREATEINDEX[invisible]ON[dnt_online]([userid],[invisible])ON[PRIMARY];”);13sb.Append(“CREATEINDEX[forumid]ON[dnt_online]([forumid])ON[PRIMARY];”);14sb.Append(“CREATEINDEX[password]ON[dnt_online]([userid],[password])ON[PRIMARY];”);15sb.Append(“CREATEINDEX[ip]ON[dnt_online]([userid],[ip])ON[PRIMARY];”);1617returnDbHelper.ExecuteNonQuery(CommandType.Text,sb.Replace(“dnt_”,BaseConfigs.GetBaseConfig().Tableprefix).ToString());18}19catch20{21return-1;22}23}2425
该方法如果正常运行的话，会在数据库中建立dnt_onlines”这个表。用于记录在线用户的全部信息。
上文介绍的仅仅是系统“初始化”时所要做的“活”。而更重要的内容是用户从一访问论坛并执行一系列操作（如登陆，发贴，浏览版块等）时，“在线用户”机制在里面所启的重要作用。
这里先以登陆(系统)这一操作发生时，程序所做出的响应为例，看一下在线这块是如何进行绑定的，请看如下代码(位于discuz.web项目的“aspx/1/”文件夹下的login.aspx.cs文件):
12OnlineUsers.UpdateAction(olid,UserAction.Login.ActionID,0,config.Onlinetimeout);34
它的作用就是将已成功登陆系统的用户所执行的当前动作及相关信息更新到”dnt_onlines” 表中。而这个函数本身所用到的四个参数要重点介绍一下:
olid: 在线列表id，对应”dnt_onlines”表中的olid字段
action:动作(结构类型，详情参见discuz.forum项目下的forumutils.cs文件) 用于传递动作的相关信息如:ActionName动作名称和ActionDescription动作描述等)
inid: 所在位置代码，即当前用户所访问的主题（TopicId）。因为登陆不牵扯主题操作，所 以上面的值为0
timeout: 无动作离线时间（config.Onlinetimeout），这个数据是在后台进行设置的，见下图: timeout的作用就是当有别人访问论坛时，在更新自身在线状态信息同时，用这个设置数据（整型）与在线表（dnt_onlines）中的”lastupdatetime”字段（最后活动时间）进行比较，找出超过timeout规定的时间的用户，将其在线状态（onlinestate）设置为0（即为离线）。而做这件事的函数就是在项目“discuz.data.sqlserver”下的“UserManage.cs”中的“AddOnlineUser”函数，这里将它的代码贴出来，详情见注释：
1/**////<summary>2///执行在线用户向表及缓存中添加的操作。3///</summary>4///<paramname=”__onlineuserinfo”>在组用户信息内容</param>5///<returns>添加成功则返回刚刚添加的olid,失败则返回0</returns>6publicintAddOnlineUser(OnlineUserInfo__onlineuserinfo,inttimeout)7{89stringstrDelTimeOutSql=””;10//此处的设置见后台forum_uisetting.aspx.cs源码11//如果timeout为负数则代表不需要精确更新用户是否在线的状态12if(timeout>0)13{14if(__onlineuserinfo.Userid>0)15{16strDelTimeOutSql=string.Format(“{0}UPDATE[{1}users]SET[onlinestate]=1WHERE[uid]={2};”,strDelTimeOutSql,BaseConfigs.GetTablePrefix,__onlineuserinfo.Userid.ToString());17}18}19else20{21timeout=timeout*-1;22}2324if(timeout>9999)25{26timeout=9999;27}2829System.Text.StringBuildersb=newSystem.Text.StringBuilder();30System.Text.StringBuildersb2=newSystem.Text.StringBuilder();3132IDataReaderdr=DbHelper.ExecuteReader(CommandType.Text,string.Format(“SELECT[userid]FROM[{0}online]WHERE[lastupdatetime]<‘{1}'”,BaseConfigs.GetTablePrefix,DateTime.Parse(DateTime.Now.AddMinutes(timeout*-1).ToString(“yyyy-MM-ddHH:mm:ss”))));33try34{35while(dr.Read())36{37sb.Append(“,”);38sb.Append(dr[0].ToString());39if(dr[0].ToString()!=”-1″)40{41sb2.Append(“,”);42sb2.Append(dr[0].ToString());43}44}45}46finally47{48dr.Close();49}5051if(sb.Length>0)52{53sb.Remove(0,1);54strDelTimeOutSql=string.Format(“{0}DELETEFROM[{1}online]WHERE[userid]IN({2});”,strDelTimeOutSql,BaseConfigs.GetTablePrefix,sb.ToString());55}56if(sb2.Length>0)57{58sb2.Remove(0,1);59strDelTimeOutSql=string.Format(“{0}UPDATE[{1}users]SET[onlinestate]=0,[lastactivity]=GETDATE()WHERE[uid]IN({2});”,strDelTimeOutSql,BaseConfigs.GetTablePrefix,sb2.ToString());60}616263DbParameter[]prams={};64intolid=Utils.StrToInt(DbHelper.ExecuteScalar(CommandType.Text,strDelTimeOutSql+”INSERTINTO[“+BaseConfigs.GetTablePrefix+”online]([userid],[ip],[username],[nickname],[password],[groupid],[olimg],[adminid],[invisible],[action],[lastactivity],[lastposttime],[lastpostpmtime],[lastsearchtime],[lastupdatetime],[forumid],[forumname],[titleid],[title],[verifycode])VALUES(@userid,@ip,@username,@nickname,@password,@groupid,@olimg,@adminid,@invisible,@action,@lastactivity,@lastposttime,@lastpostpmtime,@lastsearchtime,@lastupdatetime,@forumid,@forumname,@titleid,@title,@verifycode);SELECTSCOPE_IDENTITY()”,prams).ToString(),0);6566//如果id值太大则重建在线表67if(olid>2147483000)68{69CreateOnlineTable();70DbHelper.ExecuteNonQuery(CommandType.Text,strDelTimeOutSql+”INSERTINTO[“+BaseConfigs.GetTablePrefix+”online]([userid],[ip],[username],[nickname],[password],[groupid],[olimg],[adminid],[invisible],[action],[lastactivity],[lastposttime],[lastpostpmtime],[lastsearchtime],[lastupdatetime],[forumid],[titleid],[verifycode])VALUES(@userid,@ip,@username,@nickname,@password,@groupid,@olimg,@adminid,@invisible,@action,@lastactivity,@lastposttime,@lastpostpmtime,@lastsearchtime,@lastupdatetime,@forumid,@forumname,@titleid,@title,@verifycode);SELECTSCOPE_IDENTITY()”,prams);71return1;72}737475return0;76//return(int)DbHelper.ExecuteDataset(CommandType.Text,”SELECT[olid]FROM[“+BaseConfigFactory.GetTablePrefix+”online]WHERE[userid]=”+__onlineuserinfo.Userid.ToString()).Tables[0].Rows[0][0];7778}7980
需要说明一下，就是在线表的删除问题。因为这个在线表是通过程序在数据库中进行创建的，同时表中的olid又是一个自增字段（标识自增为1），因此为了避免自增字段最终超过最大值范围（因为在线表经常有数据添加进来）。所以在上面加入了”olid > 2147483000″的逻辑判断，来预防这个问题的出现。
说了一大堆的关于timeout参数的问题，而另一个重要的参数olid还没作详细介绍呢:)
上面所述的登陆页面(login.aspx.cs)中，olid是从basepage类中获得的，而basepage就是前台主要页面的“基类”，它里面的构造函数部分封装了页面中大部分公共变量的初始化操作。所以要了解olid，还要从basepage.cs中分析一把。
请看下面的代码段（摘自discuz.web.ui项目下的basepage.cs文件）：
1/**////<summary>2///当前用户的在线表ID3///</summary>4protectedinternalintolid;56publicBasePage()//构造函数7{89oluserinfo=OnlineUsers.UpdateInfo(config.Passwordkey,config.Onlinetimeout);1011//password可用于下面的userkey赋值，以实现用户退出操作时的识别认证12password=oluserinfo.Password;13if(password.Length>16)14{15userkey=password.Substring(4,8).Trim();16}17else18{19userkey=””;20}212223olid=oluserinfo.Olid;2425}2627
从代码中可以看出olid是通过louserinfo对象进行赋值的，而louserinfo对象是通过UpdateInfo来进行实始化绑定的，所以我们还需要再看一下这个函数，相关代码段如下：
1/**////<summary>2///用户在线信息维护。判断当前用户的身份(会员还是游客),是否在在线列表中存在,如果存在则更新会员的当前动,不存在则建立.3///</summary>4///<paramname=”passwordkey”>论坛passwordkey</param>5///<paramname=”timeout”>在线超时时间</param>6///<paramname=”passwd”>用户密码</param>7publicstaticOnlineUserInfoUpdateInfo(stringpasswordkey,inttimeout,intuid,stringpasswd)8{910lock(SynObject)11{12OnlineUserInfo__onlineuser=newOnlineUserInfo();1314stringip=DNTRequest.GetIP();15intuserid=Utils.StrToInt(ForumUtils.GetCookie(“userid”),uid);16stringpassword=(passwd==string.Empty?ForumUtils.GetCookiePassword(passwordkey):ForumUtils.GetCookiePassword(passwd,passwordkey));1718if(password.Length==0)19{20userid=-1;21}22//如果密码非Base64编码字符串则怀疑被非法篡改,直接置身份为游客23elseif(!Utils.IsBase64String(password))24{25userid=-1;26}2728if(userid!=-1)29{30__onlineuser=GetOnlineUser(userid,password);31if(__onlineuser!=null)32{3334if(__onlineuser.Ip!=ip)35{36UpdateIP(__onlineuser.Olid,ip);3738__onlineuser.Ip=ip;3940return__onlineuser;41}42}43else44{4546//判断密码是否正确47userid=Users.CheckPassword(userid,password,false);48if(userid!=-1)49{50DeleteRowsByIP(ip);51returnCreateUser(userid,timeout);52}53else54{55//如密码错误则在在线表中创建游客56__onlineuser=GetOnlineUserByIP(-1,ip);57if(__onlineuser==null)58{59returnCreateGuestUser(timeout);60}61}62}6364}65else66{67__onlineuser=GetOnlineUserByIP(-1,ip);68if(__onlineuser==null)69{70returnCreateGuestUser(timeout);71}7273}7475__onlineuser.Lastupdatetime=Utils.GetDateTime();76return__onlineuser;7778}7980}8182
看到这里大家明白了吧，原来不管用户是否注册登陆，这个函数都会将一些信息更新或添加到在线表中。即判断当前用户的身份(会员还是游客),是否在”在线列表”中存在,如果存在则更新会员的当前动作,不存在（首次访问）则初始化相关（游客）用户信息。
下面再介绍一下action这个参数，它是结构(struct)类型，里面的ActionName动作名称和ActionD-escription动作描述（目前未用上）是用于显示当前动作信息的。相应的显示效果如下图所示:
如果大家觉得没问题的话，下面再介绍一下注销（退出）操作，因为有登陆就会有退出。而注销这块的操作也很简单，请看如下代码段(位于aspx/1/logout.aspx.cs文件):
1publicclasslogout:BasePage2{3protectedoverridevoidShowPage()4{567if(DNTRequest.GetString(“userkey”)==userkey)8{9AddMsgLine(“已经清除了您的登录信息,稍后您将以游客身份返回首页”);10Users.UpdateOnlineTime(uid);11OnlineUsers.DeleteRows(olid);12ForumUtils.ClearUserCookie();13Utils.WriteCookie(Utils.GetTemplateCookieName(),””,-999999);14}15else16{17AddMsgLine(“无法确定您的身份,稍后返回首页”);18}19}20}2122
代码中的userkey其实是一个用户password的一个子串（详情上面basepage.cs代码中的相应部分）。 而“OnlineUsers.DeleteRows(olid);”这行代码其实就是删除在线表中指定olid的用户信息了。因为代码过于简单，只是一条SQL语句而已，所以就不在这里多费笔默了。
其实关于在线表有关的操作还有很多，大家不妨挖一下onlines.cs这个文件，从中会有更多的收获。
最后再介绍一下有关“最大在线人数”这个问题，其实这个功能主要是为了中小站长（服务器资源相对紧张）提供的一项设置，旨在当用户在线人数达到一定数量时，拒绝其它的访问。相应的代码判断逻辑如下（摘自basepage.cs文件）：
1if(config.Onlinetimeout>0&&userid!=-1)2{3onlineusercount=OnlineUsers.GetOnlineAllUserCount();4}5else6{7onlineusercount=OnlineUsers.GetCacheOnlineAllUserCount();8}9if(onlineusercount>=config.Maxonlines&&useradminid!=1&&pagename!=”login.aspx”&&pagename!=”logout.aspx”)10{11ShowMessage(“抱歉,目前访问人数太多,你暂时无法访问论坛.”,0);12return;13}14
里面的GetOnlineAllUserCount()和GetCacheOnlineAllUserCount()均为返回在线人数的方法，而config.Onlinetimeout的设置是在管理后台完成的，见下图:
好了，今天的文章就先写到这里了，希望大家不要感觉是在“云里雾里”的:)，如果有问题欢迎与我交流或去我们的官方站点(http://nt.discuz.net)反映问题。
我的email: daizhj@discuz.com, daizhj617595@126.com, daizhj@gmail.com
关键字:.net,discuz,disucznt,online,在线,在线用户
作者:代震军,daizhj
人生的小河，总要流过森林，荒漠，
