diff options
Diffstat (limited to '')
| -rw-r--r-- | src/messaging/session.hpp | 25 |
1 files changed, 23 insertions, 2 deletions
diff --git a/src/messaging/session.hpp b/src/messaging/session.hpp index 61e94fb1..4ee25157 100644 --- a/src/messaging/session.hpp +++ b/src/messaging/session.hpp @@ -23,6 +23,7 @@ #include "messaging/authenticator.hpp" #include "messaging/progressionListener.hpp" +#include "messaging/url.hpp" #include "propertySet.hpp" @@ -70,6 +71,16 @@ public: */ transport* getTransport(const string& protocol, authenticator* auth = NULL); + /** Return a transport service instance for the specified URL. + * + * @param url full URL with at least the protocol to use (eg: "smtp://myserver.com/") + * @param auth authenticator object to use for the new transport service. If + * NULL, a default one is used. The default authenticator simply return user + * credentials by reading the session properties "auth.username" and "auth.password". + * @return a new transport service + */ + transport* getTransport(const messaging::url& url, authenticator* auth = NULL); + /** Return a transport service instance for the protocol specified * in the session properties. * @@ -78,7 +89,7 @@ public: * @param auth authenticator object to use for the new store service. If * NULL, a default one is used. The default authenticator simply return user * credentials by reading the session properties "auth.username" and "auth.password". - * @return a new transport service + * @return a new store service */ store* getStore(authenticator* auth = NULL); @@ -88,10 +99,20 @@ public: * @param auth authenticator object to use for the new store service. If * NULL, a default one is used. The default authenticator simply return user * credentials by reading the session properties "auth.username" and "auth.password". - * @return a new transport service + * @return a new store service */ store* getStore(const string& protocol, authenticator* auth = NULL); + /** Return a store service instance for the specified URL. + * + * @param url full URL with at least the protocol to use (eg: "imap://username:[email protected]/") + * @param auth authenticator object to use for the new store service. If + * NULL, a default one is used. The default authenticator simply return user + * credentials by reading the session properties "auth.username" and "auth.password". + * @return a new store service + */ + store* getStore(const messaging::url& url, authenticator* auth = NULL); + /** Properties for the session and for the services. */ const propertySet& getProperties() const; |