org.das2.qstream

Class SimpleStreamFormatter

java.lang.Object

org.das2.qstream.SimpleStreamFormatter

public class SimpleStreamFormatter
extends java.lang.Object

Class for formatting QDataSets as QStreams. Although this is "SimpleStreamFormatter," this is the only formatter written thus far, except for SerialStreamFormatter, which formats packet-by-packet.

Constructor Summary

Constructors

Constructor and Description
SimpleStreamFormatter()

Method Summary

Modifier and Type	Method and Description
void	format(QDataSet ds, java.io.OutputStream osout, boolean asciiTypes) serialize the dataset to the output stream.
static void	main(java.lang.String[] args)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SimpleStreamFormatter

public SimpleStreamFormatter()

Method Detail

format

public void format(QDataSet ds,
                   java.io.OutputStream osout,
                   boolean asciiTypes)
            throws StreamException,
                   java.io.IOException

serialize the dataset to the output stream. Presently most datasets can be serialized:

• rank 0
• rank 1
• rank 2 qubes
• array of rank 2 qubes
• rank 3 qubes
• bundle datasets.

The design goal is that all datasets can be serialized using this formatter, however some schemas (e.g. high-rank non-qubes) will be inefficient.

Parameters:

ds - the dataset to serialize.

osout - the output stream, which will not be closed here.

asciiTypes - use ascii format types so that the stream is completely ascii.

Throws:

StreamException

java.io.IOException

main

public static void main(java.lang.String[] args)
                 throws java.io.FileNotFoundException,
                        java.io.IOException,
                        StreamException

Throws:

java.io.FileNotFoundException

java.io.IOException

StreamException