Package gov.nih.mipav.model.file

Class FileXML

java.lang.Object

gov.nih.mipav.model.file.FileBase

gov.nih.mipav.model.file.FileXML

Direct Known Subclasses:

FileDataProvenance, FileImageXML, FilePolylineVOIXML, FileSurfaceGiftiXML, FileSurfaceRefXML, FileSurfaceVTKXML, FileSurfaceXML, FileVOI

public abstract class FileXML
extends FileBase

Abstract base class for reading/writing .XML file headers. The XML reader uses any schema (.XSD) file, pased into the readHeader function, for parsing.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	FileXML.XMLAttributes	Class used to store an xml tag's attribute (name and value)

Field Summary

Fields

Modifier and Type	Field	Description
protected BufferedWriter	bw	Buffered writer for writing to XML file
protected String	fileDir	Directory of XML file on disk.
protected FileInfoXML	fileInfo	the file info storing xml specific information, abstract base class of FileInfoImageXML or FileInfoSurfaceXML:
protected String	fileName	Name of the XML header file on disk.
protected DefaultHandler	m_kHandler	DOCUMENT ME!
protected static final String	MIPAV_HEADER	Mipav header string (for top of xml header).
protected ProgressBarInterface	pInterface	progress bar implementation (either through a JProgressBar or JPanel) passed in for reading/saving file.
protected static final String	TAB	TAB string.
protected int	tabLevel	tab level counter for writing xml header.
protected static final String	W3C_XML_SCHEMA	XML schema string.
protected static final String	XML_ENCODING	XML encoding string.
protected static final String	XML_HEADER	XML header string.

Fields inherited from class gov.nih.mipav.model.file.FileBase

BIG_ENDIAN, bitsPerPixel, fileNames, LITTLE_ENDIAN, pBarVisible, raFile, READ, READ_WRITE

Constructor Summary

Constructors

Constructor	Description
FileXML(String fName, String fDir)	Constructs new file object.

Method Summary

Modifier and Type	Method	Description
protected final void	closedTag(String tag, String val)	Simple function to write an xml formatted closed tag including the tag value.
final void	closedTag(String tag, String val, Vector<FileXML.XMLAttributes> attr)	Writes a closed tag (tag, end tag) with the addition of attributes (name="value") from within a Vector (can do any number of XMLAttributes ...class included below)
final void	closedTag(String tag, Vector<FileXML.XMLAttributes> attr)	Writes a closed tag where no value is specified, only attributes.
void	finalize()	Prepares class for cleanup.
final void	openTag(String tag, boolean start)	Simple function to write an xml formatted open ended tag (value not included).
FileInfoXML	readHeader(String headerFileName, String headerDir, String kFileXSD)	readHeader parses the input XML file based on the input XSD file, kFileXSD:
void	setPBar(ProgressBarInterface pBar)	Sets the progress bar to be used for loading/saving image (JProgressBar or JPanel).

Methods inherited from class gov.nih.mipav.model.file.FileBase

addProgressChangeListener, bytesToDouble, bytesToFloat, bytesToInt, bytesToShort, doubleToBytes, fireProgressStateChanged, fireProgressStateChanged, fireProgressStateChanged, floatToBytes, getBufferDouble, getBufferFloat, getBufferInt, getBufferLong, getBufferShort, getBufferUShort, getDataType, getDouble, getFloat, getInt, getLong, getProgressChangeListeners, getRaFile, getSignedShort, getString, getUInt, getUnsignedByte, getUnsignedShort, intToBytes, isBigEndian, isProgressBarVisible, linkProgress, longToBytes, readDouble, readFloat, readInt, readLong, readShort, readString, readUnsignedShort, removeProgressChangeListener, setBigEndian, setBufferFloat, setBufferInt, setBufferLong, setBufferShort, setBufferString, setDataType, setEndianess, shortToBytes, writeBytes, writeDouble, writeFloat, writeInt, writeLong, writeShort

Methods inherited from class java.lang.Object

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

Field Details

TAB

protected static final String TAB

TAB string.

See Also:

• Constant Field Values

W3C_XML_SCHEMA

protected static final String W3C_XML_SCHEMA

XML schema string.

See Also:

• Constant Field Values

XML_ENCODING

protected static final String XML_ENCODING

XML encoding string.

See Also:

• Constant Field Values

XML_HEADER

protected static final String XML_HEADER

XML header string.

See Also:

• Constant Field Values

MIPAV_HEADER

protected static final String MIPAV_HEADER

Mipav header string (for top of xml header).

See Also:

• Constant Field Values

fileDir

protected String fileDir

Directory of XML file on disk.

fileInfo

protected FileInfoXML fileInfo

the file info storing xml specific information, abstract base class of FileInfoImageXML or FileInfoSurfaceXML:

fileName

protected String fileName

Name of the XML header file on disk.

m_kHandler

protected DefaultHandler m_kHandler

DOCUMENT ME!

pInterface

protected ProgressBarInterface pInterface

progress bar implementation (either through a JProgressBar or JPanel) passed in for reading/saving file.

tabLevel

protected int tabLevel

tab level counter for writing xml header.

bw

protected BufferedWriter bw

Buffered writer for writing to XML file

Constructor Details

FileXML

public FileXML(String fName,
 String fDir)

Constructs new file object.

Parameters:

fName - File name.

fDir - File directory.

Method Details

finalize

public void finalize()

Prepares class for cleanup.

Overrides:

finalize in class FileBase

openTag

public final void openTag(String tag,
 boolean start)

Simple function to write an xml formatted open ended tag (value not included).

Parameters:

tag - tag name

start - is this a start or end tag

bw - writer to use

readHeader

public FileInfoXML readHeader(String headerFileName,
 String headerDir,
 String kFileXSD)

readHeader parses the input XML file based on the input XSD file, kFileXSD:

Parameters:

headerFileName - DOCUMENT ME!

headerDir - DOCUMENT ME!

kFileXSD - DOCUMENT ME!

Returns:

DOCUMENT ME!

setPBar

public void setPBar(ProgressBarInterface pBar)

Sets the progress bar to be used for loading/saving image (JProgressBar or JPanel).

Parameters:

pBar - ProgressBarInterface

closedTag

protected final void closedTag(String tag,
 String val)

Simple function to write an xml formatted closed tag including the tag value.

Parameters:

tag - tag name

val - tag value

bw - write to use

closedTag

public final void closedTag(String tag,
 String val,
 Vector<FileXML.XMLAttributes> attr)

Writes a closed tag (tag, end tag) with the addition of attributes (name="value") from within a Vector (can do any number of XMLAttributes ...class included below)

Parameters:

tag - the tag name

val - the tag's value

attr - vector of XMLAttributes

closedTag

public final void closedTag(String tag,
 Vector<FileXML.XMLAttributes> attr)

Writes a closed tag where no value is specified, only attributes.