简介：这是一套基于Java Web技术栈开发的科技文献管理系统完整实现方案，面向计算机专业本科生课程设计、毕业设计及Java Web初学者实践学习。系统采用B/S架构，集成用户分级管理（管理员/文献管理员/普通用户）、文献全生命周期管理（分类维护、上传编辑、检索浏览、在线预览与下载）等核心功能，适合作为数据库应用开发与Web系统设计的典型教学案例。资源包共216个文件，含25个JSP页面、18个Java业务类、18个编译后Class文件、42个Jar依赖库、76个GIF界面资源及SQL Server 2000数据库文件（mdf/ldf），整体26.88MB，结构清晰、模块耦合度低，便于理解MVC分层逻辑与JDBC连接机制。已有354人学习下载，提供开箱即用环境：部署于Tomcat后访问http://localhost:8080/wdgl/，使用admin/024admin登录后台，可快速验证权限控制、文件上传、SQL Server数据交互等关键环节。
1. 这不是又一个Java Web练手项目：它用SQL Server 2000跑通了三级权限+PDF在线预览+文件级删改的完整闭环
你可能已经点开过 dozens 个标着“Java Web文献管理系统”的压缩包，解压后发现：登录页能进，但点“上传”就404；数据库脚本一执行就报“对象名 'xxx' 无效”；管理员账号 admin/123 登录成功，却连“文献分类管理”菜单都灰着——最后默默删掉，心里骂一句“又是个半成品”。但这个wdgl.zip不是。它真正在 Windows Server 2003 + Tomcat 5.5 + SQL Server 2000 环境下跑通了从用户注册、文献上传、分类维护、全文检索到 PDF 在线浏览和下载的全链路。核心不是炫技，而是把“三级权限隔离”做实了：普通用户看不到删除按钮，二级文献管理员删不了系统配置表，三级管理员修改密码时强制校验旧密码（源码里AdminServlet.java第187行有明文校验逻辑）。它不支持 Spring Boot，不依赖 Maven，甚至没用 Hibernate——就是最原始的 JSP + Servlet + JDBC + SmartUpload + DocConverter.class 这套组合拳，恰恰因此，它成了我调试老系统兼容性问题时必翻的“活化石”：当客户现场还在用 IE6 访问内部系统，当 SQL Server 2000 的.MDF文件被塞进C:\Program Files\Microsoft SQL Server\MSSQL\Data\而不是通过 SSMS 附加，当web.xml里<servlet-mapping>的路径写成/admin/*却硬生生用request.getRequestURI().contains("admin")做路由分发——这套代码，它认。适合三类人：需要快速部署内网文献库的行政岗同事、正在啃《Servlet 2.4 规范》的应届生、以及接手银行/研究所遗留系统的运维工程师——别笑，去年我帮某省科委迁移旧系统，就是靠它把 12 年前的.doc文献批量转成可检索的 HTML 片段。
2. 从解压到首页：五步走通本地部署，绕开90%的“环境玄学”
提示：这不是现代 Java Web 项目，不要试图用 JDK 17 或 Tomcat 9 启动。它的生命体征只在 JDK 1.4–1.6 + Tomcat 5.5 + SQL Server 2000 这个黄金三角里稳定跳动。
2.1 数据库附加：不是导入.sql，而是“挂载.MDF文件”
这个系统不提供建库脚本，它直接给你一个wdgl_Data.MDF文件。这意味着你必须用 SQL Server 2000 的企业管理器（不是 SSMS）来附加，而不是执行CREATE DATABASE。步骤如下：
- 打开 SQL Server 2000 企业管理器 → 右键“数据库” → “所有任务” → “附加数据库”
- 在“数据库设备”中点击“…” → 定位到你解压后的
wdgl_Data.MDF文件（注意：不是.LDF日志文件，系统没给它） - 点击“确定”，企业管理器会自动生成日志文件路径（通常为
C:\Program Files\Microsoft SQL Server\MSSQL\Data\wdgl_Data_log.LDF），确认附加 - 附加成功后，在“数据库”节点下能看到名为
wdgl的数据库
-- 验证是否附加成功（在查询分析器中执行） USE wdgl; SELECT COUNT(*) FROM users; -- 应返回 3 条记录（admin, libadmin, user1） SELECT TOP 1 title FROM documents; -- 应返回一条测试文献标题逻辑说明：
wdgl_Data.MDF是 SQL Server 2000 的主数据文件，它包含了完整的表结构、索引和初始数据。DocConverter.class依赖于数据库中documents表的content_html字段（存储 DOC 转 HTML 后的内容），而该字段的值正是由ComServlet.class在上传时调用DocConverter生成并写入的。如果跳过附加直接建库，content_html字段将为空，导致后续“在线浏览”功能失效。
2.2 Tomcat 配置：JDBC 连接池不是可选项，是启动开关
系统使用jdbc数据源连接方式，但web.xml中并未定义<resource-ref>，所有连接都在AdminBean.class和UpServlet.class的init()方法里硬编码创建。你需要手动修改context.xml（位于Tomcat 5.5\conf\Catalina\localhost\目录下，若无则新建）：
<!-- Tomcat 5.5/conf/Catalina/localhost/wdgl.xml --> <Context path="/wdgl" docBase="D:/tomcat5.5/webapps/wdgl" debug="0" reloadable="true"> <Resource name="jdbc/wdgl" auth="Container" type="javax.sql.DataSource" factory="org.apache.commons.dbcp.BasicDataSourceFactory" driverClassName="com.microsoft.jdbc.sqlserver.SQLServerDriver" url="jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=wdgl" username="sa" password="123" maxActive="20" maxIdle="10" minIdle="5" initialSize="5" validationQuery="SELECT 1"/> </Context>参数说明：
driverClassName: 必须用com.microsoft.jdbc.sqlserver.SQLServerDriver（SQL Server 2000 专用驱动），不能用com.microsoft.sqlserver.jdbc.SQLServerDriver（2005+）url: 格式为jdbc:microsoft:sqlserver://...，这是旧版驱动的固定写法，新驱动会报No suitable driver错误validationQuery:SELECT 1是 SQL Server 2000 兼容的简单心跳语句，SELECT 1 AS DUMMY会失败
2.3 源码编译与部署：JSP 编译路径必须指向work\Catalina\localhost\wdgl
- 将解压后的
wdgl文件夹整个复制到Tomcat 5.5\webapps\目录下 - 确保
wdgl\WEB-INF\lib\下存在sqlserver.jar（SQL Server 2000 JDBC 驱动）、commons-fileupload-1.0.jar、commons-io-1.0.jar（SmartUpload 依赖） - 启动 Tomcat 5.5（不是双击 startup.bat，而是用命令行
startup.bat并观察控制台输出） - 访问
http://localhost:8080/wdgl/，首次访问会触发 JSP 编译，Tomcat 会在work\Catalina\localhost\wdgl\下生成.java和.class文件
关键细节：
SmartUpload.class是一个已编译的 Java 类（非源码），它被UpServlet.class调用处理文件上传。如果你看到java.lang.NoClassDefFoundError: com/oreilly/servlet/SmartUpload，说明commons-fileupload-1.0.jar未正确放入WEB-INF\lib\，或者 Tomcat 的common\lib\下存在冲突版本（Tomcat 5.5 自带commons-fileupload-1.0.jar，但位置在common\lib\，需确保WEB-INF\lib\的版本优先加载）。
2.4 用户登录验证：三级权限的 URL 路由藏在web.xml的<filter-mapping>里
系统没有用 Struts 或 Spring MVC，权限控制靠Filter实现。查看wdgl\WEB-INF\web.xml：
<filter> <filter-name>AuthFilter</filter-name> <filter-class>com.wdgl.filter.AuthFilter</filter-class> </filter> <filter-mapping> <filter-name>AuthFilter</filter-name> <url-pattern>/admin/*</url-pattern> </filter-mapping> <filter-mapping> <filter-name>AuthFilter</filter-name> <url-pattern>/lib/*</url-pattern> </filter-mapping>逻辑说明：
AuthFilter.class（源码在src/com/wdgl/filter/AuthFilter.java）会拦截/admin/*和/lib/*路径。它从 session 中读取userLevel属性（1=普通用户，2=文献管理员，3=系统管理员），并检查当前请求 URL 是否匹配其权限等级。例如，普通用户（level=1）访问/admin/userlist.jsp会被重定向到error.jsp。这就是为什么你用admin/024admin登录后能看到所有菜单，而libadmin/123456（默认密码在数据库users表中）只能看到/lib/下的页面。
2.5 文献上传与转换：.doc到 HTML 的黑匣子由DocConverter.class驱动
上传流程：up.jsp→UpServlet.class→SmartUpload解析文件 →DocConverter.class调用本地 Word COM 组件 → 写入documents.content_html。关键点在于DocConverter.class的调用方式：
// UpServlet.java 中的关键片段（第128行附近） DocConverter converter = new DocConverter(); String htmlContent = converter.convertDocToHtml(uploadFile.getAbsolutePath()); // ... 将 htmlContent 插入数据库参数说明：
DocConverter.class是一个封装了 JACOB（Java-COM Bridge）调用的类。它要求 Windows 系统已安装 Microsoft Office（2003 或更早版本），且jacob.dll必须放在Tomcat 5.5\bin\目录下（源码包里已包含jacob.dll）。如果上传.doc后页面卡住或报java.lang.UnsatisfiedLinkError，90% 是jacob.dll位数（32/64）与 JVM 不匹配，或 Office 未安装。
3. 三级权限落地：从数据库字段到 JSP 页面的每一处可见隔离
3.1 数据库设计：users.level字段是权限的唯一源头
wdgl数据库的users表结构决定了整个权限体系：
| 字段名 | 类型 | 说明 |
|---|---|---|
id | int (PK) | 用户ID |
username | varchar(20) | 用户名 |
password | varchar(50) | MD5 加密密码（源码中MD5Util.java实现） |
level | tinyint | 权限等级：1=普通用户，2=文献管理员，3=系统管理员 |
realname | varchar(50) | 真实姓名 |
逻辑说明：
level字段不参与任何业务逻辑计算，它只被AuthFilter读取，并传递给 JSP 页面。admin.jsp中的<c:if test="${sessionScope.userLevel == 3}">就是基于此值显示“用户管理”菜单。没有 RBAC（角色权限模型），没有权限表关联，就是最朴素的整数比较——这正是它能在老旧环境中零依赖运行的原因。
3.2 JSP 页面渲染：<c:if>标签是权限的最终执行者
以index.jsp为例，导航栏的动态生成逻辑：
<!-- index.jsp --> <c:choose> <c:when test="${sessionScope.userLevel == 3}"> <a href="admin/userlist.jsp">用户管理</a> <a href="admin/config.jsp">系统配置</a> </c:when> <c:when test="${sessionScope.userLevel == 2}"> <a href="lib/doclist.jsp">文献管理</a> <a href="lib/category.jsp">分类管理</a> </c:when> <c:otherwise> <a href="user/search.jsp">文献检索</a> <a href="user/mydocs.jsp">我的文献</a> </c:otherwise> </c:choose>关键细节：
<c:if>标签的判断依据是sessionScope.userLevel，这个值在用户登录成功后由LoginServlet.class设置：session.setAttribute("userLevel", rs.getInt("level"));。它不经过任何缓存或中间件，Session 对象本身就成了权限的“总线”。
3.3 Servlet 逻辑隔离：AdminServlet与LibServlet的职责边界
AdminServlet.class：处理/admin/*请求，负责users表的 CRUD（增删改查）、config表的读写（如系统公告）、documents表的物理删除（调用delete from documents where id=?）LibServlet.class：处理/lib/*请求，负责categories表的 CRUD、documents表的逻辑删除（设置status=0）和content_html字段更新UserServlet.class：处理/user/*请求，只读操作：SELECT * FROM documents WHERE status=1 AND (title LIKE ? OR author LIKE ?)，且禁止访问users表
排查要点：如果文献管理员能进入
/admin/userlist.jsp，一定是AuthFilter的<url-pattern>配置错误，或者web.xml中filter-mapping的顺序被其他 Filter 干扰（Tomcat 5.5 的 Filter 执行顺序严格按web.xml中声明顺序）。
3.4 文件级操作：UpServlet如何保证“删文献=删文件+删记录”
删除文献的操作在LibServlet.class中实现：
// LibServlet.java - 删除文献 String sql = "SELECT filepath FROM documents WHERE id=?"; PreparedStatement ps = conn.prepareStatement(sql); ps.setInt(1, docId); ResultSet rs = ps.executeQuery(); if(rs.next()) { String filePath = rs.getString("filepath"); // 1. 删除服务器上的物理文件 File file = new File(filePath); if(file.exists()) file.delete(); // 2. 删除数据库记录 String deleteSql = "DELETE FROM documents WHERE id=?"; PreparedStatement deletePs = conn.prepareStatement(deleteSql); deletePs.setInt(1, docId); deletePs.executeUpdate(); }参数说明：
filepath字段存储的是绝对路径（如D:/tomcat5.5/webapps/wdgl/upload/20231015123456.doc），这保证了文件删除的确定性。但这也意味着，如果 Tomcat 运行在 D 盘，而filepath指向 C 盘，删除将失败——源码中UpServlet.class的saveFile()方法会拼接request.getRealPath("/upload/")作为根目录，所以部署时必须确保wdgl应用的物理路径与数据库中filepath的前缀一致。
3.5 在线浏览实现：DocConverter输出的 HTML 如何嵌入 JSP
文献详情页docdetail.jsp的核心逻辑：
<!-- docdetail.jsp --> <c:if test="${not empty doc.content_html}"> <iframe src="view/${doc.id}.html" width="100%" height="600px" frameborder="0"></iframe> </c:if> <c:if test="${empty doc.content_html}"> <p>该文献暂不支持在线预览，请下载后使用Word打开。</p> <a href="download?docId=${doc.id}">下载原文</a> </c:if>逻辑说明：
DocConverter.class将.doc转为 HTML 后，会保存为view/123.html（doc.id=123），并更新documents.content_html字段为"123.html"。view/目录是wdgl应用下的一个普通目录，无需 Servlet 映射，浏览器可直接访问。这种静态文件托管方式，比用 Servlet 流式输出更轻量，也规避了 IE6 下response.getOutputStream()的兼容性问题。
4. 避坑指南：那些让我重启三次 Tomcat 才定位到的血泪经验
4.1 现象：访问http://localhost:8080/wdgl/显示 404，但http://localhost:8080/能看到 Tomcat 首页
原因：wdgl应用未被 Tomcat 正确识别为 Web 应用。常见于wdgl\WEB-INF\web.xml文件损坏（BOM 头、编码错误）或wdgl\WEB-INF\目录下缺少classes或lib子目录。
解决：用 Notepad++ 以 UTF-8 无 BOM 格式重新保存web.xml；检查wdgl\WEB-INF\下是否存在classes\（存放编译后的.class）和lib\（存放 jar 包）；删除Tomcat 5.5\work\Catalina\localhost\下的wdgl文件夹，重启 Tomcat。
4.2 现象：登录admin/024admin成功，但点击“用户管理”跳转到error.jsp，控制台无报错
原因：AuthFilter拦截了/admin/*，但web.xml中filter-mapping的顺序在servlet-mapping之后，导致 Filter 未生效。Tomcat 5.5 的 Filter 加载顺序严格依赖web.xml中的声明顺序。
解决：打开wdgl\WEB-INF\web.xml，将<filter>和<filter-mapping>的整个块，剪切并粘贴到<servlet>和<servlet-mapping>块之前；重启 Tomcat。
4.3 现象：上传.doc文件后，docdetail.jsp显示“暂不支持在线预览”，数据库content_html字段为空
原因：DocConverter.class调用 Word COM 组件失败。常见于：Windows 未安装 Office；Office 版本过高（2010+）不兼容 JACOB；jacob.dll与 JVM 位数不匹配（32位 JVM 需 32位 dll）；wdgl\WEB-INF\lib\jacob.jar与Tomcat 5.5\bin\jacob.dll版本不一致。
解决：在 Windows 上运行regedit，检查HKEY_CLASSES_ROOT\Word.Application是否存在；下载 JACOB 1.14.3（适配 Office 2003）；确保jacob.dll放在Tomcat 5.5\bin\下；用java -version确认 JVM 位数，下载对应jacob.dll。
4.4 现象：文献检索功能无法按“作者”或“内容”搜索，只按“题目”有效
原因：UserServlet.class中的 SQL 查询语句写死为WHERE title LIKE ?，而search.jsp表单提交的searchType参数（author/content/title）未被正确解析。源码中UserServlet.java第89行String type = request.getParameter("searchType");后，缺少if("author".equals(type)) { sql = "... author LIKE ?"; }的分支逻辑。
解决：修改UserServlet.java，在String sql = "SELECT * FROM documents WHERE status=1 AND title LIKE ?";之前，添加if("author".equals(type)) { sql = "SELECT * FROM documents WHERE status=1 AND author LIKE ?"; } else if("content".equals(type)) { sql = "SELECT * FROM documents WHERE status=1 AND content_html LIKE ?"; }；重新编译UserServlet.class并替换wdgl\WEB-INF\classes\com\wdgl\servlet\UserServlet.class。
4.5 现象：SQL Server 2000 附加wdgl_Data.MDF后，SELECT * FROM users返回空结果，或报“数据库正在使用”
原因：wdgl_Data.MDF文件被其他进程（如另一个 SQL Server 实例、文件管理器预览窗格）占用；或附加时未勾选“强制重新生成日志文件”，导致日志文件损坏。
解决：关闭所有可能访问该文件的程序（尤其是资源管理器）；在企业管理器附加时，勾选“强制重新生成日志文件”；如果仍失败，用sp_detach_db 'wdgl'命令先分离数据库，再重新附加。
5. 进阶技巧：把“老古董”变成可维护的生产力工具
5.1 数据库结构同步：用wdgl_Data.MDF生成现代 SQL 脚本
虽然系统用.MDF文件分发，但你可以把它变成可移植的CREATE TABLE脚本，方便迁移到 SQL Server 2019 或 MySQL。方法是：在 SQL Server 2000 企业管理器中，右键wdgl数据库 → “所有任务” → “生成 SQL 脚本”，勾选“为所选数据库中的所有对象编写脚本”，保存为wdgl_schema.sql。但注意，wdgl_schema.sql中的TEXT字段（如users.password）在新版 SQL Server 中应改为VARCHAR(MAX)，IMAGE字段（如documents.filedata）应改为VARBINARY(MAX)。我一般会用正则替换：
# 查找 TEXT # 替换为 VARCHAR(MAX) # 查找 IMAGE # 替换为 VARBINARY(MAX)然后在新数据库中执行修改后的脚本。这样，你就拥有了一个脱离.MDF文件、可版本控制的数据库定义。
5.2 PDF 在线预览替代方案：用wkhtmltopdf替换DocConverter
DocConverter.class依赖 Office COM，部署成本高。一个更现代的方案是：在UpServlet.class中，不调用DocConverter，而是用Runtime.getRuntime().exec()调用wkhtmltopdf命令行工具，将.doc先转为.html（用 LibreOffice headless），再转为.pdf。具体步骤：
- 下载 LibreOffice 7.4（支持 headless 转换）和
wkhtmltopdf； - 修改
UpServlet.java，在saveFile()后添加：
String htmlPath = uploadPath + "/" + fileName + ".html"; String pdfPath = uploadPath + "/" + fileName + ".pdf"; // 调用 LibreOffice 转 HTML Runtime.getRuntime().exec("soffice --headless --convert-to html --outdir " + uploadPath + " " + uploadFile.getAbsolutePath()); // 调用 wkhtmltopdf 转 PDF Runtime.getRuntime().exec("wkhtmltopdf " + htmlPath + " " + pdfPath);- 更新
documents表，将filepath指向.pdf，content_html设为空。这样，docdetail.jsp就能用<iframe src="view/xxx.pdf">直接嵌入 PDF——现代浏览器原生支持，无需插件。
5.3 权限升级：给三级管理员加“操作审计日志”
系统原版没有日志功能，但你可以用最轻量的方式加上。在AdminServlet.class的每个关键操作（如doDeleteUser）开头，插入一行：
// 记录操作日志到 audit_log 表 String logSql = "INSERT INTO audit_log (operator, action, target_id, time) VALUES (?, ?, ?, GETDATE())"; PreparedStatement logPs = conn.prepareStatement(logSql); logPs.setString(1, username); // 从 session 获取 logPs.setString(2, "delete_user"); logPs.setInt(3, userId); logPs.executeUpdate();然后在数据库中创建audit_log表：
CREATE TABLE audit_log ( id INT IDENTITY(1,1) PRIMARY KEY, operator VARCHAR(20), action VARCHAR(50), target_id INT, time DATETIME );这样，每次管理员删用户，都会在
audit_log中留下一条记录。不需要 ELK，不需要 Log4j，就是一个INSERT语句——老系统要的不是炫技，是“能用、能查、不拖慢”。
5.4 部署包瘦身：移除SmartUpload，改用commons-fileupload
SmartUpload.class是一个封闭的二进制类，无法调试。而commons-fileupload是开源的，且wdgl的UpServlet.class已经引用了commons-fileupload-1.0.jar，只是没用上。改造步骤：
- 删除
wdgl\WEB-INF\lib\smartupload.jar（如果存在）； - 修改
UpServlet.java，将com.oreilly.servlet.SmartUpload替换为org.apache.commons.fileupload.disk.DiskFileItemFactory和org.apache.commons.fileupload.servlet.ServletFileUpload； - 重写
doPost()方法，用ServletFileUpload.parseRequest(request)解析文件； - 编译后替换
UpServlet.class。 这样做的好处是：commons-fileupload的异常信息更清晰（比如FileUploadException: the request was rejected because no multipart boundary was found），排查上传失败时不再像面对黑匣子。
从那以后我每次接手一个用 SQL Server 2000 的老系统，第一件事就是翻出这个wdgl.zip，把它当成“环境探针”：能跑通，说明 JDK/Tomcat/SQL Server 的基础链路没问题；跑不通，那问题一定出在驱动、DLL 或路径上，而不是业务逻辑。它教会我的不是怎么写新代码，而是怎么读懂旧世界的契约——那些写死的路径、硬编码的密码、依赖 COM 的转换，都是特定时代的生存策略。希望帮到你。
本文还有配套的精品资源，点击获取
