org.apache.felix.framework.util

Class ListenerInfo

java.lang.Object

org.apache.felix.framework.util.ListenerInfo

All Implemented Interfaces:

ListenerHook.ListenerInfo

public class ListenerInfo
extends java.lang.Object
implements ListenerHook.ListenerInfo

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.Object	m_acc
private Bundle	m_bundle
private BundleContext	m_context
private Filter	m_filter
private java.util.EventListener	m_listener
private java.lang.Class	m_listenerClass
private boolean	m_removed

Constructor Summary

Constructors

Constructor and Description
ListenerInfo(Bundle bundle, BundleContext context, java.lang.Class listenerClass, java.util.EventListener listener, Filter filter, java.lang.Object acc, boolean removed)
ListenerInfo(ListenerInfo info, boolean removed)

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj) Compares this ListenerInfo to another ListenerInfo.
Bundle	getBundle()
BundleContext	getBundleContext() Return the context of the bundle which added the listener.
java.lang.String	getFilter() Return the filter string with which the listener was added.
java.util.EventListener	getListener()
java.lang.Class	getListenerClass()
Filter	getParsedFilter()
java.lang.Object	getSecurityContext()
int	hashCode() Returns the hash code for this ListenerInfo.
boolean	isRemoved() Return the state of the listener for this addition and removal life cycle.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

m_bundle

private final Bundle m_bundle

m_context

private final BundleContext m_context

m_listenerClass

private final java.lang.Class m_listenerClass

m_listener

private final java.util.EventListener m_listener

m_filter

private final Filter m_filter

m_acc

private final java.lang.Object m_acc

m_removed

private final boolean m_removed

Constructor Detail

ListenerInfo

public ListenerInfo(Bundle bundle,
                    BundleContext context,
                    java.lang.Class listenerClass,
                    java.util.EventListener listener,
                    Filter filter,
                    java.lang.Object acc,
                    boolean removed)

ListenerInfo

public ListenerInfo(ListenerInfo info,
                    boolean removed)

Method Detail

getBundle

public Bundle getBundle()

getBundleContext

public BundleContext getBundleContext()

Description copied from interface: ListenerHook.ListenerInfo

Return the context of the bundle which added the listener.

Specified by:

getBundleContext in interface ListenerHook.ListenerInfo

Returns:

The context of the bundle which added the listener.

getListenerClass

public java.lang.Class getListenerClass()

getListener

public java.util.EventListener getListener()

getParsedFilter

public Filter getParsedFilter()

getFilter

public java.lang.String getFilter()

Description copied from interface: ListenerHook.ListenerInfo

Return the filter string with which the listener was added.

Specified by:

getFilter in interface ListenerHook.ListenerInfo

Returns:

The filter string with which the listener was added. This may be null if the listener was added without a filter.

getSecurityContext

public java.lang.Object getSecurityContext()

isRemoved

public boolean isRemoved()

Description copied from interface: ListenerHook.ListenerInfo

Return the state of the listener for this addition and removal life cycle. Initially this method will return false indicating the listener has been added but has not been removed. After the listener has been removed, this method must always return true.

There is an extremely rare case in which removed notification to ListenerHooks can be made before added notification if two threads are racing to add and remove the same service listener. Because ListenerHooks are called synchronously during service listener addition and removal, the Framework cannot guarantee in-order delivery of added and removed notification for a given service listener. This method can be used to detect this rare occurrence.

Specified by:

isRemoved in interface ListenerHook.ListenerInfo

Returns:

false if the listener has not been been removed, true otherwise.

equals

public boolean equals(java.lang.Object obj)

Description copied from interface: ListenerHook.ListenerInfo

Compares this ListenerInfo to another ListenerInfo. Two ListenerInfos are equals if they refer to the same listener for a given addition and removal life cycle. If the same listener is added again, it must have a different ListenerInfo which is not equal to this ListenerInfo.

Specified by:

equals in interface ListenerHook.ListenerInfo

Overrides:

equals in class java.lang.Object

Parameters:

obj - The object to compare against this ListenerInfo.

Returns:

true if the other object is a ListenerInfo object and both objects refer to the same listener for a given addition and removal life cycle.

hashCode

public int hashCode()

Description copied from interface: ListenerHook.ListenerInfo

Returns the hash code for this ListenerInfo.

Specified by:

hashCode in interface ListenerHook.ListenerInfo

Overrides:

hashCode in class java.lang.Object

Returns:

The hash code of this ListenerInfo.