Interface LogProviderService

All Known Implementing Classes:
MultiplexingClientService

public interface LogProviderService
A LogProviderService provides the loggers for objects that an injection driver completes. An object arriving by deserialisation has lost every reference to its environment, so the driver obtains its logger here instead of leaving the object to help itself with a context-free one.

The loggers of the platform are rooted in a service instance rather than in the name hierarchy of java.util.logging, so two instances of the same service type keep distinguishable logs. The logger handed out here follows that model: it belongs to this instance and merely carries the designated name as a tag.

This contract deliberately does not extend LogService: every ADEPT2Service implements that one, so testing a service against it would hold for every service and the designation of a provider would be meaningless. Implementing this interface is therefore the opt-in, and it is declared by implementation classes only, never by a service interface – the proxy layer walks the ancestry of an interface, so a remotable interface extending this one would carry the method into its stubs, where a Logger can neither be serialised nor proxied.

  • Method Summary

    Modifier and Type
    Method
    Description
    getJulLogger(String loggerName)
    Gets a logger rooted in this service instance and tagged with the designated name, which is usually the name of the class the logger is for.
  • Method Details

    • getJulLogger

      Logger getJulLogger(String loggerName)
      Gets a logger rooted in this service instance and tagged with the designated name, which is usually the name of the class the logger is for. Handlers, levels and output belong to this provider.
      Parameters:
      loggerName - The name to tag the logger with, usually the name of a class.
      Returns:
      A logger of this service instance tagged with the designated name. This will never be null.