110 lines
3.4 KiB
C++
110 lines
3.4 KiB
C++
/**
|
|
* Copyright - See the COPYRIGHT that is included with this distribution.
|
|
* EPICS pvData is distributed subject to a Software License Agreement found
|
|
* in file LICENSE that is included with this distribution.
|
|
*/
|
|
/*
|
|
* serializeHelper.h
|
|
*
|
|
* Created on: Oct 21, 2010
|
|
* Author: Miha Vitorovic
|
|
*/
|
|
|
|
#ifndef SERIALIZEHELPER_H_
|
|
#define SERIALIZEHELPER_H_
|
|
|
|
#include <pv/serialize.h>
|
|
#include <pv/byteBuffer.h>
|
|
#include <pv/noDefaultMethods.h>
|
|
#include <pv/pvIntrospect.h>
|
|
|
|
#include <shareLib.h>
|
|
|
|
namespace epics {
|
|
namespace pvData {
|
|
|
|
/**
|
|
* @brief Serialization helper.
|
|
*
|
|
*/
|
|
class epicsShareClass SerializeHelper : public NoDefaultMethods {
|
|
public:
|
|
|
|
/**
|
|
* Serialize array size.
|
|
*
|
|
* @param[in] s size to encode
|
|
* @param[in] buffer serialization buffer
|
|
* @param[in] flusher flusher
|
|
*/
|
|
static void writeSize(std::size_t s, ByteBuffer* buffer,
|
|
SerializableControl* flusher);
|
|
|
|
/**
|
|
* Deserialize array size.
|
|
*
|
|
* @param[in] buffer deserialization buffer.
|
|
* @returns array size.
|
|
*/
|
|
static std::size_t readSize(ByteBuffer* buffer,
|
|
DeserializableControl* control);
|
|
|
|
/**
|
|
* std::string serialization helper method.
|
|
*
|
|
* @param[in] value std::string to serialize
|
|
* @param[in] buffer serialization buffer
|
|
* @param[in] flusher flusher
|
|
*/
|
|
static void serializeString(const std::string& value, ByteBuffer* buffer,
|
|
SerializableControl* flusher);
|
|
|
|
/**
|
|
* std::string serialization helper method.
|
|
*
|
|
* @param[in] value std::string to serialize
|
|
* @param[in] offset start of the substring in {@code value}
|
|
* @param[in] count the number of characters to write
|
|
* @param[in] buffer serialization buffer
|
|
* @param[in] flusher flusher
|
|
*/
|
|
static void serializeSubstring(const std::string& value, std::size_t offset,
|
|
std::size_t count, ByteBuffer* buffer,
|
|
SerializableControl* flusher);
|
|
|
|
/**
|
|
* std::string deserialization helper method.
|
|
* TODO This method cannot return "null", but Java implementation
|
|
* could have serialized "null" value as well. We need to decide
|
|
* how to deserialize "null".
|
|
*
|
|
* @param[in] buffer deserialization buffer
|
|
* @param[in] control control
|
|
* @returns deserialized string
|
|
*
|
|
* @todo This method cannot return "null", but Java implementation
|
|
* could have serialized "null" value as well. We need to decide
|
|
* how to deserialize "null".
|
|
*/
|
|
static std::string deserializeString(ByteBuffer* buffer,
|
|
DeserializableControl* control);
|
|
|
|
private:
|
|
SerializeHelper() {};
|
|
~SerializeHelper() {};
|
|
|
|
/**
|
|
* Serialize array size.
|
|
*
|
|
* @param[in] s size to encode
|
|
* @param[in] buffer serialization buffer
|
|
*/
|
|
static void writeSize(std::size_t s, ByteBuffer* buffer);
|
|
|
|
};
|
|
|
|
}
|
|
}
|
|
|
|
#endif /* SERIALIZEHELPER_H_ */
|