com.sun.xml.bind.v2.model.impl.EnumLeafInfoImpl Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jaxb-runtime Show documentation
Show all versions of jaxb-runtime Show documentation
JAXB (JSR 222) Reference Implementation
/*
* Copyright (c) 1997, 2021 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Distribution License v. 1.0, which is available at
* http://www.eclipse.org/org/documents/edl-v10.php.
*
* SPDX-License-Identifier: BSD-3-Clause
*/
package com.sun.xml.bind.v2.model.impl;
import java.util.Iterator;
import javax.xml.bind.annotation.XmlEnum;
import javax.xml.bind.annotation.XmlEnumValue;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.namespace.QName;
import com.sun.xml.bind.v2.model.annotation.Locatable;
import com.sun.xml.bind.v2.model.core.EnumConstant;
import com.sun.xml.bind.v2.model.core.EnumLeafInfo;
import com.sun.xml.bind.v2.model.core.NonElement;
import com.sun.xml.bind.v2.model.core.Element;
import com.sun.xml.bind.v2.model.core.ClassInfo;
import com.sun.xml.bind.v2.runtime.Location;
import java.util.Collection;
import javax.xml.bind.annotation.XmlSchemaType;
/**
* {@link EnumLeafInfo} implementation.
*
* @author Kohsuke Kawaguchi
*/
class EnumLeafInfoImpl extends TypeInfoImpl
implements EnumLeafInfo, Element, Iterable> {
/**
* The enum class whose information this object represents.
*/
/*package*/ final C clazz;
NonElement baseType;
private final T type;
/**
* Can be null for anonymous types.
*/
private final QName typeName;
/**
* All the {@link EnumConstantImpl}s are linked in this list.
*/
private EnumConstantImpl firstConstant;
/**
* If this enum is also bound to an element, that tag name.
* Or else null.
*/
private QName elementName;
/**
* Used to recognize token vs string.
*/
protected boolean tokenStringType;
/**
* @param clazz
* @param type
* clazz and type should both point to the enum class
* that this {@link EnumLeafInfo} represents.
* Because of the type parameterization we have to take them separately.
*/
public EnumLeafInfoImpl(ModelBuilder builder,
Locatable upstream, C clazz, T type ) {
super(builder,upstream);
this.clazz = clazz;
this.type = type;
elementName = parseElementName(clazz);
// compute the type name
// TODO: I guess it must be allowed for enums to have @XmlElement
typeName = parseTypeName(clazz);
// locate the base type.
// this can be done eagerly because there shouldn't be no cycle.
XmlEnum xe = builder.reader.getClassAnnotation(XmlEnum.class, clazz, this);
if(xe!=null) {
T base = builder.reader.getClassValue(xe, "value");
baseType = builder.getTypeInfo(base,this);
} else {
baseType = builder.getTypeInfo(builder.nav.ref(String.class),this);
}
}
/**
* Build {@link EnumConstant}s and discover/report any error in it.
*/
protected void calcConstants() {
EnumConstantImpl last = null;
// first check if we represent xs:token derived type
Collection fields = nav().getDeclaredFields(clazz);
for (F f : fields) {
if (nav().isSameType(nav().getFieldType(f), nav().ref(String.class))) {
XmlSchemaType schemaTypeAnnotation = builder.reader.getFieldAnnotation(XmlSchemaType.class, f, this);
if (schemaTypeAnnotation != null) {
if ("token".equals(schemaTypeAnnotation.name())) {
tokenStringType = true;
break;
}
};
}
}
F[] constants = nav().getEnumConstants(clazz);
for( int i=constants.length-1; i>=0; i-- ) {
F constant = constants[i];
String name = nav().getFieldName(constant);
XmlEnumValue xev = builder.reader.getFieldAnnotation(XmlEnumValue.class, constant, this);
String literal;
if(xev==null) literal = name;
else literal = xev.value();
last = createEnumConstant(name,literal,constant,last);
}
this.firstConstant = last;
}
protected EnumConstantImpl createEnumConstant(String name, String literal, F constant, EnumConstantImpl last) {
return new EnumConstantImpl(this, name, literal, last);
}
public T getType() {
return type;
}
/**
*
* @return true if enum is restriction/extension from xs:token type, otherwise false
*/
public boolean isToken() {
return tokenStringType;
}
/**
* Leaf-type cannot be referenced from IDREF.
*
* @deprecated
* why are you calling a method whose return value is always known?
*/
public final boolean canBeReferencedByIDREF() {
return false;
}
public QName getTypeName() {
return typeName;
}
public C getClazz() {
return clazz;
}
public NonElement getBaseType() {
return baseType;
}
public boolean isSimpleType() {
return true;
}
public Location getLocation() {
return nav().getClassLocation(clazz);
}
public Iterable> getConstants() {
if(firstConstant==null)
calcConstants();
return this;
}
@Override
public void link() {
// make sure we've computed constants
getConstants();
super.link();
}
/**
* No substitution.
*
* @deprecated if you are invoking this method directly, there's something wrong.
*/
public Element getSubstitutionHead() {
return null;
}
public QName getElementName() {
return elementName;
}
public boolean isElement() {
return elementName!=null;
}
public Element asElement() {
if(isElement())
return this;
else
return null;
}
/**
* When a bean binds to an element, it's always through {@link XmlRootElement},
* so this method always return null.
*
* @deprecated
* you shouldn't be invoking this method on {@link ClassInfoImpl}.
*/
public ClassInfo getScope() {
return null;
}
public Iterator> iterator() {
return new Iterator>() {
private EnumConstantImpl next = firstConstant;
public boolean hasNext() {
return next!=null;
}
public EnumConstantImpl next() {
EnumConstantImpl r = next;
next = next.next;
return r;
}
public void remove() {
throw new UnsupportedOperationException();
}
};
}
}