org.apache.beam.sdk.io.xml

Class XmlIO.Read<T>

java.lang.Object

org.apache.beam.sdk.transforms.PTransform<PBegin,PCollection<T>>

org.apache.beam.sdk.io.xml.XmlIO.Read<T>

All Implemented Interfaces:

Serializable, HasDisplayData

Enclosing class:

XmlIO

public abstract static class XmlIO.Read<T>
extends PTransform<PBegin,PCollection<T>>

Implementation of XmlIO.read().

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	XmlIO.Read.CompressionType Deprecated. Use Compression instead.

Field Summary

Fields inherited from class org.apache.beam.sdk.transforms.PTransform

name

Constructor Summary

Constructors

Constructor and Description
Read()

Method Summary

Modifier and Type	Method and Description
PCollection<T>	expand(PBegin input)
XmlIO.Read<T>	from(String fileOrPatternSpec) Reads a single XML file or a set of XML files defined by a Java "glob" file pattern.
void	populateDisplayData(DisplayData.Builder builder)
XmlIO.Read<T>	withCharset(Charset charset) Sets the XML file charset.
XmlIO.Read<T>	withCompression(Compression compression) Decompresses all input files using the specified compression type.
XmlIO.Read<T>	withCompressionType(XmlIO.Read.CompressionType compressionType) Deprecated. use withCompression(org.apache.beam.sdk.io.Compression).
XmlIO.Read<T>	withMinBundleSize(long minBundleSize) Sets a parameter minBundleSize for the minimum bundle size of the source.
XmlIO.Read<T>	withRecordClass(Class<T> recordClass) Sets a JAXB annotated class that can be populated using a record of the provided XML file.
XmlIO.Read<T>	withRecordElement(String recordElement) Sets name of the record element of the XML document.
XmlIO.Read<T>	withRootElement(String rootElement) Sets name of the root element of the XML document.
XmlIO.Read<T>	withValidationEventHandler(ValidationEventHandler validationEventHandler) Sets the ValidationEventHandler to use with JAXB.

Methods inherited from class org.apache.beam.sdk.transforms.PTransform

getAdditionalInputs, getDefaultOutputCoder, getDefaultOutputCoder, getDefaultOutputCoder, getKindString, getName, toString, validate

Methods inherited from class java.lang.Object

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

Constructor Detail

Read

public Read()

Method Detail

from

public XmlIO.Read<T> from(String fileOrPatternSpec)

Reads a single XML file or a set of XML files defined by a Java "glob" file pattern. Each XML file should be of the form defined in XmlIO.read().

withRootElement

public XmlIO.Read<T> withRootElement(String rootElement)

Sets name of the root element of the XML document. This will be used to create a valid starting root element when initiating a bundle of records created from an XML document. This is a required parameter.

withRecordElement

public XmlIO.Read<T> withRecordElement(String recordElement)

Sets name of the record element of the XML document. This will be used to determine offset of the first record of a bundle created from the XML document. This is a required parameter.

withRecordClass

public XmlIO.Read<T> withRecordClass(Class<T> recordClass)

Sets a JAXB annotated class that can be populated using a record of the provided XML file. This will be used when unmarshalling record objects from the XML file. This is a required parameter.

withMinBundleSize

public XmlIO.Read<T> withMinBundleSize(long minBundleSize)

Sets a parameter minBundleSize for the minimum bundle size of the source. Please refer to OffsetBasedSource for the definition of minBundleSize. This is an optional parameter.

withCompressionType

@Deprecated
public XmlIO.Read<T> withCompressionType(XmlIO.Read.CompressionType compressionType)

Deprecated. use withCompression(org.apache.beam.sdk.io.Compression).

withCompression

public XmlIO.Read<T> withCompression(Compression compression)

Decompresses all input files using the specified compression type.

withCharset

public XmlIO.Read<T> withCharset(Charset charset)

Sets the XML file charset.

withValidationEventHandler

public XmlIO.Read<T> withValidationEventHandler(ValidationEventHandler validationEventHandler)

Sets the ValidationEventHandler to use with JAXB. Calling this with a null parameter will cause the JAXB unmarshaller event handler to be unspecified.

populateDisplayData

public void populateDisplayData(DisplayData.Builder builder)

Specified by:

populateDisplayData in interface HasDisplayData

Overrides:

populateDisplayData in class PTransform<PBegin,PCollection<T>>

expand

public PCollection<T> expand(PBegin input)

Specified by:

expand in class PTransform<PBegin,PCollection<T>>