虽然编写 Saxon 集成扩展函数对我来说非常清楚。
我有红色:
我很难找到如何让它们真正发挥作用的信息。
问:文件放在哪里,我需要遵守什么,我需要编辑 saxon 配置吗?基本上,除了使用 s9api 处理器注册扩展功能之外,我还需要做什么才能使其工作。
TestMain.java - 一些可以访问转换工厂的java文件
import javax.xml.transform.*;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;
import java.io.File;
import java.io.IOException;
import java.net.URISyntaxException;
import net.sf.saxon.TransformerFactoryImpl;
import net.sf.saxon.s9api.ExtensionFunction;
import net.sf.saxon.s9api.Processor;
import net.sf.saxon.jaxp.SaxonTransformerFactory;
import location.to.test.java.file.Test;
public class TestMain {
public static void main(String[] args) throws IOException, URISyntaxException, TransformerException {
TransformerFactory factory = TransformerFactory.newInstance();
// Grab the handle of Transformer factory and cast it to TransformerFactoryImpl
TransformerFactoryImpl tFactoryImpl = (TransformerFactoryImpl) factory;
// Get the currently used processor
net.sf.saxon.Configuration saxonConfig = tFactoryImpl.getConfiguration();
Processor processor = (Processor) saxonConfig.getProcessor();
// Here extension happens, test comes from class Test -> Test.java
ExtensionFunction test = new Test();
processor.registerExtensionFunction(test);
Source xslt = new StreamSource(new File("test.xsl"));
Transformer transformer = factory.newTransformer(xslt);
Source text = new StreamSource(new File("input.xml"));
transformer.transform(text, new StreamResult(new File("result.xml")));
}
}
Test.java - 实际的扩展功能逻辑
import net.sf.saxon.s9api.ExtensionFunction;
import net.sf.saxon.s9api.ItemType;
import net.sf.saxon.s9api.OccurrenceIndicator;
import net.sf.saxon.s9api.QName;
import net.sf.saxon.s9api.SaxonApiException;
import net.sf.saxon.s9api.SequenceType;
import net.sf.saxon.s9api.XdmAtomicValue;
import net.sf.saxon.s9api.XdmValue;
public class Test implements ExtensionFunction {
@Override
public QName getName() {
return new QName("http://some.namespace.com", "test");
}
@Override
public SequenceType getResultType() {
return SequenceType.makeSequenceType(ItemType.STRING, OccurrenceIndicator.ONE);
}
@Override
public net.sf.saxon.s9api.SequenceType[] getArgumentTypes() {
return new SequenceType[] {};
}
@Override
public XdmValue call(XdmValue[] arguments) throws SaxonApiException {
String result = "Saxon is being extended correctly.";
return new XdmAtomicValue(result);
}
}
test.xsl - 测试 xsl。文件
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="2.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:ext="http://some.namespace.com">
<xsl:output indent="yes"/>
<xsl:template match="/">
<root>
<xsl:value-of select="ext:test()" />
</root>
</xsl:template>
</xsl:stylesheet>
result.xml - 整个过程的结果
<?xml version="1.0" encoding="UTF-8"?>
<root>Saxon is being extended correctly.</root>
请注意,.java 和 .xsl 文件中使用的命名空间必须相同,在 QName 中声明
作为我长期寻找如何添加扩展的一部分,@Piotr 是非常重要的一步。对我来说,最后一步是如何将扩展与现有引擎集成。要使用现有的命令行界面,您需要扩展 net.sf.saxon.Transform 在本例中为 com.example.ExampleTransform (对于 Saxon-HE-11.6):
package com.example;
import net.sf.saxon.Transform;
import net.sf.saxon.Configuration;
import net.sf.saxon.s9api.Processor;
public class ExampleTransform extends Transform {
public static void main(String[] args) {
new ExampleTransform().doTransform(args);
}
@Override
protected void initializeConfiguration(Configuration config) {
Processor processor = (Processor)config.getProcessor();
processor.registerExtensionFunction(new Test());
}
}