Package org.nanonative.nano.core

Class Nano

java.lang.Object
org.nanonative.nano.core.NanoBase<Nano>
org.nanonative.nano.core.NanoThreads<Nano>
org.nanonative.nano.core.NanoServices<Nano>
org.nanonative.nano.core.Nano
public class Nano extends NanoServices<Nano>

  • Constructor Details

    • Nano

      public Nano(Service... startupServices)
      Initializes Nano with a set of startup Service.
      Parameters:
      startupServices - Varargs parameter of startup Service to be initiated during the Nano creation.

    • Nano

      public Nano(String[] args, Service... startupServices)
      Initializes Nano with a function to provide startup Service based on the context.
      Parameters:
      args - Command-line arguments passed during the application start.
      startupServices - Varargs parameter of startup Service to be initiated.

    • Nano

      public Nano(Map<Object,Object> config, Service... startupServices)
      Initializes Nano with configurations and startup Service.
      Parameters:
      config - Map of configuration parameters.
      startupServices - Varargs parameter of startup Service to be initiated.

    • Nano

      public Nano(Map<Object,Object> config, berlin.yuna.typemap.model.FunctionOrNull<Context,List<Service>> startupServices)
      Initializes Nano with configurations and startup Service.
      Parameters:
      config - Map of configuration parameters.
      startupServices - Function to provide startup Service based on the given context.

    • Nano

      public Nano(String[] args, berlin.yuna.typemap.model.FunctionOrNull<Context,List<Service>> startupServices)
      Initializes Nano with a function to provide startup Service based on the context.
      Parameters:
      args - Command-line arguments passed during the application start.
      startupServices - Function to provide startup Service based on the given context.

    • Nano

      public Nano(berlin.yuna.typemap.model.FunctionOrNull<Context,List<Service>> startupServices, Map<Object,Object> config, String... args)
      Initializes Nano with a function to provide startup Service, configurations, and command-line arguments.
      Parameters:
      startupServices - Function to provide startup Service based on the given context.
      config - Map of configuration parameters.
      args - Command-line arguments passed during the application start.

  • Method Details

    • context

      public Context context()
      Returns the root Context. This context should be only used to manipulate values. context() should be used for running Lambdas, Services, Schedulers or send Events
      Returns:
      the root Context associated.

    • context

      public Context context(Class<?> clazz)
      Creates a Context specified class.
      Parameters:
      clazz - The class for which the Context is to be created.
      Returns:
      A new Context instance associated with the given class.

    • contextEmpty

      public Context contextEmpty(Class<?> clazz)
      Creates an empty Context for the specified class.
      Parameters:
      clazz - The class for which the Context is to be created.
      Returns:
      A new Context instance associated with the given class.

    • stop

      public Nano stop(Class<?> clazz)
      Initiates the shutdown process for the Nano instance.
      Specified by:
      stop in class NanoBase<Nano>
      Parameters:
      clazz - class for which the Context is to be created.
      Returns:
      The current instance of Nano for method chaining.

    • stop

      public Nano stop(Context context)
      Initiates the shutdown process for the Nano instance.
      Specified by:
      stop in class NanoBase<Nano>
      Parameters:
      context - The Context in which Nano instance shuts down.
      Returns:
      The current instance of Nano for method chaining.

    • waitForStop

      public Nano waitForStop()
      This method blocks the current thread for max 10 seconds until the Nano instance is no longer ready. This is useful in tests for ensuring that the application has fully stopped before proceeding with further operations.
      Returns:
      The current instance of Nano for method chaining.

    • printParameters

      public void printParameters()
      Prints the configurations that have been loaded into the Nano instance.

    • sendEvent

      public Nano sendEvent(Event event)
      Sends an event with the specified parameters, either broadcasting it to all listeners or sending it to a targeted listener asynchronously if a response listener is provided.
      Parameters:
      event - The Event object that encapsulates the event's context, type, and payload. use Event.eventOf(Context, int) to create an instance.
      Returns:
      The Nano instance, allowing for method chaining.

    • sendEventR

      public Event sendEventR(Event event)
      Processes an event with the given parameters and decides on the execution path based on the presence of a response listener and the broadcast flag. If a response listener is provided, the event is processed asynchronously; otherwise, it is processed in the current thread. This method creates an Event instance and triggers the appropriate event handling logic.
      Parameters:
      event - The Event object that encapsulates the event's context, type, and payload. use Event.eventOf(Context, int) to create an instance.
      Returns:
      An instance of Event that represents the event being processed. This object can be used for further operations or tracking.

    • sendEventSameThread

      public Nano sendEventSameThread(Event event)
      Sends an event on the same thread and determines whether to process it to the first listener. Used Context.sendEvent(int, Supplier) from context(Class) instead of the core method.
      Parameters:
      event - The event to be processed.
      Returns:
      self for chaining

    • shutdown

      protected Nano shutdown(Class<?> clazz)
      Shuts down the Nano instance, ensuring all services and threads are gracefully terminated.
      Parameters:
      clazz - class for which the Context is to be created.
      Returns:
      Self for chaining

    • cleanUps

      protected void cleanUps(Event event)

    • printActiveProfiles

      protected void printActiveProfiles()

    • startServicesAndLogger

      protected void startServicesAndLogger(berlin.yuna.typemap.model.FunctionOrNull<Context,List<Service>> startupServices)

    • shutdown

      protected Nano shutdown(Context context)
      Shuts down the Nano instance, ensuring all services and threads are gracefully terminated.
      Parameters:
      context - The Context in which Nano instance shuts down.
      Returns:
      Self for chaining

    • hostname

      public String hostname()

    • printSystemInfo

      public Nano printSystemInfo()
      Prints system information for diagnostic purposes. Similar to toString()
      Returns:
      Self for chaining

    • gracefulShutdown

      protected void gracefulShutdown(Context context)

    • exit

      protected void exit(Context context, int exitCode)

    • toString

      public String toString()
      Overrides:
      toString in class Object