/*
* Copyright (c) 2005, 2006, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package com.sun.xml.internal.bind.v2.model.impl;
import java.io.IOException;
import java.lang.annotation.Annotation;
import java.lang.reflect.Field;
import java.lang.reflect.Method;
import java.lang.reflect.Modifier;
import java.lang.reflect.Type;
import java.util.List;
import java.util.Map;
import javax.xml.bind.JAXBException;
import javax.xml.namespace.QName;
import javax.xml.stream.XMLStreamException;
import com.sun.istack.internal.NotNull;
import com.sun.xml.internal.bind.AccessorFactory;
import com.sun.xml.internal.bind.AccessorFactoryImpl;
import com.sun.xml.internal.bind.XmlAccessorFactory;
import com.sun.xml.internal.bind.annotation.XmlLocation;
import com.sun.xml.internal.bind.api.AccessorException;
import com.sun.xml.internal.bind.v2.ClassFactory;
import com.sun.xml.internal.bind.v2.model.annotation.Locatable;
import com.sun.xml.internal.bind.v2.model.core.PropertyKind;
import com.sun.xml.internal.bind.v2.model.runtime.RuntimeClassInfo;
import com.sun.xml.internal.bind.v2.model.runtime.RuntimeElement;
import com.sun.xml.internal.bind.v2.model.runtime.RuntimePropertyInfo;
import com.sun.xml.internal.bind.v2.model.runtime.RuntimeValuePropertyInfo;
import com.sun.xml.internal.bind.v2.runtime.IllegalAnnotationException;
import com.sun.xml.internal.bind.v2.runtime.Location;
import com.sun.xml.internal.bind.v2.runtime.Name;
import com.sun.xml.internal.bind.v2.runtime.Transducer;
import com.sun.xml.internal.bind.v2.runtime.XMLSerializer;
import com.sun.xml.internal.bind.v2.runtime.JAXBContextImpl;
import com.sun.xml.internal.bind.v2.runtime.reflect.Accessor;
import com.sun.xml.internal.bind.v2.runtime.reflect.TransducedAccessor;
import com.sun.xml.internal.bind.v2.runtime.unmarshaller.UnmarshallingContext;
import org.xml.sax.Locator;
import org.xml.sax.SAXException;
/**
* @author Kohsuke Kawaguchi (kk@kohsuke.org)
*/
class RuntimeClassInfoImpl extends ClassInfoImpl<Type,Class,Field,Method>
implements RuntimeClassInfo, RuntimeElement {
/**
* If this class has a property annotated with {@link XmlLocation},
* this field will get the accessor for it.
*
* TODO: support method based XmlLocation
*/
private Accessor<?,Locator> xmlLocationAccessor;
private AccessorFactory accessorFactory;
public RuntimeClassInfoImpl(RuntimeModelBuilder modelBuilder, Locatable upstream, Class clazz) {
super(modelBuilder, upstream, clazz);
accessorFactory = createAccessorFactory(clazz);
}
protected AccessorFactory createAccessorFactory(Class clazz) {
XmlAccessorFactory factoryAnn;
AccessorFactory accFactory = null;
// user providing class to be used.
JAXBContextImpl context = ((RuntimeModelBuilder) builder).context;
if (context!=null && context.xmlAccessorFactorySupport){
factoryAnn = findXmlAccessorFactoryAnnotation(clazz);
if (factoryAnn != null) {
try {
accFactory = factoryAnn.value().newInstance();
} catch (InstantiationException e) {
builder.reportError(new IllegalAnnotationException(
Messages.ACCESSORFACTORY_INSTANTIATION_EXCEPTION.format(
factoryAnn.getClass().getName(), nav().getClassName(clazz)), this));
} catch (IllegalAccessException e) {
builder.reportError(new IllegalAnnotationException(
Messages.ACCESSORFACTORY_ACCESS_EXCEPTION.format(
factoryAnn.getClass().getName(), nav().getClassName(clazz)),this));
}
}
}
// Fall back to local AccessorFactory when no
// user not providing one or as error recovery.
if (accFactory == null){
accFactory = AccessorFactoryImpl.getInstance();
}
return accFactory;
}
protected XmlAccessorFactory findXmlAccessorFactoryAnnotation(Class clazz) {
XmlAccessorFactory factoryAnn = reader().getClassAnnotation(XmlAccessorFactory.class,clazz,this);
if (factoryAnn == null) {
factoryAnn = reader().getPackageAnnotation(XmlAccessorFactory.class,clazz,this);
}
return factoryAnn;
}
public Method getFactoryMethod(){
return super.getFactoryMethod();
}
public final RuntimeClassInfoImpl getBaseClass() {
return (RuntimeClassInfoImpl)super.getBaseClass();
}
@Override
protected ReferencePropertyInfoImpl createReferenceProperty(PropertySeed<Type,Class,Field,Method> seed) {
return new RuntimeReferencePropertyInfoImpl(this,seed);
}
@Override
protected AttributePropertyInfoImpl createAttributeProperty(PropertySeed<Type,Class,Field,Method> seed) {
return new RuntimeAttributePropertyInfoImpl(this,seed);
}
@Override
protected ValuePropertyInfoImpl createValueProperty(PropertySeed<Type,Class,Field,Method> seed) {
return new RuntimeValuePropertyInfoImpl(this,seed);
}
@Override
protected ElementPropertyInfoImpl createElementProperty(PropertySeed<Type,Class,Field,Method> seed) {
return new RuntimeElementPropertyInfoImpl(this,seed);
}
@Override
protected MapPropertyInfoImpl createMapProperty(PropertySeed<Type,Class,Field,Method> seed) {
return new RuntimeMapPropertyInfoImpl(this,seed);
}
@Override
public List<? extends RuntimePropertyInfo> getProperties() {
return (List<? extends RuntimePropertyInfo>)super.getProperties();
}
@Override
public RuntimePropertyInfo getProperty(String name) {
return (RuntimePropertyInfo)super.getProperty(name);
}
public void link() {
getTransducer(); // populate the transducer
super.link();
}
private Accessor<?,Map<QName,String>> attributeWildcardAccessor;
public <B> Accessor<B,Map<QName,String>> getAttributeWildcard() {
for( RuntimeClassInfoImpl c=this; c!=null; c=c.getBaseClass() ) {
if(c.attributeWildcard!=null) {
if(c.attributeWildcardAccessor==null)
c.attributeWildcardAccessor = c.createAttributeWildcardAccessor();
return (Accessor<B,Map<QName,String>>)c.attributeWildcardAccessor;
}
}
return null;
}
private boolean computedTransducer = false;
private Transducer xducer = null;
public Transducer getTransducer() {
if(!computedTransducer) {
computedTransducer = true;
xducer = calcTransducer();
}
return xducer;
}
/**
* Creates a transducer if this class is bound to a text in XML.
*/
private Transducer calcTransducer() {
RuntimeValuePropertyInfo valuep=null;
if(hasAttributeWildcard())
return null; // has attribute wildcard. Can't be handled as a leaf
for (RuntimeClassInfoImpl ci = this; ci != null; ci = ci.getBaseClass()) {
for( RuntimePropertyInfo pi : ci.getProperties() )
if(pi.kind()==PropertyKind.VALUE) {
valuep = (RuntimeValuePropertyInfo)pi;
} else {
// this bean has something other than a value
return null;
}
}
if(valuep==null)
return null;
if( !valuep.getTarget().isSimpleType() )
return null; // if there's an error, recover from it by returning null.
return new TransducerImpl(getClazz(),TransducedAccessor.get(
((RuntimeModelBuilder)builder).context,valuep));
}
/**
* Creates
*/
private Accessor<?,Map<QName,String>> createAttributeWildcardAccessor() {
assert attributeWildcard!=null;
return ((RuntimePropertySeed)attributeWildcard).getAccessor();
}
@Override
protected RuntimePropertySeed createFieldSeed(Field field) {
final boolean readOnly = Modifier.isStatic(field.getModifiers());
Accessor acc;
try {
acc = accessorFactory.createFieldAccessor(clazz, field, readOnly);
} catch(JAXBException e) {
builder.reportError(new IllegalAnnotationException(
Messages.CUSTOM_ACCESSORFACTORY_FIELD_ERROR.format(
nav().getClassName(clazz), e.toString()), this ));
acc = Accessor.getErrorInstance(); // error recovery
}
return new RuntimePropertySeed(super.createFieldSeed(field), acc );
}
@Override
public RuntimePropertySeed createAccessorSeed(Method getter, Method setter) {
Accessor acc;
try {
acc = accessorFactory.createPropertyAccessor(clazz, getter, setter);
} catch(JAXBException e) {
builder.reportError(new IllegalAnnotationException(
Messages.CUSTOM_ACCESSORFACTORY_PROPERTY_ERROR.format(
nav().getClassName(clazz), e.toString()), this ));
acc = Accessor.getErrorInstance(); // error recovery
}
return new RuntimePropertySeed( super.createAccessorSeed(getter,setter),
acc );
}
@Override
protected void checkFieldXmlLocation(Field f) {
if(reader().hasFieldAnnotation(XmlLocation.class,f))
// TODO: check for XmlLocation signature
// TODO: check a collision with the super class
xmlLocationAccessor = new Accessor.FieldReflection<Object,Locator>(f);
}
public Accessor<?,Locator> getLocatorField() {
return xmlLocationAccessor;
}
static final class RuntimePropertySeed implements PropertySeed<Type,Class,Field,Method> {
/**
* @see #getAccessor()
*/
private final Accessor acc;
private final PropertySeed<Type,Class,Field,Method> core;
public RuntimePropertySeed(PropertySeed<Type,Class,Field,Method> core, Accessor acc) {
this.core = core;
this.acc = acc;
}
public String getName() {
return core.getName();
}
public <A extends Annotation> A readAnnotation(Class<A> annotationType) {
return core.readAnnotation(annotationType);
}
public boolean hasAnnotation(Class<? extends Annotation> annotationType) {
return core.hasAnnotation(annotationType);
}
public Type getRawType() {
return core.getRawType();
}
public Location getLocation() {
return core.getLocation();
}
public Locatable getUpstream() {
return core.getUpstream();
}
public Accessor getAccessor() {
return acc;
}
}
/**
* {@link Transducer} implementation used when this class maps to PCDATA in XML.
*
* TODO: revisit the exception handling
*/
private static final class TransducerImpl<BeanT> implements Transducer<BeanT> {
private final TransducedAccessor<BeanT> xacc;
private final Class<BeanT> ownerClass;
public TransducerImpl(Class<BeanT> ownerClass,TransducedAccessor<BeanT> xacc) {
this.xacc = xacc;
this.ownerClass = ownerClass;
}
public boolean useNamespace() {
return xacc.useNamespace();
}
public boolean isDefault() {
return false;
}
public void declareNamespace(BeanT bean, XMLSerializer w) throws AccessorException {
try {
xacc.declareNamespace(bean,w);
} catch (SAXException e) {
throw new AccessorException(e);
}
}
public @NotNull CharSequence print(BeanT o) throws AccessorException {
try {
CharSequence value = xacc.print(o);
if(value==null)
throw new AccessorException(Messages.THERE_MUST_BE_VALUE_IN_XMLVALUE.format(o));
return value;
} catch (SAXException e) {
throw new AccessorException(e);
}
}
public BeanT parse(CharSequence lexical) throws AccessorException, SAXException {
UnmarshallingContext ctxt = UnmarshallingContext.getInstance();
BeanT inst;
if(ctxt!=null)
inst = (BeanT)ctxt.createInstance(ownerClass);
else
// when this runs for parsing enum constants,
// there's no UnmarshallingContext.
inst = ClassFactory.create(ownerClass);
xacc.parse(inst,lexical);
return inst;
}
public void writeText(XMLSerializer w, BeanT o, String fieldName) throws IOException, SAXException, XMLStreamException, AccessorException {
if(!xacc.hasValue(o))
throw new AccessorException(Messages.THERE_MUST_BE_VALUE_IN_XMLVALUE.format(o));
xacc.writeText(w,o,fieldName);
}
public void writeLeafElement(XMLSerializer w, Name tagName, BeanT o, String fieldName) throws IOException, SAXException, XMLStreamException, AccessorException {
if(!xacc.hasValue(o))
throw new AccessorException(Messages.THERE_MUST_BE_VALUE_IN_XMLVALUE.format(o));
xacc.writeLeafElement(w,tagName,o,fieldName);
}
public QName getTypeName(BeanT instance) {
return null;
}
}
}