dap4.core.util

Class DapUtil

java.lang.Object

dap4.core.util.DapUtil

public abstract class DapUtil
extends Object

Misc. Utility methods

Field Summary

Fields

Modifier and Type	Field and Description
static BigInteger	BIG_UMASK64
static int	CHECKSUMSIZE
static int	CHUNK_ALL
static int	CHUNK_DATA
static int	CHUNK_END
static int	CHUNK_ERROR
static int	CHUNK_LITTLE_ENDIAN
static String	CRLF
static int	CRLFSIZE
static String	DIGESTER
static String	LF
static ByteOrder	NATIVE_ORDER
static ByteOrder	NETWORK_ORDER
static Charset	UTF8

Constructor Summary

Constructors

Constructor and Description
DapUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static List<String>	backslashSplit(String s, char sep) Split a string with respect to a separator character and taking backslashes into consideration.
static String	canonicalpath(String path, boolean relative) Convert path to: 1.
static boolean	checkFixedSize(DapVariable var)
static long	dimProduct(List<DapDimension> dimset)
static List<Slice>	dimsetSlices(List<DapDimension> dimset) Given a view, get the universal View either from a DapDataset.
static byte[]	extract(ByteBuffer buf) Properly extract the byte contents of a ByteBuffer
static String	fqnPrefix(String fqn)
static String	fqnSuffix(String fqn)
static String[]	getProtocols(String url)
static List<DapVariable>	getStructurePath(DapVariable var) Given a dap variable, get the path from the top-level variable to and including the given variable such that all but the last element is a structure.
static boolean	hasSequence(DapNode node)
static boolean	hasStrideOne(List<Slice> slices)
static boolean	isWhole(List<Slice> slices, List<DapDimension> dimset) Test a List against set of DapDimensions to see if the list is whole wrt the dimensions
static String	locateFile(String filename, String abspath, boolean wantdir) Walk the specified subtree dir tree to try to locate file|dir named filename.
static String	locateRelative(String relpath, String abspath, boolean wantdir) Walk the specified dir tree to locate file specified by relative path.
static String	nullify(String path) Convert "" paths to null
static byte[]	readbinaryfile(InputStream stream)
static String	readtextfile(InputStream stream)
static long	sliceProduct(List<Slice> slices)

Methods inherited from class java.lang.Object

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

Field Detail

BIG_UMASK64

public static final BigInteger BIG_UMASK64

UTF8

public static final Charset UTF8

NETWORK_ORDER

public static final ByteOrder NETWORK_ORDER

NATIVE_ORDER

public static final ByteOrder NATIVE_ORDER

CHUNK_DATA

public static final int CHUNK_DATA

See Also:

Constant Field Values

CHUNK_END

public static final int CHUNK_END

See Also:

Constant Field Values

CHUNK_ERROR

public static final int CHUNK_ERROR

See Also:

Constant Field Values

CHUNK_LITTLE_ENDIAN

public static final int CHUNK_LITTLE_ENDIAN

See Also:

Constant Field Values

CHUNK_ALL

public static final int CHUNK_ALL

See Also:

Constant Field Values

LF

public static final String LF

See Also:

Constant Field Values

CRLF

public static final String CRLF

See Also:

Constant Field Values

CRLFSIZE

public static final int CRLFSIZE

See Also:

Constant Field Values

CHECKSUMSIZE

public static final int CHECKSUMSIZE

See Also:

Constant Field Values

DIGESTER

public static final String DIGESTER

See Also:

Constant Field Values

Constructor Detail

DapUtil

public DapUtil()

Method Detail

fqnSuffix

public static String fqnSuffix(String fqn)

fqnPrefix

public static String fqnPrefix(String fqn)

backslashSplit

public static List<String> backslashSplit(String s,
                          char sep)

Split a string with respect to a separator character and taking backslashes into consideration.

Parameters:

s - The string to split

sep - The character on which to split

Returns:

a List of strings (all with escaping still intact) representing s split at unescaped instances of sep.

hasSequence

public static boolean hasSequence(DapNode node)

locateFile

public static String locateFile(String filename,
                String abspath,
                boolean wantdir)

Walk the specified subtree dir tree to try to locate file|dir named filename. Use breadth first search.

Parameters:

filename - Name of the file|dir to locate

abspath - Absolute path from which to start search

wantdir - True if we are looking for a directory, false if we are looking for a file

Returns:

absolute path of the file or null

locateRelative

public static String locateRelative(String relpath,
                    String abspath,
                    boolean wantdir)

Walk the specified dir tree to locate file specified by relative path. Use breadth first search.

Parameters:

relpath - Name of the file|dir to locate

abspath - Absolute path from which to start search

wantdir - True if we are looking for a directory, false if we are looking for a file

Returns:

absolute path of the file|dir wrt to abspath

canonicalpath

public static String canonicalpath(String path,
                   boolean relative)

Convert path to: 1. use '/' consistently 2. remove any trailing '/' 3. trim blanks

Parameters:

path - convert this path

Returns:

canonicalized version

checkFixedSize

public static boolean checkFixedSize(DapVariable var)

extract

public static byte[] extract(ByteBuffer buf)

Properly extract the byte contents of a ByteBuffer

Parameters:

buf - The buffer whose content is to be extracted as defined by the buffer limit.

Returns:

The byte array contents of the buffer

readbinaryfile

public static byte[] readbinaryfile(InputStream stream)
                             throws IOException

Throws:

IOException

readtextfile

public static String readtextfile(InputStream stream)
                           throws IOException

Throws:

IOException

getStructurePath

public static List<DapVariable> getStructurePath(DapVariable var)

Given a dap variable, get the path from the top-level variable to and including the given variable such that all but the last element is a structure.

nullify

public static String nullify(String path)

Convert "" paths to null

Parameters:

path -

Returns:

path or ""

getProtocols

public static String[] getProtocols(String url)

dimProduct

public static long dimProduct(List<DapDimension> dimset)

dimsetSlices

public static List<Slice> dimsetSlices(List<DapDimension> dimset)
                                throws DapException

Given a view, get the universal View either from a DapDataset.

Throws:

DapException

isWhole

public static boolean isWhole(List<Slice> slices,
              List<DapDimension> dimset)

Test a List against set of DapDimensions to see if the list is whole wrt the dimensions

Parameters:

slices - the set of slices

dimset - the list of DapDimension

sliceProduct

public static long sliceProduct(List<Slice> slices)

hasStrideOne

public static boolean hasStrideOne(List<Slice> slices)