001: /*
002: * Licensed to the Apache Software Foundation (ASF) under one
003: * or more contributor license agreements. See the NOTICE file
004: * distributed with this work for additional information
005: * regarding copyright ownership. The ASF licenses this file
006: * to you under the Apache License, Version 2.0 (the
007: * "License"); you may not use this file except in compliance
008: * with the License. You may obtain a copy of the License at
009: *
010: * http://www.apache.org/licenses/LICENSE-2.0
011: *
012: * Unless required by applicable law or agreed to in writing,
013: * software distributed under the License is distributed on an
014: * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
015: * KIND, either express or implied. See the License for the
016: * specific language governing permissions and limitations
017: * under the License.
018: */
019: package org.apache.axis2.jaxws.marshaller.impl.alt;
020:
021: import javax.xml.bind.JAXBElement;
022: import javax.xml.namespace.QName;
023:
024: /**
025: * Characteristics of the "Element" value. * The Element value is ready for marshalling or is the
026: * result of unmarshalling. * The Element value represents the element rendering. Thus it is either
027: * a JAXBElement or has the @XmlRootElement annotation. (i.e. it is never a java.lang.String) * The
028: * Element value is not a JAX-WS object. (i.e. it is not a holder or exception) Characteristis of
029: * the "Type" value * It is the type value associated with the element value. (Thus it is either
030: * the element value or it is value of the JAXBElement * The type value is usually the object needed
031: * for the method signature (i.e. String)
032: * <p/>
033: * Here is an example for illustration: <element name='e1'> <complexType>...</complexType>
034: * </element>
035: * <p/>
036: * <element name='e2' type='t2' /> <complexType name= 't2'>..
037: * <p/>
038: * <element name='e3' type='e3' /> <!-- note element and type have same name --> <complexType name=
039: * 'e3'>..
040: * <p/>
041: * JAXB will generate the following objects: E1, T2, E3 E1 will have an @XMLRootElement annotation.
042: * It is "element" and "type" enabled. e2 does not have a generated object. So it will be
043: * represented as a JAXBElement that contains an object T2. The JAXBElement is "element" enabled.
044: * T2 represents a complexType. It is only "type" enabled. E3 represents the e3 complexType (it
045: * does not represent the e3 element). Thus E3 is "type enabled".
046: * <p/>
047: * When JAXB unmarshals an object, it will return an "element" enabled object (either a generatated
048: * object with @XMLRootElement or a JAXBElement). Conversely, you must always marshal "element"
049: * enabled objects.
050: *
051: * @see PDElement
052: * <p/>
053: * At the signature level, the values passed as arguments in an SEI operation represent type
054: * enabled objects. Each of the object must be converted to an element enabled object to
055: * marshal (or conversely converted to a type enabled object when unmarshalling)
056: */
057: public class Element {
058:
059: private QName qName;
060: private Object elementValue;
061: private Object typeValue;
062: private Class typeClass;
063:
064: /**
065: * Create Element from an
066: *
067: * @param elementValue must be JAXBElement or @XmlRootElement rendered
068: * @param qName associated QName
069: */
070: public Element(Object elementValue, QName qName) {
071: if (elementValue != null) {
072: this .qName = qName;
073: this .elementValue = elementValue;
074: } else {
075: this .qName = qName;
076: this .typeValue = null;
077: this .typeClass = Object.class;
078: }
079: }
080:
081: /**
082: * @param typeValue must not be a JAXBElement. Must not have @XmlRootElement rendering.
083: * typeValue must not be a Holder or other JAXWS api value.
084: * @param qName associated QName
085: * @param cls
086: */
087: public Element(Object typeValue, QName qName, Class cls) {
088: this .qName = qName;
089: this .typeValue = typeValue;
090: this .typeClass = cls;
091:
092: }
093:
094: public Object getElementValue() {
095: if (elementValue == null) {
096: // Create ElementValue from type information
097: elementValue = new JAXBElement(qName, typeClass, typeValue);
098: }
099: return elementValue;
100: }
101:
102: public Object getTypeValue() {
103: if (elementValue != null) {
104: if (elementValue.getClass() == JAXBElement.class) {
105: return ((JAXBElement) elementValue).getValue();
106: } else {
107: return elementValue;
108: }
109: } else {
110: return typeValue;
111: }
112: }
113:
114: public QName getQName() {
115: return qName;
116: }
117: }
|