[GitHub] [flink] becketqin opened a new pull request #10486: [FLINK-15131][connector/source] Add the APIs for Source (FLIP-27).

[GitBox <gi...@apache.org>]

becketqin opened a new pull request #10486: [FLINK-15131][connector/source] Add the APIs for Source (FLIP-27).
URL: https://github.com/apache/flink/pull/10486
 
 
   ## What is the purpose of the change
   Add the top tier interfaces for FLIP-27. These classes are prerequisite for the rest of the PRs of FLIP-27. See the [FLIP wiki](https://cwiki.apache.org/confluence/display/FLINK/FLIP-27%3A+Refactor+Source+Interface#FLIP-27:RefactorSourceInterface-Toplevelpublicinterfaces) for more details.
   
   ## Brief change log
   The classes introduced include: 
   - Boundedness - A enum indicating whether the input stream is Bounded or Unbounded
   - Source - A factory style class that helps create SplitEnumerator and SourceReader at runtime.
   - SourceSplit - An interface for all the split types.
   - SplitEnumerator - Discover the splits and assign them to the SourceReaders
   - SplitEnumeratorContext - Provide necessary information to the SplitEnumerator to assign splits and send custom events to the the SourceReaders.
   - SplitAssignment - A container class holding the source split assignment for each subtask.
   - SourceReader - Read the records from the splits assigned by the SplitEnumerator.
   - ReaderInfo - A container class about reader information.
   - SourceReaderContext - Provide necessary function to the SourceReader to communicate with SplitEnumerator.
   - SourceOutput - A collector style interface to take the records and timestamps emit by the SourceReader.
   
   ## Verifying this change
   
   *(Please pick either of the following options)*
   
   This change is a trivial rework / code cleanup without any test coverage.
   
   *(or)*
   
   This change is already covered by existing tests, such as *(please describe tests)*.
   
   *(or)*
   
   This change only introduces the interfaces, so there is no tests needed.
   
   ## Does this pull request potentially affect one of the following parts:
   
     - Dependencies (does it add or upgrade a dependency): (no)
     - The public API, i.e., is any changed class annotated with `@Public(Evolving)`: (yes)
     - The serializers: (no)
     - The runtime per-record code paths (performance sensitive): (no)
     - Anything that affects deployment or recovery: JobManager (and its components), Checkpointing, Yarn/Mesos, ZooKeeper: (no)
     - The S3 file system connector: (no)
   
   ## Documentation
   
     - Does this pull request introduce a new feature? (yes)
     - If yes, how is the feature documented? (JavaDocs, FLIP)
   

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services