com.sun.xml.ws.server.sei.EndpointResponseMessageBuilder Maven / Gradle / Ivy
/*
* The contents of this file are subject to the terms
* of the Common Development and Distribution License
* (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/CDDLv1.0.html.
* See the License for the specific language governing
* permissions and limitations under the License.
*
* When distributing Covered Code, include this CDDL
* Header Notice in each file and include the License file
* at https://glassfish.dev.java.net/public/CDDLv1.0.html.
* If applicable, add the following below the CDDL Header,
* with the fields enclosed by brackets [] replaced by
* you own identifying information:
* "Portions Copyrighted [year] [name of copyright owner]"
*
* Copyright 2006 Sun Microsystems Inc. All Rights Reserved
*/
package com.sun.xml.ws.server.sei;
import com.sun.xml.bind.api.AccessorException;
import com.sun.xml.bind.api.Bridge;
import com.sun.xml.bind.api.CompositeStructure;
import com.sun.xml.bind.api.RawAccessor;
import com.sun.xml.ws.api.SOAPVersion;
import com.sun.xml.ws.api.message.Message;
import com.sun.xml.ws.api.message.Messages;
import com.sun.xml.ws.message.jaxb.JAXBMessage;
import com.sun.xml.ws.model.ParameterImpl;
import com.sun.xml.ws.model.WrapperParameter;
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.
*
* @see MessageFiller
* @author Jitendra Kotamraju
*/
abstract class EndpointResponseMessageBuilder {
abstract Message createMessage(Object[] methodArgs, Object returnValue);
static final EndpointResponseMessageBuilder EMPTY_SOAP11 = new Empty(SOAPVersion.SOAP_11);
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;
}
Message createMessage(Object[] methodArgs, Object returnValue) {
return Messages.createEmpty(soapVersion);
}
}
/**
* 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 {@link #createMessage(Object[], Object)}
*/
private final Bridge bridge;
private final SOAPVersion soapVersion;
protected JAXB(Bridge bridge, SOAPVersion soapVersion) {
assert bridge!=null;
this.bridge = bridge;
this.soapVersion = soapVersion;
}
final Message createMessage(Object[] methodArgs, Object returnValue) {
return JAXBMessage.create( bridge, build(methodArgs, returnValue), soapVersion );
}
/**
* 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.
*/
final static class Bare extends JAXB {
/**
* The index of the method invocation parameters that goes into the payload.
*/
private final int methodPos;
private final ValueGetter getter;
/**
* Creates a {@link EndpointResponseMessageBuilder} from a bare parameter.
*/
Bare(ParameterImpl p, SOAPVersion soapVersion) {
super(p.getBridge(), soapVersion);
this.methodPos = p.getIndex();
this.getter = ValueGetter.get(p);
}
/**
* 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.
*/
abstract static class Wrapped extends JAXB {
/**
* Where in the method argument list do they come from?
*/
protected final int[] indices;
/**
* Abstracts away the {@link Holder} handling when touching method arguments.
*/
protected final ValueGetter[] getters;
protected Wrapped(WrapperParameter wp, SOAPVersion soapVersion) {
super(wp.getBridge(), soapVersion);
List children = wp.getWrapperChildren();
indices = new int[children.size()];
getters = new ValueGetter[children.size()];
for( int i=0; i children = wp.getWrapperChildren();
accessors = new RawAccessor[children.size()];
for( int i=0; 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 (AccessorException 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 {@link CompositeStructure}.
*
*
* 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!?)
*/
final static class RpcLit extends Wrapped {
/**
* How does each wrapped parameter binds to XML?
*/
private final Bridge[] parameterBridges;
/**
* Used for error diagnostics.
*/
private final List children;
/**
* Creates a {@link EndpointResponseMessageBuilder} from a {@link WrapperParameter}.
*/
RpcLit(WrapperParameter wp, SOAPVersion soapVersion) {
super(wp, soapVersion);
// we'll use CompositeStructure to pack requests
assert wp.getTypeReference().type==CompositeStructure.class;
this.children = wp.getWrapperChildren();
parameterBridges = new Bridge[children.size()];
for( int i=0; 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;
}
}
}