Serialization.h

Go to the documentation of this file.

#ifndef INCLUDE_MOLASSEMBLER_SERIALIZATION_H
#define INCLUDE_MOLASSEMBLER_SERIALIZATION_H

#include <vector>
#include <string>
#include <memory>

#include "Molassembler/Export.h"

namespace Scine {
namespace Molassembler {

// Forward-declarations
class Molecule;

class MASM_EXPORT JsonSerialization {
public:
  using BinaryType = std::vector<std::uint8_t>;

  enum class BinaryFormat {
    CBOR,
    BSON,
    MsgPack,
    UBJSON
  };

  static std::string base64Encode(const BinaryType& binary);
  static BinaryType base64Decode(const std::string& base64String);
  static bool base64EqualMolecules(const std::string& stringA, const std::string& stringB,
                                   BinaryFormat binaryFormat = BinaryFormat::CBOR);
  static bool equalDecisionLists(const std::string& listStringA, const std::string& listStringB);

  JsonSerialization(JsonSerialization&& other) noexcept;
  JsonSerialization& operator = (JsonSerialization&& other) noexcept;
  JsonSerialization(const JsonSerialization& other);
  JsonSerialization& operator = (const JsonSerialization& other);
  ~JsonSerialization();

  JsonSerialization() = delete;
  explicit JsonSerialization(const std::string& jsonString);
  explicit JsonSerialization(const Molecule& molecule);
  JsonSerialization(const BinaryType& binary, BinaryFormat format);

  operator std::string() const;
  operator Molecule() const;
  BinaryType toBinary(BinaryFormat format) const;


  JsonSerialization& standardize();

private:
  struct Impl;
  std::unique_ptr<Impl> pImpl_;
  static std::vector<std::tuple<int, int, int, int> > unpackDecisionListString(const std::string& listString);
  static std::tuple<int, int, int, int> canonicalizeDecisionListElement(const std::tuple<int, int, int, int>& decisionListElement);
  static bool equalVersions(const std::vector<unsigned> versionA, const std::vector<unsigned> versionB);
  static std::vector<std::string> splitBase64StringIntoMoleculeStrings(std::string base64String);
};

} // namespace Molassembler
} // namespace Scine

#endif