Путь JSON: как преобразовать ссылки URN в локальные ссылки

Возможно, существуют более эффективные способы решения этой проблемы, но одно из возможных решений таково:

Используйте рекурсивный метод для преобразования ссылок стиля urn в локальные ссылки:

Вот рекурсивный метод с использованием библиотеки Джексона:

private static final String ITEMS = "items";
private static final String ID = "id";
private static final String PROPERTIES = "properties";
private static final String ADDITIONAL_PROPERTIES = "additionalProperties";
private static final String REF = "$ref";

private static void parseReferences(JsonNode jsonNode, String path) {
    if (jsonNode.has(ID)) {
        typeMap.put(jsonNode.get(ID).asText(), path);
        final JsonNode properties = jsonNode.get(PROPERTIES);
        final Iterator<Map.Entry<String, JsonNode>> fields = properties.fields();
        path += "/" + PROPERTIES;

        while (fields.hasNext()) {
            Map.Entry<String, JsonNode> entry = fields.next();
            parseReferences(entry.getValue(), path + "/" + entry.getKey());
        }
    } else if (jsonNode.has(ITEMS)) {
        final JsonNode item = jsonNode.get(ITEMS);
        parseReferences(item, path + "/" + ITEMS);
    } else if (jsonNode.has(REF)) {
        ObjectNode objectNode = (ObjectNode) jsonNode;
        objectNode.set(REF, new TextNode(typeMap.get(jsonNode.get(REF).asText())));
    } else if (jsonNode.has(ADDITIONAL_PROPERTIES)) {
        JsonNode additionalProperties = jsonNode.get(ADDITIONAL_PROPERTIES);
        parseReferences(additionalProperties, path + "/" + ADDITIONAL_PROPERTIES);
    }
}

Вот как я вызываю этот метод после создания экземпляра парсера JAXB:

private static void writeSchemaToFile(ObjectMapper jaxbObjectMapper, String origPath, String path) throws Exception {
    InputStream resourceAsStream = Thread.currentThread().getContextClassLoader().getResourceAsStream(origPath);
    try (Reader r = new InputStreamReader(resourceAsStream, "UTF-8")) {
        JsonNode root = jaxbObjectMapper.readTree(r);
        parseReferences(root, "#");
        String changedJson = jaxbObjectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(root);
        final Path targetPath = Paths.get(path);
        if (!Files.exists(targetPath)) {
            Path parent = targetPath.getParent();
            if (parent != null) {
                Files.createDirectories(parent);
            }
        }
        try (Writer writer = Files.newBufferedWriter(targetPath, Charset.forName("UTF-8"), StandardOpenOption.CREATE)) {
            writer.write(changedJson);
        }
    }
}

Если вы вызовете этот метод, он преобразует JSON, указанный в вопросе, в:

"remarkFields" : {
  "type" : "object",
  "additionalProperties" : {
    "type" : "array",
    "items" : {
      "type" : "object",
      "id" : "urn:jsonschema:com:lumina:pnr:model:FileFinishingField",
      "properties" : {
        "lineNumber" : {
          "type" : "integer"
        },
        "name" : {
          "type" : "string"
        },
        "value" : {
          "type" : "string"
        },
        "references" : {
          "type" : "array",
          "items" : {
            "type" : "object",
            "$ref" : "#/properties/passengers/items/properties/reference"
          }
        }
      }
    }
  }
}