ableton-link-dev 1.0.0+dfsg-2 / usr / include / ableton / link / PingResponder.hpp

/* Copyright 2016, Ableton AG, Berlin. All rights reserved.
 *
 *  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, see <http://www.gnu.org/licenses/>.
 *
 *  If you would like to incorporate Link into a proprietary software application,
 *  please contact <link-devs@ableton.com>.
 */

#pragma once

#include <ableton/link/GhostXForm.hpp>
#include <ableton/link/PayloadEntries.hpp>
#include <ableton/link/SessionId.hpp>
#include <ableton/link/v1/Messages.hpp>
#include <ableton/platforms/asio/AsioWrapper.hpp>
#include <ableton/util/Injected.hpp>
#include <ableton/util/SafeAsyncHandler.hpp>
#include <chrono>
#include <memory>
#include <thread>

namespace ableton
{
namespace link
{

template <typename Io, typename Clock, typename Socket, typename Log>
class PingResponder
{
public:
  PingResponder(asio::ip::address_v4 address,
    SessionId sessionId,
    GhostXForm ghostXForm,
    util::Injected<Io> io,
    Clock clock,
    util::Injected<Log> log)
    : mIo(std::move(io))
    , mpImpl(std::make_shared<Impl>(*mIo,
        std::move(address),
        std::move(sessionId),
        std::move(ghostXForm),
        std::move(clock),
        std::move(log)))
  {
    mpImpl->listen();
  }

  PingResponder(const PingResponder&) = delete;
  PingResponder(PingResponder&&) = delete;

  ~PingResponder()
  {
    // post the release of the impl object into the io service so that
    // it happens in the same thread as its handlers
    auto pImpl = mpImpl;
    mIo->post([pImpl]() mutable { pImpl.reset(); });
  }

  void updateNodeState(const SessionId& sessionId, const GhostXForm& xform)
  {
    auto pImpl = mpImpl;
    mIo->post([pImpl, sessionId, xform] {
      pImpl->mSessionId = std::move(sessionId);
      pImpl->mGhostXForm = std::move(xform);
    });
  }

  asio::ip::udp::endpoint endpoint() const
  {
    return mpImpl->mSocket.endpoint();
  }

  asio::ip::address address() const
  {
    return endpoint().address();
  }

  Socket socket() const
  {
    return mpImpl->mSocket;
  }

private:
  struct Impl : std::enable_shared_from_this<Impl>
  {
    Impl(typename util::Injected<Io>::type& io,
      asio::ip::address_v4 address,
      SessionId sessionId,
      GhostXForm ghostXForm,
      Clock clock,
      util::Injected<Log> log)
      : mSessionId(std::move(sessionId))
      , mGhostXForm(std::move(ghostXForm))
      , mClock(std::move(clock))
      , mLog(std::move(log))
      , mSocket(io)
    {
      configureUnicastSocket(mSocket, address);
    }

    void listen()
    {
      mSocket.receive(util::makeAsyncSafe(this->shared_from_this()));
    }

    // Operator to handle incoming messages on the interface
    template <typename It>
    void operator()(const asio::ip::udp::endpoint& from, const It begin, const It end)
    {
      using namespace discovery;

      // Decode Ping Message
      const auto result = link::v1::parseMessageHeader(begin, end);
      const auto& header = result.first;
      const auto payloadBegin = result.second;

      // Check Payload size
      const auto payloadSize = static_cast<std::size_t>(std::distance(payloadBegin, end));
      const auto maxPayloadSize =
        sizeInByteStream(makePayload(HostTime{}, PrevGHostTime{}));
      if (header.messageType == v1::kPing && payloadSize <= maxPayloadSize)
      {
        debug(*mLog) << "Received ping message from " << from;

        try
        {
          reply(std::move(payloadBegin), std::move(end), from);
        }
        catch (const std::runtime_error& err)
        {
          info(*mLog) << "Failed to send pong to " << from << ". Reason: " << err.what();
        }
      }
      else
      {
        info(*mLog) << "Received invalid Message from " << from << ".";
      }
      listen();
    }

    template <typename It>
    void reply(It begin, It end, const asio::ip::udp::endpoint& to)
    {
      using namespace discovery;

      // Encode Pong Message
      const auto id = SessionMembership{mSessionId};
      const auto currentGt = GHostTime{mGhostXForm.hostToGhost(mClock.micros())};
      const auto pongPayload = makePayload(id, currentGt);

      v1::MessageBuffer pongBuffer;
      const auto pongMsgBegin = std::begin(pongBuffer);
      auto pongMsgEnd = v1::pongMessage(pongPayload, pongMsgBegin);
      // Append ping payload to pong message.
      pongMsgEnd = std::copy(begin, end, pongMsgEnd);

      const auto numBytes =
        static_cast<std::size_t>(std::distance(pongMsgBegin, pongMsgEnd));
      mSocket.send(pongBuffer.data(), numBytes, to);
    }

    SessionId mSessionId;
    GhostXForm mGhostXForm;
    Clock mClock;
    util::Injected<Log> mLog;
    Socket mSocket;
  };

  util::Injected<Io> mIo;
  std::shared_ptr<Impl> mpImpl;
};

} // namespace link
} // namespace ableton