Package org.osgi.framework
Interface Filter
public interface Filter
An RFC 1960-based Filter.
Filter
s can be created by calling
BundleContext.createFilter(java.lang.String)
or FrameworkUtil.createFilter(java.lang.String)
with
a filter string.
A Filter
can be used numerous times to determine if the match
argument matches the filter string that was used to create the
Filter
.
Some examples of LDAP filters are:
"(cn=Babs Jensen)" "(!(cn=Tim Howes))" "(&(" + Constants.OBJECTCLASS + "=Person)(|(sn=Jensen)(cn=Babs J*)))" "(o=univ*of*mich*)"
- Since:
- 1.1
- Version:
- $Revision: 6860 $
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionboolean
Compares thisFilter
to anotherFilter
.int
hashCode()
Returns the hashCode for thisFilter
.boolean
match
(Dictionary dictionary) Filter using aDictionary
.boolean
match
(ServiceReference reference) Filter using a service's properties.boolean
matchCase
(Dictionary dictionary) Filter with case sensitivity using aDictionary
.toString()
Returns thisFilter
's filter string.
-
Method Details
-
match
Filter using a service's properties.This
Filter
is executed using the keys and values of the referenced service's properties. The keys are case insensitively matched with thisFilter
.- Parameters:
reference
- The reference to the service whose properties are used in the match.- Returns:
true
if the service's properties match thisFilter
;false
otherwise.
-
match
Filter using aDictionary
. ThisFilter
is executed using the specifiedDictionary
's keys and values. The keys are case insensitively matched with thisFilter
.- Parameters:
dictionary
- TheDictionary
whose keys are used in the match.- Returns:
true
if theDictionary
's keys and values match this filter;false
otherwise.- Throws:
IllegalArgumentException
- Ifdictionary
contains case variants of the same key name.
-
toString
String toString()Returns thisFilter
's filter string.The filter string is normalized by removing whitespace which does not affect the meaning of the filter.
-
equals
Compares thisFilter
to anotherFilter
.This method returns the result of calling
this.toString().equals(obj.toString())
. -
hashCode
int hashCode()Returns the hashCode for thisFilter
.This method returns the result of calling
this.toString().hashCode()
. -
matchCase
Filter with case sensitivity using aDictionary
. ThisFilter
is executed using the specifiedDictionary
's keys and values. The keys are case sensitively matched with thisFilter
.- Parameters:
dictionary
- TheDictionary
whose keys are used in the match.- Returns:
true
if theDictionary
's keys and values match this filter;false
otherwise.- Since:
- 1.3
-