org.eclipse.equinox.log.ExtendedLogReaderService Maven / Gradle / Ivy
Show all versions of aspectjtools Show documentation
/*******************************************************************************
* Copyright (c) 2006, 2011 IBM Corporation and others
*
* This program and the accompanying materials are made
* available under the terms of the Eclipse Public License 2.0 which
* accompanies this distribution, and is available at
* https://www.eclipse.org/legal/epl-2.0/
*
* SPDX-License-Identifier: EPL-2.0
******************************************************************************/
package org.eclipse.equinox.log;
import org.osgi.service.log.*;
/**
* Extends the OSGi Log Service's LogReaderService to allow better control of log listeners.
* @ThreadSafe
* @see LogListener
* @since 3.7
*/
public interface ExtendedLogReaderService extends LogReaderService {
/**
* Subscribes to LogEntry
objects.
*
*
* This method registers a LogListener
object with the Log Reader
* Service with a LogFilter
to allow pre-filtering of interesting log entries.
* The LogListener.logged(LogEntry)
method will be
* called for each LogEntry
object placed into the log that matches the filter.
*
* @param listener A LogListener
object to register; the
* LogListener
object is used to receive LogEntry
* objects.
* @param filter A LogFilter
object to register; the
* LogFilter
object is used to filter LogEntry
* objects before sending them to the associated LogListener
.
* @see LogListener
* @see LogFilter
* @see LogEntry
* @see LogReaderService#addLogListener(LogListener)
*/
public void addLogListener(LogListener listener, LogFilter filter);
}