Skip to content

MINOR: Docs on state store instantiation - #5698

Merged
guozhangwang merged 4 commits into
apache:trunkfrom
guozhangwang:KMinor-customized-store-docs
Oct 3, 2018
Merged

MINOR: Docs on state store instantiation#5698
guozhangwang merged 4 commits into
apache:trunkfrom
guozhangwang:KMinor-customized-store-docs

Conversation

@guozhangwang

Copy link
Copy Markdown
Contributor

Committer Checklist (excluded from commit message)

  • Verify design and implementation
  • Verify test coverage and CI build status
  • Verify documentation (including upgrade notes)

@bbejeck bbejeck left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thanks @guozhangwang LGTM

* The implementation of this function must register the root store in the context via the
* {@link ProcessorContext#register(StateStore, StateRestoreCallback)} function, where the
* first {@code StateStore} parameter should always be the passed-in {@code root} object, and the
* second {@code StateRestoreCallback} is what users need to instantiate.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

what users need to instantiate

Unclear what this means.

* {@link ProcessorContext#register(StateStore, StateRestoreCallback)} function, where the
* first {@code StateStore} parameter should always be the passed-in {@code root} object, and the
* second {@code StateRestoreCallback} is what users need to instantiate.
*

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

nit: add <p>

*
* Note that if the state store implementation itself supports bulk writes, users can implement another
* interface {@link BatchingStateRestoreCallback} which extends {@link StateRestoreCallback} and could
* let users instantiate bulk-load restoration logic instead of restoring one record at a time.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

let users instantiate -- who is "users" ?

@mjsax mjsax left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM.

One minor formatting nit. Feel free to merge.

/**
* Initializes this state store
* Initializes this state store.
*

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

If we want a new paragraph, we need to insert <p> here.

@guozhangwang
guozhangwang merged commit 7bd8ada into apache:trunk Oct 3, 2018
@guozhangwang
guozhangwang deleted the KMinor-customized-store-docs branch October 3, 2018 18:20
pengxiaolong pushed a commit to pengxiaolong/kafka that referenced this pull request Jun 14, 2019
Reviewers: Bill Bejeck <bill@confluent.io>, Matthias J. Sax <matthias@confluent.io>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants