blob: 7b2cda91b0ec29326d422a72cb1c74d66802f464 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
/*
* Jitsi, the OpenSource Java VoIP and Instant Messaging client.
*
* Distributable under LGPL license.
* See terms of license at gnu.org.
*/
package net.java.sip.communicator.service.gui;
import net.java.sip.communicator.service.contactsource.*;
import net.java.sip.communicator.service.gui.event.*;
/**
* The <tt>FilterQuery</tt> gives information about a current filtering.
*
* @author Yana Stamcheva
*/
public abstract class FilterQuery
{
/**
* A listener, which is notified when this query finishes.
*/
private FilterQueryListener filterQueryListener;
/**
* Adds the given <tt>contactQuery</tt> to the list of filterQueries.
* @param contactQuery the <tt>ContactQuery</tt> to add
*/
public abstract void addContactQuery(Object contactQuery);
/**
* Sets the <tt>isSucceeded</tt> property.
* @param isSucceeded indicates if this query has succeeded
*/
public abstract void setSucceeded(boolean isSucceeded);
/**
* Indicates if this query has succeeded.
* @return <tt>true</tt> if this query has succeeded, <tt>false</tt> -
* otherwise
*/
public abstract boolean isSucceeded();
/**
* Indicates if this query is canceled.
* @return <tt>true</tt> if this query is canceled, <tt>false</tt> otherwise
*/
public abstract boolean isCanceled();
/**
* Cancels this filter query.
*/
public abstract void cancel();
/**
* Closes this query to indicate that no more contact sub-queries would be
* added to it.
*/
public abstract void close();
/**
* Sets the given <tt>FilterQueryListener</tt>.
* @param l the <tt>FilterQueryListener</tt> to set
*/
public void setQueryListener(FilterQueryListener l)
{
filterQueryListener = l;
}
/**
* Removes the given query from this filter query, updates the related data
* and notifies interested parties if this was the last query to process.
* @param query the <tt>ContactQuery</tt> to remove.
*/
public abstract void removeQuery(ContactQuery query);
/**
* Verifies if the given query is contained in this filter query.
*
* @param query the query we're looking for
* @return <tt>true</tt> if the given <tt>query</tt> is contained in this
* filter query, <tt>false</tt> - otherwise
*/
public abstract boolean containsQuery(Object query);
}
|