dap4.dap4lib

Class DMRPrinter

java.lang.Object

dap4.dap4lib.DMRPrinter

public class DMRPrinter
extends java.lang.Object

DMR Printer. Given a constraint and a Dataset, print the constrained subset of the dataset.

WARNING: the printDMR code in some cases duplicates code in dap4.dap4.Dap4Print; so changes here should be propagated.

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	ALLOWFIELDMAPS
protected CEConstraint	ce
protected DapDataset	dmr
protected ResponseFormat	format
protected static java.lang.String[]	GROUPSPECIAL
protected static int	NILFLAGS
protected static int	NONAME
protected static int	NONNIL
protected static int	PERLINE
protected IndentWriter	printer
protected static java.lang.String[]	RESERVEDTAGS
protected boolean	testing
protected static java.lang.String[]	VARSPECIAL
protected java.io.PrintWriter	writer
protected static int	XMLESCAPED

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DMRPrinter()
	DMRPrinter(DapDataset dmr, CEConstraint ce, java.io.PrintWriter writer, ResponseFormat format)
	DMRPrinter(DapDataset dmr, java.io.PrintWriter writer)

Method Summary

Modifier and Type	Method and Description
void	close()
void	flush()
static java.lang.String	fqnXMLEscape(java.lang.String fqn) XML escape a dap fqn and converting '"' to " Assumes backslash escapes are in effect for '/' and '.'
protected static java.lang.String	getPrintValue(java.lang.Object value)
protected static boolean	hasDimensions(DapVariable var)
protected static boolean	hasMaps(DapVariable var)
protected boolean	hasMetadata(DapNode node)
void	print() Print a DapDataset: - as DMR - optionally constrained
protected void	printContainerAttribute(DapAttribute attr)
protected void	printMetadata(DapNode node)
void	printNode(DapNode node) Print an arbitrary DapNode and its subnodes as if it is being sent to a client with optional constraint; inclusions are determined by the view.
protected void	printOtherXML(DapAttribute attr)
protected void	printReserved(DapNode node)
protected void	printXMLAttribute(java.lang.String name, java.lang.String value, int flags) PrintXMLAttributes helper function
void	testprint() Same as print() except certain items of information are suppressed.

Methods inherited from class java.lang.Object

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

Field Detail

NILFLAGS

protected static final int NILFLAGS

See Also:

Constant Field Values

PERLINE

protected static final int PERLINE

See Also:

Constant Field Values

NONAME

protected static final int NONAME

See Also:

Constant Field Values

NONNIL

protected static final int NONNIL

See Also:

Constant Field Values

XMLESCAPED

protected static final int XMLESCAPED

See Also:

Constant Field Values

GROUPSPECIAL

protected static final java.lang.String[] GROUPSPECIAL

VARSPECIAL

protected static final java.lang.String[] VARSPECIAL

RESERVEDTAGS

protected static final java.lang.String[] RESERVEDTAGS

ALLOWFIELDMAPS

public static final boolean ALLOWFIELDMAPS

See Also:

Constant Field Values

writer

protected java.io.PrintWriter writer

printer

protected IndentWriter printer

dmr

protected DapDataset dmr

ce

protected CEConstraint ce

format

protected ResponseFormat format

testing

protected boolean testing

Constructor Detail

DMRPrinter

protected DMRPrinter()

DMRPrinter

public DMRPrinter(DapDataset dmr,
                  java.io.PrintWriter writer)

DMRPrinter

public DMRPrinter(DapDataset dmr,
                  CEConstraint ce,
                  java.io.PrintWriter writer,
                  ResponseFormat format)

Method Detail

flush

public void flush()

close

public void close()

print

public void print()
           throws java.io.IOException

Print a DapDataset: - as DMR - optionally constrained

Throws:

java.io.IOException

testprint

public void testprint()
               throws java.io.IOException

Same as print() except certain items of information are suppressed.

Throws:

java.io.IOException

printNode

public void printNode(DapNode node)
               throws java.io.IOException

Print an arbitrary DapNode and its subnodes as if it is being sent to a client with optional constraint; inclusions are determined by the view.

Handling newlines is a bit tricky because they may be embedded for e.g. groups, enums, etc. So the rule is that the last newline is elided and left for the caller to print. Exceptions: printMetadata printDimrefs, printMaps

Parameters:

node - - the node to print

Throws:

java.io.IOException - Note that the PrintWriter is global.

printXMLAttribute

protected void printXMLAttribute(java.lang.String name,
                                 java.lang.String value,
                                 int flags)
                          throws DapException

PrintXMLAttributes helper function

Parameters:

name -

value -

flags -

Throws:

DapException

printReserved

protected void printReserved(DapNode node)
                      throws DapException

Throws:

DapException

printMetadata

protected void printMetadata(DapNode node)
                      throws java.io.IOException

Throws:

java.io.IOException

printContainerAttribute

protected void printContainerAttribute(DapAttribute attr)

printOtherXML

protected void printOtherXML(DapAttribute attr)

fqnXMLEscape

public static java.lang.String fqnXMLEscape(java.lang.String fqn)

XML escape a dap fqn and converting '"' to " Assumes backslash escapes are in effect for '/' and '.'

Parameters:

fqn - the backslash escaped fqn

Returns:

escaped string

getPrintValue

protected static java.lang.String getPrintValue(java.lang.Object value)

hasMetadata

protected boolean hasMetadata(DapNode node)

hasMaps

protected static boolean hasMaps(DapVariable var)

hasDimensions

protected static boolean hasDimensions(DapVariable var)