/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common Development
* and Distribution License("CDDL") (collectively, the "License"). You
* may not use this file except in compliance with the License. You can obtain
* a copy of the License at https://glassfish.dev.java.net/public/CDDL+GPL.html
* or glassfish/bootstrap/legal/LICENSE.txt. See the License for the specific
* language governing permissions and limitations under the License.
*
* When distributing the software, include this License Header Notice in each
* file and include the License file at glassfish/bootstrap/legal/LICENSE.txt.
* Sun designates this particular file as subject to the "Classpath" exception
* as provided by Sun in the GPL Version 2 section of the License file that
* accompanied this code. If applicable, add the following below the License
* Header, with the fields enclosed by brackets [] replaced by your own
* identifying information: "Portions Copyrighted [year]
* [name of copyright owner]"
*
* Contributor(s):
*
* If you wish your version of this file to be governed by only the CDDL or
* only the GPL Version 2, indicate your decision by adding "[Contributor]
* elects to include this software in this distribution under the [CDDL or GPL
* Version 2] license." If you don't indicate a single choice of license, a
* recipient has the option to distribute your version of this file under
* either the CDDL, the GPL Version 2 or to extend the choice of license to
* its licensees as provided above. However, if you add GPL Version 2 code
* and therefore, elected the GPL Version 2 license, then the option applies
* only if the new code is made subject to such option by the copyright
* holder.
*/
package com.sun.tools.xjc.model;
import java.util.Collection;
import java.util.Collections;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
import javax.xml.bind.JAXBElement;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.namespace.QName;
import com.sun.codemodel.JPackage;
import com.sun.codemodel.JType;
import com.sun.istack.Nullable;
import static com.sun.tools.xjc.model.CElementPropertyInfo.CollectionMode.NOT_REPEATED;
import static com.sun.tools.xjc.model.CElementPropertyInfo.CollectionMode.REPEATED_VALUE;
import com.sun.tools.xjc.model.nav.NClass;
import com.sun.tools.xjc.model.nav.NType;
import com.sun.tools.xjc.model.nav.NavigatorImpl;
import com.sun.tools.xjc.outline.Aspect;
import com.sun.tools.xjc.outline.Outline;
import com.sun.tools.xjc.reader.xmlschema.bindinfo.BIInlineBinaryData;
import com.sun.tools.xjc.reader.xmlschema.bindinfo.BIFactoryMethod;
import com.sun.tools.xjc.reader.xmlschema.BGMBuilder;
import com.sun.tools.xjc.reader.Ring;
import com.sun.xml.bind.v2.model.core.ElementInfo;
import com.sun.xml.xsom.XSElementDecl;
import com.sun.xml.xsom.XmlString;
import org.xml.sax.Locator;
/**
* {@link ElementInfo} implementation for the compile-time model.
*
* <p>
* As an NType, it represents the Java representation of this element
* (either JAXBElement<T> or Foo).
*
* @author Kohsuke Kawaguchi
*/
public final class CElementInfo extends AbstractCElement
implements ElementInfo<NType,NClass>, NType, CClassInfoParent {
private final QName tagName;
/**
* Represents {@code JAXBElement<ContentType>}.
*/
private NType type;
/**
* If this element produces its own class, the short name of that class.
* Otherwise null.
*/
private String className;
/**
* If this element is global, the element info is considered to be
* package-level, and this points to the package in which this element
* lives in.
*
* <p>
* For local elements, this points to the parent {@link CClassInfo}.
*/
public final CClassInfoParent parent;
private CElementInfo substitutionHead;
/**
* Lazily computed.
*/
private Set<CElementInfo> substitutionMembers;
/**
* {@link Model} that owns this object.
*/
private final Model model;
private CElementPropertyInfo property;
/**
* Custom {@link #getSqueezedName() squeezed name}, if any.
*/
private /*almost final*/ @Nullable String squeezedName;
/**
* Creates an element in the given parent.
*
* <p>
* When using this construction, {@link #initContentType(TypeUse, XSElementDecl, XmlString)}
* must not be invoked.
*/
public CElementInfo(Model model,QName tagName, CClassInfoParent parent, TypeUse contentType, XmlString defaultValue, XSElementDecl source, CCustomizations customizations, Locator location ) {
super(model,source,location,customizations);
this.tagName = tagName;
this.model = model;
this.parent = parent;
if(contentType!=null)
initContentType(contentType, source, defaultValue);
model.add(this);
}
/**
* Creates an element with a class in the given parent.
*
* <p>
* When using this construction, the caller must use
* {@link #initContentType(TypeUse, XSElementDecl, XmlString)} to fill in the content type
* later.
*
* This is to avoid a circular model construction dependency between buidling a type
* inside an element and element itself. To build a content type, you need to have
* {@link CElementInfo} for a parent, so we can't take it as a constructor parameter.
*/
public CElementInfo(Model model,QName tagName, CClassInfoParent parent, String className, CCustomizations customizations, Locator location ) {
this(model,tagName,parent,null,null,null,customizations,location);
this.className = className;
}
public void initContentType(TypeUse contentType, @Nullable XSElementDecl source, XmlString defaultValue) {
assert this.property==null; // must not be called twice
this.property = new CElementPropertyInfo("Value",
contentType.isCollection()?REPEATED_VALUE:NOT_REPEATED,
contentType.idUse(),
contentType.getExpectedMimeType(),
source,null,getLocator(),true);
this.property.setAdapter(contentType.getAdapterUse());
BIInlineBinaryData.handle(source,property);
property.getTypes().add(new CTypeRef(contentType.getInfo(),tagName,CTypeRef.getSimpleTypeName(source), true,defaultValue));
this.type = NavigatorImpl.createParameterizedType(
NavigatorImpl.theInstance.ref(JAXBElement.class),
getContentInMemoryType() );
BIFactoryMethod factoryMethod = Ring.get(BGMBuilder.class).getBindInfo(source).get(BIFactoryMethod.class);
if(factoryMethod!=null) {
factoryMethod.markAsAcknowledged();
this.squeezedName = factoryMethod.name;
}
}
public final String getDefaultValue() {
return getProperty().getTypes().get(0).getDefaultValue();
}
public final JPackage _package() {
return parent.getOwnerPackage();
}
public CNonElement getContentType() {
return getProperty().ref().get(0);
}
public NType getContentInMemoryType() {
if(getProperty().getAdapter()==null) {
NType itemType = getContentType().getType();
if(!property.isCollection())
return itemType;
return NavigatorImpl.createParameterizedType(List.class,itemType);
} else {
return getProperty().getAdapter().customType;
}
}
public CElementPropertyInfo getProperty() {
return property;
}
public CClassInfo getScope() {
if(parent instanceof CClassInfo)
return (CClassInfo)parent;
return null;
}
/**
* @deprecated why are you calling a method that returns this?
*/
public NType getType() {
return this;
}
public QName getElementName() {
return tagName;
}
public JType toType(Outline o, Aspect aspect) {
if(className==null)
return type.toType(o,aspect);
else
return o.getElement(this).implClass;
}
/**
* Returns the "squeezed name" of this element.
*
* @see CClassInfo#getSqueezedName()
*/
@XmlElement
public String getSqueezedName() {
if(squeezedName!=null) return squeezedName;
StringBuilder b = new StringBuilder();
CClassInfo s = getScope();
if(s!=null)
b.append(s.getSqueezedName());
if(className!=null)
b.append(className);
else
b.append( model.getNameConverter().toClassName(tagName.getLocalPart()));
return b.toString();
}
public CElementInfo getSubstitutionHead() {
return substitutionHead;
}
public Collection<CElementInfo> getSubstitutionMembers() {
if(substitutionMembers==null)
return Collections.emptyList();
else
return substitutionMembers;
}
public void setSubstitutionHead(CElementInfo substitutionHead) {
// don't set it twice
assert this.substitutionHead==null;
assert substitutionHead!=null;
this.substitutionHead = substitutionHead;
if(substitutionHead.substitutionMembers==null)
substitutionHead.substitutionMembers = new HashSet<CElementInfo>();
substitutionHead.substitutionMembers.add(this);
}
public boolean isBoxedType() {
return false;
}
public String fullName() {
if(className==null)
return type.fullName();
else {
String r = parent.fullName();
if(r.length()==0) return className;
else return r+'.'+className;
}
}
public <T> T accept(Visitor<T> visitor) {
return visitor.onElement(this);
}
public JPackage getOwnerPackage() {
return parent.getOwnerPackage();
}
public String shortName() {
return className;
}
/**
* True if this element has its own class
* (as opposed to be represented as an instance of {@link JAXBElement}.
*/
public boolean hasClass() {
return className!=null;
}
}