ohair@286: /*
ohair@286:  * Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved.
ohair@286:  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
ohair@286:  *
ohair@286:  * This code is free software; you can redistribute it and/or modify it
ohair@286:  * under the terms of the GNU General Public License version 2 only, as
ohair@286:  * published by the Free Software Foundation.  Oracle designates this
ohair@286:  * particular file as subject to the "Classpath" exception as provided
ohair@286:  * by Oracle in the LICENSE file that accompanied this code.
ohair@286:  *
ohair@286:  * This code is distributed in the hope that it will be useful, but WITHOUT
ohair@286:  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
ohair@286:  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
ohair@286:  * version 2 for more details (a copy is included in the LICENSE file that
ohair@286:  * accompanied this code).
ohair@286:  *
ohair@286:  * You should have received a copy of the GNU General Public License version
ohair@286:  * 2 along with this work; if not, write to the Free Software Foundation,
ohair@286:  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
ohair@286:  *
ohair@286:  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
ohair@286:  * or visit www.oracle.com if you need additional information or have any
ohair@286:  * questions.
ohair@286:  */
ohair@286: 
ohair@286: package com.sun.xml.internal.ws.server.provider;
ohair@286: 
ohair@286: import com.sun.istack.internal.NotNull;
ohair@286: import com.sun.xml.internal.ws.api.WSBinding;
ohair@286: import com.sun.xml.internal.ws.api.server.AsyncProvider;
ohair@286: import com.sun.xml.internal.ws.resources.ServerMessages;
ohair@286: import com.sun.xml.internal.ws.spi.db.BindingHelper;
ohair@286: 
ohair@286: import javax.activation.DataSource;
ohair@286: import javax.xml.soap.SOAPMessage;
ohair@286: import javax.xml.transform.Source;
ohair@286: import javax.xml.ws.Provider;
ohair@286: import javax.xml.ws.Service;
ohair@286: import javax.xml.ws.ServiceMode;
ohair@286: import javax.xml.ws.WebServiceException;
ohair@286: import javax.xml.ws.soap.SOAPBinding;
ohair@286: import java.lang.reflect.ParameterizedType;
ohair@286: import java.lang.reflect.Type;
ohair@286: 
ohair@286: 
ohair@286: /**
ohair@286:  * Keeps the runtime information like Service.Mode and erasure of Provider class
ohair@286:  * about Provider endpoint. It proccess annotations to find about Service.Mode
ohair@286:  * It also finds about parameterized type(e.g. Source, SOAPMessage, DataSource)
ohair@286:  * of endpoint class.
ohair@286:  *
ohair@286:  * @author Jitendra Kotamraju
ohair@286:  * @author Kohsuke Kawaguchi
ohair@286:  */
ohair@286: final class ProviderEndpointModel<T> {
ohair@286:     /**
ohair@286:      * True if this is {@link AsyncProvider}.
ohair@286:      */
ohair@286:     final boolean isAsync;
ohair@286: 
ohair@286:     /**
ohair@286:      * In which mode does this provider operate?
ohair@286:      */
ohair@286:     @NotNull final Service.Mode mode;
ohair@286:     /**
ohair@286:      * T of {@link Provider}&lt;T>.
ohair@286:      */
ohair@286:     @NotNull final Class datatype;
ohair@286:     /**
ohair@286:      * User class that extends {@link Provider}.
ohair@286:      */
ohair@286:     @NotNull final Class implClass;
ohair@286: 
ohair@286:     ProviderEndpointModel(Class<T> implementorClass, WSBinding binding) {
ohair@286:         assert implementorClass != null;
ohair@286:         assert binding != null;
ohair@286: 
ohair@286:         implClass = implementorClass;
ohair@286:         mode = getServiceMode(implementorClass);
ohair@286:         Class otherClass = (binding instanceof SOAPBinding)
ohair@286:             ? SOAPMessage.class : DataSource.class;
ohair@286:         isAsync = AsyncProvider.class.isAssignableFrom(implementorClass);
ohair@286: 
ohair@286: 
ohair@286:         Class<? extends Object> baseType = isAsync ? AsyncProvider.class : Provider.class;
ohair@286:         Type baseParam = BindingHelper.getBaseType(implementorClass, baseType);
ohair@286:         if (baseParam==null)
ohair@286:             throw new WebServiceException(ServerMessages.NOT_IMPLEMENT_PROVIDER(implementorClass.getName()));
ohair@286:         if (!(baseParam instanceof ParameterizedType))
ohair@286:             throw new WebServiceException(ServerMessages.PROVIDER_NOT_PARAMETERIZED(implementorClass.getName()));
ohair@286: 
ohair@286:         ParameterizedType pt = (ParameterizedType)baseParam;
ohair@286:         Type[] types = pt.getActualTypeArguments();
ohair@286:         if(!(types[0] instanceof Class))
ohair@286:             throw new WebServiceException(ServerMessages.PROVIDER_INVALID_PARAMETER_TYPE(implementorClass.getName(),types[0]));
ohair@286:         datatype = (Class)types[0];
ohair@286: 
ohair@286:         if (mode == Service.Mode.PAYLOAD && datatype!=Source.class) {
ohair@286:             // Illegal to have PAYLOAD && SOAPMessage
ohair@286:             // Illegal to have PAYLOAD && DataSource
ohair@286:             throw new IllegalArgumentException(
ohair@286:                 "Illeagal combination - Mode.PAYLOAD and Provider<"+otherClass.getName()+">");
ohair@286:         }
ohair@286:     }
ohair@286: 
ohair@286:     /**
ohair@286:      * Is it PAYLOAD or MESSAGE ??
ohair@286:      *
ohair@286:      * @param c endpoint class
ohair@286:      * @return Service.Mode.PAYLOAD or Service.Mode.MESSAGE
ohair@286:      */
ohair@286:     private static Service.Mode getServiceMode(Class<?> c) {
ohair@286:         ServiceMode mode = c.getAnnotation(ServiceMode.class);
ohair@286:         return (mode == null) ? Service.Mode.PAYLOAD : mode.value();
ohair@286:     }
ohair@286: }