org.jlab.coda.jevio

Class EvioXMLDictionary

java.lang.Object

org.jlab.coda.jevio.EvioXMLDictionary

All Implemented Interfaces:

INameProvider

public class EvioXMLDictionary
extends java.lang.Object
implements INameProvider

This was developed to read the xml dictionary that Maurizio uses for GEMC. It implements INameProvider, just like all other dictionary readers. An assumption in the following class is that each unique tag/num pair corresponds to an equally unique name. In other words, 2 different tag/numm pairs cannot have the same name. Entries with only a tag value and no num are allowed. They will match a tag/num pair if no exact match exists but the tag matches. For such entries, no additional existence of type, format, or description is allowed.

Author:

heddle, timmer

Field Summary

Fields inherited from interface org.jlab.coda.jevio.INameProvider

NO_NAME_STRING

Constructor Summary

Constructors

Constructor and Description
EvioXMLDictionary(org.w3c.dom.Document domDocument) Create an EvioXMLDictionary from an xml Document object.
EvioXMLDictionary(org.w3c.dom.Document domDocument, java.lang.String delimiter) Create an EvioXMLDictionary from an xml Document object.
EvioXMLDictionary(java.io.File file) Create an EvioXMLDictionary from an xml file.
EvioXMLDictionary(java.io.File file, java.lang.String delimiter) Create an EvioXMLDictionary from an xml file.
EvioXMLDictionary(java.lang.String xmlString) Create an EvioXMLDictionary from an xml string.
EvioXMLDictionary(java.lang.String xmlString, java.lang.String delimiter) Create an EvioXMLDictionary from an xml string.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	getDescription(int tag, int num) Returns the description, if any, associated with the given tag and num.
java.lang.String	getDescription(java.lang.String name) Returns the description, if any, associated with the name of a dictionary entry.
java.lang.String	getFormat(int tag, int num) Returns the format, if any, associated with the given tag and num.
java.lang.String	getFormat(java.lang.String name) Returns the format, if any, associated with the name of a dictionary entry.
java.lang.String	getName(BaseStructure structure) Returns the name of a given evio structure.
java.lang.String	getName(int tag, int num) Returns the name associated with the given tag and num.
int	getNum(java.lang.String name) Returns the num corresponding to the name of a dictionary entry.
int	getTag(java.lang.String name) Returns the tag corresponding to the name of a dictionary entry.
int[]	getTagNum(java.lang.String name) Returns the tag/num pair, in an int array, corresponding to the name of a dictionary entry.
DataType	getType(int tag, int num) Returns the type, if any, associated with the given tag and num.
DataType	getType(java.lang.String name) Returns the type, if any, associated with the name of a dictionary entry.
java.lang.String	toString() Get a string representation of the dictionary.
java.lang.String	toXML() Get an xml representation of the dictionary.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

EvioXMLDictionary

public EvioXMLDictionary(java.io.File file)

Create an EvioXMLDictionary from an xml file.

Parameters:

file - file containing xml.

EvioXMLDictionary

public EvioXMLDictionary(java.io.File file,
                 java.lang.String delimiter)

Create an EvioXMLDictionary from an xml file.

Parameters:

file - file containing xml.

delimiter - character used to separate hierarchical parts of names.

EvioXMLDictionary

public EvioXMLDictionary(java.lang.String xmlString)

Create an EvioXMLDictionary from an xml string.

Parameters:

xmlString - string containing xml.

EvioXMLDictionary

public EvioXMLDictionary(java.lang.String xmlString,
                 java.lang.String delimiter)

Create an EvioXMLDictionary from an xml string.

Parameters:

xmlString - string containing xml.

delimiter - character used to separate hierarchical parts of names.

EvioXMLDictionary

public EvioXMLDictionary(org.w3c.dom.Document domDocument)

Create an EvioXMLDictionary from an xml Document object.

Parameters:

domDocument - DOM object representing xml dictionary.

EvioXMLDictionary

public EvioXMLDictionary(org.w3c.dom.Document domDocument,
                 java.lang.String delimiter)

Create an EvioXMLDictionary from an xml Document object.

Parameters:

domDocument - DOM object representing xml dictionary.

delimiter - character used to separate hierarchical parts of names.

Method Detail

getName

public java.lang.String getName(BaseStructure structure)

Returns the name of a given evio structure.

Specified by:

getName in interface INameProvider

Parameters:

structure - the structure to find the name of.

Returns:

a descriptive name or ??? if none found

getName

public java.lang.String getName(int tag,
                       int num)

Returns the name associated with the given tag and num.

Parameters:

tag - to find the name of

num - to find the name of

Returns:

a descriptive name or ??? if none found

getDescription

public java.lang.String getDescription(int tag,
                              int num)

Returns the description, if any, associated with the given tag and num.

Parameters:

tag - to find the description of

num - to find the description of

Returns:

the description or null if none found

getDescription

public java.lang.String getDescription(java.lang.String name)

Returns the description, if any, associated with the name of a dictionary entry.

Parameters:

name - dictionary name

Returns:

description; null if name or is unknown or no description is associated with it

getFormat

public java.lang.String getFormat(int tag,
                         int num)

Returns the format, if any, associated with the given tag and num.

Parameters:

tag - to find the format of

num - to find the format of

Returns:

the format or null if none found

getFormat

public java.lang.String getFormat(java.lang.String name)

Returns the format, if any, associated with the name of a dictionary entry.

Parameters:

name - dictionary name

Returns:

format; null if name or is unknown or no format is associated with it

getType

public DataType getType(int tag,
               int num)

Returns the type, if any, associated with the given tag and num.

Parameters:

tag - to find the type of

num - to find the type of

Returns:

the type or null if none found

getType

public DataType getType(java.lang.String name)

Returns the type, if any, associated with the name of a dictionary entry.

Parameters:

name - dictionary name

Returns:

type; null if name or is unknown or no type is associated with it

getTagNum

public int[] getTagNum(java.lang.String name)

Returns the tag/num pair, in an int array, corresponding to the name of a dictionary entry.

Parameters:

name - dictionary name

Returns:

an integer array in which the first element is the tag and the second is the num; null if name is unknown

getTag

public int getTag(java.lang.String name)

Returns the tag corresponding to the name of a dictionary entry.

Parameters:

name - dictionary name

Returns:

tag; -1 if name unknown

getNum

public int getNum(java.lang.String name)

Returns the num corresponding to the name of a dictionary entry.

Parameters:

name - dictionary name

Returns:

num; -1 if name unknown

toXML

public java.lang.String toXML()

Get an xml representation of the dictionary.

Returns:

an xml representation of the dictionary.

toString

public java.lang.String toString()

Get a string representation of the dictionary.

Overrides:

toString in class java.lang.Object

Returns:

a string representation of the dictionary.