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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
|
/*
* The Mana World Server
* Copyright 2004 The Mana World Development Team
*
* This file is part of The Mana World.
*
* The Mana World is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License as published by the Free
* Software Foundation; either version 2 of the License, or any later version.
*
* The Mana World is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*
* You should have received a copy of the GNU General Public License along
* with The Mana World; if not, write to the Free Software Foundation, Inc.,
* 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
* $Id$
*/
#ifndef _TMWSERV_ACCOUNT_H_
#define _TMWSERV_ACCOUNT_H_
#include <string>
#include "being.h"
/**
* Notes:
* - change from the previous implementation: this class does not encrypt
* passwords anymore and will just store the passwords as they are
* passed to setPassword().
* - the encryption should and must be performed externally from this
* class or else we would end up with the password being encrypted many
* times (e.g setPassword(getPassword()) would encrypt the password
* twice or setPassword(encrypted_password_from_database) would also
* encrypt the password twice).
*/
/**
* A player account.
*/
class Account
{
public:
/**
* Constructor with initial account info.
*
* @param name the user name.
* @param password the user password.
* @param email the user email.
*/
Account(const std::string& name,
const std::string& password,
const std::string& email,
int id = -1);
/**
* Constructor with initial account info.
*
* @param name the user name.
* @param password the user password.
* @param email the user email.
* @param characters the characters.
*/
Account(const std::string& name,
const std::string& password,
const std::string& email,
const Players& characters);
/**
* Destructor.
*/
~Account();
/**
* Set the user name.
*
* @param name the user name.
*/
void
setName(const std::string& name);
/**
* Get the user name.
*
* @return the user name.
*/
const std::string&
getName() const;
/**
* Set the user password.
*
* @param password the user password.
*/
void
setPassword(const std::string& password);
/**
* Get the user password.
*
* @return the user password.
*/
const std::string
getPassword(void) const;
/**
* Set the user email address.
*
* @param email the user email address.
*/
void
setEmail(const std::string& email);
/**
* Get the user email address.
*
* @return the user email address.
*/
const std::string&
getEmail(void) const;
/**
* Set the account level.
*
* @param level the new level.
*/
void
setLevel(const AccountLevels level);
/**
* Get the account level.
*
* @return the account level.
*/
AccountLevels
getLevel() const;
/**
* Set the characters.
*
* @param characters a list of characters.
*/
void
setCharacters(const Players& characters);
/**
* Add a new character.
*
* @param character the new character.
*/
void
addCharacter(PlayerPtr character);
/**
* Remove a character.
*
* @param name The character's name to delete.
*/
bool
delCharacter(std::string const &name);
/**
* Get all the characters.
*
* @return all the characters.
*/
Players&
getCharacters();
/**
* Get a character by name.
*
* @return the character if found, NULL otherwise.
*/
PlayerPtr
getCharacter(const std::string& name);
/**
* Get account ID.
*
* @return the unique ID of the account, a negative number if none yet.
*/
int getID() const
{ return mID; }
/**
* Set account ID.
* The account shall not have any ID yet.
*/
void setID(int);
private:
Account();
Account(Account const &rhs);
Account &operator=(Account const &rhs);
private:
int mID; /**< unique id */
std::string mName; /**< user name */
std::string mPassword; /**< user password (encrypted) */
std::string mEmail; /**< user email address */
Players mCharacters; /**< player data */
AccountLevels mLevel; /**< account level */
};
/**
* Type definition for a smart pointer to Account.
*/
typedef utils::CountedPtr<Account> AccountPtr;
#endif // _TMWSERV_ACCOUNT_H_
|