PLEASE SAVE YOUR WORK! THIS WIKI IS GOING DOWN SHORTLY FOR AN UPGRADE. WILL BE DOWN FOR APPROX 3 HOURS
Current state: Accepted
Discussion thread: here
Please keep the discussion on the mailing list rather than commenting on the wiki (wiki discussions get unwieldy fast).
In 0.10.1.0, we removed the beta label from the new Java consumer
documentation and updated the various tools so that they can use the new
consumer without having to pass the `--new-consumer` flag (more
specifically the new consumer is used if `bootstrap-server` is set). More
details of the reasoning can be found in the original discuss thread:
The old consumers don't have security or `offsetsForTimestamp` (KIP-79)
support and the plan is to only add features to the new Java consumer. Even
so, the old consumers are a significant maintenance burden as they
duplicate protocol request/response classes (the SimpleConsumer exposes
them in the public API sadly). I experienced this first hand most recently
while working on KIP-74.
Given the above, I propose we deprecate the old consumers in trunk to nudge
users in the right direction. Users will have the 0.10.1.0 cycle to start
migrating to the new Java consumer with no build warnings. Once they
upgrade to the next release (i.e. 0.10.2.0), users who are still using the
old consumers will get warnings at build time encouraging them to move to
the new consumer, but everything will still work fine.
In a future major release, the old consumers (along with the old producers)
will be removed. We will have a separate discuss/vote thread for that to
make sure the time is right.
Another enticing feature of the Java consumer, that's missing in the old consumer, is its compatibility with older brokers (0.10.0 and later).
No new public interfaces are proposed, or existing interfaces are modified, or removed.
As described by Ismael Juma the intention at this point is to just mark the old consumer as deprecated and issue build warnings to users and let them know that the old consumer will be removed in a following major release (potentially 0.11.0.0).
Compatibility, Deprecation, and Migration Plan
There is no impact to existing users other than seeing the deprecation warnings at build time. Since the old consumer will be removed in a next major release a migration plan will be introduced later (some options are already suggested in the original discussion thread), if necessary, to lower the impact (downtime, etc.) to existing users of the old consumer.
None as no behavior changes is proposed at this time.