gov.nasa.gsfc.spdf.cdfj

Class ReaderFactory

java.lang.Object

gov.nasa.gsfc.spdf.cdfj.ReaderFactory

public final class ReaderFactory
extends java.lang.Object

ReaderFactory creates an instance of CDFReader from a CDF source. Uses array backed ByteBuffer for CDFReader. The source CDF can be a file, or a URL.

Constructor Summary

Constructors

Constructor and Description
ReaderFactory()

Method Summary

Modifier and Type	Method and Description
static CDFReader	getReader(java.lang.String fname) Return a reader for the CDF file.
static CDFReader	getReader(java.lang.String fname, boolean map) get a reader, forcing that all is read into memory in one heap byte array.
static CDFReader	getReader(java.net.URL url) creates CDFReader object from a URL using array backed ByteBuffer.

Methods inherited from class java.lang.Object

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

Constructor Detail

ReaderFactory

public ReaderFactory()

Method Detail

getReader

public static CDFReader getReader(java.lang.String fname)
                           throws CDFException.ReaderError

Return a reader for the CDF file. This looks at the CDF file internals to calculate the version and returns an implementation.

Parameters:

fname -

Returns:

a reader for the CDF file

Throws:

CDFException.ReaderError - if there is an issue while reading the file

java.lang.IllegalArgumentException - if the file is not a CDF file

getReader

public static CDFReader getReader(java.net.URL url)
                           throws CDFException.ReaderError

creates CDFReader object from a URL using array backed ByteBuffer.

Throws:

CDFException.ReaderError

getReader

public static CDFReader getReader(java.lang.String fname,
                                  boolean map)
                           throws CDFException.ReaderError

get a reader, forcing that all is read into memory in one heap byte array. This has the limitation that the file cannot be greater than 2GB in length.

Parameters:

fname - the file name.

map - read the file into a memory block on the heap

Returns:

a CDFReader

Throws:

CDFException.ReaderError