2 // Open Service Platform
3 // Copyright (c) 2013 Samsung Electronics Co., Ltd.
5 // Licensed under the Apache License, Version 2.0 (the License);
6 // you may not use this file except in compliance with the License.
7 // You may obtain a copy of the License at
9 // http://www.apache.org/licenses/LICENSE-2.0
11 // Unless required by applicable law or agreed to in writing, software
12 // distributed under the License is distributed on an "AS IS" BASIS,
13 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 // See the License for the specific language governing permissions and
15 // limitations under the License.
18 * @file FSclAccountManager.h
19 * @brief This is the header file for the %AccountManager class.
21 * This header file contains the declarations of the %AccountManager class.
23 #ifndef _FSCL_ACCOUNT_MANAGER_H_
24 #define _FSCL_ACCOUNT_MANAGER_H_
26 #include <unique_ptr.h>
27 #include <FBaseObject.h>
28 #include <FBaseTypes.h>
29 #include <FSclTypes.h>
31 namespace Tizen { namespace Base
40 namespace Tizen { namespace Social
43 class AccountProvider;
46 * @class AccountManager
47 * @brief This class provides the method for managing accounts.
50 * @final This class is not intended for extension.
52 * The %AccountManager class provides the method for managing accounts.
54 class _OSP_EXPORT_ AccountManager
55 : public Tizen::Base::Object
60 * The user name must be set in the account.
61 * If the account is added successfully, an account ID is newly assigned to it.
62 * The %AddAccount() method can be used only by the application belonging to a package of an application that registers its own account provider.
66 * @privilege %http://tizen.org/privilege/account.write
68 * @return An error code
69 * @param[in,out] account The account to add
70 * @exception E_SUCCESS The method is successful.
71 * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
72 * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
73 * - The user name is an empty string in the specified @c account. @n
74 * - The account ID is not #INVALID_ACCOUNT_ID. @n
75 * @exception E_INVALID_OPERATION Either of the following conditions has occurred: @n
76 * - The caller application does not belong to a package of an application that registers its own account provider. @n
77 * - The account has already been added with the multiple accounts support set to @c false.
78 * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method.
79 * @exception E_SYSTEM The method cannot proceed due to a severe system error.
81 result AddAccount(Account& account);
84 * Removes an account. @n
85 * The %RemoveAccount() method can be used only by an application belonging to a package of an application that registers its own account provider.
89 * @privilege %http://tizen.org/privilege/account.write
91 * @return An error code
92 * @param[in] accountId The account ID
93 * @exception E_SUCCESS The method is successful.
94 * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
95 * @exception E_INVALID_ARG The specified @c accountId is invalid.
96 * @exception E_OBJ_NOT_FOUND The specified @c accountId does not exist.
97 * @exception E_INVALID_OPERATION This operation is not allowed if the caller application does not belong to a package of an application that registers its own account provider.
98 * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method.
99 * @exception E_SYSTEM The method cannot proceed due to a severe system error.
101 result RemoveAccount(AccountId accountId);
104 * Updates an account. @n
105 * The user name must be set in an account.
106 * The %UpdateAccount() method can be used only by an application belonging to a package of an application that registers its own account provider.
110 * @privilege %http://tizen.org/privilege/account.write
112 * @return An error code
113 * @param[in] account The account to update
114 * @exception E_SUCCESS The method is successful.
115 * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
116 * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
117 * - The user name is an empty string in the specified @c account. @n
118 * - The account ID is invalid. @n
119 * @exception E_OBJ_NOT_FOUND The specified @c account does not exist.
120 * @exception E_INVALID_OPERATION This operation is not allowed if the caller application does not belong to a package of an application that registers its own account provider.
121 * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method.
122 * @exception E_SYSTEM The method cannot proceed due to a severe system error.
124 result UpdateAccount(const Account& account);
127 * Gets the %AccountManager instance.
131 * @return A pointer to the %AccountManager instance, @n
132 * else @c null if it fails
133 * @remarks The specific error code can be accessed using the GetLastResult() method.
135 static AccountManager* GetInstance(void);
139 // This default constructor is intentionally declared as private to implement the Singleton semantic.
143 AccountManager(void);
146 // This destructor is intentionally declared as private to implement the Singleton semantic.
150 virtual ~AccountManager(void);
153 // The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
157 AccountManager(const AccountManager& rhs);
160 // The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
164 AccountManager& operator =(const AccountManager& rhs);
167 // Constructs an instance of this class.
171 // @return An error code
172 // @exception E_SUCCESS The method is successful.
173 // @exception E_SYSTEM The method cannot proceed due to a severe system error.
175 result Construct(void);
178 // Initializes an instance of this class.
182 static void InitAccountManager(void);
185 // Destroys an instance of this class.
189 static void DestroyAccountManager(void);
192 static AccountManager* __pInstance;
193 friend struct std::default_delete<AccountManager>;
195 friend class _AccountManagerImpl;
196 class _AccountManagerImpl* __pAccountManagerImpl;
202 #endif //_FSCL_ACCOUNT_MANAGER_H_