/*
* 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.tools.internal.xjc.reader.xmlschema;
import java.util.Collection;
import com.sun.tools.internal.xjc.model.CPropertyInfo;
import com.sun.tools.internal.xjc.model.Multiplicity;
import com.sun.tools.internal.xjc.reader.RawTypeSet;
import com.sun.tools.internal.xjc.reader.gbind.ConnectedComponent;
import com.sun.tools.internal.xjc.reader.gbind.Element;
import com.sun.tools.internal.xjc.reader.gbind.Expression;
import com.sun.tools.internal.xjc.reader.gbind.Graph;
import com.sun.tools.internal.xjc.reader.xmlschema.bindinfo.BIProperty;
import com.sun.xml.internal.bind.v2.model.core.WildcardMode;
import com.sun.xml.internal.xsom.XSParticle;
/**
* {@link ParticleBinder} that uses {@link ExpressionBuilder} et al
* for better, more intuitive (but non spec-conforming) binding.
*
* @author Kohsuke Kawaguchi
*/
final class ExpressionParticleBinder extends ParticleBinder {
public void build(XSParticle p, Collection<XSParticle> forcedProps) {
// this class isn't about spec conformance, but
// for the ease of use.
// so we don't give a damn about 'forcedProps'.
// although, for a future note, it's conceivable to expand
// the binding algorithm to cover this notion.
Expression tree = ExpressionBuilder.createTree(p);
Graph g = new Graph(tree);
for (ConnectedComponent cc : g) {
buildProperty(cc);
}
}
/**
* Builds a property ouf ot a connected component.
*/
private void buildProperty(ConnectedComponent cc) {
StringBuilder propName = new StringBuilder(); // property name
int nameTokenCount = 0; // combine only up to 3
RawTypeSetBuilder rtsb = new RawTypeSetBuilder();
for (Element e : cc) {
GElement ge = (GElement)e;
if(nameTokenCount<3) {
if(nameTokenCount!=0)
propName.append("And");
propName.append(makeJavaName(cc.isCollection(),ge.getPropertyNameSeed()));
nameTokenCount++;
}
if(e instanceof GElementImpl) {
GElementImpl ei = (GElementImpl) e;
rtsb.elementDecl(ei.decl);
continue;
}
if(e instanceof GWildcardElement) {
GWildcardElement w = (GWildcardElement)e;
rtsb.getRefs().add(new RawTypeSetBuilder.WildcardRef(
w.isStrict() ? WildcardMode.STRICT : WildcardMode.SKIP));
continue;
}
assert false : e; // no other kind should be here
}
Multiplicity m = Multiplicity.ONE;
if(cc.isCollection())
m = m.makeRepeated();
if(!cc.isRequired())
m = m.makeOptional();
RawTypeSet rts = new RawTypeSet(rtsb.getRefs(),m);
XSParticle p = findSourceParticle(cc);
BIProperty cust = BIProperty.getCustomization(p);
CPropertyInfo prop = cust.createElementOrReferenceProperty(
propName.toString(), false, p, rts );
getCurrentBean().addProperty(prop);
}
/**
* Finds a {@link XSParticle} that can serve as the representative property of
* the given {@link ConnectedComponent}.
*
* The representative property is used for reporting an error location and
* taking {@link BIProperty} customization. Right now, the algorithm is just pick
* the first one with {@link BIProperty}, but one can think of a better algorithm,
* such as taking a choice of (A|B) if CC={A,B}.
*/
private XSParticle findSourceParticle(ConnectedComponent cc) {
XSParticle first = null;
for (Element e : cc) {
GElement ge = (GElement)e;
for (XSParticle p : ge.particles) {
if(first==null)
first = p;
if(getLocalPropCustomization(p)!=null)
return p;
}
// if there are multiple property customizations,
// all but one will be left unused, which will be detected as an error
// later, so no need to check that now.
}
// if no customization was found, just use the first one.
return first;
}
public boolean checkFallback(XSParticle p) {
// this algorithm never falls back to 'getContent'.
return false;
}
}