summaryrefslogtreecommitdiff
path: root/tools/lldb-mi/MICmdFactory.h
blob: 19987c281ad0fcfad39382aa2b981ac0591e92b6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
//===-- MICmdFactory.h ------------------------------------------*- C++ -*-===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//

#pragma once

// Third party headers
#include <map>

// In-house headers:
#include "MICmnBase.h"
#include "MIUtilSingletonBase.h"

// Declarations:
class CMICmdBase;
struct SMICmdData;

//++
//============================================================================
// Details: MI Command Factory. Holds a list of registered MI commands that
//          MI application understands to interpret. Creates commands objects.
//          The Command Factory is carried out in the main thread.
//          A singleton class.
//--
class CMICmdFactory : public CMICmnBase, public MI::ISingleton<CMICmdFactory> {
  friend class MI::ISingleton<CMICmdFactory>;

  // Typedefs:
public:
  typedef CMICmdBase *(*CmdCreatorFnPtr)();

  // Class:
public:
  //++
  // Description: Command's factory's interface for commands to implement.
  //--
  class ICmd {
  public:
    virtual const CMIUtilString &GetMiCmd() const = 0;
    virtual CmdCreatorFnPtr GetCmdCreatorFn() const = 0;
    // virtual CMICmdBase *         CreateSelf( void ) = 0;             // Not
    // possible as require a static creator
    // function in the command class, here for awareness

    /* dtor */ virtual ~ICmd() {}
  };

  // Methods:
public:
  bool Initialize() override;
  bool Shutdown() override;
  bool CmdRegister(const CMIUtilString &vMiCmd, CmdCreatorFnPtr vCmdCreateFn);
  bool CmdCreate(const CMIUtilString &vMiCmd, const SMICmdData &vCmdData,
                 CMICmdBase *&vpNewCmd);
  bool CmdExist(const CMIUtilString &vMiCmd) const;

  // Methods:
private:
  /* ctor */ CMICmdFactory();
  /* ctor */ CMICmdFactory(const CMICmdFactory &);
  void operator=(const CMICmdFactory &);

  bool HaveAlready(const CMIUtilString &vMiCmd) const;
  bool IsValid(const CMIUtilString &vMiCmd) const;

  // Overridden:
private:
  // From CMICmnBase
  /* dtor */ ~CMICmdFactory() override;

  // Typedefs:
private:
  typedef std::map<CMIUtilString, CmdCreatorFnPtr> MapMiCmdToCmdCreatorFn_t;
  typedef std::pair<CMIUtilString, CmdCreatorFnPtr>
      MapPairMiCmdToCmdCreatorFn_t;

  // Attributes:
private:
  MapMiCmdToCmdCreatorFn_t m_mapMiCmdToCmdCreatorFn;
};