* updates: cleanup, caching accounts, refactoring and work on
[modest] / src / modest-tny-account-store.h
index 5aedd90..e67ccf9 100644 (file)
@@ -69,8 +69,6 @@ struct _ModestTnyAccountStoreClass {
                                   gpointer user_data);
 };
 
-/* member functions */
-
 /**
  * modest_tny_account_store_get_type:
  *
@@ -88,40 +86,48 @@ GType  modest_tny_account_store_get_type   (void) G_GNUC_CONST;
  */
 ModestTnyAccountStore*    modest_tny_account_store_new (ModestAccountMgr *account_mgr);
 
+
 /**
- * tny_account_store_get_session
- * @self: a TnyAccountStore instance
+ * modest_tny_account_store_get_account_by_id 
+ * @self: a ModestTnyAccountStore instance
+ * @id: some ID
  * 
- * get the tny-camel-session for this account store. Note that this function
- * does NOT have the modest_ prefix, as tinymail requires the symbol to be like this...
- *
- * Returns: a tny-camel-session
+ * get the account with the given ID or NULL if it's not found
+ * 
+ * Returns: the tnyaccount or NULL,
+ * g_object_unref when it's no longer needed
  */
-TnySessionCamel*    tny_account_store_get_session    (TnyAccountStore *self);
+TnyAccount* modest_tny_account_store_get_tny_account_by_id  (ModestTnyAccountStore *self,
+                                                            const gchar *id);
+
 
 /**
- * tny_account_store_get_local_folders_account 
+ * modest_tny_account_store_get_tny_account_by_account
  * @self: a ModestTnyAccountStore instance
+ * @account_name: an account name
+ * @type: the tny account type
  * 
- * return the account corresponding to the local folders
- *
- * Returns: the tnyaccount for the local folders
+ * get the tny account corresponding to one of the  server_accounts for account with @account_name
+ * 
+ * Returns: the tnyaccount or NULL in case it's not found or error,
+ * g_object_unref when it's no longer needed
  */
-TnyAccount*    modest_tny_account_store_get_local_folders_account    (ModestTnyAccountStore *self);
-
+TnyAccount* modest_tny_account_store_get_tny_account_by_account (ModestTnyAccountStore *self,
+                                                                const gchar *account_name,
+                                                                TnyAccountType type);
 
 /**
- * modest_tny_account_store_get_account_from_server_account
- * @server_account: the server account name
+ * tny_account_store_get_session
+ * @self: a TnyAccountStore instance
  * 
- * this function gets a reference to the #TnyAccount corresponding
- * to a given server account.
+ * get the tny-camel-session for this account store. Note that this function
+ * does NOT have the modest_ prefix, as tinymail requires the symbol to be like this...
  *
- * Returns: a  #TnyFolder corresponding to a given server account, or NULL in case
- * of error
+ * Returns: a tny-camel-session
  */
-TnyAccount*  modest_tny_account_store_get_tny_account_from_server_account
-                   (ModestTnyAccountStore *self, const gchar* server_account);
+TnySessionCamel*    tny_account_store_get_session    (TnyAccountStore *self);
+
+
 G_END_DECLS
 
 #endif /* __MODEST_TNY_ACCOUNT_STORE_H__ */