libdap Updated for version 3.20.5
libdap4 is an implementation of OPeNDAP's DAP protocol.
DDS.h
1// -*- mode: c++; c-basic-offset:4 -*-
2
3// This file is part of libdap, A C++ implementation of the OPeNDAP Data
4// Access Protocol.
5
6// Copyright (c) 2002,2003 OPeNDAP, Inc.
7// Author: James Gallagher <jgallagher@opendap.org>
8//
9// This library is free software; you can redistribute it and/or
10// modify it under the terms of the GNU Lesser General Public
11// License as published by the Free Software Foundation; either
12// version 2.1 of the License, or (at your option) any later version.
13//
14// This library is distributed in the hope that it will be useful,
15// but WITHOUT ANY WARRANTY; without even the implied warranty of
16// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17// Lesser General Public License for more details.
18//
19// You should have received a copy of the GNU Lesser General Public
20// License along with this library; if not, write to the Free Software
21// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22//
23// You can contact OPeNDAP, Inc. at PO Box 112, Saunderstown, RI. 02874-0112.
24
25// (c) COPYRIGHT URI/MIT 1994-1999
26// Please read the full copyright statement in the file COPYRIGHT_URI.
27//
28// Authors:
29// jhrg,jimg James Gallagher <jgallagher@gso.uri.edu>
30
31// Provide access to the DDS. This class is used to parse DDS text files, to
32// produce a printed representation of the in-memory variable table, and to
33// update the table on a per-variable basis.
34//
35// jhrg 9/8/94
36
37#ifndef _dds_h
38#define _dds_h 1
39
40#include <cstdio>
41#include <iostream>
42#include <string>
43#include <vector>
44
45#ifndef _basetype_h
46#include "BaseType.h"
47#endif
48
49#ifndef _constructor_h
50#include "Constructor.h"
51#endif
52
53#ifndef base_type_factory_h
54#include "BaseTypeFactory.h"
55#endif
56
57#ifndef _das_h
58#include "DAS.h"
59#endif
60
61#ifndef A_DapObj_h
62#include "DapObj.h"
63#endif
64
65#if 0
66#ifndef KEYWORDS_H_
67#include "Keywords2.h"
68#endif
69#endif
70
71#ifndef XMLWRITER_H_
72#include "XMLWriter.h"
73#endif
74
75namespace libdap
76{
77
78bool has_dap2_attributes(BaseType *btp);
79bool has_dap2_attributes(AttrTable &a);
80
183class DDS : public DapObj
184{
185private:
186 BaseTypeFactory *d_factory;
187
188 string d_name; // The dataset d_name
189 string d_filename; // File d_name (or other OS identifier) for
190 string d_container_name; // d_name of container structure
191 Structure *d_container; // current container for container d_name
192 // dataset or part of dataset.
193
194 int d_dap_major; // The protocol major version number
195 int d_dap_minor; // ... and minor version number
196 string d_dap_version; // String version of the protocol
197 string d_request_xml_base;
198 string d_namespace;
199
200 AttrTable d_attr; // Global attributes.
201
202 vector<BaseType *> vars; // Variables at the top level
203
204 int d_timeout; // alarm time in seconds. If greater than
205 // zero, raise the alarm signal if more than
206 // d_timeout seconds are spent reading data.
207#if 0
208 Keywords d_keywords; // Holds keywords parsed from the CE
209#endif
210
211 long d_max_response_size; // In bytes...
212
213 friend class DDSTest;
214
215protected:
216 void duplicate(const DDS &dds);
217 BaseType *leaf_match(const string &name, BaseType::btp_stack *s = 0);
218 BaseType *exact_match(const string &name, BaseType::btp_stack *s = 0);
219
220public:
221 typedef std::vector<BaseType *>::const_iterator Vars_citer ;
222 typedef std::vector<BaseType *>::iterator Vars_iter ;
223 typedef std::vector<BaseType *>::reverse_iterator Vars_riter ;
224
225 DDS(BaseTypeFactory *factory, const string &name = "");
226 DDS(BaseTypeFactory *factory, const string &name, const string &version);
227 DDS(const DDS &dds);
228
229 virtual ~DDS();
230
231 DDS & operator=(const DDS &rhs);
232
233 virtual void transfer_attributes(DAS *das);
234
235 string get_dataset_name() const;
236 void set_dataset_name(const string &n);
237
243 {
244 return d_factory;
245 }
246
254 {
255 BaseTypeFactory *t = d_factory;
256 d_factory = factory;
257 return t;
258 }
259
260 virtual AttrTable &get_attr_table();
261
262 string filename() const;
263 void filename(const string &fn);
264
266 int get_dap_major() const { return d_dap_major; }
268 int get_dap_minor() const { return d_dap_minor; }
269
270 void set_dap_version(const string &version_string = "2.0");
271 string get_dap_version() const { return d_dap_version; }
272 string get_dmr_version() const { return "1.0"; }
273
275 void set_dap_major(int p);
277 void set_dap_minor(int p);
279 void set_dap_version(double d);
280
281#if 0
282 Keywords &get_keywords() {return d_keywords;}
283#endif
284
286 string get_request_xml_base() const { return d_request_xml_base; }
287
289 void set_request_xml_base(const string &xb) { d_request_xml_base = xb; }
290
292 string get_namespace() const { return d_namespace; }
293
295 void set_namespace(const string &ns) { d_namespace = ns; }
296
298 long get_response_limit() { return d_max_response_size; }
299
303 void set_response_limit(long size) { d_max_response_size = size * 1024; }
304
306 int get_request_size(bool constrained);
307
308 string container_name() ;
309 void container_name( const string &cn ) ;
311
312 void add_var(BaseType *bt);
313 void add_var_nocopy(BaseType *bt);
314
316 void del_var(const string &n);
317
318 BaseType *var(const string &n, BaseType::btp_stack &s);
319 BaseType *var(const string &n, BaseType::btp_stack *s = 0);
320 int num_var();
321
323 Vars_iter var_begin();
324#if 0
326 Vars_citer var_cbegin() const { return vars.cbegin(); }
327#endif
329 Vars_riter var_rbegin();
331 Vars_iter var_end();
332#if 0
334 Vars_citer var_cend() const { return vars.cend(); }
335#endif
337 Vars_riter var_rend();
339 Vars_iter get_vars_iter(int i);
341 BaseType *get_var_index(int i);
343 void insert_var(Vars_iter i, BaseType *ptr);
344 void insert_var_nocopy(Vars_iter i, BaseType *ptr);
346 void del_var(Vars_iter i);
348 void del_var(Vars_iter i1, Vars_iter i2);
349
355 void timeout_on();
356 void timeout_off();
357 void set_timeout(int t);
358 int get_timeout();
360
361 // These parse the DAP2 curly-brace document and make a C++ object.
362 void parse(string fname);
363 void parse(int fd);
364 void parse(FILE *in = stdin);
365
366 // These print the Binary object in either the curly-brace or XML reps
367 void print(FILE *out);
368 void print_constrained(FILE *out);
369 void print_xml(FILE *out, bool constrained, const string &blob = "");
370
371 // Same as above, but using C++ i/o streams
372 void print(ostream &out);
373 void print_constrained(ostream &out);
374 void print_xml(ostream &out, bool constrained, const string &blob = "");
375
376 // Print the XML using libxml2; the other print_xml methods use this impl.
377 void print_xml_writer(ostream &out, bool constrained, const string &blob = "");
378
379 // Print the DAP4 DMR 'object'
380 void print_dmr(ostream &out, bool constrained);
381
382 void print_das(ostream &out);
383 DAS *get_das();
384 void get_das(DAS *das);
385
386 void mark_all(bool state);
387 bool mark(const string &name, bool state);
388 bool check_semantics(bool all = false);
389
391
392 virtual void dump(ostream &strm) const ;
393};
394
395} // namespace libdap
396
397#endif // _dds_h
Contains the attributes for a dataset.
Definition: AttrTable.h:143
The basic data type for the DODS DAP types.
Definition: BaseType.h:118
Hold attribute data for a DAP2 dataset.
Definition: DAS.h:122
void set_dataset_name(const string &n)
Definition: DDS.cc:363
void set_dap_major(int p)
Definition: DDS.cc:404
void mark_all(bool state)
Definition: DDS.cc:1821
void print_dmr(ostream &out, bool constrained)
Print the DAP4 DMR object using a DDS.
Definition: DDS.cc:1649
Vars_riter var_rend()
Return a reverse iterator.
Definition: DDS.cc:817
void add_var_nocopy(BaseType *bt)
Adds the variable to the DDS.
Definition: DDS.cc:613
bool check_semantics(bool all=false)
Check the semantics of each of the variables represented in the DDS.
Definition: DDS.cc:1720
void set_namespace(const string &ns)
Set the namespace for this DDS/DDX object/response.
Definition: DDS.h:295
string filename() const
Definition: DDS.cc:387
virtual AttrTable & get_attr_table()
Definition: DDS.cc:372
void set_request_xml_base(const string &xb)
Definition: DDS.h:289
void set_response_limit(long size)
Definition: DDS.h:303
virtual void transfer_attributes(DAS *das)
Definition: DDS.cc:286
void set_dap_minor(int p)
Definition: DDS.cc:423
Vars_riter var_rbegin()
Return a reverse iterator.
Definition: DDS.cc:805
string get_namespace() const
Get the namespace associated with the DDS - likely set only by DDX responses.
Definition: DDS.h:292
int num_var()
Returns the number of variables in the DDS.
Definition: DDS.cc:873
Vars_iter get_vars_iter(int i)
Get an iterator.
Definition: DDS.cc:826
void print(FILE *out)
Print the entire DDS to the specified file.
Definition: DDS.cc:1023
BaseType * get_var_index(int i)
Get a variable.
Definition: DDS.cc:835
int get_request_size(bool constrained)
Get the estimated response size.
Definition: DDS.cc:565
BaseTypeFactory * set_factory(BaseTypeFactory *factory)
Definition: DDS.h:253
string get_dataset_name() const
Definition: DDS.cc:356
void del_var(const string &n)
Removes a variable from the DDS.
Definition: DDS.cc:636
void parse(string fname)
Parse a DDS from a file with the given d_name.
Definition: DDS.cc:942
BaseType * var(const string &n, BaseType::btp_stack &s)
Definition: DDS.cc:692
void print_xml(FILE *out, bool constrained, const string &blob="")
Definition: DDS.cc:1378
void insert_var(Vars_iter i, BaseType *ptr)
Insert a variable before the referenced element.
Definition: DDS.cc:845
bool mark(const string &name, bool state)
Mark the send_p flag of the named variable to state.
Definition: DDS.cc:1764
int get_dap_minor() const
Get the DAP minor version as sent by the client.
Definition: DDS.h:268
DDS(BaseTypeFactory *factory, const string &name="")
Definition: DDS.cc:204
void tag_nested_sequences()
Traverse DDS, set Sequence leaf nodes.
Definition: DDS.cc:930
BaseTypeFactory * get_factory() const
Definition: DDS.h:242
DAS * get_das()
Get a DAS object.
Definition: DDS.cc:1211
void print_constrained(FILE *out)
Print a constrained DDS to the specified file.
Definition: DDS.cc:1332
Vars_iter var_begin()
Return an iterator to the first variable.
Definition: DDS.cc:799
string container_name()
Definition: DDS.cc:511
void insert_var_nocopy(Vars_iter i, BaseType *ptr)
Definition: DDS.cc:862
string get_request_xml_base() const
Get the URL that will return this DDS/DDX/DataThing.
Definition: DDS.h:286
int get_dap_major() const
Get the DAP major version as sent by the client.
Definition: DDS.h:266
Vars_iter var_end()
Return an iterator.
Definition: DDS.cc:811
void set_dap_version(const string &version_string="2.0")
Definition: DDS.cc:440
Structure * container()
Definition: DDS.cc:547
void add_var(BaseType *bt)
Adds a copy of the variable to the DDS. Using the ptr_duplicate() method, perform a deep copy on the ...
Definition: DDS.cc:586
void print_xml_writer(ostream &out, bool constrained, const string &blob="")
Definition: DDS.cc:1433
long get_response_limit()
Get the maximum response size, in Bytes. Zero indicates no limit.
Definition: DDS.h:298
void print_das(ostream &out)
write the DAS response given the attribute information in the DDS
Definition: DDS.cc:1182
virtual void dump(ostream &strm) const
dumps information about this object
Definition: DDS.cc:1835
libdap base object for common functionality of libdap objects
Definition: DapObj.h:51
Holds a structure (aggregate) type.
Definition: Structure.h:84
top level DAP object to house generic methods
Definition: AlarmHandler.h:36
bool has_dap2_attributes(AttrTable &a)
Definition: DDS.cc:1053