Как внедрить XSLT-преобразование DocBook в веб-приложение Java?

Я думаю, что есть несколько способов сделать это. Один из способов сделать это — добавить поддержку доступа к ресурсам в пути к классам по URL-адресам. Таким образом, вы можете указать на таблицы стилей в своем пути к классам с помощью URL-адреса без необходимости иметь каталог.

Вы можете сделать это, например, зарегистрировав приведенный ниже класс как реализацию URLStreamHandlerProvider. Реализация адаптирована из этого ответа, но изменена для поддержки необязательной косой черты в начале URL-адреса, а также изменена для использования имени схемы cp: вместо более обычного classpath:.

• Начальная косая черта полезна в URL-адресах, чтобы они обрабатывались как иерархические URL-адреса, чтобы можно было разрешить относительные ссылки.
• Изменение имени схемы (протокола) на cp: связано с тем, что Saxon-HE (по крайней мере, версия 12.3), по-видимому, имеет обходной путь, специфичный для URL-адресов classpath:, что вызывает проблему с удалением начального слэша из пути, когда он разрешает относительные classpath: URL-адреса.

В Java 9 и выше вы можете зарегистрировать провайдера, указав полное имя класса в файле конфигурации META-INF/services/java.net.spi.URLStreamHandlerProvider.

С этим вы сможете указывать на свои таблицы стилей с помощью URL-адреса, например cp:/xsl/docbook-xsl-1.79.2/html/docbook.xsl, и заставить его работать без каталога, включая относительный импорт, до тех пор, пока ваш XSLT-процессор использует (или, по крайней мере, возвращается) этот метод разыменования. URL-адреса. Судя по быстрому тесту, этот подход работает по крайней мере с XSLT-процессорами Xalan-Java и Saxon-HE. (Я думаю, что процессор XSLT по умолчанию, включенный в Java, может иметь некоторые проблемы при использовании таблиц стилей docbook-xsl.)

package com.stackoverflow.q76848364;

import java.io.IOException;
import java.net.URL;
import java.net.URLConnection;
import java.net.URLStreamHandler;
import java.net.spi.URLStreamHandlerProvider;

/**
 * URL stream handler for "cp:/" URLs for accessing resources in the classpath.
 * Supports a leading slash in the the path so that the scheme is treated as a
 * hierarchical scheme for resolving relative URL references.
 * 
 * <p>
 * Register this provider by putting the fully qualified name of this class in
 * the configuration file
 * META-INF/services/java.net.spi.URLStreamHandlerProvider.
 */
public class ClasspathURLStreamHandlerProvider extends URLStreamHandlerProvider {

    private static final String PROTOCOL = "cp";

    @Override
    public URLStreamHandler createURLStreamHandler(String protocol) {
        if (PROTOCOL.equals(protocol)) {
            return new URLStreamHandler() {
                @Override
                protected URLConnection openConnection(URL url) throws IOException {
                    String urlPath = url.getPath();
                    String resourcePath = urlPath.startsWith("/") ? urlPath.substring(1) : urlPath;
                    return ClassLoader.getSystemClassLoader().getResource(resourcePath).openConnection();
                }
            };
        }
        return null;
    }

}

Отредактировано для добавления: Предупреждение о разрешении относительных ссылок URI в Java.

При работе с относительными ссылками URI в Java обратите внимание, что в методе java.net.URI.resolve() есть ошибка, которая влияет на разрешение ссылок относительных URI, когда относительный URI пуст (баг JDK-8218962 в базе данных ошибок Java). Таблицы стилей docbook-xsl полагаются на то, что это работает правильно, поэтому возникнут проблемы, если кто-то попытается использовать что-либо, зависящее от класса java.net.URI для этой функциональности. Поскольку и Xalan-Java, и Saxon-HE работают нормально, они должны использовать что-то другое.

Отредактировано для добавления (2): Демонстрация

Я создал пул реквест здесь, демонстрируя это решение на предоставленном минимальном примере. (Исходный пример был настроен на Java 8. Поскольку метод регистрации реализации URLStreamHandler отличается для Java 8 и Java 9+, вместо этого я изменил цель компиляции на Java 9, чтобы продемонстрировать новый подход.)