protocolmanager.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 PROTOCOLMANAGER_H
66 #define PROTOCOLMANAGER_H
67 
68 #include "messagelocation.h"
69 #include "iprotocolmanager.h"
70 #include <list>
71 #include <memory>
72 #include "xsprotocoltype.h"
73 #include <memory>
74 
75 class IProtocolHandler;
76 struct Communicator;
77 struct XsByteArray;
78 struct XsMessage;
79 
80 
82 {
83 public:
84 
86  typedef std::shared_ptr<IProtocolHandler> value_type;
87 
89  typedef std::list<value_type> container_type;
90 
92  typedef container_type::const_iterator const_iterator;
93 
94  explicit ProtocolManager(Communicator const&);
95  virtual ~ProtocolManager() throw();
96 
97  int likelyMinimumMessageSize() const;
98 
99  const_iterator begin() const;
100  const_iterator end() const;
101  MessageLocation findMessage(XsProtocolType& type, const XsByteArray& raw) override;
102  XsMessage convertToMessage(XsProtocolType& type, MessageLocation& location, const XsByteArray& raw) override;
103  bool validateMessage(XsMessage const& message) const override;
104 
109  virtual value_type add(IProtocolHandler* handler);
110  virtual value_type find(XsProtocolType type);
111  virtual bool remove(XsProtocolType type);
112  virtual bool hasProtocol(XsProtocolType type) const;
113  virtual void clear();
114 
115 private:
117 
118  // mutable because the order of elements is optimized during findMessage to speedup future searches
119  // but the findMessage method is conceptually const
121 };
122 
123 #endif
ProtocolManager::clear
virtual void clear()
Clears the protocol handlers list.
Definition: protocolmanager.cpp:243
iprotocolmanager.h
XsByteArray
A list of uint8_t values.
ProtocolManager::m_communicator
Communicator const & m_communicator
Definition: protocolmanager.h:116
ProtocolManager::begin
const_iterator begin() const
Definition: protocolmanager.cpp:94
messagelocation.h
IProtocolManager
Interface class for protocol manager.
Definition: iprotocolmanager.h:75
ProtocolManager::container_type
std::list< value_type > container_type
A typedef for a container type.
Definition: protocolmanager.h:89
xsprotocoltype.h
Communicator
A base struct for a communication interface.
Definition: communicator.h:95
ProtocolManager::add
virtual value_type add(IProtocolHandler *handler)
Adds the protocol handler.
Definition: protocolmanager.cpp:228
ProtocolManager::findMessage
MessageLocation findMessage(XsProtocolType &type, const XsByteArray &raw) override
Searches for a raw message in a raw data.
Definition: protocolmanager.cpp:111
ProtocolManager::const_iterator
container_type::const_iterator const_iterator
A typedef for a const iterator.
Definition: protocolmanager.h:92
ProtocolManager::find
virtual value_type find(XsProtocolType type)
Searches the registered protocol handlers for a handler that matches the given protocol type and retu...
Definition: protocolmanager.cpp:202
IProtocolHandler
Interface class for protocol handlers.
Definition: iprotocolhandler.h:78
ProtocolManager::m_protocolHandlers
container_type m_protocolHandlers
Definition: protocolmanager.h:120
ProtocolManager::likelyMinimumMessageSize
int likelyMinimumMessageSize() const
Definition: protocolmanager.cpp:259
XsMessage
Structure for storing a single message.
Definition: xsmessage.h:202
ProtocolManager::value_type
std::shared_ptr< IProtocolHandler > value_type
A typedef for a value type.
Definition: protocolmanager.h:86
ProtocolManager::hasProtocol
virtual bool hasProtocol(XsProtocolType type) const
Definition: protocolmanager.cpp:216
ProtocolManager::validateMessage
bool validateMessage(XsMessage const &message) const override
Check a message for a validity.
Definition: protocolmanager.cpp:252
ProtocolManager::end
const_iterator end() const
Definition: protocolmanager.cpp:101
XsProtocolType
XsProtocolType
Protocol types (XsDevice::enableProtocol())
Definition: xsprotocoltype.h:72
ProtocolManager::ProtocolManager
ProtocolManager(Communicator const &)
Default constructor.
Definition: protocolmanager.cpp:83
ProtocolManager::convertToMessage
XsMessage convertToMessage(XsProtocolType &type, MessageLocation &location, const XsByteArray &raw) override
Converts raw data using location into a XsMessage object.
Definition: protocolmanager.cpp:163
ProtocolManager::~ProtocolManager
virtual ~ProtocolManager()
Definition: protocolmanager.cpp:88
ProtocolManager::remove
virtual bool remove(XsProtocolType type)
Removes a protocol handler of a specified type.
Definition: protocolmanager.cpp:176
MessageLocation
Stores the location of a message in a buffer using a start position and a size.
Definition: messagelocation.h:70
ProtocolManager
Supplies multi-protocol data stream parsing.
Definition: protocolmanager.h:81


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