runtime/io.matthewnelson.kmp.tor.runtime/TorRuntime/ServiceFactory/Binder/onBind

onBind

abstract fun onBind(serviceEvents: Set<TorEvent>, serviceObserverNetwork: NetworkObserver?, serviceObserversTorEvent: Set<TorEvent.Observer>, serviceObserversRuntimeEvent: Set<RuntimeEvent.Observer<*>>): Lifecycle.DestroyableTorRuntime(source)

Meant to be called within the service object instance after startService has successfully executed, and ServiceFactory.binder has been injected into it.

The returned instance of Lifecycle.DestroyableTorRuntime will invoke any Lifecycle.DestroyableTorRuntime.invokeOnDestroy handles upon processing of Action.StopDaemon such that the service object can attach one and know when to shut itself down.

If an instance of Lifecycle.DestroyableTorRuntime already exists for the calling ServiceFactory, that instance will be destroyed before a new instance of Lifecycle.DestroyableTorRuntime is returned.

WARNING: This should not be called without first enqueueing Action.StartDaemon or Action.RestartDaemon. If no action job is present when onBind is called from ServiceFactory.binder, then Action.StartDaemon will be enqueued for you. If the execution of that job results in failure an UncaughtException may occur.