CaseOptions.h

// -*- tab-width: 2; indent-tabs-mode: nil; coding: utf-8-with-signature -*-
//-----------------------------------------------------------------------------
// Copyright 2000-2026 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
// See the top-level COPYRIGHT file for details.
// SPDX-License-Identifier: Apache-2.0
//-----------------------------------------------------------------------------
/*---------------------------------------------------------------------------*/
/* CaseOptions.h                                               (C) 2000-2025 */
/*                                                                           */
/* Data set options.                                                         */
/*---------------------------------------------------------------------------*/
#ifndef ARCANE_CASEOPTIONS_H
#define ARCANE_CASEOPTIONS_H
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#include "arccore/base/ReferenceCounterImpl.h"
 
#include "arcane/utils/Array.h"
#include "arcane/utils/String.h"
#include "arcane/utils/Ref.h"
 
#include "arcane/core/XmlNode.h"
#include "arcane/core/ICaseOptions.h"
#include "arcane/core/ICaseOptionList.h"
 
// These files are not necessary for this '.h' but are included
// because axlstar only includes 'CaseOptions.h'
#include "arcane/core/CaseOptionSimple.h"
#include "arcane/core/CaseOptionEnum.h"
#include "arcane/core/CaseOptionExtended.h"
#include "arcane/core/CaseOptionComplexValue.h"
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
namespace Arcane
{
namespace AxlOptionsBuilder
{
  class Document;
}
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

class ARCANE_CORE_EXPORT CaseOptions
: private ReferenceCounterImpl
, public ICaseOptions
{
  ARCCORE_DEFINE_REFERENCE_COUNTED_INCLASS_METHODS();
 
 private:
 
  struct XmlContent
  {
    String m_xml_content;
    IXmlDocumentHolder* m_document = nullptr;
  };
 
 public:

  CaseOptions(ICaseMng* cm, const String& name);
  CaseOptions(ICaseOptionList*, const String& name);
  CaseOptions(ICaseMng* cm, const String& name, const XmlNode& parent);
  CaseOptions(ICaseOptionList*, const String& name, const XmlNode& parent, bool is_optional = false, bool is_multi = false);
 
 protected:
 
  CaseOptions(ICaseMng*, const String& name, ICaseOptionList* parent);
  CaseOptions(ICaseOptionList*, const String& name, ICaseOptionList* parent);
 
 private:
 
  friend class ServiceBuilderWithOptionsBase;
 
  // Only for ServiceBuilderWithOptionsBase
  static ReferenceCounter<ICaseOptions> createDynamic(ICaseMng* cm, const AxlOptionsBuilder::Document& options_doc);

  CaseOptions(ICaseMng*, const XmlContent& xm_content);
 
 public:

  ~CaseOptions() override;
 
 private:
 
  CaseOptions(const CaseOptions& rhs) = delete;
  CaseOptions& operator=(const CaseOptions& rhs) = delete;
 
 public:

  String rootTagTrueName() const override;

  String rootTagName() const override;

  String translatedName(const String& lang) const override;

  virtual String trueName() const { return rootTagTrueName(); }

  virtual String name() const { return rootTagName(); }
 
  void read(bool is_phase1) override
  {
    auto p = (is_phase1) ? eCaseOptionReadPhase::Phase1 : eCaseOptionReadPhase::Phase2;
    read(p);
  }
 
  void read(eCaseOptionReadPhase phase) override;
 
  void addInvalidChildren(XmlNodeList&) override;
 
  void printChildren(const String& lang, int indent) override;

  IServiceInfo* caseServiceInfo() const override;

  IModule* caseModule() const override;

  void setCaseServiceInfo(IServiceInfo* m) override;

  void setCaseModule(IModule* m) override;

  void deepGetChildren(Array<CaseOptionBase*>& col) override;
 
  ICaseOptionList* configList() override;
 
  const ICaseOptionList* configList() const override;

  ICaseFunction* activateFunction() override;

  bool isPresent() const override;

  void addAlternativeNodeName(const String& lang, const String& name) override;
 
  ICaseMng* caseMng() const override;
  ITraceMng* traceMng() const override;
  ISubDomain* subDomain() const override;
  IMesh* mesh() const override;
  MeshHandle meshHandle() const override;
  ICaseDocument* caseDocument() const override;
  ICaseDocumentFragment* caseDocumentFragment() const override;
 
  void detach() override;
 
  void visit(ICaseDocumentVisitor* visitor) const override;
 
  String xpathFullName() const override;
 
  Ref<ICaseOptions> toReference() override;
 
 protected:
 
  friend class CaseOptionMultiServiceImpl;
 
  void _setTranslatedName();
  bool _setMeshHandleAndCheckDisabled(const String& mesh_name);
 
 protected:
 
  CaseOptionsPrivate* m_p; 
 
 private:
 
  void _setMeshHandle(const MeshHandle& handle);
  void _setParent(ICaseOptionList* parent);
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
} // End namespace Arcane
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#endif