isaitb/xml-validator

简介

!Banner

一个用于验证XML内容的Web应用，支持依据XML Schema和Schematron进行验证。验证可通过多种渠道进行：

• Web用户界面：供用户手动操作。
• REST API：用于机器间集成。
• SOAP API：用于机器间集成及在GITB TDL一致性测试用例中使用。

此镜像可作为特定验证器实例的通用基础（需提供应用配置），配置包括：

• 要使用的验证构件（一个或多个XSD和/或Schematron）。
• 自定义验证器的配置（如外观、验证类型及选项）。

此外，也可使用此镜像创建通用验证器，其具有最小默认设置，需在待验证输入旁提供Schema和/或Schematron规则。

此镜像由欧盟委员会DIGIT部门（具体为互操作性测试平台）维护，该平台为参与跨境公共服务交付的项目提供一致性测试服务。更多信息见此处。

使用方法

此镜像可作为构建特定验证器（基于您自己的配置）的基础，或直接用作通用验证器（需与待验证内容一同提供验证构件，如现有服务）。

选项1：创建特定验证器

创建特定验证器可通过构建包含您配置的自定义镜像，或向基于基础镜像构建的容器传递配置来实现。无论哪种方式，验证器应用内部暴露端口8080。

在镜像版本选择方面，您可以使用latest标签以获取快速更新，或如果稳定性最重要，则使用特定的发布里程碑标签。

方法1：使用自定义镜像

假设您从包含所有配置资源的文件夹构建，资源位于子文件夹resources中，示例Dockerfile如下：

dockerfile
FROM isaitb/xml-validator:latest
COPY resources /validator/resources/
ENV validator.resourceRoot /validator/resources/

方法2：直接使用基础镜像

此方法需使用卷（命名卷或卷）。使用卷创建容器的命令如下：

bash
docker run -d --name my-validator -p 8080:8080 \
             -v /validator/resources:/validator/resources/ \
             -e validator.resourceRoot=/validator/resources/  \
             isaitb/xml-validator

选项2：创建通用验证器

通用验证器实例没有预定义配置，具有默认最小配置，需与待验证输入一同提供XML Schema和/或Schematron规则。创建通用验证器实例只需直接使用当前镜像：

bash
docker run -d --name my-validator -p 8080:8080 isaitb/xml-validator

文档

有关使用此镜像构建验证器的设置、配置和管理的完整详细信息，请参阅测试平台的XML验证指南。

源代码

XML验证器作为开源软件发布在https://github.com/ISAITB/xml-validator%E4%B8%8A%E3%80%82

变更历史

最新快照和各个里程碑版本的变更列表可在文档的变更日志中查看。

许可证

本工具采用欧盟公共许可证（EUPL）1.2版共享。

本软件中包含的第三方库的许可证和归属信息见https://github.com/ISAITB/xml-validator/blob/master/THIRD_PARTY_LICENCES.md%E3%80%82

***声明

本工具的作者不对其使用或结果解释承担任何责任。在数据方面，本工具不会收集、处理任何可能与用户或工作站相关的数据，也不会保留任何使用产生的状态或统计信息。

联系方式

如需反馈或提问，请通过以下渠道联系：

• 在验证器的https://github.com/ISAITB/xml-validator/issues%E5%88%9B%E5%BB%BAissue%E3%80%82
• 发送邮件至***。

相关链接

如果您对本镜像感兴趣，可能还会对我们针对其他语法的类似验证器感兴趣：

• SHACL验证器(https://hub.docker.com/r/isaitb/shacl-validator)%EF%BC%9A%E4%BD%BF%E7%94%A8SHACL%E9%AA%8C%E8%AF%81RDF%E6%95%B0%E6%8D%AE%E3%80%82
• JSON验证器(https://hub.docker.com/r/isaitb/json-validator)%EF%BC%9A%E4%BD%BF%E7%94%A8JSON Schema验证JSON数据。
• CSV验证器(https://hub.docker.com/r/isaitb/csv-validator)%EF%BC%9A%E4%BD%BF%E7%94%A8Table Schema验证CSV数据。