More interfaces and classes on sillysky.net

IRecordRegistryHelper

Tue, 09 Dec 2025 00:00:00 +0000

The Record Registry Helper is a service for registering nano services and record names.

In the record definition it is possible to specify whether the record belongs to a nano service (of the same name). It is also possible to specify in which namespaces the nano service should be registered. The record registry helper uses this information to register records as nano services.

{
  "id": "f2be95a8-50a5-4a42-a1f3-53eb3a02145d",
  "name": "NOTIFY_APP_INSTANCE_STARTED",
  "isNanoService": "true",
  "namespaces": "SYSTEM",
  "description": "Whenever an application instance has been started,\nthis notification service will be triggered.\nDirection: App Instance Registry --> Public.",
  "slots": [
    {
      "key": "1",
      "name": "INSTANCE",
      "direction": "REQUEST",
      "presenceConstraint": "MANDATORY",
      "type": "RECORD",
      "description": "The application instance record (see APP_INSTANCE)."
    }
  ]
}

Additionally, record names are registered in the name database to find readable names in the LOG instead of unreadable IDs (which are mostly UUIDs).

CException

Wed, 15 Oct 2025 00:00:00 +0000

Instead of using Java-like many exception types, we decided to take a different approach. We use a class CException, which is based on the class java.lang.Exception. To differ between different exception types we use a code and an optional text.

Constructors

The most used constructor is the one with an integer code:

public CException(final int aCode);

Another constructor takes over an existing exception:

public CException(final Throwable aException);

The transfer of a message result is done like this:

CResultCode

Wed, 15 Oct 2025 00:00:00 +0000

This class contains only result codes.

CUtilPassword

Wed, 15 Oct 2025 00:00:00 +0000

This class is used to support password hashing.

This method creates a SHA384 hash of the passed password. Then the hash is encoded into a base64 string. A passing null value generates a return value of null as well.

@Nullable
public static String hashPassword(final char[] aPassword);

IRecordHelper

Wed, 15 Oct 2025 00:00:00 +0000

Record Helper is a service for easier handling of records and nano services. It provides methods for registering nano services and observers, removing observers, and returns the namespace ID to which a nano service belongs.

Getting the service

The service is available through the local service registry.

final IRecordHelper helper = CServiceRegistry.getInstance()
                                             .getService(IRecordHelper.class);

As always, make sure that the service starter of your package has a dependency on the helper service to ensure that the service already exists.