Mercurial > jdk8-mips64-public > jaxws / file revision

 /*

  * 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);

         }

     }

 }