libdap Updated for version 3.21.1
libdap4 is an implementation of OPeNDAP's DAP protocol.
Byte.cc
Go to the documentation of this file.
1
2// -*- mode: c++; c-basic-offset:4 -*-
3
4// This file is part of libdap, A C++ implementation of the OPeNDAP Data
5// Access Protocol.
6
7// Copyright (c) 2002,2003 OPeNDAP, Inc.
8// Author: James Gallagher <jgallagher@opendap.org>
9//
10// This library is free software; you can redistribute it and/or
11// modify it under the terms of the GNU Lesser General Public
12// License as published by the Free Software Foundation; either
13// version 2.1 of the License, or (at your option) any later version.
14//
15// This library is distributed in the hope that it will be useful,
16// but WITHOUT ANY WARRANTY; without even the implied warranty of
17// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18// Lesser General Public License for more details.
19//
20// You should have received a copy of the GNU Lesser General Public
21// License along with this library; if not, write to the Free Software
22// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
23//
24// You can contact OPeNDAP, Inc. at PO Box 112, Saunderstown, RI. 02874-0112.
25
26// (c) COPYRIGHT URI/MIT 1994-1999
27// Please read the full copyright statement in the file COPYRIGHT_URI.
28//
29// Authors:
30// jhrg,jimg James Gallagher <jgallagher@gso.uri.edu>
31
32// Implementation for Byte.
33//
34// jhrg 9/7/94
35
36// #define DODS_DEBUG
37
38#include "config.h"
39
40#include <sstream>
41
42#include "Byte.h" // synonymous with UInt8 and Char
43#include "Float32.h"
44#include "Float64.h"
45#include "Int16.h"
46#include "Int32.h"
47#include "Int64.h"
48#include "Int8.h"
49#include "Str.h"
50#include "UInt16.h"
51#include "UInt32.h"
52#include "UInt64.h"
53#include "Url.h"
54
55#include "DDS.h"
56#include "Marshaller.h"
57#include "Operators.h"
58#include "UnMarshaller.h"
59
60#include "D4Attributes.h"
61#include "D4StreamMarshaller.h"
63#include "DMR.h"
64
65#include "DapIndent.h"
66#include "InternalErr.h"
67#include "debug.h"
68#include "dods-limits.h"
69#include "parser.h"
70#include "util.h"
71
72using std::cerr;
73using std::endl;
74
75namespace libdap {
76
86Byte::Byte(const string &n) : BaseType(n, dods_byte_c), d_buf(0) {}
87
98Byte::Byte(const string &n, const string &d) : BaseType(n, d, dods_byte_c), d_buf(0) {}
99
100Byte::Byte(const Byte &copy_from) : BaseType(copy_from) { d_buf = copy_from.d_buf; }
101
102BaseType *Byte::ptr_duplicate() { return new Byte(*this); }
103
105 if (this == &rhs)
106 return *this;
108 d_buf = rhs.d_buf;
109 return *this;
110}
111
122bool Byte::serialize(ConstraintEvaluator &eval, DDS &dds, Marshaller &m, bool ce_eval) {
123#if USE_LOCAL_TIMEOUT_SCHEME
124 dds.timeout_on();
125#endif
126 if (!read_p())
127 read(); // read() throws Error and InternalErr
128
129 if (ce_eval && !eval.eval_selection(dds, dataset()))
130 return true;
131#if USE_LOCAL_TIMEOUT_SCHEME
132 dds.timeout_off();
133#endif
134 m.put_byte(d_buf);
135
136 return true;
137}
138
143 um.get_byte(d_buf);
144
145 return false;
146}
147
148void Byte::compute_checksum(Crc32 &checksum) { checksum.AddData(reinterpret_cast<uint8_t *>(&d_buf), sizeof(d_buf)); }
149
158void Byte::serialize(D4StreamMarshaller &m, DMR &, /*ConstraintEvaluator &,*/ bool) {
159 if (!read_p())
160 read(); // read() throws Error
161
162 m.put_byte(d_buf);
163}
164
166
172unsigned int Byte::val2buf(void *val, bool) {
173 // Jose Garcia
174 // This method is public therefore, and I believe it has being designed
175 // to be use by read which must be implemented on the surrogate library,
176 // thus if the pointer val is NULL, is an Internal Error.
177 if (!val)
178 throw InternalErr("the incoming pointer does not contain any data.");
179
180 d_buf = *(dods_byte *)val;
181
182 return width();
183}
184
185unsigned int Byte::buf2val(void **val) {
186 // Jose Garcia
187 // The same comment justifying throwing an Error in val2buf applies here.
188 if (!val)
189 throw InternalErr("NULL pointer");
190
191 if (!*val)
192 *val = new dods_byte;
193
194 *(dods_byte *)*val = d_buf;
195
196 return width();
197}
198
204 d_buf = value;
205 set_read_p(true);
206
207 return true;
208}
209
212dods_byte Byte::value() const { return d_buf; }
213
214void Byte::print_val(FILE *out, string space, bool print_decl_p) {
215 ostringstream oss;
216 print_val(oss, space, print_decl_p);
217 fwrite(oss.str().data(), sizeof(char), oss.str().length(), out);
218}
219
220void Byte::print_val(ostream &out, string space, bool print_decl_p) {
221 if (print_decl_p) {
222 print_decl(out, space, false);
223 out << " = " << (int)d_buf << ";\n";
224 } else
225 out << (int)d_buf;
226}
227
228bool Byte::ops(BaseType *b, int op) {
229
230 // Extract the Byte arg's value.
231 if (!read_p() && !read()) {
232 // Jose Garcia
233 // Since the read method is virtual and implemented outside
234 // libdap++ if we cannot read the data that is the problem
235 // of the user or of whoever wrote the surrogate library
236 // implementing read therefore it is an internal error.
237 throw InternalErr("This value not read!");
238 }
239 // Extract the second arg's value.
240 if (!b || !(b->read_p() || b->read())) {
241 // Jose Garcia
242 // Since the read method is virtual and implemented outside
243 // libdap++ if we cannot read the data that is the problem
244 // of the user or of whoever wrote the surrogate library
245 // implementing read therefore it is an internal error.
246 throw InternalErr("This value not read!");
247 }
248
249 // By using the same operator code numbers for both the DAP2 and DAP4
250 // parser/evaluator we can use the same evaluation code.
251 return d4_ops(b, op);
252}
253
257bool Byte::d4_ops(BaseType *b, int op) {
258 switch (b->type()) {
259 case dods_int8_c:
260 return Cmp<dods_byte, dods_int8>(op, d_buf, static_cast<Int8 *>(b)->value());
261 case dods_byte_c:
262 return Cmp<dods_byte, dods_byte>(op, d_buf, static_cast<Byte *>(b)->value());
263 case dods_int16_c:
264 return Cmp<dods_byte, dods_int16>(op, d_buf, static_cast<Int16 *>(b)->value());
265 case dods_uint16_c:
266 return Cmp<dods_byte, dods_uint16>(op, d_buf, static_cast<UInt16 *>(b)->value());
267 case dods_int32_c:
268 return Cmp<dods_byte, dods_int32>(op, d_buf, static_cast<Int32 *>(b)->value());
269 case dods_uint32_c:
270 return Cmp<dods_byte, dods_uint32>(op, d_buf, static_cast<UInt32 *>(b)->value());
271 case dods_int64_c:
272 return Cmp<dods_byte, dods_int64>(op, d_buf, static_cast<Int64 *>(b)->value());
273 case dods_uint64_c:
274 return Cmp<dods_byte, dods_uint64>(op, d_buf, static_cast<UInt64 *>(b)->value());
275 case dods_float32_c:
276 return Cmp<dods_byte, dods_float32>(op, d_buf, static_cast<Float32 *>(b)->value());
277 case dods_float64_c:
278 return Cmp<dods_byte, dods_float64>(op, d_buf, static_cast<Float64 *>(b)->value());
279 case dods_str_c:
280 case dods_url_c:
281 throw Error(malformed_expr, "Relational operators can only compare compatible types (number, string).");
282 default:
283 throw Error(malformed_expr, "Relational operators only work with scalar types.");
284 }
285}
286
302std::vector<BaseType *> *Byte::transform_to_dap2(AttrTable *parent_attr_table) {
303 DBG(cerr << __func__ << "() - BEGIN" << endl;);
304 vector<BaseType *> *vec = BaseType::transform_to_dap2(parent_attr_table);
305 if (vec->size() != 1) {
306 ostringstream oss;
307 oss << __func__ << "() - Something Bad Happened. This transform should produce only ";
308 oss << " a single BaseType yet it produced " << vec->size();
309 throw Error(internal_error, oss.str());
310 }
311
312 BaseType *dest = (*vec)[0];
313 DBG(cerr << __func__ << "() - type(): " << type() << endl;);
314 DBG(cerr << __func__ << "() - dest->type(): " << dest->type() << endl;);
315
316 // This little bit of magic ensures that the DAP4 shenanigans
317 // in which UInt8, Char , and Byte are synonymous is reduced
318 // to the DAP2 simplicity of Byte.
319 if (type() != dods_byte_c) {
320 dest->set_type(dods_byte_c);
321 }
322 DBG(dest->get_attr_table().print(cerr););
323
324 DBG(cerr << __func__ << "() - END" << endl;);
325 return vec;
326}
327
336void Byte::dump(ostream &strm) const {
337 strm << DapIndent::LMarg << "Byte::dump - (" << (void *)this << ")" << endl;
339 BaseType::dump(strm);
340 strm << DapIndent::LMarg << "value: " << d_buf << endl;
342}
343
344} // namespace libdap
#define internal_error
Internal server error (500)
Definition Error.h:63
#define malformed_expr
(400)
Definition Error.h:66
Definition crc.h:43
void AddData(const uint8_t *pData, const uint32_t length)
Definition crc.h:64
Contains the attributes for a dataset.
Definition AttrTable.h:150
virtual void print(FILE *out, string pad=" ", bool dereference=false)
Prints the attribute table.
BaseType & operator=(const BaseType &rhs)
Definition BaseType.cc:159
virtual bool read()
Read data into a local buffer.
Definition BaseType.cc:775
virtual AttrTable & get_attr_table()
Definition BaseType.cc:498
virtual void print_decl(FILE *out, string space=" ", bool print_semi=true, bool constraint_info=false, bool constrained=false)
Print an ASCII representation of the variable structure.
Definition BaseType.cc:868
virtual bool read_p()
Has this variable been read?
Definition BaseType.cc:410
virtual void set_read_p(bool state)
Sets the value of the read_p property.
Definition BaseType.cc:442
virtual string dataset() const
Returns the name of the dataset used to create this instance.
Definition BaseType.cc:326
void dump(ostream &strm) const override
dumps information about this object
Definition BaseType.cc:269
BaseType(const string &n, const Type &t, bool is_dap4=false)
The BaseType constructor.
Definition BaseType.cc:124
virtual void set_type(const Type &t)
Sets the type of the class instance.
Definition BaseType.cc:332
virtual Type type() const
Returns the type of the class instance.
Definition BaseType.cc:329
virtual std::vector< BaseType * > * transform_to_dap2(AttrTable *parent_attr_table)
DAP4 to DAP2 transform.
Definition BaseType.cc:240
void print_val(FILE *out, string space="", bool print_decl_p=true) override
Prints the value of the variable.
Definition Byte.cc:214
bool d4_ops(BaseType *b, int op) override
Definition Byte.cc:257
Byte & operator=(const Byte &rhs)
Definition Byte.cc:104
dods_byte d_buf
Definition Byte.h:61
BaseType * ptr_duplicate() override
Definition Byte.cc:102
Byte(const string &n)
The Byte constructor.
Definition Byte.cc:86
void compute_checksum(Crc32 &checksum) override
include the data for this variable in the checksum DAP4 includes a checksum with every data response....
Definition Byte.cc:148
bool deserialize(UnMarshaller &um, DDS *, bool) override
Deserialize the char on stdin and put the result in _BUF.
Definition Byte.cc:142
void dump(ostream &strm) const override
dumps information about this object
Definition Byte.cc:336
bool ops(BaseType *b, int op) override
Evaluate relational operators.
Definition Byte.cc:228
virtual dods_byte value() const
Definition Byte.cc:212
unsigned int width(bool=false) const override
How many bytes does this variable use Return the number of bytes of storage this variable uses....
Definition Byte.h:73
unsigned int val2buf(void *val, bool reuse=false) override
Definition Byte.cc:172
virtual bool set_value(const dods_byte value)
Definition Byte.cc:203
std::vector< BaseType * > * transform_to_dap2(AttrTable *parent_attr_table) override
DAP4 to DAP2 transform.
Definition Byte.cc:302
unsigned int buf2val(void **val) override
Reads the class data.
Definition Byte.cc:185
bool serialize(ConstraintEvaluator &eval, DDS &dds, Marshaller &m, bool ce_eval) override
Definition Byte.cc:122
Evaluate a constraint expression.
bool eval_selection(DDS &dds, const std::string &dataset)
Evaluate a boolean-valued constraint expression. This is main method for the evaluator and is called ...
Marshaller that knows how to marshal/serialize dap data objects to a C++ iostream using DAP4's receiv...
virtual void put_byte(dods_byte val)
Read data from the stream made by D4StreamMarshaller.
virtual void get_byte(dods_byte &val)
void timeout_off()
Definition DDS.cc:695
void timeout_on()
Definition DDS.cc:687
static ostream & LMarg(ostream &strm)
Definition DapIndent.cc:61
static void Indent()
Definition DapIndent.cc:44
static void UnIndent()
Definition DapIndent.cc:46
A class for error processing.
Definition Error.h:92
Holds a 32-bit floating point value.
Definition Float32.h:59
Holds a 64-bit (double precision) floating point value.
Definition Float64.h:58
Holds a 16-bit signed integer value.
Definition Int16.h:57
Holds a 32-bit signed integer.
Definition Int32.h:63
Holds a64-bit signed integer.
Definition Int64.h:48
Holds an 8-bit signed integer value.
Definition Int8.h:41
A class for software fault reporting.
Definition InternalErr.h:61
abstract base class used to marshal/serialize dap data objects
Definition Marshaller.h:50
virtual void put_byte(dods_byte val)=0
Holds an unsigned 16-bit integer.
Definition UInt16.h:55
Holds a 32-bit unsigned integer.
Definition UInt32.h:57
Holds a 64-bit unsigned integer.
Definition UInt64.h:47
abstract base class used to unmarshall/deserialize dap data objects
virtual void get_byte(dods_byte &val)=0
#define DBG(x)
Definition debug.h:58
top level DAP object to house generic methods
Definition AISConnect.cc:30
@ dods_uint32_c
Definition Type.h:100
@ dods_int16_c
Definition Type.h:97
@ dods_byte_c
Definition Type.h:96
@ dods_int32_c
Definition Type.h:99
@ dods_url_c
Definition Type.h:104
@ dods_int8_c
Definition Type.h:115
@ dods_float32_c
Definition Type.h:101
@ dods_int64_c
Definition Type.h:118
@ dods_uint64_c
Definition Type.h:119
@ dods_uint16_c
Definition Type.h:98
@ dods_float64_c
Definition Type.h:102
@ dods_str_c
Definition Type.h:103
bool Cmp(int op, T1 v1, T2 v2)
Definition Operators.h:52