uk.ac.starlink.pds4

Class LabelParser

java.lang.Object

uk.ac.starlink.pds4.LabelParser

public class LabelParser
extends Object

Parses a PDS4 Label (an XML file) to extract information that can be used to read table data.

This code was written with reference to the PDS4 data standards v1.16.0.

Since:

24 Nov 2021

Author:

Mark Taylor

See Also:

PDS4 Common Data Dictionary

Constructor Summary

Constructors

Constructor and Description
LabelParser() Default parser.
LabelParser(boolean observationalOnly, String[] blankSpecials) Custom constructor.

Method Summary

Modifier and Type	Method and Description
Label	parseLabel(File file) Parses the label file in a given File to create a Label object.
Label	parseLabel(InputStream in, URI contextUri) Parses the label file from a given InputStream to create a Label object.
Label	parseLabel(URL url) Parses the label file at a given URL to create a Label object.

Methods inherited from class java.lang.Object

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

Constructor Detail

LabelParser

public LabelParser()

Default parser.

LabelParser

public LabelParser(boolean observationalOnly,
                   String[] blankSpecials)

Custom constructor.

Parameters:

observationalOnly - if true, only File_Observational tables are included; if false all are included

blankSpecials - list of special constant elements to map to null values in output table data

Method Detail

parseLabel

public Label parseLabel(URL url)
                 throws IOException

Parses the label file at a given URL to create a Label object.

Parameters:

url - location of PDS4 label XML file

Returns:

parsed label object

Throws:

IOException

parseLabel

public Label parseLabel(File file)
                 throws IOException

Parses the label file in a given File to create a Label object.

Parameters:

file - location of PDS4 label XML file

Returns:

parsed label object

Throws:

IOException

parseLabel

public Label parseLabel(InputStream in,
                        URI contextUri)
                 throws IOException

Parses the label file from a given InputStream to create a Label object.

Parameters:

in - input stream, closed unconditionally on exit

contextUri - context URI

Returns:

parsed label object

Throws:

IOException