mirror of
https://github.com/FairRootGroup/FairMQ.git
synced 2025-10-12 16:21:13 +00:00
fe2127e12f
Avoid disseminating every compile unit including Message.h with TransportNames and TransportTypes and the associated unordered_map helper methods (e.g. murmur_hash).
91 lines
2.9 KiB
C++
91 lines
2.9 KiB
C++
/********************************************************************************
|
|
* Copyright (C) 2021-2022 GSI Helmholtzzentrum fuer Schwerionenforschung GmbH *
|
|
* *
|
|
* This software is distributed under the terms of the *
|
|
* GNU Lesser General Public Licence (LGPL) version 3, *
|
|
* copied verbatim in the file "LICENSE" *
|
|
********************************************************************************/
|
|
|
|
#ifndef FAIR_MQ_MESSAGE_H
|
|
#define FAIR_MQ_MESSAGE_H
|
|
|
|
#include <cstddef> // for size_t
|
|
#include <fairmq/TransportEnum.h>
|
|
#include <memory> // unique_ptr
|
|
#include <stdexcept>
|
|
|
|
namespace fair::mq {
|
|
|
|
using FreeFn = void(void* data, void* hint);
|
|
class TransportFactory;
|
|
|
|
struct Alignment
|
|
{
|
|
size_t alignment;
|
|
explicit operator size_t() const { return alignment; }
|
|
};
|
|
|
|
struct Message
|
|
{
|
|
Message() = default;
|
|
Message(TransportFactory* factory)
|
|
: fTransport(factory)
|
|
{}
|
|
|
|
Message(const Message&) = delete;
|
|
Message(Message&&) = delete;
|
|
Message& operator=(const Message&) = delete;
|
|
Message& operator=(Message&&) = delete;
|
|
|
|
virtual void Rebuild() = 0;
|
|
virtual void Rebuild(Alignment alignment) = 0;
|
|
virtual void Rebuild(size_t size) = 0;
|
|
virtual void Rebuild(size_t size, Alignment alignment) = 0;
|
|
virtual void Rebuild(void* data, size_t size, FreeFn* ffn, void* hint = nullptr) = 0;
|
|
|
|
virtual void* GetData() const = 0;
|
|
virtual size_t GetSize() const = 0;
|
|
|
|
virtual bool SetUsedSize(size_t size, Alignment alignment = Alignment{0}) = 0;
|
|
|
|
virtual Transport GetType() const = 0;
|
|
TransportFactory* GetTransport() { return fTransport; }
|
|
void SetTransport(TransportFactory* transport) { fTransport = transport; }
|
|
|
|
/// Copy the message buffer from another message
|
|
/// Transport may choose not to physically copy the buffer, but to share across the messages.
|
|
/// Modifying the buffer after a call to Copy() is undefined behaviour.
|
|
/// @param msg message to copy the buffer from.
|
|
virtual void Copy(const Message& msg) = 0;
|
|
|
|
virtual ~Message() = default;
|
|
|
|
private:
|
|
TransportFactory* fTransport{nullptr};
|
|
};
|
|
|
|
using MessagePtr = std::unique_ptr<Message>;
|
|
|
|
struct MessageError : std::runtime_error
|
|
{
|
|
using std::runtime_error::runtime_error;
|
|
};
|
|
|
|
struct MessageBadAlloc : std::runtime_error
|
|
{
|
|
using std::runtime_error::runtime_error;
|
|
};
|
|
|
|
struct RefCountBadAlloc : std::runtime_error
|
|
{
|
|
using std::runtime_error::runtime_error;
|
|
};
|
|
|
|
} // namespace fair::mq
|
|
|
|
using fairmq_free_fn [[deprecated("Use fair::mq::FreeFn")]] = fair::mq::FreeFn;
|
|
using FairMQMessage [[deprecated("Use fair::mq::Message")]] = fair::mq::Message;
|
|
using FairMQMessagePtr [[deprecated("Use fair::mq::MessagePtr")]] = fair::mq::MessagePtr;
|
|
|
|
#endif // FAIR_MQ_MESSAGE_H
|