JSONReader.h

// -*- tab-width: 2; indent-tabs-mode: nil; coding: utf-8-with-signature -*-
//-----------------------------------------------------------------------------
// Copyright 2000-2023 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
// See the top-level COPYRIGHT file for details.
// SPDX-License-Identifier: Apache-2.0
//-----------------------------------------------------------------------------
/*---------------------------------------------------------------------------*/
/* JSONReader.h                                                (C) 2000-2023 */
/*                                                                           */
/* Lecteur au format JSON.                                                   */
/*---------------------------------------------------------------------------*/
#ifndef ARCANE_UTILS_JSONREADER_H
#define ARCANE_UTILS_JSONREADER_H
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#include "arcane/utils/UtilsTypes.h"
#include "arcane/utils/Array.h"
 
#include <vector>
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
namespace Arcane
{
class JSONWrapperUtils;
class JSONKeyValue;
class JSONKeyValueList;
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
class ARCANE_UTILS_EXPORT JSONValue
{
  class Impl;
  friend JSONWrapperUtils;
  friend JSONKeyValue;
 
 private:
 
  explicit JSONValue(Impl* p)
  : m_p(p)
  {}
 
 public:
 
  JSONValue()
  : m_p(nullptr)
  {}
 
 public:
 
  bool null() const { return !m_p; }
  bool operator!() const { return null(); }
 
 public:
 
  ARCANE_DEPRECATED_REASON("Y2023: Use valueAsStringView() or value() instead")
  StringView valueAsString() const;
 
  String value() const;
  StringView valueAsStringView() const;
  Real valueAsReal() const;
  Int64 valueAsInt64() const;
  Int32 valueAsInt32() const;
  bool valueAsBool() const;
  JSONValueList valueAsArray() const;
 
 public:
 
  JSONKeyValue keyValueChild(StringView name) const;
  JSONValue child(StringView name) const;
  JSONValue expectedChild(StringView name) const;
  // Liste des objects fils de cet objet. L'instance doit être un objet
  JSONValueList children() const;
  JSONKeyValueList keyValueChildren() const;
 
 public:
 
  bool isArray() const;
  bool isObject() const;
 
 private:
 
  Impl* m_p;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
class ARCANE_UTILS_EXPORT JSONKeyValue
{
  class Impl;
  friend JSONWrapperUtils;
 
 private:
 
  explicit JSONKeyValue(Impl* p)
  : m_p(p)
  {}
 
 public:
 
  JSONKeyValue()
  : m_p(nullptr)
  {}
 
 public:
 
  bool null() const { return !m_p; }
  bool operator!() const { return null(); }
 
 public:
 
  StringView name() const;
  JSONValue value() const;
 
 private:
 
  Impl* m_p;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
class ARCANE_UTILS_EXPORT JSONKeyValueList
{
  typedef std::vector<JSONKeyValue> ContainerType;
 
 public:
 
  typedef ContainerType::const_iterator const_iterator;
  typedef ContainerType::iterator iterator;
 
 public:
 
  void add(JSONKeyValue v)
  {
    m_values.push_back(v);
  }
  const_iterator begin() const { return m_values.begin(); }
  const_iterator end() const { return m_values.end(); }
 
 private:
 
  std::vector<JSONKeyValue> m_values;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
class ARCANE_UTILS_EXPORT JSONValueList
{
  typedef std::vector<JSONValue> ContainerType;
 
 public:
 
  typedef ContainerType::const_iterator const_iterator;
  typedef ContainerType::iterator iterator;
 
 public:
 
  void add(JSONValue v)
  {
    m_values.push_back(v);
  }
  const_iterator begin() const { return m_values.begin(); }
  const_iterator end() const { return m_values.end(); }
 
 private:
 
  std::vector<JSONValue> m_values;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
class ARCANE_UTILS_EXPORT JSONDocument
{
  class Impl;
 
 public:
 
  JSONDocument();
  ~JSONDocument();
 
 public:
 
  void parse(Span<const Byte> bytes);
  void parse(Span<const std::byte> bytes);
  void parse(Span<const Byte> bytes, StringView file_name);
  void parse(Span<const std::byte> bytes, StringView file_name);
  JSONValue root() const;
 
 private:
 
  Impl* m_p;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
} // namespace Arcane
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#endif