org.nustaq.kontraktor.routers

Class SimpleKrouter

java.lang.Object

org.nustaq.kontraktor.Actors

org.nustaq.kontraktor.Actor<T>

org.nustaq.kontraktor.routers.AbstractKrouter<T>

org.nustaq.kontraktor.routers.SingleActiveServiceKrouter<SimpleKrouter>

org.nustaq.kontraktor.routers.SimpleKrouter

All Implemented Interfaces:

Serializable, Executor, Monitorable, RemotedActor, ServingActor

public class SimpleKrouter
extends SingleActiveServiceKrouter<SimpleKrouter>

a Krouter supporting dynamic replacement of a single service. For stateful service's, clients keep connected to the service instance they originally connected. Once this old service terminates they failover to the "current" service instance. THIS IS NOT A FAILOVER: if the primary (least recently connected) service goes down, no new service can connect ('service unavailable), however clients connected to a previous service instance will continue working. Use HotColdFailover for dynamic failover + dynamic replacement use cases. Use case: Replacement / Zero Downtime software update. In general its favourable to always use HotColdFailover instead of SimpleKrouter, as this also covers dynamic replacement. (SimpleKrouter's orinigal role was having a simple case for testing debugging).

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.nustaq.kontraktor.Actor

Actor.ActorReport

Field Summary

Fields inherited from class org.nustaq.kontraktor.routers.AbstractKrouter

CLIENT_PING_INTERVAL_MS, clients, lastSwitch, nextAliveRemoteActors, SERVICE_UNAVAILABLE, timeoutMap

Fields inherited from class org.nustaq.kontraktor.Actor

__cbQueue, __clientConnection, __connections, __currentDispatcher, __mailbox, __mailboxCapacity, __mbCapacity, __publishTarget, __remoteId, __scheduler, __self, __stopped, __ticketMachine, connection, sender, userData, zzRoutingGCEnabled, zzServerMsgCallback

Fields inherited from class org.nustaq.kontraktor.Actors

CONT, DEFAULT_TIMOUT, defaultScheduler, delayedCalls, exec, instance, MAX_EXTERNAL_THREADS_POOL_SIZE, version

Constructor Summary

Constructors

Constructor and Description
SimpleKrouter()

Method Summary

Modifier and Type	Method and Description
protected Actor	getRemoteRef()
void	router$handleServiceDisconnect(Actor x)
protected void	setRemoteRef(Actor remoteRef)

Methods inherited from class org.nustaq.kontraktor.routers.SingleActiveServiceKrouter

dispatchRemoteCall, getServices, init, main, router$RegisterService, willDispatch

Methods inherited from class org.nustaq.kontraktor.routers.AbstractKrouter

__dispatchRemoteCall, checkPingOnClients, clientConnected, clientDisconnected, createErrorPromiseResponse, forwardCall, forwardCallInternal, forwardMultiCall, forwardMultiCallInternal, getClientPingTimeout, getServicePingTimeout, handleServiceDiscon, hasBeenUnpublished, isStateful, pingServices, router$clientPing, sendFailoverNotification, sendFailoverNotificationInternal

Methods inherited from class org.nustaq.kontraktor.Actor

__addDeadLetter, __addRemoteConnection, __addStopHandler, __enqueueCall, __getCachedMethod, __removeRemoteConnection, __stop, __stopImpl, __submit, ask, askMsg, asyncstop, checkThread, close, closeCurrentClient, current, cyclic, delayed, execInThreadPool, execute, getActor, getActorRef, getCallbackSize, getConnections, getCurrentDispatcher, getFactory, getMailboxSize, getQSizes, getReport, getScheduler, getSubMonitorables, getUntypedRef, hasStopped, inside, inThread, isCallbackQPressured, isEmpty, isMailboxPressured, isProxy, isPublished, isRemote, isStopped, ping, self, serialOn, setServerMsgCallback, stop, stopSafeClose, tell, tellMsg, unpublish, zzkrouterLostClient, zzRoutingRefGC

Methods inherited from class org.nustaq.kontraktor.Actors

AddDeadLetter, all, all, all, allMapped, AsActor, AsActor, AsActor, AsActor, AsUntypedActor, awaitAll, awaitAll, awaitAll, awaitAll, complete, complete, DeadLetters, flow, InThread, isComplete, isCont, isError, isErrorOrComplete, isResult, isTimeout, promise, race, race, reject, resolve, resolve, stream, SubmitDelayed, yield, yield, yieldCallbacks

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.nustaq.kontraktor.remoting.base.RemotedActor

hasBeenPublished

Constructor Detail

SimpleKrouter

public SimpleKrouter()

Method Detail

getRemoteRef

protected Actor getRemoteRef()

Specified by:

getRemoteRef in class SingleActiveServiceKrouter<SimpleKrouter>

setRemoteRef

protected void setRemoteRef(Actor remoteRef)

Specified by:

setRemoteRef in class SingleActiveServiceKrouter<SimpleKrouter>

router$handleServiceDisconnect

public void router$handleServiceDisconnect(Actor x)

Specified by:

router$handleServiceDisconnect in class SingleActiveServiceKrouter<SimpleKrouter>