Thomas Groh created BEAM-1949:
---------------------------------

             Summary: Rename DoFn.Context#sideOutput to #output
                 Key: BEAM-1949
                 URL: https://issues.apache.org/jira/browse/BEAM-1949
             Project: Beam
          Issue Type: Improvement
          Components: sdk-java-core
            Reporter: Thomas Groh
            Assignee: Thomas Groh


Having two methods, both named output, one which takes the "main output type" 
and one that takes a tag to specify the type more clearly communicates the 
actual behavior - sideOutput isn't a "special" way to output, it's the same as 
output(T), just to a specified PCollection. This will help pipeline authors 
understand the actual behavior of outputting to a tag, and detangle it from 
"sideInput", which is a special way to receive input. Giving them the same name 
means that it's not even strange to call output and provide the main output 
type, which is what we want - it's a more specific way to output, but does not 
have different restrictions or capabilities.

This is also a pretty small change within the SDK - it touches about 20 files, 
and the changes are pretty automatic.



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)

Reply via email to