Ice.LoggerPlugin Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ice-compat Show documentation

Ice is a comprehensive RPC framework that helps you build distributed applications with minimal effort using familiar object-oriented idioms

There is a newer version: 3.7.10

Show newest version

//
// Copyright (c) ZeroC, Inc. All rights reserved.
//

package Ice;

/**
 * Class to support custom loggers. Applications using a custom logger
 * instantiate a LoggerPlugin with a custom logger and
 * return the instance from their {@link PluginFactory} implementation.
 *
 * @see PluginFactory
 * @see Plugin
 **/
public class LoggerPlugin implements Ice.Plugin
{
    /**
     * Installs a custom logger for a communicator.
     *
     * @param communicator The communicator using the custom logger.
     * @param logger The custom logger for the communicator.
     **/
    public
    LoggerPlugin(Communicator communicator, Logger logger)
    {
        if(communicator == null)
        {
            PluginInitializationException ex = new PluginInitializationException();
            ex.reason = "Communicator cannot be null";
            throw ex;
        }

        if(logger == null)
        {
            PluginInitializationException ex = new PluginInitializationException();
            ex.reason = "Logger cannot be null";
            throw ex;
        }

        IceInternal.Instance instance = IceInternal.Util.getInstance(communicator);
        instance.setLogger(logger);
    }

    /**
     * Called by the Ice run time during communicator initialization. The derived class
     * can override this method to perform any initialization that might be required
     * by a custom logger.
     **/
    @Override
    public void
    initialize()
    {
    }

    /**
     * Called by the Ice run time when the communicator is destroyed. The derived class
     * can override this method to perform any finalization that might be required
     * by a custom logger.
     **/
    @Override
    public void
    destroy()
    {
    }
}