/*
* Copyright (c) 1997, 2013, 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.ws.server.sei;
import com.sun.xml.internal.ws.api.SOAPVersion;
import com.sun.xml.internal.ws.api.message.Message;
import com.sun.xml.internal.ws.api.message.Messages;
import com.sun.xml.internal.ws.message.jaxb.JAXBMessage;
import com.sun.xml.internal.ws.model.ParameterImpl;
import com.sun.xml.internal.ws.model.WrapperParameter;
import com.sun.xml.internal.ws.spi.db.BindingContext;
import com.sun.xml.internal.ws.spi.db.XMLBridge;
import com.sun.xml.internal.ws.spi.db.PropertyAccessor;
import com.sun.xml.internal.ws.spi.db.WrapperComposite;
import javax.xml.bind.JAXBException;
import javax.xml.namespace.QName;
import javax.xml.ws.Holder;
import javax.xml.ws.WebServiceException;
import java.util.List;
Builds a JAXB object that represents the payload.
Author: Jitendra Kotamraju See Also: - MessageFiller
/**
* Builds a JAXB object that represents the payload.
*
* @see MessageFiller
* @author Jitendra Kotamraju
*/
public abstract class EndpointResponseMessageBuilder {
public abstract Message createMessage(Object[] methodArgs, Object returnValue);
public static final EndpointResponseMessageBuilder EMPTY_SOAP11 = new Empty(SOAPVersion.SOAP_11);
public static final EndpointResponseMessageBuilder EMPTY_SOAP12 = new Empty(SOAPVersion.SOAP_12);
private static final class Empty extends EndpointResponseMessageBuilder {
private final SOAPVersion soapVersion;
public Empty(SOAPVersion soapVersion) {
this.soapVersion = soapVersion;
}
public Message createMessage(Object[] methodArgs, Object returnValue) {
return Messages.createEmpty(soapVersion);
}
}
Base class for those EndpointResponseMessageBuilders that build a Message from JAXB objects. /**
* Base class for those {@link EndpointResponseMessageBuilder}s that build a {@link Message}
* from JAXB objects.
*/
private static abstract class JAXB extends EndpointResponseMessageBuilder {
This object determines the binding of the object returned from createMessage(Object[], Object) /**
* This object determines the binding of the object returned
* from {@link #createMessage(Object[], Object)}
*/
private final XMLBridge bridge;
private final SOAPVersion soapVersion;
protected JAXB(XMLBridge bridge, SOAPVersion soapVersion) {
assert bridge!=null;
this.bridge = bridge;
this.soapVersion = soapVersion;
}
public final Message createMessage(Object[] methodArgs, Object returnValue) {
return JAXBMessage.create( bridge, build(methodArgs, returnValue), soapVersion );
}
Builds a JAXB object that becomes the payload.
/**
* Builds a JAXB object that becomes the payload.
*/
abstract Object build(Object[] methodArgs, Object returnValue);
}
Used to create a payload JAXB object just by taking
one of the parameters.
/**
* Used to create a payload JAXB object just by taking
* one of the parameters.
*/
public final static class Bare extends JAXB {
The index of the method invocation parameters that goes into the payload.
/**
* The index of the method invocation parameters that goes into the payload.
*/
private final int methodPos;
private final ValueGetter getter;
Creates a EndpointResponseMessageBuilder from a bare parameter. /**
* Creates a {@link EndpointResponseMessageBuilder} from a bare parameter.
*/
public Bare(ParameterImpl p, SOAPVersion soapVersion) {
super(p.getXMLBridge(), soapVersion);
this.methodPos = p.getIndex();
this.getter = ValueGetter.get(p);
}
Picks up an object from the method arguments and uses it.
/**
* Picks up an object from the method arguments and uses it.
*/
Object build(Object[] methodArgs, Object returnValue) {
if (methodPos == -1) {
return returnValue;
}
return getter.get(methodArgs[methodPos]);
}
}
Used to handle a 'wrapper' style request.
Common part of rpc/lit and doc/lit.
/**
* Used to handle a 'wrapper' style request.
* Common part of rpc/lit and doc/lit.
*/
abstract static class Wrapped extends JAXB {
Where in the method argument list do they come from?
/**
* Where in the method argument list do they come from?
*/
protected final int[] indices;
Abstracts away the Holder handling when touching method arguments. /**
* Abstracts away the {@link Holder} handling when touching method arguments.
*/
protected final ValueGetter[] getters;
How does each wrapped parameter binds to XML?
/**
* How does each wrapped parameter binds to XML?
*/
protected XMLBridge[] parameterBridges;
Used for error diagnostics.
/**
* Used for error diagnostics.
*/
protected List<ParameterImpl> children;
protected Wrapped(WrapperParameter wp, SOAPVersion soapVersion) {
super(wp.getXMLBridge(), soapVersion);
children = wp.getWrapperChildren();
indices = new int[children.size()];
getters = new ValueGetter[children.size()];
for( int i=0; i<indices.length; i++ ) {
ParameterImpl p = children.get(i);
indices[i] = p.getIndex();
getters[i] = ValueGetter.get(p);
}
}
Packs a bunch of arguments intoa WrapperComposite. /**
* Packs a bunch of arguments intoa {@link WrapperComposite}.
*/
WrapperComposite buildWrapperComposite(Object[] methodArgs, Object returnValue) {
WrapperComposite cs = new WrapperComposite();
cs.bridges = parameterBridges;
cs.values = new Object[parameterBridges.length];
// fill in wrapped parameters from methodArgs
for( int i=indices.length-1; i>=0; i-- ) {
Object v;
if (indices[i] == -1) {
v = getters[i].get(returnValue);
} else {
v = getters[i].get(methodArgs[indices[i]]);
}
if(v==null) {
throw new WebServiceException("Method Parameter: "+
children.get(i).getName() +" cannot be null. This is BP 1.1 R2211 violation.");
}
cs.values[i] = v;
}
return cs;
}
}
Used to create a payload JAXB object by wrapping
multiple parameters into one "wrapper bean".
/**
* Used to create a payload JAXB object by wrapping
* multiple parameters into one "wrapper bean".
*/
public final static class DocLit extends Wrapped {
How does each wrapped parameter binds to XML?
/**
* How does each wrapped parameter binds to XML?
*/
private final PropertyAccessor[] accessors;
//private final RawAccessor retAccessor;
Wrapper bean.
/**
* Wrapper bean.
*/
private final Class wrapper;
private boolean dynamicWrapper;
Needed to get wrapper instantiation method.
/**
* Needed to get wrapper instantiation method.
*/
private BindingContext bindingContext;
Creates a EndpointResponseMessageBuilder from a WrapperParameter. /**
* Creates a {@link EndpointResponseMessageBuilder} from a {@link WrapperParameter}.
*/
public DocLit(WrapperParameter wp, SOAPVersion soapVersion) {
super(wp, soapVersion);
bindingContext = wp.getOwner().getBindingContext();
wrapper = (Class)wp.getXMLBridge().getTypeInfo().type;
dynamicWrapper = WrapperComposite.class.equals(wrapper);
children = wp.getWrapperChildren();
parameterBridges = new XMLBridge[children.size()];
accessors = new PropertyAccessor[children.size()];
for( int i=0; i<accessors.length; i++ ) {
ParameterImpl p = children.get(i);
QName name = p.getName();
if (dynamicWrapper) {
parameterBridges[i] = children.get(i).getInlinedRepeatedElementBridge();
if (parameterBridges[i] == null) parameterBridges[i] = children.get(i).getXMLBridge();
} else {
try {
accessors[i] = (dynamicWrapper) ? null :
p.getOwner().getBindingContext().getElementPropertyAccessor(
wrapper, name.getNamespaceURI(), name.getLocalPart() );
} catch (JAXBException e) {
throw new WebServiceException( // TODO: i18n
wrapper+" do not have a property of the name "+name,e);
}
}
}
}
Packs a bunch of arguments into a WrapperComposite. /**
* Packs a bunch of arguments into a {@link WrapperComposite}.
*/
Object build(Object[] methodArgs, Object returnValue) {
if (dynamicWrapper) return buildWrapperComposite(methodArgs, returnValue);
try {
//Object bean = wrapper.newInstance();
Object bean = bindingContext.newWrapperInstace(wrapper);
// fill in wrapped parameters from methodArgs
for( int i=indices.length-1; i>=0; i-- ) {
if (indices[i] == -1) {
accessors[i].set(bean, returnValue);
} else {
accessors[i].set(bean,getters[i].get(methodArgs[indices[i]]));
}
}
return bean;
} catch (InstantiationException e) {
// this is irrecoverable
Error x = new InstantiationError(e.getMessage());
x.initCause(e);
throw x;
} catch (IllegalAccessException e) {
// this is irrecoverable
Error x = new IllegalAccessError(e.getMessage());
x.initCause(e);
throw x;
} catch (com.sun.xml.internal.ws.spi.db.DatabindingException e) {
// this can happen when the set method throw a checked exception or something like that
throw new WebServiceException(e); // TODO:i18n
}
}
}
Used to create a payload JAXB object by wrapping multiple parameters into a WrapperComposite.
This is used for rpc/lit, as we don't have a wrapper bean for it.
(TODO: Why don't we have a wrapper bean for this, when doc/lit does!?)
/**
* Used to create a payload JAXB object by wrapping
* multiple parameters into a {@link WrapperComposite}.
*
* <p>
* This is used for rpc/lit, as we don't have a wrapper bean for it.
* (TODO: Why don't we have a wrapper bean for this, when doc/lit does!?)
*/
public final static class RpcLit extends Wrapped {
Creates a EndpointResponseMessageBuilder from a WrapperParameter. /**
* Creates a {@link EndpointResponseMessageBuilder} from a {@link WrapperParameter}.
*/
public RpcLit(WrapperParameter wp, SOAPVersion soapVersion) {
super(wp, soapVersion);
// we'll use CompositeStructure to pack requests
assert wp.getTypeInfo().type==WrapperComposite.class;
parameterBridges = new XMLBridge[children.size()];
for( int i=0; i<parameterBridges.length; i++ )
parameterBridges[i] = children.get(i).getXMLBridge();
}
Packs a bunch of arguments intoa WrapperComposite. /**
* Packs a bunch of arguments intoa {@link WrapperComposite}.
*/
Object build(Object[] methodArgs, Object returnValue) {
return buildWrapperComposite(methodArgs, returnValue);
}
}
}