Breaking API changes between version upgrades

[Tianxiang Xiong]

Would it be possible for breaking API changes between versions of Kafka to be more clearly communicated?

For example, TopologyBuilder in 0.10.1 had a `sourceTopics` method, which disappears in 0.10.2. I don't see any mention of this in the 0.10.2 release notes.

[Matthias J. Sax]

Hi,

sorry about this. It seems it slipped through the release notes... The
method got removed, because .sourceTopicPattern() is doing the method's
work now.

Cf.
https://github.com/apache/kafka/commit/0f87991d5dbe8741953be04628810d76a9ee7434

But you are right, this should have been documents.

However, sourceTopics() is actually an internal method you should not
use anyway. We plan a API cleanup for 0.11 release that removes all
internal methods that are currently public (but should never have been
public in the first place).
See
https://cwiki.apache.org/confluence/display/KAFKA/KIP-120%3A+Cleanup+Kafka+Streams+builder+API

Thus, I would recommend writing backward compatible code that will allow
you to migrate to 0.11 easier later on.

Hope this helps. And sorry again for the incomplete release notes.


-Matthias

On 4/10/17 1:56 PM, 'Tianxiang Xiong' via Confluent Platform wrote:
> Would it be possible for breaking API changes between versions of Kafka
> to be more clearly communicated?
>
> For example, TopologyBuilder in 0.10.1

> <https://kafka.apache.org/0101/javadoc/org/apache/kafka/streams/processor/TopologyBuilder.html>
> had a `sourceTopics`
> <https://kafka.apache.org/0101/javadoc/org/apache/kafka/streams/processor/TopologyBuilder.html#sourceTopics()>
> method, which disappears in 0.10.2
> <https://kafka.apache.org/0102/javadoc/org/apache/kafka/streams/processor/TopologyBuilder.html>.

> I don't see any mention of this in the 0.10.2 release notes

> <https://archive.apache.org/dist/kafka/0.10.2.0/RELEASE_NOTES.html>.
>
> --
> You received this message because you are subscribed to the Google
> Groups "Confluent Platform" group.
> To unsubscribe from this group and stop receiving emails from it, send
> an email to confluent-platf...@googlegroups.com
> <mailto:confluent-platf...@googlegroups.com>.
> To post to this group, send email to confluent...@googlegroups.com
> <mailto:confluent...@googlegroups.com>.
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/confluent-platform/beb38c10-ae42-4535-9a91-dbc605398b3f%40googlegroups.com
> <https://groups.google.com/d/msgid/confluent-platform/beb38c10-ae42-4535-9a91-dbc605398b3f%40googlegroups.com?utm_medium=email&utm_source=footer>.
> For more options, visit https://groups.google.com/d/optout.

[Tianxiang Xiong]

OK, thanks. 

Is there a way to replicate the functionality for `sourceTopics`?

> an email to confluent-platform+unsub...@googlegroups.com
> <mailto:confluent-platform+unsub...@googlegroups.com>.