| /* |
| * Copyright (c) 1997, 2012, 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. |
| * |
| * @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 {@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; |
| } |
| |
| 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. |
| */ |
| 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<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 {@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". |
| */ |
| 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<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 {@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 {@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 {@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 {@link WrapperComposite}. |
| */ |
| Object build(Object[] methodArgs, Object returnValue) { |
| return buildWrapperComposite(methodArgs, returnValue); |
| } |
| } |
| } |