数字档案馆系统二次开发零门槛完整实操落地指南

一、前期环境准备

需安装3项核心工具，直接复制命令执行即可：JDK 1.8（下载地址：https://download.oracle.com/otn/java/jdk/8u391-b13/jdk-8u391-linux-x64.tar.gz）、Maven 3.6.3、Git。

安装命令（Linux环境，Windows可对应替换）： ``` JDK解压配置 tar -zxvf jdk-8u391-linux-x64.tar.gz -C /usr/local/ echo 'export JAVA_HOME=/usr/local/jdk1.8.0_391' >> /etc/profile echo 'export PATH=$JAVA_HOME/bin:$PATH' >> /etc/profile source /etc/profile Maven安装 wget https://archive.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz tar -zxvf apache-maven-3.6.3-bin.tar.gz -C /usr/local/ echo 'export MAVEN_HOME=/usr/local/apache-maven-3.6.3' >> /etc/profile echo 'export PATH=$MAVEN_HOME/bin:$PATH' >> /etc/profile source /etc/profile Git安装 yum install git -y ```

环境验证：打开终端，依次执行java -version、mvn -v、git --version，全部返回对应版本号即为成功。

二、现有数字档案馆系统源码拉取与编译

2.1 拉取稳定分支源码

使用国内Gitee镜像加速克隆DSpace 6.x稳定分支（国内最常用的开源数字档案馆框架）： ``` git clone https://gitee.com/apache/dspace.git -b dspace-6_x --depth=1 cd dspace ```

--depth=1参数仅拉取最新提交，减少代码体积，避免克隆慢。

2.2 编译生成可部署包

在dspace目录执行编译命令，跳过测试节省时间： ``` mvn package -Dmaven.test.skip=true ```

编译完成后，在dspace/target/目录会生成dspace-installer-6.0-buildComplete.zip，该包为可直接部署的完整文件。

三、核心定制功能开发（示例：新增时间筛选）

假设需求：为档案查询页面添加「按形成时间筛选」功能，所有代码定制不修改官方源码，避免后续升级冲突。

3.1 后端接口新增筛选逻辑

打开后端服务类文件dspace-api/src/main/java/org/dspace/submit/ArchiveItemManager.java，添加以下方法： ```java import java.sql.Connection; import java.sql.PreparedStatement; import java.sql.ResultSet; import java.sql.SQLException; import java.text.SimpleDateFormat; import java.util.ArrayList; import java.util.Date; import java.util.List; public class ArchiveItemManager { // 新增时间筛选方法 public List getItemsByCreationTime(Context context, Date startDate, Date endDate) throws SQLException { List itemList = new ArrayList<>(); Connection conn = DBManager.getConnection(context); // SQL匹配档案形成时间元数据字段（标准DSpace字段） String sql = "SELECT item_id FROM metadatavalue WHERE metadata_field_id = (SELECT metadata_field_id FROM metadatafieldregistry WHERE element = 'date' AND qualifier = 'created') AND text_value BETWEEN ? AND ?"; PreparedStatement pstmt = conn.prepareStatement(sql); SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd"); pstmt.setString(1, sdf.format(startDate)); pstmt.setString(2, sdf.format(endDate)); ResultSet rs = pstmt.executeQuery(); while (rs.next()) { itemList.add(Item.find(context, rs.getInt("item_id"))); } // 关闭资源 rs.close(); pstmt.close(); conn.close(); return itemList; } } ```

3.2 前端页面新增筛选控件

打开前端查询页面dspace-xui/src/webapp/jsp/submit/query.jsp，在搜索栏后添加时间筛选控件： ```html

在页面末尾添加对应的JS函数，触发筛选： ```javascript // 时间筛选JS函数 function searchByTime() { const start = document.getElementById('startDate').value; const end = document.getElementById('endDate').value; if (!start || !end) { alert("请选择完整的时间范围"); return; } window.location.href = `query.jsp?startDate=${start}&endDate=${end}`; } ```

四、修改代码编译与部署

将修改后的代码重新编译，指定部署路径（替换为你实际的DSpace部署路径，默认通常为/usr/local/dspace）： ``` cd dspace mvn package -Dmaven.test.skip=true -Ddspace.install.dir=/usr/local/dspace ```

执行部署命令，自动替换原有文件： ``` mvn dspace:deploy ```

重启Tomcat服务使配置生效： ``` systemctl restart tomcat ```

五、功能测试验证

打开浏览器访问数字档案馆地址（默认：http://你的服务器IP:8080/xmlui），进入档案查询页面。

选择时间范围后点击「筛选」，若页面返回对应时间区间的档案列表，无报错则功能正常；若出现报错，查看Tomcat日志排查： ``` cat /var/log/tomcat/catalina.out ```