KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > net > suberic > pooka > AddressMatcher


1 package net.suberic.pooka;
2 import javax.mail.internet.InternetAddress JavaDoc;
3
4 /**
5  * Defines the methods used to access Internet Addresses from a given
6  * String.
7  */

8 public interface AddressMatcher {
9
10   /**
11    * Returns all of the AddressBookEntries which match the given String.
12    */

13   public AddressBookEntry[] match(String JavaDoc matchString);
14
15   /**
16    * <p>Returns the AddressBookEntries that match the given String exactly.
17    */

18   public AddressBookEntry[] matchExactly(String JavaDoc matchString);
19
20   /**
21    * Returns all of the AddressBookEntries whose FirstName matches the given
22    * String.
23    */

24   public AddressBookEntry[] matchFirstName(String JavaDoc matchString);
25
26   /**
27    * Returns all of the AddressBookEntries whose LastName matches the given
28    * String.
29    */

30   public AddressBookEntry[] matchLastName(String JavaDoc matchString);
31
32   /**
33    * Returns all of the AddressBookEntryes whose email addresses match the
34    * given String.
35    */

36   public AddressBookEntry[] matchEmailAddress(String JavaDoc matchString);
37
38   /**
39    * Returns the AddressBookEntry which follows the given String alphabetically.
40    */

41   public AddressBookEntry getNextMatch(String JavaDoc matchString);
42
43   /**
44    * Returns the AddressBookEntry which precedes the given String
45    * alphabetically.
46    */

47   public AddressBookEntry getPreviousMatch(String JavaDoc matchString);
48 }
49
Popular Tags