Passed
Push — master ( d00047...c0d95e )
by Camilo
02:17
created

Publish::completePossibleIncompleteMessage()   A

Complexity

Conditions 2
Paths 2

Size

Total Lines 17
Code Lines 12

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 0
CRAP Score 6

Importance

Changes 0
Metric Value
dl 0
loc 17
ccs 0
cts 12
cp 0
rs 9.4285
c 0
b 0
f 0
cc 2
eloc 12
nc 2
nop 2
crap 6
1
<?php
2
3
declare(strict_types=1);
4
5
namespace unreal4u\MQTT\Protocol;
6
7
use unreal4u\MQTT\Application\EmptyReadableResponse;
8
use unreal4u\MQTT\DataTypes\Message;
9
use unreal4u\MQTT\DataTypes\PacketIdentifier;
10
use unreal4u\MQTT\DataTypes\Topic;
11
use unreal4u\MQTT\DataTypes\QoSLevel;
12
use unreal4u\MQTT\Internals\ClientInterface;
13
use unreal4u\MQTT\Internals\PacketIdentifierFunctionality;
14
use unreal4u\MQTT\Internals\ProtocolBase;
15
use unreal4u\MQTT\Internals\ReadableContent;
16
use unreal4u\MQTT\Internals\ReadableContentInterface;
17
use unreal4u\MQTT\Internals\WritableContent;
18
use unreal4u\MQTT\Internals\WritableContentInterface;
19
use unreal4u\MQTT\Utilities;
20
21
/**
22
 * A PUBLISH Control Packet is sent from a Client to a Server or vice-versa to transport an Application Message.
23
 *
24
 * @see http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc398718037
25
 */
26
final class Publish extends ProtocolBase implements ReadableContentInterface, WritableContentInterface
27
{
28
    use ReadableContent, WritableContent, PacketIdentifierFunctionality;
29
30
    const CONTROL_PACKET_VALUE = 3;
31
32
    /**
33
     * Contains the message to be sent
34
     * @var Message
35
     */
36
    private $message;
37
38
    /**
39
     * Flag to check whether a message is a redelivery (DUP flag)
40
     * @see http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc398718038
41
     * @var bool
42
     */
43
    public $isRedelivery = false;
44
45
    /**
46
     * @return string
47
     * @throws \unreal4u\MQTT\Exceptions\InvalidQoSLevel
48
     * @throws \unreal4u\MQTT\Exceptions\MissingTopicName
49
     * @throws \OutOfRangeException
50
     * @throws \InvalidArgumentException
51
     */
52 4
    public function createVariableHeader(): string
53
    {
54 4
        if ($this->message === null) {
55 1
            throw new \InvalidArgumentException('You must at least provide a message object with a topic name');
56
        }
57
58 3
        $bitString = $this->createUTF8String($this->message->getTopicName());
59
        // Reset the special flags should the object be reused with another message
60 3
        $this->specialFlags = 0;
61
62 3
        if ($this->isRedelivery) {
63
            $this->logger->debug('Activating redelivery bit');
64
            // DUP flag: if the message is a re-delivery, mark it as such
65
            $this->specialFlags |= 8;
66
        }
67
68
        // Check QoS level and perform the corresponding actions
69 3
        if ($this->message->getQoSLevel() !== 0) {
70
            // 0 for QoS lvl2 for QoS lvl1 and 4 for QoS lvl2
71 2
            $this->specialFlags |= ($this->message->getQoSLevel() * 2);
72 2
            $bitString .= $this->getPacketIdentifierBinaryRepresentation();
73 2
            $this->logger->debug(sprintf('Activating QoS level %d bit', $this->message->getQoSLevel()), [
74 2
                'specialFlags' => $this->specialFlags,
75
            ]);
76
        }
77
78 3
        if ($this->message->isRetained()) {
79
            // RETAIN flag: should the server retain the message?
80 1
            $this->specialFlags |= 1;
81 1
            $this->logger->debug('Activating retain flag', ['specialFlags' => $this->specialFlags]);
82
        }
83
84 3
        $this->logger->info('Variable header created', ['specialFlags' => $this->specialFlags]);
85
86 3
        return $bitString;
87
    }
88
89
    /**
90
     * @return string
91
     * @throws \unreal4u\MQTT\Exceptions\MissingTopicName
92
     * @throws \unreal4u\MQTT\Exceptions\MessageTooBig
93
     * @throws \InvalidArgumentException
94
     */
95 2
    public function createPayload(): string
96
    {
97 2
        if ($this->message === null) {
98 1
            throw new \InvalidArgumentException('A message must be set before publishing');
99
        }
100 1
        return $this->message->getPayload();
101
    }
102
103
    /**
104
     * QoS level 0 does not have to wait for a answer, so return false. Any other QoS level returns true
105
     * @return bool
106
     * @throws \unreal4u\MQTT\Exceptions\InvalidQoSLevel
107
     */
108 2
    public function shouldExpectAnswer(): bool
109
    {
110 2
        $shouldExpectAnswer = !($this->message->getQoSLevel() === 0);
111 2
        $this->logger->debug('Checking whether we should expect an answer or not', [
112 2
            'shouldExpectAnswer' => $shouldExpectAnswer,
113
        ]);
114 2
        return $shouldExpectAnswer;
115
    }
116
117 2
    public function expectAnswer(string $data, ClientInterface $client): ReadableContentInterface
118
    {
119 2
        switch ($this->message->getQoSLevel()) {
120 2
            case 1:
121 1
                $pubAck = new PubAck($this->logger);
122 1
                $pubAck->instantiateObject($data, $client);
123 1
                return $pubAck;
124 1
            case 2:
125
                $pubRec = new PubRec($this->logger);
126
                $pubRec->instantiateObject($data, $client);
127
                return $pubRec;
128 1
            case 0:
129
            default:
130 1
                return new EmptyReadableResponse($this->logger);
131
        }
132
    }
133
134
    /**
135
     * Sets the to be sent message
136
     *
137
     * @param Message $message
138
     * @return WritableContentInterface
139
     */
140 7
    public function setMessage(Message $message): WritableContentInterface
141
    {
142 7
        $this->message = $message;
143 7
        return $this;
144
    }
145
146
    /**
147
     * Gets the set message
148
     *
149
     * @return Message
150
     */
151
    public function getMessage(): Message
152
    {
153
        return $this->message;
154
    }
155
156
    /**
157
     * Sets several bits and pieces from the first byte of the fixed header for the Publish packet
158
     *
159
     * @param int $firstByte
160
     * @param QoSLevel $qoSLevel
161
     * @return Publish
162
     * @throws \unreal4u\MQTT\Exceptions\InvalidQoSLevel
163
     */
164
    private function analyzeFirstByte(int $firstByte, QoSLevel $qoSLevel): Publish
165
    {
166
        $this->logger->debug('Analyzing first byte', [sprintf('%08d', decbin($firstByte))]);
167
        // Retained bit is bit 0 of first byte
168
        $this->message->setRetainFlag(false);
169
        if ($firstByte & 1) {
170
            $this->logger->debug('Setting retain flag to true');
171
            $this->message->setRetainFlag(true);
172
        }
173
        // QoS level are the last bits 2 & 1 of the first byte
174
        $this->message->setQoSLevel($qoSLevel);
175
176
        // Duplicate message must be checked only on QoS > 0, else set it to false
177
        $this->isRedelivery = false;
178
        if ($firstByte & 8 && $this->message->getQoSLevel() !== 0) {
179
            // Is a duplicate is always bit 3 of first byte
180
            $this->isRedelivery = true;
181
            $this->logger->debug('Setting redelivery bit');
182
        }
183
184
        return $this;
185
    }
186
187
    /**
188
     * Finds out the QoS level in a fixed header for the Publish object
189
     *
190
     * @param int $bitString
191
     * @return QoSLevel
192
     * @throws \unreal4u\MQTT\Exceptions\InvalidQoSLevel
193
     */
194
    private function determineIncomingQoSLevel(int $bitString): QoSLevel
195
    {
196
        // Strange operation, why? Because 4 == QoS lvl2; 2 == QoS lvl1, 0 == QoS lvl0
197
        $incomingQoSLevel = ($bitString & 4) / 2;
198
        $this->logger->debug('Setting QoS level', ['incomingQoSLevel' => $incomingQoSLevel]);
199
        return new QoSLevel($incomingQoSLevel);
200
    }
201
202
    /**
203
     * Gets the full message in case this object needs to
204
     *
205
     * @param string $rawMQTTHeaders
206
     * @param ClientInterface $client
207
     * @return string
208
     * @throws \OutOfBoundsException
209
     * @throws \InvalidArgumentException
210
     * @throws \unreal4u\MQTT\Exceptions\MessageTooBig
211
     * @throws \unreal4u\MQTT\Exceptions\InvalidQoSLevel
212
     */
213
    private function completePossibleIncompleteMessage(string $rawMQTTHeaders, ClientInterface $client): string
214
    {
215
        if (\strlen($rawMQTTHeaders) === 1) {
216
            $this->logger->debug('Only one incoming byte, retrieving rest of size and the full payload');
217
            $restOfBytes = $client->readBrokerData(1);
218
            $payload = $client->readBrokerData(\ord($restOfBytes));
219
        } else {
220
            $this->logger->debug('More than 1 byte detected, calculating and retrieving the rest');
221
            $restOfBytes = $rawMQTTHeaders{1};
222
            $payload = substr($rawMQTTHeaders, 2);
223
            $exactRest = \ord($restOfBytes) - \strlen($payload);
224
            $payload .= $client->readBrokerData($exactRest);
225
            $rawMQTTHeaders = $rawMQTTHeaders{0};
226
        }
227
228
        // $rawMQTTHeaders may be redefined
229
        return $rawMQTTHeaders . $restOfBytes . $payload;
230
    }
231
232
    /**
233
     * Will perform sanity checks and fill in the Readable object with data
234
     * @param string $rawMQTTHeaders
235
     * @param ClientInterface $client
236
     * @return ReadableContentInterface
237
     * @throws \unreal4u\MQTT\Exceptions\MessageTooBig
238
     * @throws \OutOfBoundsException
239
     * @throws \unreal4u\MQTT\Exceptions\InvalidQoSLevel
240
     * @throws \InvalidArgumentException
241
     * @throws \OutOfRangeException
242
     */
243
    public function fillObject(string $rawMQTTHeaders, ClientInterface $client): ReadableContentInterface
244
    {
245
        $rawMQTTHeaders = $this->completePossibleIncompleteMessage($rawMQTTHeaders, $client);
246
        #$this->logger->debug('complete headers', ['header' => str2bin($rawMQTTHeaders)]);
247
248
        // Topic size is always the 3rd byte
249
        $firstByte = \ord($rawMQTTHeaders{0});
250
        $topicSize = \ord($rawMQTTHeaders{3});
251
        $qosLevel = $this->determineIncomingQoSLevel($firstByte);
252
253
        $messageStartPosition = 4;
254
        if ($qosLevel->getQoSLevel() > 0) {
255
            $this->logger->debug('QoS level above 0, shifting message start position and getting packet identifier');
256
            // [2 (fixed header) + 2 (topic size) + $topicSize] marks the beginning of the 2 packet identifier bytes
257
            $this->setPacketIdentifier(new PacketIdentifier(Utilities::convertBinaryStringToNumber(
258
                $rawMQTTHeaders{4 + $topicSize} . $rawMQTTHeaders{5 + $topicSize}
259
            )));
260
            $this->logger->debug('Determined packet identifier', [
261
                'PI' => $this->getPacketIdentifier(),
262
                'firstBit' => \ord($rawMQTTHeaders{4 + $topicSize}),
263
                'secondBit' => \ord($rawMQTTHeaders{5 + $topicSize})
264
            ]);
265
            $messageStartPosition += 2;
266
        }
267
268
        // At this point $rawMQTTHeaders will be always 1 byte long, initialize a Message object with dummy data for now
269
        $this->message = new Message(
270
        // Save to assume a constant here: first 2 bytes will always be fixed header, next 2 bytes are topic size
271
            substr($rawMQTTHeaders, $messageStartPosition + $topicSize),
272
            new Topic(substr($rawMQTTHeaders, 4, $topicSize))
273
        );
274
        $this->analyzeFirstByte(\ord($rawMQTTHeaders{0}), $qosLevel);
275
276
        $this->logger->debug('Determined headers', [
277
            'topicSize' => $topicSize,
278
            'QoSLevel' => $this->message->getQoSLevel(),
279
            'isDuplicate' => $this->isRedelivery,
280
            'isRetained' => $this->message->isRetained(),
281
            'packetIdentifier' => $this->packetIdentifier->getPacketIdentifierValue(),
282
        ]);
283
284
285
        return $this;
286
    }
287
288
    /**
289
     * @inheritdoc
290
     * @throws \unreal4u\MQTT\Exceptions\InvalidQoSLevel
291
     * @throws \unreal4u\MQTT\Exceptions\ServerClosedConnection
292
     * @throws \unreal4u\MQTT\Exceptions\NotConnected
293
     * @throws \unreal4u\MQTT\Exceptions\Connect\NoConnectionParametersDefined
294
     */
295
    public function performSpecialActions(ClientInterface $client, WritableContentInterface $originalRequest): bool
296
    {
297
        $qosLevel = $this->message->getQoSLevel();
298
        if ($qosLevel === 0) {
299
            $this->logger->debug('No response needed', ['qosLevel', $qosLevel]);
300
        } else {
301
            if ($qosLevel === 1) {
302
                $this->logger->debug('Responding with PubAck', ['qosLevel' => $qosLevel]);
303
                $client->processObject($this->composePubAckAnswer());
304
            } elseif ($qosLevel === 2) {
305
                $this->logger->debug('Responding with PubRec', ['qosLevel' => $qosLevel]);
306
                $client->processObject($this->composePubRecAnswer());
307
            }
308
        }
309
310
        return true;
311
    }
312
313
    private function composePubRecAnswer(): PubRec
314
    {
315
        $pubRec = new PubRec($this->logger);
316
        $pubRec->setPacketIdentifier($this->packetIdentifier);
317
        return $pubRec;
318
    }
319
320
    /**
321
     * Composes a PubAck answer with the same packetIdentifier as what we received
322
     * @return PubAck
323
     */
324
    private function composePubAckAnswer(): PubAck
325
    {
326
        $pubAck = new PubAck($this->logger);
327
        $pubAck->setPacketIdentifier($this->packetIdentifier);
328
        return $pubAck;
329
    }
330
331
    /**
332
     * PUBLISH packet is the exception to the rule: it is not started on base of a packet that gets sent by us
333
     */
334
    public function getOriginControlPacket(): int
335
    {
336
        return 0;
337
    }
338
}
339