Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[FLINK-13765][task] Introduce TwoInputSelectionHandler for selecting input in StreamTwoInputSelectableProcessor #9477

Merged
merged 1 commit into from
Aug 27, 2019

Conversation

zhijiangW
Copy link
Contributor

@zhijiangW zhijiangW commented Aug 18, 2019

What is the purpose of the change

In StreamTwoInputSelectableProcessor there are three fields {InputSelectable, InputSelection, availableInputsMask} to be used together for the function of selecting next available input index.

From design aspect, these fields can be abstracted into a separate component called TwoInputSelectionHandler, which is passed into the constructor of StreamTwoInputSelectableProcessor as a final field. So the internal implementation details of TwoInputSelectionHandler is hidden from processor view which only needs to interact with exposed methods from selection handler.

Another tiny benefit is that we make the StreamTwoInputSelectableProcessor a bit because two methods are removed from it.

Brief change log

  • Introduce the TwoInputSelectionHandler for handling the logic of next available input index
  • Refactor the related process in StreamTwoInputSelectableProcessor based on InputSelectionHandler

Verifying this change

This change is a trivial rework / code cleanup without any test coverage.

Does this pull request potentially affect one of the following parts:

  • Dependencies (does it add or upgrade a dependency): (yes / no)
  • The public API, i.e., is any changed class annotated with @Public(Evolving): (yes / no)
  • The serializers: (yes / no / don't know)
  • The runtime per-record code paths (performance sensitive): (yes / no / don't know)
  • Anything that affects deployment or recovery: JobManager (and its components), Checkpointing, Yarn/Mesos, ZooKeeper: (yes / no / don't know)
  • The S3 file system connector: (yes / no / don't know)

Documentation

  • Does this pull request introduce a new feature? (yes / no)
  • If yes, how is the feature documented? (not applicable / docs / JavaDocs / not documented)

@flinkbot
Copy link
Collaborator

flinkbot commented Aug 18, 2019

Thanks a lot for your contribution to the Apache Flink project. I'm the @flinkbot. I help the community
to review your pull request. We will use this comment to track the progress of the review.

Automated Checks

Last check on commit e21b3e5 (Tue Aug 27 09:18:34 UTC 2019)

Warnings:

  • No documentation files were touched! Remember to keep the Flink docs up to date!

Mention the bot in a comment to re-run the automated checks.

Review Progress

  • ❓ 1. The [description] looks good.
  • ❓ 2. There is [consensus] that the contribution should go into to Flink.
  • ❓ 3. Needs [attention] from.
  • ❓ 4. The change fits into the overall [architecture].
  • ❓ 5. Overall code [quality] is good.

Please see the Pull Request Review Guide for a full explanation of the review process.


The Bot is tracking the review progress through labels. Labels are applied according to the order of the review items. For consensus, approval by a Flink committer of PMC member is required Bot commands
The @flinkbot bot supports the following commands:

  • @flinkbot approve description to approve one or more aspects (aspects: description, consensus, architecture and quality)
  • @flinkbot approve all to approve all aspects
  • @flinkbot approve-until architecture to approve everything until architecture
  • @flinkbot attention @username1 [@username2 ..] to require somebody's attention
  • @flinkbot disapprove architecture to remove an approval you gave earlier

@flinkbot
Copy link
Collaborator

flinkbot commented Aug 18, 2019

CI report:

Copy link
Contributor

@pnowojski pnowojski left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure how big value has this PR. Yes, you have encapsulated 3 fields, that's a plus, but very little logic was extracted. For example you replaced inputSelection.isALLMaskOf2() with inputSelectionHandler.isALLInputsSelected(). Or inputSelection.isInputSelected(1) with inputSelectionHandler.isFirstInputSelected(). However if you prefer it this way +1 from my side.

Feel free to merge this once you checked my comments

@zhijiangW
Copy link
Contributor Author

zhijiangW commented Aug 23, 2019

Thanks for this review @pnowojski !

Actually this PR would not be a blocker for the following work as I misleading before. If just from the design aspect, the benefits might not be very obvious as you mentioned. My previous thought:

  • We could make StreamTwoInputSelectableProcessor a bit thin after refactoring, because we remove two non-final vars and two methods from the processor.

  • In previous way, StreamTwoInputSelectableProcessor would involve in three fields {InputSelectable, InputSelection, availableInputsMask} to expose too many details. After refactoring, the processor only interacts with one component and some details are hidden behind.

I could understand your concern and it would be better if we could further reduce some complex interactive logics provided by TwoInputSelectionHandler.
So I think this pr can be pending now, and after we find something very confirmable to be done, we can merge then.

@pnowojski
Copy link
Contributor

As I wrote before, please feel free to merge this. Keeping it open for "rethinking" in the future it's probably a bad idea.

@zhijiangW zhijiangW changed the title [FLINK-13765][task] Introduce the InputSelectionHandler for selecting next input in StreamTwoInputSelectableProcessor [FLINK-13765][task] Introduce TwoInputSelectionHandler for selecting input in StreamTwoInputSelectableProcessor Aug 27, 2019
…ing input in StreamTwoInputSelectableProcessor

In StreamTwoInputSelectableProcessor there are three fields {InputSelectable, InputSelection, availableInputsMask} to
be used together for the function of selecting next available input index.

From design aspect, these fields can be abstracted into a separate component called TwoInputSelectionHandler, which is
passed into the constructor of StreamTwoInputSelectableProcessor as a final field. So the internal implementation details
of TwoInputSelectionHandler is hidden from processor view which only needs to interact with exposed methods from selection handler.

Another tiny benefit is that we make the StreamTwoInputSelectableProcessor a bit because two methods are removed from it.
@zhijiangW
Copy link
Contributor Author

Thanks for the confirmation and I would merge it after travis green. @pnowojski

@zhijiangW
Copy link
Contributor Author

@flinkbot run travis

@zhijiangW zhijiangW merged commit 261c2dc into apache:master Aug 27, 2019
@zhijiangW zhijiangW deleted the FLINK-13765 branch August 27, 2019 07:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
4 participants