據(jù)庫：JDBC-ODBC橋配置、排坑與JDK 8遷移指南)
簡介面向JSP初學者的數(shù)據(jù)庫連接實操文檔以連接ACCESS數(shù)據(jù)庫為例講解JDBC的基礎用法適合學習小型Web項目數(shù)據(jù)交互或復習JDBC-ODBC橋接技術的讀者。文檔完整覆蓋從創(chuàng)建test.mdb數(shù)據(jù)庫及username表含uid、pwd兩個文本字段到將數(shù)據(jù)庫文件部署至Tomcat的data目錄再到編寫JSP頁面完成連接、查詢并輸出字段的全過程并附有可直接參考的示例代碼和常見錯誤提示的排查方向。文中還詳細說明了加載JDBC-ODBC橋驅動、構建連接字符串、通過Statement執(zhí)行SQL以及關閉ResultSet、Statement、Connection釋放資源等關鍵環(huán)節(jié)同時指出Access數(shù)據(jù)庫更適用于小型項目或學習實踐企業(yè)級開發(fā)中常轉向MySQL、Oracle等關系型數(shù)據(jù)庫有助于讀者建立正確的技術選型認知。包體為單個doc文件大小31KB內容集中、便于按步驟對照練習。目前已有240人學習下載對想快速上手JSPACCESS數(shù)據(jù)讀取的初學者具有較好的參考價值。1. JSP連接ACCESS數(shù)據(jù)庫小項目夠用但JDK 8起這條路就斷了JSP連接ACCESS數(shù)據(jù)庫看起來像是十年前課設里的老題目但直到今天我在接手內部小工具、競賽原型代碼時還會撞上它。這套方案的核心就三件事建一個test.mdb庫和username表、把文件放進Tomcat的ROOT\data目錄、通過JDBC-ODBC橋驅動連上再查數(shù)據(jù)。先說結論sun.jdbc.odbc.JdbcOdbcDriver這個橋驅動在JDK 8里已經被移除所以你要么在JDK 7及以下環(huán)境復現(xiàn)要么把這段代碼當歷史遺產來改造。適合誰想快速驗證Web連接數(shù)據(jù)庫流程的初學者以及被老項目困住的維護者。下面按建庫、放文件、寫代碼、排坑的順序把整條路走一遍。2. 建庫與部署環(huán)境test.mdb、ROOT\data和驅動位數(shù)必須一致2.1 為什么是Access選型邊界先看清Access能活到今天靠的不是性能而是零門檻。建一個mdb文件不需要單獨裝數(shù)據(jù)庫服務雙擊Access就能建表插數(shù)據(jù)拷走一個文件整個數(shù)據(jù)庫也跟著走。JSP這種服務端腳本配合Access適合幾種場景校內實訓、內部報表小站、演示原型以及用戶量能數(shù)得過來的工具系統(tǒng)。一旦并發(fā)超過二三十個或者需要半夜跑批任務mdb的短板就完全暴露文件鎖沖突、連接數(shù)上限低、沒有日志和備份機制。這些邊界不是勸退而是告訴你什么時候不要用。這里我為什么還要提它因為市面上大量存量代碼就是這么寫的。老版本教材示例、培訓機構的快速Demo到現(xiàn)在依然有人在跑。理解這套代碼的運行機制比直接否定它更有用。只要是學習JDBC流程或者處理老系統(tǒng)維護這個方案都值得拆開看一遍。2.2 建test.mdb和username表打開Access新建一個空數(shù)據(jù)庫保存時注意文件類型選“Access 2002-2003格式.mdb”不要存成默認的.accdb。原因很簡單ODBC驅動名里寫的是Microsoft Access Driver (.mdb)橋驅動通過ODBC訪問老格式最穩(wěn)accdb雖然也能通過新版ACE驅動訪問但那要額外裝ACE驅動部署時更容易出幺蛾子。數(shù)據(jù)庫建好后在表設計視圖中新建表username兩個字段按原文要求都設為文本型字段名類型字段大小說明uid文本50用戶名pwd文本50密碼建議順手插入兩三條測試數(shù)據(jù)不然select查出來是空表很難判斷到底是連成功了還是查到了空結果。字段大小給50是經驗值如果存長內容就在設計視圖里改但JSP代碼里rs.getString(uid)讀取時不會受字段大小限制限制只影響Access端錄入。這里有個常見翻車點建表時字段名打錯比如寫成user_name而不是uid運行時會報“Column not found”頁面只顯示字段名錯誤定位起來相對費勁。所以我一般直接復制下面的SQL到Access的查詢設計里執(zhí)行比手點界面靠譜CREATE TABLE username ( uid TEXT(50), pwd TEXT(50) ); INSERT INTO username (uid, pwd) VALUES (admin, 123456); INSERT INTO username (uid, pwd) VALUES (zhangsan, abc123);Access的查詢向導支持直接跑這類SQL跑完表就建好了。注意TEXT(50)是Access的Jet SQL語法跟MySQL的VARCHAR不一樣不要拿MySQL習慣去套。這段SQL的邏輯說明先建表再插入兩條記錄確保第3章執(zhí)行select時至少有數(shù)據(jù)顯示。2.3 數(shù)據(jù)庫文件放哪getRealPath怎么找原文要求把test.mdb放到Tomcat安裝目錄下的webapps\ROOT\data文件夾更準確說是Tomcat安裝目錄\webapps\ROOT\data\test.mdb。webapps是Tomcat存放Web應用的根目錄ROOT是默認應用訪問http://localhost:8080/時直接命中它。data文件夾如果不存在就手動新建。為什么放在這里而不是隨便放D盤因為代碼里用的是application.getRealPath(spath)getRealPath會把“相對于當前Web應用根目錄的路徑”轉換成服務器上的物理路徑。JSP在ROOT下運行時spathdata/test.mdb結果就是Tomcat安裝目錄\webapps\ROOT\data\test.mdb。如果你把JSP放在某個子應用里比如webapps\myapp\demo.jsp那getRealPath對應的根目錄就是webapps\myappdata也要放進myapp下這個對應關系是新手最容易搞混的。有個細節(jié)要注意Tomcat 6到Tomcat 9雖然在Servlet規(guī)范里仍保留getRealPath但從Tomcat 7起部分版本對未解壓的WAR包或虛擬目錄調用getRealPath會返回null或臨時路徑。如果你是用IDE直接部署、沒走標準目錄結構跑出null時不要慌先打印一句application.getRealPath(/)看看根路徑到底指向哪。另外data目錄必須有寫權限。Access通過ODBC打開mdb時會在同目錄創(chuàng)建.laccdb鎖文件老格式是.ldb沒有寫權限就直接報“不能更新。數(shù)據(jù)庫或對象為只讀”。2.4 環(huán)境搭配JDK、Tomcat和驅動位數(shù)這套代碼最挑剔的是環(huán)境組合。JDBC-ODBC橋驅動類名是sun.jdbc.odbc.JdbcOdbcDriver只有JDK 7及以下才有。JDK 8起JDBC-ODBC橋被官方移除Class.forName會直接拋ClassNotFoundException。如果你是學習目的最省事的做法是裝一個JDK 7配Tomcat 6或7如果是維護老項目先確認服務器JDK版本再決定是改代碼還是換環(huán)境。第二個環(huán)境坑是位數(shù)。ODBC管理器有32位和64位兩套Microsoft Access Driver (*.mdb)這個驅動一般由Office提供常見的Office 32位安裝只帶32位驅動。如果Tomcat跑在64位JVM里調用的是64位ODBC就找不到32位驅動。反過來裝64位Office后Tomcat卻是32位JVM同樣會失敗。判斷方法Windows下分別運行C:\Windows\SysWOW64\odbcad32.exe和C:\Windows\System32\odbcad32.exe查看兩套驅動列表再看Tomcat啟動日志確認JVM位數(shù)?？傊甁VM位數(shù)和Access驅動位數(shù)必須對齊這是很多“驅動明明裝了卻連不上”的根源。建庫、放文件、環(huán)境組合這三件事定下來接下來進入代碼拆解。3. 連接字符串與JSP代碼拆解橋驅動、物理路徑和資源關閉3.1 JDBC-ODBC橋是什么JDBC-ODBC橋是JDK早期提供的一個適配層它讓Java程序通過JDBC API間接調用ODBC驅動再由ODBC去訪問Access這類桌面數(shù)據(jù)庫。對寫代碼的人來說整個過程是個黑匣子你只看到Class.forName一個類名后面其實經歷了“JDBC調用→橋轉換→ODBC調用→Jet/ACE引擎讀取mdb”四層。這也是為什么這類連接出問題時報錯信息經常含糊。加載驅動的原理很簡單。Class.forName(sun.jdbc.odbc.JdbcOdbcDriver)會觸發(fā)驅動類的靜態(tài)初始化把JdbcOdbcDriver實例注冊到java.sql.DriverManager里之后DriverManager.getConnection(url)才能識別jdbc:odbc:開頭的URL。如果你的classpath里沒有這個類forName這一行就會拋ClassNotFoundException后續(xù)代碼根本不執(zhí)行。這個異常在JDK 8以上環(huán)境幾乎是必現(xiàn)的。順帶解釋一個新手常問的為什么不直接連Access而要繞ODBC因為Access的Jet/ACE引擎沒有提供原生JDBC驅動Java標準庫只能走ODBC這座橋。后來UCanAccess這類純Java驅動出現(xiàn)才把ODBC這一層省掉但那是后話。3.2 連接字符串拼法Driver和DBQ各管什么原文里的連接字符串是很多教程的標準寫法String url jdbc:odbc:Driver{Microsoft Access Driver (*.mdb)};DBQ dbpath;這行代碼用了DSN-less方式不提前在控制面板建數(shù)據(jù)源直接在連接串里指定驅動名和數(shù)據(jù)庫路徑。各參數(shù)說明如下參數(shù)值說明前綴jdbc:odbc:固定寫法告訴DriverManager走JDBC-ODBC橋Driver{Microsoft Access Driver (*.mdb)}ODBC驅動顯示名花括號不能省星號和空格也不能改DBQdbpathmdb文件的物理路徑來自application.getRealPath()PWD可選Access數(shù)據(jù)庫密碼無密碼時可省略有幾個容易寫錯的地方。第一花括號內的驅動名必須和系統(tǒng)ODBC管理器里顯示的名字完全一致少了星號、多打一個空格都會報“指定的驅動程序不存在”。第二DBQ后面接的是物理路徑而不是JSP相對路徑這就是為什么前面要先用getRealPath轉換一次。第三參數(shù)之間用分號分隔最后一個參數(shù)后面不要加分號。如果你在Access里給數(shù)據(jù)庫設了密碼連接串要追加PWD參數(shù)例如String url jdbc:odbc:Driver{Microsoft Access Driver (*.mdb)};DBQ dbpath ;PWD123456;注意這跟“用戶名密碼”是兩回事。Access數(shù)據(jù)庫密碼是文件級密碼ODBC連接時用戶名一般留空。原文代碼里定義了dbname、user、password三個變量但都沒被連接代碼使用這種寫法在新手代碼里很常見實際是冗余的。真正要傳的只有DBQ和可選的PWD。還有一種常見做法是預先在系統(tǒng)里建一個DSN數(shù)據(jù)源連接串簡化為jdbc:odbc:test。這種方式在開發(fā)機上方便但換一臺機器就要重新配置ODBC數(shù)據(jù)源部署麻煩DSN-less把所有信息都寫在連接串里更適合代碼分發(fā)和教學演示。3.3 完整JSP代碼與執(zhí)行流程說明把上面的鋪墊合并成一份完整的JDBCAccess.jsp放在ROOT目錄下和data目錄同級瀏覽器直接訪問http://localhost:8080/JDBCAccess.jsp就能跑% page contentTypetext/html; charsetgb2312 languagejava importjava.sql.* % meta http-equivContent-Type contenttext/html; charsetgb2312 % try { // 1. 數(shù)據(jù)庫相對路徑相對于當前Web應用的根目錄 String spath data/test.mdb; // 2. 轉成服務器物理路徑 String dbpath application.getRealPath(spath); // 3. DSN-less連接串驅動名 數(shù)據(jù)庫物理路徑 String url jdbc:odbc:Driver{Microsoft Access Driver (*.mdb)};DBQ dbpath; // 4. 加載JDBC-ODBC橋驅動JDK 7及以下才存在 Class.forName(sun.jdbc.odbc.JdbcOdbcDriver); // 5. 建立連接 Connection conn DriverManager.getConnection(url); // 6. 創(chuàng)建語句對象 Statement stmt conn.createStatement( ResultSet.TYPE_SCROLL_SENSITIVE, ResultSet.CONCUR_UPDATABLE); // 7. 查詢并遍歷輸出 String sql select * from username; ResultSet rs stmt.executeQuery(sql); while (rs.next()) { out.print(用戶名: rs.getString(uid)); out.print( 密碼: rs.getString(pwd) br); } out.print(br恭喜你數(shù)據(jù)庫連接成功); // 8. 逆序關閉對象 rs.close(); stmt.close(); conn.close(); } catch (Exception e) { out.print(數(shù)據(jù)庫連接錯誤,錯誤信息如下br); out.print(e.getMessage()); } %執(zhí)行流程拆開看try塊里第一步先把相對路徑轉成物理路徑這是整個環(huán)節(jié)最容易出問題的地方第二步拼URL驅動名必須和ODBC管理器里一字不差第三步Class.forName加載橋驅動第四步建連接第五步建語句對象并執(zhí)行查詢最后While循環(huán)逐行讀取uid和pwd并輸出到頁面。catch塊只做了輸出沒有finally清理邏輯這是代碼的隱患。兩個參數(shù)說明。createStatement的兩個參數(shù)第一個TYPE_SCROLL_SENSITIVE表示結果集要支持雙向滾動第二個CONCUR_UPDATABLE表示結果集允許就地更新。這兩項對Access的ODBC驅動來說要求偏高很多驅動只支持TYPE_FORWARD_ONLY和CONCUR_READ_ONLY如果你只是查數(shù)據(jù)展示建議改成Statement stmt conn.createStatement( ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY);再補一個容易踩的頁面顯示“數(shù)據(jù)庫連接錯誤”時catch里只打印了e.getMessage()信息經常被截斷。實際排查時我會臨時改成e.printStackTrace()把完整堆棧打到Tomcat的catalina.out或控制臺定位是哪一層出的問題改完記得改回來。4. 常見問題排查五條踩坑記錄從文件鎖到中文亂碼這段代碼跑起來碰壁率不低。我把實戰(zhàn)中最常遇到的五類問題按現(xiàn)象、原因、解決三要素列出來你可以對應自己的報錯信息逐條對照。4.1 數(shù)據(jù)庫文件被占用、出現(xiàn).laccdb鎖文件現(xiàn)象Tomcat運行中去修改或復制test.mdb時提示文件正在被另一個程序使用data目錄下多出test.laccdb這樣的鎖文件刪掉后還會再生成。原因Access引擎通過ODBC打開mdb時會在同目錄創(chuàng)建鎖文件用于記錄當前連接。只要有一個連接沒關閉鎖文件就存在。如果JSP里conn.close()沒執(zhí)行異常時跳到了catchTomcat進程還占著連接文件就一直是鎖定狀態(tài)。解決把data目錄放到Tomcat進程有寫權限的位置改動數(shù)據(jù)庫前先停止Tomcat長期使用后定期用Access打開數(shù)據(jù)庫執(zhí)行“壓縮和修復數(shù)據(jù)庫”這個操作能清掉殘留鎖并回收文件體積。另外確保rs、stmt、conn在finally里也有關閉邏輯只靠try結尾關閉異常情況下會漏。關于鎖文件還有一點血淚經驗不要在Tomcat運行中直接用Access的界面操作同一個mdb兩邊同時打開極易觸發(fā)“文件正在使用中”的彈窗頁面也連不上。4.2 ClassNotFoundException提示橋驅動不存在現(xiàn)象頁面報java.lang.ClassNotFoundException: sun.jdbc.odbc.JdbcOdbcDriver。原因JDK 8起官方移除了JDBC-ODBC橋。這行代碼在JDK 8、JDK 11、JDK 17等新版本上必然翻車跟Tomcat版本無關。這個坑最坑的地方在于很多教程是十年前寫的當年的JDK 6能用現(xiàn)在照著敲就炸。解決如果只是復現(xiàn)這個例子安裝JDK 7并把Tomcat的JAVA_HOME指過去如果要新環(huán)境做正式開發(fā)放棄ODBC橋改用UCanAccess這種純Java的Access驅動連接串變成jdbc:ucanaccess://...完全繞開ODBC層位數(shù)問題也一并消失。4.3 64位系統(tǒng)下提示驅動不存在但這驅動明明裝了現(xiàn)象控制面板的ODBC數(shù)據(jù)源管理器里能看到Microsoft Access Driver (*.mdb)但Tomcat里運行代碼報“指定的驅動程序不存在”或者找不到數(shù)據(jù)源。原因位數(shù)不一致。Windows上有兩套ODBC管理器32位和64位。常見的Office是32位裝法只帶32位Access驅動如果Tomcat跑在64位JVM里它會去加載64位ODBC自然找不到32位驅動。反過來裝64位OfficeTomcat卻是32位JVM同樣失敗。這種問題最玄學因為你在圖形界面看驅動明明存在代碼卻告訴你沒有。解決先確認Tomcat的JVM位數(shù)。Windows任務管理器里看進程名帶不帶“*32”或者看java -version輸出。然后分別打開C:\Windows\SysWOW64\odbcad32.exe和C:\Windows\System32\odbcad32.exe確認對應的驅動列表。要做的就是讓兩邊對上要么把Tomcat換成32位版配32位Office要么裝64位Office配64位Tomcat。4.4 中文亂碼和中文查詢條件失敗現(xiàn)象頁面輸出“用戶名:?? 密碼:??”或者執(zhí)行select where uid張三返回空結果數(shù)據(jù)明明在表里。原因編碼不一致。JSP頁面聲明charsetgb2312瀏覽器按GBK解碼Tomcat老版本默認URI編碼是ISO-8859-1如果JSP文件名或路徑里有中文getRealPath拿到的路徑就會亂Access表里數(shù)據(jù)按Unicode存儲輸出時再經過gb2312轉碼多環(huán)節(jié)不一致表現(xiàn)就是亂碼。解決新頁面統(tǒng)一用UTF-8把contentType改為charsetUTF-8Tomcat老版本連接器加URIEncodingUTF-8測試數(shù)據(jù)用Access界面正常錄入不要用命令行工具亂灌。至于中文條件查詢最穩(wěn)的寫法是參數(shù)化查詢把值通過setString傳進去而不是拼接SQL字符串這樣既解決編碼也避免注入。4.5 getRealPath返回null頁面直接報空指針現(xiàn)象application.getRealPath(data/test.mdb)返回nullDBQ拼出來是“null”連接失敗。原因應用不是以解壓目錄的形式部署。比如IDE里以exploded方式部署到臨時目錄、或者部署的是WAR且Tomcat沒有解壓該應用getRealPath在這種情況下可能拿不到物理路徑。另外路徑如果以/開頭也會影響結果。解決先打印application.getRealPath(/)看Web應用根路徑的值確認JSP和data目錄的相對位置如果確實拿不到把mdb路徑配置到.properties文件里再讀。提醒一句Tomcat 7以后的Servlet規(guī)范里getRealPath已經標注為deprecated新改造的代碼建議用ServletContext.getResource或把文件放到類路徑下通過ClassLoader讀取。五條問題排查下來有個共性幾乎都是環(huán)境問題而不是SQL問題。接下來把這段一次性連接代碼往前推一步。5. 往前走一步參數(shù)化查詢與連接復用跑通上面的例子只是起點。這段代碼放在學習場景沒問題但它是典型的“一次請求一次連接”模型每次訪問JSP都重新Class.forName、重新建連接、用完就扔。Access本身并發(fā)弱這種寫法在多人同時訪問時會造成大量連接競爭頁面變慢、鎖文件頻繁出現(xiàn)。我一般會把改造分成兩步不引入復雜框架也能見效。第一步把SQL從拼接改成參數(shù)化。上面代碼里select * from username沒有任何外部輸入看不出問題一旦改成where uid request.getParameter(uid) 注入和編碼問題就全來了。改成PreparedStatementString sql select * from username where uid?; PreparedStatement ps conn.prepareStatement(sql); ps.setString(1, request.getParameter(uid)); ResultSet rs ps.executeQuery();setString把第一個問號替換成請求參數(shù)值參數(shù)化后既避免SQL拼接的注入風險也讓中文參數(shù)按連接串的字符集統(tǒng)一處理比手工加引號和轉義省心得多。第二步把連接參數(shù)抽到一個統(tǒng)一的常量類或properties文件里避免每次改路徑都要翻JSP。如果再往前一步用一個簡單的連接池或者至少把連接復用邏輯封裝到工具類整個工程就好維護多了。不過使用連接池時要注意Access的ODBC驅動對連接池化的支持并不完善JDBC-ODBC橋本身也沒有實現(xiàn)標準的PooledConnection某些池化實現(xiàn)會導致連接失效后無法自動恢復所以我通常會加一個連接有效性檢測再復用。以這套代碼為例我的建議改法是仍然保留JDBC-ODBC橋代碼作為學習參照但真實項目一律用UCanAccess或者直接遷移到MySQL。從那以后我每次做數(shù)據(jù)庫相關的老項目改造都強制先走一遍“驅動版本、位數(shù)、編碼、物理路徑”四查再動手改代碼少踩了不少冤枉路。希望幫到你。本文還有配套的精品資源點擊獲取 JSP連接Access數(shù)據(jù)庫：JDBC-ODBC橋配置、排坑與JDK 8遷移指南
簡介面向JSP初學者的數(shù)據(jù)庫連接實操文檔以連接ACCESS數(shù)據(jù)庫為例講解JDBC的基礎用法適合學習小型Web項目數(shù)據(jù)交互或復習JDBC-ODBC橋接技術的讀者。文檔完整覆蓋從創(chuàng)建test.mdb數(shù)據(jù)庫及username表含uid、pwd兩個文本字段到將數(shù)據(jù)庫文件部署至Tomcat的data目錄再到編寫JSP頁面完成連接、查詢并輸出字段的全過程并附有可直接參考的示例代碼和常見錯誤提示的排查方向。文中還詳細說明了加載JDBC-ODBC橋驅動、構建連接字符串、通過Statement執(zhí)行SQL以及關閉ResultSet、Statement、Connection釋放資源等關鍵環(huán)節(jié)同時指出Access數(shù)據(jù)庫更適用于小型項目或學習實踐企業(yè)級開發(fā)中常轉向MySQL、Oracle等關系型數(shù)據(jù)庫有助于讀者建立正確的技術選型認知。包體為單個doc文件大小31KB內容集中、便于按步驟對照練習。目前已有240人學習下載對想快速上手JSPACCESS數(shù)據(jù)讀取的初學者具有較好的參考價值。1. JSP連接ACCESS數(shù)據(jù)庫小項目夠用但JDK 8起這條路就斷了JSP連接ACCESS數(shù)據(jù)庫看起來像是十年前課設里的老題目但直到今天我在接手內部小工具、競賽原型代碼時還會撞上它。這套方案的核心就三件事建一個test.mdb庫和username表、把文件放進Tomcat的ROOT\data目錄、通過JDBC-ODBC橋驅動連上再查數(shù)據(jù)。先說結論sun.jdbc.odbc.JdbcOdbcDriver這個橋驅動在JDK 8里已經被移除所以你要么在JDK 7及以下環(huán)境復現(xiàn)要么把這段代碼當歷史遺產來改造。適合誰想快速驗證Web連接數(shù)據(jù)庫流程的初學者以及被老項目困住的維護者。下面按建庫、放文件、寫代碼、排坑的順序把整條路走一遍。2. 建庫與部署環(huán)境test.mdb、ROOT\data和驅動位數(shù)必須一致2.1 為什么是Access選型邊界先看清Access能活到今天靠的不是性能而是零門檻。建一個mdb文件不需要單獨裝數(shù)據(jù)庫服務雙擊Access就能建表插數(shù)據(jù)拷走一個文件整個數(shù)據(jù)庫也跟著走。JSP這種服務端腳本配合Access適合幾種場景校內實訓、內部報表小站、演示原型以及用戶量能數(shù)得過來的工具系統(tǒng)。一旦并發(fā)超過二三十個或者需要半夜跑批任務mdb的短板就完全暴露文件鎖沖突、連接數(shù)上限低、沒有日志和備份機制。這些邊界不是勸退而是告訴你什么時候不要用。這里我為什么還要提它因為市面上大量存量代碼就是這么寫的。老版本教材示例、培訓機構的快速Demo到現(xiàn)在依然有人在跑。理解這套代碼的運行機制比直接否定它更有用。只要是學習JDBC流程或者處理老系統(tǒng)維護這個方案都值得拆開看一遍。2.2 建test.mdb和username表打開Access新建一個空數(shù)據(jù)庫保存時注意文件類型選“Access 2002-2003格式.mdb”不要存成默認的.accdb。原因很簡單ODBC驅動名里寫的是Microsoft Access Driver (.mdb)橋驅動通過ODBC訪問老格式最穩(wěn)accdb雖然也能通過新版ACE驅動訪問但那要額外裝ACE驅動部署時更容易出幺蛾子。數(shù)據(jù)庫建好后在表設計視圖中新建表username兩個字段按原文要求都設為文本型字段名類型字段大小說明uid文本50用戶名pwd文本50密碼建議順手插入兩三條測試數(shù)據(jù)不然select查出來是空表很難判斷到底是連成功了還是查到了空結果。字段大小給50是經驗值如果存長內容就在設計視圖里改但JSP代碼里rs.getString(uid)讀取時不會受字段大小限制限制只影響Access端錄入。這里有個常見翻車點建表時字段名打錯比如寫成user_name而不是uid運行時會報“Column not found”頁面只顯示字段名錯誤定位起來相對費勁。所以我一般直接復制下面的SQL到Access的查詢設計里執(zhí)行比手點界面靠譜CREATE TABLE username ( uid TEXT(50), pwd TEXT(50) ); INSERT INTO username (uid, pwd) VALUES (admin, 123456); INSERT INTO username (uid, pwd) VALUES (zhangsan, abc123);Access的查詢向導支持直接跑這類SQL跑完表就建好了。注意TEXT(50)是Access的Jet SQL語法跟MySQL的VARCHAR不一樣不要拿MySQL習慣去套。這段SQL的邏輯說明先建表再插入兩條記錄確保第3章執(zhí)行select時至少有數(shù)據(jù)顯示。2.3 數(shù)據(jù)庫文件放哪getRealPath怎么找原文要求把test.mdb放到Tomcat安裝目錄下的webapps\ROOT\data文件夾更準確說是Tomcat安裝目錄\webapps\ROOT\data\test.mdb。webapps是Tomcat存放Web應用的根目錄ROOT是默認應用訪問http://localhost:8080/時直接命中它。data文件夾如果不存在就手動新建。為什么放在這里而不是隨便放D盤因為代碼里用的是application.getRealPath(spath)getRealPath會把“相對于當前Web應用根目錄的路徑”轉換成服務器上的物理路徑。JSP在ROOT下運行時spathdata/test.mdb結果就是Tomcat安裝目錄\webapps\ROOT\data\test.mdb。如果你把JSP放在某個子應用里比如webapps\myapp\demo.jsp那getRealPath對應的根目錄就是webapps\myappdata也要放進myapp下這個對應關系是新手最容易搞混的。有個細節(jié)要注意Tomcat 6到Tomcat 9雖然在Servlet規(guī)范里仍保留getRealPath但從Tomcat 7起部分版本對未解壓的WAR包或虛擬目錄調用getRealPath會返回null或臨時路徑。如果你是用IDE直接部署、沒走標準目錄結構跑出null時不要慌先打印一句application.getRealPath(/)看看根路徑到底指向哪。另外data目錄必須有寫權限。Access通過ODBC打開mdb時會在同目錄創(chuàng)建.laccdb鎖文件老格式是.ldb沒有寫權限就直接報“不能更新。數(shù)據(jù)庫或對象為只讀”。2.4 環(huán)境搭配JDK、Tomcat和驅動位數(shù)這套代碼最挑剔的是環(huán)境組合。JDBC-ODBC橋驅動類名是sun.jdbc.odbc.JdbcOdbcDriver只有JDK 7及以下才有。JDK 8起JDBC-ODBC橋被官方移除Class.forName會直接拋ClassNotFoundException。如果你是學習目的最省事的做法是裝一個JDK 7配Tomcat 6或7如果是維護老項目先確認服務器JDK版本再決定是改代碼還是換環(huán)境。第二個環(huán)境坑是位數(shù)。ODBC管理器有32位和64位兩套Microsoft Access Driver (*.mdb)這個驅動一般由Office提供常見的Office 32位安裝只帶32位驅動。如果Tomcat跑在64位JVM里調用的是64位ODBC就找不到32位驅動。反過來裝64位Office后Tomcat卻是32位JVM同樣會失敗。判斷方法Windows下分別運行C:\Windows\SysWOW64\odbcad32.exe和C:\Windows\System32\odbcad32.exe查看兩套驅動列表再看Tomcat啟動日志確認JVM位數(shù)?？傊甁VM位數(shù)和Access驅動位數(shù)必須對齊這是很多“驅動明明裝了卻連不上”的根源。建庫、放文件、環(huán)境組合這三件事定下來接下來進入代碼拆解。3. 連接字符串與JSP代碼拆解橋驅動、物理路徑和資源關閉3.1 JDBC-ODBC橋是什么JDBC-ODBC橋是JDK早期提供的一個適配層它讓Java程序通過JDBC API間接調用ODBC驅動再由ODBC去訪問Access這類桌面數(shù)據(jù)庫。對寫代碼的人來說整個過程是個黑匣子你只看到Class.forName一個類名后面其實經歷了“JDBC調用→橋轉換→ODBC調用→Jet/ACE引擎讀取mdb”四層。這也是為什么這類連接出問題時報錯信息經常含糊。加載驅動的原理很簡單。Class.forName(sun.jdbc.odbc.JdbcOdbcDriver)會觸發(fā)驅動類的靜態(tài)初始化把JdbcOdbcDriver實例注冊到java.sql.DriverManager里之后DriverManager.getConnection(url)才能識別jdbc:odbc:開頭的URL。如果你的classpath里沒有這個類forName這一行就會拋ClassNotFoundException后續(xù)代碼根本不執(zhí)行。這個異常在JDK 8以上環(huán)境幾乎是必現(xiàn)的。順帶解釋一個新手常問的為什么不直接連Access而要繞ODBC因為Access的Jet/ACE引擎沒有提供原生JDBC驅動Java標準庫只能走ODBC這座橋。后來UCanAccess這類純Java驅動出現(xiàn)才把ODBC這一層省掉但那是后話。3.2 連接字符串拼法Driver和DBQ各管什么原文里的連接字符串是很多教程的標準寫法String url jdbc:odbc:Driver{Microsoft Access Driver (*.mdb)};DBQ dbpath;這行代碼用了DSN-less方式不提前在控制面板建數(shù)據(jù)源直接在連接串里指定驅動名和數(shù)據(jù)庫路徑。各參數(shù)說明如下參數(shù)值說明前綴jdbc:odbc:固定寫法告訴DriverManager走JDBC-ODBC橋Driver{Microsoft Access Driver (*.mdb)}ODBC驅動顯示名花括號不能省星號和空格也不能改DBQdbpathmdb文件的物理路徑來自application.getRealPath()PWD可選Access數(shù)據(jù)庫密碼無密碼時可省略有幾個容易寫錯的地方。第一花括號內的驅動名必須和系統(tǒng)ODBC管理器里顯示的名字完全一致少了星號、多打一個空格都會報“指定的驅動程序不存在”。第二DBQ后面接的是物理路徑而不是JSP相對路徑這就是為什么前面要先用getRealPath轉換一次。第三參數(shù)之間用分號分隔最后一個參數(shù)后面不要加分號。如果你在Access里給數(shù)據(jù)庫設了密碼連接串要追加PWD參數(shù)例如String url jdbc:odbc:Driver{Microsoft Access Driver (*.mdb)};DBQ dbpath ;PWD123456;注意這跟“用戶名密碼”是兩回事。Access數(shù)據(jù)庫密碼是文件級密碼ODBC連接時用戶名一般留空。原文代碼里定義了dbname、user、password三個變量但都沒被連接代碼使用這種寫法在新手代碼里很常見實際是冗余的。真正要傳的只有DBQ和可選的PWD。還有一種常見做法是預先在系統(tǒng)里建一個DSN數(shù)據(jù)源連接串簡化為jdbc:odbc:test。這種方式在開發(fā)機上方便但換一臺機器就要重新配置ODBC數(shù)據(jù)源部署麻煩DSN-less把所有信息都寫在連接串里更適合代碼分發(fā)和教學演示。3.3 完整JSP代碼與執(zhí)行流程說明把上面的鋪墊合并成一份完整的JDBCAccess.jsp放在ROOT目錄下和data目錄同級瀏覽器直接訪問http://localhost:8080/JDBCAccess.jsp就能跑% page contentTypetext/html; charsetgb2312 languagejava importjava.sql.* % meta http-equivContent-Type contenttext/html; charsetgb2312 % try { // 1. 數(shù)據(jù)庫相對路徑相對于當前Web應用的根目錄 String spath data/test.mdb; // 2. 轉成服務器物理路徑 String dbpath application.getRealPath(spath); // 3. DSN-less連接串驅動名 數(shù)據(jù)庫物理路徑 String url jdbc:odbc:Driver{Microsoft Access Driver (*.mdb)};DBQ dbpath; // 4. 加載JDBC-ODBC橋驅動JDK 7及以下才存在 Class.forName(sun.jdbc.odbc.JdbcOdbcDriver); // 5. 建立連接 Connection conn DriverManager.getConnection(url); // 6. 創(chuàng)建語句對象 Statement stmt conn.createStatement( ResultSet.TYPE_SCROLL_SENSITIVE, ResultSet.CONCUR_UPDATABLE); // 7. 查詢并遍歷輸出 String sql select * from username; ResultSet rs stmt.executeQuery(sql); while (rs.next()) { out.print(用戶名: rs.getString(uid)); out.print( 密碼: rs.getString(pwd) br); } out.print(br恭喜你數(shù)據(jù)庫連接成功); // 8. 逆序關閉對象 rs.close(); stmt.close(); conn.close(); } catch (Exception e) { out.print(數(shù)據(jù)庫連接錯誤,錯誤信息如下br); out.print(e.getMessage()); } %執(zhí)行流程拆開看try塊里第一步先把相對路徑轉成物理路徑這是整個環(huán)節(jié)最容易出問題的地方第二步拼URL驅動名必須和ODBC管理器里一字不差第三步Class.forName加載橋驅動第四步建連接第五步建語句對象并執(zhí)行查詢最后While循環(huán)逐行讀取uid和pwd并輸出到頁面。catch塊只做了輸出沒有finally清理邏輯這是代碼的隱患。兩個參數(shù)說明。createStatement的兩個參數(shù)第一個TYPE_SCROLL_SENSITIVE表示結果集要支持雙向滾動第二個CONCUR_UPDATABLE表示結果集允許就地更新。這兩項對Access的ODBC驅動來說要求偏高很多驅動只支持TYPE_FORWARD_ONLY和CONCUR_READ_ONLY如果你只是查數(shù)據(jù)展示建議改成Statement stmt conn.createStatement( ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY);再補一個容易踩的頁面顯示“數(shù)據(jù)庫連接錯誤”時catch里只打印了e.getMessage()信息經常被截斷。實際排查時我會臨時改成e.printStackTrace()把完整堆棧打到Tomcat的catalina.out或控制臺定位是哪一層出的問題改完記得改回來。4. 常見問題排查五條踩坑記錄從文件鎖到中文亂碼這段代碼跑起來碰壁率不低。我把實戰(zhàn)中最常遇到的五類問題按現(xiàn)象、原因、解決三要素列出來你可以對應自己的報錯信息逐條對照。4.1 數(shù)據(jù)庫文件被占用、出現(xiàn).laccdb鎖文件現(xiàn)象Tomcat運行中去修改或復制test.mdb時提示文件正在被另一個程序使用data目錄下多出test.laccdb這樣的鎖文件刪掉后還會再生成。原因Access引擎通過ODBC打開mdb時會在同目錄創(chuàng)建鎖文件用于記錄當前連接。只要有一個連接沒關閉鎖文件就存在。如果JSP里conn.close()沒執(zhí)行異常時跳到了catchTomcat進程還占著連接文件就一直是鎖定狀態(tài)。解決把data目錄放到Tomcat進程有寫權限的位置改動數(shù)據(jù)庫前先停止Tomcat長期使用后定期用Access打開數(shù)據(jù)庫執(zhí)行“壓縮和修復數(shù)據(jù)庫”這個操作能清掉殘留鎖并回收文件體積。另外確保rs、stmt、conn在finally里也有關閉邏輯只靠try結尾關閉異常情況下會漏。關于鎖文件還有一點血淚經驗不要在Tomcat運行中直接用Access的界面操作同一個mdb兩邊同時打開極易觸發(fā)“文件正在使用中”的彈窗頁面也連不上。4.2 ClassNotFoundException提示橋驅動不存在現(xiàn)象頁面報java.lang.ClassNotFoundException: sun.jdbc.odbc.JdbcOdbcDriver。原因JDK 8起官方移除了JDBC-ODBC橋。這行代碼在JDK 8、JDK 11、JDK 17等新版本上必然翻車跟Tomcat版本無關。這個坑最坑的地方在于很多教程是十年前寫的當年的JDK 6能用現(xiàn)在照著敲就炸。解決如果只是復現(xiàn)這個例子安裝JDK 7并把Tomcat的JAVA_HOME指過去如果要新環(huán)境做正式開發(fā)放棄ODBC橋改用UCanAccess這種純Java的Access驅動連接串變成jdbc:ucanaccess://...完全繞開ODBC層位數(shù)問題也一并消失。4.3 64位系統(tǒng)下提示驅動不存在但這驅動明明裝了現(xiàn)象控制面板的ODBC數(shù)據(jù)源管理器里能看到Microsoft Access Driver (*.mdb)但Tomcat里運行代碼報“指定的驅動程序不存在”或者找不到數(shù)據(jù)源。原因位數(shù)不一致。Windows上有兩套ODBC管理器32位和64位。常見的Office是32位裝法只帶32位Access驅動如果Tomcat跑在64位JVM里它會去加載64位ODBC自然找不到32位驅動。反過來裝64位OfficeTomcat卻是32位JVM同樣失敗。這種問題最玄學因為你在圖形界面看驅動明明存在代碼卻告訴你沒有。解決先確認Tomcat的JVM位數(shù)。Windows任務管理器里看進程名帶不帶“*32”或者看java -version輸出。然后分別打開C:\Windows\SysWOW64\odbcad32.exe和C:\Windows\System32\odbcad32.exe確認對應的驅動列表。要做的就是讓兩邊對上要么把Tomcat換成32位版配32位Office要么裝64位Office配64位Tomcat。4.4 中文亂碼和中文查詢條件失敗現(xiàn)象頁面輸出“用戶名:?? 密碼:??”或者執(zhí)行select where uid張三返回空結果數(shù)據(jù)明明在表里。原因編碼不一致。JSP頁面聲明charsetgb2312瀏覽器按GBK解碼Tomcat老版本默認URI編碼是ISO-8859-1如果JSP文件名或路徑里有中文getRealPath拿到的路徑就會亂Access表里數(shù)據(jù)按Unicode存儲輸出時再經過gb2312轉碼多環(huán)節(jié)不一致表現(xiàn)就是亂碼。解決新頁面統(tǒng)一用UTF-8把contentType改為charsetUTF-8Tomcat老版本連接器加URIEncodingUTF-8測試數(shù)據(jù)用Access界面正常錄入不要用命令行工具亂灌。至于中文條件查詢最穩(wěn)的寫法是參數(shù)化查詢把值通過setString傳進去而不是拼接SQL字符串這樣既解決編碼也避免注入。4.5 getRealPath返回null頁面直接報空指針現(xiàn)象application.getRealPath(data/test.mdb)返回nullDBQ拼出來是“null”連接失敗。原因應用不是以解壓目錄的形式部署。比如IDE里以exploded方式部署到臨時目錄、或者部署的是WAR且Tomcat沒有解壓該應用getRealPath在這種情況下可能拿不到物理路徑。另外路徑如果以/開頭也會影響結果。解決先打印application.getRealPath(/)看Web應用根路徑的值確認JSP和data目錄的相對位置如果確實拿不到把mdb路徑配置到.properties文件里再讀。提醒一句Tomcat 7以后的Servlet規(guī)范里getRealPath已經標注為deprecated新改造的代碼建議用ServletContext.getResource或把文件放到類路徑下通過ClassLoader讀取。五條問題排查下來有個共性幾乎都是環(huán)境問題而不是SQL問題。接下來把這段一次性連接代碼往前推一步。5. 往前走一步參數(shù)化查詢與連接復用跑通上面的例子只是起點。這段代碼放在學習場景沒問題但它是典型的“一次請求一次連接”模型每次訪問JSP都重新Class.forName、重新建連接、用完就扔。Access本身并發(fā)弱這種寫法在多人同時訪問時會造成大量連接競爭頁面變慢、鎖文件頻繁出現(xiàn)。我一般會把改造分成兩步不引入復雜框架也能見效。第一步把SQL從拼接改成參數(shù)化。上面代碼里select * from username沒有任何外部輸入看不出問題一旦改成where uid request.getParameter(uid) 注入和編碼問題就全來了。改成PreparedStatementString sql select * from username where uid?; PreparedStatement ps conn.prepareStatement(sql); ps.setString(1, request.getParameter(uid)); ResultSet rs ps.executeQuery();setString把第一個問號替換成請求參數(shù)值參數(shù)化后既避免SQL拼接的注入風險也讓中文參數(shù)按連接串的字符集統(tǒng)一處理比手工加引號和轉義省心得多。第二步把連接參數(shù)抽到一個統(tǒng)一的常量類或properties文件里避免每次改路徑都要翻JSP。如果再往前一步用一個簡單的連接池或者至少把連接復用邏輯封裝到工具類整個工程就好維護多了。不過使用連接池時要注意Access的ODBC驅動對連接池化的支持并不完善JDBC-ODBC橋本身也沒有實現(xiàn)標準的PooledConnection某些池化實現(xiàn)會導致連接失效后無法自動恢復所以我通常會加一個連接有效性檢測再復用。以這套代碼為例我的建議改法是仍然保留JDBC-ODBC橋代碼作為學習參照但真實項目一律用UCanAccess或者直接遷移到MySQL。從那以后我每次做數(shù)據(jù)庫相關的老項目改造都強制先走一遍“驅動版本、位數(shù)、編碼、物理路徑”四查再動手改代碼少踩了不少冤枉路。希望幫到你。本文還有配套的精品資源點擊獲取