Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
  /*
   * Copyright (c) OSGi Alliance (2000, 2009). All Rights Reserved.
   * 
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   *      http://www.apache.org/licenses/LICENSE-2.0
   *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
 package org.osgi.framework;
 
An RFC 1960-based Filter.

Filters 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*)"
 

Version:
$Revision: 6860 $
Since:
1.1
See also:
"Core Specification, section 5.5, for a description of the filter string syntax."
ThreadSafe:
 
 public interface Filter {
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 this Filter.

Parameters:
reference The reference to the service whose properties are used in the match.
Returns:
true if the service's properties match this Filter; false otherwise.
 
 	public boolean match(ServiceReference reference);

Filter using a Dictionary. This Filter is executed using the specified Dictionary's keys and values. The keys are case insensitively matched with this Filter.

Parameters:
dictionary The Dictionary whose keys are used in the match.
Returns:
true if the Dictionary's keys and values match this filter; false otherwise.
Throws:
java.lang.IllegalArgumentException If dictionary contains case variants of the same key name.
 
 	public boolean match(Dictionary dictionary);

Returns this Filter's filter string.

The filter string is normalized by removing whitespace which does not affect the meaning of the filter.

Returns:
This Filter's filter string.
 
 	public String toString();

Compares this Filter to another Filter.

This method returns the result of calling this.toString().equals(obj.toString()).

Parameters:
obj The object to compare against this Filter.
Returns:
If the other object is a Filter object, then returns the result of calling this.toString().equals(obj.toString()); false otherwise.
 
 	public boolean equals(Object obj);

Returns the hashCode for this Filter.

This method returns the result of calling this.toString().hashCode().

Returns:
The hashCode of this Filter.
	public int hashCode();

Filter with case sensitivity using a Dictionary. This Filter is executed using the specified Dictionary's keys and values. The keys are case sensitively matched with this Filter.

Parameters:
dictionary The Dictionary whose keys are used in the match.
Returns:
true if the Dictionary's keys and values match this filter; false otherwise.
Since:
1.3
	public boolean matchCase(Dictionary dictionary);
New to GrepCode? Check out our FAQ X