001: /*
002: * Copyright (c) 1999-2001 Lutris Technologies, Inc. All Rights
003: * Reserved.
004: *
005: * This source code file is distributed by Lutris Technologies, Inc. for
006: * use only by licensed users of product(s) that include this source
007: * file. Use of this source file or the software that uses it is covered
008: * by the terms and conditions of the Lutris Enhydra Development License
009: * Agreement included with this product.
010: *
011: * This Software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF
012: * ANY KIND, either express or implied. See the License for the specific terms
013: * governing rights and limitations under the License.
014: *
015: * Contributor(s):
016: *
017: * $Id: MessengerManager.java,v 1.1 2006-09-11 12:29:26 sinisa Exp $
018: */
019:
020: package com.lutris.airsent.spec.messenger;
021:
022: import com.lutris.airsent.spec.AirSentException;
023: import com.lutris.airsent.spec.messenger.Messenger;
024:
025: /**
026: * Messenger factory class.
027: *
028: *
029: * @author
030: * @version %I%, %G%
031: */
032: public interface MessengerManager {
033:
034: /**
035: * Creates an empty messenger.
036: *
037: *
038: * @return Messenger
039: *
040: * @throws AirSentException
041: *
042: *
043: */
044: public Messenger create() throws AirSentException;
045:
046: public Messenger create(String id) throws AirSentException;
047:
048: /**
049: * Find a Messenger by its badge.
050: *
051: *
052: * @param badge
053: *
054: * @return Messenger
055: *
056: * @throws AirSentException
057: *
058: *
059: */
060: public Messenger findByBadge(String badge) throws AirSentException;
061:
062: /**
063: * Validate a messengers password.
064: *
065: *
066: * @param badge
067: * @param password
068: *
069: * @return Messenger
070: *
071: * @throws AirSentException
072: *
073: *
074: */
075: public Messenger validatePassword(String badge, String password)
076: throws AirSentException;
077:
078: /**
079: * Find a messenger by proximity using a geocode. NOT currently used.
080: *
081: *
082: * @param geocode
083: *
084: * @return Messenger
085: *
086: * @throws AirSentException
087: *
088: *
089: */
090: public Messenger findByProximity(String geocode)
091: throws AirSentException;
092:
093: /**
094: * Get all the messengers.
095: *
096: *
097: * @return Messenger[]
098: *
099: * @throws AirSentException
100: *
101: *
102: */
103: public Messenger[] findAll() throws AirSentException;
104: }
|