Uploaded image for project: 'Kafka'
  1. Kafka
  2. KAFKA-5350

Modify Unstable annotations in Streams API

    XMLWordPrintableJSON

Details

    • Bug
    • Status: Resolved
    • Major
    • Resolution: Fixed
    • None
    • 0.11.0.0
    • streams
    • None

    Description

      As discussed in the email thread: https://www.mail-archive.com/dev@kafka.apache.org/msg72581.html

      We are going to make the following changes to the Streams API compatibility annotations:

      1. For "o.a.k.streams.errors" and "o.a.k.streams.state" packages: remove the annotations except `Stores`.

      2. For "o.a.k.streams.kstream": remove the annotations except "KStream", "KTable", "GroupedKStream", "GroupedKTable", "GlobalKTable" and "KStreamBuilder".

      3. For all the other public classes, including "o.a.k.streams.processor", change the annotation to "Evolving", which means "we might break compatibility at minor releases (i.e. 0.12.x, 0.13.x, 1.0.x etc) only".

      The ultimate goal is to make sure we won't break anything going forward, hence in the future we should remove all the annotations to make that clear. The above changes in 0.11.0.0 is to give us some "buffer time" in case there are some major API change proposals after the release.

      Attachments

        Issue Links

          Activity

            People

              guozhang Guozhang Wang
              guozhang Guozhang Wang
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: