Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
org.apache.beam.sdk.util.IOChannelFactory This is under redesign, see: https://issues.apache.org/jira/browse/BEAM-59.
org.apache.beam.sdk.util.state.StateTag.StateBinder for migration only; runners should reference the top level StateBinder and move towards StateSpec rather than StateTag.
org.apache.beam.sdk.testing.StreamingIT

Deprecated Classes

Class and Description
org.apache.beam.sdk.util.AttemptAndTimeBoundedExponentialBackOff
org.apache.beam.sdk.util.AttemptBoundedExponentialBackOff
org.apache.beam.sdk.transforms.Combine.SimpleCombineFn
org.apache.beam.sdk.util.IntervalBoundedExponentialBackOff
org.apache.beam.sdk.util.PCollectionViews.IterablePCollectionView Runners should not inspect the PCollectionView subclass, as it is an implementation detail. To specialize a side input, a runner should inspect the language-independent metadata of the ViewFn.
org.apache.beam.sdk.util.PCollectionViews.ListPCollectionView Runners should not inspect the PCollectionView subclass, as it is an implementation detail. To specialize a side input, a runner should inspect the language-independent metadata of the ViewFn.
org.apache.beam.sdk.util.PCollectionViews.MapPCollectionView Runners should not inspect the PCollectionView subclass, as it is an implementation detail. To specialize a side input, a runner should inspect the language-independent metadata of the ViewFn.
org.apache.beam.sdk.util.PCollectionViews.MultimapPCollectionView Runners should not inspect the PCollectionView subclass, as it is an implementation detail. To specialize a side input, a runner should inspect the language-independent metadata of the ViewFn.
org.apache.beam.sdk.util.PCollectionViews.SingletonPCollectionView Runners should not inspect the PCollectionView subclass, as it is an implementation detail. To specialize a side input, a runner should inspect the language-independent metadata of the ViewFn.

Deprecated Fields

Field and Description
org.apache.beam.sdk.util.AppEngineEnvironment.IS_APP_ENGINE

Deprecated Methods

Method and Description
org.apache.beam.sdk.util.state.StateSpecs.adaptTagBinder(StateTag.StateBinder<K>) for migration purposes only
org.apache.beam.sdk.io.PubsubIO.PubsubSubscription.asV1Beta1Path() the v1beta1 API for Cloud Pub/Sub is deprecated.
org.apache.beam.sdk.io.PubsubIO.PubsubTopic.asV1Beta1Path() the v1beta1 API for Cloud Pub/Sub is deprecated.
org.apache.beam.sdk.io.PubsubIO.PubsubSubscription.asV1Beta2Path() the v1beta2 API for Cloud Pub/Sub is deprecated.
org.apache.beam.sdk.io.PubsubIO.PubsubTopic.asV1Beta2Path() the v1beta2 API for Cloud Pub/Sub is deprecated.
org.apache.beam.sdk.util.state.StateTag.bind(StateTag.StateBinder<? extends K>) Use the StateSpec.bind(java.lang.String, org.apache.beam.sdk.util.state.StateBinder<? extends K>) method via StateTag.getSpec() for now.
org.apache.beam.sdk.coders.AvroCoder.createDatumReader() For AvroCoder internal use only.
org.apache.beam.sdk.coders.AvroCoder.createDatumWriter() For AvroCoder internal use only.
org.apache.beam.sdk.util.state.StateContexts.createFromComponents(PipelineOptions, WindowingInternals<?, ?>, W) This exists only for temporary compatibility with Dataflow worker and should be deleted once a worker image is released that uses runners-core build after https://github.com/apache/beam/pull/1353.
org.apache.beam.sdk.util.TimerInternals.deleteTimer(StateNamespace, String) use TimerInternals.deleteTimer(StateNamespace, String, TimeDomain).
org.apache.beam.sdk.util.TimerInternals.deleteTimer(TimerInternals.TimerData) use TimerInternals.deleteTimer(StateNamespace, String, TimeDomain).
org.apache.beam.sdk.values.PValue.expand()
org.apache.beam.sdk.values.POutput.finishSpecifyingOutput(PInput, PTransform<?, ?>) see BEAM-1199
org.apache.beam.sdk.values.PCollectionView.getCoderInternal() this method will be removed entirely. The PCollection underlying a side input, including its Coder, is part of the side input's specification with a ParDo transform, which will obtain that information via a package-private channel.
org.apache.beam.sdk.util.IdentityWindowFn.getOutputTime(Instant, BoundedWindow)
org.apache.beam.sdk.values.PValue.getProducingTransformInternal()
org.apache.beam.sdk.values.PCollectionView.getTagInternal() this method will be removed entirely. The PCollection underlying a side input, is part of the side input's specification with a ParDo transform, which will obtain that information via a package-private channel.
org.apache.beam.sdk.values.PCollectionView.getViewFn() this method will be removed entirely. The ViewFn for a side input is an attribute of the side input's specification with a ParDo transform, which will obtain this specification via a package-private channel.
org.apache.beam.sdk.values.PCollectionView.getWindowingStrategyInternal() this method will be removed entirely. The PCollection underlying a side input, including its WindowingStrategy, is part of the side input's specification with a ParDo transform, which will obtain that information via a package-private channel.
org.apache.beam.sdk.transforms.reflect.DoFnInvokers.invokerFor(Serializable)
org.apache.beam.sdk.transforms.reflect.DoFnSignature.isStateful() use DoFnSignature.usesState(), it's cleaner
org.apache.beam.sdk.transforms.windowing.AfterDelayFromFirstElement.mappedTo(SerializableFunction<Instant, Instant>) This will be removed in the next major version. Please use only AfterDelayFromFirstElement.plusDelayOf(org.joda.time.Duration) and AfterDelayFromFirstElement.alignedTo(org.joda.time.Duration, org.joda.time.Instant).
org.apache.beam.sdk.util.Transport.newPubsubClient(PubsubOptions) Use an appropriate PubsubClient.PubsubClientFactory
org.apache.beam.sdk.transforms.Combine.SimpleCombineFn.of(SerializableFunction<Iterable<V>, V>)
org.apache.beam.sdk.coders.protobuf.ProtoCoder.of(String, List<String>) For JSON deserialization only.
org.apache.beam.sdk.util.IOChannelUtils.registerIOFactoriesAllowOverride(PipelineOptions) This is currently to provide different configurations for tests and is still public for IOChannelFactory redesign purposes.
org.apache.beam.sdk.util.IOChannelUtils.registerStandardIOFactories(PipelineOptions) use IOChannelUtils.registerIOFactories(org.apache.beam.sdk.options.PipelineOptions).
org.apache.beam.sdk.util.TimerInternals.setTimer(TimerInternals.TimerData) use TimerInternals.setTimer(StateNamespace, String, Instant, TimeDomain).
org.apache.beam.sdk.io.CountingSource.unbounded() use CountingInput.unbounded() instead
org.apache.beam.sdk.io.CountingSource.unboundedWithTimestampFn(SerializableFunction<Long, Instant>) use CountingInput.unbounded() and call CountingInput.UnboundedCountingInput.withTimestampFn(SerializableFunction) instead
org.apache.beam.sdk.io.CountingSource.upTo(long) use CountingInput.upTo(long) instead
org.apache.beam.sdk.util.WindowedValue.valueInEmptyWindows(T) a value in no windows technically is not "in" a PCollection. It is allowed to drop it at any point, and benign runner implementation details could cause silent data loss.
org.apache.beam.sdk.util.WindowedValue.valueInEmptyWindows(T, PaneInfo) a value in no windows technically is not "in" a PCollection. It is allowed to drop it at any point, and benign runner implementation details could cause silent data loss.
org.apache.beam.sdk.util.state.StateContexts.windowOnly(W) This exists only for temporary compatibility with Dataflow worker and should be deleted once a worker image is released that uses runners-core build after https://github.com/apache/beam/pull/1353.
org.apache.beam.sdk.transforms.View.AsMap.withSingletonValues() this method simply returns this AsMap unmodified

Deprecated Constructors

Constructor and Description
org.apache.beam.sdk.Pipeline(PipelineRunner<?>) replaced by Pipeline.Pipeline(PipelineRunner, PipelineOptions)
org.apache.beam.sdk.util.RetryHttpRequestInitializer(HttpRequestInitializer) use RetryHttpRequestInitializer.RetryHttpRequestInitializer(com.google.api.client.http.HttpRequestInitializer, com.google.api.client.util.NanoClock, com.google.api.client.util.Sleeper, java.util.Collection<java.lang.Integer>, com.google.api.client.http.HttpResponseInterceptor).
org.apache.beam.sdk.util.RetryHttpRequestInitializer(HttpRequestInitializer, Collection<Integer>) use RetryHttpRequestInitializer.RetryHttpRequestInitializer(Collection).
org.apache.beam.sdk.util.RetryHttpRequestInitializer(HttpRequestInitializer, Collection<Integer>, HttpResponseInterceptor) use RetryHttpRequestInitializer.RetryHttpRequestInitializer(Collection, HttpResponseInterceptor).