nvdk/cool-uris

cool-uris 镜像文档

镜像概述

cool-uris 是一个简单的 Web API，遵循 http://www.w3.org/TR/cooluris/%EF%BC%8C%E7%94%A8%E4%BA%8E%E4%BB%8E SPARQL 端点解引用现实世界对象。该 API 接收 "uri" 查询参数，并根据请求的 Accept 头信息及端点中的数据，自动重定向到数据视图或 HTML 视图。本镜像为 https://github.com/nvdk/cool-dereferenceable-uris 的 Scala 移植版本，已在生产环境中验证其质量。

核心功能与特性

• 遵循 cool uri 标准：实现 W3C 定义的 cool uri 策略，提供一致的资源标识
• 智能视图选择：根据请求的 Accept 头（如 text/turtle 或 text/html）自动重定向到对应的数据视图或 HTML 视图
• SPARQL 端点集成：从指定的 SPARQL 端点读取资源关联信息，动态生成重定向目标
• 生产级可靠性：已在实际生产环境中部署并验证其稳定性

使用场景

适用于需要实现 cool uri 策略的语义 Web 应用，特别适合：

• 开放数据平台需要为资源提供统一标识并根据请求类型返回不同视图
• 文化遗产、***数据等项目需同时支持机器可读数据（如 RDF）和人类可读页面（如 HTML）访问
• 任何需要基于三元组存储中资源关联信息自动处理重定向的场景

使用方法

Docker 快速启动

通过以下命令启动容器，需指定 SPARQL 端点地址：

bash
docker run -p 80:8080 --name cool-uri -e SPARQL_ENDPOINT="https://stad.gent/sparql" nvdk/cool-uris:0.1.0

基本测试

容器启动后，可通过 curl 测试 API：

bash
curl -i http://localhost/?uri=https://stad.gent/id/agents/083b7b32-df2e-4da4-bcc5-b7fe75ea8426

配置示例：实现完整重定向流程

1. 设置反向代理

配置反向代理将资源标识路径（如 /id）重定向到 cool-uris 服务。以下是 Nginx 配置示例（假设 cool-uris 服务 IP 为 172.24.0.2）：

nginx
server {
   listen      80;
   location /id {
     proxy_pass http://172.24.0.2:8080/?uri=$scheme://$host$request_uri;
   }
}

2. 配置 SPARQL 端点

在 SPARQL 端点中添加资源关联三元组，定义资源的数据视图和 HTML 视图：

<https://qa.stad.gent/id/visualart/streetart/05c7b793-b387-4b0f-b3da-63c4d3900e76> rdfs:isDefinedBy <https://qa.stad.gent/data/visualart/streetart/05c7b793-b387-4b0f-b3da-63c4d3900e76>
<https://qa.stad.gent/id/visualart/streetart/05c7b793-b387-4b0f-b3da-63c4d3900e76> foaf:page <https://cultuur.qa.stad.gent/node/341>

• rdfs:isDefinedBy：指定资源的数据视图（机器可读）
• foaf:page：指定资源的 HTML 视图（人类可读）

3. 验证重定向效果

请求数据视图（如 Turtle 格式）：

bash
curl -H "Accept: text/turtle" -i https://qa.stad.gent/id/visualart/streetart/05c7b793-b387-4b0f-b3da-63c4d3900e76

预期重定向到数据视图地址：https://qa.stad.gent/data/visualart/streetart/05c7b793-b387-4b0f-b3da-63c4d3900e76

请求 HTML 视图：

bash
curl -H "Accept: text/html" -i https://qa.stad.gent/id/visualart/streetart/05c7b793-b387-4b0f-b3da-63c4d3900e76

预期重定向到 HTML 页面地址：https://cultuur.qa.stad.gent/node/341

构建与运行

若需从源码构建：

bash
cd cool_uris
./sbt
> jetty:start
> browse

许可证

详见 LICENSE 文件。