All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.viaoa.remote.multiplexer.info.BindInfo Maven / Gradle / Ivy

There is a newer version: 3.7.10
Show newest version
/*  Copyright 1999 Vince Via [email protected]
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
*/
package com.viaoa.remote.multiplexer.info;

import java.lang.annotation.Annotation;
import java.lang.ref.ReferenceQueue;
import java.lang.ref.WeakReference;
import java.lang.reflect.Method;
import java.util.HashMap;
import java.util.logging.Logger;

import com.viaoa.remote.multiplexer.annotation.OARemoteInterface;
import com.viaoa.remote.multiplexer.annotation.OARemoteMethod;
import com.viaoa.remote.multiplexer.annotation.OARemoteParameter;

/**
 * Internal information about a remote Object. 
 * One side (Client/Server) will have the real object, and the other side will have a proxy.
 * Any reference that is passed between the C/S will use the name, and then replaced with 
 * the real/proxy instance by the receiving side. 
 * @author vvia
 */
public class BindInfo {
    private static Logger LOG = Logger.getLogger(BindInfo.class.getName());

    // internal name of object, that is past instead of the real object
    public short id;
    public String name;
    
    public boolean isBroadcast;
    public boolean usesQueue;
    public String asyncQueueName;
    public int asyncQueueSize;
    public boolean isOASync;

    public WeakReference weakRef;
    public Class interfaceClass; // used to create the proxy
    
    private HashMap hmNameToMethod;
    private HashMap hmMethod;

    public BindInfo(String name, Object obj, Class interfaceClass, ReferenceQueue referenceQueue, boolean bIsBroadcast, String queueName, int queueSize) {
        this.name = name;
        if (obj != null) setObject(obj, referenceQueue);
        this.interfaceClass = interfaceClass;
        this.isBroadcast = bIsBroadcast;
        this.asyncQueueName = queueName;
        this.asyncQueueSize = queueSize;
        this.usesQueue = (asyncQueueName != null);

        OARemoteInterface rc = (OARemoteInterface) interfaceClass.getAnnotation(OARemoteInterface.class);
        if (rc != null) {
            this.isOASync = rc.isOASync();
        }
    }
    
    
    public void setObject(Object obj, ReferenceQueue referenceQueue) {
        if (referenceQueue == null) weakRef = new WeakReference(obj);
        else weakRef = new WeakReference(obj, referenceQueue);
    }
    private boolean bObjectGCd;
    public Object getObject() {
        if (weakRef != null) {
            Object obj = weakRef.get();
            if (obj == null && !bObjectGCd) {
                bObjectGCd = true;
                LOG.warning("object has been GCd, name="+name);
            }
            return obj;
        }
        return null;
    }
    
    public MethodInfo getMethodInfo(String methodNameSig) {
        if (hmNameToMethod == null) loadMethodInfo();
        MethodInfo mi = hmNameToMethod.get(methodNameSig);
        return mi;
    }
    public MethodInfo getMethodInfo(Method method) {
        if (hmMethod == null) loadMethodInfo();
        MethodInfo mi = hmMethod.get(method);
        return mi;
    }
    
    /**
     * used to initialize the information about the methods for the bind class.
     */
    public synchronized void loadMethodInfo() {
        if (interfaceClass == null) return;
        hmNameToMethod = new HashMap(23, .75f);
        hmMethod = new HashMap();

        /*
        RemoteInterface remoteInterface = (RemoteInterface) interfaceClass.getAnnotation(RemoteInterface.class);
        if (remoteInterface != null) {
        }
        */
        
        Method[] methods = interfaceClass.getMethods();
        for (Method method : methods) {
            int sig = 0;  // create a dummy signature, to recognize method overloading
            Class[] cs = method.getParameterTypes();
            for (int j=0; cs != null && j < cs.length; j++) {
                sig *= 10;
                sig += (cs[j].getName().hashCode() % 500);
            }
            MethodInfo mi = new MethodInfo();
            mi.method = method;
            mi.methodNameSignature = method.getName() + sig; 
            
            boolean bRemote = false;
            Class c = method.getReturnType();
            if (c != null && !c.isPrimitive()) {
                OARemoteInterface rc = (OARemoteInterface) c.getAnnotation(OARemoteInterface.class);
                bRemote = (rc != null);
            }
            if (bRemote) {
                mi.remoteReturn = c;
                if (!c.isInterface()) {
                    Class[] csx = c.getInterfaces();
                    Class cx;
                    if (csx != null && csx.length > 0) cx = csx[0];
                    else cx = c;
                    String s = "bindName="+name+", method="+method;
                    s += ", will use interface="+cx;
                    LOG.warning("return value must be a Java Interface, since returnValueIsRemote() is true, "+s);
                    mi.remoteReturn = cx;
                }
            }

            OARemoteMethod remoteMethod = method.getAnnotation(OARemoteMethod.class);
            if (remoteMethod != null) {
                if (remoteMethod.compressedReturnValue()) {
                    if (mi.remoteReturn == null) {
                        mi.compressedReturn = true;
                    }
                }
                mi.noReturnValue = remoteMethod.noReturnValue();
                mi.timeoutSeconds = Math.max(0, remoteMethod.timeoutSeconds());
                mi.dontUseQueue = remoteMethod.dontUseQueue();
                mi.dontUseQueueForReturnValue = remoteMethod.dontUseQueueForReturnValue();
                mi.returnOnQueueSocket = remoteMethod.returnOnQueueSocket();
            }

            // check to see if any of the params are remote
            cs = method.getParameterTypes();
            Annotation[][] anns = method.getParameterAnnotations(); 
            
            int x = cs == null ? 0 : cs.length;

            for (int i=0; i i) {
                    OARemoteParameter rp = (OARemoteParameter)(anns[i][0]);
                    if (rp != null) {
                        bCompressed = rp.compressed();
                        bDontUseQue = rp.dontUseQueue();
                    }
                }
                if (bCompressed) {
                    if (mi.compressedParams == null) {
                        mi.compressedParams = new boolean[cs.length];
                    }
                    mi.compressedParams[i] = true;
                }
                if (bDontUseQue) {
                    if (mi.dontUseQueues == null) {
                        mi.dontUseQueues = new boolean[cs.length];
                    }
                    mi.dontUseQueues[i] = true;
                }
                
                if (bRemote) {
                    if (mi.remoteParams == null) {
                        mi.remoteParams = new Class[cs.length];
                    }
                    c = cs[i];
                    mi.remoteParams[i] = c; 
                    if (!c.isInterface()) {
                        Class[] csx = c.getInterfaces();
                        Class cx;
                        if (csx != null && csx.length > 0) cx = csx[0];
                        else cx = c;
                        String s = "bindName="+name+", method="+method;
                        s += ", param#" + i;
                        s += ", will use interface="+cx;
                        // callback must be defined as an Interface
                        LOG.warning("method "+method.getName()+" has a param annotated as remote, that is invalid - the param must be an Interface, "+s);
                        mi.remoteParams[i] = c; 
                    }
                }
            }
            hmMethod.put(method, mi);
            hmNameToMethod.put(mi.methodNameSignature, mi);
        }
    }
}