summaryrefslogtreecommitdiffstats log msg author committer range
path: root/relblobif/blobtile.hh
blob: 04bba0470d28e4602e0a1a7ae572ba9d63739e7b (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 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 . * * Copyright 2003, 2004, 2005, 2006, 2007, 2008, 2009 Peter Baumann / rasdaman GmbH. * * For more information please see * or contact Peter Baumann via . */ // -*-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