Package org.nustaq.kontraktor.services

Class ServiceActor<T extends ServiceActor>

java.lang.Object

org.nustaq.kontraktor.Actors

org.nustaq.kontraktor.Actor<T>

org.nustaq.kontraktor.services.ServiceActor<T>

All Implemented Interfaces:

Serializable, Executor, org.nustaq.kontraktor.monitoring.Monitorable

Direct Known Subclasses:

DataShard, DynDataShard, PlainService, RLJsonServerService

public abstract class ServiceActor<T extends ServiceActor>
extends org.nustaq.kontraktor.Actor<T>

Created by ruedi on 12.08.2015.

See Also:

• Serialized Form

Nested Class Summary

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

org.nustaq.kontraktor.Actor.ActorReport

Field Summary

Fields

Modifier and Type	Field	Description
protected ServiceArgs	cmdline
protected ClusterCfg	config
protected org.nustaq.reallive.server.dynamic.DynClusterDistribution	currentDistribution
protected DataClient	dclient
static int	DEFAULT_START_TIMEOUT
static final String	REGISTRY_DISCONNECTED
static final String	REGISTRY_RECONNECTED
protected Map<String,Object>	requiredServices
protected org.nustaq.kontraktor.remoting.base.ServiceDescription	serviceDescription
protected org.nustaq.kontraktor.remoting.base.ReconnectableRemoteRef<ServiceRegistry>	serviceRegistry
static final String	UNCONNECTED

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	Description
ServiceActor()

Method Summary

Modifier and Type	Method	Description
void	addServiceEventListener(BiConsumer<String,Object> l)	runs on client side, receives forwarded service event received from service actor
protected org.nustaq.kontraktor.IPromise<Void>	awaitRequiredServices()
protected void	awaitRequiredServicesInternal(org.nustaq.kontraktor.IPromise<Void> p)
org.nustaq.kontraktor.IPromise	connectRequiredServices()	try to connect required (unconnected) services, in case of failur UNCONNECTED is put into service hashmap instead
protected org.nustaq.kontraktor.IPromise<org.nustaq.kontraktor.Actor>	connectService(org.nustaq.kontraktor.remoting.base.ServiceDescription serviceDescription)
protected org.nustaq.kontraktor.remoting.base.ConnectableActor	createDefaultConnectable()
protected abstract org.nustaq.kontraktor.remoting.base.ServiceDescription	createServiceDescription()
protected void	fireServiceEvent(String ev, Object arg)
protected String[]	getAllServiceNames()
protected ServiceArgs	getCmdline()
org.nustaq.kontraktor.IPromise<ClusterCfg>	getConfig()
org.nustaq.kontraktor.IPromise<DataClient>	getDataClient()
protected String	getHost()
protected int	getPort()
protected abstract String[]	getRequiredServiceNames()
protected <T extends org.nustaq.kontraktor.Actor> T	getService(String name)
protected org.nustaq.kontraktor.remoting.base.ServiceDescription	getServiceDescription()
ServiceRegistry	getServiceRegistry()
protected Serializable	getStatus()
protected void	gravityDisconnected()
void	heartBeat()
org.nustaq.kontraktor.IPromise<Void>	init(org.nustaq.kontraktor.remoting.base.ConnectableActor registryConnectable, ServiceArgs options, boolean autoRegister)
protected void	initRealLiveDynamic()
static DynDataClient	InitRealLiveDynamic(org.nustaq.reallive.server.dynamic.DynClusterDistribution currentDistribution, ServiceRegistry serviceRegistry, Function<String,DynDataShard> serviceMapper, ServiceActor hostingService, DataCfg schema)
protected void	initRealLiveFixed()
protected boolean	isDynamicDataCluster()
protected boolean	isFixedDataCluster()
protected void	notifyConfigChanged()	override, config contains updated ClusterCfg
protected void	old_initRealLiveDynamic()
protected void	onRegistryConnected(boolean autoRegister)
protected void	onRegistryDisconnected()
protected void	onServiceRegistryReconnected()
protected void	publishSelf()
protected void	registerSelf()	register at service registry
void	removeServiceEventListener(BiConsumer<String,Object> l)
protected void	requiredSerivceWentDown(org.nustaq.kontraktor.remoting.base.ServiceDescription cdr)
static ServiceActor	RunTCP(String[] args, Class<? extends ServiceActor> serviceClazz, Class<? extends ServiceArgs> argsClazz)
static ServiceActor	RunTCP(String[] args, Class<? extends ServiceActor> serviceClazz, Class<? extends ServiceArgs> argsClazz, long timeout)
static ServiceActor	RunTCP(String[] args, Class<? extends ServiceActor> serviceClazz, Class<? extends ServiceArgs> argsClazz, Class<? extends ServiceRegistry> serviceRegistryClass)
static ServiceActor	RunTCP(String[] args, Class<? extends ServiceActor> serviceClazz, Class<? extends ServiceArgs> argsClazz, Class<? extends ServiceRegistry> serviceRegistryClass, long timeout)	run & connect a service with given cmdline args and classes
static ServiceActor	RunTCP(ServiceArgs options, Class<? extends ServiceActor> serviceClazz, long timeout)
static ServiceActor	RunTCP(ServiceArgs options, Class<? extends ServiceActor> serviceClazz, Class<? extends ServiceRegistry> serviceRegistryClass, long timeout)
protected void	serviceDisconnected(org.nustaq.kontraktor.Actor act)
protected void	serviceEvent(String eventId, Object cdr, Object err)

Methods inherited from class org.nustaq.kontraktor.Actor

__addDeadLetter, __addRemoteConnection, __addStopHandler, __dispatchRemoteCall, __enqueueCall, __getCachedMethod, __removeRemoteConnection, __stop, __stopImpl, __submit, ask, askMsg, asyncstop, checkThread, close, closeCurrentClient, current, cyclic, debounce, 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, router$clientPing, 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, kYield, kYield, promise, race, race, reject, resolve, resolve, stream, SubmitDelayed, yieldCallbacks

Methods inherited from class java.lang.Object

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

Field Details

REGISTRY_DISCONNECTED

public static final String REGISTRY_DISCONNECTED

See Also:

• Constant Field Values

REGISTRY_RECONNECTED

public static final String REGISTRY_RECONNECTED

See Also:

• Constant Field Values

DEFAULT_START_TIMEOUT

public static int DEFAULT_START_TIMEOUT

UNCONNECTED

public static final String UNCONNECTED

See Also:

• Constant Field Values

serviceRegistry

protected org.nustaq.kontraktor.remoting.base.ReconnectableRemoteRef<ServiceRegistry> serviceRegistry

requiredServices

protected Map<String,Object> requiredServices

config

protected ClusterCfg config

serviceDescription

protected org.nustaq.kontraktor.remoting.base.ServiceDescription serviceDescription

cmdline

protected ServiceArgs cmdline

dclient

protected DataClient dclient

currentDistribution

protected org.nustaq.reallive.server.dynamic.DynClusterDistribution currentDistribution

Constructor Details

ServiceActor

public ServiceActor()

Method Details

RunTCP

public static ServiceActor RunTCP(String[] args,
 Class<? extends ServiceActor> serviceClazz,
 Class<? extends ServiceArgs> argsClazz)

RunTCP

public static ServiceActor RunTCP(String[] args,
 Class<? extends ServiceActor> serviceClazz,
 Class<? extends ServiceArgs> argsClazz,
 Class<? extends ServiceRegistry> serviceRegistryClass)

RunTCP

public static ServiceActor RunTCP(String[] args,
 Class<? extends ServiceActor> serviceClazz,
 Class<? extends ServiceArgs> argsClazz,
 long timeout)

RunTCP

public static ServiceActor RunTCP(String[] args,
 Class<? extends ServiceActor> serviceClazz,
 Class<? extends ServiceArgs> argsClazz,
 Class<? extends ServiceRegistry> serviceRegistryClass,
 long timeout)

run & connect a service with given cmdline args and classes

Parameters:

args -

serviceClazz -

argsClazz -

Returns:

Throws:

IllegalAccessException

InstantiationException

RunTCP

public static ServiceActor RunTCP(ServiceArgs options,
 Class<? extends ServiceActor> serviceClazz,
 long timeout)

RunTCP

public static ServiceActor RunTCP(ServiceArgs options,
 Class<? extends ServiceActor> serviceClazz,
 Class<? extends ServiceRegistry> serviceRegistryClass,
 long timeout)

init

public org.nustaq.kontraktor.IPromise<Void> init(org.nustaq.kontraktor.remoting.base.ConnectableActor registryConnectable,
 ServiceArgs options,
 boolean autoRegister)

addServiceEventListener

public void addServiceEventListener(BiConsumer<String,Object> l)

runs on client side, receives forwarded service event received from service actor

Parameters:

l -

removeServiceEventListener

public void removeServiceEventListener(BiConsumer<String,Object> l)

getServiceRegistry

public ServiceRegistry getServiceRegistry()

fireServiceEvent

protected void fireServiceEvent(String ev,
 Object arg)

onRegistryDisconnected

protected void onRegistryDisconnected()

onRegistryConnected

protected void onRegistryConnected(boolean autoRegister)

onServiceRegistryReconnected

protected void onServiceRegistryReconnected()

awaitRequiredServices

protected org.nustaq.kontraktor.IPromise<Void> awaitRequiredServices()

awaitRequiredServicesInternal

protected void awaitRequiredServicesInternal(org.nustaq.kontraktor.IPromise<Void> p)

initRealLiveDynamic

protected void initRealLiveDynamic()

old_initRealLiveDynamic

protected void old_initRealLiveDynamic()

InitRealLiveDynamic

public static DynDataClient InitRealLiveDynamic(org.nustaq.reallive.server.dynamic.DynClusterDistribution currentDistribution,
 ServiceRegistry serviceRegistry,
 Function<String,DynDataShard> serviceMapper,
 ServiceActor hostingService,
 DataCfg schema)

initRealLiveFixed

protected void initRealLiveFixed()

getConfig

public org.nustaq.kontraktor.IPromise<ClusterCfg> getConfig()

getDataClient

public org.nustaq.kontraktor.IPromise<DataClient> getDataClient()

registerSelf

protected void registerSelf()

register at service registry

publishSelf

protected void publishSelf()

getPort

protected int getPort()

Returns:

port this service wants to expose (with default tcp exposure)

getHost

protected String getHost()

Returns:

host this service wants to expose on (with default tcp exposure)

getCmdline

protected ServiceArgs getCmdline()

getAllServiceNames

protected String[] getAllServiceNames()

isFixedDataCluster

protected boolean isFixedDataCluster()

isDynamicDataCluster

protected boolean isDynamicDataCluster()

getRequiredServiceNames

protected abstract String[] getRequiredServiceNames()

serviceEvent

protected void serviceEvent(String eventId,
 Object cdr,
 Object err)

notifyConfigChanged

protected void notifyConfigChanged()

override, config contains updated ClusterCfg

requiredSerivceWentDown

protected void requiredSerivceWentDown(org.nustaq.kontraktor.remoting.base.ServiceDescription cdr)

getService

protected <T extends org.nustaq.kontraktor.Actor> T getService(String name)

connectRequiredServices

public org.nustaq.kontraktor.IPromise connectRequiredServices()

try to connect required (unconnected) services, in case of failur UNCONNECTED is put into service hashmap instead

Returns:

connectService

protected org.nustaq.kontraktor.IPromise<org.nustaq.kontraktor.Actor> connectService(org.nustaq.kontraktor.remoting.base.ServiceDescription serviceDescription)

serviceDisconnected

protected void serviceDisconnected(org.nustaq.kontraktor.Actor act)

heartBeat

public void heartBeat()

getStatus

protected Serializable getStatus()

gravityDisconnected

protected void gravityDisconnected()

createServiceDescription

protected abstract org.nustaq.kontraktor.remoting.base.ServiceDescription createServiceDescription()

getServiceDescription

protected org.nustaq.kontraktor.remoting.base.ServiceDescription getServiceDescription()

createDefaultConnectable

protected org.nustaq.kontraktor.remoting.base.ConnectableActor createDefaultConnectable()