org.apache.flink.api.java.functions

Annotation Type FunctionAnnotation.ConstantFieldsSecondExcept

@Target(value=TYPE)
@Retention(value=RUNTIME)
public static @interface FunctionAnnotation.ConstantFieldsSecondExcept

This annotation declares that a function changes certain fields of its second input value, while leaving all others unmodified and in place in the return value. The annotation is applicable to binary functions, like for example RichFlatJoinFunction, RichCoGroupFunction, or RichCrossFunction.

The following example illustrates a join function that copies fields from the first and second input to the return value:

 \@ConstantFieldsSecondExcept("1")
 public class MyJoin extends JoinFunction, Tuple3, Tuple3>
 {
     public Tuple3 map(Tuple2 first, Tuple3 second) {
         return Tuple3(second.f0, first.f1, second.f2);
     }
 }
 

The annotation takes one String array specifying the positions of the input types that do not remain constant. When this annotation is used, it is assumed that all other values remain at the same position in input and output. To model more complex situations use the FunctionAnnotation.ConstantFieldss annotation.

This annotation is mutually exclusive with the FunctionAnnotation.ConstantFieldsSecond

If neither this annotation, nor the FunctionAnnotation.ConstantFieldsSecond annotation are set, it is assumed that no field in the second input is forwarded/copied unmodified.

See Also:

FunctionAnnotation.ConstantFieldsFirst, FunctionAnnotation.ConstantFieldsFirstExcept, FunctionAnnotation.ConstantFieldsSecond

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
String[]	value

Element Detail

value

public abstract String[] value