| /* |
| * 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.wayang.java.operators; |
| |
| import java.util.Arrays; |
| import java.util.Collection; |
| import java.util.Collections; |
| import java.util.List; |
| import java.util.Optional; |
| import java.util.function.Predicate; |
| import org.apache.wayang.basic.operators.LoopOperator; |
| import org.apache.wayang.core.api.Configuration; |
| import org.apache.wayang.core.function.PredicateDescriptor; |
| import org.apache.wayang.core.optimizer.OptimizationContext; |
| import org.apache.wayang.core.optimizer.costs.LoadProfileEstimator; |
| import org.apache.wayang.core.optimizer.costs.LoadProfileEstimators; |
| import org.apache.wayang.core.plan.wayangplan.ExecutionOperator; |
| import org.apache.wayang.core.platform.ChannelDescriptor; |
| import org.apache.wayang.core.platform.ChannelInstance; |
| import org.apache.wayang.core.platform.lineage.ExecutionLineageNode; |
| import org.apache.wayang.core.types.DataSetType; |
| import org.apache.wayang.core.util.Tuple; |
| import org.apache.wayang.java.channels.CollectionChannel; |
| import org.apache.wayang.java.channels.JavaChannelInstance; |
| import org.apache.wayang.java.channels.StreamChannel; |
| import org.apache.wayang.java.execution.JavaExecutor; |
| |
| /** |
| * Java implementation of the {@link LoopOperator}. |
| */ |
| public class JavaLoopOperator<InputType, ConvergenceType> |
| extends LoopOperator<InputType, ConvergenceType> |
| implements JavaExecutionOperator { |
| |
| |
| /** |
| * Creates a new instance. |
| */ |
| public JavaLoopOperator(DataSetType<InputType> inputType, |
| DataSetType<ConvergenceType> convergenceType, |
| PredicateDescriptor.SerializablePredicate<Collection<ConvergenceType>> criterionPredicate, |
| Integer numExpectedIterations) { |
| super(inputType, convergenceType, criterionPredicate, numExpectedIterations); |
| } |
| |
| public JavaLoopOperator(DataSetType<InputType> inputType, |
| DataSetType<ConvergenceType> convergenceType, |
| PredicateDescriptor<Collection<ConvergenceType>> criterionDescriptor, |
| Integer numExpectedIterations) { |
| super(inputType, convergenceType, criterionDescriptor, numExpectedIterations); |
| } |
| |
| /** |
| * Creates a copy of the given {@link LoopOperator}. |
| * |
| * @param that should be copied |
| */ |
| public JavaLoopOperator(LoopOperator<InputType, ConvergenceType> that) { |
| super(that); |
| } |
| |
| @Override |
| @SuppressWarnings("unchecked") |
| public Tuple<Collection<ExecutionLineageNode>, Collection<ChannelInstance>> evaluate( |
| ChannelInstance[] inputs, |
| ChannelInstance[] outputs, |
| JavaExecutor javaExecutor, |
| OptimizationContext.OperatorContext operatorContext) { |
| assert inputs.length == this.getNumInputs(); |
| assert outputs.length == this.getNumOutputs(); |
| |
| final ExecutionLineageNode executionLineageNode = new ExecutionLineageNode(operatorContext); |
| executionLineageNode.addAtomicExecutionFromOperatorContext(); |
| |
| final Predicate<Collection<ConvergenceType>> stoppingCondition = |
| javaExecutor.getCompiler().compile(this.criterionDescriptor); |
| JavaExecutor.openFunction(this, stoppingCondition, inputs, operatorContext); |
| |
| boolean endloop = false; |
| final Collection<ConvergenceType> convergenceCollection; |
| final JavaChannelInstance input; |
| switch (this.getState()) { |
| case NOT_STARTED: |
| assert inputs[INITIAL_INPUT_INDEX] != null; |
| assert inputs[INITIAL_CONVERGENCE_INPUT_INDEX] != null; |
| |
| input = (JavaChannelInstance) inputs[INITIAL_INPUT_INDEX]; |
| JavaExecutionOperator.forward(inputs[INITIAL_CONVERGENCE_INPUT_INDEX], outputs[ITERATION_CONVERGENCE_OUTPUT_INDEX]); |
| break; |
| case RUNNING: |
| assert inputs[ITERATION_INPUT_INDEX] != null; |
| assert inputs[ITERATION_CONVERGENCE_INPUT_INDEX] != null; |
| |
| input = (JavaChannelInstance) inputs[ITERATION_INPUT_INDEX]; |
| convergenceCollection = ((CollectionChannel.Instance) inputs[ITERATION_CONVERGENCE_INPUT_INDEX]).provideCollection(); |
| |
| endloop = stoppingCondition.test(convergenceCollection); |
| |
| JavaExecutionOperator.forward(inputs[ITERATION_CONVERGENCE_INPUT_INDEX], outputs[ITERATION_CONVERGENCE_OUTPUT_INDEX]); |
| executionLineageNode.addPredecessor(inputs[ITERATION_CONVERGENCE_INPUT_INDEX].getLineage()); |
| break; |
| default: |
| throw new IllegalStateException(String.format("%s is finished, yet executed.", this)); |
| |
| } |
| |
| if (endloop) { |
| // final loop output |
| JavaExecutionOperator.forward(input, outputs[FINAL_OUTPUT_INDEX]); |
| outputs[ITERATION_OUTPUT_INDEX] = null; |
| outputs[ITERATION_CONVERGENCE_OUTPUT_INDEX] = null; |
| this.setState(State.FINISHED); |
| } else { |
| outputs[FINAL_OUTPUT_INDEX] = null; |
| JavaExecutionOperator.forward(input, outputs[ITERATION_OUTPUT_INDEX]); |
| this.setState(State.RUNNING); |
| } |
| |
| return executionLineageNode.collectAndMark(); |
| } |
| |
| @Override |
| public String getLoadProfileEstimatorConfigurationKey() { |
| return "wayang.java.loop.load"; |
| } |
| |
| @Override |
| public Optional<LoadProfileEstimator> createLoadProfileEstimator(Configuration configuration) { |
| final Optional<LoadProfileEstimator> optEstimator = |
| JavaExecutionOperator.super.createLoadProfileEstimator(configuration); |
| LoadProfileEstimators.nestUdfEstimator(optEstimator, this.criterionDescriptor, configuration); |
| return optEstimator; |
| } |
| |
| @Override |
| protected ExecutionOperator createCopy() { |
| return new JavaLoopOperator<>(this.getInputType(), |
| this.getConvergenceType(), |
| this.getCriterionDescriptor().getJavaImplementation(), |
| this.getNumExpectedIterations() |
| ); |
| } |
| |
| @Override |
| public List<ChannelDescriptor> getSupportedInputChannels(int index) { |
| assert index <= this.getNumInputs() || (index == 0 && this.getNumInputs() == 0); |
| switch (index) { |
| case INITIAL_INPUT_INDEX: |
| case ITERATION_INPUT_INDEX: |
| return Arrays.asList(CollectionChannel.DESCRIPTOR, StreamChannel.DESCRIPTOR); |
| case INITIAL_CONVERGENCE_INPUT_INDEX: |
| case ITERATION_CONVERGENCE_INPUT_INDEX: |
| return Collections.singletonList(CollectionChannel.DESCRIPTOR); |
| default: |
| throw new IllegalStateException(String.format("%s has no %d-th input.", this, index)); |
| } |
| } |
| |
| @Override |
| public List<ChannelDescriptor> getSupportedOutputChannels(int index) { |
| assert index <= this.getNumOutputs() || (index == 0 && this.getNumOutputs() == 0); |
| switch (index) { |
| case ITERATION_OUTPUT_INDEX: |
| case FINAL_OUTPUT_INDEX: |
| return Collections.singletonList(StreamChannel.DESCRIPTOR); |
| case INITIAL_CONVERGENCE_INPUT_INDEX: |
| case ITERATION_CONVERGENCE_INPUT_INDEX: |
| return Collections.singletonList(CollectionChannel.DESCRIPTOR); |
| default: |
| throw new IllegalStateException(String.format("%s has no %d-th input.", this, index)); |
| } // TODO: In this specific case, the actual output Channel is context-sensitive because we could forward Streams/Collections. |
| } |
| |
| |
| } |