/** * libtransport -- C++ library for easy XMPP Transports development * * Copyright (C) 2011, Jan Kaluza * * This program 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 * (at your option) any later version. * * This program 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 this program; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA */ #pragma once #include #include "Swiften/Swiften.h" #include "Swiften/Server/Server.h" #include "Swiften/Disco/GetDiscoInfoRequest.h" #include "Swiften/Disco/EntityCapsManager.h" #include "Swiften/Disco/CapsManager.h" #include "Swiften/Disco/CapsMemoryStorage.h" #include "Swiften/Presence/PresenceOracle.h" #include "Swiften/Network/BoostTimerFactory.h" #include "Swiften/Network/BoostIOServiceThread.h" #include "Swiften/Server/UserRegistry.h" #include "Swiften/Base/SafeByteArray.h" #include "Swiften/Jingle/JingleSessionManager.h" #include #include "transport/config.h" #include "transport/factory.h" namespace Transport { // typedef enum { CLIENT_FEATURE_ROSTERX = 2, // CLIENT_FEATURE_XHTML_IM = 4, // CLIENT_FEATURE_FILETRANSFER = 8, // CLIENT_FEATURE_CHATSTATES = 16 // } SpectrumImportantFeatures; // class StorageBackend; class DiscoInfoResponder; class DiscoItemsResponder; class Factory; class UserRegistry; /// Represents one transport instance. /// It's used to connect the Jabber server and provides transaction layer /// between Jabber server and other classes. /// /// In server mode it represents Jabber server to which users can connect and use /// it as transport. class Component { public: /// Creates new Component instance. /// \param loop Main event loop. /// \param config Cofiguration; this class uses following Config values: /// - service.jid /// - service.password /// - service.server /// - service.port /// - service.server_mode /// \param factory Transport Abstract factory used to create basic transport structures. Component(Swift::EventLoop *loop, Swift::NetworkFactories *factories, Config *config, Factory *factory, Transport::UserRegistry *userRegistry = NULL); /// Component destructor. ~Component(); /// Returns Swift::StanzaChannel associated with this Transport::Component. /// It can be used to send presences and other stanzas. /// \return Swift::StanzaChannel associated with this Transport::Component. Swift::StanzaChannel *getStanzaChannel(); Swift::CapsInfo &getBuddyCapsInfo(); /// Returns Swift::IQRouter associated with this Component. /// \return Swift::IQRouter associated with this Component. Swift::IQRouter *getIQRouter() { return m_iqRouter; } /// Returns Swift::PresenceOracle associated with this Transport::Component. /// You can use it to check current resource connected for particular user. /// \return Swift::PresenceOracle associated with this Transport::Component. Swift::PresenceOracle *getPresenceOracle(); /// Returns True if the component is in server mode. /// \return True if the component is in server mode. bool inServerMode() { return m_server != NULL; } /// Connects the Jabber server. void start(); void stop(); /// Sets disco#info features which are sent as answer to disco#info IQ-get. /// This sets features of transport contact (For example "j2j.domain.tld"). /// \param features list of features as sent in disco#info response void setTransportFeatures(std::list &features); /// Sets disco#info features which are sent as answer to disco#info IQ-get. /// This sets features of legacy network buddies (For example "me\40gmail.com@j2j.domain.tld"). /// \param features list of features as sent in disco#info response void setBuddyFeatures(std::list &features); /// Returns Jabber ID of this transport. /// \return Jabber ID of this transport Swift::JID &getJID() { return m_jid; } /// Returns Swift::NetworkFactories which can be used to create new connections. /// \return Swift::NetworkFactories which can be used to create new connections. Swift::NetworkFactories *getNetworkFactories() { return m_factories; } /// Returns Transport Factory used to create basic Transport components. /// \return Transport Factory used to create basic Transport components. Factory *getFactory() { return m_factory; } /// This signal is emitted when server disconnects the transport because of some error. /// \param error disconnection error boost::signal onConnectionError; /// This signal is emitted when transport successfully connects the server. boost::signal onConnected; /// This signal is emitted when XML stanza is sent to server. /// \param xml xml stanza boost::signal onXMLOut; /// This signal is emitted when XML stanza is received from server. /// \param xml xml stanza boost::signal onXMLIn; Config *getConfig() { return m_config; } /// This signal is emitted when presence from XMPP user is received. /// It's emitted only for presences addressed to transport itself /// (for example to="j2j.domain.tld"). /// \param presence presence data boost::signal onUserPresenceReceived; boost::signal info)> onUserDiscoInfoReceived; // boost::signal info, Swift::ErrorPayload::ref error, const Swift::JID& jid)> onDiscoInfoResponse; private: void handleConnected(); void handleConnectionError(const Swift::ComponentError &error); void handlePresence(Swift::Presence::ref presence); void handleDataRead(const Swift::SafeByteArray &data); void handleDataWritten(const Swift::SafeByteArray &data); void handleDiscoInfoResponse(boost::shared_ptr info, Swift::ErrorPayload::ref error, const Swift::JID& jid); void handleCapsChanged(const Swift::JID& jid); Swift::NetworkFactories *m_factories; Swift::Component *m_component; Swift::Server *m_server; Swift::Timer::ref m_reconnectTimer; Swift::EntityCapsManager *m_entityCapsManager; Swift::CapsManager *m_capsManager; Swift::CapsMemoryStorage *m_capsMemoryStorage; Swift::PresenceOracle *m_presenceOracle; Swift::StanzaChannel *m_stanzaChannel; Swift::IQRouter *m_iqRouter; Transport::UserRegistry *m_userRegistry; StorageBackend *m_storageBackend; DiscoInfoResponder *m_discoInfoResponder; DiscoItemsResponder *m_discoItemsResponder; int m_reconnectCount; Config* m_config; std::string m_protocol; Swift::JID m_jid; Factory *m_factory; Swift::EventLoop *m_loop; friend class User; friend class UserRegistration; friend class NetworkPluginServer; }; }