Status

Current state: "Accepted"

Discussion thread: here

Voting thread: here

JIRA: here [ KAFKA-17427 - Getting issue details... STATUS ]

Please keep the discussion on the mailing list rather than commenting on the wiki (wiki discussions get unwieldy fast).

Motivation

Some config's doc description is public in `StreamsConfig`, but it only used in the `StreamConfig` class or `TopologyConfig`. The overly large scope of these variables will increased the risk of misues.

We should deprecate the public ones to allow us making them private or package private in a future release.

One of variable is unused, so we also need to deprecate it.

Public Interfaces

  • `org.apache.kafka.streams.StreamsConfig`

Proposed Changes

We proposed to deprecate some doc description variable, and make it from public to private or package private.

Compatibility, Deprecation, and Migration Plan

  1. We will add a deprecated annotation on those used in `StreamsConfig` or `TopologyConfig` doc variables.

  2. Make these variables to private at the next major release.

These variable will be modified, these used in `StreamsConfig` or `TopologyConfig`.

  • `DEFAULT_CLIENT_SUPPLIER_DOC`
  • `ENABLE_METRICS_PUSH_DOC`
  • `PROCESSING_EXCEPTION_HANDLER_CLASS_DOC`
  • `RACK_AWARE_ASSIGNMENT_NON_OVERLAP_COST_DOC`
  • `RACK_AWARE_ASSIGNMENT_STRATEGY_DOC`
  • `RACK_AWARE_ASSIGNMENT_TRAFFIC_COST_DOC`
  • `BUFFERED_RECORDS_PER_PARTITION_DOC`
  • `CACHE_MAX_BYTES_BUFFERING_DOC`
  • `DEFAULT_DESERIALIZATION_EXCEPTION_HANDLER_CLASS_DOC`
  • `DEFAULT_DSL_STORE_DOC`
  • `DEFAULT_TIMESTAMP_EXTRACTOR_CLASS_DOC`
  • `MAX_TASK_IDLE_MS_DOC`
  • `STATESTORE_CACHE_MAX_BYTES_DOC`
  • `TASK_TIMEOUT_MS_DOC`

We also depreacte the unused variable

  • `DUMMY_THREAD_INDEX`

Test Plan

n/a

Rejected Alternatives

n/a

  • No labels