DODS Programmer's Guide
The Client and Server Toolkit
Version 1.2

This document describes how to use the OPeNDAP toolkit software to build OPeNDAP data servers, clients and client-libraries. Using the objects and functions contained in the toolkit, you can create programs which serve data over the internet as well as programs that can request data from any OPeNDAP server.

This document covers release 3.2 and later of the DODS software.

• Preface
  • 0.1 Who is this Guide for?
  • 0.2 Organization of this Document
  • 0.3 Conventions
• 1 The DODS Client and Server Toolkit
  • 1.1 The DAS and DDS Objects
    • 1.1.1 The DAS Object
    • 1.1.2 The DDS Object
  • 1.2 The Type Hierarchy
    • 1.2.1 Common Ancestor: BaseType
    • 1.2.2 Simple Types
    • 1.2.3 Vector Types: Array, List
    • 1.2.4 Compound Types: Structure, Sequence, Function, Grid
• 2 Managing Connections
  • 2.1 Connect
  • 2.2 Connections
• 3 Using the DODS Library Classes
  • 3.1 Sub-classing the Type Hierarchy
    • 3.1.1 Sub-classing the Simple Types
    • 3.1.2 Sub-classing the Vector Types
    • 3.1.3 Sub-classing the Compound Types
  • 3.2 Sub-classing the Connect Class
• 4 Using the Toolkit
  • 4.1 Data Servers
    • 4.1.1 The Dispatch CGI
    • 4.1.2 The DAS and DDS filter programs
      • Caching DAS and DDS Objects
    • 4.1.3 The Data filter
      • The ASCII Data Filter
    • 4.1.4 The Usage Filter
    • 4.1.5 Documenting Your Work
      • The README File
      • The ERRORS File
      • Installation Notes
      • Information Files
  • 4.2 Client Libraries
    • 4.2.1 Rewriting the Open and Close Functions
    • 4.2.2 Getting Information about Variables
    • 4.2.3 Reading the Values of Variables from a Dataset
      • Translation
    • 4.2.4 Functions that Write to Data Sets
    • 4.2.5 Adding Local Access to a DODS Client Library
  • 4.3 Using Constraints
    • 4.3.1 How Constraint Expressions are Evaluated
    • 4.3.2 Different Ways of Using Constraint Expressions
• 5 Linking Your Program
• 6 DAP C++ Reference
• A Overview of the DODS Server Architecture
  • A.1 Outputs
    • A.1.1 HTML Data
    • A.1.2 ASCII Data (Text)
    • A.1.3 Binary Data
      • Encoding the DAP Data Types
  • A.2 Inputs
    • A.2.1 Request types
    • A.2.2 Constraint expressions
    • A.2.3 Server functions
      • Selection
      • Projection
• B Overview of the DODS Client
• Index
• Footnotes