Skip to content

KAFKA-20779: KIP-1265 review follow-ups from #21337#22772

Open
ashwinpankaj wants to merge 1 commit into
apache:trunkfrom
ashwinpankaj:ashwinpankaj/KIP-1265-followups
Open

KAFKA-20779: KIP-1265 review follow-ups from #21337#22772
ashwinpankaj wants to merge 1 commit into
apache:trunkfrom
ashwinpankaj:ashwinpankaj/KIP-1265-followups

Conversation

@ashwinpankaj

@ashwinpankaj ashwinpankaj commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Follow-up nits from @chia7712's review of #21337. None affects
checker behaviour; grouped as a single small PR.

JIRA: KAFKA-20779

Changes

# File Change
1 core/…/PublicApiViolation.java equals uses Objects.equals(memberName, …) instead of the ternary null-check.
2 core/…/CascadeValidator.java asSuppression omits #member when the finding has no memberName, so class-scope INVALID_SUPERTYPE suppressions no longer render as …Owner#null.
3 maven-plugin/…/KafkaInternalApiCheckerMojo.java Doc comments + @param tags on the class default ctor + six setters; :maven-plugin:javadoc is now warning-free.
4 api-checker/build.gradle Adds testLogging { events "passed", "skipped", "failed" } for consistency with the main Kafka build.
5 Root build.gradle Extends the root check task to depend on :api-checker:core:check, :api-checker:gradle-plugins:check, and :api-checker:maven-plugin:check. Since .github/workflows/build.yml runs ./gradlew check on every PR, the composite build's checkstyle + unit tests (incl. PluginXmlParityTest) are now exercised in the standard PR workflow.
6 api-checker/README.md Documents :maven-plugin:test; layout tree shows the test folder; "CI integration" section rewritten to reflect the new wiring.

Test plan

  • ./gradlew check -x test — clean end-to-end in 7m 38s; all 13 api-checker verification tasks appear in the plan and pass.
  • ./gradlew :api-checker:maven-plugin:javadoc — zero warnings.
  • ./gradlew check --dry-run confirms :api-checker:*:check / :test / :checkstyle* now show up under root check.

Reviewers: Chia-Ping Tsai chia7712@gmail.com

Addresses reviewer feedback (chia7712) on the merged KIP-1265 PR:

- PublicApiViolation.equals: collapse the null-safe branch to
  Objects.equals(memberName, that.memberName).
- CascadeValidator.asSuppression: omit "#member" when the finding has
  no memberName so class-scope INVALID_SUPERTYPE suppressions no longer
  render as "…Owner#null".
- KafkaInternalApiCheckerMojo: add doc comments and @param tags to the
  class default constructor and the six setters so
  :api-checker:maven-plugin:javadoc is warning-free.
- api-checker/build.gradle: add testLogging { events "passed",
  "skipped", "failed" } to the shared subprojects test config for
  consistency with the rest of the build.
- Root build.gradle: extend the root `check` task to depend on the
  composite-included api-checker's :core:check, :gradle-plugins:check,
  and :maven-plugin:check. `.github/workflows/build.yml` runs
  ./gradlew check on every PR, so this wires the api-checker's
  checkstyle + unit tests (including PluginXmlParityTest) into the
  standard PR workflow.
- api-checker/README.md: document :maven-plugin:test (including
  PluginXmlParityTest), update the layout tree to show the test folder,
  and rewrite the "CI integration" section to reflect the new wiring.

./gradlew check -x test — clean, 7m 38s, exercises all 13 api-checker
verification tasks alongside every other module.
./gradlew :api-checker:maven-plugin:javadoc — no warnings.
@github-actions github-actions Bot added triage PRs from the community build Gradle build or GitHub Actions small Small PRs labels Jul 7, 2026
@ashwinpankaj ashwinpankaj marked this pull request as ready for review July 7, 2026 04:37
@chia7712 chia7712 self-requested a review July 9, 2026 11:26

@chia7712 chia7712 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.

@ashwinpankaj thanks for this follow-up. LGTM except for one small comment :)

String description = "Suppressed " + original.getViolationType() + " in "
+ original.getClassName() + "#" + original.getMemberName()
+ location
+ " — " + original.getDescription()

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.

Would you mind using ascii code instead? -> -

@github-actions github-actions Bot removed the triage PRs from the community label Jul 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

build Gradle build or GitHub Actions ci-approved small Small PRs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants