325N/A/*
325N/A * Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved.
325N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
325N/A *
325N/A * This code is free software; you can redistribute it and/or modify it
325N/A * under the terms of the GNU General Public License version 2 only, as
325N/A * published by the Free Software Foundation. Oracle designates this
325N/A * particular file as subject to the "Classpath" exception as provided
325N/A * by Oracle in the LICENSE file that accompanied this code.
325N/A *
325N/A * This code is distributed in the hope that it will be useful, but WITHOUT
325N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
325N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
325N/A * version 2 for more details (a copy is included in the LICENSE file that
325N/A * accompanied this code).
325N/A *
325N/A * You should have received a copy of the GNU General Public License version
325N/A * 2 along with this work; if not, write to the Free Software Foundation,
325N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
325N/A *
325N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
325N/A * or visit www.oracle.com if you need additional information or have any
325N/A * questions.
325N/A */
325N/A
325N/Apackage com.sun.xml.internal.ws.server.sei;
325N/A
325N/Aimport com.sun.xml.internal.ws.api.SOAPVersion;
325N/Aimport com.sun.xml.internal.ws.api.WSBinding;
325N/Aimport com.sun.xml.internal.ws.api.message.Message;
325N/Aimport com.sun.xml.internal.ws.api.message.Packet;
325N/Aimport com.sun.xml.internal.ws.fault.SOAPFaultBuilder;
325N/Aimport com.sun.xml.internal.ws.message.jaxb.JAXBMessage;
325N/Aimport com.sun.xml.internal.ws.model.JavaMethodImpl;
325N/Aimport com.sun.xml.internal.ws.model.ParameterImpl;
325N/Aimport com.sun.xml.internal.ws.model.WrapperParameter;
325N/A
325N/Aimport javax.jws.WebParam.Mode;
325N/Aimport javax.xml.bind.JAXBException;
325N/Aimport javax.xml.stream.XMLStreamException;
325N/Aimport javax.xml.ws.Holder;
325N/Aimport javax.xml.ws.ProtocolException;
325N/Aimport javax.xml.ws.WebServiceException;
325N/Aimport java.lang.reflect.InvocationTargetException;
325N/Aimport java.lang.reflect.Method;
325N/Aimport java.util.ArrayList;
325N/Aimport java.util.List;
325N/Aimport java.util.logging.Level;
325N/Aimport java.util.logging.Logger;
325N/A
325N/A/**
325N/A *
325N/A * <p>
325N/A * This class mainly performs the following two tasks:
325N/A * <ol>
325N/A * <li>Takes a {@link Message] that represents a request,
325N/A * and extracts the arguments (and updates {@link Holder}s.)
325N/A * <li>Accepts return value and {@link Holder} arguments for a Java method,
325N/A * and creates {@link JAXBMessage} that represents a response message.
325N/A * </ol>
325N/A *
325N/A * <h2>Creating {@link JAXBMessage}</h2>
325N/A * <p>
325N/A * At the construction time, we prepare {@link EndpointArgumentsBuilder} that knows how to create endpoint {@link Method}
325N/A * invocation arguments.
325N/A * we also prepare {@link EndpointResponseMessageBuilder} and {@link MessageFiller}s
325N/A * that know how to move arguments into a {@link Message}.
325N/A * Some arguments go to the payload, some go to headers, still others go to attachments.
325N/A *
325N/A * @author Jitendra Kotamraju
325N/A */
325N/Afinal class EndpointMethodHandler {
325N/A
325N/A private final SOAPVersion soapVersion;
325N/A private final Method method;
325N/A private final int noOfArgs;
325N/A private final JavaMethodImpl javaMethodModel;
325N/A
325N/A private final Boolean isOneWay;
325N/A
325N/A // Converts {@link Message} --> Object[]
325N/A private final EndpointArgumentsBuilder argumentsBuilder;
325N/A
325N/A // these objects together create a response message from method parameters
325N/A private final EndpointResponseMessageBuilder bodyBuilder;
325N/A private final MessageFiller[] outFillers;
325N/A
325N/A private final SEIInvokerTube owner;
325N/A
325N/A public EndpointMethodHandler(SEIInvokerTube owner, JavaMethodImpl method, WSBinding binding) {
325N/A this.owner = owner;
325N/A this.soapVersion = binding.getSOAPVersion();
325N/A this.method = method.getMethod();
325N/A this.javaMethodModel = method;
325N/A argumentsBuilder = createArgumentsBuilder();
325N/A List<MessageFiller> fillers = new ArrayList<MessageFiller>();
325N/A bodyBuilder = createResponseMessageBuilder(fillers);
325N/A this.outFillers = fillers.toArray(new MessageFiller[fillers.size()]);
325N/A this.isOneWay = method.getMEP().isOneWay();
325N/A this.noOfArgs = this.method.getParameterTypes().length;
325N/A }
325N/A
325N/A /**
325N/A * It builds EndpointArgumentsBuilder which converts request {@link Message} to endpoint method's invocation
325N/A * arguments Object[]
325N/A *
325N/A * @return EndpointArgumentsBuilder
325N/A */
325N/A private EndpointArgumentsBuilder createArgumentsBuilder() {
325N/A EndpointArgumentsBuilder argsBuilder;
325N/A List<ParameterImpl> rp = javaMethodModel.getRequestParameters();
325N/A List<EndpointArgumentsBuilder> builders = new ArrayList<EndpointArgumentsBuilder>();
325N/A
325N/A for( ParameterImpl param : rp ) {
325N/A EndpointValueSetter setter = EndpointValueSetter.get(param);
325N/A switch(param.getInBinding().kind) {
325N/A case BODY:
325N/A if(param.isWrapperStyle()) {
325N/A if(param.getParent().getBinding().isRpcLit())
325N/A builders.add(new EndpointArgumentsBuilder.RpcLit((WrapperParameter)param));
325N/A else
325N/A builders.add(new EndpointArgumentsBuilder.DocLit((WrapperParameter)param, Mode.OUT));
325N/A } else {
325N/A builders.add(new EndpointArgumentsBuilder.Body(param.getBridge(),setter));
325N/A }
325N/A break;
325N/A case HEADER:
325N/A builders.add(new EndpointArgumentsBuilder.Header(soapVersion, param, setter));
325N/A break;
325N/A case ATTACHMENT:
325N/A builders.add(EndpointArgumentsBuilder.AttachmentBuilder.createAttachmentBuilder(param, setter));
325N/A break;
325N/A case UNBOUND:
325N/A builders.add(new EndpointArgumentsBuilder.NullSetter(setter,
325N/A EndpointArgumentsBuilder.getVMUninitializedValue(param.getTypeReference().type)));
325N/A break;
325N/A default:
325N/A throw new AssertionError();
325N/A }
325N/A }
325N/A
325N/A // creates {@link Holder} arguments for OUT parameters
325N/A List<ParameterImpl> resp = javaMethodModel.getResponseParameters();
325N/A for( ParameterImpl param : resp ) {
325N/A if (param.isWrapperStyle()) {
325N/A WrapperParameter wp = (WrapperParameter)param;
325N/A List<ParameterImpl> children = wp.getWrapperChildren();
325N/A for (ParameterImpl p : children) {
325N/A if (p.isOUT() && p.getIndex() != -1) {
325N/A EndpointValueSetter setter = EndpointValueSetter.get(p);
325N/A builders.add(new EndpointArgumentsBuilder.NullSetter(setter, null));
325N/A }
325N/A }
325N/A } else if (param.isOUT() && param.getIndex() != -1) {
325N/A EndpointValueSetter setter = EndpointValueSetter.get(param);
325N/A builders.add(new EndpointArgumentsBuilder.NullSetter(setter, null));
325N/A }
325N/A }
325N/A
325N/A switch(builders.size()) {
325N/A case 0:
325N/A argsBuilder = EndpointArgumentsBuilder.NONE;
325N/A break;
325N/A case 1:
325N/A argsBuilder = builders.get(0);
325N/A break;
325N/A default:
325N/A argsBuilder = new EndpointArgumentsBuilder.Composite(builders);
325N/A }
325N/A return argsBuilder;
325N/A }
325N/A
325N/A /**
325N/A * prepare objects for creating response {@link Message}
325N/A */
325N/A private EndpointResponseMessageBuilder createResponseMessageBuilder(List<MessageFiller> fillers) {
325N/A
325N/A EndpointResponseMessageBuilder bodyBuilder = null;
325N/A List<ParameterImpl> rp = javaMethodModel.getResponseParameters();
325N/A
325N/A for (ParameterImpl param : rp) {
325N/A ValueGetter getter = ValueGetter.get(param);
325N/A
325N/A switch(param.getOutBinding().kind) {
325N/A case BODY:
325N/A if(param.isWrapperStyle()) {
325N/A if(param.getParent().getBinding().isRpcLit()) {
325N/A bodyBuilder = new EndpointResponseMessageBuilder.RpcLit((WrapperParameter)param,
325N/A soapVersion);
325N/A } else {
325N/A bodyBuilder = new EndpointResponseMessageBuilder.DocLit((WrapperParameter)param,
325N/A soapVersion);
325N/A }
325N/A } else {
325N/A bodyBuilder = new EndpointResponseMessageBuilder.Bare(param, soapVersion);
325N/A }
325N/A break;
325N/A case HEADER:
325N/A fillers.add(new MessageFiller.Header(param.getIndex(), param.getBridge(), getter ));
325N/A break;
325N/A case ATTACHMENT:
325N/A fillers.add(MessageFiller.AttachmentFiller.createAttachmentFiller(param, getter));
325N/A break;
325N/A case UNBOUND:
325N/A break;
325N/A default:
325N/A throw new AssertionError(); // impossible
325N/A }
325N/A }
325N/A
325N/A if (bodyBuilder == null) {
325N/A // no parameter binds to body. we create an empty message
325N/A switch(soapVersion) {
325N/A case SOAP_11:
325N/A bodyBuilder = EndpointResponseMessageBuilder.EMPTY_SOAP11;
325N/A break;
325N/A case SOAP_12:
325N/A bodyBuilder = EndpointResponseMessageBuilder.EMPTY_SOAP12;
325N/A break;
325N/A default:
325N/A throw new AssertionError();
325N/A }
325N/A }
325N/A return bodyBuilder;
325N/A }
325N/A
325N/A
325N/A public Packet invoke(Packet req) {
325N/A Message reqMsg = req.getMessage();
325N/A Object[] args = new Object[noOfArgs];
325N/A try {
325N/A argumentsBuilder.readRequest(reqMsg,args);
325N/A } catch (JAXBException e) {
325N/A throw new WebServiceException(e);
325N/A } catch (XMLStreamException e) {
325N/A throw new WebServiceException(e);
325N/A }
325N/A // Some transports(like HTTP) may want to send response before envoking endpoint method
325N/A // Doing this here so that after closing the response stream, cannot read
325N/A // request from some transports(light weight http server)
325N/A if (isOneWay && req.transportBackChannel != null) {
325N/A req.transportBackChannel.close();
325N/A }
325N/A Message responseMessage;
325N/A try {
325N/A Object ret = owner.getInvoker(req).invoke(req, method, args);
325N/A responseMessage = isOneWay ? null : createResponseMessage(args, ret);
325N/A } catch (InvocationTargetException e) {
325N/A Throwable cause = e.getCause();
325N/A
325N/A if (!(cause instanceof RuntimeException) && cause instanceof Exception) {
325N/A // Service specific exception
325N/A LOGGER.log(Level.FINE, cause.getMessage(), cause);
325N/A responseMessage = SOAPFaultBuilder.createSOAPFaultMessage(soapVersion,
325N/A javaMethodModel.getCheckedException(cause.getClass()), cause);
325N/A } else {
325N/A if (cause instanceof ProtocolException) {
325N/A // Application code may be throwing it intentionally
325N/A LOGGER.log(Level.FINE, cause.getMessage(), cause);
325N/A } else {
325N/A // Probably some bug in application code
325N/A LOGGER.log(Level.SEVERE, cause.getMessage(), cause);
325N/A }
325N/A responseMessage = SOAPFaultBuilder.createSOAPFaultMessage(soapVersion, null, cause);
325N/A }
325N/A } catch (Exception e) {
325N/A LOGGER.log(Level.SEVERE, e.getMessage(), e);
325N/A responseMessage = SOAPFaultBuilder.createSOAPFaultMessage(soapVersion, null, e);
325N/A }
325N/A return req.createServerResponse(responseMessage, req.endpoint.getPort(), javaMethodModel.getOwner(), req.endpoint.getBinding());
325N/A }
325N/A
325N/A /**
325N/A * Creates a response {@link JAXBMessage} from method arguments, return value
325N/A *
325N/A * @return response message
325N/A */
325N/A private Message createResponseMessage(Object[] args, Object returnValue) {
325N/A Message msg = bodyBuilder.createMessage(args, returnValue);
325N/A
325N/A for (MessageFiller filler : outFillers)
325N/A filler.fillIn(args, returnValue, msg);
325N/A
325N/A return msg;
325N/A }
325N/A
325N/A private static final Logger LOGGER = Logger.getLogger(EndpointMethodHandler.class.getName());
325N/A}