communicatorfactory.h
Go to the documentation of this file.
1 
2 // Copyright (c) 2003-2021 Xsens Technologies B.V. or subsidiaries worldwide.
3 // All rights reserved.
4 //
5 // Redistribution and use in source and binary forms, with or without modification,
6 // are permitted provided that the following conditions are met:
7 //
8 // 1. Redistributions of source code must retain the above copyright notice,
9 // this list of conditions, and the following disclaimer.
10 //
11 // 2. Redistributions in binary form must reproduce the above copyright notice,
12 // this list of conditions, and the following disclaimer in the documentation
13 // and/or other materials provided with the distribution.
14 //
15 // 3. Neither the names of the copyright holders nor the names of their contributors
16 // may be used to endorse or promote products derived from this software without
17 // specific prior written permission.
18 //
19 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
20 // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
21 // MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
22 // THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23 // SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
24 // OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 // HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY OR
26 // TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
27 // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.THE LAWS OF THE NETHERLANDS
28 // SHALL BE EXCLUSIVELY APPLICABLE AND ANY DISPUTES SHALL BE FINALLY SETTLED UNDER THE RULES
29 // OF ARBITRATION OF THE INTERNATIONAL CHAMBER OF COMMERCE IN THE HAGUE BY ONE OR MORE
30 // ARBITRATORS APPOINTED IN ACCORDANCE WITH SAID RULES.
31 //
32 
33 
34 // Copyright (c) 2003-2021 Xsens Technologies B.V. or subsidiaries worldwide.
35 // All rights reserved.
36 //
37 // Redistribution and use in source and binary forms, with or without modification,
38 // are permitted provided that the following conditions are met:
39 //
40 // 1. Redistributions of source code must retain the above copyright notice,
41 // this list of conditions, and the following disclaimer.
42 //
43 // 2. Redistributions in binary form must reproduce the above copyright notice,
44 // this list of conditions, and the following disclaimer in the documentation
45 // and/or other materials provided with the distribution.
46 //
47 // 3. Neither the names of the copyright holders nor the names of their contributors
48 // may be used to endorse or promote products derived from this software without
49 // specific prior written permission.
50 //
51 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
52 // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
53 // MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
54 // THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
55 // SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
56 // OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
57 // HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY OR
58 // TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
59 // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.THE LAWS OF THE NETHERLANDS
60 // SHALL BE EXCLUSIVELY APPLICABLE AND ANY DISPUTES SHALL BE FINALLY SETTLED UNDER THE RULES
61 // OF ARBITRATION OF THE INTERNATIONAL CHAMBER OF COMMERCE IN THE HAGUE BY ONE OR MORE
62 // ARBITRATORS APPOINTED IN ACCORDANCE WITH SAID RULES.
63 //
64 
65 #ifndef COMMUNICATORFACTORY_H
66 #define COMMUNICATORFACTORY_H
67 
68 #include "compat.h"
69 
70 #include <map>
71 #include <memory>
72 
73 struct Communicator;
74 struct XsString;
75 struct XsPortInfo;
76 
81 {
82 public:
86  template <typename T>
87  static std::unique_ptr<T> createFactory()
88  {
89  auto factory = std::make_unique<T>();
90  factory->registerCommunicatorTypes();
91  return factory;
92  }
93 
95  virtual ~CommunicatorFactory();
96 
98  typedef unsigned int CommunicatorTypeId;
99 
101  typedef Communicator* (*CommunicatorConstructFunc)();
102 
104  typedef bool (*PortInfoMatchFunc)(const XsPortInfo&);
105 
106  Communicator* create(const XsPortInfo& portInfo) const;
107  Communicator* create(const XsString& filename) const;
108 
109  bool registerType(CommunicatorTypeId typeId, CommunicatorConstructFunc constructFunc, PortInfoMatchFunc matchFunc);
110 
115  virtual CommunicatorTypeId filenameToCommunicatorId(const XsString& filename) const = 0;
116 
121  virtual CommunicatorTypeId portInfoToCommunicatorId(const XsPortInfo& portInfo) const = 0;
122 
124  virtual void registerCommunicatorTypes() {}
125 
126 protected:
128  typedef std::map<CommunicatorTypeId, std::pair<CommunicatorConstructFunc, PortInfoMatchFunc>> ConstructorsMap;
129 
132  {
133  return m_constructors;
134  }
135  virtual Communicator* construct(CommunicatorTypeId communicator) const;
136 
137 private:
139 };
140 
142 {
144 }
145 
146 #endif
CommunicatorType
Definition: communicatorfactory.h:141
CommunicatorFactory::portInfoToCommunicatorId
virtual CommunicatorTypeId portInfoToCommunicatorId(const XsPortInfo &portInfo) const =0
Match a XsPortInfo to a communicator.
CommunicatorFactory::createFactory
static std::unique_ptr< T > createFactory()
Create a new CommunicatorFactory and register its basic types.
Definition: communicatorfactory.h:87
CommunicatorType::INVALID
static const CommunicatorFactory::CommunicatorTypeId INVALID
Definition: communicatorfactory.h:143
CommunicatorFactory::registerCommunicatorTypes
virtual void registerCommunicatorTypes()
Registrates communicator types.
Definition: communicatorfactory.h:124
CommunicatorFactory
A Factory for the communicators.
Definition: communicatorfactory.h:80
CommunicatorFactory::m_constructors
ConstructorsMap m_constructors
Definition: communicatorfactory.h:138
CommunicatorFactory::CommunicatorConstructFunc
Communicator *(* CommunicatorConstructFunc)()
The typedef of the communicator constructor function.
Definition: communicatorfactory.h:101
CommunicatorFactory::construct
virtual Communicator * construct(CommunicatorTypeId communicator) const
Construct a communicator based on typeId.
Definition: communicatorfactory.cpp:104
CommunicatorFactory::filenameToCommunicatorId
virtual CommunicatorTypeId filenameToCommunicatorId(const XsString &filename) const =0
Match a filename to a communicator.
CommunicatorFactory::CommunicatorTypeId
unsigned int CommunicatorTypeId
The typedef of the communicator type ID.
Definition: communicatorfactory.h:98
Communicator
A base struct for a communication interface.
Definition: communicator.h:95
CommunicatorFactory::~CommunicatorFactory
virtual ~CommunicatorFactory()
Destory the factory.
Definition: communicatorfactory.cpp:75
compat.h
CommunicatorFactory::ConstructorsMap
std::map< CommunicatorTypeId, std::pair< CommunicatorConstructFunc, PortInfoMatchFunc > > ConstructorsMap
The typedef of a map for a communicator type ID and constructors map.
Definition: communicatorfactory.h:128
XsPortInfo
Contains a descriptor for opening a communication port to an Xsens device.
Definition: xsportinfo.h:128
CommunicatorFactory::create
Communicator * create(const XsPortInfo &portInfo) const
Create a communicator based on a port info.
Definition: communicatorfactory.cpp:88
CommunicatorFactory::constructors
ConstructorsMap const & constructors() const
Definition: communicatorfactory.h:131
CommunicatorFactory::PortInfoMatchFunc
bool(* PortInfoMatchFunc)(const XsPortInfo &)
The typedef of the port info match function.
Definition: communicatorfactory.h:104
CommunicatorFactory::CommunicatorFactory
CommunicatorFactory()
Create the factory.
Definition: communicatorfactory.cpp:69
XsString
A 0-terminated managed string of characters.
CommunicatorFactory::registerType
bool registerType(CommunicatorTypeId typeId, CommunicatorConstructFunc constructFunc, PortInfoMatchFunc matchFunc)
Register a communicator type with the factory.
Definition: communicatorfactory.cpp:81


xsens_mti_driver
Author(s):
autogenerated on Sun Sep 3 2023 02:43:20