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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
|
/*
* This file is part of rasdaman community.
*
* Rasdaman community is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Rasdaman community is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with rasdaman community. If not, see <http://www.gnu.org/licenses/>.
*
* Copyright 2003, 2004, 2005, 2006, 2007, 2008, 2009 Peter Baumann /
rasdaman GmbH.
*
* For more information please see <http://www.rasdaman.org>
* or contact Peter Baumann via <baumann@rasdaman.com>.
*/
// -*-C++-*- (for Emacs)
/*************************************************************
*
*
* PURPOSE:
* The Blobtile class is used to store the tiles in the database.
*
*
* COMMENTS:
*
************************************************************/
#ifndef _BLOBTILE_HH_
#define _BLOBTILE_HH_
class OId;
class r_Error;
#include "dbtile.hh"
#include "raslib/mddtypes.hh"
//@ManMemo: Module: {\bf relblobif}.
/*@Doc:
BLOBTile is the persistent class for storing the contents of MDD tiles
in the database. Each instance represents the contents of a tile of a MDD Object
from the database. BLOBTiles are just arrays of unsigned characters.
In main memory they are encapsulated in the class \Ref{PersTile}.
At the moment a BLOBTile is loaded into main memory, when it is
accessed the first time. This usually happens, when the RasDaMan DBMS
accesses the contents of a \Ref{PersTile}.
{\bf Interdependencies}
BLOBTile is an interface class with the base DBMS. It is, therefore,
highly dependent on the base DBMS used.
*/
/**
* \defgroup Relblobifs Relblobif Classes
*/
/**
* \ingroup Relblobifs
*/
class BLOBTile : public DBTile
{
public:
//@Man: constructors
//@{
BLOBTile(r_Data_Format dataformat = r_Array);
/*@Doc:
constructs a new empty BLOBTile and gets an id for it.
*/
BLOBTile(const OId& BlobId) throw (r_Error);
/*@Doc:
constructs a BlobTile out of the database
*/
BLOBTile(r_Bytes newSize, char c = 0, r_Data_Format dataformat = r_Array);
/*@Doc:
constructs a new BLOBTile of size newSize filled with c.
*/
BLOBTile(r_Bytes newSize, r_Bytes patSize, const char* pat, r_Data_Format dataformat = r_Array);
/*@Doc:
Constructs a new BLOB Tile of size newSize filled with the repeated
char array pat of size patSize. If after filling some chars are
left, they are filled with 0
*/
/*@ManMemo: constructs a new BLOB Tile with the char array newCells
with newSize elements as contents. */
BLOBTile(r_Bytes newSize, const char* newCells, r_Data_Format dataformat = r_Array);
/*@Doc:
constructs a new BLOBTile of size newSize filled with the contents of newCells.
*/
BLOBTile(r_Bytes newSize, const char* newCells, r_Data_Format dataformat, const OId& myOId);
/*@Doc:
constructs a new BLOBTile of size newSize filled with the contents of newCells.
the oid will be assigned to this blob. used by regular computed index.
*/
BLOBTile(const OId& BlobId, r_Bytes newSize, r_Data_Format newFmt);
/*@Doc:
constructs a new BLOBTile of size newSize filled with zeros.
the tile will think it is not modified and also not in the db but persistent.
this is used by the rc index.
*/
//@}
virtual ~BLOBTile();
/*@Doc:
validates the object. deletes it cells.
*/
static void kill(const OId& target, unsigned int range = 0);
/*@Doc:
delete a blobtile without loading it first into memory.
is used by the indexes.
delete the blobtile and range consecutive tiles.
*/
static r_Bytes BLOBBufferLength;
/*@Doc:
info on the length of the BLOBBuffer
*/
protected:
virtual void updateInDb() throw (r_Error);
/*@Doc:
update the contents of a Tile in the db
*/
virtual void insertInDb() throw (r_Error);
/*@Doc:
inserts the Blob into the db.
*/
virtual void readFromDb() throw (r_Error);
/*@Doc:
read blob from db into blobtile
*/
virtual void deleteFromDb() throw (r_Error);
/*@Doc:
deletes a blob from TILES, sets size to 0 and flags to -1
*/
private:
static char* BLOBBuffer;
/*@Doc:
for writing into the DB. currently not needed by oracle.
*/
};
#endif
|
