org/objectweb/proactive/core/group/spmd/ProSPMD.java

/* 
 * ################################################################
 * 
 * ProActive: The Java(TM) library for Parallel, Distributed, 
 *            Concurrent computing with Security and Mobility
 * 
 * Copyright (C) 1997-2007 INRIA/University of Nice-Sophia Antipolis
 * Contact: proactive@objectweb.org
 * 
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or any later version.
 *  
 * This library 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
 * Lesser General Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307
 * USA
 *  
 *  Initial developer(s):               The ProActive Team
 *                        http://www.inria.fr/oasis/ProActive/contacts.html
 *  Contributor(s): 
 * 
 * ################################################################
 */ 
package org.objectweb.proactive.core.group.spmd;

import java.lang.reflect.InvocationTargetException;

import org.objectweb.proactive.ActiveObjectCreationException;
import org.objectweb.proactive.ProActive;
import org.objectweb.proactive.core.body.AbstractBody;
import org.objectweb.proactive.core.descriptor.data.VirtualNode;
import org.objectweb.proactive.core.group.Group;
import org.objectweb.proactive.core.group.ProActiveGroup;
import org.objectweb.proactive.core.group.ProxyForGroup;
import org.objectweb.proactive.core.mop.ClassNotReifiableException;
import org.objectweb.proactive.core.node.Node;
import org.objectweb.proactive.core.node.NodeException;
import org.objectweb.proactive.core.node.NodeFactory;


public class ProSPMD {

    public static Object newSPMDGroup(String className, Object[][] params,
        String nodeName)
        throws ClassNotFoundException, ClassNotReifiableException, 
            ActiveObjectCreationException, NodeException {
        Node[] nodeList = new Node[1];
        nodeList[0] = NodeFactory.getNode(nodeName);
        return ProSPMD.newSPMDGroup(className, params, nodeList);
    }

    public static Object newSPMDGroup(String className, Object[][] params,
        String[] nodeListString)
        throws ClassNotFoundException, ClassNotReifiableException, 
            ActiveObjectCreationException, NodeException {
        Node[] nodeList = new Node[nodeListString.length];
        for (int i = 0; i < nodeListString.length; i++)
            nodeList[i] = NodeFactory.getNode(nodeListString[i]);
        return ProSPMD.newSPMDGroup(className, params, nodeList);
    }

    public static Object newSPMDGroup(String className, Object[][] params,
        Node node)
        throws ClassNotFoundException, ClassNotReifiableException, 
            ActiveObjectCreationException, NodeException {
        Node[] nodeList = new Node[1];
        nodeList[0] = node;
        return ProSPMD.newSPMDGroup(className, params, nodeList);
    }

    public static Object newSPMDGroup(String className, Object[][] params,
        Node[] nodeList)
        throws ClassNotFoundException, ClassNotReifiableException, 
            ActiveObjectCreationException, NodeException {
        Object result = ProActiveGroup.newGroup(className);
        Group g = ProActiveGroup.getGroup(result);

        if (params != null) {
            for (int i = 0; i < params.length; i++) {
                g.add(ProActive.newActive(className, params[i],
                        nodeList[i % nodeList.length]));
            }
        }
        ((ProxyForGroup) g).setSPMDGroup(result);
        return result;
    }

    public static Object newSPMDGroup(String className, Object[][] params,
        VirtualNode virtualNode)
        throws ClassNotFoundException, ClassNotReifiableException, 
            ActiveObjectCreationException, NodeException {
        return ProSPMD.newSPMDGroup(className, params, virtualNode.getNodes());
    }

    // -------------------------------------------------------------------------
    // InParallel OOSPMD constructors
    // -------------------------------------------------------------------------

    public static Object newSPMDGroupInParallel(String className,
        Object[][] params, String nodeName)
        throws ClassNotFoundException, ClassNotReifiableException, 
            NodeException {
        Node[] nodeList = new Node[1];
        nodeList[0] = NodeFactory.getNode(nodeName);
        return ProSPMD.newSPMDGroupInParallel(className, params, nodeList);
    }

    public static Object newSPMDGroupInParallel(String className,
        Object[][] params, String[] nodeListString)
        throws ClassNotFoundException, ClassNotReifiableException, 
            NodeException {
        Node[] nodeList = new Node[nodeListString.length];
        for (int i = 0; i < nodeListString.length; i++)
            nodeList[i] = NodeFactory.getNode(nodeListString[i]);
        return ProSPMD.newSPMDGroupInParallel(className, params, nodeList);
    }

    public static Object newSPMDGroupInParallel(String className,
        Object[][] params, Node node)
        throws ClassNotFoundException, ClassNotReifiableException {
        Node[] nodeList = new Node[1];
        nodeList[0] = node;
        return ProSPMD.newSPMDGroupInParallel(className, params, nodeList);
    }

    public static Object newSPMDGroupInParallel(String className,
        Object[][] params, VirtualNode virtualNode)
        throws ClassNotFoundException, ClassNotReifiableException, 
            NodeException {
        return ProSPMD.newSPMDGroupInParallel(className, params,
            virtualNode.getNodes());
    }

    public static Object newSPMDGroupInParallel(String className,
        Object[][] params, Node[] nodeList)
        throws ClassNotFoundException, ClassNotReifiableException {
        Object result = ProActiveGroup.newGroup(className);
        ProxyForGroup proxy = (org.objectweb.proactive.core.group.ProxyForGroup) ProActiveGroup.getGroup(result);

        proxy.createMemberWithMultithread(className, null, params, nodeList);

        proxy.setSPMDGroup(result);

        return result;
    }

    // -------------------------------------------------------------------------
    // End InParallel
    // -------------------------------------------------------------------------
    //    /**
    //     * Set the SPMD group for this
    //     * @param o - the new SPMD group
    //     */
    //    public static void setSPMDGroupOnThis(Object o) {
    //        AbstractBody body = (AbstractBody) ProActive.getBodyOnThis();
    //        body.setSPMDGroup(o);
    //    }

    public static Object getSPMDGroup() {
        AbstractBody body = (AbstractBody) ProActive.getBodyOnThis();
        return body.getSPMDGroup();
    }

    public static int getMySPMDGroupSize() {
        return ProActiveGroup.getGroup(ProSPMD.getSPMDGroup()).size();
    }

    public static int getMyRank() {
        return ProActiveGroup.getGroup(ProSPMD.getSPMDGroup()).indexOf(ProActive.getStubOnThis());
    }

    public static void barrier(String barrierName) {
        ProSPMD.barrier(barrierName, ProSPMD.getSPMDGroup());
    }

    public static void barrier(String barrierName, Object group) {
        try {
            // add the barrier into the tag list
            AbstractBody body = (AbstractBody) ProActive.getBodyOnThis();
            body.getProActiveSPMDGroupManager().addToBarrierTags(barrierName);
            // set the number of awaited message barriers
            body.getProActiveSPMDGroupManager().setAwaitedBarrierCalls(barrierName,
                ProActiveGroup.size(group));
            // send the barrier messages
            ProxyForGroup proxy = (ProxyForGroup) ProActiveGroup.getGroup(group);
            proxy.reify(new MethodCallBarrier(barrierName));
        } catch (InvocationTargetException e) {
            System.err.println(
                "Unable to invoke a method call to control groups");
            e.printStackTrace();
        }
    }

    public static void barrier(String[] methodNames) {
        try {
            (ProActive.getStubOnThis()).getProxy().reify(new MethodCallBarrierWithMethodName(
                    methodNames));
        } catch (InvocationTargetException e) {
            System.err.println(
                "Unable to invoke a method call to control groups");
            e.printStackTrace();
        } catch (Throwable e) {
            System.err.println(
                "Unable to invoke a method call to control groups");
            e.printStackTrace();
        }
    }
}

---