INT-2768 Add XSLT Transformer Factory Class Name

Add the ability to inject the class name of the xslt transformer
implementation.

https://jira.springsource.org/browse/INT-2768

-add @author to java docs
-updat copywrite year to current year

add new test and check for class name that it exists.

-fix xslt payload transformer and test for unknown class name, will
now default to the jre default transformer.

spring-integration-xml/src/main/java/org/springframework/integration/xml/config/XsltPayloadTransformerParser.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2012 the original author or authors.
+ * Copyright 2002-2013 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -36,6 +36,7 @@ import org.springframework.util.xml.DomUtils;
  * @author Jonas Partner
  * @author Mark Fisher
  * @author Oleg Zhurakousky
+ * @author Mike Bazos
  */
 public class XsltPayloadTransformerParser extends AbstractTransformerParser {
 
@@ -51,6 +52,7 @@ public class XsltPayloadTransformerParser extends AbstractTransformerParser {
 		String resultTransformer = element.getAttribute("result-transformer");
 		String resultFactory = element.getAttribute("result-factory");
 		String resultType = element.getAttribute("result-type");
+		String transformerFactoryClass = element.getAttribute("transformer-factory-class");
 		IntegrationNamespaceUtils.setValueIfAttributeDefined(builder, element, "xslt-param-headers");
 		Assert.isTrue(StringUtils.hasText(xslResource) ^ StringUtils.hasText(xslTemplates),
 				"Exactly one of 'xsl-resource' or 'xsl-templates' is required.");
@@ -60,6 +62,9 @@ public class XsltPayloadTransformerParser extends AbstractTransformerParser {
 		else if (StringUtils.hasText(xslTemplates)) {
 			builder.addConstructorArgReference(xslTemplates);
 		}
+		if (StringUtils.hasText(transformerFactoryClass)) {
+			builder.addConstructorArgValue(transformerFactoryClass);
+		}
 		XmlNamespaceUtils.configureResultFactory(builder, resultType, resultFactory);
 		boolean resultFactorySpecified = StringUtils.hasText(resultFactory) || StringUtils.hasText(resultType);
 		if(resultFactorySpecified){

spring-integration-xml/src/main/java/org/springframework/integration/xml/transformer/XsltPayloadTransformer.java

@@ -47,6 +47,7 @@ import org.springframework.integration.xml.result.ResultFactory;
 import org.springframework.integration.xml.source.DomSourceFactory;
 import org.springframework.integration.xml.source.SourceFactory;
 import org.springframework.util.Assert;
+import org.springframework.util.ClassUtils;
 import org.springframework.util.ObjectUtils;
 import org.springframework.util.PatternMatchUtils;
 import org.springframework.xml.transform.StringResult;
@@ -76,10 +77,11 @@ import org.springframework.xml.transform.StringSource;
  * @author Mark Fisher
  * @author Oleg Zhurakousky
  * @author Artem Bilan
+ * @author Mike Bazos
  */
 public class XsltPayloadTransformer extends AbstractTransformer {
 
-	private final Log logger = LogFactory.getLog(this.getClass());
+	private static final Log logger = LogFactory.getLog(XsltPayloadTransformer.class);
 
 	private final Templates templates;
 
@@ -107,21 +109,26 @@ public class XsltPayloadTransformer extends AbstractTransformer {
 	}
 
 	public XsltPayloadTransformer(Resource xslResource) throws Exception {
-		this(TransformerFactory.newInstance().newTemplates(
-				createStreamSourceOnResource(xslResource)), null);
+		this(xslResource, null, null);
 	}
 
 	public XsltPayloadTransformer(Resource xslResource, ResultTransformer resultTransformer) throws Exception {
-		this(TransformerFactory.newInstance().newTemplates(
-				createStreamSourceOnResource(xslResource)), resultTransformer);
+		this(xslResource, resultTransformer, null);
 	}
+	
+	public XsltPayloadTransformer(Resource xslResource, ResultTransformer resultTransformer, String transformerFactoryClass) throws Exception {
+		this(getTransformerFactory(transformerFactoryClass).newTemplates(createStreamSourceOnResource(xslResource)), resultTransformer);
+	}
+
+    public XsltPayloadTransformer(Resource xslResource, String transformerFactoryClass) throws Exception {
+        this(getTransformerFactory(transformerFactoryClass).newTemplates(createStreamSourceOnResource(xslResource)), null);
+    }
 
 	public XsltPayloadTransformer(Templates templates, ResultTransformer resultTransformer) throws ParserConfigurationException {
 		this.templates = templates;
 		this.resultTransformer = resultTransformer;
 	}
 
-
 	/**
 	 * Sets the SourceFactory.
 	 */
@@ -317,5 +324,21 @@ public class XsltPayloadTransformer extends AbstractTransformer {
 			return new StreamSource(xslResource.getInputStream());
 		}
 	}
-
+	
+    private static TransformerFactory getTransformerFactory(String transformerFactoryImplClass) {
+        TransformerFactory transformerFactory = null;
+        
+        if (transformerFactoryImplClass == null || transformerFactoryImplClass.length() <= 0) {
+            transformerFactory = TransformerFactory.newInstance();
+        } else if(ClassUtils.isPresent(transformerFactoryImplClass, ClassLoader.getSystemClassLoader())) {
+            transformerFactory = TransformerFactory.newInstance(transformerFactoryImplClass, ClassLoader.getSystemClassLoader());
+        } else {
+            if (logger.isWarnEnabled()) {
+                logger.warn(String.format("Class [%s] was not found will default to [%s], please ensure [%s] is located on your class path", transformerFactoryImplClass, TransformerFactory.class, transformerFactoryImplClass));
+            }
+            transformerFactory = TransformerFactory.newInstance();
+        }
+        
+        return transformerFactory;
+    }    
 }

spring-integration-xml/src/main/resources/org/springframework/integration/xml/config/spring-integration-xml-2.2.xsd

@@ -237,6 +237,19 @@
 							</xsd:appinfo>
 						</xsd:annotation>
 					</xsd:attribute>
+					<xsd:attribute name="transformer-factory-class" type="xsd:string" use="optional">
+						<xsd:annotation>
+							<xsd:documentation><![CDATA[
+								A fully qualified class name to a transformer factory
+								class that overrides the current JVM default.								
+							]]></xsd:documentation>
+							<xsd:appinfo>
+								<tool:annotation kind="ref">
+									<tool:expected-type type="javax.xml.transform.TransformerFactory"/>
+								</tool:annotation>
+							</xsd:appinfo>
+						</xsd:annotation>
+					</xsd:attribute>
 				</xsd:extension>
 			</xsd:complexContent>
 		</xsd:complexType>