DSpace

DSpace 文档 | DSpace 版本发布 | DSpace Wiki | 支持

概述

DSpace 开源软件是一个开箱即用的仓储（Repository）应用程序，全球超过 2,000 个组织和机构使用它来提供对数字资源的持久访问。更多信息，请访问 http://www.dspace.org/

DSpace 由基于 Java 的后端和基于 Angular 的前端组成。

后端（本代码库）提供 REST API，以及其他基于机器的接口（例如 OAI-PMH、SWORD 等）
- REST 契约位于 https://github.com/DSpace/RestContract
前端（https://github.com/DSpace/dspace-angular/）是基于 REST API 构建的用户界面

旧版本的 DSpace（v6.x 及更低版本）使用了两种不同的用户界面（XMLUI 和 JSPUI）。这些界面在 v7 及以上版本中不再受支持。

旧版本的维护分支仍然可用，6.x 的维护分支请参见 dspace-6_x。

下载

后端（REST API）：https://github.com/DSpace/DSpace/releases
前端（用户界面）：https://github.com/DSpace/dspace-angular/releases

文档 / 安装

每个版本的文档都可以通过我们的文档 Wiki 在线查看或下载。

最新的 DSpace 安装说明请参见： https://wiki.lyrasis.org/display/DSDOC9x/Installing+DSpace

请注意，作为一个 Java Web 应用程序，DSpace 需要数据库（PostgreSQL）和 Servlet 容器（通常是 Tomcat）才能运行。有关这些及其他所有先决条件的更多信息，请参阅上面的安装说明。

在 Docker 中运行 DSpace 9

注意：目前，我们还没有可用于生产的 DSpace Docker 镜像。也就是说，我们确实提供了用于开发或测试目的的快速启动 Docker Compose 脚本。

请参阅使用 Docker Compose 运行 DSpace 9

贡献

请参阅贡献文档

获取帮助

DSpace 提供公共邮件列表，您可以在其中发布问题或提出讨论主题。我们欢迎所有人参与这些列表：

[email protected]：关于 DSpace 平台的一般性讨论、公告、最佳实践分享
[email protected]：技术支持邮件列表。另请参阅我们的如何排查错误指南。
[email protected]：开发人员/开发邮件列表

在 Stackoverflow 上的 DSpace 标签下也有大量优质的问答。

其他支持选项请参见 https://wiki.lyrasis.org/display/DSPACE/Support

DSpace 还拥有一个活跃的服务提供商网络。如果您更愿意聘请服务提供商来安装、升级、定制或托管 DSpace，那么我们建议您联系我们的注册服务提供商之一。

问题跟踪器

DSpace 使用 GitHub 跟踪问题：

后端（REST API）问题：https://github.com/DSpace/DSpace/issues
前端（用户界面）问题：https://github.com/DSpace/dspace-angular/issues

测试

运行测试

默认情况下，DSpace 中的单元测试和集成测试处于禁用状态。但是，GitHub Actions 会对所有 Pull Request 和代码提交自动运行这些测试。

如何同时运行单元测试（通过 maven-surefire-plugin）和集成测试（通过 maven-failsafe-plugin）：
```
mvn install -DskipUnitTests=false -DskipIntegrationTests=false
```
如何仅运行单元测试：
```
mvn test -DskipUnitTests=false
```

如何运行单个单元测试

# 运行特定测试类中的所有测试
# 注意：必需指定 failIfNoTests=false，以跳过其他模块中的测试
mvn test -DskipUnitTests=false -Dtest=[full.package.testClassName] -DfailIfNoTests=false

# 运行特定测试类中的一个测试方法
mvn test -DskipUnitTests=false -Dtest=[full.package.testClassName]#[testMethodName] -DfailIfNoTests=false

如何仅运行集成测试

mvn install -DskipIntegrationTests=false

如何运行单个集成测试

# 运行特定测试类中的所有集成测试
# 注意：必需指定 failIfNoTests=false，以跳过其他模块中的测试
mvn install -DskipIntegrationTests=false -Dit.test=[full.package.testClassName] -DfailIfNoTests=false

# 运行特定测试类中的一个测试方法
mvn install -DskipIntegrationTests=false -Dit.test=[full.package.testClassName]#[testMethodName] -DfailIfNoTests=false

如何仅运行特定 DSpace 模块的测试

# 在您只能运行一个模块的测试之前，其他模块可能需要先安装到您的 ~/.m2 中
cd [dspace-src]
mvn clean install

# 然后，进入某个模块的子目录，并运行测试命令
cd [dspace-src]/dspace-server-webapp
# 从上面的列表中选择您的测试命令

许可证

DSpace 源代码在标准的 BSD 3-Clause 许可证下免费提供。完整许可证见 LICENSE 文件，或在线查看 http://www.dspace.org/license/

DSpace 使用了可能在不同许可证下分发的第三方库。这些许可证列于 LICENSES_THIRD_PARTY 文件中。

DSpace__DSpace_CVE-2022-31192_5-100

最受欢迎