com.google.cloud.dataflow.sdk.values

Class PValueBase

java.lang.Object

com.google.cloud.dataflow.sdk.values.POutputValueBase

com.google.cloud.dataflow.sdk.values.PValueBase

All Implemented Interfaces:

PInput, POutput, PValue

Direct Known Subclasses:

TypedPValue

public abstract class PValueBase
extends POutputValueBase
implements PValue

A PValueBase is an abstract base class that provides sensible default implementations for methods of PValue. In particular, this includes functionality for getting/setting:

• The Pipeline that the PValue is part of.
• Whether the PValue has bee finalized (as an input or an output), after which its properties can no longer be changed.

For internal use.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	PValueBase()

Method Summary

Methods

Modifier and Type	Method and Description
java.util.Collection<? extends PValue>	expand() Expands this POutput into a list of its component output PValues.
void	finishSpecifying() After building, finalizes this PInput to make it ready for being used as an input to a PTransform.
protected java.lang.String	getKindString() Returns a String capturing the kind of this PValueBase.
java.lang.String	getName() Returns the name of this PValueBase.
Pipeline	getPipeline() Returns the owning Pipeline of this PValueBase.
boolean	isFinishedSpecifyingInternal() Returns whether this PValueBase has been finalized, and its core properties, e.g., name, can no longer be changed.
void	recordAsOutput(Pipeline pipeline, PTransform<?,?> transform) Records that this POutputValueBase is an output with the given name of the given PTransform in the given Pipeline.
protected void	recordAsOutput(Pipeline pipeline, PTransform<?,?> transform, java.lang.String outName) Records that this POutputValueBase is an output with the given name of the given PTransform in the given Pipeline.
PValueBase	setName(java.lang.String name) Sets the name of this PValueBase.
PValue	setPipelineInternal(Pipeline pipeline) Sets the owning Pipeline of this PValueBase.
java.lang.String	toString()

Methods inherited from class com.google.cloud.dataflow.sdk.values.POutputValueBase

finishSpecifyingOutput, getProducingTransformInternal

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.cloud.dataflow.sdk.values.PValue

getProducingTransformInternal

Methods inherited from interface com.google.cloud.dataflow.sdk.values.POutput

finishSpecifyingOutput

Constructor Detail

PValueBase

protected PValueBase()

Method Detail

getName

public java.lang.String getName()

Returns the name of this PValueBase.

By default, the name of a PValueBase is based on the name of the PTransform that produces it. It can be specified explicitly by calling setName(java.lang.String).

Specified by:

getName in interface PValue

Throws:

java.lang.IllegalStateException - if the name hasn't been set yet

setName

public PValueBase setName(java.lang.String name)

Sets the name of this PValueBase. Returns this.

Throws:

java.lang.IllegalStateException - if this PValueBase has already been finalized and is no longer settable, e.g., by having apply() called on it

getPipeline

public Pipeline getPipeline()

Returns the owning Pipeline of this PValueBase.

Specified by:

getPipeline in interface PInput

Throws:

java.lang.IllegalStateException - if the owning Pipeline hasn't been set yet

setPipelineInternal

public PValue setPipelineInternal(Pipeline pipeline)

Sets the owning Pipeline of this PValueBase. Returns this.

For internal use only.

Specified by:

setPipelineInternal in interface PValue

Throws:

java.lang.IllegalArgumentException - if the owner has already been set differently

recordAsOutput

public void recordAsOutput(Pipeline pipeline,
                  PTransform<?,?> transform)

Description copied from class: POutputValueBase

Records that this POutputValueBase is an output with the given name of the given PTransform in the given Pipeline.

To be invoked only by POutput.recordAsOutput(com.google.cloud.dataflow.sdk.Pipeline, com.google.cloud.dataflow.sdk.transforms.PTransform<?, ?>) implementations. Not to be invoked directly by user code.

Specified by:

recordAsOutput in interface POutput

Overrides:

recordAsOutput in class POutputValueBase

recordAsOutput

protected void recordAsOutput(Pipeline pipeline,
                  PTransform<?,?> transform,
                  java.lang.String outName)

Records that this POutputValueBase is an output with the given name of the given PTransform in the given Pipeline.

To be invoked only by POutput.recordAsOutput(com.google.cloud.dataflow.sdk.Pipeline, com.google.cloud.dataflow.sdk.transforms.PTransform<?, ?>) implementations. Not to be invoked directly by user code.

isFinishedSpecifyingInternal

public boolean isFinishedSpecifyingInternal()

Returns whether this PValueBase has been finalized, and its core properties, e.g., name, can no longer be changed.

For internal use only.

expand

public java.util.Collection<? extends PValue> expand()

Description copied from interface: POutput

Expands this POutput into a list of its component output PValues.

A PValue expands to itself.

A tuple or list of PValues (e.g., PCollectionTuple, and PCollectionList) expands to its component PValues.

Not intended to be invoked directly by user code.

Specified by:

expand in interface PInput

Specified by:

expand in interface POutput

finishSpecifying

public void finishSpecifying()

Description copied from interface: PInput

After building, finalizes this PInput to make it ready for being used as an input to a PTransform.

Automatically invoked whenever apply() is invoked on this PInput, so users do not normally call this explicitly.

Specified by:

finishSpecifying in interface PInput

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getKindString

protected java.lang.String getKindString()

Returns a String capturing the kind of this PValueBase.

By default, uses the base name of this PValueBase's class as its kind string.