com.sun.xml.ws.client.sei.BodyBuilder Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of rt Show documentation
Show all versions of rt Show documentation
JAX-WS Reference Implementation Runtime
The newest version!
/*
* Copyright (c) 1997, 2022 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.client.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 jakarta.xml.bind.JAXBException;
import javax.xml.namespace.QName;
import jakarta.xml.ws.Holder;
import jakarta.xml.ws.WebServiceException;
import java.util.List;
/**
* Builds a JAXB object that represents the payload.
*
* @see MessageFiller
* @author Kohsuke Kawaguchi
*/
abstract class BodyBuilder {
abstract Message createMessage(Object[] methodArgs);
static final BodyBuilder EMPTY_SOAP11 = new Empty(SOAPVersion.SOAP_11);
static final BodyBuilder EMPTY_SOAP12 = new Empty(SOAPVersion.SOAP_12);
private static final class Empty extends BodyBuilder {
private final SOAPVersion soapVersion;
public Empty(SOAPVersion soapVersion) {
this.soapVersion = soapVersion;
}
@Override
Message createMessage(Object[] methodArgs) {
return Messages.createEmpty(soapVersion);
}
}
/**
* Base class for those {@link BodyBuilder}s that build a {@link Message}
* from JAXB objects.
*/
private static abstract class JAXB extends BodyBuilder {
/**
* This object determines the binding of the object returned
* from {@link #build(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
final Message createMessage(Object[] methodArgs) {
return JAXBMessage.create( bridge, build(methodArgs), soapVersion );
}
/**
* Builds a JAXB object that becomes the payload.
*/
abstract Object build(Object[] methodArgs);
}
/**
* 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 BodyBuilder} from a bare parameter.
*/
Bare(ParameterImpl p, SOAPVersion soapVersion, ValueGetter getter) {
super(p.getXMLBridge(), soapVersion);
this.methodPos = p.getIndex();
this.getter = getter;
}
/**
* Picks up an object from the method arguments and uses it.
*/
@Override
Object build(Object[] methodArgs) {
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;
/**
* List of Parameters packed in the body.
* Only used for error diagnostics.
*/
protected List children;
protected Wrapped(WrapperParameter wp, SOAPVersion soapVersion, ValueGetterFactory getter) {
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 arg = getters[i].get(methodArgs[indices[i]]);
if(arg==null) {
throw new WebServiceException("Method Parameter: "+
children.get(i).getName()+" cannot be null. This is BP 1.1 R2211 violation.");
}
cs.values[i] = arg;
}
return cs;
}
}
/**
* Used to create a payload JAXB object by wrapping
* multiple parameters into one "wrapper bean".
*/
final static class DocLit extends Wrapped {
/**
* How does each wrapped parameter binds to XML?
*/
private final PropertyAccessor[] accessors;
/**
* Wrapper bean.
*/
private final Class wrapper;
/**
* Needed to get wrapper instantiation method.
*/
private BindingContext bindingContext;
private boolean dynamicWrapper;
/**
* Creates a {@link BodyBuilder} from a {@link WrapperParameter}.
*/
DocLit(WrapperParameter wp, SOAPVersion soapVersion, ValueGetterFactory getter) {
super(wp, soapVersion, getter);
bindingContext = wp.getOwner().getBindingContext();
wrapper = (Class)wp.getXMLBridge().getTypeInfo().type;
dynamicWrapper = WrapperComposite.class.equals(wrapper);
parameterBridges = new XMLBridge[children.size()];
accessors = new PropertyAccessor[children.size()];
for( int i=0; i=0; i-- ) {
accessors[i].set(bean,getters[i].get(methodArgs[indices[i]]));
}
return bean;
} catch (ReflectiveOperationException e) {
// this is irrecoverable
throw new InstantiationError(e.getMessage());
} 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!?)
*/
final static class RpcLit extends Wrapped {
/**
* Creates a {@link BodyBuilder} from a {@link WrapperParameter}.
*/
RpcLit(WrapperParameter wp, SOAPVersion soapVersion, ValueGetterFactory getter) {
super(wp, soapVersion, getter);
// we'll use CompositeStructure to pack requests
assert wp.getTypeInfo().type==WrapperComposite.class;
parameterBridges = new XMLBridge[children.size()];
for( int i=0; i