ASP操作數據庫的類(lèi)

今天俺在這裡給大家提供一種數據庫操作的思路，這些代碼是俺在長(cháng)期的ASP應用中不斷完成和修正的，也已經(jīng)用它完成了很多項目了，應該說(shuō)直接拿去用是沒(méi)有問(wèn)題的。當然本人能力也有限，希望大家一起來(lái)討論。


說(shuō)明：此帖代碼均是VBScript版本。另外最好你對手寫(xiě)ASP已經(jīng)有一定的基礎。

先簡(jiǎn)單介紹一下俺這個(gè)類(lèi)的一些特點(diǎn)：

可同時(shí)操作多個(gè)不同類(lèi)型的數據庫。
完全不用考慮數據類(lèi)型的差別，再也不用想字符型字段加不加單引號。
調用非常簡(jiǎn)單，對數據庫的主要操作一般只需要一行代碼。
支持mssql事務(wù)回滾。
可自動(dòng)生成和輸出sql語(yǔ)句方便調試。
使用方法：

1. 修改clsDbctrl.asp文件中的第1行為你自己的數據庫位置(修改方法參考下面的CreatConn函數說(shuō)明)。如需連接多個(gè)數據庫可自行添加，格式相同。

2. 在你新建的asp文件中包含此asp文件。如：
<!--#include file="Inc/clsDbctrl.asp" --> 或者：
<!--#include virtual="/Inc/clsDbctrl.asp"-->

3.使用如下代碼應用此類(lèi)：
一個(gè)數據庫連接：

<%
OpenConn() '打開(kāi)數據庫連接
Dim db : Set db = New DbCtrl '建立對像
'Your Code Here......
Co(db) : CloseConn() '釋放對象，關(guān)閉數據庫連接
%>

或者(一個(gè)或者多個(gè)數據庫連接)：

<%
Dim db1 : Set db1 = New DbCtrl : db1.dbConn = Oc(a)
Dim db2 : Set db2 = New DbCtrl : db2.dbConn = Oc(b)
'Your Code Here......
Co(db1) : Co(db2)
%>

4.具體操作的例子可以參考各函數說(shuō)明內的代碼示例。

方法和屬性概覽（詳細用法及例子在下面）：

引用：
CreatConn 生成數據庫連接字符串
Oc 建立數據庫連接
Co 釋放對像
OpenConn 打開(kāi)默認數據庫連接
CloseConn 關(guān)閉默認數據庫連接
dbCtrl.dbConn 屬性，獲取要操作的數據庫連接，默認值為Conn
dbCtrl.dbErr 屬性，只讀，輸出捕獲的錯誤信息
dbCtrl.Version 屬性，只讀，程序版本信息
dbCtrl.AutoId 方法，自動(dòng)獲取唯一序列號
dbCtrl.GetRecord 方法，取得符合條件的紀錄集
dbCtrl.GetRecordBySql 方法，根據sql語(yǔ)句取得紀錄集
dbCtrl.GetRecordDetail 方法，根據某一條指定紀錄的詳細數據
dbCtrl.AddRecord 方法，添加一個(gè)新的紀錄
dbCtrl.UpdateRecord 方法，根據指定條件更新紀錄
dbCtrl.DeleteRecord 方法，刪除符合條件的紀錄
dbCtrl.ReadTable 方法，根據指定條件獲取某條紀錄中的其他字段的內容
dbCtrl.C 方法，關(guān)閉紀錄集對像
dbCtrl.wGetRecord,
dbCtrl.wAddRecord,
dbCtrl.wUpdateRecord,
dbCtrl.wDeleteRecord 這4個(gè)方法是取得相應的操作(前面加w)的sql語(yǔ)句


參數約定：

由于A(yíng)SP沒(méi)有Arguments對象，不能使用動(dòng)態(tài)參數，所以，在本類(lèi)的代碼中，使用了Array(數組)來(lái)達到這一效果。本類(lèi)中的部分參數可以使用數組(參數說(shuō)明中有注明)，但使用數組時(shí)應參照以下格式：

Array("Field1:Value1", "Field2:True", "Field3:100")

對，有點(diǎn)像json的格式，如果涉及到變量，那就這樣：

Array("Field1:" & Value1, "Field2:" & Value2, "Field3:" & Value3)

可以這樣說(shuō)，本類(lèi)中的幾乎所有與數據庫字段相關(guān)的內容都可以用以上的數組格式來(lái)設置條件或者是獲取內容。而這裡最大的特點(diǎn)就是在使用時(shí)不用去考慮字段的類(lèi)型，在字段后跟一個(gè)冒號，接著(zhù)跟上相應的值就行了。如果你經(jīng)常手寫(xiě)ASP程序的話(huà)，你很快就會(huì )感受到運用這種方式的魅力，除了數據類(lèi)型不用考慮之外，它也很方便隨時(shí)添加和刪除條件。如果你還不明白怎麼用的話(huà)沒(méi)關(guān)係，下面有很多例子可以說(shuō)明這個(gè)問(wèn)題。

要把ASP的數據庫操作封裝起來(lái)其實(shí)并不難，相信大家以前自己也做過(guò)類(lèi)似的代碼或是借用過(guò)其他人的封裝好的代碼。但是就如各位知道的一樣，使用封裝后的代碼一旦出錯，排錯是一個(gè)比較麻煩的事情，一般說(shuō)來(lái)，封裝后操作越簡(jiǎn)單的排錯也越複雜。俺在寫(xiě)這些代碼的時(shí)候已經(jīng)盡我所能考慮到如果出錯的話(huà)如何去排查錯誤，在盡可能簡(jiǎn)化用戶(hù)操作數據庫的代碼的同時(shí)可以隨時(shí)輸出sql語(yǔ)句排查錯誤。

最后需要說(shuō)明一點(diǎn)，本文所涉及的ASP數據庫操作并不適合大型數據，如你所知，操作大型數據最好還是使用存儲過(guò)程之類(lèi)的東東比較好，以后俺會(huì )考慮把對存儲過(guò)程的操作也封裝進(jìn)去。還有一個(gè)效率問(wèn)題，要追求高效率的話(huà)，用ASP還是應該考慮COM+等，所以再次聲明，本類(lèi)適用的對象是中小型ASP項目。

好了，下面奉上詳細使用說(shuō)明：

一．數據庫連接

考慮到大多數人的使用習慣，在數據庫連接上使用了公共過(guò)程，所以需要大家在代碼裡自行修改，如果你已經(jīng)建立了數據庫連接，把這幾行注釋掉就行了。代碼中內置了MSSql,Access,MySQL,Oracle4種數據庫的連接方式，當然你也可以自行在源代碼中增加或刪除。修改例如：

Dim a : a = CreatConn(0, "TestData", "localhost", "username", "userpassword")
Dim b : b = CreatConn(1, "Data/%TestDb%.mdb", "", "", "")

說(shuō)明一下，第1個(gè)參數可以是字符串。如果是使用Access，則第2個(gè)參數輸入相對路徑和絕對路徑都是可以的，如有密碼也可以在第5個(gè)參數中輸入，如：

Dim c : c = CreatConn("ACCESS", "E:\MyWeb\Data\%TestDB%.mdb", "", "", "mdbpassword")

相關(guān)函數：

原 型：CreatConn(dbType, strDB, strServer, strUid, strPwd)
功 能：建立數據庫連接字符串
返回值：String
參 數：
dbType : Integer or String 連接數據庫類(lèi)型
(0 or "MSSQL") - Microsoft SQL Server
(1 or "ACCESS") - Microsoft Office Access
(2 or "MYSQL") - MySQL Server
(3 or "ORACLE") - oracle Server
strDB : String 數據庫名或數據庫地址(Access使用絕對或者相對路徑均可)
strServer : String 數據庫服務(wù)器地址,Access請留空
strUid : String 數據庫用戶(hù)名,Access請留空
strPwd : String 數據庫密碼

原 型：Oc(connStr)
功 能：打開(kāi)數據庫連接
返回值：Object 數據庫連接對像
參 數：
connStr : String 數據庫連接字符串，由CreatConn函數生成

原 型：Co(obj)
功 能：關(guān)閉對像
參 數：
obj : Object 要關(guān)閉的對象名稱(chēng)

原 型：OpenConn
功 能：打開(kāi)默認數據庫連接，會(huì )自動(dòng)建立一個(gè)名稱(chēng)為Conn的連接對像
參 數：無(wú)

原 型：CloseConn
功 能：關(guān)閉名稱(chēng)為Conn的默認數據庫連接對像
參 數：無(wú)

二. 數據庫操作

下面就是本數據庫操作類(lèi)的函數功能說(shuō)明，應該算是手冊了，請多看例子的應用。

原 型：dbCtrl.dbConn(objConn)
功 能：獲取數據庫連接對像
參 數：
objConn : Object 已經(jīng)建立的數據庫連接對像
舉 例：
Dim db : Set db = New DbCtrl
db.dbConn = Oc(CreatConn(1,"E:\WebSite\MySite\Data\%TestDb%.mdb","","",""))
Co(db)

說(shuō) 明：此屬性為可選，如果不指定此屬性則默認數據連接為頁(yè)面上名稱(chēng)為Conn的數據庫連接對像

原 型：dbCtrl.AutoID(TableName)
功 能：自動(dòng)獲取唯一序列號（自動(dòng)編號）
返回值：Integer
參 數：
TableName : String 需要獲得唯一序列號的數據表名
舉 例：
Dim newId
newId = db.AutoId("TestTable")
Response.Write(newId)

原 型：dbCtrl.GetRecord(TableName,FieldsList,Condition,OrderField,ShowN)
功 能：取得符合條件的紀錄集
返回值：Object 紀錄集對像
參 數：
TableName : String 表名稱(chēng)
FieldsList : String 字段名稱(chēng)，用逗號隔開(kāi)，留空則為全部字段
Condition : String or Array 查詢(xún)條件，如果是數組應遵循前面的參數約定
orderField : String 排序方式
ShowN : Integer 獲取紀錄的數量，相當于sql中的 Select Top N
舉 例：
Dim rs
Set rs = db.GetRecord("TestTable","fId,fName,fAge","fSex='男' And IsActive = 1","fName Asc", 0)
While Not rs.eof
Response.Write ("Name is:" & rs(1) & " Age is:" & rs(2) & "<br />")
rs.movenext()
Wend
db.C(rs)

對于以上的例子，用下面的數組方式指定條件是等價(jià)的：

Set rs = db.wGetRecord("TestTable","fId,fName,fAge", Array("fSex:男","IsActive:1"), "fName Asc", 0)

另外，你可以用下面的語(yǔ)句來(lái)查看這個(gè)函數生成的sql語(yǔ)句：

Response.Write(db.wGetRecord("TestTable","fId,fName,fAge", Array("fSex:男","IsActive:1"), "fName Asc", 0))

如你所見(jiàn)，只需要在原來(lái)的函數前加一個(gè)w即可。

原 型：dbCtrl.GetRecordBySQL(strSelect)
功 能：根據sql語(yǔ)句取得紀錄集
返回值：Object 紀錄集對像
參 數：
strSelect : String 用于生成記錄集的SQL語(yǔ)句
舉 例：
Dim rs
Set rs = db.GetRecordBySQL("Select a.Id, a.LastName, b.Group From User a InnerJoin Depart b On a.GroupId = b.GroupId")
'Your Code Here ...
db.C(rs)

原 型：dbCtrl.GetRecordDetail(TableName, Condition)
功 能：根據某一條指定紀錄的詳細數據
返回值：Object 紀錄集對像
參 數：
TableName : String 表名稱(chēng)
Condition : String or Array 查詢(xún)條件，如果是數組應遵循前面的參數約定
舉 例：
Dim rs, Id
Id = Request.QueryString("id")
Set rs = db.GetRecordDetail("TestTable","Id=" & id)
'Your Code here...
db.C(rs)

說(shuō) 明：就像你已經(jīng)看出來(lái)的一樣，這個(gè)最常用在打開(kāi)某個(gè)詳細頁(yè)面(比如新聞內容頁(yè)面)

原 型：dbCtrl.AddRecord(TableName, ValueList)
功 能：添加一個(gè)新的紀錄
返回值：新記錄的Id號(成功) or 0 (失敗)
參 數：
TableName : String 表名稱(chēng)
ValueList : Array 插入表的字段和值，只能是數組且應遵循前面的參數約定
舉 例：
Dim fName, fSex, fWorkYear, fBirth
fName = "王二壇"
fSex = "男"
fWorkYear = 12
fBirth = Cdate("1981-10-23")
Dim result
result = db.AddRecord("TestTable",Array("Name:"&fName, "Sex:"&fSex, "WorkYear:"&fWorkYear, "Birthday:"&fBirth, "IsActive:True"))
If result<>0 Then
Response.Write("添加記錄成功！此記錄的自動(dòng)編號Id為" & result)
End If

看見(jiàn)了吧，真的不用考慮字段的類(lèi)型是什麼滴。
如果你想要代碼中的字段和值看得更清楚一點(diǎn)，也可以這樣寫(xiě)，但憑卿之所好：

result = db.AddRecord("TestTable",Array("Name:" & fName,_
"Sex:" & fSex,_
"WorkYear:" & fWorkYear,_
"Birthday:" & fBirth,_
"IsActive:True"))

另外，你可以用下面的語(yǔ)句來(lái)查看這個(gè)函數生成的sql語(yǔ)句：

Response.Write(db.wAddRecord("TestTable",Array("Name:"&fName, "Sex:"&fSex, "WorkYear:"&fWorkYear, "Birthday:"&fBirth, "IsActive:True")))

說(shuō) 明：返回的Id值用的是比較笨的方法，并不能保證在并發(fā)數據量大的時(shí)候的準確性，慎用。

原 型：dbCtrl.UpdateRecord(TableName, Condition, ValueList)
功 能：根據指定條件更新紀錄
返回值：1 (成功) or 0 (失敗)
參 數：
TableName : String 表名稱(chēng)
Condition : String or Array 更新條件，如果是數組應遵循前面的參數約定
ValueList : String or Array 更新的字段及值，如果是數組應遵循前面的參數約定
舉 例：
Dim fName, fWorkYear
fName = "王三壇"
fWorkYear = 10
Dim result
result = db.UpdateRecord("TestTable", "UId = 1308", Array("Name:"&fName, "WorkYear:"&fWorkYear))
If result<>0 Then
Response.Write("更新數據成功！")
End If

另外，你可以用下面的語(yǔ)句來(lái)查看這個(gè)函數生成的sql語(yǔ)句：

Response.Write(db.wUpdateRecord("TestTable", "UId = 1308", Array("Name:"&fName, "WorkYear:"&fWorkYear)))

原 型：dbCtrl.DeleteRecord(TableName,IDFieldName,IDValues)
功 能：刪除符合條件的紀錄
返回值：1 (成功) or 0 (失敗)
參 數：
TableName : String 表名稱(chēng)
IDFieldName : String 表的Id字段的名稱(chēng)
IDValues : String or Array 刪除條件，可以是由逗號隔開(kāi)的多個(gè)Id號，如果是數組應遵循前面的參數約定
舉 例：
Dim ids, result
ids = Request.Form("selectid") '可以假設這裡獲取的值是 12, 34, 256, 314 (復選框提交的值都這樣)
result = db.DeleteRecord("TestTable", "UId", ids)
If result<>0 Then
Response.Write("刪除數據成功！")
End If

當然，你也可以用字符串或者數組指定其它的條件，比如：

result = db.DeleteRecord("TestTable", "UId", "IsActive = 0 And FirstName = 'Tom'")

另外，你可以用下面的語(yǔ)句來(lái)查看這個(gè)函數生成的sql語(yǔ)句：

Response.Write(db.wDeleteRecord("TestTable", "UId", ids))

原 型：dbCtrl.ReadTable(TableName, Condition, GetFieldNames)
功 能：根據指定條件獲取某條紀錄中的其他字段的內容
返回值：String (GetFieldNames為單個(gè)字段) or Array (GetFieldNames為多個(gè)字段)
參 數：
TableName : String 表名稱(chēng)
Condition : String or Array 查詢(xún)條件，如果是數組應遵循前面的參數約定
GetFieldNames : String 單個(gè)字段名或者由逗號隔開(kāi)的多個(gè)字段名
舉 例：
Dim uid, result
uid = rs("postid") '假設這裡是頁(yè)面上某個(gè)記錄集中的用戶(hù)id值
result = db.ReadTable("UserTable","UId=" & uid, "UserName")
Response.Write("發(fā)佈者：" & result)

我不得不說(shuō)，在實(shí)際應用中，這個(gè)函數可能是用得最多的，你上面看到的就是一個(gè)非常常用的例子，從一個(gè)值去獲取另外一個(gè)表中某字段值等于該值的另外一個(gè)字段的值（有點(diǎn)拗口，不過(guò)確實(shí)就是這個(gè)意思）。下面的例子將告訴你如何根據這個(gè)值獲得多個(gè)相應的值。

Dim uid, result
uid = rs("postid") '假設這裡是頁(yè)面上某個(gè)記錄集中的用戶(hù)id值
result = db.ReadTable("UserTable","UId=" & uid, "UserName,UserSex,UserAge")
Response.Write("發(fā)佈者：" & result(0) & "<br /> 性別：" & result(1) & "<br /> 年齡：" &result(2))

如你所見(jiàn)，就這麼簡(jiǎn)單，輸入多個(gè)字段名稱(chēng)得到的是一個(gè)數組。

原 型：dbCtrl.C(objRs)
功 能：關(guān)閉紀錄集對像
參 數：
objRs : Object 頁(yè)面上的某個(gè)記錄集對像
舉 例：
Dim rs
Set rs = db.GetRecordDetail("TestTable","Id=123" )
'Your Code here...
db.C(rs)

這個(gè)函數上面的許多例子都用了，就不多解釋了，它等同于rs.close : set rs = nothing。