/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.tuscany.sca.implementation.spring.xml;
import static javax.xml.stream.XMLStreamConstants.END_ELEMENT;
import static javax.xml.stream.XMLStreamConstants.START_ELEMENT;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.net.URL;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.jar.Attributes;
import java.util.jar.JarEntry;
import java.util.jar.JarFile;
import java.util.jar.Manifest;
import javax.xml.namespace.QName;
import javax.xml.stream.XMLInputFactory;
import javax.xml.stream.XMLStreamException;
import javax.xml.stream.XMLStreamReader;
import org.apache.tuscany.sca.assembly.AssemblyFactory;
import org.apache.tuscany.sca.assembly.ComponentType;
import org.apache.tuscany.sca.assembly.Multiplicity;
import org.apache.tuscany.sca.assembly.Property;
import org.apache.tuscany.sca.assembly.Reference;
import org.apache.tuscany.sca.assembly.Service;
import org.apache.tuscany.sca.contribution.service.ContributionReadException;
import org.apache.tuscany.sca.contribution.service.ContributionResolveException;
import org.apache.tuscany.sca.implementation.java.JavaElementImpl;
import org.apache.tuscany.sca.implementation.java.JavaImplementationFactory;
import org.apache.tuscany.sca.implementation.spring.SpringImplementation;
import org.apache.tuscany.sca.interfacedef.InvalidInterfaceException;
import org.apache.tuscany.sca.interfacedef.java.JavaInterface;
import org.apache.tuscany.sca.interfacedef.java.JavaInterfaceContract;
import org.apache.tuscany.sca.interfacedef.java.JavaInterfaceFactory;
import org.apache.tuscany.sca.interfacedef.util.JavaXMLMapper;
import org.apache.tuscany.sca.policy.PolicyFactory;
import org.springframework.core.io.Resource;
import org.springframework.core.io.UrlResource;
/**
* Introspects a Spring XML application-context configuration file to create
* component type information.
*
*
* @version $Rev: 512919 $ $Date: 2007-02-28 19:32:56 +0000 (Wed, 28 Feb 2007) $
*/
public class SpringXMLComponentTypeLoader {
private AssemblyFactory assemblyFactory;
private JavaInterfaceFactory javaFactory;
private ClassLoader cl;
private SpringBeanIntrospector beanIntrospector;
public SpringXMLComponentTypeLoader(AssemblyFactory assemblyFactory,
JavaInterfaceFactory javaFactory,
JavaImplementationFactory javaImplementationFactory,
PolicyFactory policyFactory) {
super();
this.assemblyFactory = assemblyFactory;
this.javaFactory = javaFactory;
beanIntrospector =
new SpringBeanIntrospector(assemblyFactory, javaFactory, javaImplementationFactory, policyFactory);
}
protected Class getImplementationClass() {
return SpringImplementation.class;
}
/**
* Base method which loads the component type from the application-context attached to the
* Spring implementation
*
*/
public void load(SpringImplementation implementation) throws ContributionReadException {
//System.out.println("Spring TypeLoader - load method start");
ComponentType componentType = implementation.getComponentType();
/* Check that there is a component type object already set */
if (componentType == null) {
throw new ContributionReadException("SpringXMLLoader load: implementation has no ComponentType object");
}
if (componentType.isUnresolved()) {
/* Fetch the location of the application-context file from the implementation */
loadFromXML(implementation);
if (!componentType.isUnresolved())
implementation.setUnresolved(false);
} // end if
//System.out.println("Spring TypeLoader - load method complete");
} // end method load
/**
* Method which fills out the component type for a Spring implementation by reading the
* Spring application-context.xml file.
*
* @param implementation SpringImplementation into which to load the component type information
* @throws ContributionReadException Failed to read the contribution
*/
private void loadFromXML(SpringImplementation implementation) throws ContributionReadException {
XMLStreamReader reader;
List beans = new ArrayList();
List services = new ArrayList();
List references = new ArrayList();
List scaproperties = new ArrayList();
Resource resource;
String location = implementation.getLocation();
try {
// FIXME - is the ContextClassLoader the right place to start the search?
cl = Thread.currentThread().getContextClassLoader();
resource = getApplicationContextResource(location, cl);
implementation.setResource(resource);
// The URI is used to uniquely identify the Implementation
implementation.setURI(resource.getURL().toString());
// FIXME - need a better way to handle the XMLInputFactory than allocating a new one every time
XMLInputFactory xmlFactory = XMLInputFactory.newInstance();
reader = xmlFactory.createXMLStreamReader(resource.getInputStream());
// System.out.println("Spring TypeLoader - starting to read context file");
readBeanDefinition(reader, beans, services, references, scaproperties);
} catch (IOException e) {
throw new ContributionReadException(e);
} catch (XMLStreamException e) {
throw new ContributionReadException(e);
}
/* At this point, the complete application-context.xml file has been read and its contents */
/* stored in the lists of beans, services, references. These are now used to generate */
/* the implied componentType for the application context */
generateComponentType(implementation, beans, services, references, scaproperties);
return;
} // end method loadFromXML
/**
* Method which returns the XMLStreamReader for the Spring application-context.xml file
* specified in the location attribute
*/
private XMLStreamReader getApplicationContextReader (String location) throws ContributionReadException {
try {
// FIXME - is the ContextClassLoader the right place to start the search?
cl = Thread.currentThread().getContextClassLoader();
Resource resource = getApplicationContextResource(location, cl);
// FIXME - need a better way to handle the XMLInputFactory than allocating a new one every time
XMLInputFactory xmlFactory = XMLInputFactory.newInstance();
XMLStreamReader reader = xmlFactory.createXMLStreamReader(resource.getInputStream());
return reader;
} catch (IOException e) {
throw new ContributionReadException(e);
} catch (XMLStreamException e) {
throw new ContributionReadException(e);
}
}
/**
* Method which reads the bean definitions from Spring application-context.xml file and identifies
* the defined beans, properties, services and references
*/
private void readBeanDefinition(XMLStreamReader reader,
List beans,
List services,
List references,
List scaproperties) throws ContributionReadException {
SpringBeanElement bean = null;
SpringPropertyElement property = null;
SpringConstructorArgElement constructorArg = null;
try {
boolean completed = false;
while (!completed) {
switch (reader.next()) {
case START_ELEMENT:
QName qname = reader.getName();
//System.out.println("Spring TypeLoader - found element with name: " + qname.toString());
if (Constants.IMPORT_ELEMENT.equals(qname)) {
//FIXME - put the sequence of code below which gets the ireader into a subsidiary method
String location = reader.getAttributeValue(null, "resource");
if (location != null) {
XMLStreamReader ireader = getApplicationContextReader(location);
// Read the bean definition for the identified imported resource
readBeanDefinition(ireader, beans, services, references, scaproperties);
}
} else if (Constants.SERVICE_ELEMENT.equals(qname)) {
SpringSCAServiceElement service =
new SpringSCAServiceElement(reader.getAttributeValue(null, "name"), reader
.getAttributeValue(null, "type"), reader.getAttributeValue(null, "target"));
services.add(service);
} else if (Constants.REFERENCE_ELEMENT.equals(qname)) {
SpringSCAReferenceElement reference =
new SpringSCAReferenceElement(reader.getAttributeValue(null, "name"), reader
.getAttributeValue(null, "type"));
references.add(reference);
} else if (Constants.SCAPROPERTY_ELEMENT.equals(qname)) {
SpringSCAPropertyElement scaproperty =
new SpringSCAPropertyElement(reader.getAttributeValue(null, "name"), reader
.getAttributeValue(null, "type"));
scaproperties.add(scaproperty);
} else if (Constants.BEAN_ELEMENT.equals(qname)) {
bean = new SpringBeanElement(reader.getAttributeValue(null, "id"), reader
.getAttributeValue(null, "class"));
//beans.add(bean);
} else if (Constants.PROPERTY_ELEMENT.equals(qname)) {
property = new SpringPropertyElement(reader.getAttributeValue(null, "name"), reader
.getAttributeValue(null, "ref"));
//bean.addProperty(property);
} else if (Constants.CONSTRUCTORARG_ELEMENT.equals(qname)) {
constructorArg = new SpringConstructorArgElement(reader.getAttributeValue(null, "ref"),
reader.getAttributeValue(null, "type"));
} else if (Constants.REF_ELEMENT.equals(qname)) {
String ref = reader.getAttributeValue(null, "bean");
// Check if the parent element is a property
if (property != null) property.setRef(ref);
// Check if the parent element is a constructor-arg
if (constructorArg != null) constructorArg.setRef(ref);
} else if (Constants.VALUE_ELEMENT.equals(qname)) {
String value = reader.getElementText();
// Check if the parent element is a constructor-arg
if (constructorArg != null) {
constructorArg.addValue(value);
// Identify the XML resource specified for the constructor-arg element
if ((value.indexOf(".xml") != -1)) {
if ((bean.getClassName().indexOf(".ClassPathXmlApplicationContext") != -1) ||
(bean.getClassName().indexOf(".FileSystemXmlApplicationContext") != -1)) {
XMLStreamReader creader = getApplicationContextReader(value);
// Read the bean definition for the constructor-arg resources
readBeanDefinition(creader, beans, services, references, scaproperties);
}
}
}
} // end if
break;
case END_ELEMENT:
if (Constants.BEANS_ELEMENT.equals(reader.getName())) {
//System.out.println("Spring TypeLoader - finished read of context file");
completed = true;
break;
} else if (Constants.BEAN_ELEMENT.equals(reader.getName())) {
beans.add(bean);
bean = null;
} else if (Constants.PROPERTY_ELEMENT.equals(reader.getName())) {
bean.addProperty(property);
property = null;
} else if (Constants.CONSTRUCTORARG_ELEMENT.equals(reader.getName())) {
bean.addCustructorArgs(constructorArg);
constructorArg = null;
} // end if
} // end switch
} // end while
} catch (XMLStreamException e) {
throw new ContributionReadException(e);
}
}
/**
* Generates the Spring implementation component type from the configuration contained in the
* lists of beans, services, references and scaproperties derived from the application context
*/
private void generateComponentType(SpringImplementation implementation,
List beans,
List services,
List references,
List scaproperties) throws ContributionReadException {
/*
* 1. Each service becomes a service in the component type
* 2. Each reference becomes a reference in the component type
* 3. IF there are no explicit service elements, each bean becomes a service
* 4. Each bean property which is a reference not pointing at another bean in the
* application context becomes a reference unless it is pointing at one of the references
* 5. Each scaproperty becomes a property in the component type
* 6. Each bean property which is not a reference and which is not pointing
* at another bean in the application context becomes a property in the component type
*/
ComponentType componentType = implementation.getComponentType();
try {
// Deal with the services first....
Iterator its = services.iterator();
while (its.hasNext()) {
SpringSCAServiceElement serviceElement = its.next();
Class> interfaze = cl.loadClass(serviceElement.getType());
Service theService = createService(interfaze, serviceElement.getName());
componentType.getServices().add(theService);
// Add this service to the Service / Bean map
String beanName = serviceElement.getTarget();
for (SpringBeanElement beanElement : beans) {
if (beanName.equals(beanElement.getId())) {
implementation.setBeanForService(theService, beanElement);
}
} // end for
} // end while
// Next handle the references
Iterator itr = references.iterator();
while (itr.hasNext()) {
SpringSCAReferenceElement referenceElement = itr.next();
Class> interfaze = cl.loadClass(referenceElement.getType());
Reference theReference = createReference(interfaze, referenceElement.getName());
componentType.getReferences().add(theReference);
} // end while
// Finally deal with the beans
Iterator itb;
// If there are no explicit service elements, then expose all the beans
if (services.isEmpty()) {
itb = beans.iterator();
// Loop through all the beans found
while (itb.hasNext()) {
SpringBeanElement beanElement = itb.next();
// Load the Spring bean class
Class> beanClass = cl.loadClass(beanElement.getClassName());
// Introspect the bean
ComponentType beanComponentType = assemblyFactory.createComponentType();
beanIntrospector.introspectBean(beanClass, beanComponentType);
// Get the service interface defined by this Spring Bean and add to
// the component type of the Spring Assembly
List beanServices = beanComponentType.getServices();
componentType.getServices().addAll(beanServices);
// Add these services to the Service / Bean map
for (Service beanService : beanServices) {
implementation.setBeanForService(beanService, beanElement);
}
} // end while
} // end if
// Now check to see if there are any more references from beans that are not satisfied
itb = beans.iterator();
while (itb.hasNext()) {
SpringBeanElement beanElement = itb.next();
boolean unresolvedProperties = false;
if (!beanElement.getProperties().isEmpty()) {
// Scan through the properties
Iterator itp = beanElement.getProperties().iterator();
while (itp.hasNext()) {
SpringPropertyElement propertyElement = itp.next();
if (propertyRefUnresolved(propertyElement.getRef(), beans, references, scaproperties)) {
// This means an unresolved reference from the spring bean...
unresolvedProperties = true;
} // end if
} // end while
// If there are unresolved properties, then find which ones are references
if (unresolvedProperties) {
Class> beanClass = cl.loadClass(beanElement.getClassName());
// Introspect the bean
ComponentType beanComponentType = assemblyFactory.createComponentType();
Map propertyMap =
beanIntrospector.introspectBean(beanClass, beanComponentType);
// Get the references by this Spring Bean and add the unresolved ones to
// the component type of the Spring Assembly
List beanReferences = beanComponentType.getReferences();
List beanProperties = beanComponentType.getProperties();
itp = beanElement.getProperties().iterator();
while (itp.hasNext()) {
SpringPropertyElement propertyElement = itp.next();
if (propertyRefUnresolved(propertyElement.getRef(), beans, references, scaproperties)) {
boolean resolved = false;
// This means an unresolved reference from the spring bean...add it to
// the references for the Spring application context
for (Reference reference : beanReferences) {
if (propertyElement.getName().equals(reference.getName())) {
// The name of the reference in this case is the string in
// the @ref attribute of the Spring property element, NOT the
// name of the field in the Spring bean....
reference.setName(propertyElement.getRef());
componentType.getReferences().add(reference);
resolved = true;
} // end if
} // end for
if (!resolved) {
// If the bean property is not already resolved as a reference
// then it must be an SCA property...
for (Property scaproperty : beanProperties) {
if (propertyElement.getName().equals(scaproperty.getName())) {
// The name of the reference in this case is the string in
// the @ref attribute of the Spring property element, NOT the
// name of the field in the Spring bean....
scaproperty.setName(propertyElement.getRef());
componentType.getProperties().add(scaproperty);
// Fetch and store the type of the property
implementation.setPropertyClass(scaproperty.getName(), propertyMap
.get(scaproperty.getName()).getType());
resolved = true;
} // end if
} // end for
} // end if
} // end if
} // end while
} // end if
} // end if
} // end while
Iterator itsp = scaproperties.iterator();
while (itsp.hasNext()) {
SpringSCAPropertyElement scaproperty = itsp.next();
// Create a component type property if the SCA property element has a name
// and a type declared...
if (scaproperty.getType() != null && scaproperty.getName() != null) {
Property theProperty = assemblyFactory.createProperty();
theProperty.setName(scaproperty.getName());
// Get the Java class and then an XSD element type for the property
Class> propType = Class.forName(scaproperty.getType());
theProperty.setXSDType(JavaXMLMapper.getXMLType(propType));
componentType.getProperties().add(theProperty);
// Remember the Java Class (ie the type) for this property
implementation.setPropertyClass(theProperty.getName(), propType);
} // end if
} // end while
} catch (ClassNotFoundException e) {
// Means that either an interface class, property class or a bean was not found
throw new ContributionReadException(e);
} catch (InvalidInterfaceException e) {
throw new ContributionReadException(e);
} catch (ContributionResolveException e) {
} // end try
// If we get here, the Spring assembly component type is resolved
componentType.setUnresolved(false);
implementation.setComponentType(componentType);
return;
} // end method generateComponentType
/*
* Determines whether a reference attribute of a Spring property element is resolved either
* by a bean in the application context or by an SCA reference element or by an SCA property
* element
* @param ref - a String containing the name of the reference - may be null
* @param beans - a List of SpringBean elements
* @param references - a List of SCA reference elements
* @return true if the property is not resolved, false if it is resolved
*/
private boolean propertyRefUnresolved(String ref,
List beans,
List references,
List scaproperties) {
boolean unresolved = true;
if (ref != null) {
// Scan over the beans looking for a match
Iterator itb = beans.iterator();
while (itb.hasNext()) {
SpringBeanElement beanElement = itb.next();
// Does the bean name match the ref?
if (ref.equals(beanElement.getId())) {
unresolved = false;
break;
} // end if
} // end while
// Scan over the SCA reference elements looking for a match
if (unresolved) {
Iterator itr = references.iterator();
while (itr.hasNext()) {
SpringSCAReferenceElement referenceElement = itr.next();
if (ref.equals(referenceElement.getName())) {
unresolved = false;
break;
} // end if
} // end while
} // end if
// Scan over the SCA property elements looking for a match
if (unresolved) {
Iterator itsp = scaproperties.iterator();
while (itsp.hasNext()) {
SpringSCAPropertyElement propertyElement = itsp.next();
if (ref.equals(propertyElement.getName())) {
unresolved = false;
break;
} // end if
} // end while
} // end if
} else {
// In the case where ref = null, the property is not going to be a reference of any
// kind and can be ignored
unresolved = false;
} // end if
return unresolved;
} // end method propertyRefUnresolved
/**
* Gets hold of the application-context.xml file as a Spring resource
* @param locationAttr - the location attribute from the element
* @param cl - the ClassLoader for the Spring implementation
*/
protected Resource getApplicationContextResource(String locationAttr, ClassLoader cl)
throws ContributionReadException {
File manifestFile = null;
File appXmlFile;
File locationFile = null;
URL url = cl.getResource(locationAttr);
if (url != null) {
String path = url.getPath();
locationFile = new File(path);
} else {
throw new ContributionReadException(
"SpringXMLLoader getApplicationContextResource: " + "unable to find resource file "
+ locationAttr);
}
if (locationFile.isDirectory()) {
try {
manifestFile = new File(locationFile, "META-INF"+ File.separator +"MANIFEST.MF");
if (manifestFile.exists()) {
Manifest mf = new Manifest(new FileInputStream(manifestFile));
Attributes mainAttrs = mf.getMainAttributes();
String appCtxPath = mainAttrs.getValue("Spring-Context");
if (appCtxPath != null) {
appXmlFile = new File(locationFile, appCtxPath);
if (appXmlFile.exists()) {
return new UrlResource(appXmlFile.toURL());
}
}
}
// no manifest-specified Spring context, use default
appXmlFile = new File(locationFile, "META-INF" + File.separator + "spring"
+ File.separator + Constants.APPLICATION_CONTEXT);
if (appXmlFile.exists()) {
return new UrlResource(appXmlFile.toURL());
}
} catch (IOException e) {
throw new ContributionReadException("Error reading manifest " + manifestFile);
}
} else {
if (locationFile.isFile() && locationFile.getName().indexOf(".jar") < 0) {
return new UrlResource(url);
}
else {
try {
JarFile jf = new JarFile(locationFile);
JarEntry je;
Manifest mf = jf.getManifest();
if (mf != null) {
Attributes mainAttrs = mf.getMainAttributes();
String appCtxPath = mainAttrs.getValue("Spring-Context");
if (appCtxPath != null) {
je = jf.getJarEntry(appCtxPath);
if (je != null) {
// TODO return a Spring specific Resource type for jars
return new UrlResource(new URL("jar:" + locationFile.toURI().toURL() + "!/" + appCtxPath));
}
}
}
je = jf.getJarEntry("META-INF" + File.separator + "spring"
+ File.separator + Constants.APPLICATION_CONTEXT);
if (je != null) {
return new UrlResource(new URL("jar:" + locationFile.toURI().toURL() + "!/" + Constants.APPLICATION_CONTEXT));
}
} catch (IOException e) {
// bad archive
// TODO: create a more appropriate exception type
throw new ContributionReadException(
"SpringXMLLoader getApplicationContextResource: " + " IO exception reading context file.",
e);
}
}
}
throw new ContributionReadException("SpringXMLLoader getApplicationContextResource: "
+ "META-INF/spring/" + Constants.APPLICATION_CONTEXT + "not found");
} // end method getApplicationContextResource
/**
* Creates a Service for the component type based on its name and Java interface
*/
public Service createService(Class> interfaze, String name) throws InvalidInterfaceException {
Service service = assemblyFactory.createService();
JavaInterfaceContract interfaceContract = javaFactory.createJavaInterfaceContract();
service.setInterfaceContract(interfaceContract);
// Set the name for the service
service.setName(name);
// Set the call interface and, if present, the callback interface
JavaInterface callInterface = javaFactory.createJavaInterface(interfaze);
service.getInterfaceContract().setInterface(callInterface);
if (callInterface.getCallbackClass() != null) {
JavaInterface callbackInterface = javaFactory.createJavaInterface(callInterface.getCallbackClass());
service.getInterfaceContract().setCallbackInterface(callbackInterface);
}
return service;
} // end method createService
/**
* Creates a Reference for the component type based on its name and Java interface
*/
private org.apache.tuscany.sca.assembly.Reference createReference(Class> interfaze, String name)
throws InvalidInterfaceException {
org.apache.tuscany.sca.assembly.Reference reference = assemblyFactory.createReference();
JavaInterfaceContract interfaceContract = javaFactory.createJavaInterfaceContract();
reference.setInterfaceContract(interfaceContract);
// Set the name of the reference to the supplied name and the multiplicity of the reference
// to 1..1 - for Spring implementations, this is the only multiplicity supported
reference.setName(name);
reference.setMultiplicity(Multiplicity.ONE_ONE);
// Set the call interface and, if present, the callback interface
JavaInterface callInterface = javaFactory.createJavaInterface(interfaze);
reference.getInterfaceContract().setInterface(callInterface);
if (callInterface.getCallbackClass() != null) {
JavaInterface callbackInterface = javaFactory.createJavaInterface(callInterface.getCallbackClass());
reference.getInterfaceContract().setCallbackInterface(callbackInterface);
}
return reference;
}
} // end class SpringXMLComponentTypeLoader