4。用戶模塊設計
對於底層數據庫,調用mysql的C API函數來進行數據庫的修改,內部保存一定的狀態變量例如用戶名,還是留給上一層完成?),對上一層,則提供用戶管理的接口。
Class UserManage {
private:
char myuserid[20]; // 用戶的id,未登陸前為空
time logintime; // 用戶登陸時間,並用於計算停留時間
char loginhost[20]; //上站地點。
public:
int NewUser( char *userid, char *passwd );
新建一個用戶,判斷是否已經有,其他資料暫時為空,
firstlogintime,權限等設缺省值。
int UserLogin( char *userid, char *passwd );
用戶登陸,驗證密碼,
int ChangePasswd( char *oldpasswd, char *newpasswd );
修改密碼,要求原密碼一致。
int ChangePriData( char *newname, char *newemail,
char *newaddr );
改變基本數據,泥稱,email,住址。。。。
int ModifyNumData( int addlogin, int addpost );
修改文章數,上站次數,等數據。。。。注意調用對象。
int UserLogout();
用戶退出,修改lastlogin,staytime,loginhost等
// 普通查詢命令
int QueryCommonData( const char * userid, int& loginnum,
char * username, int& postnum,
time& lastlogin, char *lasthost );
查詢網友基本信息。
// 特權指令,函數在完成功能前,先判斷權限。
int QueryPriData( const char * userid, char *email,
char *addr );
查詢基本信息,普通人只能查自己,有特權才能查其他人。
int ModifyUserLevel( BOOL isAdd, unsigned long level );
修改用戶的權限,
int ModifyUserId( char *oldid, char *newid );
char *newemail, char *newaddr );
修改用戶的基本數據。
int ModifyUserNumdata( char *userid, int addlogin, int addpost );
修改用戶的文章數等數據。
int ModifyUserPasswd( char *userid, char *newpasswd );
修改用戶的密碼。
}
以上各個函數難度不大,都是執行相應的sql語句,訪問mysql數據庫,是否將一般指令歸到特權指令中去呢?權限的檢查,是放在這一層還是上一層?
這更多的是看考慮的著重點,是看程序的清晰性還是代碼的簡練,可能還是看代碼吧,畢竟要考慮訪問量,另外,上層服務層是否也應該考慮權限檢查問題呢?
5。版面模塊設計
所謂分類,更多的是為telnet服務端考慮的,在cq66模式下,用戶可以按照自己的意願進行分類,反正最後都是直接以版為基本單位訪問的。
對於版面文章的訪問,存放的時候以整篇文章為參數,文章的分塊由本層完成,如果上層以塊為單位傳送,則在上層全部傳完,組合後,再傳參到本層分解;在讀取 的時候,本層則以塊為單位訪問,如果上層要以全文為單位訪問,則在上層做合並 工作,本層不管。
至於要不要獨立出索引,不影響上層的操作,主要和下層的數據庫構造有關,主要考慮可行性,效率需求等。
權限的檢查放在哪裡進行呢?還是放在上層吧,其實就telnet服務器端,和cq66 的客戶端,根本不會給一般用戶顯示特殊指令的菜單,當然,用戶可以直接發送cq66 的指令,服務器方還是要檢查的。但應該不用在它下面的功能模塊層再檢查一次吧 。
Class BoardManage {
private:
public:
// 有關分類的操作
int GetClassNameInfo( int maxclass, char **classid,
char ** classname );
返回分類的信息,中英文名。
int GetBoardName( int maxboards, char *classid,
char **boardname );
返回某分類中的版面信息,一般分類,直接select ..
from sboard
where boardclass == .... 特殊分類則查相應的表。。。。
// 修改需要版面管理員以上的特權
int NewClass( char * newclassname, int type );
新建分類,普通分類還是特殊分類,
int DeleteClass( char *newclassname );
刪除分類,但不cascade,即本層不負責一致性,由上層負責將
相應的版面的分類信息改為別的。分類改名也是先刪再建,
int AddClassBoard( const char *classname, char *newboardname );
將已建好的版加入某分類中,專門針對特殊分類,對一般分類,其
效果和modifyboardinfo一樣,
int DeleteClassBoard( const char *classname, char *boardname );
從分類中刪除某個版,也是針對特殊分類,對一般分類,效果也
是和modifyboardinfo一樣,一個版的分類屬性可以為空,即不屬
於任何分類。
// 有關版的信息的操作。
int NewBoard( const char *boardid,char *boardname);
新建一個版,建立對應的表。其他參數取默認值。
int DeleteBoard( const char *boardid );
刪除一個版,刪除對應的表。
int GetBoardInfo( const char *boardid, char *boardname,
int& numposts, char *masters, char *class,
long &level );
取的版面的信息。
int ModifyBoardId( const char *oldid, char *newid );
改變版的英文id,對應table的名稱也要改變,
int ModifyBoardInfo( const char *boardid, char *boardname,
int numposts, char *masters, char *class,
long level );
修改版面信息,需要特權。
// 有關版面文章的操作。
int AddText( char *boardid, char *title, char *writer,
char *text );
往版面中增加文章,內部將長文章分割成2k的塊。
int DeleteText( char *boardid, int num );
刪除文章,只是做一個標記,並不立刻修改對應的table。
int FlushTable( char *boardid );
刷新版面,刪除被刪文章的對應的記錄。
int MarkText( char *boardid, int num, char mark );
給文章做標記。
int ModifyTitle( char *boardid, int num, char *newtitle );
修改文章的標題。
int ModifyText( char *boardid, int num, char *newtext );
修改文章內容,不是自己的文章需要特權。
int GetTextInfo( const char *boardid, int num, char *title,
char *writer, char& mark );
取得文章的標題信息。
int GetText( const char *boardid, int num, int block,
char *text );
讀取文章的內容,以塊為單位。
// 文章和作者的查詢
// 一次將查詢的結果全部返回?
int QueryWriter( const char *boardid, char *writer,
char **result );
查詢版面上,某作者的文章。
int QueryTitle( const char *boardid, char *title,
char **result );
查詢版面上,標題中包含指定內容的文章。
}
參數的傳遞是一件比較討厭的事,從抽象的角度,希望返回的數據與
底層無關,所以應該加以處理,但從效率的角度,又不希望數據進行多次
復制,另一方面,空間的申請釋放,究竟是在上層中完成還是在本層中完成
呢?一不小心,很容易有內存錯誤。