Hyrax - Example BES Modules - Revision history

PatrickWest at 19:47, 9 May 2010

2010-05-09T19:47:36Z

← Older revision		Revision as of 19:47, 9 May 2010
Line 44:		Line 44:

	The CSV Data Handler Module class CSVModule adds a request handler (CSVRequestHandler) to handle populating DAP2 response objects (DAS, DDS, DataDDS) as well as the standard response for help and version. The Module also tells the BES that it can handle THREDDS catalog requests.		The CSV Data Handler Module class CSVModule adds a request handler (CSVRequestHandler) to handle populating DAP2 response objects (DAS, DDS, DataDDS) as well as the standard response for help and version. The Module also tells the BES that it can handle THREDDS catalog requests.

			[[Category:BES Modules\|Example BES Modules]]

PatrickWest at 04:54, 28 January 2009

2009-01-28T04:54:42Z

← Older revision		Revision as of 04:54, 28 January 2009
Line 1:		Line 1:
	We have provided you with two example BES modules. These modules are the Hello World module and the CSV data handler module.		We have provided you with two example BES modules. These modules are the Hello World module and the CSV data handler module.

	Both of these modules are available from the SVN source code repository and are not included in the source tar ball or the binary distributions. To get them you will need to 'check out' the bes source code. ~~@TODO~~		Both of these modules are available from the SVN source code repository and are not included in the source tar ball or the binary distributions. To get them you will need to 'check out' the bes source code for [http://scm.opendap.org/svn/trunk/bes/hello_world this module].

	=Hello World=		=Hello World=
	The Hello World module, the ~~SayModule~~ class, adds a new command to the BES, the ~~SayCommand~~. ~~From~~ the command line client you would ~~execute~~ the following ~~request~~:		The Hello World module, the SampleModule class, adds a new command to the BES, the SampleSayXMLCommand. Using the BES command line client you would have an input file with the following:

	say <~~something~~> to <~~someone~~>;		<pre>
			<?xml version="1.0" encoding="UTF-8"?>
			<request reqID="some_unique_value" >
			<say what="hello" to="world" />
			</request>
			</pre>

	~~For example~~:		The XML response document would look like the following:

	say hello to world;		<pre>
			<?xml version="1.0" encoding="ISO-8859-1"?>
			<say><response><text>hello world</text></response></say>
			</pre>

	It also adds the ~~SayRequestHandler~~ class, which handles <code>help</code> and <code>version</code> requests, the ~~SayResponseHandler~~ class, which handles building AND populating the informational response, and the SayReporter, which reports on what is being said to who in a log file configured in the BES configuration file.		It also adds the SampleRequestHandler class, which handles <code>help</code> and <code>version</code> requests, the SampleSayResponseHandler class, which handles building AND populating the informational response, and the SayReporter, which reports on what is being said to who in a log file configured in the BES configuration file. You can see the sample input and output in the bes-testsuite directory under bes/hello_world. Adding this sample module to your BES configuration file is also easy. It uses the same mechanism that data handlers use, providing a shell script, bes-sample-data.sh, to add information to the configuration file.

	=CSV Data Handler Module=		=CSV Data Handler Module=

Ndp: Hyrax 1.2: Example BES Modules moved to Hyrax - Example BES Modules

2007-11-07T07:02:23Z

Hyrax 1.2: Example BES Modules moved to Hyrax - Example BES Modules

← Older revision	Revision as of 07:02, 7 November 2007
(No difference)

Ndp: New page: We have provided you with two example BES modules. These modules are the Hello World module and the CSV data handler module. Both of these modules are available from the SVN source code r...

2007-03-22T00:27:19Z

New page: We have provided you with two example BES modules. These modules are the Hello World module and the CSV data handler module. Both of these modules are available from the SVN source code r...

New page

We have provided you with two example BES modules. These modules are the Hello World module and the CSV data handler module.

Both of these modules are available from the SVN source code repository and are not included in the source tar ball or the binary distributions. To get them you will need to 'check out' the bes source code. @TODO

=Hello World=
The Hello World module, the SayModule class, adds a new command to the BES, the SayCommand. From the command line client you would execute the following request:

say <something> to <someone>;

For example:

say hello to world;

It also adds the SayRequestHandler class, which handles <code>help</code> and <code>version</code> requests, the SayResponseHandler class, which handles building AND populating the informational response, and the SayReporter, which reports on what is being said to who in a log file configured in the BES configuration file.

=CSV Data Handler Module=

The CSV Data Handler Module handles requests for data in the CSV format (comma separated). Here is an example file:

<pre>
"Station<String>","latitude<Float32>","longitude<Float32>","temperature_K<Float32>","Notes<String>"
"CMWM",-34.7,23.7,264.3,
"BWWJ",-34.2,21.5,262.1,"Foo"
"CWQK",-32.7,22.3,268.4,
"CRLM",-33.8,22.1,270.2,"Blah"
"FOOB",-32.9,23.4,269.69,"FOOBAR"
</pre>

The types of data allowed are:
* String
* Byte
* Int16
* Int32
* Float32
* Float64

The CSV Data Handler Module class CSVModule adds a request handler (CSVRequestHandler) to handle populating DAP2 response objects (DAS, DDS, DataDDS) as well as the standard response for help and version. The Module also tells the BES that it can handle THREDDS catalog requests.