pekko/akka-actors/src/main/scala/dispatch/Reactor.scala

/**
 * Copyright (C) 2009 Scalable Solutions.
 */

package se.scalablesolutions.akka.dispatch

import java.util.List

import se.scalablesolutions.akka.util.HashCode
import se.scalablesolutions.akka.stm.Transaction
import se.scalablesolutions.akka.actor.Actor

import java.util.concurrent.ConcurrentHashMap

final class MessageInvocation(val receiver: Actor,
                              val message: Any,
                              val future: Option[CompletableFutureResult],
                              val sender: Option[Actor],
                              val tx: Option[Transaction]) {
  if (receiver == null) throw new IllegalArgumentException("receiver is null")
  if (message == null) throw new IllegalArgumentException("message is null")

  def invoke = receiver.invoke(this)

  def send = receiver.dispatcher.dispatch(this)

  override def hashCode(): Int = synchronized {
    var result = HashCode.SEED
    result = HashCode.hash(result, receiver)
    result = HashCode.hash(result, message)
    result
  }

  override def equals(that: Any): Boolean = synchronized {
    that != null &&
    that.isInstanceOf[MessageInvocation] &&
    that.asInstanceOf[MessageInvocation].receiver == receiver &&
    that.asInstanceOf[MessageInvocation].message == message
  }

  override def toString(): String = synchronized {
    "MessageInvocation[" +
     "\n\tmessage = " + message +
     "\n\treceiver = " + receiver +
     "\n\tsender = " + sender +
     "\n\tfuture = " + future +
     "\n\ttx = " + tx +
     "\n]"
  }
}

trait MessageQueue {
  def append(handle: MessageInvocation)
  def prepend(handle: MessageInvocation)
}

trait MessageInvoker {
  def invoke(message: MessageInvocation)
}

trait MessageDispatcher {
  protected val references = new ConcurrentHashMap[String, Actor]  
  def dispatch(invocation: MessageInvocation)
  def start
  def shutdown
  def register(actor: Actor) = references.put(actor.uuid, actor)
  def unregister(actor: Actor) = references.remove(actor.uuid)
  def canBeShutDown: Boolean = references.isEmpty
}

trait MessageDemultiplexer {
  def select
  def wakeUp
  def acquireSelectedInvocations: List[MessageInvocation]
  def releaseSelectedInvocations
}