com.sun.xml.ws.server.sei.EndpointResponseMessageBuilder Maven / Gradle / Ivy
/*
* Copyright (c) 1997, 2021 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Distribution License v. 1.0, which is available at
* http://www.eclipse.org/org/documents/edl-v10.php.
*
* SPDX-License-Identifier: BSD-3-Clause
*/
package com.sun.xml.ws.server.sei;
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 com.sun.xml.ws.spi.db.BindingContext;
import com.sun.xml.ws.spi.db.XMLBridge;
import com.sun.xml.ws.spi.db.PropertyAccessor;
import com.sun.xml.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.
*
* @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;
}
@Override
public 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 XMLBridge bridge;
private final SOAPVersion soapVersion;
protected JAXB(XMLBridge bridge, SOAPVersion soapVersion) {
assert bridge!=null;
this.bridge = bridge;
this.soapVersion = soapVersion;
}
@Override
public 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.
*/
public 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.
*/
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.
*/
@Override
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;
/**
* How does each wrapped parameter binds to XML?
*/
protected XMLBridge[] parameterBridges;
/**
* Used for error diagnostics.
*/
protected List 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=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".
*/
public final static class DocLit extends Wrapped {
/**
* How does each wrapped parameter binds to XML?
*/
private final PropertyAccessor[] accessors;
//private final RawAccessor retAccessor;
/**
* Wrapper bean.
*/
private final Class wrapper;
private boolean dynamicWrapper;
/**
* Needed to get wrapper instantiation method.
*/
private BindingContext bindingContext;
/**
* 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=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.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 {@link 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!?)
*/
public final static class RpcLit extends Wrapped {
/**
* 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