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: Messenger.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.address.Address;
024:
025: /**
026: * Messenger interface
027: */
028: public interface Messenger extends java.io.Serializable {
029:
030: /**
031: * maximum size for badge
032: */
033: public static int MAX_BADGE = 32;
034:
035: /**
036: * maximum size for geocode
037: */
038: public static int MAX_GEOCODE = 32;
039:
040: /**
041: * maximum size for password
042: */
043: public static int MAX_PASSWORD = 32;
044:
045: /**
046: * Get messengers database handle
047: *
048: * @return database id
049: * @exception if an error occurs
050: */
051: public String getHandle() throws AirSentException;
052:
053: /**
054: * Get first name.
055: *
056: * @return first name
057: * @exception if an error occurs
058: */
059: public String getFirstName() throws AirSentException;
060:
061: /**
062: * Set first name.
063: *
064: * @param first first name
065: * @exception if an error occurs
066: * @exception if business rules are violated
067: */
068: public void setFirstName(String first) throws AirSentException;
069:
070: /**
071: * Get last name.
072: *
073: * @return last name
074: * @exception if an error occurs
075: */
076: public String getLastName() throws AirSentException;
077:
078: /**
079: * Set last name.
080: *
081: * @param last
082: * @exception if an error occurs
083: * @exception if business rules are violated
084: */
085: public void setLastName(String last) throws AirSentException;
086:
087: /**
088: * Gets the address.
089: *
090: * @return address
091: * @exception if an error occurs
092: */
093: public Address getAddress() throws AirSentException;
094:
095: /**
096: * Get badge.
097: *
098: * @return badge
099: * @exception if an error occurs
100: */
101: public String getBadge() throws AirSentException;
102:
103: /**
104: * Set the badge
105: *
106: * @exception if an error occurs
107: * @exception if business rules are violated
108: */
109: public void setBadge(String badge) throws AirSentException;
110:
111: /**
112: * Get password.
113: *
114: * @return password
115: * @exception if an error occurs
116: */
117: public String getPassword() throws AirSentException;
118:
119: /**
120: * Set password.
121: *
122: * @exception if an error occurs
123: * @exception if business rules are violated
124: */
125: public void setPassword(String password) throws AirSentException;
126:
127: /**
128: * Get email.
129: *
130: * @return email address
131: * @exception if an error occurs
132: */
133: public String getEmail() throws AirSentException;
134:
135: /**
136: * Set Email.
137: *
138: * @param email
139: * @exception if an error occurs
140: * @exception if business rules are violated
141: */
142: public void setEmail(String email) throws AirSentException;
143:
144: /**
145: * Gets the geocode. NOT currently used.
146: *
147: * @return code
148: * @exception if an error occurs
149: */
150: public String getGeocode() throws AirSentException;
151:
152: /**
153: * Saves the messenger.
154: *
155: * @exception if an error occurs
156: */
157: public void save() throws AirSentException;
158:
159: /**
160: * Deletes the messenger.
161: *
162: * @exception if an error occurs
163: */
164: public void delete() throws AirSentException;
165:
166: }
|