/*
* 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.common.monitoring.FlightRecorder;
import co.paralleluniverse.common.monitoring.FlightRecorderMessage;
import co.paralleluniverse.common.util.Debug;
import co.paralleluniverse.fibers.SuspendExecution;
import co.paralleluniverse.strands.channels.SendPort;
import co.paralleluniverse.strands.queues.QueueCapacityExceededException;
import java.util.Objects;
import java.util.concurrent.TimeUnit;
/**
*
* @author pron
*/
abstract class ActorRefImpl<Message> extends ActorRef<Message> implements SendPort<Message>, java.io.Serializable {
static final long serialVersionUID = 894359345L;
//
private static final int MAX_SEND_RETRIES = 10;
//
private volatile String name;
private final SendPort<Object> mailbox;
private final LifecycleListener lifecycleListener = new ActorLifecycleListener(this, null);
protected transient final FlightRecorder flightRecorder;
@Override
public String toString() {
return "Actor@" + (name != null ? name : Integer.toHexString(System.identityHashCode(this)));
}
protected ActorRefImpl(String name, SendPort<Object> mailbox) {
this.name = name;
this.mailbox = mailbox;
this.flightRecorder = Debug.isDebug() ? Debug.getGlobalFlightRecorder() : null;
}
@Override
public String getName() {
return name;
}
public final void setName(String name) {
if (this.name != null)
throw new IllegalStateException("Actor " + this + " already has a name: " + this.name);
this.name = name;
}
//<editor-fold desc="Mailbox methods">
/////////// Mailbox methods ///////////////////////////////////
protected SendPort<Object> mailbox() {
return mailbox;
}
public SendPort<Object> getMailbox() {
return mailbox;
}
@Override
public final void send(Message message) throws SuspendExecution {
try {
internalSend(message);
} catch (QueueCapacityExceededException e) {
throwIn(e);
}
}
@Override
public boolean send(Message message, long timeout, TimeUnit unit) throws SuspendExecution, InterruptedException {
send(message);
return true;
}
public void sendOrInterrupt(Object message) {
try {
internalSendNonSuspendable(message);
} catch (QueueCapacityExceededException e) {
interrupt();
}
}
@Override
public void sendSync(Message message) throws SuspendExecution {
send(message);
}
@Override
public void close() {
throw new UnsupportedOperationException();
}
/**
* For internal use
*
* @param message
*/
protected abstract void internalSend(Object message) throws SuspendExecution;
protected abstract void internalSendNonSuspendable(Object message);
//</editor-fold>
//<editor-fold desc="Lifecycle">
/////////// Lifecycle ///////////////////////////////////
protected abstract void throwIn(RuntimeException e);
protected abstract void addLifecycleListener(LifecycleListener listener);
protected abstract void removeLifecycleListener(LifecycleListener listener);
protected abstract void removeObserverListeners(ActorRef actor);
protected LifecycleListener getLifecycleListener() {
return lifecycleListener;
}
protected static class ActorLifecycleListener implements LifecycleListener, java.io.Serializable {
private final ActorRefImpl observer;
private final Object id;
public ActorLifecycleListener(ActorRef observer, Object id) {
this.observer = (ActorRefImpl) observer;
this.id = id;
}
@Override
public void dead(ActorRef actor, Throwable cause) {
observer.internalSendNonSuspendable(new ExitMessage(actor, cause, id));
}
@Override
public int hashCode() {
return Objects.hashCode(this.id);
}
@Override
public boolean equals(Object obj) {
if (!(obj instanceof ActorLifecycleListener))
return false;
return Objects.equals(observer, ((ActorLifecycleListener) obj).observer) && Objects.equals(id, ((ActorLifecycleListener) obj).id);
}
@Override
public String toString() {
return "ActorLifecycleListener{" + "observer: " + observer + ", id: " + id + '}';
}
@Override
public Object getId() {
return id;
}
public ActorRefImpl getObserver() {
return observer;
}
}
//</editor-fold>
@Override
public boolean equals(Object obj) {
if (obj == null)
return false;
if(obj == this)
return true;
if (!(obj instanceof ActorRef))
return false;
ActorRef other = (ActorRef) obj;
while(other instanceof ActorRefDelegate)
other = ((ActorRefDelegate) other).ref;
return other == this;
}
//<editor-fold defaultstate="collapsed" desc="Recording">
/////////// Recording ///////////////////////////////////
protected final void record(int level, String clazz, String method, String format) {
if (flightRecorder != null)
record(flightRecorder.get(), level, clazz, method, format);
}
protected final void record(int level, String clazz, String method, String format, Object arg1) {
if (flightRecorder != null)
record(flightRecorder.get(), level, clazz, method, format, arg1);
}
protected final void record(int level, String clazz, String method, String format, Object arg1, Object arg2) {
if (flightRecorder != null)
record(flightRecorder.get(), level, clazz, method, format, arg1, arg2);
}
protected final void record(int level, String clazz, String method, String format, Object arg1, Object arg2, Object arg3) {
if (flightRecorder != null)
record(flightRecorder.get(), level, clazz, method, format, arg1, arg2, arg3);
}
protected final void record(int level, String clazz, String method, String format, Object arg1, Object arg2, Object arg3, Object arg4) {
if (flightRecorder != null)
record(flightRecorder.get(), level, clazz, method, format, arg1, arg2, arg3, arg4);
}
protected final void record(int level, String clazz, String method, String format, Object arg1, Object arg2, Object arg3, Object arg4, Object arg5) {
if (flightRecorder != null)
record(flightRecorder.get(), level, clazz, method, format, arg1, arg2, arg3, arg4, arg5);
}
protected final void record(int level, String clazz, String method, String format, Object... args) {
if (flightRecorder != null)
record(flightRecorder.get(), level, clazz, method, format, args);
}
private static void record(FlightRecorder.ThreadRecorder recorder, int level, String clazz, String method, String format) {
if (recorder != null)
recorder.record(level, makeFlightRecorderMessage(recorder, clazz, method, format, null));
}
private static void record(FlightRecorder.ThreadRecorder recorder, int level, String clazz, String method, String format, Object arg1) {
if (recorder != null)
recorder.record(level, makeFlightRecorderMessage(recorder, clazz, method, format, new Object[]{arg1}));
}
private static void record(FlightRecorder.ThreadRecorder recorder, int level, String clazz, String method, String format, Object arg1, Object arg2) {
if (recorder != null)
recorder.record(level, makeFlightRecorderMessage(recorder, clazz, method, format, new Object[]{arg1, arg2}));
}
private static void record(FlightRecorder.ThreadRecorder recorder, int level, String clazz, String method, String format, Object arg1, Object arg2, Object arg3) {
if (recorder != null)
recorder.record(level, makeFlightRecorderMessage(recorder, clazz, method, format, new Object[]{arg1, arg2, arg3}));
}
private static void record(FlightRecorder.ThreadRecorder recorder, int level, String clazz, String method, String format, Object arg1, Object arg2, Object arg3, Object arg4) {
if (recorder != null)
recorder.record(level, makeFlightRecorderMessage(recorder, clazz, method, format, new Object[]{arg1, arg2, arg3, arg4}));
}
private static void record(FlightRecorder.ThreadRecorder recorder, int level, String clazz, String method, String format, Object arg1, Object arg2, Object arg3, Object arg4, Object arg5) {
if (recorder != null)
recorder.record(level, makeFlightRecorderMessage(recorder, clazz, method, format, new Object[]{arg1, arg2, arg3, arg4, arg5}));
}
private static void record(FlightRecorder.ThreadRecorder recorder, int level, String clazz, String method, String format, Object... args) {
if (recorder != null)
recorder.record(level, makeFlightRecorderMessage(recorder, clazz, method, format, args));
}
private static FlightRecorderMessage makeFlightRecorderMessage(FlightRecorder.ThreadRecorder recorder, String clazz, String method, String format, Object[] args) {
return new FlightRecorderMessage(clazz, method, format, args);
//return ((FlightRecorderMessageFactory) recorder.getAux()).makeFlightRecorderMessage(clazz, method, format, args);
}
//</editor-fold>
}