Package org.frankframework.util

Class TransformerPool

java.lang.Object

org.frankframework.util.TransformerPool

public class TransformerPool
extends Object

Pool of transformers. As of IBIS 4.2.e the Templates object is used to improve performance and work around threading problems with the api.

Author:

Gerrit van Brakel

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	TransformerPool.OutputType

Field Summary

Fields

Modifier and Type	Field	Description
protected static org.apache.logging.log4j.Logger	log

Method Summary

Modifier and Type	Method	Description
void	close()	Closing the Pool doesn't automatically mean all references remaining in the pool will be terminated.
static TransformerPool	configureStyleSheetTransformer(FrankElement scopeProvider, String styleSheetName, int xsltVersion)
static TransformerPool	configureTransformer(FrankElement scopeProvider, String namespaceDefs, String xPathExpression, String styleSheetName, TransformerPool.OutputType outputType, boolean includeXmlDeclaration, ParameterList params)
static TransformerPool	configureTransformer(FrankElement scopeProvider, String namespaceDefs, String xPathExpression, String styleSheetName, TransformerPool.OutputType outputType, boolean includeXmlDeclaration, ParameterList params, boolean mandatory)
static TransformerPool	configureTransformer0(FrankElement scopeProvider, String namespaceDefs, String xPathExpression, String styleSheetName, TransformerPool.OutputType outputType, boolean includeXmlDeclaration, ParameterList params, int xsltVersion)
protected Transformer	createTransformer()
protected Map<String,String>	getConfigMap()
Boolean	getDisableOutputEscaping()
Boolean	getIndent()
static TransformerPool	getInstance(String xsltString, int xsltVersion, IScopeProvider scopeProvider)	Get an instance of a TransformerPool that can load additional resources such as referenced URIs from the provided IScopeProvider.
static TransformerPool	getInstance(Resource resource)	Get a TransformerPool instance that loads its XSLT stylesheet from the given resource.
static TransformerPool	getInstance(Resource resource, int xsltVersion)	Get a TransformerPool instance that loads its XSLT stylesheet from the given resource.
Boolean	getOmitXmlDeclaration()
String	getOutputMethod()
protected Transformer	getTransformer()
TransformerFilter	getTransformerFilter(ThreadConnector<?> threadConnector, ContentHandler handler)
TransformerFilter	getTransformerFilter(ContentHandler handler)
TransformerFilter	getTransformerFilter(ContentHandler handler, boolean removeNamespacesFromInput, boolean handleLexicalEvents)
static TransformerPool	getUtilityInstance(String xsltString, int xsltVersion)	Special utility method to create a new TransformerPool without a ClassLoader.
static TransformerPool	getXPathTransformerPool(String xpathExpression, int xsltVersion)
static TransformerPool	getXPathTransformerPool(String namespaceDefs, String xpathExpression, TransformerPool.OutputType outputMethod)
static TransformerPool	getXPathTransformerPool(String namespaceDefs, String xPathExpression, TransformerPool.OutputType outputType, boolean includeXmlDeclaration, ParameterList params)
static TransformerPool	getXPathTransformerPool(String namespaceDefs, String xPathExpression, TransformerPool.OutputType outputType, boolean includeXmlDeclaration, ParameterList params, int xsltVersion)
protected void	invalidateTransformer(Transformer t)
protected void	invalidateTransformerNoThrow(Transformer transformer)
void	open()
protected void	releaseTransformer(Transformer t)
void	transform(Source s, Result r, Map<String,Object> parameters)
Message	transform(Message message)
Message	transform(Message m, Map<String,Object> parameterMap)	Transforms Frank messages.
Message	transform(Message message, ParameterValueList pvl)
String	transformToString(String s)
String	transformToString(String s, Map<String,Object> parameters)
String	transformToString(String s, Map<String,Object> parameters, boolean namespaceAware)
String	transformToString(Source s)
String	transformToString(Source s, Map<String,Object> parameters)
String	transformToString(Message input)
String	transformToString(Message m, Map<String,Object> parameters, boolean namespaceAware)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

log

protected static org.apache.logging.log4j.Logger log

Method Details

getInstance

public static TransformerPool getInstance(@Nonnull
 String xsltString,
 int xsltVersion,
 @Nullable
 IScopeProvider scopeProvider)
                                   throws TransformerConfigurationException

Get an instance of a TransformerPool that can load additional resources such as referenced URIs from the provided IScopeProvider. WARNING: This should only be used to be able to load Configuration-specific resources in dynamically loaded configurations. This should not be used for application-wide transformer pools.

Parameters:

xsltString - The XSLT to be evaluated, as string

xsltVersion - Version of XSLT. Can be 0, 1, or 2. If 0, the actual version will be extracted from the stylesheet at a performance-penalty.

scopeProvider - The IScopeProvider for loading additional resources

Returns:

A TransformerPool instance for the input stylesheet.

Throws:

TransformerConfigurationException

getUtilityInstance

public static TransformerPool getUtilityInstance(@Nonnull
 String xsltString,
 int xsltVersion)
                                          throws TransformerConfigurationException

Special utility method to create a new TransformerPool without a ClassLoader. Utility pools should never use configuration classloaders, instead always read from the classpath! Utility pools should always be cached statically for re-use. The caller-code is responsible for this.

Throws:

TransformerConfigurationException

getInstance

public static TransformerPool getInstance(@Nonnull
 Resource resource)
                                   throws TransformerConfigurationException,
IOException

Get a TransformerPool instance that loads its XSLT stylesheet from the given resource. The XSLT version will be dynamically derived from the stylesheet, at a performance penalty.

Parameters:

resource - Resource from which to load the stylesheet

Returns:

TransformerPool instance for the XSLT stylesheet.

Throws:

TransformerConfigurationException - Thrown if there was an exception creating the TransformerPool or parsing the XSLT stylesheet

IOException - Thrown if the resource cannot be loaded

getInstance

public static TransformerPool getInstance(@Nonnull
 Resource resource,
 int xsltVersion)
                                   throws TransformerConfigurationException,
IOException

Get a TransformerPool instance that loads its XSLT stylesheet from the given resource. The XSLT version in the stylesheet should match the xlstVersion parameter, or be 0 for dynamic derivation at a performance penalty.

Parameters:

resource - The Resource from which to load the XSLT stylesheet

xsltVersion - The XSLT version of the stylesheet. Can be 0, 1, or 2. If 0, the actual version will be dynamically derived from the stylesheet itself on creation at a cost in performance.

Returns:

TransformerPool instance for the XSLT stylesheet.

Throws:

TransformerConfigurationException - Thrown if there was an exception creating the TransformerPool or parsing the XSLT stylesheet

IOException - Thrown if the resource cannot be loaded

configureTransformer

@Nullable
public static TransformerPool configureTransformer(@Nullable
 FrankElement scopeProvider,
 @Nullable
 String namespaceDefs,
 @Nullable
 String xPathExpression,
 @Nullable
 String styleSheetName,
 @Nonnull
 TransformerPool.OutputType outputType,
 boolean includeXmlDeclaration,
 @Nullable
 ParameterList params,
 boolean mandatory)
                                            throws ConfigurationException

Throws:

ConfigurationException

configureTransformer

@Nonnull
public static TransformerPool configureTransformer(@Nullable
 FrankElement scopeProvider,
 @Nullable
 String namespaceDefs,
 @Nullable
 String xPathExpression,
 @Nullable
 String styleSheetName,
 @Nullable
 TransformerPool.OutputType outputType,
 boolean includeXmlDeclaration,
 @Nullable
 ParameterList params)
                                            throws ConfigurationException

Throws:

ConfigurationException

configureTransformer0

@Nonnull
public static TransformerPool configureTransformer0(@Nullable
 FrankElement scopeProvider,
 @Nullable
 String namespaceDefs,
 @Nullable
 String xPathExpression,
 @Nullable
 String styleSheetName,
 @Nonnull
 TransformerPool.OutputType outputType,
 boolean includeXmlDeclaration,
 @Nullable
 ParameterList params,
 int xsltVersion)
                                             throws ConfigurationException

Throws:

ConfigurationException

configureStyleSheetTransformer

@Nonnull
public static TransformerPool configureStyleSheetTransformer(@Nullable
 FrankElement scopeProvider,
 @Nullable
 String styleSheetName,
 int xsltVersion)
                                                      throws ConfigurationException

Throws:

ConfigurationException

getXPathTransformerPool

@Nonnull
public static TransformerPool getXPathTransformerPool(@Nonnull
 String xpathExpression,
 int xsltVersion)
                                               throws TransformerConfigurationException

Throws:

TransformerConfigurationException

getXPathTransformerPool

@Nonnull
public static TransformerPool getXPathTransformerPool(@Nullable
 String namespaceDefs,
 @Nonnull
 String xpathExpression,
 @Nonnull
 TransformerPool.OutputType outputMethod)
                                               throws TransformerConfigurationException

Throws:

TransformerConfigurationException

getXPathTransformerPool

@Nonnull
public static TransformerPool getXPathTransformerPool(@Nullable
 String namespaceDefs,
 @Nonnull
 String xPathExpression,
 @Nonnull
 TransformerPool.OutputType outputType,
 boolean includeXmlDeclaration,
 @Nullable
 ParameterList params)
                                               throws TransformerConfigurationException

Throws:

TransformerConfigurationException

getXPathTransformerPool

@Nonnull
public static TransformerPool getXPathTransformerPool(@Nullable
 String namespaceDefs,
 @Nonnull
 String xPathExpression,
 @Nonnull
 TransformerPool.OutputType outputType,
 boolean includeXmlDeclaration,
 @Nullable
 ParameterList params,
 int xsltVersion)
                                               throws TransformerConfigurationException

Throws:

TransformerConfigurationException

open

public void open()

close

public void close()

Closing the Pool doesn't automatically mean all references remaining in the pool will be terminated. After closing, manually releases any associated resources in the pool

getTransformer

@Nonnull
protected Transformer getTransformer()
                              throws TransformerConfigurationException

Throws:

TransformerConfigurationException

releaseTransformer

protected void releaseTransformer(Transformer t)
                           throws TransformerConfigurationException

Throws:

TransformerConfigurationException

invalidateTransformer

protected void invalidateTransformer(Transformer t)
                              throws Exception

Throws:

Exception

invalidateTransformerNoThrow

protected void invalidateTransformerNoThrow(Transformer transformer)

createTransformer

protected Transformer createTransformer()
                                 throws TransformerConfigurationException

Throws:

TransformerConfigurationException

transformToString

public String transformToString(Message m,
 Map<String,Object> parameters,
 boolean namespaceAware)
                         throws TransformerException,
IOException,
SAXException

Throws:

TransformerException

IOException

SAXException

transformToString

public String transformToString(String s)
                         throws TransformerException,
IOException,
SAXException

Throws:

TransformerException

IOException

SAXException

transformToString

public String transformToString(String s,
 Map<String,Object> parameters)
                         throws TransformerException,
IOException,
SAXException

Throws:

TransformerException

IOException

SAXException

transformToString

public String transformToString(String s,
 Map<String,Object> parameters,
 boolean namespaceAware)
                         throws TransformerException,
IOException,
SAXException

Throws:

TransformerException

IOException

SAXException

transformToString

public String transformToString(Source s)
                         throws TransformerException,
IOException

Throws:

TransformerException

IOException

transformToString

public String transformToString(Source s,
 Map<String,Object> parameters)
                         throws TransformerException,
IOException

Throws:

TransformerException

IOException

transformToString

public String transformToString(@Nonnull
 Message input)
                         throws TransformerException,
IOException,
SAXException

Throws:

TransformerException

IOException

SAXException

transform

@Nonnull
public Message transform(@Nonnull
 Message message)
                  throws IOException,
TransformerException,
SAXException

Throws:

IOException

TransformerException

SAXException

transform

@Nonnull
public Message transform(@Nonnull
 Message message,
 @Nullable
 ParameterValueList pvl)
                  throws IOException,
TransformerException,
SAXException

Throws:

IOException

TransformerException

SAXException

transform

@Nonnull
public Message transform(@Nonnull
 Message m,
 @Nullable
 Map<String,Object> parameterMap)
                  throws IOException,
TransformerException,
SAXException

Transforms Frank messages.

Throws:

IOException

TransformerException

SAXException

transform

public void transform(@Nonnull
 Source s,
 @Nonnull
 Result r,
 Map<String,Object> parameters)
               throws TransformerException,
IOException

Throws:

TransformerException

IOException

getTransformerFilter

public TransformerFilter getTransformerFilter(@Nonnull
 ContentHandler handler)
                                       throws TransformerConfigurationException

Throws:

TransformerConfigurationException

getTransformerFilter

public TransformerFilter getTransformerFilter(@Nonnull
 ContentHandler handler,
 boolean removeNamespacesFromInput,
 boolean handleLexicalEvents)
                                       throws TransformerConfigurationException

Throws:

TransformerConfigurationException

getTransformerFilter

public TransformerFilter getTransformerFilter(@Nonnull
 ThreadConnector<?> threadConnector,
 @Nonnull
 ContentHandler handler)
                                       throws TransformerConfigurationException

Throws:

TransformerConfigurationException

getConfigMap

@Nonnull
protected Map<String,String> getConfigMap()
                                   throws TransformerException,
IOException

Throws:

TransformerException

IOException

getOmitXmlDeclaration

@Nullable
public Boolean getOmitXmlDeclaration()
                              throws TransformerException,
IOException

Throws:

TransformerException

IOException

getIndent

@Nullable
public Boolean getIndent()
                  throws TransformerException,
IOException

Throws:

TransformerException

IOException

getOutputMethod

@Nullable
public String getOutputMethod()
                       throws TransformerException,
IOException

Throws:

TransformerException

IOException

getDisableOutputEscaping

@Nullable
public Boolean getDisableOutputEscaping()
                                 throws TransformerException,
IOException

Throws:

TransformerException

IOException