acedia/acedia_network.hpp

/*                                                                            *\
**                          Copyright (C) 2009-2010                           **
**       Dominik Charousset < Dominik.Charousset (at) haw-hamburg.de >        **
**                                                                            **
**            MMM       MMMMMM   MMMMMMMMM MMMMMMM   MMM       MMM            **
**           MMMMM     MMMMMMMM  MMMMMMMMM MMMMMMMM  MMM      MMMMM           **
**          MMM MMM   MMM        MMMM      MMM   MMM MMM     MMM MMM          **
**         MMM   MMM  MMM        MMMMMMMMM MMM   MMM MMM    MMM   MMM         **
**        MMMMMMMMMMM MMMM   MMM MMMM      MMM   MMM MMM   MMMMMMMMMMM        **
**       MMM       MMM MMMMMMMM  MMMMMMMMM MMMMMMMM  MMM  MMM       MMM       **
**      MMM         MMM MMMMMM   MMMMMMMMM MMMMMMM   MMM MMM         MMM      **
**                                                                            **
**                                                                            **
** This file is part of the acedia library.                                   **
**                                                                            **
** This library is free software: you can redistribute it and/or modify       **
** it under the terms of the GNU Lesser General Public License as published   **
** by the Free Software Foundation, either version 3 of the License, or       **
** (at your option) any later version.                                        **
**                                                                            **
** This library 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 Lesser General Public License for more details.                        **
**                                                                            **
** You should have received a copy of the GNU Lesser General Public License   **
** along with acedia. If not, see <http://www.gnu.org/licenses/>.             **
\*                                                                            */

#ifndef ACEDIA_NETWORK_H
#define ACEDIA_NETWORK_H

#include "acedia.hpp"
#include "either.hpp"

namespace acedia
{
    enum PublishingError
    {
        NO_PUBLISHING_ERROR,

        SERVER_SOCKET_ERROR,

        BINDING_ERROR
    };
    const char *asString(PublishingError pe);

    class PublishingResult
    {

        PublishingError m_error;

    public:

        ~PublishingResult();

        inline PublishingResult(PublishingError err) throw() : m_error(err) { }

        inline bool successful() const throw()
        {
            return m_error == NO_PUBLISHING_ERROR;
        }

        inline PublishingError error() const throw() { return m_error; }

        const char *errorAsString() const throw();
    };

    PublishingResult publish(ActorRef actor, boost::uint16_t port);

    void closeConnections(ActorRef actor);

    void closeConnection(ActorRef actor, boost::uint16_t port);

    enum ConnectionError
    {
        NO_CONNECTION_ERROR,
        CONNECTION_SOCKET_ERROR,

        NO_SUCH_HOST_ERROR,

        COULD_NOT_CONNECT_TO_HOST_ERROR,

        INCOMPATIBLE_ACEDIA_VERSIONS_ERROR,

        INCOMPATIBLE_HOST_ERROR
    };

    const char *asString(ConnectionError ce);

} // namespace acedia

ACEDIA_ANNOUNCE((acedia)(ConnectionError))

namespace acedia
{
    std::pair<ActorRef, ConnectionError> remoteActor(const char *host,
                                                     boost::uint16_t port);
}

#endif // ACEDIA_NETWORK_H

---