nx_metadata_sdk  1.0
Metadata SDK
plugin.h
1 // Copyright 2018-present Network Optix, Inc. Licensed under MPL 2.0: www.mozilla.org/MPL/2.0/
2 
3 #pragma once
4 
5 #include <string>
6 #include <functional>
7 
8 #include <nx/sdk/i_utility_provider.h>
9 #include <nx/sdk/analytics/i_plugin.h>
10 #include <nx/sdk/helpers/ref_countable.h>
11 #include <nx/sdk/ptr.h>
12 
13 #include "engine.h"
14 
15 namespace nx {
16 namespace sdk {
17 namespace analytics {
18 
23 class Plugin: public RefCountable<IPlugin>
24 {
25 public:
26  using CreateEngine = std::function<IEngine*(Plugin* plugin)>;
27 
37  Plugin(std::string pluginManifest, CreateEngine createEngine);
38 
39  virtual ~Plugin() override;
40 
41  Ptr<IUtilityProvider> utilityProvider() const { return m_utilityProvider; }
42 
43 protected:
44  Plugin();
45 
50 
51  virtual std::string manifestString() const;
52 
53 //-------------------------------------------------------------------------------------------------
54 // Not intended to be used by a descendant.
55 
56 public:
57  virtual void setUtilityProvider(IUtilityProvider* utilityProvider) override;
58 
59 protected:
60  virtual void getManifest(Result<const IString*>* outResult) const override;
61  virtual void doCreateEngine(Result<IEngine*>* outResult) override;
62 
63 private:
64  void logLifeCycleEvent(const std::string& event) const;
65 
66  void logCreation() const { logLifeCycleEvent("Created"); }
67  void logDestruction() const { logLifeCycleEvent("Destroyed"); }
68 
69  void logError(const std::string& message) const;
70 
71 private:
72  const std::string m_jsonManifest;
73 
74  CreateEngine m_createEngineFunc;
75  Ptr<IUtilityProvider> m_utilityProvider;
76 };
77 
78 } // namespace analytics
79 } // namespace sdk
80 } // namespace nx
Definition: ptr.h:18
virtual void setUtilityProvider(IUtilityProvider *utilityProvider) override
Definition: plugin.cpp:49
virtual Result< IEngine * > doObtainEngine()
Definition: plugin.cpp:41
Definition: result.h:47
Definition: i_utility_provider.h:21
Definition: apple_utils.h:6
Definition: ref_countable.h:84
Definition: plugin.h:23