/* * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file * distributed with this work for additional information * regarding copyright ownership. The ASF licenses this file * to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance * with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package org.apache.beam.runners.direct; import java.io.Closeable; import java.util.ArrayList; import java.util.Collection; import java.util.concurrent.Callable; import org.apache.beam.runners.core.metrics.MetricUpdates; import org.apache.beam.runners.core.metrics.MetricsContainerImpl; import org.apache.beam.sdk.metrics.MetricsEnvironment; import org.apache.beam.sdk.runners.AppliedPTransform; import org.apache.beam.sdk.util.WindowedValue; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * A {@link Callable} responsible for constructing a {@link TransformEvaluator} from a * {@link TransformEvaluatorFactory} and evaluating it on some bundle of input, and registering * the result using a registered {@link CompletionCallback}. * * <p>A {@link TransformExecutor} that is currently executing also provides access to the thread * that it is being executed on. */ class TransformExecutor<T> implements Runnable { private static final Logger LOG = LoggerFactory.getLogger(TransformExecutor.class); public static <T> TransformExecutor<T> create( EvaluationContext context, TransformEvaluatorFactory factory, Iterable<? extends ModelEnforcementFactory> modelEnforcements, CommittedBundle<T> inputBundle, AppliedPTransform<?, ?, ?> transform, CompletionCallback completionCallback, TransformExecutorService transformEvaluationState) { return new TransformExecutor<>( context, factory, modelEnforcements, inputBundle, transform, completionCallback, transformEvaluationState); } private final TransformEvaluatorFactory evaluatorFactory; private final Iterable<? extends ModelEnforcementFactory> modelEnforcements; /** The transform that will be evaluated. */ private final AppliedPTransform<?, ?, ?> transform; /** The inputs this {@link TransformExecutor} will deliver to the transform. */ private final CommittedBundle<T> inputBundle; private final CompletionCallback onComplete; private final TransformExecutorService transformEvaluationState; private final EvaluationContext context; private TransformExecutor( EvaluationContext context, TransformEvaluatorFactory factory, Iterable<? extends ModelEnforcementFactory> modelEnforcements, CommittedBundle<T> inputBundle, AppliedPTransform<?, ?, ?> transform, CompletionCallback completionCallback, TransformExecutorService transformEvaluationState) { this.evaluatorFactory = factory; this.modelEnforcements = modelEnforcements; this.inputBundle = inputBundle; this.transform = transform; this.onComplete = completionCallback; this.transformEvaluationState = transformEvaluationState; this.context = context; } @Override public void run() { MetricsContainerImpl metricsContainer = new MetricsContainerImpl(transform.getFullName()); try (Closeable metricsScope = MetricsEnvironment.scopedMetricsContainer(metricsContainer)) { Collection<ModelEnforcement<T>> enforcements = new ArrayList<>(); for (ModelEnforcementFactory enforcementFactory : modelEnforcements) { ModelEnforcement<T> enforcement = enforcementFactory.forBundle(inputBundle, transform); enforcements.add(enforcement); } TransformEvaluator<T> evaluator = evaluatorFactory.forApplication(transform, inputBundle); if (evaluator == null) { onComplete.handleEmpty(transform); // Nothing to do return; } processElements(evaluator, metricsContainer, enforcements); finishBundle(evaluator, metricsContainer, enforcements); } catch (Exception e) { onComplete.handleException(inputBundle, e); if (e instanceof RuntimeException) { throw (RuntimeException) e; } throw new RuntimeException(e); } catch (Error err) { LOG.error("Error occurred within {}", this, err); onComplete.handleError(err); throw err; } finally { // Report the physical metrics from the end of this step. context.getMetrics().commitPhysical(inputBundle, metricsContainer.getCumulative()); transformEvaluationState.complete(this); } } /** * Processes all the elements in the input bundle using the transform evaluator, applying any * necessary {@link ModelEnforcement ModelEnforcements}. */ private void processElements( TransformEvaluator<T> evaluator, MetricsContainerImpl metricsContainer, Collection<ModelEnforcement<T>> enforcements) throws Exception { if (inputBundle != null) { for (WindowedValue<T> value : inputBundle.getElements()) { for (ModelEnforcement<T> enforcement : enforcements) { enforcement.beforeElement(value); } evaluator.processElement(value); // Report the physical metrics after each element MetricUpdates deltas = metricsContainer.getUpdates(); if (deltas != null) { context.getMetrics().updatePhysical(inputBundle, deltas); metricsContainer.commitUpdates(); } for (ModelEnforcement<T> enforcement : enforcements) { enforcement.afterElement(value); } } } } /** * Finishes processing the input bundle and commit the result using the * {@link CompletionCallback}, applying any {@link ModelEnforcement} if necessary. * * @return the {@link TransformResult} produced by * {@link TransformEvaluator#finishBundle()} */ private TransformResult<T> finishBundle( TransformEvaluator<T> evaluator, MetricsContainerImpl metricsContainer, Collection<ModelEnforcement<T>> enforcements) throws Exception { TransformResult<T> result = evaluator.finishBundle().withLogicalMetricUpdates(metricsContainer.getCumulative()); CommittedResult outputs = onComplete.handleResult(inputBundle, result); for (ModelEnforcement<T> enforcement : enforcements) { enforcement.afterFinish(inputBundle, result, outputs.getOutputs()); } return result; } }