Services on sillysky.net

CServiceRegistry / IServiceRegistry

Tue, 14 Oct 2025 00:00:00 +0000

The service registry manages 3 different object types:

Service starter
Services
Service listeners

The Service Starters

Service starters implement the IServiceStarter interface. They provide a list of dependencies for a service or the classes of a Java package. When the dependencies are fulfilled and all required interfaces have been registered in the service registry, the starter is started. On the other hand, when a dependency is dropped from the service registry, the starter is stopped.

IService

Tue, 14 Oct 2025 00:00:00 +0000

The IService helper interface is not mandatory for defining services. It only simplifies the initialization and removal of services.

Services activation

In this method the service can be initialized and registered to the service registry. Possible exceptions are caught and logged by the system.

void activate(@NotNull IServiceRegistry aServiceRegistry) throws Exception;

Deactivating the service

In this method the service can be de-initialized and deregistered from the service registry.

void deactivate(@NotNull IServiceRegistry aServiceRegistry) throws Exception;

IServiceDependencyList

Tue, 14 Oct 2025 00:00:00 +0000

This is a helper class used by the service registry to collect dependencies from service starters.

Add a dependency

To add a dependency on a singleton object, use the corresponding class.

void add(@NotNull Class aService);

For dependencies that are not a singleton, you must include a filter to distinguish the individual instances of the class. Filters are a list of properties separated by commas, such as "key1=val1,key2=val2".

void add(@NotNull Class aService,
         @NotNull String aProperties);

An example is the specification of a namespace. Namespaces are not singletons. They can be distinguished by namespace ID:

IServiceListener

Tue, 14 Oct 2025 00:00:00 +0000

A service listener is registered at the service registry to receive service registration and de-registration information.

A service listener implements two methods. This method is called when a service is registered with the service registry.

void notifyServiceStarted(@NotNull IServiceRegistry aServiceRegistry,
                          @NotNull Class aClass,
                          @NotNull Object aInstance,
                          @Nullable CStringProperties aProperties) throws Exception;

The other method is called when a service is deregistered.

void notifyServiceStopped(@NotNull IServiceRegistry aServiceRegistry,
                          @NotNull Class aClass,
                          @NotNull Object aInstance,
                          @Nullable CStringProperties aProperties) throws Exception;

IServiceStarter

Tue, 14 Oct 2025 00:00:00 +0000

The IServiceStarter interface is used to define a starting point for the classes in a Java package. In addition, the class that implements this interface is usually the only class in a package that is not package private. This means that all other classes are hidden in the package.

The interface is registered to the service registry as a starter. It defines a list of dependencies that the classes in the package have. If the dependencies are fulfilled, that means if all required interfaces have been started in the service registry, then this package will also be started. Conversely, the package will be stopped should a required service be stopped in the registry.

List of wellknown services

Tue, 14 Oct 2025 00:00:00 +0000

This list briefly describes various services that are registered at the service registry.

Class	Module/Plugin	Properties	Description
IHelperForLocalMicroServices	NY_MicroServicePlugIn		The service simplifies the registration and de-registration of microservices.
IKernelConfiguration	Kernel		A service to access the configuration.
IMessageLoggerFactory	Kernel		A factory for creating message loggers.
IMessageSender	Kernel		The service that sends messages.
IMicroServiceRegistryCollector	NY_MicroServicePlugIn		This service collects broadcasts from microservice registries and facilitates sending messages to microservices.
INameDb	Kernel		A database where names for record IDs, targets, etc. can be stored. These names are then output in addition to the abstract IDs in the LOG, which makes the LOG much more readable.
INamespace	Kernel	nid=NamespaceID	Namespaces are very important parts of the architecture of a nyssr.net node. They host the threads and targets and a nano service registry.
INamespaceFactory	Kernel		A factory for creating namespaces.
INamespaceRegistry	Kernel		A registry where all namespaces are registered.
INanoServiceRegistry	Kernel	nid=NamespaceID	Nano service registries always belong to a namespace. This is where nano services are registered.
IRecordHelper	Kernel		A service to register nano services and observers.
IRecordRegistryHelper	Kernel		A service to register records and nano services.
IShutDown	Kernel		A service to shut down the node.
ISlotFactory	Kernel		A factory for creating record slots.
ITargetRegistry	Kernel	nid=NamespaceID	Target registries always belong to a namespace. This is where targets are registered.
ITimerManager	Kernel		A service for the creation of timers.