coco/subjects-rw-neo4j

Subjects Reader/Writer for Neo4j（subjects-rw-neo4j）

镜像概述

本镜像提供一个API，用于向Neo4j数据库读写subjects数据，要求输入的subjects JSON格式与subjects转换器输出的格式一致。

核心功能

1. 数据操作端点：
   • PUT：创建或更新指定UUID的subject（无存在性检查，直接MERGE）
   • GET：查询指定UUID的subject数据
   • DELETE：删除指定UUID的subject
2. 管理端点：
   • 健康检查：/__health
   • 心跳检测：/ping或/__ping
3. 批量处理：支持批量请求，失败时返回500错误
4. 参数配置：通过环境变量灵活配置端口、Neo4j地址、批量大小等参数

使用场景

适用于需要与Neo4j数据库交互处理subjects数据的场景，如内容管理系统、数据分析平台、知识图谱构建工具等。

配置说明

支持的环境变量：

• PORT：应用运行端口（默认8080）
• NEO_URL：Neo4j数据库地址（默认本地7474端口）
• BATCH_SIZE：批量处理大小（默认1024）
• GRAPHITE_TCP_ADDRESS：Graphite监控地址（默认空，不发送指标）
• GRAPHITE_PREFIX：Graphite指标前缀（默认空）
• LOG_METRICS：是否记录指标（默认false）

Docker部署示例

构建镜像

bash
docker build -t coco/subjects-rw-neo4j .

运行容器

bash
docker run -ti \
  --env NEO_URL=<neo4j数据库地址> \
  --env PORT=8080 \
  --env BATCH_SIZE=50 \
  docker.xuanyuan.run/coco/subjects-rw-neo4j

示例请求

• PUT创建/更新subject：

bash
curl -XPUT -H "X-Request-Id: 123" -H "Content-Type: application/json" localhost:8080/subjects/bba39990-c78d-3629-ae83-808c333c6dbc --data '{"uuid":"bba39990-c78d-3629-ae83-808c333c6dbc","prefLabel":"Metals Markets", "alternativeIdentifiers":{"TME":["MTE3-U3ViamVjdHM="],"uuids": ["bba39990-c78d-3629-ae83-808c333c6dbc","6a2a0170-6afa-4bcc-b427-430268d2ac50"],"type":"Subject"}}'

• GET查询subject：

bash
curl -H "X-Request-Id: 123" localhost:8080/subjects/bba39990-c78d-3629-ae83-808c333c6dbc

• DELETE删除subject：

bash
curl -XDELETE -H "X-Request-Id:123" localhost:8080/subjects/bba39990-c78d-3629-ae83-808c333c6dbc