blob: e318b3c1f60d134879dda0630812c358917330c7 (
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
|
/*
* Copyright (C) 2007-2012 Xagasoft, All rights reserved.
*
* This file is part of the libgats library and is released under the
* terms of the license contained in the file LICENSE.
*/
#ifndef GATS_STREAM_H
#define GATS_STREAM_H
#include <bu/stream.h>
#include <bu/queuebuf.h>
namespace Gats
{
class Object;
class GatsStream
{
public:
GatsStream( Bu::Stream &rStream );
virtual ~GatsStream();
/**
* Read an object packet from the assosiated stream. This will make
* every effort to only read exactly enough data to describe one packet,
* in case you want to do other things with your stream. It will
* automatically skip NULL byte spacing between packets, which makes
* a convinient padding method for encrypted data streams. Since
* sizing information is available in the packet header exact amounts
* of data can be read, however this function doesn't assume that it
* can read the entire object in one operation. If it fails to read
* a complete packet in one call, it will keep the data it's read so
* far buffered and return NULL, ready for another attempt. You can
* use the function hasReadBuffer() to deterimne if readObject()
* has read part of an object packet or not. If readObject returns
* non-null then hasReadBuffer should return false on it's next call.
*/
Gats::Object *readObject();
/**
* Write an object
*/
void writeObject( Gats::Object *pObject );
/**
* Tells you if there is data still in the read buffer, i.e. that a
* packet is part way through being read. If readObject has returned
* non-null in the most recent call, this should always be false.
*/
bool hasReadBuffer() { return qbRead.getSize() > 0; }
int getReadBufferSize() { return qbRead.getSize(); }
private:
bool skipReadNulls();
private:
Bu::Stream &rStream;
Bu::QueueBuf qbRead;
};
};
#endif
|
