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

co.paralleluniverse.actors.LocalActorUtil Maven / Gradle / Ivy

Go to download

Fibers, Channels and Actors for the JVM

There is a newer version: 0.8.0
Show newest version
/*
 * Quasar: lightweight threads and actors for the JVM.
 * Copyright (C) 2013, Parallel Universe Software Co. All rights reserved.
 * 
 * This program and the accompanying materials are dual-licensed under
 * either the terms of the Eclipse Public License v1.0 as published by
 * the Eclipse Foundation
 *  
 *   or (per the licensee's choosing)
 *  
 * under the terms of the GNU Lesser General Public License version 3.0
 * as published by the Free Software Foundation.
 */
package co.paralleluniverse.actors;

import co.paralleluniverse.strands.Strand;
import co.paralleluniverse.strands.channels.QueueChannel;
import java.util.List;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

/**
 * Static methods that provide access to {@link Actor}'s functionality through an {@link ActorRef} if the actor is local.
 * Application code shouldn't normally use these methods. They are provided mainly for testing, and defining sophisticated behaviors.
 * 

 * We provide these services as static methods rather than return a reference to the actor because we don't want anyone to accidentally
 * keep a reference to the actor itself.
 *
 * @author pron
 */
public final class LocalActorUtil {
    public static boolean isLocal(ActorRef actor) {
        return stripDelegates(actor) instanceof LocalActorRef;
    }

    public static void join(ActorRef actor) throws ExecutionException, InterruptedException {
        actorOf(actor).join();
    }

    public static void join(ActorRef actor, long timeout, TimeUnit unit) throws ExecutionException, InterruptedException, TimeoutException {
        actorOf(actor).join(timeout, unit);
    }

    public static  V get(ActorRef actor) throws ExecutionException, InterruptedException {
        return (V) actorOf(actor).get();
    }

    public static  V get(ActorRef actor, long timeout, TimeUnit unit) throws ExecutionException, InterruptedException, TimeoutException {
        return (V) actorOf(actor).get(timeout, unit);
    }

    public static QueueChannel getMailbox(ActorRef actor) {
        return actorOf(actor).mailbox();
    }

    public static Strand getStrand(ActorRef actor) {
        return actorOf(actor).getStrand();
    }

    public static boolean isDone(ActorRef actor) {
        return actorOf(actor).isDone();
    }

    public static ActorMonitor getMonitor(ActorRef actor) {
        return actorOf(actor).getMonitor();
    }

    public static void stopMonitor(ActorRef actor) {
        actorOf(actor).stopMonitor();
    }

    public static void register(ActorRef actor, String name) {
        actorOf(actor).register(name);
    }

    public static void register(ActorRef actor) {
        actorOf(actor).register();
    }

    public static void unregister(ActorRef actor) {
        actorOf(actor).unregister();
    }

    public static int getQueueLength(ActorRef actor) {
        return actorOf(actor).getQueueLength();
    }

    public static void link(ActorRef actor1, ActorRef actor2) {
        actorOf(actor1).link(actor2);
    }

    public static void unlink(ActorRef actor1, ActorRef actor2) {
        actorOf(actor1).unlink(actor2);
    }

    public static  ActorBuilder toActorBuilder(ActorRef actor) {
        actor = stripDelegates(actor);
        if (!(actor instanceof LocalActorRef))
            throw new IllegalArgumentException("ActorRef " + actor + " is not a local actor, and cannot be used as an ActorBuilder.");
        return (ActorBuilder) actor;
    }

    static void setMonitor(ActorRef actor, ActorMonitor mon) {
        actorOf(actor).setMonitor(mon);
    }

    static List getMailboxSnapshot(ActorRef actor) {
        return actorOf(actor).getMailboxSnapshot();
    }

    static StackTraceElement[] getStackTrace(ActorRef actor) {
        return actorOf(actor).getStackTrace();
    }

    private static Actor actorOf(ActorRef ar) {
        ar = stripDelegates(ar);
        if (!(ar instanceof LocalActorRef))
            throw new IllegalArgumentException("ActorRef " + ar + " is not a local actor.");
        return ((LocalActorRef) ar).getActor();
    }

    static  ActorRef stripDelegates(ActorRef ar) {
        while (ar instanceof ActorRefDelegate)
            ar = ((ActorRefDelegate) ar).ref;
        return ar;
    }

    private LocalActorUtil() {
    }
}
    

    

    

            

    

            



    
    






    
© 2015 - 2024 Weber Informatics LLC | Privacy Policy