From 7946b2f35c0e3811ba7d706fc9c761d73ece47bb Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Mon, 16 Jan 2017 11:40:47 -0800
Subject: [PATCH 001/177] MINOR: Remove unused constructor param from
 ProcessorStateManager

Remove applicationId parameter as it is no longer used.

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2385 from dguy/minor-remove-unused-param
---
 .../processor/internals/AbstractTask.java        |  2 +-
 .../internals/ProcessorStateManager.java         |  3 +--
 .../internals/ProcessorStateManagerTest.java     | 16 ++++++++--------
 3 files changed, 10 insertions(+), 11 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/AbstractTask.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/AbstractTask.java
index 0730c68ca0c9f..55418d5b4e030 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/AbstractTask.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/AbstractTask.java
@@ -70,7 +70,7 @@ protected AbstractTask(TaskId id,
 
         // create the processor state manager
         try {
-            this.stateMgr = new ProcessorStateManager(applicationId, id, partitions, restoreConsumer, isStandby, stateDirectory, topology.storeToChangelogTopic());
+            this.stateMgr = new ProcessorStateManager(id, partitions, restoreConsumer, isStandby, stateDirectory, topology.storeToChangelogTopic());
 
         } catch (IOException e) {
             throw new ProcessorStateException(String.format("task [%s] Error while creating the state manager", id), e);
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java
index a21c3e8dc4f92..ad16c77c2a8ba 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java
@@ -74,8 +74,7 @@ public class ProcessorStateManager implements StateManager {
      *                       (this might be recoverable by retrying)
      * @throws IOException if any severe error happens while creating or locking the state directory
      */
-    public ProcessorStateManager(final String applicationId,
-                                 final TaskId taskId,
+    public ProcessorStateManager(final TaskId taskId,
                                  final Collection<TopicPartition> sources,
                                  final Consumer<byte[], byte[]> restoreConsumer,
                                  final boolean isStandby,
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/ProcessorStateManagerTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/ProcessorStateManagerTest.java
index de547230ae3f9..602601a17e731 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/ProcessorStateManagerTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/ProcessorStateManagerTest.java
@@ -212,7 +212,7 @@ public void cleanup() {
     public void testNoTopic() throws IOException {
         MockStateStoreSupplier.MockStateStore mockStateStore = new MockStateStoreSupplier.MockStateStore(nonPersistentStoreName, false);
 
-        ProcessorStateManager stateMgr = new ProcessorStateManager(applicationId, new TaskId(0, 1), noPartitions, new MockRestoreConsumer(), false, stateDirectory, new HashMap<String, String>() {
+        ProcessorStateManager stateMgr = new ProcessorStateManager(new TaskId(0, 1), noPartitions, new MockRestoreConsumer(), false, stateDirectory, new HashMap<String, String>() {
             {
                 put(nonPersistentStoreName, nonPersistentStoreName);
             }
@@ -244,7 +244,7 @@ public void testRegisterPersistentStore() throws IOException {
 
         MockStateStoreSupplier.MockStateStore persistentStore = new MockStateStoreSupplier.MockStateStore("persistentStore", true); // persistent store
 
-        ProcessorStateManager stateMgr = new ProcessorStateManager(applicationId, taskId, noPartitions, restoreConsumer, false, stateDirectory, new HashMap<String, String>() {
+        ProcessorStateManager stateMgr = new ProcessorStateManager(taskId, noPartitions, restoreConsumer, false, stateDirectory, new HashMap<String, String>() {
             {
                 put(persistentStoreName, persistentStoreTopicName);
                 put(nonPersistentStoreName, nonPersistentStoreName);
@@ -298,7 +298,7 @@ public void testRegisterNonPersistentStore() throws IOException {
 
         MockStateStoreSupplier.MockStateStore nonPersistentStore = new MockStateStoreSupplier.MockStateStore(nonPersistentStoreName, false); // non persistent store
 
-        ProcessorStateManager stateMgr = new ProcessorStateManager(applicationId, new TaskId(0, 2), noPartitions, restoreConsumer, false, stateDirectory, new HashMap<String, String>() {
+        ProcessorStateManager stateMgr = new ProcessorStateManager(new TaskId(0, 2), noPartitions, restoreConsumer, false, stateDirectory, new HashMap<String, String>() {
             {
                 put(persistentStoreName, persistentStoreTopicName);
                 put(nonPersistentStoreName, nonPersistentStoreTopicName);
@@ -381,7 +381,7 @@ public void testChangeLogOffsets() throws IOException {
         // if there is an source partition, inherit the partition id
         Set<TopicPartition> sourcePartitions = Utils.mkSet(new TopicPartition(storeTopicName3, 1));
 
-        ProcessorStateManager stateMgr = new ProcessorStateManager(applicationId, taskId, sourcePartitions, restoreConsumer, true, stateDirectory, storeToChangelogTopic); // standby
+        ProcessorStateManager stateMgr = new ProcessorStateManager(taskId, sourcePartitions, restoreConsumer, true, stateDirectory, storeToChangelogTopic); // standby
         try {
             restoreConsumer.reset();
 
@@ -415,7 +415,7 @@ public void testGetStore() throws IOException {
 
         MockStateStoreSupplier.MockStateStore mockStateStore = new MockStateStoreSupplier.MockStateStore(nonPersistentStoreName, false);
 
-        ProcessorStateManager stateMgr = new ProcessorStateManager(applicationId, new TaskId(0, 1), noPartitions, restoreConsumer, false, stateDirectory, Collections.<String, String>emptyMap());
+        ProcessorStateManager stateMgr = new ProcessorStateManager(new TaskId(0, 1), noPartitions, restoreConsumer, false, stateDirectory, Collections.<String, String>emptyMap());
         try {
             stateMgr.register(mockStateStore, true, mockStateStore.stateRestoreCallback);
 
@@ -453,7 +453,7 @@ public void testFlushAndClose() throws IOException {
         MockStateStoreSupplier.MockStateStore persistentStore = new MockStateStoreSupplier.MockStateStore(persistentStoreName, true);
         MockStateStoreSupplier.MockStateStore nonPersistentStore = new MockStateStoreSupplier.MockStateStore(nonPersistentStoreName, false);
 
-        ProcessorStateManager stateMgr = new ProcessorStateManager(applicationId, taskId, noPartitions, restoreConsumer, false, stateDirectory, new HashMap<String, String>() {
+        ProcessorStateManager stateMgr = new ProcessorStateManager(taskId, noPartitions, restoreConsumer, false, stateDirectory, new HashMap<String, String>() {
             {
                 put(persistentStoreName, persistentStoreTopicName);
                 put(nonPersistentStoreName, nonPersistentStoreTopicName);
@@ -491,7 +491,7 @@ public void testFlushAndClose() throws IOException {
     @Test
     public void shouldRegisterStoreWithoutLoggingEnabledAndNotBackedByATopic() throws Exception {
         MockStateStoreSupplier.MockStateStore mockStateStore = new MockStateStoreSupplier.MockStateStore(nonPersistentStoreName, false);
-        ProcessorStateManager stateMgr = new ProcessorStateManager(applicationId, new TaskId(0, 1), noPartitions, new MockRestoreConsumer(), false, stateDirectory, Collections.<String, String>emptyMap());
+        ProcessorStateManager stateMgr = new ProcessorStateManager(new TaskId(0, 1), noPartitions, new MockRestoreConsumer(), false, stateDirectory, Collections.<String, String>emptyMap());
         stateMgr.register(mockStateStore, false, mockStateStore.stateRestoreCallback);
         assertNotNull(stateMgr.getStore(nonPersistentStoreName));
     }
@@ -512,7 +512,7 @@ public void shouldNotWriteCheckpointsIfAckeOffsetsIsNull() throws Exception {
 
 
         final MockStateStoreSupplier.MockStateStore persistentStore = new MockStateStoreSupplier.MockStateStore(persistentStoreName, true);
-        final ProcessorStateManager stateMgr = new ProcessorStateManager(applicationId, taskId, noPartitions, restoreConsumer, false, stateDirectory, Collections.<String, String>emptyMap());
+        final ProcessorStateManager stateMgr = new ProcessorStateManager(taskId, noPartitions, restoreConsumer, false, stateDirectory, Collections.<String, String>emptyMap());
 
         restoreConsumer.reset();
         stateMgr.register(persistentStore, true, persistentStore.stateRestoreCallback);

From 621dff22e79dc64b9a8748186dd985774044f91a Mon Sep 17 00:00:00 2001
From: Rajini Sivaram <rajinisivaram@googlemail.com>
Date: Tue, 17 Jan 2017 11:16:29 +0000
Subject: [PATCH 002/177] KAFKA-4363; Documentation for sasl.jaas.config
 property

Author: Rajini Sivaram <rajinisivaram@googlemail.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2316 from rajinisivaram/KAFKA-4363
---
 docs/security.html | 147 ++++++++++++++++++++++++++++++---------------
 1 file changed, 99 insertions(+), 48 deletions(-)

diff --git a/docs/security.html b/docs/security.html
index 350f0cf620700..8cb867eb04cee 100644
--- a/docs/security.html
+++ b/docs/security.html
@@ -263,23 +263,65 @@ <h3><a id="security_sasl" href="#security_sasl">7.3 Authentication using SASL</a
     <li><h4><a id="security_sasl_clientconfig"
         href="#security_sasl_clientconfig">SASL configuration for Kafka clients</a></h4>
         SASL authentication is only supported for the new Java Kafka producer and
-        consumer, the older API is not supported. To configure SASL authentication
-        on the clients:
+        consumer, the older API is not supported. JAAS configuration for clients may
+        be specified as a static JAAS config file or using the client configuration property
+        <code>sasl.jaas.config</code>.
+        To configure SASL authentication on the clients:
         <ol>
         <li>Select a SASL mechanism for authentication.</li>
-        <li>Add a JAAS config file for the selected mechanism as described in the examples
-            for setting up <a href="#security_sasl_kerberos_clientconfig">GSSAPI (Kerberos)</a>
-            or <a href="#security_sasl_plain_clientconfig">PLAIN</a>. <tt>KafkaClient</tt> is the
-            section name in the JAAS file used by Kafka clients.</li>
-        <li>Pass the JAAS config file location as JVM parameter to each client JVM. For example:
-            <pre>    -Djava.security.auth.login.config=/etc/kafka/kafka_client_jaas.conf</pre></li>
         <li>Configure the following properties in producer.properties or
             consumer.properties:
             <pre>    security.protocol=SASL_PLAINTEXT (or SASL_SSL)
-        sasl.mechanism=GSSAPI (or PLAIN)</pre></li>
+    sasl.mechanism=GSSAPI (or PLAIN)</pre></li>
         <li>Follow the steps in <a href="#security_sasl_kerberos_clientconfig">GSSAPI (Kerberos)</a>
             or <a href="#security_sasl_plain_clientconfig">PLAIN</a> to configure SASL
             for the selected mechanism.</li>
+        <li>Configure JAAS using <a href="#security_client_dynamicjaas">client configuration property</a>
+            or <a href="#security_client_staticjaas">static JAAS config file</a> as described below.</li>
+        </ol>
+        <ol>
+        <li><h5><a id="security_client_dynamicjaas" href="#security_client_dynamicjaas">JAAS configuration using client configuration property</a></h5>
+            <p>Clients may specify JAAS configuration as a producer or consumer property without
+            creating a physical configuration file. This mode also enables different producers
+            and consumers within the same JVM to use different credentials by specifying
+            different properties for each client. If both static JAAS configuration system property
+            <code>java.security.auth.login.config</code> and client property <code>sasl.jaas.config</code>
+            are specified, the client property will be used.</p>
+
+            To configure SASL authentication on the clients using configuration property:
+            <ol>
+            <li>Configure the property <code>sasl.jaas.config</code> in producer.properties or
+                consumer.properties to be the JAAS login module section of the selected mechanism.
+                For example, <a href="#security_sasl_plain_clientconfig">PLAIN</a>
+                credentials may be configured as:
+                <pre>    sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required username="alice" password="alice-secret";</pre></li>
+                See <a href="#security_sasl_kerberos_clientconfig">GSSAPI (Kerberos)</a> or <a href="#security_sasl_plain_clientconfig">PLAIN</a>
+                for full example configurations.</li>
+            </ol>
+        </li>
+        <li><h5><a id="security_client_staticjaas" href="#security_client_staticjaas">JAAS configuration using static config file</a></h5>
+            To configure SASL authentication on the clients using static JAAS config file:
+            <ol>
+            <li>Add a JAAS config file with a client login section named <tt>KafkaClient</tt>. Configure
+                a login module in <tt>KafkaClient</tt> for the selected mechanism as described in the examples
+                for setting up <a href="#security_sasl_kerberos_clientconfig">GSSAPI (Kerberos)</a>
+                or <a href="#security_sasl_plain_clientconfig">PLAIN</a>.
+                For example, <a href="#security_sasl_gssapi_clientconfig">GSSAPI</a>
+                credentials may be configured as:
+                <pre>
+    KafkaClient {
+        com.sun.security.auth.module.Krb5LoginModule required
+        useKeyTab=true
+        storeKey=true
+        keyTab="/etc/security/keytabs/kafka_client.keytab"
+        principal="kafka-client-1@EXAMPLE.COM";
+    };</pre>
+                See <a href="#security_sasl_kerberos_clientconfig">GSSAPI (Kerberos)</a> or <a href="#security_sasl_plain_clientconfig">PLAIN</a>
+                for example configurations of each mechanism.</li>
+            <li>Pass the JAAS config file location as JVM parameter to each client JVM. For example:
+                <pre>    -Djava.security.auth.login.config=/etc/kafka/kafka_client_jaas.conf</pre></li>
+            </ol>
+        </li>
         </ol>
     </li>
     <li><h4><a id="security_sasl_kerberos" href="#security_sasl_kerberos">Authentication using SASL/Kerberos</a></h4>
@@ -320,7 +362,7 @@ <h3><a id="security_sasl" href="#security_sasl">7.3 Authentication using SASL</a
             </li>
             <tt>KafkaServer</tt> section in the JAAS file tells the broker which principal to use and the location of the keytab where this principal is stored. It
             allows the broker to login using the keytab specified in this section. See <a href="#security_sasl_brokernotes">notes</a> for more details on Zookeeper SASL configuration.
-            <li>Pass the JAAS and optionally the krb5 file locations as JVM parameters to each Kafka broker (see <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/KerberosReq.html">here</a> for more details): 
+            <li>Pass the JAAS and optionally the krb5 file locations as JVM parameters to each Kafka broker (see <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/KerberosReq.html">here</a> for more details):
                 <pre>    -Djava.security.krb5.conf=/etc/kafka/krb5.conf
         -Djava.security.auth.login.config=/etc/kafka/kafka_server_jaas.conf</pre>
             </li>
@@ -331,7 +373,7 @@ <h3><a id="security_sasl" href="#security_sasl">7.3 Authentication using SASL</a
         sasl.mechanism.inter.broker.protocol=GSSAPI
         sasl.enabled.mechanisms=GSSAPI
             </pre>
-            </li>We must also configure the service name in server.properties, which should match the principal name of the kafka brokers. In the above example, principal is "kafka/kafka1.hostname.com@EXAMPLE.com", so: 
+            </li>We must also configure the service name in server.properties, which should match the principal name of the kafka brokers. In the above example, principal is "kafka/kafka1.hostname.com@EXAMPLE.com", so:
             <pre>    sasl.kerberos.service.name=kafka</pre>
 
         </ol></li>
@@ -339,37 +381,43 @@ <h3><a id="security_sasl" href="#security_sasl">7.3 Authentication using SASL</a
             To configure SASL authentication on the clients:
             <ol>
                 <li>
-                    Clients (producers, consumers, connect workers, etc) will authenticate to the cluster with their own principal (usually with the same name as the user running the client), so obtain or create these principals as needed. Then create a JAAS file for each principal.
-                    The KafkaClient section describes how the clients like producer and consumer can connect to the Kafka Broker. The following is an example configuration for a client using a keytab (recommended for long-running processes):
+                    Clients (producers, consumers, connect workers, etc) will authenticate to the cluster with their
+                    own principal (usually with the same name as the user running the client), so obtain or create
+                    these principals as needed. Then configure the JAAS configuration property for each client.
+                    Different clients within a JVM may run as different users by specifiying different principals.
+                    The property <code>sasl.jaas.config</code> in producer.properties or consumer.properties describes
+                    how clients like producer and consumer can connect to the Kafka Broker. The following is an example
+                    configuration for a client using a keytab (recommended for long-running processes):
                 <pre>
-        KafkaClient {
-            com.sun.security.auth.module.Krb5LoginModule required
-            useKeyTab=true
-            storeKey=true
-            keyTab="/etc/security/keytabs/kafka_client.keytab"
-            principal="kafka-client-1@EXAMPLE.COM";
-        };</pre>
-
-                For command-line utilities like kafka-console-consumer or kafka-console-producer, kinit can be used along with "useTicketCache=true" as in:
+    sasl.jaas.config=com.sun.security.auth.module.Krb5LoginModule required \
+        useKeyTab=true \
+        storeKey=true  \
+        keyTab="/etc/security/keytabs/kafka_client.keytab" \
+        principal="kafka-client-1@EXAMPLE.COM";</pre>
+
+                   For command-line utilities like kafka-console-consumer or kafka-console-producer, kinit can be used
+                   along with "useTicketCache=true" as in:
                 <pre>
-        KafkaClient {
-            com.sun.security.auth.module.Krb5LoginModule required
-            useTicketCache=true;
-        };</pre>
+    sasl.jaas.config=com.sun.security.auth.module.Krb5LoginModule required \
+        useTicketCache=true;</pre>
+
+                   JAAS configuration for clients may alternatively be specified as a JVM parameter similar to brokers
+                   as described <a href="#security_client_staticjaas">here</a>. Clients use the login section named
+                   <tt>KafkaClient</tt>. This option allows only one user for all client connections from a JVM.</li>
+                <li>Make sure the keytabs configured in the JAAS configuration are readable by the operating system user who is starting kafka client.</li>
                 </li>
-                <li>Pass the JAAS and optionally krb5 file locations as JVM parameters to each client JVM (see <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/KerberosReq.html">here</a> for more details): 
-                <pre>    -Djava.security.krb5.conf=/etc/kafka/krb5.conf
-        -Djava.security.auth.login.config=/etc/kafka/kafka_client_jaas.conf</pre></li>
-                <li>Make sure the keytabs configured in the kafka_client_jaas.conf are readable by the operating system user who is starting kafka client.</li>
-                <li>Configure the following properties in producer.properties or consumer.properties: 
-                <pre>    security.protocol=SASL_PLAINTEXT (or SASL_SSL)
-        sasl.mechanism=GSSAPI
-        sasl.kerberos.service.name=kafka</pre></li>
+                <li>Optionally pass the krb5 file locations as JVM parameters to each client JVM (see <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/KerberosReq.html">here</a> for more details):
+                <pre>    -Djava.security.krb5.conf=/etc/kafka/krb5.conf</pre></li>
+                <li>Configure the following properties in producer.properties or consumer.properties:
+                <pre>
+    security.protocol=SASL_PLAINTEXT (or SASL_SSL)
+    sasl.mechanism=GSSAPI
+    sasl.kerberos.service.name=kafka</pre></li>
             </ol>
         </li>
         </ol>
     </li>
-        
+
     <li><h4><a id="security_sasl_plain" href="#security_sasl_plain">Authentication using SASL/PLAIN</a></h4>
         <p>SASL/PLAIN is a simple username/password authentication mechanism that is typically used with TLS for encryption to implement secure authentication.
         Kafka supports a default implementation for SASL/PLAIN which can be extended for production use as described <a href="#security_sasl_plain_production">here</a>.</p>
@@ -404,22 +452,25 @@ <h3><a id="security_sasl" href="#security_sasl">7.3 Authentication using SASL</a
         <li><h5><a id="security_sasl_plain_clientconfig" href="#security_sasl_plain_clientconfig">Configuring Kafka Clients</a></h5>
             To configure SASL authentication on the clients:
             <ol>
-            <li>The <tt>KafkaClient</tt> section describes how the clients like producer and consumer can connect to the Kafka Broker.
-            The following is an example configuration for a client for the PLAIN mechanism:
+            <li>Configure the JAAS configuration property for each client in producer.properties or consumer.properties.
+                The login module describes how the clients like producer and consumer can connect to the Kafka Broker.
+                The following is an example configuration for a client for the PLAIN mechanism:
                 <pre>
-        KafkaClient {
-            org.apache.kafka.common.security.plain.PlainLoginModule required
-            username="alice"
-            password="alice-secret";
-        };</pre>
-                The properties <tt>username</tt> and <tt>password</tt> in the <tt>KafkaClient</tt> section are used by clients to configure
+    sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required \
+        username="alice" \
+        password="alice-secret";</pre>
+                <p>The options <tt>username</tt> and <tt>password</tt> are used by clients to configure
                 the user for client connections. In this example, clients connect to the broker as user <i>alice</i>.
-            </li>
-            <li>Pass the JAAS config file location as JVM parameter to each client JVM:
-                <pre>    -Djava.security.auth.login.config=/etc/kafka/kafka_client_jaas.conf</pre></li>
+                Different clients within a JVM may connect as different users by specifying different user names
+                and passwords in <code>sasl.jaas.config</code>.</p>
+
+                <p>JAAS configuration for clients may alternatively be specified as a JVM parameter similar to brokers
+                as described <a href="#security_client_staticjaas">here</a>. Clients use the login section named
+                <tt>KafkaClient</tt>. This option allows only one user for all client connections from a JVM.</p></li>
             <li>Configure the following properties in producer.properties or consumer.properties:
-                <pre>    security.protocol=SASL_SSL
-        sasl.mechanism=PLAIN</pre></li>
+                <pre>
+    security.protocol=SASL_SSL
+    sasl.mechanism=PLAIN</pre></li>
             </ol>
         </li>
         <li><h5><a id="security_sasl_plain_production" href="#security_sasl_plain_production">Use of SASL/PLAIN in production</a></h5>

From e3f4cdd0e249f78a7f4e8f064533bcd15eb11cbf Mon Sep 17 00:00:00 2001
From: Rajini Sivaram <rajinisivaram@googlemail.com>
Date: Tue, 17 Jan 2017 12:55:07 +0000
Subject: [PATCH 003/177] KAFKA-4590; SASL/SCRAM system tests

Runs sanity test and one replication test using SASL/SCRAM.

Author: Rajini Sivaram <rajinisivaram@googlemail.com>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2355 from rajinisivaram/KAFKA-4590
---
 .../sanity_checks/test_console_consumer.py    |  2 +-
 tests/kafkatest/services/kafka/kafka.py       |  6 +++++
 .../services/security/security_config.py      | 25 +++++++++++++++++++
 .../services/security/templates/jaas.conf     |  9 +++++++
 .../kafkatest/tests/core/replication_test.py  |  6 ++++-
 5 files changed, 46 insertions(+), 2 deletions(-)

diff --git a/tests/kafkatest/sanity_checks/test_console_consumer.py b/tests/kafkatest/sanity_checks/test_console_consumer.py
index 38db057e5654a..066d6d42c1477 100644
--- a/tests/kafkatest/sanity_checks/test_console_consumer.py
+++ b/tests/kafkatest/sanity_checks/test_console_consumer.py
@@ -47,7 +47,7 @@ def setUp(self):
     @parametrize(security_protocol='PLAINTEXT', new_consumer=False)
     @matrix(security_protocol=['PLAINTEXT', 'SSL'])
     @cluster(num_nodes=4)
-    @parametrize(security_protocol='SASL_SSL', sasl_mechanism='PLAIN')
+    @matrix(security_protocol=['SASL_SSL'], sasl_mechanism=['PLAIN', 'SCRAM-SHA-256', 'SCRAM-SHA-512'])
     @matrix(security_protocol=['SASL_PLAINTEXT', 'SASL_SSL'])
     def test_lifecycle(self, security_protocol, new_consumer=True, sasl_mechanism='GSSAPI'):
         """Check that console consumer starts/stops properly, and that we are capturing log output."""
diff --git a/tests/kafkatest/services/kafka/kafka.py b/tests/kafkatest/services/kafka/kafka.py
index 716c2d2645402..8ef0f356f43cc 100644
--- a/tests/kafkatest/services/kafka/kafka.py
+++ b/tests/kafkatest/services/kafka/kafka.py
@@ -208,6 +208,7 @@ def start_node(self, node):
         node.account.create_file(self.LOG4J_CONFIG, self.render('log4j.properties', log_dir=KafkaService.OPERATIONAL_LOG_DIR))
 
         self.security_config.setup_node(node)
+        self.security_config.setup_credentials(node, self.path, self.zk.connect_setting(), broker=True)
 
         cmd = self.start_cmd(node)
         self.logger.debug("Attempting to start KafkaService on %s with command: %s" % (str(node.account), cmd))
@@ -215,6 +216,11 @@ def start_node(self, node):
             node.account.ssh(cmd)
             monitor.wait_until("Kafka Server.*started", timeout_sec=30, backoff_sec=.25, err_msg="Kafka server didn't finish startup")
 
+        # Credentials for inter-broker communication are created before starting Kafka.
+        # Client credentials are created after starting Kafka so that both loading of
+        # existing credentials from ZK and dynamic update of credentials in Kafka are tested.
+        self.security_config.setup_credentials(node, self.path, self.zk.connect_setting(), broker=False)
+
         self.start_jmx_tool(self.idx(node), node)
         if len(self.pids(node)) == 0:
             raise Exception("No process ids recorded on node %s" % str(node))
diff --git a/tests/kafkatest/services/security/security_config.py b/tests/kafkatest/services/security/security_config.py
index 9b29217bf723e..864e0a3008484 100644
--- a/tests/kafkatest/services/security/security_config.py
+++ b/tests/kafkatest/services/security/security_config.py
@@ -94,6 +94,12 @@ class SecurityConfig(TemplateRenderer):
     SASL_SSL = 'SASL_SSL'
     SASL_MECHANISM_GSSAPI = 'GSSAPI'
     SASL_MECHANISM_PLAIN = 'PLAIN'
+    SASL_MECHANISM_SCRAM_SHA_256 = 'SCRAM-SHA-256'
+    SASL_MECHANISM_SCRAM_SHA_512 = 'SCRAM-SHA-512'
+    SCRAM_CLIENT_USER = "kafka-client"
+    SCRAM_CLIENT_PASSWORD = "client-secret"
+    SCRAM_BROKER_USER = "kafka-broker"
+    SCRAM_BROKER_PASSWORD = "broker-secret"
     CONFIG_DIR = "/mnt/security"
     KEYSTORE_PATH = "/mnt/security/test.keystore.jks"
     TRUSTSTORE_PATH = "/mnt/security/test.truststore.jks"
@@ -167,6 +173,7 @@ def setup_sasl(self, node):
         else:
             is_ibm_jdk = False
         jaas_conf = self.render(jaas_conf_file,  node=node, is_ibm_jdk=is_ibm_jdk,
+                                SecurityConfig=SecurityConfig,
                                 client_sasl_mechanism=self.client_sasl_mechanism,
                                 enabled_sasl_mechanisms=self.enabled_sasl_mechanisms)
         node.account.create_file(SecurityConfig.JAAS_CONF_PATH, jaas_conf)
@@ -181,6 +188,21 @@ def setup_node(self, node):
         if self.has_sasl:
             self.setup_sasl(node)
 
+    def setup_credentials(self, node, path, zk_connect, broker):
+        if broker:
+            self.maybe_create_scram_credentials(node, zk_connect, path, self.interbroker_sasl_mechanism,
+                 SecurityConfig.SCRAM_BROKER_USER, SecurityConfig.SCRAM_BROKER_PASSWORD)
+        else:
+            self.maybe_create_scram_credentials(node, zk_connect, path, self.client_sasl_mechanism,
+                 SecurityConfig.SCRAM_CLIENT_USER, SecurityConfig.SCRAM_CLIENT_PASSWORD)
+
+    def maybe_create_scram_credentials(self, node, zk_connect, path, mechanism, user_name, password):
+        if self.has_sasl and self.is_sasl_scram(mechanism):
+            cmd = "%s --zookeeper %s --entity-name %s --entity-type users --alter --add-config %s=[password=%s]" % \
+                  (path.script("kafka-configs.sh", node), zk_connect,
+                  user_name, mechanism, password)
+            node.account.ssh(cmd)
+
     def clean_node(self, node):
         if self.security_protocol != SecurityConfig.PLAINTEXT:
             node.account.ssh("rm -rf %s" % SecurityConfig.CONFIG_DIR, allow_fail=False)
@@ -203,6 +225,9 @@ def is_ssl(self, security_protocol):
     def is_sasl(self, security_protocol):
         return security_protocol == SecurityConfig.SASL_PLAINTEXT or security_protocol == SecurityConfig.SASL_SSL
 
+    def is_sasl_scram(self, sasl_mechanism):
+        return sasl_mechanism == SecurityConfig.SASL_MECHANISM_SCRAM_SHA_256 or sasl_mechanism == SecurityConfig.SASL_MECHANISM_SCRAM_SHA_512
+
     @property
     def security_protocol(self):
         return self.properties['security.protocol']
diff --git a/tests/kafkatest/services/security/templates/jaas.conf b/tests/kafkatest/services/security/templates/jaas.conf
index fbfa8af49c2db..3667f87b661a0 100644
--- a/tests/kafkatest/services/security/templates/jaas.conf
+++ b/tests/kafkatest/services/security/templates/jaas.conf
@@ -31,6 +31,10 @@ KafkaClient {
 	org.apache.kafka.common.security.plain.PlainLoginModule required
 	username="client"
 	password="client-secret";
+{% elif client_sasl_mechanism == "SCRAM-SHA-256" or client_sasl_mechanism == "SCRAM-SHA-512" %}
+	org.apache.kafka.common.security.scram.ScramLoginModule required
+	username="{{ SecurityConfig.SCRAM_CLIENT_USER }}"
+	password="{{ SecurityConfig.SCRAM_CLIENT_PASSWORD }}";
 {% endif %}
 
 };
@@ -58,6 +62,11 @@ KafkaServer {
 	user_client="client-secret"
 	user_kafka="kafka-secret";
 {% endif %}
+{% if client_sasl_mechanism == "SCRAM-SHA-256" or client_sasl_mechanism == "SCRAM-SHA-512" %}
+	org.apache.kafka.common.security.scram.ScramLoginModule required
+	username="{{ SecurityConfig.SCRAM_BROKER_USER }}"
+	password="{{ SecurityConfig.SCRAM_BROKER_PASSWORD }}";
+{% endif %}
 };
 
 {% if zk_sasl %}
diff --git a/tests/kafkatest/tests/core/replication_test.py b/tests/kafkatest/tests/core/replication_test.py
index a95e9e5c289b9..3e17d5636eca3 100644
--- a/tests/kafkatest/tests/core/replication_test.py
+++ b/tests/kafkatest/tests/core/replication_test.py
@@ -16,6 +16,7 @@
 from ducktape.utils.util import wait_until
 
 from ducktape.mark import matrix
+from ducktape.mark import parametrize
 from ducktape.mark.resource import cluster
 
 from kafkatest.services.zookeeper import ZookeeperService
@@ -122,13 +123,16 @@ def min_cluster_size(self):
     @cluster(num_nodes=7)
     @matrix(failure_mode=["clean_shutdown", "hard_shutdown", "clean_bounce", "hard_bounce"],
             broker_type=["leader"],
-            security_protocol=["PLAINTEXT", "SSL", "SASL_PLAINTEXT", "SASL_SSL"])
+            security_protocol=["PLAINTEXT", "SASL_SSL"])
     @matrix(failure_mode=["clean_shutdown", "hard_shutdown", "clean_bounce", "hard_bounce"],
             broker_type=["controller"],
             security_protocol=["PLAINTEXT", "SASL_SSL"])
     @matrix(failure_mode=["hard_bounce"],
             broker_type=["leader"],
             security_protocol=["SASL_SSL"], client_sasl_mechanism=["PLAIN"], interbroker_sasl_mechanism=["PLAIN", "GSSAPI"])
+    @parametrize(failure_mode="hard_bounce",
+            broker_type="leader",
+            security_protocol="SASL_SSL", client_sasl_mechanism="SCRAM-SHA-256", interbroker_sasl_mechanism="SCRAM-SHA-512")
     def test_replication_with_broker_failure(self, failure_mode, security_protocol, broker_type, client_sasl_mechanism="GSSAPI", interbroker_sasl_mechanism="GSSAPI"):
         """Replication tests.
         These tests verify that replication provides simple durability guarantees by checking that data acked by

From 2b19ad9d8c47fb0f78a6e90d2f5711df6110bf1f Mon Sep 17 00:00:00 2001
From: Rajini Sivaram <rajinisivaram@googlemail.com>
Date: Tue, 17 Jan 2017 18:42:55 +0000
Subject: [PATCH 004/177] KAFKA-4580; Use sasl.jaas.config for some system
 tests

Switched console_consumer, verifiable_consumer and verifiable_producer to use new sasl.jaas_config property instead of static JAAS configuration file when used with SASL_PLAINTEXT.

Author: Rajini Sivaram <rajinisivaram@googlemail.com>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2323 from rajinisivaram/KAFKA-4580

(cherry picked from commit 3f6c4f63c9c17424cf717ca76c74554bcf3b2e9a)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 tests/kafkatest/services/console_consumer.py  |  4 +--
 .../services/security/security_config.py      | 28 +++++++++++++++----
 .../services/security/templates/jaas.conf     |  4 +++
 .../kafkatest/services/verifiable_consumer.py |  5 ++--
 .../kafkatest/services/verifiable_producer.py |  9 +++---
 5 files changed, 35 insertions(+), 15 deletions(-)

diff --git a/tests/kafkatest/services/console_consumer.py b/tests/kafkatest/services/console_consumer.py
index 17ddb6be26aa6..cdc46cdca985d 100644
--- a/tests/kafkatest/services/console_consumer.py
+++ b/tests/kafkatest/services/console_consumer.py
@@ -150,7 +150,8 @@ def prop_file(self, node):
 
         # Add security properties to the config. If security protocol is not specified,
         # use the default in the template properties.
-        self.security_config = self.kafka.security_config.client_config(prop_file)
+        self.security_config = self.kafka.security_config.client_config(prop_file, node)
+        self.security_config.setup_node(node)
 
         prop_file += str(self.security_config)
         return prop_file
@@ -231,7 +232,6 @@ def _worker(self, idx, node):
         prop_file = self.prop_file(node)
         self.logger.info(prop_file)
         node.account.create_file(ConsoleConsumer.CONFIG_FILE, prop_file)
-        self.security_config.setup_node(node)
 
         # Create and upload log properties
         log_config = self.render('tools_log4j.properties', log_file=ConsoleConsumer.LOG_FILE)
diff --git a/tests/kafkatest/services/security/security_config.py b/tests/kafkatest/services/security/security_config.py
index 864e0a3008484..846d9b10f3a6a 100644
--- a/tests/kafkatest/services/security/security_config.py
+++ b/tests/kafkatest/services/security/security_config.py
@@ -112,7 +112,7 @@ class SecurityConfig(TemplateRenderer):
 
     def __init__(self, context, security_protocol=None, interbroker_security_protocol=None,
                  client_sasl_mechanism=SASL_MECHANISM_GSSAPI, interbroker_sasl_mechanism=SASL_MECHANISM_GSSAPI,
-                 zk_sasl=False, template_props=""):
+                 zk_sasl=False, template_props="", static_jaas_conf=True):
         """
         Initialize the security properties for the node and copy
         keystore and truststore to the remote node if the transport protocol 
@@ -143,6 +143,7 @@ def __init__(self, context, security_protocol=None, interbroker_security_protoco
         self.has_sasl = self.is_sasl(security_protocol) or self.is_sasl(interbroker_security_protocol) or zk_sasl
         self.has_ssl = self.is_ssl(security_protocol) or self.is_ssl(interbroker_security_protocol)
         self.zk_sasl = zk_sasl
+        self.static_jaas_conf = static_jaas_conf
         self.properties = {
             'security.protocol' : security_protocol,
             'ssl.keystore.location' : SecurityConfig.KEYSTORE_PATH,
@@ -156,8 +157,14 @@ def __init__(self, context, security_protocol=None, interbroker_security_protoco
             'sasl.kerberos.service.name' : 'kafka'
         }
 
-    def client_config(self, template_props=""):
-        return SecurityConfig(self.context, self.security_protocol, client_sasl_mechanism=self.client_sasl_mechanism, template_props=template_props)
+    def client_config(self, template_props="", node=None):
+        # If node is not specified, use static jaas config which will be created later.
+        # Otherwise use static JAAS configuration files with SASL_SSL and sasl.jaas.config
+        # property with SASL_PLAINTEXT so that both code paths are tested by existing tests.
+        # Note that this is an artibtrary choice and it is possible to run all tests with
+        # either static or dynamic jaas config files if required.
+        static_jaas_conf = node is None or (self.has_sasl and self.has_ssl)
+        return SecurityConfig(self.context, self.security_protocol, client_sasl_mechanism=self.client_sasl_mechanism, template_props=template_props, static_jaas_conf=static_jaas_conf)
 
     def setup_ssl(self, node):
         node.account.ssh("mkdir -p %s" % SecurityConfig.CONFIG_DIR, allow_fail=False)
@@ -175,8 +182,12 @@ def setup_sasl(self, node):
         jaas_conf = self.render(jaas_conf_file,  node=node, is_ibm_jdk=is_ibm_jdk,
                                 SecurityConfig=SecurityConfig,
                                 client_sasl_mechanism=self.client_sasl_mechanism,
-                                enabled_sasl_mechanisms=self.enabled_sasl_mechanisms)
-        node.account.create_file(SecurityConfig.JAAS_CONF_PATH, jaas_conf)
+                                enabled_sasl_mechanisms=self.enabled_sasl_mechanisms,
+                                static_jaas_conf=self.static_jaas_conf)
+        if self.static_jaas_conf:
+            node.account.create_file(SecurityConfig.JAAS_CONF_PATH, jaas_conf)
+        else:
+            self.properties['sasl.jaas.config'] = jaas_conf.replace("\n", " \\\n")
         if self.has_sasl_kerberos:
             node.account.copy_to(MiniKdc.LOCAL_KEYTAB_FILE, SecurityConfig.KEYTAB_PATH)
             node.account.copy_to(MiniKdc.LOCAL_KRB5CONF_FILE, SecurityConfig.KRB5CONF_PATH)
@@ -251,7 +262,10 @@ def has_sasl_kerberos(self):
     @property
     def kafka_opts(self):
         if self.has_sasl:
-            return "\"-Djava.security.auth.login.config=%s -Djava.security.krb5.conf=%s\"" % (SecurityConfig.JAAS_CONF_PATH, SecurityConfig.KRB5CONF_PATH)
+            if self.static_jaas_conf:
+                return "\"-Djava.security.auth.login.config=%s -Djava.security.krb5.conf=%s\"" % (SecurityConfig.JAAS_CONF_PATH, SecurityConfig.KRB5CONF_PATH)
+            else:
+                return "\"-Djava.security.krb5.conf=%s\"" % SecurityConfig.KRB5CONF_PATH
         else:
             return ""
 
@@ -265,6 +279,8 @@ def props(self, prefix=''):
         """
         if self.security_protocol == SecurityConfig.PLAINTEXT:
             return ""
+        if self.has_sasl and not self.static_jaas_conf and 'sasl.jaas.config' not in self.properties:
+            raise Exception("JAAS configuration property has not yet been initialized")
         config_lines = (prefix + key + "=" + value for key, value in self.properties.iteritems())
         # Extra blank lines ensure this can be appended/prepended safely
         return "\n".join(itertools.chain([""], config_lines, [""]))
diff --git a/tests/kafkatest/services/security/templates/jaas.conf b/tests/kafkatest/services/security/templates/jaas.conf
index 3667f87b661a0..e2511451e3272 100644
--- a/tests/kafkatest/services/security/templates/jaas.conf
+++ b/tests/kafkatest/services/security/templates/jaas.conf
@@ -12,7 +12,9 @@
   */
 
 
+{% if static_jaas_conf %}
 KafkaClient {
+{% endif %}
 {% if client_sasl_mechanism == "GSSAPI" %}
 {% if is_ibm_jdk %}
     com.ibm.security.auth.module.Krb5LoginModule required debug=false
@@ -37,6 +39,7 @@ KafkaClient {
 	password="{{ SecurityConfig.SCRAM_CLIENT_PASSWORD }}";
 {% endif %}
 
+{% if static_jaas_conf %}
 };
 
 KafkaServer {
@@ -102,3 +105,4 @@ Server {
 {% endif %}
 };
 {% endif %}
+{% endif %}
diff --git a/tests/kafkatest/services/verifiable_consumer.py b/tests/kafkatest/services/verifiable_consumer.py
index c593e2a79bd42..090bcda8784fb 100644
--- a/tests/kafkatest/services/verifiable_consumer.py
+++ b/tests/kafkatest/services/verifiable_consumer.py
@@ -148,8 +148,6 @@ def __init__(self, context, num_nodes, kafka, topic, group_id,
         self.enable_autocommit = enable_autocommit
         self.assignment_strategy = assignment_strategy
         self.prop_file = ""
-        self.security_config = kafka.security_config.client_config(self.prop_file)
-        self.prop_file += str(self.security_config)
         self.stop_timeout_sec = stop_timeout_sec
 
         self.event_handlers = {}
@@ -171,6 +169,9 @@ def _worker(self, idx, node):
         node.account.create_file(VerifiableConsumer.LOG4J_CONFIG, log_config)
 
         # Create and upload config file
+        self.security_config = self.kafka.security_config.client_config(self.prop_file, node)
+        self.security_config.setup_node(node)
+        self.prop_file += str(self.security_config)
         self.logger.info("verifiable_consumer.properties:")
         self.logger.info(self.prop_file)
         node.account.create_file(VerifiableConsumer.CONFIG_FILE, self.prop_file)
diff --git a/tests/kafkatest/services/verifiable_producer.py b/tests/kafkatest/services/verifiable_producer.py
index 205143e411839..d873e1f82b525 100644
--- a/tests/kafkatest/services/verifiable_producer.py
+++ b/tests/kafkatest/services/verifiable_producer.py
@@ -83,10 +83,6 @@ def __init__(self, context, num_nodes, kafka, topic, max_messages=-1, throughput
         self.acks = acks
         self.stop_timeout_sec = stop_timeout_sec
 
-    @property
-    def security_config(self):
-        return self.kafka.security_config.client_config()
-
     def prop_file(self, node):
         idx = self.idx(node)
         prop_file = str(self.security_config)
@@ -104,6 +100,10 @@ def _worker(self, idx, node):
         log_config = self.render('tools_log4j.properties', log_file=VerifiableProducer.LOG_FILE)
         node.account.create_file(VerifiableProducer.LOG4J_CONFIG, log_config)
 
+        # Configure security
+        self.security_config = self.kafka.security_config.client_config(node=node)
+        self.security_config.setup_node(node)
+
         # Create and upload config file
         producer_prop_file = self.prop_file(node)
         if self.acks is not None:
@@ -112,7 +112,6 @@ def _worker(self, idx, node):
         self.logger.info("verifiable_producer.properties:")
         self.logger.info(producer_prop_file)
         node.account.create_file(VerifiableProducer.CONFIG_FILE, producer_prop_file)
-        self.security_config.setup_node(node)
 
         cmd = self.start_cmd(node, idx)
         self.logger.debug("VerifiableProducer %d command: %s" % (idx, cmd))

From 60d759a227087079e6fd270c68fd9e38441cb34a Mon Sep 17 00:00:00 2001
From: Jason Gustafson <jason@confluent.io>
Date: Tue, 17 Jan 2017 10:42:05 -0800
Subject: [PATCH 005/177] MINOR: Some cleanups and additional testing for
 KIP-88

Author: Jason Gustafson <jason@confluent.io>

Reviewers: Vahid Hashemian <vahidhashemian@us.ibm.com>, Ismael Juma <ismael@juma.me.uk>

Closes #2383 from hachikuji/minor-cleanup-kip-88
---
 .../common/requests/OffsetFetchRequest.java   | 24 +++++-
 .../common/requests/OffsetFetchResponse.java  | 83 ++++++------------
 .../clients/consumer/KafkaConsumerTest.java   |  2 +-
 .../internals/ConsumerCoordinatorTest.java    |  4 +-
 .../common/requests/RequestResponseTest.java  | 23 +++--
 .../scala/kafka/api/OffsetFetchRequest.scala  |  1 -
 .../kafka/coordinator/GroupCoordinator.scala  |  4 +-
 .../coordinator/GroupMetadataManager.scala    | 31 ++++---
 .../main/scala/kafka/server/KafkaApis.scala   | 86 ++++++++-----------
 .../kafka/api/AuthorizerIntegrationTest.scala | 37 +++++++-
 .../GroupCoordinatorResponseTest.scala        | 58 ++++++++++++-
 11 files changed, 211 insertions(+), 142 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/common/requests/OffsetFetchRequest.java b/clients/src/main/java/org/apache/kafka/common/requests/OffsetFetchRequest.java
index 0ff49bed09c2d..553fd9695c3b6 100644
--- a/clients/src/main/java/org/apache/kafka/common/requests/OffsetFetchRequest.java
+++ b/clients/src/main/java/org/apache/kafka/common/requests/OffsetFetchRequest.java
@@ -23,6 +23,7 @@
 
 import java.nio.ByteBuffer;
 import java.util.ArrayList;
+import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 
@@ -78,7 +79,7 @@ public String toString() {
     private final List<TopicPartition> partitions;
 
     public static OffsetFetchRequest forAllPartitions(String groupId) {
-        return new OffsetFetchRequest.Builder(groupId, (List<TopicPartition>) null).setVersion((short) 2).build();
+        return new OffsetFetchRequest.Builder(groupId, null).setVersion((short) 2).build();
     }
 
     // v0, v1, and v2 have the same fields.
@@ -131,20 +132,35 @@ public OffsetFetchRequest(Struct struct, short versionId) {
         groupId = struct.getString(GROUP_ID_KEY_NAME);
     }
 
-    @Override
-    public AbstractResponse getErrorResponse(Throwable e) {
+    public OffsetFetchResponse getErrorResponse(Errors error) {
         short versionId = version();
+
+        Map<TopicPartition, OffsetFetchResponse.PartitionData> responsePartitions = new HashMap<>();
+        if (versionId < 2) {
+            for (TopicPartition partition : this.partitions) {
+                responsePartitions.put(partition, new OffsetFetchResponse.PartitionData(
+                        OffsetFetchResponse.INVALID_OFFSET,
+                        OffsetFetchResponse.NO_METADATA,
+                        error));
+            }
+        }
+
         switch (versionId) {
             case 0:
             case 1:
             case 2:
-                return new OffsetFetchResponse(Errors.forException(e), partitions, versionId);
+                return new OffsetFetchResponse(error, responsePartitions, versionId);
             default:
                 throw new IllegalArgumentException(String.format("Version %d is not valid. Valid versions for %s are 0 to %d",
                         versionId, this.getClass().getSimpleName(), ProtoUtils.latestVersion(ApiKeys.OFFSET_FETCH.id)));
         }
     }
 
+    @Override
+    public OffsetFetchResponse getErrorResponse(Throwable e) {
+        return getErrorResponse(Errors.forException(e));
+    }
+
     public String groupId() {
         return groupId;
     }
diff --git a/clients/src/main/java/org/apache/kafka/common/requests/OffsetFetchResponse.java b/clients/src/main/java/org/apache/kafka/common/requests/OffsetFetchResponse.java
index 0095f38ec10f5..9c1415538c54f 100644
--- a/clients/src/main/java/org/apache/kafka/common/requests/OffsetFetchResponse.java
+++ b/clients/src/main/java/org/apache/kafka/common/requests/OffsetFetchResponse.java
@@ -46,6 +46,8 @@ public class OffsetFetchResponse extends AbstractResponse {
 
     public static final long INVALID_OFFSET = -1L;
     public static final String NO_METADATA = "";
+    public static final PartitionData UNKNOWN_PARTITION = new PartitionData(INVALID_OFFSET, NO_METADATA,
+            Errors.UNKNOWN_TOPIC_OR_PARTITION);
 
     /**
      * Possible error codes:
@@ -59,7 +61,7 @@ public class OffsetFetchResponse extends AbstractResponse {
      *   - GROUP_AUTHORIZATION_FAILED (30)
      */
 
-    public static final List<Errors> PARTITION_ERRORS = Arrays.asList(
+    private static final List<Errors> PARTITION_ERRORS = Arrays.asList(
             Errors.UNKNOWN_TOPIC_OR_PARTITION,
             Errors.TOPIC_AUTHORIZATION_FAILED);
 
@@ -82,14 +84,30 @@ public boolean hasError() {
         }
     }
 
-    private List<Struct> getTopicArray(Map<TopicPartition, PartitionData> responseData) {
-        Map<String, Map<Integer, PartitionData>> topicsData = CollectionUtils.groupDataByTopic(responseData);
+    /**
+     * Constructor for the latest version.
+     * @param error Potential coordinator or group level error code
+     * @param responseData Fetched offset information grouped by topic-partition
+     */
+    public OffsetFetchResponse(Errors error, Map<TopicPartition, PartitionData> responseData) {
+        this(error, responseData, CURRENT_VERSION);
+    }
 
-        List<Struct> topicArray = new ArrayList<Struct>();
+    /**
+     * Unified constructor for all versions.
+     * @param error Potential coordinator or group level error code (for api version 2 and later)
+     * @param responseData Fetched offset information grouped by topic-partition
+     * @param version The request API version
+     */
+    public OffsetFetchResponse(Errors error, Map<TopicPartition, PartitionData> responseData, int version) {
+        super(new Struct(ProtoUtils.responseSchema(ApiKeys.OFFSET_FETCH.id, version)));
+
+        Map<String, Map<Integer, PartitionData>> topicsData = CollectionUtils.groupDataByTopic(responseData);
+        List<Struct> topicArray = new ArrayList<>();
         for (Map.Entry<String, Map<Integer, PartitionData>> entries : topicsData.entrySet()) {
             Struct topicData = this.struct.instance(RESPONSES_KEY_NAME);
             topicData.set(TOPIC_KEY_NAME, entries.getKey());
-            List<Struct> partitionArray = new ArrayList<Struct>();
+            List<Struct> partitionArray = new ArrayList<>();
             for (Map.Entry<Integer, PartitionData> partitionEntry : entries.getValue().entrySet()) {
                 PartitionData fetchPartitionData = partitionEntry.getValue();
                 Struct partitionData = topicData.instance(PARTITIONS_KEY_NAME);
@@ -103,66 +121,17 @@ private List<Struct> getTopicArray(Map<TopicPartition, PartitionData> responseDa
             topicArray.add(topicData);
         }
 
-        return topicArray;
-    }
-
-    /**
-     * Unified constructor
-     * @param responseData Fetched offset information grouped by topic-partition
-     * @param topLevelErrorCode Potential coordinator or group level error code (for api version 2 and later)
-     * @param version The request API version
-     */
-    public OffsetFetchResponse(Errors topLevelError, Map<TopicPartition, PartitionData> responseData, int version) {
-        super(new Struct(ProtoUtils.responseSchema(ApiKeys.OFFSET_FETCH.id, version)));
-
-        this.struct.set(RESPONSES_KEY_NAME, getTopicArray(responseData).toArray());
+        this.struct.set(RESPONSES_KEY_NAME, topicArray.toArray());
         this.responseData = responseData;
-        this.error = topLevelError;
+        this.error = error;
         if (version > 1)
             this.struct.set(ERROR_CODE_KEY_NAME, this.error.code());
     }
 
-    /**
-     * Unified constructor (used only if there are errors in the response)
-     * @param partitions partitions to be included in the response
-     * @param topLevelErrorCode The error code to be reported in the response
-     * @param version The request API version
-     */
-    public OffsetFetchResponse(Errors topLevelError, List<TopicPartition> partitions, int version) {
-        super(new Struct(ProtoUtils.responseSchema(ApiKeys.OFFSET_FETCH.id, version)));
-
-        assert topLevelError != Errors.NONE;
-        this.responseData = new HashMap<>();
-        this.error = topLevelError;
-        if (version < 2) {
-            for (TopicPartition partition : partitions) {
-                this.responseData.put(partition, new OffsetFetchResponse.PartitionData(
-                        OffsetFetchResponse.INVALID_OFFSET,
-                        OffsetFetchResponse.NO_METADATA,
-                        topLevelError));
-            }
-        } else
-            this.struct.set(ERROR_CODE_KEY_NAME, this.error.code());
-
-        this.struct.set(RESPONSES_KEY_NAME, getTopicArray(this.responseData).toArray());
-    }
-
-    public OffsetFetchResponse(Map<TopicPartition, PartitionData> responseData) {
-        this(Errors.NONE, responseData, CURRENT_VERSION);
-    }
-
-    /**
-     * Constructor for version 2 and above when there is a coordinator or group level error
-     * @param topLevelErrorCode Coordinator or group level error code
-     */
-    public OffsetFetchResponse(Errors topLevelError) {
-        this(topLevelError, new ArrayList<TopicPartition>(), CURRENT_VERSION);
-    }
-
     public OffsetFetchResponse(Struct struct) {
         super(struct);
         Errors topLevelError = Errors.NONE;
-        this.responseData = new HashMap<TopicPartition, PartitionData>();
+        this.responseData = new HashMap<>();
         for (Object topicResponseObj : struct.getArray(RESPONSES_KEY_NAME)) {
             Struct topicResponse = (Struct) topicResponseObj;
             String topic = topicResponse.getString(TOPIC_KEY_NAME);
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
index 2eeed551abdb0..d4913df75a9c1 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
@@ -1370,7 +1370,7 @@ private OffsetFetchResponse offsetResponse(Map<TopicPartition, Long> offsets, Er
         for (Map.Entry<TopicPartition, Long> entry : offsets.entrySet()) {
             partitionData.put(entry.getKey(), new OffsetFetchResponse.PartitionData(entry.getValue(), "", error));
         }
-        return new OffsetFetchResponse(partitionData);
+        return new OffsetFetchResponse(Errors.NONE, partitionData);
     }
 
     private ListOffsetResponse listOffsetsResponse(Map<TopicPartition, Long> offsets, short error) {
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java
index 9a8c0b93de6d9..ee6afe19de5ac 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java
@@ -1482,12 +1482,12 @@ private OffsetCommitResponse offsetCommitResponse(Map<TopicPartition, Short> res
     }
 
     private OffsetFetchResponse offsetFetchResponse(Errors topLevelError) {
-        return new OffsetFetchResponse(topLevelError);
+        return new OffsetFetchResponse(topLevelError, Collections.<TopicPartition, OffsetFetchResponse.PartitionData>emptyMap());
     }
 
     private OffsetFetchResponse offsetFetchResponse(TopicPartition tp, Errors partitionLevelError, String metadata, long offset) {
         OffsetFetchResponse.PartitionData data = new OffsetFetchResponse.PartitionData(offset, metadata, partitionLevelError);
-        return new OffsetFetchResponse(Collections.singletonMap(tp, data));
+        return new OffsetFetchResponse(Errors.NONE, Collections.singletonMap(tp, data));
     }
 
     private OffsetCommitCallback callback(final AtomicBoolean success) {
diff --git a/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java b/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java
index 0d3a1a8a38053..a5ed806673975 100644
--- a/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java
+++ b/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java
@@ -43,6 +43,7 @@
 import java.util.Map;
 import java.util.Set;
 
+import static java.util.Collections.singletonList;
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertTrue;
 
@@ -90,8 +91,13 @@ public void testSerialization() throws Exception {
         checkSerialization(createOffsetCommitResponse(), null);
         checkSerialization(OffsetFetchRequest.forAllPartitions("group1"));
         checkSerialization(OffsetFetchRequest.forAllPartitions("group1").getErrorResponse(new NotCoordinatorForGroupException()), 2);
-        checkSerialization(createOffsetFetchRequest());
-        checkSerialization(createOffsetFetchRequest().getErrorResponse(new UnknownServerException()), null);
+        checkSerialization(createOffsetFetchRequest(0));
+        checkSerialization(createOffsetFetchRequest(1));
+        checkSerialization(createOffsetFetchRequest(2));
+        checkSerialization(OffsetFetchRequest.forAllPartitions("group1"));
+        checkSerialization(createOffsetFetchRequest(0).getErrorResponse(new UnknownServerException()), 0);
+        checkSerialization(createOffsetFetchRequest(1).getErrorResponse(new UnknownServerException()), 1);
+        checkSerialization(createOffsetFetchRequest(2).getErrorResponse(new UnknownServerException()), 2);
         checkSerialization(createOffsetFetchResponse(), null);
         checkSerialization(createProduceRequest());
         checkSerialization(createProduceRequest().getErrorResponse(new UnknownServerException()), null);
@@ -337,7 +343,7 @@ private ListGroupsResponse createListGroupsResponse() {
     }
 
     private DescribeGroupsRequest createDescribeGroupRequest() {
-        return new DescribeGroupsRequest.Builder(Collections.singletonList("test-group")).build();
+        return new DescribeGroupsRequest.Builder(singletonList("test-group")).build();
     }
 
     private DescribeGroupsResponse createDescribeGroupResponse() {
@@ -428,16 +434,17 @@ private OffsetCommitResponse createOffsetCommitResponse() {
         return new OffsetCommitResponse(responseData);
     }
 
-    private OffsetFetchRequest createOffsetFetchRequest() {
-        return new OffsetFetchRequest.Builder("group1",
-                Arrays.asList(new TopicPartition("test11", 1))).build();
+    private OffsetFetchRequest createOffsetFetchRequest(int version) {
+        return new OffsetFetchRequest.Builder("group1", singletonList(new TopicPartition("test11", 1)))
+                .setVersion((short) version)
+                .build();
     }
 
     private OffsetFetchResponse createOffsetFetchResponse() {
         Map<TopicPartition, OffsetFetchResponse.PartitionData> responseData = new HashMap<>();
         responseData.put(new TopicPartition("test", 0), new OffsetFetchResponse.PartitionData(100L, "", Errors.NONE));
         responseData.put(new TopicPartition("test", 1), new OffsetFetchResponse.PartitionData(100L, null, Errors.NONE));
-        return new OffsetFetchResponse(responseData);
+        return new OffsetFetchResponse(Errors.NONE, responseData);
     }
 
     private ProduceRequest createProduceRequest() {
@@ -544,7 +551,7 @@ private SaslHandshakeRequest createSaslHandshakeRequest() {
     }
 
     private SaslHandshakeResponse createSaslHandshakeResponse() {
-        return new SaslHandshakeResponse(Errors.NONE.code(), Collections.singletonList("GSSAPI"));
+        return new SaslHandshakeResponse(Errors.NONE.code(), singletonList("GSSAPI"));
     }
 
     private ApiVersionsRequest createApiVersionRequest() {
diff --git a/core/src/main/scala/kafka/api/OffsetFetchRequest.scala b/core/src/main/scala/kafka/api/OffsetFetchRequest.scala
index 2908901cf5aea..dac4cc5d75d4e 100644
--- a/core/src/main/scala/kafka/api/OffsetFetchRequest.scala
+++ b/core/src/main/scala/kafka/api/OffsetFetchRequest.scala
@@ -25,7 +25,6 @@ import kafka.network.{RequestOrResponseSend, RequestChannel}
 import kafka.network.RequestChannel.Response
 import kafka.utils.Logging
 import org.apache.kafka.common.protocol.{ApiKeys, Errors}
-import org.apache.kafka.common.requests.OffsetFetchResponse.PARTITION_ERRORS
 
 object OffsetFetchRequest extends Logging {
   val CurrentVersion: Short = 2
diff --git a/core/src/main/scala/kafka/coordinator/GroupCoordinator.scala b/core/src/main/scala/kafka/coordinator/GroupCoordinator.scala
index 4cbfad6ade6f6..7abbc6e1ac1dd 100644
--- a/core/src/main/scala/kafka/coordinator/GroupCoordinator.scala
+++ b/core/src/main/scala/kafka/coordinator/GroupCoordinator.scala
@@ -422,7 +422,7 @@ class GroupCoordinator(val brokerId: Int,
     }
   }
 
-  def doCommitOffsets(group: GroupMetadata,
+  private def doCommitOffsets(group: GroupMetadata,
                       memberId: String,
                       generationId: Int,
                       offsetMetadata: immutable.Map[TopicPartition, OffsetAndMetadata],
@@ -455,7 +455,7 @@ class GroupCoordinator(val brokerId: Int,
   }
 
   def handleFetchOffsets(groupId: String,
-                         partitions: Option[Seq[TopicPartition]]): (Errors, Map[TopicPartition, OffsetFetchResponse.PartitionData]) = {
+                         partitions: Option[Seq[TopicPartition]] = None): (Errors, Map[TopicPartition, OffsetFetchResponse.PartitionData]) = {
     if (!isActive.get)
       (Errors.GROUP_COORDINATOR_NOT_AVAILABLE, Map())
     else if (!isCoordinatorForGroup(groupId)) {
diff --git a/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala b/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
index 74b46adc28f06..2d6889c936ff5 100644
--- a/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
+++ b/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
@@ -97,7 +97,7 @@ class GroupMetadataManager(val brokerId: Int,
       unit = TimeUnit.MILLISECONDS)
   }
 
-  def currentGroups(): Iterable[GroupMetadata] = groupMetadataCache.values
+  def currentGroups: Iterable[GroupMetadata] = groupMetadataCache.values
 
   def isPartitionOwned(partition: Int) = inLock(partitionLock) { ownedPartitions.contains(partition) }
 
@@ -342,19 +342,24 @@ class GroupMetadataManager(val brokerId: Int,
             (topicPartition, new OffsetFetchResponse.PartitionData(OffsetFetchResponse.INVALID_OFFSET, "", Errors.NONE))
           }.toMap
         } else {
-            if (topicPartitionsOpt.isEmpty) {
-              // Return offsets for all partitions owned by this consumer group. (this only applies to consumers that commit offsets to Kafka.)
-              group.allOffsets.map { case (topicPartition, offsetAndMetadata) =>
-                (topicPartition, new OffsetFetchResponse.PartitionData(offsetAndMetadata.offset, offsetAndMetadata.metadata, Errors.NONE))
-              }
-            } else {
-              topicPartitionsOpt.getOrElse(Seq.empty[TopicPartition]).map { topicPartition =>
-                group.offset(topicPartition) match {
-                  case None => (topicPartition, new OffsetFetchResponse.PartitionData(OffsetFetchResponse.INVALID_OFFSET, "", Errors.NONE))
-                  case Some(offsetAndMetadata) =>
-                    (topicPartition, new OffsetFetchResponse.PartitionData(offsetAndMetadata.offset, offsetAndMetadata.metadata, Errors.NONE))
+            topicPartitionsOpt match {
+              case None =>
+                // Return offsets for all partitions owned by this consumer group. (this only applies to consumers
+                // that commit offsets to Kafka.)
+                group.allOffsets.map { case (topicPartition, offsetAndMetadata) =>
+                  topicPartition -> new OffsetFetchResponse.PartitionData(offsetAndMetadata.offset, offsetAndMetadata.metadata, Errors.NONE)
                 }
-              }.toMap
+
+              case Some(topicPartitions) =>
+                topicPartitionsOpt.getOrElse(Seq.empty[TopicPartition]).map { topicPartition =>
+                  val partitionData = group.offset(topicPartition) match {
+                    case None =>
+                      new OffsetFetchResponse.PartitionData(OffsetFetchResponse.INVALID_OFFSET, "", Errors.NONE)
+                    case Some(offsetAndMetadata) =>
+                      new OffsetFetchResponse.PartitionData(offsetAndMetadata.offset, offsetAndMetadata.metadata, Errors.NONE)
+                  }
+                  topicPartition -> partitionData
+                }.toMap
             }
         }
       }
diff --git a/core/src/main/scala/kafka/server/KafkaApis.scala b/core/src/main/scala/kafka/server/KafkaApis.scala
index a6ad7b2ec8799..530dafcd69147 100644
--- a/core/src/main/scala/kafka/server/KafkaApis.scala
+++ b/core/src/main/scala/kafka/server/KafkaApis.scala
@@ -38,7 +38,7 @@ import kafka.utils.{Logging, ZKGroupTopicDirs, ZkUtils}
 import org.apache.kafka.common.errors.{ClusterAuthorizationException, NotLeaderForPartitionException, TopicExistsException, UnknownTopicOrPartitionException, UnsupportedForMessageFormatException}
 import org.apache.kafka.common.metrics.Metrics
 import org.apache.kafka.common.network.ListenerName
-import org.apache.kafka.common.protocol.{ApiKeys, Errors, Protocol, SecurityProtocol}
+import org.apache.kafka.common.protocol.{ApiKeys, Errors, Protocol}
 import org.apache.kafka.common.record.{MemoryRecords, Record}
 import org.apache.kafka.common.requests._
 import org.apache.kafka.common.requests.ProduceResponse.PartitionResponse
@@ -886,38 +886,31 @@ class KafkaApis(val requestChannel: RequestChannel,
     requestChannel.sendResponse(new RequestChannel.Response(request, responseBody))
   }
 
-  /*
+  /**
    * Handle an offset fetch request
    */
   def handleOffsetFetchRequest(request: RequestChannel.Request) {
     val header = request.header
     val offsetFetchRequest = request.body.asInstanceOf[OffsetFetchRequest]
 
+    def authorizeTopicDescribe(partition: TopicPartition) =
+      authorize(request.session, Describe, new Resource(auth.Topic, partition.topic))
+
     val offsetFetchResponse =
       // reject the request if not authorized to the group
       if (!authorize(request.session, Read, new Resource(Group, offsetFetchRequest.groupId)))
-        new OffsetFetchResponse(Errors.GROUP_AUTHORIZATION_FAILED, offsetFetchRequest.partitions, header.apiVersion)
+        offsetFetchRequest.getErrorResponse(Errors.GROUP_AUTHORIZATION_FAILED)
       else {
-        val partitions =
-          if (offsetFetchRequest.isAllPartitions)
-            List[TopicPartition]()
-          else
-            offsetFetchRequest.partitions.asScala.toList
-
-        val (authorizedPartitions, unauthorizedPartitions) =
-          partitions.partition { partition => authorize(request.session, Describe, new Resource(auth.Topic, partition.topic)) }
-
-        val unknownTopicPartitionResponse = new OffsetFetchResponse.PartitionData(
-            OffsetFetchResponse.INVALID_OFFSET, OffsetFetchResponse.NO_METADATA, Errors.UNKNOWN_TOPIC_OR_PARTITION)
-        val unauthorizedStatus = unauthorizedPartitions.map(topicPartition => (topicPartition, unknownTopicPartitionResponse)).toMap
-
         if (header.apiVersion == 0) {
+          val (authorizedPartitions, unauthorizedPartitions) = offsetFetchRequest.partitions.asScala
+            .partition(authorizeTopicDescribe)
+
           // version 0 reads offsets from ZK
-          val responseInfo = authorizedPartitions.map { topicPartition =>
+          val authorizedPartitionData = authorizedPartitions.map { topicPartition =>
             val topicDirs = new ZKGroupTopicDirs(offsetFetchRequest.groupId, topicPartition.topic)
             try {
               if (!metadataCache.contains(topicPartition.topic))
-                (topicPartition, unknownTopicPartitionResponse)
+                (topicPartition, OffsetFetchResponse.UNKNOWN_PARTITION)
               else {
                 val payloadOpt = zkUtils.readDataMaybeNull(s"${topicDirs.consumerOffsetDir}/${topicPartition.partition}")._1
                 payloadOpt match {
@@ -925,7 +918,7 @@ class KafkaApis(val requestChannel: RequestChannel,
                     (topicPartition, new OffsetFetchResponse.PartitionData(
                         payload.toLong, OffsetFetchResponse.NO_METADATA, Errors.NONE))
                   case None =>
-                    (topicPartition, unknownTopicPartitionResponse)
+                    (topicPartition, OffsetFetchResponse.UNKNOWN_PARTITION)
                 }
               }
             } catch {
@@ -934,43 +927,32 @@ class KafkaApis(val requestChannel: RequestChannel,
                     OffsetFetchResponse.INVALID_OFFSET, OffsetFetchResponse.NO_METADATA, Errors.forException(e)))
             }
           }.toMap
-          new OffsetFetchResponse(Errors.NONE, (responseInfo ++ unauthorizedStatus).asJava, header.apiVersion)
-        }
-        else {
+
+          val unauthorizedPartitionData = unauthorizedPartitions.map(_ -> OffsetFetchResponse.UNKNOWN_PARTITION).toMap
+          new OffsetFetchResponse(Errors.NONE, (authorizedPartitionData ++ unauthorizedPartitionData).asJava, header.apiVersion)
+        } else {
           // versions 1 and above read offsets from Kafka
-          val offsets = coordinator.handleFetchOffsets(offsetFetchRequest.groupId,
-            if (offsetFetchRequest.isAllPartitions)
-              None
-            else
+          if (offsetFetchRequest.isAllPartitions) {
+            val (error, allPartitionData) = coordinator.handleFetchOffsets(offsetFetchRequest.groupId)
+            if (error != Errors.NONE)
+              offsetFetchRequest.getErrorResponse(error)
+            else {
+              // clients are not allowed to see offsets for topics that are not authorized for Describe
+              val authorizedPartitionData = allPartitionData.filter { case (topicPartition, _) => authorizeTopicDescribe(topicPartition) }
+              new OffsetFetchResponse(Errors.NONE, authorizedPartitionData.asJava, header.apiVersion)
+            }
+          } else {
+            val (authorizedPartitions, unauthorizedPartitions) = offsetFetchRequest.partitions.asScala
+              .partition(authorizeTopicDescribe)
+            val (error, authorizedPartitionData) = coordinator.handleFetchOffsets(offsetFetchRequest.groupId,
               Some(authorizedPartitions))
-
-          // Note that we do not need to filter the partitions in the
-          // metadata cache as the topic partitions will be filtered
-          // in coordinator's offset manager through the offset cache
-          if (header.apiVersion == 1) {
-            val authorizedStatus =
-              if (offsets._1 != Errors.NONE) {
-                authorizedPartitions.map { partition =>
-                  (partition, new OffsetFetchResponse.PartitionData(
-                      OffsetFetchResponse.INVALID_OFFSET, OffsetFetchResponse.NO_METADATA, offsets._1))}.toMap
-              }
-              else
-                offsets._2.toMap
-            new OffsetFetchResponse(Errors.NONE, (authorizedStatus ++ unauthorizedStatus).asJava, header.apiVersion)
-          }
-          else if (offsets._1 == Errors.NONE) {
-            if (offsetFetchRequest.isAllPartitions) {
-              // filter out unauthorized topics in case all group offsets are requested
-              val authorizedStatus = offsets._2.filter {
-                case (partition, _) => authorize(request.session, Describe, new Resource(auth.Topic, partition.topic))
-              }
-              new OffsetFetchResponse((authorizedStatus).asJava)
+            if (error != Errors.NONE)
+              offsetFetchRequest.getErrorResponse(error)
+            else {
+              val unauthorizedPartitionData = unauthorizedPartitions.map(_ -> OffsetFetchResponse.UNKNOWN_PARTITION).toMap
+              new OffsetFetchResponse(Errors.NONE, (authorizedPartitionData ++ unauthorizedPartitionData).asJava, header.apiVersion)
             }
-            else
-              new OffsetFetchResponse((offsets._2.toMap ++ unauthorizedStatus).asJava)
           }
-          else
-            new OffsetFetchResponse(offsets._1)
         }
       }
 
diff --git a/core/src/test/scala/integration/kafka/api/AuthorizerIntegrationTest.scala b/core/src/test/scala/integration/kafka/api/AuthorizerIntegrationTest.scala
index 42251fa8950cb..d43d1af2a4d2d 100644
--- a/core/src/test/scala/integration/kafka/api/AuthorizerIntegrationTest.scala
+++ b/core/src/test/scala/integration/kafka/api/AuthorizerIntegrationTest.scala
@@ -40,6 +40,7 @@ import scala.collection.mutable
 import scala.collection.mutable.Buffer
 import org.apache.kafka.common.KafkaException
 import kafka.admin.AdminUtils
+import kafka.network.SocketServer
 import org.apache.kafka.common.network.ListenerName
 import org.apache.kafka.common.record.MemoryRecords
 
@@ -173,7 +174,7 @@ class AuthorizerIntegrationTest extends BaseRequestTest {
     producers.foreach(_.close())
     consumers.foreach(_.wakeup())
     consumers.foreach(_.close())
-    removeAllAcls
+    removeAllAcls()
     super.tearDown()
   }
 
@@ -711,6 +712,34 @@ class AuthorizerIntegrationTest extends BaseRequestTest {
     this.consumers.head.position(tp)
   }
 
+  @Test
+  def testFetchAllOffsetsTopicAuthorization() {
+    val offset = 15L
+    addAndVerifyAcls(Set(new Acl(KafkaPrincipal.ANONYMOUS, Allow, Acl.WildCardHost, Read)), groupResource)
+    addAndVerifyAcls(Set(new Acl(KafkaPrincipal.ANONYMOUS, Allow, Acl.WildCardHost, Read)), topicResource)
+    this.consumers.head.assign(List(tp).asJava)
+    this.consumers.head.commitSync(Map(tp -> new OffsetAndMetadata(offset)).asJava)
+
+    removeAllAcls()
+    addAndVerifyAcls(Set(new Acl(KafkaPrincipal.ANONYMOUS, Allow, Acl.WildCardHost, Read)), groupResource)
+
+    // send offset fetch requests directly since the consumer does not expose an API to do so
+    // note there's only one broker, so no need to lookup the group coordinator
+
+    // without describe permission on the topic, we shouldn't be able to fetch offsets
+    val offsetFetchRequest = requests.OffsetFetchRequest.forAllPartitions(group)
+    var offsetFetchResponse = sendOffsetFetchRequest(offsetFetchRequest, anySocketServer)
+    assertEquals(Errors.NONE, offsetFetchResponse.error)
+    assertTrue(offsetFetchResponse.responseData.isEmpty)
+
+    // now add describe permission on the topic and verify that the offset can be fetched
+    addAndVerifyAcls(Set(new Acl(KafkaPrincipal.ANONYMOUS, Allow, Acl.WildCardHost, Describe)), topicResource)
+    offsetFetchResponse = sendOffsetFetchRequest(offsetFetchRequest, anySocketServer)
+    assertEquals(Errors.NONE, offsetFetchResponse.error)
+    assertTrue(offsetFetchResponse.responseData.containsKey(tp))
+    assertEquals(offset, offsetFetchResponse.responseData.get(tp).offset)
+  }
+
   @Test
   def testOffsetFetchTopicDescribe() {
     addAndVerifyAcls(Set(new Acl(KafkaPrincipal.ANONYMOUS, Allow, Acl.WildCardHost, Read)), groupResource)
@@ -846,4 +875,10 @@ class AuthorizerIntegrationTest extends BaseRequestTest {
     }
   }
 
+  private def sendOffsetFetchRequest(request: requests.OffsetFetchRequest,
+                                     socketServer: SocketServer): requests.OffsetFetchResponse = {
+    val response = send(request, ApiKeys.OFFSET_FETCH, socketServer)
+    requests.OffsetFetchResponse.parse(response, request.version)
+  }
+
 }
diff --git a/core/src/test/scala/unit/kafka/coordinator/GroupCoordinatorResponseTest.scala b/core/src/test/scala/unit/kafka/coordinator/GroupCoordinatorResponseTest.scala
index 20e512faaaaff..d3de16d049761 100644
--- a/core/src/test/scala/unit/kafka/coordinator/GroupCoordinatorResponseTest.scala
+++ b/core/src/test/scala/unit/kafka/coordinator/GroupCoordinatorResponseTest.scala
@@ -25,7 +25,7 @@ import kafka.server.{DelayedOperationPurgatory, KafkaConfig, ReplicaManager}
 import kafka.utils._
 import org.apache.kafka.common.TopicPartition
 import org.apache.kafka.common.protocol.Errors
-import org.apache.kafka.common.requests.{JoinGroupRequest, OffsetCommitRequest}
+import org.apache.kafka.common.requests.{JoinGroupRequest, OffsetCommitRequest, OffsetFetchResponse}
 import org.apache.kafka.common.requests.ProduceResponse.PartitionResponse
 import org.easymock.{Capture, EasyMock, IAnswer}
 import org.junit.{After, Before, Test}
@@ -748,6 +748,62 @@ class GroupCoordinatorResponseTest extends JUnitSuite {
     assertEquals(Errors.NONE.code, commitOffsetResult(tp))
   }
 
+  @Test
+  def testFetchOffsets() {
+    val tp = new TopicPartition("topic", 0)
+    val offset = OffsetAndMetadata(0)
+
+    val commitOffsetResult = commitOffsets(groupId, OffsetCommitRequest.DEFAULT_MEMBER_ID,
+      OffsetCommitRequest.DEFAULT_GENERATION_ID, immutable.Map(tp -> offset))
+    assertEquals(Errors.NONE.code, commitOffsetResult(tp))
+
+    val (error, partitionData) = groupCoordinator.handleFetchOffsets(groupId, Some(Seq(tp)))
+    assertEquals(Errors.NONE, error)
+    assertEquals(Some(0), partitionData.get(tp).map(_.offset))
+  }
+
+  @Test
+  def testFetchOffsetForUnknownPartition(): Unit = {
+    val tp = new TopicPartition("topic", 0)
+    val (error, partitionData) = groupCoordinator.handleFetchOffsets(groupId, Some(Seq(tp)))
+    assertEquals(Errors.NONE, error)
+    assertEquals(Some(OffsetFetchResponse.INVALID_OFFSET), partitionData.get(tp).map(_.offset))
+  }
+
+  @Test
+  def testFetchOffsetNotCoordinatorForGroup(): Unit = {
+    val tp = new TopicPartition("topic", 0)
+    val (error, partitionData) = groupCoordinator.handleFetchOffsets(otherGroupId, Some(Seq(tp)))
+    assertEquals(Errors.NOT_COORDINATOR_FOR_GROUP, error)
+    assertTrue(partitionData.isEmpty)
+  }
+
+  @Test
+  def testFetchAllOffsets() {
+    val tp1 = new TopicPartition("topic", 0)
+    val tp2 = new TopicPartition("topic", 1)
+    val tp3 = new TopicPartition("other-topic", 0)
+    val offset1 = OffsetAndMetadata(15)
+    val offset2 = OffsetAndMetadata(16)
+    val offset3 = OffsetAndMetadata(17)
+
+    assertEquals((Errors.NONE, Map.empty), groupCoordinator.handleFetchOffsets(groupId))
+
+    val commitOffsetResult = commitOffsets(groupId, OffsetCommitRequest.DEFAULT_MEMBER_ID,
+      OffsetCommitRequest.DEFAULT_GENERATION_ID, immutable.Map(tp1 -> offset1, tp2 -> offset2, tp3 -> offset3))
+    assertEquals(Errors.NONE.code, commitOffsetResult(tp1))
+    assertEquals(Errors.NONE.code, commitOffsetResult(tp2))
+    assertEquals(Errors.NONE.code, commitOffsetResult(tp3))
+
+    val (error, partitionData) = groupCoordinator.handleFetchOffsets(groupId)
+    assertEquals(Errors.NONE, error)
+    assertEquals(3, partitionData.size)
+    assertTrue(partitionData.forall(_._2.error == Errors.NONE))
+    assertEquals(Some(offset1.offset), partitionData.get(tp1).map(_.offset))
+    assertEquals(Some(offset2.offset), partitionData.get(tp2).map(_.offset))
+    assertEquals(Some(offset3.offset), partitionData.get(tp3).map(_.offset))
+  }
+
   @Test
   def testCommitOffsetInAwaitingSync() {
     val memberId = JoinGroupRequest.UNKNOWN_MEMBER_ID

From c9b9acf6a8b5433332c2d0d825c17a4a20cf3fa5 Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Tue, 17 Jan 2017 12:33:11 -0800
Subject: [PATCH 006/177] KAFKA-4588: Wait for topics to be created in
 QueryableStateIntegrationTest.shouldNotMakeStoreAvailableUntilAllStoresAvailable

After debugging this i can see the times that it fails there is a race between when the topic is actually created/ready on the broker and when the assignment happens. When it fails `StreamPartitionAssignor.assign(..)` gets called with a `Cluster` with no topics. Hence the test hangs as no tasks get assigned. To fix this I added a `waitForTopics` method to `EmbeddedKafkaCluster`. This will wait until the topics have been created.

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Matthias J. Sax, Guozhang Wang

Closes #2371 from dguy/integration-test-fix

(cherry picked from commit 825f225bc5706b16af8ec44ca47ee1452c11e6f3)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 checkstyle/import-control.xml                 |  1 +
 .../GlobalKTableIntegrationTest.java          |  4 +-
 ...StreamAggregationDedupIntegrationTest.java |  4 +-
 .../KStreamAggregationIntegrationTest.java    |  4 +-
 .../KStreamKTableJoinIntegrationTest.java     |  2 +-
 .../KStreamRepartitionJoinTest.java           |  8 ++--
 .../QueryableStateIntegrationTest.java        | 14 +++---
 .../utils/EmbeddedKafkaCluster.java           | 24 +++++++++--
 .../utils/IntegrationTestUtils.java           | 43 +++++++++++++++++++
 .../integration/utils/KafkaEmbedded.java      |  3 ++
 .../apache/kafka/test/StreamsTestUtils.java   |  1 +
 11 files changed, 87 insertions(+), 21 deletions(-)

diff --git a/checkstyle/import-control.xml b/checkstyle/import-control.xml
index b68cf988821ab..04f364c6f8c18 100644
--- a/checkstyle/import-control.xml
+++ b/checkstyle/import-control.xml
@@ -156,6 +156,7 @@
     
     <subpackage name="integration">
       <allow pkg="kafka.admin" />
+      <allow pkg="kafka.api" />
       <allow pkg="kafka.server" />
       <allow pkg="kafka.tools" />
       <allow pkg="kafka.utils" />
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/GlobalKTableIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/GlobalKTableIntegrationTest.java
index 85b851d12964f..6ac87ae1fe64a 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/GlobalKTableIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/GlobalKTableIntegrationTest.java
@@ -81,7 +81,7 @@ public String apply(final Long value1, final String value2) {
     private ForeachAction<String, String> foreachAction;
 
     @Before
-    public void before() {
+    public void before() throws InterruptedException {
         testNo++;
         builder = new KStreamBuilder();
         createTopics();
@@ -212,7 +212,7 @@ public boolean conditionMet() {
     }
 
 
-    private void createTopics() {
+    private void createTopics() throws InterruptedException {
         inputStream = "input-stream-" + testNo;
         inputTable = "input-table-" + testNo;
         globalOne = "globalOne-" + testNo;
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamAggregationDedupIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamAggregationDedupIntegrationTest.java
index 9397e0331f474..f2a767ceb514e 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamAggregationDedupIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamAggregationDedupIntegrationTest.java
@@ -72,7 +72,7 @@ public class KStreamAggregationDedupIntegrationTest {
 
 
     @Before
-    public void before() {
+    public void before() throws InterruptedException {
         testNo++;
         builder = new KStreamBuilder();
         createTopics();
@@ -267,7 +267,7 @@ private void produceMessages(long timestamp)
     }
 
 
-    private void createTopics() {
+    private void createTopics() throws InterruptedException {
         streamOneInput = "stream-one-" + testNo;
         outputTopic = "output-" + testNo;
         CLUSTER.createTopic(streamOneInput, 3, 1);
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamAggregationIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamAggregationIntegrationTest.java
index 0833f3c8d1fe4..beb41ce68c610 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamAggregationIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamAggregationIntegrationTest.java
@@ -89,7 +89,7 @@ public class KStreamAggregationIntegrationTest {
     private KStream<Integer, String> stream;
 
     @Before
-    public void before() {
+    public void before() throws InterruptedException {
         testNo++;
         builder = new KStreamBuilder();
         createTopics();
@@ -637,7 +637,7 @@ private void produceMessages(final long timestamp)
     }
 
 
-    private void createTopics() {
+    private void createTopics() throws InterruptedException {
         streamOneInput = "stream-one-" + testNo;
         outputTopic = "output-" + testNo;
         userSessionsStream = userSessionsStream + "-" + testNo;
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamKTableJoinIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamKTableJoinIntegrationTest.java
index 3618f1542c271..0a16494397c71 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamKTableJoinIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamKTableJoinIntegrationTest.java
@@ -74,7 +74,7 @@ public class KStreamKTableJoinIntegrationTest {
     private Properties streamsConfiguration;
 
     @Before
-    public void before() {
+    public void before() throws InterruptedException {
         testNo++;
         userClicksTopic = "user-clicks-" + testNo;
         userRegionsTopic = "user-regions-" + testNo;
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamRepartitionJoinTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamRepartitionJoinTest.java
index e8a042ad7c670..6f3c95a3ab536 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamRepartitionJoinTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamRepartitionJoinTest.java
@@ -93,7 +93,7 @@ public static Object[] data() {
     }
 
     @Before
-    public void before() {
+    public void before() throws InterruptedException {
         testNo++;
         String applicationId = "kstream-repartition-join-test-" + testNo;
         builder = new KStreamBuilder();
@@ -146,7 +146,7 @@ public void shouldCorrectlyRepartitionOnJoinOperations() throws Exception {
         verifyLeftJoin(leftJoin);
     }
 
-    private ExpectedOutputOnTopic mapStreamOneAndJoin() {
+    private ExpectedOutputOnTopic mapStreamOneAndJoin() throws InterruptedException {
         String mapOneStreamAndJoinOutput = "map-one-join-output-" + testNo;
         doJoin(streamOne.map(keyMapper), streamTwo, mapOneStreamAndJoinOutput);
         return new ExpectedOutputOnTopic(expectedStreamOneTwoJoin, mapOneStreamAndJoinOutput);
@@ -350,7 +350,7 @@ private void produceToStreamOne()
             mockTime);
     }
 
-    private void createTopics() {
+    private void createTopics() throws InterruptedException {
         streamOneInput = "stream-one-" + testNo;
         streamTwoInput = "stream-two-" + testNo;
         streamFourInput = "stream-four-" + testNo;
@@ -395,7 +395,7 @@ private void verifyCorrectOutput(final List<String> expectedMessages,
 
     private void doJoin(final KStream<Integer, Integer> lhs,
                         final KStream<Integer, String> rhs,
-                        final String outputTopic) {
+                        final String outputTopic) throws InterruptedException {
         CLUSTER.createTopic(outputTopic);
         lhs.join(rhs,
             TOSTRING_JOINER,
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/QueryableStateIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/QueryableStateIntegrationTest.java
index b8f91faed0341..911c6a89cfe17 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/QueryableStateIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/QueryableStateIntegrationTest.java
@@ -81,6 +81,7 @@ public class QueryableStateIntegrationTest {
     @ClassRule
     public static final EmbeddedKafkaCluster CLUSTER =
         new EmbeddedKafkaCluster(NUM_BROKERS);
+    public static final int STREAM_THREE_PARTITIONS = 4;
     private final MockTime mockTime = CLUSTER.time;
     private String streamOne = "stream-one";
     private String streamTwo = "stream-two";
@@ -91,7 +92,7 @@ public class QueryableStateIntegrationTest {
     private String outputTopicThree = "output-three";
     // sufficiently large window size such that everything falls into 1 window
     private static final long WINDOW_SIZE = TimeUnit.MILLISECONDS.convert(2, TimeUnit.DAYS);
-    private static final int NUM_PARTITIONS = 2;
+    private static final int STREAM_TWO_PARTITIONS = 2;
     private static final int NUM_REPLICAS = NUM_BROKERS;
     private Properties streamsConfiguration;
     private List<String> inputValues;
@@ -101,7 +102,7 @@ public class QueryableStateIntegrationTest {
     private Comparator<KeyValue<String, Long>> stringLongComparator;
     private static int testNo = 0;
 
-    public void createTopics() {
+    public void createTopics() throws InterruptedException {
         streamOne = streamOne + "-" + testNo;
         streamConcurrent = streamConcurrent + "-" + testNo;
         streamThree = streamThree + "-" + testNo;
@@ -111,8 +112,8 @@ public void createTopics() {
         streamTwo = streamTwo + "-" + testNo;
         CLUSTER.createTopic(streamOne);
         CLUSTER.createTopic(streamConcurrent);
-        CLUSTER.createTopic(streamTwo, NUM_PARTITIONS, NUM_REPLICAS);
-        CLUSTER.createTopic(streamThree, 4, 1);
+        CLUSTER.createTopic(streamTwo, STREAM_TWO_PARTITIONS, NUM_REPLICAS);
+        CLUSTER.createTopic(streamThree, STREAM_THREE_PARTITIONS, 1);
         CLUSTER.createTopic(outputTopic);
         CLUSTER.createTopic(outputTopicConcurrent);
         CLUSTER.createTopic(outputTopicThree);
@@ -128,7 +129,7 @@ public static Object[] data() {
     }
 
     @Before
-    public void before() throws IOException {
+    public void before() throws IOException, InterruptedException {
         testNo++;
         createTopics();
         streamsConfiguration = new Properties();
@@ -145,7 +146,6 @@ public void before() throws IOException {
         streamsConfiguration.put(StreamsConfig.CACHE_MAX_BYTES_BUFFERING_CONFIG, cacheSizeBytes);
         streamsConfiguration.put(StreamsConfig.COMMIT_INTERVAL_MS_CONFIG, 1000);
 
-
         stringComparator = new Comparator<KeyValue<String, String>>() {
 
             @Override
@@ -328,7 +328,7 @@ public boolean conditionMet() {
 
     @Test
     public void queryOnRebalance() throws Exception {
-        final int numThreads = NUM_PARTITIONS;
+        final int numThreads = STREAM_TWO_PARTITIONS;
         final StreamRunnable[] streamRunnables = new StreamRunnable[numThreads];
         final Thread[] streamThreads = new Thread[numThreads];
         final int numIterations = 500000;
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/utils/EmbeddedKafkaCluster.java b/streams/src/test/java/org/apache/kafka/streams/integration/utils/EmbeddedKafkaCluster.java
index 519b1f5cb14b6..619b6b5ed87e3 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/utils/EmbeddedKafkaCluster.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/utils/EmbeddedKafkaCluster.java
@@ -18,13 +18,17 @@
 package org.apache.kafka.streams.integration.utils;
 
 import kafka.server.KafkaConfig$;
+import kafka.server.KafkaServer;
 import kafka.utils.MockTime;
 import kafka.zk.EmbeddedZookeeper;
+import org.apache.kafka.common.TopicPartition;
 import org.junit.rules.ExternalResource;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
 import java.util.Properties;
 
 /**
@@ -34,6 +38,7 @@ public class EmbeddedKafkaCluster extends ExternalResource {
 
     private static final Logger log = LoggerFactory.getLogger(EmbeddedKafkaCluster.class);
     private static final int DEFAULT_BROKER_PORT = 0; // 0 results in a random port being selected
+    public static final int TOPIC_CREATION_TIMEOUT = 30000;
     private EmbeddedZookeeper zookeeper = null;
     private final KafkaEmbedded[] brokers;
     private final Properties brokerConfig;
@@ -122,7 +127,7 @@ protected void after() {
      *
      * @param topic The name of the topic.
      */
-    public void createTopic(final String topic) {
+    public void createTopic(final String topic) throws InterruptedException {
         createTopic(topic, 1, 1, new Properties());
     }
 
@@ -133,7 +138,7 @@ public void createTopic(final String topic) {
      * @param partitions  The number of partitions for this topic.
      * @param replication The replication factor for (the partitions of) this topic.
      */
-    public void createTopic(final String topic, final int partitions, final int replication) {
+    public void createTopic(final String topic, final int partitions, final int replication) throws InterruptedException {
         createTopic(topic, partitions, replication, new Properties());
     }
 
@@ -148,11 +153,24 @@ public void createTopic(final String topic, final int partitions, final int repl
     public void createTopic(final String topic,
                             final int partitions,
                             final int replication,
-                            final Properties topicConfig) {
+                            final Properties topicConfig) throws InterruptedException {
         brokers[0].createTopic(topic, partitions, replication, topicConfig);
+        final List<TopicPartition> topicPartitions = new ArrayList<>();
+        for (int partition = 0; partition < partitions; partition++) {
+            topicPartitions.add(new TopicPartition(topic, partition));
+        }
+        IntegrationTestUtils.waitForTopicPartitions(brokers(), topicPartitions, TOPIC_CREATION_TIMEOUT);
     }
 
     public void deleteTopic(final String topic) {
         brokers[0].deleteTopic(topic);
     }
+
+    public List<KafkaServer> brokers() {
+        final List<KafkaServer> servers = new ArrayList<>();
+        for (final KafkaEmbedded broker : brokers) {
+            servers.add(broker.kafkaServer());
+        }
+        return servers;
+    }
 }
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/utils/IntegrationTestUtils.java b/streams/src/test/java/org/apache/kafka/streams/integration/utils/IntegrationTestUtils.java
index aa358ab3322e6..875c3591b881b 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/utils/IntegrationTestUtils.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/utils/IntegrationTestUtils.java
@@ -17,6 +17,10 @@
 
 package org.apache.kafka.streams.integration.utils;
 
+import kafka.api.PartitionStateInfo;
+import kafka.api.Request;
+import kafka.server.KafkaServer;
+import kafka.server.MetadataCache;
 import org.apache.kafka.clients.consumer.ConsumerRecord;
 import org.apache.kafka.clients.consumer.ConsumerRecords;
 import org.apache.kafka.clients.consumer.KafkaConsumer;
@@ -24,12 +28,14 @@
 import org.apache.kafka.clients.producer.Producer;
 import org.apache.kafka.clients.producer.ProducerRecord;
 import org.apache.kafka.clients.producer.RecordMetadata;
+import org.apache.kafka.common.TopicPartition;
 import org.apache.kafka.common.utils.Time;
 import org.apache.kafka.common.utils.Utils;
 import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.StreamsConfig;
 import org.apache.kafka.test.TestCondition;
 import org.apache.kafka.test.TestUtils;
+import scala.Option;
 
 import java.io.File;
 import java.io.IOException;
@@ -255,4 +261,41 @@ public boolean conditionMet() {
         return accumData;
     }
 
+    public static void waitForTopicPartitions(final List<KafkaServer> servers,
+                                              final List<TopicPartition> partitions,
+                                              final long timeout) throws InterruptedException {
+        final long end = System.currentTimeMillis() + timeout;
+        for (final TopicPartition partition : partitions) {
+            final long remaining = end - System.currentTimeMillis();
+            if (remaining <= 0) {
+                throw new AssertionError("timed out while waiting for partitions to become available. Timeout=" + timeout);
+            }
+            waitUntilMetadataIsPropagated(servers, partition.topic(), partition.partition(), remaining);
+        }
+    }
+
+    public static void waitUntilMetadataIsPropagated(final List<KafkaServer> servers,
+                                                     final String topic,
+                                                     final int partition,
+                                                     final long timeout) throws InterruptedException {
+        TestUtils.waitForCondition(new TestCondition() {
+            @Override
+            public boolean conditionMet() {
+                for (final KafkaServer server : servers) {
+                    final MetadataCache metadataCache = server.apis().metadataCache();
+                    final Option<PartitionStateInfo> partitionInfo =
+                            metadataCache.getPartitionInfo(topic, partition);
+                    if (partitionInfo.isEmpty()) {
+                        return false;
+                    }
+                    final PartitionStateInfo partitionStateInfo = partitionInfo.get();
+                    if (!Request.isValidBrokerId(partitionStateInfo.leaderIsrAndControllerEpoch().leaderAndIsr().leader())) {
+                        return false;
+                    }
+                }
+                return true;
+            }
+        }, timeout, "metatadata for topic=" + topic + " partition=" + partition + " not propogated to all brokers");
+
+    }
 }
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/utils/KafkaEmbedded.java b/streams/src/test/java/org/apache/kafka/streams/integration/utils/KafkaEmbedded.java
index 70c50631deedd..9b48272343e4a 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/utils/KafkaEmbedded.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/utils/KafkaEmbedded.java
@@ -202,4 +202,7 @@ public void deleteTopic(final String topic) {
         zkClient.close();
     }
 
+    public KafkaServer kafkaServer() {
+        return kafka;
+    }
 }
diff --git a/streams/src/test/java/org/apache/kafka/test/StreamsTestUtils.java b/streams/src/test/java/org/apache/kafka/test/StreamsTestUtils.java
index 555e622237535..73c1b63a2a47b 100644
--- a/streams/src/test/java/org/apache/kafka/test/StreamsTestUtils.java
+++ b/streams/src/test/java/org/apache/kafka/test/StreamsTestUtils.java
@@ -66,4 +66,5 @@ public static <K, V> List<KeyValue<K, V>> toList(final Iterator<KeyValue<K, V>>
         }
         return results;
     }
+
 }

From 6f72a5a53c444278187fa6be58031168bcaffb26 Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Tue, 17 Jan 2017 14:13:46 -0800
Subject: [PATCH 007/177] KAFKA-3452 Follow-up: Refactoring StateStore
 hierarchies

This is a follow up of https://github.com/apache/kafka/pull/2166 - refactoring the store hierarchies as requested

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2360 from dguy/state-store-refactor

(cherry picked from commit 73b7ae0019d387407375f3865e263225c986a6ce)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../kstream/internals/SessionKeySerde.java    |  17 ++
 .../streams/state/WindowStoreIterator.java    |   3 +-
 ...bstractMergedSortedCacheStoreIterator.java | 166 ++++++++++++++
 .../state/internals/CachingKeyValueStore.java |  10 +-
 .../state/internals/CachingSessionStore.java  |  63 ++----
 .../state/internals/CachingWindowStore.java   |  64 ++----
 .../ChangeLoggingKeyValueBytesStore.java      |  93 ++++++++
 .../internals/ChangeLoggingKeyValueStore.java | 127 +++++++++++
 .../ChangeLoggingSegmentedBytesStore.java     |  28 +--
 .../CompositeReadOnlyWindowStore.java         |   5 +
 .../DelegatingPeekingKeyValueIterator.java    |  10 +-
 ...ergedSortedCacheKeyValueStoreIterator.java | 130 ++---------
 ...MergedSortedCacheSessionStoreIterator.java |  71 ++++++
 .../MergedSortedCacheWindowStoreIterator.java |  58 +++++
 ...MergedSortedCachedWindowStoreIterator.java | 107 ---------
 .../state/internals/MeteredKeyValueStore.java |  27 +--
 .../internals/MeteredSegmentedBytesStore.java |  27 +--
 .../state/internals/MeteredWindowStore.java   | 180 ---------------
 .../RocksDBKeyValueStoreSupplier.java         |  54 +++--
 .../RocksDBSessionStoreSupplier.java          |  54 +++--
 .../streams/state/internals/RocksDBStore.java |  28 +--
 .../state/internals/RocksDBWindowStore.java   |  25 ++-
 .../internals/RocksDBWindowStoreSupplier.java |  37 +++-
 .../internals/SerializedKeyValueIterator.java |  70 ++++++
 .../state/internals/WindowStoreUtils.java     |   3 +
 .../state/internals/WrappedStateStore.java    |  90 ++++++++
 .../internals/KGroupedStreamImplTest.java     |  42 +++-
 .../internals/CachingSessionStoreTest.java    |   3 +-
 .../internals/CachingWindowStoreTest.java     |   5 +-
 .../ChangeLoggingKeyValueBytesStoreTest.java  | 165 ++++++++++++++
 .../ChangeLoggingKeyValueStoreTest.java       | 207 ++++++++++++++++++
 ...DelegatingPeekingKeyValueIteratorTest.java |  12 +-
 ...edSortedCacheSessionStoreIteratorTest.java | 113 ++++++++++
 ...gedSortedCacheWindowStoreIteratorTest.java |  35 ++-
 .../internals/ReadOnlyWindowStoreStub.java    |   5 +
 .../RocksDBKeyValueStoreSupplierTest.java     | 155 +++++++++++++
 .../RocksDBSessionStoreSupplierTest.java      | 169 ++++++++++++++
 .../RocksDBWindowStoreSupplierTest.java       | 168 ++++++++++++++
 .../internals/RocksDBWindowStoreTest.java     |   2 -
 .../SerializedKeyValueIteratorTest.java       |  95 ++++++++
 40 files changed, 2081 insertions(+), 642 deletions(-)
 create mode 100644 streams/src/main/java/org/apache/kafka/streams/state/internals/AbstractMergedSortedCacheStoreIterator.java
 create mode 100644 streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStore.java
 create mode 100644 streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStore.java
 create mode 100644 streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIterator.java
 create mode 100644 streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheWindowStoreIterator.java
 delete mode 100644 streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCachedWindowStoreIterator.java
 delete mode 100644 streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredWindowStore.java
 create mode 100644 streams/src/main/java/org/apache/kafka/streams/state/internals/SerializedKeyValueIterator.java
 create mode 100644 streams/src/main/java/org/apache/kafka/streams/state/internals/WrappedStateStore.java
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStoreTest.java
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIteratorTest.java
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplierTest.java
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplierTest.java
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplierTest.java
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/state/internals/SerializedKeyValueIteratorTest.java

diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionKeySerde.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionKeySerde.java
index 48213d67da153..d9a3528433916 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionKeySerde.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionKeySerde.java
@@ -20,6 +20,7 @@
 import org.apache.kafka.common.serialization.Serde;
 import org.apache.kafka.common.serialization.Serializer;
 import org.apache.kafka.common.utils.Bytes;
+import org.apache.kafka.streams.kstream.Window;
 import org.apache.kafka.streams.kstream.Windowed;
 
 import java.nio.ByteBuffer;
@@ -146,4 +147,20 @@ public static <K> Bytes toBinary(final Windowed<K> sessionKey, final Serializer<
         buf.putLong(sessionKey.window().start());
         return new Bytes(buf.array());
     }
+
+    public static Bytes bytesToBinary(final Windowed<Bytes> sessionKey) {
+        final byte[] bytes = sessionKey.key().get();
+        ByteBuffer buf = ByteBuffer.allocate(bytes.length + 2 * TIMESTAMP_SIZE);
+        buf.put(bytes);
+        buf.putLong(sessionKey.window().end());
+        buf.putLong(sessionKey.window().start());
+        return new Bytes(buf.array());
+    }
+
+    public static Window extractWindow(final byte [] binaryKey) {
+        final ByteBuffer buffer = ByteBuffer.wrap(binaryKey);
+        final long start = buffer.getLong(binaryKey.length - TIMESTAMP_SIZE);
+        final long end = buffer.getLong(binaryKey.length - 2 * TIMESTAMP_SIZE);
+        return new TimeWindow(start, end);
+    }
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/WindowStoreIterator.java b/streams/src/main/java/org/apache/kafka/streams/state/WindowStoreIterator.java
index b6e6d0c2df381..958b7788411fa 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/WindowStoreIterator.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/WindowStoreIterator.java
@@ -22,7 +22,6 @@
 import org.apache.kafka.streams.KeyValue;
 
 import java.io.Closeable;
-import java.util.Iterator;
 
 /**
  * Iterator interface of {@link KeyValue} with key typed {@link Long} used for {@link WindowStore#fetch(Object, long, long)}.
@@ -32,7 +31,7 @@
  *
  * @param <E> Type of values
  */
-public interface WindowStoreIterator<E> extends Iterator<KeyValue<Long, E>>, Closeable {
+public interface WindowStoreIterator<V> extends KeyValueIterator<Long, V>, Closeable {
 
     @Override
     void close();
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/AbstractMergedSortedCacheStoreIterator.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/AbstractMergedSortedCacheStoreIterator.java
new file mode 100644
index 0000000000000..009dad05937c4
--- /dev/null
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/AbstractMergedSortedCacheStoreIterator.java
@@ -0,0 +1,166 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.common.utils.Bytes;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.state.KeyValueIterator;
+import org.apache.kafka.streams.state.StateSerdes;
+
+import java.util.NoSuchElementException;
+
+/**
+ * Merges two iterators. Assumes each of them is sorted by key
+ *
+ * @param <K>
+ * @param <V>
+ */
+abstract class AbstractMergedSortedCacheStoreIterator<K, KS, V> implements KeyValueIterator<K, V> {
+    private final PeekingKeyValueIterator<Bytes, LRUCacheEntry> cacheIterator;
+    private final KeyValueIterator<KS, byte[]> storeIterator;
+    protected final StateSerdes<K, V> serdes;
+
+    AbstractMergedSortedCacheStoreIterator(final PeekingKeyValueIterator<Bytes, LRUCacheEntry> cacheIterator,
+                                           final KeyValueIterator<KS, byte[]> storeIterator,
+                                           final StateSerdes<K, V> serdes) {
+        this.cacheIterator = cacheIterator;
+        this.storeIterator = storeIterator;
+        this.serdes = serdes;
+    }
+
+    abstract int compare(final Bytes cacheKey, final KS storeKey);
+
+    abstract K deserializeStoreKey(final KS key);
+
+    abstract KeyValue<K, V> deserializeStorePair(final KeyValue<KS, byte[]> pair);
+
+    abstract K deserializeCacheKey(final Bytes cacheKey);
+
+    private boolean isDeletedCacheEntry(final KeyValue<Bytes, LRUCacheEntry> nextFromCache) {
+        return nextFromCache.value.value == null;
+    }
+
+    @Override
+    public boolean hasNext() {
+        // skip over items deleted from cache, and corresponding store items if they have the same key
+        while (cacheIterator.hasNext() && isDeletedCacheEntry(cacheIterator.peekNext())) {
+            if (storeIterator.hasNext()) {
+                final KS nextStoreKey = storeIterator.peekNextKey();
+                // advance the store iterator if the key is the same as the deleted cache key
+                if (compare(cacheIterator.peekNextKey(), nextStoreKey) == 0) {
+                    storeIterator.next();
+                }
+            }
+            cacheIterator.next();
+        }
+
+        return cacheIterator.hasNext() || storeIterator.hasNext();
+    }
+
+    @Override
+    public KeyValue<K, V> next() {
+        if (!hasNext()) {
+            throw new NoSuchElementException();
+        }
+
+        final Bytes nextCacheKey = cacheIterator.hasNext() ? cacheIterator.peekNextKey() : null;
+        final KS nextStoreKey = storeIterator.hasNext() ? storeIterator.peekNextKey() : null;
+
+        if (nextCacheKey == null) {
+            return nextStoreValue(nextStoreKey);
+        }
+
+        if (nextStoreKey == null) {
+            return nextCacheValue(nextCacheKey);
+        }
+
+        final int comparison = compare(nextCacheKey, nextStoreKey);
+        if (comparison > 0) {
+            return nextStoreValue(nextStoreKey);
+        } else if (comparison < 0) {
+            return nextCacheValue(nextCacheKey);
+        } else {
+            // skip the same keyed element
+            storeIterator.next();
+            return nextCacheValue(nextCacheKey);
+        }
+    }
+
+    private KeyValue<K, V> nextStoreValue(KS nextStoreKey) {
+        final KeyValue<KS, byte[]> next = storeIterator.next();
+
+        if (!next.key.equals(nextStoreKey)) {
+            throw new IllegalStateException("Next record key is not the peeked key value; this should not happen");
+        }
+
+        return deserializeStorePair(next);
+    }
+
+    private KeyValue<K, V> nextCacheValue(Bytes nextCacheKey) {
+        final KeyValue<Bytes, LRUCacheEntry> next = cacheIterator.next();
+
+        if (!next.key.equals(nextCacheKey)) {
+            throw new IllegalStateException("Next record key is not the peeked key value; this should not happen");
+        }
+
+        return KeyValue.pair(deserializeCacheKey(next.key), serdes.valueFrom(next.value.value));
+    }
+
+    @Override
+    public K peekNextKey() {
+        if (!hasNext()) {
+            throw new NoSuchElementException();
+        }
+
+        final Bytes nextCacheKey = cacheIterator.hasNext() ? cacheIterator.peekNextKey() : null;
+        final KS nextStoreKey = storeIterator.hasNext() ? storeIterator.peekNextKey() : null;
+
+        if (nextCacheKey == null) {
+            return deserializeStoreKey(nextStoreKey);
+        }
+
+        if (nextStoreKey == null) {
+            return serdes.keyFrom(nextCacheKey.get());
+        }
+
+        final int comparison = compare(nextCacheKey, nextStoreKey);
+        if (comparison > 0) {
+            return deserializeStoreKey(nextStoreKey);
+        } else if (comparison < 0) {
+            return deserializeCacheKey(nextCacheKey);
+        } else {
+            // skip the same keyed element
+            storeIterator.next();
+            return deserializeCacheKey(nextCacheKey);
+        }
+    }
+
+    @Override
+    public void remove() {
+        throw new UnsupportedOperationException("remove() is not supported");
+    }
+
+    @Override
+    public void close() {
+        cacheIterator.close();
+        storeIterator.close();
+    }
+}
+
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingKeyValueStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingKeyValueStore.java
index fdb03fd13e0a5..9a0a9763cbfa1 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingKeyValueStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingKeyValueStore.java
@@ -31,7 +31,7 @@
 
 import java.util.List;
 
-class CachingKeyValueStore<K, V> implements KeyValueStore<K, V>, CachedStateStore<K, V> {
+class CachingKeyValueStore<K, V> implements WrappedStateStore, KeyValueStore<K, V>, CachedStateStore<K, V> {
 
     private final KeyValueStore<Bytes, byte[]> underlying;
     private final Serde<K> keySerde;
@@ -234,4 +234,12 @@ public synchronized V delete(final K key) {
     KeyValueStore<Bytes, byte[]> underlying() {
         return underlying;
     }
+
+    @Override
+    public StateStore inner() {
+        if (underlying instanceof WrappedStateStore) {
+            return ((WrappedStateStore) underlying).inner();
+        }
+        return underlying;
+    }
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java
index 17c4ee0084684..fec660932a696 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java
@@ -19,7 +19,6 @@
 import org.apache.kafka.common.serialization.Serde;
 import org.apache.kafka.common.utils.Bytes;
 import org.apache.kafka.streams.KeyValue;
-import org.apache.kafka.streams.errors.InvalidStateStoreException;
 import org.apache.kafka.streams.kstream.Windowed;
 import org.apache.kafka.streams.kstream.internals.CacheFlushListener;
 import org.apache.kafka.streams.kstream.internals.SessionKeySerde;
@@ -35,21 +34,22 @@
 import java.util.NoSuchElementException;
 
 
-class CachingSessionStore<K, AGG>  implements SessionStore<K, AGG>, CachedStateStore<Windowed<K>, AGG> {
+class CachingSessionStore<K, AGG> extends WrappedStateStore.AbstractWrappedStateStore implements SessionStore<K, AGG>, CachedStateStore<Windowed<K>, AGG> {
 
-    private final SegmentedBytesStore bytesStore;
+    private final SessionStore<Bytes, byte[]> bytesStore;
     private final SessionKeySchema keySchema;
     private Serde<K> keySerde;
     private final Serde<AGG> aggSerde;
     private InternalProcessorContext context;
     private String name;
-    private StateSerdes<Windowed<K>, AGG> serdes;
+    private StateSerdes<K, AGG> serdes;
     private ThreadCache cache;
     private CacheFlushListener<Windowed<K>, AGG> flushListener;
 
-    CachingSessionStore(final SegmentedBytesStore bytesStore,
+    CachingSessionStore(final SessionStore<Bytes, byte[]> bytesStore,
                         final Serde<K> keySerde,
                         final Serde<AGG> aggSerde) {
+        super(bytesStore);
         this.bytesStore = bytesStore;
         this.keySerde = keySerde;
         this.aggSerde = aggSerde;
@@ -65,12 +65,12 @@ public KeyValueIterator<Windowed<K>, AGG> findSessions(final K key,
                                                                                   keySchema.lowerRange(binarySessionId,
                                                                                                        earliestSessionEndTime).get(),
                                                                                   keySchema.upperRange(binarySessionId, latestSessionStartTime).get());
-        final KeyValueIterator<Bytes, byte[]> storeIterator = bytesStore.fetch(binarySessionId, earliestSessionEndTime, latestSessionStartTime);
+        final KeyValueIterator<Windowed<Bytes>, byte[]> storeIterator = bytesStore.findSessions(binarySessionId, earliestSessionEndTime, latestSessionStartTime);
         final HasNextCondition hasNextCondition = keySchema.hasNextCondition(binarySessionId,
-                                                                                    earliestSessionEndTime,
-                                                                                    latestSessionStartTime);
+                                                                             earliestSessionEndTime,
+                                                                             latestSessionStartTime);
         final PeekingKeyValueIterator<Bytes, LRUCacheEntry> filteredCacheIterator = new FilteredCacheIterator(cacheIterator, hasNextCondition);
-        return new MergedSortedCacheKeyValueStoreIterator<>(filteredCacheIterator, storeIterator, serdes);
+        return new MergedSortedCacheSessionStoreIterator<>(filteredCacheIterator, storeIterator, serdes);
     }
 
 
@@ -92,11 +92,6 @@ public KeyValueIterator<Windowed<K>, AGG> fetch(final K key) {
         return findSessions(key, 0, Long.MAX_VALUE);
     }
 
-
-    public String name() {
-        return bytesStore.name();
-    }
-
     @SuppressWarnings("unchecked")
     public void init(final ProcessorContext context, final StateStore root) {
         bytesStore.init(context, root);
@@ -107,14 +102,9 @@ public void init(final ProcessorContext context, final StateStore root) {
     private void initInternal(final InternalProcessorContext context) {
         this.context = context;
 
-        if (keySerde == null) {
-            keySerde = (Serde<K>) context.keySerde();
-        }
-
-
-        this.serdes = (StateSerdes<Windowed<K>, AGG>) new StateSerdes<>(bytesStore.name(),
-                                                                              new SessionKeySerde<>(keySerde),
-                                                                              aggSerde == null ? context.valueSerde() : aggSerde);
+        this.serdes = new StateSerdes<>(bytesStore.name(),
+                                        keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
+                                        aggSerde == null ? (Serde<AGG>) context.valueSerde() : aggSerde);
 
 
         this.name = context.taskId() + "-" + bytesStore.name();
@@ -135,27 +125,27 @@ private void putAndMaybeForward(final ThreadCache.DirtyEntry entry, final Intern
         final RecordContext current = context.recordContext();
         context.setRecordContext(entry.recordContext());
         try {
+            final Windowed<K> key = SessionKeySerde.from(binaryKey.get(), keySerde.deserializer());
             if (flushListener != null) {
-                final Windowed<K> key = SessionKeySerde.from(binaryKey.get(), keySerde.deserializer());
                 final AGG newValue = serdes.valueFrom(entry.newValue());
                 final AGG oldValue = fetchPrevious(binaryKey);
                 if (!(newValue == null && oldValue == null)) {
                     flushListener.apply(key, newValue == null ? null : newValue, oldValue);
                 }
-
             }
-            bytesStore.put(binaryKey, entry.newValue());
+            bytesStore.put(new Windowed<>(Bytes.wrap(serdes.rawKey(key.key())), key.window()), entry.newValue());
         } finally {
             context.setRecordContext(current);
         }
     }
 
     private AGG fetchPrevious(final Bytes key) {
-        final byte[] bytes = bytesStore.get(key);
-        if (bytes == null) {
-            return null;
+        try (final KeyValueIterator<Windowed<Bytes>, byte[]> iterator = bytesStore.fetch(key)) {
+            if (!iterator.hasNext()) {
+                return null;
+            }
+            return serdes.valueFrom(iterator.next().value);
         }
-        return serdes.valueFrom(bytes);
     }
 
 
@@ -170,25 +160,10 @@ public void close() {
         cache.close(name);
     }
 
-    public boolean persistent() {
-        return bytesStore.persistent();
-    }
-
-    public boolean isOpen() {
-        return bytesStore.isOpen();
-    }
-
     public void setFlushListener(CacheFlushListener<Windowed<K>, AGG> flushListener) {
         this.flushListener = flushListener;
     }
 
-    private void validateStoreOpen() {
-        if (!isOpen()) {
-            throw new InvalidStateStoreException("Store " + this.name + " is currently closed");
-        }
-    }
-
-
     private static class FilteredCacheIterator implements PeekingKeyValueIterator<Bytes, LRUCacheEntry> {
         private final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator;
         private final HasNextCondition hasNextCondition;
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingWindowStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingWindowStore.java
index bd252f147d0ae..d471761f36475 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingWindowStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingWindowStore.java
@@ -17,8 +17,8 @@
 package org.apache.kafka.streams.state.internals;
 
 import org.apache.kafka.common.serialization.Serde;
+import org.apache.kafka.common.serialization.Serdes;
 import org.apache.kafka.common.utils.Bytes;
-import org.apache.kafka.streams.errors.InvalidStateStoreException;
 import org.apache.kafka.streams.kstream.Windowed;
 import org.apache.kafka.streams.kstream.internals.CacheFlushListener;
 import org.apache.kafka.streams.kstream.internals.TimeWindow;
@@ -26,16 +26,15 @@
 import org.apache.kafka.streams.processor.StateStore;
 import org.apache.kafka.streams.processor.internals.InternalProcessorContext;
 import org.apache.kafka.streams.processor.internals.RecordContext;
-import org.apache.kafka.streams.state.KeyValueIterator;
 import org.apache.kafka.streams.state.StateSerdes;
 import org.apache.kafka.streams.state.WindowStore;
 import org.apache.kafka.streams.state.WindowStoreIterator;
 
 import java.util.List;
 
-class CachingWindowStore<K, V> implements WindowStore<K, V>, CachedStateStore<Windowed<K>, V> {
+class CachingWindowStore<K, V> extends WrappedStateStore.AbstractWrappedStateStore implements WindowStore<K, V>, CachedStateStore<Windowed<K>, V> {
 
-    private final SegmentedBytesStore underlying;
+    private final WindowStore<Bytes, byte[]> underlying;
     private final Serde<K> keySerde;
     private final Serde<V> valueSerde;
     private CacheFlushListener<Windowed<K>, V> flushListener;
@@ -45,21 +44,17 @@ class CachingWindowStore<K, V> implements WindowStore<K, V>, CachedStateStore<Wi
     private InternalProcessorContext context;
     private StateSerdes<K, V> serdes;
 
-    CachingWindowStore(final SegmentedBytesStore underlying,
+    CachingWindowStore(final WindowStore<Bytes, byte[]> underlying,
                        final Serde<K> keySerde,
                        final Serde<V> valueSerde,
                        final long windowSize) {
+        super(underlying);
         this.underlying = underlying;
         this.keySerde = keySerde;
         this.valueSerde = valueSerde;
         this.windowSize = windowSize;
     }
 
-    @Override
-    public String name() {
-        return underlying.name();
-    }
-
     @SuppressWarnings("unchecked")
     @Override
     public void init(final ProcessorContext context, final StateStore root) {
@@ -80,13 +75,14 @@ void initInternal(final ProcessorContext context) {
             @Override
             public void apply(final List<ThreadCache.DirtyEntry> entries) {
                 for (ThreadCache.DirtyEntry entry : entries) {
-                    final byte[] binaryKey = entry.key().get();
-                    final Bytes key = WindowStoreUtils.bytesKeyFromBinaryKey(binaryKey);
-                    final long timestamp = WindowStoreUtils.timestampFromBinaryKey(binaryKey);
-                    final Windowed<K> windowedKey = new Windowed<>(WindowStoreUtils.keyFromBinaryKey(binaryKey, serdes),
+                    final byte[] binaryWindowKey = entry.key().get();
+                    final long timestamp = WindowStoreUtils.timestampFromBinaryKey(binaryWindowKey);
+
+                    final Windowed<K> windowedKey = new Windowed<>(WindowStoreUtils.keyFromBinaryKey(binaryWindowKey, serdes),
                                                                    new TimeWindow(timestamp, timestamp + windowSize));
-                    maybeForward(entry, Bytes.wrap(binaryKey), windowedKey, (InternalProcessorContext) context);
-                    underlying.put(Bytes.wrap(WindowStoreUtils.toBinaryKey(key, timestamp, 0, WindowStoreUtils.INNER_SERDES)), entry.newValue());
+                    final Bytes key = WindowStoreUtils.bytesKeyFromBinaryKey(binaryWindowKey);
+                    maybeForward(entry, key, windowedKey, (InternalProcessorContext) context);
+                    underlying.put(key, entry.newValue(), timestamp);
                 }
             }
         });
@@ -102,7 +98,7 @@ private void maybeForward(final ThreadCache.DirtyEntry entry,
             context.setRecordContext(entry.recordContext());
             try {
                 flushListener.apply(windowedKey,
-                                    serdes.valueFrom(entry.newValue()), fetchPrevious(key));
+                                    serdes.valueFrom(entry.newValue()), fetchPrevious(key, windowedKey.window().start()));
             } finally {
                 context.setRecordContext(current);
             }
@@ -127,16 +123,6 @@ public void close() {
         cache.close(name);
     }
 
-    @Override
-    public boolean persistent() {
-        return underlying.persistent();
-    }
-
-    @Override
-    public boolean isOpen() {
-        return underlying.isOpen();
-    }
-
     @Override
     public synchronized void put(final K key, final V value) {
         put(key, value, context.timestamp());
@@ -158,23 +144,21 @@ public synchronized WindowStoreIterator<V> fetch(final K key, final long timeFro
         byte[] binaryFrom = WindowStoreUtils.toBinaryKey(key, timeFrom, 0, serdes);
         byte[] binaryTo = WindowStoreUtils.toBinaryKey(key, timeTo, 0, serdes);
 
-        final KeyValueIterator<Bytes, byte[]> underlyingIterator = underlying.fetch(Bytes.wrap(serdes.rawKey(key)), timeFrom, timeTo);
+        final WindowStoreIterator<byte[]> underlyingIterator = underlying.fetch(Bytes.wrap(serdes.rawKey(key)), timeFrom, timeTo);
         final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator = cache.range(name, binaryFrom, binaryTo);
-        return new MergedSortedCachedWindowStoreIterator<>(cacheIterator, new DelegatingPeekingKeyValueIterator<>(name, underlyingIterator), serdes);
+        return new MergedSortedCacheWindowStoreIterator<>(cacheIterator,
+                                                          underlyingIterator,
+                                                          new StateSerdes<>(serdes.stateName(), Serdes.Long(), serdes.valueSerde()));
     }
 
 
-    private V fetchPrevious(final Bytes key) {
-        final byte[] result = underlying.get(key);
-        if (result == null) {
-            return null;
-        }
-        return serdes.valueFrom(result);
-    }
-
-    private void validateStoreOpen() {
-        if (!isOpen()) {
-            throw new InvalidStateStoreException("Store " + this.name + " is currently closed");
+    private V fetchPrevious(final Bytes key, final long timestamp) {
+        try (final WindowStoreIterator<byte[]> iter = underlying.fetch(key, timestamp, timestamp)) {
+            if (!iter.hasNext()) {
+                return null;
+            } else {
+                return serdes.valueFrom(iter.next().value);
+            }
         }
     }
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStore.java
new file mode 100644
index 0000000000000..e31d04bd1f51f
--- /dev/null
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStore.java
@@ -0,0 +1,93 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.common.utils.Bytes;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.processor.ProcessorContext;
+import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.state.KeyValueIterator;
+import org.apache.kafka.streams.state.KeyValueStore;
+
+import java.util.List;
+
+public class ChangeLoggingKeyValueBytesStore extends WrappedStateStore.AbstractWrappedStateStore implements KeyValueStore<Bytes, byte[]> {
+    private final KeyValueStore<Bytes, byte[]> inner;
+    private StoreChangeLogger<Bytes, byte[]> changeLogger;
+
+    public ChangeLoggingKeyValueBytesStore(final KeyValueStore<Bytes, byte[]> inner) {
+        super(inner);
+        this.inner = inner;
+    }
+
+    @Override
+    public void init(final ProcessorContext context, final StateStore root) {
+        inner.init(context, root);
+        this.changeLogger = new StoreChangeLogger<>(inner.name(), context, WindowStoreUtils.INNER_SERDES);
+    }
+
+
+    @Override
+    public void put(final Bytes key, final byte[] value) {
+        inner.put(key, value);
+        changeLogger.logChange(key, value);
+    }
+
+    @Override
+    public byte[] putIfAbsent(final Bytes key, final byte[] value) {
+        final byte[] previous = get(key);
+        if (previous == null) {
+            put(key, value);
+        }
+        return previous;
+    }
+
+    @Override
+    public void putAll(final List<KeyValue<Bytes, byte[]>> entries) {
+        inner.putAll(entries);
+        for (KeyValue<Bytes, byte[]> entry : entries) {
+            changeLogger.logChange(entry.key, entry.value);
+        }
+    }
+
+    @Override
+    public byte[] delete(final Bytes key) {
+        final byte[] oldValue = inner.get(key);
+        put(key, null);
+        return oldValue;
+    }
+
+    @Override
+    public byte[] get(final Bytes key) {
+        return inner.get(key);
+    }
+
+    @Override
+    public KeyValueIterator<Bytes, byte[]> range(final Bytes from, final Bytes to) {
+        return inner.range(from, to);
+    }
+
+    @Override
+    public KeyValueIterator<Bytes, byte[]> all() {
+        return inner.all();
+    }
+
+    @Override
+    public long approximateNumEntries() {
+        return inner.approximateNumEntries();
+    }
+}
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStore.java
new file mode 100644
index 0000000000000..11cf8022d8bb3
--- /dev/null
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStore.java
@@ -0,0 +1,127 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.common.serialization.Serde;
+import org.apache.kafka.common.utils.Bytes;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.processor.ProcessorContext;
+import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.state.KeyValueIterator;
+import org.apache.kafka.streams.state.KeyValueStore;
+import org.apache.kafka.streams.state.StateSerdes;
+
+import java.util.ArrayList;
+import java.util.List;
+
+class ChangeLoggingKeyValueStore<K, V> extends WrappedStateStore.AbstractWrappedStateStore implements KeyValueStore<K, V> {
+    private final ChangeLoggingKeyValueBytesStore innerBytes;
+    private final Serde keySerde;
+    private final Serde valueSerde;
+    private StateSerdes<K, V> serdes;
+
+    ChangeLoggingKeyValueStore(final KeyValueStore<Bytes, byte[]> bytesStore,
+                               final Serde keySerde,
+                               final Serde valueSerde) {
+        this(new ChangeLoggingKeyValueBytesStore(bytesStore), keySerde, valueSerde);
+    }
+
+    private ChangeLoggingKeyValueStore(final ChangeLoggingKeyValueBytesStore bytesStore,
+                                       final Serde keySerde,
+                                       final Serde valueSerde) {
+        super(bytesStore);
+        this.innerBytes = bytesStore;
+        this.keySerde = keySerde;
+        this.valueSerde = valueSerde;
+    }
+
+    @Override
+    public String name() {
+        return null;
+    }
+
+    @SuppressWarnings("unchecked")
+    @Override
+    public void init(final ProcessorContext context, final StateStore root) {
+        innerBytes.init(context, root);
+
+        this.serdes = new StateSerdes<>(innerBytes.name(),
+                                        keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
+                                        valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
+    }
+
+    @Override
+    public void put(final K key, final V value) {
+        final Bytes bytesKey = Bytes.wrap(serdes.rawKey(key));
+        final byte[] bytesValue = serdes.rawValue(value);
+        innerBytes.put(bytesKey, bytesValue);
+    }
+
+    @Override
+    public V putIfAbsent(final K key, final V value) {
+        final V v = get(key);
+        if (v == null) {
+            put(key, value);
+        }
+        return v;
+    }
+
+    @Override
+    public void putAll(final List<KeyValue<K, V>> entries) {
+        final List<KeyValue<Bytes, byte[]>> keyValues = new ArrayList<>();
+        for (final KeyValue<K, V> entry : entries) {
+            keyValues.add(KeyValue.pair(Bytes.wrap(serdes.rawKey(entry.key)), serdes.rawValue(entry.value)));
+        }
+        innerBytes.putAll(keyValues);
+    }
+
+    @Override
+    public V delete(final K key) {
+        final byte[] oldValue = innerBytes.delete(Bytes.wrap(serdes.rawKey(key)));
+        if (oldValue == null) {
+            return null;
+        }
+        return serdes.valueFrom(oldValue);
+    }
+
+    @Override
+    public V get(final K key) {
+        final byte[] rawValue = innerBytes.get(Bytes.wrap(serdes.rawKey(key)));
+        if (rawValue == null) {
+            return null;
+        }
+        return serdes.valueFrom(rawValue);
+    }
+
+    @Override
+    public KeyValueIterator<K, V> range(final K from, final K to) {
+        return new SerializedKeyValueIterator<>(innerBytes.range(Bytes.wrap(serdes.rawKey(from)),
+                                                                 Bytes.wrap(serdes.rawKey(to))),
+                                                serdes);
+    }
+
+    @Override
+    public KeyValueIterator<K, V> all() {
+        return new SerializedKeyValueIterator<>(innerBytes.all(), serdes);
+    }
+
+    @Override
+    public long approximateNumEntries() {
+        return innerBytes.approximateNumEntries();
+    }
+
+}
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStore.java
index 14b8f1710e287..21c28662522d5 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStore.java
@@ -25,13 +25,14 @@
  * Simple wrapper around a {@link SegmentedBytesStore} to support writing
  * updates to a changelog
  */
-class ChangeLoggingSegmentedBytesStore implements SegmentedBytesStore {
+class ChangeLoggingSegmentedBytesStore extends WrappedStateStore.AbstractWrappedStateStore implements SegmentedBytesStore {
 
     private final SegmentedBytesStore bytesStore;
     private StoreChangeLogger<Bytes, byte[]> changeLogger;
 
 
     ChangeLoggingSegmentedBytesStore(final SegmentedBytesStore bytesStore) {
+        super(bytesStore);
         this.bytesStore = bytesStore;
     }
 
@@ -60,10 +61,6 @@ public byte[] get(final Bytes key) {
         return bytesStore.get(key);
     }
 
-    @Override
-    public String name() {
-        return bytesStore.name();
-    }
 
     @Override
     @SuppressWarnings("unchecked")
@@ -71,25 +68,4 @@ public void init(final ProcessorContext context, final StateStore root) {
         bytesStore.init(context, root);
         changeLogger = new StoreChangeLogger<>(name(), context, WindowStoreUtils.INNER_SERDES);
     }
-
-    @Override
-    public void flush() {
-        bytesStore.flush();
-    }
-
-    @Override
-    public void close() {
-        bytesStore.close();
-    }
-
-    @Override
-    public boolean persistent() {
-        return bytesStore.persistent();
-    }
-
-    @Override
-    public boolean isOpen() {
-        return bytesStore.isOpen();
-    }
-
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/CompositeReadOnlyWindowStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/CompositeReadOnlyWindowStore.java
index b33c0f0ceab3d..e0f1ec85b037b 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/CompositeReadOnlyWindowStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/CompositeReadOnlyWindowStore.java
@@ -61,6 +61,11 @@ public WindowStoreIterator<V> fetch(final K key, final long timeFrom, final long
             public void close() {
             }
 
+            @Override
+            public Long peekNextKey() {
+                throw new NoSuchElementException();
+            }
+
             @Override
             public boolean hasNext() {
                 return false;
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/DelegatingPeekingKeyValueIterator.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/DelegatingPeekingKeyValueIterator.java
index eb57acee688cf..f3101b17f9c54 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/DelegatingPeekingKeyValueIterator.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/DelegatingPeekingKeyValueIterator.java
@@ -22,7 +22,7 @@
 
 import java.util.NoSuchElementException;
 
-public class DelegatingPeekingKeyValueIterator<K, V> implements KeyValueIterator<K, V> {
+public class DelegatingPeekingKeyValueIterator<K, V> implements KeyValueIterator<K, V>, PeekingKeyValueIterator<K, V> {
     private final String storeName;
     private final KeyValueIterator<K, V> underlying;
     private KeyValue<K, V> next;
@@ -78,4 +78,12 @@ public synchronized KeyValue<K, V> next() {
     public void remove() {
         throw new UnsupportedOperationException("remove not supported");
     }
+
+    @Override
+    public KeyValue<K, V> peekNext() {
+        if (!hasNext()) {
+            throw new NoSuchElementException();
+        }
+        return next;
+    }
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheKeyValueStoreIterator.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheKeyValueStoreIterator.java
index c9a6866d9d17a..b860e161e0d9f 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheKeyValueStoreIterator.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheKeyValueStoreIterator.java
@@ -21,141 +21,37 @@
 import org.apache.kafka.streams.state.KeyValueIterator;
 import org.apache.kafka.streams.state.StateSerdes;
 
-import java.util.Comparator;
-import java.util.NoSuchElementException;
-
 /**
  * Merges two iterators. Assumes each of them is sorted by key
  *
  * @param <K>
  * @param <V>
  */
-class MergedSortedCacheKeyValueStoreIterator<K, V> implements KeyValueIterator<K, V> {
-    private final PeekingKeyValueIterator<Bytes, LRUCacheEntry> cacheIterator;
-    private final KeyValueIterator<Bytes, byte[]> storeIterator;
-    private final StateSerdes<K, V> serdes;
-    private final Comparator<byte[]> comparator = Bytes.BYTES_LEXICO_COMPARATOR;
-
-    public MergedSortedCacheKeyValueStoreIterator(final PeekingKeyValueIterator<Bytes, LRUCacheEntry> cacheIterator,
-                                                  final KeyValueIterator<Bytes, byte[]> storeIterator,
-                                                  final StateSerdes<K, V> serdes) {
-        this.cacheIterator = cacheIterator;
-        this.storeIterator = storeIterator;
-        this.serdes = serdes;
-    }
-
-    @Override
-    public boolean hasNext() {
-        while (cacheIterator.hasNext() && isDeletedCacheEntry(cacheIterator.peekNext())) {
-            if (storeIterator.hasNext()) {
-                final Bytes storeKey = storeIterator.peekNextKey();
-                // advance the store iterator if the key is the same as the deleted cache key
-                if (storeKey.equals(cacheIterator.peekNextKey())) {
-                    storeIterator.next();
-                }
-            }
-            // skip over items deleted from cache
-            cacheIterator.next();
-        }
-        return cacheIterator.hasNext() || storeIterator.hasNext();
-    }
+class MergedSortedCacheKeyValueStoreIterator<K, V> extends AbstractMergedSortedCacheStoreIterator<K, Bytes, V> {
 
-
-    private boolean isDeletedCacheEntry(final KeyValue<Bytes, LRUCacheEntry> nextFromCache) {
-        return  nextFromCache.value.value == null;
+    MergedSortedCacheKeyValueStoreIterator(final PeekingKeyValueIterator<Bytes, LRUCacheEntry> cacheIterator,
+                                           final KeyValueIterator<Bytes, byte[]> storeIterator,
+                                           final StateSerdes<K, V> serdes) {
+        super(cacheIterator, storeIterator, serdes);
     }
 
-
     @Override
-    public KeyValue<K, V> next() {
-
-        return internalNext(new NextValueFunction<KeyValue<K, V>>() {
-            @Override
-            public KeyValue<K, V> apply(final byte[] cacheKey, final byte[] storeKey) {
-                if (cacheKey == null) {
-                    return nextStoreValue();
-                }
-
-                if (storeKey == null) {
-                    return nextCacheValue();
-                }
-
-                final int comparison = comparator.compare(cacheKey, storeKey);
-                if (comparison > 0) {
-                    return nextStoreValue();
-                } else if (comparison < 0) {
-                    return nextCacheValue();
-                } else {
-                    storeIterator.next();
-                    return nextCacheValue();
-                }
-            }
-        });
+    public KeyValue<K, V> deserializeStorePair(KeyValue<Bytes, byte[]> pair) {
+        return KeyValue.pair(serdes.keyFrom(pair.key.get()), serdes.valueFrom(pair.value));
     }
 
     @Override
-    public K peekNextKey() {
-        return internalNext(new NextValueFunction<K>() {
-            @Override
-            public K apply(final byte[] cacheKey, final byte[] storeKey) {
-                if (cacheKey == null) {
-                    return serdes.keyFrom(storeKey);
-                }
-
-                if (storeKey == null) {
-                    return serdes.keyFrom(cacheKey);
-                }
-
-                final int comparison = comparator.compare(cacheKey, storeKey);
-                if (comparison > 0) {
-                    return serdes.keyFrom(storeKey);
-                } else {
-                    return serdes.keyFrom(cacheKey);
-                }
-            }
-        });
-    }
-
-    interface NextValueFunction<T> {
-        T apply(final byte[] cacheKey, final byte [] storeKey);
-    }
-
-    private <T> T internalNext(final NextValueFunction<T> nextValueFunction) {
-        if (!hasNext()) {
-            throw new NoSuchElementException();
-        }
-
-        byte[] nextCacheKey = null;
-        if (cacheIterator.hasNext()) {
-            nextCacheKey = cacheIterator.peekNextKey().get();
-        }
-
-        byte[] nextStoreKey = null;
-        if (storeIterator.hasNext()) {
-            nextStoreKey = storeIterator.peekNextKey().get();
-        }
-
-        return nextValueFunction.apply(nextCacheKey, nextStoreKey);
-    }
-
-    private KeyValue<K, V> nextCacheValue() {
-        final KeyValue<Bytes, LRUCacheEntry> next = cacheIterator.next();
-        return KeyValue.pair(serdes.keyFrom(next.key.get()), serdes.valueFrom(next.value.value));
-    }
-
-    private KeyValue<K, V> nextStoreValue() {
-        final KeyValue<Bytes, byte[]> next = storeIterator.next();
-        return KeyValue.pair(serdes.keyFrom(next.key.get()), serdes.valueFrom(next.value));
+    K deserializeCacheKey(final Bytes cacheKey) {
+        return serdes.keyFrom(cacheKey.get());
     }
 
     @Override
-    public void remove() {
-        throw new UnsupportedOperationException("remove not supported");
+    public K deserializeStoreKey(Bytes key) {
+        return serdes.keyFrom(key.get());
     }
 
     @Override
-    public void close() {
-        cacheIterator.close();
-        storeIterator.close();
+    public int compare(Bytes cacheKey, Bytes storeKey) {
+        return cacheKey.compareTo(storeKey);
     }
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIterator.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIterator.java
new file mode 100644
index 0000000000000..db64621340116
--- /dev/null
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIterator.java
@@ -0,0 +1,71 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.common.utils.Bytes;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.kstream.Windowed;
+import org.apache.kafka.streams.kstream.internals.SessionKeySerde;
+import org.apache.kafka.streams.state.KeyValueIterator;
+import org.apache.kafka.streams.state.StateSerdes;
+
+/**
+ * Merges two iterators. Assumes each of them is sorted by key
+ *
+ * @param <K>
+ * @param <AGG>
+ */
+class MergedSortedCacheSessionStoreIterator<K, AGG> extends AbstractMergedSortedCacheStoreIterator<Windowed<K>, Windowed<Bytes>, AGG> {
+    private final StateSerdes<K, AGG> rawSerdes;
+
+
+    MergedSortedCacheSessionStoreIterator(final PeekingKeyValueIterator<Bytes, LRUCacheEntry> cacheIterator,
+                                          final KeyValueIterator<Windowed<Bytes>, byte[]> storeIterator,
+                                          final StateSerdes<K, AGG> serdes) {
+        super(cacheIterator, storeIterator, new StateSerdes<>(serdes.stateName(),
+                                                              new SessionKeySerde<>(serdes.keySerde()),
+                                                              serdes.valueSerde()));
+
+        rawSerdes = serdes;
+    }
+
+    @Override
+    public KeyValue<Windowed<K>, AGG> deserializeStorePair(KeyValue<Windowed<Bytes>, byte[]> pair) {
+        final K key = rawSerdes.keyFrom(pair.key.key().get());
+        return KeyValue.pair(new Windowed<>(key, pair.key.window()), serdes.valueFrom(pair.value));
+    }
+
+    @Override
+    Windowed<K> deserializeCacheKey(final Bytes cacheKey) {
+        return SessionKeySerde.from(cacheKey.get(), rawSerdes.keyDeserializer());
+    }
+
+    @Override
+    public Windowed<K> deserializeStoreKey(Windowed<Bytes> key) {
+        final K originalKey = rawSerdes.keyFrom(key.key().get());
+        return new Windowed<K>(originalKey, key.window());
+    }
+
+    @Override
+    public int compare(Bytes cacheKey, Windowed<Bytes> storeKey) {
+        Bytes storeKeyBytes = SessionKeySerde.bytesToBinary(storeKey);
+        return cacheKey.compareTo(storeKeyBytes);
+    }
+}
+
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheWindowStoreIterator.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheWindowStoreIterator.java
new file mode 100644
index 0000000000000..a9d097320086c
--- /dev/null
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheWindowStoreIterator.java
@@ -0,0 +1,58 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.common.utils.Bytes;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.state.KeyValueIterator;
+import org.apache.kafka.streams.state.StateSerdes;
+import org.apache.kafka.streams.state.WindowStoreIterator;
+
+/**
+ * Merges two iterators. Assumes each of them is sorted by key
+ *
+ * @param <V>
+ */
+class MergedSortedCacheWindowStoreIterator<V> extends AbstractMergedSortedCacheStoreIterator<Long, Long, V> implements WindowStoreIterator<V> {
+
+    MergedSortedCacheWindowStoreIterator(final PeekingKeyValueIterator<Bytes, LRUCacheEntry> cacheIterator,
+                                         final KeyValueIterator<Long, byte[]> storeIterator,
+                                         final StateSerdes<Long, V> serdes) {
+        super(cacheIterator, storeIterator, serdes);
+    }
+
+    @Override
+    public KeyValue<Long, V> deserializeStorePair(final KeyValue<Long, byte[]> pair) {
+        return KeyValue.pair(pair.key, serdes.valueFrom(pair.value));
+    }
+
+    @Override
+    Long deserializeCacheKey(final Bytes cacheKey) {
+        return WindowStoreUtils.timestampFromBinaryKey(cacheKey.get());
+    }
+
+    @Override
+    public Long deserializeStoreKey(final Long key) {
+        return key;
+    }
+
+    @Override
+    public int compare(final Bytes cacheKey, final Long storeKey) {
+        final Long cacheTimestamp = WindowStoreUtils.timestampFromBinaryKey(cacheKey.get());
+        return cacheTimestamp.compareTo(storeKey);
+    }
+}
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCachedWindowStoreIterator.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCachedWindowStoreIterator.java
deleted file mode 100644
index e210e73111fe9..0000000000000
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCachedWindowStoreIterator.java
+++ /dev/null
@@ -1,107 +0,0 @@
-/**
- * Licensed to the Apache Software Foundation (ASF) under one or more
- * contributor license agreements.  See the NOTICE file distributed with
- * this work for additional information regarding copyright ownership.
- * The ASF licenses this file to You under the Apache License, Version 2.0
- * (the "License"); you may not use this file except in compliance with
- * the License.  You may obtain a copy of the License at
- * <p>
- * http://www.apache.org/licenses/LICENSE-2.0
- * <p>
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-package org.apache.kafka.streams.state.internals;
-
-import org.apache.kafka.common.utils.Bytes;
-import org.apache.kafka.streams.KeyValue;
-import org.apache.kafka.streams.state.KeyValueIterator;
-import org.apache.kafka.streams.state.StateSerdes;
-import org.apache.kafka.streams.state.WindowStoreIterator;
-
-import java.util.NoSuchElementException;
-
-/**
- * Merges two iterators. Assumes each of them is sorted by key
- *
- * @param <K>
- * @param <V>
- */
-class MergedSortedCachedWindowStoreIterator<K, V> implements WindowStoreIterator<V> {
-    private final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator;
-    private final KeyValueIterator<Bytes, byte[]> storeIterator;
-    private final StateSerdes<K, V> serdes;
-
-    public MergedSortedCachedWindowStoreIterator(final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator,
-                                                 final KeyValueIterator<Bytes, byte[]> storeIterator,
-                                                 final StateSerdes<K, V> serdes) {
-        this.cacheIterator = cacheIterator;
-        this.storeIterator = storeIterator;
-        this.serdes = serdes;
-    }
-
-    @Override
-    public boolean hasNext() {
-        return cacheIterator.hasNext() || storeIterator.hasNext();
-    }
-
-
-    @Override
-    public KeyValue<Long, V> next() {
-        if (!hasNext()) {
-            throw new NoSuchElementException();
-        }
-
-        Long nextCacheTimestamp = null;
-        if (cacheIterator.hasNext()) {
-            nextCacheTimestamp = WindowStoreUtils.timestampFromBinaryKey(cacheIterator.peekNextKey().get());
-        }
-
-        Long nextStoreTimestamp = null;
-        if (storeIterator.hasNext()) {
-            nextStoreTimestamp = WindowStoreUtils.timestampFromBinaryKey(storeIterator.peekNextKey().get());
-        }
-
-        if (nextCacheTimestamp == null) {
-            return nextStoreValue(nextStoreTimestamp);
-        }
-
-        if (nextStoreTimestamp == null) {
-            return nextCacheValue(nextCacheTimestamp);
-        }
-
-        final int comparison = nextCacheTimestamp.compareTo(nextStoreTimestamp);
-        if (comparison > 0) {
-            return nextStoreValue(nextStoreTimestamp);
-        } else if (comparison < 0) {
-            return nextCacheValue(nextCacheTimestamp);
-        } else {
-            storeIterator.next();
-            return nextCacheValue(nextCacheTimestamp);
-        }
-    }
-
-    private KeyValue<Long, V> nextCacheValue(final Long timestamp) {
-        final KeyValue<Bytes, LRUCacheEntry> next = cacheIterator.next();
-        return KeyValue.pair(timestamp, serdes.valueFrom(next.value.value));
-    }
-
-    private KeyValue<Long, V> nextStoreValue(final Long timestamp) {
-        final KeyValue<Bytes, byte[]> next = storeIterator.next();
-        return KeyValue.pair(timestamp, serdes.valueFrom(next.value));
-    }
-
-    @Override
-    public void remove() {
-        throw new UnsupportedOperationException("remove not supported");
-    }
-
-    @Override
-    public void close() {
-        cacheIterator.close();
-        storeIterator.close();
-    }
-}
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredKeyValueStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredKeyValueStore.java
index 926e5d4a4acf0..7dc2d3350dd8a 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredKeyValueStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredKeyValueStore.java
@@ -35,7 +35,7 @@
  * @param <K>
  * @param <V>
  */
-public class MeteredKeyValueStore<K, V> implements KeyValueStore<K, V> {
+public class MeteredKeyValueStore<K, V> extends WrappedStateStore.AbstractWrappedStateStore implements KeyValueStore<K, V> {
 
     protected final KeyValueStore<K, V> inner;
     protected final String metricScope;
@@ -102,17 +102,15 @@ public void run() {
     };
 
     // always wrap the store with the metered store
-    public MeteredKeyValueStore(final KeyValueStore<K, V> inner, String metricScope, Time time) {
+    public MeteredKeyValueStore(final KeyValueStore<K, V> inner,
+                                final String metricScope,
+                                final Time time) {
+        super(inner);
         this.inner = inner;
         this.metricScope = metricScope;
         this.time = time != null ? time : Time.SYSTEM;
     }
 
-    @Override
-    public String name() {
-        return inner.name();
-    }
-
     @Override
     public void init(ProcessorContext context, StateStore root) {
         final String name = name();
@@ -133,16 +131,6 @@ public void init(ProcessorContext context, StateStore root) {
         metrics.measureLatencyNs(time, initDelegate, this.restoreTime);
     }
 
-    @Override
-    public boolean persistent() {
-        return inner.persistent();
-    }
-
-    @Override
-    public boolean isOpen() {
-        return inner.isOpen();
-    }
-
     @Override
     public V get(K key) {
         this.key = key;
@@ -193,11 +181,6 @@ public long approximateNumEntries() {
         return this.inner.approximateNumEntries();
     }
 
-    @Override
-    public void close() {
-        inner.close();
-    }
-
     @Override
     public void flush() {
         metrics.measureLatencyNs(time, flushDelegate, this.flushTime);
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStore.java
index e0ed03ed06cd9..4eb3936be60e0 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStore.java
@@ -27,7 +27,7 @@
 import org.apache.kafka.streams.processor.StateStore;
 import org.apache.kafka.streams.state.KeyValueIterator;
 
-class MeteredSegmentedBytesStore implements SegmentedBytesStore {
+class MeteredSegmentedBytesStore extends WrappedStateStore.AbstractWrappedStateStore implements SegmentedBytesStore {
 
     private final SegmentedBytesStore inner;
     private final String metricScope;
@@ -40,17 +40,15 @@ class MeteredSegmentedBytesStore implements SegmentedBytesStore {
     private Sensor getTime;
     private Sensor removeTime;
 
-    MeteredSegmentedBytesStore(final SegmentedBytesStore inner, String metricScope, Time time) {
+    MeteredSegmentedBytesStore(final SegmentedBytesStore inner,
+                               final String metricScope,
+                               final Time time) {
+        super(inner);
         this.inner = inner;
         this.metricScope = metricScope;
         this.time = time != null ? time : new SystemTime();
     }
 
-    @Override
-    public String name() {
-        return inner.name();
-    }
-
     @Override
     public void init(ProcessorContext context, StateStore root) {
         final String name = name();
@@ -71,16 +69,6 @@ public void init(ProcessorContext context, StateStore root) {
         }
     }
 
-    @Override
-    public boolean persistent() {
-        return inner.persistent();
-    }
-
-    @Override
-    public boolean isOpen() {
-        return inner.isOpen();
-    }
-
     @Override
     public byte[] get(final Bytes key) {
         final long startNs = time.nanoseconds();
@@ -116,11 +104,6 @@ public void put(final Bytes key, final byte[] value) {
         }
     }
 
-    @Override
-    public void close() {
-        inner.close();
-    }
-
     @Override
     public void flush() {
         final long startNs = time.nanoseconds();
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredWindowStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredWindowStore.java
deleted file mode 100644
index c725c1ac6cefd..0000000000000
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredWindowStore.java
+++ /dev/null
@@ -1,180 +0,0 @@
-/**
- * Licensed to the Apache Software Foundation (ASF) under one or more
- * contributor license agreements.  See the NOTICE file distributed with
- * this work for additional information regarding copyright ownership.
- * The ASF licenses this file to You under the Apache License, Version 2.0
- * (the "License"); you may not use this file except in compliance with
- * the License.  You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package org.apache.kafka.streams.state.internals;
-
-import org.apache.kafka.common.metrics.Sensor;
-import org.apache.kafka.common.utils.Time;
-import org.apache.kafka.streams.KeyValue;
-import org.apache.kafka.streams.processor.ProcessorContext;
-import org.apache.kafka.streams.processor.StateStore;
-import org.apache.kafka.streams.processor.internals.StreamsMetricsImpl;
-import org.apache.kafka.streams.state.WindowStore;
-import org.apache.kafka.streams.state.WindowStoreIterator;
-
-public class MeteredWindowStore<K, V> implements WindowStore<K, V> {
-
-    protected final WindowStore<K, V> inner;
-    protected final String metricScope;
-    protected final Time time;
-
-    private Sensor putTime;
-    private Sensor fetchTime;
-    private Sensor flushTime;
-    private Sensor restoreTime;
-    private StreamsMetricsImpl metrics;
-
-    private ProcessorContext context;
-    private StateStore root;
-    private Runnable initDelegate = new Runnable() {
-        @Override
-        public void run() {
-            inner.init(context, root);
-        }
-    };
-
-    private K key;
-    private V value;
-    private long timestamp;
-    private Runnable putDelegate = new Runnable() {
-        @Override
-        public void run() {
-            inner.put(key, value);
-        }
-    };
-    private Runnable putTsDelegate = new Runnable() {
-        @Override
-        public void run() {
-            inner.put(key, value, timestamp);
-        }
-    };
-    private Runnable flushDelegate = new Runnable() {
-        @Override
-        public void run() {
-            inner.flush();
-        }
-    };
-
-    // always wrap the store with the metered store
-    public MeteredWindowStore(final WindowStore<K, V> inner, String metricScope, Time time) {
-        this.inner = inner;
-        this.metricScope = metricScope;
-        this.time = time != null ? time : Time.SYSTEM;
-    }
-
-    @Override
-    public String name() {
-        return inner.name();
-    }
-
-    @Override
-    public void init(ProcessorContext context, StateStore root) {
-        final String name = name();
-        this.context = context;
-        this.root = root;
-        this.metrics = (StreamsMetricsImpl) context.metrics();
-        this.putTime = this.metrics.addLatencySensor(metricScope, name, "put", Sensor.RecordingLevel.DEBUG);
-        this.fetchTime = this.metrics.addLatencySensor(metricScope, name, "fetch", Sensor.RecordingLevel.DEBUG);
-        this.flushTime = this.metrics.addLatencySensor(metricScope, name, "flush", Sensor.RecordingLevel.DEBUG);
-        this.restoreTime = this.metrics.addLatencySensor(metricScope, name, "restore", Sensor.RecordingLevel.DEBUG);
-
-        // register and possibly restore the state from the logs
-        metrics.measureLatencyNs(time, initDelegate, this.restoreTime);
-    }
-
-    @Override
-    public boolean persistent() {
-        return inner.persistent();
-    }
-
-    @Override
-    public boolean isOpen() {
-        return inner.isOpen();
-    }
-
-    @Override
-    public WindowStoreIterator<V> fetch(K key, long timeFrom, long timeTo) {
-        return new MeteredWindowStoreIterator<>(this.inner.fetch(key, timeFrom, timeTo), this.fetchTime);
-    }
-
-    @Override
-    public void put(K key, V value) {
-        this.key = key;
-        this.value = value;
-        metrics.measureLatencyNs(time, putDelegate, this.putTime);
-    }
-
-    @Override
-    public void put(K key, V value, long timestamp) {
-        this.key = key;
-        this.value = value;
-        this.timestamp = timestamp;
-        metrics.measureLatencyNs(time, putTsDelegate, this.putTime);
-    }
-
-    @Override
-    public void close() {
-        inner.close();
-    }
-
-    @Override
-    public void flush() {
-        metrics.measureLatencyNs(time, flushDelegate, this.flushTime);
-    }
-
-    private class MeteredWindowStoreIterator<E> implements WindowStoreIterator<E> {
-
-        private final WindowStoreIterator<E> iter;
-        private final Sensor sensor;
-        private final long startNs;
-
-        public MeteredWindowStoreIterator(WindowStoreIterator<E> iter, Sensor sensor) {
-            this.iter = iter;
-            this.sensor = sensor;
-            this.startNs = time.nanoseconds();
-        }
-
-        @Override
-        public boolean hasNext() {
-            return iter.hasNext();
-        }
-
-        @Override
-        public KeyValue<Long, E> next() {
-            return iter.next();
-        }
-
-        @Override
-        public void remove() {
-            iter.remove();
-        }
-
-        @Override
-        public void close() {
-            try {
-                iter.close();
-            } finally {
-                metrics.recordLatency(this.sensor, this.startNs, time.nanoseconds());
-            }
-        }
-
-    }
-
-    WindowStore<K, V> inner() {
-        return inner;
-    }
-}
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplier.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplier.java
index 164b3525d3701..b72bbede4c52b 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplier.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplier.java
@@ -35,28 +35,54 @@
 
 public class RocksDBKeyValueStoreSupplier<K, V> extends AbstractStoreSupplier<K, V, KeyValueStore> {
 
-    private final boolean enableCaching;
+    private static final String METRICS_SCOPE = "rocksdb-state";
+    private final boolean cached;
 
-    public RocksDBKeyValueStoreSupplier(String name, Serde<K> keySerde, Serde<V> valueSerde, boolean logged, Map<String, String> logConfig, boolean enableCaching) {
-        this(name, keySerde, valueSerde, null, logged, logConfig, enableCaching);
+    public RocksDBKeyValueStoreSupplier(String name, Serde<K> keySerde, Serde<V> valueSerde, boolean logged, Map<String, String> logConfig, boolean cached) {
+        this(name, keySerde, valueSerde, null, logged, logConfig, cached);
     }
 
-    public RocksDBKeyValueStoreSupplier(String name, Serde<K> keySerde, Serde<V> valueSerde, Time time, boolean logged, Map<String, String> logConfig, boolean enableCaching) {
+    public RocksDBKeyValueStoreSupplier(String name, Serde<K> keySerde, Serde<V> valueSerde, Time time, boolean logged, Map<String, String> logConfig, boolean cached) {
         super(name, keySerde, valueSerde, time, logged, logConfig);
-        this.enableCaching = enableCaching;
+        this.cached = cached;
     }
 
     public KeyValueStore get() {
-        if (!enableCaching) {
-            RocksDBStore<K, V> store = new RocksDBStore<>(name, keySerde, valueSerde);
-            return new MeteredKeyValueStore<>(logged ? store.enableLogging() : store, "rocksdb-state", time);
+        if (!cached && !logged) {
+            return new MeteredKeyValueStore<>(
+                    new RocksDBStore<>(name, keySerde, valueSerde), METRICS_SCOPE, time);
+        }
+
+        // when cached, logged, or both we use a bytes store as the inner most store
+        final RocksDBStore<Bytes, byte[]> rocks = new RocksDBStore<>(name,
+                                                                     Serdes.Bytes(),
+                                                                     Serdes.ByteArray());
+
+        if (cached && logged) {
+            return new CachingKeyValueStore<>(
+                    new MeteredKeyValueStore<>(
+                            new ChangeLoggingKeyValueBytesStore(rocks),
+                            METRICS_SCOPE,
+                            time),
+                    keySerde,
+                    valueSerde);
+        }
+
+        if (cached) {
+            return new CachingKeyValueStore<>(
+                    new MeteredKeyValueStore<>(rocks, METRICS_SCOPE, time),
+                    keySerde,
+                    valueSerde);
+
+        } else {
+            // logged
+            return new MeteredKeyValueStore<>(
+                    new ChangeLoggingKeyValueStore<>(rocks, keySerde, valueSerde),
+                    METRICS_SCOPE,
+                    time);
         }
 
-        final RocksDBStore<Bytes, byte[]> store = new RocksDBStore<>(name, Serdes.Bytes(), Serdes.ByteArray());
-        return new CachingKeyValueStore<>(new MeteredKeyValueStore<>(logged ? store.enableLogging() : store,
-                "rocksdb-state",
-                time),
-                keySerde,
-                valueSerde);
     }
+
+
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplier.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplier.java
index 76454724ba7fd..10ebf65b217e8 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplier.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplier.java
@@ -5,9 +5,9 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -18,6 +18,8 @@
 package org.apache.kafka.streams.state.internals;
 
 import org.apache.kafka.common.serialization.Serde;
+import org.apache.kafka.common.serialization.Serdes;
+import org.apache.kafka.common.utils.Bytes;
 import org.apache.kafka.common.utils.Time;
 import org.apache.kafka.streams.state.SessionStore;
 
@@ -35,13 +37,14 @@
 public class RocksDBSessionStoreSupplier<K, V> extends AbstractStoreSupplier<K, V, SessionStore> implements WindowStoreSupplier<SessionStore> {
 
     private static final int NUM_SEGMENTS = 3;
+    public static final String METRIC_SCOPE = "rocksdb-session-store";
     private final long retentionPeriod;
-    private final boolean enableCaching;
+    private final boolean cached;
 
-    public RocksDBSessionStoreSupplier(String name, long retentionPeriod, Serde<K> keySerde, Serde<V> valueSerde, boolean logged, Map<String, String> logConfig, boolean enableCaching) {
+    public RocksDBSessionStoreSupplier(String name, long retentionPeriod, Serde<K> keySerde, Serde<V> valueSerde, boolean logged, Map<String, String> logConfig, boolean cached) {
         super(name, keySerde, valueSerde, Time.SYSTEM, logged, logConfig);
         this.retentionPeriod = retentionPeriod;
-        this.enableCaching = enableCaching;
+        this.cached = cached;
     }
 
     public String name() {
@@ -49,16 +52,41 @@ public String name() {
     }
 
     public SessionStore<K, V> get() {
-        final RocksDBSegmentedBytesStore bytesStore = new RocksDBSegmentedBytesStore(name,
+        final SessionKeySchema keySchema = new SessionKeySchema();
+        final RocksDBSegmentedBytesStore segmented = new RocksDBSegmentedBytesStore(name,
                                                                                      retentionPeriod,
                                                                                      NUM_SEGMENTS,
-                                                                                     new SessionKeySchema());
-        final MeteredSegmentedBytesStore metered = new MeteredSegmentedBytesStore(logged ? new ChangeLoggingSegmentedBytesStore(bytesStore)
-                                                                                          : bytesStore, "rocksdb-session-store", time);
-        if (enableCaching) {
-            return new CachingSessionStore<>(metered, keySerde, valueSerde);
+                                                                                     keySchema
+        );
+
+        if (cached && logged) {
+            final ChangeLoggingSegmentedBytesStore logged = new ChangeLoggingSegmentedBytesStore(segmented);
+            final MeteredSegmentedBytesStore metered = new MeteredSegmentedBytesStore(logged,
+                                                                                      METRIC_SCOPE, time);
+            final RocksDBSessionStore<Bytes, byte[]> sessionStore
+                    = new RocksDBSessionStore<>(metered, Serdes.Bytes(), Serdes.ByteArray());
+
+            return new CachingSessionStore<>(sessionStore, keySerde, valueSerde);
+        }
+
+        if (cached) {
+            final MeteredSegmentedBytesStore metered = new MeteredSegmentedBytesStore(segmented,
+                                                                                      METRIC_SCOPE, time);
+            final RocksDBSessionStore<Bytes, byte[]> sessionStore
+                    = new RocksDBSessionStore<>(metered, Serdes.Bytes(), Serdes.ByteArray());
+
+            return new CachingSessionStore<>(sessionStore, keySerde, valueSerde);
         }
-        return new RocksDBSessionStore<>(metered, keySerde, valueSerde);
+
+        if (logged) {
+            final ChangeLoggingSegmentedBytesStore logged = new ChangeLoggingSegmentedBytesStore(segmented);
+            final MeteredSegmentedBytesStore metered = new MeteredSegmentedBytesStore(logged,
+                                                                                      METRIC_SCOPE, time);
+            return new RocksDBSessionStore<>(metered, keySerde, valueSerde);
+        }
+
+        return new RocksDBSessionStore<>(
+                new MeteredSegmentedBytesStore(segmented, METRIC_SCOPE, time), keySerde, valueSerde);
 
     }
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
index 8b838d02dc2f2..3f8d509dda05a 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
@@ -92,24 +92,20 @@ public class RocksDBStore<K, V> implements KeyValueStore<K, V> {
     private WriteOptions wOptions;
     private FlushOptions fOptions;
 
-    private boolean loggingEnabled = false;
-
-    private StoreChangeLogger<Bytes, byte[]> changeLogger;
-
     protected volatile boolean open = false;
 
-    public KeyValueStore<K, V> enableLogging() {
-        loggingEnabled = true;
-
-        return this;
-    }
 
-    public RocksDBStore(String name, Serde<K> keySerde, Serde<V> valueSerde) {
+    public RocksDBStore(final String name,
+                        final Serde<K> keySerde,
+                        final Serde<V> valueSerde) {
         this(name, DB_FILE_DIR, keySerde, valueSerde);
     }
 
 
-    public RocksDBStore(String name, String parentDir, Serde<K> keySerde, Serde<V> valueSerde) {
+    public RocksDBStore(final String name,
+                        final String parentDir,
+                        final Serde<K> keySerde,
+                        final Serde<V> valueSerde) {
         this.name = name;
         this.parentDir = parentDir;
         this.keySerde = keySerde;
@@ -159,10 +155,9 @@ public void init(ProcessorContext context, StateStore root) {
         // open the DB dir
         openDB(context);
 
-        this.changeLogger = this.loggingEnabled ? new StoreChangeLogger<>(name, context, WindowStoreUtils.INNER_SERDES) : null;
         // value getter should always read directly from rocksDB
         // since it is only for values that are already flushed
-        context.register(root, loggingEnabled, new StateRestoreCallback() {
+        context.register(root, false, new StateRestoreCallback() {
 
             @Override
             public void restore(byte[] key, byte[] value) {
@@ -235,10 +230,6 @@ public synchronized void put(K key, V value) {
         byte[] rawKey = serdes.rawKey(key);
         byte[] rawValue = serdes.rawValue(value);
         putInternal(rawKey, rawValue);
-
-        if (loggingEnabled) {
-            changeLogger.logChange(Bytes.wrap(rawKey), rawValue);
-        }
     }
 
     @Override
@@ -278,9 +269,6 @@ public void putAll(List<KeyValue<K, V>> entries) {
                 } else {
                     final byte[] value = serdes.rawValue(entry.value);
                     batch.put(rawKey, value);
-                    if (loggingEnabled) {
-                        changeLogger.logChange(Bytes.wrap(rawKey), value);
-                    }
                 }
             }
             db.write(wOptions, batch);
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBWindowStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBWindowStore.java
index a2a420e1c3363..80c4796a6cafc 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBWindowStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBWindowStore.java
@@ -20,6 +20,7 @@
 package org.apache.kafka.streams.state.internals;
 
 import org.apache.kafka.common.serialization.Serde;
+import org.apache.kafka.common.serialization.Serdes;
 import org.apache.kafka.common.utils.Bytes;
 import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.processor.ProcessorContext;
@@ -33,7 +34,6 @@
 
 class RocksDBWindowStore<K, V> implements WindowStore<K, V> {
 
-    private final String name;
     private final SegmentedBytesStore bytesStore;
     private final boolean retainDuplicates;
     private final Serde<K> keySerde;
@@ -43,8 +43,15 @@ class RocksDBWindowStore<K, V> implements WindowStore<K, V> {
     private StateSerdes<K, V> serdes;
 
 
-    RocksDBWindowStore(String name, boolean retainDuplicates, Serde<K> keySerde, Serde<V> valueSerde, final SegmentedBytesStore bytesStore) {
-        this.name = name;
+    static RocksDBWindowStore<Bytes, byte[]> bytesStore(final SegmentedBytesStore inner, final boolean retainDuplicates) {
+        return new RocksDBWindowStore<>(inner, Serdes.Bytes(), Serdes.ByteArray(), retainDuplicates);
+    }
+
+
+    RocksDBWindowStore(final SegmentedBytesStore bytesStore,
+                       final Serde<K> keySerde,
+                       final Serde<V> valueSerde,
+                       final boolean retainDuplicates) {
         this.keySerde = keySerde;
         this.valueSerde = valueSerde;
         this.retainDuplicates = retainDuplicates;
@@ -54,7 +61,7 @@ class RocksDBWindowStore<K, V> implements WindowStore<K, V> {
 
     @Override
     public String name() {
-        return name;
+        return bytesStore.name();
     }
 
     @Override
@@ -62,7 +69,7 @@ public String name() {
     public void init(final ProcessorContext context, final StateStore root) {
         this.context = context;
         // construct the serde
-        this.serdes = new StateSerdes<>(name,
+        this.serdes = new StateSerdes<>(bytesStore.name(),
                                         keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
                                         valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
 
@@ -147,6 +154,14 @@ public void remove() {
         public void close() {
             actual.close();
         }
+
+        @Override
+        public Long peekNextKey() {
+            if (!actual.hasNext()) {
+                throw new NoSuchElementException();
+            }
+            return WindowStoreUtils.timestampFromBinaryKey(actual.peekNextKey().get());
+        }
     }
 
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplier.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplier.java
index 84f1734fb7c8e..abaaffd2bff84 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplier.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplier.java
@@ -18,6 +18,7 @@
 package org.apache.kafka.streams.state.internals;
 
 import org.apache.kafka.common.serialization.Serde;
+import org.apache.kafka.common.utils.Bytes;
 import org.apache.kafka.common.utils.Time;
 import org.apache.kafka.streams.state.WindowStore;
 
@@ -58,23 +59,35 @@ public String name() {
     }
 
     public WindowStore get() {
-        final RocksDBSegmentedBytesStore bytesStore = new RocksDBSegmentedBytesStore(name, retentionPeriod, numSegments, new WindowStoreKeySchema());
-        if (!enableCaching) {
-            final RocksDBWindowStore<K, V> segmentedStore = new RocksDBWindowStore<>(name, retainDuplicates, keySerde, valueSerde,
-                                                                                     logged ? new ChangeLoggingSegmentedBytesStore(bytesStore)
-                                                                                                   : bytesStore);
-            return new MeteredWindowStore<>(segmentedStore, "rocksdb-window", time);
-        }
+        return maybeWrapCaching(
+                maybeWrapLogged(
+                        new RocksDBSegmentedBytesStore(
+                                name,
+                                retentionPeriod,
+                                numSegments,
+                                new WindowStoreKeySchema()
+                        )));
 
-        return new CachingWindowStore<>(new MeteredSegmentedBytesStore(logged ? new ChangeLoggingSegmentedBytesStore(bytesStore)
-                                                                               : bytesStore,
-                                                                       "rocksdb-window",
-                                                                       time),
-                                        keySerde, valueSerde, windowSize);
     }
 
     @Override
     public long retentionPeriod() {
         return retentionPeriod;
     }
+
+    private SegmentedBytesStore maybeWrapLogged(final SegmentedBytesStore inner) {
+        if (!logged) {
+            return inner;
+        }
+        return new ChangeLoggingSegmentedBytesStore(inner);
+    }
+
+    private WindowStore<K, V> maybeWrapCaching(final SegmentedBytesStore inner) {
+        final MeteredSegmentedBytesStore metered = new MeteredSegmentedBytesStore(inner, "rocksdb-window", time);
+        if (!enableCaching) {
+            return new RocksDBWindowStore<>(metered, keySerde, valueSerde, retainDuplicates);
+        }
+        final RocksDBWindowStore<Bytes, byte[]> windowed = RocksDBWindowStore.bytesStore(metered, retainDuplicates);
+        return new CachingWindowStore<>(windowed, keySerde, valueSerde, windowSize);
+    }
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/SerializedKeyValueIterator.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/SerializedKeyValueIterator.java
new file mode 100644
index 0000000000000..d76e8a4568e7b
--- /dev/null
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/SerializedKeyValueIterator.java
@@ -0,0 +1,70 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.common.utils.Bytes;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.state.KeyValueIterator;
+import org.apache.kafka.streams.state.StateSerdes;
+
+import java.util.NoSuchElementException;
+
+class SerializedKeyValueIterator<K, V> implements KeyValueIterator<K, V> {
+
+    private final KeyValueIterator<Bytes, byte[]> bytesIterator;
+    private final StateSerdes<K, V> serdes;
+
+    SerializedKeyValueIterator(final KeyValueIterator<Bytes, byte[]> bytesIterator,
+                               final StateSerdes<K, V> serdes) {
+
+        this.bytesIterator = bytesIterator;
+        this.serdes = serdes;
+    }
+
+    @Override
+    public void close() {
+        bytesIterator.close();
+    }
+
+    @Override
+    public K peekNextKey() {
+        if (!hasNext()) {
+            throw new NoSuchElementException();
+        }
+        final Bytes bytes = bytesIterator.peekNextKey();
+        return serdes.keyFrom(bytes.get());
+    }
+
+    @Override
+    public boolean hasNext() {
+        return bytesIterator.hasNext();
+    }
+
+    @Override
+    public KeyValue<K, V> next() {
+        if (!hasNext()) {
+            throw new NoSuchElementException();
+        }
+        final KeyValue<Bytes, byte[]> next = bytesIterator.next();
+        return KeyValue.pair(serdes.keyFrom(next.key.get()), serdes.valueFrom(next.value));
+    }
+
+    @Override
+    public void remove() {
+        throw new UnsupportedOperationException("remove not supported by SerializedKeyValueIterator");
+    }
+}
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreUtils.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreUtils.java
index 1ea6bef7df4aa..074cf8aef5443 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreUtils.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreUtils.java
@@ -39,7 +39,10 @@ public class WindowStoreUtils {
 
     public static <K> byte[] toBinaryKey(K key, final long timestamp, final int seqnum, StateSerdes<K, ?> serdes) {
         byte[] serializedKey = serdes.rawKey(key);
+        return toBinaryKey(serializedKey, timestamp, seqnum);
+    }
 
+    static byte[] toBinaryKey(byte[] serializedKey, final long timestamp, final int seqnum) {
         ByteBuffer buf = ByteBuffer.allocate(serializedKey.length + TIMESTAMP_SIZE + SEQNUM_SIZE);
         buf.put(serializedKey);
         buf.putLong(timestamp);
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/WrappedStateStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/WrappedStateStore.java
new file mode 100644
index 0000000000000..3d80b98d69744
--- /dev/null
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/WrappedStateStore.java
@@ -0,0 +1,90 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.streams.errors.InvalidStateStoreException;
+import org.apache.kafka.streams.processor.ProcessorContext;
+import org.apache.kafka.streams.processor.StateStore;
+
+/**
+ * A storage engine wrapper for utilities like logging, caching, and metering.
+ */
+interface WrappedStateStore extends StateStore {
+
+    /**
+     * Return the inner storage engine
+     *
+     * @return wrapped inner storage engine
+     */
+    StateStore inner();
+
+    abstract class AbstractWrappedStateStore implements WrappedStateStore {
+        final StateStore innerState;
+
+        AbstractWrappedStateStore(StateStore inner) {
+            this.innerState = inner;
+        }
+
+        @Override
+        public void init(ProcessorContext context, StateStore root) {
+            innerState.init(context, root);
+        }
+
+        @Override
+        public String name() {
+            return innerState.name();
+        }
+
+        @Override
+        public boolean persistent() {
+            return innerState.persistent();
+        }
+
+        @Override
+        public boolean isOpen() {
+            return innerState.isOpen();
+        }
+
+        void validateStoreOpen() {
+            if (!innerState.isOpen()) {
+                throw new InvalidStateStoreException("Store " + innerState.name() + " is currently closed.");
+            }
+        }
+
+        @Override
+        public StateStore inner() {
+            if (innerState instanceof WrappedStateStore) {
+                return ((WrappedStateStore) innerState).inner();
+            }
+            return innerState;
+        }
+
+        @Override
+        public void flush() {
+            innerState.flush();
+        }
+
+        @Override
+        public void close() {
+            innerState.close();
+        }
+    }
+
+
+}
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KGroupedStreamImplTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KGroupedStreamImplTest.java
index 729e1905b43d3..b6d8a974200f3 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KGroupedStreamImplTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KGroupedStreamImplTest.java
@@ -18,6 +18,7 @@
 package org.apache.kafka.streams.kstream.internals;
 
 import org.apache.kafka.common.serialization.Serdes;
+import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.kstream.Aggregator;
 import org.apache.kafka.streams.kstream.ForeachAction;
 import org.apache.kafka.streams.kstream.Initializer;
@@ -40,9 +41,14 @@
 import org.junit.Before;
 import org.junit.Test;
 
+import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
 
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.MatcherAssert.assertThat;
 import static org.junit.Assert.assertEquals;
 
 public class KGroupedStreamImplTest {
@@ -337,4 +343,38 @@ public void shouldNotAcceptNullStoreNameWhenCountingSessionWindows() throws Exce
     public void shouldNotAcceptNullStoreStoreSupplierNameWhenCountingSessionWindows() throws Exception {
         groupedStream.count(SessionWindows.with(90), (StateStoreSupplier<SessionStore>) null);
     }
-}
+
+    @Test
+    public void shouldCountWindowed() throws Exception {
+        final List<KeyValue<Windowed<String>, Long>> results = new ArrayList<>();
+        groupedStream.count(
+                TimeWindows.of(500L),
+                "aggregate-by-key-windowed")
+                .foreach(new ForeachAction<Windowed<String>, Long>() {
+                    @Override
+                    public void apply(final Windowed<String> key, final Long value) {
+                        results.add(KeyValue.pair(key, value));
+                    }
+                });
+
+        final KStreamTestDriver driver = new KStreamTestDriver(builder, TestUtils.tempDirectory(), 0);
+        driver.setTime(0);
+        driver.process(TOPIC, "1", "A");
+        driver.process(TOPIC, "2", "B");
+        driver.process(TOPIC, "3", "C");
+        driver.setTime(500);
+        driver.process(TOPIC, "1", "A");
+        driver.process(TOPIC, "1", "A");
+        driver.process(TOPIC, "2", "B");
+        driver.process(TOPIC, "2", "B");
+        assertThat(results, equalTo(Arrays.asList(
+                KeyValue.pair(new Windowed<>("1", new TimeWindow(0, 500)), 1L),
+                KeyValue.pair(new Windowed<>("2", new TimeWindow(0, 500)), 1L),
+                KeyValue.pair(new Windowed<>("3", new TimeWindow(0, 500)), 1L),
+                KeyValue.pair(new Windowed<>("1", new TimeWindow(500, 1000)), 1L),
+                KeyValue.pair(new Windowed<>("1", new TimeWindow(500, 1000)), 2L),
+                KeyValue.pair(new Windowed<>("2", new TimeWindow(500, 1000)), 1L),
+                KeyValue.pair(new Windowed<>("2", new TimeWindow(500, 1000)), 2L)
+        )));
+    }
+}
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java
index c603aa0b93fcf..5035f70887e8d 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java
@@ -59,7 +59,8 @@ public class CachingSessionStoreTest {
     @Before
     public void setUp() throws Exception {
         underlying = new RocksDBSegmentedBytesStore("test", 60000, 3, new SessionKeySchema());
-        cachingStore = new CachingSessionStore<>(underlying,
+        final RocksDBSessionStore<Bytes, byte[]> sessionStore = new RocksDBSessionStore<>(underlying, Serdes.Bytes(), Serdes.ByteArray());
+        cachingStore = new CachingSessionStore<>(sessionStore,
                                                  Serdes.String(),
                                                  Serdes.Long());
         cache = new ThreadCache("testCache", MAX_CACHE_SIZE_BYTES, new MockStreamsMetrics(new Metrics()));
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java
index 37fc9a0f6a69e..1de1002d74c51 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java
@@ -54,13 +54,15 @@ public class CachingWindowStoreTest {
     private String topic;
     private static final long DEFAULT_TIMESTAMP = 10L;
     private WindowStoreKeySchema keySchema;
+    private RocksDBWindowStore<Bytes, byte[]> windowStore;
 
     @Before
     public void setUp() throws Exception {
         keySchema = new WindowStoreKeySchema();
         underlying = new RocksDBSegmentedBytesStore("test", 30000, 3, keySchema);
+        windowStore = new RocksDBWindowStore<>(underlying, Serdes.Bytes(), Serdes.ByteArray(), false);
         cacheListener = new CachingKeyValueStoreTest.CacheFlushListenerStub<>();
-        cachingStore = new CachingWindowStore<>(underlying,
+        cachingStore = new CachingWindowStore<>(windowStore,
                                                 Serdes.String(),
                                                 Serdes.String(),
                                                 WINDOW_SIZE);
@@ -72,6 +74,7 @@ public void setUp() throws Exception {
         cachingStore.init(context, cachingStore);
     }
 
+
     @Test
     public void shouldPutFetchFromCache() throws Exception {
         cachingStore.put("a", "a");
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStoreTest.java
new file mode 100644
index 0000000000000..82fb83123a095
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStoreTest.java
@@ -0,0 +1,165 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.clients.producer.ProducerRecord;
+import org.apache.kafka.common.metrics.Metrics;
+import org.apache.kafka.common.serialization.Serdes;
+import org.apache.kafka.common.serialization.Serializer;
+import org.apache.kafka.common.utils.Bytes;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.processor.internals.MockStreamsMetrics;
+import org.apache.kafka.test.InMemoryKeyValueStore;
+import org.apache.kafka.test.MockProcessorContext;
+import org.apache.kafka.test.NoOpRecordCollector;
+import org.apache.kafka.test.TestUtils;
+import org.junit.Before;
+import org.junit.Test;
+
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.Map;
+
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.CoreMatchers.is;
+import static org.hamcrest.CoreMatchers.nullValue;
+import static org.hamcrest.MatcherAssert.assertThat;
+
+public class ChangeLoggingKeyValueBytesStoreTest {
+
+    private final InMemoryKeyValueStore<Bytes, byte[]> inner = new InMemoryKeyValueStore<>("kv");
+    private final ChangeLoggingKeyValueBytesStore store = new ChangeLoggingKeyValueBytesStore(inner);
+    private final Map sent = new HashMap<>();
+    private final Bytes hi = Bytes.wrap("hi".getBytes());
+    private final Bytes hello = Bytes.wrap("hello".getBytes());
+    private final byte[] there = "there".getBytes();
+    private final byte[] world = "world".getBytes();
+
+    @Before
+    public void before() {
+        final NoOpRecordCollector collector = new NoOpRecordCollector() {
+            @Override
+            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
+                sent.put(record.key(), record.value());
+            }
+        };
+        final MockProcessorContext context = new MockProcessorContext(null,
+                                                                      TestUtils.tempDirectory(),
+                                                                      Serdes.String(),
+                                                                      Serdes.Long(),
+                                                                      collector,
+                                                                      new ThreadCache("testCache", 0, new MockStreamsMetrics(new Metrics())));
+        context.setTime(0);
+        store.init(context, store);
+    }
+
+    @Test
+    public void shouldWriteKeyValueBytesToInnerStoreOnPut() throws Exception {
+        store.put(hi, there);
+        assertThat(inner.get(hi), equalTo(there));
+    }
+
+    @Test
+    public void shouldLogChangeOnPut() throws Exception {
+        store.put(hi, there);
+        assertThat((byte[]) sent.get(hi), equalTo(there));
+    }
+
+    @Test
+    public void shouldWriteAllKeyValueToInnerStoreOnPutAll() throws Exception {
+        store.putAll(Arrays.asList(KeyValue.pair(hi, there),
+                                   KeyValue.pair(hello, world)));
+        assertThat(inner.get(hi), equalTo(there));
+        assertThat(inner.get(hello), equalTo(world));
+    }
+
+    @Test
+    public void shouldLogChangesOnPutAll() throws Exception {
+        store.putAll(Arrays.asList(KeyValue.pair(hi, there),
+                                   KeyValue.pair(hello, world)));
+        assertThat((byte[]) sent.get(hi), equalTo(there));
+        assertThat((byte[]) sent.get(hello), equalTo(world));
+    }
+
+    @Test
+    public void shouldPutNullOnDelete() throws Exception {
+        store.put(hi, there);
+        store.delete(hi);
+        assertThat(inner.get(hi), nullValue());
+    }
+
+    @Test
+    public void shouldReturnOldValueOnDelete() throws Exception {
+        store.put(hi, there);
+        assertThat(store.delete(hi), equalTo(there));
+    }
+
+    @Test
+    public void shouldLogKeyNullOnDelete() throws Exception {
+        store.put(hi, there);
+        store.delete(hi);
+        assertThat(sent.get(hi), nullValue());
+    }
+
+    @Test
+    public void shouldWriteToInnerOnPutIfAbsentNoPreviousValue() throws Exception {
+        store.putIfAbsent(hi, there);
+        assertThat(inner.get(hi), equalTo(there));
+    }
+
+    @Test
+    public void shouldNotWriteToInnerOnPutIfAbsentWhenValueForKeyExists() throws Exception {
+        store.put(hi, there);
+        store.putIfAbsent(hi, world);
+        assertThat(inner.get(hi), equalTo(there));
+    }
+
+    @Test
+    public void shouldWriteToChangelogOnPutIfAbsentWhenNoPreviousValue() throws Exception {
+        store.putIfAbsent(hi, there);
+        assertThat((byte[]) sent.get(hi), equalTo(there));
+    }
+
+    @Test
+    public void shouldNotWriteToChangeLogOnPutIfAbsentWhenValueForKeyExists() throws Exception {
+        store.put(hi, there);
+        store.putIfAbsent(hi, world);
+        assertThat((byte[]) sent.get(hi), equalTo(there));
+    }
+
+    @Test
+    public void shouldReturnCurrentValueOnPutIfAbsent() throws Exception {
+        store.put(hi, there);
+        assertThat(store.putIfAbsent(hi, world), equalTo(there));
+    }
+
+    @Test
+    public void shouldReturnNullOnPutIfAbsentWhenNoPreviousValue() throws Exception {
+        assertThat(store.putIfAbsent(hi, there), is(nullValue()));
+    }
+
+    @Test
+    public void shouldReturnValueOnGetWhenExists() throws Exception {
+        store.put(hello, world);
+        assertThat(store.get(hello), equalTo(world));
+    }
+
+    @Test
+    public void shouldReturnNullOnGetWhenDoesntExist() throws Exception {
+        assertThat(store.get(hello), is(nullValue()));
+    }
+}
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java
new file mode 100644
index 0000000000000..8815c5a510e5f
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java
@@ -0,0 +1,207 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.clients.producer.ProducerRecord;
+import org.apache.kafka.common.metrics.Metrics;
+import org.apache.kafka.common.serialization.Serde;
+import org.apache.kafka.common.serialization.Serdes;
+import org.apache.kafka.common.serialization.Serializer;
+import org.apache.kafka.common.utils.Bytes;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.processor.internals.MockStreamsMetrics;
+import org.apache.kafka.streams.state.KeyValueIterator;
+import org.apache.kafka.test.InMemoryKeyValueStore;
+import org.apache.kafka.test.MockProcessorContext;
+import org.apache.kafka.test.NoOpRecordCollector;
+import org.apache.kafka.test.TestUtils;
+import org.junit.Before;
+import org.junit.Test;
+
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.Map;
+
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.CoreMatchers.is;
+import static org.hamcrest.CoreMatchers.nullValue;
+import static org.hamcrest.MatcherAssert.assertThat;
+import static org.junit.Assert.assertFalse;
+
+public class ChangeLoggingKeyValueStoreTest {
+
+    private final InMemoryKeyValueStore<Bytes, byte[]> inner = new InMemoryKeyValueStore<>("kv");
+    private final Serde<String> keySerde = Serdes.String();
+    private final Serde<String> valueSerde = Serdes.String();
+    private final ChangeLoggingKeyValueStore<String, String> store
+            = new ChangeLoggingKeyValueStore<>(inner, keySerde, valueSerde);
+    private final Map sent = new HashMap<>();
+    private final String hi = "hi";
+    private final Bytes hiBytes = Bytes.wrap(hi.getBytes());
+    private final String there = "there";
+    private final byte[] thereBytes = "there".getBytes();
+    private final String hello = "hello";
+    private final String world = "world";
+
+    @Before
+    public void before() {
+        final NoOpRecordCollector collector = new NoOpRecordCollector() {
+            @Override
+            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
+                sent.put(record.key(), record.value());
+            }
+        };
+        final MockProcessorContext context = new MockProcessorContext(null,
+                                                                      TestUtils.tempDirectory(),
+                                                                      Serdes.String(),
+                                                                      Serdes.Long(),
+                                                                      collector,
+                                                                      new ThreadCache("testCache", 0, new MockStreamsMetrics(new Metrics())));
+        context.setTime(0);
+        store.init(context, store);
+    }
+
+    @Test
+    public void shouldWriteKeyValueBytesToInnerStoreOnPut() throws Exception {
+        store.put(hi, there);
+        assertThat(deserializedValueFromInner(hi), equalTo(there));
+    }
+
+    @Test
+    public void shouldLogChangeOnPut() throws Exception {
+        store.put(hi, there);
+        assertThat((byte[]) sent.get(hiBytes), equalTo(thereBytes));
+    }
+
+    @Test
+    public void shouldWriteAllKeyValueToInnerStoreOnPutAll() throws Exception {
+        store.putAll(Arrays.asList(KeyValue.pair(hello, world),
+                                   KeyValue.pair(hi, there)));
+        assertThat(deserializedValueFromInner(hello), equalTo(world));
+        assertThat(deserializedValueFromInner(hi), equalTo(there));
+    }
+
+    @Test
+    public void shouldLogChangesOnPutAll() throws Exception {
+        store.putAll(Arrays.asList(KeyValue.pair(hi, there),
+                                   KeyValue.pair(hello, world)));
+        assertThat((byte[]) sent.get(hiBytes), equalTo(thereBytes));
+        assertThat((byte[]) sent.get(Bytes.wrap(hello.getBytes())), equalTo(world.getBytes()));
+    }
+
+    @Test
+    public void shouldPutNullOnDelete() throws Exception {
+        store.put(hi, there);
+        store.delete(hi);
+        assertThat(inner.get(hiBytes), nullValue());
+    }
+
+    @Test
+    public void shouldReturnOldValueOnDelete() throws Exception {
+        store.put(hi, there);
+        assertThat(store.delete(hi), equalTo(there));
+    }
+
+    @Test
+    public void shouldReturnNullOnDeleteIfNoOldValue() throws Exception {
+        assertThat(store.delete(hi), is(nullValue()));
+    }
+
+    @Test
+    public void shouldLogKeyNullOnDelete() throws Exception {
+        store.put(hi, there);
+        store.delete(hi);
+        assertThat(sent.get(hi), nullValue());
+    }
+
+    @Test
+    public void shouldWriteToInnerOnPutIfAbsentNoPreviousValue() throws Exception {
+        store.putIfAbsent(hi, there);
+        assertThat(inner.get(hiBytes), equalTo(thereBytes));
+    }
+
+    @Test
+    public void shouldNotWriteToInnerOnPutIfAbsentWhenValueForKeyExists() throws Exception {
+        store.put(hi, there);
+        store.putIfAbsent(hi, world);
+        assertThat(inner.get(hiBytes), equalTo(thereBytes));
+    }
+
+    @Test
+    public void shouldWriteToChangelogOnPutIfAbsentWhenNoPreviousValue() throws Exception {
+        store.putIfAbsent(hi, there);
+        assertThat((byte[]) sent.get(hiBytes), equalTo(thereBytes));
+    }
+
+    @Test
+    public void shouldNotWriteToChangeLogOnPutIfAbsentWhenValueForKeyExists() throws Exception {
+        store.put(hi, there);
+        store.putIfAbsent(hi, world);
+        assertThat((byte[]) sent.get(hiBytes), equalTo(thereBytes));
+    }
+
+    @Test
+    public void shouldReturnCurrentValueOnPutIfAbsent() throws Exception {
+        store.put(hi, there);
+        assertThat(store.putIfAbsent(hi, world), equalTo(there));
+    }
+
+    @Test
+    public void shouldReturnNullOnPutIfAbsentWhenNoPreviousValue() throws Exception {
+        assertThat(store.putIfAbsent(hi, there), is(nullValue()));
+    }
+
+    @Test
+    public void shouldQueryRange() throws Exception {
+        store.put(hello, world);
+        store.put(hi, there);
+        store.put("zooom", "home");
+        final KeyValueIterator<String, String> range = store.range(hello, hi);
+        assertThat(range.next(), equalTo(KeyValue.pair(hello, world)));
+        assertThat(range.next(), equalTo(KeyValue.pair(hi, there)));
+        assertFalse(range.hasNext());
+    }
+
+    @Test
+    public void shouldReturnAllKeyValues() throws Exception {
+        store.put(hello, world);
+        store.put(hi, there);
+        final String zooom = "zooom";
+        final String home = "home";
+        store.put(zooom, home);
+        final KeyValueIterator<String, String> all = store.all();
+        assertThat(all.next(), equalTo(KeyValue.pair(hello, world)));
+        assertThat(all.next(), equalTo(KeyValue.pair(hi, there)));
+        assertThat(all.next(), equalTo(KeyValue.pair(zooom, home)));
+        assertFalse(all.hasNext());
+    }
+
+    @Test
+    public void shouldReturnValueOnGetWhenExists() throws Exception {
+        store.put(hello, world);
+        assertThat(store.get(hello), equalTo(world));
+    }
+
+    @Test
+    public void shouldReturnNullOnGetWhenDoesntExist() throws Exception {
+        assertThat(store.get(hello), is(nullValue()));
+    }
+
+    private String deserializedValueFromInner(final String key) {
+        return valueSerde.deserializer().deserialize("blah", inner.get(Bytes.wrap(key.getBytes())));
+    }
+}
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/DelegatingPeekingKeyValueIteratorTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/DelegatingPeekingKeyValueIteratorTest.java
index 50845e8bc1875..0ebdd5cac3c35 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/DelegatingPeekingKeyValueIteratorTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/DelegatingPeekingKeyValueIteratorTest.java
@@ -17,6 +17,7 @@
 
 package org.apache.kafka.streams.state.internals;
 
+import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.test.InMemoryKeyValueStore;
 import org.junit.Before;
 import org.junit.Test;
@@ -37,7 +38,7 @@ public void setUp() throws Exception {
     }
 
     @Test
-    public void shouldPeekNext() throws Exception {
+    public void shouldPeekNextKey() throws Exception {
         store.put("A", "A");
         final DelegatingPeekingKeyValueIterator<String, String> peekingIterator = new DelegatingPeekingKeyValueIterator<>(name, store.all());
         assertEquals("A", peekingIterator.peekNextKey());
@@ -45,6 +46,15 @@ public void shouldPeekNext() throws Exception {
         assertTrue(peekingIterator.hasNext());
     }
 
+    @Test
+    public void shouldPeekNext() throws Exception {
+        store.put("A", "A");
+        final DelegatingPeekingKeyValueIterator<String, String> peekingIterator = new DelegatingPeekingKeyValueIterator<>(name, store.all());
+        assertEquals(KeyValue.pair("A", "A"), peekingIterator.peekNext());
+        assertEquals(KeyValue.pair("A", "A"), peekingIterator.peekNext());
+        assertTrue(peekingIterator.hasNext());
+    }
+
     @Test
     public void shouldPeekAndIterate() throws Exception {
         final String[] kvs = {"a", "b", "c", "d", "e", "f"};
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIteratorTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIteratorTest.java
new file mode 100644
index 0000000000000..e7c2eb31edff4
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIteratorTest.java
@@ -0,0 +1,113 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.common.serialization.Serdes;
+import org.apache.kafka.common.utils.Bytes;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.kstream.Windowed;
+import org.apache.kafka.streams.kstream.internals.SessionKeySerde;
+import org.apache.kafka.streams.kstream.internals.SessionWindow;
+import org.apache.kafka.streams.state.StateSerdes;
+import org.apache.kafka.test.KeyValueIteratorStub;
+import org.junit.Test;
+
+import java.util.Collections;
+import java.util.Iterator;
+
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.MatcherAssert.assertThat;
+import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertTrue;
+
+public class MergedSortedCacheSessionStoreIteratorTest {
+
+    private final String storeKey = "a";
+    private final String cacheKey = "b";
+
+    private final SessionWindow storeWindow = new SessionWindow(0, 1);
+    private final Iterator<KeyValue<Windowed<Bytes>, byte[]>> storeKvs = Collections.singleton(
+            KeyValue.pair(new Windowed<>(Bytes.wrap(storeKey.getBytes()), storeWindow), storeKey.getBytes())).iterator();
+    private final SessionWindow cacheWindow = new SessionWindow(10, 20);
+    private final Iterator<KeyValue<Bytes, LRUCacheEntry>> cacheKvs = Collections.singleton(KeyValue.pair(
+            SessionKeySerde.toBinary(
+                    new Windowed<>(cacheKey, cacheWindow), Serdes.String().serializer()), new LRUCacheEntry(cacheKey.getBytes())))
+            .iterator();
+
+    @Test
+    public void shouldHaveNextFromStore() throws Exception {
+        final MergedSortedCacheSessionStoreIterator<String, String> mergeIterator
+                = createIterator(storeKvs, Collections.<KeyValue<Bytes, LRUCacheEntry>>emptyIterator());
+        assertTrue(mergeIterator.hasNext());
+    }
+
+    @Test
+    public void shouldGetNextFromStore() throws Exception {
+        final MergedSortedCacheSessionStoreIterator<String, String> mergeIterator
+                = createIterator(storeKvs, Collections.<KeyValue<Bytes, LRUCacheEntry>>emptyIterator());
+        assertThat(mergeIterator.next(), equalTo(KeyValue.pair(new Windowed<>(storeKey, storeWindow), storeKey)));
+    }
+
+    @Test
+    public void shouldPeekNextKeyFromStore() throws Exception {
+        final MergedSortedCacheSessionStoreIterator<String, String> mergeIterator
+                = createIterator(storeKvs, Collections.<KeyValue<Bytes, LRUCacheEntry>>emptyIterator());
+        assertThat(mergeIterator.peekNextKey(), equalTo(new Windowed<>(storeKey, storeWindow)));
+    }
+
+    @Test
+    public void shouldHaveNextFromCache() throws Exception {
+        final MergedSortedCacheSessionStoreIterator<String, String> mergeIterator
+                = createIterator(Collections.<KeyValue<Windowed<Bytes>, byte[]>>emptyIterator(),
+                                 cacheKvs);
+        assertTrue(mergeIterator.hasNext());
+    }
+
+    @Test
+    public void shouldGetNextFromCache() throws Exception {
+        final MergedSortedCacheSessionStoreIterator<String, String> mergeIterator
+                = createIterator(Collections.<KeyValue<Windowed<Bytes>, byte[]>>emptyIterator(), cacheKvs);
+        assertThat(mergeIterator.next(), equalTo(KeyValue.pair(new Windowed<>(cacheKey, cacheWindow), cacheKey)));
+    }
+
+    @Test
+    public void shouldPeekNextKeyFromCache() throws Exception {
+        final MergedSortedCacheSessionStoreIterator<String, String> mergeIterator
+                = createIterator(Collections.<KeyValue<Windowed<Bytes>, byte[]>>emptyIterator(), cacheKvs);
+        assertThat(mergeIterator.peekNextKey(), equalTo(new Windowed<>(cacheKey, cacheWindow)));
+    }
+
+    @Test
+    public void shouldIterateBothStoreAndCache() throws Exception {
+        final MergedSortedCacheSessionStoreIterator<String, String> iterator = createIterator(storeKvs, cacheKvs);
+        assertThat(iterator.next(), equalTo(KeyValue.pair(new Windowed<>(storeKey, storeWindow), storeKey)));
+        assertThat(iterator.next(), equalTo(KeyValue.pair(new Windowed<>(cacheKey, cacheWindow), cacheKey)));
+        assertFalse(iterator.hasNext());
+    }
+
+    private MergedSortedCacheSessionStoreIterator<String, String> createIterator(final Iterator<KeyValue<Windowed<Bytes>, byte[]>> storeKvs,
+                                                                                 final Iterator<KeyValue<Bytes, LRUCacheEntry>> cacheKvs) {
+        final DelegatingPeekingKeyValueIterator<Windowed<Bytes>, byte[]> storeIterator
+                = new DelegatingPeekingKeyValueIterator<>("store", new KeyValueIteratorStub<>(storeKvs));
+
+        final PeekingKeyValueIterator<Bytes, LRUCacheEntry> cacheIterator
+                = new DelegatingPeekingKeyValueIterator<>("cache", new KeyValueIteratorStub<>(cacheKvs));
+        return new MergedSortedCacheSessionStoreIterator<>(cacheIterator, storeIterator, new StateSerdes<>("name", Serdes.String(), Serdes.String()));
+    }
+
+}
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/MergedSortedCacheWindowStoreIteratorTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/MergedSortedCacheWindowStoreIteratorTest.java
index b04f248e9ba89..376fca899342f 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/MergedSortedCacheWindowStoreIteratorTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/MergedSortedCacheWindowStoreIteratorTest.java
@@ -19,7 +19,6 @@
 
 import org.apache.kafka.common.metrics.Metrics;
 import org.apache.kafka.common.serialization.Serdes;
-import org.apache.kafka.common.utils.Bytes;
 import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.processor.internals.MockStreamsMetrics;
 import org.apache.kafka.streams.state.KeyValueIterator;
@@ -30,23 +29,25 @@
 import java.util.ArrayList;
 import java.util.List;
 
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.MatcherAssert.assertThat;
 import static org.junit.Assert.assertArrayEquals;
 import static org.junit.Assert.assertEquals;
 
 public class MergedSortedCacheWindowStoreIteratorTest {
 
+    private final List<KeyValue<Long, byte[]>> windowStoreKvPairs = new ArrayList<>();
+    private final ThreadCache cache = new ThreadCache("testCache", 1000000L,  new MockStreamsMetrics(new Metrics()));
+    private final String namespace = "one";
+    private final StateSerdes<String, String> stateSerdes = new StateSerdes<>("foo", Serdes.String(), Serdes.String());
+
     @Test
     public void shouldIterateOverValueFromBothIterators() throws Exception {
-        final List<KeyValue<Bytes, byte[]>> storeValues = new ArrayList<>();
-        final ThreadCache cache = new ThreadCache("testCache", 1000000L, new MockStreamsMetrics(new Metrics()));
-        final String namespace = "one";
-        final StateSerdes<String, String> stateSerdes = new StateSerdes<>("foo", Serdes.String(), Serdes.String());
         final List<KeyValue<Long, byte[]>> expectedKvPairs = new ArrayList<>();
-
         for (long t = 0; t < 100; t += 20) {
             final byte[] v1Bytes = String.valueOf(t).getBytes();
-            final KeyValue<Bytes, byte[]> v1 = KeyValue.pair(Bytes.wrap(WindowStoreUtils.toBinaryKey("a", t, 0, stateSerdes)), v1Bytes);
-            storeValues.add(v1);
+            final KeyValue<Long, byte[]> v1 = KeyValue.pair(t, v1Bytes);
+            windowStoreKvPairs.add(v1);
             expectedKvPairs.add(KeyValue.pair(t, v1Bytes));
             final byte[] keyBytes = WindowStoreUtils.toBinaryKey("a", t + 10, 0, stateSerdes);
             final byte[] valBytes = String.valueOf(t + 10).getBytes();
@@ -56,11 +57,11 @@ public void shouldIterateOverValueFromBothIterators() throws Exception {
 
         byte[] binaryFrom = WindowStoreUtils.toBinaryKey("a", 0, 0, stateSerdes);
         byte[] binaryTo = WindowStoreUtils.toBinaryKey("a", 100, 0, stateSerdes);
-        final KeyValueIterator<Bytes, byte[]> storeIterator = new DelegatingPeekingKeyValueIterator<>("name", new KeyValueIteratorStub<>(storeValues.iterator()));
+        final KeyValueIterator<Long, byte[]> storeIterator = new DelegatingPeekingKeyValueIterator<>("name", new KeyValueIteratorStub<>(windowStoreKvPairs.iterator()));
 
         final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator = cache.range(namespace, binaryFrom, binaryTo);
 
-        final MergedSortedCachedWindowStoreIterator<Bytes, byte[]> iterator = new MergedSortedCachedWindowStoreIterator<>(cacheIterator, storeIterator, new StateSerdes<>("name", Serdes.Bytes(), Serdes.ByteArray()));
+        final MergedSortedCacheWindowStoreIterator<byte[]> iterator = new MergedSortedCacheWindowStoreIterator<>(cacheIterator, storeIterator, new StateSerdes<>("name", Serdes.Long(), Serdes.ByteArray()));
         int index = 0;
         while (iterator.hasNext()) {
             final KeyValue<Long, byte[]> next = iterator.next();
@@ -70,4 +71,18 @@ public void shouldIterateOverValueFromBothIterators() throws Exception {
         }
     }
 
+    @Test
+    public void shouldPeekNextKey() throws Exception {
+        windowStoreKvPairs.add(KeyValue.pair(10L, "a".getBytes()));
+        cache.put(namespace, WindowStoreUtils.toBinaryKey("a", 0, 0, stateSerdes), new LRUCacheEntry("b".getBytes()));
+        byte[] binaryFrom = WindowStoreUtils.toBinaryKey("a", 0, 0, stateSerdes);
+        byte[] binaryTo = WindowStoreUtils.toBinaryKey("a", 100, 0, stateSerdes);
+        final KeyValueIterator<Long, byte[]> storeIterator = new DelegatingPeekingKeyValueIterator<>("name", new KeyValueIteratorStub<>(windowStoreKvPairs.iterator()));
+        final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator = cache.range(namespace, binaryFrom, binaryTo);
+        final MergedSortedCacheWindowStoreIterator<byte[]> iterator = new MergedSortedCacheWindowStoreIterator<>(cacheIterator, storeIterator, new StateSerdes<>("name", Serdes.Long(), Serdes.ByteArray()));
+        assertThat(iterator.peekNextKey(), equalTo(0L));
+        iterator.next();
+        assertThat(iterator.peekNextKey(), equalTo(10L));
+    }
+
 }
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/ReadOnlyWindowStoreStub.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/ReadOnlyWindowStoreStub.java
index 2082e00cba0bc..a2ce96c545dfb 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/ReadOnlyWindowStoreStub.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/ReadOnlyWindowStoreStub.java
@@ -104,6 +104,11 @@ public void close() {
 
         }
 
+        @Override
+        public Long peekNextKey() {
+            throw new UnsupportedOperationException("peekNextKey not supported in stub");
+        }
+
         @Override
         public boolean hasNext() {
             return underlying.hasNext();
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplierTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplierTest.java
new file mode 100644
index 0000000000000..3d9a56c271d6c
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplierTest.java
@@ -0,0 +1,155 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.clients.producer.ProducerRecord;
+import org.apache.kafka.common.metrics.Metrics;
+import org.apache.kafka.common.serialization.Serdes;
+import org.apache.kafka.common.serialization.Serializer;
+import org.apache.kafka.streams.StreamsMetrics;
+import org.apache.kafka.streams.processor.internals.MockStreamsMetrics;
+import org.apache.kafka.streams.state.KeyValueStore;
+import org.apache.kafka.test.MockProcessorContext;
+import org.apache.kafka.test.NoOpRecordCollector;
+import org.apache.kafka.test.TestUtils;
+import org.junit.After;
+import org.junit.Test;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+import static org.hamcrest.CoreMatchers.is;
+import static org.hamcrest.MatcherAssert.assertThat;
+import static org.hamcrest.core.IsInstanceOf.instanceOf;
+import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertTrue;
+
+public class RocksDBKeyValueStoreSupplierTest {
+
+    private static final String STORE_NAME = "name";
+    private final ThreadCache cache = new ThreadCache("test", 1024, new MockStreamsMetrics(new Metrics()));
+    private final MockProcessorContext context = new MockProcessorContext(null,
+                                                                          TestUtils.tempDirectory(),
+                                                                          Serdes.String(),
+                                                                          Serdes.String(),
+                                                                          new NoOpRecordCollector(),
+                                                                          cache);
+    private KeyValueStore<String, String> store;
+
+    @After
+    public void close() {
+        store.close();
+    }
+
+    @Test
+    public void shouldCreateLoggingEnabledStoreWhenStoreLogged() throws Exception {
+        store = createStore(true, false);
+        final List<ProducerRecord> logged = new ArrayList<>();
+        final NoOpRecordCollector collector = new NoOpRecordCollector() {
+            @Override
+            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
+                logged.add(record);
+            }
+        };
+        final MockProcessorContext context = new MockProcessorContext(null,
+                                                                      TestUtils.tempDirectory(),
+                                                                      Serdes.String(),
+                                                                      Serdes.String(),
+                                                                      collector,
+                                                                      cache);
+        context.setTime(1);
+        store.init(context, store);
+        store.put("a", "b");
+        assertFalse(logged.isEmpty());
+    }
+
+    @Test
+    public void shouldNotBeLoggingEnabledStoreWhenLoggingNotEnabled() throws Exception {
+        store = createStore(false, false);
+        final List<ProducerRecord> logged = new ArrayList<>();
+        final NoOpRecordCollector collector = new NoOpRecordCollector() {
+            @Override
+            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
+                logged.add(record);
+            }
+        };
+        final MockProcessorContext context = new MockProcessorContext(null,
+                                                                      TestUtils.tempDirectory(),
+                                                                      Serdes.String(),
+                                                                      Serdes.String(),
+                                                                      collector,
+                                                                      cache);
+        context.setTime(1);
+        store.init(context, store);
+        store.put("a", "b");
+        assertTrue(logged.isEmpty());
+    }
+
+    @Test
+    public void shouldReturnCachedKeyValueStoreWhenCachingEnabled() throws Exception {
+        store = createStore(false, true);
+        store.init(context, store);
+        context.setTime(1);
+        store.put("a", "b");
+        store.put("b", "c");
+        assertThat(store, is(instanceOf(CachingKeyValueStore.class)));
+        assertThat(cache.size(), is(2L));
+    }
+
+    @Test
+    public void shouldReturnMeteredStoreWhenCachingAndLoggingDisabled() throws Exception {
+        store = createStore(false, false);
+        assertThat(store, is(instanceOf(MeteredKeyValueStore.class)));
+    }
+
+    @Test
+    public void shouldReturnMeteredStoreWhenCachingDisabled() throws Exception {
+        store = createStore(true, false);
+        assertThat(store, is(instanceOf(MeteredKeyValueStore.class)));
+    }
+
+    @SuppressWarnings("unchecked")
+    @Test
+    public void shouldHaveMeteredStoreWhenCached() throws Exception {
+        store = createStore(false, true);
+        store.init(context, store);
+        final StreamsMetrics metrics = context.metrics();
+        assertFalse(metrics.metrics().isEmpty());
+    }
+
+    @SuppressWarnings("unchecked")
+    @Test
+    public void shouldHaveMeteredStoreWhenLogged() throws Exception {
+        store = createStore(true, false);
+        store.init(context, store);
+        final StreamsMetrics metrics = context.metrics();
+        assertFalse(metrics.metrics().isEmpty());
+    }
+
+    @SuppressWarnings("unchecked")
+    private KeyValueStore<String, String> createStore(final boolean logged, final boolean cached) {
+        return new RocksDBKeyValueStoreSupplier<>(STORE_NAME,
+                                                  Serdes.String(),
+                                                  Serdes.String(),
+                                                  logged,
+                                                  Collections.EMPTY_MAP,
+                                                  cached).get();
+    }
+
+}
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplierTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplierTest.java
new file mode 100644
index 0000000000000..28196a2a6ef8f
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplierTest.java
@@ -0,0 +1,169 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.clients.producer.ProducerRecord;
+import org.apache.kafka.common.metrics.Metrics;
+import org.apache.kafka.common.serialization.Serdes;
+import org.apache.kafka.common.serialization.Serializer;
+import org.apache.kafka.streams.StreamsMetrics;
+import org.apache.kafka.streams.kstream.Windowed;
+import org.apache.kafka.streams.kstream.internals.SessionWindow;
+import org.apache.kafka.streams.processor.internals.MockStreamsMetrics;
+import org.apache.kafka.streams.state.SessionStore;
+import org.apache.kafka.test.MockProcessorContext;
+import org.apache.kafka.test.NoOpRecordCollector;
+import org.apache.kafka.test.TestUtils;
+import org.junit.After;
+import org.junit.Test;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+import static org.hamcrest.CoreMatchers.is;
+import static org.hamcrest.MatcherAssert.assertThat;
+import static org.hamcrest.core.IsInstanceOf.instanceOf;
+import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertTrue;
+
+public class RocksDBSessionStoreSupplierTest {
+
+    private static final String STORE_NAME = "name";
+    private final ThreadCache cache = new ThreadCache("test", 1024, new MockStreamsMetrics(new Metrics()));
+    private final MockProcessorContext context = new MockProcessorContext(null,
+                                                                          TestUtils.tempDirectory(),
+                                                                          Serdes.String(),
+                                                                          Serdes.String(),
+                                                                          new NoOpRecordCollector(),
+                                                                          cache);
+
+    private SessionStore<String, String> store;
+
+    @After
+    public void close() {
+        store.close();
+    }
+
+    @Test
+    public void shouldCreateLoggingEnabledStoreWhenStoreLogged() throws Exception {
+        store = createStore(true, false);
+        final List<ProducerRecord> logged = new ArrayList<>();
+        final NoOpRecordCollector collector = new NoOpRecordCollector() {
+            @Override
+            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
+                logged.add(record);
+            }
+        };
+        final MockProcessorContext context = new MockProcessorContext(null,
+                                                                      TestUtils.tempDirectory(),
+                                                                      Serdes.String(),
+                                                                      Serdes.String(),
+                                                                      collector,
+                                                                      cache);
+        context.setTime(1);
+        store.init(context, store);
+        store.put(new Windowed<>("a", new SessionWindow(0, 10)), "b");
+        assertFalse(logged.isEmpty());
+    }
+
+    @Test
+    public void shouldNotBeLoggingEnabledStoreWhenLoggingNotEnabled() throws Exception {
+        store = createStore(false, false);
+        final List<ProducerRecord> logged = new ArrayList<>();
+        final NoOpRecordCollector collector = new NoOpRecordCollector() {
+            @Override
+            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
+                logged.add(record);
+            }
+        };
+        final MockProcessorContext context = new MockProcessorContext(null,
+                                                                      TestUtils.tempDirectory(),
+                                                                      Serdes.String(),
+                                                                      Serdes.String(),
+                                                                      collector,
+                                                                      cache);
+        context.setTime(1);
+        store.init(context, store);
+        store.put(new Windowed<>("a", new SessionWindow(0, 10)), "b");
+        assertTrue(logged.isEmpty());
+    }
+
+    @Test
+    public void shouldReturnCachedSessionStoreWhenCachingEnabled() throws Exception {
+        store = createStore(false, true);
+        store.init(context, store);
+        context.setTime(1);
+        store.put(new Windowed<>("a", new SessionWindow(0, 10)), "b");
+        store.put(new Windowed<>("b", new SessionWindow(0, 10)), "c");
+        assertThat(store, is(instanceOf(CachingSessionStore.class)));
+        assertThat(cache.size(), is(2L));
+    }
+
+    @Test
+    public void shouldReturnRocksDbStoreWhenCachingAndLoggingDisabled() throws Exception {
+        store = createStore(false, false);
+        assertThat(store, is(instanceOf(RocksDBSessionStore.class)));
+    }
+
+    @Test
+    public void shouldReturnRocksDbStoreWhenCachingDisabled() throws Exception {
+        store = createStore(true, false);
+        assertThat(store, is(instanceOf(RocksDBSessionStore.class)));
+    }
+
+    @SuppressWarnings("unchecked")
+    @Test
+    public void shouldHaveMeteredStoreWhenCached() throws Exception {
+        store = createStore(false, true);
+        store.init(context, store);
+        final StreamsMetrics metrics = context.metrics();
+        assertFalse(metrics.metrics().isEmpty());
+    }
+
+    @SuppressWarnings("unchecked")
+    @Test
+    public void shouldHaveMeteredStoreWhenLogged() throws Exception {
+        store = createStore(true, false);
+        store.init(context, store);
+        final StreamsMetrics metrics = context.metrics();
+        assertFalse(metrics.metrics().isEmpty());
+    }
+
+    @SuppressWarnings("unchecked")
+    @Test
+    public void shouldHaveMeteredStoreWhenNotLoggedOrCached() throws Exception {
+        store = createStore(false, false);
+        store.init(context, store);
+        final StreamsMetrics metrics = context.metrics();
+        assertFalse(metrics.metrics().isEmpty());
+    }
+
+
+
+    private SessionStore<String, String> createStore(final boolean logged, final boolean cached) {
+        return new RocksDBSessionStoreSupplier<>(STORE_NAME,
+                                                 10,
+                                                 Serdes.String(),
+                                                 Serdes.String(),
+                                                 logged,
+                                                 Collections.<String, String>emptyMap(),
+                                                 cached).get();
+    }
+
+}
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplierTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplierTest.java
new file mode 100644
index 0000000000000..897ec623dc479
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplierTest.java
@@ -0,0 +1,168 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.clients.producer.ProducerRecord;
+import org.apache.kafka.common.metrics.Metrics;
+import org.apache.kafka.common.serialization.Serdes;
+import org.apache.kafka.common.serialization.Serializer;
+import org.apache.kafka.streams.StreamsMetrics;
+import org.apache.kafka.streams.processor.internals.MockStreamsMetrics;
+import org.apache.kafka.streams.state.WindowStore;
+import org.apache.kafka.test.MockProcessorContext;
+import org.apache.kafka.test.NoOpRecordCollector;
+import org.apache.kafka.test.TestUtils;
+import org.junit.After;
+import org.junit.Test;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+import static org.hamcrest.CoreMatchers.is;
+import static org.hamcrest.MatcherAssert.assertThat;
+import static org.hamcrest.core.IsInstanceOf.instanceOf;
+import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertTrue;
+
+public class RocksDBWindowStoreSupplierTest {
+
+    private static final String STORE_NAME = "name";
+    private WindowStore<String, String> store;
+    private final ThreadCache cache = new ThreadCache("test", 1024, new MockStreamsMetrics(new Metrics()));
+    private final MockProcessorContext context = new MockProcessorContext(null,
+                                                                          TestUtils.tempDirectory(),
+                                                                          Serdes.String(),
+                                                                          Serdes.String(),
+                                                                          new NoOpRecordCollector(),
+                                                                          cache);
+
+    @After
+    public void close() {
+        store.close();
+    }
+
+    @Test
+    public void shouldCreateLoggingEnabledStoreWhenWindowStoreLogged() throws Exception {
+        store = createStore(true, false);
+        final List<ProducerRecord> logged = new ArrayList<>();
+        final NoOpRecordCollector collector = new NoOpRecordCollector() {
+            @Override
+            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
+                logged.add(record);
+            }
+        };
+        final MockProcessorContext context = new MockProcessorContext(null,
+                                                                      TestUtils.tempDirectory(),
+                                                                      Serdes.String(),
+                                                                      Serdes.String(),
+                                                                      collector,
+                                                                      cache);
+        context.setTime(1);
+        store.init(context, store);
+        store.put("a", "b");
+        assertFalse(logged.isEmpty());
+    }
+
+    @Test
+    public void shouldNotBeLoggingEnabledStoreWhenLogginNotEnabled() throws Exception {
+        store = createStore(false, false);
+        final List<ProducerRecord> logged = new ArrayList<>();
+        final NoOpRecordCollector collector = new NoOpRecordCollector() {
+            @Override
+            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
+                logged.add(record);
+            }
+        };
+        final MockProcessorContext context = new MockProcessorContext(null,
+                                                                      TestUtils.tempDirectory(),
+                                                                      Serdes.String(),
+                                                                      Serdes.String(),
+                                                                      collector,
+                                                                      cache);
+        context.setTime(1);
+        store.init(context, store);
+        store.put("a", "b");
+        assertTrue(logged.isEmpty());
+    }
+
+    @Test
+    public void shouldBeCachedWindowStoreWhenCachingEnabled() throws Exception {
+        store = createStore(false, true);
+        store.init(context, store);
+        context.setTime(1);
+        store.put("a", "b");
+        store.put("b", "c");
+        assertThat(store, is(instanceOf(CachingWindowStore.class)));
+        assertThat(context.getCache().size(), is(2L));
+    }
+
+    @Test
+    public void shouldReturnRocksDbStoreWhenCachingAndLoggingDisabled() throws Exception {
+        store = createStore(false, false);
+        assertThat(store, is(instanceOf(RocksDBWindowStore.class)));
+    }
+
+    @Test
+    public void shouldReturnRocksDbStoreWhenCachingDisabled() throws Exception {
+        store = createStore(true, false);
+        assertThat(store, is(instanceOf(RocksDBWindowStore.class)));
+    }
+
+    @SuppressWarnings("unchecked")
+    @Test
+    public void shouldHaveMeteredStoreWhenCached() throws Exception {
+        store = createStore(false, true);
+        store.init(context, store);
+        final StreamsMetrics metrics = context.metrics();
+        assertFalse(metrics.metrics().isEmpty());
+    }
+
+    @SuppressWarnings("unchecked")
+    @Test
+    public void shouldHaveMeteredStoreWhenLogged() throws Exception {
+        store = createStore(true, false);
+        store.init(context, store);
+        final StreamsMetrics metrics = context.metrics();
+        assertFalse(metrics.metrics().isEmpty());
+    }
+
+    @SuppressWarnings("unchecked")
+    @Test
+    public void shouldHaveMeteredStoreWhenNotLoggedOrCached() throws Exception {
+        store = createStore(false, false);
+        store.init(context, store);
+        final StreamsMetrics metrics = context.metrics();
+        assertFalse(metrics.metrics().isEmpty());
+    }
+
+    @SuppressWarnings("unchecked")
+    private WindowStore<String, String> createStore(final boolean logged, final boolean cached) {
+        return new RocksDBWindowStoreSupplier<>(STORE_NAME,
+                                                10,
+                                                3,
+                                                false,
+                                                Serdes.String(),
+                                                Serdes.String(),
+                                                10,
+                                                logged,
+                                                Collections.<String, String>emptyMap(),
+                                                cached).get();
+    }
+
+}
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java
index a5225926e27ed..79223dee81ab3 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java
@@ -490,8 +490,6 @@ public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySeria
                     recordCollector, cache);
 
             WindowStore<Integer, String> store = createWindowStore(context, false, true);
-            RocksDBWindowStore<Integer, String> inner =
-                    (RocksDBWindowStore<Integer, String>) ((MeteredWindowStore<Integer, String>) store).inner();
             try {
                 // to validate segments
                 final Segments segments = new Segments(windowName, retentionPeriod, numSegments);
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/SerializedKeyValueIteratorTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/SerializedKeyValueIteratorTest.java
new file mode 100644
index 0000000000000..8c0d2fec0f5db
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/SerializedKeyValueIteratorTest.java
@@ -0,0 +1,95 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.common.serialization.Serdes;
+import org.apache.kafka.common.utils.Bytes;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.state.StateSerdes;
+import org.apache.kafka.test.KeyValueIteratorStub;
+import org.junit.Test;
+
+import java.util.Arrays;
+import java.util.Iterator;
+import java.util.NoSuchElementException;
+
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.MatcherAssert.assertThat;
+import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertTrue;
+import static org.junit.Assert.fail;
+
+public class SerializedKeyValueIteratorTest {
+
+    private final StateSerdes<String, String> serdes = new StateSerdes<>("blah", Serdes.String(), Serdes.String());
+    private final Iterator<KeyValue<Bytes, byte[]>> iterator
+            = Arrays.asList(KeyValue.pair(Bytes.wrap("hi".getBytes()), "there".getBytes()),
+                            KeyValue.pair(Bytes.wrap("hello".getBytes()), "world".getBytes()))
+            .iterator();
+    private final DelegatingPeekingKeyValueIterator<Bytes, byte[]> peeking
+            = new DelegatingPeekingKeyValueIterator<>("store", new KeyValueIteratorStub<>(iterator));
+    private final SerializedKeyValueIterator<String, String> serializedKeyValueIterator
+            = new SerializedKeyValueIterator<>(peeking, serdes);
+
+    @Test
+    public void shouldReturnTrueOnHasNextWhenMoreResults() {
+        assertTrue(serializedKeyValueIterator.hasNext());
+    }
+
+    @Test
+    public void shouldReturnNextValueWhenItExists() throws Exception {
+        assertThat(serializedKeyValueIterator.next(), equalTo(KeyValue.pair("hi", "there")));
+        assertThat(serializedKeyValueIterator.next(), equalTo(KeyValue.pair("hello", "world")));
+    }
+
+    @Test
+    public void shouldReturnFalseOnHasNextWhenNoMoreResults() throws Exception {
+        advanceIteratorToEnd();
+        assertFalse(serializedKeyValueIterator.hasNext());
+    }
+
+    @Test
+    public void shouldThrowNoSuchElementOnNextWhenIteratorExhausted() throws Exception {
+        advanceIteratorToEnd();
+        try {
+            serializedKeyValueIterator.next();
+            fail("Expected NoSuchElementException on exhausted iterator");
+        } catch (final NoSuchElementException nse) {
+            // pass
+        }
+    }
+
+    @Test
+    public void shouldPeekNextKey() throws Exception {
+        assertThat(serializedKeyValueIterator.peekNextKey(), equalTo("hi"));
+        serializedKeyValueIterator.next();
+        assertThat(serializedKeyValueIterator.peekNextKey(), equalTo("hello"));
+    }
+
+    @Test(expected = UnsupportedOperationException.class)
+    public void shouldThrowUnsupportedOperationOnRemove() throws Exception {
+        serializedKeyValueIterator.remove();
+    }
+
+    private void advanceIteratorToEnd() {
+        serializedKeyValueIterator.next();
+        serializedKeyValueIterator.next();
+    }
+
+
+}
\ No newline at end of file

From eb62e5695506ae13bd37102c3c08e8a067eca0c8 Mon Sep 17 00:00:00 2001
From: Ismael Juma <ismael@juma.me.uk>
Date: Wed, 18 Jan 2017 02:43:10 +0000
Subject: [PATCH 008/177] KAFKA-4591; Create Topic Policy follow-up

1. Added javadoc to public classes
2. Removed `s` from config name for consistency with interface name
3. The policy interface now implements Configurable and AutoCloseable as per the KIP
4. Use `null` instead of `-1` in `RequestMetadata`
5. Perform all broker validation before invoking the policy
6. Add tests

Author: Ismael Juma <ismael@juma.me.uk>

Reviewers: Jason Gustafson <jason@confluent.io>

Closes #2388 from ijuma/create-topic-policy-docs-and-config-name-change

(cherry picked from commit fd6d7bcf335166a524dc9a29a50c96af8f1c1c02)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../errors/PolicyViolationException.java      |  3 +
 .../apache/kafka/common/protocol/Errors.java  |  2 +-
 .../server/policy/CreateTopicPolicy.java      | 72 +++++++++++++++++--
 .../main/scala/kafka/admin/AdminUtils.scala   | 36 ++++++----
 .../scala/kafka/server/AdminManager.scala     | 56 ++++++++++-----
 .../main/scala/kafka/server/KafkaConfig.scala |  6 +-
 .../AbstractCreateTopicsRequestTest.scala     |  2 +-
 .../CreateTopicsRequestWithPolicyTest.scala   | 59 ++++++++++++---
 .../unit/kafka/server/KafkaConfigTest.scala   |  2 +-
 9 files changed, 183 insertions(+), 55 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/common/errors/PolicyViolationException.java b/clients/src/main/java/org/apache/kafka/common/errors/PolicyViolationException.java
index 7923444c2a8f6..393a6df4bf6dd 100644
--- a/clients/src/main/java/org/apache/kafka/common/errors/PolicyViolationException.java
+++ b/clients/src/main/java/org/apache/kafka/common/errors/PolicyViolationException.java
@@ -17,6 +17,9 @@
 
 package org.apache.kafka.common.errors;
 
+/**
+ * Exception thrown if a create topics request does not satisfy the configured policy for a topic.
+ */
 public class PolicyViolationException extends ApiException {
 
     public PolicyViolationException(String message) {
diff --git a/clients/src/main/java/org/apache/kafka/common/protocol/Errors.java b/clients/src/main/java/org/apache/kafka/common/protocol/Errors.java
index f30f889054cec..e7689e2e11908 100644
--- a/clients/src/main/java/org/apache/kafka/common/protocol/Errors.java
+++ b/clients/src/main/java/org/apache/kafka/common/protocol/Errors.java
@@ -166,7 +166,7 @@ public enum Errors {
             " the message was sent to an incompatible broker. See the broker logs for more details.")),
     UNSUPPORTED_FOR_MESSAGE_FORMAT(43,
         new UnsupportedForMessageFormatException("The message format version on the broker does not support the request.")),
-    POLICY_VIOLATION(44, new PolicyViolationException("Request parameters do not satisfy the system policy."));
+    POLICY_VIOLATION(44, new PolicyViolationException("Request parameters do not satisfy the configured policy."));
 
     private static final Logger log = LoggerFactory.getLogger(Errors.class);
 
diff --git a/clients/src/main/java/org/apache/kafka/server/policy/CreateTopicPolicy.java b/clients/src/main/java/org/apache/kafka/server/policy/CreateTopicPolicy.java
index 94f1e763a222c..22a7c1d37ccb4 100644
--- a/clients/src/main/java/org/apache/kafka/server/policy/CreateTopicPolicy.java
+++ b/clients/src/main/java/org/apache/kafka/server/policy/CreateTopicPolicy.java
@@ -13,42 +13,90 @@
 
 package org.apache.kafka.server.policy;
 
+import org.apache.kafka.common.Configurable;
 import org.apache.kafka.common.errors.PolicyViolationException;
 
 import java.util.Collections;
 import java.util.List;
 import java.util.Map;
 
-public interface CreateTopicPolicy {
+/**
+ * An interface for enforcing a policy on create topics requests.
+ *
+ * Common use cases are requiring that the replication factor, min.insync.replicas and/or retention settings for a
+ * topic are within an allowable range.
+ *
+ * If <code>create.topic.policy.class.name</code> is defined, Kafka will create an instance of the specified class
+ * using the default constructor and will then pass the broker configs to its <code>configure()</code> method. During
+ * broker shutdown, the <code>close()</code> method will be invoked so that resources can be released (if necessary).
+ */
+public interface CreateTopicPolicy extends Configurable, AutoCloseable {
 
+    /**
+     * Class containing the create request parameters.
+     */
     class RequestMetadata {
         private final String topic;
-        private final int numPartitions;
-        private final short replicationFactor;
+        private final Integer numPartitions;
+        private final Short replicationFactor;
         private final Map<Integer, List<Integer>> replicasAssignments;
         private final Map<String, String> configs;
 
-        public RequestMetadata(String topic, int numPartitions, short replicationFactor,
-                               Map<Integer, List<Integer>> replicasAssignments, Map<String, String> configs) {
+        /**
+         * Create an instance of this class with the provided parameters.
+         *
+         * This constructor is public to make testing of <code>CreateTopicPolicy</code> implementations easier.
+         *
+         * @param topic the name of the topic to created.
+         * @param numPartitions the number of partitions to create or null if replicasAssignments is set.
+         * @param replicationFactor the replication factor for the topic or null if replicaAssignments is set.
+         * @param replicasAssignments replica assignments or null if numPartitions and replicationFactor is set. The
+         *                            assignment is a map from partition id to replica (broker) ids.
+         * @param configs topic configs for the topic to be created, not including broker defaults. Broker configs are
+         *                passed via the {@code configure()} method of the policy implementation.
+         */
+        public RequestMetadata(String topic, Integer numPartitions, Short replicationFactor,
+                        Map<Integer, List<Integer>> replicasAssignments, Map<String, String> configs) {
             this.topic = topic;
             this.numPartitions = numPartitions;
             this.replicationFactor = replicationFactor;
-            this.replicasAssignments = Collections.unmodifiableMap(replicasAssignments);
+            this.replicasAssignments = replicasAssignments == null ? null : Collections.unmodifiableMap(replicasAssignments);
             this.configs = Collections.unmodifiableMap(configs);
         }
 
+        /**
+         * Return the name of the topic to create.
+         */
         public String topic() {
             return topic;
         }
 
-        public int numPartitions() {
+        /**
+         * Return the number of partitions to create or null if replicaAssignments is not null.
+         */
+        public Integer numPartitions() {
             return numPartitions;
         }
 
+        /**
+         * Return the number of replicas to create or null if replicaAssignments is not null.
+         */
+        public Short replicationFactor() {
+            return replicationFactor;
+        }
+
+        /**
+         * Return a map from partition id to replica (broker) ids or null if numPartitions and replicationFactor are
+         * set instead.
+         */
         public Map<Integer, List<Integer>> replicasAssignments() {
             return replicasAssignments;
         }
 
+        /**
+         * Return topic configs in the request, not including broker defaults. Broker configs are passed via
+         * the {@code configure()} method of the policy implementation.
+         */
         public Map<String, String> configs() {
             return configs;
         }
@@ -63,5 +111,15 @@ public String toString() {
         }
     }
 
+    /**
+     * Validate the request parameters and throw a <code>PolicyViolationException</code> with a suitable error
+     * message if the create request parameters for the provided topic do not satisfy this policy.
+     *
+     * Clients will receive the POLICY_VIOLATION error code along with the exception's message. Note that validation
+     * failure only affects the relevant topic, other topics in the request will still be processed.
+     *
+     * @param requestMetadata the create request parameters for the provided topic.
+     * @throws PolicyViolationException if the request parameters do not satisfy this policy.
+     */
     void validate(RequestMetadata requestMetadata) throws PolicyViolationException;
 }
diff --git a/core/src/main/scala/kafka/admin/AdminUtils.scala b/core/src/main/scala/kafka/admin/AdminUtils.scala
index 916db483338de..02d5fe07961d0 100644
--- a/core/src/main/scala/kafka/admin/AdminUtils.scala
+++ b/core/src/main/scala/kafka/admin/AdminUtils.scala
@@ -417,12 +417,11 @@ object AdminUtils extends Logging with AdminUtilities {
     AdminUtils.createOrUpdateTopicPartitionAssignmentPathInZK(zkUtils, topic, replicaAssignment, topicConfig)
   }
 
-  def createOrUpdateTopicPartitionAssignmentPathInZK(zkUtils: ZkUtils,
-                                                     topic: String,
-                                                     partitionReplicaAssignment: Map[Int, Seq[Int]],
-                                                     config: Properties = new Properties,
-                                                     update: Boolean = false,
-                                                     validateOnly: Boolean = false) {
+  def validateCreateOrUpdateTopic(zkUtils: ZkUtils,
+                                  topic: String,
+                                  partitionReplicaAssignment: Map[Int, Seq[Int]],
+                                  config: Properties,
+                                  update: Boolean): Unit = {
     // validate arguments
     Topic.validate(topic)
 
@@ -450,18 +449,25 @@ object AdminUtils extends Logging with AdminUtilities {
 
 
     // Configs only matter if a topic is being created. Changing configs via AlterTopic is not supported
-    if (!update) {
+    if (!update)
       LogConfig.validate(config)
-      if (!validateOnly) {
-        // write out the config if there is any, this isn't transactional with the partition assignments
-        writeEntityConfig(zkUtils, getEntityConfigPath(ConfigType.Topic, topic), config)
-      }
-    }
+  }
 
-    if (!validateOnly) {
-      // create the partition assignment
-      writeTopicPartitionAssignment(zkUtils, topic, partitionReplicaAssignment, update)
+  def createOrUpdateTopicPartitionAssignmentPathInZK(zkUtils: ZkUtils,
+                                                     topic: String,
+                                                     partitionReplicaAssignment: Map[Int, Seq[Int]],
+                                                     config: Properties = new Properties,
+                                                     update: Boolean = false) {
+    validateCreateOrUpdateTopic(zkUtils, topic, partitionReplicaAssignment, config, update)
+
+    // Configs only matter if a topic is being created. Changing configs via AlterTopic is not supported
+    if (!update) {
+      // write out the config if there is any, this isn't transactional with the partition assignments
+      writeEntityConfig(zkUtils, getEntityConfigPath(ConfigType.Topic, topic), config)
     }
+
+    // create the partition assignment
+    writeTopicPartitionAssignment(zkUtils, topic, partitionReplicaAssignment, update)
   }
 
   private def writeTopicPartitionAssignment(zkUtils: ZkUtils, topic: String, replicaAssignment: Map[Int, Seq[Int]], update: Boolean) {
diff --git a/core/src/main/scala/kafka/server/AdminManager.scala b/core/src/main/scala/kafka/server/AdminManager.scala
index 75a71f5124083..6dc224dc54603 100644
--- a/core/src/main/scala/kafka/server/AdminManager.scala
+++ b/core/src/main/scala/kafka/server/AdminManager.scala
@@ -23,7 +23,7 @@ import kafka.common.TopicAlreadyMarkedForDeletionException
 import kafka.log.LogConfig
 import kafka.metrics.KafkaMetricsGroup
 import kafka.utils._
-import org.apache.kafka.common.errors.InvalidRequestException
+import org.apache.kafka.common.errors.{ApiException, InvalidRequestException, PolicyViolationException}
 import org.apache.kafka.common.metrics.Metrics
 import org.apache.kafka.common.protocol.Errors
 import org.apache.kafka.common.requests.CreateTopicsRequest._
@@ -43,7 +43,7 @@ class AdminManager(val config: KafkaConfig,
   private val topicPurgatory = DelayedOperationPurgatory[DelayedOperation]("topic", config.brokerId)
 
   private val createTopicPolicy =
-    Option(config.getConfiguredInstance(KafkaConfig.CreateTopicsPolicyClassNameProp, classOf[CreateTopicPolicy]))
+    Option(config.getConfiguredInstance(KafkaConfig.CreateTopicPolicyClassNameProp, classOf[CreateTopicPolicy]))
 
   def hasDelayedTopicOperations = topicPurgatory.delayed() != 0
 
@@ -80,29 +80,49 @@ class AdminManager(val config: KafkaConfig,
             && !arguments.replicasAssignments.isEmpty)
             throw new InvalidRequestException("Both numPartitions or replicationFactor and replicasAssignments were set. " +
               "Both cannot be used at the same time.")
-          else {
-            createTopicPolicy.foreach(_.validate(new RequestMetadata(topic, arguments.numPartitions,
-              arguments.replicationFactor, arguments.replicasAssignments, arguments.configs)))
-
-            if (!arguments.replicasAssignments.isEmpty) {
-              // Note: we don't check that replicaAssignment doesn't contain unknown brokers - unlike in add-partitions case,
-              // this follows the existing logic in TopicCommand
-              arguments.replicasAssignments.asScala.map { case (partitionId, replicas) =>
-                (partitionId.intValue, replicas.asScala.map(_.intValue))
-              }
-            } else {
-              AdminUtils.assignReplicasToBrokers(brokers, arguments.numPartitions, arguments.replicationFactor)
+          else if (!arguments.replicasAssignments.isEmpty) {
+            // Note: we don't check that replicaAssignment contains unknown brokers - unlike in add-partitions case,
+            // this follows the existing logic in TopicCommand
+            arguments.replicasAssignments.asScala.map { case (partitionId, replicas) =>
+              (partitionId.intValue, replicas.asScala.map(_.intValue))
             }
-          }
+          } else
+            AdminUtils.assignReplicasToBrokers(brokers, arguments.numPartitions, arguments.replicationFactor)
         }
         trace(s"Assignments for topic $topic are $assignments ")
-        AdminUtils.createOrUpdateTopicPartitionAssignmentPathInZK(zkUtils, topic, assignments, configs,
-          update = false, validateOnly = validateOnly)
+
+        createTopicPolicy match {
+          case Some(policy) =>
+            AdminUtils.validateCreateOrUpdateTopic(zkUtils, topic, assignments, configs, update = false)
+
+            // Use `null` for unset fields in the public API
+            val numPartitions: java.lang.Integer =
+              if (arguments.numPartitions == NO_NUM_PARTITIONS) null else arguments.numPartitions
+            val replicationFactor: java.lang.Short =
+              if (arguments.replicationFactor == NO_REPLICATION_FACTOR) null else arguments.replicationFactor
+            val replicaAssignments = if (arguments.replicasAssignments.isEmpty) null else arguments.replicasAssignments
+
+            policy.validate(new RequestMetadata(topic, numPartitions, replicationFactor, replicaAssignments,
+              arguments.configs))
+
+            if (!validateOnly)
+              AdminUtils.createOrUpdateTopicPartitionAssignmentPathInZK(zkUtils, topic, assignments, configs, update = false)
+
+          case None =>
+            if (validateOnly)
+              AdminUtils.validateCreateOrUpdateTopic(zkUtils, topic, assignments, configs, update = false)
+            else
+              AdminUtils.createOrUpdateTopicPartitionAssignmentPathInZK(zkUtils, topic, assignments, configs, update = false)
+        }
         CreateTopicMetadata(topic, assignments, new CreateTopicsResponse.Error(Errors.NONE, null))
       } catch {
-        case e: Throwable =>
+        // Log client errors at a lower level than unexpected exceptions
+        case e@ (_: PolicyViolationException | _: ApiException) =>
           info(s"Error processing create topic request for topic $topic with arguments $arguments", e)
           CreateTopicMetadata(topic, Map(), new CreateTopicsResponse.Error(Errors.forException(e), e.getMessage))
+        case e: Throwable =>
+          error(s"Error processing create topic request for topic $topic with arguments $arguments", e)
+          CreateTopicMetadata(topic, Map(), new CreateTopicsResponse.Error(Errors.forException(e), e.getMessage))
       }
     }
 
diff --git a/core/src/main/scala/kafka/server/KafkaConfig.scala b/core/src/main/scala/kafka/server/KafkaConfig.scala
index 891327f605d21..3c2a72d8ac6d9 100755
--- a/core/src/main/scala/kafka/server/KafkaConfig.scala
+++ b/core/src/main/scala/kafka/server/KafkaConfig.scala
@@ -281,7 +281,7 @@ object KafkaConfig {
   val NumRecoveryThreadsPerDataDirProp = "num.recovery.threads.per.data.dir"
   val AutoCreateTopicsEnableProp = "auto.create.topics.enable"
   val MinInSyncReplicasProp = "min.insync.replicas"
-  val CreateTopicsPolicyClassNameProp = "create.topics.policy.class.name"
+  val CreateTopicPolicyClassNameProp = "create.topic.policy.class.name"
   /** ********* Replication configuration ***********/
   val ControllerSocketTimeoutMsProp = "controller.socket.timeout.ms"
   val DefaultReplicationFactorProp = "default.replication.factor"
@@ -491,7 +491,7 @@ object KafkaConfig {
     "produce with acks of \"all\". This will ensure that the producer raises an exception " +
     "if a majority of replicas do not receive a write."
 
-  val CreateTopicsPolicyClassNameDoc = "The create topics policy class that should be used for validation. The class should " +
+  val CreateTopicPolicyClassNameDoc = "The create topic policy class that should be used for validation. The class should " +
     "implement the <code>org.apache.kafka.server.policy.CreateTopicPolicy</code> interface."
   /** ********* Replication configuration ***********/
   val ControllerSocketTimeoutMsDoc = "The socket timeout for controller-to-broker channels"
@@ -693,7 +693,7 @@ object KafkaConfig {
       .define(LogMessageFormatVersionProp, STRING, Defaults.LogMessageFormatVersion, MEDIUM, LogMessageFormatVersionDoc)
       .define(LogMessageTimestampTypeProp, STRING, Defaults.LogMessageTimestampType, in("CreateTime", "LogAppendTime"), MEDIUM, LogMessageTimestampTypeDoc)
       .define(LogMessageTimestampDifferenceMaxMsProp, LONG, Defaults.LogMessageTimestampDifferenceMaxMs, atLeast(0), MEDIUM, LogMessageTimestampDifferenceMaxMsDoc)
-      .define(CreateTopicsPolicyClassNameProp, CLASS, null, LOW, CreateTopicsPolicyClassNameDoc)
+      .define(CreateTopicPolicyClassNameProp, CLASS, null, LOW, CreateTopicPolicyClassNameDoc)
 
       /** ********* Replication configuration ***********/
       .define(ControllerSocketTimeoutMsProp, INT, Defaults.ControllerSocketTimeoutMs, MEDIUM, ControllerSocketTimeoutMsDoc)
diff --git a/core/src/test/scala/unit/kafka/server/AbstractCreateTopicsRequestTest.scala b/core/src/test/scala/unit/kafka/server/AbstractCreateTopicsRequestTest.scala
index 76774bdf55be3..32e69c772b39d 100644
--- a/core/src/test/scala/unit/kafka/server/AbstractCreateTopicsRequestTest.scala
+++ b/core/src/test/scala/unit/kafka/server/AbstractCreateTopicsRequestTest.scala
@@ -130,7 +130,7 @@ class AbstractCreateTopicsRequestTest extends BaseRequestTest {
   }
 
   protected def replicaAssignmentToJava(assignments: Map[Int, List[Int]]) = {
-    assignments.map { case (k, v) => (k:Integer, v.map { i => i:Integer }.asJava) }.asJava
+    assignments.map { case (k, v) => (k: Integer, v.map { i => i: Integer }.asJava) }.asJava
   }
 
   protected def sendCreateTopicRequest(request: CreateTopicsRequest, socketServer: SocketServer = controllerSocketServer): CreateTopicsResponse = {
diff --git a/core/src/test/scala/unit/kafka/server/CreateTopicsRequestWithPolicyTest.scala b/core/src/test/scala/unit/kafka/server/CreateTopicsRequestWithPolicyTest.scala
index 7127eaffca9de..80f6e9e096816 100644
--- a/core/src/test/scala/unit/kafka/server/CreateTopicsRequestWithPolicyTest.scala
+++ b/core/src/test/scala/unit/kafka/server/CreateTopicsRequestWithPolicyTest.scala
@@ -17,6 +17,7 @@
 
 package kafka.server
 
+import java.util
 import java.util.Properties
 
 import kafka.utils.TestUtils
@@ -34,16 +35,22 @@ class CreateTopicsRequestWithPolicyTest extends AbstractCreateTopicsRequestTest
 
   override def propertyOverrides(properties: Properties): Unit = {
     super.propertyOverrides(properties)
-    properties.put(KafkaConfig.CreateTopicsPolicyClassNameProp, classOf[Policy].getName)
+    properties.put(KafkaConfig.CreateTopicPolicyClassNameProp, classOf[Policy].getName)
   }
 
   @Test
   def testValidCreateTopicsRequests() {
     val timeout = 10000
+
     validateValidCreateTopicsRequests(new CreateTopicsRequest.Builder(
       Map("topic1" -> new CreateTopicsRequest.TopicDetails(5, 1.toShort)).asJava, timeout).build())
+
     validateValidCreateTopicsRequests(new CreateTopicsRequest.Builder(
       Map("topic2" -> new CreateTopicsRequest.TopicDetails(5, 3.toShort)).asJava, timeout, true).build())
+
+    val assignments = replicaAssignmentToJava(Map(0 -> List(1, 0), 1 -> List(0, 1)))
+    validateValidCreateTopicsRequests(new CreateTopicsRequest.Builder(
+      Map("topic3" -> new CreateTopicsRequest.TopicDetails(assignments)).asJava, timeout).build())
   }
 
   @Test
@@ -54,28 +61,62 @@ class CreateTopicsRequestWithPolicyTest extends AbstractCreateTopicsRequestTest
 
     // Policy violations
     validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(
-      Map("topic3" -> new CreateTopicsRequest.TopicDetails(4, 1.toShort)).asJava, timeout).build(),
-      Map("topic3" -> error(Errors.POLICY_VIOLATION, Some("Topics should have at least 5 partitions, received 4"))))
+      Map("policy-topic1" -> new CreateTopicsRequest.TopicDetails(4, 1.toShort)).asJava, timeout).build(),
+      Map("policy-topic1" -> error(Errors.POLICY_VIOLATION, Some("Topics should have at least 5 partitions, received 4"))))
+
+    validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(
+      Map("policy-topic2" -> new CreateTopicsRequest.TopicDetails(4, 1.toShort)).asJava, timeout, true).build(),
+      Map("policy-topic2" -> error(Errors.POLICY_VIOLATION, Some("Topics should have at least 5 partitions, received 4"))))
 
+    val assignments = replicaAssignmentToJava(Map(0 -> List(1), 1 -> List(0)))
     validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(
-      Map("topic4" -> new CreateTopicsRequest.TopicDetails(4, 1.toShort)).asJava, timeout, true).build(),
-      Map("topic4" -> error(Errors.POLICY_VIOLATION, Some("Topics should have at least 5 partitions, received 4"))))
+      Map("policy-topic3" -> new CreateTopicsRequest.TopicDetails(assignments)).asJava, timeout).build(),
+      Map("policy-topic3" -> error(Errors.POLICY_VIOLATION,
+        Some("""Topic partitions should have at least 2 partitions, received 1 for partition 0"""))), checkErrorMessage = true)
 
     // Check that basic errors still work
     validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(
       Map(existingTopic -> new CreateTopicsRequest.TopicDetails(5, 1.toShort)).asJava, timeout).build(),
       Map(existingTopic -> error(Errors.TOPIC_ALREADY_EXISTS, Some("""Topic "existing-topic" already exists."""))))
+
     validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(
       Map("error-replication" -> new CreateTopicsRequest.TopicDetails(10, (numBrokers + 1).toShort)).asJava, timeout, true).build(),
-      Map("error-replication" -> error(Errors.INVALID_REPLICATION_FACTOR, Some("replication factor: 4 larger than available brokers: 3"))))
+      Map("error-replication" -> error(Errors.INVALID_REPLICATION_FACTOR,
+        Some("replication factor: 4 larger than available brokers: 3"))))
+
+    validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(
+      Map("error-replication2" -> new CreateTopicsRequest.TopicDetails(10, -1: Short)).asJava, timeout, true).build(),
+      Map("error-replication2" -> error(Errors.INVALID_REPLICATION_FACTOR, Some("replication factor must be larger than 0"))))
   }
 
 }
 
 object CreateTopicsRequestWithPolicyTest {
+
   class Policy extends CreateTopicPolicy {
-    def validate(requestMetadata: RequestMetadata): Unit =
-      if (requestMetadata.numPartitions < 5)
-        throw new PolicyViolationException(s"Topics should have at least 5 partitions, received ${requestMetadata.numPartitions}")
+    def configure(configs: util.Map[String, _]): Unit = ()
+
+    def validate(requestMetadata: RequestMetadata): Unit = {
+      import requestMetadata._
+      require(configs.isEmpty, s"Topic configs should be empty, but it is $configs")
+      if (numPartitions != null || replicationFactor != null) {
+        require(numPartitions != null, s"numPartitions should not be null, but it is $numPartitions")
+        require(replicationFactor != null, s"replicationFactor should not be null, but it is $replicationFactor")
+        require(replicasAssignments == null, s"replicaAssigments should be null, but it is $replicasAssignments")
+        if (numPartitions < 5)
+          throw new PolicyViolationException(s"Topics should have at least 5 partitions, received $numPartitions")
+      } else {
+        require(numPartitions == null, s"numPartitions should be null, but it is $numPartitions")
+        require(replicationFactor == null, s"replicationFactor should be null, but it is $replicationFactor")
+        require(replicasAssignments != null, s"replicaAssigments should not be null, but it is $replicasAssignments")
+        replicasAssignments.asScala.foreach { case (partitionId, assignment) =>
+          if (assignment.size < 2)
+            throw new PolicyViolationException("Topic partitions should have at least 2 partitions, received " +
+              s"${assignment.size} for partition $partitionId")
+        }
+      }
+    }
+
+    def close(): Unit = ()
   }
 }
diff --git a/core/src/test/scala/unit/kafka/server/KafkaConfigTest.scala b/core/src/test/scala/unit/kafka/server/KafkaConfigTest.scala
index a5ca5a832e226..259178c57710b 100755
--- a/core/src/test/scala/unit/kafka/server/KafkaConfigTest.scala
+++ b/core/src/test/scala/unit/kafka/server/KafkaConfigTest.scala
@@ -547,7 +547,7 @@ class KafkaConfigTest {
         case KafkaConfig.RequestTimeoutMsProp => assertPropertyInvalid(getBaseProperties(), name, "not_a_number")
 
         case KafkaConfig.AuthorizerClassNameProp => //ignore string
-        case KafkaConfig.CreateTopicsPolicyClassNameProp => //ignore string
+        case KafkaConfig.CreateTopicPolicyClassNameProp => //ignore string
 
         case KafkaConfig.PortProp => assertPropertyInvalid(getBaseProperties(), name, "not_a_number")
         case KafkaConfig.HostNameProp => // ignore string

From e38794e020951adec5a5d0bbfe42c57294bf67bd Mon Sep 17 00:00:00 2001
From: Guozhang Wang <wangguoz@gmail.com>
Date: Tue, 17 Jan 2017 20:29:55 -0800
Subject: [PATCH 009/177] KAFKA-3502; move RocksDB options construction to
 init()

In RocksDBStore, options / wOptions / fOptions are constructed in the constructor, which needs to be dismissed in the close() call; however in some tests, the generated topology is not initialized at all, and hence the corresponding state stores are supposed to not be able to be closed as well since their `init` function is not called. This could cause the above option objects to be not released.

This is fixed in this patch to move the logic out of constructor and inside `init` functions, so that no RocksDB objects will be created in the constructor only. Also some minor cleanups:

1. In KStreamTestDriver.close(), we lost the logic to close the state stores but only call `flush`; it is now changed back to call both.
2. Moved the forwarding logic from KStreamTestDriver to MockProcessorContext to remove the mutual dependency: these functions should really be in ProcessorContext, not the test driver.

Author: Guozhang Wang <wangguoz@gmail.com>

Reviewers: Damian Guy <damian.guy@gmail.com>, Matthias J. Sax <matthias@confluent.io>, Jason Gustafson <jason@confluent.io>

Closes #2381 from guozhangwang/K3502-pure-virtual-function-unit-tests

(cherry picked from commit 1974e1b0e54abe5fdebd8ff3338df864b7ab60f3)
Signed-off-by: Jason Gustafson <jason@confluent.io>
---
 .../streams/state/internals/RocksDBStore.java |  21 +---
 .../streams/kstream/KStreamBuilderTest.java   |  58 ++++-----
 .../internals/KStreamKTableLeftJoinTest.java  |   2 -
 ...amSessionWindowAggregateProcessorTest.java |   4 +-
 .../state/KeyValueStoreTestDriver.java        |   2 +-
 .../internals/CachingKeyValueStoreTest.java   |   2 +-
 .../internals/CachingSessionStoreTest.java    |   2 +-
 .../internals/CachingWindowStoreTest.java     |   2 +-
 .../ChangeLoggingKeyValueBytesStoreTest.java  |   3 +-
 .../ChangeLoggingKeyValueStoreTest.java       |   3 +-
 .../ChangeLoggingSegmentedBytesStoreTest.java |   3 +-
 .../MeteredSegmentedBytesStoreTest.java       |   3 +-
 .../RocksDBKeyValueStoreSupplierTest.java     |   9 +-
 .../RocksDBSegmentedBytesStoreTest.java       |   3 +-
 .../RocksDBSessionStoreSupplierTest.java      |   9 +-
 .../internals/RocksDBSessionStoreTest.java    |   3 +-
 .../RocksDBWindowStoreSupplierTest.java       |   9 +-
 .../internals/RocksDBWindowStoreTest.java     |  24 ++--
 .../state/internals/SegmentIteratorTest.java  |  27 +++--
 .../streams/state/internals/SegmentsTest.java |   3 +-
 .../apache/kafka/test/KStreamTestDriver.java  | 113 +++++-------------
 .../kafka/test/MockProcessorContext.java      |  57 ++++++---
 22 files changed, 153 insertions(+), 209 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
index 3f8d509dda05a..55c1bb821c428 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
@@ -94,25 +94,21 @@ public class RocksDBStore<K, V> implements KeyValueStore<K, V> {
 
     protected volatile boolean open = false;
 
-
-    public RocksDBStore(final String name,
-                        final Serde<K> keySerde,
-                        final Serde<V> valueSerde) {
+    RocksDBStore(String name, Serde<K> keySerde, Serde<V> valueSerde) {
         this(name, DB_FILE_DIR, keySerde, valueSerde);
     }
 
-
-    public RocksDBStore(final String name,
-                        final String parentDir,
-                        final Serde<K> keySerde,
-                        final Serde<V> valueSerde) {
+    RocksDBStore(String name, String parentDir, Serde<K> keySerde, Serde<V> valueSerde) {
         this.name = name;
         this.parentDir = parentDir;
         this.keySerde = keySerde;
         this.valueSerde = valueSerde;
+    }
 
+    @SuppressWarnings("unchecked")
+    public void openDB(ProcessorContext context) {
         // initialize the default rocksdb options
-        BlockBasedTableConfig tableConfig = new BlockBasedTableConfig();
+        final BlockBasedTableConfig tableConfig = new BlockBasedTableConfig();
         tableConfig.setBlockCacheSize(BLOCK_CACHE_SIZE);
         tableConfig.setBlockSize(BLOCK_SIZE);
 
@@ -125,16 +121,12 @@ public RocksDBStore(final String name,
         options.setCreateIfMissing(true);
         options.setErrorIfExists(false);
 
-
         wOptions = new WriteOptions();
         wOptions.setDisableWAL(true);
 
         fOptions = new FlushOptions();
         fOptions.setWaitForFlush(true);
-    }
 
-    @SuppressWarnings("unchecked")
-    public void openDB(ProcessorContext context) {
         final Map<String, Object> configs = context.appConfigs();
         final Class<RocksDBConfigSetter> configSetterClass = (Class<RocksDBConfigSetter>) configs.get(StreamsConfig.ROCKSDB_CONFIG_SETTER_CLASS_CONFIG);
         if (configSetterClass != null) {
@@ -464,5 +456,4 @@ public synchronized boolean hasNext() {
             return super.hasNext() && comparator.compare(super.peekRawKey(), this.rawToKey) <= 0;
         }
     }
-
 }
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/KStreamBuilderTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/KStreamBuilderTest.java
index c32082c641c96..5f126c33e9d4f 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/KStreamBuilderTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/KStreamBuilderTest.java
@@ -28,6 +28,7 @@
 import org.apache.kafka.test.MockProcessorSupplier;
 import org.apache.kafka.test.MockValueJoiner;
 import org.junit.After;
+import org.junit.Before;
 import org.junit.Test;
 
 import java.util.HashSet;
@@ -41,8 +42,17 @@
 
 public class KStreamBuilderTest {
 
+    private static final String APP_ID = "app-id";
+
+    private final KStreamBuilder builder = new KStreamBuilder();
+
     private KStreamTestDriver driver = null;
 
+    @Before
+    public void setUp() {
+        builder.setApplicationId(APP_ID);
+    }
+
     @After
     public void cleanup() {
         if (driver != null) {
@@ -53,8 +63,6 @@ public void cleanup() {
 
     @Test(expected = TopologyBuilderException.class)
     public void testFrom() {
-        final KStreamBuilder builder = new KStreamBuilder();
-
         builder.stream("topic-1", "topic-2");
 
         builder.addSource(KStreamImpl.SOURCE_NAME + "0000000000", "topic-3");
@@ -62,17 +70,15 @@ public void testFrom() {
 
     @Test
     public void testNewName() {
-        KStreamBuilder builder = new KStreamBuilder();
-
         assertEquals("X-0000000000", builder.newName("X-"));
         assertEquals("Y-0000000001", builder.newName("Y-"));
         assertEquals("Z-0000000002", builder.newName("Z-"));
 
-        builder = new KStreamBuilder();
+        KStreamBuilder newBuilder = new KStreamBuilder();
 
-        assertEquals("X-0000000000", builder.newName("X-"));
-        assertEquals("Y-0000000001", builder.newName("Y-"));
-        assertEquals("Z-0000000002", builder.newName("Z-"));
+        assertEquals("X-0000000000", newBuilder.newName("X-"));
+        assertEquals("Y-0000000001", newBuilder.newName("Y-"));
+        assertEquals("Z-0000000002", newBuilder.newName("Z-"));
     }
 
     @Test
@@ -80,8 +86,6 @@ public void testMerge() {
         String topic1 = "topic-1";
         String topic2 = "topic-2";
 
-        KStreamBuilder builder = new KStreamBuilder();
-
         KStream<String, String> source1 = builder.stream(topic1);
         KStream<String, String> source2 = builder.stream(topic2);
         KStream<String, String> merged = builder.merge(source1, source2);
@@ -105,7 +109,6 @@ public void shouldHaveCorrectSourceTopicsForTableFromMergedStream() throws Excep
         final String topic1 = "topic-1";
         final String topic2 = "topic-2";
         final String topic3 = "topic-3";
-        final KStreamBuilder builder = new KStreamBuilder();
         final KStream<String, String> source1 = builder.stream(topic1);
         final KStream<String, String> source2 = builder.stream(topic2);
         final KStream<String, String> source3 = builder.stream(topic3);
@@ -131,28 +134,26 @@ public boolean test(final String key, final String value) {
         final KStream<String, String> merged = builder.merge(processedSource1, processedSource2, source3);
         merged.groupByKey().count("my-table");
         final Map<String, Set<String>> actual = builder.stateStoreNameToSourceTopics();
+
         assertEquals(Utils.mkSet("topic-1", "topic-2", "topic-3"), actual.get("my-table"));
     }
 
     @Test(expected = TopologyBuilderException.class)
     public void shouldThrowExceptionWhenNoTopicPresent() throws Exception {
-        new KStreamBuilder().stream();
+        builder.stream();
     }
 
     @Test(expected = NullPointerException.class)
     public void shouldThrowExceptionWhenTopicNamesAreNull() throws Exception {
-        new KStreamBuilder().stream(Serdes.String(), Serdes.String(), null, null);
+        builder.stream(Serdes.String(), Serdes.String(), null, null);
     }
 
     @Test
     public void shouldNotMaterializeSourceKTableIfStateNameNotSpecified() throws Exception {
-        final KStreamBuilder builder = new KStreamBuilder();
-        builder.setApplicationId("app-id");
-
         builder.table("topic1", "table1");
         builder.table("topic2", null);
 
-        ProcessorTopology topology = builder.build(null);
+        final ProcessorTopology topology = builder.build(null);
 
         assertEquals(1, topology.stateStores().size());
         assertEquals("table1", topology.stateStores().get(0).name());
@@ -162,23 +163,26 @@ public void shouldNotMaterializeSourceKTableIfStateNameNotSpecified() throws Exc
 
     @Test
     public void shouldBuildSimpleGlobalTableTopology() throws Exception {
-        final KStreamBuilder builder = new KStreamBuilder();
         builder.globalTable("table", "globalTable");
+
         final ProcessorTopology topology = builder.buildGlobalStateTopology();
         final List<StateStore> stateStores = topology.globalStateStores();
-        final StateStore store = stateStores.iterator().next();
+
         assertEquals(1, stateStores.size());
-        assertEquals("globalTable", store.name());
+        assertEquals("globalTable", stateStores.get(0).name());
     }
 
     @Test
     public void shouldBuildGlobalTopologyWithAllGlobalTables() throws Exception {
-        final KStreamBuilder builder = new KStreamBuilder();
         builder.globalTable("table", "globalTable");
         builder.globalTable("table2", "globalTable2");
+
         final ProcessorTopology topology = builder.buildGlobalStateTopology();
+
         final List<StateStore> stateStores = topology.globalStateStores();
-        assertEquals(Utils.mkSet("table", "table2"), topology.sourceTopics());
+        final Set<String> sourceTopics = topology.sourceTopics();
+
+        assertEquals(Utils.mkSet("table", "table2"), sourceTopics);
         assertEquals(2, stateStores.size());
     }
 
@@ -186,7 +190,6 @@ public void shouldBuildGlobalTopologyWithAllGlobalTables() throws Exception {
     public void shouldAddGlobalTablesToEachGroup() throws Exception {
         final String one = "globalTable";
         final String two = "globalTable2";
-        final KStreamBuilder builder = new KStreamBuilder();
         final GlobalKTable<String, String> globalTable = builder.globalTable("table", one);
         final GlobalKTable<String, String> globalTable2 = builder.globalTable("table2", two);
 
@@ -203,7 +206,7 @@ public String apply(final String key, final String value) {
         stream.leftJoin(globalTable, kvMapper, MockValueJoiner.TOSTRING_JOINER);
         final KStream<String, String> stream2 = builder.stream("t2");
         stream2.leftJoin(globalTable2, kvMapper, MockValueJoiner.TOSTRING_JOINER);
-        builder.setApplicationId("app-id");
+
         final Map<Integer, Set<String>> nodeGroups = builder.nodeGroups();
         for (Integer groupId : nodeGroups.keySet()) {
             final ProcessorTopology topology = builder.build(groupId);
@@ -212,6 +215,7 @@ public String apply(final String key, final String value) {
             for (StateStore stateStore : stateStores) {
                 names.add(stateStore.name());
             }
+
             assertEquals(2, stateStores.size());
             assertTrue(names.contains(one));
             assertTrue(names.contains(two));
@@ -220,9 +224,6 @@ public String apply(final String key, final String value) {
 
     @Test
     public void shouldMapStateStoresToCorrectSourceTopics() throws Exception {
-        final KStreamBuilder builder = new KStreamBuilder();
-        builder.setApplicationId("app-id");
-
         final KStream<String, String> playEvents = builder.stream("events");
 
         final KTable<String, String> table = builder.table("table-topic", "table-store");
@@ -230,7 +231,8 @@ public void shouldMapStateStoresToCorrectSourceTopics() throws Exception {
 
         final KStream<String, String> mapped = playEvents.map(MockKeyValueMapper.<String, String>SelectValueKeyValueMapper());
         mapped.leftJoin(table, MockValueJoiner.TOSTRING_JOINER).groupByKey().count("count");
+
         assertEquals(Collections.singleton("table-topic"), builder.stateStoreNameToSourceTopics().get("table-store"));
-        assertEquals(Collections.singleton("app-id-KSTREAM-MAP-0000000003-repartition"), builder.stateStoreNameToSourceTopics().get("count"));
+        assertEquals(Collections.singleton(APP_ID + "-KSTREAM-MAP-0000000003-repartition"), builder.stateStoreNameToSourceTopics().get("count"));
     }
 }
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KStreamKTableLeftJoinTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KStreamKTableLeftJoinTest.java
index 569ea5af0f921..b6988e31587e6 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KStreamKTableLeftJoinTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KStreamKTableLeftJoinTest.java
@@ -141,6 +141,4 @@ public void testJoin() throws Exception {
 
         processor.checkAndClearProcessResult("0:XX0+null", "1:XX1+null", "2:XX2+YY2", "3:XX3+YY3");
     }
-
-
 }
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KStreamSessionWindowAggregateProcessorTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KStreamSessionWindowAggregateProcessorTest.java
index c3368a116a90f..2e5b201186199 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KStreamSessionWindowAggregateProcessorTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KStreamSessionWindowAggregateProcessorTest.java
@@ -22,7 +22,6 @@
 import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.kstream.Aggregator;
 import org.apache.kafka.streams.kstream.Initializer;
-import org.apache.kafka.streams.kstream.KStreamBuilder;
 import org.apache.kafka.streams.kstream.Merger;
 import org.apache.kafka.streams.kstream.SessionWindows;
 import org.apache.kafka.streams.kstream.Windowed;
@@ -32,7 +31,6 @@
 import org.apache.kafka.streams.state.internals.RocksDBSessionStoreSupplier;
 import org.apache.kafka.streams.state.SessionStore;
 import org.apache.kafka.streams.state.internals.ThreadCache;
-import org.apache.kafka.test.KStreamTestDriver;
 import org.apache.kafka.test.MockProcessorContext;
 import org.apache.kafka.test.NoOpRecordCollector;
 import org.apache.kafka.test.TestUtils;
@@ -91,7 +89,7 @@ public Long apply(final String aggKey, final Long aggOne, final Long aggTwo) {
     @Before
     public void initializeStore() {
         final File stateDir = TestUtils.tempDirectory();
-        context = new MockProcessorContext(new KStreamTestDriver(new KStreamBuilder(), stateDir), stateDir,
+        context = new MockProcessorContext(stateDir,
             Serdes.String(), Serdes.String(), new NoOpRecordCollector(), new ThreadCache("testCache", 100000, new MockStreamsMetrics(new Metrics()))) {
             @Override
             public <K, V> void forward(final K key, final V value) {
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/KeyValueStoreTestDriver.java b/streams/src/test/java/org/apache/kafka/streams/state/KeyValueStoreTestDriver.java
index c3df49d3222ea..efa0e0e629839 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/KeyValueStoreTestDriver.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/KeyValueStoreTestDriver.java
@@ -231,7 +231,7 @@ public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySeria
 
 
 
-        this.context = new MockProcessorContext(null, this.stateDir, serdes.keySerde(), serdes.valueSerde(), recordCollector, null) {
+        this.context = new MockProcessorContext(this.stateDir, serdes.keySerde(), serdes.valueSerde(), recordCollector, null) {
             @Override
             public TaskId taskId() {
                 return new TaskId(0, 1);
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingKeyValueStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingKeyValueStoreTest.java
index 8746a86cb44b1..a00526f24c79a 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingKeyValueStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingKeyValueStoreTest.java
@@ -63,7 +63,7 @@ public void setUp() throws Exception {
         store = new CachingKeyValueStore<>(underlyingStore, Serdes.String(), Serdes.String());
         store.setFlushListener(cacheFlushListener);
         cache = new ThreadCache("testCache", maxCacheSizeBytes, new MockStreamsMetrics(new Metrics()));
-        final MockProcessorContext context = new MockProcessorContext(null, null, null, null, (RecordCollector) null, cache);
+        final MockProcessorContext context = new MockProcessorContext(null, null, null, (RecordCollector) null, cache);
         topic = "topic";
         context.setRecordContext(new ProcessorRecordContext(10, 0, 0, topic));
         store.init(context, null);
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java
index 5035f70887e8d..65a249eb5c69c 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java
@@ -64,7 +64,7 @@ public void setUp() throws Exception {
                                                  Serdes.String(),
                                                  Serdes.Long());
         cache = new ThreadCache("testCache", MAX_CACHE_SIZE_BYTES, new MockStreamsMetrics(new Metrics()));
-        final MockProcessorContext context = new MockProcessorContext(null, TestUtils.tempDirectory(), null, null, (RecordCollector) null, cache);
+        final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(), null, null, (RecordCollector) null, cache);
         context.setRecordContext(new ProcessorRecordContext(DEFAULT_TIMESTAMP, 0, 0, "topic"));
         cachingStore.init(context, cachingStore);
     }
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java
index 1de1002d74c51..2728aa07ea67a 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java
@@ -69,7 +69,7 @@ public void setUp() throws Exception {
         cachingStore.setFlushListener(cacheListener);
         cache = new ThreadCache("testCache", MAX_CACHE_SIZE_BYTES, new MockStreamsMetrics(new Metrics()));
         topic = "topic";
-        final MockProcessorContext context = new MockProcessorContext(null, TestUtils.tempDirectory(), null, null, (RecordCollector) null, cache);
+        final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(), null, null, (RecordCollector) null, cache);
         context.setRecordContext(new ProcessorRecordContext(DEFAULT_TIMESTAMP, 0, 0, topic));
         cachingStore.init(context, cachingStore);
     }
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStoreTest.java
index 82fb83123a095..99b13479dcdda 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStoreTest.java
@@ -57,8 +57,7 @@ public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> k
                 sent.put(record.key(), record.value());
             }
         };
-        final MockProcessorContext context = new MockProcessorContext(null,
-                                                                      TestUtils.tempDirectory(),
+        final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
                                                                       Serdes.String(),
                                                                       Serdes.Long(),
                                                                       collector,
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java
index 8815c5a510e5f..442602ce91572 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java
@@ -65,8 +65,7 @@ public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> k
                 sent.put(record.key(), record.value());
             }
         };
-        final MockProcessorContext context = new MockProcessorContext(null,
-                                                                      TestUtils.tempDirectory(),
+        final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
                                                                       Serdes.String(),
                                                                       Serdes.Long(),
                                                                       collector,
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStoreTest.java
index 621feb36c247b..51f31bf392e21 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStoreTest.java
@@ -52,8 +52,7 @@ public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> k
                 sent.put(record.key(), record.value());
             }
         };
-        final MockProcessorContext context = new MockProcessorContext(null,
-                                                                      TestUtils.tempDirectory(),
+        final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
                                                                       Serdes.String(),
                                                                       Serdes.Long(),
                                                                       collector,
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStoreTest.java
index 63065129f14e1..9160a73a2f6c8 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStoreTest.java
@@ -93,8 +93,7 @@ public Sensor addSensor(String name, Sensor.RecordingLevel recordLevel, Sensor..
 
         };
 
-        final MockProcessorContext context = new MockProcessorContext(null,
-                                                                      TestUtils.tempDirectory(),
+        final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
                                                                       Serdes.String(),
                                                                       Serdes.Long(),
                                                                       new NoOpRecordCollector(),
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplierTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplierTest.java
index 3d9a56c271d6c..c51008931c084 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplierTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplierTest.java
@@ -44,8 +44,7 @@ public class RocksDBKeyValueStoreSupplierTest {
 
     private static final String STORE_NAME = "name";
     private final ThreadCache cache = new ThreadCache("test", 1024, new MockStreamsMetrics(new Metrics()));
-    private final MockProcessorContext context = new MockProcessorContext(null,
-                                                                          TestUtils.tempDirectory(),
+    private final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
                                                                           Serdes.String(),
                                                                           Serdes.String(),
                                                                           new NoOpRecordCollector(),
@@ -67,8 +66,7 @@ public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> k
                 logged.add(record);
             }
         };
-        final MockProcessorContext context = new MockProcessorContext(null,
-                                                                      TestUtils.tempDirectory(),
+        final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
                                                                       Serdes.String(),
                                                                       Serdes.String(),
                                                                       collector,
@@ -89,8 +87,7 @@ public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> k
                 logged.add(record);
             }
         };
-        final MockProcessorContext context = new MockProcessorContext(null,
-                                                                      TestUtils.tempDirectory(),
+        final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
                                                                       Serdes.String(),
                                                                       Serdes.String(),
                                                                       collector,
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSegmentedBytesStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSegmentedBytesStoreTest.java
index 7fe490c2b82f2..3763290765e85 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSegmentedBytesStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSegmentedBytesStoreTest.java
@@ -62,8 +62,7 @@ public void before() {
                                                     new SessionKeySchema());
 
         stateDir = TestUtils.tempDirectory();
-        final MockProcessorContext context = new MockProcessorContext(null,
-                                                                      stateDir,
+        final MockProcessorContext context = new MockProcessorContext(stateDir,
                                                                       Serdes.String(),
                                                                       Serdes.Long(),
                                                                       new NoOpRecordCollector(),
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplierTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplierTest.java
index 28196a2a6ef8f..6677624e59627 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplierTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplierTest.java
@@ -46,8 +46,7 @@ public class RocksDBSessionStoreSupplierTest {
 
     private static final String STORE_NAME = "name";
     private final ThreadCache cache = new ThreadCache("test", 1024, new MockStreamsMetrics(new Metrics()));
-    private final MockProcessorContext context = new MockProcessorContext(null,
-                                                                          TestUtils.tempDirectory(),
+    private final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
                                                                           Serdes.String(),
                                                                           Serdes.String(),
                                                                           new NoOpRecordCollector(),
@@ -70,8 +69,7 @@ public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> k
                 logged.add(record);
             }
         };
-        final MockProcessorContext context = new MockProcessorContext(null,
-                                                                      TestUtils.tempDirectory(),
+        final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
                                                                       Serdes.String(),
                                                                       Serdes.String(),
                                                                       collector,
@@ -92,8 +90,7 @@ public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> k
                 logged.add(record);
             }
         };
-        final MockProcessorContext context = new MockProcessorContext(null,
-                                                                      TestUtils.tempDirectory(),
+        final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
                                                                       Serdes.String(),
                                                                       Serdes.String(),
                                                                       collector,
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreTest.java
index 5a23a1cb6740c..e1801b87cc04e 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreTest.java
@@ -53,8 +53,7 @@ public void before() {
                                                  Serdes.String(),
                                                  Serdes.Long());
 
-        final MockProcessorContext context = new MockProcessorContext(null,
-                                                                      TestUtils.tempDirectory(),
+        final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
                                                                       Serdes.String(),
                                                                       Serdes.Long(),
                                                                       new NoOpRecordCollector(),
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplierTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplierTest.java
index 897ec623dc479..d9a0d4f3554fb 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplierTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplierTest.java
@@ -45,8 +45,7 @@ public class RocksDBWindowStoreSupplierTest {
     private static final String STORE_NAME = "name";
     private WindowStore<String, String> store;
     private final ThreadCache cache = new ThreadCache("test", 1024, new MockStreamsMetrics(new Metrics()));
-    private final MockProcessorContext context = new MockProcessorContext(null,
-                                                                          TestUtils.tempDirectory(),
+    private final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
                                                                           Serdes.String(),
                                                                           Serdes.String(),
                                                                           new NoOpRecordCollector(),
@@ -67,8 +66,7 @@ public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> k
                 logged.add(record);
             }
         };
-        final MockProcessorContext context = new MockProcessorContext(null,
-                                                                      TestUtils.tempDirectory(),
+        final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
                                                                       Serdes.String(),
                                                                       Serdes.String(),
                                                                       collector,
@@ -89,8 +87,7 @@ public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> k
                 logged.add(record);
             }
         };
-        final MockProcessorContext context = new MockProcessorContext(null,
-                                                                      TestUtils.tempDirectory(),
+        final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
                                                                       Serdes.String(),
                                                                       Serdes.String(),
                                                                       collector,
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java
index 79223dee81ab3..ee846f7383c10 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java
@@ -100,7 +100,7 @@ public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySeria
         };
 
         MockProcessorContext context = new MockProcessorContext(
-                null, baseDir,
+                baseDir,
                 byteArraySerde, byteArraySerde,
                 recordCollector, cache);
 
@@ -151,7 +151,7 @@ public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySeria
             };
 
             MockProcessorContext context = new MockProcessorContext(
-                    null, baseDir,
+                    baseDir,
                     byteArraySerde, byteArraySerde,
                     recordCollector, cache);
 
@@ -225,7 +225,7 @@ public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySeria
             };
 
             MockProcessorContext context = new MockProcessorContext(
-                    null, baseDir,
+                    baseDir,
                     byteArraySerde, byteArraySerde,
                     recordCollector, cache);
 
@@ -314,7 +314,7 @@ public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySeria
             };
 
             MockProcessorContext context = new MockProcessorContext(
-                    null, baseDir,
+                    baseDir,
                     byteArraySerde, byteArraySerde,
                     recordCollector, cache);
 
@@ -401,7 +401,7 @@ public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySeria
             };
 
             MockProcessorContext context = new MockProcessorContext(
-                    null, baseDir,
+                    baseDir,
                     byteArraySerde, byteArraySerde,
                     recordCollector, cache);
 
@@ -457,7 +457,7 @@ public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySeria
             };
 
             MockProcessorContext context = new MockProcessorContext(
-                null, baseDir,
+                baseDir,
                 byteArraySerde, byteArraySerde,
                 recordCollector, cache);
 
@@ -485,7 +485,7 @@ public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySeria
             };
 
             MockProcessorContext context = new MockProcessorContext(
-                    null, baseDir,
+                    baseDir,
                     byteArraySerde, byteArraySerde,
                     recordCollector, cache);
 
@@ -613,7 +613,7 @@ public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySeria
             };
 
             MockProcessorContext context = new MockProcessorContext(
-                    null, baseDir,
+                    baseDir,
                     byteArraySerde, byteArraySerde,
                     recordCollector, cache);
 
@@ -662,7 +662,7 @@ public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySeria
             };
 
             MockProcessorContext context = new MockProcessorContext(
-                    null, baseDir,
+                    baseDir,
                     byteArraySerde, byteArraySerde,
                     recordCollector, cache);
 
@@ -710,7 +710,7 @@ public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySeria
             };
 
             MockProcessorContext context = new MockProcessorContext(
-                    null, baseDir,
+                    baseDir,
                     byteArraySerde, byteArraySerde,
                     recordCollector, cache);
 
@@ -810,7 +810,7 @@ public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySeria
             };
 
             MockProcessorContext context = new MockProcessorContext(
-                    null, baseDir,
+                    baseDir,
                     byteArraySerde, byteArraySerde,
                     recordCollector, cache);
 
@@ -870,7 +870,7 @@ public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySeria
         };
 
         MockProcessorContext context = new MockProcessorContext(
-                null, baseDir,
+                baseDir,
                 byteArraySerde, byteArraySerde,
                 recordCollector, cache);
 
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/SegmentIteratorTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/SegmentIteratorTest.java
index 3d2da31be0c52..ae6fb5a7b6581 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/SegmentIteratorTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/SegmentIteratorTest.java
@@ -48,14 +48,16 @@ public boolean hasNext(final KeyValueIterator iterator) {
         }
     };
 
+    private SegmentIterator iterator = null;
+
     @Before
     public void before() {
-        final MockProcessorContext context = new MockProcessorContext(null,
-                                                                      TestUtils.tempDirectory(),
-                                                                      Serdes.String(),
-                                                                      Serdes.String(),
-                                                                      new NoOpRecordCollector(),
-                                                                      new ThreadCache("testCache", 0, new MockStreamsMetrics(new Metrics())));
+        final MockProcessorContext context = new MockProcessorContext(
+                TestUtils.tempDirectory(),
+                Serdes.String(),
+                Serdes.String(),
+                new NoOpRecordCollector(),
+                new ThreadCache("testCache", 0, new MockStreamsMetrics(new Metrics())));
         segmentOne.openDB(context);
         segmentTwo.openDB(context);
         segmentOne.put(Bytes.wrap("a".getBytes()), "1".getBytes());
@@ -67,13 +69,17 @@ public void before() {
 
     @After
     public void closeSegments() {
+        if (iterator != null) {
+            iterator.close();
+            iterator = null;
+        }
         segmentOne.close();
         segmentTwo.close();
     }
 
     @Test
     public void shouldIterateOverAllSegments() throws Exception {
-        final SegmentIterator iterator = new SegmentIterator(
+        iterator = new SegmentIterator(
                 Arrays.asList(segmentOne,
                               segmentTwo).iterator(),
                 hasNextCondition,
@@ -101,7 +107,7 @@ public void shouldIterateOverAllSegments() throws Exception {
 
     @Test
     public void shouldOnlyIterateOverSegmentsInRange() throws Exception {
-        final SegmentIterator iterator = new SegmentIterator(
+        iterator = new SegmentIterator(
                 Arrays.asList(segmentOne,
                               segmentTwo).iterator(),
                 hasNextCondition,
@@ -121,7 +127,7 @@ public void shouldOnlyIterateOverSegmentsInRange() throws Exception {
 
     @Test(expected = NoSuchElementException.class)
     public void shouldThrowNoSuchElementOnPeekNextKeyIfNoNext() throws Exception {
-        final SegmentIterator iterator = new SegmentIterator(
+        iterator = new SegmentIterator(
                 Arrays.asList(segmentOne,
                               segmentTwo).iterator(),
                 hasNextCondition,
@@ -133,7 +139,7 @@ public void shouldThrowNoSuchElementOnPeekNextKeyIfNoNext() throws Exception {
 
     @Test(expected = NoSuchElementException.class)
     public void shouldThrowNoSuchElementOnNextIfNoNext() throws Exception {
-        final SegmentIterator iterator = new SegmentIterator(
+        iterator = new SegmentIterator(
                 Arrays.asList(segmentOne,
                               segmentTwo).iterator(),
                 hasNextCondition,
@@ -146,5 +152,4 @@ public void shouldThrowNoSuchElementOnNextIfNoNext() throws Exception {
     private KeyValue<String, String> toStringKeyValue(final KeyValue<Bytes, byte[]> binaryKv) {
         return KeyValue.pair(new String(binaryKv.key.get()), new String(binaryKv.value));
     }
-
 }
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/SegmentsTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/SegmentsTest.java
index 47207ec149521..9e34e63062be7 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/SegmentsTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/SegmentsTest.java
@@ -43,8 +43,7 @@ public class SegmentsTest {
 
     @Before
     public void createContext() {
-        context = new MockProcessorContext(null,
-                                           TestUtils.tempDirectory(),
+        context = new MockProcessorContext(TestUtils.tempDirectory(),
                                            Serdes.String(),
                                            Serdes.Long(),
                                            new NoOpRecordCollector(),
diff --git a/streams/src/test/java/org/apache/kafka/test/KStreamTestDriver.java b/streams/src/test/java/org/apache/kafka/test/KStreamTestDriver.java
index d51384c12bc72..207705c89e45d 100644
--- a/streams/src/test/java/org/apache/kafka/test/KStreamTestDriver.java
+++ b/streams/src/test/java/org/apache/kafka/test/KStreamTestDriver.java
@@ -42,14 +42,11 @@
 
 public class KStreamTestDriver {
 
+    private static final long DEFAULT_CACHE_SIZE_BYTES = 1 * 1024 * 1024L;
+
     private final ProcessorTopology topology;
     private final MockProcessorContext context;
     private final ProcessorTopology globalTopology;
-    private ThreadCache cache;
-    private static final long DEFAULT_CACHE_SIZE_BYTES = 1 * 1024 * 1024L;
-    public final File stateDir;
-
-    private ProcessorNode currNode;
 
     public KStreamTestDriver(KStreamBuilder builder) {
         this(builder, null, Serdes.ByteArray(), Serdes.ByteArray());
@@ -78,9 +75,8 @@ public KStreamTestDriver(KStreamBuilder builder,
         builder.setApplicationId("TestDriver");
         this.topology = builder.build(null);
         this.globalTopology = builder.buildGlobalStateTopology();
-        this.stateDir = stateDir;
-        this.cache = new ThreadCache("testCache", cacheSize, new MockStreamsMetrics(new Metrics()));
-        this.context = new MockProcessorContext(this, stateDir, keySerde, valSerde, new MockRecordCollector(), cache);
+        ThreadCache cache = new ThreadCache("testCache", cacheSize, new MockStreamsMetrics(new Metrics()));
+        this.context = new MockProcessorContext(stateDir, keySerde, valSerde, new MockRecordCollector(), cache);
         this.context.setRecordContext(new ProcessorRecordContext(0, 0, 0, "topic"));
         // init global topology first as it will add stores to the
         // store map that are required for joins etc.
@@ -88,7 +84,6 @@ public KStreamTestDriver(KStreamBuilder builder,
             initTopology(globalTopology, globalTopology.globalStateStores());
         }
         initTopology(topology, topology.stateStores());
-
     }
 
     private void initTopology(final ProcessorTopology topology, final List<StateStore> stores) {
@@ -106,14 +101,17 @@ private void initTopology(final ProcessorTopology topology, final List<StateStor
         }
     }
 
+    public ProcessorTopology topology() {
+        return topology;
+    }
 
     public ProcessorContext context() {
         return context;
     }
 
     public void process(String topicName, Object key, Object value) {
-        final ProcessorNode previous = currNode;
-        currNode = topology.source(topicName);
+        final ProcessorNode prevNode = context.currentNode();
+        ProcessorNode currNode = topology.source(topicName);
         if (currNode == null && globalTopology != null) {
             currNode = globalTopology.source(topicName);
         }
@@ -121,33 +119,27 @@ public void process(String topicName, Object key, Object value) {
         // if currNode is null, check if this topic is a changelog topic;
         // if yes, skip
         if (topicName.endsWith(ProcessorStateManager.STATE_CHANGELOG_TOPIC_SUFFIX)) {
-            currNode = previous;
             return;
         }
         context.setRecordContext(createRecordContext(context.timestamp()));
         context.setCurrentNode(currNode);
         try {
-            forward(key, value);
+            context.forward(key, value);
         } finally {
-            currNode = null;
-            context.setCurrentNode(null);
+            context.setCurrentNode(prevNode);
         }
     }
 
-    private ProcessorRecordContext createRecordContext(long timestamp) {
-        return new ProcessorRecordContext(timestamp, -1, -1, "topic");
-    }
-
-
     public void punctuate(long timestamp) {
+        final ProcessorNode prevNode = context.currentNode();
         for (ProcessorNode processor : topology.processors()) {
             if (processor.processor() != null) {
-                currNode = processor;
+                context.setRecordContext(createRecordContext(timestamp));
+                context.setCurrentNode(processor);
                 try {
-                    context.setRecordContext(createRecordContext(timestamp));
                     processor.processor().punctuate(timestamp);
                 } finally {
-                    currNode = null;
+                    context.setCurrentNode(prevNode);
                 }
             }
         }
@@ -157,59 +149,18 @@ public void setTime(long timestamp) {
         context.setTime(timestamp);
     }
 
-    @SuppressWarnings("unchecked")
-    public <K, V> void forward(K key, V value) {
-        ProcessorNode thisNode = currNode;
-        for (ProcessorNode childNode : (List<ProcessorNode<K, V>>) currNode.children()) {
-            currNode = childNode;
-            try {
-                childNode.process(key, value);
-            } finally {
-                currNode = thisNode;
-            }
-        }
-    }
-
-    @SuppressWarnings("unchecked")
-    public <K, V> void forward(K key, V value, int childIndex) {
-        ProcessorNode thisNode = currNode;
-        ProcessorNode childNode = (ProcessorNode<K, V>) thisNode.children().get(childIndex);
-        currNode = childNode;
-        try {
-            childNode.process(key, value);
-        } finally {
-            currNode = thisNode;
-        }
-    }
-
-    @SuppressWarnings("unchecked")
-    public <K, V> void forward(K key, V value, String childName) {
-        ProcessorNode thisNode = currNode;
-        for (ProcessorNode childNode : (List<ProcessorNode<K, V>>) thisNode.children()) {
-            if (childNode.name().equals(childName)) {
-                currNode = childNode;
-                try {
-                    childNode.process(key, value);
-                } finally {
-                    currNode = thisNode;
-                }
-                break;
-            }
-        }
-    }
-
     public void close() {
         // close all processors
         for (ProcessorNode node : topology.processors()) {
-            currNode = node;
+            context.setCurrentNode(node);
             try {
                 node.close();
             } finally {
-                currNode = null;
+                context.setCurrentNode(null);
             }
         }
 
-        flushState();
+        closeState();
     }
 
     public Set<String> allProcessorNames() {
@@ -245,24 +196,19 @@ public void flushState() {
         }
     }
 
-    public void setCurrentNode(final ProcessorNode currentNode) {
-        currNode = currentNode;
-    }
-
-    public StateStore globalStateStore(final String storeName) {
-        if (globalTopology != null) {
-            for (final StateStore store : globalTopology.globalStateStores()) {
-                if (store.name().equals(storeName)) {
-                    return store;
-                }
-            }
+    private void closeState() {
+        for (StateStore stateStore : context.allStateStores().values()) {
+            stateStore.flush();
+            stateStore.close();
         }
-        return null;
     }
 
+    private ProcessorRecordContext createRecordContext(long timestamp) {
+        return new ProcessorRecordContext(timestamp, -1, -1, "topic");
+    }
 
     private class MockRecordCollector extends RecordCollectorImpl {
-        public MockRecordCollector() {
+        MockRecordCollector() {
             super(null, "KStreamTestDriver");
         }
 
@@ -280,12 +226,9 @@ public <K, V> void send(ProducerRecord<K, V> record, Serializer<K> keySerializer
         }
 
         @Override
-        public void flush() {
-        }
+        public void flush() {}
 
         @Override
-        public void close() {
-        }
+        public void close() {}
     }
-
 }
diff --git a/streams/src/test/java/org/apache/kafka/test/MockProcessorContext.java b/streams/src/test/java/org/apache/kafka/test/MockProcessorContext.java
index 5ae71124e3bd3..93f0f42370306 100644
--- a/streams/src/test/java/org/apache/kafka/test/MockProcessorContext.java
+++ b/streams/src/test/java/org/apache/kafka/test/MockProcessorContext.java
@@ -18,7 +18,6 @@
 package org.apache.kafka.test;
 
 import java.io.File;
-import java.util.Arrays;
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.List;
@@ -48,7 +47,6 @@
 
 public class MockProcessorContext implements InternalProcessorContext, RecordCollector.Supplier {
 
-    private final KStreamTestDriver driver;
     private final Serde<?> keySerde;
     private final Serde<?> valSerde;
     private final RecordCollector.Supplier recordCollectorSupplier;
@@ -67,34 +65,34 @@ public class MockProcessorContext implements InternalProcessorContext, RecordCol
     private ProcessorNode currentNode;
 
     public MockProcessorContext(StateSerdes<?, ?> serdes, RecordCollector collector) {
-        this(null, null, serdes.keySerde(), serdes.valueSerde(), collector, null);
+        this(null, serdes.keySerde(), serdes.valueSerde(), collector, null);
     }
 
-    public MockProcessorContext(KStreamTestDriver driver, File stateDir,
+    public MockProcessorContext(File stateDir,
                                 Serde<?> keySerde,
                                 Serde<?> valSerde,
                                 final RecordCollector collector,
                                 final ThreadCache cache) {
-        this(driver, stateDir, keySerde, valSerde,
+        this(stateDir, keySerde, valSerde,
                 new RecordCollector.Supplier() {
                     @Override
                     public RecordCollector recordCollector() {
                         return collector;
                     }
-                }, cache);
+                },
+                cache);
     }
 
-    public MockProcessorContext(KStreamTestDriver driver, File stateDir,
-                                Serde<?> keySerde,
-                                Serde<?> valSerde,
-                                RecordCollector.Supplier collectorSupplier,
+    public MockProcessorContext(final File stateDir,
+                                final Serde<?> keySerde,
+                                final Serde<?> valSerde,
+                                final RecordCollector.Supplier collectorSupplier,
                                 final ThreadCache cache) {
-        this.driver = driver;
         this.stateDir = stateDir;
         this.keySerde = keySerde;
         this.valSerde = valSerde;
         this.recordCollectorSupplier = collectorSupplier;
-        this.metrics = new Metrics(config, Arrays.asList((MetricsReporter) new JmxReporter()), time, true);
+        this.metrics = new Metrics(config, Collections.singletonList((MetricsReporter) new JmxReporter()), time, true);
         this.cache = cache;
         this.streamsMetrics = new MockStreamsMetrics(metrics);
     }
@@ -182,19 +180,45 @@ public void schedule(long interval) {
     @Override
     @SuppressWarnings("unchecked")
     public <K, V> void forward(K key, V value) {
-        driver.forward(key, value);
+        ProcessorNode thisNode = currentNode;
+        for (ProcessorNode childNode : (List<ProcessorNode<K, V>>) thisNode.children()) {
+            currentNode = childNode;
+            try {
+                childNode.process(key, value);
+            } finally {
+                currentNode = thisNode;
+            }
+        }
     }
 
     @Override
     @SuppressWarnings("unchecked")
     public <K, V> void forward(K key, V value, int childIndex) {
-        driver.forward(key, value, childIndex);
+        ProcessorNode thisNode = currentNode;
+        ProcessorNode childNode = (ProcessorNode<K, V>) thisNode.children().get(childIndex);
+        currentNode = childNode;
+        try {
+            childNode.process(key, value);
+        } finally {
+            currentNode = thisNode;
+        }
     }
 
     @Override
     @SuppressWarnings("unchecked")
     public <K, V> void forward(K key, V value, String childName) {
-        driver.forward(key, value, childName);
+        ProcessorNode thisNode = currentNode;
+        for (ProcessorNode childNode : (List<ProcessorNode<K, V>>) thisNode.children()) {
+            if (childNode.name().equals(childName)) {
+                currentNode = childNode;
+                try {
+                    childNode.process(key, value);
+                } finally {
+                    currentNode = thisNode;
+                }
+                break;
+            }
+        }
     }
 
 
@@ -268,8 +292,7 @@ public void setRecordContext(final RecordContext recordContext) {
 
     @Override
     public void setCurrentNode(final ProcessorNode currentNode) {
-        this.currentNode  = currentNode;
-        driver.setCurrentNode(currentNode);
+        this.currentNode = currentNode;
     }
 
     @Override

From 919548ba0e1d0e231008c381f824f91a8924dc6a Mon Sep 17 00:00:00 2001
From: Rajini Sivaram <rajinisivaram@googlemail.com>
Date: Wed, 18 Jan 2017 11:05:58 +0000
Subject: [PATCH 010/177] KAFKA-4568; Simplify test code for multiple SASL
 mechanisms

Remove workaround for testing multiple SASL mechanisms using
sasl.jaas.config and the new support for multiple client
modules within a JVM.

Author: Rajini Sivaram <rajinisivaram@googlemail.com>

Reviewers: Sriharsha Chintalapani <harsha@hortonworks.com>, Ismael Juma <ismael@juma.me.uk>

Closes #2373 from rajinisivaram/KAFKA-4568

(cherry picked from commit 4c492975a05e4a646f7140c560ed403c48925331)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../kafka/api/BaseProducerSendTest.scala      |  4 +-
 .../kafka/api/EndToEndAuthorizationTest.scala |  2 +-
 .../kafka/api/EndToEndClusterIdTest.scala     |  2 +-
 .../kafka/api/IntegrationTestHarness.scala    | 10 ++---
 .../kafka/api/PlaintextConsumerTest.scala     |  2 +-
 .../api/SaslEndToEndAuthorizationTest.scala   | 17 ++++-----
 .../api/SaslMultiMechanismConsumerTest.scala  |  6 +--
 .../api/SaslPlainPlaintextConsumerTest.scala  |  3 +-
 .../integration/kafka/api/SaslSetup.scala     | 37 ++++++++++++-------
 .../kafka/api/SaslTestHarness.scala           |  8 +---
 .../api/SslEndToEndAuthorizationTest.scala    |  2 +-
 .../integration/kafka/api/UserQuotaTest.scala |  3 +-
 .../integration/KafkaServerTestHarness.scala  |  3 +-
 .../unit/kafka/server/BaseRequestTest.scala   |  2 +-
 .../server/SaslApiVersionsRequestTest.scala   |  3 +-
 .../unit/kafka/utils/JaasTestUtils.scala      | 14 +++----
 16 files changed, 64 insertions(+), 54 deletions(-)

diff --git a/core/src/test/scala/integration/kafka/api/BaseProducerSendTest.scala b/core/src/test/scala/integration/kafka/api/BaseProducerSendTest.scala
index 82409bbcd88fc..9ebc7e3bf3b87 100644
--- a/core/src/test/scala/integration/kafka/api/BaseProducerSendTest.scala
+++ b/core/src/test/scala/integration/kafka/api/BaseProducerSendTest.scala
@@ -43,7 +43,7 @@ abstract class BaseProducerSendTest extends KafkaServerTestHarness {
     val numServers = 2
     overridingProps.put(KafkaConfig.NumPartitionsProp, 4.toString)
     TestUtils.createBrokerConfigs(numServers, zkConnect, false, interBrokerSecurityProtocol = Some(securityProtocol),
-      trustStoreFile = trustStoreFile, saslProperties = saslProperties).map(KafkaConfig.fromProps(_, overridingProps))
+      trustStoreFile = trustStoreFile, saslProperties = serverSaslProperties).map(KafkaConfig.fromProps(_, overridingProps))
   }
 
   private var consumer: KafkaConsumer[Array[Byte], Array[Byte]] = _
@@ -69,7 +69,7 @@ abstract class BaseProducerSendTest extends KafkaServerTestHarness {
 
   protected def createProducer(brokerList: String, retries: Int = 0, lingerMs: Long = 0, props: Option[Properties] = None): KafkaProducer[Array[Byte],Array[Byte]] = {
     val producer = TestUtils.createNewProducer(brokerList, securityProtocol = securityProtocol, trustStoreFile = trustStoreFile,
-      saslProperties = saslProperties, retries = retries, lingerMs = lingerMs, props = props)
+      saslProperties = clientSaslProperties, retries = retries, lingerMs = lingerMs, props = props)
     registerProducer(producer)
   }
 
diff --git a/core/src/test/scala/integration/kafka/api/EndToEndAuthorizationTest.scala b/core/src/test/scala/integration/kafka/api/EndToEndAuthorizationTest.scala
index 3e391d3911490..3866cc14e847a 100644
--- a/core/src/test/scala/integration/kafka/api/EndToEndAuthorizationTest.scala
+++ b/core/src/test/scala/integration/kafka/api/EndToEndAuthorizationTest.scala
@@ -169,7 +169,7 @@ abstract class EndToEndAuthorizationTest extends IntegrationTestHarness with Sas
                                 maxBlockMs = 3000L,
                                 securityProtocol = this.securityProtocol,
                                 trustStoreFile = this.trustStoreFile,
-                                saslProperties = this.saslProperties,
+                                saslProperties = this.clientSaslProperties,
                                 props = Some(producerConfig))
   }
   
diff --git a/core/src/test/scala/integration/kafka/api/EndToEndClusterIdTest.scala b/core/src/test/scala/integration/kafka/api/EndToEndClusterIdTest.scala
index 9e03e2781cf84..d885d9b2894f9 100644
--- a/core/src/test/scala/integration/kafka/api/EndToEndClusterIdTest.scala
+++ b/core/src/test/scala/integration/kafka/api/EndToEndClusterIdTest.scala
@@ -104,7 +104,7 @@ class EndToEndClusterIdTest extends KafkaServerTestHarness {
 
   override def generateConfigs() = {
     val cfgs = TestUtils.createBrokerConfigs(serverCount, zkConnect, interBrokerSecurityProtocol = Some(securityProtocol),
-      trustStoreFile = trustStoreFile, saslProperties = saslProperties)
+      trustStoreFile = trustStoreFile, saslProperties = serverSaslProperties)
     cfgs.foreach(_.putAll(serverConfig))
     cfgs.map(KafkaConfig.fromProps)
   }
diff --git a/core/src/test/scala/integration/kafka/api/IntegrationTestHarness.scala b/core/src/test/scala/integration/kafka/api/IntegrationTestHarness.scala
index ee556d71d94da..92088f8210cc0 100644
--- a/core/src/test/scala/integration/kafka/api/IntegrationTestHarness.scala
+++ b/core/src/test/scala/integration/kafka/api/IntegrationTestHarness.scala
@@ -47,15 +47,15 @@ trait IntegrationTestHarness extends KafkaServerTestHarness {
 
   override def generateConfigs() = {
     val cfgs = TestUtils.createBrokerConfigs(serverCount, zkConnect, interBrokerSecurityProtocol = Some(securityProtocol),
-      trustStoreFile = trustStoreFile, saslProperties = saslProperties)
+      trustStoreFile = trustStoreFile, saslProperties = serverSaslProperties)
     cfgs.foreach(_.putAll(serverConfig))
     cfgs.map(KafkaConfig.fromProps)
   }
 
   @Before
   override def setUp() {
-    val producerSecurityProps = TestUtils.producerSecurityConfigs(securityProtocol, trustStoreFile, saslProperties)
-    val consumerSecurityProps = TestUtils.consumerSecurityConfigs(securityProtocol, trustStoreFile, saslProperties)
+    val producerSecurityProps = TestUtils.producerSecurityConfigs(securityProtocol, trustStoreFile, clientSaslProperties)
+    val consumerSecurityProps = TestUtils.consumerSecurityConfigs(securityProtocol, trustStoreFile, clientSaslProperties)
     super.setUp()
     producerConfig.put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, classOf[org.apache.kafka.common.serialization.ByteArraySerializer])
     producerConfig.put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, classOf[org.apache.kafka.common.serialization.ByteArraySerializer])
@@ -81,7 +81,7 @@ trait IntegrationTestHarness extends KafkaServerTestHarness {
       TestUtils.createNewProducer(brokerList,
                                   securityProtocol = this.securityProtocol,
                                   trustStoreFile = this.trustStoreFile,
-                                  saslProperties = this.saslProperties,
+                                  saslProperties = this.clientSaslProperties,
                                   props = Some(producerConfig))
   }
   
@@ -89,7 +89,7 @@ trait IntegrationTestHarness extends KafkaServerTestHarness {
       TestUtils.createNewConsumer(brokerList,
                                   securityProtocol = this.securityProtocol,
                                   trustStoreFile = this.trustStoreFile,
-                                  saslProperties = this.saslProperties,
+                                  saslProperties = this.clientSaslProperties,
                                   props = Some(consumerConfig))
   }
 
diff --git a/core/src/test/scala/integration/kafka/api/PlaintextConsumerTest.scala b/core/src/test/scala/integration/kafka/api/PlaintextConsumerTest.scala
index aefe5bd15ba25..282d67cf5c741 100644
--- a/core/src/test/scala/integration/kafka/api/PlaintextConsumerTest.scala
+++ b/core/src/test/scala/integration/kafka/api/PlaintextConsumerTest.scala
@@ -528,7 +528,7 @@ class PlaintextConsumerTest extends BaseConsumerTest {
     producerProps.setProperty(ProducerConfig.COMPRESSION_TYPE_CONFIG, CompressionType.GZIP.name)
     producerProps.setProperty(ProducerConfig.LINGER_MS_CONFIG, Long.MaxValue.toString)
     val producer = TestUtils.createNewProducer(brokerList, securityProtocol = securityProtocol, trustStoreFile = trustStoreFile,
-        saslProperties = saslProperties, retries = 0, lingerMs = Long.MaxValue, props = Some(producerProps))
+        saslProperties = clientSaslProperties, retries = 0, lingerMs = Long.MaxValue, props = Some(producerProps))
     (0 until numRecords).foreach { i =>
       producer.send(new ProducerRecord(tp.topic, tp.partition, i.toLong, s"key $i".getBytes, s"value $i".getBytes))
     }
diff --git a/core/src/test/scala/integration/kafka/api/SaslEndToEndAuthorizationTest.scala b/core/src/test/scala/integration/kafka/api/SaslEndToEndAuthorizationTest.scala
index 992649a0f9eff..826eb5ce8babf 100644
--- a/core/src/test/scala/integration/kafka/api/SaslEndToEndAuthorizationTest.scala
+++ b/core/src/test/scala/integration/kafka/api/SaslEndToEndAuthorizationTest.scala
@@ -16,10 +16,9 @@
   */
 package kafka.api
 
-import java.io.File
 import java.util.Properties
 
-import kafka.utils.{JaasTestUtils,TestUtils}
+import kafka.utils.TestUtils
 import org.apache.kafka.common.protocol.SecurityProtocol
 import org.apache.kafka.common.config.SaslConfigs
 import org.apache.kafka.common.errors.GroupAuthorizationException
@@ -30,24 +29,24 @@ import scala.collection.JavaConverters._
 
 abstract class SaslEndToEndAuthorizationTest extends EndToEndAuthorizationTest {
   override protected def securityProtocol = SecurityProtocol.SASL_SSL
-  override protected val saslProperties = Some(kafkaSaslProperties(kafkaClientSaslMechanism, Some(kafkaServerSaslMechanisms)))
+  override protected val serverSaslProperties = Some(kafkaServerSaslProperties(kafkaServerSaslMechanisms, kafkaClientSaslMechanism))
+  override protected val clientSaslProperties = Some(kafkaClientSaslProperties(kafkaClientSaslMechanism))
   
   protected def kafkaClientSaslMechanism: String
   protected def kafkaServerSaslMechanisms: List[String]
   
   @Before
   override def setUp {
-    startSasl(Both, List(kafkaClientSaslMechanism), kafkaServerSaslMechanisms)
+    startSasl(Both, kafkaServerSaslMechanisms, Option(kafkaClientSaslMechanism))
     super.setUp
   }
 
   // Use JAAS configuration properties for clients so that dynamic JAAS configuration is also tested by this set of tests
-  override protected def setJaasConfiguration(mode: SaslSetupMode, serverMechanisms: List[String], clientMechanisms: List[String],
-      serverKeytabFile: Option[File] = None, clientKeytabFile: Option[File] = None) {
+  override protected def setJaasConfiguration(mode: SaslSetupMode, serverMechanisms: List[String], clientMechanism: Option[String]) {
     // create static config with client login context with credentials for JaasTestUtils 'client2'
-    super.setJaasConfiguration(mode, kafkaServerSaslMechanisms, clientMechanisms, serverKeytabFile, clientKeytabFile) 
+    super.setJaasConfiguration(mode, kafkaServerSaslMechanisms, clientMechanism)
     // set dynamic properties with credentials for JaasTestUtils 'client1'
-    val clientLoginContext = JaasTestUtils.clientLoginModule(kafkaClientSaslMechanism, clientKeytabFile)
+    val clientLoginContext = jaasClientLoginModule(kafkaClientSaslMechanism)
     producerConfig.put(SaslConfigs.SASL_JAAS_CONFIG, clientLoginContext)
     consumerConfig.put(SaslConfigs.SASL_JAAS_CONFIG, clientLoginContext)
   }
@@ -70,7 +69,7 @@ abstract class SaslEndToEndAuthorizationTest extends EndToEndAuthorizationTest {
     val consumer2 = TestUtils.createNewConsumer(brokerList,
                                                 securityProtocol = securityProtocol,
                                                 trustStoreFile = trustStoreFile,
-                                                saslProperties = saslProperties,
+                                                saslProperties = clientSaslProperties,
                                                 props = Some(consumer2Config))
     consumers += consumer2
 
diff --git a/core/src/test/scala/integration/kafka/api/SaslMultiMechanismConsumerTest.scala b/core/src/test/scala/integration/kafka/api/SaslMultiMechanismConsumerTest.scala
index 5814e9463560c..3ff133f228ac4 100644
--- a/core/src/test/scala/integration/kafka/api/SaslMultiMechanismConsumerTest.scala
+++ b/core/src/test/scala/integration/kafka/api/SaslMultiMechanismConsumerTest.scala
@@ -23,11 +23,11 @@ class SaslMultiMechanismConsumerTest extends BaseConsumerTest with SaslTestHarne
   override protected val zkSaslEnabled = true
   override protected val kafkaClientSaslMechanism = "PLAIN"
   override protected val kafkaServerSaslMechanisms = List("GSSAPI", "PLAIN")
-  override protected def allKafkaClientSaslMechanisms = List("PLAIN", "GSSAPI")
   this.serverConfig.setProperty(KafkaConfig.ZkEnableSecureAclsProp, "true")
   override protected def securityProtocol = SecurityProtocol.SASL_SSL
   override protected lazy val trustStoreFile = Some(File.createTempFile("truststore", ".jks"))
-  override protected val saslProperties = Some(kafkaSaslProperties(kafkaClientSaslMechanism, Some(kafkaServerSaslMechanisms)))
+  override protected val serverSaslProperties = Some(kafkaServerSaslProperties(kafkaServerSaslMechanisms, kafkaClientSaslMechanism))
+  override protected val clientSaslProperties = Some(kafkaClientSaslProperties(kafkaClientSaslMechanism))
 
   @Test
   def testMultipleBrokerMechanisms() {
@@ -35,7 +35,7 @@ class SaslMultiMechanismConsumerTest extends BaseConsumerTest with SaslTestHarne
     val plainSaslProducer = producers.head
     val plainSaslConsumer = consumers.head
 
-    val gssapiSaslProperties = kafkaSaslProperties("GSSAPI")
+    val gssapiSaslProperties = kafkaClientSaslProperties("GSSAPI", dynamicJaasConfig = true)
     val gssapiSaslProducer = TestUtils.createNewProducer(brokerList,
                                                          securityProtocol = this.securityProtocol,
                                                          trustStoreFile = this.trustStoreFile,
diff --git a/core/src/test/scala/integration/kafka/api/SaslPlainPlaintextConsumerTest.scala b/core/src/test/scala/integration/kafka/api/SaslPlainPlaintextConsumerTest.scala
index bdca577c0e878..125d4318ebe8b 100644
--- a/core/src/test/scala/integration/kafka/api/SaslPlainPlaintextConsumerTest.scala
+++ b/core/src/test/scala/integration/kafka/api/SaslPlainPlaintextConsumerTest.scala
@@ -23,5 +23,6 @@ class SaslPlainPlaintextConsumerTest extends BaseConsumerTest with SaslTestHarne
   this.serverConfig.setProperty(KafkaConfig.ZkEnableSecureAclsProp, "true")
   override protected def securityProtocol = SecurityProtocol.SASL_PLAINTEXT
   override protected lazy val trustStoreFile = Some(File.createTempFile("truststore", ".jks"))
-  override protected val saslProperties = Some(kafkaSaslProperties(kafkaClientSaslMechanism, Some(kafkaServerSaslMechanisms)))
+  override protected val serverSaslProperties = Some(kafkaServerSaslProperties(kafkaServerSaslMechanisms, kafkaClientSaslMechanism))
+  override protected val clientSaslProperties = Some(kafkaClientSaslProperties(kafkaClientSaslMechanism))
 }
diff --git a/core/src/test/scala/integration/kafka/api/SaslSetup.scala b/core/src/test/scala/integration/kafka/api/SaslSetup.scala
index c1e2da2cbf797..36b9d41e0584d 100644
--- a/core/src/test/scala/integration/kafka/api/SaslSetup.scala
+++ b/core/src/test/scala/integration/kafka/api/SaslSetup.scala
@@ -43,32 +43,36 @@ trait SaslSetup {
   private val workDir = TestUtils.tempDir()
   private val kdcConf = MiniKdc.createConfig
   private var kdc: MiniKdc = null
+  private var serverKeytabFile: Option[File] = null
+  private var clientKeytabFile: Option[File] = null
 
-  def startSasl(mode: SaslSetupMode = Both, kafkaServerSaslMechanisms: List[String], kafkaClientSaslMechanisms: List[String]) {
+  def startSasl(mode: SaslSetupMode = Both, kafkaServerSaslMechanisms: List[String], kafkaClientSaslMechanism: Option[String]) {
     // Important if tests leak consumers, producers or brokers
     LoginManager.closeAll()
-    val hasKerberos = mode != ZkSasl && (kafkaClientSaslMechanisms.contains("GSSAPI") || kafkaServerSaslMechanisms.contains("GSSAPI"))
+    val hasKerberos = mode != ZkSasl && (kafkaClientSaslMechanism == Some("GSSAPI") || kafkaServerSaslMechanisms.contains("GSSAPI"))
     if (hasKerberos) {
       val serverKeytabFile = TestUtils.tempFile()
       val clientKeytabFile = TestUtils.tempFile()
-      setJaasConfiguration(mode, kafkaServerSaslMechanisms, kafkaClientSaslMechanisms, Some(serverKeytabFile), Some(clientKeytabFile))
+      this.clientKeytabFile = Some(clientKeytabFile)
+      this.serverKeytabFile = Some(serverKeytabFile)
       kdc = new MiniKdc(kdcConf, workDir)
       kdc.start()
       kdc.createPrincipal(serverKeytabFile, JaasTestUtils.KafkaServerPrincipalUnqualifiedName + "/localhost")
       kdc.createPrincipal(clientKeytabFile, JaasTestUtils.KafkaClientPrincipalUnqualifiedName, JaasTestUtils.KafkaClientPrincipalUnqualifiedName2)
     } else {
-      setJaasConfiguration(mode, kafkaServerSaslMechanisms, kafkaClientSaslMechanisms)
+      this.clientKeytabFile = None
+      this.serverKeytabFile = None
     }
+    setJaasConfiguration(mode, kafkaServerSaslMechanisms, kafkaClientSaslMechanism)
     if (mode == Both || mode == ZkSasl)
       System.setProperty("zookeeper.authProvider.1", "org.apache.zookeeper.server.auth.SASLAuthenticationProvider")
   }
 
-  protected def setJaasConfiguration(mode: SaslSetupMode, kafkaServerSaslMechanisms: List[String], kafkaClientSaslMechanisms: List[String], 
-      serverKeytabFile: Option[File] = None, clientKeytabFile: Option[File] = None) {
+  protected def setJaasConfiguration(mode: SaslSetupMode, kafkaServerSaslMechanisms: List[String], kafkaClientSaslMechanism: Option[String]) {
     val jaasFile = mode match {
       case ZkSasl => JaasTestUtils.writeZkFile()
-      case KafkaSasl => JaasTestUtils.writeKafkaFile(kafkaServerSaslMechanisms, kafkaClientSaslMechanisms, serverKeytabFile, clientKeytabFile)
-      case Both => JaasTestUtils.writeZkAndKafkaFiles(kafkaServerSaslMechanisms, kafkaClientSaslMechanisms, serverKeytabFile, clientKeytabFile)
+      case KafkaSasl => JaasTestUtils.writeKafkaFile(kafkaServerSaslMechanisms, kafkaClientSaslMechanism, serverKeytabFile, clientKeytabFile)
+      case Both => JaasTestUtils.writeZkAndKafkaFiles(kafkaServerSaslMechanisms, kafkaClientSaslMechanism, serverKeytabFile, clientKeytabFile)
     }
     // This will cause a reload of the Configuration singleton when `getConfiguration` is called
     Configuration.setConfiguration(null)
@@ -85,13 +89,20 @@ trait SaslSetup {
     Configuration.setConfiguration(null)
   }
 
-  def kafkaSaslProperties(clientSaslMechanism: String, serverSaslMechanisms: Option[Seq[String]] = None) = {
+  def kafkaServerSaslProperties(serverSaslMechanisms: Seq[String], interBrokerSaslMechanism: String) = {
+    val props = new Properties
+    props.put(KafkaConfig.SaslMechanismInterBrokerProtocolProp, interBrokerSaslMechanism)
+    props.put(SaslConfigs.SASL_ENABLED_MECHANISMS, serverSaslMechanisms.mkString(","))
+    props
+  }
+
+  def kafkaClientSaslProperties(clientSaslMechanism: String, dynamicJaasConfig: Boolean = false) = {
     val props = new Properties
     props.put(SaslConfigs.SASL_MECHANISM, clientSaslMechanism)
-    serverSaslMechanisms.foreach { serverMechanisms =>
-        props.put(KafkaConfig.SaslMechanismInterBrokerProtocolProp, clientSaslMechanism)
-        props.put(SaslConfigs.SASL_ENABLED_MECHANISMS, serverMechanisms.mkString(","))
-    }
+    if (dynamicJaasConfig)
+      props.put(SaslConfigs.SASL_JAAS_CONFIG, jaasClientLoginModule(clientSaslMechanism))
     props
   }
+
+  def jaasClientLoginModule(clientSaslMechanism: String): String = JaasTestUtils.clientLoginModule(clientSaslMechanism, clientKeytabFile)
 }
diff --git a/core/src/test/scala/integration/kafka/api/SaslTestHarness.scala b/core/src/test/scala/integration/kafka/api/SaslTestHarness.scala
index 8fd3eb4422e0e..97faa36e7fa2c 100644
--- a/core/src/test/scala/integration/kafka/api/SaslTestHarness.scala
+++ b/core/src/test/scala/integration/kafka/api/SaslTestHarness.scala
@@ -20,16 +20,12 @@ trait SaslTestHarness extends ZooKeeperTestHarness with SaslSetup {
   protected val kafkaClientSaslMechanism = "GSSAPI"
   protected val kafkaServerSaslMechanisms = List(kafkaClientSaslMechanism)
 
-  // Override this list to enable client login modules for multiple mechanisms for testing
-  // of multi-mechanism brokers with clients using different mechanisms in a single JVM
-  protected def allKafkaClientSaslMechanisms = List(kafkaClientSaslMechanism)
-
   @Before
   override def setUp() {
     if (zkSaslEnabled)
-      startSasl(Both, kafkaServerSaslMechanisms, allKafkaClientSaslMechanisms)
+      startSasl(Both, kafkaServerSaslMechanisms, Some(kafkaClientSaslMechanism))
     else
-      startSasl(KafkaSasl, kafkaServerSaslMechanisms, allKafkaClientSaslMechanisms)
+      startSasl(KafkaSasl, kafkaServerSaslMechanisms, Some(kafkaClientSaslMechanism))
     super.setUp
   }
 
diff --git a/core/src/test/scala/integration/kafka/api/SslEndToEndAuthorizationTest.scala b/core/src/test/scala/integration/kafka/api/SslEndToEndAuthorizationTest.scala
index 365c0ba5b5886..064e783508130 100644
--- a/core/src/test/scala/integration/kafka/api/SslEndToEndAuthorizationTest.scala
+++ b/core/src/test/scala/integration/kafka/api/SslEndToEndAuthorizationTest.scala
@@ -29,7 +29,7 @@ class SslEndToEndAuthorizationTest extends EndToEndAuthorizationTest {
 
   @Before
   override def setUp {
-    startSasl(ZkSasl, List.empty, List.empty)
+    startSasl(ZkSasl, List.empty, None)
     super.setUp
   }
 }
diff --git a/core/src/test/scala/integration/kafka/api/UserQuotaTest.scala b/core/src/test/scala/integration/kafka/api/UserQuotaTest.scala
index 4677c8ce9ab2b..c8d0a77aac146 100644
--- a/core/src/test/scala/integration/kafka/api/UserQuotaTest.scala
+++ b/core/src/test/scala/integration/kafka/api/UserQuotaTest.scala
@@ -29,7 +29,8 @@ class UserQuotaTest extends BaseQuotaTest with SaslTestHarness {
   override protected def securityProtocol = SecurityProtocol.SASL_SSL
   override protected lazy val trustStoreFile = Some(File.createTempFile("truststore", ".jks"))
   override protected val zkSaslEnabled = false
-  override protected val saslProperties = Some(kafkaSaslProperties(kafkaClientSaslMechanism, Some(kafkaServerSaslMechanisms)))
+  override protected val serverSaslProperties = Some(kafkaServerSaslProperties(kafkaServerSaslMechanisms, kafkaClientSaslMechanism))
+  override protected val clientSaslProperties = Some(kafkaClientSaslProperties(kafkaClientSaslMechanism))
 
   override val userPrincipal = JaasTestUtils.KafkaClientPrincipalUnqualifiedName2
   override val producerQuotaId = QuotaId(Some(userPrincipal), None)
diff --git a/core/src/test/scala/unit/kafka/integration/KafkaServerTestHarness.scala b/core/src/test/scala/unit/kafka/integration/KafkaServerTestHarness.scala
index 270fca2e01624..bfaff0bb343e3 100755
--- a/core/src/test/scala/unit/kafka/integration/KafkaServerTestHarness.scala
+++ b/core/src/test/scala/unit/kafka/integration/KafkaServerTestHarness.scala
@@ -75,7 +75,8 @@ trait KafkaServerTestHarness extends ZooKeeperTestHarness {
   protected def securityProtocol: SecurityProtocol = SecurityProtocol.PLAINTEXT
   protected def listenerName: ListenerName = ListenerName.forSecurityProtocol(securityProtocol)
   protected def trustStoreFile: Option[File] = None
-  protected def saslProperties: Option[Properties] = None
+  protected def serverSaslProperties: Option[Properties] = None
+  protected def clientSaslProperties: Option[Properties] = None
 
   @Before
   override def setUp() {
diff --git a/core/src/test/scala/unit/kafka/server/BaseRequestTest.scala b/core/src/test/scala/unit/kafka/server/BaseRequestTest.scala
index 3825489ddb737..b864e5d0875fb 100644
--- a/core/src/test/scala/unit/kafka/server/BaseRequestTest.scala
+++ b/core/src/test/scala/unit/kafka/server/BaseRequestTest.scala
@@ -42,7 +42,7 @@ abstract class BaseRequestTest extends KafkaServerTestHarness {
     val props = TestUtils.createBrokerConfigs(numBrokers, zkConnect,
       enableControlledShutdown = false, enableDeleteTopic = true,
       interBrokerSecurityProtocol = Some(securityProtocol),
-      trustStoreFile = trustStoreFile, saslProperties = saslProperties)
+      trustStoreFile = trustStoreFile, saslProperties = serverSaslProperties)
     props.foreach(propertyOverrides)
     props.map(KafkaConfig.fromProps)
   }
diff --git a/core/src/test/scala/unit/kafka/server/SaslApiVersionsRequestTest.scala b/core/src/test/scala/unit/kafka/server/SaslApiVersionsRequestTest.scala
index 34d7d147c1cb7..07e03e3824ef9 100644
--- a/core/src/test/scala/unit/kafka/server/SaslApiVersionsRequestTest.scala
+++ b/core/src/test/scala/unit/kafka/server/SaslApiVersionsRequestTest.scala
@@ -33,7 +33,8 @@ class SaslApiVersionsRequestTest extends BaseRequestTest with SaslTestHarness {
   override protected def securityProtocol = SecurityProtocol.SASL_PLAINTEXT
   override protected val kafkaClientSaslMechanism = "PLAIN"
   override protected val kafkaServerSaslMechanisms = List("PLAIN")
-  override protected val saslProperties = Some(kafkaSaslProperties(kafkaClientSaslMechanism, Some(kafkaServerSaslMechanisms)))
+  override protected val serverSaslProperties = Some(kafkaServerSaslProperties(kafkaServerSaslMechanisms, kafkaClientSaslMechanism))
+  override protected val clientSaslProperties = Some(kafkaClientSaslProperties(kafkaClientSaslMechanism))
   override protected val zkSaslEnabled = false
   override def numBrokers = 1
 
diff --git a/core/src/test/scala/unit/kafka/utils/JaasTestUtils.scala b/core/src/test/scala/unit/kafka/utils/JaasTestUtils.scala
index 7055b7e2b835b..0949eb793b4e5 100644
--- a/core/src/test/scala/unit/kafka/utils/JaasTestUtils.scala
+++ b/core/src/test/scala/unit/kafka/utils/JaasTestUtils.scala
@@ -128,16 +128,16 @@ object JaasTestUtils {
     jaasFile.getCanonicalPath
   }
 
-  def writeKafkaFile(kafkaServerSaslMechanisms: List[String], kafkaClientSaslMechanisms: List[String], serverKeyTabLocation: Option[File], clientKeyTabLocation: Option[File]): String = {
+  def writeKafkaFile(kafkaServerSaslMechanisms: List[String], kafkaClientSaslMechanism: Option[String], serverKeyTabLocation: Option[File], clientKeyTabLocation: Option[File]): String = {
     val jaasFile = TestUtils.tempFile()
-    val kafkaSections = Seq(kafkaServerSection(kafkaServerSaslMechanisms, serverKeyTabLocation), kafkaClientSection(kafkaClientSaslMechanisms, clientKeyTabLocation))
+    val kafkaSections = Seq(kafkaServerSection(kafkaServerSaslMechanisms, serverKeyTabLocation), kafkaClientSection(kafkaClientSaslMechanism, clientKeyTabLocation))
     writeToFile(jaasFile, kafkaSections)
     jaasFile.getCanonicalPath
   }
 
-  def writeZkAndKafkaFiles(kafkaServerSaslMechanisms: List[String], kafkaClientSaslMechanisms: List[String], serverKeyTabLocation: Option[File], clientKeyTabLocation: Option[File]): String = {
+  def writeZkAndKafkaFiles(kafkaServerSaslMechanisms: List[String], kafkaClientSaslMechanism: Option[String], serverKeyTabLocation: Option[File], clientKeyTabLocation: Option[File]): String = {
     val jaasFile = TestUtils.tempFile()
-    val kafkaSections = Seq(kafkaServerSection(kafkaServerSaslMechanisms, serverKeyTabLocation), kafkaClientSection(kafkaClientSaslMechanisms, clientKeyTabLocation))
+    val kafkaSections = Seq(kafkaServerSection(kafkaServerSaslMechanisms, serverKeyTabLocation), kafkaClientSection(kafkaClientSaslMechanism, clientKeyTabLocation))
     writeToFile(jaasFile, kafkaSections ++ zkSections)
     jaasFile.getCanonicalPath
   }
@@ -209,9 +209,9 @@ object JaasTestUtils {
   /*
    * Used for the static JAAS configuration and it uses the credentials for client#2
    */
-  private def kafkaClientSection(mechanisms: List[String], keytabLocation: Option[File]): JaasSection = {
-    new JaasSection(KafkaClientContextName, mechanisms.map(m => 
-      kafkaClientModule(m, keytabLocation, KafkaClientPrincipal2, KafkaPlainUser2, KafkaPlainPassword2, KafkaScramUser2, KafkaScramPassword2)))
+  private def kafkaClientSection(mechanism: Option[String], keytabLocation: Option[File]): JaasSection = {
+    new JaasSection(KafkaClientContextName, mechanism.map(m =>
+      kafkaClientModule(m, keytabLocation, KafkaClientPrincipal2, KafkaPlainUser2, KafkaPlainPassword2, KafkaScramUser2, KafkaScramPassword2)).toSeq)
   }
 
   private def jaasSectionsToString(jaasSections: Seq[JaasSection]): String =

From 9b751f0c54e0409380632c4ee4618d78daca87d5 Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Wed, 18 Jan 2017 15:17:05 +0000
Subject: [PATCH 011/177] MINOR: Fix javadoc typos in KStream#process

interface for `Processor` in comments incorrectly had `transform` rather than `process`.

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Michael G. Noll, Ismael Juma <ismael@juma.me.uk>

Closes #2396 from dguy/minor-javadoc

(cherry picked from commit ccb183f9fca20a37b9b39761dedcd197e3cf2033)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../main/java/org/apache/kafka/streams/kstream/KStream.java   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
index 8bc54e2256ab7..3e95e7cec0d26 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
@@ -706,7 +706,7 @@ <VR> KStream<K, VR> transformValues(final ValueTransformerSupplier<? super V, ?
      * {@link org.apache.kafka.streams.processor.Processor Processor} (provided by the given {@link ProcessorSupplier}).
      * This is a stateful record-by-record operation (cf. {@link #foreach(ForeachAction)}).
      * Furthermore, via {@link org.apache.kafka.streams.processor.Processor#punctuate(long) Processor.punctuate(long)}
-     * the processing progress can be observed and additional periodic actions get be performed.
+     * the processing progress can be observed and additional periodic actions can be performed.
      * Note that this is a terminal operation that returns void.
      * <p>
      * In order to assign a state, the state must be created and registered beforehand:
@@ -739,7 +739,7 @@ <VR> KStream<K, VR> transformValues(final ValueTransformerSupplier<? super V, ?
      *                 context.schedule(1000); // call #punctuate() each 1000ms
      *             }
      *
-     *             void transform(K key, V value) {
+     *             void process(K key, V value) {
      *                 // can access this.state
      *             }
      *

From 638a82b7bbf5b375f951e5827983753e9771dda0 Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Wed, 18 Jan 2017 09:19:06 -0800
Subject: [PATCH 012/177] HOTFIX: ChangeLoggingKeyValueStore.name() returns
 null

This class doesn't need to override this method as it is handled appropriately by the super class

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2397 from dguy/hotfix-npe-state-store

(cherry picked from commit 961ebca57fdd4f8f84df8cf26a835f07ea1718c9)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../state/internals/ChangeLoggingKeyValueStore.java        | 7 +------
 .../state/internals/ChangeLoggingKeyValueStoreTest.java    | 5 +++++
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStore.java
index 11cf8022d8bb3..cd63d1ab30b75 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStore.java
@@ -48,12 +48,7 @@ private ChangeLoggingKeyValueStore(final ChangeLoggingKeyValueBytesStore bytesSt
         this.keySerde = keySerde;
         this.valueSerde = valueSerde;
     }
-
-    @Override
-    public String name() {
-        return null;
-    }
-
+    
     @SuppressWarnings("unchecked")
     @Override
     public void init(final ProcessorContext context, final StateStore root) {
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java
index 442602ce91572..2dc2017fd4862 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java
@@ -200,6 +200,11 @@ public void shouldReturnNullOnGetWhenDoesntExist() throws Exception {
         assertThat(store.get(hello), is(nullValue()));
     }
 
+    @Test
+    public void shouldReturnInnerStoreName() throws Exception {
+        assertThat(store.name(), equalTo("kv"));
+    }
+
     private String deserializedValueFromInner(final String key) {
         return valueSerde.deserializer().deserialize("blah", inner.get(Bytes.wrap(key.getBytes())));
     }

From dbca4a3b60d6039558c6fec99c86400c2131f9e8 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Wed, 18 Jan 2017 11:55:23 -0800
Subject: [PATCH 013/177] MINOR: refactor streams system test class hierachy

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Eno Thereska, Guozhang Wang

Closes #2392 from mjsax/minor-system-test-rework

(cherry picked from commit d8a77560c2fa2c209353e3ba2366ad3d4cfdf22c)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../kafka/streams/perf/SimpleBenchmark.java   |   2 +-
 .../performance/streams_performance.py        | 112 ++----------------
 tests/kafkatest/services/streams.py           |  54 +++++----
 .../streams/streams_shutdown_deadlock_test.py |   3 +-
 4 files changed, 43 insertions(+), 128 deletions(-)

diff --git a/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java b/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java
index 7ba61613d43cb..db3752db46961 100644
--- a/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java
+++ b/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java
@@ -111,7 +111,7 @@ public static void main(String[] args) throws Exception {
         rocksdbDir.mkdir();
 
         // Note: this output is needed for automated tests and must not be removed
-        System.out.println("SimpleBenchmark instance started");
+        System.out.println("StreamsTest instance started");
         System.out.println("kafka=" + kafka);
         System.out.println("zookeeper=" + zookeeper);
         System.out.println("stateDir=" + stateDir);
diff --git a/tests/kafkatest/services/performance/streams_performance.py b/tests/kafkatest/services/performance/streams_performance.py
index 0af13f9b349ca..e9fa2a79acd40 100644
--- a/tests/kafkatest/services/performance/streams_performance.py
+++ b/tests/kafkatest/services/performance/streams_performance.py
@@ -13,115 +13,17 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import os.path
-import signal
+from kafkatest.services.streams import StreamsTestBaseService
 
-from ducktape.services.service import Service
-from ducktape.utils.util import wait_until
-
-from kafkatest.directory_layout.kafka_path import KafkaPathResolverMixin
 
 #
 # Class used to start the simple Kafka Streams benchmark
 #
-class StreamsSimpleBenchmarkService(KafkaPathResolverMixin, Service):
+class StreamsSimpleBenchmarkService(StreamsTestBaseService):
     """Base class for simple Kafka Streams benchmark"""
 
-    PERSISTENT_ROOT = "/mnt/streams"
-    # The log file contains normal log4j logs written using a file appender. stdout and stderr are handled separately
-    LOG_FILE = os.path.join(PERSISTENT_ROOT, "streams.log")
-    STDOUT_FILE = os.path.join(PERSISTENT_ROOT, "streams.stdout")
-    STDERR_FILE = os.path.join(PERSISTENT_ROOT, "streams.stderr")
-    LOG4J_CONFIG_FILE = os.path.join(PERSISTENT_ROOT, "tools-log4j.properties")
-    PID_FILE = os.path.join(PERSISTENT_ROOT, "streams.pid")
-
-    logs = {
-        "streams_log": {
-            "path": LOG_FILE,
-            "collect_default": True},
-        "streams_stdout": {
-            "path": STDOUT_FILE,
-            "collect_default": True},
-        "streams_stderr": {
-            "path": STDERR_FILE,
-            "collect_default": True},
-    }
-
-    def __init__(self, context, kafka, numrecs):
-        super(StreamsSimpleBenchmarkService, self).__init__(context, 1)
-        self.kafka = kafka
-        self.numrecs = numrecs
-
-    @property
-    def node(self):
-        return self.nodes[0]
-
-    def pids(self, node):
-        try:
-            return [pid for pid in node.account.ssh_capture("cat " + self.PID_FILE, callback=int)]
-        except:
-            return []
-
-    def stop_node(self, node, clean_shutdown=True):
-        self.logger.info((clean_shutdown and "Cleanly" or "Forcibly") + " stopping SimpleBenchmark on " + str(node.account))
-        pids = self.pids(node)
-        sig = signal.SIGTERM if clean_shutdown else signal.SIGKILL
-
-        for pid in pids:
-            node.account.signal(pid, sig, allow_fail=True)
-        if clean_shutdown:
-            for pid in pids:
-                wait_until(lambda: not node.account.alive(pid), timeout_sec=60, err_msg="SimpleBenchmark process on " + str(node.account) + " took too long to exit")
-
-        node.account.ssh("rm -f " + self.PID_FILE, allow_fail=False)
-
-    def wait(self):
-        for node in self.nodes:
-            for pid in self.pids(node):
-                wait_until(lambda: not node.account.alive(pid), timeout_sec=600, backoff_sec=1, err_msg="SimpleBenchmark process on " + str(node.account) + " took too long to exit")
-
-    def clean_node(self, node):
-        node.account.kill_process("streams", clean_shutdown=False, allow_fail=True)
-        node.account.ssh("rm -rf " + self.PERSISTENT_ROOT, allow_fail=False)
-
-    def start_cmd(self, node):
-        args = {}
-        args['kafka'] = self.kafka.bootstrap_servers()
-        args['zk'] = self.kafka.zk.connect_setting()
-        args['state_dir'] = self.PERSISTENT_ROOT
-        args['numrecs'] = self.numrecs
-        args['stdout'] = self.STDOUT_FILE
-        args['stderr'] = self.STDERR_FILE
-        args['pidfile'] = self.PID_FILE
-        args['log4j'] = self.LOG4J_CONFIG_FILE
-        args['kafka_run_class'] = self.path.script("kafka-run-class.sh", node)
-
-        cmd = "( export KAFKA_LOG4J_OPTS=\"-Dlog4j.configuration=file:%(log4j)s\"; " \
-              "INCLUDE_TEST_JARS=true %(kafka_run_class)s org.apache.kafka.streams.perf.SimpleBenchmark " \
-              " %(kafka)s %(zk)s %(state_dir)s %(numrecs)s " \
-              " & echo $! >&3 ) 1>> %(stdout)s 2>> %(stderr)s 3> %(pidfile)s" % args
-
-        return cmd
-
-    def start_node(self, node):
-        node.account.ssh("mkdir -p %s" % self.PERSISTENT_ROOT, allow_fail=False)
-
-        node.account.create_file(self.LOG4J_CONFIG_FILE, self.render('tools_log4j.properties', log_file=self.LOG_FILE))
-
-        self.logger.info("Starting SimpleBenchmark process on " + str(node.account))
-        results = {}
-        with node.account.monitor_log(self.STDOUT_FILE) as monitor:
-            node.account.ssh(self.start_cmd(node))
-            monitor.wait_until('SimpleBenchmark instance started', timeout_sec=15, err_msg="Never saw message indicating SimpleBenchmark finished startup on " + str(node.account))
-
-        if len(self.pids(node)) == 0:
-            raise RuntimeError("No process ids recorded")
-
-    def collect_data(self, node):
-        # Collect the data and return it to the framework
-        output = node.account.ssh_capture("grep Performance %s" % self.STDOUT_FILE)
-        data = {}
-        for line in output:
-            parts = line.split(':')
-            data[parts[0]] = float(parts[1])
-        return data
+    def __init__(self, test_context, kafka, numrecs):
+        super(StreamsSimpleBenchmarkService, self).__init__(test_context,
+                                                            kafka,
+                                                            "org.apache.kafka.streams.perf.SimpleBenchmark",
+                                                            numrecs)
diff --git a/tests/kafkatest/services/streams.py b/tests/kafkatest/services/streams.py
index 87e441470e425..9250cd7b94375 100644
--- a/tests/kafkatest/services/streams.py
+++ b/tests/kafkatest/services/streams.py
@@ -22,8 +22,8 @@
 from kafkatest.directory_layout.kafka_path import KafkaPathResolverMixin
 
 
-class StreamsSmokeTestBaseService(KafkaPathResolverMixin, Service):
-    """Base class for Streams Smoke Test services providing some common settings and functionality"""
+class StreamsTestBaseService(KafkaPathResolverMixin, Service):
+    """Base class for Streams Test services providing some common settings and functionality"""
 
     PERSISTENT_ROOT = "/mnt/streams"
     # The log file contains normal log4j logs written using a file appender. stdout and stderr are handled separately
@@ -45,10 +45,11 @@ class StreamsSmokeTestBaseService(KafkaPathResolverMixin, Service):
             "collect_default": True},
     }
 
-    def __init__(self, context, kafka, command):
-        super(StreamsSmokeTestBaseService, self).__init__(context, 1)
+    def __init__(self, test_context, kafka, streams_class_name, user_test_args):
+        super(StreamsTestBaseService, self).__init__(test_context, 1)
         self.kafka = kafka
-        self.args = {'command': command}
+        self.args = {'streams_class_name': streams_class_name,
+                     'user_test_args': user_test_args}
 
     @property
     def node(self):
@@ -65,7 +66,7 @@ def stop_nodes(self, clean_shutdown=True):
             self.stop_node(node, clean_shutdown)
 
     def stop_node(self, node, clean_shutdown=True):
-        self.logger.info((clean_shutdown and "Cleanly" or "Forcibly") + " stopping Streams Smoke Test on " + str(node.account))
+        self.logger.info((clean_shutdown and "Cleanly" or "Forcibly") + " stopping Streams Test on " + str(node.account))
         pids = self.pids(node)
         sig = signal.SIGTERM if clean_shutdown else signal.SIGKILL
 
@@ -73,7 +74,7 @@ def stop_node(self, node, clean_shutdown=True):
             node.account.signal(pid, sig, allow_fail=True)
         if clean_shutdown:
             for pid in pids:
-                wait_until(lambda: not node.account.alive(pid), timeout_sec=60, err_msg="Streams Smoke Test process on " + str(node.account) + " took too long to exit")
+                wait_until(lambda: not node.account.alive(pid), timeout_sec=60, err_msg="Streams Test process on " + str(node.account) + " took too long to exit")
 
         node.account.ssh("rm -f " + self.PID_FILE, allow_fail=False)
 
@@ -95,8 +96,11 @@ def abortThenRestart(self):
 
     def wait(self, timeout_sec=360):
         for node in self.nodes:
-            for pid in self.pids(node):
-                wait_until(lambda: not node.account.alive(pid), timeout_sec=timeout_sec, err_msg="Streams Smoke Test process on " + str(node.account) + " took too long to exit")
+            self.wait_node(node, timeout_sec)
+
+    def wait_node(self, node, timeout_sec=None):
+        for pid in self.pids(node):
+            wait_until(lambda: not node.account.alive(pid), timeout_sec=timeout_sec, err_msg="Streams Test process on " + str(node.account) + " took too long to exit")
 
     def clean_node(self, node):
         node.account.kill_process("streams", clean_shutdown=False, allow_fail=True)
@@ -105,7 +109,6 @@ def clean_node(self, node):
     def start_cmd(self, node):
         args = self.args.copy()
         args['kafka'] = self.kafka.bootstrap_servers()
-        args['zk'] = self.kafka.zk.connect_setting()
         args['state_dir'] = self.PERSISTENT_ROOT
         args['stdout'] = self.STDOUT_FILE
         args['stderr'] = self.STDERR_FILE
@@ -114,8 +117,8 @@ def start_cmd(self, node):
         args['kafka_run_class'] = self.path.script("kafka-run-class.sh", node)
 
         cmd = "( export KAFKA_LOG4J_OPTS=\"-Dlog4j.configuration=file:%(log4j)s\"; " \
-              "INCLUDE_TEST_JARS=true %(kafka_run_class)s org.apache.kafka.streams.smoketest.StreamsSmokeTest " \
-              " %(command)s %(kafka)s %(zk)s %(state_dir)s " \
+              "INCLUDE_TEST_JARS=true %(kafka_run_class)s %(streams_class_name)s " \
+              " %(kafka)s %(state_dir)s %(user_test_args)s" \
               " & echo $! >&3 ) 1>> %(stdout)s 2>> %(stderr)s 3> %(pidfile)s" % args
 
         return cmd
@@ -125,24 +128,35 @@ def start_node(self, node):
 
         node.account.create_file(self.LOG4J_CONFIG_FILE, self.render('tools_log4j.properties', log_file=self.LOG_FILE))
 
-        self.logger.info("Starting StreamsSmokeTest process on " + str(node.account))
+        self.logger.info("Starting StreamsTest process on " + str(node.account))
         with node.account.monitor_log(self.STDOUT_FILE) as monitor:
             node.account.ssh(self.start_cmd(node))
-            monitor.wait_until('StreamsSmokeTest instance started', timeout_sec=15, err_msg="Never saw message indicating StreamsSmokeTest finished startup on " + str(node.account))
+            monitor.wait_until('StreamsTest instance started', timeout_sec=60, err_msg="Never saw message indicating StreamsTest finished startup on " + str(node.account))
 
         if len(self.pids(node)) == 0:
             raise RuntimeError("No process ids recorded")
 
 
+class StreamsSmokeTestBaseService(StreamsTestBaseService):
+    """Base class for Streams Smoke Test services providing some common settings and functionality"""
+
+    def __init__(self, test_context, kafka, command):
+        super(StreamsSmokeTestBaseService, self).__init__(test_context,
+                                                          kafka,
+                                                          "org.apache.kafka.streams.smoketest.StreamsSmokeTest",
+                                                          command)
+
+
 class StreamsSmokeTestDriverService(StreamsSmokeTestBaseService):
-    def __init__(self, context, kafka):
-        super(StreamsSmokeTestDriverService, self).__init__(context, kafka, "run")
+    def __init__(self, test_context, kafka):
+        super(StreamsSmokeTestDriverService, self).__init__(test_context, kafka, "run")
 
 
 class StreamsSmokeTestJobRunnerService(StreamsSmokeTestBaseService):
-    def __init__(self, context, kafka):
-        super(StreamsSmokeTestJobRunnerService, self).__init__(context, kafka, "process")
+    def __init__(self, test_context, kafka):
+        super(StreamsSmokeTestJobRunnerService, self).__init__(test_context, kafka, "process")
+
 
 class StreamsSmokeTestShutdownDeadlockService(StreamsSmokeTestBaseService):
-    def __init__(self, context, kafka):
-        super(StreamsSmokeTestShutdownDeadlockService, self).__init__(context, kafka, "close-deadlock-test")
+    def __init__(self, test_context, kafka):
+        super(StreamsSmokeTestShutdownDeadlockService, self).__init__(test_context, kafka, "close-deadlock-test")
diff --git a/tests/kafkatest/tests/streams/streams_shutdown_deadlock_test.py b/tests/kafkatest/tests/streams/streams_shutdown_deadlock_test.py
index 5e4e7f28c683b..482da9c5d85f7 100644
--- a/tests/kafkatest/tests/streams/streams_shutdown_deadlock_test.py
+++ b/tests/kafkatest/tests/streams/streams_shutdown_deadlock_test.py
@@ -13,11 +13,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from ducktape.mark import ignore
-
 from kafkatest.tests.kafka_test import KafkaTest
 from kafkatest.services.streams import StreamsSmokeTestShutdownDeadlockService
 
+
 class StreamsShutdownDeadlockTest(KafkaTest):
     """
     Simple test of Kafka Streams.

From 866b33c16496ab654d59e69cb3e83587c52da673 Mon Sep 17 00:00:00 2001
From: "Colin P. Mccabe" <cmccabe@confluent.io>
Date: Wed, 18 Jan 2017 22:45:57 +0000
Subject: [PATCH 014/177] KAFKA-4457; Add BrokerApiVersionsCommand

Author: Colin P. Mccabe <cmccabe@confluent.io>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>, Apurva Mehta <apurva.1618@gmail.com>, Ismael Juma <ismael@juma.me.uk>

Closes #2184 from cmccabe/KAFKA-4457

(cherry picked from commit 4a6f2c6cc0647a08f016a2d712a01ec02630cf87)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 bin/kafka-broker-api-versions.sh              | 17 ++++
 .../apache/kafka/clients/NodeApiVersions.java | 34 +++++++-
 .../kafka/clients/NodeApiVersionsTest.java    |  8 +-
 .../main/scala/kafka/admin/AdminClient.scala  | 49 ++++++-----
 .../admin/BrokerApiVersionsCommand.scala      | 81 +++++++++++++++++++
 .../admin/BrokerApiVersionsCommandTest.scala  | 61 ++++++++++++++
 .../kafka/api/AdminClientTest.scala           | 19 +++++
 7 files changed, 244 insertions(+), 25 deletions(-)
 create mode 100755 bin/kafka-broker-api-versions.sh
 create mode 100644 core/src/main/scala/kafka/admin/BrokerApiVersionsCommand.scala
 create mode 100644 core/src/test/scala/integration/kafka/admin/BrokerApiVersionsCommandTest.scala

diff --git a/bin/kafka-broker-api-versions.sh b/bin/kafka-broker-api-versions.sh
new file mode 100755
index 0000000000000..4f560a0a60cd5
--- /dev/null
+++ b/bin/kafka-broker-api-versions.sh
@@ -0,0 +1,17 @@
+#!/bin/bash
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+exec $(dirname $0)/kafka-run-class.sh kafka.admin.BrokerApiVersionsCommand "$@"
diff --git a/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java b/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java
index 6acbb6318374c..b90009bd57dbe 100644
--- a/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java
+++ b/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java
@@ -21,6 +21,7 @@
 import java.util.Collection;
 import java.util.EnumMap;
 import java.util.Map;
+import java.util.NoSuchElementException;
 import java.util.TreeMap;
 
 public class NodeApiVersions {
@@ -56,10 +57,21 @@ public short usableVersion(ApiKeys apiKey) {
     }
 
     /**
+     * Convert the object to a string with no linebreaks.<p/>
+     *
      * This toString method is relatively expensive, so avoid calling it unless debug logging is turned on.
      */
     @Override
     public String toString() {
+        return toString(false);
+    }
+
+    /**
+     * Convert the object to a string.
+     *
+     * @param lineBreaks True if we should add a linebreak after each api.
+     */
+    public String toString(boolean lineBreaks) {
         // The apiVersion collection may not be in sorted order.  We put it into
         // a TreeMap before printing it out to ensure that we always print in
         // ascending order.
@@ -73,11 +85,20 @@ public String toString() {
             if (!apiKeysText.containsKey(apiKey.id)) {
                 StringBuilder bld = new StringBuilder();
                 bld.append(apiKey.name).append("(").
-                    append(apiKey.id).append("): ").append("UNSUPPORTED");
+                        append(apiKey.id).append("): ").append("UNSUPPORTED");
                 apiKeysText.put(apiKey.id, bld.toString());
             }
         }
-        return "{" + Utils.join(apiKeysText.values(), ", ") + "}";
+        String separator = lineBreaks ? ",\n\t" : ", ";
+        StringBuilder bld = new StringBuilder();
+        bld.append("(");
+        if (lineBreaks)
+            bld.append("\n\t");
+        bld.append(Utils.join(apiKeysText.values(), separator));
+        if (lineBreaks)
+            bld.append("\n");
+        bld.append(")");
+        return bld.toString();
     }
 
     private String apiVersionToText(ApiVersion apiVersion) {
@@ -106,4 +127,13 @@ private String apiVersionToText(ApiVersion apiVersion) {
         }
         return bld.toString();
     }
+
+    public ApiVersion apiVersion(ApiKeys apiKey) {
+        for (ApiVersion apiVersion : apiVersions) {
+            if (apiVersion.apiKey == apiKey.id) {
+                return apiVersion;
+            }
+        }
+        throw new NoSuchElementException();
+    }
 }
diff --git a/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java b/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java
index b39a0aa88fabd..861a28f01f958 100644
--- a/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java
@@ -36,13 +36,13 @@ public void testUnsupportedVersionsToString() {
         NodeApiVersions versions = new NodeApiVersions(
                 Collections.<ApiVersion>emptyList());
         StringBuilder bld = new StringBuilder();
-        String prefix = "{";
+        String prefix = "(";
         for (ApiKeys apiKey : ApiKeys.values()) {
             bld.append(prefix).append(apiKey.name).
                     append("(").append(apiKey.id).append("): UNSUPPORTED");
             prefix = ", ";
         }
-        bld.append("}");
+        bld.append(")");
         assertEquals(bld.toString(), versions.toString());
     }
 
@@ -59,7 +59,7 @@ public void testVersionsToString() {
         }
         NodeApiVersions versions = new NodeApiVersions(versionList);
         StringBuilder bld = new StringBuilder();
-        String prefix = "{";
+        String prefix = "(";
         for (ApiKeys apiKey : ApiKeys.values()) {
             bld.append(prefix);
             if (apiKey == ApiKeys.CONTROLLED_SHUTDOWN_KEY) {
@@ -80,7 +80,7 @@ public void testVersionsToString() {
             }
             prefix = ", ";
         }
-        bld.append("}");
+        bld.append(")");
         assertEquals(bld.toString(), versions.toString());
     }
 
diff --git a/core/src/main/scala/kafka/admin/AdminClient.scala b/core/src/main/scala/kafka/admin/AdminClient.scala
index 33089d107a9ab..680c5e16f435b 100644
--- a/core/src/main/scala/kafka/admin/AdminClient.scala
+++ b/core/src/main/scala/kafka/admin/AdminClient.scala
@@ -16,6 +16,7 @@ import java.nio.ByteBuffer
 import java.util.{Collections, Properties}
 import java.util.concurrent.atomic.AtomicInteger
 
+import org.apache.kafka.common.requests.ApiVersionsResponse.ApiVersion
 import kafka.common.KafkaException
 import kafka.coordinator.GroupOverview
 import kafka.utils.Logging
@@ -28,11 +29,11 @@ import org.apache.kafka.common.network.Selector
 import org.apache.kafka.common.protocol.{ApiKeys, Errors}
 import org.apache.kafka.common.requests._
 import org.apache.kafka.common.requests.OffsetFetchResponse
-import org.apache.kafka.common.requests.OffsetFetchResponse.PartitionData
 import org.apache.kafka.common.utils.{Time, Utils}
 import org.apache.kafka.common.{Cluster, Node, TopicPartition}
 
 import scala.collection.JavaConverters._
+import scala.util.Try
 
 class AdminClient(val time: Time,
                   val requestTimeoutMs: Int,
@@ -68,37 +69,42 @@ class AdminClient(val time: Time,
   def findCoordinator(groupId: String): Node = {
     val requestBuilder = new GroupCoordinatorRequest.Builder(groupId)
     val response = sendAnyNode(ApiKeys.GROUP_COORDINATOR, requestBuilder).asInstanceOf[GroupCoordinatorResponse]
-    Errors.forCode(response.errorCode()).maybeThrow()
-    response.node()
+    Errors.forCode(response.errorCode).maybeThrow()
+    response.node
   }
 
   def listGroups(node: Node): List[GroupOverview] = {
     val response = send(node, ApiKeys.LIST_GROUPS, new ListGroupsRequest.Builder()).asInstanceOf[ListGroupsResponse]
-    Errors.forCode(response.errorCode()).maybeThrow()
-    response.groups().asScala.map(group => GroupOverview(group.groupId(), group.protocolType())).toList
+    Errors.forCode(response.errorCode).maybeThrow()
+    response.groups.asScala.map(group => GroupOverview(group.groupId, group.protocolType)).toList
+  }
+
+  def getApiVersions(node: Node): List[ApiVersion] = {
+    val response = send(node, ApiKeys.API_VERSIONS, new ApiVersionsRequest.Builder()).asInstanceOf[ApiVersionsResponse]
+    Errors.forCode(response.errorCode).maybeThrow()
+    response.apiVersions.asScala.toList
   }
 
   private def findAllBrokers(): List[Node] = {
     val request = MetadataRequest.Builder.allTopics()
     val response = sendAnyNode(ApiKeys.METADATA, request).asInstanceOf[MetadataResponse]
-    val errors = response.errors()
+    val errors = response.errors
     if (!errors.isEmpty)
       debug(s"Metadata request contained errors: $errors")
-    response.cluster().nodes().asScala.toList
+    response.cluster.nodes.asScala.toList
   }
 
   def listAllGroups(): Map[Node, List[GroupOverview]] = {
-    findAllBrokers.map {
-      case broker =>
-        broker -> {
-          try {
-            listGroups(broker)
-          } catch {
-            case e: Exception =>
-              debug(s"Failed to find groups from broker $broker", e)
-              List[GroupOverview]()
-          }
+    findAllBrokers.map { broker =>
+      broker -> {
+        try {
+          listGroups(broker)
+        } catch {
+          case e: Exception =>
+            debug(s"Failed to find groups from broker $broker", e)
+            List[GroupOverview]()
         }
+      }
     }.toMap
   }
 
@@ -123,9 +129,14 @@ class AdminClient(val time: Time,
     if (response.hasError)
       throw response.error.exception
     response.maybeThrowFirstPartitionError
-    response.responseData().asScala.map { responseData => (responseData._1, responseData._2.offset) }.toMap
+    response.responseData.asScala.map { case (tp, partitionData) => (tp, partitionData.offset) }.toMap
   }
 
+  def listAllBrokerVersionInfo(): Map[Node, Try[NodeApiVersions]] =
+    findAllBrokers.map { broker =>
+      broker -> Try[NodeApiVersions](new NodeApiVersions(getApiVersions(broker).asJava))
+    }.toMap
+
   /**
    * Case class used to represent a consumer of a consumer group
    */
@@ -252,6 +263,6 @@ object AdminClient {
       time,
       DefaultRequestTimeoutMs,
       highLevelClient,
-      bootstrapCluster.nodes().asScala.toList)
+      bootstrapCluster.nodes.asScala.toList)
   }
 }
diff --git a/core/src/main/scala/kafka/admin/BrokerApiVersionsCommand.scala b/core/src/main/scala/kafka/admin/BrokerApiVersionsCommand.scala
new file mode 100644
index 0000000000000..812bc9ddad77b
--- /dev/null
+++ b/core/src/main/scala/kafka/admin/BrokerApiVersionsCommand.scala
@@ -0,0 +1,81 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package kafka.admin
+
+import java.io.PrintStream
+import java.util.Properties
+
+import kafka.utils.CommandLineUtils
+import org.apache.kafka.common.utils.Utils
+import org.apache.kafka.clients.CommonClientConfigs
+import joptsimple._
+
+import scala.util.{Failure, Success}
+
+/**
+ * A command for retrieving broker version information.
+ */
+object BrokerApiVersionsCommand {
+
+  def main(args: Array[String]): Unit = {
+    execute(args, System.out)
+  }
+
+  def execute(args: Array[String], out: PrintStream): Unit = {
+    val opts = new BrokerVersionCommandOptions(args)
+    val adminClient = createAdminClient(opts)
+    val brokerMap = adminClient.listAllBrokerVersionInfo()
+    brokerMap.foreach { case (broker, versionInfoOrError) =>
+      versionInfoOrError match {
+        case Success(v) => out.print(s"${broker} -> ${v.toString(true)}\n")
+        case Failure(v) => out.print(s"${broker} -> ERROR: ${v}\n")
+      }
+    }
+  }
+
+  private def createAdminClient(opts: BrokerVersionCommandOptions): AdminClient = {
+    val props = if (opts.options.has(opts.commandConfigOpt))
+      Utils.loadProps(opts.options.valueOf(opts.commandConfigOpt))
+    else
+      new Properties()
+    props.put(CommonClientConfigs.BOOTSTRAP_SERVERS_CONFIG, opts.options.valueOf(opts.bootstrapServerOpt))
+    AdminClient.create(props)
+  }
+
+  class BrokerVersionCommandOptions(args: Array[String]) {
+    val BootstrapServerDoc = "REQUIRED: The server to connect to."
+    val CommandConfigDoc = "A property file containing configs to be passed to Admin Client."
+
+    val parser = new OptionParser
+    val commandConfigOpt = parser.accepts("command-config", CommandConfigDoc)
+                                 .withRequiredArg
+                                 .describedAs("command config property file")
+                                 .ofType(classOf[String])
+    val bootstrapServerOpt = parser.accepts("bootstrap-server", BootstrapServerDoc)
+                                   .withRequiredArg
+                                   .describedAs("server(s) to use for bootstrapping")
+                                   .ofType(classOf[String])
+    val options = parser.parse(args : _*)
+    checkArgs()
+
+    def checkArgs() {
+      // check required args
+      CommandLineUtils.checkRequiredArgs(parser, options, bootstrapServerOpt)
+    }
+  }
+}
diff --git a/core/src/test/scala/integration/kafka/admin/BrokerApiVersionsCommandTest.scala b/core/src/test/scala/integration/kafka/admin/BrokerApiVersionsCommandTest.scala
new file mode 100644
index 0000000000000..ff93f22c11f25
--- /dev/null
+++ b/core/src/test/scala/integration/kafka/admin/BrokerApiVersionsCommandTest.scala
@@ -0,0 +1,61 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package kafka.admin
+
+import java.io.{ByteArrayOutputStream, PrintStream}
+import java.nio.charset.StandardCharsets
+
+import kafka.integration.KafkaServerTestHarness
+import kafka.server.KafkaConfig
+import kafka.utils.TestUtils
+import org.apache.kafka.clients.NodeApiVersions
+import org.apache.kafka.common.protocol.ApiKeys
+import org.apache.kafka.common.requests.ApiVersionsResponse
+import org.junit.Assert.{assertEquals, assertFalse, assertTrue}
+import org.junit.Test
+
+class BrokerApiVersionsCommandTest extends KafkaServerTestHarness {
+
+  def generateConfigs(): Seq[KafkaConfig] = TestUtils.createBrokerConfigs(1, zkConnect).map(KafkaConfig.fromProps)
+
+  @Test
+  def checkBrokerApiVersionCommandOutput() {
+    val byteArrayOutputStream = new ByteArrayOutputStream
+    val printStream = new PrintStream(byteArrayOutputStream)
+    BrokerApiVersionsCommand.execute(Array("--bootstrap-server", brokerList), printStream)
+    val content = new String(byteArrayOutputStream.toByteArray, StandardCharsets.UTF_8)
+    val lineIter = content.split("\n").iterator
+    assertTrue(lineIter.hasNext)
+    assertEquals(s"$brokerList (id: 0 rack: null) -> (", lineIter.next)
+    val nodeApiVersions = new NodeApiVersions(ApiVersionsResponse.API_VERSIONS_RESPONSE.apiVersions)
+    for (apiKey <- ApiKeys.values) {
+      val apiVersion = nodeApiVersions.apiVersion(apiKey)
+      val versionRangeStr =
+        if (apiVersion.minVersion == apiVersion.maxVersion) apiVersion.minVersion.toString
+        else s"${apiVersion.minVersion} to ${apiVersion.maxVersion}"
+      val terminator = if (apiKey == ApiKeys.values.last) "" else ","
+      val usableVersion = nodeApiVersions.usableVersion(apiKey)
+      val line = s"\t${apiKey.name}(${apiKey.id}): $versionRangeStr [usable: $usableVersion]$terminator"
+      assertTrue(lineIter.hasNext)
+      assertEquals(line, lineIter.next)
+    }
+    assertTrue(lineIter.hasNext)
+    assertEquals(")", lineIter.next)
+    assertFalse(lineIter.hasNext)
+  }
+}
diff --git a/core/src/test/scala/integration/kafka/api/AdminClientTest.scala b/core/src/test/scala/integration/kafka/api/AdminClientTest.scala
index a62922caaf278..1e2749f6946ca 100644
--- a/core/src/test/scala/integration/kafka/api/AdminClientTest.scala
+++ b/core/src/test/scala/integration/kafka/api/AdminClientTest.scala
@@ -24,6 +24,7 @@ import kafka.utils.{Logging, TestUtils}
 import org.apache.kafka.clients.consumer.ConsumerConfig
 import org.apache.kafka.clients.producer.ProducerConfig
 import org.apache.kafka.common.TopicPartition
+import org.apache.kafka.common.protocol.ApiKeys
 import org.junit.{Before, Test}
 import org.junit.Assert._
 
@@ -77,6 +78,24 @@ class AdminClientTest extends IntegrationTestHarness with Logging {
     assertEquals("consumer", group.protocolType)
   }
 
+  @Test
+  def testListAllBrokerVersionInfo() {
+    consumers.head.subscribe(Collections.singletonList(topic))
+    TestUtils.waitUntilTrue(() => {
+      consumers.head.poll(0)
+      !consumers.head.assignment.isEmpty
+    }, "Expected non-empty assignment")
+    val brokerVersionInfos = client.listAllBrokerVersionInfo
+    val brokers = brokerList.split(",")
+    assertEquals(brokers.size, brokerVersionInfos.size)
+    for ((node, tryBrokerVersionInfo) <- brokerVersionInfos) {
+      val hostStr = s"${node.host}:${node.port}"
+      assertTrue(s"Unknown host:port pair $hostStr in brokerVersionInfos", brokers.contains(hostStr))
+      val brokerVersionInfo = tryBrokerVersionInfo.get
+      assertEquals(0, brokerVersionInfo.usableVersion(ApiKeys.API_VERSIONS))
+    }
+  }
+
   @Test
   def testGetConsumerGroupSummary() {
     consumers.head.subscribe(Collections.singletonList(topic))

From 5562d63e8a02fdddaabe066437fe7674d28d5d01 Mon Sep 17 00:00:00 2001
From: Hojjat Jafarpour <hojjat@Hojjat-Jafarpours-MBP.local>
Date: Wed, 18 Jan 2017 15:53:17 -0800
Subject: [PATCH 015/177] KAFKA-4060; Follow-up: Throw exceptions when internal
 topics to create already exist with unexpected number of partitions

Re-branched the trunk and applied the changes to the new branch to simplify commit log.

Author: Hojjat Jafarpour <hojjat@Hojjat-Jafarpours-MBP.local>

Reviewers: Ismael Juma, Damian Guy, Eno Thereska, Guozhang Wang

Closes #2389 from hjafarpour/KAFKA-4060-Remove-ZkClient-dependency-in-Kafka-Streams-followup-from-trunk

Address Ismael's comments upon merging

(cherry picked from commit 8e2cbae8b12cd71f99f13953b744163f68021323)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../internals/InternalTopicManager.java       |  28 ++--
 .../internals/StreamsKafkaClient.java         | 104 +++++----------
 .../internals/InternalTopicManagerTest.java   | 124 ++++++++++++++++++
 .../StreamPartitionAssignorTest.java          |  25 ----
 4 files changed, 174 insertions(+), 107 deletions(-)
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java
index 8bb5a3df65314..133375fd17c71 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java
@@ -48,9 +48,13 @@ public InternalTopicManager(final StreamsKafkaClient streamsKafkaClient, final i
     }
 
     /**
-     * Prepares the set of given internal topics. If the topic with the correct number of partitions exists ignores it. For the ones with different number of
-     * partitions delete them and create new ones with correct number of partitons along with the non existing topics.
+     * Prepares a given internal topic.
+     * If the topic does not exist creates a new topic.
+     * If the topic with the correct number of partitions exists ignores it.
+     * If the topic exists already but has different number of partitions we fail and throw exception requesting user to reset the app before restarting again.
+     *
      * @param topic
+     * @param numPartitions
      */
     public void makeReady(final InternalTopicConfig topic, int numPartitions) {
 
@@ -58,11 +62,9 @@ public void makeReady(final InternalTopicConfig topic, int numPartitions) {
         topics.put(topic, numPartitions);
         for (int i = 0; i < MAX_TOPIC_READY_TRY; i++) {
             try {
-                Collection<MetadataResponse.TopicMetadata> topicMetadatas = streamsKafkaClient.fetchTopicMetadata();
-                Map<InternalTopicConfig, Integer> topicsToBeDeleted = getTopicsToBeDeleted(topics, topicMetadatas);
-                Map<InternalTopicConfig, Integer> topicsToBeCreated = filterExistingTopics(topics, topicMetadatas);
-                topicsToBeCreated.putAll(topicsToBeDeleted);
-                streamsKafkaClient.deleteTopics(topicsToBeDeleted);
+                Collection<MetadataResponse.TopicMetadata> topicsMetadata = streamsKafkaClient.fetchTopicsMetadata();
+                validateTopicPartitons(topics, topicsMetadata);
+                Map<InternalTopicConfig, Integer> topicsToBeCreated = filterExistingTopics(topics, topicsMetadata);
                 streamsKafkaClient.createTopics(topicsToBeCreated, replicationFactor, windowChangeLogAdditionalRetention);
                 return;
             } catch (StreamsException ex) {
@@ -99,24 +101,22 @@ private Map<InternalTopicConfig, Integer> filterExistingTopics(final Map<Interna
         return nonExistingTopics;
     }
 
+
     /**
-     * Return the topics that exist but have different partiton number to be deleted.
+     * Make sure the existing topics have correct number of partitions.
+     *
      * @param topicsPartitionsMap
      * @param topicsMetadata
-     * @return
      */
-    private Map<InternalTopicConfig, Integer> getTopicsToBeDeleted(final Map<InternalTopicConfig, Integer> topicsPartitionsMap, Collection<MetadataResponse.TopicMetadata> topicsMetadata) {
+    private void validateTopicPartitons(final Map<InternalTopicConfig, Integer> topicsPartitionsMap, Collection<MetadataResponse.TopicMetadata> topicsMetadata) {
         Map<String, Integer> existingTopicNamesPartitions = getExistingTopicNamesPartitions(topicsMetadata);
-        Map<InternalTopicConfig, Integer> deleteTopics = new HashMap<>();
-        // Add the topics that don't exist to the nonExistingTopics.
         for (InternalTopicConfig topic: topicsPartitionsMap.keySet()) {
             if (existingTopicNamesPartitions.get(topic.name()) != null) {
                 if (existingTopicNamesPartitions.get(topic.name()) != topicsPartitionsMap.get(topic)) {
-                    deleteTopics.put(topic, topicsPartitionsMap.get(topic));
+                    throw new StreamsException("Internal topic with invalid partitons. Use 'kafka.tools.StreamsResetter' tool to clean up invalid topics before processing.");
                 }
             }
         }
-        return deleteTopics;
     }
 
     private Map<String, Integer> getExistingTopicNamesPartitions(Collection<MetadataResponse.TopicMetadata> topicsMetadata) {
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
index f33a4e40f6430..8ea570faa5379 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
@@ -33,11 +33,8 @@
 import org.apache.kafka.common.protocol.Errors;
 import org.apache.kafka.common.requests.CreateTopicsRequest;
 import org.apache.kafka.common.requests.CreateTopicsResponse;
-import org.apache.kafka.common.requests.DeleteTopicsRequest;
-import org.apache.kafka.common.requests.DeleteTopicsResponse;
 import org.apache.kafka.common.requests.MetadataRequest;
 import org.apache.kafka.common.requests.MetadataResponse;
-import org.apache.kafka.common.requests.AbstractRequest;
 import org.apache.kafka.common.utils.SystemTime;
 import org.apache.kafka.common.utils.Time;
 import org.apache.kafka.streams.StreamsConfig;
@@ -45,14 +42,13 @@
 
 import java.io.IOException;
 import java.net.InetSocketAddress;
-import java.util.HashMap;
-import java.util.Map;
-import java.util.Set;
-import java.util.HashSet;
 import java.util.List;
+import java.util.Map;
 import java.util.LinkedHashMap;
 import java.util.Properties;
+import java.util.HashMap;
 import java.util.Collection;
+import java.util.Arrays;
 import java.util.concurrent.TimeUnit;
 
 public class StreamsKafkaClient {
@@ -125,10 +121,13 @@ public void createTopics(final Map<InternalTopicConfig, Integer> topicsMap, fina
 
             topicRequestDetails.put(internalTopicConfig.name(), topicDetails);
         }
-        final CreateTopicsRequest.Builder createTopicsRequest =
-                new CreateTopicsRequest.Builder(topicRequestDetails,
-                        streamsConfig.getInt(StreamsConfig.REQUEST_TIMEOUT_MS_CONFIG));
-        final ClientResponse clientResponse = sendRequest(createTopicsRequest);
+
+        final ClientRequest clientRequest = kafkaClient.newClientRequest(getBrokerId(), new CreateTopicsRequest.Builder(topicRequestDetails, streamsConfig.getInt(StreamsConfig.REQUEST_TIMEOUT_MS_CONFIG)), Time.SYSTEM.milliseconds(), true, null);
+        final ClientResponse clientResponse = sendRequest(clientRequest);
+
+        if (!clientResponse.hasResponse()) {
+            throw new StreamsException("Empty response for client request.");
+        }
         if (!(clientResponse.responseBody() instanceof CreateTopicsResponse)) {
             throw new StreamsException("Inconsistent response type for internal topic creation request. Expected CreateTopicsResponse but received " + clientResponse.responseBody().getClass().getName());
         }
@@ -146,51 +145,8 @@ public void createTopics(final Map<InternalTopicConfig, Integer> topicsMap, fina
         }
     }
 
-    /**
-     * Delets a set of topics.
-     *
-     * @param topics
-     */
-    public void deleteTopics(final Map<InternalTopicConfig, Integer> topics) {
-
-        final Set<String> topicNames = new HashSet<>();
-        for (InternalTopicConfig internalTopicConfig: topics.keySet()) {
-            topicNames.add(internalTopicConfig.name());
-        }
-        deleteTopics(topicNames);
-    }
-
-    /**
-     * Delete a set of topics in one request.
-     *
-     * @param topics
-     */
-    private void deleteTopics(final Set<String> topics) {
-
-        final DeleteTopicsRequest.Builder deleteTopicsRequest =
-                new DeleteTopicsRequest.Builder(topics, streamsConfig.getInt(StreamsConfig.REQUEST_TIMEOUT_MS_CONFIG));
-        final ClientResponse clientResponse = sendRequest(deleteTopicsRequest);
-        if (!(clientResponse.responseBody() instanceof DeleteTopicsResponse)) {
-            throw new StreamsException("Inconsistent response type for internal topic deletion request. Expected DeleteTopicsResponse but received " + clientResponse.responseBody().getClass().getName());
-        }
-        final DeleteTopicsResponse deleteTopicsResponse = (DeleteTopicsResponse) clientResponse.responseBody();
-        for (Map.Entry<String, Errors> entry : deleteTopicsResponse.errors().entrySet()) {
-            if (entry.getValue() != Errors.NONE) {
-                throw new StreamsException("Could not delete topic: " + entry.getKey() + " due to " + entry.getValue().message());
-            }
-        }
-
-    }
-
-    /**
-     * Send a request to kafka broker of this client. Keep polling until the corresponding response is received.
-     *
-     * @param request
-     */
-    private ClientResponse sendRequest(final AbstractRequest.Builder<?> request) {
-
+    private String getBrokerId() {
         String brokerId = null;
-
         final Metadata metadata = new Metadata(streamsConfig.getLong(StreamsConfig.RETRY_BACKOFF_MS_CONFIG), streamsConfig.getLong(StreamsConfig.METADATA_MAX_AGE_CONFIG));
         final List<InetSocketAddress> addresses = ClientUtils.parseAndValidateAddresses(streamsConfig.getList(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG));
         metadata.update(Cluster.bootstrap(addresses), Time.SYSTEM.milliseconds());
@@ -211,12 +167,11 @@ private ClientResponse sendRequest(final AbstractRequest.Builder<?> request) {
         if (brokerId == null) {
             throw new StreamsException("Could not find any available broker.");
         }
+        return brokerId;
+    }
 
-        final ClientRequest clientRequest = kafkaClient.newClientRequest(
-                brokerId, request, Time.SYSTEM.milliseconds(), true, null);
-
+    private ClientResponse sendRequest(final ClientRequest clientRequest) {
         kafkaClient.send(clientRequest, Time.SYSTEM.milliseconds());
-
         final long responseTimeout = Time.SYSTEM.milliseconds() + streamsConfig.getInt(StreamsConfig.REQUEST_TIMEOUT_MS_CONFIG);
         // Poll for the response.
         while (Time.SYSTEM.milliseconds() < responseTimeout) {
@@ -229,24 +184,27 @@ private ClientResponse sendRequest(final AbstractRequest.Builder<?> request) {
                 if (response.requestHeader().correlationId() == clientRequest.correlationId()) {
                     return response;
                 } else {
-                    throw new StreamsException("Inconsistent response received from broker " + brokerId +
-                            ", expected correlation id " + clientRequest.correlationId() + ", but received " +
+                    throw new StreamsException("Inconsistent response received from the broker " + clientRequest.destination() + ", expected correlation id " + clientRequest.correlationId() + ", but received " +
                             response.requestHeader().correlationId());
                 }
             }
         }
         throw new StreamsException("Failed to get response from broker within timeout");
+
     }
 
 
-    /**
-     * Get the metadata for a topic.
+     /**
+     * Fetch the metadata for a topic.
      * @param topic
      * @return
      */
-    public MetadataResponse.TopicMetadata getTopicMetadata(final String topic) {
-
-        final ClientResponse clientResponse = sendRequest(MetadataRequest.Builder.allTopics());
+    public MetadataResponse.TopicMetadata fetchTopicMetadata(final String topic) {
+        final ClientRequest clientRequest = kafkaClient.newClientRequest(getBrokerId(), new MetadataRequest.Builder(Arrays.asList(topic)), Time.SYSTEM.milliseconds(), true, null);
+        final ClientResponse clientResponse = sendRequest(clientRequest);
+        if (!clientResponse.hasResponse()) {
+            throw new StreamsException("Empty response for client request.");
+        }
         if (!(clientResponse.responseBody() instanceof MetadataResponse)) {
             throw new StreamsException("Inconsistent response type for internal topic metadata request. Expected MetadataResponse but received " + clientResponse.responseBody().getClass().getName());
         }
@@ -260,8 +218,18 @@ public MetadataResponse.TopicMetadata getTopicMetadata(final String topic) {
     }
 
 
-    public Collection<MetadataResponse.TopicMetadata> fetchTopicMetadata() {
-        final ClientResponse clientResponse = sendRequest(MetadataRequest.Builder.allTopics());
+    /**
+     * Fetch the metadata for all topics
+     *
+     * @return
+     */
+    public Collection<MetadataResponse.TopicMetadata> fetchTopicsMetadata() {
+
+        final ClientRequest clientRequest = kafkaClient.newClientRequest(getBrokerId(), new MetadataRequest.Builder(null), Time.SYSTEM.milliseconds(), true, null);
+        final ClientResponse clientResponse = sendRequest(clientRequest);
+        if (!clientResponse.hasResponse()) {
+            throw new StreamsException("Empty response for client request.");
+        }
         if (!(clientResponse.responseBody() instanceof MetadataResponse)) {
             throw new StreamsException("Inconsistent response type for internal topic metadata request. Expected MetadataResponse but received " + clientResponse.responseBody().getClass().getName());
         }
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java
new file mode 100644
index 0000000000000..f82809917e5a5
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java
@@ -0,0 +1,124 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.kafka.streams.processor.internals;
+
+import org.apache.kafka.common.Node;
+import org.apache.kafka.common.protocol.Errors;
+import org.apache.kafka.common.requests.MetadataResponse;
+import org.apache.kafka.streams.StreamsConfig;
+import org.apache.kafka.streams.errors.StreamsException;
+import org.apache.kafka.test.MockTimestampExtractor;
+import org.junit.Assert;
+import org.junit.Before;
+import org.junit.Test;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.Map;
+import java.util.Properties;
+import java.util.Arrays;
+import java.util.ArrayList;
+
+import static org.apache.kafka.streams.processor.internals.InternalTopicManager.WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT;
+
+public class InternalTopicManagerTest {
+
+    private String userEndPoint = "localhost:2171";
+    StreamsConfig config;
+    MockStreamKafkaClient streamsKafkaClient;
+
+    @Before
+    public void init() {
+        config = new StreamsConfig(configProps());
+        streamsKafkaClient = new MockStreamKafkaClient(config);
+    }
+
+    @Test
+    public void shouldCreateRequiredTopics() throws Exception {
+
+        streamsKafkaClient.setReturnCorrectTopic(true);
+        InternalTopicManager internalTopicManager = new InternalTopicManager(streamsKafkaClient, 1, WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT);
+        internalTopicManager.makeReady(new InternalTopicConfig("test_topic", Collections.singleton(InternalTopicConfig.CleanupPolicy.compact), null), 1);
+    }
+
+    @Test
+    public void shouldNotCreateTopicIfExistsWithDifferentPartitions() throws Exception {
+
+        streamsKafkaClient.setReturnCorrectTopic(true);
+        InternalTopicManager internalTopicManager = new InternalTopicManager(streamsKafkaClient, 1, WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT);
+        boolean exceptionWasThrown = false;
+        try {
+            internalTopicManager.makeReady(new InternalTopicConfig("test_topic", Collections.singleton(InternalTopicConfig.CleanupPolicy.compact), null), 2);
+        } catch (StreamsException e) {
+            exceptionWasThrown = true;
+        }
+        Assert.assertTrue(exceptionWasThrown);
+    }
+
+    private Properties configProps() {
+        return new Properties() {
+            {
+                setProperty(StreamsConfig.APPLICATION_ID_CONFIG, "Internal-Topic-ManagerTest");
+                setProperty(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, userEndPoint);
+                setProperty(StreamsConfig.BUFFERED_RECORDS_PER_PARTITION_CONFIG, "3");
+                setProperty(StreamsConfig.TIMESTAMP_EXTRACTOR_CLASS_CONFIG, MockTimestampExtractor.class.getName());
+            }
+        };
+    }
+
+    private class MockStreamKafkaClient extends StreamsKafkaClient {
+        public MockStreamKafkaClient(final StreamsConfig streamsConfig) {
+            super(streamsConfig);
+        }
+
+        public boolean isReturnCorrectTopic() {
+            return returnCorrectTopic;
+        }
+
+        public void setReturnCorrectTopic(boolean returnCorrectTopic) {
+            this.returnCorrectTopic = returnCorrectTopic;
+        }
+
+        boolean returnCorrectTopic = false;
+
+
+        @Override
+        public void createTopics(final Map<InternalTopicConfig, Integer> topicsMap, final int replicationFactor, final long windowChangeLogAdditionalRetention) {
+
+        }
+
+        @Override
+        public MetadataResponse.TopicMetadata fetchTopicMetadata(final String topic) {
+
+            if (returnCorrectTopic) {
+                MetadataResponse.PartitionMetadata partitionMetadata = new MetadataResponse.PartitionMetadata(Errors.NONE, 1, null, new ArrayList<Node>(), new ArrayList<Node>());
+                MetadataResponse.TopicMetadata topicMetadata = new MetadataResponse.TopicMetadata(Errors.NONE, topic, true, Arrays.asList(partitionMetadata));
+                return topicMetadata;
+            }
+            return null;
+        }
+
+        @Override
+        public Collection<MetadataResponse.TopicMetadata> fetchTopicsMetadata() {
+            if (returnCorrectTopic) {
+                return Arrays.asList(fetchTopicMetadata("test_topic"));
+            }
+            return null;
+        }
+    }
+}
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignorTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignorTest.java
index 5aa40c82733b5..c212f1412d6d7 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignorTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignorTest.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.streams.processor.internals;
 
-import org.apache.kafka.clients.consumer.MockConsumer;
 import org.apache.kafka.clients.consumer.internals.PartitionAssignor;
 import org.apache.kafka.common.Cluster;
 import org.apache.kafka.common.Node;
@@ -1062,28 +1061,4 @@ private AssignmentInfo checkAssignment(Set<String> expectedTopics, PartitionAssi
         return info;
     }
 
-    private class MockInternalTopicManager extends InternalTopicManager {
-
-        Map<String, Integer> readyTopics = new HashMap<>();
-        MockConsumer<byte[], byte[]> restoreConsumer;
-
-        MockInternalTopicManager(StreamsConfig streamsConfig, MockConsumer<byte[], byte[]> restoreConsumer) {
-            super(new StreamsKafkaClient(streamsConfig), 0, 0);
-
-            this.restoreConsumer = restoreConsumer;
-        }
-
-        @Override
-        public void makeReady(InternalTopicConfig topic, int numPartitions) {
-            readyTopics.put(topic.name(), numPartitions);
-
-            List<PartitionInfo> partitions = new ArrayList<>();
-            for (int i = 0; i < numPartitions; i++) {
-                partitions.add(new PartitionInfo(topic.name(), i, null, null, null));
-            }
-
-            restoreConsumer.updatePartitions(topic.name(), partitions);
-        }
-    }
-
 }

From ae5591a3af45832d9a50e2aaa31b11c039d8d389 Mon Sep 17 00:00:00 2001
From: Rajini Sivaram <rajinisivaram@googlemail.com>
Date: Thu, 19 Jan 2017 08:35:39 -0800
Subject: [PATCH 016/177] KAFKA-4589; SASL/SCRAM documentation

Author: Rajini Sivaram <rajinisivaram@googlemail.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>, Gwen Shapira <cshapi@gmail.com>, Sriharsha Chintalapani <harsha@hortonworks.com>, Jun Rao <junrao@gmail.com>

Closes #2369 from rajinisivaram/KAFKA-4589

(cherry picked from commit 666abafcc54f8cab64912355dba4c8ada8e44827)
Signed-off-by: Jun Rao <junrao@gmail.com>
---
 docs/security.html | 317 +++++++++++++++++++++++++++++++--------------
 1 file changed, 218 insertions(+), 99 deletions(-)

diff --git a/docs/security.html b/docs/security.html
index 8cb867eb04cee..81d5c403c134e 100644
--- a/docs/security.html
+++ b/docs/security.html
@@ -19,8 +19,12 @@
     <h3><a id="security_overview" href="#security_overview">7.1 Security Overview</a></h3>
     In release 0.9.0.0, the Kafka community added a number of features that, used either separately or together, increases security in a Kafka cluster. The following security measures are currently supported:
     <ol>
-        <li>Authentication of connections to brokers from clients (producers and consumers), other brokers and tools, using either SSL or SASL (Kerberos).
-        SASL/PLAIN can also be used from release 0.10.0.0 onwards.</li>
+        <li>Authentication of connections to brokers from clients (producers and consumers), other brokers and tools, using either SSL or SASL. Kafka supports the following SASL mechanisms:
+        <ul>
+            <li>SASL/GSSAPI (Kerberos) - starting at version 0.9.0.0</li>
+            <li>SASL/PLAIN - starting at version 0.10.0.0</li>
+            <li>SASL/SCRAM-SHA-256 and SASL/SCRAM-SHA-512 - starting at version 0.10.2.0</li>
+        </ul></li>
         <li>Authentication of connections from brokers to ZooKeeper</li>
         <li>Encryption of data transferred between brokers and clients, between brokers, or between brokers and tools using SSL (Note that there is a performance degradation when SSL is enabled, the magnitude of which depends on the CPU type and the JVM implementation.)</li>
         <li>Authorization of read / write operations by clients</li>
@@ -211,117 +215,125 @@ <h3><a id="security_ssl" href="#security_ssl">7.2 Encryption and Authentication
     <h3><a id="security_sasl" href="#security_sasl">7.3 Authentication using SASL</a></h3>
 
     <ol>
-    <li><h4><a id="security_sasl_brokerconfig"
-        href="#security_sasl_brokerconfig">SASL configuration for Kafka brokers</a></h4>
-        <ol>
-        <li>Select one or more supported mechanisms to enable in the broker. <tt>GSSAPI</tt>
-            and <tt>PLAIN</tt> are the mechanisms currently supported in Kafka.</li>
-        <li>Add a JAAS config file for the selected mechanisms as described in the examples
-            for setting up <a href="#security_sasl_kerberos_brokerconfig">GSSAPI (Kerberos)</a>
-            or <a href="#security_sasl_plain_brokerconfig">PLAIN</a>.</li>
-        <li>Pass the JAAS config file location as JVM parameter to each Kafka broker.
-            For example:
-            <pre>    -Djava.security.auth.login.config=/etc/kafka/kafka_server_jaas.conf</pre></li>
-        <li>Configure a SASL port in server.properties, by adding at least one of
-            SASL_PLAINTEXT or SASL_SSL to the <i>listeners</i> parameter, which
-            contains one or more comma-separated values:
-            <pre>    listeners=SASL_PLAINTEXT://host.name:port</pre>
-            If SASL_SSL is used, then <a href="#security_ssl">SSL must also be
-            configured</a>. If you are only configuring a SASL port (or if you want
-            the Kafka brokers to authenticate each other using SASL) then make sure
-            you set the same SASL protocol for inter-broker communication:
-            <pre>    security.inter.broker.protocol=SASL_PLAINTEXT (or SASL_SSL)</pre></li>
-        <li>Enable one or more SASL mechanisms in server.properties:
-            <pre>    sasl.enabled.mechanisms=GSSAPI (,PLAIN)</pre></li>
-        <li>Configure the SASL mechanism for inter-broker communication in server.properties
-            if using SASL for inter-broker communication:
-            <pre>    sasl.mechanism.inter.broker.protocol=GSSAPI (or PLAIN)</pre></li>
-        <li>Follow the steps in <a href="#security_sasl_kerberos_brokerconfig">GSSAPI (Kerberos)</a>
-            or <a href="#security_sasl_plain_brokerconfig">PLAIN</a> to configure SASL
-            for the enabled mechanisms. To enable multiple mechanisms in the broker, follow
-            the steps <a href="#security_sasl_multimechanism">here</a>.</li>
-        <u><a id="security_sasl_brokernotes" href="#security_sasl_brokernotes">Important notes:</a></u>
+    <li><h4><a id="security_sasl_jaasconfig" href="#security_sasl_jaasconfig">JAAS configuration</a></h4>
+    <p>Kafka uses the Java Authentication and Authorization Service
+    (<a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/jaas/JAASRefGuide.html">JAAS</a>)
+    for SASL configuration.</p>
         <ol>
-            <li><tt>KafkaServer</tt> is the section name in the JAAS file used by each
+        <li><h5><a id="security_jaas_broker"
+            href="#security_jaas_broker">JAAS configuration for Kafka brokers</a></h5>
+
+            <p><tt>KafkaServer</tt> is the section name in the JAAS file used by each
             KafkaServer/Broker. This section provides SASL configuration options
             for the broker including any SASL client connections made by the broker
-            for inter-broker communication.</li>
-            <li><tt>Client</tt> section is used to authenticate a SASL connection with
+            for inter-broker communication.</p>
+
+            <p><tt>Client</tt> section is used to authenticate a SASL connection with
             zookeeper. It also allows the brokers to set SASL ACL on zookeeper
             nodes which locks these nodes down so that only the brokers can
             modify it. It is necessary to have the same principal name across all
             brokers. If you want to use a section name other than Client, set the
             system property <tt>zookeeper.sasl.client</tt> to the appropriate
-            name (<i>e.g.</i>, <tt>-Dzookeeper.sasl.client=ZkClient</tt>).</li>
-            <li>ZooKeeper uses "zookeeper" as the service name by default. If you
+            name (<i>e.g.</i>, <tt>-Dzookeeper.sasl.client=ZkClient</tt>).</p>
+
+            <p>ZooKeeper uses "zookeeper" as the service name by default. If you
             want to change this, set the system property
             <tt>zookeeper.sasl.client.username</tt> to the appropriate name
-            (<i>e.g.</i>, <tt>-Dzookeeper.sasl.client.username=zk</tt>).</li>
-        </ol>
-        </ol>
-    </li>
-    <li><h4><a id="security_sasl_clientconfig"
-        href="#security_sasl_clientconfig">SASL configuration for Kafka clients</a></h4>
-        SASL authentication is only supported for the new Java Kafka producer and
-        consumer, the older API is not supported. JAAS configuration for clients may
-        be specified as a static JAAS config file or using the client configuration property
-        <code>sasl.jaas.config</code>.
-        To configure SASL authentication on the clients:
-        <ol>
-        <li>Select a SASL mechanism for authentication.</li>
-        <li>Configure the following properties in producer.properties or
-            consumer.properties:
-            <pre>    security.protocol=SASL_PLAINTEXT (or SASL_SSL)
-    sasl.mechanism=GSSAPI (or PLAIN)</pre></li>
-        <li>Follow the steps in <a href="#security_sasl_kerberos_clientconfig">GSSAPI (Kerberos)</a>
-            or <a href="#security_sasl_plain_clientconfig">PLAIN</a> to configure SASL
-            for the selected mechanism.</li>
-        <li>Configure JAAS using <a href="#security_client_dynamicjaas">client configuration property</a>
-            or <a href="#security_client_staticjaas">static JAAS config file</a> as described below.</li>
-        </ol>
-        <ol>
-        <li><h5><a id="security_client_dynamicjaas" href="#security_client_dynamicjaas">JAAS configuration using client configuration property</a></h5>
-            <p>Clients may specify JAAS configuration as a producer or consumer property without
-            creating a physical configuration file. This mode also enables different producers
-            and consumers within the same JVM to use different credentials by specifying
-            different properties for each client. If both static JAAS configuration system property
-            <code>java.security.auth.login.config</code> and client property <code>sasl.jaas.config</code>
-            are specified, the client property will be used.</p>
-
-            To configure SASL authentication on the clients using configuration property:
-            <ol>
-            <li>Configure the property <code>sasl.jaas.config</code> in producer.properties or
-                consumer.properties to be the JAAS login module section of the selected mechanism.
-                For example, <a href="#security_sasl_plain_clientconfig">PLAIN</a>
-                credentials may be configured as:
-                <pre>    sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required username="alice" password="alice-secret";</pre></li>
-                See <a href="#security_sasl_kerberos_clientconfig">GSSAPI (Kerberos)</a> or <a href="#security_sasl_plain_clientconfig">PLAIN</a>
-                for full example configurations.</li>
-            </ol>
-        </li>
-        <li><h5><a id="security_client_staticjaas" href="#security_client_staticjaas">JAAS configuration using static config file</a></h5>
-            To configure SASL authentication on the clients using static JAAS config file:
+            (<i>e.g.</i>, <tt>-Dzookeeper.sasl.client.username=zk</tt>).</p></li>
+
+        <li><h5><a id="security_jaas_client"
+            href="#security_jaas_client">JAAS configuration for Kafka clients</a></h5>
+
+            <p>Clients may configure JAAS using the client configuration property
+            <a href="#security_client_dynamicjaas">sasl.jaas.config</a>
+            or using the <a href="#security_client_staticjaas">static JAAS config file</a>
+            similar to brokers.</p>
+
             <ol>
-            <li>Add a JAAS config file with a client login section named <tt>KafkaClient</tt>. Configure
-                a login module in <tt>KafkaClient</tt> for the selected mechanism as described in the examples
-                for setting up <a href="#security_sasl_kerberos_clientconfig">GSSAPI (Kerberos)</a>
-                or <a href="#security_sasl_plain_clientconfig">PLAIN</a>.
-                For example, <a href="#security_sasl_gssapi_clientconfig">GSSAPI</a>
-                credentials may be configured as:
-                <pre>
-    KafkaClient {
+            <li><h6><a id="security_client_dynamicjaas"
+                href="#security_client_dynamicjaas">JAAS configuration using client configuration property</a></h6>
+                <p>Clients may specify JAAS configuration as a producer or consumer property without
+                creating a physical configuration file. This mode also enables different producers
+                and consumers within the same JVM to use different credentials by specifying
+                different properties for each client. If both static JAAS configuration system property
+                <code>java.security.auth.login.config</code> and client property <code>sasl.jaas.config</code>
+                are specified, the client property will be used.</p>
+
+                <p>See <a href="#security_sasl_kerberos_clientconfig">GSSAPI (Kerberos)</a>,
+                <a href="#security_sasl_plain_clientconfig">PLAIN</a> or
+                <a href="#security_sasl_scram_clientconfig">SCRAM</a> for example configurations.</p></li>
+
+                <li><h6><a id="security_client_staticjaas" href="#security_client_staticjaas">JAAS configuration using static config file</a></h6>
+                To configure SASL authentication on the clients using static JAAS config file:
+                <ol>
+                <li>Add a JAAS config file with a client login section named <tt>KafkaClient</tt>. Configure
+                    a login module in <tt>KafkaClient</tt> for the selected mechanism as described in the examples
+                    for setting up <a href="#security_sasl_kerberos_clientconfig">GSSAPI (Kerberos)</a>,
+                    <a href="#security_sasl_plain_clientconfig">PLAIN</a> or
+                    <a href="#security_sasl_scram_clientconfig">SCRAM</a>.
+                    For example, <a href="#security_sasl_gssapi_clientconfig">GSSAPI</a>
+                    credentials may be configured as:
+                    <pre>
+        KafkaClient {
         com.sun.security.auth.module.Krb5LoginModule required
         useKeyTab=true
         storeKey=true
         keyTab="/etc/security/keytabs/kafka_client.keytab"
         principal="kafka-client-1@EXAMPLE.COM";
     };</pre>
-                See <a href="#security_sasl_kerberos_clientconfig">GSSAPI (Kerberos)</a> or <a href="#security_sasl_plain_clientconfig">PLAIN</a>
-                for example configurations of each mechanism.</li>
-            <li>Pass the JAAS config file location as JVM parameter to each client JVM. For example:
-                <pre>    -Djava.security.auth.login.config=/etc/kafka/kafka_client_jaas.conf</pre></li>
+                </li>
+                <li>Pass the JAAS config file location as JVM parameter to each client JVM. For example:
+                    <pre>    -Djava.security.auth.login.config=/etc/kafka/kafka_client_jaas.conf</pre></li>
+	</ol>
+                </li>
+            </ol>
+            </li>
+        </ol>
+    </li>
+    <li><h4><a id="security_sasl_config"
+        href="#security_sasl_config">SASL configuration</a></h4>
+
+        <p>SASL may be used with PLAINTEXT or SSL as the transport layer using the
+        security protocol SASL_PLAINTEXT or SASL_SSL respectively. If SASL_SSL is
+        used, then <a href="#security_ssl">SSL must also be configured</a>.</p>
+
+        <ol>
+        <li><h5><a id="security_sasl_mechanism"
+            href="#security_sasl_mechanism">SASL mechanisms</a></h5>
+            Kafka supports the following SASL mechanisms:
+            <ul>
+                <li><a href="#security_sasl_kerberos">GSSAPI</a> (Kerberos)</li>
+                <li><a href="#security_sasl_plain">PLAIN</a></li>
+                <li><a href="#security_sasl_scram">SCRAM-SHA-256</a></li>
+                <li><a href="#security_sasl_scram">SCRAM-SHA-512</a></li>
+            </ul>
+        </li>
+        <li><h5><a id="security_sasl_brokerconfig"
+            href="#security_sasl_brokerconfig">SASL configuration for Kafka brokers</a></h5>
+            <ol>
+            <li>Configure a SASL port in server.properties, by adding at least one of
+                SASL_PLAINTEXT or SASL_SSL to the <i>listeners</i> parameter, which
+                contains one or more comma-separated values:
+                <pre>    listeners=SASL_PLAINTEXT://host.name:port</pre>
+                If you are only configuring a SASL port (or if you want
+                the Kafka brokers to authenticate each other using SASL) then make sure
+                you set the same SASL protocol for inter-broker communication:
+                <pre>    security.inter.broker.protocol=SASL_PLAINTEXT (or SASL_SSL)</pre></li>
+            <li>Select one or more  <a href="#security_sasl_mechanism">supported mechanisms</a>
+                to enable in the broker and follow the steps to configure SASL for the mechanism.
+                To enable multiple mechanisms in the broker, follow the steps
+                <a href="#security_sasl_multimechanism">here</a>.</li>
             </ol>
         </li>
+        <li><h5><a id="security_sasl_clientconfig"
+            href="#security_sasl_clientconfig">SASL configuration for Kafka clients</a></h5>
+            <p>SASL authentication is only supported for the new Java Kafka producer and
+            consumer, the older API is not supported.</p>
+
+            <p>To configure SASL authentication on the clients, select a SASL
+            <a href="#security_sasl_mechanism">mechanism</a> that is enabled in
+            the broker for client authentication and follow the steps to configure SASL
+            for the selected mechanism.</p></li>
         </ol>
     </li>
     <li><h4><a id="security_sasl_kerberos" href="#security_sasl_kerberos">Authentication using SASL/Kerberos</a></h4>
@@ -502,6 +514,111 @@ <h3><a id="security_sasl" href="#security_sasl">7.3 Authentication using SASL</a
         </li>
         </ol>
     </li>
+
+    <li><h4><a id="security_sasl_scram" href="#security_sasl_scram">Authentication using SASL/SCRAM</a></h4>
+        <p>Salted Challenge Response Authentication Mechanism (SCRAM) is a family of SASL mechanisms that
+        addresses the security concerns with traditional mechanisms that perform username/password authentication
+        like PLAIN and DIGEST-MD5. The mechanism is defined in <a href="https://tools.ietf.org/html/rfc5802">RFC 5802</a>.
+        Kafka supports <a href="https://tools.ietf.org/html/rfc7677">SCRAM-SHA-256</a> and SCRAM-SHA-512 which
+        can be used with TLS to perform secure authentication. The username is used as the authenticated
+        <code>Principal</code> for configuration of ACLs etc. The default SCRAM implementation in Kafka
+        stores SCRAM credentials in Zookeeper and is suitable for use in Kafka installations where Zookeeper
+        is on a private network. Refer to <a href="#security_sasl_scram_security">Security Considerations</a>
+        for more details.</p>
+        <ol>
+        <li><h5><a id="security_sasl_scram_credentials" href="#security_sasl_scram_credentials">Creating SCRAM Credentials</a></h5>
+        <p>The SCRAM implementation in Kafka uses Zookeeper as credential store. Credentials can be created in
+        Zookeeper using <tt>kafka-configs.sh</tt>. For each SCRAM mechanism enabled, credentials must be created
+        by adding a config with the mechanism name. Credentials for inter-broker communication must be created
+        before Kafka brokers are started. Client credentials may be created and updated dynamically and updated
+        credentials will be used to authenticate new connections.</p>
+        <p>Create SCRAM credentials for user <i>alice</i> with password <i>alice-secret</i>:
+        <pre>
+    bin/kafka-configs.sh --zookeeper localhost:2181 --alter --add-config 'SCRAM-SHA-256=[iterations=8192,password=alice-secret],SCRAM-SHA-512=[password=alice-secret]' --entity-type users --entity-name alice
+        </pre>
+        <p>The default iteration count of 4096 is used if iterations are not specified. A random salt is created
+        and the SCRAM identity consisting of salt, iterations, StoredKey and ServerKey are stored in Zookeeper.
+        See <a href="https://tools.ietf.org/html/rfc5802">RFC 5802</a> for details on SCRAM identity and the individual fields.
+        <p>The following examples also require a user <i>admin</i> for inter-broker communication which can be created using:
+        <pre>
+    bin/kafka-configs.sh --zookeeper localhost:2181 --alter --add-config 'SCRAM-SHA-256=[password=admin-secret],SCRAM-SHA-512=[password=admin-secret]' --entity-type users --entity-name admin
+        </pre>
+        <p>Existing credentials may be listed using the <i>--describe</i> option:
+        <pre>
+   bin/kafka-configs.sh --zookeeper localhost:2181 --describe --entity-type users --entity-name alice
+        </pre>
+        <p>Credentials may be deleted for one or more SCRAM mechanisms using the <i>--delete</i> option:
+        <pre>
+   bin/kafka-configs.sh --zookeeper localhost:2181 --alter --delete-config 'SCRAM-SHA-512' --entity-type users --entity-name alice
+        </pre>
+        </li>
+        <li><h5><a id="security_sasl_scram_brokerconfig" href="#security_sasl_scram_brokerconfig">Configuring Kafka Brokers</a></h5>
+            <ol>
+            <li>Add a suitably modified JAAS file similar to the one below to each Kafka broker's config directory, let's call it kafka_server_jaas.conf for this example:
+                <pre>
+    KafkaServer {
+        org.apache.kafka.common.security.scram.ScramLoginModule required
+        username="admin"
+        password="admin-secret"
+    };</pre>
+                The properties <tt>username</tt> and <tt>password</tt> in the <tt>KafkaServer</tt> section are used by
+                the broker to initiate connections to other brokers. In this example, <i>admin</i> is the user for
+                inter-broker communication.</li>
+            <li>Pass the JAAS config file location as JVM parameter to each Kafka broker:
+                <pre>    -Djava.security.auth.login.config=/etc/kafka/kafka_server_jaas.conf</pre></li>
+            <li>Configure SASL port and SASL mechanisms in server.properties as described <a href="#security_sasl_brokerconfig">here</a>.</pre> For example:
+                <pre>
+    listeners=SASL_SSL://host.name:port
+    security.inter.broker.protocol=SASL_SSL
+    sasl.mechanism.inter.broker.protocol=SCRAM-SHA-256 (or SCRAM-SHA-512)
+    sasl.enabled.mechanisms=SCRAM-SHA-256 (or SCRAM-SHA-512)</pre></li>
+            </ol>
+        </li>
+
+        <li><h5><a id="security_sasl_scram_clientconfig" href="#security_sasl_scram_clientconfig">Configuring Kafka Clients</a></h5>
+            To configure SASL authentication on the clients:
+            <ol>
+	    <li>Configure the JAAS configuration property for each client in producer.properties or consumer.properties.
+                The login module describes how the clients like producer and consumer can connect to the Kafka Broker.
+	        The following is an example configuration for a client for the SCRAM mechanisms:
+                <pre>
+   sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required \
+        username="alice" \
+        password="alice-secret";</pre>
+
+                <p>The options <tt>username</tt> and <tt>password</tt> are used by clients to configure
+                the user for client connections. In this example, clients connect to the broker as user <i>alice</i>.
+                Different clients within a JVM may connect as different users by specifying different user names
+                and passwords in <code>sasl.jaas.config</code>.</p>
+
+                <p>JAAS configuration for clients may alternatively be specified as a JVM parameter similar to brokers
+                as described <a href="#security_client_staticjaas">here</a>. Clients use the login section named
+                <tt>KafkaClient</tt>. This option allows only one user for all client connections from a JVM.</p></li>
+            </li>
+            <li>Configure the following properties in producer.properties or consumer.properties:
+                <pre>
+    security.protocol=SASL_SSL
+    sasl.mechanism=SCRAM-SHA-256 (or SCRAM-SHA-512)</pre></li>
+            </ol>
+        </li>
+        <li><h5><a id="security_sasl_scram_security" href="#security_sasl_scram_security">Security Considerations for SASL/SCRAM</a></h5>
+            <ul>
+            <li>The default implementation of SASL/SCRAM in Kafka stores SCRAM credentials in Zookeeper. This
+            is suitable for production use in installations where Zookeeper is secure and on a private network.</li>
+            <li>Kafka supports only the strong hash functions SHA-256 and SHA-512 with a minimum iteration count
+            of 4096. Strong hash functions combined with strong passwords and high iteration counts protect
+            against brute force attacks if Zookeeper security is compromised.</li>
+            <li>SCRAM should be used only with TLS-encryption to prevent interception of SCRAM exchanges. This
+            protects against dictionary or brute force attacks and against impersonation if Zookeeper is compromised.</li>
+            <li>The default SASL/SCRAM implementation may be overridden using custom login modules in installations
+            where Zookeeper is not secure. See <a href="#security_sasl_plain_production">here</a> for details.</li>
+            <li>For more details on security considerations, refer to
+            <a href="https://tools.ietf.org/html/rfc5802#section-9">RFC 5802</a>.
+            </ul>
+        </li>
+        </ol>
+    </li>
+
     <li><h4><a id="security_sasl_multimechanism" href="#security_sasl_multimechanism">Enabling multiple SASL mechanisms in a broker</a></h4>
         <ol>
         <li>Specify configuration for the login modules of all enabled mechanisms in the <tt>KafkaServer</tt> section of the JAAS config file. For example:
@@ -519,12 +636,14 @@ <h3><a id="security_sasl" href="#security_sasl">7.3 Authentication using SASL</a
             user_admin="admin-secret"
             user_alice="alice-secret";
         };</pre></li>
-        <li>Enable the SASL mechanisms in server.properties: <pre>    sasl.enabled.mechanisms=GSSAPI,PLAIN</pre></li>
+        <li>Enable the SASL mechanisms in server.properties: <pre>    sasl.enabled.mechanisms=GSSAPI,PLAIN,SCRAM-SHA-256,SCRAM-SHA-512</pre></li>
         <li>Specify the SASL security protocol and mechanism for inter-broker communication in server.properties if required:
-            <pre>    security.inter.broker.protocol=SASL_PLAINTEXT (or SASL_SSL)
-        sasl.mechanism.inter.broker.protocol=GSSAPI (or PLAIN)</pre></li>
-        <li>Follow the mechanism-specific steps in <a href="#security_sasl_kerberos_brokerconfig">GSSAPI (Kerberos)</a>
-            and <a href="#security_sasl_plain_brokerconfig">PLAIN</a> to configure SASL for the enabled mechanisms.</li>
+            <pre>
+    security.inter.broker.protocol=SASL_PLAINTEXT (or SASL_SSL)
+    sasl.mechanism.inter.broker.protocol=GSSAPI (or one of the other enabled mechanisms)</pre></li>
+        <li>Follow the mechanism-specific steps in <a href="#security_sasl_kerberos_brokerconfig">GSSAPI (Kerberos)</a>,
+            <a href="#security_sasl_plain_brokerconfig">PLAIN</a> and <a href="#security_sasl_scram_brokerconfig">SCRAM</a>
+            to configure SASL for the enabled mechanisms.</li>
         </ol>
     </li>
     <li><h4><a id="saslmechanism_rolling_upgrade" href="#saslmechanism_rolling_upgrade">Modifying SASL mechanism in a Running Cluster</a></h4>

From 770bab39916e213443aff8f696c6097b551b9408 Mon Sep 17 00:00:00 2001
From: Yuto Kawamura <kawamuray.dadada@gmail.com>
Date: Thu, 19 Jan 2017 09:47:34 -0800
Subject: [PATCH 017/177] KAFKA-4614; Forcefully unmap mmap of OffsetIndex to
 prevent long GC pause

Issue: https://issues.apache.org/jira/browse/KAFKA-4614

Fixes the problem that the broker threads suffered by long GC pause.
When GC thread collects mmap objects which were created for index files, it unmaps memory mapping so kernel turns to delete a file physically. This work may transparently read file's metadata from physical disk if it's not available on cache.
This seems to happen typically when we're using G1GC, due to it's strategy to left a garbage for a long time if other objects in the same region are still alive.
See the link for the details.

Author: Yuto Kawamura <kawamuray.dadada@gmail.com>

Reviewers: Apurva Mehta <apurva.1618@gmail.com>, Guozhang Wang <wangguoz@gmail.com>, Ismael Juma <ismael@juma.me.uk>,

Closes #2352 from kawamuray/KAFKA-4614-force-munmap-for-index

(cherry picked from commit 5fc530bc483db145e0cba3b63a57d6d6a7c547f2)
Signed-off-by: Jun Rao <junrao@gmail.com>
---
 .../src/main/scala/kafka/log/AbstractIndex.scala | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/core/src/main/scala/kafka/log/AbstractIndex.scala b/core/src/main/scala/kafka/log/AbstractIndex.scala
index 77ef0f73f050e..6f850d54ecf75 100644
--- a/core/src/main/scala/kafka/log/AbstractIndex.scala
+++ b/core/src/main/scala/kafka/log/AbstractIndex.scala
@@ -17,7 +17,7 @@
 
 package kafka.log
 
-import java.io.{File, RandomAccessFile}
+import java.io.{File, IOException, RandomAccessFile}
 import java.nio.{ByteBuffer, MappedByteBuffer}
 import java.nio.channels.FileChannel
 import java.util.concurrent.locks.{Lock, ReentrantLock}
@@ -141,8 +141,16 @@ abstract class AbstractIndex[K, V](@volatile var file: File, val baseOffset: Lon
    */
   def delete(): Boolean = {
     info(s"Deleting index ${file.getAbsolutePath}")
-    if(Os.isWindows)
+    inLock(lock) {
+      // On JVM, a memory mapping is typically unmapped by garbage collector.
+      // However, in some cases it can pause application threads(STW) for a long moment reading metadata from a physical disk.
+      // To prevent this, we forcefully cleanup memory mapping within proper execution which never affects API responsiveness.
+      // See https://issues.apache.org/jira/browse/KAFKA-4614 for the details.
       CoreUtils.swallow(forceUnmap(mmap))
+      // Accessing unmapped mmap crashes JVM by SEGV.
+      // Accessing it after this method called sounds like a bug but for safety, assign null and do not allow later access.
+      mmap = null
+    }
     file.delete()
   }
 
@@ -185,7 +193,7 @@ abstract class AbstractIndex[K, V](@volatile var file: File, val baseOffset: Lon
   def truncateTo(offset: Long): Unit
 
   /**
-   * Forcefully free the buffer's mmap. We do this only on windows.
+   * Forcefully free the buffer's mmap.
    */
   protected def forceUnmap(m: MappedByteBuffer) {
     try {
@@ -279,4 +287,4 @@ abstract class AbstractIndex[K, V](@volatile var file: File, val baseOffset: Lon
 object IndexSearchType extends Enumeration {
   type IndexSearchEntity = Value
   val KEY, VALUE = Value
-}
\ No newline at end of file
+}

From 17dd4db29fe7f930ca1c5d0fb5687a48c364f2d7 Mon Sep 17 00:00:00 2001
From: Vahid Hashemian <vahidhashemian@us.ibm.com>
Date: Thu, 19 Jan 2017 16:35:12 -0800
Subject: [PATCH 018/177] KAFKA-4547; Avoid incorrect reset of paused
 partitions to the committed offsets

Author: Vahid Hashemian <vahidhashemian@us.ibm.com>

Reviewers: Jason Gustafson <jason@confluent.io>

Closes #2341 from vahidhashemian/KAFKA-4547
---
 .../kafka/clients/consumer/KafkaConsumer.java |  6 +-
 .../clients/consumer/internals/Fetcher.java   |  2 +-
 .../consumer/internals/SubscriptionState.java | 14 ++++-
 .../clients/consumer/KafkaConsumerTest.java   | 55 ++++++++++++++++
 .../consumer/internals/FetcherTest.java       | 62 +++++++++++++++++++
 5 files changed, 132 insertions(+), 7 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
index 1b033e9e06639..be212db8a4a1f 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
@@ -1584,9 +1584,9 @@ private void updateFetchPositions(Set<TopicPartition> partitions) {
         // the user is manually assigning partitions and managing their own offsets).
         fetcher.resetOffsetsIfNeeded(partitions);
 
-        if (!subscriptions.hasAllFetchPositions()) {
-            // if we still don't have offsets for all partitions, then we should either seek
-            // to the last committed position or reset using the auto reset policy
+        if (!subscriptions.hasAllFetchPositions(partitions)) {
+            // if we still don't have offsets for the given partitions, then we should either
+            // seek to the last committed position or reset using the auto reset policy
 
             // first refresh commits for all assigned partitions
             coordinator.refreshCommittedOffsetsIfNeeded();
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
index 3a916a47d9c65..cd7f3077c49ca 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
@@ -208,7 +208,7 @@ public void resetOffsetsIfNeeded(Set<TopicPartition> partitions) {
     public void updateFetchPositions(Set<TopicPartition> partitions) {
         // reset the fetch position to the committed position
         for (TopicPartition tp : partitions) {
-            if (!subscriptions.isAssigned(tp) || subscriptions.isFetchable(tp))
+            if (!subscriptions.isAssigned(tp) || subscriptions.hasValidPosition(tp))
                 continue;
 
             if (subscriptions.isOffsetResetNeeded(tp)) {
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/SubscriptionState.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/SubscriptionState.java
index ad4f20b8b47ab..9e496ff08ce5b 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/SubscriptionState.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/SubscriptionState.java
@@ -357,13 +357,17 @@ public OffsetResetStrategy resetStrategy(TopicPartition partition) {
         return assignedState(partition).resetStrategy;
     }
 
-    public boolean hasAllFetchPositions() {
-        for (TopicPartitionState state : assignment.partitionStateValues())
-            if (!state.hasValidPosition())
+    public boolean hasAllFetchPositions(Collection<TopicPartition> partitions) {
+        for (TopicPartition partition : partitions)
+            if (!hasValidPosition(partition))
                 return false;
         return true;
     }
 
+    public boolean hasAllFetchPositions() {
+        return hasAllFetchPositions(this.assignedPartitions());
+    }
+
     public Set<TopicPartition> missingFetchPositions() {
         Set<TopicPartition> missing = new HashSet<>();
         for (PartitionStates.PartitionState<TopicPartitionState> state : assignment.partitionStates()) {
@@ -385,6 +389,10 @@ public boolean isFetchable(TopicPartition tp) {
         return isAssigned(tp) && assignedState(tp).isFetchable();
     }
 
+    public boolean hasValidPosition(TopicPartition tp) {
+        return isAssigned(tp) && assignedState(tp).hasValidPosition();
+    }
+
     public void pause(TopicPartition tp) {
         assignedState(tp).pause();
     }
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
index d4913df75a9c1..3e8310d410268 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
@@ -61,6 +61,7 @@
 import org.apache.kafka.common.serialization.StringDeserializer;
 import org.apache.kafka.common.utils.MockTime;
 import org.apache.kafka.common.utils.Time;
+import org.apache.kafka.common.utils.Utils;
 import org.apache.kafka.test.MockConsumerInterceptor;
 import org.apache.kafka.test.MockMetricsReporter;
 import org.apache.kafka.test.TestUtils;
@@ -1094,6 +1095,60 @@ public void testManualAssignmentChangeWithAutoCommitDisabled() {
         consumer.close();
     }
 
+    @Test
+    public void testOffsetOfPausedPartitions() {
+        int rebalanceTimeoutMs = 60000;
+        int sessionTimeoutMs = 30000;
+        int heartbeatIntervalMs = 3000;
+        int autoCommitIntervalMs = 1000;
+
+        Time time = new MockTime();
+        Cluster cluster = TestUtils.singletonCluster(topic, 2);
+        Node node = cluster.nodes().get(0);
+
+        Metadata metadata = new Metadata(0, Long.MAX_VALUE);
+        metadata.update(cluster, time.milliseconds());
+
+        MockClient client = new MockClient(time, metadata);
+        client.setNode(node);
+        PartitionAssignor assignor = new RangeAssignor();
+
+        final KafkaConsumer<String, String> consumer = newConsumer(time, client, metadata, assignor,
+                rebalanceTimeoutMs, sessionTimeoutMs, heartbeatIntervalMs, true, autoCommitIntervalMs);
+
+        // lookup coordinator
+        client.prepareResponseFrom(new GroupCoordinatorResponse(Errors.NONE.code(), node), node);
+        Node coordinator = new Node(Integer.MAX_VALUE - node.id(), node.host(), node.port());
+
+        // manual assignment
+        Set<TopicPartition> partitions = Utils.mkSet(tp0, tp1);
+        consumer.assign(partitions);
+        // verify consumer's assignment
+        assertTrue(consumer.assignment().equals(partitions));
+
+        consumer.pause(partitions);
+        consumer.seekToEnd(partitions);
+
+        // fetch and verify committed offset of two partitions
+        Map<TopicPartition, Long> offsets = new HashMap<>();
+        offsets.put(tp0, 0L);
+        offsets.put(tp1, 0L);
+
+        client.prepareResponseFrom(offsetResponse(offsets, Errors.NONE), coordinator);
+        assertEquals(0, consumer.committed(tp0).offset());
+        assertEquals(0, consumer.committed(tp1).offset());
+
+        // fetch and verify consumer's position in the two partitions
+        client.prepareResponse(listOffsetsResponse(Collections.singletonMap(tp0, 3L), Errors.NONE.code()));
+        client.prepareResponse(listOffsetsResponse(Collections.singletonMap(tp1, 3L), Errors.NONE.code()));
+        assertEquals(3L, consumer.position(tp0));
+        assertEquals(3L, consumer.position(tp1));
+
+        client.requests().clear();
+        consumer.unsubscribe();
+        consumer.close();
+    }
+
     @Test(expected = IllegalStateException.class)
     public void testPollWithNoSubscription() {
         KafkaConsumer<byte[], byte[]> consumer = newConsumer();
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java
index cffa59f7a3989..bdd56c3e0f713 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java
@@ -544,6 +544,68 @@ public void testUpdateFetchPositionDisconnect() {
         assertEquals(5, subscriptions.position(tp).longValue());
     }
 
+    @Test
+    public void testUpdateFetchPositionOfPausedPartitionsRequiringOffsetReset() {
+        subscriptions.assignFromUser(singleton(tp));
+        subscriptions.committed(tp, new OffsetAndMetadata(0));
+        subscriptions.pause(tp); // paused partition does not have a valid position
+        subscriptions.needOffsetReset(tp, OffsetResetStrategy.LATEST);
+
+        client.prepareResponse(listOffsetRequestMatcher(ListOffsetRequest.LATEST_TIMESTAMP),
+                               listOffsetResponse(Errors.NONE, 1L, 10L));
+        fetcher.updateFetchPositions(singleton(tp));
+
+        assertFalse(subscriptions.isOffsetResetNeeded(tp));
+        assertFalse(subscriptions.isFetchable(tp)); // because tp is paused
+        assertTrue(subscriptions.hasValidPosition(tp));
+        assertEquals(10, subscriptions.position(tp).longValue());
+    }
+
+    @Test
+    public void testUpdateFetchPositionOfPausedPartitionsWithoutACommittedOffset() {
+        subscriptions.assignFromUser(singleton(tp));
+        subscriptions.pause(tp); // paused partition does not have a valid position
+
+        client.prepareResponse(listOffsetRequestMatcher(ListOffsetRequest.EARLIEST_TIMESTAMP),
+                               listOffsetResponse(Errors.NONE, 1L, 0L));
+        fetcher.updateFetchPositions(singleton(tp));
+
+        assertFalse(subscriptions.isOffsetResetNeeded(tp));
+        assertFalse(subscriptions.isFetchable(tp)); // because tp is paused
+        assertTrue(subscriptions.hasValidPosition(tp));
+        assertEquals(0, subscriptions.position(tp).longValue());
+    }
+
+    @Test
+    public void testUpdateFetchPositionOfPausedPartitionsWithoutAValidPosition() {
+        subscriptions.assignFromUser(singleton(tp));
+        subscriptions.committed(tp, new OffsetAndMetadata(0));
+        subscriptions.pause(tp); // paused partition does not have a valid position
+        subscriptions.seek(tp, 10);
+
+        fetcher.updateFetchPositions(singleton(tp));
+
+        assertFalse(subscriptions.isOffsetResetNeeded(tp));
+        assertFalse(subscriptions.isFetchable(tp)); // because tp is paused
+        assertTrue(subscriptions.hasValidPosition(tp));
+        assertEquals(10, subscriptions.position(tp).longValue());
+    }
+
+    @Test
+    public void testUpdateFetchPositionOfPausedPartitionsWithAValidPosition() {
+        subscriptions.assignFromUser(singleton(tp));
+        subscriptions.committed(tp, new OffsetAndMetadata(0));
+        subscriptions.seek(tp, 10);
+        subscriptions.pause(tp); // paused partition already has a valid position
+
+        fetcher.updateFetchPositions(singleton(tp));
+
+        assertFalse(subscriptions.isOffsetResetNeeded(tp));
+        assertFalse(subscriptions.isFetchable(tp)); // because tp is paused
+        assertTrue(subscriptions.hasValidPosition(tp));
+        assertEquals(10, subscriptions.position(tp).longValue());
+    }
+
     @Test
     public void testGetAllTopics() {
         // sending response before request, as getTopicMetadata is a blocking call

From 3e1abac4c7d298d47567d23d6390eae4cd9ac1f8 Mon Sep 17 00:00:00 2001
From: Sandesh K <sandesh.karkera@flipkart.com>
Date: Thu, 19 Jan 2017 17:46:59 -0800
Subject: [PATCH 019/177] KAFKA-4432; Added support to supply custom message
 payloads to perf-producer script.

Current implementation of ProducerPerformance creates static payload. This is not very useful in testing compression or when you want to test with production/custom payloads. So, we decided to add support for providing payload file as an input to producer perf test script.

We made the following changes:
1. Added support to provide a payload file which can have the list of payloads that you actually want to send.
2. Moved payload generation inside the send loop for cases when payload file is provided.

Following are the changes to how the producer-performance is evoked:
1. You must provide "--record-size" or "--payload-file" but not both. This is because, record size cannot be guaranteed when you are using custom events.
  e.g. ./kafka-producer-perf-test.sh --topic test_topic --num-records 100000 --producer-props bootstrap.servers=127.0.0.1:9092 acks=0 buffer.memory=33554432 compression.type=gzip batch.size=10240 linger.ms=10 --throughput -1 --payload-file ./test_payloads --payload-delimiter ,
2. Earlier "--record-size" was a required config, now you must provide exactly one of "--record-size" or "--payload-file". Providing both will result in an error.
3. Support for an additional parameter "--payload-delimiter" has been added which defaults to "\n"

Author: Sandesh K <sandesh.karkera@flipkart.com>

Reviewers: dan norwood <norwood@confluent.io>, Jun Rao <junrao@gmail.com>

Closes #2158 from SandeshKarkera/PerfProducerChanges

(cherry picked from commit a37bf5fffa4a607ded14ec055276d76f19df2d50)
Signed-off-by: Jun Rao <junrao@gmail.com>
---
 .../kafka/tools/ProducerPerformance.java      | 82 ++++++++++++++++---
 1 file changed, 72 insertions(+), 10 deletions(-)

diff --git a/tools/src/main/java/org/apache/kafka/tools/ProducerPerformance.java b/tools/src/main/java/org/apache/kafka/tools/ProducerPerformance.java
index a13d3ec68fc68..c277b83330767 100644
--- a/tools/src/main/java/org/apache/kafka/tools/ProducerPerformance.java
+++ b/tools/src/main/java/org/apache/kafka/tools/ProducerPerformance.java
@@ -3,9 +3,9 @@
  * file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file
  * to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the
  * License. You may obtain a copy of the License at
- * 
+ *
  * http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
  * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
  * specific language governing permissions and limitations under the License.
@@ -14,11 +14,18 @@
 
 import static net.sourceforge.argparse4j.impl.Arguments.store;
 
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+
+import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.List;
 import java.util.Properties;
 import java.util.Random;
 
+import net.sourceforge.argparse4j.inf.MutuallyExclusiveGroup;
 import org.apache.kafka.clients.producer.Callback;
 import org.apache.kafka.clients.producer.KafkaProducer;
 import org.apache.kafka.clients.producer.ProducerConfig;
@@ -42,15 +49,36 @@ public static void main(String[] args) throws Exception {
             /* parse args */
             String topicName = res.getString("topic");
             long numRecords = res.getLong("numRecords");
-            int recordSize = res.getInt("recordSize");
+            Integer recordSize = res.getInt("recordSize");
             int throughput = res.getInt("throughput");
             List<String> producerProps = res.getList("producerConfig");
             String producerConfig = res.getString("producerConfigFile");
+            String payloadFilePath = res.getString("payloadFile");
+
+            // since default value gets printed with the help text, we are escaping \n there and replacing it with correct value here.
+            String payloadDelimiter = res.getString("payloadDelimiter").equals("\\n") ? "\n" : res.getString("payloadDelimiter");
 
             if (producerProps == null && producerConfig == null) {
                 throw new ArgumentParserException("Either --producer-props or --producer.config must be specified.", parser);
             }
 
+            List<byte[]> payloadByteList = new ArrayList<>();
+            if (payloadFilePath != null) {
+                Path path = Paths.get(payloadFilePath);
+                System.out.println("Reading payloads from: " + path.toAbsolutePath());
+                if (Files.notExists(path) || Files.size(path) == 0)  {
+                    throw new  IllegalArgumentException("File does not exist or empty file provided.");
+                }
+
+                String[] payloadList = new String(Files.readAllBytes(path), "UTF-8").split(payloadDelimiter);
+
+                System.out.println("Number of messages read: " + payloadList.length);
+
+                for (String payload : payloadList) {
+                    payloadByteList.add(payload.getBytes(StandardCharsets.UTF_8));
+                }
+            }
+
             Properties props = new Properties();
             if (producerConfig != null) {
                 props.putAll(Utils.loadProps(producerConfig));
@@ -68,16 +96,24 @@ public static void main(String[] args) throws Exception {
             KafkaProducer<byte[], byte[]> producer = new KafkaProducer<byte[], byte[]>(props);
 
             /* setup perf test */
-            byte[] payload = new byte[recordSize];
+            byte[] payload = null;
             Random random = new Random(0);
-            for (int i = 0; i < payload.length; ++i)
-                payload[i] = (byte) (random.nextInt(26) + 65);
-            ProducerRecord<byte[], byte[]> record = new ProducerRecord<>(topicName, payload);
+            if (recordSize != null) {
+                payload = new byte[recordSize];
+                for (int i = 0; i < payload.length; ++i)
+                    payload[i] = (byte) (random.nextInt(26) + 65);
+            }
+            ProducerRecord<byte[], byte[]> record;
             Stats stats = new Stats(numRecords, 5000);
             long startMs = System.currentTimeMillis();
 
             ThroughputThrottler throttler = new ThroughputThrottler(throughput, startMs);
             for (int i = 0; i < numRecords; i++) {
+                if (payloadFilePath != null) {
+                    payload = payloadByteList.get(random.nextInt(payloadByteList.size()));
+                }
+                record = new ProducerRecord<>(topicName, payload);
+
                 long sendStartMs = System.currentTimeMillis();
                 Callback cb = stats.nextCompletion(sendStartMs, payload.length, stats);
                 producer.send(record, cb);
@@ -109,6 +145,11 @@ private static ArgumentParser argParser() {
                 .defaultHelp(true)
                 .description("This tool is used to verify the producer performance.");
 
+        MutuallyExclusiveGroup payloadOptions = parser
+                .addMutuallyExclusiveGroup()
+                .required(true)
+                .description("either --record-size or --payload-file must be specified but not both.");
+
         parser.addArgument("--topic")
                 .action(store())
                 .required(true)
@@ -124,13 +165,34 @@ private static ArgumentParser argParser() {
                 .dest("numRecords")
                 .help("number of messages to produce");
 
-        parser.addArgument("--record-size")
+        payloadOptions.addArgument("--record-size")
                 .action(store())
-                .required(true)
+                .required(false)
                 .type(Integer.class)
                 .metavar("RECORD-SIZE")
                 .dest("recordSize")
-                .help("message size in bytes");
+                .help("message size in bytes. Note that you must provide exactly one of --record-size or --payload-file.");
+
+        payloadOptions.addArgument("--payload-file")
+                .action(store())
+                .required(false)
+                .type(String.class)
+                .metavar("PAYLOAD-FILE")
+                .dest("payloadFile")
+                .help("file to read the message payloads from. This works only for UTF-8 encoded text files. " +
+                        "Payloads will be read from this file and a payload will be randomly selected when sending messages. " +
+                        "Note that you must provide exactly one of --record-size or --payload-file.");
+
+        parser.addArgument("--payload-delimiter")
+                .action(store())
+                .required(false)
+                .type(String.class)
+                .metavar("PAYLOAD-DELIMITER")
+                .dest("payloadDelimiter")
+                .setDefault("\\n")
+                .help("provides delimiter to be used when --payload-file is provided. " +
+                        "Defaults to new line. " +
+                        "Note that this parameter will be ignored if --payload-file is not provided.");
 
         parser.addArgument("--throughput")
                 .action(store())

From 05237367d7a12f395c9b2a1c2b354e1564f21aae Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Xavier=20L=C3=A9aut=C3=A9?= <xavier@confluent.io>
Date: Fri, 20 Jan 2017 11:07:57 -0800
Subject: [PATCH 020/177] MINOR: reduce verbosity of cache flushes
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This log message tends to be extremely verbose when state stores are being restored

Author: Xavier Léauté <xavier@confluent.io>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2412 from xvrl/reduce-verbosity

(cherry picked from commit 50e035dc341bb595decbac0851354a10c90b0e06)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../apache/kafka/streams/state/internals/NamedCache.java    | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/NamedCache.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/NamedCache.java
index 6dc08f2247e8b..229ccec056649 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/NamedCache.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/NamedCache.java
@@ -106,8 +106,10 @@ synchronized void flush() {
     private void flush(final LRUNode evicted) {
         numFlushes++;
 
-        log.debug("Named cache {} stats on flush: #hits={}, #misses={}, #overwrites={}, #flushes={}",
-                  name, hits(), misses(), overwrites(), flushes());
+        if (log.isTraceEnabled()) {
+            log.trace("Named cache {} stats on flush: #hits={}, #misses={}, #overwrites={}, #flushes={}",
+                      name, hits(), misses(), overwrites(), flushes());
+        }
 
         if (listener == null) {
             throw new IllegalArgumentException("No listener for namespace " + name + " registered with cache");

From c3f923cbf9f686bf42adda44d34a975167a13159 Mon Sep 17 00:00:00 2001
From: Shikhar Bhushan <shikhar@confluent.io>
Date: Fri, 20 Jan 2017 16:15:15 -0800
Subject: [PATCH 021/177] KAFKA-3209: KIP-66: more single message transforms

Renames `HoistToStruct` SMT to `HoistField`.

Adds the following SMTs:
`ExtractField`
`MaskField`
`RegexRouter`
`ReplaceField`
`SetSchemaMetadata`
`ValueToKey`

Adds HTML doc generation and updates to `connect.html`.

Author: Shikhar Bhushan <shikhar@confluent.io>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2374 from shikhar/more-smt
---
 build.gradle                                  |   9 +-
 .../connect/tools/TransformationDoc.java      |  87 +++++++
 .../connect/transforms/ExtractField.java      | 114 +++++++++
 .../{HoistToStruct.java => HoistField.java}   |  46 ++--
 .../kafka/connect/transforms/InsertField.java | 170 ++++++-------
 .../kafka/connect/transforms/MaskField.java   | 172 +++++++++++++
 .../kafka/connect/transforms/RegexRouter.java |  75 ++++++
 .../connect/transforms/ReplaceField.java      | 230 ++++++++++++++++++
 .../connect/transforms/SetSchemaMetadata.java | 124 ++++++++++
 .../connect/transforms/TimestampRouter.java   |  30 +--
 .../kafka/connect/transforms/ValueToKey.java  | 111 +++++++++
 .../util/NonEmptyListValidator.java           |  39 +++
 .../transforms/util/RegexValidator.java       |  41 ++++
 .../connect/transforms/util/Requirements.java |  61 +++++
 .../connect/transforms/util/SchemaUtil.java   |  40 +++
 .../connect/transforms/ExtractFieldTest.java  |  59 +++++
 ...tToStructTest.java => HoistFieldTest.java} |  19 +-
 .../connect/transforms/MaskFieldTest.java     | 156 ++++++++++++
 .../connect/transforms/RegexRouterTest.java   |  70 ++++++
 .../connect/transforms/ReplaceFieldTest.java  |  92 +++++++
 .../transforms/SetSchemaMetadataTest.java     |  67 +++++
 .../connect/transforms/ValueToKeyTest.java    |  87 +++++++
 docs/connect.html                             |  16 ++
 .../tests/connect/connect_distributed_test.py |   2 +-
 24 files changed, 1779 insertions(+), 138 deletions(-)
 create mode 100644 connect/runtime/src/main/java/org/apache/kafka/connect/tools/TransformationDoc.java
 create mode 100644 connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ExtractField.java
 rename connect/transforms/src/main/java/org/apache/kafka/connect/transforms/{HoistToStruct.java => HoistField.java} (73%)
 create mode 100644 connect/transforms/src/main/java/org/apache/kafka/connect/transforms/MaskField.java
 create mode 100644 connect/transforms/src/main/java/org/apache/kafka/connect/transforms/RegexRouter.java
 create mode 100644 connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ReplaceField.java
 create mode 100644 connect/transforms/src/main/java/org/apache/kafka/connect/transforms/SetSchemaMetadata.java
 create mode 100644 connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ValueToKey.java
 create mode 100644 connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/NonEmptyListValidator.java
 create mode 100644 connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/RegexValidator.java
 create mode 100644 connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/Requirements.java
 create mode 100644 connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/SchemaUtil.java
 create mode 100644 connect/transforms/src/test/java/org/apache/kafka/connect/transforms/ExtractFieldTest.java
 rename connect/transforms/src/test/java/org/apache/kafka/connect/transforms/{HoistToStructTest.java => HoistFieldTest.java} (71%)
 create mode 100644 connect/transforms/src/test/java/org/apache/kafka/connect/transforms/MaskFieldTest.java
 create mode 100644 connect/transforms/src/test/java/org/apache/kafka/connect/transforms/RegexRouterTest.java
 create mode 100644 connect/transforms/src/test/java/org/apache/kafka/connect/transforms/ReplaceFieldTest.java
 create mode 100644 connect/transforms/src/test/java/org/apache/kafka/connect/transforms/SetSchemaMetadataTest.java
 create mode 100644 connect/transforms/src/test/java/org/apache/kafka/connect/transforms/ValueToKeyTest.java

diff --git a/build.gradle b/build.gradle
index 6f4d2501f7345..e191a51c3b89a 100644
--- a/build.gradle
+++ b/build.gradle
@@ -508,7 +508,7 @@ project(':core') {
 
   task siteDocsTar(dependsOn: ['genProtocolErrorDocs', 'genProtocolApiKeyDocs', 'genProtocolMessageDocs',
                                'genProducerConfigDocs', 'genConsumerConfigDocs', 'genKafkaConfigDocs',
-                               'genTopicConfigDocs', ':connect:runtime:genConnectConfigDocs',
+                               'genTopicConfigDocs', ':connect:runtime:genConnectConfigDocs', ':connect:runtime:genConnectTransformationDocs',
                                ':streams:genStreamsConfigDocs'], type: Tar) {
     classifier = 'site-docs'
     compression = Compression.GZIP
@@ -948,6 +948,13 @@ project(':connect:runtime') {
     if( !generatedDocsDir.exists() ) { generatedDocsDir.mkdirs() }
     standardOutput = new File(generatedDocsDir, "connect_config.html").newOutputStream()
   }
+
+  task genConnectTransformationDocs(type: JavaExec) {
+    classpath = sourceSets.main.runtimeClasspath
+    main = 'org.apache.kafka.connect.tools.TransformationDoc'
+    if( !generatedDocsDir.exists() ) { generatedDocsDir.mkdirs() }
+    standardOutput = new File(generatedDocsDir, "connect_transforms.html").newOutputStream()
+  }
 }
 
 project(':connect:file') {
diff --git a/connect/runtime/src/main/java/org/apache/kafka/connect/tools/TransformationDoc.java b/connect/runtime/src/main/java/org/apache/kafka/connect/tools/TransformationDoc.java
new file mode 100644
index 0000000000000..6746042baa743
--- /dev/null
+++ b/connect/runtime/src/main/java/org/apache/kafka/connect/tools/TransformationDoc.java
@@ -0,0 +1,87 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p/>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p/>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.tools;
+
+import org.apache.kafka.common.config.ConfigDef;
+import org.apache.kafka.connect.transforms.ExtractField;
+import org.apache.kafka.connect.transforms.HoistField;
+import org.apache.kafka.connect.transforms.InsertField;
+import org.apache.kafka.connect.transforms.MaskField;
+import org.apache.kafka.connect.transforms.RegexRouter;
+import org.apache.kafka.connect.transforms.ReplaceField;
+import org.apache.kafka.connect.transforms.SetSchemaMetadata;
+import org.apache.kafka.connect.transforms.TimestampRouter;
+import org.apache.kafka.connect.transforms.ValueToKey;
+
+import java.io.PrintStream;
+import java.util.Arrays;
+import java.util.List;
+
+public class TransformationDoc {
+
+    private static final class DocInfo {
+        final String transformationName;
+        final String overview;
+        final ConfigDef configDef;
+
+        private DocInfo(String transformationName, String overview, ConfigDef configDef) {
+            this.transformationName = transformationName;
+            this.overview = overview;
+            this.configDef = configDef;
+        }
+    }
+
+    private static final List<DocInfo> TRANSFORMATIONS = Arrays.asList(
+            new DocInfo(InsertField.class.getName(), InsertField.OVERVIEW_DOC, InsertField.CONFIG_DEF),
+            new DocInfo(ReplaceField.class.getName(), ReplaceField.OVERVIEW_DOC, ReplaceField.CONFIG_DEF),
+            new DocInfo(MaskField.class.getName(), MaskField.OVERVIEW_DOC, MaskField.CONFIG_DEF),
+            new DocInfo(ValueToKey.class.getName(), ValueToKey.OVERVIEW_DOC, ValueToKey.CONFIG_DEF),
+            new DocInfo(HoistField.class.getName(), HoistField.OVERVIEW_DOC, HoistField.CONFIG_DEF),
+            new DocInfo(ExtractField.class.getName(), ExtractField.OVERVIEW_DOC, ExtractField.CONFIG_DEF),
+            new DocInfo(SetSchemaMetadata.class.getName(), SetSchemaMetadata.OVERVIEW_DOC, SetSchemaMetadata.CONFIG_DEF),
+            new DocInfo(TimestampRouter.class.getName(), TimestampRouter.OVERVIEW_DOC, TimestampRouter.CONFIG_DEF),
+            new DocInfo(RegexRouter.class.getName(), RegexRouter.OVERVIEW_DOC, RegexRouter.CONFIG_DEF)
+    );
+
+    private static void printTransformationHtml(PrintStream out, DocInfo docInfo) {
+        out.println("<div id=\"" + docInfo.transformationName + "\">");
+
+        out.print("<h5>");
+        out.print(docInfo.transformationName);
+        out.println("</h5>");
+
+        out.println(docInfo.overview);
+
+        out.println("<p/>");
+
+        out.println(docInfo.configDef.toHtmlTable());
+
+        out.println("</div>");
+    }
+
+    private static void printHtml(PrintStream out) throws NoSuchFieldException, IllegalAccessException, InstantiationException {
+        for (final DocInfo docInfo : TRANSFORMATIONS) {
+            printTransformationHtml(out, docInfo);
+        }
+    }
+
+    public static void main(String... args) throws Exception {
+        printHtml(System.out);
+    }
+
+}
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ExtractField.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ExtractField.java
new file mode 100644
index 0000000000000..b7063136e9df1
--- /dev/null
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ExtractField.java
@@ -0,0 +1,114 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p/>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p/>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms;
+
+import org.apache.kafka.common.config.ConfigDef;
+import org.apache.kafka.connect.connector.ConnectRecord;
+import org.apache.kafka.connect.data.Schema;
+import org.apache.kafka.connect.data.Struct;
+import org.apache.kafka.connect.transforms.util.SimpleConfig;
+
+import java.util.Map;
+
+import static org.apache.kafka.connect.transforms.util.Requirements.requireMap;
+import static org.apache.kafka.connect.transforms.util.Requirements.requireStruct;
+
+public abstract class ExtractField<R extends ConnectRecord<R>> implements Transformation<R> {
+
+    public static final String OVERVIEW_DOC =
+            "Extract the specified field from a Struct when schema present, or a Map in the case of schemaless data."
+                    + "<p/>Use the concrete transformation type designed for the record key (<code>" + Key.class.getCanonicalName() + "</code>) "
+                    + "or value (<code>" + Value.class.getCanonicalName() + "</code>).";
+
+    private static final String FIELD_CONFIG = "field";
+
+    public static final ConfigDef CONFIG_DEF = new ConfigDef()
+            .define(FIELD_CONFIG, ConfigDef.Type.STRING, ConfigDef.NO_DEFAULT_VALUE, ConfigDef.Importance.MEDIUM, "Field name to extract.");
+
+    private static final String PURPOSE = "field extraction";
+
+    private String fieldName;
+
+    @Override
+    public void configure(Map<String, ?> props) {
+        final SimpleConfig config = new SimpleConfig(CONFIG_DEF, props);
+        fieldName = config.getString(FIELD_CONFIG);
+    }
+
+    @Override
+    public R apply(R record) {
+        final Schema schema = operatingSchema(record);
+        if (schema == null) {
+            final Map<String, Object> value = requireMap(operatingValue(record), PURPOSE);
+            return newRecord(record, null, value.get(fieldName));
+        } else {
+            final Struct value = requireStruct(operatingValue(record), PURPOSE);
+            return newRecord(record, schema.field(fieldName).schema(), value.get(fieldName));
+        }
+    }
+
+    @Override
+    public void close() {
+    }
+
+    @Override
+    public ConfigDef config() {
+        return CONFIG_DEF;
+    }
+
+    protected abstract Schema operatingSchema(R record);
+
+    protected abstract Object operatingValue(R record);
+
+    protected abstract R newRecord(R record, Schema updatedSchema, Object updatedValue);
+
+    public static class Key<R extends ConnectRecord<R>> extends ExtractField<R> {
+        @Override
+        protected Schema operatingSchema(R record) {
+            return record.keySchema();
+        }
+
+        @Override
+        protected Object operatingValue(R record) {
+            return record.key();
+        }
+
+        @Override
+        protected R newRecord(R record, Schema updatedSchema, Object updatedValue) {
+            return record.newRecord(record.topic(), record.kafkaPartition(), updatedSchema, updatedValue, record.valueSchema(), record.value(), record.timestamp());
+        }
+    }
+
+    public static class Value<R extends ConnectRecord<R>> extends ExtractField<R> {
+        @Override
+        protected Schema operatingSchema(R record) {
+            return record.valueSchema();
+        }
+
+        @Override
+        protected Object operatingValue(R record) {
+            return record.value();
+        }
+
+        @Override
+        protected R newRecord(R record, Schema updatedSchema, Object updatedValue) {
+            return record.newRecord(record.topic(), record.kafkaPartition(), record.keySchema(), record.key(), updatedSchema, updatedValue, record.timestamp());
+        }
+    }
+
+}
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/HoistToStruct.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/HoistField.java
similarity index 73%
rename from connect/transforms/src/main/java/org/apache/kafka/connect/transforms/HoistToStruct.java
rename to connect/transforms/src/main/java/org/apache/kafka/connect/transforms/HoistField.java
index c2726ca84378b..1f2ed7c8e626f 100644
--- a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/HoistToStruct.java
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/HoistField.java
@@ -27,15 +27,21 @@
 import org.apache.kafka.connect.data.Struct;
 import org.apache.kafka.connect.transforms.util.SimpleConfig;
 
+import java.util.Collections;
 import java.util.Map;
 
-public abstract class HoistToStruct<R extends ConnectRecord<R>> implements Transformation<R> {
+public abstract class HoistField<R extends ConnectRecord<R>> implements Transformation<R> {
 
-    public static final String FIELD_CONFIG = "field";
+    public static final String OVERVIEW_DOC =
+            "Wrap data using the specified field name in a Struct when schema present, or a Map in the case of schemaless data."
+                    + "<p/>Use the concrete transformation type designed for the record key (<code>" + Key.class.getCanonicalName() + "</code>) "
+                    + "or value (<code>" + Value.class.getCanonicalName() + "</code>).";
 
-    private static final ConfigDef CONFIG_DEF = new ConfigDef()
+    private static final String FIELD_CONFIG = "field";
+
+    public static final ConfigDef CONFIG_DEF = new ConfigDef()
             .define(FIELD_CONFIG, ConfigDef.Type.STRING, ConfigDef.NO_DEFAULT_VALUE, ConfigDef.Importance.MEDIUM,
-                    "Field name for the single field that will be created in the resulting Struct.");
+                    "Field name for the single field that will be created in the resulting Struct or Map.");
 
     private Cache<Schema, Schema> schemaUpdateCache;
 
@@ -53,15 +59,19 @@ public R apply(R record) {
         final Schema schema = operatingSchema(record);
         final Object value = operatingValue(record);
 
-        Schema updatedSchema = schemaUpdateCache.get(schema);
-        if (updatedSchema == null) {
-            updatedSchema = SchemaBuilder.struct().field(fieldName, schema).build();
-            schemaUpdateCache.put(schema, updatedSchema);
-        }
+        if (schema == null) {
+            return newRecord(record, null, Collections.singletonMap(fieldName, value));
+        } else {
+            Schema updatedSchema = schemaUpdateCache.get(schema);
+            if (updatedSchema == null) {
+                updatedSchema = SchemaBuilder.struct().field(fieldName, schema).build();
+                schemaUpdateCache.put(schema, updatedSchema);
+            }
 
-        final Struct updatedValue = new Struct(updatedSchema).put(fieldName, value);
+            final Struct updatedValue = new Struct(updatedSchema).put(fieldName, value);
 
-        return newRecord(record, updatedSchema, updatedValue);
+            return newRecord(record, updatedSchema, updatedValue);
+        }
     }
 
     @Override
@@ -80,11 +90,7 @@ public ConfigDef config() {
 
     protected abstract R newRecord(R record, Schema updatedSchema, Object updatedValue);
 
-    /**
-     * Wraps the record key in a {@link org.apache.kafka.connect.data.Struct} with specified field name.
-     */
-    public static class Key<R extends ConnectRecord<R>> extends HoistToStruct<R> {
-
+    public static class Key<R extends ConnectRecord<R>> extends HoistField<R> {
         @Override
         protected Schema operatingSchema(R record) {
             return record.keySchema();
@@ -99,14 +105,9 @@ protected Object operatingValue(R record) {
         protected R newRecord(R record, Schema updatedSchema, Object updatedValue) {
             return record.newRecord(record.topic(), record.kafkaPartition(), updatedSchema, updatedValue, record.valueSchema(), record.value(), record.timestamp());
         }
-
     }
 
-    /**
-     * Wraps the record value in a {@link org.apache.kafka.connect.data.Struct} with specified field name.
-     */
-    public static class Value<R extends ConnectRecord<R>> extends HoistToStruct<R> {
-
+    public static class Value<R extends ConnectRecord<R>> extends HoistField<R> {
         @Override
         protected Schema operatingSchema(R record) {
             return record.valueSchema();
@@ -121,7 +122,6 @@ protected Object operatingValue(R record) {
         protected R newRecord(R record, Schema updatedSchema, Object updatedValue) {
             return record.newRecord(record.topic(), record.kafkaPartition(), record.keySchema(), record.key(), updatedSchema, updatedValue, record.timestamp());
         }
-
     }
 
 }
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/InsertField.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/InsertField.java
index d67fea0893237..f32d6ed2e9465 100644
--- a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/InsertField.java
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/InsertField.java
@@ -21,23 +21,32 @@
 import org.apache.kafka.common.cache.LRUCache;
 import org.apache.kafka.common.cache.SynchronizedCache;
 import org.apache.kafka.common.config.ConfigDef;
+import org.apache.kafka.common.config.ConfigException;
 import org.apache.kafka.connect.connector.ConnectRecord;
 import org.apache.kafka.connect.data.Field;
 import org.apache.kafka.connect.data.Schema;
 import org.apache.kafka.connect.data.SchemaBuilder;
 import org.apache.kafka.connect.data.Struct;
 import org.apache.kafka.connect.data.Timestamp;
-import org.apache.kafka.connect.errors.DataException;
-import org.apache.kafka.connect.sink.SinkRecord;
 import org.apache.kafka.connect.transforms.util.SimpleConfig;
+import org.apache.kafka.connect.transforms.util.SchemaUtil;
 
 import java.util.Date;
 import java.util.HashMap;
 import java.util.Map;
 
+import static org.apache.kafka.connect.transforms.util.Requirements.requireMap;
+import static org.apache.kafka.connect.transforms.util.Requirements.requireSinkRecord;
+import static org.apache.kafka.connect.transforms.util.Requirements.requireStruct;
+
 public abstract class InsertField<R extends ConnectRecord<R>> implements Transformation<R> {
 
-    public interface Keys {
+    public static final String OVERVIEW_DOC =
+            "Insert field(s) using attributes from the record metadata or a configured static value."
+                    + "<p/>Use the concrete transformation type designed for the record key (<code>" + Key.class.getCanonicalName() + "</code>) "
+                    + "or value (<code>" + Value.class.getCanonicalName() + "</code>).";
+
+    private interface ConfigName {
         String TOPIC_FIELD = "topic.field";
         String PARTITION_FIELD = "partition.field";
         String OFFSET_FIELD = "offset.field";
@@ -46,22 +55,24 @@ public interface Keys {
         String STATIC_VALUE = "static.value";
     }
 
-    private static final String OPTIONALITY_DOC = "Suffix with '!' to make this a required field, or '?' to keep it optional (the default).";
-
-    private static final ConfigDef CONFIG_DEF = new ConfigDef()
-            .define(Keys.TOPIC_FIELD, ConfigDef.Type.STRING, null, ConfigDef.Importance.MEDIUM,
-                    "Field name for Kafka topic.\n" + OPTIONALITY_DOC)
-            .define(Keys.PARTITION_FIELD, ConfigDef.Type.STRING, null, ConfigDef.Importance.MEDIUM,
-                    "Field name for Kafka partition.\n" + OPTIONALITY_DOC)
-            .define(Keys.OFFSET_FIELD, ConfigDef.Type.STRING, null, ConfigDef.Importance.MEDIUM,
-                    "Field name for Kafka offset - only applicable to sink connectors.\n" + OPTIONALITY_DOC)
-            .define(Keys.TIMESTAMP_FIELD, ConfigDef.Type.STRING, null, ConfigDef.Importance.MEDIUM,
-                    "Field name for record timestamp.\n" + OPTIONALITY_DOC)
-            .define(Keys.STATIC_FIELD, ConfigDef.Type.STRING, null, ConfigDef.Importance.MEDIUM,
-                    "Field name for static data field.\n" + OPTIONALITY_DOC)
-            .define(Keys.STATIC_VALUE, ConfigDef.Type.STRING, null, ConfigDef.Importance.MEDIUM,
+    private static final String OPTIONALITY_DOC = "Suffix with <code>!</code> to make this a required field, or <code>?</code> to keep it optional (the default).";
+
+    public static final ConfigDef CONFIG_DEF = new ConfigDef()
+            .define(ConfigName.TOPIC_FIELD, ConfigDef.Type.STRING, null, ConfigDef.Importance.MEDIUM,
+                    "Field name for Kafka topic. " + OPTIONALITY_DOC)
+            .define(ConfigName.PARTITION_FIELD, ConfigDef.Type.STRING, null, ConfigDef.Importance.MEDIUM,
+                    "Field name for Kafka partition. " + OPTIONALITY_DOC)
+            .define(ConfigName.OFFSET_FIELD, ConfigDef.Type.STRING, null, ConfigDef.Importance.MEDIUM,
+                    "Field name for Kafka offset - only applicable to sink connectors.<br/>" + OPTIONALITY_DOC)
+            .define(ConfigName.TIMESTAMP_FIELD, ConfigDef.Type.STRING, null, ConfigDef.Importance.MEDIUM,
+                    "Field name for record timestamp. " + OPTIONALITY_DOC)
+            .define(ConfigName.STATIC_FIELD, ConfigDef.Type.STRING, null, ConfigDef.Importance.MEDIUM,
+                    "Field name for static data field. " + OPTIONALITY_DOC)
+            .define(ConfigName.STATIC_VALUE, ConfigDef.Type.STRING, null, ConfigDef.Importance.MEDIUM,
                     "Static field value, if field name configured.");
 
+    private static final String PURPOSE = "field insertion";
+
     private static final Schema OPTIONAL_TIMESTAMP_SCHEMA = Timestamp.builder().optional().build();
 
     private static final class InsertionSpec {
@@ -91,46 +102,42 @@ public static InsertionSpec parse(String spec) {
     private InsertionSpec timestampField;
     private InsertionSpec staticField;
     private String staticValue;
-    private boolean applicable;
 
     private Cache<Schema, Schema> schemaUpdateCache;
 
     @Override
     public void configure(Map<String, ?> props) {
         final SimpleConfig config = new SimpleConfig(CONFIG_DEF, props);
-        topicField = InsertionSpec.parse(config.getString(Keys.TOPIC_FIELD));
-        partitionField = InsertionSpec.parse(config.getString(Keys.PARTITION_FIELD));
-        offsetField = InsertionSpec.parse(config.getString(Keys.OFFSET_FIELD));
-        timestampField = InsertionSpec.parse(config.getString(Keys.TIMESTAMP_FIELD));
-        staticField = InsertionSpec.parse(config.getString(Keys.STATIC_FIELD));
-        staticValue = config.getString(Keys.STATIC_VALUE);
-        applicable = topicField != null || partitionField != null || offsetField != null || timestampField != null;
+        topicField = InsertionSpec.parse(config.getString(ConfigName.TOPIC_FIELD));
+        partitionField = InsertionSpec.parse(config.getString(ConfigName.PARTITION_FIELD));
+        offsetField = InsertionSpec.parse(config.getString(ConfigName.OFFSET_FIELD));
+        timestampField = InsertionSpec.parse(config.getString(ConfigName.TIMESTAMP_FIELD));
+        staticField = InsertionSpec.parse(config.getString(ConfigName.STATIC_FIELD));
+        staticValue = config.getString(ConfigName.STATIC_VALUE);
+
+        if (topicField == null && partitionField == null && offsetField == null && timestampField == null && staticField == null) {
+            throw new ConfigException("No field insertion configured");
+        }
+
+        if (staticField != null && staticValue == null) {
+            throw new ConfigException(ConfigName.STATIC_VALUE, null, "No value specified for static field: " + staticField);
+        }
 
         schemaUpdateCache = new SynchronizedCache<>(new LRUCache<Schema, Schema>(16));
     }
 
     @Override
     public R apply(R record) {
-        if (!applicable) return record;
-
-        final Schema schema = operatingSchema(record);
-        final Object value = operatingValue(record);
-
-        if (value == null)
-            throw new DataException("null value");
-
-        if (schema == null) {
-            if (!(value instanceof Map))
-                throw new DataException("Can only operate on Map value in schemaless mode: " + value.getClass().getName());
-            return applySchemaless(record, (Map<String, Object>) value);
+        if (operatingSchema(record) == null) {
+            return applySchemaless(record);
         } else {
-            if (schema.type() != Schema.Type.STRUCT)
-                throw new DataException("Can only operate on Struct types: " + value.getClass().getName());
-            return applyWithSchema(record, schema, (Struct) value);
+            return applyWithSchema(record);
         }
     }
 
-    private R applySchemaless(R record, Map<String, Object> value) {
+    private R applySchemaless(R record) {
+        final Map<String, Object> value = requireMap(operatingValue(record), PURPOSE);
+
         final Map<String, Object> updatedValue = new HashMap<>(value);
 
         if (topicField != null) {
@@ -140,9 +147,7 @@ private R applySchemaless(R record, Map<String, Object> value) {
             updatedValue.put(partitionField.name, record.kafkaPartition());
         }
         if (offsetField != null) {
-            if (!(record instanceof SinkRecord))
-                throw new DataException("Offset insertion is only supported for sink connectors, record is of type: " + record.getClass());
-            updatedValue.put(offsetField.name, ((SinkRecord) record).kafkaOffset());
+            updatedValue.put(offsetField.name, requireSinkRecord(record, PURPOSE).kafkaOffset());
         }
         if (timestampField != null && record.timestamp() != null) {
             updatedValue.put(timestampField.name, record.timestamp());
@@ -150,36 +155,46 @@ private R applySchemaless(R record, Map<String, Object> value) {
         if (staticField != null && staticValue != null) {
             updatedValue.put(staticField.name, staticValue);
         }
+
         return newRecord(record, null, updatedValue);
     }
 
-    private R applyWithSchema(R record, Schema schema, Struct value) {
-        Schema updatedSchema = schemaUpdateCache.get(schema);
+    private R applyWithSchema(R record) {
+        final Struct value = requireStruct(operatingValue(record), PURPOSE);
+
+        Schema updatedSchema = schemaUpdateCache.get(value.schema());
         if (updatedSchema == null) {
-            updatedSchema = makeUpdatedSchema(schema);
-            schemaUpdateCache.put(schema, updatedSchema);
+            updatedSchema = makeUpdatedSchema(value.schema());
+            schemaUpdateCache.put(value.schema(), updatedSchema);
         }
 
         final Struct updatedValue = new Struct(updatedSchema);
 
-        copyFields(value, updatedValue);
+        for (Field field : value.schema().fields()) {
+            updatedValue.put(field.name(), value.get(field));
+        }
 
-        insertFields(record, updatedValue);
+        if (topicField != null) {
+            updatedValue.put(topicField.name, record.topic());
+        }
+        if (partitionField != null && record.kafkaPartition() != null) {
+            updatedValue.put(partitionField.name, record.kafkaPartition());
+        }
+        if (offsetField != null) {
+            updatedValue.put(offsetField.name, requireSinkRecord(record, PURPOSE).kafkaOffset());
+        }
+        if (timestampField != null && record.timestamp() != null) {
+            updatedValue.put(timestampField.name, new Date(record.timestamp()));
+        }
+        if (staticField != null && staticValue != null) {
+            updatedValue.put(staticField.name, staticValue);
+        }
 
         return newRecord(record, updatedSchema, updatedValue);
     }
 
     private Schema makeUpdatedSchema(Schema schema) {
-        final SchemaBuilder builder = SchemaBuilder.struct();
-
-        builder.name(schema.name());
-        builder.version(schema.version());
-        builder.doc(schema.doc());
-
-        final Map<String, String> params = schema.parameters();
-        if (params != null) {
-            builder.parameters(params);
-        }
+        final SchemaBuilder builder = SchemaUtil.copySchemaBasics(schema, SchemaBuilder.struct());
 
         for (Field field : schema.fields()) {
             builder.field(field.name(), field.schema());
@@ -204,33 +219,6 @@ private Schema makeUpdatedSchema(Schema schema) {
         return builder.build();
     }
 
-    private void copyFields(Struct value, Struct updatedValue) {
-        for (Field field : value.schema().fields()) {
-            updatedValue.put(field.name(), value.get(field));
-        }
-    }
-
-    private void insertFields(R record, Struct value) {
-        if (topicField != null) {
-            value.put(topicField.name, record.topic());
-        }
-        if (partitionField != null && record.kafkaPartition() != null) {
-            value.put(partitionField.name, record.kafkaPartition());
-        }
-        if (offsetField != null) {
-            if (!(record instanceof SinkRecord)) {
-                throw new DataException("Offset insertion is only supported for sink connectors, record is of type: " + record.getClass());
-            }
-            value.put(offsetField.name, ((SinkRecord) record).kafkaOffset());
-        }
-        if (timestampField != null && record.timestamp() != null) {
-            value.put(timestampField.name, new Date(record.timestamp()));
-        }
-        if (staticField != null && staticValue != null) {
-            value.put(staticField.name, staticValue);
-        }
-    }
-
     @Override
     public void close() {
         schemaUpdateCache = null;
@@ -247,10 +235,6 @@ public ConfigDef config() {
 
     protected abstract R newRecord(R record, Schema updatedSchema, Object updatedValue);
 
-    /**
-     * This transformation allows inserting configured attributes of the record metadata as fields in the record key.
-     * It also allows adding a static data field.
-     */
     public static class Key<R extends ConnectRecord<R>> extends InsertField<R> {
 
         @Override
@@ -270,10 +254,6 @@ protected R newRecord(R record, Schema updatedSchema, Object updatedValue) {
 
     }
 
-    /**
-     * This transformation allows inserting configured attributes of the record metadata as fields in the record value.
-     * It also allows adding a static data field.
-     */
     public static class Value<R extends ConnectRecord<R>> extends InsertField<R> {
 
         @Override
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/MaskField.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/MaskField.java
new file mode 100644
index 0000000000000..d7ef2aa8429ad
--- /dev/null
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/MaskField.java
@@ -0,0 +1,172 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p/>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p/>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms;
+
+import org.apache.kafka.common.config.ConfigDef;
+import org.apache.kafka.connect.connector.ConnectRecord;
+import org.apache.kafka.connect.data.Field;
+import org.apache.kafka.connect.data.Schema;
+import org.apache.kafka.connect.data.Struct;
+import org.apache.kafka.connect.errors.DataException;
+import org.apache.kafka.connect.transforms.util.NonEmptyListValidator;
+import org.apache.kafka.connect.transforms.util.SimpleConfig;
+
+import java.math.BigDecimal;
+import java.math.BigInteger;
+import java.util.Collections;
+import java.util.Date;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static org.apache.kafka.connect.transforms.util.Requirements.requireMap;
+import static org.apache.kafka.connect.transforms.util.Requirements.requireStruct;
+
+public abstract class MaskField<R extends ConnectRecord<R>> implements Transformation<R> {
+
+    public static final String OVERVIEW_DOC =
+            "Mask specified fields with a valid null value for the field type (i.e. 0, false, empty string, and so on)."
+                    + "<p/>Use the concrete transformation type designed for the record key (<code>" + Key.class.getCanonicalName() + "</code>) "
+                    + "or value (<code>" + Value.class.getCanonicalName() + "</code>).";
+
+    private static final String FIELDS_CONFIG = "fields";
+
+    public static final ConfigDef CONFIG_DEF = new ConfigDef()
+            .define(FIELDS_CONFIG, ConfigDef.Type.LIST, ConfigDef.NO_DEFAULT_VALUE, new NonEmptyListValidator(), ConfigDef.Importance.HIGH, "Names of fields to mask.");
+
+    private static final String PURPOSE = "mask fields";
+
+    private static final Map<Class<?>, Object> PRIMITIVE_VALUE_MAPPING = new HashMap<>();
+
+    static {
+        PRIMITIVE_VALUE_MAPPING.put(Boolean.class, Boolean.FALSE);
+        PRIMITIVE_VALUE_MAPPING.put(Byte.class, (byte) 0);
+        PRIMITIVE_VALUE_MAPPING.put(Short.class, (short) 0);
+        PRIMITIVE_VALUE_MAPPING.put(Integer.class, 0);
+        PRIMITIVE_VALUE_MAPPING.put(Long.class, 0L);
+        PRIMITIVE_VALUE_MAPPING.put(Float.class, 0f);
+        PRIMITIVE_VALUE_MAPPING.put(Double.class, 0d);
+        PRIMITIVE_VALUE_MAPPING.put(BigInteger.class, BigInteger.ZERO);
+        PRIMITIVE_VALUE_MAPPING.put(BigDecimal.class, BigDecimal.ZERO);
+        PRIMITIVE_VALUE_MAPPING.put(Date.class, new Date(0));
+        PRIMITIVE_VALUE_MAPPING.put(String.class, "");
+    }
+
+    private Set<String> maskedFields;
+
+    @Override
+    public void configure(Map<String, ?> props) {
+        final SimpleConfig config = new SimpleConfig(CONFIG_DEF, props);
+        maskedFields = new HashSet<>(config.getList(FIELDS_CONFIG));
+    }
+
+    @Override
+    public R apply(R record) {
+        if (operatingSchema(record) == null) {
+            return applySchemaless(record);
+        } else {
+            return applyWithSchema(record);
+        }
+    }
+
+    private R applySchemaless(R record) {
+        final Map<String, Object> value = requireMap(operatingValue(record), PURPOSE);
+        final HashMap<String, Object> updatedValue = new HashMap<>(value);
+        for (String field : maskedFields) {
+            updatedValue.put(field, masked(value.get(field)));
+        }
+        return newRecord(record, updatedValue);
+    }
+
+    private R applyWithSchema(R record) {
+        final Struct value = requireStruct(operatingValue(record), PURPOSE);
+        final Struct updatedValue = new Struct(value.schema());
+        for (Field field : value.schema().fields()) {
+            final Object origFieldValue = value.get(field);
+            updatedValue.put(field, maskedFields.contains(field.name()) ? masked(origFieldValue) : origFieldValue);
+        }
+        return newRecord(record, updatedValue);
+    }
+
+    private static Object masked(Object value) {
+        if (value == null)
+            return null;
+        Object maskedValue = PRIMITIVE_VALUE_MAPPING.get(value.getClass());
+        if (maskedValue == null) {
+            if (value instanceof List)
+                maskedValue = Collections.emptyList();
+            else if (value instanceof Map)
+                maskedValue = Collections.emptyMap();
+            else
+                throw new DataException("Cannot mask value of type: " + value.getClass());
+        }
+        return maskedValue;
+    }
+
+    @Override
+    public ConfigDef config() {
+        return CONFIG_DEF;
+    }
+
+    @Override
+    public void close() {
+    }
+
+    protected abstract Schema operatingSchema(R record);
+
+    protected abstract Object operatingValue(R record);
+
+    protected abstract R newRecord(R base, Object value);
+
+    public static final class Key<R extends ConnectRecord<R>> extends MaskField<R> {
+        @Override
+        protected Schema operatingSchema(R record) {
+            return record.keySchema();
+        }
+
+        @Override
+        protected Object operatingValue(R record) {
+            return record.key();
+        }
+
+        @Override
+        protected R newRecord(R record, Object updatedValue) {
+            return record.newRecord(record.topic(), record.kafkaPartition(), record.keySchema(), updatedValue, record.valueSchema(), record.value(), record.timestamp());
+        }
+    }
+
+    public static final class Value<R extends ConnectRecord<R>> extends MaskField<R> {
+        @Override
+        protected Schema operatingSchema(R record) {
+            return record.valueSchema();
+        }
+
+        @Override
+        protected Object operatingValue(R record) {
+            return record.value();
+        }
+
+        @Override
+        protected R newRecord(R record, Object updatedValue) {
+            return record.newRecord(record.topic(), record.kafkaPartition(), record.keySchema(), record.key(), record.valueSchema(), updatedValue, record.timestamp());
+        }
+    }
+
+}
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/RegexRouter.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/RegexRouter.java
new file mode 100644
index 0000000000000..f16560e3c5748
--- /dev/null
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/RegexRouter.java
@@ -0,0 +1,75 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms;
+
+import org.apache.kafka.common.config.ConfigDef;
+import org.apache.kafka.connect.connector.ConnectRecord;
+import org.apache.kafka.connect.transforms.util.RegexValidator;
+import org.apache.kafka.connect.transforms.util.SimpleConfig;
+
+import java.util.Map;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+public class RegexRouter<R extends ConnectRecord<R>> implements Transformation<R> {
+
+    public static final String OVERVIEW_DOC = "Update the record topic using the configured regular expression and replacement string."
+            + "<p/>Under the hood, the regex is compiled to a <code>java.util.regex.Pattern</code>. "
+            + "If the pattern matches the input topic, <code>java.util.regex.Matcher#replaceFirst()</code> is used with the replacement string to obtain the new topic.";
+
+    public static final ConfigDef CONFIG_DEF = new ConfigDef()
+            .define(ConfigName.REGEX, ConfigDef.Type.STRING, ConfigDef.NO_DEFAULT_VALUE, new RegexValidator(), ConfigDef.Importance.HIGH,
+                    "Regular expression to use for matching.")
+            .define(ConfigName.REPLACEMENT, ConfigDef.Type.STRING, ConfigDef.NO_DEFAULT_VALUE, ConfigDef.Importance.HIGH,
+                    "Replacement string.");
+
+    private interface ConfigName {
+        String REGEX = "regex";
+        String REPLACEMENT = "replacement";
+    }
+
+    private Pattern regex;
+    private String replacement;
+
+    @Override
+    public void configure(Map<String, ?> props) {
+        final SimpleConfig config = new SimpleConfig(CONFIG_DEF, props);
+        regex = Pattern.compile(config.getString(ConfigName.REGEX));
+        replacement = config.getString(ConfigName.REPLACEMENT);
+    }
+
+    @Override
+    public R apply(R record) {
+        final Matcher matcher = regex.matcher(record.topic());
+        if (matcher.matches()) {
+            final String topic = matcher.replaceFirst(replacement);
+            return record.newRecord(topic, record.kafkaPartition(), record.keySchema(), record.key(), record.valueSchema(), record.value(), record.timestamp());
+        }
+        return record;
+    }
+
+    @Override
+    public void close() {
+    }
+
+    @Override
+    public ConfigDef config() {
+        return CONFIG_DEF;
+    }
+
+}
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ReplaceField.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ReplaceField.java
new file mode 100644
index 0000000000000..6faf84250af07
--- /dev/null
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ReplaceField.java
@@ -0,0 +1,230 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms;
+
+import org.apache.kafka.common.cache.Cache;
+import org.apache.kafka.common.cache.LRUCache;
+import org.apache.kafka.common.cache.SynchronizedCache;
+import org.apache.kafka.common.config.ConfigDef;
+import org.apache.kafka.common.config.ConfigException;
+import org.apache.kafka.connect.connector.ConnectRecord;
+import org.apache.kafka.connect.data.Field;
+import org.apache.kafka.connect.data.Schema;
+import org.apache.kafka.connect.data.SchemaBuilder;
+import org.apache.kafka.connect.data.Struct;
+import org.apache.kafka.connect.transforms.util.SchemaUtil;
+import org.apache.kafka.connect.transforms.util.SimpleConfig;
+
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static org.apache.kafka.connect.transforms.util.Requirements.requireMap;
+import static org.apache.kafka.connect.transforms.util.Requirements.requireStruct;
+
+public abstract class ReplaceField<R extends ConnectRecord<R>> implements Transformation<R> {
+
+    public static final String OVERVIEW_DOC = "Filter or rename fields.";
+
+    interface ConfigName {
+        String BLACKLIST = "blacklist";
+        String WHITELIST = "whitelist";
+        String RENAME = "renames";
+    }
+
+    public static final ConfigDef CONFIG_DEF = new ConfigDef()
+            .define(ConfigName.BLACKLIST, ConfigDef.Type.LIST, Collections.emptyList(), ConfigDef.Importance.MEDIUM,
+                    "Fields to exclude. This takes precedence over the whitelist.")
+            .define(ConfigName.WHITELIST, ConfigDef.Type.LIST, Collections.emptyList(), ConfigDef.Importance.MEDIUM,
+                    "Fields to include. If specified, only these fields will be used.")
+            .define(ConfigName.RENAME, ConfigDef.Type.LIST, Collections.emptyList(), new ConfigDef.Validator() {
+                @Override
+                public void ensureValid(String name, Object value) {
+                    parseRenameMappings((List<String>) value);
+                }
+
+                @Override
+                public String toString() {
+                    return "list of colon-delimited pairs, e.g. <code>foo:bar,abc:xyz</code>";
+                }
+            }, ConfigDef.Importance.MEDIUM, "Field rename mappings.");
+
+    private static final String PURPOSE = "field replacement";
+
+    private List<String> blacklist;
+    private List<String> whitelist;
+    private Map<String, String> renames;
+    private Map<String, String> reverseRenames;
+
+    private Cache<Schema, Schema> schemaUpdateCache;
+
+    @Override
+    public void configure(Map<String, ?> configs) {
+        final SimpleConfig config = new SimpleConfig(CONFIG_DEF, configs);
+        blacklist = config.getList(ConfigName.BLACKLIST);
+        whitelist = config.getList(ConfigName.WHITELIST);
+        renames = parseRenameMappings(config.getList(ConfigName.RENAME));
+        reverseRenames = invert(renames);
+
+        schemaUpdateCache = new SynchronizedCache<>(new LRUCache<Schema, Schema>(16));
+    }
+
+    static Map<String, String> parseRenameMappings(List<String> mappings) {
+        final Map<String, String> m = new HashMap<>();
+        for (String mapping : mappings) {
+            final String[] parts = mapping.split(":");
+            if (parts.length != 2) {
+                throw new ConfigException(ConfigName.RENAME, mappings, "Invalid rename mapping: " + mapping);
+            }
+            m.put(parts[0], parts[1]);
+        }
+        return m;
+    }
+
+    static Map<String, String> invert(Map<String, String> source) {
+        final Map<String, String> m = new HashMap<>();
+        for (Map.Entry<String, String> e : source.entrySet()) {
+            m.put(e.getValue(), e.getKey());
+        }
+        return m;
+    }
+
+    boolean filter(String fieldName) {
+        return !blacklist.contains(fieldName) && (whitelist.isEmpty() || whitelist.contains(fieldName));
+    }
+
+    String renamed(String fieldName) {
+        final String mapping = renames.get(fieldName);
+        return mapping == null ? fieldName : mapping;
+    }
+
+    String reverseRenamed(String fieldName) {
+        final String mapping = reverseRenames.get(fieldName);
+        return mapping == null ? fieldName : mapping;
+    }
+
+    @Override
+    public R apply(R record) {
+        if (operatingSchema(record) == null) {
+            return applySchemaless(record);
+        } else {
+            return applyWithSchema(record);
+        }
+    }
+
+    private R applySchemaless(R record) {
+        final Map<String, Object> value = requireMap(operatingValue(record), PURPOSE);
+
+        final Map<String, Object> updatedValue = new HashMap<>(value.size());
+
+        for (Map.Entry<String, Object> e : value.entrySet()) {
+            final String fieldName = e.getKey();
+            if (filter(fieldName)) {
+                final Object fieldValue = e.getValue();
+                updatedValue.put(renamed(fieldName), fieldValue);
+            }
+        }
+
+        return newRecord(record, null, updatedValue);
+    }
+
+    private R applyWithSchema(R record) {
+        final Struct value = requireStruct(operatingValue(record), PURPOSE);
+
+        Schema updatedSchema = schemaUpdateCache.get(value.schema());
+        if (updatedSchema == null) {
+            updatedSchema = makeUpdatedSchema(value.schema());
+            schemaUpdateCache.put(value.schema(), updatedSchema);
+        }
+
+        final Struct updatedValue = new Struct(updatedSchema);
+
+        for (Field field : updatedSchema.fields()) {
+            final Object fieldValue = value.get(reverseRenamed(field.name()));
+            updatedValue.put(field.name(), fieldValue);
+        }
+
+        return newRecord(record, updatedSchema, updatedValue);
+    }
+
+    private Schema makeUpdatedSchema(Schema schema) {
+        final SchemaBuilder builder = SchemaUtil.copySchemaBasics(schema, SchemaBuilder.struct());
+        for (Field field : schema.fields()) {
+            if (filter(field.name())) {
+                builder.field(renamed(field.name()), field.schema());
+            }
+        }
+        return builder.build();
+    }
+
+    @Override
+    public ConfigDef config() {
+        return CONFIG_DEF;
+    }
+
+    @Override
+    public void close() {
+        schemaUpdateCache = null;
+    }
+
+    protected abstract Schema operatingSchema(R record);
+
+    protected abstract Object operatingValue(R record);
+
+    protected abstract R newRecord(R record, Schema updatedSchema, Object updatedValue);
+
+    public static class Key<R extends ConnectRecord<R>> extends ReplaceField<R> {
+
+        @Override
+        protected Schema operatingSchema(R record) {
+            return record.keySchema();
+        }
+
+        @Override
+        protected Object operatingValue(R record) {
+            return record.key();
+        }
+
+        @Override
+        protected R newRecord(R record, Schema updatedSchema, Object updatedValue) {
+            return record.newRecord(record.topic(), record.kafkaPartition(), updatedSchema, updatedValue, record.valueSchema(), record.value(), record.timestamp());
+        }
+
+    }
+
+    public static class Value<R extends ConnectRecord<R>> extends ReplaceField<R> {
+
+        @Override
+        protected Schema operatingSchema(R record) {
+            return record.valueSchema();
+        }
+
+        @Override
+        protected Object operatingValue(R record) {
+            return record.value();
+        }
+
+        @Override
+        protected R newRecord(R record, Schema updatedSchema, Object updatedValue) {
+            return record.newRecord(record.topic(), record.kafkaPartition(), record.keySchema(), record.key(), updatedSchema, updatedValue, record.timestamp());
+        }
+
+    }
+
+}
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/SetSchemaMetadata.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/SetSchemaMetadata.java
new file mode 100644
index 0000000000000..f3076b445719b
--- /dev/null
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/SetSchemaMetadata.java
@@ -0,0 +1,124 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms;
+
+import org.apache.kafka.common.config.ConfigDef;
+import org.apache.kafka.common.config.ConfigException;
+import org.apache.kafka.connect.connector.ConnectRecord;
+import org.apache.kafka.connect.data.ConnectSchema;
+import org.apache.kafka.connect.data.Schema;
+import org.apache.kafka.connect.transforms.util.SimpleConfig;
+
+import java.util.Map;
+
+import static org.apache.kafka.connect.transforms.util.Requirements.requireSchema;
+
+public abstract class SetSchemaMetadata<R extends ConnectRecord<R>> implements Transformation<R> {
+
+    public static final String OVERVIEW_DOC =
+            "Set the schema name, version or both on the record's key (<code>" + Key.class.getCanonicalName() + "</code>)"
+                    + " or value (<code>" + Value.class.getCanonicalName() + "</code>) schema.";
+
+    private interface ConfigName {
+        String SCHEMA_NAME = "schema.name";
+        String SCHEMA_VERSION = "schema.version";
+    }
+
+    public static final ConfigDef CONFIG_DEF = new ConfigDef()
+            .define(ConfigName.SCHEMA_NAME, ConfigDef.Type.STRING, null, ConfigDef.Importance.HIGH, "Schema name to set.")
+            .define(ConfigName.SCHEMA_VERSION, ConfigDef.Type.INT, null, ConfigDef.Importance.HIGH, "Schema version to set.");
+
+    private String schemaName;
+    private Integer schemaVersion;
+
+    @Override
+    public void configure(Map<String, ?> configs) {
+        final SimpleConfig config = new SimpleConfig(CONFIG_DEF, configs);
+        schemaName = config.getString(ConfigName.SCHEMA_NAME);
+        schemaVersion = config.getInt(ConfigName.SCHEMA_VERSION);
+
+        if (schemaName == null && schemaVersion == null) {
+            throw new ConfigException("Neither schema name nor version configured");
+        }
+    }
+
+    @Override
+    public R apply(R record) {
+        final Schema schema = operatingSchema(record);
+        requireSchema(schema, "updating schema metadata");
+        final boolean isArray = schema.type() == Schema.Type.ARRAY;
+        final boolean isMap = schema.type() == Schema.Type.MAP;
+        final Schema updatedSchema = new ConnectSchema(
+                schema.type(),
+                schema.isOptional(),
+                schema.defaultValue(),
+                schemaName != null ? schemaName : schema.name(),
+                schemaVersion != null ? schemaVersion : schema.version(),
+                schema.doc(),
+                schema.parameters(),
+                schema.fields(),
+                isMap ? schema.keySchema() : null,
+                isMap || isArray ? schema.valueSchema() : null
+        );
+        return newRecord(record, updatedSchema);
+    }
+
+    @Override
+    public ConfigDef config() {
+        return CONFIG_DEF;
+    }
+
+    @Override
+    public void close() {
+    }
+
+    protected abstract Schema operatingSchema(R record);
+
+    protected abstract R newRecord(R record, Schema updatedSchema);
+
+    /**
+     * Set the schema name, version or both on the record's key schema.
+     */
+    public static class Key<R extends ConnectRecord<R>> extends SetSchemaMetadata<R> {
+        @Override
+        protected Schema operatingSchema(R record) {
+            return record.keySchema();
+        }
+
+        @Override
+        protected R newRecord(R record, Schema updatedSchema) {
+            return record.newRecord(record.topic(), record.kafkaPartition(), updatedSchema, record.key(), record.valueSchema(), record.value(), record.timestamp());
+        }
+    }
+
+    /**
+     * Set the schema name, version or both on the record's value schema.
+     */
+    public static class Value<R extends ConnectRecord<R>> extends SetSchemaMetadata<R> {
+        @Override
+        protected Schema operatingSchema(R record) {
+            return record.valueSchema();
+        }
+
+        @Override
+        protected R newRecord(R record, Schema updatedSchema) {
+            return record.newRecord(record.topic(), record.kafkaPartition(), record.keySchema(), record.key(), updatedSchema, record.value(), record.timestamp());
+        }
+    }
+
+}
\ No newline at end of file
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/TimestampRouter.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/TimestampRouter.java
index 1dd5345a6091a..f917a8d65f09a 100644
--- a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/TimestampRouter.java
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/TimestampRouter.java
@@ -27,25 +27,25 @@
 import java.util.Map;
 import java.util.TimeZone;
 
-/**
- * This transformation facilitates updating the record's topic field as a function of the original topic value and the record timestamp.
- * <p/>
- * It is mainly useful for sink connectors, since the topic field is often used to determine the equivalent entity name in the destination system
- * (e.g. database table or search index name).
- */
 public class TimestampRouter<R extends ConnectRecord<R>> implements Transformation<R> {
 
-    public interface Keys {
+    public static final String OVERVIEW_DOC =
+            "Update the record's topic field as a function of the original topic value and the record timestamp."
+                    + "<p/>"
+                    + "This is mainly useful for sink connectors, since the topic field is often used to determine the equivalent entity name in the destination system"
+                    + "(e.g. database table or search index name).";
+
+    public static final ConfigDef CONFIG_DEF = new ConfigDef()
+            .define(ConfigName.TOPIC_FORMAT, ConfigDef.Type.STRING, "${topic}-${timestamp}", ConfigDef.Importance.HIGH,
+                    "Format string which can contain <code>${topic}</code> and <code>${timestamp}</code> as placeholders for the topic and timestamp, respectively.")
+            .define(ConfigName.TIMESTAMP_FORMAT, ConfigDef.Type.STRING, "yyyyMMdd", ConfigDef.Importance.HIGH,
+                    "Format string for the timestamp that is compatible with <code>java.text.SimpleDateFormat</code>.");
+
+    private interface ConfigName {
         String TOPIC_FORMAT = "topic.format";
         String TIMESTAMP_FORMAT = "timestamp.format";
     }
 
-    private static final ConfigDef CONFIG_DEF = new ConfigDef()
-            .define(Keys.TOPIC_FORMAT, ConfigDef.Type.STRING, "${topic}-${timestamp}", ConfigDef.Importance.HIGH,
-                    "Format string which can contain ``${topic}`` and ``${timestamp}`` as placeholders for the topic and timestamp, respectively.")
-            .define(Keys.TIMESTAMP_FORMAT, ConfigDef.Type.STRING, "yyyyMMdd", ConfigDef.Importance.HIGH,
-                    "Format string for the timestamp that is compatible with java.text.SimpleDateFormat.");
-
     private String topicFormat;
     private ThreadLocal<SimpleDateFormat> timestampFormat;
 
@@ -53,9 +53,9 @@ public interface Keys {
     public void configure(Map<String, ?> props) {
         final SimpleConfig config = new SimpleConfig(CONFIG_DEF, props);
 
-        topicFormat = config.getString(Keys.TOPIC_FORMAT);
+        topicFormat = config.getString(ConfigName.TOPIC_FORMAT);
 
-        final String timestampFormatStr = config.getString(Keys.TIMESTAMP_FORMAT);
+        final String timestampFormatStr = config.getString(ConfigName.TIMESTAMP_FORMAT);
         timestampFormat = new ThreadLocal<SimpleDateFormat>() {
             @Override
             protected SimpleDateFormat initialValue() {
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ValueToKey.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ValueToKey.java
new file mode 100644
index 0000000000000..504da541f6574
--- /dev/null
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ValueToKey.java
@@ -0,0 +1,111 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms;
+
+import org.apache.kafka.common.cache.Cache;
+import org.apache.kafka.common.cache.LRUCache;
+import org.apache.kafka.common.cache.SynchronizedCache;
+import org.apache.kafka.common.config.ConfigDef;
+import org.apache.kafka.connect.connector.ConnectRecord;
+import org.apache.kafka.connect.data.Schema;
+import org.apache.kafka.connect.data.SchemaBuilder;
+import org.apache.kafka.connect.data.Struct;
+import org.apache.kafka.connect.transforms.util.NonEmptyListValidator;
+import org.apache.kafka.connect.transforms.util.SimpleConfig;
+
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static org.apache.kafka.connect.transforms.util.Requirements.requireMap;
+import static org.apache.kafka.connect.transforms.util.Requirements.requireStruct;
+
+public class ValueToKey<R extends ConnectRecord<R>> implements Transformation<R> {
+
+    public static final String OVERVIEW_DOC = "Replace the record key with a new key formed from a subset of fields in the record value.";
+
+    public static final String FIELDS_CONFIG = "fields";
+
+    public static final ConfigDef CONFIG_DEF = new ConfigDef()
+            .define(FIELDS_CONFIG, ConfigDef.Type.LIST, ConfigDef.NO_DEFAULT_VALUE, new NonEmptyListValidator(), ConfigDef.Importance.HIGH,
+                    "Field names on the record value to extract as the record key.");
+
+    private static final String PURPOSE = "copying fields from value to key";
+
+    private List<String> fields;
+
+    private Cache<Schema, Schema> valueToKeySchemaCache;
+
+    @Override
+    public void configure(Map<String, ?> configs) {
+        final SimpleConfig config = new SimpleConfig(CONFIG_DEF, configs);
+        fields = config.getList(FIELDS_CONFIG);
+        valueToKeySchemaCache = new SynchronizedCache<>(new LRUCache<Schema, Schema>(16));
+    }
+
+    @Override
+    public R apply(R record) {
+        if (record.valueSchema() == null) {
+            return applySchemaless(record);
+        } else {
+            return applyWithSchema(record);
+        }
+    }
+
+    private R applySchemaless(R record) {
+        final Map<String, Object> value = requireMap(record.value(), PURPOSE);
+        final Map<String, Object> key = new HashMap<>(fields.size());
+        for (String field : fields) {
+            key.put(field, value.get(field));
+        }
+        return record.newRecord(record.topic(), record.kafkaPartition(), null, key, record.valueSchema(), record.value(), record.timestamp());
+    }
+
+    private R applyWithSchema(R record) {
+        final Struct value = requireStruct(record.value(), PURPOSE);
+
+        Schema keySchema = valueToKeySchemaCache.get(value.schema());
+        if (keySchema == null) {
+            final SchemaBuilder keySchemaBuilder = SchemaBuilder.struct();
+            for (String field : fields) {
+                final Schema fieldSchema = value.schema().field(field).schema();
+                keySchemaBuilder.field(field, fieldSchema);
+            }
+            keySchema = keySchemaBuilder.build();
+            valueToKeySchemaCache.put(value.schema(), keySchema);
+        }
+
+        final Struct key = new Struct(keySchema);
+        for (String field : fields) {
+            key.put(field, value.get(field));
+        }
+
+        return record.newRecord(record.topic(), record.kafkaPartition(), keySchema, key, value.schema(), value, record.timestamp());
+    }
+
+    @Override
+    public ConfigDef config() {
+        return CONFIG_DEF;
+    }
+
+    @Override
+    public void close() {
+        valueToKeySchemaCache = null;
+    }
+
+}
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/NonEmptyListValidator.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/NonEmptyListValidator.java
new file mode 100644
index 0000000000000..1abbbc8aaf081
--- /dev/null
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/NonEmptyListValidator.java
@@ -0,0 +1,39 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms.util;
+
+import org.apache.kafka.common.config.ConfigDef;
+import org.apache.kafka.common.config.ConfigException;
+
+import java.util.List;
+
+public class NonEmptyListValidator implements ConfigDef.Validator {
+
+    @Override
+    public void ensureValid(String name, Object value) {
+        if (((List) value).isEmpty()) {
+            throw new ConfigException(name, value, "Empty list");
+        }
+    }
+
+    @Override
+    public String toString() {
+        return "non-empty list";
+    }
+
+}
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/RegexValidator.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/RegexValidator.java
new file mode 100644
index 0000000000000..9713b27446f47
--- /dev/null
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/RegexValidator.java
@@ -0,0 +1,41 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms.util;
+
+import org.apache.kafka.common.config.ConfigDef;
+import org.apache.kafka.common.config.ConfigException;
+
+import java.util.regex.Pattern;
+
+public class RegexValidator implements ConfigDef.Validator {
+
+    @Override
+    public void ensureValid(String name, Object value) {
+        try {
+            Pattern.compile((String) value);
+        } catch (Exception e) {
+            throw new ConfigException(name, value, "Invalid regex: " + e.getMessage());
+        }
+    }
+
+    @Override
+    public String toString() {
+        return "valid regex";
+    }
+
+}
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/Requirements.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/Requirements.java
new file mode 100644
index 0000000000000..b004f8ae91500
--- /dev/null
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/Requirements.java
@@ -0,0 +1,61 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms.util;
+
+import org.apache.kafka.connect.connector.ConnectRecord;
+import org.apache.kafka.connect.data.Schema;
+import org.apache.kafka.connect.data.Struct;
+import org.apache.kafka.connect.errors.DataException;
+import org.apache.kafka.connect.sink.SinkRecord;
+
+import java.util.Map;
+
+public class Requirements {
+
+    public static void requireSchema(Schema schema, String purpose) {
+        if (schema == null) {
+            throw new DataException("Schema required for [" + purpose + "]");
+        }
+    }
+
+    public static Map<String, Object> requireMap(Object value, String purpose) {
+        if (!(value instanceof Map)) {
+            throw new DataException("Only Map objects supported in absence of schema for [" + purpose + "], found: " + nullSafeClassName(value));
+        }
+        return (Map<String, Object>) value;
+    }
+
+    public static Struct requireStruct(Object value, String purpose) {
+        if (!(value instanceof Struct)) {
+            throw new DataException("Only Struct objects supported for [" + purpose + "], found: " + nullSafeClassName(value));
+        }
+        return (Struct) value;
+    }
+
+    public static SinkRecord requireSinkRecord(ConnectRecord<?> record, String purpose) {
+        if (!(record instanceof SinkRecord)) {
+            throw new DataException("Only SinkRecord supported for [" + purpose + "], found: " + nullSafeClassName(record));
+        }
+        return (SinkRecord) record;
+    }
+
+    private static String nullSafeClassName(Object x) {
+        return x == null ? "null" : x.getClass().getCanonicalName();
+    }
+
+}
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/SchemaUtil.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/SchemaUtil.java
new file mode 100644
index 0000000000000..da261e79b22de
--- /dev/null
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/util/SchemaUtil.java
@@ -0,0 +1,40 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p/>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p/>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms.util;
+
+import org.apache.kafka.connect.data.Schema;
+import org.apache.kafka.connect.data.SchemaBuilder;
+
+import java.util.Map;
+
+public class SchemaUtil {
+
+    public static SchemaBuilder copySchemaBasics(Schema source, SchemaBuilder builder) {
+        builder.name(source.name());
+        builder.version(source.version());
+        builder.doc(source.doc());
+
+        final Map<String, String> params = source.parameters();
+        if (params != null) {
+            builder.parameters(params);
+        }
+
+        return builder;
+    }
+
+}
diff --git a/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/ExtractFieldTest.java b/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/ExtractFieldTest.java
new file mode 100644
index 0000000000000..d72179559a50a
--- /dev/null
+++ b/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/ExtractFieldTest.java
@@ -0,0 +1,59 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p/>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p/>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms;
+
+import org.apache.kafka.connect.data.Schema;
+import org.apache.kafka.connect.data.SchemaBuilder;
+import org.apache.kafka.connect.data.Struct;
+import org.apache.kafka.connect.sink.SinkRecord;
+import org.junit.Test;
+
+import java.util.Collections;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNull;
+
+public class ExtractFieldTest {
+
+    @Test
+    public void schemaless() {
+        final ExtractField<SinkRecord> xform = new ExtractField.Key<>();
+        xform.configure(Collections.singletonMap("field", "magic"));
+
+        final SinkRecord record = new SinkRecord("test", 0, null, Collections.singletonMap("magic", 42), null, null, 0);
+        final SinkRecord transformedRecord = xform.apply(record);
+
+        assertNull(transformedRecord.keySchema());
+        assertEquals(42, transformedRecord.key());
+    }
+
+    @Test
+    public void withSchema() {
+        final ExtractField<SinkRecord> xform = new ExtractField.Key<>();
+        xform.configure(Collections.singletonMap("field", "magic"));
+
+        final Schema keySchema = SchemaBuilder.struct().field("magic", Schema.INT32_SCHEMA).build();
+        final Struct key = new Struct(keySchema).put("magic", 42);
+        final SinkRecord record = new SinkRecord("test", 0, keySchema, key, null, null, 0);
+        final SinkRecord transformedRecord = xform.apply(record);
+
+        assertEquals(Schema.INT32_SCHEMA, transformedRecord.keySchema());
+        assertEquals(42, transformedRecord.key());
+    }
+
+}
diff --git a/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/HoistToStructTest.java b/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/HoistFieldTest.java
similarity index 71%
rename from connect/transforms/src/test/java/org/apache/kafka/connect/transforms/HoistToStructTest.java
rename to connect/transforms/src/test/java/org/apache/kafka/connect/transforms/HoistFieldTest.java
index 99a6e99dde000..b5f9d93d935e4 100644
--- a/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/HoistToStructTest.java
+++ b/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/HoistFieldTest.java
@@ -25,12 +25,25 @@
 import java.util.Collections;
 
 import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNull;
 
-public class HoistToStructTest {
+public class HoistFieldTest {
 
     @Test
-    public void sanityCheck() {
-        final HoistToStruct<SinkRecord> xform = new HoistToStruct.Key<>();
+    public void schemaless() {
+        final HoistField<SinkRecord> xform = new HoistField.Key<>();
+        xform.configure(Collections.singletonMap("field", "magic"));
+
+        final SinkRecord record = new SinkRecord("test", 0, null, 42, null, null, 0);
+        final SinkRecord transformedRecord = xform.apply(record);
+
+        assertNull(transformedRecord.keySchema());
+        assertEquals(Collections.singletonMap("magic", 42), transformedRecord.key());
+    }
+
+    @Test
+    public void withSchema() {
+        final HoistField<SinkRecord> xform = new HoistField.Key<>();
         xform.configure(Collections.singletonMap("field", "magic"));
 
         final SinkRecord record = new SinkRecord("test", 0, Schema.INT32_SCHEMA, 42, null, null, 0);
diff --git a/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/MaskFieldTest.java b/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/MaskFieldTest.java
new file mode 100644
index 0000000000000..c96058afbe6de
--- /dev/null
+++ b/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/MaskFieldTest.java
@@ -0,0 +1,156 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p/>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p/>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms;
+
+import org.apache.kafka.connect.data.Decimal;
+import org.apache.kafka.connect.data.Field;
+import org.apache.kafka.connect.data.Schema;
+import org.apache.kafka.connect.data.SchemaBuilder;
+import org.apache.kafka.connect.data.Struct;
+import org.apache.kafka.connect.data.Time;
+import org.apache.kafka.connect.data.Timestamp;
+import org.apache.kafka.connect.sink.SinkRecord;
+import org.junit.Test;
+
+import java.math.BigDecimal;
+import java.math.BigInteger;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.Date;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static org.junit.Assert.assertEquals;
+
+public class MaskFieldTest {
+
+    private static MaskField<SinkRecord> transform(List<String> fields) {
+        final MaskField<SinkRecord> xform = new MaskField.Value<>();
+        xform.configure(Collections.singletonMap("fields", fields));
+        return xform;
+    }
+
+    private static SinkRecord record(Schema schema, Object value) {
+        return new SinkRecord("", 0, null, null, schema, value, 0);
+    }
+
+    @Test
+    public void schemaless() {
+        final Map<String, Object> value = new HashMap<>();
+        value.put("magic", 42);
+        value.put("bool", true);
+        value.put("byte", (byte) 42);
+        value.put("short", (short) 42);
+        value.put("int", 42);
+        value.put("long", 42L);
+        value.put("float", 42f);
+        value.put("double", 42d);
+        value.put("string", "blabla");
+        value.put("date", new Date());
+        value.put("bigint", new BigInteger("42"));
+        value.put("bigdec", new BigDecimal("42.0"));
+        value.put("list", Collections.singletonList(42));
+        value.put("map", Collections.singletonMap("key", "value"));
+
+        final List<String> maskFields = new ArrayList<>(value.keySet());
+        maskFields.remove("magic");
+
+        final Map<String, Object> updatedValue = (Map) transform(maskFields).apply(record(null, value)).value();
+
+        assertEquals(42, updatedValue.get("magic"));
+        assertEquals(false, updatedValue.get("bool"));
+        assertEquals((byte) 0, updatedValue.get("byte"));
+        assertEquals((short) 0, updatedValue.get("short"));
+        assertEquals(0, updatedValue.get("int"));
+        assertEquals(0L, updatedValue.get("long"));
+        assertEquals(0f, updatedValue.get("float"));
+        assertEquals(0d, updatedValue.get("double"));
+        assertEquals("", updatedValue.get("string"));
+        assertEquals(new Date(0), updatedValue.get("date"));
+        assertEquals(BigInteger.ZERO, updatedValue.get("bigint"));
+        assertEquals(BigDecimal.ZERO, updatedValue.get("bigdec"));
+        assertEquals(Collections.emptyList(), updatedValue.get("list"));
+        assertEquals(Collections.emptyMap(), updatedValue.get("map"));
+    }
+
+    @Test
+    public void withSchema() {
+        Schema schema = SchemaBuilder.struct()
+                .field("magic", Schema.INT32_SCHEMA)
+                .field("bool", Schema.BOOLEAN_SCHEMA)
+                .field("byte", Schema.INT8_SCHEMA)
+                .field("short", Schema.INT16_SCHEMA)
+                .field("int", Schema.INT32_SCHEMA)
+                .field("long", Schema.INT64_SCHEMA)
+                .field("float", Schema.FLOAT32_SCHEMA)
+                .field("double", Schema.FLOAT64_SCHEMA)
+                .field("string", Schema.STRING_SCHEMA)
+                .field("date", org.apache.kafka.connect.data.Date.SCHEMA)
+                .field("time", Time.SCHEMA)
+                .field("timestamp", Timestamp.SCHEMA)
+                .field("decimal", Decimal.schema(0))
+                .field("array", SchemaBuilder.array(Schema.INT32_SCHEMA))
+                .field("map", SchemaBuilder.map(Schema.STRING_SCHEMA, Schema.STRING_SCHEMA))
+                .build();
+
+        final Struct value = new Struct(schema);
+        value.put("magic", 42);
+        value.put("bool", true);
+        value.put("byte", (byte) 42);
+        value.put("short", (short) 42);
+        value.put("int", 42);
+        value.put("long", 42L);
+        value.put("float", 42f);
+        value.put("double", 42d);
+        value.put("string", "hmm");
+        value.put("date", new Date());
+        value.put("time", new Date());
+        value.put("timestamp", new Date());
+        value.put("decimal", new BigDecimal(42));
+        value.put("array", Arrays.asList(1, 2, 3));
+        value.put("map", Collections.singletonMap("what", "what"));
+
+        final List<String> maskFields = new ArrayList<>(schema.fields().size());
+        for (Field field: schema.fields()) {
+            if (!field.name().equals("magic")) {
+                maskFields.add(field.name());
+            }
+        }
+
+        final Struct updatedValue = (Struct) transform(maskFields).apply(record(schema, value)).value();
+
+        assertEquals(42, updatedValue.get("magic"));
+        assertEquals(false, updatedValue.get("bool"));
+        assertEquals((byte) 0, updatedValue.get("byte"));
+        assertEquals((short) 0, updatedValue.get("short"));
+        assertEquals(0, updatedValue.get("int"));
+        assertEquals(0L, updatedValue.get("long"));
+        assertEquals(0f, updatedValue.get("float"));
+        assertEquals(0d, updatedValue.get("double"));
+        assertEquals("", updatedValue.get("string"));
+        assertEquals(new Date(0), updatedValue.get("date"));
+        assertEquals(new Date(0), updatedValue.get("time"));
+        assertEquals(new Date(0), updatedValue.get("timestamp"));
+        assertEquals(BigDecimal.ZERO, updatedValue.get("decimal"));
+        assertEquals(Collections.emptyList(), updatedValue.get("array"));
+        assertEquals(Collections.emptyMap(), updatedValue.get("map"));
+    }
+
+}
diff --git a/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/RegexRouterTest.java b/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/RegexRouterTest.java
new file mode 100644
index 0000000000000..c599265d57200
--- /dev/null
+++ b/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/RegexRouterTest.java
@@ -0,0 +1,70 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms;
+
+import org.apache.kafka.connect.sink.SinkRecord;
+import org.junit.Test;
+
+import java.util.HashMap;
+import java.util.Map;
+
+import static org.junit.Assert.assertEquals;
+
+public class RegexRouterTest {
+
+    private static String apply(String regex, String replacement, String topic) {
+        final Map<String, String> props = new HashMap<>();
+        props.put("regex", regex);
+        props.put("replacement", replacement);
+        final RegexRouter<SinkRecord> router = new RegexRouter<>();
+        router.configure(props);
+        return router.apply(new SinkRecord(topic, 0, null, null, null, null, 0))
+                .topic();
+    }
+
+    @Test
+    public void staticReplacement() {
+        assertEquals("bar", apply("foo", "bar", "foo"));
+    }
+
+    @Test
+    public void doesntMatch() {
+        assertEquals("orig", apply("foo", "bar", "orig"));
+    }
+
+    @Test
+    public void identity() {
+        assertEquals("orig", apply("(.*)", "$1", "orig"));
+    }
+
+    @Test
+    public void addPrefix() {
+        assertEquals("prefix-orig", apply("(.*)", "prefix-$1", "orig"));
+    }
+
+    @Test
+    public void addSuffix() {
+        assertEquals("orig-suffix", apply("(.*)", "$1-suffix", "orig"));
+    }
+
+    @Test
+    public void slice() {
+        assertEquals("index", apply("(.*)-(\\d\\d\\d\\d\\d\\d\\d\\d)", "$1", "index-20160117"));
+    }
+
+}
diff --git a/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/ReplaceFieldTest.java b/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/ReplaceFieldTest.java
new file mode 100644
index 0000000000000..9f9d4b7031b52
--- /dev/null
+++ b/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/ReplaceFieldTest.java
@@ -0,0 +1,92 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms;
+
+import org.apache.kafka.connect.data.Schema;
+import org.apache.kafka.connect.data.SchemaBuilder;
+import org.apache.kafka.connect.data.Struct;
+import org.apache.kafka.connect.sink.SinkRecord;
+import org.junit.Test;
+
+import java.util.HashMap;
+import java.util.Map;
+
+import static org.junit.Assert.assertEquals;
+
+public class ReplaceFieldTest {
+
+    @Test
+    public void schemaless() {
+        final ReplaceField<SinkRecord> xform = new ReplaceField.Value<>();
+
+        final Map<String, String> props = new HashMap<>();
+        props.put("blacklist", "dont");
+        props.put("renames", "abc:xyz,foo:bar");
+
+        xform.configure(props);
+
+        final Map<String, Object> value = new HashMap<>();
+        value.put("dont", "whatever");
+        value.put("abc", 42);
+        value.put("foo", true);
+        value.put("etc", "etc");
+
+        final SinkRecord record = new SinkRecord("test", 0, null, null, null, value, 0);
+        final SinkRecord transformedRecord = xform.apply(record);
+
+        final Map updatedValue = (Map) transformedRecord.value();
+        assertEquals(3, updatedValue.size());
+        assertEquals(42, updatedValue.get("xyz"));
+        assertEquals(true, updatedValue.get("bar"));
+        assertEquals("etc", updatedValue.get("etc"));
+    }
+
+    @Test
+    public void withSchema() {
+        final ReplaceField<SinkRecord> xform = new ReplaceField.Value<>();
+
+        final Map<String, String> props = new HashMap<>();
+        props.put("whitelist", "abc,foo");
+        props.put("renames", "abc:xyz,foo:bar");
+
+        xform.configure(props);
+
+        final Schema schema = SchemaBuilder.struct()
+                .field("dont", Schema.STRING_SCHEMA)
+                .field("abc", Schema.INT32_SCHEMA)
+                .field("foo", Schema.BOOLEAN_SCHEMA)
+                .field("etc", Schema.STRING_SCHEMA)
+                .build();
+
+        final Struct value = new Struct(schema);
+        value.put("dont", "whatever");
+        value.put("abc", 42);
+        value.put("foo", true);
+        value.put("etc", "etc");
+
+        final SinkRecord record = new SinkRecord("test", 0, null, null, schema, value, 0);
+        final SinkRecord transformedRecord = xform.apply(record);
+
+        final Struct updatedValue = (Struct) transformedRecord.value();
+
+        assertEquals(2, updatedValue.schema().fields().size());
+        assertEquals(new Integer(42), updatedValue.getInt32("xyz"));
+        assertEquals(true, updatedValue.getBoolean("bar"));
+    }
+
+}
diff --git a/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/SetSchemaMetadataTest.java b/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/SetSchemaMetadataTest.java
new file mode 100644
index 0000000000000..2aa790f0a2d82
--- /dev/null
+++ b/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/SetSchemaMetadataTest.java
@@ -0,0 +1,67 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms;
+
+import org.apache.kafka.connect.data.SchemaBuilder;
+import org.apache.kafka.connect.sink.SinkRecord;
+import org.junit.Test;
+
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.Map;
+
+import static org.junit.Assert.assertEquals;
+
+public class SetSchemaMetadataTest {
+
+    @Test
+    public void schemaNameUpdate() {
+        final SetSchemaMetadata<SinkRecord> xform = new SetSchemaMetadata.Value<>();
+        xform.configure(Collections.singletonMap("schema.name", "foo"));
+        final SinkRecord record = new SinkRecord("", 0, null, null, SchemaBuilder.struct().build(), null, 0);
+        final SinkRecord updatedRecord = xform.apply(record);
+        assertEquals("foo", updatedRecord.valueSchema().name());
+    }
+
+    @Test
+    public void schemaVersionUpdate() {
+        final SetSchemaMetadata<SinkRecord> xform = new SetSchemaMetadata.Value<>();
+        xform.configure(Collections.singletonMap("schema.version", 42));
+        final SinkRecord record = new SinkRecord("", 0, null, null, SchemaBuilder.struct().build(), null, 0);
+        final SinkRecord updatedRecord = xform.apply(record);
+        assertEquals(new Integer(42), updatedRecord.valueSchema().version());
+    }
+
+    @Test
+    public void schemaNameAndVersionUpdate() {
+        final Map<String, String> props = new HashMap<>();
+        props.put("schema.name", "foo");
+        props.put("schema.version", "42");
+
+        final SetSchemaMetadata<SinkRecord> xform = new SetSchemaMetadata.Value<>();
+        xform.configure(props);
+
+        final SinkRecord record = new SinkRecord("", 0, null, null, SchemaBuilder.struct().build(), null, 0);
+
+        final SinkRecord updatedRecord = xform.apply(record);
+
+        assertEquals("foo", updatedRecord.valueSchema().name());
+        assertEquals(new Integer(42), updatedRecord.valueSchema().version());
+    }
+
+}
diff --git a/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/ValueToKeyTest.java b/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/ValueToKeyTest.java
new file mode 100644
index 0000000000000..e5328d36baebb
--- /dev/null
+++ b/connect/transforms/src/test/java/org/apache/kafka/connect/transforms/ValueToKeyTest.java
@@ -0,0 +1,87 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+package org.apache.kafka.connect.transforms;
+
+import org.apache.kafka.connect.data.Schema;
+import org.apache.kafka.connect.data.SchemaBuilder;
+import org.apache.kafka.connect.data.Struct;
+import org.apache.kafka.connect.sink.SinkRecord;
+import org.junit.Test;
+
+import java.util.Collections;
+import java.util.HashMap;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNull;
+
+public class ValueToKeyTest {
+
+    @Test
+    public void schemaless() {
+        final ValueToKey<SinkRecord> xform = new ValueToKey<>();
+        xform.configure(Collections.singletonMap("fields", "a,b"));
+
+        final HashMap<String, Integer> value = new HashMap<>();
+        value.put("a", 1);
+        value.put("b", 2);
+        value.put("c", 3);
+
+        final SinkRecord record = new SinkRecord("", 0, null, null, null, value, 0);
+        final SinkRecord transformedRecord = xform.apply(record);
+
+        final HashMap<String, Integer> expectedKey = new HashMap<>();
+        expectedKey.put("a", 1);
+        expectedKey.put("b", 2);
+
+        assertNull(transformedRecord.keySchema());
+        assertEquals(expectedKey, transformedRecord.key());
+    }
+
+    @Test
+    public void withSchema() {
+        final ValueToKey<SinkRecord> xform = new ValueToKey<>();
+        xform.configure(Collections.singletonMap("fields", "a,b"));
+
+        final Schema valueSchema = SchemaBuilder.struct()
+                .field("a", Schema.INT32_SCHEMA)
+                .field("b", Schema.INT32_SCHEMA)
+                .field("c", Schema.INT32_SCHEMA)
+                .build();
+
+        final Struct value = new Struct(valueSchema);
+        value.put("a", 1);
+        value.put("b", 2);
+        value.put("c", 3);
+
+        final SinkRecord record = new SinkRecord("", 0, null, null, valueSchema, value, 0);
+        final SinkRecord transformedRecord = xform.apply(record);
+
+        final Schema expectedKeySchema = SchemaBuilder.struct()
+                .field("a", Schema.INT32_SCHEMA)
+                .field("b", Schema.INT32_SCHEMA)
+                .build();
+
+        final Struct expectedKey = new Struct(expectedKeySchema)
+                .put("a", 1)
+                .put("b", 2);
+
+        assertEquals(expectedKeySchema, transformedRecord.keySchema());
+        assertEquals(expectedKey, transformedRecord.key());
+    }
+
+}
diff --git a/docs/connect.html b/docs/connect.html
index 23e168cae0309..1af5ed95f6051 100644
--- a/docs/connect.html
+++ b/docs/connect.html
@@ -100,6 +100,22 @@ <h4><a id="connect_configuring" href="#connect_configuring">Configuring Connecto
 
     For any other options, you should consult the documentation for the connector.
 
+    <h4><a id="connect_transforms" href="#connect_transforms">Transformations</a></h4>
+
+    Connectors can be configured with transformations to make lightweight message-at-a-time modifications. They can be convenient for minor data massaging and routing changes.
+
+    A transformation chain can be specified in the connector configuration.
+
+    <ul>
+        <li><code>transforms</code> - List of aliases for the transformation, specifying the order in which the transformations will be applied.</li>
+        <li><code>transforms.$alias.type</code> - Fully qualified class name for the transformation.</li>
+        <li><code>transforms.$alias.$transformationSpecificConfig</code> Configuration properties for the transformation</li>
+    </ul>
+
+    Several widely-applicable data and routing transformations are included with Kafka Connect:
+
+    <!--#include virtual="generated/connect_transforms.html" -->
+
     <h4><a id="connect_rest" href="#connect_rest">REST API</a></h4>
 
     Since Kafka Connect is intended to be run as a service, it also provides a REST API for managing connectors. By default, this service runs on port 8083. The following are the currently supported endpoints:
diff --git a/tests/kafkatest/tests/connect/connect_distributed_test.py b/tests/kafkatest/tests/connect/connect_distributed_test.py
index 198e94501f50d..c298fb154e86e 100644
--- a/tests/kafkatest/tests/connect/connect_distributed_test.py
+++ b/tests/kafkatest/tests/connect/connect_distributed_test.py
@@ -460,7 +460,7 @@ def test_transformations(self):
             'file': self.INPUT_FILE,
             'topic': self.TOPIC,
             'transforms': 'hoistToStruct,insertTimestampField',
-            'transforms.hoistToStruct.type': 'org.apache.kafka.connect.transforms.HoistToStruct$Value',
+            'transforms.hoistToStruct.type': 'org.apache.kafka.connect.transforms.HoistField$Value',
             'transforms.hoistToStruct.field': 'content',
             'transforms.insertTimestampField.type': 'org.apache.kafka.connect.transforms.InsertField$Value',
             'transforms.insertTimestampField.timestamp.field': ts_fieldname,

From db57c1a0c7e057e19ec165d3cf9fa35d54b97c8f Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Sat, 21 Jan 2017 13:18:39 -0800
Subject: [PATCH 022/177] KAFKA-4060 and KAFKA-4476 follow up: remove
 unnecessary InternalTopicManager branch and fixed one copartitioning bug

ZK removed reveal a bug in `StreamPartitionAssigner` but did not fix it properly. This is a follow up bug fix.

Issue:
 - If topic metadata is missing, `StreamPartitionAssigner` should not create any affected tasks that consume topics with missing metadata.
 - Depending downstream tasks should not be create either.
 - For tasks that are not created, no store changelog topics (if any) should get created
 - For tasks that write output to not-yet existing internal repartitioning topics, those repartitioning topics should not get created

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Damian Guy, Guozhang Wang

Closes #2404 from mjsax/kafka-4060-zk-test-follow-up

(cherry picked from commit 0b99bea590842018e8e97e7fd1c71b1471db4d08)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../processor/DefaultPartitionGrouper.java    |   2 +
 .../internals/StreamPartitionAssignor.java    |  59 ++++------
 .../StreamPartitionAssignorTest.java          | 103 +++++++++++-------
 3 files changed, 90 insertions(+), 74 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/DefaultPartitionGrouper.java b/streams/src/main/java/org/apache/kafka/streams/processor/DefaultPartitionGrouper.java
index 1da12097b53eb..2f354d8d3bc69 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/DefaultPartitionGrouper.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/DefaultPartitionGrouper.java
@@ -21,6 +21,7 @@
 import org.apache.kafka.common.PartitionInfo;
 import org.apache.kafka.common.TopicPartition;
 import org.apache.kafka.streams.errors.StreamsException;
+import org.apache.kafka.streams.processor.internals.StreamPartitionAssignor;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -83,6 +84,7 @@ protected int maxNumPartitions(Cluster metadata, Set<String> topics) {
 
             if (partitions == null) {
                 log.info("Skipping assigning topic {} to tasks since its metadata is not available yet", topic);
+                maxNumPartitions = StreamPartitionAssignor.NOT_AVAILABLE;
             } else {
                 int numPartitions = partitions.size();
                 if (numPartitions > maxNumPartitions)
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java
index 7b48a6fdb784c..382c4e9986aeb 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java
@@ -59,7 +59,7 @@ public class StreamPartitionAssignor implements PartitionAssignor, Configurable
 
     private static final Logger log = LoggerFactory.getLogger(StreamPartitionAssignor.class);
 
-    public final static int UNKNOWN = -1;
+    private final static int UNKNOWN = -1;
     public final static int NOT_AVAILABLE = -2;
 
     private static class AssignedPartition implements Comparable<AssignedPartition> {
@@ -159,7 +159,7 @@ public int compare(TopicPartition p1, TopicPartition p2) {
     private Map<TaskId, Set<TopicPartition>> standbyTasks;
     private Map<TaskId, Set<TopicPartition>> activeTasks;
 
-    InternalTopicManager internalTopicManager;
+    private InternalTopicManager internalTopicManager;
 
     /**
      * We need to have the PartitionAssignor and its StreamThread to be mutually accessible
@@ -369,9 +369,7 @@ public Map<String, Assignment> assign(Cluster metadata, Map<String, Subscription
         // create these topics if necessary
         prepareTopic(repartitionTopicMetadata);
 
-        metadataWithInternalTopics = metadata;
-        if (internalTopicManager != null)
-            metadataWithInternalTopics = metadata.withPartitions(allRepartitionTopicPartitions);
+        metadataWithInternalTopics = metadata.withPartitions(allRepartitionTopicPartitions);
 
         log.debug("stream-thread [{}] Created repartition topics {} from the parsed topology.", streamThread.getName(), allRepartitionTopicPartitions.values());
 
@@ -592,43 +590,27 @@ public void onAssignment(Assignment assignment) {
      *
      * @param topicPartitions Map that contains the topic names to be created with the number of partitions
      */
-    private void prepareTopic(Map<String, InternalTopicMetadata> topicPartitions) {
+    private void prepareTopic(final Map<String, InternalTopicMetadata> topicPartitions) {
         log.debug("stream-thread [{}] Starting to validate internal topics in partition assignor.", streamThread.getName());
 
-        // if ZK is specified, prepare the internal source topic before calling partition grouper
-        if (internalTopicManager != null) {
-            for (Map.Entry<String, InternalTopicMetadata> entry : topicPartitions.entrySet()) {
-                InternalTopicConfig topic = entry.getValue().config;
-                Integer numPartitions = entry.getValue().numPartitions;
+        for (final Map.Entry<String, InternalTopicMetadata> entry : topicPartitions.entrySet()) {
+            final InternalTopicConfig topic = entry.getValue().config;
+            final Integer numPartitions = entry.getValue().numPartitions;
 
-                if (numPartitions == NOT_AVAILABLE) {
-                    continue;
-                }
-                if (numPartitions < 0) {
-                    throw new TopologyBuilderException(String.format("stream-thread [%s] Topic [%s] number of partitions not defined", streamThread.getName(), topic.name()));
-                }
-
-                internalTopicManager.makeReady(topic, numPartitions);
-
-                // wait until the topic metadata has been propagated to all brokers
-                List<PartitionInfo> partitions;
-                do {
-                    partitions = streamThread.restoreConsumer.partitionsFor(topic.name());
-                } while (partitions == null || partitions.size() != numPartitions);
+            if (numPartitions == NOT_AVAILABLE) {
+                continue;
             }
-        } else {
-            List<String> missingTopics = new ArrayList<>();
-            for (String topic : topicPartitions.keySet()) {
-                List<PartitionInfo> partitions = streamThread.restoreConsumer.partitionsFor(topic);
-                if (partitions == null) {
-                    missingTopics.add(topic);
-                }
+            if (numPartitions < 0) {
+                throw new TopologyBuilderException(String.format("stream-thread [%s] Topic [%s] number of partitions not defined", streamThread.getName(), topic.name()));
             }
 
-            if (!missingTopics.isEmpty()) {
-                log.warn("stream-thread [{}] Topic {} do not exists but couldn't created as the config '{}' isn't supplied",
-                        streamThread.getName(), missingTopics, StreamsConfig.ZOOKEEPER_CONNECT_CONFIG);
-            }
+            internalTopicManager.makeReady(topic, numPartitions);
+
+            // wait until the topic metadata has been propagated to all brokers
+            List<PartitionInfo> partitions;
+            do {
+                partitions = streamThread.restoreConsumer.partitionsFor(topic.name());
+            } while (partitions == null || partitions.size() != numPartitions);
         }
 
         log.info("stream-thread [{}] Completed validating internal topics in partition assignor", streamThread.getName());
@@ -661,6 +643,11 @@ private void ensureCopartitioning(Set<String> copartitionGroup,
                     Arrays.sort(topics);
                     throw new TopologyBuilderException(String.format("stream-thread [%s] Topics not co-partitioned: [%s]", streamThread.getName(), Utils.mkString(Arrays.asList(topics), ",")));
                 }
+            } else {
+                if (allRepartitionTopicsNumPartitions.get(topic).numPartitions == NOT_AVAILABLE) {
+                    numPartitions = NOT_AVAILABLE;
+                    break;
+                }
             }
         }
 
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignorTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignorTest.java
index c212f1412d6d7..eff2179abcb5e 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignorTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignorTest.java
@@ -26,6 +26,7 @@
 import org.apache.kafka.common.metrics.Metrics;
 import org.apache.kafka.common.utils.Time;
 import org.apache.kafka.common.utils.Utils;
+import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.StreamsConfig;
 import org.apache.kafka.streams.kstream.JoinWindows;
 import org.apache.kafka.streams.kstream.KStream;
@@ -38,23 +39,23 @@
 import org.apache.kafka.streams.processor.internals.assignment.SubscriptionInfo;
 import org.apache.kafka.streams.state.HostInfo;
 import org.apache.kafka.test.MockClientSupplier;
+import org.apache.kafka.test.MockInternalTopicManager;
 import org.apache.kafka.test.MockProcessorSupplier;
-import org.apache.kafka.test.MockTimestampExtractor;
 import org.apache.kafka.test.MockStateStoreSupplier;
-import org.apache.kafka.test.MockInternalTopicManager;
+import org.apache.kafka.test.MockTimestampExtractor;
 import org.junit.Assert;
 import org.junit.Test;
 
+import java.util.ArrayList;
 import java.util.Arrays;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.HashSet;
 import java.util.List;
-import java.util.Set;
-import java.util.Properties;
 import java.util.Map;
+import java.util.Properties;
+import java.util.Set;
 import java.util.UUID;
-import java.util.HashMap;
-import java.util.HashSet;
-import java.util.Collections;
-import java.util.ArrayList;
 
 import static org.hamcrest.CoreMatchers.equalTo;
 import static org.hamcrest.CoreMatchers.not;
@@ -91,7 +92,7 @@ public class StreamPartitionAssignorTest {
             new PartitionInfo("topic3", 3, Node.noNode(), new Node[0], new Node[0])
     );
 
-    private Cluster metadata = new Cluster("cluster", Arrays.asList(Node.noNode()), infos, Collections.<String>emptySet(),
+    private Cluster metadata = new Cluster("cluster", Collections.singletonList(Node.noNode()), infos, Collections.<String>emptySet(),
             Collections.<String>emptySet());
 
     private final TaskId task0 = new TaskId(0, 0);
@@ -248,17 +249,17 @@ public void testAssignWithPartialTopology() throws Exception {
         UUID uuid1 = UUID.randomUUID();
         String client1 = "client1";
 
-        StreamThread thread10 = new StreamThread(builder, config, new MockClientSupplier(), "test", client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST), 0);
+        final MockClientSupplier mockClientSupplier = new MockClientSupplier();
+        StreamThread thread10 = new StreamThread(builder, config, mockClientSupplier, "test", client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST), 0);
 
         StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(thread10, "test", client1));
+        partitionAssignor.setInternalTopicManager(new MockInternalTopicManager(thread10.config, mockClientSupplier.restoreConsumer));
         Map<String, PartitionAssignor.Subscription> subscriptions = new HashMap<>();
         subscriptions.put("consumer10",
             new PartitionAssignor.Subscription(topics, new SubscriptionInfo(uuid1, Collections.<TaskId>emptySet(), Collections.<TaskId>emptySet(), userEndPoint).encode()));
 
-        // TODO: Update the code accordingly,
-        // This line was added to fix the test failure since internalTopicManager is created in the config method all the time.
-        partitionAssignor.internalTopicManager = null;
+
         // will throw exception if it fails
         Map<String, PartitionAssignor.Assignment> assignments = partitionAssignor.assign(metadata, subscriptions);
 
@@ -285,7 +286,7 @@ public void testAssignEmptyMetadata() throws Exception {
 
         final Set<TaskId> prevTasks10 = Utils.mkSet(task0);
         final Set<TaskId> standbyTasks10 = Utils.mkSet(task1);
-        final  Cluster emptyMetadata = new Cluster("cluster", Arrays.asList(Node.noNode()),
+        final  Cluster emptyMetadata = new Cluster("cluster", Collections.singletonList(Node.noNode()),
             Collections.<PartitionInfo>emptySet(),
             Collections.<String>emptySet(),
             Collections.<String>emptySet());
@@ -443,9 +444,6 @@ public void testAssignWithStates() throws Exception {
         subscriptions.put("consumer20",
                 new PartitionAssignor.Subscription(topics, new SubscriptionInfo(uuid2, Collections.<TaskId>emptySet(), Collections.<TaskId>emptySet(), userEndPoint).encode()));
 
-        // TODO: Update the code accordingly,
-        // This line was added to fix the test failure since internalTopicManager is created in the config method all the time.
-        partitionAssignor.internalTopicManager = null;
         Map<String, PartitionAssignor.Assignment> assignments = partitionAssignor.assign(metadata, subscriptions);
 
         // check assigned partition size: since there is no previous task and there are two sub-topologies the assignment is random so we cannot check exact match
@@ -633,7 +631,7 @@ public void testAssignWithInternalTopics() throws Exception {
         partitionAssignor.setInternalTopicManager(internalTopicManager);
 
         Map<String, PartitionAssignor.Subscription> subscriptions = new HashMap<>();
-        Set<TaskId> emptyTasks = Collections.<TaskId>emptySet();
+        Set<TaskId> emptyTasks = Collections.emptySet();
         subscriptions.put("consumer10",
                 new PartitionAssignor.Subscription(topics, new SubscriptionInfo(uuid1, emptyTasks, emptyTasks, userEndPoint).encode()));
 
@@ -676,11 +674,11 @@ public void testAssignWithInternalTopicThatsSourceIsAnotherInternalTopic() throw
         partitionAssignor.setInternalTopicManager(internalTopicManager);
 
         Map<String, PartitionAssignor.Subscription> subscriptions = new HashMap<>();
-        Set<TaskId> emptyTasks = Collections.<TaskId>emptySet();
+        Set<TaskId> emptyTasks = Collections.emptySet();
         subscriptions.put("consumer10",
                 new PartitionAssignor.Subscription(topics, new SubscriptionInfo(uuid1, emptyTasks, emptyTasks, userEndPoint).encode()));
 
-        Map<String, PartitionAssignor.Assignment> assignments = partitionAssignor.assign(metadata, subscriptions);
+        partitionAssignor.assign(metadata, subscriptions);
 
         // check prepared internal topics
         assertEquals(2, internalTopicManager.readyTopics.size());
@@ -742,7 +740,7 @@ public void shouldMapUserEndPointToTopicPartitions() throws Exception {
         partitionAssignor.setInternalTopicManager(new MockInternalTopicManager(streamThread.config, clientSupplier.restoreConsumer));
 
         final Map<String, PartitionAssignor.Subscription> subscriptions = new HashMap<>();
-        final Set<TaskId> emptyTasks = Collections.<TaskId>emptySet();
+        final Set<TaskId> emptyTasks = Collections.emptySet();
         subscriptions.put("consumer1",
                 new PartitionAssignor.Subscription(topics, new SubscriptionInfo(uuid1, emptyTasks, emptyTasks, myEndPoint).encode()));
 
@@ -815,7 +813,7 @@ public void shouldThrowExceptionIfApplicationServerConfigPortIsNotAnInteger() th
     @Test
     public void shouldExposeHostStateToTopicPartitionsOnAssignment() throws Exception {
         final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
-        List<TopicPartition> topic = Arrays.asList(new TopicPartition("topic", 0));
+        List<TopicPartition> topic = Collections.singletonList(new TopicPartition("topic", 0));
         final Map<HostInfo, Set<TopicPartition>> hostState =
                 Collections.singletonMap(new HostInfo("localhost", 80),
                         Collections.singleton(new TopicPartition("topic", 0)));
@@ -830,7 +828,7 @@ public void shouldExposeHostStateToTopicPartitionsOnAssignment() throws Exceptio
     public void shouldSetClusterMetadataOnAssignment() throws Exception {
         final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
 
-        final List<TopicPartition> topic = Arrays.asList(new TopicPartition("topic", 0));
+        final List<TopicPartition> topic = Collections.singletonList(new TopicPartition("topic", 0));
         final Map<HostInfo, Set<TopicPartition>> hostState =
                 Collections.singletonMap(new HostInfo("localhost", 80),
                         Collections.singleton(new TopicPartition("topic", 0)));
@@ -863,22 +861,47 @@ public void shouldNotLoopInfinitelyOnMissingMetadataAndShouldNotCreateRelatedTas
         builder.setApplicationId(applicationId);
 
         KStream<Object, Object> stream1 = builder
+
+            // Task 1 (should get created):
             .stream("topic1")
+            // force repartitioning for aggregation
             .selectKey(new KeyValueMapper<Object, Object, Object>() {
                 @Override
                 public Object apply(Object key, Object value) {
                     return null;
                 }
             })
-            .through("topic2");
+            .groupByKey()
+
+            // Task 2 (should get created):
+            // create repartioning and changelog topic as task 1 exists
+            .count("count")
+
+            // force repartitioning for join, but second join input topic unknown
+            // -> internal repartitioning topic should not get created
+            .toStream()
+            .map(new KeyValueMapper<Object, Long, KeyValue<Object, Object>>() {
+                @Override
+                public KeyValue<Object, Object> apply(Object key, Long value) {
+                    return null;
+                }
+            });
+
         builder
+            // Task 3 (should not get created because input topic unknown)
             .stream("unknownTopic")
+
+            // force repartitioning for join, but input topic unknown
+            // -> thus should not create internal repartitioning topic
             .selectKey(new KeyValueMapper<Object, Object, Object>() {
                 @Override
                 public Object apply(Object key, Object value) {
                     return null;
                 }
             })
+
+            // Task 4 (should not get created because input topics unknown)
+            // should not create any of both input repartition topics or any of both changelog topics
             .join(
                 stream1,
                 new ValueJoiner() {
@@ -894,13 +917,16 @@ public Object apply(Object value1, Object value2) {
         final String client = "client1";
 
         final StreamsConfig config = new StreamsConfig(configProps());
-        final StreamThread streamThread = new StreamThread(builder, config, new MockClientSupplier(), applicationId, client, uuid, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST), 0);
+        final MockClientSupplier mockClientSupplier = new MockClientSupplier();
+        final StreamThread streamThread = new StreamThread(builder, config, mockClientSupplier, applicationId, client, uuid, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST), 0);
 
         final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(streamThread, applicationId, client));
+        final MockInternalTopicManager mockInternalTopicManager = new MockInternalTopicManager(streamThread.config, mockClientSupplier.restoreConsumer);
+        partitionAssignor.setInternalTopicManager(mockInternalTopicManager);
 
         final Map<String, PartitionAssignor.Subscription> subscriptions = new HashMap<>();
-        final Set<TaskId> emptyTasks = Collections.<TaskId>emptySet();
+        final Set<TaskId> emptyTasks = Collections.emptySet();
         subscriptions.put(
             client,
             new PartitionAssignor.Subscription(
@@ -908,20 +934,22 @@ public Object apply(Object value1, Object value2) {
                 new SubscriptionInfo(uuid, emptyTasks, emptyTasks, userEndPoint).encode()
             )
         );
-        // TODO: Update the code accordingly,
-        // This line was added to fix the test failure since internalTopicManager is created in the config method all the time.
-        partitionAssignor.internalTopicManager = null;
         final Map<String, PartitionAssignor.Assignment> assignment = partitionAssignor.assign(metadata, subscriptions);
 
+        final Map<String, Integer> expectedCreatedInternalTopics = new HashMap<>();
+        expectedCreatedInternalTopics.put(applicationId + "-count-repartition", 3);
+        expectedCreatedInternalTopics.put(applicationId + "-count-changelog", 3);
+        assertThat(mockInternalTopicManager.readyTopics, equalTo(expectedCreatedInternalTopics));
+
         final List<TopicPartition> expectedAssignment = Arrays.asList(
             new TopicPartition("topic1", 0),
             new TopicPartition("topic1", 1),
             new TopicPartition("topic1", 2),
-            new TopicPartition("topic2", 0),
-            new TopicPartition("topic2", 1),
-            new TopicPartition("topic2", 2)
+            new TopicPartition(applicationId + "-count-repartition", 0),
+            new TopicPartition(applicationId + "-count-repartition", 1),
+            new TopicPartition(applicationId + "-count-repartition", 2)
         );
-        assertThat(expectedAssignment, equalTo(assignment.get(client).partitions()));
+        assertThat(new HashSet(assignment.get(client).partitions()), equalTo(new HashSet(expectedAssignment)));
     }
 
     @Test
@@ -981,13 +1009,15 @@ public void shouldNotAddStandbyTaskPartitionsToPartitionsForHost() throws Except
         final UUID uuid = UUID.randomUUID();
         final String client = "client1";
 
-        final StreamThread streamThread = new StreamThread(builder, config, new MockClientSupplier(), applicationId, client, uuid, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST), 0);
+        final MockClientSupplier mockClientSupplier = new MockClientSupplier();
+        final StreamThread streamThread = new StreamThread(builder, config, mockClientSupplier, applicationId, client, uuid, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST), 0);
 
         final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(streamThread, applicationId, client));
+        partitionAssignor.setInternalTopicManager(new MockInternalTopicManager(streamThread.config, mockClientSupplier.restoreConsumer));
 
         final Map<String, PartitionAssignor.Subscription> subscriptions = new HashMap<>();
-        final Set<TaskId> emptyTasks = Collections.<TaskId>emptySet();
+        final Set<TaskId> emptyTasks = Collections.emptySet();
         subscriptions.put(
                 "consumer1",
                 new PartitionAssignor.Subscription(
@@ -1004,9 +1034,6 @@ public void shouldNotAddStandbyTaskPartitionsToPartitionsForHost() throws Except
                 )
         );
         final Set<TopicPartition> allPartitions = Utils.mkSet(t1p0, t1p1, t1p2);
-        // TODO: Update the code accordingly,
-        // This line was added to fix the test failure since internalTopicManager is created in the config method all the time.
-        partitionAssignor.internalTopicManager = null;
         final Map<String, PartitionAssignor.Assignment> assign = partitionAssignor.assign(metadata, subscriptions);
         final PartitionAssignor.Assignment consumer1Assignment = assign.get("consumer1");
         final AssignmentInfo assignmentInfo = AssignmentInfo.decode(consumer1Assignment.userData());

From e393c9928972c00677250ae2df3b4f061fdccd58 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Xavier=20L=C3=A9aut=C3=A9?= <xavier@confluent.io>
Date: Sat, 21 Jan 2017 14:10:01 -0800
Subject: [PATCH 023/177] KAFKA-4672; fix source compatibility for lambda
 expressions
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Variance changes introduced in KIP-100 cause compilation failures with lambda expression in Java 8. To my knowledge this only affects the following method

`KStreams.transform(TransformerSupplier<...>, String...)`

prior to the changes it was possible to write:

`streams.transform(MyTransformer::new)`

where `MyTransformer` extends `Transformer`

After the changes the Java compiler is unable to infer correct return types for the lambda expressions. This change fixed this by reverting to invariant return types for transformer suppliers.

please cherry-pick into 0.10.2.x

Author: Xavier Léauté <xavier@confluent.io>

Reviewers: Ismael Juma, Damian Guy, Guozhang Wang

Closes #2402 from xvrl/lambdas-oh-my

(cherry picked from commit 20e957c9b1f389621bb8ae9e9f5554b66cd92a4f)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../src/main/java/org/apache/kafka/streams/kstream/KStream.java | 2 +-
 .../org/apache/kafka/streams/kstream/internals/KStreamImpl.java | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
index 3e95e7cec0d26..35095230cc3f8 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
@@ -623,7 +623,7 @@ void to(final Serde<K> keySerde,
      * @see #transformValues(ValueTransformerSupplier, String...)
      * @see #process(ProcessorSupplier, String...)
      */
-    <K1, V1> KStream<K1, V1> transform(final TransformerSupplier<? super K, ? super V, ? extends KeyValue<? extends K1, ? extends V1>> transformerSupplier,
+    <K1, V1> KStream<K1, V1> transform(final TransformerSupplier<? super K, ? super V, KeyValue<K1, V1>> transformerSupplier,
                                        final String... stateStoreNames);
 
     /**
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamImpl.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamImpl.java
index b99e55d29d8e6..3d41ae44d768d 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamImpl.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamImpl.java
@@ -365,7 +365,7 @@ public void to(Serde<K> keySerde, Serde<V> valSerde, StreamPartitioner<? super K
     }
 
     @Override
-    public <K1, V1> KStream<K1, V1> transform(TransformerSupplier<? super K, ? super V, ? extends KeyValue<? extends K1, ? extends V1>> transformerSupplier, String... stateStoreNames) {
+    public <K1, V1> KStream<K1, V1> transform(TransformerSupplier<? super K, ? super V, KeyValue<K1, V1>> transformerSupplier, String... stateStoreNames) {
         Objects.requireNonNull(transformerSupplier, "transformerSupplier can't be null");
         String name = topology.newName(TRANSFORM_NAME);
 

From f0449d3248801facca442d93552a829e8b8d06a7 Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno.thereska@gmail.com>
Date: Mon, 23 Jan 2017 14:45:30 +0000
Subject: [PATCH 024/177] MINOR: Pass RecordingLevel to MetricConfig in the
 broker

This is a KIP-104/105 follow-up. Thanks to ijuma for pointing out.

Author: Eno Thereska <eno.thereska@gmail.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2350 from enothereska/minor-broker-level-config

(cherry picked from commit 1eb1e2f60ae006144757fc9fc10ab423c58970bb)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../main/scala/kafka/server/KafkaConfig.scala |  1 +
 .../main/scala/kafka/server/KafkaServer.scala | 12 +++--
 .../unit/kafka/server/KafkaConfigTest.scala   |  4 ++
 .../unit/kafka/server/ServerMetricsTest.scala | 51 +++++++++++++++++++
 4 files changed, 64 insertions(+), 4 deletions(-)
 create mode 100755 core/src/test/scala/unit/kafka/server/ServerMetricsTest.scala

diff --git a/core/src/main/scala/kafka/server/KafkaConfig.scala b/core/src/main/scala/kafka/server/KafkaConfig.scala
index 3c2a72d8ac6d9..c4f54c9e14a31 100755
--- a/core/src/main/scala/kafka/server/KafkaConfig.scala
+++ b/core/src/main/scala/kafka/server/KafkaConfig.scala
@@ -941,6 +941,7 @@ class KafkaConfig(val props: java.util.Map[_, _], doLog: Boolean) extends Abstra
   val metricNumSamples = getInt(KafkaConfig.MetricNumSamplesProp)
   val metricSampleWindowMs = getLong(KafkaConfig.MetricSampleWindowMsProp)
   val metricReporterClasses: java.util.List[MetricsReporter] = getConfiguredInstances(KafkaConfig.MetricReporterClassesProp, classOf[MetricsReporter])
+  val metricRecordingLevel = getString(KafkaConfig.MetricRecordingLevelProp)
 
   /** ********* SSL Configuration **************/
   val principalBuilderClass = getClass(KafkaConfig.PrincipalBuilderClassProp)
diff --git a/core/src/main/scala/kafka/server/KafkaServer.scala b/core/src/main/scala/kafka/server/KafkaServer.scala
index 79548e86c5969..b5075f9472884 100755
--- a/core/src/main/scala/kafka/server/KafkaServer.scala
+++ b/core/src/main/scala/kafka/server/KafkaServer.scala
@@ -79,9 +79,15 @@ object KafkaServer {
     logProps.put(LogConfig.MessageTimestampDifferenceMaxMsProp, kafkaConfig.logMessageTimestampDifferenceMaxMs)
     logProps
   }
-}
 
+  private[server] def metricConfig(kafkaConfig: KafkaConfig): MetricConfig = {
+    new MetricConfig()
+      .samples(kafkaConfig.metricNumSamples)
+      .recordLevel(Sensor.RecordingLevel.forName(kafkaConfig.metricRecordingLevel))
+      .timeWindow(kafkaConfig.metricSampleWindowMs, TimeUnit.MILLISECONDS)
+  }
 
+}
 
 /**
  * Represents the lifecycle of a single Kafka broker. Handles all functionality required
@@ -100,9 +106,7 @@ class KafkaServer(val config: KafkaConfig, time: Time = Time.SYSTEM, threadNameP
 
   var metrics: Metrics = null
 
-  private val metricConfig: MetricConfig = new MetricConfig()
-    .samples(config.metricNumSamples)
-    .timeWindow(config.metricSampleWindowMs, TimeUnit.MILLISECONDS)
+  private val metricConfig: MetricConfig = KafkaServer.metricConfig(config)
 
   val brokerState: BrokerState = new BrokerState
 
diff --git a/core/src/test/scala/unit/kafka/server/KafkaConfigTest.scala b/core/src/test/scala/unit/kafka/server/KafkaConfigTest.scala
index 259178c57710b..0f5ff5dec6300 100755
--- a/core/src/test/scala/unit/kafka/server/KafkaConfigTest.scala
+++ b/core/src/test/scala/unit/kafka/server/KafkaConfigTest.scala
@@ -24,6 +24,7 @@ import kafka.cluster.EndPoint
 import kafka.message._
 import kafka.utils.{CoreUtils, TestUtils}
 import org.apache.kafka.common.config.ConfigException
+import org.apache.kafka.common.metrics.Sensor
 import org.apache.kafka.common.network.ListenerName
 import org.apache.kafka.common.protocol.SecurityProtocol
 import org.junit.Assert._
@@ -684,6 +685,8 @@ class KafkaConfigTest {
     //For LogFlushIntervalMsProp
     defaults.put(KafkaConfig.LogFlushSchedulerIntervalMsProp, "123")
     defaults.put(KafkaConfig.OffsetsTopicCompressionCodecProp, SnappyCompressionCodec.codec.toString)
+    // For MetricRecordingLevelProp
+    defaults.put(KafkaConfig.MetricRecordingLevelProp, Sensor.RecordingLevel.DEBUG.toString)
 
     val config = KafkaConfig.fromProps(defaults)
     assertEquals("127.0.0.1:2181", config.zkConnect)
@@ -701,6 +704,7 @@ class KafkaConfigTest {
     assertEquals(10 * 60L * 1000L * 60, config.logRetentionTimeMillis)
     assertEquals(123L, config.logFlushIntervalMs)
     assertEquals(SnappyCompressionCodec, config.offsetsTopicCompressionCodec)
+    assertEquals(Sensor.RecordingLevel.DEBUG.toString, config.metricRecordingLevel)
   }
 
   private def assertPropertyInvalid(validRequiredProps: => Properties, name: String, values: Any*) {
diff --git a/core/src/test/scala/unit/kafka/server/ServerMetricsTest.scala b/core/src/test/scala/unit/kafka/server/ServerMetricsTest.scala
new file mode 100755
index 0000000000000..dc96680c95893
--- /dev/null
+++ b/core/src/test/scala/unit/kafka/server/ServerMetricsTest.scala
@@ -0,0 +1,51 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package kafka.server
+
+import kafka.utils.TestUtils
+import org.apache.kafka.common.metrics.Sensor
+import org.junit.Assert._
+import org.junit.Test
+import org.scalatest.junit.JUnitSuite
+
+class ServerMetricsTest extends JUnitSuite {
+
+  @Test
+  def testMetricsConfig(): Unit = {
+    val recordingLevels = List(Sensor.RecordingLevel.DEBUG, Sensor.RecordingLevel.INFO)
+    val illegalNames = List("IllegalName", "")
+    val props = TestUtils.createBrokerConfig(0, "localhost:2818")
+
+    for (recordingLevel <- recordingLevels) {
+      props.put(KafkaConfig.MetricRecordingLevelProp, recordingLevel.name)
+      val config = KafkaConfig.fromProps(props)
+      val metricConfig = KafkaServer.metricConfig(config)
+      assertEquals(recordingLevel, metricConfig.recordLevel)
+    }
+
+    for (illegalName <- illegalNames) {
+      intercept[IllegalArgumentException] {
+        props.put(KafkaConfig.MetricRecordingLevelProp, illegalName)
+        val config = KafkaConfig.fromProps(props)
+        KafkaServer.metricConfig(config)
+      }
+    }
+
+  }
+
+}

From afde87804211dfea2b9ee87c5f6470e8460dcd33 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Mon, 23 Jan 2017 09:34:52 -0800
Subject: [PATCH 025/177] HOTFIX: KAFKA-4060 and KAFKA-4476 follow up

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Damian Guy, Guozhang Wang

Closes #2418 from mjsax/kafka-4060-zk-test-follow-up

(cherry picked from commit dd897bdb2e9cc8790d1e0494fb7867a5cd09ecc6)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../processor/DefaultPartitionGrouper.java    |  2 +-
 .../DefaultPartitionGrouperTest.java          | 72 ++++++++++++-------
 2 files changed, 49 insertions(+), 25 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/DefaultPartitionGrouper.java b/streams/src/main/java/org/apache/kafka/streams/processor/DefaultPartitionGrouper.java
index 2f354d8d3bc69..25efcd6eaf391 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/DefaultPartitionGrouper.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/DefaultPartitionGrouper.java
@@ -84,7 +84,7 @@ protected int maxNumPartitions(Cluster metadata, Set<String> topics) {
 
             if (partitions == null) {
                 log.info("Skipping assigning topic {} to tasks since its metadata is not available yet", topic);
-                maxNumPartitions = StreamPartitionAssignor.NOT_AVAILABLE;
+                return StreamPartitionAssignor.NOT_AVAILABLE;
             } else {
                 int numPartitions = partitions.size();
                 if (numPartitions > maxNumPartitions)
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/DefaultPartitionGrouperTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/DefaultPartitionGrouperTest.java
index e36bde4775876..e26453dc15846 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/DefaultPartitionGrouperTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/DefaultPartitionGrouperTest.java
@@ -21,8 +21,6 @@
 import org.apache.kafka.common.Node;
 import org.apache.kafka.common.PartitionInfo;
 import org.apache.kafka.common.TopicPartition;
-
-import static org.apache.kafka.common.utils.Utils.mkSet;
 import org.junit.Test;
 
 import java.util.Arrays;
@@ -32,11 +30,12 @@
 import java.util.Map;
 import java.util.Set;
 
+import static org.apache.kafka.common.utils.Utils.mkSet;
 import static org.junit.Assert.assertEquals;
 
 public class DefaultPartitionGrouperTest {
 
-    private List<PartitionInfo> infos = Arrays.asList(
+    private final List<PartitionInfo> infos = Arrays.asList(
             new PartitionInfo("topic1", 0, Node.noNode(), new Node[0], new Node[0]),
             new PartitionInfo("topic1", 1, Node.noNode(), new Node[0], new Node[0]),
             new PartitionInfo("topic1", 2, Node.noNode(), new Node[0], new Node[0]),
@@ -44,39 +43,64 @@ public class DefaultPartitionGrouperTest {
             new PartitionInfo("topic2", 1, Node.noNode(), new Node[0], new Node[0])
     );
 
-    private Cluster metadata = new Cluster("cluster", Collections.singletonList(Node.noNode()), infos, Collections.<String>emptySet(),
+    private final Cluster metadata = new Cluster(
+        "cluster",
+        Collections.singletonList(Node.noNode()),
+        infos,
+        Collections.<String>emptySet(),
         Collections.<String>emptySet());
 
     @Test
-    public void testGrouping() {
-        PartitionGrouper grouper = new DefaultPartitionGrouper();
-        int topicGroupId;
-        Map<TaskId, Set<TopicPartition>> expectedPartitionsForTask;
-        Map<Integer, Set<String>> topicGroups;
-
-        topicGroups = new HashMap<>();
-        topicGroups.put(0, mkSet("topic1"));
-        topicGroups.put(1, mkSet("topic2"));
-
-        expectedPartitionsForTask = new HashMap<>();
-        topicGroupId = 0;
+    public void shouldComputeGroupingForTwoGroups() {
+        final PartitionGrouper grouper = new DefaultPartitionGrouper();
+        final Map<TaskId, Set<TopicPartition>> expectedPartitionsForTask = new HashMap<>();
+        final Map<Integer, Set<String>> topicGroups = new HashMap<>();
+
+        int topicGroupId = 0;
+
+        topicGroups.put(topicGroupId, mkSet("topic1"));
         expectedPartitionsForTask.put(new TaskId(topicGroupId, 0), mkSet(new TopicPartition("topic1", 0)));
         expectedPartitionsForTask.put(new TaskId(topicGroupId, 1), mkSet(new TopicPartition("topic1", 1)));
         expectedPartitionsForTask.put(new TaskId(topicGroupId, 2), mkSet(new TopicPartition("topic1", 2)));
-        topicGroupId++;
+
+        topicGroups.put(++topicGroupId, mkSet("topic2"));
         expectedPartitionsForTask.put(new TaskId(topicGroupId, 0), mkSet(new TopicPartition("topic2", 0)));
         expectedPartitionsForTask.put(new TaskId(topicGroupId, 1), mkSet(new TopicPartition("topic2", 1)));
 
         assertEquals(expectedPartitionsForTask, grouper.partitionGroups(topicGroups, metadata));
+    }
 
-        topicGroups = new HashMap<>();
-        topicGroups.put(0, mkSet("topic1", "topic2"));
+    @Test
+    public void shouldComputeGroupingForSingleGroupWithMultipleTopics() {
+        final PartitionGrouper grouper = new DefaultPartitionGrouper();
+        final Map<TaskId, Set<TopicPartition>> expectedPartitionsForTask = new HashMap<>();
+        final Map<Integer, Set<String>> topicGroups = new HashMap<>();
 
-        expectedPartitionsForTask = new HashMap<>();
-        topicGroupId = 0;
-        expectedPartitionsForTask.put(new TaskId(topicGroupId, 0), mkSet(new TopicPartition("topic1", 0), new TopicPartition("topic2", 0)));
-        expectedPartitionsForTask.put(new TaskId(topicGroupId, 1), mkSet(new TopicPartition("topic1", 1), new TopicPartition("topic2", 1)));
-        expectedPartitionsForTask.put(new TaskId(topicGroupId, 2), mkSet(new TopicPartition("topic1", 2)));
+        final int topicGroupId = 0;
+
+        topicGroups.put(topicGroupId, mkSet("topic1", "topic2"));
+        expectedPartitionsForTask.put(
+            new TaskId(topicGroupId, 0),
+            mkSet(new TopicPartition("topic1", 0), new TopicPartition("topic2", 0)));
+        expectedPartitionsForTask.put(
+            new TaskId(topicGroupId, 1),
+            mkSet(new TopicPartition("topic1", 1), new TopicPartition("topic2", 1)));
+        expectedPartitionsForTask.put(
+            new TaskId(topicGroupId, 2),
+            mkSet(new TopicPartition("topic1", 2)));
+
+        assertEquals(expectedPartitionsForTask, grouper.partitionGroups(topicGroups, metadata));
+    }
+
+    @Test
+    public void shouldNotCreateAnyTasksBecauseOneTopicHasUnknownPartitions() {
+        final PartitionGrouper grouper = new DefaultPartitionGrouper();
+        final Map<TaskId, Set<TopicPartition>> expectedPartitionsForTask = new HashMap<>();
+        final Map<Integer, Set<String>> topicGroups = new HashMap<>();
+
+        final int topicGroupId = 0;
+
+        topicGroups.put(topicGroupId, mkSet("topic1", "unknownTopic", "topic2"));
 
         assertEquals(expectedPartitionsForTask, grouper.partitionGroups(topicGroups, metadata));
     }

From 80ceb75d2acf5c3d8c21e03bf55e706c637d9fd9 Mon Sep 17 00:00:00 2001
From: Hojjat Jafarpour <hojjat@Hojjat-Jafarpours-MBP.local>
Date: Mon, 23 Jan 2017 10:21:06 -0800
Subject: [PATCH 026/177] KAFKA-4060 Follow-up: update docs accordingly

Updated the docs with changes in KAFKA-4060.

Author: Hojjat Jafarpour <hojjat@Hojjat-Jafarpours-MBP.local>
Author: Hojjat Jafarpour <hojjat@HojjatJpoursMBP.attlocal.net>

Reviewers: Ismael Juma, Matthias J. Sax, Guozhang Wang

Closes #2377 from hjafarpour/KAFKA-4060-docs-update

(cherry picked from commit 62206de4e52dbec32b99baffa0ebf7f5303d7b7f)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 docs/upgrade.html | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/upgrade.html b/docs/upgrade.html
index a6683ba8b16cc..23b02afcfabb4 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -37,6 +37,8 @@ <h5><a id="upgrade_1020_notable" href="#upgrade_1020_notable">Notable changes in
         A new close API with timeout has been added to <code>KafkaConsumer</code> to control the maximum wait time.</li>
     <li>Multiple regular expressions separated by commas can be passed to MirrorMaker with the new Java consumer via the --whitelist option. This
         makes the behaviour consistent with MirrorMaker when used the old Scala consumer.</li>
+    <li>Zookeeper dependency was removed from the Streams API. Now the Streams API uses Kafka protocol to manage internal topics instead of modifying Zookeeper directly. This eliminates the need for privilege[s] to access Zookeeper directly and "StreamsConfig.ZOOKEEPER_CONFIG" should not be set in the streams app anymore. If the Kafka cluster is secured, the Streams apps require to have proper security privilege[s] to create new topics.</li>
+    <li>Several new fields including "security.protocol", "connections.max.idle.ms", "retry.backoff.ms", "reconnect.backoff.ms" and "request.timeout.ms" were added to StreamsConfig class. User should pay attenntion to the default values and set these if needed. For more details please refer to <a id="streamsconfigs" href="#streamsconfigs">3.5 Kafka Streams Configs</a>.</li>
 </ul>
 
 <h4><a id="upgrade_10_1" href="#upgrade_10_1">Upgrading from 0.8.x, 0.9.x or 0.10.0.X to 0.10.1.0</a></h4>

From 0f87991d5dbe8741953be04628810d76a9ee7434 Mon Sep 17 00:00:00 2001
From: Guozhang Wang <wangguoz@gmail.com>
Date: Mon, 23 Jan 2017 10:45:45 -0800
Subject: [PATCH 027/177] KAFKA-4633; Always using regex pattern subscription
 in StreamThread

1. In StreamThread, always use subscribe(Pattern, ..) function in order to avoid sending MetadataRequest with specific topic names and cause brokers to possibly auto-create subscribed topics; the pattern is generated as "topic-1|topic-2..|topic-n".

2. In ConsumerCoordinator, let the leader to refresh its metadata if the generated assignment contains some topics that is not contained in the subscribed topics; also in SubscriptionState, modified the verification for regex subscription to against the regex pattern instead of the matched topics since the returned assignment may contain some topics not yet created when joining the group but existed after the rebalance; also modified some unit tests in `KafkaConsumerTest` to accommodate the above changes.

3. Minor cleanup: changed String[] to List<String> to avoid overloaded functions.

4. Minor cleanup: enforced strong typing in SinkNodeFactory and removed unnecessary unchecked tags.

5. Minor cleanup: augmented unit test error message and fixed a potential transient failure in KafkaStreamTest.

Author: Guozhang Wang <wangguoz@gmail.com>

Reviewers: Damian Guy <damian.guy@gmail.com>, Matthias J. Sax <matthias@confluent.io>, Jason Gustafson <jason@confluent.io>

Closes #2379 from guozhangwang/K4633-regex-pattern

(cherry picked from commit 3400d0c3cc07d5d3136bf9a19142b36cca93f92d)
Signed-off-by: Jason Gustafson <jason@confluent.io>
---
 .../internals/ConsumerCoordinator.java        |  59 ++-
 .../consumer/internals/SubscriptionState.java |  13 +-
 .../clients/consumer/KafkaConsumerTest.java   |   6 +-
 .../internals/ConsumerCoordinatorTest.java    | 410 +++++++++++-------
 .../internals/SubscriptionStateTest.java      |  53 ++-
 .../kstream/internals/AbstractStream.java     |   6 -
 .../streams/processor/TopologyBuilder.java    | 182 +++-----
 .../streams/processor/internals/SinkNode.java |   4 +-
 .../processor/internals/SourceNode.java       |   9 +-
 .../processor/internals/StreamThread.java     |  13 +-
 .../internals/StreamsMetadataState.java       |  16 +-
 .../kafka/streams/KafkaStreamsTest.java       |   2 +
 .../KStreamRepartitionJoinTest.java           |   6 +-
 .../utils/EmbeddedKafkaCluster.java           |   2 +-
 .../utils/IntegrationTestUtils.java           |   4 +-
 .../streams/kstream/KStreamBuilderTest.java   |  12 +-
 .../processor/TopologyBuilderTest.java        |  21 +-
 .../SourceNodeRecordDeserializerTest.java     |   4 +-
 .../org/apache/kafka/test/MockSourceNode.java |   3 +-
 19 files changed, 478 insertions(+), 347 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java
index 7c463d10c9e8c..4c54a8f087b21 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java
@@ -216,6 +216,32 @@ protected void onJoinComplete(int generation,
         // update partition assignment
         subscriptions.assignFromSubscribed(assignment.partitions());
 
+        // check if the assignment contains some topics that were not in the original
+        // subscription, if yes we will obey what leader has decided and add these topics
+        // into the subscriptions as long as they still match the subscribed pattern
+        //
+        // TODO this part of the logic should be removed once we allow regex on leader assign
+        Set<String> addedTopics = new HashSet<>();
+        for (TopicPartition tp : subscriptions.assignedPartitions()) {
+            if (!joinedSubscription.contains(tp.topic()))
+                addedTopics.add(tp.topic());
+        }
+
+        if (!addedTopics.isEmpty()) {
+            Set<String> newSubscription = new HashSet<>(subscriptions.subscription());
+            Set<String> newJoinedSubscription = new HashSet<>(joinedSubscription);
+            newSubscription.addAll(addedTopics);
+            newJoinedSubscription.addAll(addedTopics);
+
+            this.subscriptions.subscribeFromPattern(newSubscription);
+            this.joinedSubscription = newJoinedSubscription;
+        }
+
+        // update the metadata and enforce a refresh to make sure the fetcher can start
+        // fetching data in the next iteration
+        this.metadata.setTopics(subscriptions.groupSubscription());
+        client.ensureFreshMetadata();
+
         // give the assignor a chance to update internal state based on the received assignment
         assignor.onAssignment(assignment);
 
@@ -307,13 +333,44 @@ protected Map<String, ByteBuffer> performAssignment(String leaderId,
         client.ensureFreshMetadata();
 
         isLeader = true;
-        assignmentSnapshot = metadataSnapshot;
 
         log.debug("Performing assignment for group {} using strategy {} with subscriptions {}",
                 groupId, assignor.name(), subscriptions);
 
         Map<String, Assignment> assignment = assignor.assign(metadata.fetch(), subscriptions);
 
+        // user-customized assignor may have created some topics that are not in the subscription list
+        // and assign their partitions to the members; in this case we would like to update the leader's
+        // own metadata with the newly added topics so that it will not trigger a subsequent rebalance
+        // when these topics gets updated from metadata refresh.
+        //
+        // TODO: this is a hack and not something we want to support long-term unless we push regex into the protocol
+        //       we may need to modify the PartitionAssingor API to better support this case.
+        Set<String> assignedTopics = new HashSet<>();
+        for (Assignment assigned : assignment.values()) {
+            for (TopicPartition tp : assigned.partitions())
+                assignedTopics.add(tp.topic());
+        }
+
+        if (!assignedTopics.containsAll(allSubscribedTopics)) {
+            Set<String> notAssignedTopics = new HashSet<>(allSubscribedTopics);
+            notAssignedTopics.removeAll(assignedTopics);
+            log.warn("The following subscribed topics are not assigned to any members in the group {} : {} ", groupId, notAssignedTopics);
+        }
+
+        if (!allSubscribedTopics.containsAll(assignedTopics)) {
+            Set<String> newlyAddedTopics = new HashSet<>(assignedTopics);
+            newlyAddedTopics.removeAll(allSubscribedTopics);
+            log.info("The following not-subscribed topics are assigned to group {}, and their metadata will be fetched from the brokers : {}", groupId, newlyAddedTopics);
+
+            allSubscribedTopics.addAll(assignedTopics);
+            this.subscriptions.groupSubscribe(allSubscribedTopics);
+            metadata.setTopics(this.subscriptions.groupSubscription());
+            client.ensureFreshMetadata();
+        }
+
+        assignmentSnapshot = metadataSnapshot;
+
         log.debug("Finished assignment for group {}: {}", groupId, assignment);
 
         Map<String, ByteBuffer> groupAssignment = new HashMap<>();
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/SubscriptionState.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/SubscriptionState.java
index 9e496ff08ce5b..1a2a7ee6d76bd 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/SubscriptionState.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/SubscriptionState.java
@@ -183,9 +183,16 @@ public void assignFromSubscribed(Collection<TopicPartition> assignments) {
         Set<TopicPartition> newAssignment = new HashSet<>(assignments);
         removeAllLagSensors(newAssignment);
 
-        for (TopicPartition tp : assignments)
-            if (!this.subscription.contains(tp.topic()))
-                throw new IllegalArgumentException("Assigned partition " + tp + " for non-subscribed topic.");
+        if (this.subscribedPattern != null) {
+            for (TopicPartition tp : assignments) {
+                if (!this.subscribedPattern.matcher(tp.topic()).matches())
+                    throw new IllegalArgumentException("Assigned partition " + tp + " for non-subscribed topic regex pattern; subscription pattern is " + this.subscribedPattern);
+            }
+        } else {
+            for (TopicPartition tp : assignments)
+                if (!this.subscription.contains(tp.topic()))
+                    throw new IllegalArgumentException("Assigned partition " + tp + " for non-subscribed topic; subscription is " + this.subscription);
+        }
 
         // after rebalancing, we always reinitialize the assignment value
         this.assignment.set(partitionToStateMap(assignments));
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
index 3e8310d410268..ac88ce9284420 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
@@ -366,7 +366,7 @@ public void verifyHeartbeatSent() throws Exception {
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
         metadata.update(cluster, time.milliseconds());
 
-        MockClient client = new MockClient(time);
+        MockClient client = new MockClient(time, metadata);
         client.setNode(node);
         PartitionAssignor assignor = new RoundRobinAssignor();
 
@@ -1228,7 +1228,7 @@ private void consumerCloseTest(final long closeTimeoutMs,
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
         metadata.update(cluster, time.milliseconds());
 
-        MockClient client = new MockClient(time);
+        MockClient client = new MockClient(time, metadata);
         client.setNode(node);
         PartitionAssignor assignor = new RoundRobinAssignor();
 
@@ -1238,6 +1238,8 @@ private void consumerCloseTest(final long closeTimeoutMs,
         consumer.subscribe(Arrays.asList(topic), getConsumerRebalanceListener(consumer));
         Node coordinator = prepareRebalance(client, node, assignor, Arrays.asList(tp0), null);
 
+        client.prepareMetadataUpdate(cluster);
+
         // Poll with responses
         client.prepareResponseFrom(fetchResponse(tp0, 0, 1), node);
         client.prepareResponseFrom(fetchResponse(tp0, 1, 0), node);
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java
index ee6afe19de5ac..3c4dd2dac5deb 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java
@@ -85,9 +85,11 @@
 
 public class ConsumerCoordinatorTest {
 
-    private String topicName = "test";
+    private String topic1 = "test1";
+    private String topic2 = "test2";
     private String groupId = "test-group";
-    private TopicPartition tp = new TopicPartition(topicName, 0);
+    private TopicPartition t1p = new TopicPartition(topic1, 0);
+    private TopicPartition t2p = new TopicPartition(topic2, 0);
     private int rebalanceTimeoutMs = 60000;
     private int sessionTimeoutMs = 10000;
     private int heartbeatIntervalMs = 5000;
@@ -98,7 +100,12 @@ public class ConsumerCoordinatorTest {
     private List<PartitionAssignor> assignors = Collections.<PartitionAssignor>singletonList(partitionAssignor);
     private MockTime time;
     private MockClient client;
-    private Cluster cluster = TestUtils.singletonCluster(topicName, 1);
+    private Cluster cluster = TestUtils.clusterWith(1, new HashMap<String, Integer>() {
+        {
+            put(topic1, 1);
+            put(topic2, 1);
+        }
+    });
     private Node node = cluster.nodes().get(0);
     private SubscriptionState subscriptions;
     private Metadata metadata;
@@ -112,10 +119,10 @@ public class ConsumerCoordinatorTest {
     @Before
     public void setup() {
         this.time = new MockTime();
-        this.client = new MockClient(time);
         this.subscriptions = new SubscriptionState(OffsetResetStrategy.EARLIEST, metrics);
         this.metadata = new Metadata(0, Long.MAX_VALUE);
         this.metadata.update(cluster, time.milliseconds());
+        this.client = new MockClient(time, metadata);
         this.consumerClient = new ConsumerNetworkClient(client, metadata, time, 100, 1000);
         this.metrics = new Metrics(time);
         this.rebalanceListener = new MockRebalanceListener();
@@ -157,7 +164,7 @@ public void testGroupDescribeUnauthorized() {
 
     @Test(expected = GroupAuthorizationException.class)
     public void testGroupReadUnauthorized() {
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
@@ -215,8 +222,8 @@ public void testIllegalGeneration() {
         coordinator.ensureCoordinatorReady();
 
         // illegal_generation will cause re-partition
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
-        subscriptions.assignFromSubscribed(Collections.singletonList(tp));
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
+        subscriptions.assignFromSubscribed(Collections.singletonList(t1p));
 
         time.sleep(sessionTimeoutMs);
         RequestFuture<Void> future = coordinator.sendHeartbeatRequest(); // should send out the heartbeat
@@ -239,8 +246,8 @@ public void testUnknownConsumerId() {
         coordinator.ensureCoordinatorReady();
 
         // illegal_generation will cause re-partition
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
-        subscriptions.assignFromSubscribed(Collections.singletonList(tp));
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
+        subscriptions.assignFromSubscribed(Collections.singletonList(t1p));
 
         time.sleep(sessionTimeoutMs);
         RequestFuture<Void> future = coordinator.sendHeartbeatRequest(); // should send out the heartbeat
@@ -282,10 +289,10 @@ public void testCoordinatorDisconnect() {
     public void testJoinGroupInvalidGroupId() {
         final String consumerId = "leader";
 
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         // ensure metadata is up-to-date for leader
-        metadata.setTopics(singletonList(topicName));
+        metadata.setTopics(singletonList(topic1));
         metadata.update(cluster, time.milliseconds());
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
@@ -300,18 +307,18 @@ public void testJoinGroupInvalidGroupId() {
     public void testNormalJoinGroupLeader() {
         final String consumerId = "leader";
 
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         // ensure metadata is up-to-date for leader
-        metadata.setTopics(singletonList(topicName));
+        metadata.setTopics(singletonList(topic1));
         metadata.update(cluster, time.milliseconds());
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
         // normal join group
-        Map<String, List<String>> memberSubscriptions = Collections.singletonMap(consumerId, singletonList(topicName));
-        partitionAssignor.prepare(Collections.singletonMap(consumerId, singletonList(tp)));
+        Map<String, List<String>> memberSubscriptions = Collections.singletonMap(consumerId, singletonList(topic1));
+        partitionAssignor.prepare(Collections.singletonMap(consumerId, singletonList(t1p)));
 
         client.prepareResponse(joinGroupLeaderResponse(1, consumerId, memberSubscriptions, Errors.NONE.code()));
         client.prepareResponse(new MockClient.RequestMatcher() {
@@ -322,37 +329,79 @@ public boolean matches(AbstractRequest body) {
                         sync.generationId() == 1 &&
                         sync.groupAssignment().containsKey(consumerId);
             }
-        }, syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        }, syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
         coordinator.poll(time.milliseconds());
 
         assertFalse(coordinator.needRejoin());
-        assertEquals(singleton(tp), subscriptions.assignedPartitions());
+        assertEquals(singleton(t1p), subscriptions.assignedPartitions());
+        assertEquals(singleton(topic1), subscriptions.groupSubscription());
         assertEquals(1, rebalanceListener.revokedCount);
         assertEquals(Collections.emptySet(), rebalanceListener.revoked);
         assertEquals(1, rebalanceListener.assignedCount);
-        assertEquals(singleton(tp), rebalanceListener.assigned);
+        assertEquals(singleton(t1p), rebalanceListener.assigned);
+    }
+
+    @Test
+    public void testPatternJoinGroupLeader() {
+        final String consumerId = "leader";
+
+        subscriptions.subscribe(Pattern.compile("test.*"), rebalanceListener);
+
+        // partially update the metadata with one topic first,
+        // let the leader to refresh metadata during assignment
+        metadata.setTopics(singletonList(topic1));
+        metadata.update(TestUtils.singletonCluster(topic1, 1), time.milliseconds());
+
+        client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
+        coordinator.ensureCoordinatorReady();
+
+        // normal join group
+        Map<String, List<String>> memberSubscriptions = Collections.singletonMap(consumerId, singletonList(topic1));
+        partitionAssignor.prepare(Collections.singletonMap(consumerId, Arrays.asList(t1p, t2p)));
+
+        client.prepareResponse(joinGroupLeaderResponse(1, consumerId, memberSubscriptions, Errors.NONE.code()));
+        client.prepareResponse(new MockClient.RequestMatcher() {
+            @Override
+            public boolean matches(AbstractRequest body) {
+                SyncGroupRequest sync = (SyncGroupRequest) body;
+                return sync.memberId().equals(consumerId) &&
+                        sync.generationId() == 1 &&
+                        sync.groupAssignment().containsKey(consumerId);
+            }
+        }, syncGroupResponse(Arrays.asList(t1p, t2p), Errors.NONE.code()));
+        // expect client to force updating the metadata, if yes gives it both topics
+        client.prepareMetadataUpdate(cluster);
+
+        coordinator.poll(time.milliseconds());
+
+        assertFalse(coordinator.needRejoin());
+        assertEquals(2, subscriptions.assignedPartitions().size());
+        assertEquals(2, subscriptions.groupSubscription().size());
+        assertEquals(2, subscriptions.subscription().size());
+        assertEquals(1, rebalanceListener.revokedCount);
+        assertEquals(Collections.emptySet(), rebalanceListener.revoked);
+        assertEquals(1, rebalanceListener.assignedCount);
+        assertEquals(2, rebalanceListener.assigned.size());
     }
 
     @Test
     public void testMetadataRefreshDuringRebalance() {
         final String consumerId = "leader";
-        final String otherTopicName = "otherTopic";
-        TopicPartition otherPartition = new TopicPartition(otherTopicName, 0);
 
         subscriptions.subscribe(Pattern.compile(".*"), rebalanceListener);
         metadata.needMetadataForAllTopics(true);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(TestUtils.singletonCluster(topic1, 1), time.milliseconds());
 
-        assertEquals(singleton(topicName), subscriptions.subscription());
+        assertEquals(singleton(topic1), subscriptions.subscription());
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        Map<String, List<String>> initialSubscription = singletonMap(consumerId, singletonList(topicName));
-        partitionAssignor.prepare(singletonMap(consumerId, singletonList(tp)));
+        Map<String, List<String>> initialSubscription = singletonMap(consumerId, singletonList(topic1));
+        partitionAssignor.prepare(singletonMap(consumerId, singletonList(t1p)));
 
         // the metadata will be updated in flight with a new topic added
-        final List<String> updatedSubscription = Arrays.asList(topicName, otherTopicName);
+        final List<String> updatedSubscription = Arrays.asList(topic1, topic2);
         final Set<String> updatedSubscriptionSet = new HashSet<>(updatedSubscription);
 
         client.prepareResponse(joinGroupLeaderResponse(1, consumerId, initialSubscription, Errors.NONE.code()));
@@ -365,12 +414,12 @@ public boolean matches(AbstractRequest body) {
                 metadata.update(TestUtils.clusterWith(1, updatedPartitions), time.milliseconds());
                 return true;
             }
-        }, syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        }, syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
 
-        List<TopicPartition> newAssignment = Arrays.asList(tp, otherPartition);
+        List<TopicPartition> newAssignment = Arrays.asList(t1p, t2p);
         Set<TopicPartition> newAssignmentSet = new HashSet<>(newAssignment);
 
-        Map<String, List<String>> updatedSubscriptions = singletonMap(consumerId, Arrays.asList(topicName, otherTopicName));
+        Map<String, List<String>> updatedSubscriptions = singletonMap(consumerId, Arrays.asList(topic1, topic2));
         partitionAssignor.prepare(singletonMap(consumerId, newAssignment));
 
         // we expect to see a second rebalance with the new-found topics
@@ -392,7 +441,7 @@ public boolean matches(AbstractRequest body) {
         assertEquals(updatedSubscriptionSet, subscriptions.subscription());
         assertEquals(newAssignmentSet, subscriptions.assignedPartitions());
         assertEquals(2, rebalanceListener.revokedCount);
-        assertEquals(singleton(tp), rebalanceListener.revoked);
+        assertEquals(singleton(t1p), rebalanceListener.revoked);
         assertEquals(2, rebalanceListener.assignedCount);
         assertEquals(newAssignmentSet, rebalanceListener.assigned);
     }
@@ -401,17 +450,17 @@ public boolean matches(AbstractRequest body) {
     public void testWakeupDuringJoin() {
         final String consumerId = "leader";
 
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         // ensure metadata is up-to-date for leader
-        metadata.setTopics(singletonList(topicName));
+        metadata.setTopics(singletonList(topic1));
         metadata.update(cluster, time.milliseconds());
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        Map<String, List<String>> memberSubscriptions = Collections.singletonMap(consumerId, singletonList(topicName));
-        partitionAssignor.prepare(Collections.singletonMap(consumerId, singletonList(tp)));
+        Map<String, List<String>> memberSubscriptions = Collections.singletonMap(consumerId, singletonList(topic1));
+        partitionAssignor.prepare(Collections.singletonMap(consumerId, singletonList(t1p)));
 
         // prepare only the first half of the join and then trigger the wakeup
         client.prepareResponse(joinGroupLeaderResponse(1, consumerId, memberSubscriptions, Errors.NONE.code()));
@@ -424,22 +473,22 @@ public void testWakeupDuringJoin() {
         }
 
         // now complete the second half
-        client.prepareResponse(syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
         coordinator.poll(time.milliseconds());
 
         assertFalse(coordinator.needRejoin());
-        assertEquals(singleton(tp), subscriptions.assignedPartitions());
+        assertEquals(singleton(t1p), subscriptions.assignedPartitions());
         assertEquals(1, rebalanceListener.revokedCount);
         assertEquals(Collections.emptySet(), rebalanceListener.revoked);
         assertEquals(1, rebalanceListener.assignedCount);
-        assertEquals(singleton(tp), rebalanceListener.assigned);
+        assertEquals(singleton(t1p), rebalanceListener.assigned);
     }
 
     @Test
     public void testNormalJoinGroupFollower() {
         final String consumerId = "consumer";
 
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
@@ -454,28 +503,68 @@ public boolean matches(AbstractRequest body) {
                         sync.generationId() == 1 &&
                         sync.groupAssignment().isEmpty();
             }
-        }, syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        }, syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
 
         coordinator.joinGroupIfNeeded();
 
         assertFalse(coordinator.needRejoin());
-        assertEquals(singleton(tp), subscriptions.assignedPartitions());
+        assertEquals(singleton(t1p), subscriptions.assignedPartitions());
+        assertEquals(singleton(topic1), subscriptions.groupSubscription());
         assertEquals(1, rebalanceListener.revokedCount);
+        assertEquals(Collections.emptySet(), rebalanceListener.revoked);
         assertEquals(1, rebalanceListener.assignedCount);
-        assertEquals(singleton(tp), rebalanceListener.assigned);
+        assertEquals(singleton(t1p), rebalanceListener.assigned);
+    }
+
+    @Test
+    public void testPatternJoinGroupFollower() {
+        final String consumerId = "consumer";
+
+        subscriptions.subscribe(Pattern.compile("test.*"), rebalanceListener);
+
+        // partially update the metadata with one topic first,
+        // let the leader to refresh metadata during assignment
+        metadata.setTopics(singletonList(topic1));
+        metadata.update(TestUtils.singletonCluster(topic1, 1), time.milliseconds());
+
+        client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
+        coordinator.ensureCoordinatorReady();
+
+        // normal join group
+        client.prepareResponse(joinGroupFollowerResponse(1, consumerId, "leader", Errors.NONE.code()));
+        client.prepareResponse(new MockClient.RequestMatcher() {
+            @Override
+            public boolean matches(AbstractRequest body) {
+                SyncGroupRequest sync = (SyncGroupRequest) body;
+                return sync.memberId().equals(consumerId) &&
+                        sync.generationId() == 1 &&
+                        sync.groupAssignment().isEmpty();
+            }
+        }, syncGroupResponse(Arrays.asList(t1p, t2p), Errors.NONE.code()));
+        // expect client to force updating the metadata, if yes gives it both topics
+        client.prepareMetadataUpdate(cluster);
+
+        coordinator.joinGroupIfNeeded();
+
+        assertFalse(coordinator.needRejoin());
+        assertEquals(2, subscriptions.assignedPartitions().size());
+        assertEquals(2, subscriptions.subscription().size());
+        assertEquals(1, rebalanceListener.revokedCount);
+        assertEquals(1, rebalanceListener.assignedCount);
+        assertEquals(2, rebalanceListener.assigned.size());
     }
 
     @Test
     public void testLeaveGroupOnClose() {
         final String consumerId = "consumer";
 
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
         client.prepareResponse(joinGroupFollowerResponse(1, consumerId, "leader", Errors.NONE.code()));
-        client.prepareResponse(syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
         coordinator.joinGroupIfNeeded();
 
         final AtomicBoolean received = new AtomicBoolean(false);
@@ -496,13 +585,13 @@ public boolean matches(AbstractRequest body) {
     public void testMaybeLeaveGroup() {
         final String consumerId = "consumer";
 
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
         client.prepareResponse(joinGroupFollowerResponse(1, consumerId, "leader", Errors.NONE.code()));
-        client.prepareResponse(syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
         coordinator.joinGroupIfNeeded();
 
         final AtomicBoolean received = new AtomicBoolean(false);
@@ -526,7 +615,7 @@ public boolean matches(AbstractRequest body) {
     public void testUnexpectedErrorOnSyncGroup() {
         final String consumerId = "consumer";
 
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
@@ -541,7 +630,7 @@ public void testUnexpectedErrorOnSyncGroup() {
     public void testUnknownMemberIdOnSyncGroup() {
         final String consumerId = "consumer";
 
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
@@ -558,19 +647,19 @@ public boolean matches(AbstractRequest body) {
                 return joinRequest.memberId().equals(JoinGroupRequest.UNKNOWN_MEMBER_ID);
             }
         }, joinGroupFollowerResponse(2, consumerId, "leader", Errors.NONE.code()));
-        client.prepareResponse(syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
 
         coordinator.joinGroupIfNeeded();
 
         assertFalse(coordinator.needRejoin());
-        assertEquals(singleton(tp), subscriptions.assignedPartitions());
+        assertEquals(singleton(t1p), subscriptions.assignedPartitions());
     }
 
     @Test
     public void testRebalanceInProgressOnSyncGroup() {
         final String consumerId = "consumer";
 
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
@@ -581,19 +670,19 @@ public void testRebalanceInProgressOnSyncGroup() {
 
         // then let the full join/sync finish successfully
         client.prepareResponse(joinGroupFollowerResponse(2, consumerId, "leader", Errors.NONE.code()));
-        client.prepareResponse(syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
 
         coordinator.joinGroupIfNeeded();
 
         assertFalse(coordinator.needRejoin());
-        assertEquals(singleton(tp), subscriptions.assignedPartitions());
+        assertEquals(singleton(t1p), subscriptions.assignedPartitions());
     }
 
     @Test
     public void testIllegalGenerationOnSyncGroup() {
         final String consumerId = "consumer";
 
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
@@ -610,12 +699,12 @@ public boolean matches(AbstractRequest body) {
                 return joinRequest.memberId().equals(JoinGroupRequest.UNKNOWN_MEMBER_ID);
             }
         }, joinGroupFollowerResponse(2, consumerId, "leader", Errors.NONE.code()));
-        client.prepareResponse(syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
 
         coordinator.joinGroupIfNeeded();
 
         assertFalse(coordinator.needRejoin());
-        assertEquals(singleton(tp), subscriptions.assignedPartitions());
+        assertEquals(singleton(t1p), subscriptions.assignedPartitions());
     }
 
     @Test
@@ -623,27 +712,27 @@ public void testMetadataChangeTriggersRebalance() {
         final String consumerId = "consumer";
 
         // ensure metadata is up-to-date for leader
-        metadata.setTopics(singletonList(topicName));
+        metadata.setTopics(singletonList(topic1));
         metadata.update(cluster, time.milliseconds());
 
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        Map<String, List<String>> memberSubscriptions = Collections.singletonMap(consumerId, singletonList(topicName));
-        partitionAssignor.prepare(Collections.singletonMap(consumerId, singletonList(tp)));
+        Map<String, List<String>> memberSubscriptions = Collections.singletonMap(consumerId, singletonList(topic1));
+        partitionAssignor.prepare(Collections.singletonMap(consumerId, singletonList(t1p)));
 
         // the leader is responsible for picking up metadata changes and forcing a group rebalance
         client.prepareResponse(joinGroupLeaderResponse(1, consumerId, memberSubscriptions, Errors.NONE.code()));
-        client.prepareResponse(syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
 
         coordinator.poll(time.milliseconds());
 
         assertFalse(coordinator.needRejoin());
 
         // a new partition is added to the topic
-        metadata.update(TestUtils.singletonCluster(topicName, 2), time.milliseconds());
+        metadata.update(TestUtils.singletonCluster(topic1, 2), time.milliseconds());
 
         // we should detect the change and ask for reassignment
         assertTrue(coordinator.needRejoin());
@@ -670,7 +759,7 @@ public void testUpdateMetadataDuringRebalance() {
 
         // prepare initial rebalance
         Map<String, List<String>> memberSubscriptions = Collections.singletonMap(consumerId, topics);
-        partitionAssignor.prepare(Collections.singletonMap(consumerId, Arrays.asList(tp1)));
+        partitionAssignor.prepare(Collections.singletonMap(consumerId, Collections.singletonList(tp1)));
 
         client.prepareResponse(joinGroupLeaderResponse(1, consumerId, memberSubscriptions, Errors.NONE.code()));
         client.prepareResponse(new MockClient.RequestMatcher() {
@@ -689,7 +778,7 @@ public boolean matches(AbstractRequest body) {
                 }
                 return false;
             }
-        }, syncGroupResponse(Arrays.asList(tp1), Errors.NONE.code()));
+        }, syncGroupResponse(Collections.singletonList(tp1), Errors.NONE.code()));
 
         // the metadata update should trigger a second rebalance
         client.prepareResponse(joinGroupLeaderResponse(2, consumerId, memberSubscriptions, Errors.NONE.code()));
@@ -725,36 +814,36 @@ public void testIncludeInternalTopicsConfigOption() {
     public void testRejoinGroup() {
         String otherTopic = "otherTopic";
 
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
         // join the group once
         client.prepareResponse(joinGroupFollowerResponse(1, "consumer", "leader", Errors.NONE.code()));
-        client.prepareResponse(syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
         coordinator.joinGroupIfNeeded();
 
         assertEquals(1, rebalanceListener.revokedCount);
         assertTrue(rebalanceListener.revoked.isEmpty());
         assertEquals(1, rebalanceListener.assignedCount);
-        assertEquals(singleton(tp), rebalanceListener.assigned);
+        assertEquals(singleton(t1p), rebalanceListener.assigned);
 
         // and join the group again
-        subscriptions.subscribe(new HashSet<>(Arrays.asList(topicName, otherTopic)), rebalanceListener);
+        subscriptions.subscribe(new HashSet<>(Arrays.asList(topic1, otherTopic)), rebalanceListener);
         client.prepareResponse(joinGroupFollowerResponse(2, "consumer", "leader", Errors.NONE.code()));
-        client.prepareResponse(syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
         coordinator.joinGroupIfNeeded();
 
         assertEquals(2, rebalanceListener.revokedCount);
-        assertEquals(singleton(tp), rebalanceListener.revoked);
+        assertEquals(singleton(t1p), rebalanceListener.revoked);
         assertEquals(2, rebalanceListener.assignedCount);
-        assertEquals(singleton(tp), rebalanceListener.assigned);
+        assertEquals(singleton(t1p), rebalanceListener.assigned);
     }
 
     @Test
     public void testDisconnectInJoin() {
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
@@ -763,19 +852,19 @@ public void testDisconnectInJoin() {
         client.prepareResponse(joinGroupFollowerResponse(1, "consumer", "leader", Errors.NONE.code()), true);
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         client.prepareResponse(joinGroupFollowerResponse(1, "consumer", "leader", Errors.NONE.code()));
-        client.prepareResponse(syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
         coordinator.joinGroupIfNeeded();
 
         assertFalse(coordinator.needRejoin());
-        assertEquals(singleton(tp), subscriptions.assignedPartitions());
+        assertEquals(singleton(t1p), subscriptions.assignedPartitions());
         assertEquals(1, rebalanceListener.revokedCount);
         assertEquals(1, rebalanceListener.assignedCount);
-        assertEquals(singleton(tp), rebalanceListener.assigned);
+        assertEquals(singleton(t1p), rebalanceListener.assigned);
     }
 
     @Test(expected = ApiException.class)
     public void testInvalidSessionTimeout() {
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
@@ -787,19 +876,19 @@ public void testInvalidSessionTimeout() {
 
     @Test
     public void testCommitOffsetOnly() {
-        subscriptions.assignFromUser(singleton(tp));
+        subscriptions.assignFromUser(singleton(t1p));
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.NONE.code())));
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.NONE.code())));
 
         AtomicBoolean success = new AtomicBoolean(false);
-        coordinator.commitOffsetsAsync(Collections.singletonMap(tp, new OffsetAndMetadata(100L)), callback(success));
+        coordinator.commitOffsetsAsync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L)), callback(success));
         coordinator.invokeCompletedOffsetCommitCallbacks();
         assertTrue(success.get());
 
-        assertEquals(100L, subscriptions.committed(tp).offset());
+        assertEquals(100L, subscriptions.committed(t1p).offset());
     }
 
     @Test
@@ -809,22 +898,22 @@ public void testAutoCommitDynamicAssignment() {
         ConsumerCoordinator coordinator = buildCoordinator(new Metrics(), assignors,
                 ConsumerConfig.DEFAULT_EXCLUDE_INTERNAL_TOPICS, true);
 
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
         client.prepareResponse(joinGroupFollowerResponse(1, consumerId, "leader", Errors.NONE.code()));
-        client.prepareResponse(syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
         coordinator.joinGroupIfNeeded();
 
-        subscriptions.seek(tp, 100);
+        subscriptions.seek(t1p, 100);
 
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.NONE.code())));
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.NONE.code())));
         time.sleep(autoCommitIntervalMs);
         coordinator.poll(time.milliseconds());
 
-        assertEquals(100L, subscriptions.committed(tp).offset());
+        assertEquals(100L, subscriptions.committed(t1p).offset());
     }
 
     @Test
@@ -834,7 +923,7 @@ public void testAutoCommitDynamicAssignmentRebalance() {
         ConsumerCoordinator coordinator = buildCoordinator(new Metrics(), assignors,
                 ConsumerConfig.DEFAULT_EXCLUDE_INTERNAL_TOPICS, true);
 
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
@@ -844,16 +933,16 @@ public void testAutoCommitDynamicAssignmentRebalance() {
         consumerClient.poll(0);
 
         client.prepareResponse(joinGroupFollowerResponse(1, consumerId, "leader", Errors.NONE.code()));
-        client.prepareResponse(syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
         coordinator.joinGroupIfNeeded();
 
-        subscriptions.seek(tp, 100);
+        subscriptions.seek(t1p, 100);
 
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.NONE.code())));
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.NONE.code())));
         time.sleep(autoCommitIntervalMs);
         coordinator.poll(time.milliseconds());
 
-        assertEquals(100L, subscriptions.committed(tp).offset());
+        assertEquals(100L, subscriptions.committed(t1p).offset());
     }
 
     @Test
@@ -861,17 +950,17 @@ public void testAutoCommitManualAssignment() {
         ConsumerCoordinator coordinator = buildCoordinator(new Metrics(), assignors,
                 ConsumerConfig.DEFAULT_EXCLUDE_INTERNAL_TOPICS, true);
 
-        subscriptions.assignFromUser(singleton(tp));
-        subscriptions.seek(tp, 100);
+        subscriptions.assignFromUser(singleton(t1p));
+        subscriptions.seek(t1p, 100);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.NONE.code())));
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.NONE.code())));
         time.sleep(autoCommitIntervalMs);
         coordinator.poll(time.milliseconds());
 
-        assertEquals(100L, subscriptions.committed(tp).offset());
+        assertEquals(100L, subscriptions.committed(t1p).offset());
     }
 
     @Test
@@ -879,15 +968,15 @@ public void testAutoCommitManualAssignmentCoordinatorUnknown() {
         ConsumerCoordinator coordinator = buildCoordinator(new Metrics(), assignors,
                 ConsumerConfig.DEFAULT_EXCLUDE_INTERNAL_TOPICS, true);
 
-        subscriptions.assignFromUser(singleton(tp));
-        subscriptions.seek(tp, 100);
+        subscriptions.assignFromUser(singleton(t1p));
+        subscriptions.seek(t1p, 100);
 
         // no commit initially since coordinator is unknown
         consumerClient.poll(0);
         time.sleep(autoCommitIntervalMs);
         consumerClient.poll(0);
 
-        assertNull(subscriptions.committed(tp));
+        assertNull(subscriptions.committed(t1p));
 
         // now find the coordinator
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
@@ -895,28 +984,28 @@ public void testAutoCommitManualAssignmentCoordinatorUnknown() {
 
         // sleep only for the retry backoff
         time.sleep(retryBackoffMs);
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.NONE.code())));
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.NONE.code())));
         coordinator.poll(time.milliseconds());
 
-        assertEquals(100L, subscriptions.committed(tp).offset());
+        assertEquals(100L, subscriptions.committed(t1p).offset());
     }
 
     @Test
     public void testCommitOffsetMetadata() {
-        subscriptions.assignFromUser(singleton(tp));
+        subscriptions.assignFromUser(singleton(t1p));
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.NONE.code())));
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.NONE.code())));
 
         AtomicBoolean success = new AtomicBoolean(false);
-        coordinator.commitOffsetsAsync(Collections.singletonMap(tp, new OffsetAndMetadata(100L, "hello")), callback(success));
+        coordinator.commitOffsetsAsync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L, "hello")), callback(success));
         coordinator.invokeCompletedOffsetCommitCallbacks();
         assertTrue(success.get());
 
-        assertEquals(100L, subscriptions.committed(tp).offset());
-        assertEquals("hello", subscriptions.committed(tp).metadata());
+        assertEquals(100L, subscriptions.committed(t1p).offset());
+        assertEquals("hello", subscriptions.committed(t1p).metadata());
     }
 
     @Test
@@ -924,8 +1013,8 @@ public void testCommitOffsetAsyncWithDefaultCallback() {
         int invokedBeforeTest = defaultOffsetCommitCallback.invoked;
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.NONE.code())));
-        coordinator.commitOffsetsAsync(Collections.singletonMap(tp, new OffsetAndMetadata(100L)), null);
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.NONE.code())));
+        coordinator.commitOffsetsAsync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L)), null);
         coordinator.invokeCompletedOffsetCommitCallbacks();
         assertEquals(invokedBeforeTest + 1, defaultOffsetCommitCallback.invoked);
         assertNull(defaultOffsetCommitCallback.exception);
@@ -934,20 +1023,23 @@ public void testCommitOffsetAsyncWithDefaultCallback() {
     @Test
     public void testCommitAfterLeaveGroup() {
         // enable auto-assignment
-        subscriptions.subscribe(singleton(topicName), rebalanceListener);
+        subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
         client.prepareResponse(joinGroupFollowerResponse(1, "consumer", "leader", Errors.NONE.code()));
-        client.prepareResponse(syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+        client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
+
+        client.prepareMetadataUpdate(cluster);
+
         coordinator.joinGroupIfNeeded();
 
         // now switch to manual assignment
         client.prepareResponse(new LeaveGroupResponse(Errors.NONE.code()));
         subscriptions.unsubscribe();
         coordinator.maybeLeaveGroup();
-        subscriptions.assignFromUser(singleton(tp));
+        subscriptions.assignFromUser(singleton(t1p));
 
         // the client should not reuse generation/memberId from auto-subscribed generation
         client.prepareResponse(new MockClient.RequestMatcher() {
@@ -957,10 +1049,10 @@ public boolean matches(AbstractRequest body) {
                 return commitRequest.memberId().equals(OffsetCommitRequest.DEFAULT_MEMBER_ID) &&
                         commitRequest.generationId() == OffsetCommitRequest.DEFAULT_GENERATION_ID;
             }
-        }, offsetCommitResponse(Collections.singletonMap(tp, Errors.NONE.code())));
+        }, offsetCommitResponse(Collections.singletonMap(t1p, Errors.NONE.code())));
 
         AtomicBoolean success = new AtomicBoolean(false);
-        coordinator.commitOffsetsAsync(Collections.singletonMap(tp, new OffsetAndMetadata(100L)), callback(success));
+        coordinator.commitOffsetsAsync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L)), callback(success));
         coordinator.invokeCompletedOffsetCommitCallbacks();
         assertTrue(success.get());
     }
@@ -970,8 +1062,8 @@ public void testCommitOffsetAsyncFailedWithDefaultCallback() {
         int invokedBeforeTest = defaultOffsetCommitCallback.invoked;
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.GROUP_COORDINATOR_NOT_AVAILABLE.code())));
-        coordinator.commitOffsetsAsync(Collections.singletonMap(tp, new OffsetAndMetadata(100L)), null);
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.GROUP_COORDINATOR_NOT_AVAILABLE.code())));
+        coordinator.commitOffsetsAsync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L)), null);
         coordinator.invokeCompletedOffsetCommitCallbacks();
         assertEquals(invokedBeforeTest + 1, defaultOffsetCommitCallback.invoked);
         assertTrue(defaultOffsetCommitCallback.exception instanceof RetriableCommitFailedException);
@@ -984,8 +1076,8 @@ public void testCommitOffsetAsyncCoordinatorNotAvailable() {
 
         // async commit with coordinator not available
         MockCommitCallback cb = new MockCommitCallback();
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.GROUP_COORDINATOR_NOT_AVAILABLE.code())));
-        coordinator.commitOffsetsAsync(Collections.singletonMap(tp, new OffsetAndMetadata(100L)), cb);
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.GROUP_COORDINATOR_NOT_AVAILABLE.code())));
+        coordinator.commitOffsetsAsync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L)), cb);
         coordinator.invokeCompletedOffsetCommitCallbacks();
 
         assertTrue(coordinator.coordinatorUnknown());
@@ -1000,8 +1092,8 @@ public void testCommitOffsetAsyncNotCoordinator() {
 
         // async commit with not coordinator
         MockCommitCallback cb = new MockCommitCallback();
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.NOT_COORDINATOR_FOR_GROUP.code())));
-        coordinator.commitOffsetsAsync(Collections.singletonMap(tp, new OffsetAndMetadata(100L)), cb);
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.NOT_COORDINATOR_FOR_GROUP.code())));
+        coordinator.commitOffsetsAsync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L)), cb);
         coordinator.invokeCompletedOffsetCommitCallbacks();
 
         assertTrue(coordinator.coordinatorUnknown());
@@ -1016,8 +1108,8 @@ public void testCommitOffsetAsyncDisconnected() {
 
         // async commit with coordinator disconnected
         MockCommitCallback cb = new MockCommitCallback();
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.NONE.code())), true);
-        coordinator.commitOffsetsAsync(Collections.singletonMap(tp, new OffsetAndMetadata(100L)), cb);
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.NONE.code())), true);
+        coordinator.commitOffsetsAsync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L)), cb);
         coordinator.invokeCompletedOffsetCommitCallbacks();
 
         assertTrue(coordinator.coordinatorUnknown());
@@ -1031,10 +1123,10 @@ public void testCommitOffsetSyncNotCoordinator() {
         coordinator.ensureCoordinatorReady();
 
         // sync commit with coordinator disconnected (should connect, get metadata, and then submit the commit request)
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.NOT_COORDINATOR_FOR_GROUP.code())));
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.NOT_COORDINATOR_FOR_GROUP.code())));
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.NONE.code())));
-        coordinator.commitOffsetsSync(Collections.singletonMap(tp, new OffsetAndMetadata(100L)), Long.MAX_VALUE);
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.NONE.code())));
+        coordinator.commitOffsetsSync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L)), Long.MAX_VALUE);
     }
 
     @Test
@@ -1043,10 +1135,10 @@ public void testCommitOffsetSyncCoordinatorNotAvailable() {
         coordinator.ensureCoordinatorReady();
 
         // sync commit with coordinator disconnected (should connect, get metadata, and then submit the commit request)
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.GROUP_COORDINATOR_NOT_AVAILABLE.code())));
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.GROUP_COORDINATOR_NOT_AVAILABLE.code())));
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.NONE.code())));
-        coordinator.commitOffsetsSync(Collections.singletonMap(tp, new OffsetAndMetadata(100L)), Long.MAX_VALUE);
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.NONE.code())));
+        coordinator.commitOffsetsSync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L)), Long.MAX_VALUE);
     }
 
     @Test
@@ -1055,10 +1147,10 @@ public void testCommitOffsetSyncCoordinatorDisconnected() {
         coordinator.ensureCoordinatorReady();
 
         // sync commit with coordinator disconnected (should connect, get metadata, and then submit the commit request)
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.NONE.code())), true);
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.NONE.code())), true);
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.NONE.code())));
-        coordinator.commitOffsetsSync(Collections.singletonMap(tp, new OffsetAndMetadata(100L)), Long.MAX_VALUE);
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.NONE.code())));
+        coordinator.commitOffsetsSync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L)), Long.MAX_VALUE);
     }
 
     @Test(expected = KafkaException.class)
@@ -1066,8 +1158,8 @@ public void testCommitUnknownTopicOrPartition() {
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.UNKNOWN_TOPIC_OR_PARTITION.code())));
-        coordinator.commitOffsetsSync(Collections.singletonMap(tp, new OffsetAndMetadata(100L, "metadata")), Long.MAX_VALUE);
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.UNKNOWN_TOPIC_OR_PARTITION.code())));
+        coordinator.commitOffsetsSync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L, "metadata")), Long.MAX_VALUE);
     }
 
     @Test(expected = OffsetMetadataTooLarge.class)
@@ -1076,8 +1168,8 @@ public void testCommitOffsetMetadataTooLarge() {
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.OFFSET_METADATA_TOO_LARGE.code())));
-        coordinator.commitOffsetsSync(Collections.singletonMap(tp, new OffsetAndMetadata(100L, "metadata")), Long.MAX_VALUE);
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.OFFSET_METADATA_TOO_LARGE.code())));
+        coordinator.commitOffsetsSync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L, "metadata")), Long.MAX_VALUE);
     }
 
     @Test(expected = CommitFailedException.class)
@@ -1086,8 +1178,8 @@ public void testCommitOffsetIllegalGeneration() {
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.ILLEGAL_GENERATION.code())));
-        coordinator.commitOffsetsSync(Collections.singletonMap(tp, new OffsetAndMetadata(100L, "metadata")), Long.MAX_VALUE);
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.ILLEGAL_GENERATION.code())));
+        coordinator.commitOffsetsSync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L, "metadata")), Long.MAX_VALUE);
     }
 
     @Test(expected = CommitFailedException.class)
@@ -1096,8 +1188,8 @@ public void testCommitOffsetUnknownMemberId() {
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.UNKNOWN_MEMBER_ID.code())));
-        coordinator.commitOffsetsSync(Collections.singletonMap(tp, new OffsetAndMetadata(100L, "metadata")), Long.MAX_VALUE);
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.UNKNOWN_MEMBER_ID.code())));
+        coordinator.commitOffsetsSync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L, "metadata")), Long.MAX_VALUE);
     }
 
     @Test(expected = CommitFailedException.class)
@@ -1106,8 +1198,8 @@ public void testCommitOffsetRebalanceInProgress() {
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.REBALANCE_IN_PROGRESS.code())));
-        coordinator.commitOffsetsSync(Collections.singletonMap(tp, new OffsetAndMetadata(100L, "metadata")), Long.MAX_VALUE);
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.REBALANCE_IN_PROGRESS.code())));
+        coordinator.commitOffsetsSync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L, "metadata")), Long.MAX_VALUE);
     }
 
     @Test(expected = KafkaException.class)
@@ -1116,21 +1208,21 @@ public void testCommitOffsetSyncCallbackWithNonRetriableException() {
         coordinator.ensureCoordinatorReady();
 
         // sync commit with invalid partitions should throw if we have no callback
-        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(tp, Errors.UNKNOWN.code())), false);
-        coordinator.commitOffsetsSync(Collections.singletonMap(tp, new OffsetAndMetadata(100L)), Long.MAX_VALUE);
+        client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.UNKNOWN.code())), false);
+        coordinator.commitOffsetsSync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L)), Long.MAX_VALUE);
     }
 
     @Test(expected = IllegalArgumentException.class)
     public void testCommitSyncNegativeOffset() {
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
-        coordinator.commitOffsetsSync(Collections.singletonMap(tp, new OffsetAndMetadata(-1L)), Long.MAX_VALUE);
+        coordinator.commitOffsetsSync(Collections.singletonMap(t1p, new OffsetAndMetadata(-1L)), Long.MAX_VALUE);
     }
 
     @Test
     public void testCommitAsyncNegativeOffset() {
         int invokedBeforeTest = defaultOffsetCommitCallback.invoked;
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
-        coordinator.commitOffsetsAsync(Collections.singletonMap(tp, new OffsetAndMetadata(-1L)), null);
+        coordinator.commitOffsetsAsync(Collections.singletonMap(t1p, new OffsetAndMetadata(-1L)), null);
         coordinator.invokeCompletedOffsetCommitCallbacks();
         assertEquals(invokedBeforeTest + 1, defaultOffsetCommitCallback.invoked);
         assertTrue(defaultOffsetCommitCallback.exception instanceof IllegalArgumentException);
@@ -1141,12 +1233,12 @@ public void testRefreshOffset() {
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        subscriptions.assignFromUser(singleton(tp));
+        subscriptions.assignFromUser(singleton(t1p));
         subscriptions.needRefreshCommits();
-        client.prepareResponse(offsetFetchResponse(tp, Errors.NONE, "", 100L));
+        client.prepareResponse(offsetFetchResponse(t1p, Errors.NONE, "", 100L));
         coordinator.refreshCommittedOffsetsIfNeeded();
         assertFalse(subscriptions.refreshCommitsNeeded());
-        assertEquals(100L, subscriptions.committed(tp).offset());
+        assertEquals(100L, subscriptions.committed(t1p).offset());
     }
 
     @Test
@@ -1154,13 +1246,13 @@ public void testRefreshOffsetLoadInProgress() {
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        subscriptions.assignFromUser(singleton(tp));
+        subscriptions.assignFromUser(singleton(t1p));
         subscriptions.needRefreshCommits();
         client.prepareResponse(offsetFetchResponse(Errors.GROUP_LOAD_IN_PROGRESS));
-        client.prepareResponse(offsetFetchResponse(tp, Errors.NONE, "", 100L));
+        client.prepareResponse(offsetFetchResponse(t1p, Errors.NONE, "", 100L));
         coordinator.refreshCommittedOffsetsIfNeeded();
         assertFalse(subscriptions.refreshCommitsNeeded());
-        assertEquals(100L, subscriptions.committed(tp).offset());
+        assertEquals(100L, subscriptions.committed(t1p).offset());
     }
 
     @Test
@@ -1168,7 +1260,7 @@ public void testRefreshOffsetsGroupNotAuthorized() {
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        subscriptions.assignFromUser(singleton(tp));
+        subscriptions.assignFromUser(singleton(t1p));
         subscriptions.needRefreshCommits();
         client.prepareResponse(offsetFetchResponse(Errors.GROUP_AUTHORIZATION_FAILED));
         try {
@@ -1184,9 +1276,9 @@ public void testRefreshOffsetUnknownTopicOrPartition() {
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        subscriptions.assignFromUser(singleton(tp));
+        subscriptions.assignFromUser(singleton(t1p));
         subscriptions.needRefreshCommits();
-        client.prepareResponse(offsetFetchResponse(tp, Errors.UNKNOWN_TOPIC_OR_PARTITION, "", 100L));
+        client.prepareResponse(offsetFetchResponse(t1p, Errors.UNKNOWN_TOPIC_OR_PARTITION, "", 100L));
         coordinator.refreshCommittedOffsetsIfNeeded();
     }
 
@@ -1195,14 +1287,14 @@ public void testRefreshOffsetNotCoordinatorForConsumer() {
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        subscriptions.assignFromUser(singleton(tp));
+        subscriptions.assignFromUser(singleton(t1p));
         subscriptions.needRefreshCommits();
         client.prepareResponse(offsetFetchResponse(Errors.NOT_COORDINATOR_FOR_GROUP));
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
-        client.prepareResponse(offsetFetchResponse(tp, Errors.NONE, "", 100L));
+        client.prepareResponse(offsetFetchResponse(t1p, Errors.NONE, "", 100L));
         coordinator.refreshCommittedOffsetsIfNeeded();
         assertFalse(subscriptions.refreshCommitsNeeded());
-        assertEquals(100L, subscriptions.committed(tp).offset());
+        assertEquals(100L, subscriptions.committed(t1p).offset());
     }
 
     @Test
@@ -1210,12 +1302,12 @@ public void testRefreshOffsetWithNoFetchableOffsets() {
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
 
-        subscriptions.assignFromUser(singleton(tp));
+        subscriptions.assignFromUser(singleton(t1p));
         subscriptions.needRefreshCommits();
-        client.prepareResponse(offsetFetchResponse(tp, Errors.NONE, "", -1L));
+        client.prepareResponse(offsetFetchResponse(t1p, Errors.NONE, "", -1L));
         coordinator.refreshCommittedOffsetsIfNeeded();
         assertFalse(subscriptions.refreshCommitsNeeded());
-        assertEquals(null, subscriptions.committed(tp));
+        assertEquals(null, subscriptions.committed(t1p));
     }
 
     @Test
@@ -1341,14 +1433,14 @@ private ConsumerCoordinator prepareCoordinatorForCloseTest(boolean useGroupManag
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
         if (useGroupManagement) {
-            subscriptions.subscribe(singleton(topicName), rebalanceListener);
+            subscriptions.subscribe(singleton(topic1), rebalanceListener);
             client.prepareResponse(joinGroupFollowerResponse(1, consumerId, "leader", Errors.NONE.code()));
-            client.prepareResponse(syncGroupResponse(singletonList(tp), Errors.NONE.code()));
+            client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
             coordinator.joinGroupIfNeeded();
         } else
-            subscriptions.assignFromUser(singleton(tp));
+            subscriptions.assignFromUser(singleton(t1p));
 
-        subscriptions.seek(tp, 100);
+        subscriptions.seek(t1p, 100);
         coordinator.poll(time.milliseconds());
 
         return coordinator;
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/SubscriptionStateTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/SubscriptionStateTest.java
index ef7575444fece..55bf2a357db28 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/SubscriptionStateTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/SubscriptionStateTest.java
@@ -29,7 +29,6 @@
 import java.util.HashSet;
 import java.util.regex.Pattern;
 
-import static java.util.Arrays.asList;
 import static java.util.Collections.singleton;
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertFalse;
@@ -77,7 +76,7 @@ public void partitionAssignmentChangeOnTopicSubscription() {
         // assigned partitions should remain unchanged
         assertTrue(state.assignedPartitions().isEmpty());
 
-        state.assignFromSubscribed(asList(t1p0));
+        state.assignFromSubscribed(Collections.singletonList(t1p0));
         // assigned partitions should immediately change
         assertEquals(singleton(t1p0), state.assignedPartitions());
 
@@ -96,21 +95,32 @@ public void partitionAssignmentChangeOnPatternSubscription() {
         // assigned partitions should remain unchanged
         assertTrue(state.assignedPartitions().isEmpty());
 
-        state.subscribeFromPattern(new HashSet<>(Arrays.asList(topic, topic1)));
+        state.subscribeFromPattern(new HashSet<>(Collections.singletonList(topic)));
         // assigned partitions should remain unchanged
         assertTrue(state.assignedPartitions().isEmpty());
 
-        state.assignFromSubscribed(asList(tp1));
+        state.assignFromSubscribed(Collections.singletonList(tp1));
         // assigned partitions should immediately change
         assertEquals(singleton(tp1), state.assignedPartitions());
+        assertEquals(singleton(topic), state.subscription());
+
+        state.assignFromSubscribed(Collections.singletonList(t1p0));
+        // assigned partitions should immediately change
+        assertEquals(singleton(t1p0), state.assignedPartitions());
+        assertEquals(singleton(topic), state.subscription());
 
         state.subscribe(Pattern.compile(".*t"), rebalanceListener);
         // assigned partitions should remain unchanged
-        assertEquals(singleton(tp1), state.assignedPartitions());
+        assertEquals(singleton(t1p0), state.assignedPartitions());
 
         state.subscribeFromPattern(singleton(topic));
         // assigned partitions should remain unchanged
-        assertEquals(singleton(tp1), state.assignedPartitions());
+        assertEquals(singleton(t1p0), state.assignedPartitions());
+
+        state.assignFromSubscribed(Collections.singletonList(tp0));
+        // assigned partitions should immediately change
+        assertEquals(singleton(tp0), state.assignedPartitions());
+        assertEquals(singleton(topic), state.subscription());
 
         state.unsubscribe();
         // assigned partitions should immediately change
@@ -139,11 +149,11 @@ public void topicSubscription() {
         assertEquals(1, state.subscription().size());
         assertTrue(state.assignedPartitions().isEmpty());
         assertTrue(state.partitionsAutoAssigned());
-        state.assignFromSubscribed(asList(tp0));
+        state.assignFromSubscribed(Collections.singletonList(tp0));
         state.seek(tp0, 1);
         state.committed(tp0, new OffsetAndMetadata(1));
         assertAllPositions(tp0, 1L);
-        state.assignFromSubscribed(asList(tp1));
+        state.assignFromSubscribed(Collections.singletonList(tp1));
         assertTrue(state.isAssigned(tp1));
         assertFalse(state.isAssigned(tp0));
         assertFalse(state.isFetchable(tp1));
@@ -173,20 +183,28 @@ public void commitOffsetMetadata() {
     @Test(expected = IllegalStateException.class)
     public void invalidPositionUpdate() {
         state.subscribe(singleton(topic), rebalanceListener);
-        state.assignFromSubscribed(asList(tp0));
+        state.assignFromSubscribed(Collections.singletonList(tp0));
         state.position(tp0, 0);
     }
 
+    @Test(expected = IllegalArgumentException.class)
+    public void cantAssignPartitionForUnsubscribedTopics() {
+        state.subscribe(singleton(topic), rebalanceListener);
+        state.assignFromSubscribed(Collections.singletonList(t1p0));
+    }
+
+    @Test(expected = IllegalArgumentException.class)
+    public void cantAssignPartitionForUnmatchedPattern() {
+        state.subscribe(Pattern.compile(".*t"), rebalanceListener);
+        state.subscribeFromPattern(new HashSet<>(Collections.singletonList(topic)));
+        state.assignFromSubscribed(Collections.singletonList(t1p0));
+    }
+
     @Test(expected = IllegalStateException.class)
     public void cantChangePositionForNonAssignedPartition() {
         state.position(tp0, 1);
     }
 
-    public void assertAllPositions(TopicPartition tp, Long offset) {
-        assertEquals(offset.longValue(), state.committed(tp).offset());
-        assertEquals(offset, state.position(tp));
-    }
-
     @Test(expected = IllegalStateException.class)
     public void cantSubscribeTopicAndPattern() {
         state.subscribe(singleton(topic), rebalanceListener);
@@ -240,7 +258,7 @@ public void unsubscribeUserSubscribe() {
     public void unsubscription() {
         state.subscribe(Pattern.compile(".*"), rebalanceListener);
         state.subscribeFromPattern(new HashSet<>(Arrays.asList(topic, topic1)));
-        state.assignFromSubscribed(asList(tp1));
+        state.assignFromSubscribed(Collections.singletonList(tp1));
         assertEquals(singleton(tp1), state.assignedPartitions());
 
         state.unsubscribe();
@@ -255,6 +273,11 @@ public void unsubscription() {
         assertTrue(state.assignedPartitions().isEmpty());
     }
 
+    private void assertAllPositions(TopicPartition tp, Long offset) {
+        assertEquals(offset.longValue(), state.committed(tp).offset());
+        assertEquals(offset, state.position(tp));
+    }
+
     private static class MockRebalanceListener implements ConsumerRebalanceListener {
         public Collection<TopicPartition> revoked;
         public Collection<TopicPartition> assigned;
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/AbstractStream.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/AbstractStream.java
index 31a3dc63b3416..bcffce2dcb227 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/AbstractStream.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/AbstractStream.java
@@ -37,12 +37,6 @@ public abstract class AbstractStream<K> {
     protected final String name;
     protected final Set<String> sourceNodes;
 
-    public AbstractStream(AbstractStream<K> stream) {
-        this.topology = stream.topology;
-        this.name = stream.name;
-        this.sourceNodes = stream.sourceNodes;
-    }
-
     public AbstractStream(KStreamBuilder topology, String name, Set<String> sourceNodes) {
         if (sourceNodes == null || sourceNodes.isEmpty()) {
             throw new IllegalArgumentException("parameter <sourceNodes> must not be null or empty");
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/TopologyBuilder.java b/streams/src/main/java/org/apache/kafka/streams/processor/TopologyBuilder.java
index b25fcad3d1f2f..81f4302429bff 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/TopologyBuilder.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/TopologyBuilder.java
@@ -49,6 +49,7 @@
 import java.util.Set;
 import java.util.regex.Pattern;
 
+
 /**
  * A component that is used to build a {@link ProcessorTopology}. A topology contains an acyclic graph of sources, processors,
  * and sinks. A {@link SourceNode source} is a node in the graph that consumes one or more Kafka topics and forwards them to
@@ -81,7 +82,7 @@ public class TopologyBuilder {
     private final List<Set<String>> copartitionSourceGroups = new ArrayList<>();
 
     // map from source processor names to subscribed topics (without application-id prefix for internal topics)
-    private final HashMap<String, String[]> nodeToSourceTopics = new HashMap<>();
+    private final HashMap<String, List<String>> nodeToSourceTopics = new HashMap<>();
 
     // map from source processor names to regex subscription patterns
     private final HashMap<String, Pattern> nodeToSourcePatterns = new LinkedHashMap<>();
@@ -146,11 +147,11 @@ private static abstract class NodeFactory {
     }
 
     private static class ProcessorNodeFactory extends NodeFactory {
-        public final String[] parents;
-        private final ProcessorSupplier supplier;
+        private final String[] parents;
+        private final ProcessorSupplier<?, ?> supplier;
         private final Set<String> stateStoreNames = new HashSet<>();
 
-        public ProcessorNodeFactory(String name, String[] parents, ProcessorSupplier supplier) {
+        ProcessorNodeFactory(String name, String[] parents, ProcessorSupplier<?, ?> supplier) {
             super(name);
             this.parents = parents.clone();
             this.supplier = supplier;
@@ -160,37 +161,32 @@ public void addStateStore(String stateStoreName) {
             stateStoreNames.add(stateStoreName);
         }
 
-        @SuppressWarnings("unchecked")
         @Override
         public ProcessorNode build() {
-            return new ProcessorNode(name, supplier.get(), stateStoreNames);
+            return new ProcessorNode<>(name, supplier.get(), stateStoreNames);
         }
     }
 
     private class SourceNodeFactory extends NodeFactory {
-        private final String[] topics;
-        public final Pattern pattern;
-        private Deserializer keyDeserializer;
-        private Deserializer valDeserializer;
+        private final List<String> topics;
+        private final Pattern pattern;
+        private final Deserializer<?> keyDeserializer;
+        private final Deserializer<?> valDeserializer;
 
-        private SourceNodeFactory(String name, String[] topics, Pattern pattern, Deserializer keyDeserializer, Deserializer valDeserializer) {
+        private SourceNodeFactory(String name, String[] topics, Pattern pattern, Deserializer<?> keyDeserializer, Deserializer<?> valDeserializer) {
             super(name);
-            this.topics = topics != null ? topics.clone() : null;
+            this.topics = topics != null ? Arrays.asList(topics) : null;
             this.pattern = pattern;
             this.keyDeserializer = keyDeserializer;
             this.valDeserializer = valDeserializer;
         }
 
-        String[] getTopics() {
-            return topics;
-        }
-
-        String[] getTopics(Collection<String> subscribedTopics) {
+        List<String> getTopics(Collection<String> subscribedTopics) {
             // if it is subscribed via patterns, it is possible that the topic metadata has not been updated
             // yet and hence the map from source node to topics is stale, in this case we put the pattern as a place holder;
             // this should only happen for debugging since during runtime this function should always be called after the metadata has updated.
             if (subscribedTopics.isEmpty())
-                return new String[] {"Pattern[" + pattern + "]"};
+                return Collections.singletonList("Pattern[" + pattern + "]");
 
             List<String> matchedTopics = new ArrayList<>();
             for (String update : subscribedTopics) {
@@ -207,21 +203,20 @@ String[] getTopics(Collection<String> subscribedTopics) {
                     matchedTopics.add(update);
                 }
             }
-            return matchedTopics.toArray(new String[matchedTopics.size()]);
+            return matchedTopics;
         }
 
-        @SuppressWarnings("unchecked")
         @Override
         public ProcessorNode build() {
-            final String[] sourceTopics = nodeToSourceTopics.get(name);
+            final List<String> sourceTopics = nodeToSourceTopics.get(name);
 
             // if it is subscribed via patterns, it is possible that the topic metadata has not been updated
             // yet and hence the map from source node to topics is stale, in this case we put the pattern as a place holder;
             // this should only happen for debugging since during runtime this function should always be called after the metadata has updated.
             if (sourceTopics == null)
-                return new SourceNode(name, new String[] {"Pattern[" + pattern + "]"}, keyDeserializer, valDeserializer);
+                return new SourceNode<>(name, Collections.singletonList("Pattern[" + pattern + "]"), keyDeserializer, valDeserializer);
             else
-                return new SourceNode(name, maybeDecorateInternalSourceTopics(sourceTopics).toArray(new String[sourceTopics.length]), keyDeserializer, valDeserializer);
+                return new SourceNode<>(name, maybeDecorateInternalSourceTopics(sourceTopics), keyDeserializer, valDeserializer);
         }
 
         private boolean isMatch(String topic) {
@@ -229,14 +224,14 @@ private boolean isMatch(String topic) {
         }
     }
 
-    private class SinkNodeFactory extends NodeFactory {
-        public final String[] parents;
-        public final String topic;
-        private Serializer keySerializer;
-        private Serializer valSerializer;
-        private final StreamPartitioner partitioner;
+    private class SinkNodeFactory<K, V> extends NodeFactory {
+        private final String[] parents;
+        private final String topic;
+        private final Serializer<K> keySerializer;
+        private final Serializer<V> valSerializer;
+        private final StreamPartitioner<? super K, ? super V> partitioner;
 
-        private SinkNodeFactory(String name, String[] parents, String topic, Serializer keySerializer, Serializer valSerializer, StreamPartitioner partitioner) {
+        private SinkNodeFactory(String name, String[] parents, String topic, Serializer<K> keySerializer, Serializer<V> valSerializer, StreamPartitioner<? super K, ? super V> partitioner) {
             super(name);
             this.parents = parents.clone();
             this.topic = topic;
@@ -245,14 +240,13 @@ private SinkNodeFactory(String name, String[] parents, String topic, Serializer
             this.partitioner = partitioner;
         }
 
-        @SuppressWarnings("unchecked")
         @Override
         public ProcessorNode build() {
             if (internalTopicNames.contains(topic)) {
                 // prefix the internal topic name with the application id
-                return new SinkNode(name, decorateTopic(topic), keySerializer, valSerializer, partitioner);
+                return new SinkNode<>(name, decorateTopic(topic), keySerializer, valSerializer, partitioner);
             } else {
-                return new SinkNode(name, topic, keySerializer, valSerializer, partitioner);
+                return new SinkNode<>(name, topic, keySerializer, valSerializer, partitioner);
             }
         }
     }
@@ -263,7 +257,7 @@ public static class TopicsInfo {
         public Map<String, InternalTopicConfig> stateChangelogTopics;
         public Map<String, InternalTopicConfig> repartitionSourceTopics;
 
-        public TopicsInfo(Set<String> sinkTopics, Set<String> sourceTopics, Map<String, InternalTopicConfig> repartitionSourceTopics, Map<String, InternalTopicConfig> stateChangelogTopics) {
+        TopicsInfo(Set<String> sinkTopics, Set<String> sourceTopics, Map<String, InternalTopicConfig> repartitionSourceTopics, Map<String, InternalTopicConfig> stateChangelogTopics) {
             this.sinkTopics = sinkTopics;
             this.sourceTopics = sourceTopics;
             this.stateChangelogTopics = stateChangelogTopics;
@@ -312,8 +306,8 @@ public TopologyBuilder() {}
     /**
      * Set the applicationId to be used for auto-generated internal topics.
      *
-     * This is required before calling {@link #sourceTopics}, {@link #topicGroups},
-     * {@link #copartitionSources}, {@link #stateStoreNameToSourceTopics} and {@link #build(Integer)}.
+     * This is required before calling {@link #topicGroups}, {@link #copartitionSources},
+     * {@link #stateStoreNameToSourceTopics} and {@link #build(Integer)}.
      *
      * @param applicationId the streams applicationId. Should be the same as set by
      * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG}
@@ -337,7 +331,7 @@ public synchronized final TopologyBuilder setApplicationId(String applicationId)
      * @return this builder instance so methods can be chained together; never null
      */
     public synchronized final TopologyBuilder addSource(String name, String... topics) {
-        return addSource(null, name, (Deserializer) null, (Deserializer) null, topics);
+        return addSource(null, name, null, null, topics);
     }
 
     /**
@@ -353,7 +347,7 @@ public synchronized final TopologyBuilder addSource(String name, String... topic
      * @return this builder instance so methods can be chained together; never null
      */
     public synchronized final TopologyBuilder addSource(AutoOffsetReset offsetReset, String name,  String... topics) {
-        return addSource(offsetReset, name, (Deserializer) null, (Deserializer) null, topics);
+        return addSource(offsetReset, name, null, null, topics);
     }
 
 
@@ -370,7 +364,7 @@ public synchronized final TopologyBuilder addSource(AutoOffsetReset offsetReset,
      * @return this builder instance so methods can be chained together; never null
      */
     public synchronized final TopologyBuilder addSource(String name, Pattern topicPattern) {
-        return addSource(null, name, (Deserializer) null, (Deserializer) null, topicPattern);
+        return addSource(null, name, null, null, topicPattern);
     }
 
     /**
@@ -387,7 +381,7 @@ public synchronized final TopologyBuilder addSource(String name, Pattern topicPa
      * @return this builder instance so methods can be chained together; never null
      */
     public synchronized final TopologyBuilder addSource(AutoOffsetReset offsetReset, String name,  Pattern topicPattern) {
-        return addSource(offsetReset, name, (Deserializer) null, (Deserializer) null, topicPattern);
+        return addSource(offsetReset, name, null, null, topicPattern);
     }
 
 
@@ -445,7 +439,7 @@ public synchronized final TopologyBuilder addSource(AutoOffsetReset offsetReset,
         }
 
         nodeFactories.put(name, new SourceNodeFactory(name, topics, null, keyDeserializer, valDeserializer));
-        nodeToSourceTopics.put(name, topics.clone());
+        nodeToSourceTopics.put(name, Arrays.asList(topics));
         nodeGrouper.add(name);
 
         return this;
@@ -470,7 +464,7 @@ public synchronized final TopologyBuilder addSource(AutoOffsetReset offsetReset,
      * @param topic                 the topic to source the data from
      * @param processorName         the name of the {@link ProcessorSupplier}
      * @param stateUpdateSupplier   the instance of {@link ProcessorSupplier}
-     * @return
+     * @return this builder instance so methods can be chained together; never null
      */
     public synchronized TopologyBuilder addGlobalStore(final StateStore store,
                                                        final String sourceName,
@@ -499,7 +493,7 @@ public synchronized TopologyBuilder addGlobalStore(final StateStore store,
         globalTopics.add(topic);
         final String[] topics = {topic};
         nodeFactories.put(sourceName, new SourceNodeFactory(sourceName, topics, null, keyDeserializer, valueDeserializer));
-        nodeToSourceTopics.put(sourceName, topics.clone());
+        nodeToSourceTopics.put(sourceName, Arrays.asList(topics));
         nodeGrouper.add(sourceName);
 
         final String[] parents = {sourceName};
@@ -612,7 +606,7 @@ public synchronized final TopologyBuilder addSource(AutoOffsetReset offsetReset,
      * @see #addSink(String, String, Serializer, Serializer, StreamPartitioner, String...)
      */
     public synchronized final TopologyBuilder addSink(String name, String topic, String... parentNames) {
-        return addSink(name, topic, (Serializer) null, (Serializer) null, parentNames);
+        return addSink(name, topic, null, null, parentNames);
     }
 
     /**
@@ -639,7 +633,7 @@ public synchronized final TopologyBuilder addSink(String name, String topic, Str
      * @see #addSink(String, String, Serializer, Serializer, StreamPartitioner, String...)
      */
     public synchronized final TopologyBuilder addSink(String name, String topic, StreamPartitioner partitioner, String... parentNames) {
-        return addSink(name, topic, (Serializer) null, (Serializer) null, partitioner, parentNames);
+        return addSink(name, topic, null, null, partitioner, parentNames);
     }
 
     /**
@@ -662,7 +656,7 @@ public synchronized final TopologyBuilder addSink(String name, String topic, Str
      * @see #addSink(String, String, Serializer, Serializer, StreamPartitioner, String...)
      */
     public synchronized final TopologyBuilder addSink(String name, String topic, Serializer keySerializer, Serializer valSerializer, String... parentNames) {
-        return addSink(name, topic, keySerializer, valSerializer, (StreamPartitioner) null, parentNames);
+        return addSink(name, topic, keySerializer, valSerializer, null, parentNames);
     }
 
     /**
@@ -703,7 +697,7 @@ public synchronized final <K, V> TopologyBuilder addSink(String name, String top
             }
         }
 
-        nodeFactories.put(name, new SinkNodeFactory(name, parentNames, topic, keySerializer, valSerializer, partitioner));
+        nodeFactories.put(name, new SinkNodeFactory<>(name, parentNames, topic, keySerializer, valSerializer, partitioner));
         nodeToSinkTopic.put(name, topic);
         nodeGrouper.add(name);
         nodeGrouper.unite(name, parentNames);
@@ -876,7 +870,7 @@ private Set<String> findSourceTopicsForProcessorParents(String [] parents) {
         for (String parent : parents) {
             NodeFactory nodeFactory = nodeFactories.get(parent);
             if (nodeFactory instanceof SourceNodeFactory) {
-                sourceTopics.addAll(Arrays.asList(((SourceNodeFactory) nodeFactory).getTopics()));
+                sourceTopics.addAll(((SourceNodeFactory) nodeFactory).topics);
             } else if (nodeFactory instanceof ProcessorNodeFactory) {
                 sourceTopics.addAll(findSourceTopicsForProcessorParents(((ProcessorNodeFactory) nodeFactory).parents));
             }
@@ -1013,8 +1007,8 @@ private Set<String> globalNodeGroups() {
             for (String node : nodes) {
                 final NodeFactory nodeFactory = nodeFactories.get(node);
                 if (nodeFactory instanceof SourceNodeFactory) {
-                    final String[] topics = ((SourceNodeFactory) nodeFactory).getTopics();
-                    if (topics != null && topics.length == 1 && globalTopics.contains(topics[0])) {
+                    final List<String> topics = ((SourceNodeFactory) nodeFactory).topics;
+                    if (topics != null && topics.size() == 1 && globalTopics.contains(topics.get(0))) {
                         globalGroups.addAll(nodes);
                     }
                 }
@@ -1023,7 +1017,6 @@ private Set<String> globalNodeGroups() {
         return globalGroups;
     }
 
-    @SuppressWarnings("unchecked")
     private ProcessorTopology build(Set<String> nodeGroup) {
         List<ProcessorNode> processorNodes = new ArrayList<>(nodeFactories.size());
         Map<String, ProcessorNode> processorMap = new HashMap<>();
@@ -1040,7 +1033,8 @@ private ProcessorTopology build(Set<String> nodeGroup) {
 
                 if (factory instanceof ProcessorNodeFactory) {
                     for (String parent : ((ProcessorNodeFactory) factory).parents) {
-                        processorMap.get(parent).addChild(node);
+                        ProcessorNode<?, ?> parentNode = processorMap.get(parent);
+                        parentNode.addChild(node);
                     }
                     for (String stateStoreName : ((ProcessorNodeFactory) factory).stateStoreNames) {
                         if (!stateStoreMap.containsKey(stateStoreName)) {
@@ -1063,10 +1057,10 @@ private ProcessorTopology build(Set<String> nodeGroup) {
                         }
                     }
                 } else if (factory instanceof SourceNodeFactory) {
-                    SourceNodeFactory sourceNodeFactory = (SourceNodeFactory) factory;
-                    String[] topics = (sourceNodeFactory.pattern != null) ?
+                    final SourceNodeFactory sourceNodeFactory = (SourceNodeFactory) factory;
+                    final List<String> topics = (sourceNodeFactory.pattern != null) ?
                             sourceNodeFactory.getTopics(subscriptionUpdates.getUpdates()) :
-                            sourceNodeFactory.getTopics();
+                            sourceNodeFactory.topics;
 
                     for (String topic : topics) {
                         if (internalTopicNames.contains(topic)) {
@@ -1077,7 +1071,8 @@ private ProcessorTopology build(Set<String> nodeGroup) {
                         }
                     }
                 } else if (factory instanceof SinkNodeFactory) {
-                    SinkNodeFactory sinkNodeFactory = (SinkNodeFactory) factory;
+                    final SinkNodeFactory sinkNodeFactory = (SinkNodeFactory) factory;
+
                     for (String parent : sinkNodeFactory.parents) {
                         processorMap.get(parent).addChild(node);
                         if (internalTopicNames.contains(sinkNodeFactory.topic)) {
@@ -1105,13 +1100,6 @@ public Map<String, StateStore> globalStateStores() {
         return Collections.unmodifiableMap(globalStateStores);
     }
 
-    private StateStore getStateStore(final String stateStoreName) {
-        if (stateFactories.containsKey(stateStoreName)) {
-            return stateFactories.get(stateStoreName).supplier.get();
-        }
-        return globalStateStores.get(stateStoreName);
-    }
-
     /**
      * Returns the map of topic groups keyed by the group id.
      * A topic group is a group of topics in the same task.
@@ -1131,7 +1119,7 @@ public synchronized Map<Integer, TopicsInfo> topicGroups() {
             Map<String, InternalTopicConfig> stateChangelogTopics = new HashMap<>();
             for (String node : entry.getValue()) {
                 // if the node is a source node, add to the source topics
-                String[] topics = nodeToSourceTopics.get(node);
+                List<String> topics = nodeToSourceTopics.get(node);
                 if (topics != null) {
                     // if some of the topics are internal, add them to the internal topics
                     for (String topic : topics) {
@@ -1196,7 +1184,7 @@ private void setRegexMatchedTopicsToSourceNodes() {
         }
     }
 
-    private InternalTopicConfig createInternalTopicConfig(final StateStoreSupplier supplier, final String name) {
+    private InternalTopicConfig createInternalTopicConfig(final StateStoreSupplier<?> supplier, final String name) {
         if (!(supplier instanceof WindowStoreSupplier)) {
             return new InternalTopicConfig(name, Collections.singleton(InternalTopicConfig.CleanupPolicy.compact), supplier.logConfig());
         }
@@ -1210,27 +1198,13 @@ private InternalTopicConfig createInternalTopicConfig(final StateStoreSupplier s
         return config;
     }
 
-
-    /**
-     * Get the names of topics that are to be consumed by the source nodes created by this builder.
-     * @return the unmodifiable set of topic names used by source nodes, which changes as new sources are added; never null
-     */
-    public synchronized Set<String> sourceTopics() {
-        Set<String> topics = maybeDecorateInternalSourceTopics(sourceTopicNames);
-        return Collections.unmodifiableSet(topics);
-    }
-
     /**
      * Get the Pattern to match all topics requiring to start reading from earliest available offset
      * @return the Pattern for matching all topics reading from earliest offset, never null
      */
     public synchronized Pattern earliestResetTopicsPattern() {
-        Set<String> topics = maybeDecorateInternalSourceTopics(earliestResetTopics);
-
-        String[] sourceTopicNames = topics.toArray(new String[topics.size()]);
-        Pattern[] sourceTopicPatterns = earliestResetPatterns.toArray(new Pattern[earliestResetPatterns.size()]);
-
-        Pattern earliestPattern =  buildPatternForOffsetResetTopics(sourceTopicNames, sourceTopicPatterns);
+        final List<String> topics = maybeDecorateInternalSourceTopics(earliestResetTopics);
+        final Pattern earliestPattern =  buildPatternForOffsetResetTopics(topics, earliestResetPatterns);
 
         ensureNoRegexOverlap(earliestPattern, latestResetPatterns, latestResetTopics);
 
@@ -1242,12 +1216,8 @@ public synchronized Pattern earliestResetTopicsPattern() {
      * @return the Pattern for matching all topics reading from latest offset, never null
      */
     public synchronized Pattern latestResetTopicsPattern() {
-        Set<String> topics = maybeDecorateInternalSourceTopics(latestResetTopics);
-
-        String[] sourceTopicNames = topics.toArray(new String[topics.size()]);
-        Pattern[] sourceTopicPatterns = latestResetPatterns.toArray(new Pattern[latestResetPatterns.size()]);
-
-        Pattern latestPattern = buildPatternForOffsetResetTopics(sourceTopicNames, sourceTopicPatterns);
+        final List<String> topics = maybeDecorateInternalSourceTopics(latestResetTopics);
+        final Pattern latestPattern = buildPatternForOffsetResetTopics(topics, latestResetPatterns);
 
         ensureNoRegexOverlap(latestPattern, earliestResetPatterns, earliestResetTopics);
 
@@ -1267,10 +1237,8 @@ private void ensureNoRegexOverlap(Pattern builtPattern, Set<Pattern> otherPatter
                 throw new TopologyBuilderException(String.format("Found overlapping regex [%s] matching topic [%s] for a KStream with auto offset resets", builtPattern.pattern(), otherTopic));
             }
         }
-
     }
 
-
     /**
      * Builds a composite pattern out of topic names and Pattern object for matching topic names.  If the provided
      * arrays are empty a Pattern.compile("") instance is returned.
@@ -1279,7 +1247,7 @@ private void ensureNoRegexOverlap(Pattern builtPattern, Set<Pattern> otherPatter
      * @param sourcePatterns Patterns for matching source topics to add to a composite pattern
      * @return a Pattern that is composed of the literal source topic names and any Patterns for matching source topics
      */
-    private static synchronized Pattern buildPatternForOffsetResetTopics(String[] sourceTopics, Pattern[] sourcePatterns) {
+    private static synchronized Pattern buildPatternForOffsetResetTopics(Collection<String> sourceTopics, Collection<Pattern> sourcePatterns) {
         StringBuilder builder = new StringBuilder();
 
         for (String topic : sourceTopics) {
@@ -1301,11 +1269,10 @@ private static synchronized Pattern buildPatternForOffsetResetTopics(String[] so
     /**
      * @return a mapping from state store name to a Set of source Topics.
      */
-    public Map<String, Set<String>> stateStoreNameToSourceTopics() {
-        final Map<String, Set<String>> results = new HashMap<>();
+    public Map<String, List<String>> stateStoreNameToSourceTopics() {
+        final Map<String, List<String>> results = new HashMap<>();
         for (Map.Entry<String, Set<String>> entry : stateStoreNameToSourceTopics.entrySet()) {
             results.put(entry.getKey(), maybeDecorateInternalSourceTopics(entry.getValue()));
-
         }
         return results;
     }
@@ -1321,7 +1288,7 @@ public synchronized Collection<Set<String>> copartitionGroups() {
         for (Set<String> nodeNames : copartitionSourceGroups) {
             Set<String> copartitionGroup = new HashSet<>();
             for (String node : nodeNames) {
-                String[] topics = nodeToSourceTopics.get(node);
+                final List<String> topics = nodeToSourceTopics.get(node);
                 if (topics != null)
                     copartitionGroup.addAll(maybeDecorateInternalSourceTopics(topics));
             }
@@ -1330,12 +1297,8 @@ public synchronized Collection<Set<String>> copartitionGroups() {
         return Collections.unmodifiableList(list);
     }
 
-    private Set<String> maybeDecorateInternalSourceTopics(final Set<String> sourceTopics) {
-        return maybeDecorateInternalSourceTopics(sourceTopics.toArray(new String[sourceTopics.size()]));
-    }
-
-    private Set<String> maybeDecorateInternalSourceTopics(String ... sourceTopics) {
-        final Set<String> decoratedTopics = new HashSet<>();
+    private List<String> maybeDecorateInternalSourceTopics(final Collection<String> sourceTopics) {
+        final List<String> decoratedTopics = new ArrayList<>();
         for (String topic : sourceTopics) {
             if (internalTopicNames.contains(topic)) {
                 decoratedTopics.add(decorateTopic(topic));
@@ -1357,23 +1320,18 @@ private String decorateTopic(String topic) {
     }
 
     public synchronized Pattern sourceTopicPattern() {
-        if (this.topicPattern == null && !nodeToSourcePatterns.isEmpty()) {
-
-            List<String> allNodeToSourceTopics = new ArrayList<>();
+        if (this.topicPattern == null) {
+            List<String> allSourceTopics = new ArrayList<>();
             if (!nodeToSourceTopics.isEmpty()) {
-                for (String[] topics : nodeToSourceTopics.values()) {
-                    allNodeToSourceTopics.addAll(Arrays.asList(topics));
-
+                for (List<String> topics : nodeToSourceTopics.values()) {
+                    allSourceTopics.addAll(maybeDecorateInternalSourceTopics(topics));
                 }
             }
-            int numPatterns = nodeToSourcePatterns.values().size();
-            int numTopics = allNodeToSourceTopics.size();
-
-            Pattern[] patterns = nodeToSourcePatterns.values().toArray(new Pattern[numPatterns]);
-            String[] allTopics = allNodeToSourceTopics.toArray(new String[numTopics]);
+            Collections.sort(allSourceTopics);
 
-            this.topicPattern = buildPatternForOffsetResetTopics(allTopics, patterns);
+            this.topicPattern = buildPatternForOffsetResetTopics(allSourceTopics, nodeToSourcePatterns.values());
         }
+
         return this.topicPattern;
     }
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/SinkNode.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/SinkNode.java
index 0ebfda71c1e98..c4db740d56159 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/SinkNode.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/SinkNode.java
@@ -29,11 +29,11 @@ public class SinkNode<K, V> extends ProcessorNode<K, V> {
     private final String topic;
     private Serializer<K> keySerializer;
     private Serializer<V> valSerializer;
-    private final StreamPartitioner<K, V> partitioner;
+    private final StreamPartitioner<? super K, ? super V> partitioner;
 
     private ProcessorContext context;
 
-    public SinkNode(String name, String topic, Serializer<K> keySerializer, Serializer<V> valSerializer, StreamPartitioner<K, V> partitioner) {
+    public SinkNode(String name, String topic, Serializer<K> keySerializer, Serializer<V> valSerializer, StreamPartitioner<? super K, ? super V> partitioner) {
         super(name);
 
         this.topic = topic;
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/SourceNode.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/SourceNode.java
index 771f5041a2f5a..340660640a323 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/SourceNode.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/SourceNode.java
@@ -21,14 +21,17 @@
 import org.apache.kafka.streams.kstream.internals.ChangedDeserializer;
 import org.apache.kafka.streams.processor.ProcessorContext;
 
+import java.util.List;
+
 public class SourceNode<K, V> extends ProcessorNode<K, V> {
 
+    private final List<String> topics;
+
+    private ProcessorContext context;
     private Deserializer<K> keyDeserializer;
     private Deserializer<V> valDeserializer;
-    private ProcessorContext context;
-    private String[] topics;
 
-    public SourceNode(String name, String[] topics, Deserializer<K> keyDeserializer, Deserializer<V> valDeserializer) {
+    public SourceNode(String name, List<String> topics, Deserializer<K> keyDeserializer, Deserializer<V> valDeserializer) {
         super(name);
         this.topics = topics;
         this.keyDeserializer = keyDeserializer;
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
index 38961f23f617b..b445a51a48d6b 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
@@ -180,14 +180,13 @@ private synchronized void setStateWhenNotInPendingShutdown(final State newState)
 
     protected final StreamsConfig config;
     protected final TopologyBuilder builder;
-    protected final Set<String> sourceTopics;
-    protected final Pattern topicPattern;
     protected final Producer<byte[], byte[]> producer;
     protected final Consumer<byte[], byte[]> consumer;
     protected final Consumer<byte[], byte[]> restoreConsumer;
 
     private final String logPrefix;
     private final String threadClientId;
+    private final Pattern sourceTopicPattern;
     private final Map<TaskId, StreamTask> activeTasks;
     private final Map<TaskId, StandbyTask> standbyTasks;
     private final Map<TopicPartition, StreamTask> activeTasksByPartition;
@@ -200,6 +199,7 @@ private synchronized void setStateWhenNotInPendingShutdown(final State newState)
     private final long cleanTimeMs;
     private final long commitTimeMs;
     private final StreamsMetricsThreadImpl streamsMetrics;
+    // TODO: this is not private only for tests, should be better refactored
     final StateDirectory stateDirectory;
     private String originalReset;
     private StreamPartitionAssignor partitionAssignor = null;
@@ -291,8 +291,7 @@ public StreamThread(TopologyBuilder builder,
         String threadName = getName();
         this.config = config;
         this.builder = builder;
-        this.sourceTopics = builder.sourceTopics();
-        this.topicPattern = builder.sourceTopicPattern();
+        this.sourceTopicPattern = builder.sourceTopicPattern();
         this.clientId = clientId;
         this.processId = processId;
         this.partitionGrouper = config.getConfiguredInstance(StreamsConfig.PARTITION_GROUPER_CLASS_CONFIG, PartitionGrouper.class);
@@ -566,11 +565,7 @@ private void runLoop() {
         boolean requiresPoll = true;
         boolean polledRecords = false;
 
-        if (topicPattern != null) {
-            consumer.subscribe(topicPattern, rebalanceListener);
-        } else {
-            consumer.subscribe(new ArrayList<>(sourceTopics), rebalanceListener);
-        }
+        consumer.subscribe(sourceTopicPattern, rebalanceListener);
 
         while (stillRunning()) {
             this.timerStartedMs = time.milliseconds();
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsMetadataState.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsMetadataState.java
index a59eb5f914f00..6fb6e062a4c84 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsMetadataState.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsMetadataState.java
@@ -84,7 +84,7 @@ public synchronized Collection<StreamsMetadata> getAllMetadataForStore(final Str
             return allMetadata;
         }
 
-        final Set<String> sourceTopics = builder.stateStoreNameToSourceTopics().get(storeName);
+        final List<String> sourceTopics = builder.stateStoreNameToSourceTopics().get(storeName);
         if (sourceTopics == null) {
             return Collections.emptyList();
         }
@@ -201,7 +201,7 @@ public synchronized void onChange(final Map<HostInfo, Set<TopicPartition>> curre
         rebuildMetadata(currentState);
     }
 
-    private boolean hasPartitionsForAnyTopics(final Set<String> topicNames, final Set<TopicPartition> partitionForHost) {
+    private boolean hasPartitionsForAnyTopics(final List<String> topicNames, final Set<TopicPartition> partitionForHost) {
         for (TopicPartition topicPartition : partitionForHost) {
             if (topicNames.contains(topicPartition.topic())) {
                 return true;
@@ -215,13 +215,13 @@ private void rebuildMetadata(final Map<HostInfo, Set<TopicPartition>> currentSta
         if (currentState.isEmpty()) {
             return;
         }
-        final Map<String, Set<String>> stores = builder.stateStoreNameToSourceTopics();
+        final Map<String, List<String>> stores = builder.stateStoreNameToSourceTopics();
         for (Map.Entry<HostInfo, Set<TopicPartition>> entry : currentState.entrySet()) {
             final HostInfo key = entry.getKey();
             final Set<TopicPartition> partitionsForHost = new HashSet<>(entry.getValue());
             final Set<String> storesOnHost = new HashSet<>();
-            for (Map.Entry<String, Set<String>> storeTopicEntry : stores.entrySet()) {
-                final Set<String> topicsForStore = storeTopicEntry.getValue();
+            for (Map.Entry<String, List<String>> storeTopicEntry : stores.entrySet()) {
+                final List<String> topicsForStore = storeTopicEntry.getValue();
                 if (hasPartitionsForAnyTopics(topicsForStore, partitionsForHost)) {
                     storesOnHost.add(storeTopicEntry.getKey());
                 }
@@ -259,7 +259,7 @@ private <K> StreamsMetadata getStreamsMetadataForKey(final String storeName,
     }
 
     private SourceTopicsInfo getSourceTopicsInfo(final String storeName) {
-        final Set<String> sourceTopics = builder.stateStoreNameToSourceTopics().get(storeName);
+        final List<String> sourceTopics = builder.stateStoreNameToSourceTopics().get(storeName);
         if (sourceTopics == null || sourceTopics.isEmpty()) {
             return null;
         }
@@ -271,11 +271,11 @@ private boolean isInitialized() {
     }
 
     private class SourceTopicsInfo {
-        private final Set<String> sourceTopics;
+        private final List<String> sourceTopics;
         private int maxPartitions;
         private String topicWithMostPartitions;
 
-        private SourceTopicsInfo(final Set<String> sourceTopics) {
+        private SourceTopicsInfo(final List<String> sourceTopics) {
             this.sourceTopics = sourceTopics;
             for (String topic : sourceTopics) {
                 final List<PartitionInfo> partitions = clusterMetadata.partitionsForTopic(topic);
diff --git a/streams/src/test/java/org/apache/kafka/streams/KafkaStreamsTest.java b/streams/src/test/java/org/apache/kafka/streams/KafkaStreamsTest.java
index 41277c7f264b4..5dae8ddf580ad 100644
--- a/streams/src/test/java/org/apache/kafka/streams/KafkaStreamsTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/KafkaStreamsTest.java
@@ -17,6 +17,7 @@
 
 package org.apache.kafka.streams;
 
+import org.apache.kafka.clients.consumer.ConsumerConfig;
 import org.apache.kafka.common.Metric;
 import org.apache.kafka.common.MetricName;
 import org.apache.kafka.common.config.ConfigException;
@@ -201,6 +202,7 @@ public void shouldReturnFalseOnCloseWhenThreadsHaventTerminated() throws Excepti
             final Properties props = new Properties();
             props.setProperty(StreamsConfig.APPLICATION_ID_CONFIG, "appId");
             props.setProperty(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, CLUSTER.bootstrapServers());
+            props.setProperty(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
 
             final KStreamBuilder builder = new KStreamBuilder();
             final CountDownLatch latch = new CountDownLatch(1);
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamRepartitionJoinTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamRepartitionJoinTest.java
index 6f3c95a3ab536..f0fb0a2a4673d 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamRepartitionJoinTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamRepartitionJoinTest.java
@@ -354,9 +354,9 @@ private void createTopics() throws InterruptedException {
         streamOneInput = "stream-one-" + testNo;
         streamTwoInput = "stream-two-" + testNo;
         streamFourInput = "stream-four-" + testNo;
-        CLUSTER.createTopic(streamOneInput);
-        CLUSTER.createTopic(streamTwoInput);
-        CLUSTER.createTopic(streamFourInput);
+        CLUSTER.createTopic(streamOneInput, 2, 1);
+        CLUSTER.createTopic(streamTwoInput, 2, 1);
+        CLUSTER.createTopic(streamFourInput, 2, 1);
     }
 
 
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/utils/EmbeddedKafkaCluster.java b/streams/src/test/java/org/apache/kafka/streams/integration/utils/EmbeddedKafkaCluster.java
index 619b6b5ed87e3..fe7bebc5635a6 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/utils/EmbeddedKafkaCluster.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/utils/EmbeddedKafkaCluster.java
@@ -68,7 +68,7 @@ public void start() throws IOException, InterruptedException {
         putIfAbsent(brokerConfig, KafkaConfig$.MODULE$.DeleteTopicEnableProp(), true);
         putIfAbsent(brokerConfig, KafkaConfig$.MODULE$.LogCleanerDedupeBufferSizeProp(), 2 * 1024 * 1024L);
         putIfAbsent(brokerConfig, KafkaConfig$.MODULE$.GroupMinSessionTimeoutMsProp(), 0);
-        putIfAbsent(brokerConfig, KafkaConfig$.MODULE$.AutoCreateTopicsEnableProp(), false);
+        putIfAbsent(brokerConfig, KafkaConfig$.MODULE$.AutoCreateTopicsEnableProp(), true);
 
         for (int i = 0; i < brokers.length; i++) {
             brokerConfig.put(KafkaConfig$.MODULE$.BrokerIdProp(), i);
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/utils/IntegrationTestUtils.java b/streams/src/test/java/org/apache/kafka/streams/integration/utils/IntegrationTestUtils.java
index 875c3591b881b..3e7c41b347f22 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/utils/IntegrationTestUtils.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/utils/IntegrationTestUtils.java
@@ -214,7 +214,7 @@ public boolean conditionMet() {
             }
         };
 
-        final String conditionDetails = "Did not receive " + expectedNumRecords + " number of records";
+        final String conditionDetails = "Expecting " + expectedNumRecords + " records while only received " + accumData.size() + ": " + accumData;
 
         TestUtils.waitForCondition(valuesRead, waitTime, conditionDetails);
 
@@ -254,7 +254,7 @@ public boolean conditionMet() {
             }
         };
 
-        final String conditionDetails = "Did not receive " + expectedNumRecords + " number of records";
+        final String conditionDetails = "Expecting " + expectedNumRecords + " records while only received " + accumData.size() + ": " + accumData;
 
         TestUtils.waitForCondition(valuesRead, waitTime, conditionDetails);
 
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/KStreamBuilderTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/KStreamBuilderTest.java
index 5f126c33e9d4f..a469f25fbe754 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/KStreamBuilderTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/KStreamBuilderTest.java
@@ -133,9 +133,8 @@ public boolean test(final String key, final String value) {
 
         final KStream<String, String> merged = builder.merge(processedSource1, processedSource2, source3);
         merged.groupByKey().count("my-table");
-        final Map<String, Set<String>> actual = builder.stateStoreNameToSourceTopics();
-
-        assertEquals(Utils.mkSet("topic-1", "topic-2", "topic-3"), actual.get("my-table"));
+        final Map<String, List<String>> actual = builder.stateStoreNameToSourceTopics();
+        assertEquals(Utils.mkList("topic-1", "topic-2", "topic-3"), actual.get("my-table"));
     }
 
     @Test(expected = TopologyBuilderException.class)
@@ -227,12 +226,11 @@ public void shouldMapStateStoresToCorrectSourceTopics() throws Exception {
         final KStream<String, String> playEvents = builder.stream("events");
 
         final KTable<String, String> table = builder.table("table-topic", "table-store");
-        assertEquals(Collections.singleton("table-topic"), builder.stateStoreNameToSourceTopics().get("table-store"));
+        assertEquals(Collections.singletonList("table-topic"), builder.stateStoreNameToSourceTopics().get("table-store"));
 
         final KStream<String, String> mapped = playEvents.map(MockKeyValueMapper.<String, String>SelectValueKeyValueMapper());
         mapped.leftJoin(table, MockValueJoiner.TOSTRING_JOINER).groupByKey().count("count");
-
-        assertEquals(Collections.singleton("table-topic"), builder.stateStoreNameToSourceTopics().get("table-store"));
-        assertEquals(Collections.singleton(APP_ID + "-KSTREAM-MAP-0000000003-repartition"), builder.stateStoreNameToSourceTopics().get("count"));
+        assertEquals(Collections.singletonList("table-topic"), builder.stateStoreNameToSourceTopics().get("table-store"));
+        assertEquals(Collections.singletonList(APP_ID + "-KSTREAM-MAP-0000000003-repartition"), builder.stateStoreNameToSourceTopics().get("count"));
     }
 }
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/TopologyBuilderTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/TopologyBuilderTest.java
index 4712320d160ed..2f3a450f811ee 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/TopologyBuilderTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/TopologyBuilderTest.java
@@ -156,12 +156,9 @@ public void testSourceTopics() {
         builder.addSource("source-3", "topic-3");
         builder.addInternalTopic("topic-3");
 
-        Set<String> expected = new HashSet<>();
-        expected.add("topic-1");
-        expected.add("topic-2");
-        expected.add("X-topic-3");
+        Pattern expectedPattern = Pattern.compile("X-topic-3|topic-1|topic-2");
 
-        assertEquals(expected, builder.sourceTopics());
+        assertEquals(expectedPattern.pattern(), builder.sourceTopicPattern().pattern());
     }
 
     @Test
@@ -184,7 +181,7 @@ public void testAddMoreThanOnePatternSourceNode() {
     @Test
     public void testSubscribeTopicNameAndPattern() {
         final TopologyBuilder builder = new TopologyBuilder();
-        Pattern expectedPattern = Pattern.compile("topic-foo|topic-bar|.*-\\d");
+        Pattern expectedPattern = Pattern.compile("topic-bar|topic-foo|.*-\\d");
         builder.addSource("source-1", "topic-foo", "topic-bar");
         builder.addSource("source-2", Pattern.compile(".*-\\d"));
         assertEquals(expectedPattern.pattern(), builder.sourceTopicPattern().pattern());
@@ -441,9 +438,9 @@ public void shouldAssociateStateStoreNameWhenStateStoreSupplierIsInternal() thro
         builder.addSource("source", "topic");
         builder.addProcessor("processor", new MockProcessorSupplier(), "source");
         builder.addStateStore(new MockStateStoreSupplier("store", false), "processor");
-        final Map<String, Set<String>> stateStoreNameToSourceTopic = builder.stateStoreNameToSourceTopics();
+        final Map<String, List<String>> stateStoreNameToSourceTopic = builder.stateStoreNameToSourceTopics();
         assertEquals(1, stateStoreNameToSourceTopic.size());
-        assertEquals(Collections.singleton("topic"), stateStoreNameToSourceTopic.get("store"));
+        assertEquals(Collections.singletonList("topic"), stateStoreNameToSourceTopic.get("store"));
     }
 
     @Test
@@ -452,9 +449,9 @@ public void shouldAssociateStateStoreNameWhenStateStoreSupplierIsExternal() thro
         builder.addSource("source", "topic");
         builder.addProcessor("processor", new MockProcessorSupplier(), "source");
         builder.addStateStore(new MockStateStoreSupplier("store", false), "processor");
-        final Map<String, Set<String>> stateStoreNameToSourceTopic = builder.stateStoreNameToSourceTopics();
+        final Map<String, List<String>> stateStoreNameToSourceTopic = builder.stateStoreNameToSourceTopics();
         assertEquals(1, stateStoreNameToSourceTopic.size());
-        assertEquals(Collections.singleton("topic"), stateStoreNameToSourceTopic.get("store"));
+        assertEquals(Collections.singletonList("topic"), stateStoreNameToSourceTopic.get("store"));
     }
 
     @Test
@@ -465,9 +462,9 @@ public void shouldCorrectlyMapStateStoreToInternalTopics() throws Exception {
         builder.addSource("source", "internal-topic");
         builder.addProcessor("processor", new MockProcessorSupplier(), "source");
         builder.addStateStore(new MockStateStoreSupplier("store", false), "processor");
-        final Map<String, Set<String>> stateStoreNameToSourceTopic = builder.stateStoreNameToSourceTopics();
+        final Map<String, List<String>> stateStoreNameToSourceTopic = builder.stateStoreNameToSourceTopics();
         assertEquals(1, stateStoreNameToSourceTopic.size());
-        assertEquals(Collections.singleton("appId-internal-topic"), stateStoreNameToSourceTopic.get("store"));
+        assertEquals(Collections.singletonList("appId-internal-topic"), stateStoreNameToSourceTopic.get("store"));
     }
 
     @SuppressWarnings("unchecked")
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/SourceNodeRecordDeserializerTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/SourceNodeRecordDeserializerTest.java
index fdd9127cd2cb4..cf328eee808ca 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/SourceNodeRecordDeserializerTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/SourceNodeRecordDeserializerTest.java
@@ -22,6 +22,8 @@
 import org.apache.kafka.streams.errors.StreamsException;
 import org.junit.Test;
 
+import java.util.Collections;
+
 import static org.junit.Assert.assertEquals;
 
 public class SourceNodeRecordDeserializerTest {
@@ -82,7 +84,7 @@ static class TheSourceNode extends SourceNode {
                       final boolean valueThrowsException,
                       final Object key,
                       final Object value) {
-            super("", new String[0], null, null);
+            super("", Collections.EMPTY_LIST, null, null);
             this.keyThrowsException = keyThrowsException;
             this.valueThrowsException = valueThrowsException;
             this.key = key;
diff --git a/streams/src/test/java/org/apache/kafka/test/MockSourceNode.java b/streams/src/test/java/org/apache/kafka/test/MockSourceNode.java
index 096c64a6c069c..4e0d21a062e69 100644
--- a/streams/src/test/java/org/apache/kafka/test/MockSourceNode.java
+++ b/streams/src/test/java/org/apache/kafka/test/MockSourceNode.java
@@ -23,6 +23,7 @@
 import org.apache.kafka.streams.processor.internals.SourceNode;
 
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.concurrent.atomic.AtomicInteger;
 
 public class MockSourceNode<K, V> extends SourceNode<K, V> {
@@ -36,7 +37,7 @@ public class MockSourceNode<K, V> extends SourceNode<K, V> {
     public boolean initialized;
 
     public MockSourceNode(String[] topics, Deserializer<K> keyDeserializer, Deserializer<V> valDeserializer) {
-        super(NAME + INDEX.getAndIncrement(), topics, keyDeserializer, valDeserializer);
+        super(NAME + INDEX.getAndIncrement(), Arrays.asList(topics), keyDeserializer, valDeserializer);
     }
 
     @Override

From 4218c02478a213935afbb2c2d661d8a29a5f29ee Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Mon, 23 Jan 2017 16:31:36 -0800
Subject: [PATCH 028/177] KAFKA-4671: Fix Streams window retention policy

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Damian Guy, Eno Thereska, Guozhang Wang

Closes #2401 from mjsax/kafka-4671-window-retention-policy

(cherry picked from commit 79987590e3e96351ff75ce86718801ec605b2419)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../kafka/streams/kstream/JoinWindows.java    |  60 +++++----
 .../kafka/streams/kstream/SessionWindows.java |  19 ++-
 .../kafka/streams/kstream/TimeWindows.java    |  68 +++++-----
 .../streams/kstream/UnlimitedWindows.java     |  38 +++---
 .../apache/kafka/streams/kstream/Window.java  |  42 +++---
 .../kafka/streams/kstream/Windowed.java       |  15 +--
 .../apache/kafka/streams/kstream/Windows.java |  24 ++--
 .../kstream/internals/KStreamImpl.java        |  12 +-
 .../kstream/internals/SessionWindow.java      |   6 +-
 .../streams/kstream/internals/TimeWindow.java |  11 +-
 .../kstream/internals/UnlimitedWindow.java    |  12 +-
 .../streams/kstream/JoinWindowsTest.java      |  64 +++++++--
 .../streams/kstream/SessionWindowsTest.java   |  68 ++++++++++
 .../streams/kstream/TimeWindowsTest.java      |  92 ++++++++++---
 .../streams/kstream/UnlimitedWindowsTest.java |  22 +++-
 .../kafka/streams/kstream/WindowTest.java     |  85 ++++++++++++
 .../kafka/streams/kstream/WindowsTest.java    |  62 +++++++++
 .../kstream/internals/TimeWindowTest.java     | 122 ++++++++++++++++++
 .../internals/UnlimitedWindowTest.java        |  42 ++++++
 .../WindowedStreamPartitionerTest.java        |   2 +-
 .../CompositeReadOnlySessionStoreTest.java    |  18 +--
 21 files changed, 701 insertions(+), 183 deletions(-)
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/kstream/SessionWindowsTest.java
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/kstream/WindowTest.java
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/kstream/WindowsTest.java
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/kstream/internals/TimeWindowTest.java
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/kstream/internals/UnlimitedWindowTest.java

diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java
index 931774356e976..6dd1a85f5340a 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java
@@ -17,8 +17,6 @@
 
 package org.apache.kafka.streams.kstream;
 
-import org.apache.kafka.streams.kstream.internals.TimeWindow;
-
 import java.util.Map;
 
 /**
@@ -45,21 +43,19 @@
  * Both values (before and after) must not result in an "inverse" window,
  * i.e., lower-interval-bound must not be larger than upper-interval.bound.
  */
-public class JoinWindows extends Windows<TimeWindow> {
+public class JoinWindows extends Windows<Window> {
 
     /** Maximum time difference for tuples that are before the join tuple. */
-    public final long before;
+    public final long beforeMs;
     /** Maximum time difference for tuples that are after the join tuple. */
-    public final long after;
-
-    private JoinWindows(long before, long after) {
-        super();
+    public final long afterMs;
 
-        if (before + after < 0) {
-            throw new IllegalArgumentException("Window interval (ie, before+after) must not be negative");
+    private JoinWindows(final long beforeMs, final long afterMs) {
+        if (beforeMs + afterMs < 0) {
+            throw new IllegalArgumentException("Window interval (ie, beforeMs+afterMs) must not be negative");
         }
-        this.after = after;
-        this.before = before;
+        this.afterMs = afterMs;
+        this.beforeMs = beforeMs;
     }
 
     /**
@@ -68,8 +64,8 @@ private JoinWindows(long before, long after) {
      *
      * @param timeDifference    join window interval
      */
-    public static JoinWindows of(long timeDifference) {
-        return new JoinWindows(timeDifference, timeDifference);
+    public static JoinWindows of(final long timeDifferenceMs) throws IllegalArgumentException {
+        return new JoinWindows(timeDifferenceMs, timeDifferenceMs);
     }
 
     /**
@@ -79,8 +75,8 @@ public static JoinWindows of(long timeDifference) {
      *
      * @param timeDifference    join window interval
      */
-    public JoinWindows before(long timeDifference) {
-        return new JoinWindows(timeDifference, this.after);
+    public JoinWindows before(final long timeDifferenceMs) throws IllegalArgumentException {
+        return new JoinWindows(timeDifferenceMs, afterMs);
     }
 
     /**
@@ -90,25 +86,39 @@ public JoinWindows before(long timeDifference) {
      *
      * @param timeDifference    join window interval
      */
-    public JoinWindows after(long timeDifference) {
-        return new JoinWindows(this.before, timeDifference);
+    public JoinWindows after(final long timeDifferenceMs) throws IllegalArgumentException {
+        return new JoinWindows(beforeMs, timeDifferenceMs);
     }
 
     /**
      * Not supported by {@link JoinWindows}. Throws {@link UnsupportedOperationException}.
      */
     @Override
-    public Map<Long, TimeWindow> windowsFor(long timestamp) {
+    public Map<Long, Window> windowsFor(final long timestamp) {
         throw new UnsupportedOperationException("windowsFor() is not supported in JoinWindows");
     }
 
     @Override
     public long size() {
-        return after + before;
+        return beforeMs + afterMs;
+    }
+
+    @Override
+    public JoinWindows until(final long durationMs) throws IllegalArgumentException {
+        if (durationMs < size()) {
+            throw new IllegalArgumentException("Window retention time (durationMs) cannot be smaller than the window size.");
+        }
+        super.until(durationMs);
+        return this;
+    }
+
+    @Override
+    public long maintainMs() {
+        return Math.max(super.maintainMs(), size());
     }
 
     @Override
-    public final boolean equals(Object o) {
+    public final boolean equals(final Object o) {
         if (o == this) {
             return true;
         }
@@ -116,14 +126,14 @@ public final boolean equals(Object o) {
             return false;
         }
 
-        JoinWindows other = (JoinWindows) o;
-        return this.before == other.before && this.after == other.after;
+        final JoinWindows other = (JoinWindows) o;
+        return beforeMs == other.beforeMs && afterMs == other.afterMs;
     }
 
     @Override
     public int hashCode() {
-        int result = (int) (before ^ (before >>> 32));
-        result = 31 * result + (int) (after ^ (after >>> 32));
+        int result = (int) (beforeMs ^ (beforeMs >>> 32));
+        result = 31 * result + (int) (afterMs ^ (afterMs >>> 32));
         return result;
     }
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java
index f9a399a6451e1..bed6c3dd97125 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java
@@ -63,9 +63,9 @@ public class SessionWindows {
     private final long gapMs;
     private long maintainDurationMs;
 
-    private SessionWindows(final long gapMs, final long maintainDurationMs) {
+    private SessionWindows(final long gapMs) {
         this.gapMs = gapMs;
-        this.maintainDurationMs = maintainDurationMs;
+        maintainDurationMs = Windows.DEFAULT_MAINTAIN_DURATION_MS;
     }
 
     /**
@@ -75,7 +75,10 @@ private SessionWindows(final long gapMs, final long maintainDurationMs) {
      * and default maintain duration
      */
     public static SessionWindows with(final long inactivityGapMs) {
-        return new SessionWindows(inactivityGapMs, Windows.DEFAULT_MAINTAIN_DURATION);
+        if (inactivityGapMs < 1) {
+            throw new IllegalArgumentException("Gap time (inactivityGapMs) cannot be zero or negative.");
+        }
+        return new SessionWindows(inactivityGapMs);
     }
 
     /**
@@ -84,8 +87,12 @@ public static SessionWindows with(final long inactivityGapMs) {
      *
      * @return  itself
      */
-    public SessionWindows until(final long durationMs) {
-        this.maintainDurationMs = durationMs;
+    public SessionWindows until(final long durationMs) throws IllegalArgumentException {
+        if (durationMs < gapMs) {
+            throw new IllegalArgumentException("Window retentin time (durationMs) cannot be smaller than window gap.");
+        }
+        maintainDurationMs = durationMs;
+
         return this;
     }
 
@@ -100,6 +107,6 @@ public long inactivityGap() {
      * @return the minimum amount of time a window will be maintained for.
      */
     public long maintainMs() {
-        return maintainDurationMs;
+        return Math.max(maintainDurationMs, gapMs);
     }
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java
index ef94cf9b0abfa..11df22823c6aa 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java
@@ -40,27 +40,18 @@ public class TimeWindows extends Windows<TimeWindow> {
      * The window size's effective time unit is determined by the semantics of the topology's
      * configured {@link org.apache.kafka.streams.processor.TimestampExtractor}.
      */
-    public final long size;
+    public final long sizeMs;
 
     /**
      * The size of the window's advance interval, i.e. by how much a window moves forward relative
      * to the previous one. The interval's effective time unit is determined by the semantics of
      * the topology's configured {@link org.apache.kafka.streams.processor.TimestampExtractor}.
      */
-    public final long advance;
+    public final long advanceMs;
 
-
-    private TimeWindows(long size, long advance) {
-        super();
-        if (size <= 0) {
-            throw new IllegalArgumentException("window size must be > 0 (you provided " + size + ")");
-        }
-        this.size = size;
-        if (!(0 < advance && advance <= size)) {
-            throw new IllegalArgumentException(
-                String.format("advance interval (%d) must lie within interval (0, %d]", advance, size));
-        }
-        this.advance = advance;
+    private TimeWindows(final long sizeMs, final long advanceMs) throws IllegalArgumentException {
+        this.sizeMs = sizeMs;
+        this.advanceMs = advanceMs;
     }
 
     /**
@@ -76,8 +67,11 @@ private TimeWindows(long size, long advance) {
      *             topology's configured {@link org.apache.kafka.streams.processor.TimestampExtractor}.
      * @return a new window definition
      */
-    public static TimeWindows of(long size) {
-        return new TimeWindows(size, size);
+    public static TimeWindows of(final long sizeMs) throws IllegalArgumentException {
+        if (sizeMs <= 0) {
+            throw new IllegalArgumentException("Window sizeMs must be larger than zero.");
+        }
+        return new TimeWindows(sizeMs, sizeMs);
     }
 
     /**
@@ -93,43 +87,59 @@ public static TimeWindows of(long size) {
      *                 {@link org.apache.kafka.streams.processor.TimestampExtractor}.
      * @return a new window definition
      */
-    public TimeWindows advanceBy(long interval) {
-        return new TimeWindows(this.size, interval);
+    public TimeWindows advanceBy(final long advanceMs) {
+        if (advanceMs <= 0 || advanceMs > sizeMs) {
+            throw new IllegalArgumentException(String.format("AdvanceMs must lie within interval (0, %d]", sizeMs));
+        }
+        return new TimeWindows(sizeMs, advanceMs);
     }
 
     @Override
-    public Map<Long, TimeWindow> windowsFor(long timestamp) {
-        long windowStart = (Math.max(0, timestamp - this.size + this.advance) / this.advance) * this.advance;
-        Map<Long, TimeWindow> windows = new HashMap<>();
+    public Map<Long, TimeWindow> windowsFor(final long timestamp) {
+        long windowStart = (Math.max(0, timestamp - sizeMs + advanceMs) / advanceMs) * advanceMs;
+        final Map<Long, TimeWindow> windows = new HashMap<>();
         while (windowStart <= timestamp) {
-            TimeWindow window = new TimeWindow(windowStart, windowStart + this.size);
+            final TimeWindow window = new TimeWindow(windowStart, windowStart + sizeMs);
             windows.put(windowStart, window);
-            windowStart += this.advance;
+            windowStart += advanceMs;
         }
         return windows;
     }
 
     @Override
     public long size() {
-        return size;
+        return sizeMs;
+    }
+
+    public TimeWindows until(final long durationMs) throws IllegalArgumentException {
+        if (durationMs < sizeMs) {
+            throw new IllegalArgumentException("Window retention time (durationMs) cannot be smaller than the window size.");
+        }
+        super.until(durationMs);
+        return this;
+    }
+
+    @Override
+    public long maintainMs() {
+        return Math.max(super.maintainMs(), sizeMs);
     }
 
     @Override
-    public final boolean equals(Object o) {
+    public final boolean equals(final Object o) {
         if (o == this) {
             return true;
         }
         if (!(o instanceof TimeWindows)) {
             return false;
         }
-        TimeWindows other = (TimeWindows) o;
-        return this.size == other.size && this.advance == other.advance;
+        final TimeWindows other = (TimeWindows) o;
+        return sizeMs == other.sizeMs && advanceMs == other.advanceMs;
     }
 
     @Override
     public int hashCode() {
-        int result = (int) (size ^ (size >>> 32));
-        result = 31 * result + (int) (advance ^ (advance >>> 32));
+        int result = (int) (sizeMs ^ (sizeMs >>> 32));
+        result = 31 * result + (int) (advanceMs ^ (advanceMs >>> 32));
         return result;
     }
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java
index 3dc6f654dcdec..8605f9d6bf26b 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java
@@ -27,24 +27,23 @@
  */
 public class UnlimitedWindows extends Windows<UnlimitedWindow> {
 
-    private static final long DEFAULT_START_TIMESTAMP = 0L;
+    private static final long DEFAULT_START_TIMESTAMP_MS = 0L;
 
     /** The start timestamp of the window. */
-    public final long start;
+    public final long startMs;
 
-    private UnlimitedWindows(long start) {
-        super();
-        if (start < 0) {
-            throw new IllegalArgumentException("start must be > 0 (you provided " + start + ")");
+    private UnlimitedWindows(final long startMs) throws IllegalArgumentException {
+        if (startMs < 0) {
+            throw new IllegalArgumentException("startMs must be > 0 (you provided " + startMs + ")");
         }
-        this.start = start;
+        this.startMs = startMs;
     }
 
     /**
      * Return an unlimited window starting at timestamp zero.
      */
     public static UnlimitedWindows of() {
-        return new UnlimitedWindows(DEFAULT_START_TIMESTAMP);
+        return new UnlimitedWindows(DEFAULT_START_TIMESTAMP_MS);
     }
 
     /**
@@ -53,18 +52,18 @@ public static UnlimitedWindows of() {
      * @param start  the window start time
      * @return       a new unlimited window that starts at {@code start}
      */
-    public UnlimitedWindows startOn(long start) {
+    public UnlimitedWindows startOn(final long start) throws IllegalArgumentException {
         return new UnlimitedWindows(start);
     }
 
     @Override
-    public Map<Long, UnlimitedWindow> windowsFor(long timestamp) {
+    public Map<Long, UnlimitedWindow> windowsFor(final long timestamp) {
         // always return the single unlimited window
 
         // we cannot use Collections.singleMap since it does not support remove()
-        Map<Long, UnlimitedWindow> windows = new HashMap<>();
-        if (timestamp >= start) {
-            windows.put(start, new UnlimitedWindow(start));
+        final Map<Long, UnlimitedWindow> windows = new HashMap<>();
+        if (timestamp >= startMs) {
+            windows.put(startMs, new UnlimitedWindow(startMs));
         }
         return windows;
     }
@@ -75,7 +74,7 @@ public long size() {
     }
 
     @Override
-    public final boolean equals(Object o) {
+    public final boolean equals(final Object o) {
         if (o == this) {
             return true;
         }
@@ -84,13 +83,18 @@ public final boolean equals(Object o) {
             return false;
         }
 
-        UnlimitedWindows other = (UnlimitedWindows) o;
-        return this.start == other.start;
+        final UnlimitedWindows other = (UnlimitedWindows) o;
+        return startMs == other.startMs;
     }
 
     @Override
     public int hashCode() {
-        return (int) (start ^ (start >>> 32));
+        return (int) (startMs ^ (startMs >>> 32));
+    }
+
+    @Override
+    public UnlimitedWindows until(final long durationMs) {
+        throw new IllegalArgumentException("Window retention time (durationMs) cannot be set for UnlimitedWindows.");
     }
 
     @Override
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java
index 13a9529d6bedd..9c6edc099588c 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java
@@ -22,8 +22,8 @@
  */
 public abstract class Window {
 
-    protected final long start;
-    protected final long end;
+    protected final long startMs;
+    protected final long endMs;
 
     /**
      * Create a new window for the given start time (inclusive) and end time (exclusive).
@@ -33,32 +33,29 @@ public abstract class Window {
      * @throws IllegalArgumentException if {@code start} or {@code end} is negative or if {@code end} is smaller than
      * {@code start}
      */
-    public Window(long start, long end) throws IllegalArgumentException {
-        if (start < 0) {
-            throw new IllegalArgumentException("Window start time cannot be negative.");
+    public Window(long startMs, long endMs) throws IllegalArgumentException {
+        if (startMs < 0) {
+            throw new IllegalArgumentException("Window startMs time cannot be negative.");
         }
-        if (end < 0) {
-            throw new IllegalArgumentException("Window end time cannot be negative.");
+        if (endMs < startMs) {
+            throw new IllegalArgumentException("Window endMs time cannot be smaller than window startMs time.");
         }
-        if (end < start) {
-            throw new IllegalArgumentException("Window end time cannot be smaller than window start time.");
-        }
-        this.start = start;
-        this.end = end;
+        this.startMs = startMs;
+        this.endMs = endMs;
     }
 
     /**
      * Return the start timestamp of this window, inclusive
      */
     public long start() {
-        return start;
+        return startMs;
     }
 
     /**
      * Return the end timestamp of this window, exclusive
      */
     public long end() {
-        return end;
+        return endMs;
     }
 
     /**
@@ -67,10 +64,10 @@ public long end() {
      * @param other  another window
      * @return       {@code true} if {@code other} overlaps with this window&mdash;{@code false} otherwise
      */
-    public abstract boolean overlap(Window other);
+    public abstract boolean overlap(final Window other);
 
     @Override
-    public boolean equals(Object obj) {
+    public boolean equals(final Object obj) {
         if (obj == this) {
             return true;
         }
@@ -79,21 +76,20 @@ public boolean equals(Object obj) {
             return false;
         }
 
-        Window other = (Window) obj;
-        return this.start == other.start && this.end == other.end;
+        final Window other = (Window) obj;
+        return startMs == other.startMs && endMs == other.endMs;
     }
 
     @Override
     public int hashCode() {
-        long n = (this.start << 32) | this.end;
-        return (int) (n % 0xFFFFFFFFL);
+        return (int) (((startMs << 32) | endMs) % 0xFFFFFFFFL);
     }
 
     @Override
     public String toString() {
         return "Window{" +
-                "start=" + start +
-                ", end=" + end +
-                '}';
+            "start=" + startMs +
+            ", end=" + endMs +
+            '}';
     }
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Windowed.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Windowed.java
index 6606fcb367acc..81357c1daf50d 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Windowed.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Windowed.java
@@ -26,11 +26,11 @@
  */
 public class Windowed<K> {
 
-    private K key;
+    private final K key;
 
-    private Window window;
+    private final Window window;
 
-    public Windowed(K key, Window window) {
+    public Windowed(final K key, final Window window) {
         this.key = key;
         this.window = window;
     }
@@ -59,21 +59,20 @@ public String toString() {
     }
 
     @Override
-    public boolean equals(Object obj) {
+    public boolean equals(final Object obj) {
         if (obj == this)
             return true;
 
         if (!(obj instanceof Windowed))
             return false;
 
-        Windowed<?> that = (Windowed) obj;
-
-        return this.window.equals(that.window) && this.key.equals(that.key);
+        final Windowed<?> that = (Windowed) obj;
+        return window.equals(that.window) && key.equals(that.key);
     }
 
     @Override
     public int hashCode() {
-        long n = ((long) window.hashCode() << 32) | key.hashCode();
+        final long n = ((long) window.hashCode() << 32) | key.hashCode();
         return (int) (n % 0xFFFFFFFFL);
     }
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Windows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Windows.java
index ebd92fe7346e5..29b61fda79bf8 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Windows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Windows.java
@@ -14,7 +14,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-
 package org.apache.kafka.streams.kstream;
 
 import java.util.Map;
@@ -28,15 +27,15 @@ public abstract class Windows<W extends Window> {
 
     private static final int DEFAULT_NUM_SEGMENTS = 3;
 
-    static final long DEFAULT_MAINTAIN_DURATION = 24 * 60 * 60 * 1000L;   // one day
+    static final long DEFAULT_MAINTAIN_DURATION_MS = 24 * 60 * 60 * 1000L; // one day
 
     private long maintainDurationMs;
 
     public int segments;
 
     protected Windows() {
-        this.segments = DEFAULT_NUM_SEGMENTS;
-        this.maintainDurationMs = DEFAULT_MAINTAIN_DURATION;
+        segments = DEFAULT_NUM_SEGMENTS;
+        maintainDurationMs = DEFAULT_MAINTAIN_DURATION_MS;
     }
 
     /**
@@ -45,8 +44,12 @@ protected Windows() {
      *
      * @return  itself
      */
-    public Windows<W> until(long durationMs) {
-        this.maintainDurationMs = durationMs;
+    // This should always get overridden to provide the correct return type and thus to avoid a cast
+    public Windows<W> until(final long durationMs) throws IllegalArgumentException {
+        if (durationMs < 0) {
+            throw new IllegalArgumentException("Window retention time (durationMs) cannot be negative.");
+        }
+        maintainDurationMs = durationMs;
 
         return this;
     }
@@ -57,7 +60,10 @@ public Windows<W> until(long durationMs) {
      *
      * @return  itself
      */
-    protected Windows<W> segments(int segments) {
+    protected Windows<W> segments(final int segments) throws IllegalArgumentException {
+        if (segments < 2) {
+            throw new IllegalArgumentException("Number of segments must be at least 2.");
+        }
         this.segments = segments;
 
         return this;
@@ -69,7 +75,7 @@ protected Windows<W> segments(int segments) {
      * @return the window maintain duration in milliseconds of streams time
      */
     public long maintainMs() {
-        return this.maintainDurationMs;
+        return maintainDurationMs;
     }
 
     /**
@@ -78,7 +84,7 @@ public long maintainMs() {
      * @param timestamp  the timestamp window should get created for
      * @return  a map of {@code windowStartTimestamp -> Window} entries
      */
-    public abstract Map<Long, W> windowsFor(long timestamp);
+    public abstract Map<Long, W> windowsFor(final long timestamp);
 
     public abstract long size();
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamImpl.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamImpl.java
index 3d41ae44d768d..0434f06c7fe76 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamImpl.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamImpl.java
@@ -711,20 +711,20 @@ public <K1, R, V1, V2> KStream<K1, R> join(KStream<K1, V1> lhs,
 
 
             KStreamJoinWindow<K1, V1> thisWindowedStream = new KStreamJoinWindow<>(thisWindow.name(),
-                                                                                   windows.before + windows.after + 1,
+                                                                                   windows.beforeMs + windows.afterMs + 1,
                                                                                    windows.maintainMs());
             KStreamJoinWindow<K1, V2> otherWindowedStream = new KStreamJoinWindow<>(otherWindow.name(),
-                                                                                    windows.before + windows.after + 1,
+                                                                                    windows.beforeMs + windows.afterMs + 1,
                                                                                     windows.maintainMs());
 
             final KStreamKStreamJoin<K1, R, ? super V1, ? super V2> joinThis = new KStreamKStreamJoin<>(otherWindow.name(),
-                windows.before,
-                windows.after,
+                windows.beforeMs,
+                windows.afterMs,
                 joiner,
                 leftOuter);
             final KStreamKStreamJoin<K1, R, ? super V2, ? super V1> joinOther = new KStreamKStreamJoin<>(thisWindow.name(),
-                windows.after,
-                windows.before,
+                windows.afterMs,
+                windows.beforeMs,
                 reverseJoiner(joiner),
                 rightOuter);
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionWindow.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionWindow.java
index db63029e04ae7..cf72752fa526b 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionWindow.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionWindow.java
@@ -35,8 +35,8 @@ public final class SessionWindow extends Window {
      * @param start  the start timestamp of the window
      * @param end    the end timestamp of the window
      */
-    public SessionWindow(final long start, final long end) {
-        super(start, end);
+    public SessionWindow(final long startMs, final long endMs) {
+        super(startMs, endMs);
     }
 
     /**
@@ -52,7 +52,7 @@ public boolean overlap(final Window other) throws IllegalArgumentException {
                 + other.getClass());
         }
         final SessionWindow otherWindow = (SessionWindow) other;
-        return !(otherWindow.end < start || end < otherWindow.start);
+        return !(otherWindow.endMs < startMs || endMs < otherWindow.startMs);
     }
 
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/TimeWindow.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/TimeWindow.java
index 630821fdb8064..bf98f941dbac9 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/TimeWindow.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/TimeWindow.java
@@ -21,18 +21,21 @@
 
 public class TimeWindow extends Window {
 
-    public TimeWindow(long start, long end) {
-        super(start, end);
+    public TimeWindow(long startMs, long endMs) {
+        super(startMs, endMs);
+        if (startMs == endMs) {
+            throw new IllegalArgumentException("Window endMs must be greater than window startMs.");
+        }
     }
 
     @Override
-    public boolean overlap(Window other) {
+    public boolean overlap(final Window other) throws IllegalArgumentException {
         if (getClass() != other.getClass()) {
             throw new IllegalArgumentException("Cannot compare windows of different type. Other window has type "
                 + other.getClass());
         }
         final TimeWindow otherWindow = (TimeWindow) other;
-        return start < otherWindow.end && otherWindow.start < end;
+        return startMs < otherWindow.endMs && otherWindow.startMs < endMs;
     }
 
 }
\ No newline at end of file
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/UnlimitedWindow.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/UnlimitedWindow.java
index e9ec040d0d191..7fb7c53000a44 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/UnlimitedWindow.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/UnlimitedWindow.java
@@ -5,9 +5,9 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -21,12 +21,12 @@
 
 public class UnlimitedWindow extends Window {
 
-    public UnlimitedWindow(long start) {
-        super(start, Long.MAX_VALUE);
+    public UnlimitedWindow(final long startMs) {
+        super(startMs, Long.MAX_VALUE);
     }
 
     @Override
-    public boolean overlap(Window other) {
+    public boolean overlap(final Window other) {
         if (getClass() != other.getClass()) {
             throw new IllegalArgumentException("Cannot compare windows of different type. Other window has type "
                 + other.getClass());
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/JoinWindowsTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/JoinWindowsTest.java
index b37e5e8d87986..24387ad687805 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/JoinWindowsTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/JoinWindowsTest.java
@@ -23,6 +23,7 @@
 
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertNotEquals;
+import static org.junit.Assert.fail;
 
 
 public class JoinWindowsTest {
@@ -44,8 +45,8 @@ public void shouldHaveSaneEqualsAndHashCode() {
         assertEquals(w2, w1);
         assertEquals(w1.hashCode(), w2.hashCode());
 
-        JoinWindows w3 = JoinWindows.of(w2.after).before(anyOtherSize);
-        JoinWindows w4 = JoinWindows.of(anyOtherSize).after(w2.after);
+        JoinWindows w3 = JoinWindows.of(w2.afterMs).before(anyOtherSize);
+        JoinWindows w4 = JoinWindows.of(anyOtherSize).after(w2.afterMs);
         assertEquals(w3, w4);
         assertEquals(w4, w3);
         assertEquals(w3.hashCode(), w4.hashCode());
@@ -55,13 +56,13 @@ public void shouldHaveSaneEqualsAndHashCode() {
         assertNotEquals("must be false for different window types", UnlimitedWindows.of(), w1);
         assertNotEquals("must be false for different types", new Object(), w1);
 
-        JoinWindows differentWindowSize = JoinWindows.of(w1.after + 1);
+        JoinWindows differentWindowSize = JoinWindows.of(w1.afterMs + 1);
         assertNotEquals("must be false when window sizes are different", differentWindowSize, w1);
 
-        JoinWindows differentWindowSize2 = JoinWindows.of(w1.after).after(w1.after + 1);
+        JoinWindows differentWindowSize2 = JoinWindows.of(w1.afterMs).after(w1.afterMs + 1);
         assertNotEquals("must be false when window sizes are different", differentWindowSize2, w1);
 
-        JoinWindows differentWindowSize3 = JoinWindows.of(w1.after).before(w1.before + 1);
+        JoinWindows differentWindowSize3 = JoinWindows.of(w1.afterMs).before(w1.beforeMs + 1);
         assertNotEquals("must be false when window sizes are different", differentWindowSize3, w1);
     }
 
@@ -85,14 +86,55 @@ public void timeDifferenceMustNotBeNegative() {
         JoinWindows.of(-1);
     }
 
-    @Test(expected = IllegalArgumentException.class)
-    public void afterBelowLower() {
-        JoinWindows.of(anySize).after(-anySize - 1);
+    @Test
+    public void endTimeShouldNotBeBeforeStart() {
+        final JoinWindows windowSpec = JoinWindows.of(anySize);
+        try {
+            windowSpec.after(-anySize - 1);
+            fail("window end time should not be before window start time");
+        } catch (final IllegalArgumentException e) {
+            // expected
+        }
     }
 
-    @Test(expected = IllegalArgumentException.class)
-    public void beforeOverUpper() {
-        JoinWindows.of(anySize).before(-anySize - 1);
+    @Test
+    public void startTimeShouldNotBeAfterEnd() {
+        final JoinWindows windowSpec = JoinWindows.of(anySize);
+        try {
+            windowSpec.before(-anySize - 1);
+            fail("window start time should not be after window end time");
+        } catch (final IllegalArgumentException e) {
+            // expected
+        }
+    }
+
+    @Test
+    public void untilShouldSetMaintainDuration() {
+        final JoinWindows windowSpec = JoinWindows.of(anySize);
+        final long windowSize = windowSpec.size();
+        assertEquals(windowSize, windowSpec.until(windowSize).maintainMs());
+    }
+
+    @Test
+    public void shouldUseWindowSizeForMaintainDurationWhenSizeLargerThanDefaultMaintainMs() {
+        final long size = Windows.DEFAULT_MAINTAIN_DURATION_MS;
+
+        final JoinWindows windowSpec = JoinWindows.of(size);
+        final long windowSize = windowSpec.size();
+
+        assertEquals(windowSize, windowSpec.maintainMs());
+    }
+
+    @Test
+    public void retentionTimeMustNoBeSmallerThanWindowSize() {
+        final JoinWindows windowSpec = JoinWindows.of(anySize);
+        final long windowSize = windowSpec.size();
+        try {
+            windowSpec.until(windowSize - 1);
+            fail("should not accept retention time smaller than window size");
+        } catch (final IllegalArgumentException e) {
+            // expected
+        }
     }
 
 }
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/SessionWindowsTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/SessionWindowsTest.java
new file mode 100644
index 0000000000000..a9eced46cf1a3
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/SessionWindowsTest.java
@@ -0,0 +1,68 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.apache.kafka.streams.kstream;
+
+import org.junit.Test;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.fail;
+
+public class SessionWindowsTest {
+
+    @Test
+    public void shouldSetWindowGap() {
+        final long anyGap = 42L;
+        assertEquals(anyGap, SessionWindows.with(anyGap).inactivityGap());
+    }
+
+    @Test
+    public void shouldSetWindowRetentionTime() {
+        final long anyRetentionTime = 42L;
+        assertEquals(anyRetentionTime, SessionWindows.with(1).until(anyRetentionTime).maintainMs());
+    }
+
+    @Test(expected = IllegalArgumentException.class)
+    public void windowSizeMustNotBeNegative() {
+        SessionWindows.with(-1);
+    }
+
+    @Test(expected = IllegalArgumentException.class)
+    public void windowSizeMustNotBeZero() {
+        SessionWindows.with(0);
+    }
+
+    @Test
+    public void retentionTimeShouldBeGapIfGapIsLargerThanDefaultRetentionTime() {
+        final long windowGap = 2 * Windows.DEFAULT_MAINTAIN_DURATION_MS;
+        assertEquals(windowGap, SessionWindows.with(windowGap).maintainMs());
+    }
+
+    @Test
+    public void retentionTimeMustNotBeNegative() {
+        final SessionWindows windowSpec = SessionWindows.with(42);
+        try {
+            windowSpec.until(41);
+            fail("should not accept retention time smaller than gap");
+        } catch (final IllegalArgumentException e) {
+            // expected
+        }
+    }
+
+}
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/TimeWindowsTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/TimeWindowsTest.java
index 2bea16b23b367..6b8b6ea9c99c1 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/TimeWindowsTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/TimeWindowsTest.java
@@ -26,15 +26,38 @@
 
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertNotEquals;
+import static org.junit.Assert.fail;
 
 public class TimeWindowsTest {
 
-    private static long anySize = 123L;
+    private static final long ANY_SIZE = 123L;
+
+    @Test
+    public void shouldSetWindowSize() {
+        assertEquals(ANY_SIZE, TimeWindows.of(ANY_SIZE).sizeMs);
+    }
+
+    @Test
+    public void shouldSetWindowAdvance() {
+        final long anyAdvance = 4;
+        assertEquals(anyAdvance, TimeWindows.of(ANY_SIZE).advanceBy(anyAdvance).advanceMs);
+    }
+
+    @Test
+    public void shouldSetWindowRetentionTime() {
+        assertEquals(ANY_SIZE, TimeWindows.of(ANY_SIZE).until(ANY_SIZE).maintainMs());
+    }
+
+    @Test
+    public void shouldUseWindowSizeAsRentitionTimeIfWindowSizeIsLargerThanDefaultRetentionTime() {
+        final long windowSize = 2 * Windows.DEFAULT_MAINTAIN_DURATION_MS;
+        assertEquals(windowSize, TimeWindows.of(windowSize).maintainMs());
+    }
 
     @Test
     public void shouldHaveSaneEqualsAndHashCode() {
-        TimeWindows w1 = TimeWindows.of(anySize);
-        TimeWindows w2 = TimeWindows.of(w1.size);
+        TimeWindows w1 = TimeWindows.of(ANY_SIZE);
+        TimeWindows w2 = TimeWindows.of(w1.sizeMs);
 
         // Reflexive
         assertEquals(w1, w1);
@@ -46,7 +69,7 @@ public void shouldHaveSaneEqualsAndHashCode() {
         assertEquals(w1.hashCode(), w2.hashCode());
 
         // Transitive
-        TimeWindows w3 = TimeWindows.of(w2.size);
+        TimeWindows w3 = TimeWindows.of(w2.sizeMs);
         assertEquals(w2, w3);
         assertEquals(w1, w3);
         assertEquals(w1.hashCode(), w3.hashCode());
@@ -56,42 +79,69 @@ public void shouldHaveSaneEqualsAndHashCode() {
         assertNotEquals("must be false for different window types", UnlimitedWindows.of(), w1);
         assertNotEquals("must be false for different types", new Object(), w1);
 
-        TimeWindows differentWindowSize = TimeWindows.of(w1.size + 1);
+        TimeWindows differentWindowSize = TimeWindows.of(w1.sizeMs + 1);
         assertNotEquals("must be false when window sizes are different", differentWindowSize, w1);
 
-        TimeWindows differentAdvanceInterval = w1.advanceBy(w1.advance - 1);
+        TimeWindows differentAdvanceInterval = w1.advanceBy(w1.advanceMs - 1);
         assertNotEquals("must be false when advance intervals are different", differentAdvanceInterval, w1);
     }
 
+    @Test(expected = IllegalArgumentException.class)
+    public void windowSizeMustNotBeZero() {
+        TimeWindows.of(0);
+    }
 
     @Test(expected = IllegalArgumentException.class)
     public void windowSizeMustNotBeNegative() {
         TimeWindows.of(-1);
     }
 
-    @Test(expected = IllegalArgumentException.class)
-    public void windowSizeMustNotBeZero() {
-        TimeWindows.of(0);
+    @Test
+    public void advanceIntervalMustNotBeZero() {
+        final TimeWindows windowSpec = TimeWindows.of(ANY_SIZE);
+        try {
+            windowSpec.advanceBy(0);
+            fail("should not accept zero advance parameter");
+        } catch (final IllegalArgumentException e) {
+            // expected
+        }
     }
 
-    @Test(expected = IllegalArgumentException.class)
+    @Test
     public void advanceIntervalMustNotBeNegative() {
-        TimeWindows.of(anySize).advanceBy(-1);
+        final TimeWindows windowSpec = TimeWindows.of(ANY_SIZE);
+        try {
+            windowSpec.advanceBy(-1);
+            fail("should not accept negative advance parameter");
+        } catch (final IllegalArgumentException e) {
+            // expected
+        }
     }
 
-    @Test(expected = IllegalArgumentException.class)
-    public void advanceIntervalMustNotBeZero() {
-        TimeWindows.of(anySize).advanceBy(0);
+    @Test
+    public void advanceIntervalMustNotBeLargerThanWindowSize() {
+        final TimeWindows windowSpec = TimeWindows.of(ANY_SIZE);
+        try {
+            windowSpec.advanceBy(ANY_SIZE + 1);
+            fail("should not accept advance greater than window size");
+        } catch (final IllegalArgumentException e) {
+            // expected
+        }
     }
 
-    @Test(expected = IllegalArgumentException.class)
-    public void advanceIntervalMustNotBeLargerThanWindowSize() {
-        long size = anySize;
-        TimeWindows.of(size).advanceBy(size + 1);
+    @Test
+    public void retentionTimeMustNoBeSmallerThanWindowSize() {
+        final TimeWindows windowSpec = TimeWindows.of(ANY_SIZE);
+        try {
+            windowSpec.until(ANY_SIZE - 1);
+            fail("should not accept retention time smaller than window size");
+        } catch (final IllegalArgumentException e) {
+            // expected
+        }
     }
 
     @Test
-    public void windowsForHoppingWindows() {
+    public void shouldComputeWindowsForHoppingWindows() {
         TimeWindows windows = TimeWindows.of(12L).advanceBy(5L);
         Map<Long, TimeWindow> matched = windows.windowsFor(21L);
         assertEquals(12L / 5L + 1, matched.size());
@@ -101,7 +151,7 @@ public void windowsForHoppingWindows() {
     }
 
     @Test
-    public void windowsForBarelyOverlappingHoppingWindows() {
+    public void shouldComputeWindowsForBarelyOverlappingHoppingWindows() {
         TimeWindows windows = TimeWindows.of(6L).advanceBy(5L);
         Map<Long, TimeWindow> matched = windows.windowsFor(7L);
         assertEquals(1, matched.size());
@@ -109,7 +159,7 @@ public void windowsForBarelyOverlappingHoppingWindows() {
     }
 
     @Test
-    public void windowsForTumblingWindows() {
+    public void shouldComputeWindowsForTumblingWindows() {
         TimeWindows windows = TimeWindows.of(12L);
         Map<Long, TimeWindow> matched = windows.windowsFor(21L);
         assertEquals(1, matched.size());
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/UnlimitedWindowsTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/UnlimitedWindowsTest.java
index c1f4be6246353..ea9078c9dbaca 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/UnlimitedWindowsTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/UnlimitedWindowsTest.java
@@ -26,25 +26,37 @@
 
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertTrue;
+import static org.junit.Assert.fail;
 
 public class UnlimitedWindowsTest {
 
     private static long anyStartTime = 10L;
 
+    @Test
+    public void shouldSetWindowStartTime() {
+        assertEquals(anyStartTime, UnlimitedWindows.of().startOn(anyStartTime).startMs);
+    }
+
     @Test(expected = IllegalArgumentException.class)
     public void startTimeMustNotBeNegative() {
         UnlimitedWindows.of().startOn(-1);
     }
 
     @Test
-    public void startTimeCanBeZero() {
-        UnlimitedWindows.of().startOn(0);
+    public void shouldThrowOnUntil() {
+        final UnlimitedWindows windowSpec = UnlimitedWindows.of();
+        try {
+            windowSpec.until(42);
+            fail("should not allow to set window retention time");
+        } catch (final IllegalArgumentException e) {
+            // expected
+        }
     }
 
     @Test
     public void shouldIncludeRecordsThatHappenedOnWindowStart() {
         UnlimitedWindows w = UnlimitedWindows.of().startOn(anyStartTime);
-        Map<Long, UnlimitedWindow> matchedWindows = w.windowsFor(w.start);
+        Map<Long, UnlimitedWindow> matchedWindows = w.windowsFor(w.startMs);
         assertEquals(1, matchedWindows.size());
         assertEquals(new UnlimitedWindow(anyStartTime), matchedWindows.get(anyStartTime));
     }
@@ -52,7 +64,7 @@ public void shouldIncludeRecordsThatHappenedOnWindowStart() {
     @Test
     public void shouldIncludeRecordsThatHappenedAfterWindowStart() {
         UnlimitedWindows w = UnlimitedWindows.of().startOn(anyStartTime);
-        long timestamp = w.start + 1;
+        long timestamp = w.startMs + 1;
         Map<Long, UnlimitedWindow> matchedWindows = w.windowsFor(timestamp);
         assertEquals(1, matchedWindows.size());
         assertEquals(new UnlimitedWindow(anyStartTime), matchedWindows.get(anyStartTime));
@@ -61,7 +73,7 @@ public void shouldIncludeRecordsThatHappenedAfterWindowStart() {
     @Test
     public void shouldExcludeRecordsThatHappenedBeforeWindowStart() {
         UnlimitedWindows w = UnlimitedWindows.of().startOn(anyStartTime);
-        long timestamp = w.start - 1;
+        long timestamp = w.startMs - 1;
         Map<Long, UnlimitedWindow> matchedWindows = w.windowsFor(timestamp);
         assertTrue(matchedWindows.isEmpty());
     }
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/WindowTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/WindowTest.java
new file mode 100644
index 0000000000000..55c5c60d430a9
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/WindowTest.java
@@ -0,0 +1,85 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.kafka.streams.kstream;
+
+import org.junit.Test;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNotEquals;
+
+public class WindowTest {
+
+    static class TestWindow extends Window {
+        TestWindow(final long startMs, final long endMs) {
+            super(startMs, endMs);
+        }
+
+        @Override
+        public boolean overlap(final Window other) {
+            return false;
+        }
+    }
+
+    static class TestWindow2 extends  Window {
+        TestWindow2(final long startMs, final long endMs) {
+            super(startMs, endMs);
+        }
+
+        @Override
+        public boolean overlap(final Window other) {
+            return false;
+        }
+    }
+
+    private final TestWindow window = new TestWindow(5, 10);
+
+    @Test(expected = IllegalArgumentException.class)
+    public void shouldThrowIfStartIsNegative() {
+        new TestWindow(-1, 0);
+    }
+
+    @Test(expected = IllegalArgumentException.class)
+    public void shouldThrowIfEndIsSmallerThanStart() {
+        new TestWindow(1, 0);
+    }
+
+    @Test
+    public void shouldBeEqualIfStartAndEndSame() {
+        final TestWindow window2 = new TestWindow(window.startMs, window.endMs);
+
+        assertEquals(window, window);
+        assertEquals(window, window2);
+        assertEquals(window2, window);
+    }
+
+    @Test
+    public void shouldNotBeEqualIfStartOrEndIsDifferent() {
+        assertNotEquals(window, new TestWindow(0, window.endMs));
+        assertNotEquals(window, new TestWindow(7, window.endMs));
+        assertNotEquals(window, new TestWindow(window.startMs, 7));
+        assertNotEquals(window, new TestWindow(window.startMs, 15));
+        assertNotEquals(window, new TestWindow(7, 8));
+        assertNotEquals(window, new TestWindow(0, 15));
+    }
+
+    @Test
+    public void shouldNotBeEqualIfDifferentWindowType() {
+        assertNotEquals(window, new TestWindow2(window.startMs, window.endMs));
+    }
+}
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/WindowsTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/WindowsTest.java
new file mode 100644
index 0000000000000..890265f917776
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/WindowsTest.java
@@ -0,0 +1,62 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.kafka.streams.kstream;
+
+import org.junit.Test;
+
+import java.util.Map;
+
+import static org.junit.Assert.assertEquals;
+
+public class WindowsTest {
+
+    private class TestWindows extends Windows {
+
+        @Override
+        public Map windowsFor(long timestamp) {
+            return null;
+        }
+
+        @Override
+        public long size() {
+            return 0;
+        }
+    }
+
+    @Test
+    public void shouldSetNumberOfSegments() {
+        final int anySegmentSizeLargerThanOne = 5;
+        assertEquals(anySegmentSizeLargerThanOne, new TestWindows().segments(anySegmentSizeLargerThanOne).segments);
+    }
+
+    @Test
+    public void shouldSetWindowRetentionTime() {
+        final int anyNotNegativeRetentionTime = 42;
+        assertEquals(anyNotNegativeRetentionTime, new TestWindows().until(anyNotNegativeRetentionTime).maintainMs());
+    }
+
+    @Test(expected = IllegalArgumentException.class)
+    public void numberOfSegmentsMustBeAtLeastTwo() {
+        new TestWindows().segments(1);
+    }
+
+    @Test(expected = IllegalArgumentException.class)
+    public void retentionTimeMustNotBeNegative() {
+        new TestWindows().until(-1);
+    }
+
+}
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/TimeWindowTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/TimeWindowTest.java
new file mode 100644
index 0000000000000..efa20b8be7464
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/TimeWindowTest.java
@@ -0,0 +1,122 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.kafka.streams.kstream.internals;
+
+import org.junit.Test;
+
+import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertTrue;
+
+public class TimeWindowTest {
+
+    private long start = 50;
+    private long end = 100;
+    private final TimeWindow window = new TimeWindow(start, end);
+    private final SessionWindow sessionWindow = new SessionWindow(start, end);
+
+    @Test(expected = IllegalArgumentException.class)
+    public void endMustBeLargerThanStart() {
+        new TimeWindow(start, start);
+    }
+
+    @Test
+    public void shouldNotOverlapIfOtherWindowIsBeforeThisWindow() {
+        /*
+         * This:        [-------)
+         * Other: [-----)
+         */
+        assertFalse(window.overlap(new TimeWindow(0, 25)));
+        assertFalse(window.overlap(new TimeWindow(0, start - 1)));
+        assertFalse(window.overlap(new TimeWindow(0, start)));
+    }
+
+    @Test
+    public void shouldOverlapIfOtherWindowEndIsWithinThisWindow() {
+        /*
+         * This:        [-------)
+         * Other: [---------)
+         */
+        assertTrue(window.overlap(new TimeWindow(0, start + 1)));
+        assertTrue(window.overlap(new TimeWindow(0, 75)));
+        assertTrue(window.overlap(new TimeWindow(0, end - 1)));
+
+        assertTrue(window.overlap(new TimeWindow(start - 1, start + 1)));
+        assertTrue(window.overlap(new TimeWindow(start - 1, 75)));
+        assertTrue(window.overlap(new TimeWindow(start - 1, end - 1)));
+    }
+
+    @Test
+    public void shouldOverlapIfOtherWindowContainsThisWindow() {
+        /*
+         * This:        [-------)
+         * Other: [------------------)
+         */
+        assertTrue(window.overlap(new TimeWindow(0, end)));
+        assertTrue(window.overlap(new TimeWindow(0, end + 1)));
+        assertTrue(window.overlap(new TimeWindow(0, 150)));
+
+        assertTrue(window.overlap(new TimeWindow(start - 1, end)));
+        assertTrue(window.overlap(new TimeWindow(start - 1, end + 1)));
+        assertTrue(window.overlap(new TimeWindow(start - 1, 150)));
+
+        assertTrue(window.overlap(new TimeWindow(start, end)));
+        assertTrue(window.overlap(new TimeWindow(start, end + 1)));
+        assertTrue(window.overlap(new TimeWindow(start, 150)));
+    }
+
+    @Test
+    public void shouldOverlapIfOtherWindowIsWithinThisWindow() {
+        /*
+         * This:        [-------)
+         * Other:         [---)
+         */
+        assertTrue(window.overlap(new TimeWindow(start, 75)));
+        assertTrue(window.overlap(new TimeWindow(start, end)));
+        assertTrue(window.overlap(new TimeWindow(75, end)));
+    }
+
+    @Test
+    public void shouldOverlapIfOtherWindowStartIsWithinThisWindow() {
+        /*
+         * This:        [-------)
+         * Other:           [-------)
+         */
+        assertTrue(window.overlap(new TimeWindow(start, end + 1)));
+        assertTrue(window.overlap(new TimeWindow(start, 150)));
+        assertTrue(window.overlap(new TimeWindow(75, end + 1)));
+        assertTrue(window.overlap(new TimeWindow(75, 150)));
+    }
+
+    @Test
+    public void shouldNotOverlapIsOtherWindowIsAfterThisWindow() {
+        /*
+         * This:        [-------)
+         * Other:               [------)
+         */
+        assertFalse(window.overlap(new TimeWindow(end, end + 1)));
+        assertFalse(window.overlap(new TimeWindow(end, 150)));
+        assertFalse(window.overlap(new TimeWindow(end + 1, 150)));
+        assertFalse(window.overlap(new TimeWindow(125, 150)));
+    }
+
+    @Test(expected = IllegalArgumentException.class)
+    public void cannotCompareTimeWindowWithDifferentWindowType() {
+        window.overlap(sessionWindow);
+    }
+}
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/UnlimitedWindowTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/UnlimitedWindowTest.java
new file mode 100644
index 0000000000000..f3c9cfbff89c9
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/UnlimitedWindowTest.java
@@ -0,0 +1,42 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.kafka.streams.kstream.internals;
+
+import org.junit.Test;
+
+import static org.junit.Assert.assertTrue;
+
+public class UnlimitedWindowTest {
+
+    private long start = 50;
+    private final UnlimitedWindow window = new UnlimitedWindow(start);
+    private final SessionWindow sessionWindow = new SessionWindow(start, start);
+
+    @Test
+    public void shouldAlwaysOverlap() {
+        assertTrue(window.overlap(new UnlimitedWindow(start - 1)));
+        assertTrue(window.overlap(new UnlimitedWindow(start)));
+        assertTrue(window.overlap(new UnlimitedWindow(start + 1)));
+    }
+
+    @Test(expected = IllegalArgumentException.class)
+    public void cannotCompareUnlimitedWindowWithDifferentWindowType() {
+        window.overlap(sessionWindow);
+    }
+}
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/WindowedStreamPartitionerTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/WindowedStreamPartitionerTest.java
index 4be83bebf2566..0b6288fb4d4dd 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/WindowedStreamPartitionerTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/WindowedStreamPartitionerTest.java
@@ -81,7 +81,7 @@ public void testCopartitioning() {
 
             Integer expected = defaultPartitioner.partition("topic", key, keyBytes, value, valueBytes, cluster);
 
-            for (int w = 0; w < 10; w++) {
+            for (int w = 1; w < 10; w++) {
                 TimeWindow window = new TimeWindow(10 * w, 20 * w);
 
                 Windowed<Integer> windowedKey = new Windowed<>(key, window);
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/CompositeReadOnlySessionStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/CompositeReadOnlySessionStoreTest.java
index 8bfcb7bfb49d5..51b3bf0a4b5e6 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/CompositeReadOnlySessionStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/CompositeReadOnlySessionStoreTest.java
@@ -20,7 +20,7 @@
 import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.errors.InvalidStateStoreException;
 import org.apache.kafka.streams.kstream.Windowed;
-import org.apache.kafka.streams.kstream.internals.TimeWindow;
+import org.apache.kafka.streams.kstream.internals.SessionWindow;
 import org.apache.kafka.streams.state.KeyValueIterator;
 import org.apache.kafka.streams.state.QueryableStoreTypes;
 import org.apache.kafka.test.ReadOnlySessionStoreStub;
@@ -58,12 +58,12 @@ public void before() {
 
     @Test
     public void shouldFetchResulstFromUnderlyingSessionStore() throws Exception {
-        underlyingSessionStore.put(new Windowed<>("a", new TimeWindow(0, 0)), 1L);
-        underlyingSessionStore.put(new Windowed<>("a", new TimeWindow(10, 10)), 2L);
+        underlyingSessionStore.put(new Windowed<>("a", new SessionWindow(0, 0)), 1L);
+        underlyingSessionStore.put(new Windowed<>("a", new SessionWindow(10, 10)), 2L);
 
         final List<KeyValue<Windowed<String>, Long>> results = toList(sessionStore.fetch("a"));
-        assertEquals(Arrays.asList(KeyValue.pair(new Windowed<>("a", new TimeWindow(0, 0)), 1L),
-                                   KeyValue.pair(new Windowed<>("a", new TimeWindow(10, 10)), 2L)),
+        assertEquals(Arrays.asList(KeyValue.pair(new Windowed<>("a", new SessionWindow(0, 0)), 1L),
+                                   KeyValue.pair(new Windowed<>("a", new SessionWindow(10, 10)), 2L)),
                      results);
     }
 
@@ -79,8 +79,8 @@ public void shouldFindValueForKeyWhenMultiStores() throws Exception {
                 ReadOnlySessionStoreStub<>();
         stubProviderTwo.addStore(storeName, secondUnderlying);
 
-        final Windowed<String> keyOne = new Windowed<>("key-one", new TimeWindow(0, 0));
-        final Windowed<String> keyTwo = new Windowed<>("key-two", new TimeWindow(0, 0));
+        final Windowed<String> keyOne = new Windowed<>("key-one", new SessionWindow(0, 0));
+        final Windowed<String> keyTwo = new Windowed<>("key-two", new SessionWindow(0, 0));
         underlyingSessionStore.put(keyOne, 0L);
         secondUnderlying.put(keyTwo, 10L);
 
@@ -93,8 +93,8 @@ public void shouldFindValueForKeyWhenMultiStores() throws Exception {
 
     @Test
     public void shouldNotGetValueFromOtherStores() throws Exception {
-        final Windowed<String> expectedKey = new Windowed<>("foo", new TimeWindow(0, 0));
-        otherUnderlyingStore.put(new Windowed<>("foo", new TimeWindow(10, 10)), 10L);
+        final Windowed<String> expectedKey = new Windowed<>("foo", new SessionWindow(0, 0));
+        otherUnderlyingStore.put(new Windowed<>("foo", new SessionWindow(10, 10)), 10L);
         underlyingSessionStore.put(expectedKey, 1L);
 
         final KeyValueIterator<Windowed<String>, Long> result = sessionStore.fetch("foo");

From 928f69ce883c8e30050d2e6f5e72e77e6740bdb9 Mon Sep 17 00:00:00 2001
From: huxi <huxi@zhenrongbao.com>
Date: Tue, 24 Jan 2017 10:04:42 +0000
Subject: [PATCH 029/177] KAFKA-4576; Log segments close to max size break on
 fetch

`FileChannel.read` may not fill the destination buffer even if there
are enough bytes in the channel to do so. Add a couple of utility
methods that ensure this and use them from all the relevant places.

Author: huxi <huxi@zhenrongbao.com>
Author: amethystic <huxi_2b@hotmail.com>
Author: Ismael Juma <ismael@juma.me.uk>

Reviewers: Jun Rao <junrao@gmail.com>, Jason Gustafson <jason@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2304 from amethystic/kafka4576_FileChannel_read

(cherry picked from commit 337f576f5979bf8924c5707b338cf4d3c76a53fd)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../common/record/FileLogInputStream.java     |  13 +-
 .../kafka/common/record/FileRecords.java      |   9 +-
 .../org/apache/kafka/common/utils/Utils.java  |  52 +++++++
 .../apache/kafka/common/utils/UtilsTest.java  | 140 +++++++++++++++++-
 4 files changed, 201 insertions(+), 13 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/common/record/FileLogInputStream.java b/clients/src/main/java/org/apache/kafka/common/record/FileLogInputStream.java
index ae393b03c0d62..dd9cc84dfb253 100644
--- a/clients/src/main/java/org/apache/kafka/common/record/FileLogInputStream.java
+++ b/clients/src/main/java/org/apache/kafka/common/record/FileLogInputStream.java
@@ -18,6 +18,7 @@
 
 import org.apache.kafka.common.KafkaException;
 import org.apache.kafka.common.errors.CorruptRecordException;
+import org.apache.kafka.common.utils.Utils;
 
 import java.io.IOException;
 import java.nio.ByteBuffer;
@@ -56,9 +57,7 @@ public FileChannelLogEntry nextEntry() throws IOException {
             return null;
 
         logHeaderBuffer.rewind();
-        channel.read(logHeaderBuffer, position);
-        if (logHeaderBuffer.hasRemaining())
-            return null;
+        Utils.readFullyOrFail(channel, logHeaderBuffer, position, "log header");
 
         logHeaderBuffer.rewind();
         long offset = logHeaderBuffer.getLong();
@@ -117,9 +116,7 @@ public byte magic() {
             try {
                 byte[] magic = new byte[1];
                 ByteBuffer buf = ByteBuffer.wrap(magic);
-                channel.read(buf, position + Records.LOG_OVERHEAD + Record.MAGIC_OFFSET);
-                if (buf.hasRemaining())
-                    throw new KafkaException("Failed to read magic byte from FileChannel " + channel);
+                Utils.readFullyOrFail(channel, buf, position + Records.LOG_OVERHEAD + Record.MAGIC_OFFSET, "magic byte");
                 return magic[0];
             } catch (IOException e) {
                 throw new KafkaException(e);
@@ -136,9 +133,7 @@ private Record loadRecord() throws IOException {
                 return record;
 
             ByteBuffer recordBuffer = ByteBuffer.allocate(recordSize);
-            channel.read(recordBuffer, position + Records.LOG_OVERHEAD);
-            if (recordBuffer.hasRemaining())
-                throw new IOException("Failed to read full record from channel " + channel);
+            Utils.readFullyOrFail(channel, recordBuffer, position + Records.LOG_OVERHEAD, "full record");
 
             recordBuffer.rewind();
             record = new Record(recordBuffer);
diff --git a/clients/src/main/java/org/apache/kafka/common/record/FileRecords.java b/clients/src/main/java/org/apache/kafka/common/record/FileRecords.java
index 8a33dcaaef828..960b7168ff70f 100644
--- a/clients/src/main/java/org/apache/kafka/common/record/FileRecords.java
+++ b/clients/src/main/java/org/apache/kafka/common/record/FileRecords.java
@@ -108,14 +108,17 @@ public FileChannel channel() {
     }
 
     /**
-     * Read log entries into a given buffer.
+     * Read log entries into the given buffer until there are no bytes remaining in the buffer or the end of the file
+     * is reached.
+     *
      * @param buffer The buffer to write the entries to
      * @param position Position in the buffer to read from
      * @return The same buffer
-     * @throws IOException
+     * @throws IOException If an I/O error occurs, see {@link FileChannel#read(ByteBuffer, long)} for details on the
+     * possible exceptions
      */
     public ByteBuffer readInto(ByteBuffer buffer, int position) throws IOException {
-        channel.read(buffer, position + this.start);
+        Utils.readFully(channel, buffer, position + this.start);
         buffer.flip();
         return buffer;
     }
diff --git a/clients/src/main/java/org/apache/kafka/common/utils/Utils.java b/clients/src/main/java/org/apache/kafka/common/utils/Utils.java
index ac8d0786d7bc4..afa85bd23e9b2 100755
--- a/clients/src/main/java/org/apache/kafka/common/utils/Utils.java
+++ b/clients/src/main/java/org/apache/kafka/common/utils/Utils.java
@@ -12,6 +12,7 @@
  */
 package org.apache.kafka.common.utils;
 
+import java.io.EOFException;
 import java.io.IOException;
 import java.io.InputStream;
 import java.io.Closeable;
@@ -803,4 +804,55 @@ public static long computeChecksum(ByteBuffer buffer, int start, int size) {
         return Crc32.crc32(buffer.array(), buffer.arrayOffset() + start, size);
     }
 
+    /**
+     * Read data from the channel to the given byte buffer until there are no bytes remaining in the buffer. If the end
+     * of the file is reached while there are bytes remaining in the buffer, an EOFException is thrown.
+     *
+     * @param channel File channel containing the data to read from
+     * @param destinationBuffer The buffer into which bytes are to be transferred
+     * @param position The file position at which the transfer is to begin; it must be non-negative
+     * @param description A description of what is being read, this will be included in the EOFException if it is thrown
+     *
+     * @throws IllegalArgumentException If position is negative
+     * @throws EOFException If the end of the file is reached while there are remaining bytes in the destination buffer
+     * @throws IOException If an I/O error occurs, see {@link FileChannel#read(ByteBuffer, long)} for details on the
+     * possible exceptions
+     */
+    public static void readFullyOrFail(FileChannel channel, ByteBuffer destinationBuffer, long position,
+                                       String description) throws IOException {
+        if (position < 0) {
+            throw new IllegalArgumentException("The file channel position cannot be negative, but it is " + position);
+        }
+        int expectedReadBytes = destinationBuffer.remaining();
+        readFully(channel, destinationBuffer, position);
+        if (destinationBuffer.hasRemaining()) {
+            throw new EOFException(String.format("Failed to read `%s` from file channel `%s`. Expected to read %d bytes, " +
+                    "but reached end of file after reading %d bytes. Started read from position %d.",
+                    description, channel, expectedReadBytes, expectedReadBytes - destinationBuffer.remaining(), position));
+        }
+    }
+
+    /**
+     * Read data from the channel to the given byte buffer until there are no bytes remaining in the buffer or the end
+     * of the file has been reached.
+     *
+     * @param channel File channel containing the data to read from
+     * @param destinationBuffer The buffer into which bytes are to be transferred
+     * @param position The file position at which the transfer is to begin; it must be non-negative
+     *
+     * @throws IllegalArgumentException If position is negative
+     * @throws IOException If an I/O error occurs, see {@link FileChannel#read(ByteBuffer, long)} for details on the
+     * possible exceptions
+     */
+    public static void readFully(FileChannel channel, ByteBuffer destinationBuffer, long position) throws IOException {
+        if (position < 0) {
+            throw new IllegalArgumentException("The file channel position cannot be negative, but it is " + position);
+        }
+        long currentPosition = position;
+        int bytesRead;
+        do {
+            bytesRead = channel.read(destinationBuffer, currentPosition);
+            currentPosition += bytesRead;
+        } while (bytesRead != -1 && destinationBuffer.hasRemaining());
+    }
 }
diff --git a/clients/src/test/java/org/apache/kafka/common/utils/UtilsTest.java b/clients/src/test/java/org/apache/kafka/common/utils/UtilsTest.java
index 46400b4a63474..194cad6807422 100755
--- a/clients/src/test/java/org/apache/kafka/common/utils/UtilsTest.java
+++ b/clients/src/test/java/org/apache/kafka/common/utils/UtilsTest.java
@@ -16,18 +16,27 @@
  */
 package org.apache.kafka.common.utils;
 
+import java.io.EOFException;
+import java.nio.channels.FileChannel;
+import java.nio.file.StandardOpenOption;
 import java.util.Arrays;
 import java.util.Collections;
 import java.io.Closeable;
 import java.io.IOException;
 import java.nio.ByteBuffer;
+import java.util.Random;
 
+import org.apache.kafka.test.TestUtils;
+import org.easymock.EasyMock;
+import org.easymock.IAnswer;
 import org.junit.Test;
 
+
+import static org.apache.kafka.common.utils.Utils.formatAddress;
 import static org.apache.kafka.common.utils.Utils.getHost;
 import static org.apache.kafka.common.utils.Utils.getPort;
-import static org.apache.kafka.common.utils.Utils.formatAddress;
 import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertFalse;
 import static org.junit.Assert.assertTrue;
 import static org.junit.Assert.fail;
 
@@ -158,6 +167,135 @@ public void testCloseAll() {
         }
     }
 
+    @Test
+    public void testReadFullyOrFailWithRealFile() throws IOException {
+        try (FileChannel channel = FileChannel.open(TestUtils.tempFile().toPath(), StandardOpenOption.READ, StandardOpenOption.WRITE)) {
+            // prepare channel
+            String msg = "hello, world";
+            channel.write(ByteBuffer.wrap(msg.getBytes()), 0);
+            channel.force(true);
+            assertEquals("Message should be written to the file channel", channel.size(), msg.length());
+
+            ByteBuffer perfectBuffer = ByteBuffer.allocate(msg.length());
+            ByteBuffer smallBuffer = ByteBuffer.allocate(5);
+            ByteBuffer largeBuffer = ByteBuffer.allocate(msg.length() + 1);
+            // Scenario 1: test reading into a perfectly-sized buffer
+            Utils.readFullyOrFail(channel, perfectBuffer, 0, "perfect");
+            assertFalse("Buffer should be filled up", perfectBuffer.hasRemaining());
+            assertEquals("Buffer should be populated correctly", msg, new String(perfectBuffer.array()));
+            // Scenario 2: test reading into a smaller buffer
+            Utils.readFullyOrFail(channel, smallBuffer, 0, "small");
+            assertFalse("Buffer should be filled", smallBuffer.hasRemaining());
+            assertEquals("Buffer should be populated correctly", "hello", new String(smallBuffer.array()));
+            // Scenario 3: test reading starting from a non-zero position
+            smallBuffer.clear();
+            Utils.readFullyOrFail(channel, smallBuffer, 7, "small");
+            assertFalse("Buffer should be filled", smallBuffer.hasRemaining());
+            assertEquals("Buffer should be populated correctly", "world", new String(smallBuffer.array()));
+            // Scenario 4: test end of stream is reached before buffer is filled up
+            try {
+                Utils.readFullyOrFail(channel, largeBuffer, 0, "large");
+                fail("Expected EOFException to be raised");
+            } catch (EOFException e) {
+                // expected
+            }
+        }
+    }
+
+    /**
+     * Tests that `readFullyOrFail` behaves correctly if multiple `FileChannel.read` operations are required to fill
+     * the destination buffer.
+     */
+    @Test
+    public void testReadFullyOrFailWithPartialFileChannelReads() throws IOException {
+        FileChannel channelMock = EasyMock.createMock(FileChannel.class);
+        final int bufferSize = 100;
+        ByteBuffer buffer = ByteBuffer.allocate(bufferSize);
+        StringBuilder expectedBufferContent = new StringBuilder();
+        fileChannelMockExpectReadWithRandomBytes(channelMock, expectedBufferContent, bufferSize);
+        EasyMock.replay(channelMock);
+        Utils.readFullyOrFail(channelMock, buffer, 0L, "test");
+        assertEquals("The buffer should be populated correctly", expectedBufferContent.toString(),
+                new String(buffer.array()));
+        assertFalse("The buffer should be filled", buffer.hasRemaining());
+        EasyMock.verify(channelMock);
+    }
+
+    /**
+     * Tests that `readFullyOrFail` behaves correctly if multiple `FileChannel.read` operations are required to fill
+     * the destination buffer.
+     */
+    @Test
+    public void testReadFullyWithPartialFileChannelReads() throws IOException {
+        FileChannel channelMock = EasyMock.createMock(FileChannel.class);
+        final int bufferSize = 100;
+        StringBuilder expectedBufferContent = new StringBuilder();
+        fileChannelMockExpectReadWithRandomBytes(channelMock, expectedBufferContent, bufferSize);
+        EasyMock.replay(channelMock);
+        ByteBuffer buffer = ByteBuffer.allocate(bufferSize);
+        Utils.readFully(channelMock, buffer, 0L);
+        assertEquals("The buffer should be populated correctly.", expectedBufferContent.toString(),
+                new String(buffer.array()));
+        assertFalse("The buffer should be filled", buffer.hasRemaining());
+        EasyMock.verify(channelMock);
+    }
+
+    @Test
+    public void testReadFullyIfEofIsReached() throws IOException {
+        final FileChannel channelMock = EasyMock.createMock(FileChannel.class);
+        final int bufferSize = 100;
+        final String fileChannelContent = "abcdefghkl";
+        ByteBuffer buffer = ByteBuffer.allocate(bufferSize);
+        EasyMock.expect(channelMock.size()).andReturn((long) fileChannelContent.length());
+        EasyMock.expect(channelMock.read(EasyMock.anyObject(ByteBuffer.class), EasyMock.anyInt())).andAnswer(new IAnswer<Integer>() {
+            @Override
+            public Integer answer() throws Throwable {
+                ByteBuffer buffer = (ByteBuffer) EasyMock.getCurrentArguments()[0];
+                buffer.put(fileChannelContent.getBytes());
+                return -1;
+            }
+        });
+        EasyMock.replay(channelMock);
+        Utils.readFully(channelMock, buffer, 0L);
+        assertEquals("abcdefghkl", new String(buffer.array(), 0, buffer.position()));
+        assertEquals(buffer.position(), channelMock.size());
+        assertTrue(buffer.hasRemaining());
+        EasyMock.verify(channelMock);
+    }
+
+    /**
+     * Expectation setter for multiple reads where each one reads random bytes to the buffer.
+     *
+     * @param channelMock           The mocked FileChannel object
+     * @param expectedBufferContent buffer that will be updated to contain the expected buffer content after each
+     *                              `FileChannel.read` invocation
+     * @param bufferSize            The buffer size
+     * @throws IOException          If an I/O error occurs
+     */
+    private void fileChannelMockExpectReadWithRandomBytes(final FileChannel channelMock,
+                                                          final StringBuilder expectedBufferContent,
+                                                          final int bufferSize) throws IOException {
+        final int step = 20;
+        final Random random = new Random();
+        int remainingBytes = bufferSize;
+        while (remainingBytes > 0) {
+            final int mockedBytesRead = remainingBytes < step ? remainingBytes : random.nextInt(step);
+            final StringBuilder sb = new StringBuilder();
+            EasyMock.expect(channelMock.read(EasyMock.anyObject(ByteBuffer.class), EasyMock.anyInt())).andAnswer(new IAnswer<Integer>() {
+                @Override
+                public Integer answer() throws Throwable {
+                    ByteBuffer buffer = (ByteBuffer) EasyMock.getCurrentArguments()[0];
+                    for (int i = 0; i < mockedBytesRead; i++)
+                        sb.append("a");
+                    buffer.put(sb.toString().getBytes());
+                    expectedBufferContent.append(sb);
+                    return mockedBytesRead;
+                }
+            });
+            remainingBytes -= mockedBytesRead;
+        }
+    }
+
     private static class TestCloseable implements Closeable {
         private final int id;
         private final IOException closeException;

From b676f51dd54125b950fee35fe867057778866bcb Mon Sep 17 00:00:00 2001
From: "Colin P. Mccabe" <cmccabe@confluent.io>
Date: Tue, 24 Jan 2017 11:09:47 +0000
Subject: [PATCH 030/177] KAFKA-4688; Kafka 0.10.1.1 should be available in
 system tests

Author: Colin P. Mccabe <cmccabe@confluent.io>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2424 from cmccabe/KAFKA-4688

(cherry picked from commit 567180605c0a8cf74b8d2cad52e2873c83065a95)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 tests/docker/Dockerfile    | 1 +
 tests/kafkatest/version.py | 3 ++-
 vagrant/base.sh            | 2 ++
 3 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/tests/docker/Dockerfile b/tests/docker/Dockerfile
index bdd6af612dd11..82e2e55f4320a 100644
--- a/tests/docker/Dockerfile
+++ b/tests/docker/Dockerfile
@@ -28,6 +28,7 @@ ENV MIRROR="http://apache.cs.utah.edu/"
 RUN wget -q "${MIRROR}kafka/0.8.2.2/kafka_2.10-0.8.2.2.tgz" -O "/tmp/kafka_2.10-0.8.2.2.tgz" && tar xfz /tmp/kafka_2.10-0.8.2.2.tgz -C /opt && mv "/opt/kafka_2.10-0.8.2.2" "/opt/kafka-0.8.2.2"
 RUN wget -q "${MIRROR}kafka/0.9.0.1/kafka_2.10-0.9.0.1.tgz" -O "/tmp/kafka_2.10-0.9.0.1.tgz" && tar xfz /tmp/kafka_2.10-0.9.0.1.tgz -C /opt && mv "/opt/kafka_2.10-0.9.0.1" "/opt/kafka-0.9.0.1"
 RUN wget -q "${MIRROR}kafka/0.10.0.1/kafka_2.10-0.10.0.1.tgz" -O "/tmp/kafka_2.10-0.10.0.1.tgz" && tar xfz /tmp/kafka_2.10-0.10.0.1.tgz -C /opt && mv "/opt/kafka_2.10-0.10.0.1" "/opt/kafka-0.10.0.1"
+RUN wget -q "${MIRROR}kafka/0.10.1.1/kafka_2.10-0.10.1.1.tgz" -O "/tmp/kafka_2.10-0.10.1.1.tgz" && tar xfz /tmp/kafka_2.10-0.10.1.1.tgz -C /opt && mv "/opt/kafka_2.10-0.10.1.1" "/opt/kafka-0.10.1.1"
 
 RUN rm /tmp/kafka_*.tgz
 ADD ssh /root/.ssh
diff --git a/tests/kafkatest/version.py b/tests/kafkatest/version.py
index 5dd09a1fa5150..cd361e836b49d 100644
--- a/tests/kafkatest/version.py
+++ b/tests/kafkatest/version.py
@@ -82,6 +82,7 @@ def get_version(node=None):
 
 # 0.10.1.x versions
 V_0_10_1_0 = KafkaVersion("0.10.1.0")
-LATEST_0_10_1 = V_0_10_1_0
+V_0_10_1_1 = KafkaVersion("0.10.1.1")
+LATEST_0_10_1 = V_0_10_1_1
 
 LATEST_0_10 = LATEST_0_10_1
diff --git a/vagrant/base.sh b/vagrant/base.sh
index 369776584a2fd..5f07cc3658b36 100755
--- a/vagrant/base.sh
+++ b/vagrant/base.sh
@@ -67,6 +67,8 @@ get_kafka 0.9.0.1
 chmod a+rw /opt/kafka-0.9.0.1
 get_kafka 0.10.0.1
 chmod a+rw /opt/kafka-0.10.0.1
+get_kafka 0.10.1.1
+chmod a+rw /opt/kafka-0.10.1.1
 
 
 # For EC2 nodes, we want to use /mnt, which should have the local disk. On local

From 90b9a8a3cc7f9443101f9f95c0acc87873453f68 Mon Sep 17 00:00:00 2001
From: Dana Powers <dana.powers@gmail.com>
Date: Tue, 24 Jan 2017 12:41:21 +0000
Subject: [PATCH 031/177] MINOR: Add expected Error Codes to ProduceResponse
 documentation

This is a documentation-only patch discussed on the mailing list. The
intent is to have these changes propagated to the protocol wiki
(https://cwiki.apache.org/confluence/display/KAFKA/A+Guide+To+The+Kafka+Protocol) .

Author: Dana Powers <dana.powers@gmail.com>

Reviewers: Grant Henke <granthenke@gmail.com>, Ismael Juma <ismael@juma.me.uk>

Closes #918 from dpkp/produce_response_errors

(cherry picked from commit 3bb0d3cd888c29a002400253d9ff84ce73ebc03c)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../apache/kafka/common/requests/ProduceResponse.java | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/clients/src/main/java/org/apache/kafka/common/requests/ProduceResponse.java b/clients/src/main/java/org/apache/kafka/common/requests/ProduceResponse.java
index 71e6ab5cfde24..6c2125a98db05 100644
--- a/clients/src/main/java/org/apache/kafka/common/requests/ProduceResponse.java
+++ b/clients/src/main/java/org/apache/kafka/common/requests/ProduceResponse.java
@@ -48,7 +48,16 @@ public class ProduceResponse extends AbstractResponse {
     /**
      * Possible error code:
      *
-     * TODO
+     * CORRUPT_MESSAGE (2)
+     * UNKNOWN_TOPIC_OR_PARTITION (3)
+     * NOT_LEADER_FOR_PARTITION (6)
+     * MESSAGE_TOO_LARGE (10)
+     * INVALID_TOPIC (17)
+     * RECORD_LIST_TOO_LARGE (18)
+     * NOT_ENOUGH_REPLICAS (19)
+     * NOT_ENOUGH_REPLICAS_AFTER_APPEND (20)
+     * INVALID_REQUIRED_ACKS (21)
+     * TOPIC_AUTHORIZATION_FAILED (29)
      */
 
     private static final String BASE_OFFSET_KEY_NAME = "base_offset";

From 740abdb7bf6dff841a09baf84f1bacd88401f50e Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Tue, 24 Jan 2017 11:02:34 -0800
Subject: [PATCH 032/177] MINOR: rework JavaDoc for windowing related public
 API

 - also some code refactoring and bug fixes

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Damian Guy, Eno Thereska, Guozhang Wang

Closes #2337 from mjsax/javaDocImprovements4

(cherry picked from commit b938c03b0aa7a0cebdaad0cbb22689cc719c6ebc)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../kafka/streams/kstream/JoinWindows.java    |  90 +++++++++++----
 .../kafka/streams/kstream/SessionWindows.java |  60 ++++++----
 .../kafka/streams/kstream/TimeWindows.java    | 107 +++++++++++-------
 .../streams/kstream/UnlimitedWindows.java     |  83 ++++++++++----
 .../apache/kafka/streams/kstream/Window.java  |  40 ++++---
 .../kafka/streams/kstream/Windowed.java       |  28 ++++-
 .../apache/kafka/streams/kstream/Windows.java |  61 ++++++----
 .../kstream/internals/SessionWindow.java      |  18 ++-
 .../streams/kstream/internals/TimeWindow.java |  37 +++++-
 .../kstream/internals/UnlimitedWindow.java    |  34 +++++-
 10 files changed, 403 insertions(+), 155 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java
index 6dd1a85f5340a..f20e39f6a4d29 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java
@@ -5,9 +5,9 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -17,20 +17,23 @@
 
 package org.apache.kafka.streams.kstream;
 
+import org.apache.kafka.common.annotation.InterfaceStability;
+
 import java.util.Map;
 
 /**
  * The window specifications used for joins.
  * <p>
- * A {@link JoinWindows} instance defines a join over two stream on the same key and a maximum time difference.
+ * A {@link JoinWindows} instance defines a maximum time difference for a {@link KStream#join(KStream, ValueJoiner,
+ * JoinWindows) join over two streams} on the same key.
  * In SQL-style you would express this join as
- * <pre>
+ * <pre>{@code
  *     SELECT * FROM stream1, stream2
  *     WHERE
  *       stream1.key = stream2.key
  *       AND
  *       stream1.ts - before <= stream2.ts AND stream2.ts <= stream1.ts + after
- * </pre>
+ * }</pre>
  * There are three different window configuration supported:
  * <ul>
  *     <li>before = after = time-difference</li>
@@ -40,9 +43,27 @@
  * A join is symmetric in the sense, that a join specification on the first stream returns the same result record as
  * a join specification on the second stream with flipped before and after values.
  * <p>
- * Both values (before and after) must not result in an "inverse" window,
- * i.e., lower-interval-bound must not be larger than upper-interval.bound.
+ * Both values (before and after) must not result in an "inverse" window, i.e., upper-interval bound cannot be smaller
+ * than lower-interval bound.
+ * <p>
+ * {@link JoinWindows} are sliding windows, thus, they are aligned to the actual record timestamps.
+ * This implies, that each input record defines its own window with start and end time being relative to the record's
+ * timestamp.
+ * <p>
+ * For time semantics, see {@link org.apache.kafka.streams.processor.TimestampExtractor TimestampExtractor}.
+ *
+ * @see TimeWindows
+ * @see UnlimitedWindows
+ * @see SessionWindows
+ * @see KStream#join(KStream, ValueJoiner, JoinWindows)
+ * @see KStream#join(KStream, ValueJoiner, JoinWindows, org.apache.kafka.common.serialization.Serde, org.apache.kafka.common.serialization.Serde, org.apache.kafka.common.serialization.Serde)
+ * @see KStream#leftJoin(KStream, ValueJoiner, JoinWindows)
+ * @see KStream#leftJoin(KStream, ValueJoiner, JoinWindows, org.apache.kafka.common.serialization.Serde, org.apache.kafka.common.serialization.Serde, org.apache.kafka.common.serialization.Serde)
+ * @see KStream#outerJoin(KStream, ValueJoiner, JoinWindows)
+ * @see KStream#outerJoin(KStream, ValueJoiner, JoinWindows)
+ * @see org.apache.kafka.streams.processor.TimestampExtractor
  */
+@InterfaceStability.Unstable
 public class JoinWindows extends Windows<Window> {
 
     /** Maximum time difference for tuples that are before the join tuple. */
@@ -52,50 +73,61 @@ public class JoinWindows extends Windows<Window> {
 
     private JoinWindows(final long beforeMs, final long afterMs) {
         if (beforeMs + afterMs < 0) {
-            throw new IllegalArgumentException("Window interval (ie, beforeMs+afterMs) must not be negative");
+            throw new IllegalArgumentException("Window interval (ie, beforeMs+afterMs) must not be negative.");
         }
         this.afterMs = afterMs;
         this.beforeMs = beforeMs;
     }
 
     /**
-     * Specifies that records of the same key are joinable if their timestamps are within {@code timeDifference}.
-     * ({@code timeDifference} must not be negative)
+     * Specifies that records of the same key are joinable if their timestamps are within {@code timeDifferenceMs},
+     * i.e., the timestamp of a record from the secondary stream is max {@code timeDifferenceMs} earlier or later than
+     * the timestamp of the record from the primary stream.
      *
-     * @param timeDifference    join window interval
+     * @param timeDifferenceMs join window interval in milliseconds
+     * @throws IllegalArgumentException if {@code timeDifferenceMs} is negative
      */
     public static JoinWindows of(final long timeDifferenceMs) throws IllegalArgumentException {
         return new JoinWindows(timeDifferenceMs, timeDifferenceMs);
     }
 
     /**
-     * Specifies that records of the same key are joinable if their timestamps are within
-     * the join window interval, and if the timestamp of a record from the secondary stream is
-     * earlier than or equal to the timestamp of a record from the first stream.
+     * Changes the start window boundary to {@code timeDifferenceMs} but keep the end window boundary as is.
+     * Thus, records of the same key are joinable if the timestamp of a record from the secondary stream is at most
+     * {@code timeDifferenceMs} earlier than the timestamp of the record from the primary stream.
+     * {@code timeDifferenceMs} can be negative but it's absolute value must not be larger than current window "after"
+     * value (which would result in a negative window size).
      *
-     * @param timeDifference    join window interval
+     * @param timeDifferenceMs relative window start time in milliseconds
+     * @throws IllegalArgumentException if the resulting window size is negative
      */
     public JoinWindows before(final long timeDifferenceMs) throws IllegalArgumentException {
         return new JoinWindows(timeDifferenceMs, afterMs);
     }
 
     /**
-     * Specifies that records of the same key are joinable if their timestamps are within
-     * the join window interval, and if the timestamp of a record from the secondary stream
-     * is later than or equal to the timestamp of a record from the first stream.
+     * Changes the end window boundary to {@code timeDifferenceMs} but keep the start window boundary as is.
+     * Thus, records of the same key are joinable if the timestamp of a record from the secondary stream is at most
+     * {@code timeDifferenceMs} later than the timestamp of the record from the primary stream.
+     * {@code timeDifferenceMs} can be negative but it's absolute value must not be larger than current window "before"
+     * value (which would result in a negative window size).
      *
-     * @param timeDifference    join window interval
+     * @param timeDifferenceMs relative window end time in milliseconds
+     * @throws IllegalArgumentException if the resulting window size is negative
      */
     public JoinWindows after(final long timeDifferenceMs) throws IllegalArgumentException {
         return new JoinWindows(beforeMs, timeDifferenceMs);
     }
 
     /**
-     * Not supported by {@link JoinWindows}. Throws {@link UnsupportedOperationException}.
+     * Not supported by {@link JoinWindows}.
+     * Throws {@link UnsupportedOperationException}.
+     *
+     * @throws UnsupportedOperationException at every invocation
      */
     @Override
     public Map<Long, Window> windowsFor(final long timestamp) {
-        throw new UnsupportedOperationException("windowsFor() is not supported in JoinWindows");
+        throw new UnsupportedOperationException("windowsFor() is not supported by JoinWindows.");
     }
 
     @Override
@@ -103,6 +135,13 @@ public long size() {
         return beforeMs + afterMs;
     }
 
+    /**
+     * {@inheritDoc}
+     *
+     * @param durationMs the window retention time in milliseconds
+     * @return itself
+     * @throws IllegalArgumentException if {@code durationMs} is smaller than the window size
+     */
     @Override
     public JoinWindows until(final long durationMs) throws IllegalArgumentException {
         if (durationMs < size()) {
@@ -112,6 +151,13 @@ public JoinWindows until(final long durationMs) throws IllegalArgumentException
         return this;
     }
 
+    /**
+     * {@inheritDoc}
+     * <p>
+     * For {@link TimeWindows} the maintain duration is at least as small as the window size.
+     *
+     * @return the window maintain duration
+     */
     @Override
     public long maintainMs() {
         return Math.max(super.maintainMs(), size());
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java
index bed6c3dd97125..8918f3e68bb8b 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java
@@ -16,18 +16,16 @@
  */
 package org.apache.kafka.streams.kstream;
 
-
 import org.apache.kafka.common.annotation.InterfaceStability;
 
 /**
  * A session based window specification used for aggregating events into sessions.
  * <p>
  * Sessions represent a period of activity separated by a defined gap of inactivity.
- * Any events processed that fall within the inactivity gap of any existing sessions
- * are merged into the existing sessions. If the event falls outside of the session gap
- * then a new session will be created.
+ * Any events processed that fall within the inactivity gap of any existing sessions are merged into the existing sessions.
+ * If the event falls outside of the session gap then a new session will be created.
  * <p>
- * For example, If we have a session gap of 5 and the following data arrives:
+ * For example, if we have a session gap of 5 and the following data arrives:
  * <pre>
  * +--------------------------------------+
  * |    key    |    value    |    time    |
@@ -39,13 +37,12 @@
  * |    A      |     3       |     20     |
  * +-----------+-------------+------------+
  * </pre>
- * <p>
- * We'd have 2 sessions for key A. 1 starting from time 10 and ending at time 12 and another
- * starting and ending at time 20. The length of the session is driven by the timestamps of
- * the data within the session
+ * We'd have 2 sessions for key A.
+ * One starting from time 10 and ending at time 12 and another starting and ending at time 20.
+ * The length of the session is driven by the timestamps of the data within the session.
+ * Thus, session windows are no fixed-size windows (c.f. {@link TimeWindows} and {@link JoinWindows}).
  * <p>
  * If we then received another record:
- * <p>
  * <pre>
  * +--------------------------------------+
  * |    key    |    value    |    time    |
@@ -53,9 +50,21 @@
  * |    A      |     4       |     16     |
  * +-----------+-------------+------------+
  * </pre>
- * <p>
  * The previous 2 sessions would be merged into a single session with start time 10 and end time 20.
  * The aggregate value for this session would be the result of aggregating all 4 values.
+ * <p>
+ * For time semantics, see {@link org.apache.kafka.streams.processor.TimestampExtractor TimestampExtractor}.
+ *
+ * @see TimeWindows
+ * @see UnlimitedWindows
+ * @see JoinWindows
+ * @see KGroupedStream#count(SessionWindows, String)
+ * @see KGroupedStream#count(SessionWindows, org.apache.kafka.streams.processor.StateStoreSupplier)
+ * @see KGroupedStream#reduce(Reducer, SessionWindows, String)
+ * @see KGroupedStream#reduce(Reducer, SessionWindows, org.apache.kafka.streams.processor.StateStoreSupplier)
+ * @see KGroupedStream#aggregate(Initializer, Aggregator, Merger, SessionWindows, org.apache.kafka.common.serialization.Serde, String)
+ * @see KGroupedStream#aggregate(Initializer, Aggregator, Merger, SessionWindows, org.apache.kafka.common.serialization.Serde, org.apache.kafka.streams.processor.StateStoreSupplier)
+ * @see org.apache.kafka.streams.processor.TimestampExtractor
  */
 @InterfaceStability.Unstable
 public class SessionWindows {
@@ -69,27 +78,30 @@ private SessionWindows(final long gapMs) {
     }
 
     /**
-     * Create a new SessionWindows with the specified inactivity gap
-     * @param inactivityGapMs  the gap of inactivity between sessions
-     * @return a new SessionWindows with the provided inactivity gap
-     * and default maintain duration
+     * Create a new window specification with the specified inactivity gap in milliseconds.
+     *
+     * @param inactivityGapMs the gap of inactivity between sessions in milliseconds
+     * @return a new window specification with default maintain duration of 1 day
+     *
+     * @throws IllegalArgumentException if {@code inactivityGapMs} is zero or negative
      */
     public static SessionWindows with(final long inactivityGapMs) {
-        if (inactivityGapMs < 1) {
+        if (inactivityGapMs <= 0) {
             throw new IllegalArgumentException("Gap time (inactivityGapMs) cannot be zero or negative.");
         }
         return new SessionWindows(inactivityGapMs);
     }
 
     /**
-     * Set the window maintain duration in milliseconds of streams time.
+     * Set the window maintain duration (retention time) in milliseconds.
      * This retention time is a guaranteed <i>lower bound</i> for how long a window will be maintained.
      *
-     * @return  itself
+     * @return itself
+     * @throws IllegalArgumentException if {@code durationMs} is smaller than window gap
      */
     public SessionWindows until(final long durationMs) throws IllegalArgumentException {
         if (durationMs < gapMs) {
-            throw new IllegalArgumentException("Window retentin time (durationMs) cannot be smaller than window gap.");
+            throw new IllegalArgumentException("Window retention time (durationMs) cannot be smaller than window gap.");
         }
         maintainDurationMs = durationMs;
 
@@ -97,14 +109,20 @@ public SessionWindows until(final long durationMs) throws IllegalArgumentExcepti
     }
 
     /**
-     * @return the inactivityGap
+     * Return the specified gap for the session windows in milliseconds.
+     *
+     * @return the inactivity gap of the specified windows
      */
     public long inactivityGap() {
         return gapMs;
     }
 
     /**
-     * @return the minimum amount of time a window will be maintained for.
+     * Return the window maintain duration (retention time) in milliseconds.
+     * <p>
+     * For {@link SessionWindows} the maintain duration is at least as small as the window gap.
+     *
+     * @return the window maintain duration
      */
     public long maintainMs() {
         return Math.max(maintainDurationMs, gapMs);
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java
index 11df22823c6aa..87e7f2efc30d6 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java
@@ -5,9 +5,9 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -17,79 +17,94 @@
 
 package org.apache.kafka.streams.kstream;
 
+import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.streams.kstream.internals.TimeWindow;
 
 import java.util.HashMap;
 import java.util.Map;
 
 /**
- * The time-based window specifications used for aggregations.
+ * The fixed-size time-based window specifications used for aggregations.
  * <p>
- * The semantics of a time-based window are: Every T1 (advance) time-units, compute the aggregate total for T2 (size) time-units.
+ * The semantics of time-based aggregation windows are: Every T1 (advance) milliseconds, compute the aggregate total for
+ * T2 (size) milliseconds.
  * <ul>
- *     <li> If {@code advance < size} a hopping windows is defined: <br />
- *          it discretize a stream into overlapping windows, which implies that a record maybe contained in one and or more "adjacent" windows.</li>
+ *     <li> If {@code advance < size} a hopping windows is defined:<br />
+ *          it discretize a stream into overlapping windows, which implies that a record maybe contained in one and or
+ *          more "adjacent" windows.</li>
  *     <li> If {@code advance == size} a tumbling window is defined:<br />
- *          it discretize a stream into non-overlapping windows, which implies that a record is only ever contained in one and only one tumbling window.</li>
+ *          it discretize a stream into non-overlapping windows, which implies that a record is only ever contained in
+ *          one and only one tumbling window.</li>
  * </ul>
+ * Thus, the specified {@link TimeWindow}s are aligned to the epoch.
+ * Aligned to the epoch means, that the first window starts at timestamp zero.
+ * For example, hopping windows with size of 5000ms and advance of 3000ms, have window boundaries
+ * [0;5000),[3000;8000),... and not [1000;6000),[4000;9000),... or even something "random" like [1452;6452),[4452;9452),...
+ * <p>
+ * For time semantics, see {@link org.apache.kafka.streams.processor.TimestampExtractor TimestampExtractor}.
+ *
+ * @see SessionWindows
+ * @see UnlimitedWindows
+ * @see JoinWindows
+ * @see KGroupedStream#count(Windows, String)
+ * @see KGroupedStream#count(Windows, org.apache.kafka.streams.processor.StateStoreSupplier)
+ * @see KGroupedStream#reduce(Reducer, Windows, String)
+ * @see KGroupedStream#reduce(Reducer, Windows, org.apache.kafka.streams.processor.StateStoreSupplier)
+ * @see KGroupedStream#aggregate(Initializer, Aggregator, Windows, org.apache.kafka.common.serialization.Serde, String)
+ * @see KGroupedStream#aggregate(Initializer, Aggregator, Windows, org.apache.kafka.streams.processor.StateStoreSupplier)
+ * @see org.apache.kafka.streams.processor.TimestampExtractor
  */
+@InterfaceStability.Unstable
 public class TimeWindows extends Windows<TimeWindow> {
 
-    /**
-     * The size of the window, i.e. how long a window lasts.
-     * The window size's effective time unit is determined by the semantics of the topology's
-     * configured {@link org.apache.kafka.streams.processor.TimestampExtractor}.
-     */
+    /** The size of the windows in milliseconds. */
     public final long sizeMs;
 
     /**
-     * The size of the window's advance interval, i.e. by how much a window moves forward relative
-     * to the previous one. The interval's effective time unit is determined by the semantics of
-     * the topology's configured {@link org.apache.kafka.streams.processor.TimestampExtractor}.
+     * The size of the window's advance interval in milliseconds, i.e., by how much a window moves forward relative to
+     * the previous one.
      */
     public final long advanceMs;
 
-    private TimeWindows(final long sizeMs, final long advanceMs) throws IllegalArgumentException {
+    private TimeWindows(final long sizeMs, final long advanceMs) {
         this.sizeMs = sizeMs;
         this.advanceMs = advanceMs;
     }
 
     /**
-     * Returns a window definition with the given window size, and with the advance interval being
-     * equal to the window size. Think: [N * size, N * size + size), with N denoting the N-th
-     * window.
+     * Return a window definition with the given window size, and with the advance interval being equal to the window
+     * size.
+     * The time interval represented by the the N-th window is: {@code [N * size, N * size + size)}.
+     * <p>
+     * This provides the semantics of tumbling windows, which are fixed-sized, gap-less, non-overlapping windows.
+     * Tumbling windows are a special case of hopping windows with {@code advance == size}.
      *
-     * This provides the semantics of tumbling windows, which are fixed-sized, gap-less,
-     * non-overlapping windows. Tumbling windows are a specialization of hopping windows.
-     *
-     * @param size The size of the window, with the requirement that size &gt; 0.
-     *             The window size's effective time unit is determined by the semantics of the
-     *             topology's configured {@link org.apache.kafka.streams.processor.TimestampExtractor}.
-     * @return a new window definition
+     * @param sizeMs The size of the window in milliseconds
+     * @return a new window definition with default maintain duration of 1 day
+     * @throws IllegalArgumentException if the specified window size is zero or negative
      */
     public static TimeWindows of(final long sizeMs) throws IllegalArgumentException {
         if (sizeMs <= 0) {
-            throw new IllegalArgumentException("Window sizeMs must be larger than zero.");
+            throw new IllegalArgumentException("Window size (sizeMs) must be larger than zero.");
         }
         return new TimeWindows(sizeMs, sizeMs);
     }
 
     /**
-     * Returns a window definition with the original size, but advance ("hop") the window by the given
-     * interval, which specifies by how much a window moves forward relative to the previous one.
-     * Think: [N * advanceInterval, N * advanceInterval + size), with N denoting the N-th window.
-     *
+     * Return a window definition with the original size, but advance ("hop") the window by the given interval, which
+     * specifies by how much a window moves forward relative to the previous one.
+     * The time interval represented by the the N-th window is: {@code [N * advance, N * advance + size)}.
+     * <p>
      * This provides the semantics of hopping windows, which are fixed-sized, overlapping windows.
      *
-     * @param interval The advance interval ("hop") of the window, with the requirement that
-     *                 0 &lt; interval &le; size. The interval's effective time unit is
-     *                 determined by the semantics of the topology's configured
-     *                 {@link org.apache.kafka.streams.processor.TimestampExtractor}.
-     * @return a new window definition
+     * @param advanceMs The advance interval ("hop") in milliseconds of the window, with the requirement that
+     *                  {@code 0 < advanceMs &le; sizeMs}.
+     * @return a new window definition with default maintain duration of 1 day
+     * @throws IllegalArgumentException if the advance interval is negative, zero, or larger-or-equal the window size
      */
     public TimeWindows advanceBy(final long advanceMs) {
         if (advanceMs <= 0 || advanceMs > sizeMs) {
-            throw new IllegalArgumentException(String.format("AdvanceMs must lie within interval (0, %d]", sizeMs));
+            throw new IllegalArgumentException(String.format("AdvanceMs must lie within interval (0, %d].", sizeMs));
         }
         return new TimeWindows(sizeMs, advanceMs);
     }
@@ -111,6 +126,13 @@ public long size() {
         return sizeMs;
     }
 
+    /**
+     * {@inheritDoc}
+     *
+     * @param durationMs the window retention time
+     * @return itself
+     * @throws IllegalArgumentException if {@code duration} is smaller than the window size
+     */
     public TimeWindows until(final long durationMs) throws IllegalArgumentException {
         if (durationMs < sizeMs) {
             throw new IllegalArgumentException("Window retention time (durationMs) cannot be smaller than the window size.");
@@ -119,6 +141,13 @@ public TimeWindows until(final long durationMs) throws IllegalArgumentException
         return this;
     }
 
+    /**
+     * {@inheritDoc}
+     * <p>
+     * For {@link TimeWindows} the maintain duration is at least as small as the window size.
+     *
+     * @return the window maintain duration
+     */
     @Override
     public long maintainMs() {
         return Math.max(super.maintainMs(), sizeMs);
@@ -143,4 +172,4 @@ public int hashCode() {
         return result;
     }
 
-}
\ No newline at end of file
+}
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java
index 8605f9d6bf26b..9d5669ceae85d 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java
@@ -5,9 +5,9 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -17,14 +17,33 @@
 
 package org.apache.kafka.streams.kstream;
 
+import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.streams.kstream.internals.UnlimitedWindow;
 
 import java.util.HashMap;
 import java.util.Map;
 
 /**
- * The unlimited window specifications.
+ * The unlimited window specifications used for aggregations.
+ * <p>
+ * An unlimited time window is also called landmark window.
+ * It has a fixed starting point while its window end is defined as infinite.
+ * With this regard, it is a fixed-size window with infinite window size.
+ * <p>
+ * For time semantics, see {@link org.apache.kafka.streams.processor.TimestampExtractor TimestampExtractor}.
+ *
+ * @see TimeWindows
+ * @see SessionWindows
+ * @see JoinWindows
+ * @see KGroupedStream#count(Windows, String)
+ * @see KGroupedStream#count(Windows, org.apache.kafka.streams.processor.StateStoreSupplier)
+ * @see KGroupedStream#reduce(Reducer, Windows, String)
+ * @see KGroupedStream#reduce(Reducer, Windows, org.apache.kafka.streams.processor.StateStoreSupplier)
+ * @see KGroupedStream#aggregate(Initializer, Aggregator, Windows, org.apache.kafka.common.serialization.Serde, String)
+ * @see KGroupedStream#aggregate(Initializer, Aggregator, Windows, org.apache.kafka.streams.processor.StateStoreSupplier)
+ * @see org.apache.kafka.streams.processor.TimestampExtractor
  */
+@InterfaceStability.Unstable
 public class UnlimitedWindows extends Windows<UnlimitedWindow> {
 
     private static final long DEFAULT_START_TIMESTAMP_MS = 0L;
@@ -32,10 +51,7 @@ public class UnlimitedWindows extends Windows<UnlimitedWindow> {
     /** The start timestamp of the window. */
     public final long startMs;
 
-    private UnlimitedWindows(final long startMs) throws IllegalArgumentException {
-        if (startMs < 0) {
-            throw new IllegalArgumentException("startMs must be > 0 (you provided " + startMs + ")");
-        }
+    private UnlimitedWindows(final long startMs) {
         this.startMs = startMs;
     }
 
@@ -49,11 +65,15 @@ public static UnlimitedWindows of() {
     /**
      * Return a new unlimited window for the specified start timestamp.
      *
-     * @param start  the window start time
-     * @return       a new unlimited window that starts at {@code start}
+     * @param startMs the window start time
+     * @return a new unlimited window that starts at {@code startMs}
+     * @throws IllegalArgumentException if the start time is negative
      */
-    public UnlimitedWindows startOn(final long start) throws IllegalArgumentException {
-        return new UnlimitedWindows(start);
+    public UnlimitedWindows startOn(final long startMs) throws IllegalArgumentException {
+        if (startMs < 0) {
+            throw new IllegalArgumentException("Window start time (startMs) cannot be negative.");
+        }
+        return new UnlimitedWindows(startMs);
     }
 
     @Override
@@ -68,11 +88,39 @@ public Map<Long, UnlimitedWindow> windowsFor(final long timestamp) {
         return windows;
     }
 
+    /**
+     * {@inheritDoc}
+     * As unlimited windows have conceptually infinite size, this methods just returns {@link Long#MAX_VALUE}.
+     *
+     * @return the size of the specified windows which is {@link Long#MAX_VALUE}
+     */
     @Override
     public long size() {
         return Long.MAX_VALUE;
     }
 
+    /**
+     * Throws an {@link IllegalArgumentException} because the retention time for unlimited windows is always infinite
+     * and cannot be changed.
+     *
+     * @throws IllegalArgumentException on every invocation
+     */
+    @Override
+    public UnlimitedWindows until(final long durationMs) {
+        throw new IllegalArgumentException("Window retention time (durationMs) cannot be set for UnlimitedWindows.");
+    }
+
+    /**
+     * {@inheritDoc}
+     * The retention time for unlimited windows in infinite and thus represented as {@link Long#MAX_VALUE}.
+     *
+     * @return the window retention time that is {@link Long#MAX_VALUE}
+     */
+    @Override
+    public long maintainMs() {
+        return Long.MAX_VALUE;
+    }
+
     @Override
     public final boolean equals(final Object o) {
         if (o == this) {
@@ -92,13 +140,4 @@ public int hashCode() {
         return (int) (startMs ^ (startMs >>> 32));
     }
 
-    @Override
-    public UnlimitedWindows until(final long durationMs) {
-        throw new IllegalArgumentException("Window retention time (durationMs) cannot be set for UnlimitedWindows.");
-    }
-
-    @Override
-    public long maintainMs() {
-        return Long.MAX_VALUE;
-    }
-}
\ No newline at end of file
+}
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java
index 9c6edc099588c..2d2439d0e1ed8 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java
@@ -5,33 +5,45 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-
 package org.apache.kafka.streams.kstream;
 
+import org.apache.kafka.common.annotation.InterfaceStability;
+
 /**
  * A single window instance, defined by its start and end timestamp.
+ * {@link Window} is agnostic if start/end boundaries are inclusive or exclusive; this is defined by concrete
+ * window implementations.
+ * <p>
+ * To specify how {@link Window} boundaries are defined use {@link Windows}.
+ * For time semantics, see {@link org.apache.kafka.streams.processor.TimestampExtractor TimestampExtractor}.
+ *
+ * @see Windows
+ * @see org.apache.kafka.streams.kstream.internals.TimeWindow
+ * @see org.apache.kafka.streams.kstream.internals.SessionWindow
+ * @see org.apache.kafka.streams.kstream.internals.UnlimitedWindow
+ * @see org.apache.kafka.streams.processor.TimestampExtractor
  */
+@InterfaceStability.Unstable
 public abstract class Window {
 
     protected final long startMs;
     protected final long endMs;
 
     /**
-     * Create a new window for the given start time (inclusive) and end time (exclusive).
+     * Create a new window for the given start and end time.
      *
-     * @param start  the start timestamp of the window (inclusive)
-     * @param end    the end timestamp of the window (exclusive)
-     * @throws IllegalArgumentException if {@code start} or {@code end} is negative or if {@code end} is smaller than
-     * {@code start}
+     * @param startMs the start timestamp of the window
+     * @param endMs   the end timestamp of the window
+     * @throws IllegalArgumentException if {@code startMs} is negative or if {@code endMs} is smaller than {@code startMs}
      */
     public Window(long startMs, long endMs) throws IllegalArgumentException {
         if (startMs < 0) {
@@ -45,14 +57,14 @@ public Window(long startMs, long endMs) throws IllegalArgumentException {
     }
 
     /**
-     * Return the start timestamp of this window, inclusive
+     * Return the start timestamp of this window.
      */
     public long start() {
         return startMs;
     }
 
     /**
-     * Return the end timestamp of this window, exclusive
+     * Return the end timestamp of this window.
      */
     public long end() {
         return endMs;
@@ -60,9 +72,11 @@ public long end() {
 
     /**
      * Check if the given window overlaps with this window.
+     * Should throw an {@link IllegalArgumentException} if the {@code other} window has a different type than {@code
+     * this} window.
      *
-     * @param other  another window
-     * @return       {@code true} if {@code other} overlaps with this window&mdash;{@code false} otherwise
+     * @param other another window of the same type
+     * @return {@code true} if {@code other} overlaps with this window&mdash;{@code false} otherwise
      */
     public abstract boolean overlap(final Window other);
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Windowed.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Windowed.java
index 81357c1daf50d..2941136dc9856 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Windowed.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Windowed.java
@@ -17,13 +17,31 @@
 
 package org.apache.kafka.streams.kstream;
 
+import org.apache.kafka.common.annotation.InterfaceStability;
+
 /**
- * Used to represent windowed stream aggregations (e.g. as returned by
- * {@link KGroupedStream#aggregate(Initializer, Aggregator, Windows, org.apache.kafka.common.serialization.Serde, String)}),
- * which have the type {@code <Windowed<K>, V>}.
+ * The result key type of a windowed stream aggregation.
+ * <p>
+ * If a {@link KStream} gets grouped and aggregated using a window-aggregation the resulting {@link KTable} is a
+ * so-called "windowed {@link KTable}" with a combined key type that encodes the corresponding aggregation window and
+ * the original record key.
+ * Thus, a windowed {@link KTable} has type {@link Windowed &lt;Windowed&lt;K&gt;,V&gt;}
  *
- * @param <K> Type of the key
+ * @param <K> type of the key
+ * @see KGroupedStream#count(Windows, String)
+ * @see KGroupedStream#count(Windows, org.apache.kafka.streams.processor.StateStoreSupplier)
+ * @see KGroupedStream#count(SessionWindows, String)
+ * @see KGroupedStream#count(SessionWindows, org.apache.kafka.streams.processor.StateStoreSupplier)
+ * @see KGroupedStream#reduce(Reducer, Windows, String)
+ * @see KGroupedStream#reduce(Reducer, Windows, org.apache.kafka.streams.processor.StateStoreSupplier)
+ * @see KGroupedStream#reduce(Reducer, SessionWindows, String)
+ * @see KGroupedStream#reduce(Reducer, SessionWindows, org.apache.kafka.streams.processor.StateStoreSupplier)
+ * @see KGroupedStream#aggregate(Initializer, Aggregator, Windows, org.apache.kafka.common.serialization.Serde, String)
+ * @see KGroupedStream#aggregate(Initializer, Aggregator, Windows, org.apache.kafka.streams.processor.StateStoreSupplier)
+ * @see KGroupedStream#aggregate(Initializer, Aggregator, Merger, SessionWindows, org.apache.kafka.common.serialization.Serde, org.apache.kafka.streams.processor.StateStoreSupplier)
+ * @see KGroupedStream#aggregate(Initializer, Aggregator, Merger, SessionWindows, org.apache.kafka.common.serialization.Serde, String)
  */
+@InterfaceStability.Unstable
 public class Windowed<K> {
 
     private final K key;
@@ -47,7 +65,7 @@ public K key() {
     /**
      * Return the window containing the values associated with this key.
      *
-     * @return  the window containing the values
+     * @return the window containing the values
      */
     public Window window() {
         return window;
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Windows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Windows.java
index 29b61fda79bf8..ea0c7286f1fbd 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Windows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Windows.java
@@ -5,9 +5,9 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -16,13 +16,25 @@
  */
 package org.apache.kafka.streams.kstream;
 
+import org.apache.kafka.common.annotation.InterfaceStability;
+
 import java.util.Map;
 
 /**
- * The window specification interface that can be extended for windowing operation in joins and aggregations.
+ * The window specification interface for fixed size windows that is used to define window boundaries and window
+ * maintain duration.
+ * <p>
+ * If not explicitly specified, the default maintain duration is 1 day.
+ * For time semantics, see {@link org.apache.kafka.streams.processor.TimestampExtractor TimestampExtractor}.
  *
- * @param <W>   type of the window instance
+ * @param <W> type of the window instance
+ * @see TimeWindows
+ * @see UnlimitedWindows
+ * @see JoinWindows
+ * @see SessionWindows
+ * @see org.apache.kafka.streams.processor.TimestampExtractor
  */
+@InterfaceStability.Unstable
 public abstract class Windows<W extends Window> {
 
     private static final int DEFAULT_NUM_SEGMENTS = 3;
@@ -39,10 +51,12 @@ protected Windows() {
     }
 
     /**
-     * Set the window maintain duration in milliseconds of streams time.
+     * Set the window maintain duration (retention time) in milliseconds.
      * This retention time is a guaranteed <i>lower bound</i> for how long a window will be maintained.
      *
-     * @return  itself
+     * @param durationMs the window retention time in milliseconds
+     * @return itself
+     * @throws IllegalArgumentException if {@code durationMs} is negative
      */
     // This should always get overridden to provide the correct return type and thus to avoid a cast
     public Windows<W> until(final long durationMs) throws IllegalArgumentException {
@@ -55,10 +69,21 @@ public Windows<W> until(final long durationMs) throws IllegalArgumentException {
     }
 
     /**
-     * Specify the number of segments to be used for rolling the window store,
-     * this function is not exposed to users but can be called by developers that extend this JoinWindows specs.
+     * Return the window maintain duration (retention time) in milliseconds.
+     *
+     * @return the window maintain duration
+     */
+    public long maintainMs() {
+        return maintainDurationMs;
+    }
+
+    /**
+     * Set the number of segments to be used for rolling the window store.
+     * This function is not exposed to users but can be called by developers that extend this class.
      *
-     * @return  itself
+     * @param segments the number of segments to be used
+     * @return itself
+     * @throws IllegalArgumentException if specified segments is small than 2
      */
     protected Windows<W> segments(final int segments) throws IllegalArgumentException {
         if (segments < 2) {
@@ -70,21 +95,17 @@ protected Windows<W> segments(final int segments) throws IllegalArgumentExceptio
     }
 
     /**
-     * Return the window maintain duration in milliseconds of streams time.
+     * Create all windows that contain the provided timestamp, indexed by non-negative window start timestamps.
      *
-     * @return the window maintain duration in milliseconds of streams time
+     * @param timestamp the timestamp window should get created for
+     * @return a map of {@code windowStartTimestamp -> Window} entries
      */
-    public long maintainMs() {
-        return maintainDurationMs;
-    }
+    public abstract Map<Long, W> windowsFor(final long timestamp);
 
     /**
-     * Creates all windows that contain the provided timestamp, indexed by non-negative window start timestamps.
+     * Return the size of the specified windows in milliseconds.
      *
-     * @param timestamp  the timestamp window should get created for
-     * @return  a map of {@code windowStartTimestamp -> Window} entries
+     * @return the size of the specified windows
      */
-    public abstract Map<Long, W> windowsFor(final long timestamp);
-
     public abstract long size();
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionWindow.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionWindow.java
index cf72752fa526b..2ea273c0bcb3e 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionWindow.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionWindow.java
@@ -18,38 +18,44 @@
  */
 package org.apache.kafka.streams.kstream.internals;
 
+import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.streams.kstream.Window;
 
 /**
  * A session window covers a closed time interval with its start and end timestamp both being an inclusive boundary.
+ * <p>
+ * For time semantics, see {@link org.apache.kafka.streams.processor.TimestampExtractor TimestampExtractor}.
  *
  * @see TimeWindow
  * @see UnlimitedWindow
  * @see org.apache.kafka.streams.kstream.SessionWindows
+ * @see org.apache.kafka.streams.processor.TimestampExtractor
  */
+@InterfaceStability.Unstable
 public final class SessionWindow extends Window {
 
     /**
      * Create a new window for the given start time and end time (both inclusive).
      *
-     * @param start  the start timestamp of the window
-     * @param end    the end timestamp of the window
+     * @param startMs the start timestamp of the window
+     * @param endMs   the end timestamp of the window
+     * @throws IllegalArgumentException if {@code startMs} is negative or if {@code endMs} is smaller than {@code startMs}
      */
-    public SessionWindow(final long startMs, final long endMs) {
+    public SessionWindow(final long startMs, final long endMs) throws IllegalArgumentException {
         super(startMs, endMs);
     }
 
     /**
      * Check if the given window overlaps with this window.
      *
-     * @param other  another window
-     * @return       {@code true} if {@code other} overlaps with this window&mdash;{@code false} otherwise
+     * @param other another window
+     * @return {@code true} if {@code other} overlaps with this window&mdash;{@code false} otherwise
      * @throws IllegalArgumentException if the {@code other} window has a different type than {@link this} window
      */
     public boolean overlap(final Window other) throws IllegalArgumentException {
         if (getClass() != other.getClass()) {
             throw new IllegalArgumentException("Cannot compare windows of different type. Other window has type "
-                + other.getClass());
+                + other.getClass() + ".");
         }
         final SessionWindow otherWindow = (SessionWindow) other;
         return !(otherWindow.endMs < startMs || endMs < otherWindow.startMs);
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/TimeWindow.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/TimeWindow.java
index bf98f941dbac9..ab805acaa2200 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/TimeWindow.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/TimeWindow.java
@@ -14,28 +14,57 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-
 package org.apache.kafka.streams.kstream.internals;
 
+import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.streams.kstream.Window;
 
+/**
+ * A {@link TimeWindow} covers a half-open time interval with its start timestamp as an inclusive boundary and its end
+ * timestamp as exclusive boundary.
+ * It is a fixed size window, i.e., all instances (of a single {@link org.apache.kafka.streams.kstream.TimeWindows
+ * window specification}) will have the same size.
+ * <p>
+ * For time semantics, see {@link org.apache.kafka.streams.processor.TimestampExtractor TimestampExtractor}.
+ *
+ * @see SessionWindow
+ * @see UnlimitedWindow
+ * @see org.apache.kafka.streams.kstream.TimeWindows
+ * @see org.apache.kafka.streams.processor.TimestampExtractor
+ */
+@InterfaceStability.Unstable
 public class TimeWindow extends Window {
 
-    public TimeWindow(long startMs, long endMs) {
+    /**
+     * Create a new window for the given start time (inclusive) and end time (exclusive).
+     *
+     * @param startMs the start timestamp of the window (inclusive)
+     * @param endMs   the end timestamp of the window (exclusive)
+     * @throws IllegalArgumentException if {@code startMs} is negative or if {@code endMs} is smaller than or equal to
+     * {@code startMs}
+     */
+    public TimeWindow(final long startMs, final long endMs) throws IllegalArgumentException {
         super(startMs, endMs);
         if (startMs == endMs) {
             throw new IllegalArgumentException("Window endMs must be greater than window startMs.");
         }
     }
 
+    /**
+     * Check if the given window overlaps with this window.
+     *
+     * @param other another window
+     * @return {@code true} if {@code other} overlaps with this window&mdash;{@code false} otherwise
+     * @throws IllegalArgumentException if the {@code other} window has a different type than {@link this} window
+     */
     @Override
     public boolean overlap(final Window other) throws IllegalArgumentException {
         if (getClass() != other.getClass()) {
             throw new IllegalArgumentException("Cannot compare windows of different type. Other window has type "
-                + other.getClass());
+                + other.getClass() + ".");
         }
         final TimeWindow otherWindow = (TimeWindow) other;
         return startMs < otherWindow.endMs && otherWindow.startMs < endMs;
     }
 
-}
\ No newline at end of file
+}
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/UnlimitedWindow.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/UnlimitedWindow.java
index 7fb7c53000a44..311169e58e0be 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/UnlimitedWindow.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/UnlimitedWindow.java
@@ -14,24 +14,52 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-
 package org.apache.kafka.streams.kstream.internals;
 
+import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.streams.kstream.Window;
 
+/**
+ * {@link UnlimitedWindow} is an "infinite" large window with a fixed (inclusive) start time.
+ * All windows of the same {@link org.apache.kafka.streams.kstream.UnlimitedWindows window specification} will have the
+ * same start time.
+ * To make the window size "infinite" end time is set to {@link Long#MAX_VALUE}.
+ * <p>
+ * For time semantics, see {@link org.apache.kafka.streams.processor.TimestampExtractor TimestampExtractor}.
+ *
+ * @see TimeWindow
+ * @see SessionWindow
+ * @see org.apache.kafka.streams.kstream.UnlimitedWindows
+ * @see org.apache.kafka.streams.processor.TimestampExtractor
+ */
+@InterfaceStability.Unstable
 public class UnlimitedWindow extends Window {
 
+    /**
+     * Create a new window for the given start time (inclusive).
+     *
+     * @param startMs the start timestamp of the window (inclusive)
+     * @throws IllegalArgumentException if {@code start} is negative
+     */
     public UnlimitedWindow(final long startMs) {
         super(startMs, Long.MAX_VALUE);
     }
 
+    /**
+     * Returns {@code true} if the given window is of the same type, because all unlimited windows overlap with each
+     * other due to their infinite size.
+     *
+     * @param other another window
+     * @return {@code true}
+     * @throws IllegalArgumentException if the {@code other} window has a different type than {@link this} window
+     */
     @Override
     public boolean overlap(final Window other) {
         if (getClass() != other.getClass()) {
             throw new IllegalArgumentException("Cannot compare windows of different type. Other window has type "
-                + other.getClass());
+                + other.getClass() + ".");
         }
         return true;
     }
 
-}
\ No newline at end of file
+}

From f34831c7603fb69ff196e2f99cd4b00bc59abf53 Mon Sep 17 00:00:00 2001
From: Guozhang Wang <wangguoz@gmail.com>
Date: Tue, 24 Jan 2017 12:00:35 -0800
Subject: [PATCH 033/177] KAFKA-3896: Fix KStreamRepartitionJoinTest

The root cause of this issue is that in InternalTopicManager we are creating topics one-at-a-time, and for this test, there are 31 topics to be created, as a result it is possible that the consumer could time out during the assignment in rebalance, and the next leader has to do the same again because of "makeReady" calls are one-at-a-time.

This patch batches the topics into a single create request and also use the StreamsKafkaClient directly to fetch metadata for validating the created topics. Also optimized a bunch of inefficient code in InternalTopicManager and StreamsKafkaClient.

Minor cleanup: make the exception message more informative in integration tests.

Author: Guozhang Wang <wangguoz@gmail.com>

Reviewers: Damian Guy, Matthias J. Sax, Jason Gustafson

Closes #2405 from guozhangwang/K3896-fix-kstream-repartition-join-test

(cherry picked from commit 7837d3e54850fc6ecd16f9bc4dd28a02779572c2)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../internals/InternalTopicManager.java       | 86 +++++++++----------
 .../internals/StreamPartitionAssignor.java    | 42 ++++++---
 .../internals/StreamsKafkaClient.java         | 40 +--------
 .../KStreamRepartitionJoinTest.java           |  8 +-
 .../utils/IntegrationTestUtils.java           |  4 +-
 .../internals/InternalTopicManagerTest.java   | 66 ++++++--------
 .../kafka/test/MockInternalTopicManager.java  | 28 ++++--
 7 files changed, 123 insertions(+), 151 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java
index 133375fd17c71..eeb38d1133bbd 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java
@@ -26,6 +26,7 @@
 import java.util.Collection;
 import java.util.HashMap;
 import java.util.Map;
+import java.util.Set;
 import java.util.concurrent.TimeUnit;
 
 public class InternalTopicManager {
@@ -48,23 +49,17 @@ public InternalTopicManager(final StreamsKafkaClient streamsKafkaClient, final i
     }
 
     /**
-     * Prepares a given internal topic.
-     * If the topic does not exist creates a new topic.
-     * If the topic with the correct number of partitions exists ignores it.
-     * If the topic exists already but has different number of partitions we fail and throw exception requesting user to reset the app before restarting again.
+     * Prepares a set of given internal topics.
      *
-     * @param topic
-     * @param numPartitions
+     * If a topic does not exist creates a new topic.
+     * If a topic with the correct number of partitions exists ignores it.
+     * If a topic exists already but has different number of partitions we fail and throw exception requesting user to reset the app before restarting again.
      */
-    public void makeReady(final InternalTopicConfig topic, int numPartitions) {
-
-        Map<InternalTopicConfig, Integer> topics = new HashMap<>();
-        topics.put(topic, numPartitions);
+    public void makeReady(final Map<InternalTopicConfig, Integer> topics) {
         for (int i = 0; i < MAX_TOPIC_READY_TRY; i++) {
             try {
-                Collection<MetadataResponse.TopicMetadata> topicsMetadata = streamsKafkaClient.fetchTopicsMetadata();
-                validateTopicPartitons(topics, topicsMetadata);
-                Map<InternalTopicConfig, Integer> topicsToBeCreated = filterExistingTopics(topics, topicsMetadata);
+                final Map<String, Integer> existingTopicPartitions = fetchExistingPartitionCountByTopic();
+                final Map<InternalTopicConfig, Integer> topicsToBeCreated = validateTopicPartitions(topics, existingTopicPartitions);
                 streamsKafkaClient.createTopics(topicsToBeCreated, replicationFactor, windowChangeLogAdditionalRetention);
                 return;
             } catch (StreamsException ex) {
@@ -74,6 +69,16 @@ public void makeReady(final InternalTopicConfig topic, int numPartitions) {
         throw new StreamsException("Could not create internal topics.");
     }
 
+    /**
+     * Get the number of partitions for the given topics
+     */
+    public Map<String, Integer> getNumPartitions(final Set<String> topics) {
+        final Map<String, Integer> existingTopicPartitions = fetchExistingPartitionCountByTopic();
+        existingTopicPartitions.keySet().retainAll(topics);
+
+        return existingTopicPartitions;
+    }
+
     public void close() {
         try {
             streamsKafkaClient.close();
@@ -83,49 +88,36 @@ public void close() {
     }
 
     /**
-     * Return the non existing topics.
-     *
-     * @param topicsPartitionsMap
-     * @param topicsMetadata
-     * @return
+     * Check the existing topics to have correct number of partitions; and return the non existing topics to be created
      */
-    private Map<InternalTopicConfig, Integer> filterExistingTopics(final Map<InternalTopicConfig, Integer> topicsPartitionsMap, Collection<MetadataResponse.TopicMetadata> topicsMetadata) {
-        Map<String, Integer> existingTopicNamesPartitions = getExistingTopicNamesPartitions(topicsMetadata);
-        Map<InternalTopicConfig, Integer> nonExistingTopics = new HashMap<>();
-        // Add the topics that don't exist to the nonExistingTopics.
+    private Map<InternalTopicConfig, Integer> validateTopicPartitions(final Map<InternalTopicConfig, Integer> topicsPartitionsMap,
+                                                                      final Map<String, Integer> existingTopicNamesPartitions) {
+        final Map<InternalTopicConfig, Integer> topicsToBeCreated = new HashMap<>();
         for (InternalTopicConfig topic: topicsPartitionsMap.keySet()) {
-            if (existingTopicNamesPartitions.get(topic.name()) == null) {
-                nonExistingTopics.put(topic, topicsPartitionsMap.get(topic));
+            if (existingTopicNamesPartitions.containsKey(topic.name())) {
+                if (!existingTopicNamesPartitions.get(topic.name()).equals(topicsPartitionsMap.get(topic))) {
+                    throw new StreamsException("Existing internal topic " + topic.name() + " has invalid partitions." +
+                            " Expected: " + topicsPartitionsMap.get(topic) + " Actual: " + existingTopicNamesPartitions.get(topic.name()) +
+                            ". Use 'kafka.tools.StreamsResetter' tool to clean up invalid topics before processing.");
+                }
+            } else {
+                topicsToBeCreated.put(topic, topicsPartitionsMap.get(topic));
             }
         }
-        return nonExistingTopics;
+
+        return topicsToBeCreated;
     }
 
+    private Map<String, Integer> fetchExistingPartitionCountByTopic() {
+        // The names of existing topics and corresponding partition counts
+        final Map<String, Integer> existingPartitionCountByTopic = new HashMap<>();
 
-    /**
-     * Make sure the existing topics have correct number of partitions.
-     *
-     * @param topicsPartitionsMap
-     * @param topicsMetadata
-     */
-    private void validateTopicPartitons(final Map<InternalTopicConfig, Integer> topicsPartitionsMap, Collection<MetadataResponse.TopicMetadata> topicsMetadata) {
-        Map<String, Integer> existingTopicNamesPartitions = getExistingTopicNamesPartitions(topicsMetadata);
-        for (InternalTopicConfig topic: topicsPartitionsMap.keySet()) {
-            if (existingTopicNamesPartitions.get(topic.name()) != null) {
-                if (existingTopicNamesPartitions.get(topic.name()) != topicsPartitionsMap.get(topic)) {
-                    throw new StreamsException("Internal topic with invalid partitons. Use 'kafka.tools.StreamsResetter' tool to clean up invalid topics before processing.");
-                }
-            }
-        }
-    }
+        Collection<MetadataResponse.TopicMetadata> topicsMetadata = streamsKafkaClient.fetchTopicsMetadata();
 
-    private Map<String, Integer> getExistingTopicNamesPartitions(Collection<MetadataResponse.TopicMetadata> topicsMetadata) {
-        // The names of existing topics
-        Map<String, Integer> existingTopicNamesPartitions = new HashMap<>();
         for (MetadataResponse.TopicMetadata topicMetadata: topicsMetadata) {
-            existingTopicNamesPartitions.put(topicMetadata.topic(), topicMetadata.partitionMetadata().size());
+            existingPartitionCountByTopic.put(topicMetadata.topic(), topicMetadata.partitionMetadata().size());
         }
-        return existingTopicNamesPartitions;
-    }
 
+        return existingPartitionCountByTopic;
+    }
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java
index 382c4e9986aeb..c790a1e99970b 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java
@@ -263,7 +263,6 @@ public Subscription subscription(Set<String> topics) {
      */
     @Override
     public Map<String, Assignment> assign(Cluster metadata, Map<String, Subscription> subscriptions) {
-
         // construct the client metadata from the decoded subscription info
         Map<UUID, ClientMetadata> clientsMetadata = new HashMap<>();
 
@@ -593,9 +592,13 @@ public void onAssignment(Assignment assignment) {
     private void prepareTopic(final Map<String, InternalTopicMetadata> topicPartitions) {
         log.debug("stream-thread [{}] Starting to validate internal topics in partition assignor.", streamThread.getName());
 
-        for (final Map.Entry<String, InternalTopicMetadata> entry : topicPartitions.entrySet()) {
-            final InternalTopicConfig topic = entry.getValue().config;
-            final Integer numPartitions = entry.getValue().numPartitions;
+        // first construct the topics to make ready
+        Map<InternalTopicConfig, Integer> topicsToMakeReady = new HashMap<>();
+        Set<String> topicNamesToMakeReady = new HashSet<>();
+
+        for (InternalTopicMetadata metadata : topicPartitions.values()) {
+            InternalTopicConfig topic = metadata.config;
+            Integer numPartitions = metadata.numPartitions;
 
             if (numPartitions == NOT_AVAILABLE) {
                 continue;
@@ -604,18 +607,37 @@ private void prepareTopic(final Map<String, InternalTopicMetadata> topicPartitio
                 throw new TopologyBuilderException(String.format("stream-thread [%s] Topic [%s] number of partitions not defined", streamThread.getName(), topic.name()));
             }
 
-            internalTopicManager.makeReady(topic, numPartitions);
+            topicsToMakeReady.put(topic, numPartitions);
+            topicNamesToMakeReady.add(topic.name());
+        }
 
-            // wait until the topic metadata has been propagated to all brokers
-            List<PartitionInfo> partitions;
-            do {
-                partitions = streamThread.restoreConsumer.partitionsFor(topic.name());
-            } while (partitions == null || partitions.size() != numPartitions);
+        if (!topicsToMakeReady.isEmpty()) {
+            internalTopicManager.makeReady(topicsToMakeReady);
+
+            // wait until each one of the topic metadata has been propagated to at least one broker
+            while (!allTopicsCreated(topicNamesToMakeReady, topicsToMakeReady)) {
+                try {
+                    Thread.sleep(50L);
+                } catch (InterruptedException e) {
+                    // ignore
+                }
+            }
         }
 
         log.info("stream-thread [{}] Completed validating internal topics in partition assignor", streamThread.getName());
     }
 
+    private boolean allTopicsCreated(final Set<String> topicNamesToMakeReady, final Map<InternalTopicConfig, Integer> topicsToMakeReady) {
+        final Map<String, Integer> partitions = internalTopicManager.getNumPartitions(topicNamesToMakeReady);
+        for (Map.Entry<InternalTopicConfig, Integer> entry : topicsToMakeReady.entrySet()) {
+            final Integer numPartitions = partitions.get(entry.getKey().name());
+            if (numPartitions == null || !numPartitions.equals(entry.getValue())) {
+                return false;
+            }
+        }
+        return true;
+    }
+
     private void ensureCopartitioning(Collection<Set<String>> copartitionGroups,
                                       Map<String, InternalTopicMetadata> allRepartitionTopicsNumPartitions,
                                       Cluster metadata) {
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
index 8ea570faa5379..df590fbe151b8 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
@@ -48,7 +48,6 @@
 import java.util.Properties;
 import java.util.HashMap;
 import java.util.Collection;
-import java.util.Arrays;
 import java.util.concurrent.TimeUnit;
 
 public class StreamsKafkaClient {
@@ -103,10 +102,6 @@ public void close() throws IOException {
 
     /**
      * Creates a set of new topics using batch request.
-     *
-     * @param topicsMap
-     * @param replicationFactor
-     * @param windowChangeLogAdditionalRetention
      */
     public void createTopics(final Map<InternalTopicConfig, Integer> topicsMap, final int replicationFactor, final long windowChangeLogAdditionalRetention) {
 
@@ -135,12 +130,8 @@ public void createTopics(final Map<InternalTopicConfig, Integer> topicsMap, fina
 
         for (InternalTopicConfig internalTopicConfig : topicsMap.keySet()) {
             CreateTopicsResponse.Error error = createTopicsResponse.errors().get(internalTopicConfig.name());
-            if (!error.is(Errors.NONE)) {
-                if (error.is(Errors.TOPIC_ALREADY_EXISTS)) {
-                    continue;
-                } else {
-                    throw new StreamsException("Could not create topic: " + internalTopicConfig.name() + " due to " + error.messageWithFallback());
-                }
+            if (!error.is(Errors.NONE) && !error.is(Errors.TOPIC_ALREADY_EXISTS)) {
+                throw new StreamsException("Could not create topic: " + internalTopicConfig.name() + " due to " + error.messageWithFallback());
             }
         }
     }
@@ -193,35 +184,8 @@ private ClientResponse sendRequest(final ClientRequest clientRequest) {
 
     }
 
-
-     /**
-     * Fetch the metadata for a topic.
-     * @param topic
-     * @return
-     */
-    public MetadataResponse.TopicMetadata fetchTopicMetadata(final String topic) {
-        final ClientRequest clientRequest = kafkaClient.newClientRequest(getBrokerId(), new MetadataRequest.Builder(Arrays.asList(topic)), Time.SYSTEM.milliseconds(), true, null);
-        final ClientResponse clientResponse = sendRequest(clientRequest);
-        if (!clientResponse.hasResponse()) {
-            throw new StreamsException("Empty response for client request.");
-        }
-        if (!(clientResponse.responseBody() instanceof MetadataResponse)) {
-            throw new StreamsException("Inconsistent response type for internal topic metadata request. Expected MetadataResponse but received " + clientResponse.responseBody().getClass().getName());
-        }
-        final MetadataResponse metadataResponse = (MetadataResponse) clientResponse.responseBody();
-        for (MetadataResponse.TopicMetadata topicMetadata: metadataResponse.topicMetadata()) {
-            if (topicMetadata.topic().equalsIgnoreCase(topic)) {
-                return topicMetadata;
-            }
-        }
-        return null;
-    }
-
-
     /**
      * Fetch the metadata for all topics
-     *
-     * @return
      */
     public Collection<MetadataResponse.TopicMetadata> fetchTopicsMetadata() {
 
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamRepartitionJoinTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamRepartitionJoinTest.java
index f0fb0a2a4673d..43e5d879f311d 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamRepartitionJoinTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamRepartitionJoinTest.java
@@ -160,7 +160,6 @@ private ExpectedOutputOnTopic mapBothStreamsAndJoin() throws Exception {
         return new ExpectedOutputOnTopic(expectedStreamOneTwoJoin, "map-both-streams-and-join-" + testNo);
     }
 
-
     private ExpectedOutputOnTopic mapMapJoin() throws Exception {
         final KStream<Integer, Integer> mapMapStream = streamOne.map(
             new KeyValueMapper<Long, Integer, KeyValue<Long, Integer>>() {
@@ -178,8 +177,7 @@ public KeyValue<Long, Integer> apply(final Long key, final Integer value) {
         return new ExpectedOutputOnTopic(expectedStreamOneTwoJoin, outputTopic);
     }
 
-
-    public ExpectedOutputOnTopic selectKeyAndJoin() throws ExecutionException, InterruptedException {
+    private ExpectedOutputOnTopic selectKeyAndJoin() throws ExecutionException, InterruptedException {
 
         final KStream<Integer, Integer> keySelected =
             streamOne.selectKey(MockKeyValueMapper.<Long, Integer>SelectValueMapper());
@@ -189,7 +187,6 @@ public ExpectedOutputOnTopic selectKeyAndJoin() throws ExecutionException, Inter
         return new ExpectedOutputOnTopic(expectedStreamOneTwoJoin, outputTopic);
     }
 
-
     private ExpectedOutputOnTopic flatMapJoin() throws Exception {
         final KStream<Integer, Integer> flatMapped = streamOne.flatMap(
             new KeyValueMapper<Long, Integer, Iterable<KeyValue<Integer, Integer>>>() {
@@ -221,7 +218,7 @@ private ExpectedOutputOnTopic joinMappedRhsStream() throws Exception {
         return new ExpectedOutputOnTopic(Arrays.asList("A:1", "B:2", "C:3", "D:4", "E:5"), output);
     }
 
-    public ExpectedOutputOnTopic mapBothStreamsAndLeftJoin() throws Exception {
+    private ExpectedOutputOnTopic mapBothStreamsAndLeftJoin() throws Exception {
         final KStream<Integer, Integer> map1 = streamOne.map(keyMapper);
 
         final KStream<Integer, String> map2 = streamTwo.map(MockKeyValueMapper.<Integer, String>NoOpKeyValueMapper());
@@ -312,7 +309,6 @@ private void produceMessages()
 
     }
 
-
     private void produceStreamTwoInputTo(final String streamTwoInput)
         throws ExecutionException, InterruptedException {
         IntegrationTestUtils.produceKeyValuesSynchronously(
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/utils/IntegrationTestUtils.java b/streams/src/test/java/org/apache/kafka/streams/integration/utils/IntegrationTestUtils.java
index 3e7c41b347f22..08e22cca76302 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/utils/IntegrationTestUtils.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/utils/IntegrationTestUtils.java
@@ -214,7 +214,7 @@ public boolean conditionMet() {
             }
         };
 
-        final String conditionDetails = "Expecting " + expectedNumRecords + " records while only received " + accumData.size() + ": " + accumData;
+        final String conditionDetails = "Expecting " + expectedNumRecords + " records from topic " + topic + " while only received " + accumData.size() + ": " + accumData;
 
         TestUtils.waitForCondition(valuesRead, waitTime, conditionDetails);
 
@@ -254,7 +254,7 @@ public boolean conditionMet() {
             }
         };
 
-        final String conditionDetails = "Expecting " + expectedNumRecords + " records while only received " + accumData.size() + ": " + accumData;
+        final String conditionDetails = "Expecting " + expectedNumRecords + " records from topic " + topic + " while only received " + accumData.size() + ": " + accumData;
 
         TestUtils.waitForCondition(valuesRead, waitTime, conditionDetails);
 
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java
index f82809917e5a5..548cb45bc9719 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java
@@ -23,47 +23,55 @@
 import org.apache.kafka.streams.StreamsConfig;
 import org.apache.kafka.streams.errors.StreamsException;
 import org.apache.kafka.test.MockTimestampExtractor;
+import org.junit.After;
 import org.junit.Assert;
 import org.junit.Before;
 import org.junit.Test;
 
+import java.io.IOException;
+import java.util.ArrayList;
 import java.util.Collection;
 import java.util.Collections;
 import java.util.Map;
 import java.util.Properties;
-import java.util.Arrays;
-import java.util.ArrayList;
 
 import static org.apache.kafka.streams.processor.internals.InternalTopicManager.WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT;
 
 public class InternalTopicManagerTest {
 
-    private String userEndPoint = "localhost:2171";
-    StreamsConfig config;
-    MockStreamKafkaClient streamsKafkaClient;
+    private final String topic = "test_topic";
+    private final String userEndPoint = "localhost:2171";
+    private MockStreamKafkaClient streamsKafkaClient;
 
     @Before
     public void init() {
-        config = new StreamsConfig(configProps());
+        final StreamsConfig config = new StreamsConfig(configProps());
         streamsKafkaClient = new MockStreamKafkaClient(config);
     }
 
+    @After
+    public void shutdown() throws IOException {
+        streamsKafkaClient.close();
+    }
+
     @Test
-    public void shouldCreateRequiredTopics() throws Exception {
+    public void shouldReturnCorrectPartitionCounts() throws Exception {
+        InternalTopicManager internalTopicManager = new InternalTopicManager(streamsKafkaClient, 1, WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT);
+        Assert.assertEquals(Collections.singletonMap(topic, 1), internalTopicManager.getNumPartitions(Collections.singleton(topic)));
+    }
 
-        streamsKafkaClient.setReturnCorrectTopic(true);
+    @Test
+    public void shouldCreateRequiredTopics() throws Exception {
         InternalTopicManager internalTopicManager = new InternalTopicManager(streamsKafkaClient, 1, WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT);
-        internalTopicManager.makeReady(new InternalTopicConfig("test_topic", Collections.singleton(InternalTopicConfig.CleanupPolicy.compact), null), 1);
+        internalTopicManager.makeReady(Collections.singletonMap(new InternalTopicConfig(topic, Collections.singleton(InternalTopicConfig.CleanupPolicy.compact), null), 1));
     }
 
     @Test
     public void shouldNotCreateTopicIfExistsWithDifferentPartitions() throws Exception {
-
-        streamsKafkaClient.setReturnCorrectTopic(true);
         InternalTopicManager internalTopicManager = new InternalTopicManager(streamsKafkaClient, 1, WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT);
         boolean exceptionWasThrown = false;
         try {
-            internalTopicManager.makeReady(new InternalTopicConfig("test_topic", Collections.singleton(InternalTopicConfig.CleanupPolicy.compact), null), 2);
+            internalTopicManager.makeReady(Collections.singletonMap(new InternalTopicConfig(topic, Collections.singleton(InternalTopicConfig.CleanupPolicy.compact), null), 2));
         } catch (StreamsException e) {
             exceptionWasThrown = true;
         }
@@ -82,43 +90,21 @@ private Properties configProps() {
     }
 
     private class MockStreamKafkaClient extends StreamsKafkaClient {
-        public MockStreamKafkaClient(final StreamsConfig streamsConfig) {
-            super(streamsConfig);
-        }
 
-        public boolean isReturnCorrectTopic() {
-            return returnCorrectTopic;
-        }
-
-        public void setReturnCorrectTopic(boolean returnCorrectTopic) {
-            this.returnCorrectTopic = returnCorrectTopic;
+        MockStreamKafkaClient(final StreamsConfig streamsConfig) {
+            super(streamsConfig);
         }
 
-        boolean returnCorrectTopic = false;
-
-
         @Override
         public void createTopics(final Map<InternalTopicConfig, Integer> topicsMap, final int replicationFactor, final long windowChangeLogAdditionalRetention) {
-
-        }
-
-        @Override
-        public MetadataResponse.TopicMetadata fetchTopicMetadata(final String topic) {
-
-            if (returnCorrectTopic) {
-                MetadataResponse.PartitionMetadata partitionMetadata = new MetadataResponse.PartitionMetadata(Errors.NONE, 1, null, new ArrayList<Node>(), new ArrayList<Node>());
-                MetadataResponse.TopicMetadata topicMetadata = new MetadataResponse.TopicMetadata(Errors.NONE, topic, true, Arrays.asList(partitionMetadata));
-                return topicMetadata;
-            }
-            return null;
+            // do nothing
         }
 
         @Override
         public Collection<MetadataResponse.TopicMetadata> fetchTopicsMetadata() {
-            if (returnCorrectTopic) {
-                return Arrays.asList(fetchTopicMetadata("test_topic"));
-            }
-            return null;
+            MetadataResponse.PartitionMetadata partitionMetadata = new MetadataResponse.PartitionMetadata(Errors.NONE, 1, null, new ArrayList<Node>(), new ArrayList<Node>());
+            MetadataResponse.TopicMetadata topicMetadata = new MetadataResponse.TopicMetadata(Errors.NONE, topic, true, Collections.singletonList(partitionMetadata));
+            return Collections.singleton(topicMetadata);
         }
     }
 }
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/test/MockInternalTopicManager.java b/streams/src/test/java/org/apache/kafka/test/MockInternalTopicManager.java
index af268801dbba3..28aca34b23bbe 100644
--- a/streams/src/test/java/org/apache/kafka/test/MockInternalTopicManager.java
+++ b/streams/src/test/java/org/apache/kafka/test/MockInternalTopicManager.java
@@ -28,11 +28,12 @@
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
+import java.util.Set;
 
 public class MockInternalTopicManager extends InternalTopicManager {
 
     public Map<String, Integer> readyTopics = new HashMap<>();
-    public MockConsumer<byte[], byte[]> restoreConsumer;
+    private MockConsumer<byte[], byte[]> restoreConsumer;
 
     public MockInternalTopicManager(StreamsConfig streamsConfig, MockConsumer<byte[], byte[]> restoreConsumer) {
         super(new StreamsKafkaClient(streamsConfig), 0, 0);
@@ -41,15 +42,26 @@ public MockInternalTopicManager(StreamsConfig streamsConfig, MockConsumer<byte[]
     }
 
     @Override
-    public void makeReady(InternalTopicConfig topic, int numPartitions) {
-        readyTopics.put(topic.name(), numPartitions);
+    public void makeReady(final Map<InternalTopicConfig, Integer> topics) {
+        for (Map.Entry<InternalTopicConfig, Integer> entry : topics.entrySet()) {
+            readyTopics.put(entry.getKey().name(), entry.getValue());
 
-        List<PartitionInfo> partitions = new ArrayList<>();
-        for (int i = 0; i < numPartitions; i++) {
-            partitions.add(new PartitionInfo(topic.name(), i, null, null, null));
-        }
+            final List<PartitionInfo> partitions = new ArrayList<>();
+            for (int i = 0; i < entry.getValue(); i++) {
+                partitions.add(new PartitionInfo(entry.getKey().name(), i, null, null, null));
+            }
 
-        restoreConsumer.updatePartitions(topic.name(), partitions);
+            restoreConsumer.updatePartitions(entry.getKey().name(), partitions);
+        }
     }
 
+    @Override
+    public Map<String, Integer> getNumPartitions(final Set<String> topics) {
+        final Map<String, Integer> partitions = new HashMap<>();
+        for (String topic : topics) {
+            partitions.put(topic, restoreConsumer.partitionsFor(topic) == null ?  null : restoreConsumer.partitionsFor(topic).size());
+        }
+
+        return partitions;
+    }
 }
\ No newline at end of file

From 5dbb4b8bfe4f02b31a6b5652ba7fac123d035edd Mon Sep 17 00:00:00 2001
From: "Colin P. Mccabe" <cmccabe@confluent.io>
Date: Tue, 24 Jan 2017 20:06:35 +0000
Subject: [PATCH 034/177] KAFKA-4548; Add ClientCompatibilityTest to verify
 features against older brokers

Author: Colin P. Mccabe <cmccabe@confluent.io>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2262 from cmccabe/KAFKA-4548

(cherry picked from commit 3df60e7eb8b6fb38cd560708f5b909a9b2e61de2)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../client_compatibility_features_test.py     | 100 +++++
 ...ent_compatibility_produce_consume_test.py} |  14 +-
 .../kafka/tools/ClientCompatibilityTest.java  | 359 ++++++++++++++++++
 3 files changed, 466 insertions(+), 7 deletions(-)
 create mode 100644 tests/kafkatest/tests/client/client_compatibility_features_test.py
 rename tests/kafkatest/tests/client/{test_producer_consumer_compat.py => client_compatibility_produce_consume_test.py} (85%)
 create mode 100644 tools/src/main/java/org/apache/kafka/tools/ClientCompatibilityTest.java

diff --git a/tests/kafkatest/tests/client/client_compatibility_features_test.py b/tests/kafkatest/tests/client/client_compatibility_features_test.py
new file mode 100644
index 0000000000000..3c96b84f37e5e
--- /dev/null
+++ b/tests/kafkatest/tests/client/client_compatibility_features_test.py
@@ -0,0 +1,100 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import time
+from random import randint
+
+from ducktape.mark import parametrize
+from ducktape.tests.test import TestContext
+
+from kafkatest.services.zookeeper import ZookeeperService
+from kafkatest.services.kafka import KafkaService
+from ducktape.tests.test import Test
+from kafkatest.version import TRUNK, LATEST_0_10_0, LATEST_0_10_1, V_0_10_1_0, KafkaVersion
+
+def get_broker_features(broker_version):
+    features = {}
+    if (broker_version < V_0_10_1_0):
+        features["offsets-for-times-supported"] = False
+        features["cluster-id-supported"] = False
+    else:
+        features["offsets-for-times-supported"] = True
+        features["cluster-id-supported"] = True
+    return features
+
+def run_command(node, cmd, ssh_log_file):
+    with open(ssh_log_file, 'w') as f:
+        f.write("Running %s\n" % cmd)
+        try:
+            for line in node.account.ssh_capture(cmd):
+                f.write(line)
+        except Exception as e:
+            f.write("** Command failed!")
+            print e
+            raise e
+
+
+class ClientCompatibilityFeaturesTest(Test):
+    """
+    Tests clients for the presence or absence of specific features when communicating with brokers with various
+    versions. Relies on ClientCompatibilityTest.java for much of the functionality.
+    """
+
+    def __init__(self, test_context):
+        """:type test_context: ducktape.tests.test.TestContext"""
+        super(ClientCompatibilityFeaturesTest, self).__init__(test_context=test_context)
+
+        self.zk = ZookeeperService(test_context, num_nodes=3)
+
+        # Generate a unique topic name
+        topic_name = "client_compat_features_topic_%d%d" % (int(time.time()), randint(0, 2147483647))
+        self.topics = { topic_name: {
+            "partitions": 1, # Use only one partition to avoid worrying about ordering
+            "replication-factor": 3
+            }}
+        self.kafka = KafkaService(test_context, num_nodes=3, zk=self.zk, topics=self.topics)
+
+    def invoke_compatibility_program(self, features):
+        # Run the compatibility test on the first Kafka node.
+        node = self.zk.nodes[0]
+        cmd = ("%s org.apache.kafka.tools.ClientCompatibilityTest "
+               "--bootstrap-server %s "
+               "--offsets-for-times-supported %s "
+               "--cluster-id-supported %s "
+               "--topic %s " % (self.zk.path.script("kafka-run-class.sh", node),
+                               self.kafka.bootstrap_servers(),
+                               features["offsets-for-times-supported"],
+                               features["cluster-id-supported"],
+                               self.topics.keys()[0]))
+        results_dir = TestContext.results_dir(self.test_context, 0)
+        os.makedirs(results_dir)
+        ssh_log_file = "%s/%s" % (results_dir, "client_compatibility_test_output.txt")
+        try:
+          self.logger.info("Running %s" % cmd)
+          run_command(node, cmd, ssh_log_file)
+        except Exception as e:
+          self.logger.info("** Command failed.  See %s for log messages." % ssh_log_file)
+          raise e
+
+    @parametrize(broker_version=str(TRUNK))
+    @parametrize(broker_version=str(LATEST_0_10_0))
+    @parametrize(broker_version=str(LATEST_0_10_1))
+    def run_compatibility_test(self, broker_version):
+        self.zk.start()
+        self.kafka.set_version(KafkaVersion(broker_version))
+        self.kafka.start()
+        features = get_broker_features(broker_version)
+        self.invoke_compatibility_program(features)
diff --git a/tests/kafkatest/tests/client/test_producer_consumer_compat.py b/tests/kafkatest/tests/client/client_compatibility_produce_consume_test.py
similarity index 85%
rename from tests/kafkatest/tests/client/test_producer_consumer_compat.py
rename to tests/kafkatest/tests/client/client_compatibility_produce_consume_test.py
index 5a14fc5995cf4..35b904b77ae01 100644
--- a/tests/kafkatest/tests/client/test_producer_consumer_compat.py
+++ b/tests/kafkatest/tests/client/client_compatibility_produce_consume_test.py
@@ -22,17 +22,16 @@
 from kafkatest.services.console_consumer import ConsoleConsumer
 from kafkatest.tests.produce_consume_validate import ProduceConsumeValidateTest
 from kafkatest.utils import is_int_with_prefix
-from kafkatest.version import TRUNK, V_0_10_0_0, KafkaVersion
+from kafkatest.version import TRUNK, LATEST_0_10_0, LATEST_0_10_1, KafkaVersion
 
-class TestProducerConsumerCompat(ProduceConsumeValidateTest):
+class ClientCompatibilityProduceConsumeTest(ProduceConsumeValidateTest):
     """
-    These tests validate that we can use a new client to consume from older
-    brokers.
+    These tests validate that we can use a new client to produce and consume from older brokers.
     """
 
     def __init__(self, test_context):
         """:type test_context: ducktape.tests.test.TestContext"""
-        super(TestProducerConsumerCompat, self).__init__(test_context=test_context)
+        super(ClientCompatibilityProduceConsumeTest, self).__init__(test_context=test_context)
 
         self.topic = "test_topic"
         self.zk = ZookeeperService(test_context, num_nodes=3)
@@ -51,10 +50,11 @@ def setUp(self):
 
     def min_cluster_size(self):
         # Override this since we're adding services outside of the constructor
-        return super(TestProducerConsumerCompat, self).min_cluster_size() + self.num_producers + self.num_consumers
+        return super(ClientCompatibilityProduceConsumeTest, self).min_cluster_size() + self.num_producers + self.num_consumers
 
-    # TODO: when KAFKA-4462 is fully implemented, we should test other versions here.
     @parametrize(broker_version=str(TRUNK))
+    @parametrize(broker_version=str(LATEST_0_10_0))
+    @parametrize(broker_version=str(LATEST_0_10_1))
     def test_produce_consume(self, broker_version):
         print("running producer_consumer_compat with broker_version = %s" % broker_version)
         self.kafka.set_version(KafkaVersion(broker_version))
diff --git a/tools/src/main/java/org/apache/kafka/tools/ClientCompatibilityTest.java b/tools/src/main/java/org/apache/kafka/tools/ClientCompatibilityTest.java
new file mode 100644
index 0000000000000..69202a06feafe
--- /dev/null
+++ b/tools/src/main/java/org/apache/kafka/tools/ClientCompatibilityTest.java
@@ -0,0 +1,359 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.kafka.tools;
+
+import static net.sourceforge.argparse4j.impl.Arguments.store;
+
+import net.sourceforge.argparse4j.ArgumentParsers;
+import net.sourceforge.argparse4j.inf.ArgumentParser;
+import net.sourceforge.argparse4j.inf.ArgumentParserException;
+import net.sourceforge.argparse4j.inf.Namespace;
+import org.apache.kafka.clients.consumer.ConsumerRecord;
+import org.apache.kafka.clients.consumer.ConsumerRecords;
+import org.apache.kafka.clients.consumer.KafkaConsumer;
+import org.apache.kafka.clients.consumer.OffsetAndTimestamp;
+import org.apache.kafka.clients.producer.KafkaProducer;
+import org.apache.kafka.clients.producer.ProducerConfig;
+import org.apache.kafka.clients.producer.ProducerRecord;
+import org.apache.kafka.clients.producer.RecordMetadata;
+import org.apache.kafka.common.ClusterResource;
+import org.apache.kafka.common.ClusterResourceListener;
+import org.apache.kafka.common.PartitionInfo;
+import org.apache.kafka.common.TopicPartition;
+import org.apache.kafka.common.errors.ObsoleteBrokerException;
+import org.apache.kafka.common.serialization.ByteArraySerializer;
+import org.apache.kafka.common.serialization.Deserializer;
+import org.apache.kafka.common.utils.Time;
+import org.apache.kafka.common.utils.Utils;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import java.nio.ByteBuffer;
+import java.util.Arrays;
+import java.util.Iterator;
+import java.util.LinkedList;
+import java.util.List;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.NoSuchElementException;
+import java.util.Properties;
+import java.util.concurrent.Future;
+
+/**
+ * ClientCompatibilityTest is invoked by the ducktape test client_compatibility_features_test.py to validate
+ * client behavior when various broker versions are in use.  It runs various client operations and tests whether they
+ * are supported or not.
+ */
+public class ClientCompatibilityTest {
+    private static final Logger log = LoggerFactory.getLogger(ClientCompatibilityTest.class);
+
+    static class TestConfig {
+        final String bootstrapServer;
+        final String topic;
+        final boolean offsetsForTimesSupported;
+        final boolean expectClusterId;
+
+        TestConfig(Namespace res) {
+            this.bootstrapServer = res.getString("bootstrapServer");
+            this.topic = res.getString("topic");
+            this.offsetsForTimesSupported = res.getBoolean("offsetsForTimesSupported");
+            this.expectClusterId = res.getBoolean("clusterIdSupported");
+        }
+    }
+
+    public static void main(String[] args) throws Exception {
+        ArgumentParser parser = ArgumentParsers
+            .newArgumentParser("client-compatibility-test")
+            .defaultHelp(true)
+            .description("This tool is used to verify client compatibility guarantees.");
+        parser.addArgument("--topic")
+            .action(store())
+            .required(true)
+            .type(String.class)
+            .dest("topic")
+            .metavar("TOPIC")
+            .help("the compatibility test will produce messages to this topic");
+        parser.addArgument("--bootstrap-server")
+            .action(store())
+            .required(true)
+            .type(String.class)
+            .dest("bootstrapServer")
+            .metavar("BOOTSTRAP_SERVER")
+            .help("The server(s) to use for bootstrapping");
+        parser.addArgument("--offsets-for-times-supported")
+            .action(store())
+            .required(true)
+            .type(Boolean.class)
+            .dest("offsetsForTimesSupported")
+            .metavar("OFFSETS_FOR_TIMES_SUPPORTED")
+            .help("True if KafkaConsumer#offsetsForTimes is supported by the current broker version");
+        parser.addArgument("--cluster-id-supported")
+            .action(store())
+            .required(true)
+            .type(Boolean.class)
+            .dest("clusterIdSupported")
+            .metavar("CLUSTER_ID_SUPPORTED")
+            .help("True if cluster IDs are supported.  False if cluster ID always appears as null.");
+        Namespace res = null;
+        try {
+            res = parser.parseArgs(args);
+        } catch (ArgumentParserException e) {
+            if (args.length == 0) {
+                parser.printHelp();
+                System.exit(0);
+            } else {
+                parser.handleError(e);
+                System.exit(1);
+            }
+        }
+        TestConfig testConfig = new TestConfig(res);
+        ClientCompatibilityTest test = new ClientCompatibilityTest(testConfig);
+        try {
+            test.run();
+        } catch (Throwable t) {
+            System.out.printf("FAILED: Caught exception %s\n\n", t.getMessage());
+            t.printStackTrace();
+            System.exit(1);
+        }
+        System.out.println("SUCCESS.");
+        System.exit(0);
+    }
+
+    private static byte[] asByteArray(long a) {
+        ByteBuffer buf = ByteBuffer.allocate(8);
+        buf.putLong(a);
+        return buf.array();
+    }
+
+    private static byte[] asByteArray(long a, long b) {
+        ByteBuffer buf = ByteBuffer.allocate(16);
+        buf.putLong(a);
+        buf.putLong(b);
+        return buf.array();
+    }
+
+    private static String toHexString(byte[] buf) {
+        StringBuilder bld = new StringBuilder();
+        for (byte b : buf) {
+            bld.append(String.format("%02x", b));
+        }
+        return bld.toString();
+    }
+
+    private static void compareArrays(byte[] a, byte[] b) {
+        if (!Arrays.equals(a, b)) {
+            throw new RuntimeException("Arrays did not match: expected " + toHexString(a) + ", got " + toHexString(b));
+        }
+    }
+
+    private final TestConfig testConfig;
+
+    private final byte[] message1;
+
+    private final byte[] message2;
+
+    ClientCompatibilityTest(TestConfig testConfig) {
+        this.testConfig = testConfig;
+        long curTime = Time.SYSTEM.milliseconds();
+        this.message1 = asByteArray(curTime);
+        this.message2 = asByteArray(curTime, curTime);
+    }
+
+    void run() throws Exception {
+        long prodTimeMs = Time.SYSTEM.milliseconds();
+        testProduce();
+        testConsume(prodTimeMs);
+    }
+
+    public void testProduce() throws Exception {
+        Properties producerProps = new Properties();
+        producerProps.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, testConfig.bootstrapServer);
+        ByteArraySerializer serializer = new ByteArraySerializer();
+        KafkaProducer<byte[], byte[]> producer = new KafkaProducer<>(producerProps, serializer, serializer);
+        ProducerRecord<byte[], byte[]> record1 = new ProducerRecord<>(testConfig.topic, message1);
+        Future<RecordMetadata> future1 = producer.send(record1);
+        ProducerRecord<byte[], byte[]> record2 = new ProducerRecord<>(testConfig.topic, message2);
+        Future<RecordMetadata> future2 = producer.send(record2);
+        producer.flush();
+        future1.get();
+        future2.get();
+        producer.close();
+    }
+
+    private static class OffsetsForTime {
+        Map<TopicPartition, OffsetAndTimestamp> result;
+
+        @Override
+        public String toString() {
+            return Utils.mkString(result);
+        }
+    }
+
+    public static class ClientCompatibilityTestDeserializer implements Deserializer<byte[]>, ClusterResourceListener {
+        private final boolean expectClusterId;
+
+        ClientCompatibilityTestDeserializer(boolean expectClusterId) {
+            this.expectClusterId = expectClusterId;
+        }
+
+        @Override
+        public void configure(Map<String, ?> configs, boolean isKey) {
+            // nothing to do
+        }
+
+        @Override
+        public byte[] deserialize(String topic, byte[] data) {
+            return data;
+        }
+
+        @Override
+        public void close() {
+            // nothing to do
+        }
+
+        @Override
+        public void onUpdate(ClusterResource clusterResource) {
+            if (expectClusterId) {
+                if (clusterResource.clusterId() == null) {
+                    throw new RuntimeException("Expected cluster id to be supported, but it was null.");
+                }
+            } else {
+                if (clusterResource.clusterId() != null) {
+                    throw new RuntimeException("Expected cluster id to be null, but it was supported.");
+                }
+            }
+        }
+    }
+
+    public void testConsume(final long prodTimeMs) throws Exception {
+        Properties consumerProps = new Properties();
+        consumerProps.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, testConfig.bootstrapServer);
+        ClientCompatibilityTestDeserializer deserializer =
+            new ClientCompatibilityTestDeserializer(testConfig.expectClusterId);
+        final KafkaConsumer<byte[], byte[]> consumer = new KafkaConsumer<>(consumerProps, deserializer, deserializer);
+        final List<PartitionInfo> partitionInfos = consumer.partitionsFor(testConfig.topic);
+        if (partitionInfos.size() < 1)
+            throw new RuntimeException("Expected at least one partition for topic " + testConfig.topic);
+        final Map<TopicPartition, Long> timestampsToSearch = new HashMap<>();
+        final LinkedList<TopicPartition> topicPartitions = new LinkedList<>();
+        for (PartitionInfo partitionInfo : partitionInfos) {
+            TopicPartition topicPartition = new TopicPartition(partitionInfo.topic(), partitionInfo.partition());
+            timestampsToSearch.put(topicPartition, prodTimeMs);
+            topicPartitions.add(topicPartition);
+        }
+        final OffsetsForTime offsetsForTime = new OffsetsForTime();
+        tryFeature("offsetsForTimes", testConfig.offsetsForTimesSupported,
+                new Runnable() {
+                    @Override
+                    public void run() {
+                        offsetsForTime.result = consumer.offsetsForTimes(timestampsToSearch);
+                    }
+                },
+                new Runnable() {
+                    @Override
+                    public void run() {
+                        log.info("offsetsForTime = {}", offsetsForTime.result);
+                    }
+                });
+        // Whether or not offsetsForTimes works, beginningOffsets and endOffsets
+        // should work.
+        consumer.beginningOffsets(timestampsToSearch.keySet());
+        consumer.endOffsets(timestampsToSearch.keySet());
+
+        consumer.assign(topicPartitions);
+        consumer.seekToBeginning(topicPartitions);
+        final Iterator<byte[]> iter = new Iterator<byte[]>() {
+            private final int timeoutMs = 10000;
+            private Iterator<ConsumerRecord<byte[], byte[]>> recordIter = null;
+            private byte[] next = null;
+
+            private byte[] fetchNext() {
+                while (true) {
+                    long curTime = Time.SYSTEM.milliseconds();
+                    if (curTime - prodTimeMs > timeoutMs)
+                        throw new RuntimeException("Timed out after " + timeoutMs + " ms.");
+                    if (recordIter == null) {
+                        ConsumerRecords<byte[], byte[]> records = consumer.poll(100);
+                        recordIter = records.iterator();
+                    }
+                    if (recordIter.hasNext())
+                        return recordIter.next().value();
+                    recordIter = null;
+                }
+            }
+
+            @Override
+            public boolean hasNext() {
+                if (next != null)
+                    return true;
+                next = fetchNext();
+                return next != null;
+            }
+
+            @Override
+            public byte[] next() {
+                if (!hasNext())
+                    throw new NoSuchElementException();
+                byte[] cur = next;
+                next = null;
+                return cur;
+            }
+
+            @Override
+            public void remove() {
+                throw new UnsupportedOperationException();
+            }
+        };
+
+        byte[] next = iter.next();
+        try {
+            compareArrays(message1, next);
+            log.debug("Found first message...");
+        } catch (RuntimeException e) {
+            throw new RuntimeException("The first message in this topic was not ours. Please use a new topic when " +
+                    "running this program.");
+        }
+        next = iter.next();
+        try {
+            compareArrays(message2, next);
+            log.debug("Found second message...");
+        } catch (RuntimeException e) {
+            throw new RuntimeException("The second message in this topic was not ours. Please use a new topic when " +
+                    "running this program.");
+        }
+        log.debug("Closing consumer.");
+        consumer.close();
+        log.info("Closed consumer.");
+    }
+
+    private void tryFeature(String featureName, boolean supported, Runnable invoker, Runnable resultTester) {
+        try {
+            invoker.run();
+            log.info("Successfully used feature {}", featureName);
+        } catch (ObsoleteBrokerException e) {
+            log.info("Got ObsoleteBrokerException when attempting to use feature {}", featureName);
+            if (supported) {
+                throw new RuntimeException("Expected " + featureName + " to be supported, but it wasn't.", e);
+            }
+            return;
+        }
+        if (!supported) {
+            throw new RuntimeException("Did not expect " + featureName + " to be supported, but it was.");
+        }
+        resultTester.run();
+    }
+}

From f8b8edd4e1145b04979bd841cdb98e4e9d64e090 Mon Sep 17 00:00:00 2001
From: Andrew Olson <aolson1@cerner.com>
Date: Tue, 24 Jan 2017 20:20:30 +0000
Subject: [PATCH 035/177] KAFKA-4687; Fix InvalidTopicException due to topic
 creation race condition

We now throw the correct TopicExistsException instead.

Author: Andrew Olson <aolson1@cerner.com>

Reviewers: Jason Gustafson <jason@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2425 from noslowerdna/KAFKA-4687

(cherry picked from commit 8dfb8afb93f3f1026f868466edb66a4cc63b4455)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../main/scala/kafka/admin/AdminUtils.scala    | 18 ++++++++++--------
 .../scala/unit/kafka/admin/AdminTest.scala     | 16 ++++++++++++++++
 .../kafka/server/CreateTopicsRequestTest.scala |  2 +-
 .../CreateTopicsRequestWithPolicyTest.scala    |  2 +-
 4 files changed, 28 insertions(+), 10 deletions(-)

diff --git a/core/src/main/scala/kafka/admin/AdminUtils.scala b/core/src/main/scala/kafka/admin/AdminUtils.scala
index 02d5fe07961d0..65ac91cf361b4 100644
--- a/core/src/main/scala/kafka/admin/AdminUtils.scala
+++ b/core/src/main/scala/kafka/admin/AdminUtils.scala
@@ -386,7 +386,7 @@ object AdminUtils extends Logging with AdminUtilities {
   }
 
   def topicExists(zkUtils: ZkUtils, topic: String): Boolean =
-    zkUtils.zkClient.exists(getTopicPath(topic))
+    zkUtils.pathExists(getTopicPath(topic))
 
   def getBrokerMetadatas(zkUtils: ZkUtils, rackAwareMode: RackAwareMode = RackAwareMode.Enforced,
                         brokerList: Option[Seq[Int]] = None): Seq[BrokerMetadata] = {
@@ -425,16 +425,18 @@ object AdminUtils extends Logging with AdminUtilities {
     // validate arguments
     Topic.validate(topic)
 
-    val topicPath = getTopicPath(topic)
-
     if (!update) {
-      if (zkUtils.zkClient.exists(topicPath))
-        throw new TopicExistsException("Topic \"%s\" already exists.".format(topic))
+      if (topicExists(zkUtils, topic))
+        throw new TopicExistsException(s"Topic '$topic' already exists.")
       else if (Topic.hasCollisionChars(topic)) {
         val allTopics = zkUtils.getAllTopics()
-        val collidingTopics = allTopics.filter(t => Topic.hasCollision(topic, t))
+        // check again in case the topic was created in the meantime, otherwise the
+        // topic could potentially collide with itself
+        if (allTopics.contains(topic))
+          throw new TopicExistsException(s"Topic '$topic' already exists.")
+        val collidingTopics = allTopics.filter(Topic.hasCollision(topic, _))
         if (collidingTopics.nonEmpty) {
-          throw new InvalidTopicException("Topic \"%s\" collides with existing topics: %s".format(topic, collidingTopics.mkString(", ")))
+          throw new InvalidTopicException(s"Topic '$topic' collides with existing topics: ${collidingTopics.mkString(", ")}")
         }
       }
     }
@@ -484,7 +486,7 @@ object AdminUtils extends Logging with AdminUtilities {
       }
       debug("Updated path %s with %s for replica assignment".format(zkPath, jsonPartitionData))
     } catch {
-      case _: ZkNodeExistsException => throw new TopicExistsException("topic %s already exists".format(topic))
+      case _: ZkNodeExistsException => throw new TopicExistsException(s"Topic '$topic' already exists.")
       case e2: Throwable => throw new AdminOperationException(e2.toString)
     }
   }
diff --git a/core/src/test/scala/unit/kafka/admin/AdminTest.scala b/core/src/test/scala/unit/kafka/admin/AdminTest.scala
index f9eb61c00aad7..aa3dbc4adc528 100755
--- a/core/src/test/scala/unit/kafka/admin/AdminTest.scala
+++ b/core/src/test/scala/unit/kafka/admin/AdminTest.scala
@@ -20,6 +20,7 @@ import kafka.server.DynamicConfig.Broker._
 import kafka.server.KafkaConfig._
 import org.apache.kafka.common.errors.{InvalidReplicaAssignmentException, InvalidReplicationFactorException, InvalidTopicException, TopicExistsException}
 import org.apache.kafka.common.metrics.Quota
+import org.easymock.EasyMock
 import org.junit.Assert._
 import org.junit.Test
 import java.util.Properties
@@ -159,6 +160,21 @@ class AdminTest extends ZooKeeperTestHarness with Logging with RackAwareTest {
     }
   }
 
+  @Test
+  def testConcurrentTopicCreation() {
+    val topic = "test.topic"
+
+    // simulate the ZK interactions that can happen when a topic is concurrently created by multiple processes
+    val zkMock = EasyMock.createNiceMock(classOf[ZkUtils])
+    EasyMock.expect(zkMock.pathExists(s"/brokers/topics/$topic")).andReturn(false)
+    EasyMock.expect(zkMock.getAllTopics).andReturn(Seq("some.topic", topic, "some.other.topic"))
+    EasyMock.replay(zkMock)
+
+    intercept[TopicExistsException] {
+      AdminUtils.validateCreateOrUpdateTopic(zkMock, topic, Map.empty, new Properties, update = false)
+    }
+  }
+
   private def getBrokersWithPartitionDir(servers: Iterable[KafkaServer], topic: String, partitionId: Int): Set[Int] = {
     servers.filter(server => new File(server.config.logDirs.head, topic + "-" + partitionId).exists)
            .map(_.config.brokerId)
diff --git a/core/src/test/scala/unit/kafka/server/CreateTopicsRequestTest.scala b/core/src/test/scala/unit/kafka/server/CreateTopicsRequestTest.scala
index e3b0bbe504939..6efa189a6c828 100644
--- a/core/src/test/scala/unit/kafka/server/CreateTopicsRequestTest.scala
+++ b/core/src/test/scala/unit/kafka/server/CreateTopicsRequestTest.scala
@@ -63,7 +63,7 @@ class CreateTopicsRequestTest extends AbstractCreateTopicsRequestTest {
 
     // Basic
     validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(Map(existingTopic -> new CreateTopicsRequest.TopicDetails(1, 1.toShort)).asJava, timeout).build(),
-      Map(existingTopic -> error(Errors.TOPIC_ALREADY_EXISTS, Some("""Topic "existing-topic" already exists."""))))
+      Map(existingTopic -> error(Errors.TOPIC_ALREADY_EXISTS, Some("Topic 'existing-topic' already exists."))))
     validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(Map("error-partitions" -> new CreateTopicsRequest.TopicDetails(-1, 1.toShort)).asJava, timeout).build(),
       Map("error-partitions" -> error(Errors.INVALID_PARTITIONS)), checkErrorMessage = false)
     validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(Map("error-replication" -> new CreateTopicsRequest.TopicDetails(1, (numBrokers + 1).toShort)).asJava, timeout).build(),
diff --git a/core/src/test/scala/unit/kafka/server/CreateTopicsRequestWithPolicyTest.scala b/core/src/test/scala/unit/kafka/server/CreateTopicsRequestWithPolicyTest.scala
index 80f6e9e096816..9affea47e3c48 100644
--- a/core/src/test/scala/unit/kafka/server/CreateTopicsRequestWithPolicyTest.scala
+++ b/core/src/test/scala/unit/kafka/server/CreateTopicsRequestWithPolicyTest.scala
@@ -77,7 +77,7 @@ class CreateTopicsRequestWithPolicyTest extends AbstractCreateTopicsRequestTest
     // Check that basic errors still work
     validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(
       Map(existingTopic -> new CreateTopicsRequest.TopicDetails(5, 1.toShort)).asJava, timeout).build(),
-      Map(existingTopic -> error(Errors.TOPIC_ALREADY_EXISTS, Some("""Topic "existing-topic" already exists."""))))
+      Map(existingTopic -> error(Errors.TOPIC_ALREADY_EXISTS, Some("Topic 'existing-topic' already exists."))))
 
     validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(
       Map("error-replication" -> new CreateTopicsRequest.TopicDetails(10, (numBrokers + 1).toShort)).asJava, timeout, true).build(),

From cd304076706d7ebb0b3ea7e638313a39ffd423e8 Mon Sep 17 00:00:00 2001
From: Ewen Cheslack-Postava <me@ewencp.org>
Date: Tue, 24 Jan 2017 13:19:03 -0800
Subject: [PATCH 036/177] KAFKA-4673: Fix thread-safety of Python
 VerifiableConsumer class

Author: Ewen Cheslack-Postava <me@ewencp.org>

Reviewers: Jason Gustafson <jason@confluent.io>

Closes #2427 from ewencp/kafka-4673-verifiable-consumer-thread-safety

(cherry picked from commit 9b8d99b1b866a90b07c8a9a61fe79a75d01ae272)
Signed-off-by: Ewen Cheslack-Postava <me@ewencp.org>
---
 .../kafkatest/services/verifiable_consumer.py | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/tests/kafkatest/services/verifiable_consumer.py b/tests/kafkatest/services/verifiable_consumer.py
index 090bcda8784fb..711554c07ce99 100644
--- a/tests/kafkatest/services/verifiable_consumer.py
+++ b/tests/kafkatest/services/verifiable_consumer.py
@@ -158,10 +158,11 @@ def __init__(self, context, num_nodes, kafka, topic, group_id,
             node.version = version
 
     def _worker(self, idx, node):
-        if node not in self.event_handlers:
-            self.event_handlers[node] = ConsumerEventHandler(node)
+        with self.lock:
+            if node not in self.event_handlers:
+                self.event_handlers[node] = ConsumerEventHandler(node)
+            handler = self.event_handlers[node]
 
-        handler = self.event_handlers[node]
         node.account.ssh("mkdir -p %s" % VerifiableConsumer.PERSISTENT_ROOT, allow_fail=False)
 
         # Create and upload log properties
@@ -267,7 +268,8 @@ def kill_node(self, node, clean_shutdown=True, allow_fail=False):
         for pid in self.pids(node):
             node.account.signal(pid, sig, allow_fail)
 
-        self.event_handlers[node].handle_kill_process(clean_shutdown)
+        with self.lock:
+            self.event_handlers[node].handle_kill_process(clean_shutdown)
 
     def stop_node(self, node, clean_shutdown=True):
         self.kill_node(node, clean_shutdown=clean_shutdown)
@@ -293,10 +295,11 @@ def current_position(self, tp):
                 return None
 
     def owner(self, tp):
-        for handler in self.event_handlers.itervalues():
-            if tp in handler.current_assignment():
-                return handler.node
-        return None
+        with self.lock:
+            for handler in self.event_handlers.itervalues():
+                if tp in handler.current_assignment():
+                    return handler.node
+            return None
 
     def last_commit(self, tp):
         with self.lock:

From 3a169837b864886f19c57dfaa6c9b3a188ffbb4d Mon Sep 17 00:00:00 2001
From: pengwei-li <pengwei.li@huawei.com>
Date: Tue, 24 Jan 2017 13:56:30 -0800
Subject: [PATCH 037/177] KAFKA-4229; Controller can't start after several zk
 expired event

Author: pengwei <pengwei.lihuawei.com>

Reviewers: wangguoz.gmail.com

Author: pengwei-li <pengwei.li@huawei.com>
Author: c00353482 <c00353482@huaweiobz.com>

Reviewers: Jun Rao <junrao@gmail.com>

Closes #2175 from pengwei-li/trunk

(cherry picked from commit 3f0168cd35c1baaa5a032e9a534f28a1bd9221b9)
Signed-off-by: Jun Rao <junrao@gmail.com>
---
 .../main/scala/kafka/controller/KafkaController.scala | 11 ++++++++---
 .../scala/kafka/server/ZookeeperLeaderElector.scala   |  2 +-
 2 files changed, 9 insertions(+), 4 deletions(-)
 mode change 100755 => 100644 core/src/main/scala/kafka/controller/KafkaController.scala
 mode change 100755 => 100644 core/src/main/scala/kafka/server/ZookeeperLeaderElector.scala

diff --git a/core/src/main/scala/kafka/controller/KafkaController.scala b/core/src/main/scala/kafka/controller/KafkaController.scala
old mode 100755
new mode 100644
index 8ffa610fe1bf6..b0ed8d7d32e8e
--- a/core/src/main/scala/kafka/controller/KafkaController.scala
+++ b/core/src/main/scala/kafka/controller/KafkaController.scala
@@ -1163,9 +1163,14 @@ class KafkaController(val config: KafkaConfig, zkUtils: ZkUtils, val brokerState
     @throws[Exception]
     def handleNewSession() {
       info("ZK expired; shut down all controller components and try to re-elect")
-      onControllerResignation()
-      inLock(controllerContext.controllerLock) {
-        controllerElector.elect
+      if (controllerElector.getControllerID() != config.brokerId) {
+        onControllerResignation()
+        inLock(controllerContext.controllerLock) {
+          controllerElector.elect
+        }
+      } else {
+        //maybe create by current session or the previous zk session's ephemeral node is not deleted
+        info("ZK expired, but the current controller id %d is the same as this broker id, skip re-elect".format(config.brokerId))
       }
     }
 
diff --git a/core/src/main/scala/kafka/server/ZookeeperLeaderElector.scala b/core/src/main/scala/kafka/server/ZookeeperLeaderElector.scala
old mode 100755
new mode 100644
index ca0f6a03d8eb5..f41782e5a460b
--- a/core/src/main/scala/kafka/server/ZookeeperLeaderElector.scala
+++ b/core/src/main/scala/kafka/server/ZookeeperLeaderElector.scala
@@ -52,7 +52,7 @@ class ZookeeperLeaderElector(controllerContext: ControllerContext,
     }
   }
 
-  private def getControllerID(): Int = {
+  def getControllerID(): Int = {
     controllerContext.zkUtils.readDataMaybeNull(electionPath)._1 match {
        case Some(controller) => KafkaController.parseControllerId(controller)
        case None => -1

From c1c680e18c01332a78848f6d837319e24daa8594 Mon Sep 17 00:00:00 2001
From: Jun Rao <junrao@gmail.com>
Date: Tue, 24 Jan 2017 15:17:26 -0800
Subject: [PATCH 038/177] trivial change to clarify comments in KAFKA-4229

---
 core/src/main/scala/kafka/controller/KafkaController.scala | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/core/src/main/scala/kafka/controller/KafkaController.scala b/core/src/main/scala/kafka/controller/KafkaController.scala
index b0ed8d7d32e8e..e38adf891fbe2 100644
--- a/core/src/main/scala/kafka/controller/KafkaController.scala
+++ b/core/src/main/scala/kafka/controller/KafkaController.scala
@@ -1169,7 +1169,9 @@ class KafkaController(val config: KafkaConfig, zkUtils: ZkUtils, val brokerState
           controllerElector.elect
         }
       } else {
-        //maybe create by current session or the previous zk session's ephemeral node is not deleted
+        // This can happen when there are multiple consecutive session expiration and handleNewSession() are called multiple
+        // times. The first call may already register the controller path using the newest ZK session. Therefore, the
+        // controller path will exist in subsequent calls to handleNewSession().
         info("ZK expired, but the current controller id %d is the same as this broker id, skip re-elect".format(config.brokerId))
       }
     }

From 3633489324ccc53fd0a9e30ac3c1bb4c7f13297b Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Tue, 24 Jan 2017 15:40:45 -0800
Subject: [PATCH 039/177] MINOR: close state store in CachingSessionStoreTest

close the sessions store in `After` to release rocksdb resources.

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2430 from dguy/minor-close-sesion-store

(cherry picked from commit 675881b0f1138c6c09ff4700b17f008ea9053aa4)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../streams/state/internals/CachingSessionStoreTest.java    | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java
index 65a249eb5c69c..047503137f927 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java
@@ -32,6 +32,7 @@
 import org.apache.kafka.streams.state.StateSerdes;
 import org.apache.kafka.test.MockProcessorContext;
 import org.apache.kafka.test.TestUtils;
+import org.junit.After;
 import org.junit.Before;
 import org.junit.Test;
 
@@ -69,6 +70,11 @@ public void setUp() throws Exception {
         cachingStore.init(context, cachingStore);
     }
 
+    @After
+    public void close() {
+        cachingStore.close();
+    }
+
     @Test
     public void shouldPutFetchFromCache() throws Exception {
         cachingStore.put(new Windowed<>("a", new SessionWindow(0, 0)), 1L);

From 218a7651a89df262ae4c8415b11ec771c9c812f8 Mon Sep 17 00:00:00 2001
From: Vahid Hashemian <vahidhashemian@us.ibm.com>
Date: Tue, 24 Jan 2017 16:24:19 -0800
Subject: [PATCH 040/177] MINOR: Update consumer group describe output in the
 documentation

Author: Vahid Hashemian <vahidhashemian@us.ibm.com>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2409 from vahidhashemian/doc/update_consumer_group_describe_output

(cherry picked from commit 63cf0e58775b8f0b4abf907866bd7c955500902c)
Signed-off-by: Ewen Cheslack-Postava <me@ewencp.org>
---
 docs/ops.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/ops.html b/docs/ops.html
index b500d6936f766..c5f621287ad01 100644
--- a/docs/ops.html
+++ b/docs/ops.html
@@ -168,8 +168,8 @@ <h4><a id="basic_ops_consumer_group" href="#basic_ops_consumer_group">Managing C
   <pre>
   &gt; bin/kafka-consumer-groups.sh --bootstrap-server broker1:9092 --describe --group test-consumer-group
 
-  GROUP                          TOPIC                          PARTITION  CURRENT-OFFSET  LOG-END-OFFSET  LAG             OWNER
-  test-consumer-group            test-foo                       0          1               3               2               consumer-1_/127.0.0.1
+  TOPIC                          PARTITION  CURRENT-OFFSET  LOG-END-OFFSET  LAG        CONSUMER-ID                                       HOST                           CLIENT-ID
+  test-foo                       0          1               3               2          consumer-1-a5d61779-4d04-4c50-a6d6-fb35d942642d   /127.0.0.1                     consumer-1
   </pre>
 
   If you are using the old high-level consumer and storing the group metadata in ZooKeeper (i.e. <code>offsets.storage=zookeeper</code>), pass

From d2d92b7ef990ce440ebe79056ca971fded517fb9 Mon Sep 17 00:00:00 2001
From: Jeyhun Karimov <je.karimov@gmail.com>
Date: Tue, 24 Jan 2017 16:36:31 -0800
Subject: [PATCH 041/177] KAFKA-3835; Streams is creating two ProducerRecords
 for each send via RecordCollector

Author: Jeyhun Karimov <je.karimov@gmail.com>

Reviewers: Matthias J. Sax, Guozhang Wang

Closes #2417 from jeyhunkarimov/KAFKA-3835

(cherry picked from commit abe19fe693d81ea65a018041f157c58ebecd014d)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../processor/internals/RecordCollector.java  |  19 ++-
 .../internals/RecordCollectorImpl.java        |  34 +++--
 .../streams/processor/internals/SinkNode.java |   3 +-
 .../internals/StandbyContextImpl.java         |  19 ++-
 .../state/internals/StoreChangeLogger.java    |   3 +-
 .../internals/RecordCollectorTest.java        |  48 +++----
 .../state/KeyValueStoreTestDriver.java        |  33 +++--
 .../ChangeLoggingKeyValueBytesStoreTest.java  |  11 +-
 .../ChangeLoggingKeyValueStoreTest.java       |  11 +-
 .../ChangeLoggingSegmentedBytesStoreTest.java |  11 +-
 .../RocksDBKeyValueStoreSupplierTest.java     |  20 ++-
 .../RocksDBSessionStoreSupplierTest.java      |  20 ++-
 .../RocksDBWindowStoreSupplierTest.java       |  20 ++-
 .../internals/RocksDBWindowStoreTest.java     | 133 ++++++++++++++----
 .../internals/StoreChangeLoggerTest.java      |  23 ++-
 .../apache/kafka/test/KStreamTestDriver.java  |  23 ++-
 .../kafka/test/NoOpRecordCollector.java       |  20 ++-
 17 files changed, 324 insertions(+), 127 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/RecordCollector.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/RecordCollector.java
index ec20d46b5531d..730b37dd6c42b 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/RecordCollector.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/RecordCollector.java
@@ -16,7 +16,6 @@
  */
 package org.apache.kafka.streams.processor.internals;
 
-import org.apache.kafka.clients.producer.ProducerRecord;
 import org.apache.kafka.common.TopicPartition;
 import org.apache.kafka.common.serialization.Serializer;
 import org.apache.kafka.streams.processor.StreamPartitioner;
@@ -24,9 +23,21 @@
 import java.util.Map;
 
 public interface RecordCollector {
-    <K, V> void send(ProducerRecord<K, V> record, Serializer<K> keySerializer, Serializer<V> valueSerializer);
-
-    <K, V> void send(ProducerRecord<K, V> record, Serializer<K> keySerializer, Serializer<V> valueSerializer,
+    <K, V> void send(final String topic,
+                     K key,
+                     V value,
+                     Integer partition,
+                     Long timestamp,
+                     Serializer<K> keySerializer,
+                     Serializer<V> valueSerializer);
+
+    <K, V> void send(final String topic,
+                     K key,
+                     V value,
+                     Integer partition,
+                     Long timestamp,
+                     Serializer<K> keySerializer,
+                     Serializer<V> valueSerializer,
                      StreamPartitioner<? super K, ? super V> partitioner);
 
     void flush();
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/RecordCollectorImpl.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/RecordCollectorImpl.java
index afb899919003b..f243d82568270 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/RecordCollectorImpl.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/RecordCollectorImpl.java
@@ -40,7 +40,7 @@ public class RecordCollectorImpl implements RecordCollector {
     private static final long SEND_RETRY_BACKOFF = 100L;
 
     private static final Logger log = LoggerFactory.getLogger(RecordCollectorImpl.class);
-
+    
     private final Producer<byte[], byte[]> producer;
     private final Map<TopicPartition, Long> offsets;
     private final String logPrefix;
@@ -54,26 +54,36 @@ public RecordCollectorImpl(Producer<byte[], byte[]> producer, String streamTaskI
     }
 
     @Override
-    public <K, V> void send(ProducerRecord<K, V> record, Serializer<K> keySerializer, Serializer<V> valueSerializer) {
-        send(record, keySerializer, valueSerializer, null);
+    public <K, V> void send(final String topic,
+                            K key,
+                            V value,
+                            Integer partition,
+                            Long timestamp,
+                            Serializer<K> keySerializer,
+                            Serializer<V> valueSerializer) {
+        send(topic, key, value, partition, timestamp, keySerializer, valueSerializer, null);
     }
 
     @Override
-    public <K, V> void send(ProducerRecord<K, V> record, Serializer<K> keySerializer, Serializer<V> valueSerializer,
-                            StreamPartitioner<? super K, ? super V> partitioner) {
+    public <K, V> void  send(final String topic,
+                             K key,
+                             V value,
+                             Integer partition,
+                             Long timestamp,
+                             Serializer<K> keySerializer,
+                             Serializer<V> valueSerializer,
+                             StreamPartitioner<? super K, ? super V> partitioner) {
         checkForException();
-        byte[] keyBytes = keySerializer.serialize(record.topic(), record.key());
-        byte[] valBytes = valueSerializer.serialize(record.topic(), record.value());
-        Integer partition = record.partition();
+        byte[] keyBytes = keySerializer.serialize(topic, key);
+        byte[] valBytes = valueSerializer.serialize(topic, value);
         if (partition == null && partitioner != null) {
-            List<PartitionInfo> partitions = this.producer.partitionsFor(record.topic());
+            List<PartitionInfo> partitions = this.producer.partitionsFor(topic);
             if (partitions != null && partitions.size() > 0)
-                partition = partitioner.partition(record.key(), record.value(), partitions.size());
+                partition = partitioner.partition(key, value, partitions.size());
         }
 
         ProducerRecord<byte[], byte[]> serializedRecord =
-                new ProducerRecord<>(record.topic(), partition, record.timestamp(), keyBytes, valBytes);
-        final String topic = serializedRecord.topic();
+                new ProducerRecord<>(topic, partition, timestamp, keyBytes, valBytes);
 
         for (int attempt = 1; attempt <= MAX_SEND_ATTEMPTS; attempt++) {
             try {
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/SinkNode.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/SinkNode.java
index c4db740d56159..f144079416fc4 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/SinkNode.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/SinkNode.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.streams.processor.internals;
 
-import org.apache.kafka.clients.producer.ProducerRecord;
 import org.apache.kafka.common.serialization.Serializer;
 import org.apache.kafka.streams.errors.StreamsException;
 import org.apache.kafka.streams.kstream.internals.ChangedSerializer;
@@ -77,7 +76,7 @@ public void process(final K key, final V value) {
         }
 
         try {
-            collector.send(new ProducerRecord<>(topic, null, timestamp, key, value), keySerializer, valSerializer, partitioner);
+            collector.send(topic, key, value, null, timestamp, keySerializer, valSerializer, partitioner);
         } catch (ClassCastException e) {
             throw new StreamsException(
                     String.format("A serializer (key: %s / value: %s) is not compatible to the actual key or value type " +
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StandbyContextImpl.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StandbyContextImpl.java
index 954c7107815f2..82f2714be9cb6 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StandbyContextImpl.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StandbyContextImpl.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.streams.processor.internals;
 
-import org.apache.kafka.clients.producer.ProducerRecord;
 import org.apache.kafka.common.TopicPartition;
 import org.apache.kafka.common.serialization.Serializer;
 import org.apache.kafka.streams.StreamsConfig;
@@ -33,12 +32,24 @@ class StandbyContextImpl extends AbstractProcessorContext implements RecordColle
 
     private static final RecordCollector NO_OP_COLLECTOR = new RecordCollector() {
         @Override
-        public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
-
+        public <K, V> void send(final String topic,
+                                K key,
+                                V value,
+                                Integer partition,
+                                Long timestamp,
+                                Serializer<K> keySerializer,
+                                Serializer<V> valueSerializer) {
         }
 
         @Override
-        public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer, final StreamPartitioner<? super K, ? super V> partitioner) {
+        public <K, V> void send(final String topic,
+                                K key,
+                                V value,
+                                Integer partition,
+                                Long timestamp,
+                                Serializer<K> keySerializer,
+                                Serializer<V> valueSerializer,
+                                StreamPartitioner<? super K, ? super V> partitioner) {
 
         }
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/StoreChangeLogger.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/StoreChangeLogger.java
index 44cda5be3887b..39c8270600bd6 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/StoreChangeLogger.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/StoreChangeLogger.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.streams.state.internals;
 
-import org.apache.kafka.clients.producer.ProducerRecord;
 import org.apache.kafka.common.serialization.Serializer;
 import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.internals.ProcessorStateManager;
@@ -58,7 +57,7 @@ void logChange(final K key, final V value) {
         if (collector != null) {
             final Serializer<K> keySerializer = serialization.keySerializer();
             final Serializer<V> valueSerializer = serialization.valueSerializer();
-            collector.send(new ProducerRecord<>(this.topic, this.partition, context.timestamp(), key, value), keySerializer, valueSerializer);
+            collector.send(this.topic, key, value, this.partition, context.timestamp(), keySerializer, valueSerializer);
         }
     }
 
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/RecordCollectorTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/RecordCollectorTest.java
index b54ce34796484..f0d06f715d7de 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/RecordCollectorTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/RecordCollectorTest.java
@@ -74,14 +74,14 @@ public void testSpecificPartition() {
                 new MockProducer<>(cluster, true, new DefaultPartitioner(), byteArraySerializer, byteArraySerializer),
                 "RecordCollectorTest-TestSpecificPartition");
 
-        collector.send(new ProducerRecord<>("topic1", 0, "999", "0"), stringSerializer, stringSerializer);
-        collector.send(new ProducerRecord<>("topic1", 0, "999", "0"), stringSerializer, stringSerializer);
-        collector.send(new ProducerRecord<>("topic1", 0, "999", "0"), stringSerializer, stringSerializer);
+        collector.send("topic1", "999", "0", 0, null, stringSerializer, stringSerializer);
+        collector.send("topic1", "999", "0", 0, null, stringSerializer, stringSerializer);
+        collector.send("topic1", "999", "0", 0, null, stringSerializer, stringSerializer);
 
-        collector.send(new ProducerRecord<>("topic1", 1, "999", "0"), stringSerializer, stringSerializer);
-        collector.send(new ProducerRecord<>("topic1", 1, "999", "0"), stringSerializer, stringSerializer);
+        collector.send("topic1", "999", "0", 1, null, stringSerializer, stringSerializer);
+        collector.send("topic1", "999", "0", 1, null, stringSerializer, stringSerializer);
 
-        collector.send(new ProducerRecord<>("topic1", 2, "999", "0"), stringSerializer, stringSerializer);
+        collector.send("topic1", "999", "0", 2, null, stringSerializer, stringSerializer);
 
         Map<TopicPartition, Long> offsets = collector.offsets();
 
@@ -90,9 +90,9 @@ public void testSpecificPartition() {
         assertEquals((Long) 0L, offsets.get(new TopicPartition("topic1", 2)));
 
         // ignore StreamPartitioner
-        collector.send(new ProducerRecord<>("topic1", 0, "999", "0"), stringSerializer, stringSerializer, streamPartitioner);
-        collector.send(new ProducerRecord<>("topic1", 1, "999", "0"), stringSerializer, stringSerializer, streamPartitioner);
-        collector.send(new ProducerRecord<>("topic1", 2, "999", "0"), stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "999", "0", 0, null, stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "999", "0", 1, null, stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "999", "0", 2, null, stringSerializer, stringSerializer, streamPartitioner);
 
         assertEquals((Long) 3L, offsets.get(new TopicPartition("topic1", 0)));
         assertEquals((Long) 2L, offsets.get(new TopicPartition("topic1", 1)));
@@ -106,17 +106,17 @@ public void testStreamPartitioner() {
                 new MockProducer<>(cluster, true, new DefaultPartitioner(), byteArraySerializer, byteArraySerializer),
                 "RecordCollectorTest-TestStreamPartitioner");
 
-        collector.send(new ProducerRecord<>("topic1", "3", "0"), stringSerializer, stringSerializer, streamPartitioner);
-        collector.send(new ProducerRecord<>("topic1", "9", "0"), stringSerializer, stringSerializer, streamPartitioner);
-        collector.send(new ProducerRecord<>("topic1", "27", "0"), stringSerializer, stringSerializer, streamPartitioner);
-        collector.send(new ProducerRecord<>("topic1", "81", "0"), stringSerializer, stringSerializer, streamPartitioner);
-        collector.send(new ProducerRecord<>("topic1", "243", "0"), stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "3", "0", null, null, stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "9", "0", null, null, stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "27", "0", null, null, stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "81", "0", null, null, stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "243", "0", null, null, stringSerializer, stringSerializer, streamPartitioner);
 
-        collector.send(new ProducerRecord<>("topic1", "28", "0"), stringSerializer, stringSerializer, streamPartitioner);
-        collector.send(new ProducerRecord<>("topic1", "82", "0"), stringSerializer, stringSerializer, streamPartitioner);
-        collector.send(new ProducerRecord<>("topic1", "244", "0"), stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "28", "0", null, null, stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "82", "0", null, null, stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "244", "0", null, null, stringSerializer, stringSerializer, streamPartitioner);
 
-        collector.send(new ProducerRecord<>("topic1", "245", "0"), stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "245", "0", null, null, stringSerializer, stringSerializer, streamPartitioner);
 
         Map<TopicPartition, Long> offsets = collector.offsets();
 
@@ -141,7 +141,7 @@ public synchronized Future<RecordMetadata> send(final ProducerRecord record, fin
                 },
                 "test");
 
-        collector.send(new ProducerRecord<>("topic1", "3", "0"), stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "3", "0", null, null, stringSerializer, stringSerializer, streamPartitioner);
         final Long offset = collector.offsets().get(new TopicPartition("topic1", 0));
         assertEquals(Long.valueOf(0L), offset);
     }
@@ -158,7 +158,7 @@ public synchronized Future<RecordMetadata> send(final ProducerRecord record, fin
                 },
                 "test");
 
-        collector.send(new ProducerRecord<>("topic1", "3", "0"), stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "3", "0", null, null, stringSerializer, stringSerializer, streamPartitioner);
 
     }
 
@@ -174,8 +174,8 @@ public synchronized Future<RecordMetadata> send(final ProducerRecord record, fin
                     }
                 },
                 "test");
-        collector.send(new ProducerRecord<>("topic1", "3", "0"), stringSerializer, stringSerializer, streamPartitioner);
-        collector.send(new ProducerRecord<>("topic1", "3", "0"), stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "3", "0", null, null, stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "3", "0", null, null, stringSerializer, stringSerializer, streamPartitioner);
     }
 
     @SuppressWarnings("unchecked")
@@ -190,7 +190,7 @@ public synchronized Future<RecordMetadata> send(final ProducerRecord record, fin
                     }
                 },
                 "test");
-        collector.send(new ProducerRecord<>("topic1", "3", "0"), stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "3", "0", null, null, stringSerializer, stringSerializer, streamPartitioner);
         collector.flush();
     }
 
@@ -206,7 +206,7 @@ public synchronized Future<RecordMetadata> send(final ProducerRecord record, fin
                     }
                 },
                 "test");
-        collector.send(new ProducerRecord<>("topic1", "3", "0"), stringSerializer, stringSerializer, streamPartitioner);
+        collector.send("topic1", "3", "0", null, null, stringSerializer, stringSerializer, streamPartitioner);
         collector.close();
     }
 
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/KeyValueStoreTestDriver.java b/streams/src/test/java/org/apache/kafka/streams/state/KeyValueStoreTestDriver.java
index efa0e0e629839..2f5b36851d27c 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/KeyValueStoreTestDriver.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/KeyValueStoreTestDriver.java
@@ -28,7 +28,6 @@
 import java.util.Set;
 import org.apache.kafka.clients.producer.MockProducer;
 import org.apache.kafka.clients.producer.Producer;
-import org.apache.kafka.clients.producer.ProducerRecord;
 import org.apache.kafka.common.metrics.JmxReporter;
 import org.apache.kafka.common.metrics.MetricConfig;
 import org.apache.kafka.common.metrics.Metrics;
@@ -203,20 +202,32 @@ protected KeyValueStoreTestDriver(final StateSerdes<K, V> serdes) {
         this.recordCollector = new RecordCollectorImpl(producer, "KeyValueStoreTestDriver") {
             @SuppressWarnings("unchecked")
             @Override
-            public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer) {
-                // for byte arrays we need to wrap it for comparison
-
-                K key = serdes.keyFrom(keySerializer.serialize(record.topic(), record.key()));
-                V value = serdes.valueFrom(valueSerializer.serialize(record.topic(), record.value()));
-
-                recordFlushed(key, value);
+            public <K1, V1> void send(final String topic,
+                                      K1 key,
+                                      V1 value,
+                                      Integer partition,
+                                      Long timestamp,
+                                      Serializer<K1> keySerializer,
+                                      Serializer<V1> valueSerializer) {
+            // for byte arrays we need to wrap it for comparison
+
+                K keyTest = serdes.keyFrom(keySerializer.serialize(topic, key));
+                V valueTest = serdes.valueFrom(valueSerializer.serialize(topic, value));
+
+                recordFlushed(keyTest, valueTest);
             }
 
             @Override
-            public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer,
-                                    StreamPartitioner<? super K1, ? super V1> partitioner) {
+            public <K1, V1> void send(final String topic,
+                                      K1 key,
+                                      V1 value,
+                                      Integer partition,
+                                      Long timestamp,
+                                      Serializer<K1> keySerializer,
+                                      Serializer<V1> valueSerializer,
+                                      StreamPartitioner<? super K1, ? super V1> partitioner) {
                 // ignore partitioner
-                send(record, keySerializer, valueSerializer);
+                send(topic, key, value, partition, timestamp, keySerializer, valueSerializer);
             }
         };
         this.stateDir = TestUtils.tempDirectory();
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStoreTest.java
index 99b13479dcdda..58b42e3b53bac 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStoreTest.java
@@ -16,7 +16,6 @@
  */
 package org.apache.kafka.streams.state.internals;
 
-import org.apache.kafka.clients.producer.ProducerRecord;
 import org.apache.kafka.common.metrics.Metrics;
 import org.apache.kafka.common.serialization.Serdes;
 import org.apache.kafka.common.serialization.Serializer;
@@ -53,8 +52,14 @@ public class ChangeLoggingKeyValueBytesStoreTest {
     public void before() {
         final NoOpRecordCollector collector = new NoOpRecordCollector() {
             @Override
-            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
-                sent.put(record.key(), record.value());
+            public <K, V> void send(final String topic,
+                                    K key,
+                                    V value,
+                                    Integer partition,
+                                    Long timestamp,
+                                    Serializer<K> keySerializer,
+                                    Serializer<V> valueSerializer) {
+                sent.put(key, value);
             }
         };
         final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java
index 2dc2017fd4862..d45f82e4ba06b 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStoreTest.java
@@ -16,7 +16,6 @@
  */
 package org.apache.kafka.streams.state.internals;
 
-import org.apache.kafka.clients.producer.ProducerRecord;
 import org.apache.kafka.common.metrics.Metrics;
 import org.apache.kafka.common.serialization.Serde;
 import org.apache.kafka.common.serialization.Serdes;
@@ -61,8 +60,14 @@ public class ChangeLoggingKeyValueStoreTest {
     public void before() {
         final NoOpRecordCollector collector = new NoOpRecordCollector() {
             @Override
-            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
-                sent.put(record.key(), record.value());
+            public <K, V> void send(final String topic,
+                                    K key,
+                                    V value,
+                                    Integer partition,
+                                    Long timestamp,
+                                    Serializer<K> keySerializer,
+                                    Serializer<V> valueSerializer) {
+                sent.put(key, value);
             }
         };
         final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStoreTest.java
index 51f31bf392e21..6ba7b14f43623 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStoreTest.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.streams.state.internals;
 
-import org.apache.kafka.clients.producer.ProducerRecord;
 import org.apache.kafka.common.metrics.Metrics;
 import org.apache.kafka.common.serialization.Serdes;
 import org.apache.kafka.common.serialization.Serializer;
@@ -48,8 +47,14 @@ public class ChangeLoggingSegmentedBytesStoreTest {
     public void setUp() throws Exception {
         final NoOpRecordCollector collector = new NoOpRecordCollector() {
             @Override
-            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
-                sent.put(record.key(), record.value());
+            public <K, V> void send(final String topic,
+                                    K key,
+                                    V value,
+                                    Integer partition,
+                                    Long timestamp,
+                                    Serializer<K> keySerializer,
+                                    Serializer<V> valueSerializer) {
+                sent.put(key, value);
             }
         };
         final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplierTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplierTest.java
index c51008931c084..304772b4ec52f 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplierTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBKeyValueStoreSupplierTest.java
@@ -62,8 +62,14 @@ public void shouldCreateLoggingEnabledStoreWhenStoreLogged() throws Exception {
         final List<ProducerRecord> logged = new ArrayList<>();
         final NoOpRecordCollector collector = new NoOpRecordCollector() {
             @Override
-            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
-                logged.add(record);
+            public <K, V> void send(final String topic,
+                                    K key,
+                                    V value,
+                                    Integer partition,
+                                    Long timestamp,
+                                    Serializer<K> keySerializer,
+                                    Serializer<V> valueSerializer) {
+                logged.add(new ProducerRecord<K, V>(topic, partition, timestamp, key, value));
             }
         };
         final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
@@ -83,8 +89,14 @@ public void shouldNotBeLoggingEnabledStoreWhenLoggingNotEnabled() throws Excepti
         final List<ProducerRecord> logged = new ArrayList<>();
         final NoOpRecordCollector collector = new NoOpRecordCollector() {
             @Override
-            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
-                logged.add(record);
+            public <K, V> void send(final String topic,
+                                    K key,
+                                    V value,
+                                    Integer partition,
+                                    Long timestamp,
+                                    Serializer<K> keySerializer,
+                                    Serializer<V> valueSerializer) {
+                logged.add(new ProducerRecord<K, V>(topic, partition, timestamp, key, value));
             }
         };
         final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplierTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplierTest.java
index 6677624e59627..48618b7e7343e 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplierTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreSupplierTest.java
@@ -65,8 +65,14 @@ public void shouldCreateLoggingEnabledStoreWhenStoreLogged() throws Exception {
         final List<ProducerRecord> logged = new ArrayList<>();
         final NoOpRecordCollector collector = new NoOpRecordCollector() {
             @Override
-            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
-                logged.add(record);
+            public <K, V> void send(final String topic,
+                                    K key,
+                                    V value,
+                                    Integer partition,
+                                    Long timestamp,
+                                    Serializer<K> keySerializer,
+                                    Serializer<V> valueSerializer) {
+                logged.add(new ProducerRecord<K, V>(topic, partition, timestamp, key, value));
             }
         };
         final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
@@ -86,8 +92,14 @@ public void shouldNotBeLoggingEnabledStoreWhenLoggingNotEnabled() throws Excepti
         final List<ProducerRecord> logged = new ArrayList<>();
         final NoOpRecordCollector collector = new NoOpRecordCollector() {
             @Override
-            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
-                logged.add(record);
+            public <K, V> void send(final String topic,
+                                    K key,
+                                    V value,
+                                    Integer partition,
+                                    Long timestamp,
+                                    Serializer<K> keySerializer,
+                                    Serializer<V> valueSerializer) {
+                logged.add(new ProducerRecord<K, V>(topic, partition, timestamp, key, value));
             }
         };
         final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplierTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplierTest.java
index d9a0d4f3554fb..98fac08694ad1 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplierTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreSupplierTest.java
@@ -62,8 +62,14 @@ public void shouldCreateLoggingEnabledStoreWhenWindowStoreLogged() throws Except
         final List<ProducerRecord> logged = new ArrayList<>();
         final NoOpRecordCollector collector = new NoOpRecordCollector() {
             @Override
-            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
-                logged.add(record);
+            public <K, V> void send(final String topic,
+                                    K key,
+                                    V value,
+                                    Integer partition,
+                                    Long timestamp,
+                                    Serializer<K> keySerializer,
+                                    Serializer<V> valueSerializer) {
+                logged.add(new ProducerRecord<K, V>(topic, partition, timestamp, key, value));
             }
         };
         final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
@@ -83,8 +89,14 @@ public void shouldNotBeLoggingEnabledStoreWhenLogginNotEnabled() throws Exceptio
         final List<ProducerRecord> logged = new ArrayList<>();
         final NoOpRecordCollector collector = new NoOpRecordCollector() {
             @Override
-            public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
-                logged.add(record);
+            public <K, V> void send(final String topic,
+                                    K key,
+                                    V value,
+                                    Integer partition,
+                                    Long timestamp,
+                                    Serializer<K> keySerializer,
+                                    Serializer<V> valueSerializer) {
+                logged.add(new ProducerRecord<K, V>(topic, partition, timestamp, key, value));
             }
         };
         final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java
index ee846f7383c10..d606e84eb8f5a 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java
@@ -19,7 +19,6 @@
 
 import org.apache.kafka.clients.producer.MockProducer;
 import org.apache.kafka.clients.producer.Producer;
-import org.apache.kafka.clients.producer.ProducerRecord;
 import org.apache.kafka.common.metrics.Metrics;
 import org.apache.kafka.common.serialization.Serde;
 import org.apache.kafka.common.serialization.Serdes;
@@ -95,7 +94,13 @@ public void shouldOnlyIterateOpenSegments() throws Exception {
         Producer<byte[], byte[]> producer = new MockProducer<>(true, byteArraySerde.serializer(), byteArraySerde.serializer());
         RecordCollector recordCollector = new RecordCollectorImpl(producer, "RocksDBWindowStoreTest-ShouldOnlyIterateOpenSegments") {
             @Override
-            public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer) {
+            public <K1, V1> void send(final String topic,
+                                      K1 key,
+                                      V1 value,
+                                      Integer partition,
+                                      Long timestamp,
+                                      Serializer<K1> keySerializer,
+                                      Serializer<V1> valueSerializer) {
             }
         };
 
@@ -142,10 +147,16 @@ public void testPutAndFetch() throws IOException {
             Producer<byte[], byte[]> producer = new MockProducer<>(true, byteArraySerde.serializer(), byteArraySerde.serializer());
             RecordCollector recordCollector = new RecordCollectorImpl(producer, "RocksDBWindowStoreTest-TestPutAndFetch") {
                 @Override
-                public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer) {
+                public <K1, V1> void send(final String topic,
+                                          K1 key,
+                                          V1 value,
+                                          Integer partition,
+                                          Long timestamp,
+                                          Serializer<K1> keySerializer,
+                                          Serializer<V1> valueSerializer) {
                     changeLog.add(new KeyValue<>(
-                                    keySerializer.serialize(record.topic(), record.key()),
-                                    valueSerializer.serialize(record.topic(), record.value()))
+                                    keySerializer.serialize(topic, key),
+                                    valueSerializer.serialize(topic, value))
                     );
                 }
             };
@@ -216,10 +227,16 @@ public void testPutAndFetchBefore() throws IOException {
             Producer<byte[], byte[]> producer = new MockProducer<>(true, byteArraySerde.serializer(), byteArraySerde.serializer());
             RecordCollector recordCollector = new RecordCollectorImpl(producer, "RocksDBWindowStoreTest-TestPutAndFetchBefore") {
                 @Override
-                public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer) {
+                public <K1, V1> void send(final String topic,
+                                          K1 key,
+                                          V1 value,
+                                          Integer partition,
+                                          Long timestamp,
+                                          Serializer<K1> keySerializer,
+                                          Serializer<V1> valueSerializer) {
                     changeLog.add(new KeyValue<>(
-                                    keySerializer.serialize(record.topic(), record.key()),
-                                    valueSerializer.serialize(record.topic(), record.value()))
+                                    keySerializer.serialize(topic, key),
+                                    valueSerializer.serialize(topic, value))
                     );
                 }
             };
@@ -305,10 +322,16 @@ public void testPutAndFetchAfter() throws IOException {
             Producer<byte[], byte[]> producer = new MockProducer<>(true, byteArraySerde.serializer(), byteArraySerde.serializer());
             RecordCollector recordCollector = new RecordCollectorImpl(producer, "RocksDBWindowStoreTest-TestPutAndFetchAfter") {
                 @Override
-                public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer) {
+                public <K1, V1> void send(final String topic,
+                                          K1 key,
+                                          V1 value,
+                                          Integer partition,
+                                          Long timestamp,
+                                          Serializer<K1> keySerializer,
+                                          Serializer<V1> valueSerializer) {
                     changeLog.add(new KeyValue<>(
-                                    keySerializer.serialize(record.topic(), record.key()),
-                                    valueSerializer.serialize(record.topic(), record.value()))
+                                    keySerializer.serialize(topic, key),
+                                    valueSerializer.serialize(topic, value))
                     );
                 }
             };
@@ -392,10 +415,16 @@ public void testPutSameKeyTimestamp() throws IOException {
             Producer<byte[], byte[]> producer = new MockProducer<>(true, byteArraySerde.serializer(), byteArraySerde.serializer());
             RecordCollector recordCollector = new RecordCollectorImpl(producer, "RocksDBWindowStoreTest-TestPutSameKeyTimestamp") {
                 @Override
-                public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer) {
+                public <K1, V1> void send(final String topic,
+                                          K1 key,
+                                          V1 value,
+                                          Integer partition,
+                                          Long timestamp,
+                                          Serializer<K1> keySerializer,
+                                          Serializer<V1> valueSerializer) {
                     changeLog.add(new KeyValue<>(
-                                    keySerializer.serialize(record.topic(), record.key()),
-                                    valueSerializer.serialize(record.topic(), record.value()))
+                                    keySerializer.serialize(topic, key),
+                                    valueSerializer.serialize(topic, value))
                     );
                 }
             };
@@ -448,10 +477,16 @@ public void testCachingEnabled() throws IOException {
             Producer<byte[], byte[]> producer = new MockProducer<>(true, byteArraySerde.serializer(), byteArraySerde.serializer());
             RecordCollector recordCollector = new RecordCollectorImpl(producer, "anyTaskID") {
                 @Override
-                public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer) {
+                public <K1, V1> void send(final String topic,
+                                          K1 key,
+                                          V1 value,
+                                          Integer partition,
+                                          Long timestamp,
+                                          Serializer<K1> keySerializer,
+                                          Serializer<V1> valueSerializer) {
                     changeLog.add(new KeyValue<>(
-                        keySerializer.serialize(record.topic(), record.key()),
-                        valueSerializer.serialize(record.topic(), record.value()))
+                        keySerializer.serialize(topic, key),
+                        valueSerializer.serialize(topic, value))
                     );
                 }
             };
@@ -476,10 +511,16 @@ public void testRolling() throws IOException {
             Producer<byte[], byte[]> producer = new MockProducer<>(true, byteArraySerde.serializer(), byteArraySerde.serializer());
             RecordCollector recordCollector = new RecordCollectorImpl(producer, "RocksDBWindowStoreTest-TestRolling") {
                 @Override
-                public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer) {
+                public <K1, V1> void send(final String topic,
+                                          K1 key,
+                                          V1 value,
+                                          Integer partition,
+                                          Long timestamp,
+                                          Serializer<K1> keySerializer,
+                                          Serializer<V1> valueSerializer) {
                     changeLog.add(new KeyValue<>(
-                                    keySerializer.serialize(record.topic(), record.key()),
-                                    valueSerializer.serialize(record.topic(), record.value()))
+                                    keySerializer.serialize(topic, key),
+                                    valueSerializer.serialize(topic, value))
                     );
                 }
             };
@@ -604,10 +645,16 @@ public void testRestore() throws IOException {
             Producer<byte[], byte[]> producer = new MockProducer<>(true, byteArraySerde.serializer(), byteArraySerde.serializer());
             RecordCollector recordCollector = new RecordCollectorImpl(producer, "RocksDBWindowStoreTest-TestRestore") {
                 @Override
-                public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer) {
+                public <K1, V1> void send(final String topic,
+                                          K1 key,
+                                          V1 value,
+                                          Integer partition,
+                                          Long timestamp,
+                                          Serializer<K1> keySerializer,
+                                          Serializer<V1> valueSerializer) {
                     changeLog.add(new KeyValue<>(
-                                    keySerializer.serialize(record.topic(), record.key()),
-                                    valueSerializer.serialize(record.topic(), record.value()))
+                                    keySerializer.serialize(topic, key),
+                                    valueSerializer.serialize(topic, value))
                     );
                 }
             };
@@ -653,10 +700,16 @@ public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySeria
             Producer<byte[], byte[]> producer = new MockProducer<>(true, byteArraySerde.serializer(), byteArraySerde.serializer());
             RecordCollector recordCollector = new RecordCollectorImpl(producer, "RocksDBWindowStoreTest-TestRestoreII") {
                 @Override
-                public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer) {
+                public <K1, V1> void send(final String topic,
+                                          K1 key,
+                                          V1 value,
+                                          Integer partition,
+                                          Long timestamp,
+                                          Serializer<K1> keySerializer,
+                                          Serializer<V1> valueSerializer) {
                     changeLog.add(new KeyValue<>(
-                                    keySerializer.serialize(record.topic(), record.key()),
-                                    valueSerializer.serialize(record.topic(), record.value()))
+                                    keySerializer.serialize(topic, key),
+                                    valueSerializer.serialize(topic, value))
                     );
                 }
             };
@@ -704,8 +757,14 @@ public void testSegmentMaintenance() throws IOException {
             Producer<byte[], byte[]> producer = new MockProducer<>(true, byteArraySerde.serializer(), byteArraySerde.serializer());
             RecordCollector recordCollector = new RecordCollectorImpl(producer, "RocksDBWindowStoreTest-TestSegmentMaintenance") {
                 @Override
-                public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer) {
-                    // do nothing
+                public <K1, V1> void send(final String topic,
+                                          K1 key,
+                                          V1 value,
+                                          Integer partition,
+                                          Long timestamp,
+                                          Serializer<K1> keySerializer,
+                                          Serializer<V1> valueSerializer) {
+                // do nothing
                 }
             };
 
@@ -804,8 +863,14 @@ public void testInitialLoading() throws IOException {
             Producer<byte[], byte[]> producer = new MockProducer<>(true, byteArraySerde.serializer(), byteArraySerde.serializer());
             RecordCollector recordCollector = new RecordCollectorImpl(producer, "RocksDBWindowStoreTest-TestInitialLoading") {
                 @Override
-                public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer) {
-                    // do nothing
+                public <K1, V1> void send(final String topic,
+                                          K1 key,
+                                          V1 value,
+                                          Integer partition,
+                                          Long timestamp,
+                                          Serializer<K1> keySerializer,
+                                          Serializer<V1> valueSerializer) {
+                // do nothing
                 }
             };
 
@@ -865,7 +930,13 @@ public void shouldCloseOpenIteratorsWhenStoreIsClosedAndThrowInvalidStateStoreEx
         Producer<byte[], byte[]> producer = new MockProducer<>(true, byteArraySerde.serializer(), byteArraySerde.serializer());
         RecordCollector recordCollector = new RecordCollectorImpl(producer, "RocksDBWindowStoreTest-ShouldOnlyIterateOpenSegments") {
             @Override
-            public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer) {
+            public <K1, V1> void send(final String topic,
+                                      K1 key,
+                                      V1 value,
+                                      Integer partition,
+                                      Long timestamp,
+                                      Serializer<K1> keySerializer,
+                                      Serializer<V1> valueSerializer) {
             }
         };
 
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/StoreChangeLoggerTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/StoreChangeLoggerTest.java
index 82e524e9a0083..9b2bd538dbc9a 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/StoreChangeLoggerTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/StoreChangeLoggerTest.java
@@ -23,7 +23,6 @@
 import java.util.HashMap;
 import java.util.Map;
 
-import org.apache.kafka.clients.producer.ProducerRecord;
 import org.apache.kafka.common.serialization.Serializer;
 import org.apache.kafka.streams.processor.StreamPartitioner;
 import org.apache.kafka.streams.processor.internals.RecordCollectorImpl;
@@ -45,15 +44,27 @@ public class StoreChangeLoggerTest {
             new RecordCollectorImpl(null, "StoreChangeLoggerTest") {
                 @SuppressWarnings("unchecked")
                 @Override
-                public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer) {
-                    logged.put((Integer) record.key(), (String) record.value());
+                public <K1, V1> void send(final String topic,
+                                          K1 key,
+                                          V1 value,
+                                          Integer partition,
+                                          Long timestamp,
+                                          Serializer<K1> keySerializer,
+                                          Serializer<V1> valueSerializer) {
+                    logged.put((Integer) key, (String) value);
                 }
 
                 @Override
-                public <K1, V1> void send(ProducerRecord<K1, V1> record, Serializer<K1> keySerializer, Serializer<V1> valueSerializer,
-                                          StreamPartitioner<? super K1, ? super V1> partitioner) {
+                public <K1, V1> void send(final String topic,
+                                           K1 key,
+                                           V1 value,
+                                           Integer partition,
+                                           Long timestamp,
+                                           Serializer<K1> keySerializer,
+                                           Serializer<V1> valueSerializer,
+                                           StreamPartitioner<? super K1, ? super V1> partitioner) {
                     // ignore partitioner
-                    send(record, keySerializer, valueSerializer);
+                    send(topic, key, value, partition, timestamp, keySerializer, valueSerializer);
                 }
             }
     );
diff --git a/streams/src/test/java/org/apache/kafka/test/KStreamTestDriver.java b/streams/src/test/java/org/apache/kafka/test/KStreamTestDriver.java
index 207705c89e45d..011532baeef39 100644
--- a/streams/src/test/java/org/apache/kafka/test/KStreamTestDriver.java
+++ b/streams/src/test/java/org/apache/kafka/test/KStreamTestDriver.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.test;
 
-import org.apache.kafka.clients.producer.ProducerRecord;
 import org.apache.kafka.common.metrics.Metrics;
 import org.apache.kafka.common.serialization.Serde;
 import org.apache.kafka.common.serialization.Serdes;
@@ -213,16 +212,28 @@ private class MockRecordCollector extends RecordCollectorImpl {
         }
 
         @Override
-        public <K, V> void send(ProducerRecord<K, V> record, Serializer<K> keySerializer, Serializer<V> valueSerializer,
+        public <K, V> void send(final String topic,
+                                K key,
+                                V value,
+                                Integer partition,
+                                Long timestamp,
+                                Serializer<K> keySerializer,
+                                Serializer<V> valueSerializer,
                                 StreamPartitioner<? super K, ? super V> partitioner) {
             // The serialization is skipped.
-            process(record.topic(), record.key(), record.value());
+            process(topic, key, value);
         }
 
         @Override
-        public <K, V> void send(ProducerRecord<K, V> record, Serializer<K> keySerializer, Serializer<V> valueSerializer) {
-            // The serialization is skipped.
-            process(record.topic(), record.key(), record.value());
+        public <K, V> void send(final String topic,
+                                K key,
+                                V value,
+                                Integer partition,
+                                Long timestamp,
+                                Serializer<K> keySerializer,
+                                Serializer<V> valueSerializer) {
+        // The serialization is skipped.
+            process(topic, key, value);
         }
 
         @Override
diff --git a/streams/src/test/java/org/apache/kafka/test/NoOpRecordCollector.java b/streams/src/test/java/org/apache/kafka/test/NoOpRecordCollector.java
index 0fe4d63a854c3..c2833ad942642 100644
--- a/streams/src/test/java/org/apache/kafka/test/NoOpRecordCollector.java
+++ b/streams/src/test/java/org/apache/kafka/test/NoOpRecordCollector.java
@@ -16,7 +16,6 @@
  */
 package org.apache.kafka.test;
 
-import org.apache.kafka.clients.producer.ProducerRecord;
 import org.apache.kafka.common.TopicPartition;
 import org.apache.kafka.common.serialization.Serializer;
 import org.apache.kafka.streams.processor.StreamPartitioner;
@@ -28,12 +27,25 @@
 public class NoOpRecordCollector implements RecordCollector {
 
     @Override
-    public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer) {
-        // no-op
+    public <K, V> void send(final String topic,
+                            K key,
+                            V value,
+                            Integer partition,
+                            Long timestamp,
+                            Serializer<K> keySerializer,
+                            Serializer<V> valueSerializer) {
+    // no-op
     }
 
     @Override
-    public <K, V> void send(final ProducerRecord<K, V> record, final Serializer<K> keySerializer, final Serializer<V> valueSerializer, final StreamPartitioner<? super K, ? super V> partitioner) {
+    public <K, V> void send(final String topic,
+                                K key,
+                                V value,
+                                Integer partition,
+                                Long timestamp,
+                                Serializer<K> keySerializer,
+                                Serializer<V> valueSerializer,
+                                StreamPartitioner<? super K, ? super V> partitioner) {
         // no-op
     }
 

From 87bd754095c3dd24daf13f4078a7bb28028a4a9d Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Tue, 17 Jan 2017 18:14:43 -0800
Subject: [PATCH 042/177] MINOR: remove ZK from system tests

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2391 from mjsax/kafka-4060-zk-follow-up-system-tests
---
 .../kafka/streams/perf/SimpleBenchmark.java   | 26 ++++++++-----------
 .../smoketest/ShutdownDeadlockTest.java       |  7 +----
 .../streams/smoketest/SmokeTestClient.java    |  8 +++---
 .../streams/smoketest/SmokeTestDriver.java    |  8 +++---
 .../streams/smoketest/StreamsSmokeTest.java   | 10 +++----
 5 files changed, 23 insertions(+), 36 deletions(-)

diff --git a/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java b/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java
index db3752db46961..90226c126a0df 100644
--- a/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java
+++ b/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java
@@ -57,7 +57,6 @@
 public class SimpleBenchmark {
 
     private final String kafka;
-    private final String zookeeper;
     private final File stateDir;
 
     private static final String SOURCE_TOPIC = "simpleBenchmarkSourceTopic";
@@ -91,18 +90,16 @@ public byte[] apply(final byte[] value1, final byte[] value2) {
     private static final Serde<byte[]> BYTE_SERDE = Serdes.ByteArray();
     private static final Serde<Integer> INTEGER_SERDE = Serdes.Integer();
 
-    public SimpleBenchmark(File stateDir, String kafka, String zookeeper) {
+    public SimpleBenchmark(File stateDir, String kafka) {
         super();
         this.stateDir = stateDir;
         this.kafka = kafka;
-        this.zookeeper = zookeeper;
     }
 
     public static void main(String[] args) throws Exception {
         String kafka = args.length > 0 ? args[0] : "localhost:9092";
-        String zookeeper = args.length > 1 ? args[1] : "localhost:2181";
-        String stateDirStr = args.length > 2 ? args[2] : "/tmp/kafka-streams-simple-benchmark";
-        numRecords = args.length > 3 ? Integer.parseInt(args[3]) : 10000000;
+        String stateDirStr = args.length > 1 ? args[1] : "/tmp/kafka-streams-simple-benchmark";
+        numRecords = args.length > 2 ? Integer.parseInt(args[2]) : 10000000;
         endKey = numRecords - 1;
 
         final File stateDir = new File(stateDirStr);
@@ -113,11 +110,10 @@ public static void main(String[] args) throws Exception {
         // Note: this output is needed for automated tests and must not be removed
         System.out.println("StreamsTest instance started");
         System.out.println("kafka=" + kafka);
-        System.out.println("zookeeper=" + zookeeper);
         System.out.println("stateDir=" + stateDir);
         System.out.println("numRecords=" + numRecords);
 
-        SimpleBenchmark benchmark = new SimpleBenchmark(stateDir, kafka, zookeeper);
+        SimpleBenchmark benchmark = new SimpleBenchmark(stateDir, kafka);
 
         // producer performance
         benchmark.produce(SOURCE_TOPIC, VALUE_SIZE, "simple-benchmark-produce", numRecords, true, numRecords, true);
@@ -239,7 +235,7 @@ private void runJoinBenchmark(final KafkaStreams streams, final String nameOfBen
     public void processStream(String topic) {
         CountDownLatch latch = new CountDownLatch(1);
 
-        final KafkaStreams streams = createKafkaStreams(topic, stateDir, kafka, zookeeper, latch);
+        final KafkaStreams streams = createKafkaStreams(topic, stateDir, kafka, latch);
 
         Thread thread = new Thread() {
             public void run() {
@@ -273,7 +269,7 @@ public void run() {
     public void processStreamWithSink(String topic) {
         CountDownLatch latch = new CountDownLatch(1);
 
-        final KafkaStreams streams = createKafkaStreamsWithSink(topic, stateDir, kafka, zookeeper, latch);
+        final KafkaStreams streams = createKafkaStreamsWithSink(topic, stateDir, kafka, latch);
 
         Thread thread = new Thread() {
             public void run() {
@@ -337,7 +333,7 @@ public void run() {
     public void processStreamWithStateStore(String topic) {
         CountDownLatch latch = new CountDownLatch(1);
 
-        final KafkaStreams streams = createKafkaStreamsWithStateStore(topic, stateDir, kafka, zookeeper, latch, false);
+        final KafkaStreams streams = createKafkaStreamsWithStateStore(topic, stateDir, kafka, latch, false);
         internalProcessStreamWithStore(streams, latch, "Streams Performance [MB/sec read+store]: ");
 
     }
@@ -345,7 +341,7 @@ public void processStreamWithStateStore(String topic) {
     public void processStreamWithCachedStateStore(String topic) {
         CountDownLatch latch = new CountDownLatch(1);
 
-        final KafkaStreams streams = createKafkaStreamsWithStateStore(topic, stateDir, kafka, zookeeper, latch, true);
+        final KafkaStreams streams = createKafkaStreamsWithStateStore(topic, stateDir, kafka, latch, true);
 
         internalProcessStreamWithStore(streams, latch, "Streams Performance [MB/sec read+cache+store]: ");
     }
@@ -433,7 +429,7 @@ public void consume(String topic) {
         System.out.println("Consumer Performance [MB/sec read]: " + megaBytePerSec(endTime - startTime));
     }
 
-    private KafkaStreams createKafkaStreams(String topic, File stateDir, String kafka, String zookeeper, final CountDownLatch latch) {
+    private KafkaStreams createKafkaStreams(String topic, File stateDir, String kafka, final CountDownLatch latch) {
         Properties props = new Properties();
         props.put(StreamsConfig.APPLICATION_ID_CONFIG, "simple-benchmark-streams");
         props.put(StreamsConfig.STATE_DIR_CONFIG, stateDir.toString());
@@ -475,7 +471,7 @@ public void close() {
         return new KafkaStreams(builder, props);
     }
 
-    private KafkaStreams createKafkaStreamsWithSink(String topic, File stateDir, String kafka, String zookeeper, final CountDownLatch latch) {
+    private KafkaStreams createKafkaStreamsWithSink(String topic, File stateDir, String kafka, final CountDownLatch latch) {
         Properties props = new Properties();
         props.put(StreamsConfig.APPLICATION_ID_CONFIG, "simple-benchmark-streams-with-sink");
         props.put(StreamsConfig.STATE_DIR_CONFIG, stateDir.toString());
@@ -565,7 +561,7 @@ private KafkaStreams createKafkaStreamsKStreamKStreamJoin(Properties streamConfi
         return new KafkaStreams(builder, streamConfig);
     }
 
-    private KafkaStreams createKafkaStreamsWithStateStore(String topic, File stateDir, String kafka, String zookeeper,
+    private KafkaStreams createKafkaStreamsWithStateStore(String topic, File stateDir, String kafka,
                                                           final CountDownLatch latch,
                                                           boolean enableCaching) {
         Properties props = new Properties();
diff --git a/streams/src/test/java/org/apache/kafka/streams/smoketest/ShutdownDeadlockTest.java b/streams/src/test/java/org/apache/kafka/streams/smoketest/ShutdownDeadlockTest.java
index 7abbd0d415c99..942e0c33820a3 100644
--- a/streams/src/test/java/org/apache/kafka/streams/smoketest/ShutdownDeadlockTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/smoketest/ShutdownDeadlockTest.java
@@ -33,13 +33,9 @@
 public class ShutdownDeadlockTest {
 
     private final String kafka;
-    private final String zookeeper;
-
-    public ShutdownDeadlockTest(final String kafka,
-                                final String zookeeper) {
 
+    public ShutdownDeadlockTest(final String kafka) {
         this.kafka = kafka;
-        this.zookeeper = zookeeper;
     }
 
     public void start() {
@@ -47,7 +43,6 @@ public void start() {
         final Properties props = new Properties();
         props.setProperty(StreamsConfig.APPLICATION_ID_CONFIG, "shouldNotDeadlock");
         props.setProperty(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, kafka);
-        props.setProperty(StreamsConfig.ZOOKEEPER_CONNECT_CONFIG, zookeeper);
         final KStreamBuilder builder = new KStreamBuilder();
         final KStream<String, String> source = builder.stream(Serdes.String(), Serdes.String(), topic);
 
diff --git a/streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestClient.java b/streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestClient.java
index 9f4dbd9991688..374cc2ff4f1d0 100644
--- a/streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestClient.java
+++ b/streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestClient.java
@@ -37,20 +37,18 @@
 public class SmokeTestClient extends SmokeTestUtil {
 
     private final String kafka;
-    private final String zookeeper;
     private final File stateDir;
     private KafkaStreams streams;
     private Thread thread;
 
-    public SmokeTestClient(File stateDir, String kafka, String zookeeper) {
+    public SmokeTestClient(File stateDir, String kafka) {
         super();
         this.stateDir = stateDir;
         this.kafka = kafka;
-        this.zookeeper = zookeeper;
     }
 
     public void start() {
-        streams = createKafkaStreams(stateDir, kafka, zookeeper);
+        streams = createKafkaStreams(stateDir, kafka);
         streams.setUncaughtExceptionHandler(new Thread.UncaughtExceptionHandler() {
             @Override
             public void uncaughtException(Thread t, Throwable e) {
@@ -75,7 +73,7 @@ public void close() {
         }
     }
 
-    private static KafkaStreams createKafkaStreams(File stateDir, String kafka, String zookeeper) {
+    private static KafkaStreams createKafkaStreams(File stateDir, String kafka) {
         Properties props = new Properties();
         props.put(StreamsConfig.APPLICATION_ID_CONFIG, "SmokeTest");
         props.put(StreamsConfig.STATE_DIR_CONFIG, stateDir.toString());
diff --git a/streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestDriver.java b/streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestDriver.java
index 2ce7e1a3ee3bc..33464f77de162 100644
--- a/streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestDriver.java
+++ b/streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestDriver.java
@@ -94,10 +94,10 @@ public void run() {
             }
         };
 
-        SmokeTestClient streams1 = new SmokeTestClient(createDir(stateDir, "1"), kafka, zookeeper);
-        SmokeTestClient streams2 = new SmokeTestClient(createDir(stateDir, "2"), kafka, zookeeper);
-        SmokeTestClient streams3 = new SmokeTestClient(createDir(stateDir, "3"), kafka, zookeeper);
-        SmokeTestClient streams4 = new SmokeTestClient(createDir(stateDir, "4"), kafka, zookeeper);
+        SmokeTestClient streams1 = new SmokeTestClient(createDir(stateDir, "1"), kafka);
+        SmokeTestClient streams2 = new SmokeTestClient(createDir(stateDir, "2"), kafka);
+        SmokeTestClient streams3 = new SmokeTestClient(createDir(stateDir, "3"), kafka);
+        SmokeTestClient streams4 = new SmokeTestClient(createDir(stateDir, "4"), kafka);
 
         System.out.println("starting the driver");
         driver.start();
diff --git a/streams/src/test/java/org/apache/kafka/streams/smoketest/StreamsSmokeTest.java b/streams/src/test/java/org/apache/kafka/streams/smoketest/StreamsSmokeTest.java
index ce0bd2b81cdae..31dd325c004ae 100644
--- a/streams/src/test/java/org/apache/kafka/streams/smoketest/StreamsSmokeTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/smoketest/StreamsSmokeTest.java
@@ -32,13 +32,11 @@ public class StreamsSmokeTest {
     public static void main(String[] args) throws Exception {
         String command = args[0];
         String kafka = args.length > 1 ? args[1] : null;
-        String zookeeper = args.length > 2 ? args[2] : null;
-        String stateDir = args.length > 3 ? args[3] : null;
+        String stateDir = args.length > 2 ? args[2] : null;
 
-        System.out.println("StreamsSmokeTest instance started");
+        System.out.println("StreamsTest instance started");
         System.out.println("command=" + command);
         System.out.println("kafka=" + kafka);
-        System.out.println("zookeeper=" + zookeeper);
         System.out.println("stateDir=" + stateDir);
 
         switch (command) {
@@ -54,7 +52,7 @@ public static void main(String[] args) throws Exception {
                 break;
             case "process":
                 // this starts a KafkaStreams client
-                final SmokeTestClient client = new SmokeTestClient(new File(stateDir), kafka, zookeeper);
+                final SmokeTestClient client = new SmokeTestClient(new File(stateDir), kafka);
                 client.start();
 
                 Runtime.getRuntime().addShutdownHook(new Thread() {
@@ -65,7 +63,7 @@ public void run() {
                 });
                 break;
             case "close-deadlock-test":
-                final ShutdownDeadlockTest test = new ShutdownDeadlockTest(kafka, zookeeper);
+                final ShutdownDeadlockTest test = new ShutdownDeadlockTest(kafka);
                 test.start();
                 break;
             default:

From e0eefdd36ca2606286a14cb033879ff4a9f56d58 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Tue, 24 Jan 2017 19:36:08 -0800
Subject: [PATCH 043/177] HOTIFX: streams system test do not start up correctly

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Guozhang Wang, Damian Guy, Eno Thereska

Closes #2428 from mjsax/hotfixSystemTests
---
 .../apache/kafka/streams/perf/SimpleBenchmark.java    |  9 +++++----
 .../{smoketest => tests}/ShutdownDeadlockTest.java    |  2 +-
 .../streams/{smoketest => tests}/SmokeTestClient.java |  2 +-
 .../streams/{smoketest => tests}/SmokeTestDriver.java |  2 +-
 .../streams/{smoketest => tests}/SmokeTestUtil.java   |  2 +-
 .../{smoketest => tests}/StreamsSmokeTest.java        |  8 ++++----
 .../streams/streams_simple_benchmark_test.py          | 11 ++++++++++-
 .../services/performance/streams_performance.py       |  9 +++++++++
 tests/kafkatest/services/streams.py                   |  4 ++--
 9 files changed, 34 insertions(+), 15 deletions(-)
 rename streams/src/test/java/org/apache/kafka/streams/{smoketest => tests}/ShutdownDeadlockTest.java (98%)
 rename streams/src/test/java/org/apache/kafka/streams/{smoketest => tests}/SmokeTestClient.java (99%)
 rename streams/src/test/java/org/apache/kafka/streams/{smoketest => tests}/SmokeTestDriver.java (99%)
 rename streams/src/test/java/org/apache/kafka/streams/{smoketest => tests}/SmokeTestUtil.java (99%)
 rename streams/src/test/java/org/apache/kafka/streams/{smoketest => tests}/StreamsSmokeTest.java (92%)

diff --git a/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java b/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java
index 90226c126a0df..7a10b79c10a00 100644
--- a/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java
+++ b/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java
@@ -46,6 +46,7 @@
 import org.apache.kafka.streams.processor.ProcessorSupplier;
 import org.apache.kafka.streams.state.KeyValueStore;
 import org.apache.kafka.streams.state.Stores;
+import org.apache.kafka.test.TestUtils;
 
 import java.io.File;
 import java.util.ArrayList;
@@ -98,7 +99,7 @@ public SimpleBenchmark(File stateDir, String kafka) {
 
     public static void main(String[] args) throws Exception {
         String kafka = args.length > 0 ? args[0] : "localhost:9092";
-        String stateDirStr = args.length > 1 ? args[1] : "/tmp/kafka-streams-simple-benchmark";
+        String stateDirStr = args.length > 1 ? args[1] : TestUtils.tempDirectory().getAbsolutePath();
         numRecords = args.length > 2 ? Integer.parseInt(args[2]) : 10000000;
         endKey = numRecords - 1;
 
@@ -128,11 +129,11 @@ public static void main(String[] args) throws Exception {
         // simple stream performance source->cache->store
         benchmark.processStreamWithCachedStateStore(SOURCE_TOPIC);
         // simple streams performance KSTREAM-KTABLE join
-        benchmark.kStreamKTableJoin(JOIN_TOPIC_1_PREFIX + "kStreamKTable", JOIN_TOPIC_2_PREFIX + "kStreamKTable");
+        benchmark.kStreamKTableJoin(JOIN_TOPIC_1_PREFIX + "KStreamKTable", JOIN_TOPIC_2_PREFIX + "KStreamKTable");
         // simple streams performance KSTREAM-KSTREAM join
-        benchmark.kStreamKStreamJoin(JOIN_TOPIC_1_PREFIX + "kStreamKStream", JOIN_TOPIC_2_PREFIX + "kStreamKStream");
+        benchmark.kStreamKStreamJoin(JOIN_TOPIC_1_PREFIX + "KStreamKStream", JOIN_TOPIC_2_PREFIX + "KStreamKStream");
         // simple streams performance KTABLE-KTABLE join
-        benchmark.kTableKTableJoin(JOIN_TOPIC_1_PREFIX + "kTableKTable", JOIN_TOPIC_2_PREFIX + "kTableKTable");
+        benchmark.kTableKTableJoin(JOIN_TOPIC_1_PREFIX + "KTableKTable", JOIN_TOPIC_2_PREFIX + "KTableKTable");
     }
 
     private Properties setJoinProperties(final String applicationId) {
diff --git a/streams/src/test/java/org/apache/kafka/streams/smoketest/ShutdownDeadlockTest.java b/streams/src/test/java/org/apache/kafka/streams/tests/ShutdownDeadlockTest.java
similarity index 98%
rename from streams/src/test/java/org/apache/kafka/streams/smoketest/ShutdownDeadlockTest.java
rename to streams/src/test/java/org/apache/kafka/streams/tests/ShutdownDeadlockTest.java
index 942e0c33820a3..e06e0346d6453 100644
--- a/streams/src/test/java/org/apache/kafka/streams/smoketest/ShutdownDeadlockTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/tests/ShutdownDeadlockTest.java
@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-package org.apache.kafka.streams.smoketest;
+package org.apache.kafka.streams.tests;
 
 import org.apache.kafka.clients.producer.KafkaProducer;
 import org.apache.kafka.clients.producer.ProducerConfig;
diff --git a/streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestClient.java b/streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestClient.java
similarity index 99%
rename from streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestClient.java
rename to streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestClient.java
index 374cc2ff4f1d0..35f1883b484d6 100644
--- a/streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestClient.java
+++ b/streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestClient.java
@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package org.apache.kafka.streams.smoketest;
+package org.apache.kafka.streams.tests;
 
 import org.apache.kafka.clients.consumer.ConsumerConfig;
 import org.apache.kafka.streams.KafkaStreams;
diff --git a/streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestDriver.java b/streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestDriver.java
similarity index 99%
rename from streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestDriver.java
rename to streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestDriver.java
index 33464f77de162..6f29e00895f42 100644
--- a/streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestDriver.java
+++ b/streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestDriver.java
@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package org.apache.kafka.streams.smoketest;
+package org.apache.kafka.streams.tests;
 
 import org.apache.kafka.clients.consumer.ConsumerConfig;
 import org.apache.kafka.clients.consumer.ConsumerRecord;
diff --git a/streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestUtil.java b/streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestUtil.java
similarity index 99%
rename from streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestUtil.java
rename to streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestUtil.java
index 36660fb95e9d0..73fe27c465998 100644
--- a/streams/src/test/java/org/apache/kafka/streams/smoketest/SmokeTestUtil.java
+++ b/streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestUtil.java
@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package org.apache.kafka.streams.smoketest;
+package org.apache.kafka.streams.tests;
 
 import org.apache.kafka.common.serialization.Serde;
 import org.apache.kafka.common.serialization.Serdes;
diff --git a/streams/src/test/java/org/apache/kafka/streams/smoketest/StreamsSmokeTest.java b/streams/src/test/java/org/apache/kafka/streams/tests/StreamsSmokeTest.java
similarity index 92%
rename from streams/src/test/java/org/apache/kafka/streams/smoketest/StreamsSmokeTest.java
rename to streams/src/test/java/org/apache/kafka/streams/tests/StreamsSmokeTest.java
index 31dd325c004ae..304cae7e0ada8 100644
--- a/streams/src/test/java/org/apache/kafka/streams/smoketest/StreamsSmokeTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/tests/StreamsSmokeTest.java
@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package org.apache.kafka.streams.smoketest;
+package org.apache.kafka.streams.tests;
 
 import java.io.File;
 import java.util.Map;
@@ -30,9 +30,9 @@ public class StreamsSmokeTest {
      * @param args
      */
     public static void main(String[] args) throws Exception {
-        String command = args[0];
-        String kafka = args.length > 1 ? args[1] : null;
-        String stateDir = args.length > 2 ? args[2] : null;
+        String kafka = args[0];
+        String stateDir = args.length > 1 ? args[1] : null;
+        String command = args.length > 2 ? args[2] : null;
 
         System.out.println("StreamsTest instance started");
         System.out.println("command=" + command);
diff --git a/tests/kafkatest/benchmarks/streams/streams_simple_benchmark_test.py b/tests/kafkatest/benchmarks/streams/streams_simple_benchmark_test.py
index ab9b112b4fb8c..ebd69a6597b49 100644
--- a/tests/kafkatest/benchmarks/streams/streams_simple_benchmark_test.py
+++ b/tests/kafkatest/benchmarks/streams/streams_simple_benchmark_test.py
@@ -25,7 +25,16 @@ class StreamsSimpleBenchmarkTest(KafkaTest):
     """
 
     def __init__(self, test_context):
-        super(StreamsSimpleBenchmarkTest, self).__init__(test_context, num_zk=1, num_brokers=1)
+        super(StreamsSimpleBenchmarkTest, self).__init__(test_context, num_zk=1, num_brokers=1,topics={
+            'simpleBenchmarkSourceTopic' : { 'partitions': 1, 'replication-factor': 1 },
+            'simpleBenchmarkSinkTopic' : { 'partitions': 1, 'replication-factor': 1 },
+            'joinSourceTopic1KStreamKStream' : { 'partitions': 1, 'replication-factor': 1 },
+            'joinSourceTopic2KStreamKStream' : { 'partitions': 1, 'replication-factor': 1 },
+            'joinSourceTopic1KStreamKTable' : { 'partitions': 1, 'replication-factor': 1 },
+            'joinSourceTopic2KStreamKTable' : { 'partitions': 1, 'replication-factor': 1 },
+            'joinSourceTopic1KTableKTable' : { 'partitions': 1, 'replication-factor': 1 },
+            'joinSourceTopic2KTableKTable' : { 'partitions': 1, 'replication-factor': 1 }
+        })
 
         self.driver = StreamsSimpleBenchmarkService(test_context, self.kafka, 1000000L)
 
diff --git a/tests/kafkatest/services/performance/streams_performance.py b/tests/kafkatest/services/performance/streams_performance.py
index e9fa2a79acd40..4ccc3b2943815 100644
--- a/tests/kafkatest/services/performance/streams_performance.py
+++ b/tests/kafkatest/services/performance/streams_performance.py
@@ -27,3 +27,12 @@ def __init__(self, test_context, kafka, numrecs):
                                                             kafka,
                                                             "org.apache.kafka.streams.perf.SimpleBenchmark",
                                                             numrecs)
+
+    def collect_data(self, node):
+        # Collect the data and return it to the framework
+        output = node.account.ssh_capture("grep Performance %s" % self.STDOUT_FILE)
+        data = {}
+        for line in output:
+            parts = line.split(':')
+            data[parts[0]] = float(parts[1])
+        return data
diff --git a/tests/kafkatest/services/streams.py b/tests/kafkatest/services/streams.py
index 9250cd7b94375..e1f292cba6aa7 100644
--- a/tests/kafkatest/services/streams.py
+++ b/tests/kafkatest/services/streams.py
@@ -131,7 +131,7 @@ def start_node(self, node):
         self.logger.info("Starting StreamsTest process on " + str(node.account))
         with node.account.monitor_log(self.STDOUT_FILE) as monitor:
             node.account.ssh(self.start_cmd(node))
-            monitor.wait_until('StreamsTest instance started', timeout_sec=60, err_msg="Never saw message indicating StreamsTest finished startup on " + str(node.account))
+            monitor.wait_until('StreamsTest instance started', timeout_sec=15, err_msg="Never saw message indicating StreamsTest finished startup on " + str(node.account))
 
         if len(self.pids(node)) == 0:
             raise RuntimeError("No process ids recorded")
@@ -143,7 +143,7 @@ class StreamsSmokeTestBaseService(StreamsTestBaseService):
     def __init__(self, test_context, kafka, command):
         super(StreamsSmokeTestBaseService, self).__init__(test_context,
                                                           kafka,
-                                                          "org.apache.kafka.streams.smoketest.StreamsSmokeTest",
+                                                          "org.apache.kafka.streams.tests.StreamsSmokeTest",
                                                           command)
 
 

From f0388d923e1d7564e8831d59bf3aab88db36d30d Mon Sep 17 00:00:00 2001
From: Ben Stopford <benstopford@gmail.com>
Date: Wed, 25 Jan 2017 12:23:57 +0000
Subject: [PATCH 044/177] KAFKA-4596; Throttled reassignment should support
 partial JSON file

Fixes a logic error in the Reassignment process which throws an exception
if you don't rebalance all partitions.

Author: Ben Stopford <benstopford@gmail.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2399 from benstopford/KAFKA-4596

(cherry picked from commit b8c3b7c964c6167be7f8ad72c96733dfa0d648a2)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../admin/ReassignPartitionsCommand.scala     | 13 +--
 .../admin/ReassignPartitionsClusterTest.scala | 91 +++++++++++++++++--
 .../admin/ReassignPartitionsCommandTest.scala | 33 +++++++
 3 files changed, 124 insertions(+), 13 deletions(-)

diff --git a/core/src/main/scala/kafka/admin/ReassignPartitionsCommand.scala b/core/src/main/scala/kafka/admin/ReassignPartitionsCommand.scala
index dc707e56d23d3..4e7b4e0c3937c 100755
--- a/core/src/main/scala/kafka/admin/ReassignPartitionsCommand.scala
+++ b/core/src/main/scala/kafka/admin/ReassignPartitionsCommand.scala
@@ -360,16 +360,17 @@ class ReassignPartitionsCommand(zkUtils: ZkUtils, proposedAssignment: Map[TopicA
   }
 
   private def postRebalanceReplicasThatMoved(existing: Map[TopicAndPartition, Seq[Int]], proposed: Map[TopicAndPartition, Seq[Int]]): Map[TopicAndPartition, Seq[Int]] = {
-    //For each partition in the proposed list, filter out any replicas that exist now (i.e. are in the proposed list and hence are not moving)
-    existing.map { case (tp, current) =>
-      tp -> (proposed(tp).toSet -- current).toSeq
+    //For each partition in the proposed list, filter out any replicas that exist now, and hence aren't being moved.
+    proposed.map { case (tp, proposedReplicas) =>
+      tp -> (proposedReplicas.toSet -- existing(tp)).toSeq
     }
   }
 
   private def preRebalanceReplicaForMovingPartitions(existing: Map[TopicAndPartition, Seq[Int]], proposed: Map[TopicAndPartition, Seq[Int]]): Map[TopicAndPartition, Seq[Int]] = {
-    //Throttle all existing replicas (as any one might be a leader). So just filter out those which aren't moving
-    existing.filter { case (tp, current) =>
-      (proposed(tp).toSet -- current).nonEmpty
+    def moving(before: Seq[Int], after: Seq[Int]) = (after.toSet -- before.toSet).nonEmpty
+    //For any moving partition, throttle all the original (pre move) replicas (as any one might be a leader)
+    existing.filter { case (tp, preMoveReplicas) =>
+      proposed.contains(tp) && moving(preMoveReplicas, proposed(tp))
     }
   }
 
diff --git a/core/src/test/scala/unit/kafka/admin/ReassignPartitionsClusterTest.scala b/core/src/test/scala/unit/kafka/admin/ReassignPartitionsClusterTest.scala
index 95ee5d386ccae..c211c245eb18c 100644
--- a/core/src/test/scala/unit/kafka/admin/ReassignPartitionsClusterTest.scala
+++ b/core/src/test/scala/unit/kafka/admin/ReassignPartitionsClusterTest.scala
@@ -16,12 +16,13 @@ import kafka.common.{AdminCommandFailedException, TopicAndPartition}
 import kafka.server.{KafkaConfig, KafkaServer}
 import kafka.utils.TestUtils._
 import kafka.utils.ZkUtils._
-import kafka.utils.{CoreUtils, Logging, ZkUtils}
+import kafka.utils.{CoreUtils, Logging, TestUtils, ZkUtils}
 import kafka.zk.ZooKeeperTestHarness
 import org.junit.Assert.{assertEquals, assertTrue}
 import org.junit.{After, Before, Test}
 import kafka.admin.ReplicationQuotaUtils._
-import scala.collection.Seq
+
+import scala.collection.{Map, Seq}
 
 
 class ReassignPartitionsClusterTest extends ZooKeeperTestHarness with Logging {
@@ -58,7 +59,7 @@ class ReassignPartitionsClusterTest extends ZooKeeperTestHarness with Logging {
     waitForReassignmentToComplete()
 
     //Then the replica should be on 101
-    assertEquals(zkUtils.getPartitionAssignmentForTopics(Seq(topicName)).get(topicName).get(partition), Seq(101))
+    assertEquals(Seq(101), zkUtils.getPartitionAssignmentForTopics(Seq(topicName)).get(topicName).get(partition))
   }
 
   @Test
@@ -79,7 +80,7 @@ class ReassignPartitionsClusterTest extends ZooKeeperTestHarness with Logging {
 
     //Then the replicas should span all three brokers
     val actual = zkUtils.getPartitionAssignmentForTopics(Seq(topicName))(topicName)
-    assertEquals(actual.values.flatten.toSeq.distinct.sorted, Seq(100, 101, 102))
+    assertEquals(Seq(100, 101, 102), actual.values.flatten.toSeq.distinct.sorted)
   }
 
   @Test
@@ -100,7 +101,43 @@ class ReassignPartitionsClusterTest extends ZooKeeperTestHarness with Logging {
 
     //Then replicas should only span the first two brokers
     val actual = zkUtils.getPartitionAssignmentForTopics(Seq(topicName))(topicName)
-    assertEquals(actual.values.flatten.toSeq.distinct.sorted, Seq(100, 101))
+    assertEquals(Seq(100, 101), actual.values.flatten.toSeq.distinct.sorted)
+  }
+
+  @Test
+  def shouldMoveSubsetOfPartitions() {
+    //Given partitions on 3 of 3 brokers
+    val brokers = Array(100, 101, 102)
+    startBrokers(brokers)
+    createTopic(zkUtils, "topic1", Map(
+      0 -> Seq(100, 101),
+      1 -> Seq(101, 102),
+      2 -> Seq(102, 100)
+    ), servers = servers)
+    createTopic(zkUtils, "topic2", Map(
+      0 -> Seq(100, 101),
+      1 -> Seq(101, 102),
+      2 -> Seq(102, 100)
+    ), servers = servers)
+
+    val proposed: Map[TopicAndPartition, Seq[Int]] = Map(
+      TopicAndPartition("topic1", 0) -> Seq(100, 102),
+      TopicAndPartition("topic1", 2) -> Seq(100, 102),
+      TopicAndPartition("topic2", 2) -> Seq(100, 102)
+    )
+
+    //When rebalancing
+    ReassignPartitionsCommand.executeAssignment(zkUtils, ZkUtils.formatAsReassignmentJson(proposed))
+    waitForReassignmentToComplete()
+
+    //Then the proposed changes should have been made
+    val actual = zkUtils.getPartitionAssignmentForTopics(Seq("topic1", "topic2"))
+    assertEquals(Seq(100, 102), actual("topic1")(0))//changed
+    assertEquals(Seq(101, 102), actual("topic1")(1))
+    assertEquals(Seq(100, 102), actual("topic1")(2))//changed
+    assertEquals(Seq(100, 101), actual("topic2")(0))
+    assertEquals(Seq(101, 102), actual("topic2")(1))
+    assertEquals(Seq(100, 102), actual("topic2")(2))//changed
   }
 
   @Test
@@ -135,7 +172,7 @@ class ReassignPartitionsClusterTest extends ZooKeeperTestHarness with Logging {
 
     //Check move occurred
     val actual = zkUtils.getPartitionAssignmentForTopics(Seq(topicName))(topicName)
-    assertEquals(actual.values.flatten.toSeq.distinct.sorted, Seq(101, 102))
+    assertEquals(Seq(101, 102), actual.values.flatten.toSeq.distinct.sorted)
 
     //Then command should have taken longer than the throttle rate
     assertTrue(s"Expected replication to be > ${expectedDurationSecs * 0.9 * 1000} but was $took", took > expectedDurationSecs * 0.9 * 1000)
@@ -233,7 +270,7 @@ class ReassignPartitionsClusterTest extends ZooKeeperTestHarness with Logging {
 
     //Check move occurred
     val actual = zkUtils.getPartitionAssignmentForTopics(Seq(topicName))(topicName)
-    assertEquals(actual.values.flatten.toSeq.distinct.sorted, Seq(101, 102))
+    assertEquals(Seq(101, 102), actual.values.flatten.toSeq.distinct.sorted)
   }
 
   @Test(expected = classOf[AdminCommandFailedException])
@@ -246,6 +283,46 @@ class ReassignPartitionsClusterTest extends ZooKeeperTestHarness with Logging {
     ReassignPartitionsCommand.executeAssignment(zkUtils, s"""{"version":1,"partitions":[{"topic":"$topicName","partition":1,"replicas":[101]}]}""")
   }
 
+  @Test
+  def shouldPerformThrottledReassignmentOverVariousTopics() {
+    val throttle = 1000L
+
+    //Given four brokers
+    servers = TestUtils.createBrokerConfigs(4, zkConnect, false).map(conf => TestUtils.createServer(KafkaConfig.fromProps(conf)))
+
+    //With up several small topics
+    createTopic(zkUtils, "orders", Map(0 -> List(0, 1, 2), 1 -> List(0, 1, 2)), servers)
+    createTopic(zkUtils, "payments", Map(0 -> List(0, 1), 1 -> List(0, 1)), servers)
+    createTopic(zkUtils, "deliveries", Map(0 -> List(0)), servers)
+    createTopic(zkUtils, "customers", Map(0 -> List(0), 1 -> List(1), 2 -> List(2), 3 -> List(3)), servers)
+
+    //Define a move for some of them
+    val move = Map(
+      TopicAndPartition("orders", 0) -> Seq(0, 2, 3),//moves
+      TopicAndPartition("orders", 1) -> Seq(0, 1, 2),//stays
+      TopicAndPartition("payments", 1) -> Seq(1, 2), //only define one partition as moving
+      TopicAndPartition("deliveries", 0) -> Seq(1, 2) //increase replication factor
+    )
+
+    //When we run a throttled reassignment
+    new ReassignPartitionsCommand(zkUtils, move).reassignPartitions(throttle)
+
+    waitForReassignmentToComplete()
+
+    //Check moved replicas did move
+    assertEquals(Seq(0, 2, 3), zkUtils.getReplicasForPartition("orders", 0))
+    assertEquals(Seq(0, 1, 2), zkUtils.getReplicasForPartition("orders", 1))
+    assertEquals(Seq(1, 2), zkUtils.getReplicasForPartition("payments", 1))
+    assertEquals(Seq(1, 2), zkUtils.getReplicasForPartition("deliveries", 0))
+
+    //Check untouched replicas are still there
+    assertEquals(Seq(0, 1), zkUtils.getReplicasForPartition("payments", 0))
+    assertEquals(Seq(0), zkUtils.getReplicasForPartition("customers", 0))
+    assertEquals(Seq(1), zkUtils.getReplicasForPartition("customers", 1))
+    assertEquals(Seq(2), zkUtils.getReplicasForPartition("customers", 2))
+    assertEquals(Seq(3), zkUtils.getReplicasForPartition("customers", 3))
+  }
+
   def waitForReassignmentToComplete() {
     waitUntilTrue(() => !zkUtils.pathExists(ReassignPartitionsPath), s"Znode ${ZkUtils.ReassignPartitionsPath} wasn't deleted")
   }
diff --git a/core/src/test/scala/unit/kafka/admin/ReassignPartitionsCommandTest.scala b/core/src/test/scala/unit/kafka/admin/ReassignPartitionsCommandTest.scala
index 924daf8676749..5ecc19bde25be 100644
--- a/core/src/test/scala/unit/kafka/admin/ReassignPartitionsCommandTest.scala
+++ b/core/src/test/scala/unit/kafka/admin/ReassignPartitionsCommandTest.scala
@@ -29,6 +29,7 @@ import org.easymock.EasyMock._
 import org.easymock.{Capture, CaptureType, EasyMock}
 import org.junit.{Before, Test}
 import org.junit.Assert.{assertEquals, assertNull, fail}
+
 import scala.collection.{Seq, mutable}
 import scala.collection.JavaConversions._
 
@@ -57,6 +58,38 @@ class ReassignPartitionsCommandTest extends Logging {
     assertEquals(1, calls)
   }
 
+  @Test
+  def shouldFindMovingReplicasWhenProposedIsSubsetOfExisting() {
+    val assigner = new ReassignPartitionsCommand(null, null)
+
+    //Given we have more existing partitions than we are proposing
+    val existingSuperset = Map(
+      TopicAndPartition("topic1", 0) -> Seq(100, 101),
+      TopicAndPartition("topic1", 1) -> Seq(100, 102),
+      TopicAndPartition("topic1", 2) -> Seq(100, 101),
+      TopicAndPartition("topic2", 0) -> Seq(100, 101, 102),
+      TopicAndPartition("topic3", 0) -> Seq(100, 101, 102)
+    )
+    val proposedSubset = Map(
+      TopicAndPartition("topic1", 0) -> Seq(101, 102),
+      TopicAndPartition("topic1", 1) -> Seq(102),
+      TopicAndPartition("topic1", 2) -> Seq(100, 101, 102)
+    )
+
+    val mock = new TestAdminUtils {
+      override def changeTopicConfig(zkUtils: ZkUtils, topic: String, configChange: Properties): Unit = {
+        assertEquals("0:102,2:102", configChange.get(FollowerReplicationThrottledReplicasProp))
+        assertEquals("0:100,0:101,2:100,2:101", configChange.get(LeaderReplicationThrottledReplicasProp))
+        assertEquals("topic1", topic)
+        calls += 1
+      }
+    }
+
+    //Then replicas should assign correctly (based on the proposed map)
+    assigner.assignThrottledReplicas(existingSuperset, proposedSubset, mock)
+    assertEquals(1, calls)
+  }
+
   @Test
   def shouldFindMovingReplicasMultiplePartitions() {
     val control = TopicAndPartition("topic1", 2) -> Seq(100, 102)

From b0742c2024c3c07f8b2d7f9a7c77fa2b7c9e228f Mon Sep 17 00:00:00 2001
From: Manikumar Reddy O <manikumar.reddy@gmail.com>
Date: Wed, 25 Jan 2017 08:17:50 -0800
Subject: [PATCH 045/177] KAFKA-2000; Delete topic should also delete consumer
 offsets.

Author: Manikumar Reddy O <manikumar.reddy@gmail.com>

Reviewers: Jason Gustafson <jason@confluent.io>, Sriharsha Chintalapani <harsha@hortonworks.com>

Closes #1850 from omkreddy/KAFKA-2700-DELETE
---
 .../kafka/coordinator/GroupCoordinator.scala  |  4 +++
 .../kafka/coordinator/GroupMetadata.scala     | 21 ++++++++++++--
 .../coordinator/GroupMetadataManager.scala    | 12 ++++++--
 .../main/scala/kafka/server/KafkaApis.scala   |  3 +-
 .../scala/kafka/server/MetadataCache.scala    |  8 +++--
 .../scala/kafka/server/ReplicaManager.scala   |  5 ++--
 .../unit/kafka/server/OffsetCommitTest.scala  | 29 ++++++++++++++++++-
 7 files changed, 71 insertions(+), 11 deletions(-)

diff --git a/core/src/main/scala/kafka/coordinator/GroupCoordinator.scala b/core/src/main/scala/kafka/coordinator/GroupCoordinator.scala
index 7abbc6e1ac1dd..c7edcefc1057e 100644
--- a/core/src/main/scala/kafka/coordinator/GroupCoordinator.scala
+++ b/core/src/main/scala/kafka/coordinator/GroupCoordinator.scala
@@ -497,6 +497,10 @@ class GroupCoordinator(val brokerId: Int,
     }
   }
 
+  def handleDeletedPartitions(topicPartitions: Seq[TopicPartition]) {
+    groupManager.cleanupGroupMetadata(Some(topicPartitions))
+  }
+
   private def onGroupUnloaded(group: GroupMetadata) {
     group synchronized {
       info(s"Unloading group metadata for ${group.groupId} with generation ${group.generationId}")
diff --git a/core/src/main/scala/kafka/coordinator/GroupMetadata.scala b/core/src/main/scala/kafka/coordinator/GroupMetadata.scala
index 6b889f474db88..eac31519f8a58 100644
--- a/core/src/main/scala/kafka/coordinator/GroupMetadata.scala
+++ b/core/src/main/scala/kafka/coordinator/GroupMetadata.scala
@@ -17,8 +17,10 @@
 
 package kafka.coordinator
 
-import collection.mutable
+import collection.{Seq, mutable, immutable}
+
 import java.util.UUID
+
 import kafka.common.OffsetAndMetadata
 import kafka.utils.nonthreadsafe
 import org.apache.kafka.common.TopicPartition
@@ -264,7 +266,9 @@ private[coordinator] class GroupMetadata(val groupId: String, initialState: Grou
   }
 
   def completePendingOffsetWrite(topicPartition: TopicPartition, offset: OffsetAndMetadata) {
-    offsets.put(topicPartition, offset)
+    if (pendingOffsetCommits.contains(topicPartition))
+      offsets.put(topicPartition, offset)
+
     pendingOffsetCommits.get(topicPartition) match {
       case Some(stagedOffset) if offset == stagedOffset => pendingOffsetCommits.remove(topicPartition)
       case _ =>
@@ -282,12 +286,23 @@ private[coordinator] class GroupMetadata(val groupId: String, initialState: Grou
     pendingOffsetCommits ++= offsets
   }
 
+  def removeOffsets(topicPartitions: Seq[TopicPartition]): immutable.Map[TopicPartition, OffsetAndMetadata] = {
+    val removedOffsetMap = new mutable.HashMap[TopicPartition, OffsetAndMetadata]
+    for (topicPartition <- topicPartitions) {
+      pendingOffsetCommits.remove(topicPartition)
+      val removedOffsets = offsets.remove(topicPartition)
+      if (!removedOffsets.isEmpty)
+        removedOffsetMap.put(topicPartition, removedOffsets.get)
+    }
+    removedOffsetMap.toMap
+  }
+
   def removeExpiredOffsets(startMs: Long) = {
     val expiredOffsets = offsets.filter {
       case (topicPartition, offset) => offset.expireTimestamp < startMs && !pendingOffsetCommits.contains(topicPartition)
     }
     offsets --= expiredOffsets.keySet
-    expiredOffsets
+    expiredOffsets.toMap
   }
 
   def allOffsets = offsets.toMap
diff --git a/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala b/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
index 2d6889c936ff5..1163e72665f1e 100644
--- a/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
+++ b/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
@@ -546,14 +546,22 @@ class GroupMetadataManager(val brokerId: Int,
   }
 
   // visible for testing
-  private[coordinator] def cleanupGroupMetadata() {
+  private[coordinator] def cleanupGroupMetadata(): Unit = {
+    cleanupGroupMetadata(None)
+  }
+
+  def cleanupGroupMetadata(topicPartitions: Option[Seq[TopicPartition]]) {
     val startMs = time.milliseconds()
     var offsetsRemoved = 0
 
     groupMetadataCache.foreach { case (groupId, group) =>
       val (expiredOffsets, groupIsDead, generation) = group synchronized {
         // remove expired offsets from the cache
-        val expiredOffsets = group.removeExpiredOffsets(startMs)
+        val expiredOffsets = if (topicPartitions.isEmpty)
+          group.removeExpiredOffsets(startMs)
+        else
+          group.removeOffsets(topicPartitions.get)
+
         if (group.is(Empty) && !group.hasOffsets) {
           info(s"Group $groupId transitioned to Dead in generation ${group.generationId}")
           group.transitionTo(Dead)
diff --git a/core/src/main/scala/kafka/server/KafkaApis.scala b/core/src/main/scala/kafka/server/KafkaApis.scala
index 530dafcd69147..b99ce4dc65f12 100644
--- a/core/src/main/scala/kafka/server/KafkaApis.scala
+++ b/core/src/main/scala/kafka/server/KafkaApis.scala
@@ -196,7 +196,8 @@ class KafkaApis(val requestChannel: RequestChannel,
 
     val updateMetadataResponse =
       if (authorize(request.session, ClusterAction, Resource.ClusterResource)) {
-        replicaManager.maybeUpdateMetadataCache(correlationId, updateMetadataRequest, metadataCache)
+        val deletedPartitions = replicaManager.maybeUpdateMetadataCache(correlationId, updateMetadataRequest, metadataCache)
+        coordinator.handleDeletedPartitions(deletedPartitions)
         if (adminManager.hasDelayedTopicOperations) {
           updateMetadataRequest.partitionStates.keySet.asScala.map(_.topic).foreach { topic =>
             adminManager.tryCompleteDelayedTopicOperations(topic)
diff --git a/core/src/main/scala/kafka/server/MetadataCache.scala b/core/src/main/scala/kafka/server/MetadataCache.scala
index 5c28e140808e5..9a6090d3647d6 100755
--- a/core/src/main/scala/kafka/server/MetadataCache.scala
+++ b/core/src/main/scala/kafka/server/MetadataCache.scala
@@ -27,7 +27,7 @@ import kafka.common.{BrokerEndPointNotAvailableException, Topic, TopicAndPartiti
 import kafka.controller.{KafkaController, LeaderIsrAndControllerEpoch}
 import kafka.utils.CoreUtils._
 import kafka.utils.Logging
-import org.apache.kafka.common.Node
+import org.apache.kafka.common.{Node, TopicPartition}
 import org.apache.kafka.common.network.ListenerName
 import org.apache.kafka.common.protocol.Errors
 import org.apache.kafka.common.requests.{MetadataResponse, PartitionState, UpdateMetadataRequest}
@@ -155,7 +155,8 @@ private[server] class MetadataCache(brokerId: Int) extends Logging {
 
   def getControllerId: Option[Int] = controllerId
 
-  def updateCache(correlationId: Int, updateMetadataRequest: UpdateMetadataRequest) {
+  // This method returns the deleted TopicPartitions received from UpdateMetadataRequest
+  def updateCache(correlationId: Int, updateMetadataRequest: UpdateMetadataRequest): Seq[TopicPartition] = {
     inWriteLock(partitionMetadataLock) {
       controllerId = updateMetadataRequest.controllerId match {
           case id if id < 0 => None
@@ -177,6 +178,7 @@ private[server] class MetadataCache(brokerId: Int) extends Logging {
         aliveNodes(broker.id) = nodes.asScala
       }
 
+      val deletedPartitions = new mutable.ArrayBuffer[TopicPartition]
       updateMetadataRequest.partitionStates.asScala.foreach { case (tp, info) =>
         val controllerId = updateMetadataRequest.controllerId
         val controllerEpoch = updateMetadataRequest.controllerEpoch
@@ -184,6 +186,7 @@ private[server] class MetadataCache(brokerId: Int) extends Logging {
           removePartitionInfo(tp.topic, tp.partition)
           stateChangeLogger.trace(s"Broker $brokerId deleted partition $tp from metadata cache in response to UpdateMetadata " +
             s"request sent by controller $controllerId epoch $controllerEpoch with correlation id $correlationId")
+          deletedPartitions += tp
         } else {
           val partitionInfo = partitionStateToPartitionStateInfo(info)
           addOrUpdatePartitionInfo(tp.topic, tp.partition, partitionInfo)
@@ -191,6 +194,7 @@ private[server] class MetadataCache(brokerId: Int) extends Logging {
             s"UpdateMetadata request sent by controller $controllerId epoch $controllerEpoch with correlation id $correlationId")
         }
       }
+      deletedPartitions
     }
   }
 
diff --git a/core/src/main/scala/kafka/server/ReplicaManager.scala b/core/src/main/scala/kafka/server/ReplicaManager.scala
index 199bb67482ba8..be2e04abde504 100644
--- a/core/src/main/scala/kafka/server/ReplicaManager.scala
+++ b/core/src/main/scala/kafka/server/ReplicaManager.scala
@@ -625,7 +625,7 @@ class ReplicaManager(val config: KafkaConfig,
       replica.log.map(log => (log.config.messageFormatVersion.messageFormatVersion, log.config.messageTimestampType))
     }
 
-  def maybeUpdateMetadataCache(correlationId: Int, updateMetadataRequest: UpdateMetadataRequest, metadataCache: MetadataCache) {
+  def maybeUpdateMetadataCache(correlationId: Int, updateMetadataRequest: UpdateMetadataRequest, metadataCache: MetadataCache) : Seq[TopicPartition] =  {
     replicaStateChangeLock synchronized {
       if(updateMetadataRequest.controllerEpoch < controllerEpoch) {
         val stateControllerEpochErrorMessage = ("Broker %d received update metadata request with correlation id %d from an " +
@@ -635,8 +635,9 @@ class ReplicaManager(val config: KafkaConfig,
         stateChangeLogger.warn(stateControllerEpochErrorMessage)
         throw new ControllerMovedException(stateControllerEpochErrorMessage)
       } else {
-        metadataCache.updateCache(correlationId, updateMetadataRequest)
+        val deletedPartitions = metadataCache.updateCache(correlationId, updateMetadataRequest)
         controllerEpoch = updateMetadataRequest.controllerEpoch
+        deletedPartitions
       }
     }
   }
diff --git a/core/src/test/scala/unit/kafka/server/OffsetCommitTest.scala b/core/src/test/scala/unit/kafka/server/OffsetCommitTest.scala
index 6ca784a272486..355acde17255a 100755
--- a/core/src/test/scala/unit/kafka/server/OffsetCommitTest.scala
+++ b/core/src/test/scala/unit/kafka/server/OffsetCommitTest.scala
@@ -30,6 +30,8 @@ import org.junit.Assert._
 import java.util.Properties
 import java.io.File
 
+import kafka.admin.AdminUtils
+
 import scala.util.Random
 import scala.collection._
 
@@ -46,7 +48,7 @@ class OffsetCommitTest extends ZooKeeperTestHarness {
   @Before
   override def setUp() {
     super.setUp()
-    val config: Properties = createBrokerConfig(1, zkConnect)
+    val config: Properties = createBrokerConfig(1, zkConnect,  enableDeleteTopic = true)
     config.setProperty(KafkaConfig.OffsetsTopicReplicationFactorProp, "1")
     config.setProperty(KafkaConfig.OffsetsRetentionCheckIntervalMsProp, retentionCheckInterval.toString)
     val logDirPath = config.getProperty("log.dir")
@@ -304,4 +306,29 @@ class OffsetCommitTest extends ZooKeeperTestHarness {
     assertEquals(Errors.UNKNOWN_TOPIC_OR_PARTITION.code, commitResponse.commitStatus.get(TopicAndPartition(topic1, 0)).get)
     assertEquals(Errors.NONE.code, commitResponse.commitStatus.get(TopicAndPartition(topic2, 0)).get)
   }
+
+  @Test
+  def testOffsetsDeleteAfterTopicDeletion() {
+    // set up topic partition
+    val topic = "topic"
+    val topicPartition = TopicAndPartition(topic, 0)
+    createTopic(zkUtils, topic, servers = Seq(server), numPartitions = 1)
+
+    val commitRequest = OffsetCommitRequest(group, immutable.Map(topicPartition -> OffsetAndMetadata(offset = 42L)))
+    val commitResponse = simpleConsumer.commitOffsets(commitRequest)
+
+    assertEquals(Errors.NONE.code, commitResponse.commitStatus.get(topicPartition).get)
+
+    // start topic deletion
+    AdminUtils.deleteTopic(zkUtils, topic)
+    TestUtils.verifyTopicDeletion(zkUtils, topic, 1, Seq(server))
+    Thread.sleep(retentionCheckInterval * 2)
+
+    // check if offsets deleted
+    val fetchRequest = OffsetFetchRequest(group, Seq(TopicAndPartition(topic, 0)))
+    val offsetMetadataAndErrorMap = simpleConsumer.fetchOffsets(fetchRequest)
+    val offsetMetadataAndError = offsetMetadataAndErrorMap.requestInfo(topicPartition)
+    assertEquals(OffsetMetadataAndError.NoOffset, offsetMetadataAndError)
+  }
+
 }

From ec3975978582dfec63986b67c38d6e3bb7742f81 Mon Sep 17 00:00:00 2001
From: Guozhang Wang <wangguoz@gmail.com>
Date: Wed, 25 Jan 2017 11:11:21 -0800
Subject: [PATCH 046/177] KAFKA-3502: KStreamTestDriver needs to be closed
 after the test case

Found a few recently added unit tests did not close KStreamTestDriver after the test itself is closed; this can cause RocksDB virtual function called if the contained topology has some persistent store since they will be initialized but not closed in time.

MINOR fix: found that when closing KStreamTestDriver, we need to first flushing all stores before closing any of them; this is triggered from the `KTableKTableLeftJoin.shouldNotThrowIllegalStateExceptionWhenMultiCacheEvictions`.

MINOR fix: in CachingXXXStore, the `name` field is actually used as the cache's namespace, not really the store name or its corresponding topic name. Fixed it by renaming it to `cacheName` and use `this.name()` elsewhere which will call the underlying store's name.

Author: Guozhang Wang <wangguoz@gmail.com>

Reviewers: Ewen Cheslack-Postava, Eno Thereska, Damian Guy

Closes #2432 from guozhangwang/K3502-kstream-builder-test

(cherry picked from commit 2ca3e59bb6054cc8ecf6926a74859efe3df000ba)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../state/internals/CachingKeyValueStore.java | 26 ++++++-------
 .../state/internals/CachingSessionStore.java  | 16 ++++----
 .../streams/state/internals/RocksDBStore.java |  1 +
 .../internals/GlobalKTableJoinsTest.java      | 19 +++++++---
 .../internals/KGroupedStreamImplTest.java     | 37 +++++++++++--------
 .../internals/KGroupedTableImplTest.java      | 27 ++++++++------
 .../internals/KTableAggregateTest.java        |  8 ++--
 .../internals/KTableKTableLeftJoinTest.java   |  5 +--
 .../KeyValuePrinterProcessorTest.java         | 10 ++---
 .../apache/kafka/test/KStreamTestDriver.java  |  5 ++-
 10 files changed, 87 insertions(+), 67 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingKeyValueStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingKeyValueStore.java
index 9a0a9763cbfa1..1e91b478d734e 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingKeyValueStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingKeyValueStore.java
@@ -37,7 +37,7 @@ class CachingKeyValueStore<K, V> implements WrappedStateStore, KeyValueStore<K,
     private final Serde<K> keySerde;
     private final Serde<V> valueSerde;
     private CacheFlushListener<K, V> flushListener;
-    private String name;
+    private String cacheName;
     private ThreadCache cache;
     private InternalProcessorContext context;
     private StateSerdes<K, V> serdes;
@@ -73,9 +73,9 @@ void initInternal(final ProcessorContext context) {
                                         keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
                                         valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
 
-        this.name = context.taskId() + "-" + underlying.name();
+        this.cacheName = context.taskId() + "-" + underlying.name();
         this.cache = this.context.getCache();
-        cache.addDirtyEntryFlushListener(name, new ThreadCache.DirtyEntryFlushListener() {
+        cache.addDirtyEntryFlushListener(cacheName, new ThreadCache.DirtyEntryFlushListener() {
             @Override
             public void apply(final List<ThreadCache.DirtyEntry> entries) {
                 for (ThreadCache.DirtyEntry entry : entries) {
@@ -108,7 +108,7 @@ public void setFlushListener(final CacheFlushListener<K, V> flushListener) {
 
     @Override
     public synchronized void flush() {
-        cache.flush(name);
+        cache.flush(cacheName);
         underlying.flush();
     }
 
@@ -116,7 +116,7 @@ public synchronized void flush() {
     public void close() {
         flush();
         underlying.close();
-        cache.close(name);
+        cache.close(cacheName);
     }
 
     @Override
@@ -141,12 +141,12 @@ public synchronized V get(final K key) {
 
     private void validateStoreOpen() {
         if (!isOpen()) {
-            throw new InvalidStateStoreException("Store " + this.name + " is currently closed");
+            throw new InvalidStateStoreException("Store " + this.name() + " is currently closed");
         }
     }
 
     private V get(final byte[] rawKey) {
-        final LRUCacheEntry entry = cache.get(name, rawKey);
+        final LRUCacheEntry entry = cache.get(cacheName, rawKey);
         if (entry == null) {
             final byte[] rawValue = underlying.get(Bytes.wrap(rawKey));
             if (rawValue == null) {
@@ -155,7 +155,7 @@ private V get(final byte[] rawKey) {
             // only update the cache if this call is on the streamThread
             // as we don't want other threads to trigger an eviction/flush
             if (Thread.currentThread().equals(streamThread)) {
-                cache.put(name, rawKey, new LRUCacheEntry(rawValue));
+                cache.put(cacheName, rawKey, new LRUCacheEntry(rawValue));
             }
             return serdes.valueFrom(rawValue);
         }
@@ -173,15 +173,15 @@ public KeyValueIterator<K, V> range(final K from, final K to) {
         final byte[] origFrom = serdes.rawKey(from);
         final byte[] origTo = serdes.rawKey(to);
         final KeyValueIterator<Bytes, byte[]> storeIterator = underlying.range(Bytes.wrap(origFrom), Bytes.wrap(origTo));
-        final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator = cache.range(name, origFrom, origTo);
+        final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator = cache.range(cacheName, origFrom, origTo);
         return new MergedSortedCacheKeyValueStoreIterator<>(cacheIterator, storeIterator, serdes);
     }
 
     @Override
     public KeyValueIterator<K, V> all() {
         validateStoreOpen();
-        final KeyValueIterator<Bytes, byte[]> storeIterator = new DelegatingPeekingKeyValueIterator<>(name, underlying.all());
-        final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator = cache.all(name);
+        final KeyValueIterator<Bytes, byte[]> storeIterator = new DelegatingPeekingKeyValueIterator<>(this.name(), underlying.all());
+        final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator = cache.all(cacheName);
         return new MergedSortedCacheKeyValueStoreIterator<>(cacheIterator, storeIterator, serdes);
     }
 
@@ -199,7 +199,7 @@ public synchronized void put(final K key, final V value) {
 
     private synchronized void put(final byte[] rawKey, final V value) {
         final byte[] rawValue = serdes.rawValue(value);
-        cache.put(name, rawKey, new LRUCacheEntry(rawValue, true, context.offset(),
+        cache.put(cacheName, rawKey, new LRUCacheEntry(rawValue, true, context.offset(),
                                                   context.timestamp(), context.partition(), context.topic()));
     }
 
@@ -226,7 +226,7 @@ public synchronized V delete(final K key) {
         validateStoreOpen();
         final byte[] rawKey = serdes.rawKey(key);
         final V v = get(rawKey);
-        cache.delete(name, serdes.rawKey(key));
+        cache.delete(cacheName, serdes.rawKey(key));
         underlying.delete(Bytes.wrap(rawKey));
         return v;
     }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java
index fec660932a696..2cea9155e6463 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java
@@ -41,7 +41,7 @@ class CachingSessionStore<K, AGG> extends WrappedStateStore.AbstractWrappedState
     private Serde<K> keySerde;
     private final Serde<AGG> aggSerde;
     private InternalProcessorContext context;
-    private String name;
+    private String cacheName;
     private StateSerdes<K, AGG> serdes;
     private ThreadCache cache;
     private CacheFlushListener<Windowed<K>, AGG> flushListener;
@@ -60,8 +60,8 @@ public KeyValueIterator<Windowed<K>, AGG> findSessions(final K key,
                                                            final long earliestSessionEndTime,
                                                            final long latestSessionStartTime) {
         validateStoreOpen();
-        final Bytes binarySessionId = Bytes.wrap(keySerde.serializer().serialize(name, key));
-        final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator = cache.range(name,
+        final Bytes binarySessionId = Bytes.wrap(keySerde.serializer().serialize(this.name(), key));
+        final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator = cache.range(cacheName,
                                                                                   keySchema.lowerRange(binarySessionId,
                                                                                                        earliestSessionEndTime).get(),
                                                                                   keySchema.upperRange(binarySessionId, latestSessionStartTime).get());
@@ -84,7 +84,7 @@ public void put(final Windowed<K> key, AGG value) {
         final Bytes binaryKey = SessionKeySerde.toBinary(key, keySerde.serializer());
         final LRUCacheEntry entry = new LRUCacheEntry(serdes.rawValue(value), true, context.offset(),
                                                       key.window().end(), context.partition(), context.topic());
-        cache.put(name, binaryKey.get(), entry);
+        cache.put(cacheName, binaryKey.get(), entry);
     }
 
     @Override
@@ -107,9 +107,9 @@ private void initInternal(final InternalProcessorContext context) {
                                         aggSerde == null ? (Serde<AGG>) context.valueSerde() : aggSerde);
 
 
-        this.name = context.taskId() + "-" + bytesStore.name();
+        this.cacheName = context.taskId() + "-" + bytesStore.name();
         this.cache = this.context.getCache();
-        cache.addDirtyEntryFlushListener(name, new ThreadCache.DirtyEntryFlushListener() {
+        cache.addDirtyEntryFlushListener(cacheName, new ThreadCache.DirtyEntryFlushListener() {
             @Override
             public void apply(final List<ThreadCache.DirtyEntry> entries) {
                 for (ThreadCache.DirtyEntry entry : entries) {
@@ -150,14 +150,14 @@ private AGG fetchPrevious(final Bytes key) {
 
 
     public void flush() {
-        cache.flush(name);
+        cache.flush(cacheName);
         bytesStore.flush();
     }
 
     public void close() {
         flush();
         bytesStore.close();
-        cache.close(name);
+        cache.close(cacheName);
     }
 
     public void setFlushListener(CacheFlushListener<Windowed<K>, AGG> flushListener) {
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
index 55c1bb821c428..5c83ddfc6045c 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
@@ -352,6 +352,7 @@ public synchronized void close() {
         if (!open) {
             return;
         }
+
         open = false;
         closeOpenIterators();
         options.close();
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/GlobalKTableJoinsTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/GlobalKTableJoinsTest.java
index bbc9741ca2be6..c41d9539f597e 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/GlobalKTableJoinsTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/GlobalKTableJoinsTest.java
@@ -25,6 +25,7 @@
 import org.apache.kafka.test.KStreamTestDriver;
 import org.apache.kafka.test.MockValueJoiner;
 import org.apache.kafka.test.TestUtils;
+import org.junit.After;
 import org.junit.Before;
 import org.junit.Test;
 
@@ -38,14 +39,15 @@
 public class GlobalKTableJoinsTest {
 
     private final KStreamBuilder builder = new KStreamBuilder();
-    private GlobalKTable<String, String> global;
-    private File stateDir;
     private final Map<String, String> results = new HashMap<>();
+    private final String streamTopic = "stream";
+    private final String globalTopic = "global";
+    private File stateDir;
+    private GlobalKTable<String, String> global;
     private KStream<String, String> stream;
     private KeyValueMapper<String, String, String> keyValueMapper;
     private ForeachAction<String, String> action;
-    private final String streamTopic = "stream";
-    private final String globalTopic = "global";
+    private KStreamTestDriver driver = null;
 
     @Before
     public void setUp() throws Exception {
@@ -64,7 +66,14 @@ public void apply(final String key, final String value) {
                 results.put(key, value);
             }
         };
+    }
 
+    @After
+    public void cleanup() {
+        if (driver != null) {
+            driver.close();
+        }
+        driver = null;
     }
 
     @Test
@@ -94,7 +103,7 @@ public void shouldInnerJoinWithStream() throws Exception {
     }
 
     private void verifyJoin(final Map<String, String> expected, final String joinInput) {
-        final KStreamTestDriver driver = new KStreamTestDriver(builder, stateDir);
+        driver = new KStreamTestDriver(builder, stateDir);
         driver.setTime(0L);
         // write some data to the global table
         driver.process(globalTopic, "a", "A");
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KGroupedStreamImplTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KGroupedStreamImplTest.java
index b6d8a974200f3..3fd287d7304b4 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KGroupedStreamImplTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KGroupedStreamImplTest.java
@@ -32,12 +32,14 @@
 import org.apache.kafka.streams.processor.StateStoreSupplier;
 import org.apache.kafka.streams.kstream.Windowed;
 import org.apache.kafka.streams.kstream.Windows;
+import org.apache.kafka.streams.state.KeyValueStore;
 import org.apache.kafka.streams.state.SessionStore;
 import org.apache.kafka.test.KStreamTestDriver;
 import org.apache.kafka.test.MockAggregator;
 import org.apache.kafka.test.MockInitializer;
 import org.apache.kafka.test.MockReducer;
 import org.apache.kafka.test.TestUtils;
+import org.junit.After;
 import org.junit.Before;
 import org.junit.Test;
 
@@ -56,6 +58,7 @@ public class KGroupedStreamImplTest {
     private static final String TOPIC = "topic";
     private final KStreamBuilder builder = new KStreamBuilder();
     private KGroupedStream<String, String> groupedStream;
+    private KStreamTestDriver driver = null;
 
     @Before
     public void before() {
@@ -63,6 +66,14 @@ public void before() {
         groupedStream = stream.groupByKey(Serdes.String(), Serdes.String());
     }
 
+    @After
+    public void cleanup() {
+        if (driver != null) {
+            driver.close();
+        }
+        driver = null;
+    }
+
     @Test(expected = NullPointerException.class)
     public void shouldNotHaveNullReducerOnReduce() throws Exception {
         groupedStream.reduce(null, "store");
@@ -70,14 +81,12 @@ public void shouldNotHaveNullReducerOnReduce() throws Exception {
 
     @Test(expected = NullPointerException.class)
     public void shouldNotHaveNullStoreNameOnReduce() throws Exception {
-        String storeName = null;
-        groupedStream.reduce(MockReducer.STRING_ADDER, storeName);
+        groupedStream.reduce(MockReducer.STRING_ADDER, (String) null);
     }
 
     @Test(expected = NullPointerException.class)
     public void shouldNotHaveNullStoreSupplierOnReduce() throws Exception {
-        StateStoreSupplier storeSupplier = null;
-        groupedStream.reduce(MockReducer.STRING_ADDER, storeSupplier);
+        groupedStream.reduce(MockReducer.STRING_ADDER, (StateStoreSupplier<KeyValueStore>) null);
     }
 
     @Test(expected = NullPointerException.class)
@@ -92,8 +101,7 @@ public void shouldNotHaveNullWindowsWithWindowedReduce() throws Exception {
 
     @Test(expected = NullPointerException.class)
     public void shouldNotHaveNullStoreNameWithWindowedReduce() throws Exception {
-        String storeName = null;
-        groupedStream.reduce(MockReducer.STRING_ADDER, TimeWindows.of(10), storeName);
+        groupedStream.reduce(MockReducer.STRING_ADDER, TimeWindows.of(10), (String) null);
     }
 
     @Test(expected = NullPointerException.class)
@@ -108,8 +116,7 @@ public void shouldNotHaveNullAdderOnAggregate() throws Exception {
 
     @Test(expected = NullPointerException.class)
     public void shouldNotHaveNullStoreNameOnAggregate() throws Exception {
-        String storeName = null;
-        groupedStream.aggregate(MockInitializer.STRING_INIT, MockAggregator.TOSTRING_ADDER, Serdes.String(), storeName);
+        groupedStream.aggregate(MockInitializer.STRING_INIT, MockAggregator.TOSTRING_ADDER, Serdes.String(), null);
     }
 
     @Test(expected = NullPointerException.class)
@@ -129,14 +136,12 @@ public void shouldNotHaveNullWindowsOnWindowedAggregate() throws Exception {
 
     @Test(expected = NullPointerException.class)
     public void shouldNotHaveNullStoreNameOnWindowedAggregate() throws Exception {
-        String storeName = null;
-        groupedStream.aggregate(MockInitializer.STRING_INIT, MockAggregator.TOSTRING_ADDER, TimeWindows.of(10), Serdes.String(), storeName);
+        groupedStream.aggregate(MockInitializer.STRING_INIT, MockAggregator.TOSTRING_ADDER, TimeWindows.of(10), Serdes.String(), null);
     }
 
     @Test(expected = NullPointerException.class)
     public void shouldNotHaveNullStoreSupplierOnWindowedAggregate() throws Exception {
-        StateStoreSupplier storeSupplier = null;
-        groupedStream.aggregate(MockInitializer.STRING_INIT, MockAggregator.TOSTRING_ADDER, TimeWindows.of(10), storeSupplier);
+        groupedStream.aggregate(MockInitializer.STRING_INIT, MockAggregator.TOSTRING_ADDER, TimeWindows.of(10), null);
     }
 
     @Test
@@ -165,7 +170,7 @@ public void apply(final Windowed<String> key, final Integer value) {
                     }
                 });
 
-        final KStreamTestDriver driver = new KStreamTestDriver(builder, TestUtils.tempDirectory());
+        driver = new KStreamTestDriver(builder, TestUtils.tempDirectory());
         driver.setTime(10);
         driver.process(TOPIC, "1", "1");
         driver.setTime(15);
@@ -194,7 +199,7 @@ public void apply(final Windowed<String> key, final Long value) {
                         results.put(key, value);
                     }
                 });
-        final KStreamTestDriver driver = new KStreamTestDriver(builder, TestUtils.tempDirectory());
+        driver = new KStreamTestDriver(builder, TestUtils.tempDirectory());
         driver.setTime(10);
         driver.process(TOPIC, "1", "1");
         driver.setTime(15);
@@ -230,7 +235,7 @@ public void apply(final Windowed<String> key, final String value) {
                         results.put(key, value);
                     }
                 });
-        final KStreamTestDriver driver = new KStreamTestDriver(builder, TestUtils.tempDirectory());
+        driver = new KStreamTestDriver(builder, TestUtils.tempDirectory());
         driver.setTime(10);
         driver.process(TOPIC, "1", "A");
         driver.setTime(15);
@@ -357,7 +362,7 @@ public void apply(final Windowed<String> key, final Long value) {
                     }
                 });
 
-        final KStreamTestDriver driver = new KStreamTestDriver(builder, TestUtils.tempDirectory(), 0);
+        driver = new KStreamTestDriver(builder, TestUtils.tempDirectory(), 0);
         driver.setTime(0);
         driver.process(TOPIC, "1", "A");
         driver.process(TOPIC, "2", "B");
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KGroupedTableImplTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KGroupedTableImplTest.java
index 5ed61e1c750e2..5fded02dec1bb 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KGroupedTableImplTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KGroupedTableImplTest.java
@@ -24,13 +24,13 @@
 import org.apache.kafka.streams.kstream.KStreamBuilder;
 import org.apache.kafka.streams.kstream.KTable;
 import org.apache.kafka.streams.kstream.KeyValueMapper;
-import org.apache.kafka.streams.processor.StateStoreSupplier;
 import org.apache.kafka.test.KStreamTestDriver;
 import org.apache.kafka.test.MockAggregator;
 import org.apache.kafka.test.MockInitializer;
 import org.apache.kafka.test.MockKeyValueMapper;
 import org.apache.kafka.test.MockReducer;
 import org.apache.kafka.test.TestUtils;
+import org.junit.After;
 import org.junit.Before;
 import org.junit.Test;
 
@@ -42,19 +42,27 @@
 
 public class KGroupedTableImplTest {
 
+    private final KStreamBuilder builder = new KStreamBuilder();
     private KGroupedTable<String, String> groupedTable;
+    private KStreamTestDriver driver = null;
 
     @Before
     public void before() {
-        final KStreamBuilder builder = new KStreamBuilder();
         groupedTable = builder.table(Serdes.String(), Serdes.String(), "blah", "blah")
                 .groupBy(MockKeyValueMapper.<String, String>SelectValueKeyValueMapper());
     }
 
+    @After
+    public void cleanup() {
+        if (driver != null) {
+            driver.close();
+        }
+        driver = null;
+    }
+
     @Test(expected = NullPointerException.class)
     public void shouldNotAllowNullStoreNameOnAggregate() throws Exception {
-        String storeName = null;
-        groupedTable.aggregate(MockInitializer.STRING_INIT, MockAggregator.TOSTRING_ADDER, MockAggregator.TOSTRING_REMOVER, storeName);
+        groupedTable.aggregate(MockInitializer.STRING_INIT, MockAggregator.TOSTRING_ADDER, MockAggregator.TOSTRING_REMOVER, (String) null);
     }
 
     @Test(expected = NullPointerException.class)
@@ -84,19 +92,16 @@ public void shouldNotAllowNullSubtractorOnReduce() throws Exception {
 
     @Test(expected = NullPointerException.class)
     public void shouldNotAllowNullStoreNameOnReduce() throws Exception {
-        String storeName = null;
-        groupedTable.reduce(MockReducer.STRING_ADDER, MockReducer.STRING_REMOVER, storeName);
+        groupedTable.reduce(MockReducer.STRING_ADDER, MockReducer.STRING_REMOVER, (String) null);
     }
 
     @Test(expected = NullPointerException.class)
     public void shouldNotAllowNullStoreSupplierOnReduce() throws Exception {
-        StateStoreSupplier storeName = null;
-        groupedTable.reduce(MockReducer.STRING_ADDER, MockReducer.STRING_REMOVER, storeName);
+        groupedTable.reduce(MockReducer.STRING_ADDER, MockReducer.STRING_REMOVER, (String) null);
     }
 
     @Test
     public void shouldReduce() throws Exception {
-        final KStreamBuilder builder = new KStreamBuilder();
         final String topic = "input";
         final KeyValueMapper<String, Number, KeyValue<String, Integer>> intProjection =
             new KeyValueMapper<String, Number, KeyValue<String, Integer>>() {
@@ -118,8 +123,7 @@ public void apply(final String key, final Integer value) {
             }
         });
 
-
-        final KStreamTestDriver driver = new KStreamTestDriver(builder, TestUtils.tempDirectory(), Serdes.String(), Serdes.Integer());
+        driver = new KStreamTestDriver(builder, TestUtils.tempDirectory(), Serdes.String(), Serdes.Integer());
         driver.setTime(10L);
         driver.process(topic, "A", 1.1);
         driver.process(topic, "B", 2.2);
@@ -136,6 +140,5 @@ public void apply(final String key, final Integer value) {
 
         assertEquals(Integer.valueOf(5), results.get("A"));
         assertEquals(Integer.valueOf(6), results.get("B"));
-
     }
 }
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableAggregateTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableAggregateTest.java
index a43cab629caba..39baa4ebc9ecb 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableAggregateTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableAggregateTest.java
@@ -220,7 +220,7 @@ public void testCount() throws IOException {
                 .toStream()
                 .process(proc);
 
-        final KStreamTestDriver driver = new KStreamTestDriver(builder, stateDir);
+        driver = new KStreamTestDriver(builder, stateDir);
 
         driver.process(input, "A", "green");
         driver.flushState();
@@ -256,7 +256,7 @@ public void testCountCoalesced() throws IOException {
             .toStream()
             .process(proc);
 
-        final KStreamTestDriver driver = new KStreamTestDriver(builder, stateDir);
+        driver = new KStreamTestDriver(builder, stateDir);
 
         driver.process(input, "A", "green");
         driver.process(input, "B", "green");
@@ -309,7 +309,7 @@ public String apply(String key, String value, String aggregate) {
                 .toStream()
                 .process(proc);
 
-        final KStreamTestDriver driver = new KStreamTestDriver(builder, stateDir);
+        driver = new KStreamTestDriver(builder, stateDir);
 
         driver.process(input, "11", "A");
         driver.flushState();
@@ -378,7 +378,7 @@ public String apply(final String value) {
                     }
                 });
 
-        final KStreamTestDriver driver = new KStreamTestDriver(builder, stateDir, 111);
+        driver = new KStreamTestDriver(builder, stateDir, 111);
         driver.process(reduceTopic, "1", new Change<>(1L, null));
         driver.process("tableOne", "2", "2");
         // this should trigger eviction on the reducer-store topic
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableLeftJoinTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableLeftJoinTest.java
index cbf1da4aed8a7..97900449aebf3 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableLeftJoinTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableLeftJoinTest.java
@@ -367,7 +367,6 @@ public String apply(final String value) {
         };
         final KTable<Long, String> seven = one.mapValues(mapper);
 
-
         final KTable<Long, String> eight = six.leftJoin(seven, MockValueJoiner.TOSTRING_JOINER);
 
         aggTable.leftJoin(one, MockValueJoiner.TOSTRING_JOINER)
@@ -378,7 +377,7 @@ public String apply(final String value) {
                 .leftJoin(eight, MockValueJoiner.TOSTRING_JOINER)
                 .mapValues(mapper);
 
-        final KStreamTestDriver driver = new KStreamTestDriver(builder, stateDir, 250);
+        driver = new KStreamTestDriver(builder, stateDir, 250);
 
         final String[] values = {"a", "AA", "BBB", "CCCC", "DD", "EEEEEEEE", "F", "GGGGGGGGGGGGGGG", "HHH", "IIIIIIIIII",
                                  "J", "KK", "LLLL", "MMMMMMMMMMMMMMMMMMMMMM", "NNNNN", "O", "P", "QQQQQ", "R", "SSSS",
@@ -387,7 +386,7 @@ public String apply(final String value) {
         final Random random = new Random();
         for (int i = 0; i < 1000; i++) {
             for (String input : inputs) {
-                final Long key = Long.valueOf(random.nextInt(1000));
+                final Long key = (long) random.nextInt(1000);
                 final String value = values[random.nextInt(values.length)];
                 driver.process(input, key, value);
             }
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KeyValuePrinterProcessorTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KeyValuePrinterProcessorTest.java
index d1bff05b83d0c..4ab1c35d0b2a9 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KeyValuePrinterProcessorTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KeyValuePrinterProcessorTest.java
@@ -38,11 +38,11 @@
 
 public class KeyValuePrinterProcessorTest {
 
-    private String topicName = "topic";
-    private Serde<String> stringSerde = Serdes.String();
-    private ByteArrayOutputStream baos = new ByteArrayOutputStream();
-    private KStreamBuilder builder = new KStreamBuilder();
-    private PrintStream printStream = new PrintStream(baos);
+    private final String topicName = "topic";
+    private final Serde<String> stringSerde = Serdes.String();
+    private final ByteArrayOutputStream baos = new ByteArrayOutputStream();
+    private final KStreamBuilder builder = new KStreamBuilder();
+    private final PrintStream printStream = new PrintStream(baos);
 
     private KStreamTestDriver driver = null;
 
diff --git a/streams/src/test/java/org/apache/kafka/test/KStreamTestDriver.java b/streams/src/test/java/org/apache/kafka/test/KStreamTestDriver.java
index 011532baeef39..dfa2987d04855 100644
--- a/streams/src/test/java/org/apache/kafka/test/KStreamTestDriver.java
+++ b/streams/src/test/java/org/apache/kafka/test/KStreamTestDriver.java
@@ -196,8 +196,11 @@ public void flushState() {
     }
 
     private void closeState() {
+        // we need to first flush all stores before trying to close any one
+        // of them since the flushing could cause eviction and hence tries to access other stores
+        flushState();
+
         for (StateStore stateStore : context.allStateStores().values()) {
-            stateStore.flush();
             stateStore.close();
         }
     }

From 1d2426683b0dba7f57d064b9ed0ddcf1c9c25c3c Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno.thereska@gmail.com>
Date: Wed, 25 Jan 2017 11:40:17 -0800
Subject: [PATCH 047/177] HOTFIX: KIP-104 follow-up: remove duplicated
 per-processor-node throughput metrics, and also rename some other sensors

This is the HOTFIX PR for any issues detected with KIP-104 until code freeze. Note: do not merge until close to code freeze.

The name changes reflect feedback received while writing the documentation.

Author: Eno Thereska <eno.thereska@gmail.com>

Reviewers: Dan Norwood, Guozhang Wang

Closes #2398 from enothereska/hotfix-streams-metrics

(cherry picked from commit 0971e62e50b94a74aae170fb49d1e532e39b2136)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../apache/kafka/streams/StreamsMetrics.java  | 16 +++--
 .../processor/internals/ProcessorNode.java    | 17 +++---
 .../processor/internals/SourceNode.java       |  2 +-
 .../processor/internals/StreamTask.java       |  2 +-
 .../processor/internals/StreamThread.java     | 58 +++++++++----------
 .../internals/StreamsMetricsImpl.java         |  8 +--
 .../state/internals/MeteredKeyValueStore.java | 18 +++---
 .../internals/MeteredSegmentedBytesStore.java | 12 ++--
 .../internals/ProcessorNodeTest.java          | 10 ++--
 .../processor/internals/StreamTaskTest.java   |  6 +-
 .../processor/internals/StreamThreadTest.java | 42 +++++++-------
 .../internals/StreamsMetricsImplTest.java     |  4 +-
 .../MeteredSegmentedBytesStoreTest.java       |  2 +-
 13 files changed, 99 insertions(+), 98 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/StreamsMetrics.java b/streams/src/main/java/org/apache/kafka/streams/StreamsMetrics.java
index afd3497356139..7b68137fe55c0 100644
--- a/streams/src/main/java/org/apache/kafka/streams/StreamsMetrics.java
+++ b/streams/src/main/java/org/apache/kafka/streams/StreamsMetrics.java
@@ -37,7 +37,7 @@ public interface StreamsMetrics {
     Map<MetricName, ? extends Metric> metrics();
 
     /**
-     * Add a latency sensor and default associated metrics. Metrics include both latency ones
+     * Add a latency and throughput sensor and default associated metrics. Metrics include both latency ones
      * (average and max latency) and throughput ones (operations/time unit).
      *
      * @param scopeName Name of the scope, could be the type of the state store, etc.
@@ -47,10 +47,13 @@ public interface StreamsMetrics {
      * @param tags Additional tags of the sensor.
      * @return The added sensor.
      */
-    Sensor addLatencySensor(String scopeName, String entityName, String operationName, Sensor.RecordingLevel recordingLevel, String... tags);
+    Sensor addLatencyAndThroughputSensor(String scopeName, String entityName, String operationName, Sensor.RecordingLevel recordingLevel, String... tags);
 
     /**
-     * Record the given latency value of the sensor.
+     * Record the given latency value of the sensor. If the passed sensor includes throughput metrics,
+     * e.g., when created by the {@link #addLatencyAndThroughputSensor(String, String, String, Sensor.RecordingLevel, String...)}
+     * method, then the throughput metrics will also be recorded from this event.
+     *
      * @param sensor sensor whose latency we are recording.
      * @param startNs start of measurement time in nanoseconds.
      * @param endNs end of measurement time in nanoseconds.
@@ -59,7 +62,8 @@ public interface StreamsMetrics {
 
     /**
      * Add a throughput sensor and default associated metrics. Metrics include throughput ones
-     * (operations/time unit).
+     * (operations/time unit). This sensor is a strict subset of the sensor created by
+     * {@link #addLatencyAndThroughputSensor(String, String, String, Sensor.RecordingLevel, String...)}.
      *
      * @param scopeName Name of the scope, could be the type of the state store, etc.
      * @param entityName Name of the entity, could be the name of the state store instance, etc.
@@ -81,7 +85,7 @@ public interface StreamsMetrics {
     /**
      * Generic method to create a sensor.
      * Note that for most cases it is advisable to use {@link #addThroughputSensor(String, String, String, Sensor.RecordingLevel, String...)}
-     * or {@link #addLatencySensor(String, String, String, Sensor.RecordingLevel, String...)} to ensure
+     * or {@link #addLatencyAndThroughputSensor(String, String, String, Sensor.RecordingLevel, String...)} to ensure
      * metric name well-formedness and conformity with the rest of the streams code base. However,
      * if the above two methods are not sufficient, this method can also be used.
      * @param name Name of the sensor.
@@ -92,7 +96,7 @@ public interface StreamsMetrics {
     /**
      * Generic method to create a sensor with parent sensors.
      * Note that for most cases it is advisable to use {@link #addThroughputSensor(String, String, String, Sensor.RecordingLevel, String...)}
-     * or {@link #addLatencySensor(String, String, String, Sensor.RecordingLevel, String...)} to ensure
+     * or {@link #addLatencyAndThroughputSensor(String, String, String, Sensor.RecordingLevel, String...)} to ensure
      * metric name well-formedness and conformity with the rest of the streams code base. However,
      * if the above two methods are not sufficient, this method can also be used.
      * @param name Name of the sensor.
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorNode.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorNode.java
index b66e3df7b255b..fa4cc2b96ebe5 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorNode.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorNode.java
@@ -132,9 +132,6 @@ public void process(final K key, final V value) {
         this.value = value;
 
         this.nodeMetrics.metrics.measureLatencyNs(time, processDelegate, nodeMetrics.nodeProcessTimeSensor);
-
-        // record throughput
-        this.nodeMetrics.metrics.recordThroughput(nodeMetrics.nodeThroughputSensor, 1);
     }
 
     public void punctuate(long timestamp) {
@@ -174,7 +171,7 @@ protected class NodeMetrics  {
 
         final Sensor nodeProcessTimeSensor;
         final Sensor nodePunctuateTimeSensor;
-        final Sensor nodeThroughputSensor;
+        final Sensor sourceNodeForwardSensor;
         final Sensor nodeCreationSensor;
         final Sensor nodeDestructionSensor;
 
@@ -189,18 +186,18 @@ public NodeMetrics(StreamsMetrics metrics, String name, String sensorNamePrefix)
             this.metricTags.put(tagKey, tagValue);
 
             // these are all latency metrics
-            this.nodeProcessTimeSensor = metrics.addLatencySensor(scope, sensorNamePrefix + "." + name, "process", Sensor.RecordingLevel.DEBUG, tagKey, tagValue);
-            this.nodePunctuateTimeSensor = metrics.addLatencySensor(scope, sensorNamePrefix + "." + name, "punctuate", Sensor.RecordingLevel.DEBUG, tagKey, tagValue);
-            this.nodeCreationSensor = metrics.addLatencySensor(scope, sensorNamePrefix + "." + name, "create", Sensor.RecordingLevel.DEBUG, tagKey, tagValue);
-            this.nodeDestructionSensor = metrics.addLatencySensor(scope, sensorNamePrefix + "." + name, "destroy", Sensor.RecordingLevel.DEBUG, tagKey, tagValue);
-            this.nodeThroughputSensor = metrics.addThroughputSensor(scope, sensorNamePrefix + "." + name, "process-throughput", Sensor.RecordingLevel.DEBUG, tagKey, tagValue);
+            this.nodeProcessTimeSensor = metrics.addLatencyAndThroughputSensor(scope, sensorNamePrefix + "." + name, "process", Sensor.RecordingLevel.DEBUG, tagKey, tagValue);
+            this.nodePunctuateTimeSensor = metrics.addLatencyAndThroughputSensor(scope, sensorNamePrefix + "." + name, "punctuate", Sensor.RecordingLevel.DEBUG, tagKey, tagValue);
+            this.nodeCreationSensor = metrics.addLatencyAndThroughputSensor(scope, sensorNamePrefix + "." + name, "create", Sensor.RecordingLevel.DEBUG, tagKey, tagValue);
+            this.nodeDestructionSensor = metrics.addLatencyAndThroughputSensor(scope, sensorNamePrefix + "." + name, "destroy", Sensor.RecordingLevel.DEBUG, tagKey, tagValue);
+            this.sourceNodeForwardSensor = metrics.addThroughputSensor(scope, sensorNamePrefix + "." + name, "forward", Sensor.RecordingLevel.DEBUG, tagKey, tagValue);
 
         }
 
         public void removeAllSensors() {
             metrics.removeSensor(nodeProcessTimeSensor);
             metrics.removeSensor(nodePunctuateTimeSensor);
-            metrics.removeSensor(nodeThroughputSensor);
+            metrics.removeSensor(sourceNodeForwardSensor);
             metrics.removeSensor(nodeCreationSensor);
             metrics.removeSensor(nodeDestructionSensor);
         }
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/SourceNode.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/SourceNode.java
index 340660640a323..d44929c2cc7f7 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/SourceNode.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/SourceNode.java
@@ -68,7 +68,7 @@ public void init(ProcessorContext context) {
     @Override
     public void process(final K key, final V value) {
         context.forward(key, value);
-        nodeMetrics.nodeThroughputSensor.record();
+        nodeMetrics.sourceNodeForwardSensor.record();
     }
 
     /**
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamTask.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamTask.java
index b71422148c173..7375fb597a0e3 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamTask.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamTask.java
@@ -408,7 +408,7 @@ protected class TaskMetrics  {
         public TaskMetrics(StreamsMetrics metrics) {
             String name = id.toString();
             this.metrics = (StreamsMetricsImpl) metrics;
-            this.taskCommitTimeSensor = metrics.addLatencySensor("task", name, "commit", Sensor.RecordingLevel.DEBUG, "streams-task-id", name);
+            this.taskCommitTimeSensor = metrics.addLatencyAndThroughputSensor("task", name, "commit", Sensor.RecordingLevel.DEBUG, "streams-task-id", name);
         }
 
         public void removeAllSensors() {
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
index b445a51a48d6b..01281423cca35 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
@@ -827,7 +827,7 @@ public Set<TaskId> cachedTasks() {
     protected StreamTask createStreamTask(TaskId id, Collection<TopicPartition> partitions) {
         log.info("{} Creating active task {} with assigned partitions [{}]", logPrefix, id, partitions);
 
-        streamsMetrics.taskCreationSensor.record();
+        streamsMetrics.taskCreatedSensor.record();
 
         final ProcessorTopology topology = builder.build(id.topicGroupId);
         final RecordCollector recordCollector = new RecordCollectorImpl(producer, id.toString());
@@ -940,7 +940,7 @@ private void addStreamTasks(Collection<TopicPartition> assignment) {
     StandbyTask createStandbyTask(TaskId id, Collection<TopicPartition> partitions) {
         log.info("{} Creating new standby task {} with assigned partitions [{}]", logPrefix, id, partitions);
 
-        streamsMetrics.taskCreationSensor.record();
+        streamsMetrics.taskCreatedSensor.record();
 
         ProcessorTopology topology = builder.build(id.topicGroupId);
 
@@ -1044,7 +1044,7 @@ private RuntimeException closeAllTasks() {
             public void apply(final AbstractTask task) {
                 log.info("{} Closing a task {}", StreamThread.this.logPrefix, task.id());
                 task.close();
-                streamsMetrics.taskDestructionSensor.record();
+                streamsMetrics.tasksClosedSensor.record();
             }
         }, "close");
     }
@@ -1055,7 +1055,7 @@ private RuntimeException closeAllTasksTopologies() {
             public void apply(final AbstractTask task) {
                 log.info("{} Closing a task's topology {}", StreamThread.this.logPrefix, task.id());
                 task.closeTopology();
-                streamsMetrics.taskDestructionSensor.record();
+                streamsMetrics.tasksClosedSensor.record();
             }
         }, "close");
     }
@@ -1111,40 +1111,40 @@ private class StreamsMetricsThreadImpl extends StreamsMetricsImpl {
         final Sensor pollTimeSensor;
         final Sensor processTimeSensor;
         final Sensor punctuateTimeSensor;
-        final Sensor taskCreationSensor;
-        final Sensor taskDestructionSensor;
+        final Sensor taskCreatedSensor;
+        final Sensor tasksClosedSensor;
         final Sensor skippedRecordsSensor;
 
         public StreamsMetricsThreadImpl(Metrics metrics, String groupName, String prefix, Map<String, String> tags) {
             super(metrics, groupName, tags);
-            this.commitTimeSensor = metrics.sensor(prefix + ".commit-time", Sensor.RecordingLevel.INFO);
-            this.commitTimeSensor.add(metrics.metricName("commit-time-avg", this.groupName, "The average commit time in ms", this.tags), new Avg());
-            this.commitTimeSensor.add(metrics.metricName("commit-time-max", this.groupName, "The maximum commit time in ms", this.tags), new Max());
-            this.commitTimeSensor.add(metrics.metricName("commit-calls-rate", this.groupName, "The average per-second number of commit calls", this.tags), new Rate(new Count()));
+            this.commitTimeSensor = metrics.sensor(prefix + ".commit-latency", Sensor.RecordingLevel.INFO);
+            this.commitTimeSensor.add(metrics.metricName("commit-latency-avg", this.groupName, "The average commit time in ms", this.tags), new Avg());
+            this.commitTimeSensor.add(metrics.metricName("commit-latency-max", this.groupName, "The maximum commit time in ms", this.tags), new Max());
+            this.commitTimeSensor.add(metrics.metricName("commit-rate", this.groupName, "The average per-second number of commit calls", this.tags), new Rate(new Count()));
 
-            this.pollTimeSensor = metrics.sensor(prefix + ".poll-time", Sensor.RecordingLevel.INFO);
-            this.pollTimeSensor.add(metrics.metricName("poll-time-avg", this.groupName, "The average poll time in ms", this.tags), new Avg());
-            this.pollTimeSensor.add(metrics.metricName("poll-time-max", this.groupName, "The maximum poll time in ms", this.tags), new Max());
-            this.pollTimeSensor.add(metrics.metricName("poll-calls-rate", this.groupName, "The average per-second number of record-poll calls", this.tags), new Rate(new Count()));
+            this.pollTimeSensor = metrics.sensor(prefix + ".poll-latency", Sensor.RecordingLevel.INFO);
+            this.pollTimeSensor.add(metrics.metricName("poll-latency-avg", this.groupName, "The average poll time in ms", this.tags), new Avg());
+            this.pollTimeSensor.add(metrics.metricName("poll-latency-max", this.groupName, "The maximum poll time in ms", this.tags), new Max());
+            this.pollTimeSensor.add(metrics.metricName("poll-rate", this.groupName, "The average per-second number of record-poll calls", this.tags), new Rate(new Count()));
 
-            this.processTimeSensor = metrics.sensor(prefix + ".process-time", Sensor.RecordingLevel.INFO);
-            this.processTimeSensor.add(metrics.metricName("process-time-avg", this.groupName, "The average process time in ms", this.tags), new Avg());
-            this.processTimeSensor.add(metrics.metricName("process-time-max", this.groupName, "The maximum process time in ms", this.tags), new Max());
-            this.processTimeSensor.add(metrics.metricName("process-calls-rate", this.groupName, "The average per-second number of process calls", this.tags), new Rate(new Count()));
+            this.processTimeSensor = metrics.sensor(prefix + ".process-latency", Sensor.RecordingLevel.INFO);
+            this.processTimeSensor.add(metrics.metricName("process-latency-avg", this.groupName, "The average process time in ms", this.tags), new Avg());
+            this.processTimeSensor.add(metrics.metricName("process-latency-max", this.groupName, "The maximum process time in ms", this.tags), new Max());
+            this.processTimeSensor.add(metrics.metricName("process-rate", this.groupName, "The average per-second number of process calls", this.tags), new Rate(new Count()));
 
-            this.punctuateTimeSensor = metrics.sensor(prefix + ".punctuate-time", Sensor.RecordingLevel.INFO);
-            this.punctuateTimeSensor.add(metrics.metricName("punctuate-time-avg", this.groupName, "The average punctuate time in ms", this.tags), new Avg());
-            this.punctuateTimeSensor.add(metrics.metricName("punctuate-time-max", this.groupName, "The maximum punctuate time in ms", this.tags), new Max());
-            this.punctuateTimeSensor.add(metrics.metricName("punctuate-calls-rate", this.groupName, "The average per-second number of punctuate calls", this.tags), new Rate(new Count()));
+            this.punctuateTimeSensor = metrics.sensor(prefix + ".punctuate-latency", Sensor.RecordingLevel.INFO);
+            this.punctuateTimeSensor.add(metrics.metricName("punctuate-latency-avg", this.groupName, "The average punctuate time in ms", this.tags), new Avg());
+            this.punctuateTimeSensor.add(metrics.metricName("punctuate-latency-max", this.groupName, "The maximum punctuate time in ms", this.tags), new Max());
+            this.punctuateTimeSensor.add(metrics.metricName("punctuate-rate", this.groupName, "The average per-second number of punctuate calls", this.tags), new Rate(new Count()));
 
-            this.taskCreationSensor = metrics.sensor(prefix + ".task-creation", Sensor.RecordingLevel.INFO);
-            this.taskCreationSensor.add(metrics.metricName("task-creation-rate", this.groupName, "The average per-second number of newly created tasks", this.tags), new Rate(new Count()));
+            this.taskCreatedSensor = metrics.sensor(prefix + ".task-created", Sensor.RecordingLevel.INFO);
+            this.taskCreatedSensor.add(metrics.metricName("task-created-rate", this.groupName, "The average per-second number of newly created tasks", this.tags), new Rate(new Count()));
 
-            this.taskDestructionSensor = metrics.sensor(prefix + ".task-destruction", Sensor.RecordingLevel.INFO);
-            this.taskDestructionSensor.add(metrics.metricName("task-destruction-rate", this.groupName, "The average per-second number of destructed tasks", this.tags), new Rate(new Count()));
+            this.tasksClosedSensor = metrics.sensor(prefix + ".task-closed", Sensor.RecordingLevel.INFO);
+            this.tasksClosedSensor.add(metrics.metricName("task-closed-rate", this.groupName, "The average per-second number of closed tasks", this.tags), new Rate(new Count()));
 
             this.skippedRecordsSensor = metrics.sensor(prefix + ".skipped-records");
-            this.skippedRecordsSensor.add(metrics.metricName("skipped-records-count", this.groupName, "The average per-second number of skipped records.", this.tags), new Rate(new Count()));
+            this.skippedRecordsSensor.add(metrics.metricName("skipped-records-rate", this.groupName, "The average per-second number of skipped records.", this.tags), new Rate(new Count()));
 
         }
 
@@ -1159,8 +1159,8 @@ public void removeAllSensors() {
             removeSensor(pollTimeSensor);
             removeSensor(processTimeSensor);
             removeSensor(punctuateTimeSensor);
-            removeSensor(taskCreationSensor);
-            removeSensor(taskDestructionSensor);
+            removeSensor(taskCreatedSensor);
+            removeSensor(tasksClosedSensor);
             removeSensor(skippedRecordsSensor);
 
         }
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsMetricsImpl.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsMetricsImpl.java
index e29476bd5cd87..99ab03ccb5f89 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsMetricsImpl.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsMetricsImpl.java
@@ -113,7 +113,7 @@ private Map<String, String> tagMap(String... tags) {
      * @throws IllegalArgumentException if tags is not constructed in key-value pairs
      */
     @Override
-    public Sensor addLatencySensor(String scopeName, String entityName, String operationName, Sensor.RecordingLevel recordingLevel, String... tags) {
+    public Sensor addLatencyAndThroughputSensor(String scopeName, String entityName, String operationName, Sensor.RecordingLevel recordingLevel, String... tags) {
         Map<String, String> tagMap = tagMap(tags);
 
         // first add the global operation metrics if not yet, with the global tags only
@@ -150,15 +150,15 @@ public Sensor addThroughputSensor(String scopeName, String entityName, String op
     }
 
     private void addLatencyMetrics(String scopeName, Sensor sensor, String entityName, String opName, Map<String, String> tags) {
-        maybeAddMetric(sensor, metrics.metricName(entityName + "-" + opName + "-avg-latency", groupNameFromScope(scopeName),
+        maybeAddMetric(sensor, metrics.metricName(entityName + "-" + opName + "-latency-avg", groupNameFromScope(scopeName),
             "The average latency of " + entityName + " " + opName + " operation.", tags), new Avg());
-        maybeAddMetric(sensor, metrics.metricName(entityName + "-" + opName + "-max-latency", groupNameFromScope(scopeName),
+        maybeAddMetric(sensor, metrics.metricName(entityName + "-" + opName + "-latency-max", groupNameFromScope(scopeName),
             "The max latency of " + entityName + " " + opName + " operation.", tags), new Max());
         addThroughputMetrics(scopeName, sensor, entityName, opName, tags);
     }
 
     private void addThroughputMetrics(String scopeName, Sensor sensor, String entityName, String opName, Map<String, String> tags) {
-        maybeAddMetric(sensor, metrics.metricName(entityName + "-" + opName + "-qps", groupNameFromScope(scopeName),
+        maybeAddMetric(sensor, metrics.metricName(entityName + "-" + opName + "-rate", groupNameFromScope(scopeName),
             "The average number of occurrence of " + entityName + " " + opName + " operation per second.", tags), new Rate(new Count()));
     }
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredKeyValueStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredKeyValueStore.java
index 7dc2d3350dd8a..dc6b7a5582b0b 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredKeyValueStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredKeyValueStore.java
@@ -117,15 +117,15 @@ public void init(ProcessorContext context, StateStore root) {
         this.context = context;
         this.root = root;
         this.metrics = (StreamsMetricsImpl) context.metrics();
-        this.putTime = this.metrics.addLatencySensor(metricScope, name, "put", Sensor.RecordingLevel.DEBUG);
-        this.putIfAbsentTime = this.metrics.addLatencySensor(metricScope, name, "put-if-absent", Sensor.RecordingLevel.DEBUG);
-        this.getTime = this.metrics.addLatencySensor(metricScope, name, "get", Sensor.RecordingLevel.DEBUG);
-        this.deleteTime = this.metrics.addLatencySensor(metricScope, name, "delete", Sensor.RecordingLevel.DEBUG);
-        this.putAllTime = this.metrics.addLatencySensor(metricScope, name, "put-all", Sensor.RecordingLevel.DEBUG);
-        this.allTime = this.metrics.addLatencySensor(metricScope, name, "all", Sensor.RecordingLevel.DEBUG);
-        this.rangeTime = this.metrics.addLatencySensor(metricScope, name, "range", Sensor.RecordingLevel.DEBUG);
-        this.flushTime = this.metrics.addLatencySensor(metricScope, name, "flush", Sensor.RecordingLevel.DEBUG);
-        this.restoreTime = this.metrics.addLatencySensor(metricScope, name, "restore", Sensor.RecordingLevel.DEBUG);
+        this.putTime = this.metrics.addLatencyAndThroughputSensor(metricScope, name, "put", Sensor.RecordingLevel.DEBUG);
+        this.putIfAbsentTime = this.metrics.addLatencyAndThroughputSensor(metricScope, name, "put-if-absent", Sensor.RecordingLevel.DEBUG);
+        this.getTime = this.metrics.addLatencyAndThroughputSensor(metricScope, name, "get", Sensor.RecordingLevel.DEBUG);
+        this.deleteTime = this.metrics.addLatencyAndThroughputSensor(metricScope, name, "delete", Sensor.RecordingLevel.DEBUG);
+        this.putAllTime = this.metrics.addLatencyAndThroughputSensor(metricScope, name, "put-all", Sensor.RecordingLevel.DEBUG);
+        this.allTime = this.metrics.addLatencyAndThroughputSensor(metricScope, name, "all", Sensor.RecordingLevel.DEBUG);
+        this.rangeTime = this.metrics.addLatencyAndThroughputSensor(metricScope, name, "range", Sensor.RecordingLevel.DEBUG);
+        this.flushTime = this.metrics.addLatencyAndThroughputSensor(metricScope, name, "flush", Sensor.RecordingLevel.DEBUG);
+        this.restoreTime = this.metrics.addLatencyAndThroughputSensor(metricScope, name, "restore", Sensor.RecordingLevel.DEBUG);
 
         // register and possibly restore the state from the logs
         metrics.measureLatencyNs(time, initDelegate, this.restoreTime);
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStore.java
index 4eb3936be60e0..4d3771ea55edf 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStore.java
@@ -53,13 +53,13 @@ class MeteredSegmentedBytesStore extends WrappedStateStore.AbstractWrappedStateS
     public void init(ProcessorContext context, StateStore root) {
         final String name = name();
         this.metrics = context.metrics();
-        this.putTime = this.metrics.addLatencySensor(metricScope, name, "put", Sensor.RecordingLevel.DEBUG);
-        this.fetchTime = this.metrics.addLatencySensor(metricScope, name, "fetch", Sensor.RecordingLevel.DEBUG);
-        this.flushTime = this.metrics.addLatencySensor(metricScope, name, "flush", Sensor.RecordingLevel.DEBUG);
-        this.getTime = this.metrics.addLatencySensor(metricScope, name, "get", Sensor.RecordingLevel.DEBUG);
-        this.removeTime = this.metrics.addLatencySensor(metricScope, name, "remove", Sensor.RecordingLevel.DEBUG);
+        this.putTime = this.metrics.addLatencyAndThroughputSensor(metricScope, name, "put", Sensor.RecordingLevel.DEBUG);
+        this.fetchTime = this.metrics.addLatencyAndThroughputSensor(metricScope, name, "fetch", Sensor.RecordingLevel.DEBUG);
+        this.flushTime = this.metrics.addLatencyAndThroughputSensor(metricScope, name, "flush", Sensor.RecordingLevel.DEBUG);
+        this.getTime = this.metrics.addLatencyAndThroughputSensor(metricScope, name, "get", Sensor.RecordingLevel.DEBUG);
+        this.removeTime = this.metrics.addLatencyAndThroughputSensor(metricScope, name, "remove", Sensor.RecordingLevel.DEBUG);
 
-        final Sensor restoreTime = this.metrics.addLatencySensor(metricScope, name, "restore", Sensor.RecordingLevel.DEBUG);
+        final Sensor restoreTime = this.metrics.addLatencyAndThroughputSensor(metricScope, name, "restore", Sensor.RecordingLevel.DEBUG);
         // register and possibly restore the state from the logs
         final long startNs = time.nanoseconds();
         try {
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/ProcessorNodeTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/ProcessorNodeTest.java
index b1d5f087dea1c..f2c7e53a0aa1c 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/ProcessorNodeTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/ProcessorNodeTest.java
@@ -103,7 +103,7 @@ public void testMetrics() {
         String name = "task." + context.taskId() + "." + node.name();
         String[] entities = {"all", name};
         String[] latencyOperations = {"process", "punctuate", "create", "destroy"};
-        String throughputOperation =  "process-throughput";
+        String throughputOperation =  "forward";
         String groupName = "stream-processor-node-metrics";
         Map<String, String> tags = Collections.singletonMap("processor-node-id", node.name());
 
@@ -115,14 +115,14 @@ public void testMetrics() {
 
         for (String entity : entities) {
             for (String operation : latencyOperations) {
-                assertNotNull(metrics.metrics().get(metrics.metricName(entity + "-" + operation + "-avg-latency", groupName,
+                assertNotNull(metrics.metrics().get(metrics.metricName(entity + "-" + operation + "-latency-avg", groupName,
                     "The average latency in milliseconds of " + entity + " " + operation + " operation.", tags)));
-                assertNotNull(metrics.metrics().get(metrics.metricName(entity + "-" + operation + "-max-latency", groupName,
+                assertNotNull(metrics.metrics().get(metrics.metricName(entity + "-" + operation + "-latency-max", groupName,
                     "The max latency in milliseconds of " + entity + " " + operation + " operation.", tags)));
-                assertNotNull(metrics.metrics().get(metrics.metricName(entity + "-" + operation + "-qps", groupName,
+                assertNotNull(metrics.metrics().get(metrics.metricName(entity + "-" + operation + "-rate", groupName,
                     "The average number of occurrence of " + entity + " " + operation + " operation per second.", tags)));
             }
-            assertNotNull(metrics.metrics().get(metrics.metricName(entity + "-" + throughputOperation + "-qps", groupName,
+            assertNotNull(metrics.metrics().get(metrics.metricName(entity + "-" + throughputOperation + "-rate", groupName,
                 "The average number of occurrence of " + entity + " " + throughputOperation + " operation per second.", tags)));
         }
     }
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamTaskTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamTaskTest.java
index 4e95911e8d4b4..0479b9d5e34d4 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamTaskTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamTaskTest.java
@@ -196,11 +196,11 @@ public void testMetrics() throws Exception {
         assertNotNull(metrics.getSensor(name + "-" + operation));
 
         for (String entity : entities) {
-            assertNotNull(metrics.metrics().get(metrics.metricName(entity + "-" + operation + "-avg-latency", groupName,
+            assertNotNull(metrics.metrics().get(metrics.metricName(entity + "-" + operation + "-latency-avg", groupName,
                 "The average latency in milliseconds of " + entity + " " + operation + " operation.", tags)));
-            assertNotNull(metrics.metrics().get(metrics.metricName(entity + "-" + operation + "-max-latency", groupName,
+            assertNotNull(metrics.metrics().get(metrics.metricName(entity + "-" + operation + "-latency-max", groupName,
                 "The max latency in milliseconds of " + entity + " " + operation + " operation.", tags)));
-            assertNotNull(metrics.metrics().get(metrics.metricName(entity + "-" + operation + "-qps", groupName,
+            assertNotNull(metrics.metrics().get(metrics.metricName(entity + "-" + operation + "-rate", groupName,
                 "The average number of occurrence of " + entity + " " + operation + " operation per second.", tags)));
         }
     }
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamThreadTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamThreadTest.java
index 20d428b16ff5f..0e98f56eac000 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamThreadTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamThreadTest.java
@@ -438,29 +438,29 @@ public void testMetrics() throws Exception {
         String defaultPrefix = "thread." + thread.threadClientId();
         Map<String, String> defaultTags = Collections.singletonMap("client-id", thread.threadClientId());
 
-        assertNotNull(metrics.getSensor(defaultPrefix + ".commit-time"));
-        assertNotNull(metrics.getSensor(defaultPrefix + ".poll-time"));
-        assertNotNull(metrics.getSensor(defaultPrefix + ".process-time"));
-        assertNotNull(metrics.getSensor(defaultPrefix + ".punctuate-time"));
-        assertNotNull(metrics.getSensor(defaultPrefix + ".task-creation"));
-        assertNotNull(metrics.getSensor(defaultPrefix + ".task-destruction"));
+        assertNotNull(metrics.getSensor(defaultPrefix + ".commit-latency"));
+        assertNotNull(metrics.getSensor(defaultPrefix + ".poll-latency"));
+        assertNotNull(metrics.getSensor(defaultPrefix + ".process-latency"));
+        assertNotNull(metrics.getSensor(defaultPrefix + ".punctuate-latency"));
+        assertNotNull(metrics.getSensor(defaultPrefix + ".task-created"));
+        assertNotNull(metrics.getSensor(defaultPrefix + ".task-closed"));
         assertNotNull(metrics.getSensor(defaultPrefix + ".skipped-records"));
 
-        assertNotNull(metrics.metrics().get(metrics.metricName("commit-time-avg", defaultGroupName, "The average commit time in ms", defaultTags)));
-        assertNotNull(metrics.metrics().get(metrics.metricName("commit-time-max", defaultGroupName, "The maximum commit time in ms", defaultTags)));
-        assertNotNull(metrics.metrics().get(metrics.metricName("commit-calls-rate", defaultGroupName, "The average per-second number of commit calls", defaultTags)));
-        assertNotNull(metrics.metrics().get(metrics.metricName("poll-time-avg", defaultGroupName, "The average poll time in ms", defaultTags)));
-        assertNotNull(metrics.metrics().get(metrics.metricName("poll-time-max", defaultGroupName, "The maximum poll time in ms", defaultTags)));
-        assertNotNull(metrics.metrics().get(metrics.metricName("poll-calls-rate", defaultGroupName, "The average per-second number of record-poll calls", defaultTags)));
-        assertNotNull(metrics.metrics().get(metrics.metricName("process-time-avg", defaultGroupName, "The average process time in ms", defaultTags)));
-        assertNotNull(metrics.metrics().get(metrics.metricName("process-time-max", defaultGroupName, "The maximum process time in ms", defaultTags)));
-        assertNotNull(metrics.metrics().get(metrics.metricName("process-calls-rate", defaultGroupName, "The average per-second number of process calls", defaultTags)));
-        assertNotNull(metrics.metrics().get(metrics.metricName("punctuate-time-avg", defaultGroupName, "The average punctuate time in ms", defaultTags)));
-        assertNotNull(metrics.metrics().get(metrics.metricName("punctuate-time-max", defaultGroupName, "The maximum punctuate time in ms", defaultTags)));
-        assertNotNull(metrics.metrics().get(metrics.metricName("punctuate-calls-rate", defaultGroupName, "The average per-second number of punctuate calls", defaultTags)));
-        assertNotNull(metrics.metrics().get(metrics.metricName("task-creation-rate", defaultGroupName, "The average per-second number of newly created tasks", defaultTags)));
-        assertNotNull(metrics.metrics().get(metrics.metricName("task-destruction-rate", defaultGroupName, "The average per-second number of destructed tasks", defaultTags)));
-        assertNotNull(metrics.metrics().get(metrics.metricName("skipped-records-count", defaultGroupName, "The average per-second number of skipped records.", defaultTags)));
+        assertNotNull(metrics.metrics().get(metrics.metricName("commit-latency-avg", defaultGroupName, "The average commit time in ms", defaultTags)));
+        assertNotNull(metrics.metrics().get(metrics.metricName("commit-latency-max", defaultGroupName, "The maximum commit time in ms", defaultTags)));
+        assertNotNull(metrics.metrics().get(metrics.metricName("commit-rate", defaultGroupName, "The average per-second number of commit calls", defaultTags)));
+        assertNotNull(metrics.metrics().get(metrics.metricName("poll-latency-avg", defaultGroupName, "The average poll time in ms", defaultTags)));
+        assertNotNull(metrics.metrics().get(metrics.metricName("poll-latency-max", defaultGroupName, "The maximum poll time in ms", defaultTags)));
+        assertNotNull(metrics.metrics().get(metrics.metricName("poll-rate", defaultGroupName, "The average per-second number of record-poll calls", defaultTags)));
+        assertNotNull(metrics.metrics().get(metrics.metricName("process-latency-avg", defaultGroupName, "The average process time in ms", defaultTags)));
+        assertNotNull(metrics.metrics().get(metrics.metricName("process-latency-max", defaultGroupName, "The maximum process time in ms", defaultTags)));
+        assertNotNull(metrics.metrics().get(metrics.metricName("process-rate", defaultGroupName, "The average per-second number of process calls", defaultTags)));
+        assertNotNull(metrics.metrics().get(metrics.metricName("punctuate-latency-avg", defaultGroupName, "The average punctuate time in ms", defaultTags)));
+        assertNotNull(metrics.metrics().get(metrics.metricName("punctuate-latency-max", defaultGroupName, "The maximum punctuate time in ms", defaultTags)));
+        assertNotNull(metrics.metrics().get(metrics.metricName("punctuate-rate", defaultGroupName, "The average per-second number of punctuate calls", defaultTags)));
+        assertNotNull(metrics.metrics().get(metrics.metricName("task-created-rate", defaultGroupName, "The average per-second number of newly created tasks", defaultTags)));
+        assertNotNull(metrics.metrics().get(metrics.metricName("task-closed-rate", defaultGroupName, "The average per-second number of closed tasks", defaultTags)));
+        assertNotNull(metrics.metrics().get(metrics.metricName("skipped-records-rate", defaultGroupName, "The average per-second number of skipped records.", defaultTags)));
     }
 
     @Test
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamsMetricsImplTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamsMetricsImplTest.java
index b7c0c2cba58e7..c6bc2508f2d8c 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamsMetricsImplTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamsMetricsImplTest.java
@@ -61,7 +61,7 @@ public void testRemoveSensor() {
         Sensor sensor1a = streamsMetrics.addSensor(sensorName, Sensor.RecordingLevel.DEBUG, sensor1);
         streamsMetrics.removeSensor(sensor1a);
 
-        Sensor sensor2 = streamsMetrics.addLatencySensor(scope, entity, operation, Sensor.RecordingLevel.DEBUG);
+        Sensor sensor2 = streamsMetrics.addLatencyAndThroughputSensor(scope, entity, operation, Sensor.RecordingLevel.DEBUG);
         streamsMetrics.removeSensor(sensor2);
 
         Sensor sensor3 = streamsMetrics.addThroughputSensor(scope, entity, operation, Sensor.RecordingLevel.DEBUG);
@@ -77,7 +77,7 @@ public void testLatencyMetrics() {
         Map<String, String> tags = new HashMap<>();
         StreamsMetricsImpl streamsMetrics = new StreamsMetricsImpl(new Metrics(), groupName, tags);
 
-        Sensor sensor1 = streamsMetrics.addLatencySensor(scope, entity, operation, Sensor.RecordingLevel.DEBUG);
+        Sensor sensor1 = streamsMetrics.addLatencyAndThroughputSensor(scope, entity, operation, Sensor.RecordingLevel.DEBUG);
 
         Map<MetricName, ? extends Metric> metrics = streamsMetrics.metrics();
         // 6 metrics plus a common metric that keeps track of total registered metrics in Metrics() constructor
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStoreTest.java
index 9160a73a2f6c8..205e990a12aa9 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/MeteredSegmentedBytesStoreTest.java
@@ -57,7 +57,7 @@ public void setUp() throws Exception {
             }
 
             @Override
-            public Sensor addLatencySensor(String scopeName, String entityName, String operationName, Sensor.RecordingLevel recordLevel, String... tags) {
+            public Sensor addLatencyAndThroughputSensor(String scopeName, String entityName, String operationName, Sensor.RecordingLevel recordLevel, String... tags) {
                 return metrics.sensor(operationName);
             }
 

From 94c0da2b7946569b3da7c5fcc49157e3283b2be3 Mon Sep 17 00:00:00 2001
From: Ismael Juma <ismael@juma.me.uk>
Date: Wed, 25 Jan 2017 16:51:58 -0800
Subject: [PATCH 048/177] KAFKA-4698; VerifyError in kafka/client/ClientUtils
 due to -target:jvm-1.7

Author: Ismael Juma <ismael@juma.me.uk>

Reviewers: Jason Gustafson <jason@confluent.io>

Closes #2434 from ijuma/kafka-4698-target-1.7-verify-error

(cherry picked from commit 23f6951961060ad9a07b42f392470a227269e65a)
Signed-off-by: Jason Gustafson <jason@confluent.io>
---
 build.gradle | 1 -
 1 file changed, 1 deletion(-)

diff --git a/build.gradle b/build.gradle
index e191a51c3b89a..7a34c25d6d3b4 100644
--- a/build.gradle
+++ b/build.gradle
@@ -252,7 +252,6 @@ subprojects {
       "-deprecation",
       "-unchecked",
       "-encoding", "utf8",
-      "-target:jvm-${sourceCompatibility}".toString(),
       "-Xlog-reflective-calls",
       "-feature",
       "-language:postfixOps",

From e74a924638d6bf17bf1cdae5a42c7a4d3dc527ca Mon Sep 17 00:00:00 2001
From: Ismael Juma <ismael@juma.me.uk>
Date: Wed, 25 Jan 2017 17:25:10 -0800
Subject: [PATCH 049/177] KAFKA-4597; RecordMetadata should return log append
 time when appropriate

There is a slight change of behaviour: we now complete the `Future` returned from `send`
before the callbacks are invoked. This seems OK and perhaps a little better as the `Future`
can make progress sooner (as it would typically be blocked on a different thread than the
I/O thread that invokes the callbacks).

Author: Ismael Juma <ismael@juma.me.uk>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>, Jason Gustafson <jason@confluent.io>

Closes #2318 from ijuma/kafka-4597-record-metadata-log-append-time

(cherry picked from commit 8b3c6c0a1c1bb8f098a7013dbf9c2cb97720e106)
Signed-off-by: Jason Gustafson <jason@confluent.io>
---
 .../kafka/clients/producer/MockProducer.java  | 13 ++---
 .../internals/FutureRecordMetadata.java       | 38 ++++---------
 .../internals/ProduceRequestResult.java       | 37 +++++++++++--
 .../producer/internals/RecordBatch.java       | 55 +++++++++----------
 .../clients/producer/internals/Sender.java    | 25 ++++-----
 .../kafka/common/protocol/Protocol.java       |  2 +-
 .../kafka/common/requests/ProduceRequest.java |  7 +--
 .../common/requests/ProduceResponse.java      | 36 +++++++-----
 .../clients/producer/KafkaProducerTest.java   | 15 +++++
 .../clients/producer/RecordSendTest.java      | 18 +++---
 .../producer/internals/SenderTest.java        |  3 +-
 .../common/requests/RequestResponseTest.java  |  6 +-
 .../coordinator/GroupMetadataManager.scala    | 18 +++---
 .../scala/kafka/server/DelayedFetch.scala     |  2 +-
 .../scala/kafka/server/DelayedProduce.scala   |  8 +--
 .../main/scala/kafka/server/KafkaApis.scala   | 14 ++---
 .../scala/kafka/server/ReplicaManager.scala   | 41 +++++++-------
 .../kafka/api/AuthorizerIntegrationTest.scala |  2 +-
 .../kafka/api/BaseProducerSendTest.scala      | 23 +++++---
 .../kafka/api/PlaintextProducerSendTest.scala | 54 +++---------------
 .../GroupCoordinatorResponseTest.scala        |  4 +-
 .../GroupMetadataManagerTest.scala            |  2 +-
 .../kafka/server/EdgeCaseRequestTest.scala    |  4 +-
 .../kafka/server/ProduceRequestTest.scala     |  8 +--
 .../kafka/server/ReplicaManagerTest.scala     | 10 ++--
 25 files changed, 217 insertions(+), 228 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/producer/MockProducer.java b/clients/src/main/java/org/apache/kafka/clients/producer/MockProducer.java
index 109b0caed4963..008ca70b088eb 100644
--- a/clients/src/main/java/org/apache/kafka/clients/producer/MockProducer.java
+++ b/clients/src/main/java/org/apache/kafka/clients/producer/MockProducer.java
@@ -116,11 +116,11 @@ public synchronized Future<RecordMetadata> send(ProducerRecord<K, V> record, Cal
         int partition = 0;
         if (this.cluster.partitionsForTopic(record.topic()) != null)
             partition = partition(record, this.cluster);
-        ProduceRequestResult result = new ProduceRequestResult();
-        FutureRecordMetadata future = new FutureRecordMetadata(result, 0, Record.NO_TIMESTAMP, 0, 0, 0);
         TopicPartition topicPartition = new TopicPartition(record.topic(), partition);
+        ProduceRequestResult result = new ProduceRequestResult(topicPartition);
+        FutureRecordMetadata future = new FutureRecordMetadata(result, 0, Record.NO_TIMESTAMP, 0, 0, 0);
         long offset = nextOffset(topicPartition);
-        Completion completion = new Completion(topicPartition, offset,
+        Completion completion = new Completion(offset,
                                                new RecordMetadata(topicPartition, 0, offset, Record.NO_TIMESTAMP, 0, 0, 0),
                                                result, callback);
         this.sent.add(record);
@@ -233,10 +233,8 @@ private static class Completion {
         private final RecordMetadata metadata;
         private final ProduceRequestResult result;
         private final Callback callback;
-        private final TopicPartition topicPartition;
 
-        public Completion(TopicPartition topicPartition,
-                          long offset,
+        public Completion(long offset,
                           RecordMetadata metadata,
                           ProduceRequestResult result,
                           Callback callback) {
@@ -244,11 +242,10 @@ public Completion(TopicPartition topicPartition,
             this.offset = offset;
             this.result = result;
             this.callback = callback;
-            this.topicPartition = topicPartition;
         }
 
         public void complete(RuntimeException e) {
-            result.done(topicPartition, e == null ? offset : -1L, e);
+            result.done(e == null ? offset : -1L, Record.NO_TIMESTAMP, e);
             if (callback != null) {
                 if (e == null)
                     callback.onCompletion(metadata, null);
diff --git a/clients/src/main/java/org/apache/kafka/clients/producer/internals/FutureRecordMetadata.java b/clients/src/main/java/org/apache/kafka/clients/producer/internals/FutureRecordMetadata.java
index d5995a3468c10..1cde13d1b2d6e 100644
--- a/clients/src/main/java/org/apache/kafka/clients/producer/internals/FutureRecordMetadata.java
+++ b/clients/src/main/java/org/apache/kafka/clients/producer/internals/FutureRecordMetadata.java
@@ -26,16 +26,16 @@ public final class FutureRecordMetadata implements Future<RecordMetadata> {
 
     private final ProduceRequestResult result;
     private final long relativeOffset;
-    private final long timestamp;
+    private final long createTimestamp;
     private final long checksum;
     private final int serializedKeySize;
     private final int serializedValueSize;
 
-    public FutureRecordMetadata(ProduceRequestResult result, long relativeOffset, long timestamp,
+    public FutureRecordMetadata(ProduceRequestResult result, long relativeOffset, long createTimestamp,
                                 long checksum, int serializedKeySize, int serializedValueSize) {
         this.result = result;
         this.relativeOffset = relativeOffset;
-        this.timestamp = timestamp;
+        this.createTimestamp = createTimestamp;
         this.checksum = checksum;
         this.serializedKeySize = serializedKeySize;
         this.serializedValueSize = serializedValueSize;
@@ -46,6 +46,11 @@ public boolean cancel(boolean interrupt) {
         return false;
     }
 
+    @Override
+    public boolean isCancelled() {
+        return false;
+    }
+
     @Override
     public RecordMetadata get() throws InterruptedException, ExecutionException {
         this.result.await();
@@ -69,32 +74,11 @@ RecordMetadata valueOrError() throws ExecutionException {
     
     RecordMetadata value() {
         return new RecordMetadata(result.topicPartition(), this.result.baseOffset(), this.relativeOffset,
-                                  this.timestamp, this.checksum, this.serializedKeySize, this.serializedValueSize);
-    }
-    
-    public long relativeOffset() {
-        return this.relativeOffset;
-    }
-
-    public long timestamp() {
-        return this.timestamp;
+                                  timestamp(), this.checksum, this.serializedKeySize, this.serializedValueSize);
     }
 
-    public long checksum() {
-        return this.checksum;
-    }
-
-    public int serializedKeySize() {
-        return this.serializedKeySize;
-    }
-
-    public int serializedValueSize() {
-        return this.serializedValueSize;
-    }
-
-    @Override
-    public boolean isCancelled() {
-        return false;
+    private long timestamp() {
+        return result.hasLogAppendTime() ? result.logAppendTime() : createTimestamp;
     }
 
     @Override
diff --git a/clients/src/main/java/org/apache/kafka/clients/producer/internals/ProduceRequestResult.java b/clients/src/main/java/org/apache/kafka/clients/producer/internals/ProduceRequestResult.java
index 8e5855d9f41e2..41c204d974ea2 100644
--- a/clients/src/main/java/org/apache/kafka/clients/producer/internals/ProduceRequestResult.java
+++ b/clients/src/main/java/org/apache/kafka/clients/producer/internals/ProduceRequestResult.java
@@ -19,7 +19,9 @@
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
 
+import org.apache.kafka.clients.producer.RecordMetadata;
 import org.apache.kafka.common.TopicPartition;
+import org.apache.kafka.common.record.Record;
 
 
 /**
@@ -30,22 +32,31 @@
 public final class ProduceRequestResult {
 
     private final CountDownLatch latch = new CountDownLatch(1);
-    private volatile TopicPartition topicPartition;
+    private final TopicPartition topicPartition;
+
     private volatile long baseOffset = -1L;
+    private volatile long logAppendTime = Record.NO_TIMESTAMP;
     private volatile RuntimeException error;
 
-    public ProduceRequestResult() {
+    /**
+     * Create an instance of this class.
+     *
+     * @param topicPartition The topic and partition to which this record set was sent was sent
+     */
+    public ProduceRequestResult(TopicPartition topicPartition) {
+        this.topicPartition = topicPartition;
     }
 
     /**
      * Mark this request as complete and unblock any threads waiting on its completion.
-     * @param topicPartition The topic and partition to which this record set was sent was sent
+     *
      * @param baseOffset The base offset assigned to the record
-     * @param error The error that occurred if there was one, or null.
+     * @param logAppendTime The log append time or -1 if CreateTime is being used
+     * @param error The error that occurred if there was one, or null
      */
-    public void done(TopicPartition topicPartition, long baseOffset, RuntimeException error) {
-        this.topicPartition = topicPartition;
+    public void done(long baseOffset, long logAppendTime, RuntimeException error) {
         this.baseOffset = baseOffset;
+        this.logAppendTime = logAppendTime;
         this.error = error;
         this.latch.countDown();
     }
@@ -74,6 +85,20 @@ public long baseOffset() {
         return baseOffset;
     }
 
+    /**
+     * Return true if log append time is being used for this topic
+     */
+    public boolean hasLogAppendTime() {
+        return logAppendTime != Record.NO_TIMESTAMP;
+    }
+
+    /**
+     * The log append time or -1 if CreateTime is being used
+     */
+    public long logAppendTime() {
+        return logAppendTime;
+    }
+
     /**
      * The error thrown (generally on the server) while processing this request
      */
diff --git a/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordBatch.java b/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordBatch.java
index 68b27d3fa14a4..1b751bf549e20 100644
--- a/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordBatch.java
+++ b/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordBatch.java
@@ -35,28 +35,28 @@ public final class RecordBatch {
 
     private static final Logger log = LoggerFactory.getLogger(RecordBatch.class);
 
-    public int recordCount = 0;
-    public int maxRecordSize = 0;
-    public volatile int attempts = 0;
-    public final long createdMs;
-    public long drainedMs;
-    public long lastAttemptMs;
-    public final TopicPartition topicPartition;
-    public final ProduceRequestResult produceFuture;
-    public long lastAppendTime;
-    private final List<Thunk> thunks;
-    private boolean retry;
+    final long createdMs;
+    final TopicPartition topicPartition;
+    final ProduceRequestResult produceFuture;
+
+    private final List<Thunk> thunks = new ArrayList<>();
     private final MemoryRecordsBuilder recordsBuilder;
 
+    volatile int attempts;
+    int recordCount;
+    int maxRecordSize;
+    long drainedMs;
+    long lastAttemptMs;
+    long lastAppendTime;
+    private boolean retry;
+
     public RecordBatch(TopicPartition tp, MemoryRecordsBuilder recordsBuilder, long now) {
         this.createdMs = now;
         this.lastAttemptMs = now;
         this.recordsBuilder = recordsBuilder;
         this.topicPartition = tp;
-        this.produceFuture = new ProduceRequestResult();
-        this.thunks = new ArrayList<>();
         this.lastAppendTime = createdMs;
-        this.retry = false;
+        this.produceFuture = new ProduceRequestResult(topicPartition);
     }
 
     /**
@@ -83,36 +83,33 @@ public FutureRecordMetadata tryAppend(long timestamp, byte[] key, byte[] value,
     }
 
     /**
-     * Complete the request
+     * Complete the request.
      * 
      * @param baseOffset The base offset of the messages assigned by the server
-     * @param timestamp The timestamp returned by the broker.
+     * @param logAppendTime The log append time or -1 if CreateTime is being used
      * @param exception The exception that occurred (or null if the request was successful)
      */
-    public void done(long baseOffset, long timestamp, RuntimeException exception) {
+    public void done(long baseOffset, long logAppendTime, RuntimeException exception) {
         log.trace("Produced messages to topic-partition {} with base offset offset {} and error: {}.",
-                  topicPartition,
-                  baseOffset,
-                  exception);
+                  topicPartition, baseOffset, exception);
+
+        // Complete the future before invoking the callbacks as we rely on its state for the `onCompletion` call
+        produceFuture.done(baseOffset, logAppendTime, exception);
+
         // execute callbacks
         for (Thunk thunk : thunks) {
             try {
                 if (exception == null) {
-                    // If the timestamp returned by server is NoTimestamp, that means CreateTime is used. Otherwise LogAppendTime is used.
-                    RecordMetadata metadata = new RecordMetadata(this.topicPartition,  baseOffset, thunk.future.relativeOffset(),
-                                                                 timestamp == Record.NO_TIMESTAMP ? thunk.future.timestamp() : timestamp,
-                                                                 thunk.future.checksum(),
-                                                                 thunk.future.serializedKeySize(),
-                                                                 thunk.future.serializedValueSize());
+                    RecordMetadata metadata = thunk.future.value();
                     thunk.callback.onCompletion(metadata, null);
                 } else {
                     thunk.callback.onCompletion(null, exception);
                 }
             } catch (Exception e) {
-                log.error("Error executing user-provided callback on message for topic-partition {}:", topicPartition, e);
+                log.error("Error executing user-provided callback on message for topic-partition '{}'", topicPartition, e);
             }
         }
-        this.produceFuture.done(topicPartition, baseOffset, exception);
+
     }
 
     /**
@@ -167,7 +164,7 @@ public boolean maybeExpire(int requestTimeoutMs, long retryBackoffMs, long now,
     /**
      * Returns if the batch is been retried for sending to kafka
      */
-    public boolean inRetry() {
+    private boolean inRetry() {
         return this.retry;
     }
 
diff --git a/clients/src/main/java/org/apache/kafka/clients/producer/internals/Sender.java b/clients/src/main/java/org/apache/kafka/clients/producer/internals/Sender.java
index dc299362fe4dd..5483c4a09e717 100644
--- a/clients/src/main/java/org/apache/kafka/clients/producer/internals/Sender.java
+++ b/clients/src/main/java/org/apache/kafka/clients/producer/internals/Sender.java
@@ -34,7 +34,6 @@
 import org.apache.kafka.common.metrics.stats.Rate;
 import org.apache.kafka.common.protocol.Errors;
 import org.apache.kafka.common.record.MemoryRecords;
-import org.apache.kafka.common.record.Record;
 import org.apache.kafka.common.requests.ProduceRequest;
 import org.apache.kafka.common.requests.ProduceResponse;
 import org.apache.kafka.common.utils.Time;
@@ -253,12 +252,12 @@ private void handleProduceResponse(ClientResponse response, Map<TopicPartition,
         if (response.wasDisconnected()) {
             log.trace("Cancelled request {} due to node {} being disconnected", response, response.destination());
             for (RecordBatch batch : batches.values())
-                completeBatch(batch, Errors.NETWORK_EXCEPTION, -1L, Record.NO_TIMESTAMP, correlationId, now);
+                completeBatch(batch, new ProduceResponse.PartitionResponse(Errors.NETWORK_EXCEPTION), correlationId, now);
         } else if (response.versionMismatch() != null) {
             log.warn("Cancelled request {} due to a version mismatch with node {}",
                     response, response.destination(), response.versionMismatch());
             for (RecordBatch batch : batches.values())
-                completeBatch(batch, Errors.INVALID_REQUEST, -1L, Record.NO_TIMESTAMP, correlationId, now);
+                completeBatch(batch, new ProduceResponse.PartitionResponse(Errors.INVALID_REQUEST), correlationId, now);
         } else {
             log.trace("Received produce response from node {} with correlation id {}", response.destination(), correlationId);
             // if we have a response, parse it
@@ -267,16 +266,16 @@ private void handleProduceResponse(ClientResponse response, Map<TopicPartition,
                 for (Map.Entry<TopicPartition, ProduceResponse.PartitionResponse> entry : produceResponse.responses().entrySet()) {
                     TopicPartition tp = entry.getKey();
                     ProduceResponse.PartitionResponse partResp = entry.getValue();
-                    Errors error = Errors.forCode(partResp.errorCode);
                     RecordBatch batch = batches.get(tp);
-                    completeBatch(batch, error, partResp.baseOffset, partResp.timestamp, correlationId, now);
+                    completeBatch(batch, partResp, correlationId, now);
                 }
                 this.sensors.recordLatency(response.destination(), response.requestLatencyMs());
                 this.sensors.recordThrottleTime(produceResponse.getThrottleTime());
             } else {
                 // this is the acks = 0 case, just complete all requests
-                for (RecordBatch batch : batches.values())
-                    completeBatch(batch, Errors.NONE, -1L, Record.NO_TIMESTAMP, correlationId, now);
+                for (RecordBatch batch : batches.values()) {
+                    completeBatch(batch, new ProduceResponse.PartitionResponse(Errors.NONE), correlationId, now);
+                }
             }
         }
     }
@@ -285,13 +284,13 @@ private void handleProduceResponse(ClientResponse response, Map<TopicPartition,
      * Complete or retry the given batch of records.
      * 
      * @param batch The record batch
-     * @param error The error (or null if none)
-     * @param baseOffset The base offset assigned to the records if successful
-     * @param timestamp The timestamp returned by the broker for this batch
+     * @param response The produce response
      * @param correlationId The correlation id for the request
-     * @param now The current POSIX time stamp in milliseconds
+     * @param now The current POSIX timestamp in milliseconds
      */
-    private void completeBatch(RecordBatch batch, Errors error, long baseOffset, long timestamp, long correlationId, long now) {
+    private void completeBatch(RecordBatch batch, ProduceResponse.PartitionResponse response, long correlationId,
+                               long now) {
+        Errors error = response.error;
         if (error != Errors.NONE && canRetry(batch, error)) {
             // retry
             log.warn("Got error produce response with correlation id {} on topic-partition {}, retrying ({} attempts left). Error: {}",
@@ -308,7 +307,7 @@ private void completeBatch(RecordBatch batch, Errors error, long baseOffset, lon
             else
                 exception = error.exception();
             // tell the user the result of their request
-            batch.done(baseOffset, timestamp, exception);
+            batch.done(response.baseOffset, response.logAppendTime, exception);
             this.accumulator.deallocate(batch);
             if (error != Errors.NONE)
                 this.sensors.recordErrors(batch.topicPartition.topic(), batch.recordCount);
diff --git a/clients/src/main/java/org/apache/kafka/common/protocol/Protocol.java b/clients/src/main/java/org/apache/kafka/common/protocol/Protocol.java
index e76fc047d1ae8..b04587fcb86df 100644
--- a/clients/src/main/java/org/apache/kafka/common/protocol/Protocol.java
+++ b/clients/src/main/java/org/apache/kafka/common/protocol/Protocol.java
@@ -193,7 +193,7 @@ public class Protocol {
                                                                                                                         INT16),
                                                                                                               new Field("base_offset",
                                                                                                                         INT64),
-                                                                                                              new Field("timestamp",
+                                                                                                              new Field("log_append_time",
                                                                                                                         INT64,
                                                                                                                         "The timestamp returned by broker after appending the messages. " +
                                                                                                                             "If CreateTime is used for the topic, the timestamp will be -1. " +
diff --git a/clients/src/main/java/org/apache/kafka/common/requests/ProduceRequest.java b/clients/src/main/java/org/apache/kafka/common/requests/ProduceRequest.java
index c05643ded01cb..e4a2aae9272cd 100644
--- a/clients/src/main/java/org/apache/kafka/common/requests/ProduceRequest.java
+++ b/clients/src/main/java/org/apache/kafka/common/requests/ProduceRequest.java
@@ -20,7 +20,6 @@
 import org.apache.kafka.common.protocol.ProtoUtils;
 import org.apache.kafka.common.protocol.types.Struct;
 import org.apache.kafka.common.record.MemoryRecords;
-import org.apache.kafka.common.record.Record;
 import org.apache.kafka.common.utils.CollectionUtils;
 import org.apache.kafka.common.utils.Utils;
 
@@ -130,10 +129,10 @@ public AbstractResponse getErrorResponse(Throwable e) {
             return null;
 
         Map<TopicPartition, ProduceResponse.PartitionResponse> responseMap = new HashMap<>();
+        ProduceResponse.PartitionResponse partitionResponse = new ProduceResponse.PartitionResponse(Errors.forException(e));
 
-        for (Map.Entry<TopicPartition, MemoryRecords> entry : partitionRecords.entrySet()) {
-            responseMap.put(entry.getKey(), new ProduceResponse.PartitionResponse(Errors.forException(e).code(), ProduceResponse.INVALID_OFFSET, Record.NO_TIMESTAMP));
-        }
+        for (Map.Entry<TopicPartition, MemoryRecords> entry : partitionRecords.entrySet())
+            responseMap.put(entry.getKey(), partitionResponse);
 
         short versionId = version();
         switch (versionId) {
diff --git a/clients/src/main/java/org/apache/kafka/common/requests/ProduceResponse.java b/clients/src/main/java/org/apache/kafka/common/requests/ProduceResponse.java
index 6c2125a98db05..9eaaadf617e15 100644
--- a/clients/src/main/java/org/apache/kafka/common/requests/ProduceResponse.java
+++ b/clients/src/main/java/org/apache/kafka/common/requests/ProduceResponse.java
@@ -14,9 +14,11 @@
 
 import org.apache.kafka.common.TopicPartition;
 import org.apache.kafka.common.protocol.ApiKeys;
+import org.apache.kafka.common.protocol.Errors;
 import org.apache.kafka.common.protocol.ProtoUtils;
 import org.apache.kafka.common.protocol.types.Schema;
 import org.apache.kafka.common.protocol.types.Struct;
+import org.apache.kafka.common.record.Record;
 import org.apache.kafka.common.utils.CollectionUtils;
 
 import java.nio.ByteBuffer;
@@ -61,7 +63,7 @@ public class ProduceResponse extends AbstractResponse {
      */
 
     private static final String BASE_OFFSET_KEY_NAME = "base_offset";
-    private static final String TIMESTAMP_KEY_NAME = "timestamp";
+    private static final String LOG_APPEND_TIME_KEY_NAME = "log_append_time";
 
     private final Map<TopicPartition, PartitionResponse> responses;
     private final int throttleTime;
@@ -114,11 +116,11 @@ public ProduceResponse(Struct struct) {
             for (Object partResponse : topicRespStruct.getArray(PARTITION_RESPONSES_KEY_NAME)) {
                 Struct partRespStruct = (Struct) partResponse;
                 int partition = partRespStruct.getInt(PARTITION_KEY_NAME);
-                short errorCode = partRespStruct.getShort(ERROR_CODE_KEY_NAME);
+                Errors error = Errors.forCode(partRespStruct.getShort(ERROR_CODE_KEY_NAME));
                 long offset = partRespStruct.getLong(BASE_OFFSET_KEY_NAME);
-                long timestamp = partRespStruct.getLong(TIMESTAMP_KEY_NAME);
+                long logAppendTime = partRespStruct.getLong(LOG_APPEND_TIME_KEY_NAME);
                 TopicPartition tp = new TopicPartition(topic, partition);
-                responses.put(tp, new PartitionResponse(errorCode, offset, timestamp));
+                responses.put(tp, new PartitionResponse(error, offset, logAppendTime));
             }
         }
         this.throttleTime = struct.getInt(THROTTLE_TIME_KEY_NAME);
@@ -135,10 +137,10 @@ private void initCommonFields(Map<TopicPartition, PartitionResponse> responses)
                 PartitionResponse part = partitionEntry.getValue();
                 Struct partStruct = topicData.instance(PARTITION_RESPONSES_KEY_NAME)
                         .set(PARTITION_KEY_NAME, partitionEntry.getKey())
-                        .set(ERROR_CODE_KEY_NAME, part.errorCode)
+                        .set(ERROR_CODE_KEY_NAME, part.error.code())
                         .set(BASE_OFFSET_KEY_NAME, part.baseOffset);
-                if (partStruct.hasField(TIMESTAMP_KEY_NAME))
-                        partStruct.set(TIMESTAMP_KEY_NAME, part.timestamp);
+                if (partStruct.hasField(LOG_APPEND_TIME_KEY_NAME))
+                        partStruct.set(LOG_APPEND_TIME_KEY_NAME, part.logAppendTime);
                 partitionArray.add(partStruct);
             }
             topicData.set(PARTITION_RESPONSES_KEY_NAME, partitionArray.toArray());
@@ -156,14 +158,18 @@ public int getThrottleTime() {
     }
 
     public static final class PartitionResponse {
-        public short errorCode;
+        public Errors error;
         public long baseOffset;
-        public long timestamp;
+        public long logAppendTime;
 
-        public PartitionResponse(short errorCode, long baseOffset, long timestamp) {
-            this.errorCode = errorCode;
+        public PartitionResponse(Errors error) {
+            this(error, INVALID_OFFSET, Record.NO_TIMESTAMP);
+        }
+
+        public PartitionResponse(Errors error, long baseOffset, long logAppendTime) {
+            this.error = error;
             this.baseOffset = baseOffset;
-            this.timestamp = timestamp;
+            this.logAppendTime = logAppendTime;
         }
 
         @Override
@@ -171,11 +177,11 @@ public String toString() {
             StringBuilder b = new StringBuilder();
             b.append('{');
             b.append("error: ");
-            b.append(errorCode);
+            b.append(error);
             b.append(",offset: ");
             b.append(baseOffset);
-            b.append(",timestamp: ");
-            b.append(timestamp);
+            b.append(",logAppendTime: ");
+            b.append(logAppendTime);
             b.append('}');
             return b.toString();
         }
diff --git a/clients/src/test/java/org/apache/kafka/clients/producer/KafkaProducerTest.java b/clients/src/test/java/org/apache/kafka/clients/producer/KafkaProducerTest.java
index 90256bbdddc55..13f7fdab0dca9 100644
--- a/clients/src/test/java/org/apache/kafka/clients/producer/KafkaProducerTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/producer/KafkaProducerTest.java
@@ -22,6 +22,7 @@
 import org.apache.kafka.common.KafkaException;
 import org.apache.kafka.common.Node;
 import org.apache.kafka.common.PartitionInfo;
+import org.apache.kafka.common.config.ConfigException;
 import org.apache.kafka.common.network.Selectable;
 import org.apache.kafka.common.serialization.ByteArraySerializer;
 import org.apache.kafka.common.serialization.StringSerializer;
@@ -52,6 +53,20 @@
 @PowerMockIgnore("javax.management.*")
 public class KafkaProducerTest {
 
+    @Test
+    public void testConstructorWithSerializers() {
+        Properties producerProps = new Properties();
+        producerProps.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, "localhost:9000");
+        new KafkaProducer<>(producerProps, new ByteArraySerializer(), new ByteArraySerializer()).close();
+    }
+
+    @Test(expected = ConfigException.class)
+    public void testNoSerializerProvided() {
+        Properties producerProps = new Properties();
+        producerProps.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, "localhost:9000");
+        new KafkaProducer(producerProps);
+    }
+
     @Test
     public void testConstructorFailureCloseResource() {
         Properties props = new Properties();
diff --git a/clients/src/test/java/org/apache/kafka/clients/producer/RecordSendTest.java b/clients/src/test/java/org/apache/kafka/clients/producer/RecordSendTest.java
index d820dab5f6fe8..a420d61eecf80 100644
--- a/clients/src/test/java/org/apache/kafka/clients/producer/RecordSendTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/producer/RecordSendTest.java
@@ -35,16 +35,16 @@
 
 public class RecordSendTest {
 
-    private TopicPartition topicPartition = new TopicPartition("test", 0);
-    private long baseOffset = 45;
-    private long relOffset = 5;
+    private final TopicPartition topicPartition = new TopicPartition("test", 0);
+    private final long baseOffset = 45;
+    private final long relOffset = 5;
 
     /**
      * Test that waiting on a request that never completes times out
      */
     @Test
     public void testTimeout() throws Exception {
-        ProduceRequestResult request = new ProduceRequestResult();
+        ProduceRequestResult request = new ProduceRequestResult(topicPartition);
         FutureRecordMetadata future = new FutureRecordMetadata(request, relOffset,
                                                                Record.NO_TIMESTAMP, 0, 0, 0);
         assertFalse("Request is not completed", future.isDone());
@@ -54,7 +54,7 @@ public void testTimeout() throws Exception {
         } catch (TimeoutException e) { /* this is good */
         }
 
-        request.done(topicPartition, baseOffset, null);
+        request.done(baseOffset, Record.NO_TIMESTAMP, null);
         assertTrue(future.isDone());
         assertEquals(baseOffset + relOffset, future.get().offset());
     }
@@ -81,15 +81,13 @@ public void testBlocking() throws Exception {
 
     /* create a new request result that will be completed after the given timeout */
     public ProduceRequestResult asyncRequest(final long baseOffset, final RuntimeException error, final long timeout) {
-        final ProduceRequestResult request = new ProduceRequestResult();
+        final ProduceRequestResult request = new ProduceRequestResult(topicPartition);
         Thread thread = new Thread() {
             public void run() {
                 try {
                     sleep(timeout);
-                    request.done(topicPartition, baseOffset, error);
-                } catch (InterruptedException e) {
-                    e.printStackTrace();
-                }
+                    request.done(baseOffset, Record.NO_TIMESTAMP, error);
+                } catch (InterruptedException e) { }
             }
         };
         thread.start();
diff --git a/clients/src/test/java/org/apache/kafka/clients/producer/internals/SenderTest.java b/clients/src/test/java/org/apache/kafka/clients/producer/internals/SenderTest.java
index 00c536c0c4be6..7f5fe1587f339 100644
--- a/clients/src/test/java/org/apache/kafka/clients/producer/internals/SenderTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/producer/internals/SenderTest.java
@@ -272,7 +272,8 @@ private void completedWithError(Future<RecordMetadata> future, Errors error) thr
     }
 
     private ProduceResponse produceResponse(TopicPartition tp, long offset, int error, int throttleTimeMs) {
-        ProduceResponse.PartitionResponse resp = new ProduceResponse.PartitionResponse((short) error, offset, Record.NO_TIMESTAMP);
+        ProduceResponse.PartitionResponse resp = new ProduceResponse.PartitionResponse(Errors.forCode((short) error),
+                offset, Record.NO_TIMESTAMP);
         Map<TopicPartition, ProduceResponse.PartitionResponse> partResp = Collections.singletonMap(tp, resp);
         return new ProduceResponse(partResp, throttleTimeMs);
     }
diff --git a/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java b/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java
index a5ed806673975..7b71f8fe74093 100644
--- a/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java
+++ b/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java
@@ -183,7 +183,8 @@ private void checkSerialization(AbstractRequestResponse req, Integer version) th
     @Test
     public void produceResponseVersionTest() {
         Map<TopicPartition, ProduceResponse.PartitionResponse> responseData = new HashMap<>();
-        responseData.put(new TopicPartition("test", 0), new ProduceResponse.PartitionResponse(Errors.NONE.code(), 10000, Record.NO_TIMESTAMP));
+        responseData.put(new TopicPartition("test", 0), new ProduceResponse.PartitionResponse(Errors.NONE,
+                10000, Record.NO_TIMESTAMP));
         ProduceResponse v0Response = new ProduceResponse(responseData);
         ProduceResponse v1Response = new ProduceResponse(responseData, 10, 1);
         ProduceResponse v2Response = new ProduceResponse(responseData, 10, 2);
@@ -455,7 +456,8 @@ private ProduceRequest createProduceRequest() {
 
     private ProduceResponse createProduceResponse() {
         Map<TopicPartition, ProduceResponse.PartitionResponse> responseData = new HashMap<>();
-        responseData.put(new TopicPartition("test", 0), new ProduceResponse.PartitionResponse(Errors.NONE.code(), 10000, Record.NO_TIMESTAMP));
+        responseData.put(new TopicPartition("test", 0), new ProduceResponse.PartitionResponse(Errors.NONE,
+                10000, Record.NO_TIMESTAMP));
         return new ProduceResponse(responseData, 0);
     }
 
diff --git a/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala b/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
index 1163e72665f1e..459297e879e44 100644
--- a/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
+++ b/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
@@ -160,16 +160,15 @@ class GroupMetadataManager(val brokerId: Int,
           // construct the error status in the propagated assignment response
           // in the cache
           val status = responseStatus(groupMetadataPartition)
-          val statusError = Errors.forCode(status.errorCode)
 
-          val responseError = if (statusError == Errors.NONE) {
+          val responseError = if (status.error == Errors.NONE) {
             Errors.NONE
           } else {
             debug(s"Metadata from group ${group.groupId} with generation $generationId failed when appending to log " +
-              s"due to ${statusError.exceptionName}")
+              s"due to ${status.error.exceptionName}")
 
             // transform the log append error code to the corresponding the commit status error code
-            statusError match {
+            status.error match {
               case Errors.UNKNOWN_TOPIC_OR_PARTITION
                    | Errors.NOT_ENOUGH_REPLICAS
                    | Errors.NOT_ENOUGH_REPLICAS_AFTER_APPEND =>
@@ -186,13 +185,13 @@ class GroupMetadataManager(val brokerId: Int,
                    | Errors.INVALID_FETCH_SIZE =>
 
                 error(s"Appending metadata message for group ${group.groupId} generation $generationId failed due to " +
-                  s"${statusError.exceptionName}, returning UNKNOWN error code to the client")
+                  s"${status.error.exceptionName}, returning UNKNOWN error code to the client")
 
                 Errors.UNKNOWN
 
               case other =>
                 error(s"Appending metadata message for group ${group.groupId} generation $generationId failed " +
-                  s"due to unexpected error: ${statusError.exceptionName}")
+                  s"due to unexpected error: ${status.error.exceptionName}")
 
                 other
             }
@@ -254,11 +253,10 @@ class GroupMetadataManager(val brokerId: Int,
           // construct the commit response status and insert
           // the offset and metadata to cache if the append status has no error
           val status = responseStatus(offsetTopicPartition)
-          val statusError = Errors.forCode(status.errorCode)
 
           val responseCode =
             group synchronized {
-              if (statusError == Errors.NONE) {
+              if (status.error == Errors.NONE) {
                 if (!group.is(Dead)) {
                   filteredOffsetMetadata.foreach { case (topicPartition, offsetAndMetadata) =>
                     group.completePendingOffsetWrite(topicPartition, offsetAndMetadata)
@@ -273,10 +271,10 @@ class GroupMetadataManager(val brokerId: Int,
                 }
 
                 debug(s"Offset commit $filteredOffsetMetadata from group ${group.groupId}, consumer $consumerId " +
-                  s"with generation $generationId failed when appending to log due to ${statusError.exceptionName}")
+                  s"with generation $generationId failed when appending to log due to ${status.error.exceptionName}")
 
                 // transform the log append error code to the corresponding the commit status error code
-                val responseError = statusError match {
+                val responseError = status.error match {
                   case Errors.UNKNOWN_TOPIC_OR_PARTITION
                        | Errors.NOT_ENOUGH_REPLICAS
                        | Errors.NOT_ENOUGH_REPLICAS_AFTER_APPEND =>
diff --git a/core/src/main/scala/kafka/server/DelayedFetch.scala b/core/src/main/scala/kafka/server/DelayedFetch.scala
index 0a1884a94a3fa..a05131ae8c6ab 100644
--- a/core/src/main/scala/kafka/server/DelayedFetch.scala
+++ b/core/src/main/scala/kafka/server/DelayedFetch.scala
@@ -150,7 +150,7 @@ class DelayedFetch(delayMs: Long,
     )
 
     val fetchPartitionData = logReadResults.map { case (tp, result) =>
-      tp -> FetchPartitionData(result.errorCode, result.hw, result.info.records)
+      tp -> FetchPartitionData(result.error, result.hw, result.info.records)
     }
 
     responseCallback(fetchPartitionData)
diff --git a/core/src/main/scala/kafka/server/DelayedProduce.scala b/core/src/main/scala/kafka/server/DelayedProduce.scala
index 1af0bfbfa9c9b..f27dff3142f0b 100644
--- a/core/src/main/scala/kafka/server/DelayedProduce.scala
+++ b/core/src/main/scala/kafka/server/DelayedProduce.scala
@@ -33,7 +33,7 @@ case class ProducePartitionStatus(requiredOffset: Long, responseStatus: Partitio
   @volatile var acksPending = false
 
   override def toString = "[acksPending: %b, error: %d, startOffset: %d, requiredOffset: %d]"
-    .format(acksPending, responseStatus.errorCode, responseStatus.baseOffset, requiredOffset)
+    .format(acksPending, responseStatus.error.code, responseStatus.baseOffset, requiredOffset)
 }
 
 /**
@@ -58,10 +58,10 @@ class DelayedProduce(delayMs: Long,
 
   // first update the acks pending variable according to the error code
   produceMetadata.produceStatus.foreach { case (topicPartition, status) =>
-    if (status.responseStatus.errorCode == Errors.NONE.code) {
+    if (status.responseStatus.error == Errors.NONE) {
       // Timeout error state will be cleared when required acks are received
       status.acksPending = true
-      status.responseStatus.errorCode = Errors.REQUEST_TIMED_OUT.code
+      status.responseStatus.error = Errors.REQUEST_TIMED_OUT
     } else {
       status.acksPending = false
     }
@@ -95,7 +95,7 @@ class DelayedProduce(delayMs: Long,
         // Case B.1 || B.2
         if (error != Errors.NONE || hasEnough) {
           status.acksPending = false
-          status.responseStatus.errorCode = error.code
+          status.responseStatus.error = error
         }
       }
     }
diff --git a/core/src/main/scala/kafka/server/KafkaApis.scala b/core/src/main/scala/kafka/server/KafkaApis.scala
index b99ce4dc65f12..3ce27dbc6cd43 100644
--- a/core/src/main/scala/kafka/server/KafkaApis.scala
+++ b/core/src/main/scala/kafka/server/KafkaApis.scala
@@ -359,21 +359,19 @@ class KafkaApis(val requestChannel: RequestChannel,
     def sendResponseCallback(responseStatus: Map[TopicPartition, PartitionResponse]) {
 
       val mergedResponseStatus = responseStatus ++
-        unauthorizedForWriteRequestInfo.mapValues(_ =>
-           new PartitionResponse(Errors.TOPIC_AUTHORIZATION_FAILED.code, -1, Record.NO_TIMESTAMP)) ++
-        nonExistingOrUnauthorizedForDescribeTopics.mapValues(_ =>
-           new PartitionResponse(Errors.UNKNOWN_TOPIC_OR_PARTITION.code, -1, Record.NO_TIMESTAMP))
+        unauthorizedForWriteRequestInfo.mapValues(_ => new PartitionResponse(Errors.TOPIC_AUTHORIZATION_FAILED)) ++
+        nonExistingOrUnauthorizedForDescribeTopics.mapValues(_ => new PartitionResponse(Errors.UNKNOWN_TOPIC_OR_PARTITION))
 
       var errorInResponse = false
 
       mergedResponseStatus.foreach { case (topicPartition, status) =>
-        if (status.errorCode != Errors.NONE.code) {
+        if (status.error != Errors.NONE) {
           errorInResponse = true
           debug("Produce request with correlation id %d from client %s on partition %s failed due to %s".format(
             request.header.correlationId,
             request.header.clientId,
             topicPartition,
-            Errors.forCode(status.errorCode).exceptionName))
+            status.error.exceptionName))
         }
       }
 
@@ -384,7 +382,7 @@ class KafkaApis(val requestChannel: RequestChannel,
           // the producer client will know that some error has happened and will refresh its metadata
           if (errorInResponse) {
             val exceptionsSummary = mergedResponseStatus.map { case (topicPartition, status) =>
-              topicPartition -> Errors.forCode(status.errorCode).exceptionName
+              topicPartition -> status.error.exceptionName
             }.mkString(", ")
             info(
               s"Closing connection due to error during produce request with correlation id ${request.header.correlationId} " +
@@ -481,7 +479,7 @@ class KafkaApis(val requestChannel: RequestChannel,
             FetchPartitionData(data.error, data.hw, data.records.toMessageFormat(Record.MAGIC_VALUE_V0))
           } else data
 
-          tp -> new FetchResponse.PartitionData(convertedData.error, convertedData.hw, convertedData.records)
+          tp -> new FetchResponse.PartitionData(convertedData.error.code, convertedData.hw, convertedData.records)
         }
       }
 
diff --git a/core/src/main/scala/kafka/server/ReplicaManager.scala b/core/src/main/scala/kafka/server/ReplicaManager.scala
index be2e04abde504..dd8fc03a798c9 100644
--- a/core/src/main/scala/kafka/server/ReplicaManager.scala
+++ b/core/src/main/scala/kafka/server/ReplicaManager.scala
@@ -45,10 +45,10 @@ import scala.collection.JavaConverters._
 /*
  * Result metadata of a log append operation on the log
  */
-case class LogAppendResult(info: LogAppendInfo, error: Option[Throwable] = None) {
-  def errorCode = error match {
-    case None => Errors.NONE.code
-    case Some(e) => Errors.forException(e).code
+case class LogAppendResult(info: LogAppendInfo, exception: Option[Throwable] = None) {
+  def error: Errors = exception match {
+    case None => Errors.NONE
+    case Some(e) => Errors.forException(e)
   }
 }
 
@@ -66,20 +66,19 @@ case class LogReadResult(info: FetchDataInfo,
                          leaderLogEndOffset: Long,
                          fetchTimeMs: Long,
                          readSize: Int,
-                         error: Option[Throwable] = None) {
+                         exception: Option[Throwable] = None) {
 
-  def errorCode = error match {
-    case None => Errors.NONE.code
-    case Some(e) => Errors.forException(e).code
+  def error: Errors = exception match {
+    case None => Errors.NONE
+    case Some(e) => Errors.forException(e)
   }
 
-  override def toString = {
-    "Fetch Data: [%s], HW: [%d], leaderLogEndOffset: [%d], readSize: [%d], error: [%s]"
-            .format(info, hw, leaderLogEndOffset, readSize, error)
-  }
+  override def toString =
+    s"Fetch Data: [$info], HW: [$hw], leaderLogEndOffset: [$leaderLogEndOffset], readSize: [$readSize], error: [$error]"
+
 }
 
-case class FetchPartitionData(error: Short = Errors.NONE.code, hw: Long = -1L, records: Records)
+case class FetchPartitionData(error: Errors = Errors.NONE, hw: Long = -1L, records: Records)
 
 object LogReadResult {
   val UnknownLogReadResult = LogReadResult(info = FetchDataInfo(LogOffsetMetadata.UnknownOffsetMetadata, MemoryRecords.EMPTY),
@@ -315,7 +314,7 @@ class ReplicaManager(val config: KafkaConfig,
         topicPartition ->
                 ProducePartitionStatus(
                   result.info.lastOffset + 1, // required offset
-                  new PartitionResponse(result.errorCode, result.info.firstOffset, result.info.logAppendTime)) // response status
+                  new PartitionResponse(result.error, result.info.firstOffset, result.info.logAppendTime)) // response status
       }
 
       if (delayedRequestRequired(requiredAcks, entriesPerPartition, localProduceResults)) {
@@ -340,7 +339,7 @@ class ReplicaManager(val config: KafkaConfig,
       // If required.acks is outside accepted range, something is wrong with the client
       // Just return an error and don't handle the request at all
       val responseStatus = entriesPerPartition.map { case (topicPartition, _) =>
-        topicPartition -> new PartitionResponse(Errors.INVALID_REQUIRED_ACKS.code,
+        topicPartition -> new PartitionResponse(Errors.INVALID_REQUIRED_ACKS,
           LogAppendInfo.UnknownLogAppendInfo.firstOffset, Record.NO_TIMESTAMP)
       }
       responseCallback(responseStatus)
@@ -357,7 +356,7 @@ class ReplicaManager(val config: KafkaConfig,
                                      localProduceResults: Map[TopicPartition, LogAppendResult]): Boolean = {
     requiredAcks == -1 &&
     entriesPerPartition.nonEmpty &&
-    localProduceResults.values.count(_.error.isDefined) < entriesPerPartition.size
+    localProduceResults.values.count(_.exception.isDefined) < entriesPerPartition.size
   }
 
   private def isValidRequiredAcks(requiredAcks: Short): Boolean = {
@@ -464,7 +463,7 @@ class ReplicaManager(val config: KafkaConfig,
     val logReadResultValues = logReadResults.map { case (_, v) => v }
     val bytesReadable = logReadResultValues.map(_.info.records.sizeInBytes).sum
     val errorReadingData = logReadResultValues.foldLeft(false) ((errorIncurred, readResult) =>
-      errorIncurred || (readResult.errorCode != Errors.NONE.code))
+      errorIncurred || (readResult.error != Errors.NONE))
 
     // respond immediately if 1) fetch request does not want to wait
     //                        2) fetch request does not require any data
@@ -472,7 +471,7 @@ class ReplicaManager(val config: KafkaConfig,
     //                        4) some error happens while reading data
     if (timeout <= 0 || fetchInfos.isEmpty || bytesReadable >= fetchMinBytes || errorReadingData) {
       val fetchPartitionData = logReadResults.map { case (tp, result) =>
-        tp -> FetchPartitionData(result.errorCode, result.hw, result.info.records)
+        tp -> FetchPartitionData(result.error, result.hw, result.info.records)
       }
       responseCallback(fetchPartitionData)
     } else {
@@ -567,7 +566,7 @@ class ReplicaManager(val config: KafkaConfig,
                       leaderLogEndOffset = initialLogEndOffset,
                       fetchTimeMs = fetchTimeMs,
                       readSize = partitionFetchSize,
-                      error = None)
+                      exception = None)
       } catch {
         // NOTE: Failed fetch requests metric is not incremented for known exceptions since it
         // is supposed to indicate un-expected failure of a broker in handling a fetch request
@@ -580,7 +579,7 @@ class ReplicaManager(val config: KafkaConfig,
                         leaderLogEndOffset = -1L,
                         fetchTimeMs = -1L,
                         readSize = partitionFetchSize,
-                        error = Some(e))
+                        exception = Some(e))
         case e: Throwable =>
           BrokerTopicStats.getBrokerTopicStats(tp.topic).failedFetchRequestRate.mark()
           BrokerTopicStats.getBrokerAllTopicsStats().failedFetchRequestRate.mark()
@@ -590,7 +589,7 @@ class ReplicaManager(val config: KafkaConfig,
                         leaderLogEndOffset = -1L,
                         fetchTimeMs = -1L,
                         readSize = partitionFetchSize,
-                        error = Some(e))
+                        exception = Some(e))
       }
     }
 
diff --git a/core/src/test/scala/integration/kafka/api/AuthorizerIntegrationTest.scala b/core/src/test/scala/integration/kafka/api/AuthorizerIntegrationTest.scala
index d43d1af2a4d2d..c9d35af7fb168 100644
--- a/core/src/test/scala/integration/kafka/api/AuthorizerIntegrationTest.scala
+++ b/core/src/test/scala/integration/kafka/api/AuthorizerIntegrationTest.scala
@@ -107,7 +107,7 @@ class AuthorizerIntegrationTest extends BaseRequestTest {
 
   val RequestKeyToErrorCode = Map[ApiKeys, (Nothing) => Short](
     ApiKeys.METADATA -> ((resp: requests.MetadataResponse) => resp.errors().asScala.find(_._1 == topic).getOrElse(("test", Errors.NONE))._2.code),
-    ApiKeys.PRODUCE -> ((resp: requests.ProduceResponse) => resp.responses().asScala.find(_._1 == tp).get._2.errorCode),
+    ApiKeys.PRODUCE -> ((resp: requests.ProduceResponse) => resp.responses().asScala.find(_._1 == tp).get._2.error.code),
     ApiKeys.FETCH -> ((resp: requests.FetchResponse) => resp.responseData().asScala.find(_._1 == tp).get._2.errorCode),
     ApiKeys.LIST_OFFSETS -> ((resp: requests.ListOffsetResponse) => resp.responseData().asScala.find(_._1 == tp).get._2.errorCode),
     ApiKeys.OFFSET_COMMIT -> ((resp: requests.OffsetCommitResponse) => resp.responseData().asScala.find(_._1 == tp).get._2),
diff --git a/core/src/test/scala/integration/kafka/api/BaseProducerSendTest.scala b/core/src/test/scala/integration/kafka/api/BaseProducerSendTest.scala
index 9ebc7e3bf3b87..ad61a375c3d4f 100644
--- a/core/src/test/scala/integration/kafka/api/BaseProducerSendTest.scala
+++ b/core/src/test/scala/integration/kafka/api/BaseProducerSendTest.scala
@@ -187,13 +187,13 @@ abstract class BaseProducerSendTest extends KafkaServerTestHarness {
 
       def onCompletion(metadata: RecordMetadata, exception: Exception) {
         if (exception == null) {
-          assertEquals(offset, metadata.offset())
-          assertEquals(topic, metadata.topic())
+          assertEquals(offset, metadata.offset)
+          assertEquals(topic, metadata.topic)
           if (timestampType == TimestampType.CREATE_TIME)
-            assertEquals(baseTimestamp + timestampDiff, metadata.timestamp())
+            assertEquals(baseTimestamp + timestampDiff, metadata.timestamp)
           else
-            assertTrue(metadata.timestamp() >= startTime && metadata.timestamp() <= System.currentTimeMillis())
-          assertEquals(partition, metadata.partition())
+            assertTrue(metadata.timestamp >= startTime && metadata.timestamp <= System.currentTimeMillis())
+          assertEquals(partition, metadata.partition)
           offset += 1
           timestampDiff += 1
         } else {
@@ -211,11 +211,18 @@ abstract class BaseProducerSendTest extends KafkaServerTestHarness {
         topicProps.setProperty(LogConfig.MessageTimestampTypeProp, "CreateTime")
       TestUtils.createTopic(zkUtils, topic, 1, 2, servers, topicProps)
 
-      for (i <- 1 to numRecords) {
-        val record = new ProducerRecord[Array[Byte], Array[Byte]](topic, partition, baseTimestamp + i, "key".getBytes, "value".getBytes)
-        producer.send(record, callback)
+      val recordAndFutures = for (i <- 1 to numRecords) yield {
+        val record = new ProducerRecord(topic, partition, baseTimestamp + i, "key".getBytes, "value".getBytes)
+        (record, producer.send(record, callback))
       }
       producer.close(20000L, TimeUnit.MILLISECONDS)
+      recordAndFutures.foreach { case (record, future) =>
+        val recordMetadata = future.get
+        if (timestampType == TimestampType.LOG_APPEND_TIME)
+          assertTrue(recordMetadata.timestamp >= startTime && recordMetadata.timestamp <= System.currentTimeMillis())
+        else
+          assertEquals(record.timestamp, recordMetadata.timestamp)
+      }
       assertEquals(s"Should have offset $numRecords but only successfully sent ${callback.offset}", numRecords, callback.offset)
     } finally {
       producer.close()
diff --git a/core/src/test/scala/integration/kafka/api/PlaintextProducerSendTest.scala b/core/src/test/scala/integration/kafka/api/PlaintextProducerSendTest.scala
index a75e7c73b1cee..956fe61dd17c1 100644
--- a/core/src/test/scala/integration/kafka/api/PlaintextProducerSendTest.scala
+++ b/core/src/test/scala/integration/kafka/api/PlaintextProducerSendTest.scala
@@ -22,53 +22,23 @@ import java.util.concurrent.ExecutionException
 
 import kafka.log.LogConfig
 import kafka.utils.TestUtils
-
 import org.apache.kafka.clients.producer.{KafkaProducer, ProducerConfig, ProducerRecord}
-import org.apache.kafka.common.config.ConfigException
 import org.apache.kafka.common.errors.{InvalidTimestampException, SerializationException}
 import org.apache.kafka.common.record.TimestampType
-import org.apache.kafka.common.serialization.ByteArraySerializer
 import org.junit.Assert._
 import org.junit.Test
 
 class PlaintextProducerSendTest extends BaseProducerSendTest {
 
-  @Test
-  def testSerializerConstructors() {
-    try {
-      createNewProducerWithNoSerializer(brokerList)
-      fail("Instantiating a producer without specifying a serializer should cause a ConfigException")
-    } catch {
-      case _ : ConfigException => // this is ok
-    }
-
-    // create a producer with explicit serializers should succeed
-    createNewProducerWithExplicitSerializer(brokerList)
-  }
-
-  private def createNewProducerWithNoSerializer(brokerList: String): KafkaProducer[Array[Byte], Array[Byte]] = {
-    val producerProps = new Properties()
-    producerProps.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, brokerList)
-    registerProducer(new KafkaProducer(producerProps))
-  }
-
-  private def createNewProducerWithExplicitSerializer(brokerList: String): KafkaProducer[Array[Byte], Array[Byte]] = {
+  @Test(expected = classOf[SerializationException])
+  def testWrongSerializer() {
     val producerProps = new Properties()
     producerProps.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, brokerList)
-    registerProducer(new KafkaProducer(producerProps, new ByteArraySerializer, new ByteArraySerializer))
-  }
-
-  @Test
-  def testWrongSerializer() {
-    // send a record with a wrong type should receive a serialization exception
-    try {
-      val producer = createProducerWithWrongSerializer(brokerList)
-      val record5 = new ProducerRecord[Array[Byte], Array[Byte]](topic, new Integer(0), "key".getBytes, "value".getBytes)
-      producer.send(record5)
-      fail("Should have gotten a SerializationException")
-    } catch {
-      case _: SerializationException => // this is ok
-    }
+    producerProps.put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringSerializer")
+    producerProps.put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringSerializer")
+    val producer = registerProducer(new KafkaProducer(producerProps))
+    val record = new ProducerRecord[Array[Byte], Array[Byte]](topic, new Integer(0), "key".getBytes, "value".getBytes)
+    producer.send(record)
   }
 
   @Test
@@ -96,7 +66,7 @@ class PlaintextProducerSendTest extends BaseProducerSendTest {
 
     try {
       // Send a message to auto-create the topic
-      val record = new ProducerRecord[Array[Byte], Array[Byte]](topic, null, "key".getBytes, "value".getBytes)
+      val record = new ProducerRecord(topic, null, "key".getBytes, "value".getBytes)
       assertEquals("Should have offset 0", 0L, producer.send(record).get.offset)
 
       // double check that the topic is created with leader elected
@@ -137,12 +107,4 @@ class PlaintextProducerSendTest extends BaseProducerSendTest {
     }
   }
 
-  private def createProducerWithWrongSerializer(brokerList: String): KafkaProducer[Array[Byte], Array[Byte]] = {
-    val producerProps = new Properties()
-    producerProps.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, brokerList)
-    producerProps.put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringSerializer")
-    producerProps.put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringSerializer")
-    registerProducer(new KafkaProducer(producerProps))
-  }
-
 }
diff --git a/core/src/test/scala/unit/kafka/coordinator/GroupCoordinatorResponseTest.scala b/core/src/test/scala/unit/kafka/coordinator/GroupCoordinatorResponseTest.scala
index d3de16d049761..11f91021a133f 100644
--- a/core/src/test/scala/unit/kafka/coordinator/GroupCoordinatorResponseTest.scala
+++ b/core/src/test/scala/unit/kafka/coordinator/GroupCoordinatorResponseTest.scala
@@ -1052,7 +1052,7 @@ class GroupCoordinatorResponseTest extends JUnitSuite {
       EasyMock.capture(capturedArgument))).andAnswer(new IAnswer[Unit] {
       override def answer = capturedArgument.getValue.apply(
         Map(new TopicPartition(Topic.GroupMetadataTopicName, groupPartitionId) ->
-          new PartitionResponse(Errors.NONE.code, 0L, Record.NO_TIMESTAMP)
+          new PartitionResponse(Errors.NONE, 0L, Record.NO_TIMESTAMP)
         )
       )})
     EasyMock.expect(replicaManager.getMagicAndTimestampType(EasyMock.anyObject()))
@@ -1134,7 +1134,7 @@ class GroupCoordinatorResponseTest extends JUnitSuite {
       EasyMock.capture(capturedArgument))).andAnswer(new IAnswer[Unit] {
       override def answer = capturedArgument.getValue.apply(
         Map(new TopicPartition(Topic.GroupMetadataTopicName, groupPartitionId) ->
-          new PartitionResponse(Errors.NONE.code, 0L, Record.NO_TIMESTAMP)
+          new PartitionResponse(Errors.NONE, 0L, Record.NO_TIMESTAMP)
         )
       )})
     EasyMock.expect(replicaManager.getMagicAndTimestampType(EasyMock.anyObject()))
diff --git a/core/src/test/scala/unit/kafka/coordinator/GroupMetadataManagerTest.scala b/core/src/test/scala/unit/kafka/coordinator/GroupMetadataManagerTest.scala
index e3dca329529ff..9478122ffbc7d 100644
--- a/core/src/test/scala/unit/kafka/coordinator/GroupMetadataManagerTest.scala
+++ b/core/src/test/scala/unit/kafka/coordinator/GroupMetadataManagerTest.scala
@@ -613,7 +613,7 @@ class GroupMetadataManagerTest {
       EasyMock.capture(capturedArgument))).andAnswer(new IAnswer[Unit] {
       override def answer = capturedArgument.getValue.apply(
         Map(new TopicPartition(Topic.GroupMetadataTopicName, groupPartitionId) ->
-          new PartitionResponse(error.code, 0L, Record.NO_TIMESTAMP)
+          new PartitionResponse(error, 0L, Record.NO_TIMESTAMP)
         )
       )})
     EasyMock.expect(replicaManager.getMagicAndTimestampType(EasyMock.anyObject()))
diff --git a/core/src/test/scala/unit/kafka/server/EdgeCaseRequestTest.scala b/core/src/test/scala/unit/kafka/server/EdgeCaseRequestTest.scala
index 5c53ffa167103..1f9e18ba805fd 100755
--- a/core/src/test/scala/unit/kafka/server/EdgeCaseRequestTest.scala
+++ b/core/src/test/scala/unit/kafka/server/EdgeCaseRequestTest.scala
@@ -27,7 +27,7 @@ import kafka.utils._
 import org.apache.kafka.common.TopicPartition
 import org.apache.kafka.common.network.ListenerName
 import org.apache.kafka.common.protocol.types.Type
-import org.apache.kafka.common.protocol.{ApiKeys, SecurityProtocol}
+import org.apache.kafka.common.protocol.{ApiKeys, Errors, SecurityProtocol}
 import org.apache.kafka.common.record.MemoryRecords
 import org.apache.kafka.common.requests.{ProduceRequest, ProduceResponse, ResponseHeader}
 import org.junit.Assert._
@@ -138,7 +138,7 @@ class EdgeCaseRequestTest extends KafkaServerTestHarness {
 
     val partitionResponse = produceResponse.responses().get(topicPartition)
     assertNotNull(partitionResponse)
-    assertEquals("There should be no error", 0, partitionResponse.errorCode)
+    assertEquals("There should be no error", Errors.NONE, partitionResponse.error)
   }
 
   @Test
diff --git a/core/src/test/scala/unit/kafka/server/ProduceRequestTest.scala b/core/src/test/scala/unit/kafka/server/ProduceRequestTest.scala
index 8ed93d94d3f4b..b05be9d580531 100644
--- a/core/src/test/scala/unit/kafka/server/ProduceRequestTest.scala
+++ b/core/src/test/scala/unit/kafka/server/ProduceRequestTest.scala
@@ -45,9 +45,9 @@ class ProduceRequestTest extends BaseRequestTest {
       assertEquals(1, produceResponse.responses.size)
       val (tp, partitionResponse) = produceResponse.responses.asScala.head
       assertEquals(topicPartition, tp)
-      assertEquals(Errors.NONE.code, partitionResponse.errorCode)
+      assertEquals(Errors.NONE, partitionResponse.error)
       assertEquals(expectedOffset, partitionResponse.baseOffset)
-      assertEquals(-1, partitionResponse.timestamp)
+      assertEquals(-1, partitionResponse.logAppendTime)
       partitionResponse
     }
 
@@ -82,9 +82,9 @@ class ProduceRequestTest extends BaseRequestTest {
     assertEquals(1, produceResponse.responses.size)
     val (tp, partitionResponse) = produceResponse.responses.asScala.head
     assertEquals(topicPartition, tp)
-    assertEquals(Errors.CORRUPT_MESSAGE.code, partitionResponse.errorCode)
+    assertEquals(Errors.CORRUPT_MESSAGE, partitionResponse.error)
     assertEquals(-1, partitionResponse.baseOffset)
-    assertEquals(-1, partitionResponse.timestamp)
+    assertEquals(-1, partitionResponse.logAppendTime)
   }
 
   private def sendProduceRequest(leaderId: Int, request: ProduceRequest): ProduceResponse = {
diff --git a/core/src/test/scala/unit/kafka/server/ReplicaManagerTest.scala b/core/src/test/scala/unit/kafka/server/ReplicaManagerTest.scala
index 00959f142a413..d5075aaa7a0dc 100644
--- a/core/src/test/scala/unit/kafka/server/ReplicaManagerTest.scala
+++ b/core/src/test/scala/unit/kafka/server/ReplicaManagerTest.scala
@@ -101,7 +101,7 @@ class ReplicaManagerTest {
       new AtomicBoolean(false), QuotaFactory.instantiate(config, metrics, time).follower, Option(this.getClass.getName))
     try {
       def callback(responseStatus: Map[TopicPartition, PartitionResponse]) = {
-        assert(responseStatus.values.head.errorCode == Errors.INVALID_REQUIRED_ACKS.code)
+        assert(responseStatus.values.head.error == Errors.INVALID_REQUIRED_ACKS)
       }
       rm.appendRecords(
         timeout = 0,
@@ -128,13 +128,15 @@ class ReplicaManagerTest {
     try {
       var produceCallbackFired = false
       def produceCallback(responseStatus: Map[TopicPartition, PartitionResponse]) = {
-        assertEquals("Should give NotLeaderForPartitionException", Errors.NOT_LEADER_FOR_PARTITION.code, responseStatus.values.head.errorCode)
+        assertEquals("Should give NotLeaderForPartitionException", Errors.NOT_LEADER_FOR_PARTITION,
+          responseStatus.values.head.error)
         produceCallbackFired = true
       }
 
       var fetchCallbackFired = false
       def fetchCallback(responseStatus: Seq[(TopicPartition, FetchPartitionData)]) = {
-        assertEquals("Should give NotLeaderForPartitionException", Errors.NOT_LEADER_FOR_PARTITION.code, responseStatus.map(_._2).head.error)
+        assertEquals("Should give NotLeaderForPartitionException", Errors.NOT_LEADER_FOR_PARTITION,
+          responseStatus.map(_._2).head.error)
         fetchCallbackFired = true
       }
 
@@ -229,7 +231,7 @@ class ReplicaManagerTest {
       var fetchError = 0
       var fetchedRecords: Records = null
       def fetchCallback(responseStatus: Seq[(TopicPartition, FetchPartitionData)]) = {
-        fetchError = responseStatus.map(_._2).head.error
+        fetchError = responseStatus.map(_._2).head.error.code
         fetchedRecords = responseStatus.map(_._2).head.records
         fetchCallbackFired = true
       }

From 47154d804e687b021dc16661fc28b27a2fc6c34d Mon Sep 17 00:00:00 2001
From: Xi Hu <huxi@zhenrongbao.com>
Date: Wed, 25 Jan 2017 17:53:51 -0800
Subject: [PATCH 050/177] KAFKA-4684: add kafka-configs.bat for Windows boxes

Add kafka-configs.bat script for Windows.

Author: huxi <huxi@zhenrongbao.com>

Reviewers: Guozhang Wang, Vahid Hashemian

Closes #2419 from amethystic/kafka4684_offer_kafkaconfigs_script

(cherry picked from commit e9426291aa989ac2624905b844724eeffa608773)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 bin/windows/kafka-configs.bat | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 bin/windows/kafka-configs.bat

diff --git a/bin/windows/kafka-configs.bat b/bin/windows/kafka-configs.bat
new file mode 100644
index 0000000000000..8bbbbfa5cfcdd
--- /dev/null
+++ b/bin/windows/kafka-configs.bat
@@ -0,0 +1,17 @@
+@echo off
+rem Licensed to the Apache Software Foundation (ASF) under one or more
+rem contributor license agreements.  See the NOTICE file distributed with
+rem this work for additional information regarding copyright ownership.
+rem The ASF licenses this file to You under the Apache License, Version 2.0
+rem (the "License"); you may not use this file except in compliance with
+rem the License.  You may obtain a copy of the License at
+rem
+rem     http://www.apache.org/licenses/LICENSE-2.0
+rem
+rem Unless required by applicable law or agreed to in writing, software
+rem distributed under the License is distributed on an "AS IS" BASIS,
+rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+rem See the License for the specific language governing permissions and
+rem limitations under the License.
+
+%~dp0kafka-run-class.bat kafka.admin.ConfigCommand %*

From d54855a481da9b98d5abc413f57927d0bc2546d2 Mon Sep 17 00:00:00 2001
From: Gwen Shapira <cshapi@gmail.com>
Date: Wed, 25 Jan 2017 18:00:14 -0800
Subject: [PATCH 051/177] MINOR: Clarify misleading comment in WordCount
 example

Author: Gwen Shapira <cshapi@gmail.com>

Reviewers: Matthias J. Sax, Guozhang Wang

Closes #2400 from gwenshap/wordcount-comment

(cherry picked from commit 9a7032720f4600099b130a0bb7b578cedc83e5ff)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../apache/kafka/streams/examples/wordcount/WordCountDemo.java  | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountDemo.java b/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountDemo.java
index 99fbc1574b55d..b1d3c52a0bb56 100644
--- a/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountDemo.java
+++ b/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountDemo.java
@@ -53,6 +53,8 @@ public static void main(String[] args) throws Exception {
         props.put(StreamsConfig.VALUE_SERDE_CLASS_CONFIG, Serdes.String().getClass().getName());
 
         // setting offset reset to earliest so that we can re-run the demo code with the same pre-loaded data
+        // Note: To re-run the demo, you need to use the offset reset tool:
+        // https://cwiki.apache.org/confluence/display/KAFKA/Kafka+Streams+Application+Reset+Tool
         props.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
 
         KStreamBuilder builder = new KStreamBuilder();

From 6493e5d8dbafb84dc9502b56ba651049dca7d72d Mon Sep 17 00:00:00 2001
From: Will Marshall <wcm214@gmail.com>
Date: Wed, 25 Jan 2017 18:01:37 -0800
Subject: [PATCH 052/177] MINOR: Fix typo in WordCountProcessorDemo

`bin-kafka-console-producer.sh` should be `bin/kafka-console-producer.sh`.

Author: Will Marshall <wcm214@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2410 from wmarshall484/typo-fix

(cherry picked from commit 51e745ef30c777009c2d1f75965e63a3fe7bb474)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../streams/examples/wordcount/WordCountProcessorDemo.java      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountProcessorDemo.java b/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountProcessorDemo.java
index e0560a9c6fd49..f9913cac7ed73 100644
--- a/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountProcessorDemo.java
+++ b/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountProcessorDemo.java
@@ -42,7 +42,7 @@
  * is an updated count of a single word.
  *
  * Before running this example you must create the source topic (e.g. via bin/kafka-topics.sh --create ...)
- * and write some data to it (e.g. via bin-kafka-console-producer.sh). Otherwise you won't see any data arriving in the output topic.
+ * and write some data to it (e.g. via bin/kafka-console-producer.sh). Otherwise you won't see any data arriving in the output topic.
  */
 public class WordCountProcessorDemo {
 

From d8f9e18aa0f16b97e71719ca5983f8ff39134a4a Mon Sep 17 00:00:00 2001
From: Jason Gustafson <jason@confluent.io>
Date: Thu, 26 Jan 2017 02:53:59 +0000
Subject: [PATCH 053/177] MINOR: Refactor partition lag metric for cleaner
 encapsulation

Author: Jason Gustafson <jason@confluent.io>

Reviewers: Jiangjie Qin <becket.qin@gmail.com>, Guozhang Wang <wangguoz@gmail.com>, Ismael Juma <ismael@juma.me.uk>

Closes #2416 from hachikuji/refactor-partition-lag-cleanup

(cherry picked from commit 135488352cbe646334a274418d7014a91e92057f)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../consumer/ConsumerRebalanceListener.java   |   4 +-
 .../kafka/clients/consumer/KafkaConsumer.java |   2 +-
 .../kafka/clients/consumer/MockConsumer.java  |   3 +-
 .../internals/ConsumerCoordinator.java        |   2 +-
 .../clients/consumer/internals/Fetcher.java   | 107 ++++++++++--------
 .../consumer/internals/SubscriptionState.java |  62 ++++++----
 .../clients/consumer/KafkaConsumerTest.java   |   2 +-
 .../internals/ConsumerCoordinatorTest.java    |   2 +-
 .../consumer/internals/FetcherTest.java       |  16 ++-
 .../internals/SubscriptionStateTest.java      |  44 +++++--
 .../kafka/api/BaseConsumerTest.scala          | 101 +----------------
 .../kafka/api/PlaintextConsumerTest.scala     | 102 ++++++++++++++++-
 12 files changed, 250 insertions(+), 197 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/ConsumerRebalanceListener.java b/clients/src/main/java/org/apache/kafka/clients/consumer/ConsumerRebalanceListener.java
index 938d22bbbece5..a4265abb76eda 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/ConsumerRebalanceListener.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/ConsumerRebalanceListener.java
@@ -86,7 +86,7 @@ public interface ConsumerRebalanceListener {
      *
      * @param partitions The list of partitions that were assigned to the consumer on the last rebalance
      */
-    public void onPartitionsRevoked(Collection<TopicPartition> partitions);
+    void onPartitionsRevoked(Collection<TopicPartition> partitions);
 
     /**
      * A callback method the user can implement to provide handling of customized offsets on completion of a successful
@@ -100,5 +100,5 @@ public interface ConsumerRebalanceListener {
      * @param partitions The list of partitions that are now assigned to the consumer (may include partitions previously
      *            assigned to the consumer)
      */
-    public void onPartitionsAssigned(Collection<TopicPartition> partitions);
+    void onPartitionsAssigned(Collection<TopicPartition> partitions);
 }
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
index be212db8a4a1f..2936f0f8f034f 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
@@ -663,7 +663,7 @@ private KafkaConsumer(ConsumerConfig config,
             this.client = new ConsumerNetworkClient(netClient, metadata, time, retryBackoffMs,
                     config.getInt(ConsumerConfig.REQUEST_TIMEOUT_MS_CONFIG));
             OffsetResetStrategy offsetResetStrategy = OffsetResetStrategy.valueOf(config.getString(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG).toUpperCase(Locale.ROOT));
-            this.subscriptions = new SubscriptionState(offsetResetStrategy, metrics);
+            this.subscriptions = new SubscriptionState(offsetResetStrategy);
             List<PartitionAssignor> assignors = config.getConfiguredInstances(
                     ConsumerConfig.PARTITION_ASSIGNMENT_STRATEGY_CONFIG,
                     PartitionAssignor.class);
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/MockConsumer.java b/clients/src/main/java/org/apache/kafka/clients/consumer/MockConsumer.java
index 95e3830952db0..a88f4324ccb2d 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/MockConsumer.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/MockConsumer.java
@@ -34,7 +34,6 @@
 import java.util.concurrent.TimeUnit;
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.regex.Pattern;
-import org.apache.kafka.common.metrics.Metrics;
 
 
 /**
@@ -59,7 +58,7 @@ public class MockConsumer<K, V> implements Consumer<K, V> {
     private AtomicBoolean wakeup;
 
     public MockConsumer(OffsetResetStrategy offsetResetStrategy) {
-        this.subscriptions = new SubscriptionState(offsetResetStrategy, new Metrics());
+        this.subscriptions = new SubscriptionState(offsetResetStrategy);
         this.partitions = new HashMap<>();
         this.records = new HashMap<>();
         this.paused = new HashSet<>();
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java
index 4c54a8f087b21..03b767a4cd8a2 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java
@@ -155,7 +155,7 @@ public void updatePatternSubscription(Cluster cluster) {
         final Set<String> topicsToSubscribe = new HashSet<>();
 
         for (String topic : cluster.topics())
-            if (subscriptions.getSubscribedPattern().matcher(topic).matches() &&
+            if (subscriptions.subscribedPattern().matcher(topic).matches() &&
                     !(excludeInternalTopics && cluster.internalTopics().contains(topic)))
                 topicsToSubscribe.add(topic);
 
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
index cd7f3077c49ca..6bd454ef36dff 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
@@ -72,7 +72,7 @@
 /**
  * This class manage the fetching process with the brokers.
  */
-public class Fetcher<K, V> {
+public class Fetcher<K, V> implements SubscriptionState.Listener {
 
     private static final Logger log = LoggerFactory.getLogger(Fetcher.class);
 
@@ -124,6 +124,8 @@ public Fetcher(ConsumerNetworkClient client,
         this.completedFetches = new ConcurrentLinkedQueue<>();
         this.sensors = new FetchManagerMetrics(metrics, metricGrpPrefix);
         this.retryBackoffMs = retryBackoffMs;
+
+        subscriptions.addListener(this);
     }
 
     /**
@@ -453,10 +455,9 @@ public Map<TopicPartition, List<ConsumerRecord<K, V>>> fetchedRecords() {
                 if (completedFetch == null)
                     break;
 
-                nextInLineRecords = parseFetchedData(completedFetch);
+                nextInLineRecords = parseCompletedFetch(completedFetch);
             } else {
                 TopicPartition partition = nextInLineRecords.partition;
-
                 List<ConsumerRecord<K, V>> records = drainRecords(nextInLineRecords, recordsRemaining);
                 if (!records.isEmpty()) {
                     List<ConsumerRecord<K, V>> currentRecords = drained.get(partition);
@@ -480,9 +481,6 @@ public Map<TopicPartition, List<ConsumerRecord<K, V>>> fetchedRecords() {
     }
 
     private List<ConsumerRecord<K, V>> drainRecords(PartitionRecords<K, V> partitionRecords, int maxRecords) {
-        if (partitionRecords.isDrained())
-            return Collections.emptyList();
-
         if (!subscriptions.isAssigned(partitionRecords.partition)) {
             // this can happen when a rebalance happened before fetched records are returned to the consumer's poll call
             log.debug("Not returning fetched records for partition {} since it is no longer assigned", partitionRecords.partition);
@@ -493,19 +491,19 @@ private List<ConsumerRecord<K, V>> drainRecords(PartitionRecords<K, V> partition
                 // this can happen when a partition is paused before fetched records are returned to the consumer's poll call
                 log.debug("Not returning fetched records for assigned partition {} since it is no longer fetchable", partitionRecords.partition);
             } else if (partitionRecords.fetchOffset == position) {
-                // we are ensured to have at least one record since we already checked for emptiness
                 List<ConsumerRecord<K, V>> partRecords = partitionRecords.drainRecords(maxRecords);
-                long nextOffset = partRecords.get(partRecords.size() - 1).offset() + 1;
+                if (!partRecords.isEmpty()) {
+                    long nextOffset = partRecords.get(partRecords.size() - 1).offset() + 1;
+                    log.trace("Returning fetched records at offset {} for assigned partition {} and update " +
+                            "position to {}", position, partitionRecords.partition, nextOffset);
 
-                log.trace("Returning fetched records at offset {} for assigned partition {} and update " +
-                        "position to {}", position, partitionRecords.partition, nextOffset);
+                    subscriptions.position(partitionRecords.partition, nextOffset);
+                }
 
-                subscriptions.position(partitionRecords.partition, nextOffset);
                 Long partitionLag = subscriptions.partitionLag(partitionRecords.partition);
-                if (partitionLag != null) {
-                    this.sensors.recordsFetchLag.record(partitionLag);
-                    this.sensors.recordPartitionFetchLag(partitionRecords.partition, partitionLag);
-                }
+                if (partitionLag != null)
+                    this.sensors.recordPartitionLag(partitionRecords.partition, partitionLag);
+
                 return partRecords;
             } else {
                 // these records aren't next in line based on the last consumed position, ignore them
@@ -731,7 +729,7 @@ private Map<Node, FetchRequest.Builder> createFetchRequests() {
     /**
      * The callback for fetch completion
      */
-    private PartitionRecords<K, V> parseFetchedData(CompletedFetch completedFetch) {
+    private PartitionRecords<K, V> parseCompletedFetch(CompletedFetch completedFetch) {
         TopicPartition tp = completedFetch.partition;
         FetchResponse.PartitionData partition = completedFetch.partitionData;
         long fetchOffset = completedFetch.fetchedOffset;
@@ -766,26 +764,13 @@ private PartitionRecords<K, V> parseFetchedData(CompletedFetch completedFetch) {
 
                 recordsCount = parsed.size();
 
-                if (!parsed.isEmpty()) {
-                    log.trace("Adding fetched record for partition {} with offset {} to buffered record list", tp, position);
-                    parsedRecords = new PartitionRecords<>(fetchOffset, tp, parsed);
-                }
+                log.trace("Adding fetched record for partition {} with offset {} to buffered record list", tp, position);
+                parsedRecords = new PartitionRecords<>(fetchOffset, tp, parsed);
 
                 if (partition.highWatermark >= 0) {
                     log.trace("Received {} records in fetch response for partition {} with offset {}", parsed.size(), tp, position);
-                    Long partitionLag = subscriptions.partitionLag(tp);
                     subscriptions.updateHighWatermark(tp, partition.highWatermark);
-                    // If the partition lag is null, that means this is the first fetch response for this partition.
-                    // We update the lag here to create the lag metric. This is to handle the case that there is no
-                    // message consumed by the end user from this partition. If there are messages returned from the
-                    // partition, the lag will be updated when those messages are consumed by the end user.
-                    if (partitionLag == null) {
-                        partitionLag = subscriptions.partitionLag(tp);
-                        this.sensors.recordsFetchLag.record(partitionLag);
-                        this.sensors.recordPartitionFetchLag(tp, partitionLag);
-                    }
                 }
-
             } else if (error == Errors.NOT_LEADER_FOR_PARTITION) {
                 log.debug("Error in fetch for partition {}: {}", tp, error.exceptionName());
                 this.metadata.requestUpdate();
@@ -860,20 +845,25 @@ private ConsumerRecord<K, V> parseRecord(TopicPartition partition, LogEntry logE
         }
     }
 
+    @Override
+    public void onAssignment(Set<TopicPartition> assignment) {
+        sensors.updatePartitionLagSensors(assignment);
+    }
+
     private static class PartitionRecords<K, V> {
         private long fetchOffset;
         private TopicPartition partition;
         private List<ConsumerRecord<K, V>> records;
         private int position = 0;
 
-        public PartitionRecords(long fetchOffset, TopicPartition partition, List<ConsumerRecord<K, V>> records) {
+        private PartitionRecords(long fetchOffset, TopicPartition partition, List<ConsumerRecord<K, V>> records) {
             this.fetchOffset = fetchOffset;
             this.partition = partition;
             this.records = records;
         }
 
         private boolean isDrained() {
-            return records == null || position >= records.size();
+            return records == null;
         }
 
         private void drain() {
@@ -881,8 +871,10 @@ private void drain() {
         }
 
         private List<ConsumerRecord<K, V>> drainRecords(int n) {
-            if (isDrained())
+            if (isDrained() || position >= records.size()) {
+                drain();
                 return Collections.emptyList();
+            }
 
             // using a sublist avoids a potentially expensive list copy (depending on the size of the records
             // and the maximum we can return from poll). The cost is that we cannot mutate the returned sublist.
@@ -903,10 +895,10 @@ private static class CompletedFetch {
         private final FetchResponse.PartitionData partitionData;
         private final FetchResponseMetricAggregator metricAggregator;
 
-        public CompletedFetch(TopicPartition partition,
-                              long fetchedOffset,
-                              FetchResponse.PartitionData partitionData,
-                              FetchResponseMetricAggregator metricAggregator) {
+        private CompletedFetch(TopicPartition partition,
+                               long fetchedOffset,
+                               FetchResponse.PartitionData partitionData,
+                               FetchResponseMetricAggregator metricAggregator) {
             this.partition = partition;
             this.fetchedOffset = fetchedOffset;
             this.partitionData = partitionData;
@@ -974,16 +966,17 @@ protected void increment(int bytes, int records) {
     }
 
     private static class FetchManagerMetrics {
-        public final Metrics metrics;
-        public final String metricGrpName;
+        private final Metrics metrics;
+        private final String metricGrpName;
+        private final Sensor bytesFetched;
+        private final Sensor recordsFetched;
+        private final Sensor fetchLatency;
+        private final Sensor recordsFetchLag;
+        private final Sensor fetchThrottleTimeSensor;
 
-        public final Sensor bytesFetched;
-        public final Sensor recordsFetched;
-        public final Sensor fetchLatency;
-        public final Sensor recordsFetchLag;
-        public final Sensor fetchThrottleTimeSensor;
+        private Set<TopicPartition> assignedPartitions;
 
-        public FetchManagerMetrics(Metrics metrics, String metricGrpPrefix) {
+        private FetchManagerMetrics(Metrics metrics, String metricGrpPrefix) {
             this.metrics = metrics;
             this.metricGrpName = metricGrpPrefix + "-fetch-manager-metrics";
 
@@ -1032,7 +1025,7 @@ public FetchManagerMetrics(Metrics metrics, String metricGrpPrefix) {
                                                          "The maximum throttle time in ms"), new Max());
         }
 
-        public void recordTopicFetchMetrics(String topic, int bytes, int records) {
+        private void recordTopicFetchMetrics(String topic, int bytes, int records) {
             // record bytes fetched
             String name = "topic." + topic + ".bytes-fetched";
             Sensor bytesFetched = this.metrics.getSensor(name);
@@ -1075,8 +1068,20 @@ public void recordTopicFetchMetrics(String topic, int bytes, int records) {
             recordsFetched.record(records);
         }
 
-        public void recordPartitionFetchLag(TopicPartition tp, long lag) {
-            String name = tp + ".records-lag";
+        private void updatePartitionLagSensors(Set<TopicPartition> assignedPartitions) {
+            if (this.assignedPartitions != null) {
+                for (TopicPartition tp : this.assignedPartitions) {
+                    if (!assignedPartitions.contains(tp))
+                        metrics.removeSensor(partitionLagMetricName(tp));
+                }
+            }
+            this.assignedPartitions = assignedPartitions;
+        }
+
+        private void recordPartitionLag(TopicPartition tp, long lag) {
+            this.recordsFetchLag.record(lag);
+
+            String name = partitionLagMetricName(tp);
             Sensor recordsLag = this.metrics.getSensor(name);
             if (recordsLag == null) {
                 recordsLag = this.metrics.sensor(name);
@@ -1091,6 +1096,10 @@ public void recordPartitionFetchLag(TopicPartition tp, long lag) {
             }
             recordsLag.record(lag);
         }
+
+        private static String partitionLagMetricName(TopicPartition tp) {
+            return tp + ".records-lag";
+        }
     }
 
 }
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/SubscriptionState.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/SubscriptionState.java
index 1a2a7ee6d76bd..25995fb5c04c2 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/SubscriptionState.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/SubscriptionState.java
@@ -17,7 +17,6 @@
 import org.apache.kafka.clients.consumer.OffsetResetStrategy;
 import org.apache.kafka.common.TopicPartition;
 import org.apache.kafka.common.internals.PartitionStates;
-import org.apache.kafka.common.metrics.Metrics;
 
 import java.util.ArrayList;
 import java.util.Collection;
@@ -78,19 +77,19 @@ private enum SubscriptionType {
     /* Default offset reset strategy */
     private final OffsetResetStrategy defaultResetStrategy;
 
-    /* Listener to be invoked when assignment changes */
+    /* User-provided listener to be invoked when assignment changes */
     private ConsumerRebalanceListener listener;
 
-    private final Metrics metrics;
+    /* Listeners provide a hook for internal state cleanup (e.g. metrics) on assignment changes */
+    private List<Listener> listeners = new ArrayList<>();
 
-    public SubscriptionState(OffsetResetStrategy defaultResetStrategy, Metrics metrics) {
+    public SubscriptionState(OffsetResetStrategy defaultResetStrategy) {
         this.defaultResetStrategy = defaultResetStrategy;
         this.subscription = Collections.emptySet();
         this.assignment = new PartitionStates<>();
         this.groupSubscription = new HashSet<>();
         this.needsFetchCommittedOffsets = true; // initialize to true for the consumers to fetch offset upon starting up
         this.subscribedPattern = null;
-        this.metrics = metrics;
         this.subscriptionType = SubscriptionType.NONE;
     }
 
@@ -160,7 +159,8 @@ public void assignFromUser(Set<TopicPartition> partitions) {
         setSubscriptionType(SubscriptionType.USER_ASSIGNED);
 
         if (!this.assignment.partitionSet().equals(partitions)) {
-            removeAllLagSensors(partitions);
+            fireOnAssignment(partitions);
+
             Map<TopicPartition, TopicPartitionState> partitionToState = new HashMap<>();
             for (TopicPartition partition : partitions) {
                 TopicPartitionState state = assignment.stateValue(partition);
@@ -180,8 +180,9 @@ public void assignFromUser(Set<TopicPartition> partitions) {
     public void assignFromSubscribed(Collection<TopicPartition> assignments) {
         if (!this.partitionsAutoAssigned())
             throw new IllegalArgumentException("Attempt to dynamically assign partitions while manual assignment in use");
-        Set<TopicPartition> newAssignment = new HashSet<>(assignments);
-        removeAllLagSensors(newAssignment);
+
+        Map<TopicPartition, TopicPartitionState> assignedPartitionStates = partitionToStateMap(assignments);
+        fireOnAssignment(assignedPartitionStates.keySet());
 
         if (this.subscribedPattern != null) {
             for (TopicPartition tp : assignments) {
@@ -195,24 +196,10 @@ public void assignFromSubscribed(Collection<TopicPartition> assignments) {
         }
 
         // after rebalancing, we always reinitialize the assignment value
-        this.assignment.set(partitionToStateMap(assignments));
+        this.assignment.set(assignedPartitionStates);
         this.needsFetchCommittedOffsets = true;
     }
 
-    private void removeAllLagSensors(Set<TopicPartition> preservedPartitions) {
-        for (TopicPartition tp : assignment.partitionSet()) {
-            if (!preservedPartitions.contains(tp))
-                metrics.removeSensor(tp + ".records-lag");
-        }
-    }
-
-    private Map<TopicPartition, TopicPartitionState> partitionToStateMap(Collection<TopicPartition> assignments) {
-        Map<TopicPartition, TopicPartitionState> map = new HashMap<>(assignments.size());
-        for (TopicPartition tp : assignments)
-            map.put(tp, new TopicPartitionState());
-        return map;
-    }
-
     public void subscribe(Pattern pattern, ConsumerRebalanceListener listener) {
         if (listener == null)
             throw new IllegalArgumentException("RebalanceListener cannot be null");
@@ -236,9 +223,10 @@ public void unsubscribe() {
         this.assignment.clear();
         this.subscribedPattern = null;
         this.subscriptionType = SubscriptionType.NONE;
+        fireOnAssignment(Collections.<TopicPartition>emptySet());
     }
 
-    public Pattern getSubscribedPattern() {
+    public Pattern subscribedPattern() {
         return this.subscribedPattern;
     }
 
@@ -416,6 +404,22 @@ public ConsumerRebalanceListener listener() {
         return listener;
     }
 
+    public void addListener(Listener listener) {
+        listeners.add(listener);
+    }
+
+    public void fireOnAssignment(Set<TopicPartition> assignment) {
+        for (Listener listener : listeners)
+            listener.onAssignment(assignment);
+    }
+
+    private static Map<TopicPartition, TopicPartitionState> partitionToStateMap(Collection<TopicPartition> assignments) {
+        Map<TopicPartition, TopicPartitionState> map = new HashMap<>(assignments.size());
+        for (TopicPartition tp : assignments)
+            map.put(tp, new TopicPartitionState());
+        return map;
+    }
+
     private static class TopicPartitionState {
         private Long position; // last consumed position
         private Long highWatermark; // the high watermark from last fetch
@@ -473,4 +477,14 @@ private boolean isFetchable() {
 
     }
 
+    public interface Listener {
+        /**
+         * Fired after a new assignment is received (after a group rebalance or when the user manually changes the
+         * assignment).
+         *
+         * @param assignment The topic partitions assigned to the consumer
+         */
+        void onAssignment(Set<TopicPartition> assignment);
+    }
+
 }
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
index ac88ce9284420..8346e932fd840 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
@@ -1491,7 +1491,7 @@ private KafkaConsumer<String, String> newConsumer(Time time,
         ConsumerInterceptors<String, String> interceptors = null;
 
         Metrics metrics = new Metrics();
-        SubscriptionState subscriptions = new SubscriptionState(autoResetStrategy, metrics);
+        SubscriptionState subscriptions = new SubscriptionState(autoResetStrategy);
         ConsumerNetworkClient consumerClient = new ConsumerNetworkClient(client, metadata, time, retryBackoffMs, requestTimeoutMs);
         ConsumerCoordinator consumerCoordinator = new ConsumerCoordinator(
                 consumerClient,
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java
index 3c4dd2dac5deb..e13d49faccbaa 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java
@@ -119,7 +119,7 @@ public class ConsumerCoordinatorTest {
     @Before
     public void setup() {
         this.time = new MockTime();
-        this.subscriptions = new SubscriptionState(OffsetResetStrategy.EARLIEST, metrics);
+        this.subscriptions = new SubscriptionState(OffsetResetStrategy.EARLIEST);
         this.metadata = new Metadata(0, Long.MAX_VALUE);
         this.metadata.update(cluster, time.milliseconds());
         this.client = new MockClient(time, metadata);
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java
index bdd56c3e0f713..210af6dbcde57 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java
@@ -91,8 +91,8 @@ public class FetcherTest {
     private Cluster cluster = TestUtils.singletonCluster(topicName, 1);
     private Node node = cluster.nodes().get(0);
     private Metrics metrics = new Metrics(time);
-    private SubscriptionState subscriptions = new SubscriptionState(OffsetResetStrategy.EARLIEST, metrics);
-    private SubscriptionState subscriptionsNoAutoReset = new SubscriptionState(OffsetResetStrategy.NONE, metrics);
+    private SubscriptionState subscriptions = new SubscriptionState(OffsetResetStrategy.EARLIEST);
+    private SubscriptionState subscriptionsNoAutoReset = new SubscriptionState(OffsetResetStrategy.NONE);
     private static final double EPSILON = 0.0001;
     private ConsumerNetworkClient consumerClient = new ConsumerNetworkClient(client, metadata, time, 100, 1000);
 
@@ -704,8 +704,11 @@ public void testFetcherMetrics() {
         subscriptions.assignFromUser(singleton(tp));
         subscriptions.seek(tp, 0);
 
+        MetricName maxLagMetric = metrics.metricName("records-lag-max", metricGroup, "");
+        MetricName partitionLagMetric = metrics.metricName(tp + ".records-lag", metricGroup, "");
+
         Map<MetricName, KafkaMetric> allMetrics = metrics.metrics();
-        KafkaMetric recordsFetchLagMax = allMetrics.get(metrics.metricName("records-lag-max", metricGroup, ""));
+        KafkaMetric recordsFetchLagMax = allMetrics.get(maxLagMetric);
 
         // recordsFetchLagMax should be initialized to negative infinity
         assertEquals(Double.NEGATIVE_INFINITY, recordsFetchLagMax.value(), EPSILON);
@@ -714,12 +717,19 @@ public void testFetcherMetrics() {
         fetchRecords(MemoryRecords.EMPTY, Errors.NONE.code(), 100L, 0);
         assertEquals(100, recordsFetchLagMax.value(), EPSILON);
 
+        KafkaMetric partitionLag = allMetrics.get(partitionLagMetric);
+        assertEquals(100, partitionLag.value(), EPSILON);
+
         // recordsFetchLagMax should be hw - offset of the last message after receiving a non-empty FetchResponse
         MemoryRecordsBuilder builder = MemoryRecords.builder(ByteBuffer.allocate(1024), CompressionType.NONE, TimestampType.CREATE_TIME);
         for (int v = 0; v < 3; v++)
             builder.appendWithOffset((long) v, Record.NO_TIMESTAMP, "key".getBytes(), String.format("value-%d", v).getBytes());
         fetchRecords(builder.build(), Errors.NONE.code(), 200L, 0);
         assertEquals(197, recordsFetchLagMax.value(), EPSILON);
+
+        // verify de-registration of partition lag
+        subscriptions.unsubscribe();
+        assertFalse(allMetrics.containsKey(partitionLagMetric));
     }
 
     private Map<TopicPartition, List<ConsumerRecord<byte[], byte[]>>> fetchRecords(MemoryRecords records, short error, long hw, int throttleTime) {
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/SubscriptionStateTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/SubscriptionStateTest.java
index 55bf2a357db28..61a55e262f909 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/SubscriptionStateTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/SubscriptionStateTest.java
@@ -20,13 +20,15 @@
 import org.apache.kafka.clients.consumer.OffsetAndMetadata;
 import org.apache.kafka.clients.consumer.OffsetResetStrategy;
 import org.apache.kafka.common.TopicPartition;
-import org.apache.kafka.common.metrics.Metrics;
+import org.apache.kafka.common.utils.Utils;
 import org.junit.Test;
 
 import java.util.Arrays;
 import java.util.Collection;
 import java.util.Collections;
 import java.util.HashSet;
+import java.util.Set;
+import java.util.concurrent.atomic.AtomicReference;
 import java.util.regex.Pattern;
 
 import static java.util.Collections.singleton;
@@ -36,7 +38,7 @@
 
 public class SubscriptionStateTest {
 
-    private final SubscriptionState state = new SubscriptionState(OffsetResetStrategy.EARLIEST, new Metrics());
+    private final SubscriptionState state = new SubscriptionState(OffsetResetStrategy.EARLIEST);
     private final String topic = "test";
     private final String topic1 = "test1";
     private final TopicPartition tp0 = new TopicPartition(topic, 0);
@@ -76,7 +78,7 @@ public void partitionAssignmentChangeOnTopicSubscription() {
         // assigned partitions should remain unchanged
         assertTrue(state.assignedPartitions().isEmpty());
 
-        state.assignFromSubscribed(Collections.singletonList(t1p0));
+        state.assignFromSubscribed(singleton(t1p0));
         // assigned partitions should immediately change
         assertEquals(singleton(t1p0), state.assignedPartitions());
 
@@ -99,7 +101,7 @@ public void partitionAssignmentChangeOnPatternSubscription() {
         // assigned partitions should remain unchanged
         assertTrue(state.assignedPartitions().isEmpty());
 
-        state.assignFromSubscribed(Collections.singletonList(tp1));
+        state.assignFromSubscribed(singleton(tp1));
         // assigned partitions should immediately change
         assertEquals(singleton(tp1), state.assignedPartitions());
         assertEquals(singleton(topic), state.subscription());
@@ -127,6 +129,28 @@ public void partitionAssignmentChangeOnPatternSubscription() {
         assertTrue(state.assignedPartitions().isEmpty());
     }
 
+    @Test
+    public void verifyAssignmentListener() {
+        final AtomicReference<Set<TopicPartition>> assignmentRef = new AtomicReference<>();
+        state.addListener(new SubscriptionState.Listener() {
+            @Override
+            public void onAssignment(Set<TopicPartition> assignment) {
+                assignmentRef.set(assignment);
+            }
+        });
+        Set<TopicPartition> userAssignment = Utils.mkSet(tp0, tp1);
+        state.assignFromUser(userAssignment);
+        assertEquals(userAssignment, assignmentRef.get());
+
+        state.unsubscribe();
+        assertEquals(Collections.emptySet(), assignmentRef.get());
+
+        Set<TopicPartition> autoAssignment = Utils.mkSet(t1p0);
+        state.subscribe(singleton(topic1), rebalanceListener);
+        state.assignFromSubscribed(autoAssignment);
+        assertEquals(autoAssignment, assignmentRef.get());
+    }
+
     @Test
     public void partitionReset() {
         state.assignFromUser(singleton(tp0));
@@ -149,11 +173,11 @@ public void topicSubscription() {
         assertEquals(1, state.subscription().size());
         assertTrue(state.assignedPartitions().isEmpty());
         assertTrue(state.partitionsAutoAssigned());
-        state.assignFromSubscribed(Collections.singletonList(tp0));
+        state.assignFromSubscribed(singleton(tp0));
         state.seek(tp0, 1);
         state.committed(tp0, new OffsetAndMetadata(1));
         assertAllPositions(tp0, 1L);
-        state.assignFromSubscribed(Collections.singletonList(tp1));
+        state.assignFromSubscribed(singleton(tp1));
         assertTrue(state.isAssigned(tp1));
         assertFalse(state.isAssigned(tp0));
         assertFalse(state.isFetchable(tp1));
@@ -183,7 +207,7 @@ public void commitOffsetMetadata() {
     @Test(expected = IllegalStateException.class)
     public void invalidPositionUpdate() {
         state.subscribe(singleton(topic), rebalanceListener);
-        state.assignFromSubscribed(Collections.singletonList(tp0));
+        state.assignFromSubscribed(singleton(tp0));
         state.position(tp0, 0);
     }
 
@@ -233,9 +257,7 @@ public void cantSubscribePatternAndPartition() {
     public void patternSubscription() {
         state.subscribe(Pattern.compile(".*"), rebalanceListener);
         state.subscribeFromPattern(new HashSet<>(Arrays.asList(topic, topic1)));
-
-        assertEquals(
-                "Expected subscribed topics count is incorrect", 2, state.subscription().size());
+        assertEquals("Expected subscribed topics count is incorrect", 2, state.subscription().size());
     }
 
     @Test
@@ -258,7 +280,7 @@ public void unsubscribeUserSubscribe() {
     public void unsubscription() {
         state.subscribe(Pattern.compile(".*"), rebalanceListener);
         state.subscribeFromPattern(new HashSet<>(Arrays.asList(topic, topic1)));
-        state.assignFromSubscribed(Collections.singletonList(tp1));
+        state.assignFromSubscribed(singleton(tp1));
         assertEquals(singleton(tp1), state.assignedPartitions());
 
         state.unsubscribe();
diff --git a/core/src/test/scala/integration/kafka/api/BaseConsumerTest.scala b/core/src/test/scala/integration/kafka/api/BaseConsumerTest.scala
index 4bc1678d589d5..802bab89233f6 100644
--- a/core/src/test/scala/integration/kafka/api/BaseConsumerTest.scala
+++ b/core/src/test/scala/integration/kafka/api/BaseConsumerTest.scala
@@ -13,13 +13,12 @@
 package kafka.api
 
 import java.util
-import java.util.Collections
 
 import org.apache.kafka.clients.consumer._
 import org.apache.kafka.clients.producer.{ProducerConfig, ProducerRecord}
 import org.apache.kafka.common.record.TimestampType
 import org.apache.kafka.common.serialization.ByteArrayDeserializer
-import org.apache.kafka.common.{MetricName, PartitionInfo, TopicPartition}
+import org.apache.kafka.common.{PartitionInfo, TopicPartition}
 import kafka.utils.{Logging, ShutdownableThread, TestUtils}
 import kafka.common.Topic
 import kafka.server.KafkaConfig
@@ -118,104 +117,6 @@ abstract class BaseConsumerTest extends IntegrationTestHarness with Logging {
     assertEquals(1, listener.callsToRevoked)
   }
 
-  @Test
-  def testPerPartitionLagMetricsCleanUpWithSubscribe() {
-    val numMessages = 1000
-    val topic2 = "topic2"
-    TestUtils.createTopic(this.zkUtils, topic2, 2, serverCount, this.servers)
-    // send some messages.
-    sendRecords(numMessages, tp)
-    // Test subscribe
-    // Create a consumer and consumer some messages.
-    consumerConfig.setProperty(ConsumerConfig.GROUP_ID_CONFIG, "testPerPartitionLagMetricsCleanUpWithSubscribe")
-    consumerConfig.setProperty(ConsumerConfig.CLIENT_ID_CONFIG, "testPerPartitionLagMetricsCleanUpWithSubscribe")
-    val consumer = new KafkaConsumer(this.consumerConfig, new ByteArrayDeserializer(), new ByteArrayDeserializer())
-    try {
-      val listener0 = new TestConsumerReassignmentListener
-      consumer.subscribe(List(topic, topic2).asJava, listener0)
-      var records: ConsumerRecords[Array[Byte], Array[Byte]] = ConsumerRecords.empty()
-      TestUtils.waitUntilTrue(() => {
-          records = consumer.poll(100)
-          !records.records(tp).isEmpty
-        }, "Consumer did not consume any message before timeout.")
-      assertEquals("should be assigned once", 1, listener0.callsToAssigned)
-      // Verify the metric exist.
-      val tags = Collections.singletonMap("client-id", "testPerPartitionLagMetricsCleanUpWithSubscribe")
-      val fetchLag0 = consumer.metrics.get(new MetricName(tp + ".records-lag", "consumer-fetch-manager-metrics", "", tags))
-      assertNotNull(fetchLag0)
-      val expectedLag = numMessages - records.count
-      assertEquals(s"The lag should be $expectedLag", expectedLag, fetchLag0.value, epsilon)
-
-      // Remove topic from subscription
-      consumer.subscribe(List(topic2).asJava, listener0)
-      TestUtils.waitUntilTrue(() => {
-        consumer.poll(100)
-        listener0.callsToAssigned >= 2
-      }, "Expected rebalance did not occur.")
-      // Verify the metric has gone
-      assertNull(consumer.metrics.get(new MetricName(tp + ".records-lag", "consumer-fetch-manager-metrics", "", tags)))
-      assertNull(consumer.metrics.get(new MetricName(tp2 + ".records-lag", "consumer-fetch-manager-metrics", "", tags)))
-    } finally {
-      consumer.close()
-    }
-  }
-
-  @Test
-  def testPerPartitionLagMetricsCleanUpWithAssign() {
-    val numMessages = 1000
-    // Test assign
-    // send some messages.
-    sendRecords(numMessages, tp)
-    sendRecords(numMessages, tp2)
-    consumerConfig.setProperty(ConsumerConfig.GROUP_ID_CONFIG, "testPerPartitionLagMetricsCleanUpWithAssign")
-    consumerConfig.setProperty(ConsumerConfig.CLIENT_ID_CONFIG, "testPerPartitionLagMetricsCleanUpWithAssign")
-    val consumer = new KafkaConsumer(this.consumerConfig, new ByteArrayDeserializer(), new ByteArrayDeserializer())
-    try {
-      consumer.assign(List(tp).asJava)
-      var records: ConsumerRecords[Array[Byte], Array[Byte]] = ConsumerRecords.empty()
-      TestUtils.waitUntilTrue(() => {
-          records = consumer.poll(100)
-          !records.records(tp).isEmpty
-        }, "Consumer did not consume any message before timeout.")
-      // Verify the metric exist.
-      val tags = Collections.singletonMap("client-id", "testPerPartitionLagMetricsCleanUpWithAssign")
-      val fetchLag = consumer.metrics.get(new MetricName(tp + ".records-lag", "consumer-fetch-manager-metrics", "", tags))
-      assertNotNull(fetchLag)
-      val expectedLag = numMessages - records.count
-      assertEquals(s"The lag should be $expectedLag", expectedLag, fetchLag.value, epsilon)
-
-      consumer.assign(List(tp2).asJava)
-      TestUtils.waitUntilTrue(() => !consumer.poll(100).isEmpty, "Consumer did not consume any message before timeout.")
-      assertNull(consumer.metrics.get(new MetricName(tp + ".records-lag", "consumer-fetch-manager-metrics", "", tags)))
-    } finally {
-      consumer.close()
-    }
-  }
-
-  @Test
-  def testPerPartitionLagWithMaxPollRecords() {
-    val numMessages = 1000
-    val maxPollRecords = 10
-    sendRecords(numMessages, tp)
-    consumerConfig.setProperty(ConsumerConfig.GROUP_ID_CONFIG, "testPerPartitionLagWithMaxPollRecords")
-    consumerConfig.setProperty(ConsumerConfig.CLIENT_ID_CONFIG, "testPerPartitionLagWithMaxPollRecords")
-    consumerConfig.setProperty(ConsumerConfig.MAX_POLL_RECORDS_CONFIG, maxPollRecords.toString)
-    val consumer = new KafkaConsumer(this.consumerConfig, new ByteArrayDeserializer(), new ByteArrayDeserializer())
-    consumer.assign(List(tp).asJava)
-    try {
-      var records: ConsumerRecords[Array[Byte], Array[Byte]] = ConsumerRecords.empty()
-      TestUtils.waitUntilTrue(() => {
-          records = consumer.poll(100)
-          !records.isEmpty
-        }, "Consumer did not consume any message before timeout.")
-      val tags = Collections.singletonMap("client-id", "testPerPartitionLagWithMaxPollRecords")
-      val lag = consumer.metrics.get(new MetricName(tp + ".records-lag", "consumer-fetch-manager-metrics", "", tags))
-      assertEquals(s"The lag should be ${numMessages - records.count}", numMessages - records.count, lag.value, epsilon)
-    } finally {
-      consumer.close()
-    }
-  }
-
   protected class TestConsumerReassignmentListener extends ConsumerRebalanceListener {
     var callsToAssigned = 0
     var callsToRevoked = 0
diff --git a/core/src/test/scala/integration/kafka/api/PlaintextConsumerTest.scala b/core/src/test/scala/integration/kafka/api/PlaintextConsumerTest.scala
index 282d67cf5c741..4fa14621dd634 100644
--- a/core/src/test/scala/integration/kafka/api/PlaintextConsumerTest.scala
+++ b/core/src/test/scala/integration/kafka/api/PlaintextConsumerTest.scala
@@ -12,7 +12,6 @@
   */
 package kafka.api
 
-
 import java.util
 import java.util.regex.Pattern
 import java.util.{Collections, Locale, Properties}
@@ -22,7 +21,7 @@ import kafka.server.KafkaConfig
 import kafka.utils.TestUtils
 import org.apache.kafka.clients.consumer._
 import org.apache.kafka.clients.producer.{KafkaProducer, ProducerConfig, ProducerRecord}
-import org.apache.kafka.common.TopicPartition
+import org.apache.kafka.common.{MetricName, TopicPartition}
 import org.apache.kafka.common.errors.InvalidTopicException
 import org.apache.kafka.common.record.{CompressionType, TimestampType}
 import org.apache.kafka.common.serialization.{ByteArrayDeserializer, ByteArraySerializer, StringDeserializer, StringSerializer}
@@ -1230,6 +1229,105 @@ class PlaintextConsumerTest extends BaseConsumerTest {
     assertEquals(500, consumer0.committed(tp2).offset)
   }
 
+
+  @Test
+  def testPerPartitionLagMetricsCleanUpWithSubscribe() {
+    val numMessages = 1000
+    val topic2 = "topic2"
+    TestUtils.createTopic(this.zkUtils, topic2, 2, serverCount, this.servers)
+    // send some messages.
+    sendRecords(numMessages, tp)
+    // Test subscribe
+    // Create a consumer and consumer some messages.
+    consumerConfig.setProperty(ConsumerConfig.GROUP_ID_CONFIG, "testPerPartitionLagMetricsCleanUpWithSubscribe")
+    consumerConfig.setProperty(ConsumerConfig.CLIENT_ID_CONFIG, "testPerPartitionLagMetricsCleanUpWithSubscribe")
+    val consumer = new KafkaConsumer(this.consumerConfig, new ByteArrayDeserializer(), new ByteArrayDeserializer())
+    try {
+      val listener0 = new TestConsumerReassignmentListener
+      consumer.subscribe(List(topic, topic2).asJava, listener0)
+      var records: ConsumerRecords[Array[Byte], Array[Byte]] = ConsumerRecords.empty()
+      TestUtils.waitUntilTrue(() => {
+        records = consumer.poll(100)
+        !records.records(tp).isEmpty
+      }, "Consumer did not consume any message before timeout.")
+      assertEquals("should be assigned once", 1, listener0.callsToAssigned)
+      // Verify the metric exist.
+      val tags = Collections.singletonMap("client-id", "testPerPartitionLagMetricsCleanUpWithSubscribe")
+      val fetchLag0 = consumer.metrics.get(new MetricName(tp + ".records-lag", "consumer-fetch-manager-metrics", "", tags))
+      assertNotNull(fetchLag0)
+      val expectedLag = numMessages - records.count
+      assertEquals(s"The lag should be $expectedLag", expectedLag, fetchLag0.value, epsilon)
+
+      // Remove topic from subscription
+      consumer.subscribe(List(topic2).asJava, listener0)
+      TestUtils.waitUntilTrue(() => {
+        consumer.poll(100)
+        listener0.callsToAssigned >= 2
+      }, "Expected rebalance did not occur.")
+      // Verify the metric has gone
+      assertNull(consumer.metrics.get(new MetricName(tp + ".records-lag", "consumer-fetch-manager-metrics", "", tags)))
+      assertNull(consumer.metrics.get(new MetricName(tp2 + ".records-lag", "consumer-fetch-manager-metrics", "", tags)))
+    } finally {
+      consumer.close()
+    }
+  }
+
+  @Test
+  def testPerPartitionLagMetricsCleanUpWithAssign() {
+    val numMessages = 1000
+    // Test assign
+    // send some messages.
+    sendRecords(numMessages, tp)
+    sendRecords(numMessages, tp2)
+    consumerConfig.setProperty(ConsumerConfig.GROUP_ID_CONFIG, "testPerPartitionLagMetricsCleanUpWithAssign")
+    consumerConfig.setProperty(ConsumerConfig.CLIENT_ID_CONFIG, "testPerPartitionLagMetricsCleanUpWithAssign")
+    val consumer = new KafkaConsumer(this.consumerConfig, new ByteArrayDeserializer(), new ByteArrayDeserializer())
+    try {
+      consumer.assign(List(tp).asJava)
+      var records: ConsumerRecords[Array[Byte], Array[Byte]] = ConsumerRecords.empty()
+      TestUtils.waitUntilTrue(() => {
+        records = consumer.poll(100)
+        !records.records(tp).isEmpty
+      }, "Consumer did not consume any message before timeout.")
+      // Verify the metric exist.
+      val tags = Collections.singletonMap("client-id", "testPerPartitionLagMetricsCleanUpWithAssign")
+      val fetchLag = consumer.metrics.get(new MetricName(tp + ".records-lag", "consumer-fetch-manager-metrics", "", tags))
+      assertNotNull(fetchLag)
+      val expectedLag = numMessages - records.count
+      assertEquals(s"The lag should be $expectedLag", expectedLag, fetchLag.value, epsilon)
+
+      consumer.assign(List(tp2).asJava)
+      TestUtils.waitUntilTrue(() => !consumer.poll(100).isEmpty, "Consumer did not consume any message before timeout.")
+      assertNull(consumer.metrics.get(new MetricName(tp + ".records-lag", "consumer-fetch-manager-metrics", "", tags)))
+    } finally {
+      consumer.close()
+    }
+  }
+
+  @Test
+  def testPerPartitionLagWithMaxPollRecords() {
+    val numMessages = 1000
+    val maxPollRecords = 10
+    sendRecords(numMessages, tp)
+    consumerConfig.setProperty(ConsumerConfig.GROUP_ID_CONFIG, "testPerPartitionLagWithMaxPollRecords")
+    consumerConfig.setProperty(ConsumerConfig.CLIENT_ID_CONFIG, "testPerPartitionLagWithMaxPollRecords")
+    consumerConfig.setProperty(ConsumerConfig.MAX_POLL_RECORDS_CONFIG, maxPollRecords.toString)
+    val consumer = new KafkaConsumer(this.consumerConfig, new ByteArrayDeserializer(), new ByteArrayDeserializer())
+    consumer.assign(List(tp).asJava)
+    try {
+      var records: ConsumerRecords[Array[Byte], Array[Byte]] = ConsumerRecords.empty()
+      TestUtils.waitUntilTrue(() => {
+        records = consumer.poll(100)
+        !records.isEmpty
+      }, "Consumer did not consume any message before timeout.")
+      val tags = Collections.singletonMap("client-id", "testPerPartitionLagWithMaxPollRecords")
+      val lag = consumer.metrics.get(new MetricName(tp + ".records-lag", "consumer-fetch-manager-metrics", "", tags))
+      assertEquals(s"The lag should be ${numMessages - records.count}", numMessages - records.count, lag.value, epsilon)
+    } finally {
+      consumer.close()
+    }
+  }
+
   def runMultiConsumerSessionTimeoutTest(closeConsumer: Boolean): Unit = {
     // use consumers defined in this class plus one additional consumer
     // Use topic defined in this class + one additional topic

From 8812d151a9cb7d3a71fdb7c170a661ebf5214358 Mon Sep 17 00:00:00 2001
From: "Colin P. Mccabe" <cmccabe@confluent.io>
Date: Thu, 26 Jan 2017 09:24:17 +0000
Subject: [PATCH 054/177] KAFKA-4630; Implement RecordTooLargeException when
 communicating with pre-KIP-74 brokers

Author: Colin P. Mccabe <cmccabe@confluent.io>

Reviewers: Jason Gustafson <jason@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2390 from cmccabe/KAFKA-4630

(cherry picked from commit 5b4e299a46a8ee92e450c54880408713606e4f52)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../apache/kafka/clients/NodeApiVersions.java | 37 +++++++++
 .../clients/consumer/internals/Fetcher.java   | 82 ++++++++++---------
 .../kafka/common/requests/FetchRequest.java   |  1 +
 .../kafka/common/requests/FetchResponse.java  |  6 ++
 .../org/apache/kafka/clients/MockClient.java  |  7 +-
 .../kafka/clients/NodeApiVersionsTest.java    |  3 +-
 .../consumer/internals/FetcherTest.java       | 58 +++++++++++++
 .../admin/BrokerApiVersionsCommandTest.scala  |  2 +-
 .../client_compatibility_features_test.py     |  4 +
 .../kafka/tools/ClientCompatibilityTest.java  | 62 +++++++++-----
 10 files changed, 198 insertions(+), 64 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java b/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java
index b90009bd57dbe..1c5d8fb37c041 100644
--- a/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java
+++ b/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java
@@ -19,7 +19,10 @@
 import org.apache.kafka.common.utils.Utils;
 
 import java.util.Collection;
+import java.util.Collections;
 import java.util.EnumMap;
+import java.util.LinkedList;
+import java.util.List;
 import java.util.Map;
 import java.util.NoSuchElementException;
 import java.util.TreeMap;
@@ -30,6 +33,40 @@ public class NodeApiVersions {
     // An array of the usable versions of each API, indexed by ApiKeys ID.
     private final Map<ApiKeys, Short> usableVersions = new EnumMap<>(ApiKeys.class);
 
+    /**
+     * Create a NodeApiVersions object with the current ApiVersions.
+     *
+     * @return A new NodeApiVersions object.
+     */
+    public static NodeApiVersions create() {
+        return create(Collections.EMPTY_LIST);
+    }
+
+    /**
+     * Create a NodeApiVersions object.
+     *
+     * @param overrides API versions to override. Any ApiVersion not specified here will be set to the current client
+     *                  value.
+     * @return A new NodeApiVersions object.
+     */
+    public static NodeApiVersions create(Collection<ApiVersion> overrides) {
+        List<ApiVersion> apiVersions = new LinkedList<>(overrides);
+        for (ApiKeys apiKey : ApiKeys.values()) {
+            boolean exists = false;
+            for (ApiVersion apiVersion : apiVersions) {
+                if (apiVersion.apiKey == apiKey.id) {
+                    exists = true;
+                    break;
+                }
+            }
+            if (!exists) {
+                apiVersions.add(new ApiVersion(apiKey.id, ProtoUtils.oldestVersion(apiKey.id),
+                    ProtoUtils.latestVersion(apiKey.id)));
+            }
+        }
+        return new NodeApiVersions(apiVersions);
+    }
+
     public NodeApiVersions(Collection<ApiVersion> apiVersions) {
         this.apiVersions = apiVersions;
         for (ApiVersion apiVersion : apiVersions) {
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
index 6bd454ef36dff..af82570a1ab0f 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
@@ -15,6 +15,7 @@
 
 import org.apache.kafka.clients.ClientResponse;
 import org.apache.kafka.clients.Metadata;
+import org.apache.kafka.clients.consumer.ConsumerConfig;
 import org.apache.kafka.clients.consumer.ConsumerRecord;
 import org.apache.kafka.clients.consumer.NoOffsetForPartitionException;
 import org.apache.kafka.clients.consumer.OffsetAndTimestamp;
@@ -27,6 +28,7 @@
 import org.apache.kafka.common.TopicPartition;
 import org.apache.kafka.common.errors.InvalidMetadataException;
 import org.apache.kafka.common.errors.InvalidTopicException;
+import org.apache.kafka.common.errors.RecordTooLargeException;
 import org.apache.kafka.common.errors.RetriableException;
 import org.apache.kafka.common.errors.SerializationException;
 import org.apache.kafka.common.errors.TimeoutException;
@@ -174,7 +176,8 @@ public void onSuccess(ClientResponse resp) {
                                 TopicPartition partition = entry.getKey();
                                 long fetchOffset = request.fetchData().get(partition).offset;
                                 FetchResponse.PartitionData fetchData = entry.getValue();
-                                completedFetches.add(new CompletedFetch(partition, fetchOffset, fetchData, metricAggregator));
+                                completedFetches.add(new CompletedFetch(partition, fetchOffset, fetchData, metricAggregator,
+                                        request.version()));
                             }
 
                             sensors.fetchLatency.record(resp.requestLatencyMs());
@@ -334,44 +337,24 @@ private RequestFuture<ClientResponse> sendMetadataRequest(MetadataRequest.Builde
     private void resetOffset(TopicPartition partition) {
         OffsetResetStrategy strategy = subscriptions.resetStrategy(partition);
         log.debug("Resetting offset for partition {} to {} offset.", partition, strategy.name().toLowerCase(Locale.ROOT));
-        long offset = listOffset(partition, strategy);
+        final long timestamp;
+        if (strategy == OffsetResetStrategy.EARLIEST)
+            timestamp = ListOffsetRequest.EARLIEST_TIMESTAMP;
+        else if (strategy == OffsetResetStrategy.LATEST)
+            timestamp = ListOffsetRequest.LATEST_TIMESTAMP;
+        else
+            throw new NoOffsetForPartitionException(partition);
+        Map<TopicPartition, OffsetAndTimestamp> offsetsByTimes = retrieveOffsetsByTimes(
+                Collections.singletonMap(partition, timestamp), Long.MAX_VALUE, false);
+        OffsetAndTimestamp offsetAndTimestamp = offsetsByTimes.get(partition);
+        if (offsetAndTimestamp == null)
+            throw new NoOffsetForPartitionException(partition);
+        long offset = offsetAndTimestamp.offset();
         // we might lose the assignment while fetching the offset, so check it is still active
         if (subscriptions.isAssigned(partition))
             this.subscriptions.seek(partition, offset);
     }
 
-    private long listOffset(TopicPartition partition, OffsetResetStrategy strategy) {
-        final long timestamp;
-        switch (strategy) {
-            case EARLIEST:
-                timestamp = ListOffsetRequest.EARLIEST_TIMESTAMP;
-                break;
-            case LATEST:
-                timestamp = ListOffsetRequest.LATEST_TIMESTAMP;
-                break;
-            default:
-                throw new NoOffsetForPartitionException(partition);
-        }
-        while (true) {
-            RequestFuture<Map<TopicPartition, OffsetAndTimestamp>> future =
-                    sendListOffsetRequests(false, Collections.singletonMap(partition, timestamp));
-            client.poll(future);
-            if (future.succeeded()) {
-                OffsetAndTimestamp offsetAndTimestamp = future.value().get(partition);
-                if (offsetAndTimestamp == null)
-                    throw new NoOffsetForPartitionException(partition);
-                return offsetAndTimestamp.offset();
-            }
-            if (!future.isRetriable())
-                throw future.exception();
-            if (future.exception() instanceof InvalidMetadataException)
-                client.awaitMetadataUpdate();
-            else
-                time.sleep(retryBackoffMs);
-        }
-    }
-
-
     public Map<TopicPartition, OffsetAndTimestamp> getOffsetsByTimes(Map<TopicPartition, Long> timestampsToSearch,
                                                                      long timeout) {
         return retrieveOffsetsByTimes(timestampsToSearch, timeout, true);
@@ -636,7 +619,7 @@ private void handleListOffsetResponse(Map<TopicPartition, Long> timestampsToSear
                     } else {
                         offset = partitionData.offsets.get(0);
                     }
-                    log.debug("Handling v0 ListOffsetResponse response for {}.  Fetched offset {}",
+                    log.debug("Handling v0 ListOffsetResponse response for {}. Fetched offset {}",
                             topicPartition, offset);
                     if (offset != ListOffsetResponse.UNKNOWN_OFFSET) {
                         OffsetAndTimestamp offsetAndTimestamp = new OffsetAndTimestamp(offset, -1);
@@ -644,7 +627,7 @@ private void handleListOffsetResponse(Map<TopicPartition, Long> timestampsToSear
                     }
                 } else {
                     // Handle v1 and later response
-                    log.debug("Handling ListOffsetResponse response for {}.  Fetched offset {}, timestamp {}",
+                    log.debug("Handling ListOffsetResponse response for {}. Fetched offset {}, timestamp {}",
                             topicPartition, partitionData.offset, partitionData.timestamp);
                     if (partitionData.offset != ListOffsetResponse.UNKNOWN_OFFSET) {
                         OffsetAndTimestamp offsetAndTimestamp =
@@ -754,12 +737,14 @@ private PartitionRecords<K, V> parseCompletedFetch(CompletedFetch completedFetch
                 }
 
                 List<ConsumerRecord<K, V>> parsed = new ArrayList<>();
+                boolean skippedRecords = false;
                 for (LogEntry logEntry : partition.records.deepEntries()) {
                     // Skip the messages earlier than current position.
                     if (logEntry.offset() >= position) {
                         parsed.add(parseRecord(tp, logEntry));
                         bytes += logEntry.sizeInBytes();
-                    }
+                    } else
+                        skippedRecords = true;
                 }
 
                 recordsCount = parsed.size();
@@ -767,6 +752,24 @@ private PartitionRecords<K, V> parseCompletedFetch(CompletedFetch completedFetch
                 log.trace("Adding fetched record for partition {} with offset {} to buffered record list", tp, position);
                 parsedRecords = new PartitionRecords<>(fetchOffset, tp, parsed);
 
+                if (parsed.isEmpty() && !skippedRecords && (partition.records.sizeInBytes() > 0)) {
+                    if (completedFetch.responseVersion < 3) {
+                        // Implement the pre KIP-74 behavior of throwing a RecordTooLargeException.
+                        Map<TopicPartition, Long> recordTooLargePartitions = Collections.singletonMap(tp, fetchOffset);
+                        throw new RecordTooLargeException("There are some messages at [Partition=Offset]: " +
+                                recordTooLargePartitions + " whose size is larger than the fetch size " + this.fetchSize +
+                                " and hence cannot be returned. Please considering upgrading your broker to 0.10.1.0 or " +
+                                "newer to avoid this issue. Alternately, increase the fetch size on the client (using " +
+                                ConsumerConfig.MAX_PARTITION_FETCH_BYTES_CONFIG + ")",
+                                recordTooLargePartitions);
+                    } else {
+                        // This should not happen with brokers that support FetchRequest/Response V3 or higher (i.e. KIP-74)
+                        throw new KafkaException("Failed to make progress reading messages at " + tp + "=" +
+                            fetchOffset + ". Received a non-empty fetch response from the server, but no " +
+                            "complete records were found.");
+                    }
+                }
+
                 if (partition.highWatermark >= 0) {
                     log.trace("Received {} records in fetch response for partition {} with offset {}", parsed.size(), tp, position);
                     subscriptions.updateHighWatermark(tp, partition.highWatermark);
@@ -894,15 +897,18 @@ private static class CompletedFetch {
         private final long fetchedOffset;
         private final FetchResponse.PartitionData partitionData;
         private final FetchResponseMetricAggregator metricAggregator;
+        private final short responseVersion;
 
         private CompletedFetch(TopicPartition partition,
                                long fetchedOffset,
                                FetchResponse.PartitionData partitionData,
-                               FetchResponseMetricAggregator metricAggregator) {
+                               FetchResponseMetricAggregator metricAggregator,
+                               short responseVersion) {
             this.partition = partition;
             this.fetchedOffset = fetchedOffset;
             this.partitionData = partitionData;
             this.metricAggregator = metricAggregator;
+            this.responseVersion = responseVersion;
         }
     }
 
diff --git a/clients/src/main/java/org/apache/kafka/common/requests/FetchRequest.java b/clients/src/main/java/org/apache/kafka/common/requests/FetchRequest.java
index 4768a205e8f56..5700e9e184996 100644
--- a/clients/src/main/java/org/apache/kafka/common/requests/FetchRequest.java
+++ b/clients/src/main/java/org/apache/kafka/common/requests/FetchRequest.java
@@ -142,6 +142,7 @@ public String toString() {
                     append(", replicaId=").append(replicaId).
                     append(", maxWait=").append(maxWait).
                     append(", minBytes=").append(minBytes).
+                    append(", maxBytes=").append(maxBytes).
                     append(", fetchData=").append(Utils.mkString(fetchData)).
                     append(")");
             return bld.toString();
diff --git a/clients/src/main/java/org/apache/kafka/common/requests/FetchResponse.java b/clients/src/main/java/org/apache/kafka/common/requests/FetchResponse.java
index 66b01a0d39dbf..965b2073cfbf6 100644
--- a/clients/src/main/java/org/apache/kafka/common/requests/FetchResponse.java
+++ b/clients/src/main/java/org/apache/kafka/common/requests/FetchResponse.java
@@ -82,6 +82,12 @@ public PartitionData(short errorCode, long highWatermark, Records records) {
             this.highWatermark = highWatermark;
             this.records = records;
         }
+
+        @Override
+        public String toString() {
+            return "(errorCode=" + errorCode + ", highWaterMark=" + highWatermark +
+                    ", records=" + records + ")";
+        }
     }
 
     /**
diff --git a/clients/src/test/java/org/apache/kafka/clients/MockClient.java b/clients/src/test/java/org/apache/kafka/clients/MockClient.java
index bfde9f95b250f..50ed1319cdac3 100644
--- a/clients/src/test/java/org/apache/kafka/clients/MockClient.java
+++ b/clients/src/test/java/org/apache/kafka/clients/MockClient.java
@@ -73,6 +73,7 @@ public FutureResponse(AbstractResponse responseBody, boolean disconnected, Reque
     private final Queue<ClientResponse> responses = new ConcurrentLinkedDeque<>();
     private final Queue<FutureResponse> futureResponses = new ArrayDeque<>();
     private final Queue<Cluster> metadataUpdates = new ArrayDeque<>();
+    private volatile NodeApiVersions nodeApiVersions = NodeApiVersions.create();
 
     public MockClient(Time time) {
         this.time = time;
@@ -145,7 +146,8 @@ public void send(ClientRequest request, long now) {
             FutureResponse futureResp = iterator.next();
             if (futureResp.node != null && !request.destination().equals(futureResp.node.idString()))
                 continue;
-
+            request.requestBuilder().setVersion(nodeApiVersions.usableVersion(
+                    request.requestBuilder().apiKey()));
             AbstractRequest abstractRequest = request.requestBuilder().build();
             if (!futureResp.requestMatcher.matches(abstractRequest))
                 throw new IllegalStateException("Next in line response did not match expected request");
@@ -334,4 +336,7 @@ public interface RequestMatcher {
         boolean matches(AbstractRequest body);
     }
 
+    public void setNodeApiVersions(NodeApiVersions nodeApiVersions) {
+        this.nodeApiVersions = nodeApiVersions;
+    }
 }
diff --git a/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java b/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java
index 861a28f01f958..f72137bd4be64 100644
--- a/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java
@@ -33,8 +33,7 @@ public class NodeApiVersionsTest {
 
     @Test
     public void testUnsupportedVersionsToString() {
-        NodeApiVersions versions = new NodeApiVersions(
-                Collections.<ApiVersion>emptyList());
+        NodeApiVersions versions = new NodeApiVersions(Collections.<ApiVersion>emptyList());
         StringBuilder bld = new StringBuilder();
         String prefix = "(";
         for (ApiKeys apiKey : ApiKeys.values()) {
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java
index 210af6dbcde57..ecaade25085cf 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java
@@ -18,6 +18,7 @@
 
 import org.apache.kafka.clients.Metadata;
 import org.apache.kafka.clients.MockClient;
+import org.apache.kafka.clients.NodeApiVersions;
 import org.apache.kafka.clients.consumer.ConsumerRebalanceListener;
 import org.apache.kafka.clients.consumer.ConsumerRecord;
 import org.apache.kafka.clients.consumer.OffsetAndMetadata;
@@ -31,11 +32,13 @@
 import org.apache.kafka.common.PartitionInfo;
 import org.apache.kafka.common.TopicPartition;
 import org.apache.kafka.common.errors.InvalidTopicException;
+import org.apache.kafka.common.errors.RecordTooLargeException;
 import org.apache.kafka.common.errors.SerializationException;
 import org.apache.kafka.common.errors.TimeoutException;
 import org.apache.kafka.common.errors.TopicAuthorizationException;
 import org.apache.kafka.common.metrics.KafkaMetric;
 import org.apache.kafka.common.metrics.Metrics;
+import org.apache.kafka.common.protocol.ApiKeys;
 import org.apache.kafka.common.protocol.Errors;
 import org.apache.kafka.common.record.ByteBufferOutputStream;
 import org.apache.kafka.common.record.CompressionType;
@@ -44,6 +47,7 @@
 import org.apache.kafka.common.record.Record;
 import org.apache.kafka.common.record.TimestampType;
 import org.apache.kafka.common.requests.AbstractRequest;
+import org.apache.kafka.common.requests.ApiVersionsResponse;
 import org.apache.kafka.common.requests.FetchRequest;
 import org.apache.kafka.common.requests.FetchResponse;
 import org.apache.kafka.common.requests.ListOffsetRequest;
@@ -316,6 +320,60 @@ public void testFetchNonContinuousRecords() {
         assertEquals(30L, consumerRecords.get(2).offset());
     }
 
+    /**
+     * Test the case where the client makes a pre-v3 FetchRequest, but the server replies with only a partial
+     * request. This happens when a single message is larger than the per-partition limit.
+     */
+    @Test
+    public void testFetchRequestWhenRecordTooLarge() {
+        try {
+            client.setNodeApiVersions(NodeApiVersions.create(Collections.singletonList(
+                new ApiVersionsResponse.ApiVersion(ApiKeys.FETCH.id, (short) 2, (short) 2))));
+            makeFetchRequestWithIncompleteRecord();
+            try {
+                fetcher.fetchedRecords();
+                fail("RecordTooLargeException should have been raised");
+            } catch (RecordTooLargeException e) {
+                assertTrue(e.getMessage().startsWith("There are some messages at [Partition=Offset]: "));
+                // the position should not advance since no data has been returned
+                assertEquals(0, subscriptions.position(tp).longValue());
+            }
+        } finally {
+            client.setNodeApiVersions(NodeApiVersions.create());
+        }
+    }
+
+    /**
+     * Test the case where the client makes a post KIP-74 FetchRequest, but the server replies with only a
+     * partial request. For v3 and later FetchRequests, the implementation of KIP-74 changed the behavior
+     * so that at least one message is always returned. Therefore, this case should not happen, and it indicates
+     * that an internal error has taken place.
+     */
+    @Test
+    public void testFetchRequestInternalError() {
+        makeFetchRequestWithIncompleteRecord();
+        try {
+            fetcher.fetchedRecords();
+            fail("RecordTooLargeException should have been raised");
+        } catch (KafkaException e) {
+            assertTrue(e.getMessage().startsWith("Failed to make progress reading messages"));
+            // the position should not advance since no data has been returned
+            assertEquals(0, subscriptions.position(tp).longValue());
+        }
+    }
+
+    private void makeFetchRequestWithIncompleteRecord() {
+        subscriptions.assignFromUser(singleton(tp));
+        subscriptions.seek(tp, 0);
+        assertEquals(1, fetcher.sendFetches());
+        assertFalse(fetcher.hasCompletedFetches());
+        MemoryRecords partialRecord = MemoryRecords.readableRecords(
+            ByteBuffer.wrap(new byte[]{0, 0, 0, 0, 0, 0, 0, 0}));
+        client.prepareResponse(fetchResponse(partialRecord, Errors.NONE.code(), 100L, 0));
+        consumerClient.poll(0);
+        assertTrue(fetcher.hasCompletedFetches());
+    }
+
     @Test
     public void testUnauthorizedTopic() {
         subscriptions.assignFromUser(singleton(tp));
diff --git a/core/src/test/scala/integration/kafka/admin/BrokerApiVersionsCommandTest.scala b/core/src/test/scala/integration/kafka/admin/BrokerApiVersionsCommandTest.scala
index ff93f22c11f25..8fa489d3fa331 100644
--- a/core/src/test/scala/integration/kafka/admin/BrokerApiVersionsCommandTest.scala
+++ b/core/src/test/scala/integration/kafka/admin/BrokerApiVersionsCommandTest.scala
@@ -42,7 +42,7 @@ class BrokerApiVersionsCommandTest extends KafkaServerTestHarness {
     val lineIter = content.split("\n").iterator
     assertTrue(lineIter.hasNext)
     assertEquals(s"$brokerList (id: 0 rack: null) -> (", lineIter.next)
-    val nodeApiVersions = new NodeApiVersions(ApiVersionsResponse.API_VERSIONS_RESPONSE.apiVersions)
+    val nodeApiVersions = NodeApiVersions.create
     for (apiKey <- ApiKeys.values) {
       val apiVersion = nodeApiVersions.apiVersion(apiKey)
       val versionRangeStr =
diff --git a/tests/kafkatest/tests/client/client_compatibility_features_test.py b/tests/kafkatest/tests/client/client_compatibility_features_test.py
index 3c96b84f37e5e..36d76b4b06726 100644
--- a/tests/kafkatest/tests/client/client_compatibility_features_test.py
+++ b/tests/kafkatest/tests/client/client_compatibility_features_test.py
@@ -30,9 +30,11 @@ def get_broker_features(broker_version):
     if (broker_version < V_0_10_1_0):
         features["offsets-for-times-supported"] = False
         features["cluster-id-supported"] = False
+        features["expect-record-too-large-exception"] = True
     else:
         features["offsets-for-times-supported"] = True
         features["cluster-id-supported"] = True
+        features["expect-record-too-large-exception"] = False
     return features
 
 def run_command(node, cmd, ssh_log_file):
@@ -74,10 +76,12 @@ def invoke_compatibility_program(self, features):
                "--bootstrap-server %s "
                "--offsets-for-times-supported %s "
                "--cluster-id-supported %s "
+               "--expect-record-too-large-exception %s "
                "--topic %s " % (self.zk.path.script("kafka-run-class.sh", node),
                                self.kafka.bootstrap_servers(),
                                features["offsets-for-times-supported"],
                                features["cluster-id-supported"],
+                               features["expect-record-too-large-exception"],
                                self.topics.keys()[0]))
         results_dir = TestContext.results_dir(self.test_context, 0)
         os.makedirs(results_dir)
diff --git a/tools/src/main/java/org/apache/kafka/tools/ClientCompatibilityTest.java b/tools/src/main/java/org/apache/kafka/tools/ClientCompatibilityTest.java
index 69202a06feafe..d7eb717b7227f 100644
--- a/tools/src/main/java/org/apache/kafka/tools/ClientCompatibilityTest.java
+++ b/tools/src/main/java/org/apache/kafka/tools/ClientCompatibilityTest.java
@@ -22,6 +22,7 @@
 import net.sourceforge.argparse4j.inf.ArgumentParser;
 import net.sourceforge.argparse4j.inf.ArgumentParserException;
 import net.sourceforge.argparse4j.inf.Namespace;
+import org.apache.kafka.clients.consumer.ConsumerConfig;
 import org.apache.kafka.clients.consumer.ConsumerRecord;
 import org.apache.kafka.clients.consumer.ConsumerRecords;
 import org.apache.kafka.clients.consumer.KafkaConsumer;
@@ -35,6 +36,7 @@
 import org.apache.kafka.common.PartitionInfo;
 import org.apache.kafka.common.TopicPartition;
 import org.apache.kafka.common.errors.ObsoleteBrokerException;
+import org.apache.kafka.common.errors.RecordTooLargeException;
 import org.apache.kafka.common.serialization.ByteArraySerializer;
 import org.apache.kafka.common.serialization.Deserializer;
 import org.apache.kafka.common.utils.Time;
@@ -66,12 +68,14 @@ static class TestConfig {
         final String topic;
         final boolean offsetsForTimesSupported;
         final boolean expectClusterId;
+        final boolean expectRecordTooLargeException;
 
         TestConfig(Namespace res) {
             this.bootstrapServer = res.getString("bootstrapServer");
             this.topic = res.getString("topic");
             this.offsetsForTimesSupported = res.getBoolean("offsetsForTimesSupported");
             this.expectClusterId = res.getBoolean("clusterIdSupported");
+            this.expectRecordTooLargeException = res.getBoolean("expectRecordTooLargeException");
         }
     }
 
@@ -108,6 +112,15 @@ public static void main(String[] args) throws Exception {
             .dest("clusterIdSupported")
             .metavar("CLUSTER_ID_SUPPORTED")
             .help("True if cluster IDs are supported.  False if cluster ID always appears as null.");
+        parser.addArgument("--expect-record-too-large-exception")
+            .action(store())
+            .required(true)
+            .type(Boolean.class)
+            .dest("expectRecordTooLargeException")
+            .metavar("EXPECT_RECORD_TOO_LARGE_EXCEPTION")
+            .help("True if we should expect a RecordTooLargeException when trying to read from a topic " +
+                  "that contains a message that is bigger than " + ConsumerConfig.MAX_PARTITION_FETCH_BYTES_CONFIG +
+                  ".  This is pre-KIP-74 behavior.");
         Namespace res = null;
         try {
             res = parser.parseArgs(args);
@@ -133,19 +146,6 @@ public static void main(String[] args) throws Exception {
         System.exit(0);
     }
 
-    private static byte[] asByteArray(long a) {
-        ByteBuffer buf = ByteBuffer.allocate(8);
-        buf.putLong(a);
-        return buf.array();
-    }
-
-    private static byte[] asByteArray(long a, long b) {
-        ByteBuffer buf = ByteBuffer.allocate(16);
-        buf.putLong(a);
-        buf.putLong(b);
-        return buf.array();
-    }
-
     private static String toHexString(byte[] buf) {
         StringBuilder bld = new StringBuilder();
         for (byte b : buf) {
@@ -169,8 +169,16 @@ private static void compareArrays(byte[] a, byte[] b) {
     ClientCompatibilityTest(TestConfig testConfig) {
         this.testConfig = testConfig;
         long curTime = Time.SYSTEM.milliseconds();
-        this.message1 = asByteArray(curTime);
-        this.message2 = asByteArray(curTime, curTime);
+
+        ByteBuffer buf = ByteBuffer.allocate(8);
+        buf.putLong(curTime);
+        this.message1 = buf.array();
+
+        ByteBuffer buf2 = ByteBuffer.allocate(4096);
+        for (long i = 0; i < buf2.capacity(); i += 8) {
+            buf2.putLong(curTime + i);
+        }
+        this.message2 = buf2.array();
     }
 
     void run() throws Exception {
@@ -242,6 +250,7 @@ public void onUpdate(ClusterResource clusterResource) {
     public void testConsume(final long prodTimeMs) throws Exception {
         Properties consumerProps = new Properties();
         consumerProps.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, testConfig.bootstrapServer);
+        consumerProps.put(ConsumerConfig.MAX_PARTITION_FETCH_BYTES_CONFIG, 512);
         ClientCompatibilityTestDeserializer deserializer =
             new ClientCompatibilityTestDeserializer(testConfig.expectClusterId);
         final KafkaConsumer<byte[], byte[]> consumer = new KafkaConsumer<>(consumerProps, deserializer, deserializer);
@@ -318,7 +327,6 @@ public void remove() {
                 throw new UnsupportedOperationException();
             }
         };
-
         byte[] next = iter.next();
         try {
             compareArrays(message1, next);
@@ -327,13 +335,23 @@ public void remove() {
             throw new RuntimeException("The first message in this topic was not ours. Please use a new topic when " +
                     "running this program.");
         }
-        next = iter.next();
         try {
-            compareArrays(message2, next);
-            log.debug("Found second message...");
-        } catch (RuntimeException e) {
-            throw new RuntimeException("The second message in this topic was not ours. Please use a new topic when " +
-                    "running this program.");
+            next = iter.next();
+            if (testConfig.expectRecordTooLargeException)
+                throw new RuntimeException("Expected to get a RecordTooLargeException when reading a record " +
+                        "bigger than " + ConsumerConfig.MAX_PARTITION_FETCH_BYTES_CONFIG);
+            try {
+                compareArrays(message2, next);
+            } catch (RuntimeException e) {
+                System.out.println("The second message in this topic was not ours. Please use a new " +
+                    "topic when running this program.");
+                System.exit(1);
+            }
+        } catch (RecordTooLargeException e) {
+            log.debug("Got RecordTooLargeException", e);
+            if (!testConfig.expectRecordTooLargeException)
+                throw new RuntimeException("Got an unexpected RecordTooLargeException when reading a record " +
+                    "bigger than " + ConsumerConfig.MAX_PARTITION_FETCH_BYTES_CONFIG);
         }
         log.debug("Closing consumer.");
         consumer.close();

From 29bc8905acea32c8a34b889edb17107132b80037 Mon Sep 17 00:00:00 2001
From: Ismael Juma <ismael@juma.me.uk>
Date: Thu, 26 Jan 2017 09:50:25 -0800
Subject: [PATCH 055/177] KAFKA-4699; Invoke producer callbacks before
 completing the future
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This behaviour was changed in 8b3c6c0, but it caused interceptor
test failures (which rely on callbacks) and since we’re so close to
code freeze, it’s better to be conservative.

Author: Ismael Juma <ismael@juma.me.uk>

Reviewers: Jason Gustafson <jason@confluent.io>

Closes #2440 from ijuma/kafka-4699-callbacks-invoked-before-future-is-completed

(cherry picked from commit 254e3b77d656a610f19efd1124802e073dfda4b8)
Signed-off-by: Jason Gustafson <jason@confluent.io>
---
 .../kafka/clients/producer/MockProducer.java  |  3 ++-
 .../internals/ProduceRequestResult.java       | 14 ++++++++---
 .../producer/internals/RecordBatch.java       |  5 ++--
 .../clients/producer/RecordSendTest.java      |  6 +++--
 .../SourceTaskOffsetCommitterTest.java        |  2 +-
 .../kafka/api/PlaintextConsumerTest.scala     | 24 +++++++++----------
 6 files changed, 33 insertions(+), 21 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/producer/MockProducer.java b/clients/src/main/java/org/apache/kafka/clients/producer/MockProducer.java
index 008ca70b088eb..165437de1085e 100644
--- a/clients/src/main/java/org/apache/kafka/clients/producer/MockProducer.java
+++ b/clients/src/main/java/org/apache/kafka/clients/producer/MockProducer.java
@@ -245,13 +245,14 @@ public Completion(long offset,
         }
 
         public void complete(RuntimeException e) {
-            result.done(e == null ? offset : -1L, Record.NO_TIMESTAMP, e);
+            result.set(e == null ? offset : -1L, Record.NO_TIMESTAMP, e);
             if (callback != null) {
                 if (e == null)
                     callback.onCompletion(metadata, null);
                 else
                     callback.onCompletion(null, e);
             }
+            result.done();
         }
     }
 
diff --git a/clients/src/main/java/org/apache/kafka/clients/producer/internals/ProduceRequestResult.java b/clients/src/main/java/org/apache/kafka/clients/producer/internals/ProduceRequestResult.java
index 41c204d974ea2..a98b28e52728c 100644
--- a/clients/src/main/java/org/apache/kafka/clients/producer/internals/ProduceRequestResult.java
+++ b/clients/src/main/java/org/apache/kafka/clients/producer/internals/ProduceRequestResult.java
@@ -34,7 +34,7 @@ public final class ProduceRequestResult {
     private final CountDownLatch latch = new CountDownLatch(1);
     private final TopicPartition topicPartition;
 
-    private volatile long baseOffset = -1L;
+    private volatile Long baseOffset = null;
     private volatile long logAppendTime = Record.NO_TIMESTAMP;
     private volatile RuntimeException error;
 
@@ -48,16 +48,24 @@ public ProduceRequestResult(TopicPartition topicPartition) {
     }
 
     /**
-     * Mark this request as complete and unblock any threads waiting on its completion.
+     * Set the result of the produce request.
      *
      * @param baseOffset The base offset assigned to the record
      * @param logAppendTime The log append time or -1 if CreateTime is being used
      * @param error The error that occurred if there was one, or null
      */
-    public void done(long baseOffset, long logAppendTime, RuntimeException error) {
+    public void set(long baseOffset, long logAppendTime, RuntimeException error) {
         this.baseOffset = baseOffset;
         this.logAppendTime = logAppendTime;
         this.error = error;
+    }
+
+    /**
+     * Mark this request as complete and unblock any threads waiting on its completion.
+     */
+    public void done() {
+        if (baseOffset == null)
+            throw new IllegalStateException("The method `set` must be invoked before this method.");
         this.latch.countDown();
     }
 
diff --git a/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordBatch.java b/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordBatch.java
index 1b751bf549e20..c8eddd5d93d7a 100644
--- a/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordBatch.java
+++ b/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordBatch.java
@@ -93,8 +93,8 @@ public void done(long baseOffset, long logAppendTime, RuntimeException exception
         log.trace("Produced messages to topic-partition {} with base offset offset {} and error: {}.",
                   topicPartition, baseOffset, exception);
 
-        // Complete the future before invoking the callbacks as we rely on its state for the `onCompletion` call
-        produceFuture.done(baseOffset, logAppendTime, exception);
+        // Set the future before invoking the callbacks as we rely on its state for the `onCompletion` call
+        produceFuture.set(baseOffset, logAppendTime, exception);
 
         // execute callbacks
         for (Thunk thunk : thunks) {
@@ -110,6 +110,7 @@ public void done(long baseOffset, long logAppendTime, RuntimeException exception
             }
         }
 
+        produceFuture.done();
     }
 
     /**
diff --git a/clients/src/test/java/org/apache/kafka/clients/producer/RecordSendTest.java b/clients/src/test/java/org/apache/kafka/clients/producer/RecordSendTest.java
index a420d61eecf80..bc8105bff5b6b 100644
--- a/clients/src/test/java/org/apache/kafka/clients/producer/RecordSendTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/producer/RecordSendTest.java
@@ -54,7 +54,8 @@ public void testTimeout() throws Exception {
         } catch (TimeoutException e) { /* this is good */
         }
 
-        request.done(baseOffset, Record.NO_TIMESTAMP, null);
+        request.set(baseOffset, Record.NO_TIMESTAMP, null);
+        request.done();
         assertTrue(future.isDone());
         assertEquals(baseOffset + relOffset, future.get().offset());
     }
@@ -86,7 +87,8 @@ public ProduceRequestResult asyncRequest(final long baseOffset, final RuntimeExc
             public void run() {
                 try {
                     sleep(timeout);
-                    request.done(baseOffset, Record.NO_TIMESTAMP, error);
+                    request.set(baseOffset, Record.NO_TIMESTAMP, error);
+                    request.done();
                 } catch (InterruptedException e) { }
             }
         };
diff --git a/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/SourceTaskOffsetCommitterTest.java b/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/SourceTaskOffsetCommitterTest.java
index 45125ccfba9c5..d0fa1c878bad6 100644
--- a/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/SourceTaskOffsetCommitterTest.java
+++ b/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/SourceTaskOffsetCommitterTest.java
@@ -165,7 +165,7 @@ public void testRemove() throws Exception {
         EasyMock.expect(task.cancel(eq(false))).andReturn(false);
         EasyMock.expect(task.isDone()).andReturn(false);
         EasyMock.expect(task.get()).andThrow(new CancellationException());
-        mockLog.trace(EasyMock.anyString(), EasyMock.anyObject());
+        mockLog.trace(EasyMock.anyString(), EasyMock.<Object>anyObject());
         PowerMock.expectLastCall();
         PowerMock.replayAll();
 
diff --git a/core/src/test/scala/integration/kafka/api/PlaintextConsumerTest.scala b/core/src/test/scala/integration/kafka/api/PlaintextConsumerTest.scala
index 4fa14621dd634..50941cebeb9b2 100644
--- a/core/src/test/scala/integration/kafka/api/PlaintextConsumerTest.scala
+++ b/core/src/test/scala/integration/kafka/api/PlaintextConsumerTest.scala
@@ -847,28 +847,28 @@ class PlaintextConsumerTest extends BaseConsumerTest {
     producerProps.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, brokerList)
     producerProps.put(ProducerConfig.INTERCEPTOR_CLASSES_CONFIG, "org.apache.kafka.test.MockProducerInterceptor")
     producerProps.put("mock.interceptor.append", appendStr)
-    val testProducer = new KafkaProducer[String, String](producerProps, new StringSerializer, new StringSerializer)
+    val testProducer = new KafkaProducer(producerProps, new StringSerializer, new StringSerializer)
 
     // produce records
     val numRecords = 10
     (0 until numRecords).map { i =>
-      testProducer.send(new ProducerRecord(tp.topic(), tp.partition(), s"key $i", s"value $i"))
+      testProducer.send(new ProducerRecord(tp.topic, tp.partition, s"key $i", s"value $i"))
     }.foreach(_.get)
-    assertEquals(numRecords, MockProducerInterceptor.ONSEND_COUNT.intValue())
-    assertEquals(numRecords, MockProducerInterceptor.ON_SUCCESS_COUNT.intValue())
+    assertEquals(numRecords, MockProducerInterceptor.ONSEND_COUNT.intValue)
+    assertEquals(numRecords, MockProducerInterceptor.ON_SUCCESS_COUNT.intValue)
     // send invalid record
     try {
-      testProducer.send(null, null)
+      testProducer.send(null)
       fail("Should not allow sending a null record")
     } catch {
       case _: Throwable =>
-        assertEquals("Interceptor should be notified about exception", 1, MockProducerInterceptor.ON_ERROR_COUNT.intValue())
+        assertEquals("Interceptor should be notified about exception", 1, MockProducerInterceptor.ON_ERROR_COUNT.intValue)
         assertEquals("Interceptor should not receive metadata with an exception when record is null", 0, MockProducerInterceptor.ON_ERROR_WITH_METADATA_COUNT.intValue())
     }
 
     // create consumer with interceptor
     this.consumerConfig.setProperty(ConsumerConfig.INTERCEPTOR_CLASSES_CONFIG, "org.apache.kafka.test.MockConsumerInterceptor")
-    val testConsumer = new KafkaConsumer[String, String](this.consumerConfig, new StringDeserializer(), new StringDeserializer())
+    val testConsumer = new KafkaConsumer(this.consumerConfig, new StringDeserializer, new StringDeserializer)
     testConsumer.assign(List(tp).asJava)
     testConsumer.seek(tp, 0)
 
@@ -876,22 +876,22 @@ class PlaintextConsumerTest extends BaseConsumerTest {
     val records = consumeRecords(testConsumer, numRecords)
     for (i <- 0 until numRecords) {
       val record = records(i)
-      assertEquals(s"key $i", new String(record.key()))
-      assertEquals(s"value $i$appendStr".toUpperCase(Locale.ROOT), new String(record.value()))
+      assertEquals(s"key $i", new String(record.key))
+      assertEquals(s"value $i$appendStr".toUpperCase(Locale.ROOT), new String(record.value))
     }
 
     // commit sync and verify onCommit is called
-    val commitCountBefore = MockConsumerInterceptor.ON_COMMIT_COUNT.intValue()
+    val commitCountBefore = MockConsumerInterceptor.ON_COMMIT_COUNT.intValue
     testConsumer.commitSync(Map[TopicPartition, OffsetAndMetadata]((tp, new OffsetAndMetadata(2L))).asJava)
     assertEquals(2, testConsumer.committed(tp).offset)
-    assertEquals(commitCountBefore + 1, MockConsumerInterceptor.ON_COMMIT_COUNT.intValue())
+    assertEquals(commitCountBefore + 1, MockConsumerInterceptor.ON_COMMIT_COUNT.intValue)
 
     // commit async and verify onCommit is called
     val commitCallback = new CountConsumerCommitCallback()
     testConsumer.commitAsync(Map[TopicPartition, OffsetAndMetadata]((tp, new OffsetAndMetadata(5L))).asJava, commitCallback)
     awaitCommitCallback(testConsumer, commitCallback)
     assertEquals(5, testConsumer.committed(tp).offset)
-    assertEquals(commitCountBefore + 2, MockConsumerInterceptor.ON_COMMIT_COUNT.intValue())
+    assertEquals(commitCountBefore + 2, MockConsumerInterceptor.ON_COMMIT_COUNT.intValue)
 
     testConsumer.close()
     testProducer.close()

From e2cc88602fb49f36feec21e965d185d5c3c52d4d Mon Sep 17 00:00:00 2001
From: Jason Gustafson <jason@confluent.io>
Date: Thu, 26 Jan 2017 20:52:54 +0000
Subject: [PATCH 056/177] HOTFIX: Consumer offsets not properly loaded on
 coordinator failover

Author: Jason Gustafson <jason@confluent.io>

Reviewers: Manikumar Reddy <manikumar.reddy@gmail.com>, Ismael Juma <ismael@juma.me.uk>

Closes #2436 from hachikuji/hotfix-offset-deletion

(cherry picked from commit 8301cc608e0e3c334da96b546bf6d943a1704024)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../kafka/coordinator/GroupMetadata.scala     | 15 +--
 .../coordinator/GroupMetadataManager.scala    | 96 +++++++++----------
 .../main/scala/kafka/server/KafkaApis.scala   |  4 +-
 .../kafka/api/ConsumerBounceTest.scala        |  1 -
 4 files changed, 55 insertions(+), 61 deletions(-)

diff --git a/core/src/main/scala/kafka/coordinator/GroupMetadata.scala b/core/src/main/scala/kafka/coordinator/GroupMetadata.scala
index eac31519f8a58..0e49995fa5e06 100644
--- a/core/src/main/scala/kafka/coordinator/GroupMetadata.scala
+++ b/core/src/main/scala/kafka/coordinator/GroupMetadata.scala
@@ -265,6 +265,10 @@ private[coordinator] class GroupMetadata(val groupId: String, initialState: Grou
     GroupOverview(groupId, protocolType.getOrElse(""))
   }
 
+  def initializeOffsets(offsets: collection.Map[TopicPartition, OffsetAndMetadata]) {
+     this.offsets ++= offsets
+  }
+
   def completePendingOffsetWrite(topicPartition: TopicPartition, offset: OffsetAndMetadata) {
     if (pendingOffsetCommits.contains(topicPartition))
       offsets.put(topicPartition, offset)
@@ -287,14 +291,11 @@ private[coordinator] class GroupMetadata(val groupId: String, initialState: Grou
   }
 
   def removeOffsets(topicPartitions: Seq[TopicPartition]): immutable.Map[TopicPartition, OffsetAndMetadata] = {
-    val removedOffsetMap = new mutable.HashMap[TopicPartition, OffsetAndMetadata]
-    for (topicPartition <- topicPartitions) {
+    topicPartitions.flatMap { topicPartition =>
       pendingOffsetCommits.remove(topicPartition)
-      val removedOffsets = offsets.remove(topicPartition)
-      if (!removedOffsets.isEmpty)
-        removedOffsetMap.put(topicPartition, removedOffsets.get)
-    }
-    removedOffsetMap.toMap
+      val removedOffset = offsets.remove(topicPartition)
+      removedOffset.map(topicPartition -> _)
+    }.toMap
   }
 
   def removeExpiredOffsets(startMs: Long) = {
diff --git a/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala b/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
index 459297e879e44..45ed77b9069db 100644
--- a/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
+++ b/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
@@ -436,13 +436,13 @@ class GroupMetadataManager(val brokerId: Int,
               }
             }
 
-            val (groupOffsets, noGroupOffsets)  = loadedOffsets
+            val (groupOffsets, noGroupOffsets) = loadedOffsets
               .groupBy(_._1.group)
               .mapValues(_.map{ case (groupTopicPartition, offsetAndMetadata) => (groupTopicPartition.topicPartition, offsetAndMetadata)})
               .partition(value => loadedGroups.contains(value._1))
 
             loadedGroups.values.foreach { group =>
-              val offsets = groupOffsets.getOrElse(group.groupId, Map.empty)
+              val offsets = groupOffsets.getOrElse(group.groupId, Map.empty[TopicPartition, OffsetAndMetadata])
               loadGroup(group, offsets)
               onGroupLoaded(group)
             }
@@ -479,30 +479,24 @@ class GroupMetadataManager(val brokerId: Int,
     }
   }
 
-  private def loadGroup(group: GroupMetadata, offsets: Iterable[(TopicPartition, OffsetAndMetadata)]): Unit = {
+  private def loadGroup(group: GroupMetadata, offsets: Map[TopicPartition, OffsetAndMetadata]): Unit = {
+    // offsets are initialized prior to loading the group into the cache to ensure that clients see a consistent
+    // view of the group's offsets
+    val loadedOffsets = offsets.mapValues { offsetAndMetadata =>
+      // special handling for version 0:
+      // set the expiration time stamp as commit time stamp + server default retention time
+      if (offsetAndMetadata.expireTimestamp == org.apache.kafka.common.requests.OffsetCommitRequest.DEFAULT_TIMESTAMP)
+        offsetAndMetadata.copy(expireTimestamp = offsetAndMetadata.commitTimestamp + config.offsetsRetentionMs)
+      else
+        offsetAndMetadata
+    }
+    trace(s"Initialized offsets $loadedOffsets for group ${group.groupId}")
+    group.initializeOffsets(loadedOffsets)
+
     val currentGroup = addGroup(group)
-    if (group != currentGroup) {
+    if (group != currentGroup)
       debug(s"Attempt to load group ${group.groupId} from log with generation ${group.generationId} failed " +
         s"because there is already a cached group with generation ${currentGroup.generationId}")
-    } else {
-
-      offsets.foreach {
-        case (topicPartition, offsetAndMetadata) => {
-          val offset = offsetAndMetadata.copy (
-            expireTimestamp = {
-              // special handling for version 0:
-              // set the expiration time stamp as commit time stamp + server default retention time
-              if (offsetAndMetadata.expireTimestamp == org.apache.kafka.common.requests.OffsetCommitRequest.DEFAULT_TIMESTAMP)
-                offsetAndMetadata.commitTimestamp + config.offsetsRetentionMs
-              else
-                offsetAndMetadata.expireTimestamp
-            }
-          )
-          trace("Loaded offset %s for %s.".format(offset, topicPartition))
-          group.completePendingOffsetWrite(topicPartition, offset)
-        }
-      }
-    }
   }
 
   /**
@@ -548,23 +542,22 @@ class GroupMetadataManager(val brokerId: Int,
     cleanupGroupMetadata(None)
   }
 
-  def cleanupGroupMetadata(topicPartitions: Option[Seq[TopicPartition]]) {
+  def cleanupGroupMetadata(deletedTopicPartitions: Option[Seq[TopicPartition]]) {
     val startMs = time.milliseconds()
     var offsetsRemoved = 0
 
     groupMetadataCache.foreach { case (groupId, group) =>
-      val (expiredOffsets, groupIsDead, generation) = group synchronized {
-        // remove expired offsets from the cache
-        val expiredOffsets = if (topicPartitions.isEmpty)
-          group.removeExpiredOffsets(startMs)
-        else
-          group.removeOffsets(topicPartitions.get)
+      val (removedOffsets, groupIsDead, generation) = group synchronized {
+        val removedOffsets = deletedTopicPartitions match {
+          case Some(topicPartitions) => group.removeOffsets(topicPartitions)
+          case None => group.removeExpiredOffsets(startMs)
+        }
 
         if (group.is(Empty) && !group.hasOffsets) {
           info(s"Group $groupId transitioned to Dead in generation ${group.generationId}")
           group.transitionTo(Dead)
         }
-        (expiredOffsets, group.is(Dead), group.generationId)
+        (removedOffsets, group.is(Dead), group.generationId)
       }
 
       val offsetsPartition = partitionFor(groupId)
@@ -573,12 +566,12 @@ class GroupMetadataManager(val brokerId: Int,
         case Some((magicValue, timestampType, timestamp)) =>
           val partitionOpt = replicaManager.getPartition(appendPartition)
           partitionOpt.foreach { partition =>
-            val tombstones = expiredOffsets.map { case (topicPartition, offsetAndMetadata) =>
-              trace(s"Removing expired offset and metadata for $groupId, $topicPartition: $offsetAndMetadata")
+            val tombstones = removedOffsets.map { case (topicPartition, offsetAndMetadata) =>
+              trace(s"Removing expired/deleted offset and metadata for $groupId, $topicPartition: $offsetAndMetadata")
               val commitKey = GroupMetadataManager.offsetCommitKey(groupId, topicPartition.topic, topicPartition.partition)
               Record.create(magicValue, timestampType, timestamp, commitKey, null)
             }.toBuffer
-            trace(s"Marked ${expiredOffsets.size} offsets in $appendPartition for deletion.")
+            trace(s"Marked ${removedOffsets.size} offsets in $appendPartition for deletion.")
 
             // We avoid writing the tombstone when the generationId is 0, since this group is only using
             // Kafka for offset storage.
@@ -595,11 +588,11 @@ class GroupMetadataManager(val brokerId: Int,
                 // do not need to require acks since even if the tombstone is lost,
                 // it will be appended again in the next purge cycle
                 partition.appendRecordsToLeader(MemoryRecords.withRecords(timestampType, compressionType, tombstones: _*))
-                offsetsRemoved += expiredOffsets.size
-                trace(s"Successfully appended ${tombstones.size} tombstones to $appendPartition for expired offsets and/or metadata for group $groupId")
+                offsetsRemoved += removedOffsets.size
+                trace(s"Successfully appended ${tombstones.size} tombstones to $appendPartition for expired/deleted offsets and/or metadata for group $groupId")
               } catch {
                 case t: Throwable =>
-                  error(s"Failed to append ${tombstones.size} tombstones to $appendPartition for expired offsets and/or metadata for group $groupId.", t)
+                  error(s"Failed to append ${tombstones.size} tombstones to $appendPartition for expired/deleted offsets and/or metadata for group $groupId.", t)
                   // ignore and continue
               }
             }
@@ -888,26 +881,25 @@ object GroupMetadataManager {
     value.set(PROTOCOL_KEY, groupMetadata.protocol)
     value.set(LEADER_KEY, groupMetadata.leaderId)
 
-    val memberArray = groupMetadata.allMemberMetadata.map {
-      case memberMetadata =>
-        val memberStruct = value.instance(MEMBERS_KEY)
-        memberStruct.set(MEMBER_ID_KEY, memberMetadata.memberId)
-        memberStruct.set(CLIENT_ID_KEY, memberMetadata.clientId)
-        memberStruct.set(CLIENT_HOST_KEY, memberMetadata.clientHost)
-        memberStruct.set(SESSION_TIMEOUT_KEY, memberMetadata.sessionTimeoutMs)
+    val memberArray = groupMetadata.allMemberMetadata.map { memberMetadata =>
+      val memberStruct = value.instance(MEMBERS_KEY)
+      memberStruct.set(MEMBER_ID_KEY, memberMetadata.memberId)
+      memberStruct.set(CLIENT_ID_KEY, memberMetadata.clientId)
+      memberStruct.set(CLIENT_HOST_KEY, memberMetadata.clientHost)
+      memberStruct.set(SESSION_TIMEOUT_KEY, memberMetadata.sessionTimeoutMs)
 
-        if (version > 0)
-          memberStruct.set(REBALANCE_TIMEOUT_KEY, memberMetadata.rebalanceTimeoutMs)
+      if (version > 0)
+        memberStruct.set(REBALANCE_TIMEOUT_KEY, memberMetadata.rebalanceTimeoutMs)
 
-        val metadata = memberMetadata.metadata(groupMetadata.protocol)
-        memberStruct.set(SUBSCRIPTION_KEY, ByteBuffer.wrap(metadata))
+      val metadata = memberMetadata.metadata(groupMetadata.protocol)
+      memberStruct.set(SUBSCRIPTION_KEY, ByteBuffer.wrap(metadata))
 
-        val memberAssignment = assignment(memberMetadata.memberId)
-        assert(memberAssignment != null)
+      val memberAssignment = assignment(memberMetadata.memberId)
+      assert(memberAssignment != null)
 
-        memberStruct.set(ASSIGNMENT_KEY, ByteBuffer.wrap(memberAssignment))
+      memberStruct.set(ASSIGNMENT_KEY, ByteBuffer.wrap(memberAssignment))
 
-        memberStruct
+      memberStruct
     }
 
     value.set(MEMBERS_KEY, memberArray.toArray)
diff --git a/core/src/main/scala/kafka/server/KafkaApis.scala b/core/src/main/scala/kafka/server/KafkaApis.scala
index 3ce27dbc6cd43..7bb3ed54de2ba 100644
--- a/core/src/main/scala/kafka/server/KafkaApis.scala
+++ b/core/src/main/scala/kafka/server/KafkaApis.scala
@@ -197,7 +197,9 @@ class KafkaApis(val requestChannel: RequestChannel,
     val updateMetadataResponse =
       if (authorize(request.session, ClusterAction, Resource.ClusterResource)) {
         val deletedPartitions = replicaManager.maybeUpdateMetadataCache(correlationId, updateMetadataRequest, metadataCache)
-        coordinator.handleDeletedPartitions(deletedPartitions)
+        if (deletedPartitions.nonEmpty)
+          coordinator.handleDeletedPartitions(deletedPartitions)
+
         if (adminManager.hasDelayedTopicOperations) {
           updateMetadataRequest.partitionStates.keySet.asScala.map(_.topic).foreach { topic =>
             adminManager.tryCompleteDelayedTopicOperations(topic)
diff --git a/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala b/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala
index f98716a503774..fba3239b39407 100644
--- a/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala
+++ b/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala
@@ -161,7 +161,6 @@ class ConsumerBounceTest extends IntegrationTestHarness with Logging {
     }
   }
 
-
   @Test
   def testClose() {
     val numRecords = 10

From 1f4f9c74c1a42bb9ef84e5ef45a7fe175302e73b Mon Sep 17 00:00:00 2001
From: Jon Freedman <jon.freedman@zoho.com>
Date: Thu, 26 Jan 2017 14:17:09 -0800
Subject: [PATCH 057/177] MINOR: Update kafka-run-class.bat to handle spaces in
 classpath

handle existing classpath with spaces
list each lib dependency individually

Author: Jon Freedman <jon.freedman@zoho.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2433 from jonfreedman/trunk

(cherry picked from commit dc4d1bb81b37908725e3bcefd21bade9c2297ebd)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 bin/windows/kafka-run-class.bat | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/bin/windows/kafka-run-class.bat b/bin/windows/kafka-run-class.bat
index 4f85301286589..23263b20ac348 100755
--- a/bin/windows/kafka-run-class.bat
+++ b/bin/windows/kafka-run-class.bat
@@ -90,7 +90,9 @@ for %%p in (api runtime file json tools) do (
 )
 
 rem Classpath addition for release
-call :concat %BASE_DIR%\libs\*
+for %%i in (%BASE_DIR%\libs\*) do (
+	call :concat %%i
+)
 
 rem Classpath addition for core
 for %%i in (%BASE_DIR%\core\build\libs\kafka_%SCALA_BINARY_VERSION%*.jar) do (
@@ -174,7 +176,7 @@ IF ["%CLASSPATH%"] EQU [""] (
 	EXIT /B 2
 )
 
-set COMMAND=%JAVA% %KAFKA_HEAP_OPTS% %KAFKA_JVM_PERFORMANCE_OPTS% %KAFKA_JMX_OPTS% %KAFKA_LOG4J_OPTS% -cp %CLASSPATH% %KAFKA_OPTS% %*
+set COMMAND=%JAVA% %KAFKA_HEAP_OPTS% %KAFKA_JVM_PERFORMANCE_OPTS% %KAFKA_JMX_OPTS% %KAFKA_LOG4J_OPTS% -cp "%CLASSPATH%" %KAFKA_OPTS% %*
 rem echo.
 rem echo %COMMAND%
 rem echo.
@@ -184,7 +186,7 @@ rem echo.
 goto :eof
 :concat
 IF ["%CLASSPATH%"] EQU [""] (
-  set CLASSPATH="%1"
+  set "CLASSPATH=%1"
 ) ELSE (
-  set CLASSPATH=%CLASSPATH%;"%1"
+  set "CLASSPATH=%CLASSPATH%;%1"
 )

From 4f61359318f2e7c25ec46d99fd134cf61de28a93 Mon Sep 17 00:00:00 2001
From: Ismael Juma <ismael@juma.me.uk>
Date: Thu, 26 Jan 2017 14:18:54 -0800
Subject: [PATCH 058/177] KAFKA-4700: Don't drop security configs in
 `StreamsKafkaClient`

Author: Ismael Juma <ismael@juma.me.uk>

Reviewers: Eno Thereska, Damian Guy, Guozhang Wang

Closes #2441 from ijuma/streams-kafka-client-drops-security-configs

(cherry picked from commit 31716590454e1bdd53a65836741f316bf4715c9d)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../apache/kafka/streams/StreamsConfig.java   |  7 ++++
 .../internals/StreamsKafkaClient.java         | 23 +++++++++-
 .../internals/StreamsKafkaClientTest.java     | 42 +++++++++++++++++++
 3 files changed, 71 insertions(+), 1 deletion(-)
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClientTest.java

diff --git a/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java b/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java
index 956ae0b7b8290..d7d65662f58a5 100644
--- a/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java
+++ b/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java
@@ -388,6 +388,13 @@ public static String producerPrefix(final String producerProp) {
         return PRODUCER_PREFIX + producerProp;
     }
 
+    /**
+     * Returns a copy of the config definition.
+     */
+    public static ConfigDef configDef() {
+        return new ConfigDef(CONFIG);
+    }
+
     public StreamsConfig(Map<?, ?> props) {
         super(CONFIG, props);
     }
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
index df590fbe151b8..afde63f87b4c7 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
@@ -24,6 +24,8 @@
 import org.apache.kafka.clients.producer.ProducerConfig;
 import org.apache.kafka.common.Cluster;
 import org.apache.kafka.common.Node;
+import org.apache.kafka.common.config.AbstractConfig;
+import org.apache.kafka.common.config.ConfigDef;
 import org.apache.kafka.common.metrics.JmxReporter;
 import org.apache.kafka.common.metrics.MetricConfig;
 import org.apache.kafka.common.metrics.Metrics;
@@ -52,15 +54,34 @@
 
 public class StreamsKafkaClient {
 
+    private static final ConfigDef CONFIG = StreamsConfig.configDef()
+            .withClientSslSupport()
+            .withClientSaslSupport();
+
+    public static class Config extends AbstractConfig {
+
+        public static Config fromStreamsConfig(StreamsConfig streamsConfig) {
+            return new Config(streamsConfig.originals());
+        }
+
+        public Config(Map<?, ?> originals) {
+            super(CONFIG, originals, false);
+        }
+    }
+
     private final KafkaClient kafkaClient;
     private final List<MetricsReporter> reporters;
-    private final StreamsConfig streamsConfig;
+    private final Config streamsConfig;
 
     private static final int MAX_INFLIGHT_REQUESTS = 100;
 
     public StreamsKafkaClient(final StreamsConfig streamsConfig) {
+        this(Config.fromStreamsConfig(streamsConfig));
+    }
 
+    public StreamsKafkaClient(final Config streamsConfig) {
         this.streamsConfig = streamsConfig;
+
         final Time time = new SystemTime();
 
         final Map<String, String> metricTags = new LinkedHashMap<>();
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClientTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClientTest.java
new file mode 100644
index 0000000000000..2fb57247e76f1
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClientTest.java
@@ -0,0 +1,42 @@
+/**
+  * Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE
+  * file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file
+  * to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the
+  * License. You may obtain a copy of the License at
+  *
+  * http://www.apache.org/licenses/LICENSE-2.0
+  *
+  * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
+  * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+  * specific language governing permissions and limitations under the License.
+  */
+
+package org.apache.kafka.streams.processor.internals;
+
+import org.apache.kafka.common.config.AbstractConfig;
+import org.apache.kafka.common.config.SaslConfigs;
+import org.apache.kafka.streams.StreamsConfig;
+import org.junit.Test;
+
+import java.util.Properties;
+
+import static java.util.Arrays.asList;
+import static org.junit.Assert.assertEquals;
+
+public class StreamsKafkaClientTest {
+
+    @Test
+    public void testConfigFromStreamsConfig() {
+        for (final String expectedMechanism : asList("PLAIN", "SCRAM-SHA-512")) {
+            final Properties props = new Properties();
+            props.setProperty(StreamsConfig.APPLICATION_ID_CONFIG, "some_app_id");
+            props.setProperty(SaslConfigs.SASL_MECHANISM, expectedMechanism);
+            props.setProperty(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, "localhost:9000");
+            final StreamsConfig streamsConfig = new StreamsConfig(props);
+            final AbstractConfig config = StreamsKafkaClient.Config.fromStreamsConfig(streamsConfig);
+            assertEquals(expectedMechanism, config.values().get(SaslConfigs.SASL_MECHANISM));
+            assertEquals(expectedMechanism, config.getString(SaslConfigs.SASL_MECHANISM));
+        }
+    }
+
+}

From f68c7e0f3fa005ac1476a1593067a365fe58dd73 Mon Sep 17 00:00:00 2001
From: Vahid Hashemian <vahidhashemian@us.ibm.com>
Date: Thu, 26 Jan 2017 15:04:35 -0800
Subject: [PATCH 059/177] MINOR: Escape '<' and '>' symbols in quickstart
 streams code snippet

This was missing from [an earlier PR](https://github.com/apache/kafka/pull/2247) that escaped these symbols in another section of the doc.

Author: Vahid Hashemian <vahidhashemian@us.ibm.com>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2453 from vahidhashemian/doc/escape_lt_gt_in_streams_code

(cherry picked from commit 0c83eddcda8ed1b483a869f0915815204e3faade)
Signed-off-by: Ewen Cheslack-Postava <me@ewencp.org>
---
 docs/quickstart.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/quickstart.html b/docs/quickstart.html
index 574d7461086dc..c8f01d49c51e5 100644
--- a/docs/quickstart.html
+++ b/docs/quickstart.html
@@ -282,7 +282,7 @@ <h4><a id="quickstart_kafkastreams" href="#quickstart_kafkastreams">Step 8: Use
 of the <code>WordCountDemo</code> example code (converted to use Java 8 lambda expressions for easy reading).
 </p>
 <pre>
-KTable<String, Long> wordCounts = textLines
+KTable&lt;String, Long&gt; wordCounts = textLines
     // Split each text line, by whitespace, into words.
     .flatMapValues(value -> Arrays.asList(value.toLowerCase().split("\\W+")))
 
@@ -389,7 +389,7 @@ <h4><a id="quickstart_kafkastreams" href="#quickstart_kafkastreams">Step 8: Use
 </pre>
 
 <p>
-Here, the first column is the Kafka message key, and the second column is the message value, both in in <code>java.lang.String</code> format.
+Here, the first column is the Kafka message key, and the second column is the message value, both in <code>java.lang.String</code> format.
 Note that the output is actually a continuous stream of updates, where each data record (i.e. each line in the original output above) is
 an updated count of a single word, aka record key such as "kafka". For multiple records with the same key, each later record is an update of the previous one.
 </p>

From af4f4df1898109857c2da2b718c68ad8ebd501a3 Mon Sep 17 00:00:00 2001
From: Guozhang Wang <wangguoz@gmail.com>
Date: Thu, 26 Jan 2017 16:45:34 -0800
Subject: [PATCH 060/177] MINOR: Change logging level for ignored
 maybeAddMetric from debug to trace
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Author: Guozhang Wang <wangguoz@gmail.com>

Reviewers: Eno Thereska <eno.thereska@gmail.com>, Xavier Léauté <xavier@confluent.io>, Jason Gustafson <jason@confluent.io>

Closes #2454 from guozhangwang/KMinor-trace-logging-add-metrics-twice

(cherry picked from commit 1eac3f33f5de3490046203a8e408970da161b84e)
Signed-off-by: Jason Gustafson <jason@confluent.io>
---
 .../kafka/streams/processor/internals/StreamsMetricsImpl.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsMetricsImpl.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsMetricsImpl.java
index 99ab03ccb5f89..bccf736d0a8ad 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsMetricsImpl.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsMetricsImpl.java
@@ -166,7 +166,7 @@ private void maybeAddMetric(Sensor sensor, MetricName name, MeasurableStat stat)
         if (!metrics.metrics().containsKey(name)) {
             sensor.add(name, stat);
         } else {
-            log.debug("Trying to add metric twice " + name);
+            log.trace("Trying to add metric twice: {}", name);
         }
     }
 

From 5f1ab1419ef20a3da6cc1fd3e4542a3d77be8a10 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Thu, 26 Jan 2017 21:25:26 -0800
Subject: [PATCH 061/177] MINOR: Update JavaDoc for DSL PAPI-API

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Damian Guy, Guozhang Wang

Closes #2413 from mjsax/javaDocImprovements6

(cherry picked from commit a01b72236926d2bcc52dd7d0378147f8fae8117d)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../apache/kafka/streams/kstream/KStream.java | 20 +++--
 .../kafka/streams/kstream/KeyValueMapper.java |  3 +-
 .../apache/kafka/streams/kstream/Merger.java  |  2 +-
 .../kafka/streams/kstream/Transformer.java    | 76 +++++++++++++---
 .../streams/kstream/TransformerSupplier.java  | 15 +++-
 .../kafka/streams/kstream/ValueMapper.java    |  7 +-
 .../streams/kstream/ValueTransformer.java     | 86 +++++++++++++++----
 .../kstream/ValueTransformerSupplier.java     | 18 +++-
 8 files changed, 180 insertions(+), 47 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
index 35095230cc3f8..8a18a5a1e78a4 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
@@ -105,7 +105,8 @@ public interface KStream<K, V> {
      * (both key and value type can be altered arbitrarily).
      * The provided {@link KeyValueMapper} is applied to each input record and computes a new output record.
      * Thus, an input record {@code <K,V>} can be transformed into an output record {@code <K':V'>}.
-     * This is a stateless record-by-record operation.
+     * This is a stateless record-by-record operation (cf. {@link #transform(TransformerSupplier, String...)} for
+     * stateful record transformation).
      * <p>
      * The example below normalizes the String key to upper-case letters and counts the number of token of the value string.
      * <pre>{@code
@@ -117,7 +118,7 @@ public interface KStream<K, V> {
      * });
      * }</pre>
      * <p>
-     * The provided {@link KeyValueMapper} must return a {@link KeyValue} type and the return value must not be {@code null}.
+     * The provided {@link KeyValueMapper} must return a {@link KeyValue} type and must not return {@code null}.
      * <p>
      * Mapping records might result in an internal data redistribution if a key based operator (like an aggregation or
      * join) is applied to the result {@link KStream}. (cf. {@link #mapValues(ValueMapper)})
@@ -130,6 +131,8 @@ public interface KStream<K, V> {
      * @see #flatMap(KeyValueMapper)
      * @see #mapValues(ValueMapper)
      * @see #flatMapValues(ValueMapper)
+     * @see #transform(TransformerSupplier, String...)
+     * @see #transformValues(ValueTransformerSupplier, String...)
      */
     <KR, VR> KStream<KR, VR> map(KeyValueMapper<? super K, ? super V, ? extends KeyValue<? extends KR, ? extends VR>> mapper);
 
@@ -137,7 +140,8 @@ public interface KStream<K, V> {
      * Transform the value of each input record into a new value (with possible new type) of the output record.
      * The provided {@link ValueMapper} is applied to each input record value and computes a new value for it.
      * Thus, an input record {@code <K,V>} can be transformed into an output record {@code <K:V'>}.
-     * This is a stateless record-by-record operation (cf. {@link #transformValues(ValueTransformerSupplier, String...)}).
+     * This is a stateless record-by-record operation (cf.
+     * {@link #transformValues(ValueTransformerSupplier, String...)} for stateful value transformation).
      * <p>
      * The example below counts the number of token of the value string.
      * <pre>{@code
@@ -160,6 +164,7 @@ public interface KStream<K, V> {
      * @see #map(KeyValueMapper)
      * @see #flatMap(KeyValueMapper)
      * @see #flatMapValues(ValueMapper)
+     * @see #transform(TransformerSupplier, String...)
      * @see #transformValues(ValueTransformerSupplier, String...)
      */
     <VR> KStream<K, VR> mapValues(ValueMapper<? super V, ? extends VR> mapper);
@@ -169,7 +174,8 @@ public interface KStream<K, V> {
      * can be altered arbitrarily).
      * The provided {@link KeyValueMapper} is applied to each input record and computes zero or more output records.
      * Thus, an input record {@code <K,V>} can be transformed into output records {@code <K':V'>, <K'':V''>, ...}.
-     * This is a stateless record-by-record operation (cf. {@link #transform(TransformerSupplier, String...)}).
+     * This is a stateless record-by-record operation (cf. {@link #transform(TransformerSupplier, String...)} for
+     * stateful record transformation).
      * <p>
      * The example below splits input records {@code <null:String>} containing sentences as values into their words
      * and emit a record {@code <word:1>} for each word.
@@ -204,6 +210,7 @@ public interface KStream<K, V> {
      * @see #mapValues(ValueMapper)
      * @see #flatMapValues(ValueMapper)
      * @see #transform(TransformerSupplier, String...)
+     * @see #transformValues(ValueTransformerSupplier, String...)
      */
     <KR, VR> KStream<KR, VR> flatMap(final KeyValueMapper<? super K, ? super V, ? extends Iterable<? extends KeyValue<? extends KR, ? extends VR>>> mapper);
 
@@ -214,7 +221,8 @@ public interface KStream<K, V> {
      * stream (value type can be altered arbitrarily).
      * The provided {@link ValueMapper} is applied to each input record and computes zero or more output values.
      * Thus, an input record {@code <K,V>} can be transformed into output records {@code <K:V'>, <K:V''>, ...}.
-     * This is a stateless record-by-record operation.
+     * This is a stateless record-by-record operation (cf. {@link #transformValues(ValueTransformerSupplier, String...)}
+     * for stateful value transformation).
      * <p>
      * The example below splits input records {@code <null:String>} containing sentences as values into their words.
      * <pre>{@code
@@ -240,6 +248,8 @@ public interface KStream<K, V> {
      * @see #map(KeyValueMapper)
      * @see #flatMap(KeyValueMapper)
      * @see #mapValues(ValueMapper)
+     * @see #transform(TransformerSupplier, String...)
+     * @see #transformValues(ValueTransformerSupplier, String...)
      */
     <VR> KStream<K, VR> flatMapValues(final ValueMapper<? super V, ? extends Iterable<? extends VR>> processor);
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KeyValueMapper.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KeyValueMapper.java
index d6d1defb9fdd6..b677de0fb83ff 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KeyValueMapper.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KeyValueMapper.java
@@ -28,13 +28,14 @@
  * <li>map from an input record to a new key (with arbitrary key type as specified by {@code VR})</li>
  * </ul>
  * This is a stateless record-by-record operation, i.e, {@link #apply(Object, Object)} is invoked individually for each
- * record of a stream.
+ * record of a stream (cf. {@link Transformer} for stateful record transformation).
  * {@link KeyValueMapper} is a generalization of {@link ValueMapper}.
  *
  * @param <K>  key type
  * @param <V>  value type
  * @param <VR> mapped value type
  * @see ValueMapper
+ * @see Transformer
  * @see KStream#map(KeyValueMapper)
  * @see KStream#flatMap(KeyValueMapper)
  * @see KStream#selectKey(KeyValueMapper)
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Merger.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Merger.java
index 5a70f21366559..f0df2c609516f 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Merger.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Merger.java
@@ -29,7 +29,7 @@
 public interface Merger<K, V> {
 
     /**
-     * Compute a new aggregate from the key and two aggregates
+     * Compute a new aggregate from the key and two aggregates.
      *
      * @param aggKey    the key of the record
      * @param aggOne    the first aggregate
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Transformer.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Transformer.java
index 95d822ad56e16..d9a814b94c33f 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Transformer.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Transformer.java
@@ -17,48 +17,96 @@
 
 package org.apache.kafka.streams.kstream;
 
+import org.apache.kafka.common.annotation.InterfaceStability;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.errors.StreamsException;
 import org.apache.kafka.streams.processor.ProcessorContext;
+import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.processor.TimestampExtractor;
 
 /**
- * A stateful {@link Transformer} interface to transform a key-value pair into a new value.
+ * The {@link Transformer} interface for stateful mapping of an input record to zero, one, or multiple new output
+ * records (both key and value type can be altered arbitrarily).
+ * This is a stateful record-by-record operation, i.e, {@link #transform(Object, Object)} is invoked individually for
+ * each record of a stream and can access and modify a state that is available beyond a single call of
+ * {@link #transform(Object, Object)} (cf. {@link KeyValueMapper} for stateless record transformation).
+ * Additionally, the interface can be called in regular intervals based on the processing progress
+ * (cf. {@link #punctuate(long)}.
+ * <p>
+ * Use {@link TransformerSupplier} to provide new instances of {@link Transformer} to Kafka Stream's runtime.
+ * <p>
+ * If only a record's value should be modified {@link ValueTransformer} can be used.
  *
- * @param <K>   key type
- * @param <V>   value type
- * @param <R>   return type
+ * @param <K> key type
+ * @param <V> value type
+ * @param <R> {@link KeyValue} return type (both key and value type can be set
+ *            arbitrarily)
+ * @see TransformerSupplier
+ * @see KStream#transform(TransformerSupplier, String...)
+ * @see ValueTransformer
+ * @see KStream#map(KeyValueMapper)
+ * @see KStream#flatMap(KeyValueMapper)
  */
+@InterfaceStability.Unstable
 public interface Transformer<K, V, R> {
 
     /**
-     * Initialize this transformer with the given context. The framework ensures this is called once per processor when the topology
-     * that contains it is initialized.
+     * Initialize this transformer.
+     * This is called once per instance when the topology gets initialized.
      * <p>
-     * If this transformer is to be {@link #punctuate(long) called periodically} by the framework, then this method should
-     * {@link ProcessorContext#schedule(long) schedule itself} with the provided context.
+     * The provided {@link ProcessorContext context} can be used to access topology and record meta data, to
+     * {@link ProcessorContext#schedule(long) schedule itself} for periodical calls (cf. {@link #punctuate(long)}), and
+     * to access attached {@link StateStore}s.
+     * <p>
+     * Note, that {@link ProcessorContext} is updated in the background with the current record's meta data.
+     * Thus, it only contains valid record meta data when accessed within {@link #transform(Object, Object)}.
      *
-     * @param context the context; may not be null
+     * @param context the context
      */
     void init(final ProcessorContext context);
 
     /**
      * Transform the record with the given key and value.
+     * Additionally, any {@link StateStore state} that is {@link KStream#transform(TransformerSupplier, String...)
+     * attached} to this operator can be accessed and modified
+     * arbitrarily (cf. {@link ProcessorContext#getStateStore(String)}).
+     * <p>
+     * If more than one output record should be forwarded downstream {@link ProcessorContext#forward(Object, Object)},
+     * {@link ProcessorContext#forward(Object, Object, int)}, and
+     * {@link ProcessorContext#forward(Object, Object, String)} can be used.
+     * If not record should be forwarded downstream, {@code transform} can return {@code null}.
      *
      * @param key the key for the record
      * @param value the value for the record
-     * @return new value; if null no key-value pair will be forwarded to down stream
+     * @return new {@link KeyValue} pair&mdash;if {@code null} no key-value pair will
+     * be forwarded to down stream
      */
     R transform(final K key, final V value);
 
     /**
-     * Perform any periodic operations and possibly generate a key, if this processor {@link ProcessorContext#schedule(long) schedules itself} with the context
-     * during {@link #init(ProcessorContext) initialization}.
+     * Perform any periodic operations and possibly generate new {@link KeyValue} pairs if this processor
+     * {@link ProcessorContext#schedule(long) schedules itself} with the context during
+     * {@link #init(ProcessorContext) initialization}.
+     * <p>
+     * To generate new {@link KeyValue} pairs {@link ProcessorContext#forward(Object, Object)},
+     * {@link ProcessorContext#forward(Object, Object, int)}, and
+     * {@link ProcessorContext#forward(Object, Object, String)} can be used.
+     * <p>
+     * Note that {@code punctuate} is called based on <it>stream time</it> (i.e., time progresses with regard to
+     * timestamps return by the used {@link TimestampExtractor})
+     * and not based on wall-clock time.
      *
-     * @param timestamp the stream time when this method is being called
-     * @return new value; if null it will not be forwarded to down stream
+     * @param timestamp the stream time when {@code punctuate} is being called
+     * @return must return {@code null}&mdash;otherwise, a {@link StreamsException exception} will be thrown
      */
     R punctuate(final long timestamp);
 
     /**
      * Close this processor and clean up any resources.
+     * <p>
+     * To generate new {@link KeyValue} pairs {@link ProcessorContext#forward(Object, Object)},
+     * {@link ProcessorContext#forward(Object, Object, int)}, and
+     * {@link ProcessorContext#forward(Object, Object, String)} can be used.
      */
     void close();
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/TransformerSupplier.java b/streams/src/main/java/org/apache/kafka/streams/kstream/TransformerSupplier.java
index 0341702dafe7d..0a0148982528d 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/TransformerSupplier.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/TransformerSupplier.java
@@ -17,15 +17,28 @@
 
 package org.apache.kafka.streams.kstream;
 
+import org.apache.kafka.common.annotation.InterfaceStability;
+
 /**
  * A {@link TransformerSupplier} interface which can create one or more {@link Transformer} instances.
+ *
+ * @param <K> key type
+ * @param <V> value type
+ * @param <R> {@link org.apache.kafka.streams.KeyValue KeyValue} return type (both key and value type can be set
+ *            arbitrarily)
+ * @see Transformer
+ * @see KStream#transform(TransformerSupplier, String...)
+ * @see ValueTransformer
+ * @see ValueTransformerSupplier
+ * @see KStream#transformValues(ValueTransformerSupplier, String...)
  */
+@InterfaceStability.Unstable
 public interface TransformerSupplier<K, V, R> {
 
     /**
      * Return a new {@link Transformer} instance.
      *
-     * @return  a new {@link Transformer} instance
+     * @return a new {@link Transformer} instance
      */
     Transformer<K, V, R> get();
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/ValueMapper.java b/streams/src/main/java/org/apache/kafka/streams/kstream/ValueMapper.java
index 5099ac71e2ac3..71acc1d13c7c2 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/ValueMapper.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/ValueMapper.java
@@ -21,14 +21,15 @@
 /**
  * The {@link ValueMapper} interface for mapping a value to a new value of arbitrary type.
  * This is a stateless record-by-record operation, i.e, {@link #apply(Object)} is invoked individually for each record
- * of a stream.
- * Thus, if {@link ValueMapper} is applied to a {@link org.apache.kafka.streams.KeyValue key-value pair} record the
- * record's key is preserved.
+ * of a stream (cf. {@link ValueTransformer} for stateful value transformation).
+ * If {@link ValueMapper} is applied to a {@link org.apache.kafka.streams.KeyValue key-value pair} record the record's
+ * key is preserved.
  * If a record's key and value should be modified {@link KeyValueMapper} can be used.
  *
  * @param <V>  value type
  * @param <VR> mapped value type
  * @see KeyValueMapper
+ * @see ValueTransformer
  * @see KStream#mapValues(ValueMapper)
  * @see KStream#flatMapValues(ValueMapper)
  * @see KTable#mapValues(ValueMapper)
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformer.java b/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformer.java
index 063c35233999c..02c3ba7270d62 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformer.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformer.java
@@ -17,46 +17,96 @@
 
 package org.apache.kafka.streams.kstream;
 
+import org.apache.kafka.common.annotation.InterfaceStability;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.errors.StreamsException;
 import org.apache.kafka.streams.processor.ProcessorContext;
+import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.processor.TimestampExtractor;
 
 /**
- * A stateful {@link ValueTransformer} interface to transform a value into a new value.
+ * The {@link ValueTransformer} interface for stateful mapping of a value to a new value (with possible new type).
+ * This is a stateful record-by-record operation, i.e, {@link #transform(Object)} is invoked individually for each
+ * record of a stream and can access and modify a state that is available beyond a single call of
+ * {@link #transform(Object)} (cf. {@link ValueMapper} for stateless value transformation).
+ * Additionally, the interface can be called in regular intervals based on the processing progress
+ * (cf. {@link #punctuate(long)}.
+ * If {@link ValueTransformer} is applied to a {@link KeyValue} pair record the record's key is preserved.
+ * <p>
+ * Use {@link ValueTransformerSupplier} to provide new instances of {@link ValueTransformer} to Kafka Stream's runtime.
+ * <p>
+ * If a record's key and value should be modified {@link Transformer} can be used.
  *
- * @param <V>   value type
- * @param <R>   return type
+ * @param <V>  value type
+ * @param <VR> transformed value type
+ * @see ValueTransformerSupplier
+ * @see KStream#transformValues(ValueTransformerSupplier, String...)
+ * @see Transformer
  */
-public interface ValueTransformer<V, R> {
+@InterfaceStability.Unstable
+public interface ValueTransformer<V, VR> {
 
     /**
-     * Initialize this transformer with the given context. The framework ensures this is called once per processor when the topology
-     * that contains it is initialized.
+     * Initialize this transformer.
+     * This is called once per instance when the topology gets initialized.
      * <p>
-     * If this transformer is to be {@link #punctuate(long) called periodically} by the framework, then this method should
-     * {@link ProcessorContext#schedule(long) schedule itself} with the provided context.
+     * The provided {@link ProcessorContext context} can be used to access topology and record meta data, to
+     * {@link ProcessorContext#schedule(long) schedule itself} for periodical calls (cf. {@link #punctuate(long)}), and
+     * to access attached {@link StateStore}s.
+     * <p>
+     * Note that {@link ProcessorContext} is updated in the background with the current record's meta data.
+     * Thus, it only contains valid record meta data when accessed within {@link #transform(Object)}.
+     * <p>
+     * Note that using {@link ProcessorContext#forward(Object, Object)},
+     * {@link ProcessorContext#forward(Object, Object, int)}, or
+     * {@link ProcessorContext#forward(Object, Object, String)} is not allowed within any method of
+     * {@code ValueTransformer} and will result in an {@link StreamsException exception}.
      *
-     * @param context the context; may not be null
+     * @param context the context
      */
     void init(final ProcessorContext context);
 
     /**
-     * Transform the record with the given key and value.
+     * Transform the given value to a new value.
+     * Additionally, any {@link StateStore} that is {@link KStream#transformValues(ValueTransformerSupplier, String...)
+     * attached} to this operator can be accessed and modified arbitrarily (cf.
+     * {@link ProcessorContext#getStateStore(String)}).
+     * <p>
+     * Note, that using {@link ProcessorContext#forward(Object, Object)},
+     * {@link ProcessorContext#forward(Object, Object, int)}, and
+     * {@link ProcessorContext#forward(Object, Object, String)} is not allowed within {@code transform} and
+     * will result in an {@link StreamsException exception}.
      *
-     * @param value the value for the record
-     * @return new value
+     * @param value the value to be transformed
+     * @return the new value
      */
-    R transform(final V value);
+    VR transform(final V value);
 
     /**
-     * Perform any periodic operations and possibly return a new value, if this processor {@link ProcessorContext#schedule(long) schedule itself} with the context
-     * during {@link #init(ProcessorContext) initialization}.
+     * Perform any periodic operations if this processor {@link ProcessorContext#schedule(long) schedule itself} with
+     * the context during {@link #init(ProcessorContext) initialization}.
+     * <p>
+     * It is not possible to return any new output records within {@code punctuate}.
+     * Using {@link ProcessorContext#forward(Object, Object)}, {@link ProcessorContext#forward(Object, Object, int)},
+     * or {@link ProcessorContext#forward(Object, Object, String)} will result in an
+     * {@link StreamsException exception}.
+     * Furthermore, {@code punctuate} must return {@code null}.
+     * <p>
+     * Note, that {@code punctuate} is called base on <it>stream time</it> (i.e., time progress with regard to
+     * timestamps return by the used {@link TimestampExtractor})
+     * and not based on wall-clock time.
      *
-     * @param timestamp the stream time when this method is being called
-     * @return new value; if null it will not be forwarded to down stream
+     * @param timestamp the stream time when {@code punctuate} is being called
+     * @return must return {@code null}&mdash;otherwise, an {@link StreamsException exception} will be thrown
      */
-    R punctuate(final long timestamp);
+    VR punctuate(final long timestamp);
 
     /**
      * Close this processor and clean up any resources.
+     * <p>
+     * It is not possible to return any new output records within {@code close()}.
+     * Using {@link ProcessorContext#forward(Object, Object)}, {@link ProcessorContext#forward(Object, Object, int)},
+     * or {@link ProcessorContext#forward(Object, Object, String)} will result in an {@link StreamsException exception}.
      */
     void close();
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformerSupplier.java b/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformerSupplier.java
index ecd454abac15d..3d357ee296141 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformerSupplier.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformerSupplier.java
@@ -14,18 +14,28 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-
 package org.apache.kafka.streams.kstream;
 
+import org.apache.kafka.common.annotation.InterfaceStability;
+
 /**
  * A {@link ValueTransformerSupplier} interface which can create one or more {@link ValueTransformer} instances.
+ *
+ * @param <V>  value type
+ * @param <VR> transformed value type
+ * @see ValueTransformer
+ * @see KStream#transformValues(ValueTransformerSupplier, String...)
+ * @see Transformer
+ * @see TransformerSupplier
+ * @see KStream#transform(TransformerSupplier, String...)
  */
-public interface ValueTransformerSupplier<V, R> {
+@InterfaceStability.Unstable
+public interface ValueTransformerSupplier<V, VR> {
 
     /**
      * Return a new {@link ValueTransformer} instance.
      *
-     * @return  a new {@link ValueTransformer} instance.
+     * @return a new {@link ValueTransformer} instance.
      */
-    ValueTransformer<V, R> get();
+    ValueTransformer<V, VR> get();
 }

From b2bcef7f35650088d3ca8882be7c49186b6a27cc Mon Sep 17 00:00:00 2001
From: Ismael Juma <ismael@juma.me.uk>
Date: Thu, 26 Jan 2017 21:27:44 -0800
Subject: [PATCH 062/177] MINOR: Close create topics policy during shutdown and
 more tests

Author: Ismael Juma <ismael@juma.me.uk>

Reviewers: Jason Gustafson <jason@confluent.io>

Closes #2443 from ijuma/close-create-topics-policy-during-shutdown

(cherry picked from commit 2f9e9195abada7c2bcbd41147cb9d4c00f3a712d)
Signed-off-by: Jason Gustafson <jason@confluent.io>
---
 .../scala/kafka/server/AdminManager.scala     |  1 +
 .../CreateTopicsRequestWithPolicyTest.scala   | 49 ++++++++++++++++---
 2 files changed, 42 insertions(+), 8 deletions(-)

diff --git a/core/src/main/scala/kafka/server/AdminManager.scala b/core/src/main/scala/kafka/server/AdminManager.scala
index 6dc224dc54603..98a4b1897d635 100644
--- a/core/src/main/scala/kafka/server/AdminManager.scala
+++ b/core/src/main/scala/kafka/server/AdminManager.scala
@@ -191,5 +191,6 @@ class AdminManager(val config: KafkaConfig,
 
   def shutdown() {
     topicPurgatory.shutdown()
+    CoreUtils.swallow(createTopicPolicy.foreach(_.close()))
   }
 }
diff --git a/core/src/test/scala/unit/kafka/server/CreateTopicsRequestWithPolicyTest.scala b/core/src/test/scala/unit/kafka/server/CreateTopicsRequestWithPolicyTest.scala
index 9affea47e3c48..f2020cf8bb41e 100644
--- a/core/src/test/scala/unit/kafka/server/CreateTopicsRequestWithPolicyTest.scala
+++ b/core/src/test/scala/unit/kafka/server/CreateTopicsRequestWithPolicyTest.scala
@@ -20,6 +20,7 @@ package kafka.server
 import java.util
 import java.util.Properties
 
+import kafka.log.LogConfig
 import kafka.utils.TestUtils
 import org.apache.kafka.common.errors.PolicyViolationException
 import org.apache.kafka.common.protocol.Errors
@@ -48,9 +49,13 @@ class CreateTopicsRequestWithPolicyTest extends AbstractCreateTopicsRequestTest
     validateValidCreateTopicsRequests(new CreateTopicsRequest.Builder(
       Map("topic2" -> new CreateTopicsRequest.TopicDetails(5, 3.toShort)).asJava, timeout, true).build())
 
+    val configs = Map(LogConfig.RetentionMsProp -> 4999.toString)
+    validateValidCreateTopicsRequests(new CreateTopicsRequest.Builder(
+      Map("topic3" -> new CreateTopicsRequest.TopicDetails(11, 2.toShort, configs.asJava)).asJava, timeout, true).build())
+
     val assignments = replicaAssignmentToJava(Map(0 -> List(1, 0), 1 -> List(0, 1)))
     validateValidCreateTopicsRequests(new CreateTopicsRequest.Builder(
-      Map("topic3" -> new CreateTopicsRequest.TopicDetails(assignments)).asJava, timeout).build())
+      Map("topic4" -> new CreateTopicsRequest.TopicDetails(assignments)).asJava, timeout).build())
   }
 
   @Test
@@ -65,14 +70,23 @@ class CreateTopicsRequestWithPolicyTest extends AbstractCreateTopicsRequestTest
       Map("policy-topic1" -> error(Errors.POLICY_VIOLATION, Some("Topics should have at least 5 partitions, received 4"))))
 
     validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(
-      Map("policy-topic2" -> new CreateTopicsRequest.TopicDetails(4, 1.toShort)).asJava, timeout, true).build(),
+      Map("policy-topic2" -> new CreateTopicsRequest.TopicDetails(4, 3.toShort)).asJava, timeout, true).build(),
       Map("policy-topic2" -> error(Errors.POLICY_VIOLATION, Some("Topics should have at least 5 partitions, received 4"))))
 
+    val configs = Map(LogConfig.RetentionMsProp -> 5001.toString)
+    validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(
+      Map("policy-topic3" -> new CreateTopicsRequest.TopicDetails(11, 2.toShort, configs.asJava)).asJava, timeout, true).build(),
+      Map("policy-topic3" -> error(Errors.POLICY_VIOLATION, Some("RetentionMs should be less than 5000ms if replicationFactor > 5"))))
+
+    validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(
+      Map("policy-topic4" -> new CreateTopicsRequest.TopicDetails(11, 3.toShort, Map.empty.asJava)).asJava, timeout, true).build(),
+      Map("policy-topic4" -> error(Errors.POLICY_VIOLATION, Some("RetentionMs should be less than 5000ms if replicationFactor > 5"))))
+
     val assignments = replicaAssignmentToJava(Map(0 -> List(1), 1 -> List(0)))
     validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(
-      Map("policy-topic3" -> new CreateTopicsRequest.TopicDetails(assignments)).asJava, timeout).build(),
-      Map("policy-topic3" -> error(Errors.POLICY_VIOLATION,
-        Some("""Topic partitions should have at least 2 partitions, received 1 for partition 0"""))), checkErrorMessage = true)
+      Map("policy-topic5" -> new CreateTopicsRequest.TopicDetails(assignments)).asJava, timeout).build(),
+      Map("policy-topic5" -> error(Errors.POLICY_VIOLATION,
+        Some("Topic partitions should have at least 2 partitions, received 1 for partition 0"))))
 
     // Check that basic errors still work
     validateErrorCreateTopicsRequests(new CreateTopicsRequest.Builder(
@@ -94,29 +108,48 @@ class CreateTopicsRequestWithPolicyTest extends AbstractCreateTopicsRequestTest
 object CreateTopicsRequestWithPolicyTest {
 
   class Policy extends CreateTopicPolicy {
-    def configure(configs: util.Map[String, _]): Unit = ()
+
+    var configs: Map[String, _] = _
+    var closed = false
+
+    def configure(configs: util.Map[String, _]): Unit = {
+      this.configs = configs.asScala.toMap
+    }
 
     def validate(requestMetadata: RequestMetadata): Unit = {
+      require(!closed, "Policy should not be closed")
+      require(!configs.isEmpty, "configure should have been called with non empty configs")
+
       import requestMetadata._
-      require(configs.isEmpty, s"Topic configs should be empty, but it is $configs")
       if (numPartitions != null || replicationFactor != null) {
         require(numPartitions != null, s"numPartitions should not be null, but it is $numPartitions")
         require(replicationFactor != null, s"replicationFactor should not be null, but it is $replicationFactor")
         require(replicasAssignments == null, s"replicaAssigments should be null, but it is $replicasAssignments")
+
         if (numPartitions < 5)
           throw new PolicyViolationException(s"Topics should have at least 5 partitions, received $numPartitions")
+
+        if (numPartitions > 10) {
+          if (requestMetadata.configs.asScala.get(LogConfig.RetentionMsProp).fold(true)(_.toInt > 5000))
+            throw new PolicyViolationException("RetentionMs should be less than 5000ms if replicationFactor > 5")
+        } else
+          require(requestMetadata.configs.isEmpty, s"Topic configs should be empty, but it is ${requestMetadata.configs}")
+
       } else {
         require(numPartitions == null, s"numPartitions should be null, but it is $numPartitions")
         require(replicationFactor == null, s"replicationFactor should be null, but it is $replicationFactor")
         require(replicasAssignments != null, s"replicaAssigments should not be null, but it is $replicasAssignments")
+
         replicasAssignments.asScala.foreach { case (partitionId, assignment) =>
           if (assignment.size < 2)
             throw new PolicyViolationException("Topic partitions should have at least 2 partitions, received " +
               s"${assignment.size} for partition $partitionId")
         }
       }
+
     }
 
-    def close(): Unit = ()
+    def close(): Unit = closed = true
+
   }
 }

From 890b4ac6abe2a927e3273773cb119ba516f4971e Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Thu, 26 Jan 2017 21:46:37 -0800
Subject: [PATCH 063/177] MINOR: Add Streams system test for broker backwards
 compatibility

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Damian Guy, Eno Thereska, Guozhang Wang

Closes #2403 from mjsax/addStreamsClientCompatibilityTest

(cherry picked from commit 89fb02aa81fe67f5a506f579e463f30f3020dee5)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../apache/kafka/streams/KafkaStreams.java    |  21 +++-
 .../internals/InternalTopicManager.java       |   2 +-
 .../internals/StreamsKafkaClient.java         | 101 ++++++++++++----
 .../tests/BrokerCompatibilityTest.java        | 110 ++++++++++++++++++
 tests/kafkatest/services/streams.py           |   8 ++
 .../streams/streams_broker_compatibility.py   |  90 ++++++++++++++
 6 files changed, 304 insertions(+), 28 deletions(-)
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/tests/BrokerCompatibilityTest.java
 create mode 100644 tests/kafkatest/tests/streams/streams_broker_compatibility.py

diff --git a/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java b/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
index 31456b2a16086..27c8d22d90c71 100644
--- a/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
+++ b/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
@@ -36,6 +36,7 @@
 import org.apache.kafka.streams.processor.internals.ProcessorTopology;
 import org.apache.kafka.streams.processor.internals.StateDirectory;
 import org.apache.kafka.streams.processor.internals.StreamThread;
+import org.apache.kafka.streams.processor.internals.StreamsKafkaClient;
 import org.apache.kafka.streams.processor.internals.StreamsMetadataState;
 import org.apache.kafka.streams.state.HostInfo;
 import org.apache.kafka.streams.state.QueryableStoreType;
@@ -48,17 +49,18 @@
 import org.slf4j.LoggerFactory;
 
 import java.io.File;
+import java.io.IOException;
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.Collection;
 import java.util.Collections;
 import java.util.HashMap;
+import java.util.HashSet;
 import java.util.List;
 import java.util.Map;
 import java.util.Properties;
-import java.util.UUID;
 import java.util.Set;
-import java.util.HashSet;
-import java.util.Arrays;
+import java.util.UUID;
 import java.util.concurrent.TimeUnit;
 
 import static org.apache.kafka.common.utils.Utils.getHost;
@@ -358,6 +360,18 @@ private static HostInfo parseHostInfo(final String endPoint) {
         return new HostInfo(host, port);
     }
 
+    private void checkBrokerVersionCompatibility() {
+        final StreamsKafkaClient client = new StreamsKafkaClient(config);
+
+        client.checkBrokerCompatibility();
+
+        try {
+            client.close();
+        } catch (final IOException e) {
+            log.warn("Could not close StreamKafkaClient.", e);
+        }
+
+    }
 
     /**
      * Start the stream instance by starting all its threads.
@@ -368,6 +382,7 @@ public synchronized void start() {
         log.debug("Starting Kafka Stream process");
 
         if (state == KafkaStreams.State.CREATED) {
+            checkBrokerVersionCompatibility();
             setState(KafkaStreams.State.RUNNING);
 
             if (globalStreamThread != null) {
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java
index eeb38d1133bbd..a9bd5d7e6ccff 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java
@@ -63,7 +63,7 @@ public void makeReady(final Map<InternalTopicConfig, Integer> topics) {
                 streamsKafkaClient.createTopics(topicsToBeCreated, replicationFactor, windowChangeLogAdditionalRetention);
                 return;
             } catch (StreamsException ex) {
-                log.warn("Could not create internal topics: " + ex.getMessage() + ". Retry #" + i);
+                log.warn("Could not create internal topics: " + ex.getMessage() + " Retry #" + i);
             }
         }
         throw new StreamsException("Could not create internal topics.");
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
index afde63f87b4c7..5edc10d84886a 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
@@ -13,13 +13,13 @@
 
 package org.apache.kafka.streams.processor.internals;
 
+import org.apache.kafka.clients.ClientRequest;
+import org.apache.kafka.clients.ClientResponse;
 import org.apache.kafka.clients.ClientUtils;
 import org.apache.kafka.clients.CommonClientConfigs;
 import org.apache.kafka.clients.KafkaClient;
-import org.apache.kafka.clients.NetworkClient;
 import org.apache.kafka.clients.Metadata;
-import org.apache.kafka.clients.ClientResponse;
-import org.apache.kafka.clients.ClientRequest;
+import org.apache.kafka.clients.NetworkClient;
 import org.apache.kafka.clients.consumer.ConsumerConfig;
 import org.apache.kafka.clients.producer.ProducerConfig;
 import org.apache.kafka.common.Cluster;
@@ -32,7 +32,10 @@
 import org.apache.kafka.common.metrics.MetricsReporter;
 import org.apache.kafka.common.network.ChannelBuilder;
 import org.apache.kafka.common.network.Selector;
+import org.apache.kafka.common.protocol.ApiKeys;
 import org.apache.kafka.common.protocol.Errors;
+import org.apache.kafka.common.requests.ApiVersionsRequest;
+import org.apache.kafka.common.requests.ApiVersionsResponse;
 import org.apache.kafka.common.requests.CreateTopicsRequest;
 import org.apache.kafka.common.requests.CreateTopicsResponse;
 import org.apache.kafka.common.requests.MetadataRequest;
@@ -44,12 +47,12 @@
 
 import java.io.IOException;
 import java.net.InetSocketAddress;
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
 import java.util.List;
 import java.util.Map;
-import java.util.LinkedHashMap;
 import java.util.Properties;
-import java.util.HashMap;
-import java.util.Collection;
 import java.util.concurrent.TimeUnit;
 
 public class StreamsKafkaClient {
@@ -87,7 +90,10 @@ public StreamsKafkaClient(final Config streamsConfig) {
         final Map<String, String> metricTags = new LinkedHashMap<>();
         metricTags.put("client-id", StreamsConfig.CLIENT_ID_CONFIG);
 
-        final Metadata metadata = new Metadata(streamsConfig.getLong(StreamsConfig.RETRY_BACKOFF_MS_CONFIG), streamsConfig.getLong(StreamsConfig.METADATA_MAX_AGE_CONFIG));
+        final Metadata metadata = new Metadata(streamsConfig.getLong(
+            StreamsConfig.RETRY_BACKOFF_MS_CONFIG),
+            streamsConfig.getLong(StreamsConfig.METADATA_MAX_AGE_CONFIG)
+        );
         final List<InetSocketAddress> addresses = ClientUtils.parseAndValidateAddresses(streamsConfig.getList(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG));
         metadata.update(Cluster.bootstrap(addresses), time.milliseconds());
 
@@ -102,17 +108,24 @@ public StreamsKafkaClient(final Config streamsConfig) {
 
         final ChannelBuilder channelBuilder = ClientUtils.createChannelBuilder(streamsConfig.values());
 
-        final Selector selector = new Selector(streamsConfig.getLong(StreamsConfig.CONNECTIONS_MAX_IDLE_MS_CONFIG), metrics, time, "kafka-client", channelBuilder);
+        final Selector selector = new Selector(
+            streamsConfig.getLong(StreamsConfig.CONNECTIONS_MAX_IDLE_MS_CONFIG),
+            metrics,
+            time,
+            "kafka-client",
+            channelBuilder);
 
         kafkaClient = new NetworkClient(
-                selector,
-                metadata,
-                streamsConfig.getString(StreamsConfig.CLIENT_ID_CONFIG),
-                MAX_INFLIGHT_REQUESTS, // a fixed large enough value will suffice
-                streamsConfig.getLong(StreamsConfig.RECONNECT_BACKOFF_MS_CONFIG),
-                streamsConfig.getInt(StreamsConfig.SEND_BUFFER_CONFIG),
-                streamsConfig.getInt(StreamsConfig.RECEIVE_BUFFER_CONFIG),
-                streamsConfig.getInt(StreamsConfig.REQUEST_TIMEOUT_MS_CONFIG), time, true);
+            selector,
+            metadata,
+            streamsConfig.getString(StreamsConfig.CLIENT_ID_CONFIG),
+            MAX_INFLIGHT_REQUESTS, // a fixed large enough value will suffice
+            streamsConfig.getLong(StreamsConfig.RECONNECT_BACKOFF_MS_CONFIG),
+            streamsConfig.getInt(StreamsConfig.SEND_BUFFER_CONFIG),
+            streamsConfig.getInt(StreamsConfig.RECEIVE_BUFFER_CONFIG),
+            streamsConfig.getInt(StreamsConfig.REQUEST_TIMEOUT_MS_CONFIG),
+            time,
+            true);
     }
 
     public void close() throws IOException {
@@ -133,19 +146,29 @@ public void createTopics(final Map<InternalTopicConfig, Integer> topicsMap, fina
             for (String key : topicProperties.stringPropertyNames()) {
                 topicConfig.put(key, topicProperties.getProperty(key));
             }
-            final CreateTopicsRequest.TopicDetails topicDetails = new CreateTopicsRequest.TopicDetails(topicsMap.get(internalTopicConfig), (short) replicationFactor, topicConfig);
+            final CreateTopicsRequest.TopicDetails topicDetails = new CreateTopicsRequest.TopicDetails(
+                topicsMap.get(internalTopicConfig),
+                (short) replicationFactor,
+                topicConfig);
 
             topicRequestDetails.put(internalTopicConfig.name(), topicDetails);
         }
 
-        final ClientRequest clientRequest = kafkaClient.newClientRequest(getBrokerId(), new CreateTopicsRequest.Builder(topicRequestDetails, streamsConfig.getInt(StreamsConfig.REQUEST_TIMEOUT_MS_CONFIG)), Time.SYSTEM.milliseconds(), true, null);
+        final ClientRequest clientRequest = kafkaClient.newClientRequest(
+            getBrokerId(),
+            new CreateTopicsRequest.Builder(
+                topicRequestDetails,
+                streamsConfig.getInt(StreamsConfig.REQUEST_TIMEOUT_MS_CONFIG)),
+            Time.SYSTEM.milliseconds(),
+            true);
         final ClientResponse clientResponse = sendRequest(clientRequest);
 
         if (!clientResponse.hasResponse()) {
             throw new StreamsException("Empty response for client request.");
         }
         if (!(clientResponse.responseBody() instanceof CreateTopicsResponse)) {
-            throw new StreamsException("Inconsistent response type for internal topic creation request. Expected CreateTopicsResponse but received " + clientResponse.responseBody().getClass().getName());
+            throw new StreamsException("Inconsistent response type for internal topic creation request. " +
+                "Expected CreateTopicsResponse but received " + clientResponse.responseBody().getClass().getName());
         }
         final CreateTopicsResponse createTopicsResponse =  (CreateTopicsResponse) clientResponse.responseBody();
 
@@ -159,7 +182,9 @@ public void createTopics(final Map<InternalTopicConfig, Integer> topicsMap, fina
 
     private String getBrokerId() {
         String brokerId = null;
-        final Metadata metadata = new Metadata(streamsConfig.getLong(StreamsConfig.RETRY_BACKOFF_MS_CONFIG), streamsConfig.getLong(StreamsConfig.METADATA_MAX_AGE_CONFIG));
+        final Metadata metadata = new Metadata(
+            streamsConfig.getLong(StreamsConfig.RETRY_BACKOFF_MS_CONFIG),
+            streamsConfig.getLong(StreamsConfig.METADATA_MAX_AGE_CONFIG));
         final List<InetSocketAddress> addresses = ClientUtils.parseAndValidateAddresses(streamsConfig.getList(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG));
         metadata.update(Cluster.bootstrap(addresses), Time.SYSTEM.milliseconds());
 
@@ -196,8 +221,9 @@ private ClientResponse sendRequest(final ClientRequest clientRequest) {
                 if (response.requestHeader().correlationId() == clientRequest.correlationId()) {
                     return response;
                 } else {
-                    throw new StreamsException("Inconsistent response received from the broker " + clientRequest.destination() + ", expected correlation id " + clientRequest.correlationId() + ", but received " +
-                            response.requestHeader().correlationId());
+                    throw new StreamsException("Inconsistent response received from the broker "
+                        + clientRequest.destination() + ", expected correlation id " + clientRequest.correlationId()
+                        + ", but received " + response.requestHeader().correlationId());
                 }
             }
         }
@@ -210,16 +236,43 @@ private ClientResponse sendRequest(final ClientRequest clientRequest) {
      */
     public Collection<MetadataResponse.TopicMetadata> fetchTopicsMetadata() {
 
-        final ClientRequest clientRequest = kafkaClient.newClientRequest(getBrokerId(), new MetadataRequest.Builder(null), Time.SYSTEM.milliseconds(), true, null);
+        final ClientRequest clientRequest = kafkaClient.newClientRequest(
+            getBrokerId(),
+            new MetadataRequest.Builder(null),
+            Time.SYSTEM.milliseconds(),
+            true);
         final ClientResponse clientResponse = sendRequest(clientRequest);
         if (!clientResponse.hasResponse()) {
             throw new StreamsException("Empty response for client request.");
         }
         if (!(clientResponse.responseBody() instanceof MetadataResponse)) {
-            throw new StreamsException("Inconsistent response type for internal topic metadata request. Expected MetadataResponse but received " + clientResponse.responseBody().getClass().getName());
+            throw new StreamsException("Inconsistent response type for internal topic metadata request. " +
+                "Expected MetadataResponse but received " + clientResponse.responseBody().getClass().getName());
         }
         final MetadataResponse metadataResponse = (MetadataResponse) clientResponse.responseBody();
         return metadataResponse.topicMetadata();
     }
 
+    public void checkBrokerCompatibility() {
+        final ClientRequest clientRequest = kafkaClient.newClientRequest(
+            getBrokerId(),
+            new ApiVersionsRequest.Builder(),
+            Time.SYSTEM.milliseconds(),
+            true);
+
+        final ClientResponse clientResponse = sendRequest(clientRequest);
+        if (!clientResponse.hasResponse()) {
+            throw new StreamsException("Empty response for client request.");
+        }
+        if (!(clientResponse.responseBody() instanceof ApiVersionsResponse)) {
+            throw new StreamsException("Inconsistent response type for API versions request. " +
+                "Expected ApiVersionsResponse but received " + clientResponse.responseBody().getClass().getName());
+        }
+
+        final ApiVersionsResponse apiVersionsResponse =  (ApiVersionsResponse) clientResponse.responseBody();
+
+        if (apiVersionsResponse.apiVersion(ApiKeys.CREATE_TOPICS.id) == null) {
+            throw new StreamsException("Kafka Streams requires broker version 0.10.1.x or higher.");
+        }
+    }
 }
diff --git a/streams/src/test/java/org/apache/kafka/streams/tests/BrokerCompatibilityTest.java b/streams/src/test/java/org/apache/kafka/streams/tests/BrokerCompatibilityTest.java
new file mode 100644
index 0000000000000..9af32626d5278
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/tests/BrokerCompatibilityTest.java
@@ -0,0 +1,110 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.kafka.streams.tests;
+
+import org.apache.kafka.clients.consumer.ConsumerConfig;
+import org.apache.kafka.clients.consumer.ConsumerRecord;
+import org.apache.kafka.clients.consumer.ConsumerRecords;
+import org.apache.kafka.clients.consumer.KafkaConsumer;
+import org.apache.kafka.clients.producer.KafkaProducer;
+import org.apache.kafka.clients.producer.ProducerConfig;
+import org.apache.kafka.clients.producer.ProducerRecord;
+import org.apache.kafka.common.serialization.Serdes;
+import org.apache.kafka.common.serialization.StringDeserializer;
+import org.apache.kafka.common.serialization.StringSerializer;
+import org.apache.kafka.streams.KafkaStreams;
+import org.apache.kafka.streams.StreamsConfig;
+import org.apache.kafka.streams.kstream.KStreamBuilder;
+import org.apache.kafka.test.TestUtils;
+
+import java.io.File;
+import java.util.Collections;
+import java.util.Properties;
+
+public class BrokerCompatibilityTest {
+
+    private static final String SOURCE_TOPIC = "brokerCompatibilitySourceTopic";
+    private static final String SINK_TOPIC = "brokerCompatibilitySinkTopic";
+
+    public static void main(String[] args) throws Exception {
+        System.out.println("StreamsTest instance started");
+
+        final String kafka = args.length > 0 ? args[0] : "localhost:9092";
+        final String stateDirStr = args.length > 1 ? args[1] : TestUtils.tempDirectory().getAbsolutePath();
+
+        final File stateDir = new File(stateDirStr);
+        stateDir.mkdir();
+
+        final Properties streamsProperties = new Properties();
+        streamsProperties.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, kafka);
+        streamsProperties.put(StreamsConfig.APPLICATION_ID_CONFIG, "kafka-streams-system-test-broker-compatibility");
+        streamsProperties.put(StreamsConfig.STATE_DIR_CONFIG, stateDir.toString());
+        streamsProperties.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
+        streamsProperties.put(StreamsConfig.KEY_SERDE_CLASS_CONFIG, Serdes.String().getClass());
+        streamsProperties.put(StreamsConfig.VALUE_SERDE_CLASS_CONFIG, Serdes.String().getClass());
+        streamsProperties.put(StreamsConfig.COMMIT_INTERVAL_MS_CONFIG, 100);
+
+
+        final KStreamBuilder builder = new KStreamBuilder();
+        builder.stream(SOURCE_TOPIC).to(SINK_TOPIC);
+
+        final KafkaStreams streams = new KafkaStreams(builder, streamsProperties);
+        System.out.println("start Kafka Streams");
+        streams.start();
+
+
+        System.out.println("send data");
+        final Properties producerProperties = new Properties();
+        producerProperties.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, kafka);
+        producerProperties.put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, StringSerializer.class);
+        producerProperties.put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, StringSerializer.class);
+
+        final KafkaProducer<String, String> producer = new KafkaProducer<>(producerProperties);
+        producer.send(new ProducerRecord<>(SOURCE_TOPIC, "key", "value"));
+
+
+        System.out.println("wait for result");
+        loopUntilRecordReceived(kafka);
+
+
+        System.out.println("close Kafka Streams");
+        streams.close();
+    }
+
+    private static void loopUntilRecordReceived(final String kafka) {
+        final Properties consumerProperties = new Properties();
+        consumerProperties.put(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG, kafka);
+        consumerProperties.put(ConsumerConfig.GROUP_ID_CONFIG, "broker-compatibility-consumer");
+        consumerProperties.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
+        consumerProperties.put(ConsumerConfig.KEY_DESERIALIZER_CLASS_CONFIG, StringDeserializer.class);
+        consumerProperties.put(ConsumerConfig.VALUE_DESERIALIZER_CLASS_CONFIG, StringDeserializer.class);
+
+        final KafkaConsumer<String, String> consumer = new KafkaConsumer<>(consumerProperties);
+        consumer.subscribe(Collections.singletonList(SINK_TOPIC));
+
+        while (true) {
+            ConsumerRecords<String, String> records = consumer.poll(100);
+            for (ConsumerRecord<String, String> record : records) {
+                if (record.key().equals("key") && record.value().equals("value")) {
+                    consumer.close();
+                    return;
+                }
+            }
+        }
+    }
+
+}
diff --git a/tests/kafkatest/services/streams.py b/tests/kafkatest/services/streams.py
index e1f292cba6aa7..a0fa412213b78 100644
--- a/tests/kafkatest/services/streams.py
+++ b/tests/kafkatest/services/streams.py
@@ -160,3 +160,11 @@ def __init__(self, test_context, kafka):
 class StreamsSmokeTestShutdownDeadlockService(StreamsSmokeTestBaseService):
     def __init__(self, test_context, kafka):
         super(StreamsSmokeTestShutdownDeadlockService, self).__init__(test_context, kafka, "close-deadlock-test")
+
+
+class StreamsBrokerCompatibilityService(StreamsTestBaseService):
+    def __init__(self, test_context, kafka):
+        super(StreamsBrokerCompatibilityService, self).__init__(test_context,
+                                                                kafka,
+                                                                "org.apache.kafka.streams.tests.BrokerCompatibilityTest",
+                                                                "dummy")
diff --git a/tests/kafkatest/tests/streams/streams_broker_compatibility.py b/tests/kafkatest/tests/streams/streams_broker_compatibility.py
new file mode 100644
index 0000000000000..7c7a751ecbc60
--- /dev/null
+++ b/tests/kafkatest/tests/streams/streams_broker_compatibility.py
@@ -0,0 +1,90 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from ducktape.mark import parametrize
+from ducktape.tests.test import Test
+
+from kafkatest.services.kafka import KafkaService
+from kafkatest.services.streams import StreamsBrokerCompatibilityService
+from kafkatest.services.verifiable_consumer import VerifiableConsumer
+from kafkatest.services.zookeeper import ZookeeperService
+from kafkatest.version import TRUNK, LATEST_0_10_1, LATEST_0_10_0, KafkaVersion
+
+
+class StreamsBrokerCompatibility(Test):
+    """
+    These tests validate that Streams v0.10.2+ can connect to older brokers v0.10+
+    and that Streams fails fast for pre-0.10 brokers
+    """
+
+    input = "brokerCompatibilitySourceTopic"
+    output = "brokerCompatibilitySinkTopic"
+
+    def __init__(self, test_context):
+        super(StreamsBrokerCompatibility, self).__init__(test_context=test_context)
+
+        self.zk = ZookeeperService(test_context, num_nodes=1)
+        self.kafka = KafkaService(test_context,
+                                  num_nodes=1,
+                                  zk=self.zk,
+                                  topics={
+                                      self.input: {'partitions': 1, 'replication-factor': 1},
+                                      self.output: {'partitions': 1, 'replication-factor': 1}
+                                  })
+
+        self.processor = StreamsBrokerCompatibilityService(self.test_context, self.kafka)
+
+        self.consumer = VerifiableConsumer(test_context,
+                                           1,
+                                           self.kafka,
+                                           self.output,
+                                           "stream-broker-compatibility-verify-consumer")
+
+    def setUp(self):
+        self.zk.start()
+
+    @parametrize(broker_version=str(TRUNK))
+    @parametrize(broker_version=str(LATEST_0_10_1))
+    def test_compatible_brokers(self, broker_version):
+        self.kafka.set_version(KafkaVersion(broker_version))
+        self.kafka.start()
+
+        self.processor.start()
+        self.consumer.start()
+
+        self.processor.wait()
+
+        num_consumed_mgs = self.consumer.total_consumed()
+
+        self.consumer.stop()
+        self.kafka.stop()
+
+        assert num_consumed_mgs == 1, \
+            "Did expect to read exactly one message but got %d" % num_consumed_mgs
+
+    @parametrize(broker_version=str(LATEST_0_10_0))
+    def test_fail_fast_on_incompatible_brokers(self, broker_version):
+        self.kafka.set_version(KafkaVersion(broker_version))
+        self.kafka.start()
+
+        self.processor.start()
+
+        self.processor.node.account.ssh(self.processor.start_cmd(self.processor.node))
+        with self.processor.node.account.monitor_log(self.processor.STDERR_FILE) as monitor:
+            monitor.wait_until('Exception in thread "main" org.apache.kafka.streams.errors.StreamsException: Kafka Streams requires broker version 0.10.1.x or higher.',
+                        timeout_sec=60,
+                        err_msg="Never saw 'incompatible broker' error message " + str(self.processor.node.account))
+
+        self.kafka.stop()

From a2a3e9dd81fb04d9f8c784d765426a0f750040b7 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Thu, 26 Jan 2017 21:50:44 -0800
Subject: [PATCH 064/177] MINOR: Streams API JavaDoc improvements

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Damian Guy, Guozhang Wang

Closes #2437 from mjsax/javaDocImprovements7

(cherry picked from commit 4277645d25e3be0276cb443a36c7ebaa0638034c)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../kafka/streams/kstream/JoinWindows.java    |   5 +-
 .../kafka/streams/kstream/KGroupedStream.java | 101 +--
 .../apache/kafka/streams/kstream/KStream.java | 628 +++++++++---------
 .../kafka/streams/kstream/KeyValueMapper.java |  10 +-
 .../kafka/streams/kstream/Predicate.java      |   7 +-
 .../apache/kafka/streams/kstream/Reducer.java |   6 +-
 .../kafka/streams/kstream/SessionWindows.java |   3 +-
 .../kafka/streams/kstream/TimeWindows.java    |   5 +-
 .../streams/kstream/UnlimitedWindows.java     |   5 +-
 .../apache/kafka/streams/kstream/Window.java  |   5 +-
 .../apache/kafka/streams/kstream/Windows.java |   5 +-
 11 files changed, 396 insertions(+), 384 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java
index f20e39f6a4d29..720efb298f1df 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java
@@ -18,6 +18,7 @@
 package org.apache.kafka.streams.kstream;
 
 import org.apache.kafka.common.annotation.InterfaceStability;
+import org.apache.kafka.streams.processor.TimestampExtractor;
 
 import java.util.Map;
 
@@ -50,7 +51,7 @@
  * This implies, that each input record defines its own window with start and end time being relative to the record's
  * timestamp.
  * <p>
- * For time semantics, see {@link org.apache.kafka.streams.processor.TimestampExtractor TimestampExtractor}.
+ * For time semantics, see {@link TimestampExtractor}.
  *
  * @see TimeWindows
  * @see UnlimitedWindows
@@ -61,7 +62,7 @@
  * @see KStream#leftJoin(KStream, ValueJoiner, JoinWindows, org.apache.kafka.common.serialization.Serde, org.apache.kafka.common.serialization.Serde, org.apache.kafka.common.serialization.Serde)
  * @see KStream#outerJoin(KStream, ValueJoiner, JoinWindows)
  * @see KStream#outerJoin(KStream, ValueJoiner, JoinWindows)
- * @see org.apache.kafka.streams.processor.TimestampExtractor
+ * @see TimestampExtractor
  */
 @InterfaceStability.Unstable
 public class JoinWindows extends Windows<Window> {
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java
index 8e69fdb89c67e..586061f3dfc69 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java
@@ -22,6 +22,7 @@
 import org.apache.kafka.streams.state.QueryableStoreType;
 import org.apache.kafka.streams.state.WindowStore;
 import org.apache.kafka.streams.state.SessionStore;
+import org.apache.kafka.streams.StreamsConfig;
 
 /**
  * {@link KGroupedStream} is an abstraction of a <i>grouped</i> record stream of key-value pairs.
@@ -49,11 +50,11 @@ public interface KGroupedStream<K, V> {
      * the same key.
      * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
      * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
+     * You can configure the cache size via {@link StreamsConfig} parameter
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
      * <p>
      * To query the local {@link KeyValueStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
      * <pre>{@code
      * KafkaStreams streams = ... // counting words
      * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
@@ -65,8 +66,8 @@ public interface KGroupedStream<K, V> {
      * <p>
      * For failure and recovery the store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-${storeName}-changelog", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
      * provide {@code storeName}, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
@@ -83,7 +84,7 @@ public interface KGroupedStream<K, V> {
      * Furthermore, updates to the store are sent downstream into a {@link KTable} changelog stream.
      * <p>
      * To query the local {@link KeyValueStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
      * <pre>{@code
      * KafkaStreams streams = ... // counting words
@@ -116,11 +117,11 @@ public interface KGroupedStream<K, V> {
      * the same window and key.
      * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
      * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
+     * You can configure the cache size via {@link StreamsConfig} parameter
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
      * <p>
      * To query the local windowed {@link KeyValueStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
      * <pre>{@code
      * KafkaStreams streams = ... // counting words
      * ReadOnlyWindowStore<String,Long> localWindowStore = streams.store(storeName, QueryableStoreTypes.<String, Long>windowStore());
@@ -134,8 +135,8 @@ public interface KGroupedStream<K, V> {
      * <p>
      * For failure and recovery the store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-${storeName}-changelog", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
+     * user-specified in {@link StreamsConfig StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
      * provide {@code storeName}, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
@@ -158,7 +159,7 @@ <W extends Window> KTable<Windowed<K>, Long> count(final Windows<W> windows,
      * "windowed" implies that the {@link KTable} key is a combined key of the original record key and a window ID.
      * <p>
      * To query the local windowed {@link KeyValueStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
      * <pre>{@code
      * KafkaStreams streams = ... // counting words
@@ -191,7 +192,7 @@ <W extends Window> KTable<Windowed<K>, Long> count(final Windows<W> windows,
      * "windowed" implies that the {@link KTable} key is a combined key of the original record key and a window ID.
      * <p>
      * To query the local {@link SessionStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
      * <pre>{@code
      * KafkaStreams streams = ... // counting words
@@ -221,7 +222,7 @@ <W extends Window> KTable<Windowed<K>, Long> count(final Windows<W> windows,
      * "windowed" implies that the {@link KTable} key is a combined key of the original record key and a window ID.
      * <p>
      * To query the local {@link SessionStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
      * <pre>{@code
      * KafkaStreams streams = ... // counting words
@@ -256,8 +257,8 @@ KTable<Windowed<K>, Long> count(final SessionWindows sessionWindows,
      * the same key.
      * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
      * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
+     * You can configure the cache size via {@link StreamsConfig} parameter
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
      * <p>
      * The specified {@link Reducer} is applied for each input record and computes a new aggregate using the current
      * aggregate and the record's value.
@@ -266,7 +267,7 @@ KTable<Windowed<K>, Long> count(final SessionWindows sessionWindows,
      * Thus, {@code reduce(Reducer, String)} can be used to compute aggregate functions like sum, min, or max.
      * <p>
      * To query the local {@link KeyValueStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
      * <pre>{@code
      * KafkaStreams streams = ... // compute sum
      * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
@@ -278,8 +279,8 @@ KTable<Windowed<K>, Long> count(final SessionWindows sessionWindows,
      * <p>
      * For failure and recovery the store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-${storeName}-changelog", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
      * provide {@code storeName}, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
@@ -307,7 +308,7 @@ KTable<K, V> reduce(final Reducer<V> reducer,
      * max.
      * <p>
      * To query the local {@link KeyValueStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
      * <pre>{@code
      * KafkaStreams streams = ... // compute sum
@@ -343,8 +344,8 @@ KTable<K, V> reduce(final Reducer<V> reducer,
      * the same key.
      * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
      * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
+     * You can configure the cache size via {@link StreamsConfig} parameter
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
      * <p>
      * The specified {@link Reducer} is applied for each input record and computes a new aggregate using the current
      * aggregate and the record's value.
@@ -353,7 +354,7 @@ KTable<K, V> reduce(final Reducer<V> reducer,
      * Thus, {@code reduce(Reducer, Windows, String)} can be used to compute aggregate functions like sum, min, or max.
      * <p>
      * To query the local windowed {@link KeyValueStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
      * <pre>{@code
      * KafkaStreams streams = ... // compute sum
      * ReadOnlyWindowStore<String,Long> localWindowStore = streams.store(storeName, QueryableStoreTypes.<String, Long>windowStore());
@@ -367,8 +368,8 @@ KTable<K, V> reduce(final Reducer<V> reducer,
      * <p>
      * For failure and recovery the store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-${storeName}-changelog", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
      * provide {@code storeName}, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
@@ -402,7 +403,7 @@ <W extends Window> KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      * min, or max.
      * <p>
      * To query the local windowed {@link KeyValueStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
      * <pre>{@code
      * KafkaStreams streams = ... // compute sum
@@ -440,8 +441,8 @@ <W extends Window> KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      * the same key.
      * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
      * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
+     * You can configure the cache size via {@link StreamsConfig} parameter
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
      * <p>
      * The specified {@link Reducer} is applied for each input record and computes a new aggregate using the current
      * aggregate and the record's value.
@@ -451,7 +452,7 @@ <W extends Window> KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      * or max.
      * <p>
      * To query the local {@link SessionStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
      * <pre>{@code
      * KafkaStreams streams = ... // compute sum
      * ReadOnlySessionStore<String,Long> sessionStore = streams.store(storeName, QueryableStoreTypes.<String, Long>sessionStore());
@@ -463,8 +464,8 @@ <W extends Window> KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      * <p>
      * For failure and recovery the store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-${storeName}-changelog", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
      * provide {@code storeName}, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * @param reducer           the instance of {@link Reducer}
@@ -491,8 +492,8 @@ KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      * the same key.
      * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
      * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
+     * You can configure the cache size via {@link StreamsConfig} parameter
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
      * <p>
      * The specified {@link Reducer} is applied for each input record and computes a new aggregate using the current
      * aggregate and the record's value.
@@ -502,7 +503,7 @@ KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      * sum, min, or max.
      * <p>
      * To query the local {@link SessionStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
      * <pre>{@code
      * KafkaStreams streams = ... // compute sum
      * ReadOnlySessionStore<String,Long> sessionStore = streams.store(storeName, QueryableStoreTypes.<String, Long>sessionStore());
@@ -514,8 +515,8 @@ KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      * <p>
      * For failure and recovery the store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-${storeName}-changelog", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
      * provide {@code storeName}, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * @param reducer           the instance of {@link Reducer}
@@ -543,8 +544,8 @@ KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      * the same key.
      * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
      * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
+     * You can configure the cache size via {@link StreamsConfig} parameter
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
      * <p>
      * The specified {@link Initializer} is applied once directly before the first input record is processed to
      * provide an initial intermediate aggregation result that is used to process the first record.
@@ -555,7 +556,7 @@ KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      * count (c.f. {@link #count(String)})
      * <p>
      * To query the local {@link KeyValueStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
      * <pre>{@code
      * KafkaStreams streams = ... // some aggregation on value type double
      * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
@@ -567,8 +568,8 @@ KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      * <p>
      * For failure and recovery the store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-${storeName}-changelog", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
      * provide {@code storeName}, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
@@ -603,7 +604,7 @@ <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
      * like count (c.f. {@link #count(String)})
      * <p>
      * To query the local {@link KeyValueStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
      * <pre>{@code
      * KafkaStreams streams = ... // some aggregation on value type double
@@ -642,8 +643,8 @@ <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
      * the same key.
      * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
      * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
+     * You can configure the cache size via {@link StreamsConfig} parameter
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
      * <p>
      * The specified {@link Initializer} is applied once per window directly before the first input record is
      * processed to provide an initial intermediate aggregation result that is used to process the first record.
@@ -654,7 +655,7 @@ <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
      * functions like count (c.f. {@link #count(String)})
      * <p>
      * To query the local windowed {@link KeyValueStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
      * <pre>{@code
      * KafkaStreams streams = ... // some windowed aggregation on value type double
      * ReadOnlyWindowStore<String,Long> localWindowStore = streams.store(storeName, QueryableStoreTypes.<String, Long>windowStore());
@@ -668,8 +669,8 @@ <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
      * <p>
      * For failure and recovery the store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-${storeName}-changelog", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
      * provide {@code storeName}, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
@@ -711,7 +712,7 @@ <W extends Window, VR> KTable<Windowed<K>, VR> aggregate(final Initializer<VR> i
      * functions like count (c.f. {@link #count(String)}) TODO add more examples.
      * <p>
      * To query the local windowed {@link KeyValueStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
      * <pre>{@code
      * KafkaStreams streams = ... // some windowed aggregation on value type double TODO update example
@@ -758,7 +759,7 @@ <W extends Window, VR> KTable<Windowed<K>, VR> aggregate(final Initializer<VR> i
      * aggregate functions like count (c.f. {@link #count(String)})
      * <p>
      * To query the local {@link SessionStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
      * <pre>{@code
      * KafkaStreams streams = ... // some windowed aggregation on value type double
@@ -808,7 +809,7 @@ <T> KTable<Windowed<K>, T> aggregate(final Initializer<T> initializer,
      * to compute aggregate functions like count (c.f. {@link #count(String)})
      * <p>
      * To query the local {@link SessionStore} it must be obtained via
-     * {@link org.apache.kafka.streams.KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
      * <pre>{@code
      * KafkaStreams streams = ... // some windowed aggregation on value type double
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
index 8a18a5a1e78a4..2b8e040326e81 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
@@ -16,27 +16,33 @@
  */
 package org.apache.kafka.streams.kstream;
 
+import org.apache.kafka.clients.producer.internals.DefaultPartitioner;
 import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.common.serialization.Serde;
 import org.apache.kafka.streams.KafkaStreams;
 import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.StreamsConfig;
+import org.apache.kafka.streams.kstream.internals.WindowedSerializer;
+import org.apache.kafka.streams.kstream.internals.WindowedStreamPartitioner;
+import org.apache.kafka.streams.processor.Processor;
+import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.ProcessorSupplier;
 import org.apache.kafka.streams.processor.StreamPartitioner;
+import org.apache.kafka.streams.processor.TopologyBuilder;
 
 /**
- * {@link KStream} is an abstraction of a <i>record stream</i> of key-value pairs,
- * i.e., each record is an independent entity/event in the real world.
+ * {@link KStream} is an abstraction of a <i>record stream</i> of key-value pairs, i.e., each record is an independent
+ * entity/event in the real world.
  * For example a user X might buy two items I1 and I2, and thus there might be two records {@code <K:I1>, <K:I2>}
  * in the stream.
  * <p>
- * A {@link KStream} is either defined from one or multiple Kafka topics that are consumed message by message or
- * the result of a {@link KStream} transformation.
+ * A {@link KStream} is either defined from one or multiple Kafka topics that are consumed message by message or the
+ * result of a {@link KStream} transformation.
  * A {@link KTable} can also be converted into a {@link KStream}.
  * <p>
- * A {@link KStream} can be transformed record by record, joined with another {@link KStream} or {@link KTable}, or
- * can be aggregated into a {@link KTable}.
- * Kafka Streams DSL can be mixed-and-matched with Processor API (PAPI) (c.f.
- * {@link org.apache.kafka.streams.processor.TopologyBuilder TopologyBuilder}) via
+ * A {@link KStream} can be transformed record by record, joined with another {@link KStream}, {@link KTable},
+ * {@link GlobalKTable}, or can be aggregated into a {@link KTable}.
+ * Kafka Streams DSL can be mixed-and-matched with Processor API (PAPI) (c.f. {@link TopologyBuilder}) via
  * {@link #process(ProcessorSupplier, String...) process(...)},
  * {@link #transform(TransformerSupplier, String...) transform(...)}, and
  * {@link #transformValues(ValueTransformerSupplier, String...) transformValues(...)}.
@@ -44,14 +50,16 @@
  * @param <K> Type of keys
  * @param <V> Type of values
  * @see KTable
+ * @see KGroupedStream
  */
 @SuppressWarnings("unused")
 @InterfaceStability.Unstable
 public interface KStream<K, V> {
 
     /**
-     * Create a new {@link KStream} that consists of all records of this stream which satisfy a predicate.
-     * All records that do not satisfy the predicate are dropped. This is a stateless record-by-record operation.
+     * Create a new {@link KStream} that consists of all records of this stream which satisfy the given predicate.
+     * All records that do not satisfy the predicate are dropped.
+     * This is a stateless record-by-record operation.
      *
      * @param predicate a filter {@link Predicate} that is applied to each record
      * @return a {@link KStream} that contains only those records that satisfy the given predicate
@@ -60,8 +68,10 @@ public interface KStream<K, V> {
     KStream<K, V> filter(Predicate<? super K, ? super V> predicate);
 
     /**
-     * Create a new {@link KStream} that consists all records of this stream which do <em>not</em> satisfy a predicate.
-     * All records that <em>do</em> satisfy the predicate are dropped. This is a stateless record-by-record operation.
+     * Create a new {@link KStream} that consists all records of this stream which do <em>not</em> satisfy the given
+     * predicate.
+     * All records that <em>do</em> satisfy the predicate are dropped.
+     * This is a stateless record-by-record operation.
      *
      * @param predicate a filter {@link Predicate} that is applied to each record
      * @return a {@link KStream} that contains only those records that do <em>not</em> satisfy the given predicate
@@ -79,7 +89,7 @@ public interface KStream<K, V> {
      * extracting a key from the value within your {@link KeyValueMapper}. The example below computes the new key as the
      * length of the value string.
      * <pre>{@code
-     * KStream<Byte[], String> keyLessStream = builder.from("key-less-topic");
+     * KStream<Byte[], String> keyLessStream = builder.stream("key-less-topic");
      * KStream<Integer, String> keyedStream = keyLessStream.selectKey(new KeyValueMapper<Byte[], String, Integer> {
      *     Integer apply(Byte[] key, String value) {
      *         return value.length();
@@ -101,8 +111,8 @@ public interface KStream<K, V> {
     <KR> KStream<KR, V> selectKey(KeyValueMapper<? super K, ? super V, ? extends KR> mapper);
 
     /**
-     * Transform each record of the input stream into a new record in the output stream
-     * (both key and value type can be altered arbitrarily).
+     * Transform each record of the input stream into a new record in the output stream (both key and value type can be
+     * altered arbitrarily).
      * The provided {@link KeyValueMapper} is applied to each input record and computes a new output record.
      * Thus, an input record {@code <K,V>} can be transformed into an output record {@code <K':V'>}.
      * This is a stateless record-by-record operation (cf. {@link #transform(TransformerSupplier, String...)} for
@@ -110,7 +120,7 @@ public interface KStream<K, V> {
      * <p>
      * The example below normalizes the String key to upper-case letters and counts the number of token of the value string.
      * <pre>{@code
-     * KStream<String, String> inputStream = builder.from("topic");
+     * KStream<String, String> inputStream = builder.stream("topic");
      * KStream<Integer, String> outputStream = inputStream.map(new KeyValueMapper<String, String, KeyValue<String, Integer>> {
      *     KeyValue<String, Integer> apply(String key, String value) {
      *         return new KeyValue<>(key.toUpperCase(), value.split(" ").length);
@@ -145,8 +155,8 @@ public interface KStream<K, V> {
      * <p>
      * The example below counts the number of token of the value string.
      * <pre>{@code
-     * KStream<String, String> inputStream = builder.from("topic");
-     * KStream<String, Integer> outputStream = inputStream.map(new ValueMapper<String, Integer> {
+     * KStream<String, String> inputStream = builder.stream("topic");
+     * KStream<String, Integer> outputStream = inputStream.mapValues(new ValueMapper<String, Integer> {
      *     Integer apply(String value) {
      *         return value.split(" ").length;
      *     }
@@ -180,7 +190,7 @@ public interface KStream<K, V> {
      * The example below splits input records {@code <null:String>} containing sentences as values into their words
      * and emit a record {@code <word:1>} for each word.
      * <pre>{@code
-     * KStream<byte[], String> inputStream = builder.from("topic");
+     * KStream<byte[], String> inputStream = builder.stream("topic");
      * KStream<Integer, String> outputStream = inputStream.flatMap(new KeyValueMapper<byte[], String, Iterable<KeyValue<String, Integer>>> {
      *     Iterable<KeyValue<String, Integer>> apply(byte[] key, String value) {
      *         String[] tokens = value.split(" ");
@@ -215,8 +225,8 @@ public interface KStream<K, V> {
     <KR, VR> KStream<KR, VR> flatMap(final KeyValueMapper<? super K, ? super V, ? extends Iterable<? extends KeyValue<? extends KR, ? extends VR>>> mapper);
 
     /**
-     * Create a new instance of {@link KStream} by transforming the value of each element in this stream into zero or
-     * more values with the same key in the new stream.
+     * Create a new {@link KStream} by transforming the value of each record in this stream into zero or more values
+     * with the same key in the new stream.
      * Transform the value of each input record into zero or more records with the same (unmodified) key in the output
      * stream (value type can be altered arbitrarily).
      * The provided {@link ValueMapper} is applied to each input record and computes zero or more output values.
@@ -226,7 +236,7 @@ public interface KStream<K, V> {
      * <p>
      * The example below splits input records {@code <null:String>} containing sentences as values into their words.
      * <pre>{@code
-     * KStream<byte[], String> inputStream = builder.from("topic");
+     * KStream<byte[], String> inputStream = builder.stream("topic");
      * KStream<Integer, String> outputStream = inputStream.flatMap(new ValueMapper<String, Iterable<String>> {
      *     Iterable<String> apply(String value) {
      *         return Arrays.asList(value.split(" "));
@@ -254,19 +264,25 @@ public interface KStream<K, V> {
     <VR> KStream<K, VR> flatMapValues(final ValueMapper<? super V, ? extends Iterable<? extends VR>> processor);
 
     /**
-     * Print the elements of this stream to {@code System.out}.
+     * Print the records of this stream to {@code System.out}.
      * This function will use the generated name of the parent processor node to label the key/value pairs printed out
      * to the console.
      * <p>
+     * The default serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
+     * {@code toString()} on the deserialized object.
+     * <p>
      * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
      * {@link Integer} etc. to get meaningful information.
      */
     void print();
 
     /**
-     * Print the elements of this stream to {@code System.out}.
+     * Print the records of this stream to {@code System.out}.
      * This function will use the given name to label the key/value pairs printed out to the console.
      * <p>
+     * The default serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
+     * {@code toString()} on the deserialized object.
+     * <p>
      * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
      * {@link Integer} etc. to get meaningful information.
      *
@@ -275,11 +291,11 @@ public interface KStream<K, V> {
     void print(final String streamName);
 
     /**
-     * Print the elements of this stream to {@code System.out}.
+     * Print the records of this stream to {@code System.out}.
      * This function will use the generated name of the parent processor node to label the key/value pairs printed out
      * to the console.
      * <p>
-     * The provided serde will be use to deserialize the key or value in case the type is {@code byte[]} before calling
+     * The provided serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
      * {@code toString()} on the deserialized object.
      * <p>
      * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
@@ -292,9 +308,9 @@ void print(final Serde<K> keySerde,
                final Serde<V> valSerde);
 
     /**
-     * Print the elements of this stream to {@code System.out}.
+     * Print the records of this stream to {@code System.out}.
      * <p>
-     * The provided serde will be use to deserialize the key or value in case the type is {@code byte[]} before calling
+     * The provided serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
      * {@code toString()} on the deserialized object.
      * <p>
      * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
@@ -309,10 +325,13 @@ void print(final Serde<K> keySerde,
                final String streamName);
 
     /**
-     * Write the elements of this stream to a file at the given path.
+     * Write the records of this stream to a file at the given path.
      * This function will use the generated name of the parent processor node to label the key/value pairs printed out
      * to the file.
      * <p>
+     * The default serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
+     * {@code toString()} on the deserialized object.
+     * <p>
      * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
      * {@link Integer} etc. to get meaningful information.
      *
@@ -321,9 +340,12 @@ void print(final Serde<K> keySerde,
     void writeAsText(final String filePath);
 
     /**
-     * Write the elements of this stream to a file at the given path.
+     * Write the records of this stream to a file at the given path.
      * This function will use the given name to label the key/value printed out to the file.
      * <p>
+     * The default serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
+     * {@code toString()} on the deserialized object.
+     * <p>
      * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
      * {@link Integer} etc. to get meaningful information.
      *
@@ -334,7 +356,7 @@ void writeAsText(final String filePath,
                      final String streamName);
 
     /**
-     * Write the elements of this stream to a file at the given path.
+     * Write the records of this stream to a file at the given path.
      * This function will use the generated name of the parent processor node to label the key/value pairs printed out
      * to the file.
      * <p>
@@ -353,7 +375,7 @@ void writeAsText(final String filePath,
                      final Serde<V> valSerde);
 
     /**
-     * Write the elements of this stream to a file at the given path.
+     * Write the records of this stream to a file at the given path.
      * This function will use the given name to label the key/value printed out to the file.
      * <p>
      * The provided serde will be used to deserialize the key or value in case the type is {@code byte[]}
@@ -383,13 +405,13 @@ void writeAsText(final String filePath,
     void foreach(final ForeachAction<? super K, ? super V> action);
 
     /**
-     * Creates an array of {@link KStream} from this stream by branching the elements in the original stream based on
+     * Creates an array of {@link KStream} from this stream by branching the records in the original stream based on
      * the supplied predicates.
-     * Each element is evaluated against the supplied predicates, and predicates are evaluated in order.
+     * Each record is evaluated against the supplied predicates, and predicates are evaluated in order.
      * Each stream in the result array corresponds position-wise (index) to the predicate in the supplied predicates.
-     * The branching happens on first-match: An element in the original stream is assigned to the corresponding result
+     * The branching happens on first-match: A record in the original stream is assigned to the corresponding result
      * stream for the first predicate that evaluates to true, and is assigned to this stream only.
-     * An element will be dropped if none of the predicates evaluate to true.
+     * A record will be dropped if none of the predicates evaluate to true.
      * This is a stateless record-by-record operation.
      *
      * @param predicates the ordered list of {@link Predicate} instances
@@ -399,74 +421,66 @@ void writeAsText(final String filePath,
     KStream<K, V>[] branch(final Predicate<? super K, ? super V>... predicates);
 
     /**
-     * Materialize this stream to a topic and creates a new instance of {@link KStream} from the topic using default
-     * serializers and deserializers and producer's
-     * {@link org.apache.kafka.clients.producer.internals.DefaultPartitioner DefaultPartitioner}.
+     * Materialize this stream to a topic and creates a new {@link KStream} from the topic using default serializers and
+     * deserializers and producer's {@link DefaultPartitioner}.
      * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
      * started).
      * <p>
-     * This is equivalent to calling {@link #to(String) #to(someTopicName)} and
-     * {@link org.apache.kafka.streams.kstream.KStreamBuilder#stream(String...) KStreamBuilder#stream(someTopicName)}.
+     * This is equivalent to calling {@link #to(String) #to(someTopicName)} and {@link KStreamBuilder#stream(String...)
+     * KStreamBuilder#stream(someTopicName)}.
      *
      * @param topic the topic name
-     * @return a {@link KStream} that contains the exact same records as this {@link KStream}
+     * @return a {@link KStream} that contains the exact same (and potentially repartitioned) records as this {@link KStream}
      */
     KStream<K, V> through(final String topic);
 
     /**
-     * Materialize this stream to a topic and creates a new instance of {@link KStream} from the topic using default
-     * serializers and deserializers and a customizable {@link StreamPartitioner} to determine the distribution of
-     * records to partitions.
+     * Materialize this stream to a topic and creates a new {@link KStream} from the topic using default serializers and
+     * deserializers and a customizable {@link StreamPartitioner} to determine the distribution of records to partitions.
      * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
      * started).
      * <p>
      * This is equivalent to calling {@link #to(StreamPartitioner, String) #to(StreamPartitioner, someTopicName)} and
-     * {@link org.apache.kafka.streams.kstream.KStreamBuilder#stream(String...) KStreamBuilder#stream(someTopicName)}.
+     * {@link KStreamBuilder#stream(String...) KStreamBuilder#stream(someTopicName)}.
      *
      * @param partitioner the function used to determine how records are distributed among partitions of the topic,
-     *                    if not specified producer's
-     *                    {@link org.apache.kafka.clients.producer.internals.DefaultPartitioner DefaultPartitioner}
-     *                    will be used
+     *                    if not specified producer's {@link DefaultPartitioner} will be used
      * @param topic       the topic name
-     * @return a {@link KStream} that contains the exact same records as this {@link KStream}
+     * @return a {@link KStream} that contains the exact same (and potentially repartitioned) records as this {@link KStream}
      */
     KStream<K, V> through(final StreamPartitioner<? super K, ? super V> partitioner,
                           final String topic);
 
     /**
-     * Materialize this stream to a topic, and creates a new instance of {@link KStream} from the topic.
+     * Materialize this stream to a topic, and creates a new {@link KStream} from the topic.
      * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
      * started).
      * <p>
-     * If {@code keySerde} provides a {@link org.apache.kafka.streams.kstream.internals.WindowedSerializer
-     * WindowedSerializer} for the key {@link org.apache.kafka.streams.kstream.internals.WindowedStreamPartitioner
-     * WindowedStreamPartitioner} is used&mdash;otherwise producer's
-     * {@link org.apache.kafka.clients.producer.internals.DefaultPartitioner DefaultPartitioner} is used.
+     * If {@code keySerde} provides a {@link WindowedSerializer} for the key {@link WindowedStreamPartitioner} is
+     * used&mdash;otherwise producer's {@link DefaultPartitioner} is used.
      * <p>
      * This is equivalent to calling {@link #to(Serde, Serde, String) #to(keySerde, valSerde, someTopicName)} and
-     * {@link org.apache.kafka.streams.kstream.KStreamBuilder#stream(Serde, Serde, String...)
-     * KStreamBuilder#stream(keySerde, valSerde, someTopicName)}.
+     * {@link KStreamBuilder#stream(Serde, Serde, String...) KStreamBuilder#stream(keySerde, valSerde, someTopicName)}.
      *
      * @param keySerde key serde used to send key-value pairs,
      *                 if not specified the default key serde defined in the configuration will be used
      * @param valSerde value serde used to send key-value pairs,
      *                 if not specified the default value serde defined in the configuration will be used
      * @param topic    the topic name
-     * @return a {@link KStream} that contains the exact same records as this {@link KStream}
+     * @return a {@link KStream} that contains the exact same (and potentially repartitioned) records as this {@link KStream}
      */
     KStream<K, V> through(final Serde<K> keySerde,
                           final Serde<V> valSerde,
                           final String topic);
 
     /**
-     * Materialize this stream to a topic and creates a new instance of {@link KStream} from the topic
-     * using a customizable {@link StreamPartitioner} to determine the distribution of records to partitions.
+     * Materialize this stream to a topic and creates a new {@link KStream} from the topic using a customizable
+     * {@link StreamPartitioner} to determine the distribution of records to partitions.
      * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
      * started).
      * <p>
      * This is equivalent to calling {@link #to(Serde, Serde, StreamPartitioner, String) #to(keySerde, valSerde,
-     * StreamPartitioner, someTopicName)} and
-     * {@link org.apache.kafka.streams.kstream.KStreamBuilder#stream(Serde, Serde, String...)
+     * StreamPartitioner, someTopicName)} and {@link KStreamBuilder#stream(Serde, Serde, String...)
      * KStreamBuilder#stream(keySerde, valSerde, someTopicName)}.
      *
      * @param keySerde    key serde used to send key-value pairs,
@@ -474,14 +488,11 @@ KStream<K, V> through(final Serde<K> keySerde,
      * @param valSerde    value serde used to send key-value pairs,
      *                    if not specified the default value serde defined in the configuration will be used
      * @param partitioner the function used to determine how records are distributed among partitions of the topic,
-     *                    if not specified and {@code keySerde} provides a
-     *                    {@link org.apache.kafka.streams.kstream.internals.WindowedSerializer WindowedSerializer} for
-     *                    the key {@link org.apache.kafka.streams.kstream.internals.WindowedStreamPartitioner
-     *                    WindowedStreamPartitioner} will be used&mdash;otherwise
-     *                    {@link org.apache.kafka.clients.producer.internals.DefaultPartitioner DefaultPartitioner} will
+     *                    if not specified and {@code keySerde} provides a {@link WindowedSerializer} for the key
+     *                    {@link WindowedStreamPartitioner} will be used&mdash;otherwise {@link DefaultPartitioner} will
      *                    be used
      * @param topic       the topic name
-     * @return a {@link KStream} that contains the exact same records as this {@link KStream}
+     * @return a {@link KStream} that contains the exact same (and potentially repartitioned) records as this {@link KStream}
      */
     KStream<K, V> through(final Serde<K> keySerde,
                           final Serde<V> valSerde,
@@ -490,7 +501,7 @@ KStream<K, V> through(final Serde<K> keySerde,
 
     /**
      * Materialize this stream to a topic using default serializers specified in the config and producer's
-     * {@link org.apache.kafka.clients.producer.internals.DefaultPartitioner DefaultPartitioner}.
+     * {@link DefaultPartitioner}.
      * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
      * started).
      *
@@ -505,20 +516,16 @@ KStream<K, V> through(final Serde<K> keySerde,
      * started).
      *
      * @param partitioner the function used to determine how records are distributed among partitions of the topic,
-     *                    if not specified producer's
-     *                    {@link org.apache.kafka.clients.producer.internals.DefaultPartitioner DefaultPartitioner} will
-     *                    be used
+     *                    if not specified producer's {@link DefaultPartitioner} will be used
      * @param topic       the topic name
      */
     void to(final StreamPartitioner<? super K, ? super V> partitioner,
             final String topic);
 
     /**
-     * Materialize this stream to a topic. If {@code keySerde} provides a
-     * {@link org.apache.kafka.streams.kstream.internals.WindowedSerializer WindowedSerializer} for the key
-     * {@link org.apache.kafka.streams.kstream.internals.WindowedStreamPartitioner WindowedStreamPartitioner} is
-     * used&mdash;otherwise producer's {@link org.apache.kafka.clients.producer.internals.DefaultPartitioner
-     * DefaultPartitioner} is used.
+     * Materialize this stream to a topic. If {@code keySerde} provides a {@link WindowedSerializer WindowedSerializer}
+     * for the key {@link WindowedStreamPartitioner} is used&mdash;otherwise producer's {@link DefaultPartitioner} is
+     * used.
      * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
      * started).
      *
@@ -543,11 +550,8 @@ void to(final Serde<K> keySerde,
      * @param valSerde    value serde used to send key-value pairs,
      *                    if not specified the default serde defined in the configs will be used
      * @param partitioner the function used to determine how records are distributed among partitions of the topic,
-     *                    if not specified and {@code keySerde} provides a
-     *                    {@link org.apache.kafka.streams.kstream.internals.WindowedSerializer WindowedSerializer} for
-     *                    the key {@link org.apache.kafka.streams.kstream.internals.WindowedStreamPartitioner
-     *                    WindowedStreamPartitioner} will be used&mdash;otherwise
-     *                    {@link org.apache.kafka.clients.producer.internals.DefaultPartitioner DefaultPartitioner} will
+     *                    if not specified and {@code keySerde} provides a {@link  WindowedSerializer} for the key
+     *                    {@link WindowedStreamPartitioner} will be used&mdash;otherwise {@link DefaultPartitioner} will
      *                    be used
      * @param topic       the topic name
      */
@@ -582,7 +586,7 @@ void to(final Serde<K> keySerde,
      * }</pre>
      * <p>
      * Within the {@link Transformer}, the state is obtained via the
-     * {@link org.apache.kafka.streams.processor.ProcessorContext ProcessorContext}.
+     * {@link  ProcessorContext}.
      * To trigger periodic actions via {@link Transformer#punctuate(long) punctuate()}, a schedule must be registered.
      * The {@link Transformer} must return a {@link KeyValue} type in {@link Transformer#transform(Object, Object)
      * transform()} and {@link Transformer#punctuate(long) punctuate()}.
@@ -661,11 +665,11 @@ <K1, V1> KStream<K1, V1> transform(final TransformerSupplier<? super K, ? super
      * }</pre>
      * <p>
      * Within the {@link ValueTransformer}, the state is obtained via the
-     * {@link org.apache.kafka.streams.processor.ProcessorContext ProcessorContext}.
+     * {@link ProcessorContext}.
      * To trigger periodic actions via {@link ValueTransformer#punctuate(long) punctuate()}, a schedule must be
      * registered.
      * In contrast to {@link #transform(TransformerSupplier, String...) transform()}, no additional {@link KeyValue}
-     * pairs should be emitted via {@link org.apache.kafka.streams.processor.ProcessorContext#forward(Object, Object)
+     * pairs should be emitted via {@link ProcessorContext#forward(Object, Object)
      * ProcessorContext.forward()}.
      * <pre>{@code
      * new ValueTransformerSupplier() {
@@ -712,11 +716,11 @@ <VR> KStream<K, VR> transformValues(final ValueTransformerSupplier<? super V, ?
                                         final String... stateStoreNames);
 
     /**
-     * Process all elements in this stream, one element at a time, by applying a
-     * {@link org.apache.kafka.streams.processor.Processor Processor} (provided by the given {@link ProcessorSupplier}).
+     * Process all records in this stream, one record at a time, by applying a {@link Processor} (provided by the given
+     * {@link ProcessorSupplier}).
      * This is a stateful record-by-record operation (cf. {@link #foreach(ForeachAction)}).
-     * Furthermore, via {@link org.apache.kafka.streams.processor.Processor#punctuate(long) Processor.punctuate(long)}
-     * the processing progress can be observed and additional periodic actions can be performed.
+     * Furthermore, via {@link Processor#punctuate(long)} the processing progress can be observed and additional
+     * periodic actions can be performed.
      * Note that this is a terminal operation that returns void.
      * <p>
      * In order to assign a state, the state must be created and registered beforehand:
@@ -734,9 +738,9 @@ <VR> KStream<K, VR> transformValues(final ValueTransformerSupplier<? super V, ?
      * inputStream.process(new ProcessorSupplier() { ... }, "myProcessorState");
      * }</pre>
      * <p>
-     * Within the {@link org.apache.kafka.streams.processor.Processor Processor}, the state is obtained via the
-     * {@link org.apache.kafka.streams.processor.ProcessorContext ProcessorContext}.
-     * To trigger periodic actions via {@link org.apache.kafka.streams.processor.Processor#punctuate(long) punctuate()},
+     * Within the {@link Processor}, the state is obtained via the
+     * {@link ProcessorContext}.
+     * To trigger periodic actions via {@link Processor#punctuate(long) punctuate()},
      * a schedule must be registered.
      * <pre>{@code
      * new ProcessorSupplier() {
@@ -765,8 +769,7 @@ <VR> KStream<K, VR> transformValues(final ValueTransformerSupplier<? super V, ?
      * }
      * }</pre>
      *
-     * @param processorSupplier a instance of {@link ProcessorSupplier} that generates a
-     *                          {@link org.apache.kafka.streams.processor.Processor}
+     * @param processorSupplier a instance of {@link ProcessorSupplier} that generates a {@link Processor}
      * @param stateStoreNames   the names of the state store used by the processor
      * @see #foreach(ForeachAction)
      * @see #transform(TransformerSupplier, String...)
@@ -775,36 +778,59 @@ void process(final ProcessorSupplier<? super K, ? super V> processorSupplier,
                  final String... stateStoreNames);
 
     /**
-     * Group the records of this {@link KStream} on a new key that is selected using the provided {@link KeyValueMapper}.
+     * Group the records by their current key into a {@link KGroupedStream} while preserving the original values
+     * and default serializers and deserializers.
      * Grouping a stream on the record key is required before an aggregation operator can be applied to the data
      * (cf. {@link KGroupedStream}).
-     * The {@link KeyValueMapper} selects a new key (with potentially different type) while preserving the original values.
-     * If the new record key is {@code null} the record will not be included in the resulting {@link KGroupedStream}.
+     * If a record key is {@code null} the record will not be included in the resulting {@link KGroupedStream}.
      * <p>
-     * Because a new key is selected, an internal repartitioning topic will be created in Kafka.
+     * If a key changing operator was used before this operation (e.g., {@link #selectKey(KeyValueMapper)},
+     * {@link #map(KeyValueMapper)}, {@link #flatMap(KeyValueMapper)}, or
+     * {@link #transform(TransformerSupplier, String...)}), and no data redistribution happened afterwards (e.g., via
+     * {@link #through(String)}) an internal repartitioning topic will be created in Kafka.
      * This topic will be named "${applicationId}-XXX-repartition", where "applicationId" is user-specified in
-     * {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internal
-     * generated name, and "-repartition" is a fixed suffix.
+     * {@link StreamsConfig} via parameter {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is
+     * an internally generated name, and "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * All data of this stream will be redistributed through the repartitioning topic by writing all records to
-     * and rereading all records from it, such that the resulting {@link KGroupedStream} is partitioned on the new key.
+     * For this case, all data of this stream will be redistributed through the repartitioning topic by writing all
+     * records to it, and rereading all records from it, such that the resulting {@link KGroupedStream} is partitioned
+     * correctly on its key.
+     * If the last key changing operator changed the key type, it is recommended to use
+     * {@link #groupByKey(Serde, Serde)} instead.
+     *
+     * @return a {@link KGroupedStream} that contains the grouped records of the original {@link KStream}
+     * @see #groupBy(KeyValueMapper)
+     */
+    KGroupedStream<K, V> groupByKey();
+
+    /**
+     * Group the records by their current key into a {@link KGroupedStream} while preserving the original values.
+     * Grouping a stream on the record key is required before an aggregation operator can be applied to the data
+     * (cf. {@link KGroupedStream}).
+     * If a record key is {@code null} the record will not be included in the resulting {@link KGroupedStream}.
      * <p>
-     * This is equivalent to calling {@link #selectKey(KeyValueMapper)} followed by {@link #groupByKey(Serde, Serde)}.
+     * If a key changing operator was used before this operation (e.g., {@link #selectKey(KeyValueMapper)},
+     * {@link #map(KeyValueMapper)}, {@link #flatMap(KeyValueMapper)}, or
+     * {@link #transform(TransformerSupplier, String...)}), and no data redistribution happened afterwards (e.g., via
+     * {@link #through(String)}) an internal repartitioning topic will be created in Kafka.
+     * This topic will be named "${applicationId}-XXX-repartition", where "applicationId" is user-specified in
+     * {@link StreamsConfig} via parameter {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is
+     * an internally generated name, and "-repartition" is a fixed suffix.
+     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
+     * <p>
+     * For this case, all data of this stream will be redistributed through the repartitioning topic by writing all
+     * records to it, and rereading all records from it, such that the resulting {@link KGroupedStream} is partitioned
+     * correctly on its key.
      *
-     * @param selector a {@link KeyValueMapper} that computes a new key for grouping
      * @param keySerde key serdes for materializing this stream,
      *                 if not specified the default serdes defined in the configs will be used
      * @param valSerde value serdes for materializing this stream,
      *                 if not specified the default serdes defined in the configs will be used
-     * @param <KR>     the key type of the result {@link KGroupedStream}
      * @return a {@link KGroupedStream} that contains the grouped records of the original {@link KStream}
-     * @see #groupByKey()
      */
-    <KR> KGroupedStream<KR, V> groupBy(final KeyValueMapper<? super K, ? super V, KR> selector,
-                                       final Serde<KR> keySerde,
-                                       final Serde<V> valSerde);
+    KGroupedStream<K, V> groupByKey(final Serde<K> keySerde,
+                                    final Serde<V> valSerde);
 
     /**
      * Group the records of this {@link KStream} on a new key that is selected using the provided {@link KeyValueMapper}
@@ -816,12 +842,11 @@ <KR> KGroupedStream<KR, V> groupBy(final KeyValueMapper<? super K, ? super V, KR
      * <p>
      * Because a new key is selected, an internal repartitioning topic will be created in Kafka.
      * This topic will be named "${applicationId}-XXX-repartition", where "applicationId" is user-specified in
-     * {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internal
-     * generated name, and "-repartition" is a fixed suffix.
+     * {@link  StreamsConfig} via parameter {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is
+     * an internally generated name, and "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * All data of this stream will be redistributed through the repartitioning topic by writing all records to
+     * All data of this stream will be redistributed through the repartitioning topic by writing all records to it,
      * and rereading all records from it, such that the resulting {@link KGroupedStream} is partitioned on the new key.
      * <p>
      * This operation is equivalent to calling {@link #selectKey(KeyValueMapper)} followed by {@link #groupByKey()}.
@@ -834,66 +859,41 @@ <KR> KGroupedStream<KR, V> groupBy(final KeyValueMapper<? super K, ? super V, KR
     <KR> KGroupedStream<KR, V> groupBy(final KeyValueMapper<? super K, ? super V, KR> selector);
 
     /**
-     * Group the records by their current key into a {@link KGroupedStream} while preserving the original values
-     * and default serializers and deserializers.
+     * Group the records of this {@link KStream} on a new key that is selected using the provided {@link KeyValueMapper}.
      * Grouping a stream on the record key is required before an aggregation operator can be applied to the data
      * (cf. {@link KGroupedStream}).
-     * If a record key is {@code null} the record will not be included in the resulting {@link KGroupedStream}.
+     * The {@link KeyValueMapper} selects a new key (with potentially different type) while preserving the original values.
+     * If the new record key is {@code null} the record will not be included in the resulting {@link KGroupedStream}.
      * <p>
-     * If a key changing operator was used before this operation (e.g., {@link #selectKey(KeyValueMapper)},
-     * {@link #map(KeyValueMapper)}, {@link #flatMap(KeyValueMapper)}, or
-     * {@link #transform(TransformerSupplier, String...)}), and no data redistribution happened afterwards (e.g., via
-     * {@link #through(String)}) an internal repartitioning topic will be created in Kafka.
+     * Because a new key is selected, an internal repartitioning topic will be created in Kafka.
      * This topic will be named "${applicationId}-XXX-repartition", where "applicationId" is user-specified in
-     * {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internal
-     * generated name, and "-repartition" is a fixed suffix.
+     * {@link StreamsConfig StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
+     * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * For this case, all data of this stream will be redistributed through the repartitioning topic by writing all
-     * records to and rereading all records from it, such that the resulting {@link KGroupedStream} is partitioned
-     * correctly on its key.
-     * If the last key changing operator changed the key type, it is recommended to use
-     * {@link #groupByKey(Serde, Serde)} instead.
-     *
-     * @return a {@link KGroupedStream} that contains the grouped records of the original {@link KStream}
-     * @see #groupBy(KeyValueMapper)
-     */
-    KGroupedStream<K, V> groupByKey();
-
-    /**
-     * Group the records by their current key into a {@link KGroupedStream} while preserving the original values.
-     * Grouping a stream on the record key is required before an aggregation operator can be applied to the data
-     * (cf. {@link KGroupedStream}).
-     * If a record key is {@code null} the record will not be included in the resulting {@link KGroupedStream}.
-     * <p>
-     * If a key changing operator was used before this operation (e.g., {@link #selectKey(KeyValueMapper)},
-     * {@link #map(KeyValueMapper)}, {@link #flatMap(KeyValueMapper)}, or
-     * {@link #transform(TransformerSupplier, String...)}), and no data redistribution happened afterwards (e.g., via
-     * {@link #through(String)}) an internal repartitioning topic will be created in Kafka.
-     * This topic will be named "${applicationId}-XXX-repartition", where "applicationId" is user-specified in
-     * {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internal
-     * generated name, and "-repartition" is a fixed suffix.
-     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
+     * All data of this stream will be redistributed through the repartitioning topic by writing all records to it,
+     * and rereading all records from it, such that the resulting {@link KGroupedStream} is partitioned on the new key.
      * <p>
-     * For this case, all data of this stream will be redistributed through the repartitioning topic by writing all
-     * records to and rereading all records from it, such that the resulting {@link KGroupedStream} is partitioned
-     * correctly on its key.
+     * This is equivalent to calling {@link #selectKey(KeyValueMapper)} followed by {@link #groupByKey(Serde, Serde)}.
      *
+     * @param selector a {@link KeyValueMapper} that computes a new key for grouping
      * @param keySerde key serdes for materializing this stream,
      *                 if not specified the default serdes defined in the configs will be used
      * @param valSerde value serdes for materializing this stream,
      *                 if not specified the default serdes defined in the configs will be used
+     * @param <KR>     the key type of the result {@link KGroupedStream}
      * @return a {@link KGroupedStream} that contains the grouped records of the original {@link KStream}
+     * @see #groupByKey()
      */
-    KGroupedStream<K, V> groupByKey(final Serde<K> keySerde,
-                                    final Serde<V> valSerde);
+    <KR> KGroupedStream<KR, V> groupBy(final KeyValueMapper<? super K, ? super V, KR> selector,
+                                       final Serde<KR> keySerde,
+                                       final Serde<V> valSerde);
 
     /**
      * Join records of this stream with another {@link KStream}'s records using windowed inner equi join with default
      * serializers and deserializers.
-     * The join is a primary key join with join attribute {@code thisKStream.key == otherKStream.key}.
+     * The join is computed on the records' key with join attribute {@code thisKStream.key == otherKStream.key}.
      * Furthermore, two records are only joined if their timestamps are close to each other as defined by the given
      * {@link JoinWindows}, i.e., the window defines an additional join predicate on the record timestamps.
      * <p>
@@ -930,22 +930,22 @@ KGroupedStream<K, V> groupByKey(final Serde<K> keySerde,
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internal
-     * generated name, and "-repartition" is a fixed suffix.
+     * user-specified in {@link  StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
+     * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
      * Repartitioning can happen for one or both of the joining {@link KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to and rereading all records from it, such that the join input {@link KStream} is partitioned correctly
-     * on its key.
+     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * correctly on its key.
      * <p>
      * Both of the joining {@link KStream}s will be materialized in local state stores with auto-generated store names.
      * For failure and recovery each store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-storeName-changelog", where "applicationId" is user-specified
-     * in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is an
-     * internal generated name, and "-changelog" is a fixed suffix.
+     * in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is an
+     * internally generated name, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
      * @param otherStream the {@link KStream} to be joined with this stream
@@ -964,7 +964,7 @@ <VO, VR> KStream<K, VR> join(final KStream<K, VO> otherStream,
 
     /**
      * Join records of this stream with another {@link KStream}'s records using windowed inner equi join.
-     * The join is a primary key join with join attribute {@code thisKStream.key == otherKStream.key}.
+     * The join is computed on the records' key with join attribute {@code thisKStream.key == otherKStream.key}.
      * Furthermore, two records are only joined if their timestamps are close to each other as defined by the given
      * {@link JoinWindows}, i.e., the window defines an additional join predicate on the record timestamps.
      * <p>
@@ -1001,22 +1001,21 @@ <VO, VR> KStream<K, VR> join(final KStream<K, VO> otherStream,
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internal
-     * generated name, and "-repartition" is a fixed suffix.
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
+     * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
      * Repartitioning can happen for one or both of the joining {@link KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to and rereading all records from it, such that the join input {@link KStream} is partitioned correctly
-     * on its key.
+     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * correctly on its key.
      * <p>
      * Both of the joining {@link KStream}s will be materialized in local state stores with auto-generated store names.
      * For failure and recovery each store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-storeName-changelog", where "applicationId" is user-specified
-     * in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is an
-     * internal generated name, and "-changelog" is a fixed suffix.
+     * in {@link StreamsConfig} via parameter {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG},
+     * "storeName" is an internally generated name, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
      * @param otherStream     the {@link KStream} to be joined with this stream
@@ -1047,7 +1046,7 @@ <VO, VR> KStream<K, VR> join(final KStream<K, VO> otherStream,
      * serializers and deserializers.
      * In contrast to {@link #join(KStream, ValueJoiner, JoinWindows) inner-join}, all records from this stream will
      * produce at least one output record (cf. below).
-     * The join is a primary key join with join attribute {@code thisKStream.key == otherKStream.key}.
+     * The join is computed on the records' key with join attribute {@code thisKStream.key == otherKStream.key}.
      * Furthermore, two records are only joined if their timestamps are close to each other as defined by the given
      * {@link JoinWindows}, i.e., the window defines an additional join predicate on the record timestamps.
      * <p>
@@ -1086,22 +1085,21 @@ <VO, VR> KStream<K, VR> join(final KStream<K, VO> otherStream,
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internal
-     * generated name, and "-repartition" is a fixed suffix.
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
+     * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen for one or both of the joining {@link KStream}s
+     * Repartitioning can happen for one or both of the joining {@link KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to and rereading all records from it, such that the join input {@link KStream} is partitioned correctly
-     * on its key.
+     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * correctly on its key.
      * <p>
      * Both of the joining {@link KStream}s will be materialized in local state stores with auto-generated store names.
      * For failure and recovery each store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-storeName-changelog", where "applicationId" is user-specified
-     * in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is an
-     * internal generated name, and "-changelog" is a fixed suffix.
+     * in {@link StreamsConfig} via parameter {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG},
+     * "storeName" is an internally generated name, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
      * @param otherStream the {@link KStream} to be joined with this stream
@@ -1123,7 +1121,7 @@ <VO, VR> KStream<K, VR> leftJoin(final KStream<K, VO> otherStream,
      * Join records of this stream with another {@link KStream}'s records using windowed left equi join.
      * In contrast to {@link #join(KStream, ValueJoiner, JoinWindows, Serde, Serde, Serde) inner-join}, all records from
      * this stream will produce at least one output record (cf. below).
-     * The join is a primary key join with join attribute {@code thisKStream.key == otherKStream.key}.
+     * The join is computed on the records' key with join attribute {@code thisKStream.key == otherKStream.key}.
      * Furthermore, two records are only joined if their timestamps are close to each other as defined by the given
      * {@link JoinWindows}, i.e., the window defines an additional join predicate on the record timestamps.
      * <p>
@@ -1162,22 +1160,22 @@ <VO, VR> KStream<K, VR> leftJoin(final KStream<K, VO> otherStream,
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internal
-     * generated name, and "-repartition" is a fixed suffix.
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
+     * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen for one or both of the joining {@link KStream}s
+     * Repartitioning can happen for one or both of the joining {@link KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to and rereading all records from it, such that the join input {@link KStream} is partitioned correctly
-     * on its key.
+     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * correctly on its key.
      * <p>
      * Both of the joining {@link KStream}s will be materialized in local state stores with auto-generated store names.
      * For failure and recovery each store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-storeName-changelog", where "applicationId" is user-specified
-     * in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is an
-     * internal generated name, and "-changelog" is a fixed suffix.
+     * in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is an
+     * internally generated name, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
      * @param otherStream     the {@link KStream} to be joined with this stream
@@ -1210,7 +1208,7 @@ <VO, VR> KStream<K, VR> leftJoin(final KStream<K, VO> otherStream,
      * In contrast to {@link #join(KStream, ValueJoiner, JoinWindows) inner-join} or
      * {@link #leftJoin(KStream, ValueJoiner, JoinWindows) left-join}, all records from both streams will produce at
      * least one output record (cf. below).
-     * The join is a primary key join with join attribute {@code thisKStream.key == otherKStream.key}.
+     * The join is computed on the records' key with join attribute {@code thisKStream.key == otherKStream.key}.
      * Furthermore, two records are only joined if their timestamps are close to each other as defined by the given
      * {@link JoinWindows}, i.e., the window defines an additional join predicate on the record timestamps.
      * <p>
@@ -1249,22 +1247,21 @@ <VO, VR> KStream<K, VR> leftJoin(final KStream<K, VO> otherStream,
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internal
-     * generated name, and "-repartition" is a fixed suffix.
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
+     * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen for one or both of the joining {@link KStream}s
+     * Repartitioning can happen for one or both of the joining {@link KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to and rereading all records from it, such that the join input {@link KStream} is partitioned correctly
-     * on its key.
+     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * correctly on its key.
      * <p>
      * Both of the joining {@link KStream}s will be materialized in local state stores with auto-generated store names.
      * For failure and recovery each store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-storeName-changelog", where "applicationId" is user-specified
-     * in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is an
-     * internal generated name, and "-changelog" is a fixed suffix.
+     * in {@link StreamsConfig} via parameter {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG},
+     * "storeName" is an internally generated name, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
      * @param otherStream the {@link KStream} to be joined with this stream
@@ -1287,7 +1284,7 @@ <VO, VR> KStream<K, VR> outerJoin(final KStream<K, VO> otherStream,
      * In contrast to {@link #join(KStream, ValueJoiner, JoinWindows, Serde, Serde, Serde) inner-join} or
      * {@link #leftJoin(KStream, ValueJoiner, JoinWindows, Serde, Serde, Serde) left-join}, all records from both
      * streams will produce at least one output record (cf. below).
-     * The join is a primary key join with join attribute {@code thisKStream.key == otherKStream.key}.
+     * The join is computed on the records' key with join attribute {@code thisKStream.key == otherKStream.key}.
      * Furthermore, two records are only joined if their timestamps are close to each other as defined by the given
      * {@link JoinWindows}, i.e., the window defines an additional join predicate on the record timestamps.
      * <p>
@@ -1326,22 +1323,21 @@ <VO, VR> KStream<K, VR> outerJoin(final KStream<K, VO> otherStream,
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internal
-     * generated name, and "-repartition" is a fixed suffix.
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
+     * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen for one or both of the joining {@link KStream}s
+     * Repartitioning can happen for one or both of the joining {@link KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to and rereading all records from it, such that the join input {@link KStream} is partitioned correctly
-     * on its key.
+     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * correctly on its key.
      * <p>
      * Both of the joining {@link KStream}s will be materialized in local state stores with auto-generated store names.
      * For failure and recovery each store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-storeName-changelog", where "applicationId" is user-specified
-     * in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is an
-     * internal generated name, and "-changelog" is a fixed suffix.
+     * in {@link StreamsConfig} via parameter {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG},
+     * "storeName" is an internally generated name, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
      * @param otherStream     the {@link KStream} to be joined with this stream
@@ -1357,7 +1353,7 @@ <VO, VR> KStream<K, VR> outerJoin(final KStream<K, VO> otherStream,
      * @param <VR>            the value type of the result stream
      * @return a {@link KStream} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one for each matched record-pair with the same key plus one for each non-matching record of
-     * both {@link KStream} and within the joining window intervals
+     * both {@link KStream}s and within the joining window intervals
      * @see #join(KStream, ValueJoiner, JoinWindows, Serde, Serde, Serde)
      * @see #leftJoin(KStream, ValueJoiner, JoinWindows, Serde, Serde, Serde)
      */
@@ -1373,12 +1369,12 @@ <VO, VR> KStream<K, VR> outerJoin(final KStream<K, VO> otherStream,
      * serializers and deserializers.
      * The join is a primary key table lookup join with join attribute {@code stream.key == table.key}.
      * "Table lookup join" means, that results are only computed if {@link KStream} records are processed.
-     * This is done by performing a lookup for matching records in the <em>current</em> (ie, processing time) internal
+     * This is done by performing a lookup for matching records in the <em>current</em> (i.e., processing time) internal
      * {@link KTable} state.
      * In contrast, processing {@link KTable} input records will only update the internal {@link KTable} state and
      * will not produce any result records.
      * <p>
-     * For each {@link KStream} record that finds an corresponding record in {@link KTable} the provided
+     * For each {@link KStream} record that finds a corresponding record in {@link KTable} the provided
      * {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
      * If an {@link KStream} input record key or value is {@code null} the record will not be included in the join
@@ -1411,19 +1407,20 @@ <VO, VR> KStream<K, VR> outerJoin(final KStream<K, VO> otherStream,
      * <td>&lt;K1:ValueJoiner(C,b)&gt;</td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key.
+     * Both input streams need to be co-partitioned on the join key (cf.
+     * {@link #join(GlobalKTable, KeyValueMapper, ValueJoiner)}).
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internal
-     * generated name, and "-repartition" is a fixed suffix.
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
+     * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
      * Repartitioning can happen only for this {@link KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to and rereading all records from it, such that the join input {@link KStream} is partitioned correctly
-     * on its key.
+     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * correctly on its key.
      *
      * @param table  the {@link KTable} to be joined with this stream
      * @param joiner a {@link ValueJoiner} that computes the join result for a pair of matching records
@@ -1432,6 +1429,7 @@ <VO, VR> KStream<K, VR> outerJoin(final KStream<K, VO> otherStream,
      * @return a {@link KStream} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one for each matched record-pair with the same key
      * @see #leftJoin(KTable, ValueJoiner)
+     * @see #join(GlobalKTable, KeyValueMapper, ValueJoiner)
      */
     <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
                                  final ValueJoiner<? super V, ? super VT, ? extends VR> joiner);
@@ -1440,12 +1438,12 @@ <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
      * Join records of this stream with {@link KTable}'s records using non-windowed inner equi join.
      * The join is a primary key table lookup join with join attribute {@code stream.key == table.key}.
      * "Table lookup join" means, that results are only computed if {@link KStream} records are processed.
-     * This is done by performing a lookup for matching records in the <em>current</em> (ie, processing time) internal
+     * This is done by performing a lookup for matching records in the <em>current</em> (i.e., processing time) internal
      * {@link KTable} state.
      * In contrast, processing {@link KTable} input records will only update the internal {@link KTable} state and
      * will not produce any result records.
      * <p>
-     * For each {@link KStream} record that finds an corresponding record in {@link KTable} the provided
+     * For each {@link KStream} record that finds a corresponding record in {@link KTable} the provided
      * {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
      * If an {@link KStream} input record key or value is {@code null} the record will not be included in the join
@@ -1478,31 +1476,33 @@ <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
      * <td>&lt;K1:ValueJoiner(C,b)&gt;</td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key.
+     * Both input streams need to be co-partitioned on the join key (cf.
+     * {@link #join(GlobalKTable, KeyValueMapper, ValueJoiner)}).
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internal
-     * generated name, and "-repartition" is a fixed suffix.
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
+     * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
      * Repartitioning can happen only for this {@link KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to and rereading all records from it, such that the join input {@link KStream} is partitioned correctly
-     * on its key.
+     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * correctly on its key.
      *
-     * @param table       the {@link KTable} to be joined with this stream
-     * @param joiner      a {@link ValueJoiner} that computes the join result for a pair of matching records
-     * @param keySerde    key serdes for materializing this stream.
-     *                    If not specified the default serdes defined in the configs will be used
-     * @param valSerde    value serdes for materializing this stream,
-     *                    if not specified the default serdes defined in the configs will be used
-     * @param <VT>        the value type of the table
-     * @param <VR>        the value type of the result stream
+     * @param table    the {@link KTable} to be joined with this stream
+     * @param joiner   a {@link ValueJoiner} that computes the join result for a pair of matching records
+     * @param keySerde key serdes for materializing this stream.
+     *                 If not specified the default serdes defined in the configs will be used
+     * @param valSerde value serdes for materializing this stream,
+     *                 if not specified the default serdes defined in the configs will be used
+     * @param <VT>     the value type of the table
+     * @param <VR>     the value type of the result stream
      * @return a {@link KStream} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one for each matched record-pair with the same key
      * @see #leftJoin(KTable, ValueJoiner, Serde, Serde)
+     * @see #join(GlobalKTable, KeyValueMapper, ValueJoiner)
      */
     <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
                                  final ValueJoiner<? super V, ? super VT, ? extends VR> joiner,
@@ -1512,16 +1512,16 @@ <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
     /**
      * Join records of this stream with {@link KTable}'s records using non-windowed left equi join with default
      * serializers and deserializers.
-     * In contrast to {@link #join(KTable, ValueJoiner)} inner-join}, all records from this stream will produce an
+     * In contrast to {@link #join(KTable, ValueJoiner) inner-join}, all records from this stream will produce an
      * output record (cf. below).
      * The join is a primary key table lookup join with join attribute {@code stream.key == table.key}.
      * "Table lookup join" means, that results are only computed if {@link KStream} records are processed.
-     * This is done by performing a lookup for matching records in the <em>current</em> (ie, processing time) internal
+     * This is done by performing a lookup for matching records in the <em>current</em> (i.e., processing time) internal
      * {@link KTable} state.
      * In contrast, processing {@link KTable} input records will only update the internal {@link KTable} state and
      * will not produce any result records.
      * <p>
-     * For each {@link KStream} record weather or not it finds an corresponding record in {@link KTable} the provided
+     * For each {@link KStream} record weather or not it finds a corresponding record in {@link KTable} the provided
      * {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
      * If no {@link KTable} record was found during lookup, a {@code null} value will be provided to {@link ValueJoiner}.
      * The key of the result record is the same as for both joining input records.
@@ -1555,19 +1555,20 @@ <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
      * <td>&lt;K1:ValueJoiner(C,b)&gt;</td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key.
+     * Both input streams need to be co-partitioned on the join key (cf.
+     * {@link #leftJoin(GlobalKTable, KeyValueMapper, ValueJoiner)}).
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internal
-     * generated name, and "-repartition" is a fixed suffix.
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
+     * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
      * Repartitioning can happen only for this {@link KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to and rereading all records from it, such that the join input {@link KStream} is partitioned correctly
-     * on its key.
+     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * correctly on its key.
      *
      * @param table  the {@link KTable} to be joined with this stream
      * @param joiner a {@link ValueJoiner} that computes the join result for a pair of matching records
@@ -1576,22 +1577,23 @@ <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
      * @return a {@link KStream} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one output for each input {@link KStream} record
      * @see #join(KTable, ValueJoiner)
+     * @see #leftJoin(GlobalKTable, KeyValueMapper, ValueJoiner)
      */
     <VT, VR> KStream<K, VR> leftJoin(final KTable<K, VT> table,
                                      final ValueJoiner<? super V, ? super VT, ? extends VR> joiner);
 
     /**
      * Join records of this stream with {@link KTable}'s records using non-windowed left equi join.
-     * In contrast to {@link #join(KTable, ValueJoiner)} inner-join}, all records from this stream will produce an
+     * In contrast to {@link #join(KTable, ValueJoiner) inner-join}, all records from this stream will produce an
      * output record (cf. below).
      * The join is a primary key table lookup join with join attribute {@code stream.key == table.key}.
      * "Table lookup join" means, that results are only computed if {@link KStream} records are processed.
-     * This is done by performing a lookup for matching records in the <em>current</em> (ie, processing time) internal
+     * This is done by performing a lookup for matching records in the <em>current</em> (i.e., processing time) internal
      * {@link KTable} state.
      * In contrast, processing {@link KTable} input records will only update the internal {@link KTable} state and
      * will not produce any result records.
      * <p>
-     * For each {@link KStream} record weather or not it finds an corresponding record in {@link KTable} the provided
+     * For each {@link KStream} record weather or not it finds a corresponding record in {@link KTable} the provided
      * {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
      * If no {@link KTable} record was found during lookup, a {@code null} value will be provided to {@link ValueJoiner}.
      * The key of the result record is the same as for both joining input records.
@@ -1625,99 +1627,103 @@ <VT, VR> KStream<K, VR> leftJoin(final KTable<K, VT> table,
      * <td>&lt;K1:ValueJoiner(C,b)&gt;</td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key.
+     * Both input streams need to be co-partitioned on the join key (cf.
+     * {@link #leftJoin(GlobalKTable, KeyValueMapper, ValueJoiner)}).
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
-     * user-specified in {@link org.apache.kafka.streams.StreamsConfig StreamsConfig} via parameter
-     * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internal
-     * generated name, and "-repartition" is a fixed suffix.
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
+     * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
      * Repartitioning can happen only for this {@link KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to and rereading all records from it, such that the join input {@link KStream} is partitioned correctly
-     * on its key.
+     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * correctly on its key.
      *
-     * @param table       the {@link KTable} to be joined with this stream
-     * @param joiner      a {@link ValueJoiner} that computes the join result for a pair of matching records
-     * @param keySerde    key serdes for materializing this stream.
-     *                    If not specified the default serdes defined in the configs will be used
-     * @param valSerde    value serdes for materializing this stream,
-     *                    if not specified the default serdes defined in the configs will be used
-     * @param <VT>        the value type of the table
-     * @param <VR>        the value type of the result stream
+     * @param table    the {@link KTable} to be joined with this stream
+     * @param joiner   a {@link ValueJoiner} that computes the join result for a pair of matching records
+     * @param keySerde key serdes for materializing this stream.
+     *                 If not specified the default serdes defined in the configs will be used
+     * @param valSerde value serdes for materializing this stream,
+     *                 if not specified the default serdes defined in the configs will be used
+     * @param <VT>     the value type of the table
+     * @param <VR>     the value type of the result stream
      * @return a {@link KStream} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one output for each input {@link KStream} record
      * @see #join(KTable, ValueJoiner, Serde, Serde)
+     * @see #leftJoin(GlobalKTable, KeyValueMapper, ValueJoiner)
      */
     <VT, VR> KStream<K, VR> leftJoin(final KTable<K, VT> table,
                                      final ValueJoiner<? super V, ? super VT, ? extends VR> joiner,
                                      final Serde<K> keySerde,
                                      final Serde<V> valSerde);
 
-
     /**
-     * Join records of this stream with {@link GlobalKTable}'s records using non-windowed left equi join.
-     * In contrast to {@link #join(GlobalKTable, KeyValueMapper, ValueJoiner)} inner-join}, all records from this stream will produce an
-     * output record (cf. below).
-     * The join is a primary key table lookup join with join attribute {@code keyValueMapper.map(stream.keyValue) == table.key}.
+     * Join records of this stream with {@link GlobalKTable}'s records using non-windowed inner equi join.
+     * The join is a primary key table lookup join with join attribute
+     * {@code keyValueMapper.map(stream.keyValue) == table.key}.
      * "Table lookup join" means, that results are only computed if {@link KStream} records are processed.
-     * This is done by performing a lookup for matching records in the <em>current</em> internal
-     * {@link GlobalKTable} state.
-     * In contrast, processing {@link GlobalKTable} input records will only update the internal {@link GlobalKTable} state and
-     * will not produce any result records.
+     * This is done by performing a lookup for matching records in the <em>current</em> internal {@link GlobalKTable}
+     * state.
+     * In contrast, processing {@link GlobalKTable} input records will only update the internal {@link GlobalKTable}
+     * state and will not produce any result records.
      * <p>
-     * For each {@link KStream} record whether or not it finds an corresponding record in {@link GlobalKTable} the provided
+     * For each {@link KStream} record that finds a corresponding record in {@link GlobalKTable} the provided
      * {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
-     * If no {@link GlobalKTable} record was found during lookup, a {@code null} value will be provided to {@link ValueJoiner}.
-     * The key of the result record is the same as this {@link KStream}
+     * The key of the result record is the same as the key of this {@link KStream}.
      * If an {@link KStream} input record key or value is {@code null} the record will not be included in the join
      * operation and thus no output record will be added to the resulting {@link KStream}.
-     **
-     * @param globalKTable      the {@link GlobalKTable} to be joined with this stream
-     * @param keyValueMapper    instance of {@link KeyValueMapper} used to map from the (key, value) of this stream
-     *                          to the key of the {@link GlobalKTable}
-     * @param valueJoiner       a {@link ValueJoiner} that computes the join result for a pair of matching records
-     * @param <GK>              the key type of {@link GlobalKTable}
-     * @param <GV>              the value type of the {@link GlobalKTable}
-     * @param <RV>               the value type of the resulting {@link KStream}
+     *
+     * @param globalKTable   the {@link GlobalKTable} to be joined with this stream
+     * @param keyValueMapper instance of {@link KeyValueMapper} used to map from the (key, value) of this stream
+     *                       to the key of the {@link GlobalKTable}
+     * @param joiner         a {@link ValueJoiner} that computes the join result for a pair of matching records
+     * @param <GK>           the key type of {@link GlobalKTable}
+     * @param <GV>           the value type of the {@link GlobalKTable}
+     * @param <RV>           the value type of the resulting {@link KStream}
      * @return a {@link KStream} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one output for each input {@link KStream} record
-     * @see #join(GlobalKTable, KeyValueMapper, ValueJoiner)
+     * @see #leftJoin(GlobalKTable, KeyValueMapper, ValueJoiner)
      */
-    <GK, GV, RV> KStream<K, RV> leftJoin(final GlobalKTable<GK, GV> globalKTable,
-                                         final KeyValueMapper<? super K, ? super V, ? extends GK> keyValueMapper,
-                                         final ValueJoiner<? super V, ? super GV, ? extends RV> valueJoiner);
+    <GK, GV, RV> KStream<K, RV> join(final GlobalKTable<GK, GV> globalKTable,
+                                     final KeyValueMapper<? super K, ? super V, ? extends GK> keyValueMapper,
+                                     final ValueJoiner<? super V, ? super GV, ? extends RV> joiner);
 
     /**
-     * Join records of this stream with {@link GlobalKTable}'s records using non-windowed inner equi join
-     * The join is a primary key table lookup join with join attribute {@code keyValueMapper.map(stream.keyValue) == table.key}.
+     * Join records of this stream with {@link GlobalKTable}'s records using non-windowed left equi join.
+     * In contrast to {@link #join(GlobalKTable, KeyValueMapper, ValueJoiner) inner-join}, all records from this stream
+     * will produce an output record (cf. below).
+     * The join is a primary key table lookup join with join attribute
+     * {@code keyValueMapper.map(stream.keyValue) == table.key}.
      * "Table lookup join" means, that results are only computed if {@link KStream} records are processed.
-     * This is done by performing a lookup for matching records in the <em>current</em> internal
-     * {@link GlobalKTable} state.
-     * In contrast, processing {@link GlobalKTable} input records will only update the internal {@link GlobalKTable} state and
-     * will not produce any result records.
-     * <p>
-     * For each {@link KStream} record that finds an corresponding record in {@link GlobalKTable} the provided
-     * {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
-     * The key of the result record is the same as the key of this {@link KStream}
+     * This is done by performing a lookup for matching records in the <em>current</em> internal {@link GlobalKTable}
+     * state.
+     * In contrast, processing {@link GlobalKTable} input records will only update the internal {@link GlobalKTable}
+     * state and will not produce any result records.
+     * <p>
+     * For each {@link KStream} record whether or not it finds a corresponding record in {@link GlobalKTable} the
+     * provided {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
+     * If no {@link GlobalKTable} record was found during lookup, a {@code null} value will be provided to
+     * {@link ValueJoiner}.
+     * The key of the result record is the same as this {@link KStream}.
      * If an {@link KStream} input record key or value is {@code null} the record will not be included in the join
      * operation and thus no output record will be added to the resulting {@link KStream}.
-     * <p>
-
-     * @param globalKTable      the {@link GlobalKTable} to be joined with this stream
-     * @param keyValueMapper    instance of {@link KeyValueMapper} used to map from the (key, value) of this stream
-     *                          to the key of the {@link GlobalKTable}
-     * @param joiner            a {@link ValueJoiner} that computes the join result for a pair of matching records
-     * @param <GK>              the key type of {@link GlobalKTable}
-     * @param <GV>              the value type of the {@link GlobalKTable}
-     * @param <RV>               the value type of the resulting {@link KStream}
+     *
+     * @param globalKTable   the {@link GlobalKTable} to be joined with this stream
+     * @param keyValueMapper instance of {@link KeyValueMapper} used to map from the (key, value) of this stream
+     *                       to the key of the {@link GlobalKTable}
+     * @param valueJoiner    a {@link ValueJoiner} that computes the join result for a pair of matching records
+     * @param <GK>           the key type of {@link GlobalKTable}
+     * @param <GV>           the value type of the {@link GlobalKTable}
+     * @param <RV>           the value type of the resulting {@link KStream}
      * @return a {@link KStream} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one output for each input {@link KStream} record
-     * @see #leftJoin(KStream, ValueJoiner, JoinWindows)
+     * @see #join(GlobalKTable, KeyValueMapper, ValueJoiner)
      */
-    <GK, GV, RV> KStream<K, RV> join(final GlobalKTable<GK, GV> globalKTable,
-                                     final KeyValueMapper<? super K, ? super V, ? extends GK> keyValueMapper,
-                                     final ValueJoiner<? super V, ? super GV, ? extends RV> joiner);
+    <GK, GV, RV> KStream<K, RV> leftJoin(final GlobalKTable<GK, GV> globalKTable,
+                                         final KeyValueMapper<? super K, ? super V, ? extends GK> keyValueMapper,
+                                         final ValueJoiner<? super V, ? super GV, ? extends RV> valueJoiner);
+
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KeyValueMapper.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KeyValueMapper.java
index b677de0fb83ff..13daca8f41ffe 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KeyValueMapper.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KeyValueMapper.java
@@ -17,14 +17,14 @@
 package org.apache.kafka.streams.kstream;
 
 import org.apache.kafka.common.annotation.InterfaceStability;
+import org.apache.kafka.streams.KeyValue;
 
 /**
- * The {@link KeyValueMapper} interface for mapping a {@link org.apache.kafka.streams.KeyValue key-value pair} to a new
- * value of arbitrary type. For example, it can be used to
+ * The {@link KeyValueMapper} interface for mapping a {@link KeyValue key-value pair} to a new value of arbitrary type.
+ * For example, it can be used to
  * <ul>
- * <li>map from an input {@link org.apache.kafka.streams.KeyValue key-value pair} to an output
- * {@link org.apache.kafka.streams.KeyValue key-value pair} with different key and/or value type (for this case
- * output type {@code VR == }{@link org.apache.kafka.streams.KeyValue KeyValue&lt;NewKeyType,NewValueType&gt;})</li>
+ * <li>map from an input {@link KeyValue} pair to an output {@link KeyValue} pair with different key and/or value type
+ *     (for this case output type {@code VR == }{@link KeyValue KeyValue&lt;NewKeyType,NewValueType&gt;})</li>
  * <li>map from an input record to a new key (with arbitrary key type as specified by {@code VR})</li>
  * </ul>
  * This is a stateless record-by-record operation, i.e, {@link #apply(Object, Object)} is invoked individually for each
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Predicate.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Predicate.java
index 24563ba9c2cd0..ef22f24a62aa9 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Predicate.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Predicate.java
@@ -17,10 +17,10 @@
 package org.apache.kafka.streams.kstream;
 
 import org.apache.kafka.common.annotation.InterfaceStability;
+import org.apache.kafka.streams.KeyValue;
 
 /**
- * The {@link Predicate} interface represents a predicate (boolean-valued function) of a
- * {@link org.apache.kafka.streams.KeyValue key-value pair}.
+ * The {@link Predicate} interface represents a predicate (boolean-valued function) of a {@link KeyValue} pair.
  * This is a stateless record-by-record operation, i.e, {@link #test(Object, Object)} is invoked individually for each
  * record of a stream.
  *
@@ -40,8 +40,7 @@ public interface Predicate<K, V> {
      *
      * @param key   the key of the record
      * @param value the value of the record
-     * @return {@code true} if the {@link org.apache.kafka.streams.KeyValue key-value pair} satisfies the
-     * predicate&mdash;{@code false} otherwise
+     * @return {@code true} if the {@link KeyValue} pair satisfies the predicate&mdash;{@code false} otherwise
      */
     boolean test(final K key, final V value);
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Reducer.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Reducer.java
index d19c1eb1b68b1..328f6236dcd65 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Reducer.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Reducer.java
@@ -18,13 +18,13 @@
 package org.apache.kafka.streams.kstream;
 
 import org.apache.kafka.common.annotation.InterfaceStability;
-
+import org.apache.kafka.streams.KeyValue;
 /**
  * The {@link Reducer} interface for combining two values of the same type into a new value.
  * In contrast to {@link Aggregator} the result type must be the same as the input type.
  * <p>
- * The provided values can be either original values from input {@link org.apache.kafka.streams.KeyValue KeyValue} pair
- * records or be a previously computed result from {@link Reducer#apply(Object, Object)}.
+ * The provided values can be either original values from input {@link KeyValue} pair records or be a previously
+ * computed result from {@link Reducer#apply(Object, Object)}.
  * <p>
  * {@link Reducer} can be used to implement aggregation functions like sum, min, or max.
  *
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java
index 8918f3e68bb8b..2eee43e7335ed 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java
@@ -17,6 +17,7 @@
 package org.apache.kafka.streams.kstream;
 
 import org.apache.kafka.common.annotation.InterfaceStability;
+import org.apache.kafka.streams.processor.TimestampExtractor;
 
 /**
  * A session based window specification used for aggregating events into sessions.
@@ -53,7 +54,7 @@
  * The previous 2 sessions would be merged into a single session with start time 10 and end time 20.
  * The aggregate value for this session would be the result of aggregating all 4 values.
  * <p>
- * For time semantics, see {@link org.apache.kafka.streams.processor.TimestampExtractor TimestampExtractor}.
+ * For time semantics, see {@link TimestampExtractor}.
  *
  * @see TimeWindows
  * @see UnlimitedWindows
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java
index 87e7f2efc30d6..bcd3d8721ded8 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java
@@ -19,6 +19,7 @@
 
 import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.streams.kstream.internals.TimeWindow;
+import org.apache.kafka.streams.processor.TimestampExtractor;
 
 import java.util.HashMap;
 import java.util.Map;
@@ -41,7 +42,7 @@
  * For example, hopping windows with size of 5000ms and advance of 3000ms, have window boundaries
  * [0;5000),[3000;8000),... and not [1000;6000),[4000;9000),... or even something "random" like [1452;6452),[4452;9452),...
  * <p>
- * For time semantics, see {@link org.apache.kafka.streams.processor.TimestampExtractor TimestampExtractor}.
+ * For time semantics, see {@link TimestampExtractor}.
  *
  * @see SessionWindows
  * @see UnlimitedWindows
@@ -52,7 +53,7 @@
  * @see KGroupedStream#reduce(Reducer, Windows, org.apache.kafka.streams.processor.StateStoreSupplier)
  * @see KGroupedStream#aggregate(Initializer, Aggregator, Windows, org.apache.kafka.common.serialization.Serde, String)
  * @see KGroupedStream#aggregate(Initializer, Aggregator, Windows, org.apache.kafka.streams.processor.StateStoreSupplier)
- * @see org.apache.kafka.streams.processor.TimestampExtractor
+ * @see TimestampExtractor
  */
 @InterfaceStability.Unstable
 public class TimeWindows extends Windows<TimeWindow> {
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java
index 9d5669ceae85d..cab614204908d 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java
@@ -19,6 +19,7 @@
 
 import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.streams.kstream.internals.UnlimitedWindow;
+import org.apache.kafka.streams.processor.TimestampExtractor;
 
 import java.util.HashMap;
 import java.util.Map;
@@ -30,7 +31,7 @@
  * It has a fixed starting point while its window end is defined as infinite.
  * With this regard, it is a fixed-size window with infinite window size.
  * <p>
- * For time semantics, see {@link org.apache.kafka.streams.processor.TimestampExtractor TimestampExtractor}.
+ * For time semantics, see {@link TimestampExtractor}.
  *
  * @see TimeWindows
  * @see SessionWindows
@@ -41,7 +42,7 @@
  * @see KGroupedStream#reduce(Reducer, Windows, org.apache.kafka.streams.processor.StateStoreSupplier)
  * @see KGroupedStream#aggregate(Initializer, Aggregator, Windows, org.apache.kafka.common.serialization.Serde, String)
  * @see KGroupedStream#aggregate(Initializer, Aggregator, Windows, org.apache.kafka.streams.processor.StateStoreSupplier)
- * @see org.apache.kafka.streams.processor.TimestampExtractor
+ * @see TimestampExtractor
  */
 @InterfaceStability.Unstable
 public class UnlimitedWindows extends Windows<UnlimitedWindow> {
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java
index 2d2439d0e1ed8..5388affee9b90 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java
@@ -17,6 +17,7 @@
 package org.apache.kafka.streams.kstream;
 
 import org.apache.kafka.common.annotation.InterfaceStability;
+import org.apache.kafka.streams.processor.TimestampExtractor;
 
 /**
  * A single window instance, defined by its start and end timestamp.
@@ -24,13 +25,13 @@
  * window implementations.
  * <p>
  * To specify how {@link Window} boundaries are defined use {@link Windows}.
- * For time semantics, see {@link org.apache.kafka.streams.processor.TimestampExtractor TimestampExtractor}.
+ * For time semantics, see {@link TimestampExtractor}.
  *
  * @see Windows
  * @see org.apache.kafka.streams.kstream.internals.TimeWindow
  * @see org.apache.kafka.streams.kstream.internals.SessionWindow
  * @see org.apache.kafka.streams.kstream.internals.UnlimitedWindow
- * @see org.apache.kafka.streams.processor.TimestampExtractor
+ * @see TimestampExtractor
  */
 @InterfaceStability.Unstable
 public abstract class Window {
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Windows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Windows.java
index ea0c7286f1fbd..74fff47f34a19 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Windows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Windows.java
@@ -17,6 +17,7 @@
 package org.apache.kafka.streams.kstream;
 
 import org.apache.kafka.common.annotation.InterfaceStability;
+import org.apache.kafka.streams.processor.TimestampExtractor;
 
 import java.util.Map;
 
@@ -25,14 +26,14 @@
  * maintain duration.
  * <p>
  * If not explicitly specified, the default maintain duration is 1 day.
- * For time semantics, see {@link org.apache.kafka.streams.processor.TimestampExtractor TimestampExtractor}.
+ * For time semantics, see {@link TimestampExtractor}.
  *
  * @param <W> type of the window instance
  * @see TimeWindows
  * @see UnlimitedWindows
  * @see JoinWindows
  * @see SessionWindows
- * @see org.apache.kafka.streams.processor.TimestampExtractor
+ * @see TimestampExtractor
  */
 @InterfaceStability.Unstable
 public abstract class Windows<W extends Window> {

From fcdfe8e98db3ad1f490f954162dc299c95de07c2 Mon Sep 17 00:00:00 2001
From: Ismael Juma <ismael@juma.me.uk>
Date: Fri, 27 Jan 2017 11:10:28 +0000
Subject: [PATCH 065/177] KAFKA-4578; Upgrade notes for 0.10.2.0

Author: Ismael Juma <ismael@juma.me.uk>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>, Michael G. Noll

Closes #2445 from ijuma/kafka-4578-upgrade-notes-0.10.2

(cherry picked from commit 1956b462527972217447c5e2a5743df8547451c1)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 docs/upgrade.html | 62 +++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 52 insertions(+), 10 deletions(-)

diff --git a/docs/upgrade.html b/docs/upgrade.html
index 23b02afcfabb4..ebc61dbb053be 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -14,31 +14,73 @@
  See the License for the specific language governing permissions and
  limitations under the License.
 -->
+
 <h4><a id="upgrade_10_2_0" href="#upgrade_10_2_0">Upgrading from 0.8.x, 0.9.x, 0.10.0.x or 0.10.1.x to 0.10.2.0</a></h4>
-Users upgrading from versions prior to 0.10.1.x should follow the upgrade guide <a href="#upgrade_10_1">here</a>. Users upgrading from 0.10.1.0
-can upgrade the brokers one at a time: shut down the broker, update the code, and restart it.
+<p>0.10.2.0 has wire protocol changes. By following the recommended rolling upgrade plan below, you guarantee no downtime during the upgrade.
+However, please review the <a href="#upgrade_1020_notable">notable changes in 0.10.2.0</a> before upgrading.
+</p>
+
+<p>Starting with version 0.10.2, Java clients (producer and consumer) have acquired the ability to communicate with older brokers. Version 0.10.2
+clients can talk to version 0.10.0 or newer brokers. However, if your brokers are older than 0.10.0, you must upgrade all the brokers in the
+Kafka cluster before upgrading your clients. Version 0.10.2 brokers support 0.8.x and newer clients.
+</p>
 
 <p><b>For a rolling upgrade:</b></p>
 
 <ol>
-  <li>Upgrading a Kafka Streams Applications:
-    <ul>
-      <li>You need to recompile your code. Just swapping the jar file will not work and will break your appliation.</li>
-      <li>If you use a custom timestamp extractor, you will need to update this code, because the <code>TimestampExtractor</code> interface got changed.</li>
-    </ul>
-  </li>
+    <li> Update server.properties file on all brokers and add the following properties:
+        <ul>
+            <li>inter.broker.protocol.version=CURRENT_KAFKA_VERSION (e.g. 0.8.2, 0.9.0, 0.10.0 or 0.10.1).</li>
+            <li>log.message.format.version=CURRENT_KAFKA_VERSION  (See <a href="#upgrade_10_performance_impact">potential performance impact following the upgrade</a> for the details on what this configuration does.)
+        </ul>
+    </li>
+    <li> Upgrade the brokers one at a time: shut down the broker, update the code, and restart it. </li>
+    <li> Once the entire cluster is upgraded, bump the protocol version by editing inter.broker.protocol.version and setting it to 0.10.2. </li>
+    <li> If your previous message format is 0.10.0, change log.message.format.version to 0.10.2 (this is a no-op as the message format is the same for 0.10.0, 0.10.1 and 0.10.2).
+        If your previous message format version is lower than 0.10.0, do not change log.message.format.version yet - this parameter should only change once all consumers have been upgraded to 0.10.0.0 or later.</li>
+    <li> Restart the brokers one by one for the new protocol version to take effect. </li>
+    <li> If log.message.format.version is still lower than 0.10.0 at this point, wait until all consumers have been upgraded to 0.10.0 or later,
+        then change log.message.format.version to 0.10.2 on each broker and restart them one by one. </li>
+</ol>
+
+<p><b>Note:</b> If you are willing to accept downtime, you can simply take all the brokers down, update the code and start all of them. They will start with the new protocol by default.
+
+<p><b>Note:</b> Bumping the protocol version and restarting can be done any time after the brokers were upgraded. It does not have to be immediately after.
+
+<ol>
+    <li>Upgrading a Kafka Streams Applications:
+        <ul>
+            <li>You need to recompile your code. Just swapping the jar file will not work and will break your appliation.</li>
+            <li>If you use a custom timestamp extractor, you will need to update this code, because the <code>TimestampExtractor</code> interface was changed.</li>
+        </ul>
+    </li>
 </ol>
 
 <h5><a id="upgrade_1020_notable" href="#upgrade_1020_notable">Notable changes in 0.10.2.0</a></h5>
 <ul>
+    <li>The Java clients (producer and consumer) have acquired the ability to communicate with older brokers. Version 0.10.2 clients
+        can talk to version 0.10.0 or newer brokers. Note that some features are not available or are limited when older brokers
+        are used. </li>
     <li>Several methods on the Java consumer may now throw <code>InterruptException</code> if the calling thread is interrupted.
         Please refer to the <code>KafkaConsumer</code> Javadoc for a more in-depth explanation of this change.</li>
     <li>Java consumer now shuts down gracefully. By default, the consumer waits up to 30 seconds to complete pending requests.
         A new close API with timeout has been added to <code>KafkaConsumer</code> to control the maximum wait time.</li>
     <li>Multiple regular expressions separated by commas can be passed to MirrorMaker with the new Java consumer via the --whitelist option. This
         makes the behaviour consistent with MirrorMaker when used the old Scala consumer.</li>
-    <li>Zookeeper dependency was removed from the Streams API. Now the Streams API uses Kafka protocol to manage internal topics instead of modifying Zookeeper directly. This eliminates the need for privilege[s] to access Zookeeper directly and "StreamsConfig.ZOOKEEPER_CONFIG" should not be set in the streams app anymore. If the Kafka cluster is secured, the Streams apps require to have proper security privilege[s] to create new topics.</li>
-    <li>Several new fields including "security.protocol", "connections.max.idle.ms", "retry.backoff.ms", "reconnect.backoff.ms" and "request.timeout.ms" were added to StreamsConfig class. User should pay attenntion to the default values and set these if needed. For more details please refer to <a id="streamsconfigs" href="#streamsconfigs">3.5 Kafka Streams Configs</a>.</li>
+    <li>The Zookeeper dependency was removed from the Streams API. The Streams API now uses the Kafka protocol to manage internal topics instead of
+        modifying Zookeeper directly. This eliminates the need for privileges to access Zookeeper directly and "StreamsConfig.ZOOKEEPER_CONFIG"
+        should not be set in the Streams app any more. If the Kafka cluster is secured, Streams apps must have the required security privileges to create new topics.</li>
+    <li>Several new fields including "security.protocol", "connections.max.idle.ms", "retry.backoff.ms", "reconnect.backoff.ms" and "request.timeout.ms" were added to
+        StreamsConfig class. User should pay attenntion to the default values and set these if needed. For more details please refer to <a id="streamsconfigs" href="#streamsconfigs">3.5 Kafka Streams Configs</a>.</li>
+</ul>
+
+<h5><a id="upgrade_1020_new_protocols" href="#upgrade_1020_new_protocols">New Protocol Versions</a></h5>
+<ul>
+    <li> <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-88%3A+OffsetFetch+Protocol+Update">KIP-88</a>: OffsetFetchRequest v2 supports retrieval of offsets for all topics if the <code>topics</code> array is set to <code>null</code>. </li>
+    <li> <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-88%3A+OffsetFetch+Protocol+Update">KIP-88</a>: OffsetFetchResponse v2 introduces a top-level <code>error_code</code> field. </li>
+    <li> <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-103%3A+Separation+of+Internal+and+External+traffic">KIP-103</a>: UpdateMetadataRequest v3 introduces a <code>listener_name</code> field to the elements of the <code>end_points</code> array. </li>
+    <li> <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-108%3A+Create+Topic+Policy">KIP-108</a>: CreateTopicsRequest v1 introduces a <code>validate_only</code> field. </li>
+    <li> <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-108%3A+Create+Topic+Policy">KIP-108</a>: CreateTopicsResponse v1 introduces an <code>error_message</code> field to the elements of the <code>topic_errors</code> array. </li>
 </ul>
 
 <h4><a id="upgrade_10_1" href="#upgrade_10_1">Upgrading from 0.8.x, 0.9.x or 0.10.0.X to 0.10.1.0</a></h4>

From 02a516f125c2320eca8e98f7a587ad4b9f1f3c2a Mon Sep 17 00:00:00 2001
From: Kamal C <kamal.chandraprakash@gmail.com>
Date: Fri, 27 Jan 2017 12:09:14 +0000
Subject: [PATCH 066/177] MINOR: Include more detail in `ConfigDef.parseType`
 exception message

Author: Kamal C <kamal.chandraprakash@gmail.com>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2345 from Kamal15/trunk

(cherry picked from commit ec76ea343616df27ae2a4e42f5078e081d5878e2)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../java/org/apache/kafka/common/config/ConfigDef.java    | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/common/config/ConfigDef.java b/clients/src/main/java/org/apache/kafka/common/config/ConfigDef.java
index 89feb9aba5ed6..5257f6ef8ec9f 100644
--- a/clients/src/main/java/org/apache/kafka/common/config/ConfigDef.java
+++ b/clients/src/main/java/org/apache/kafka/common/config/ConfigDef.java
@@ -638,7 +638,7 @@ else if (value instanceof String)
                     } else if (value instanceof String) {
                         return Integer.parseInt(trimmed);
                     } else {
-                        throw new ConfigException(name, value, "Expected value to be an number.");
+                        throw new ConfigException(name, value, "Expected value to be a 32-bit integer, but it was a " + value.getClass().getName());
                     }
                 case SHORT:
                     if (value instanceof Short) {
@@ -646,7 +646,7 @@ else if (value instanceof String)
                     } else if (value instanceof String) {
                         return Short.parseShort(trimmed);
                     } else {
-                        throw new ConfigException(name, value, "Expected value to be an number.");
+                        throw new ConfigException(name, value, "Expected value to be a 16-bit integer (short), but it was a " + value.getClass().getName());
                     }
                 case LONG:
                     if (value instanceof Integer)
@@ -656,14 +656,14 @@ else if (value instanceof String)
                     else if (value instanceof String)
                         return Long.parseLong(trimmed);
                     else
-                        throw new ConfigException(name, value, "Expected value to be an number.");
+                        throw new ConfigException(name, value, "Expected value to be a 64-bit integer (long), but it was a " + value.getClass().getName());
                 case DOUBLE:
                     if (value instanceof Number)
                         return ((Number) value).doubleValue();
                     else if (value instanceof String)
                         return Double.parseDouble(trimmed);
                     else
-                        throw new ConfigException(name, value, "Expected value to be an number.");
+                        throw new ConfigException(name, value, "Expected value to be a double, but it was a " + value.getClass().getName());
                 case LIST:
                     if (value instanceof List)
                         return (List<?>) value;

From e992aca9eda38d8dfbf9488eadcc1b58b9998e99 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Fri, 27 Jan 2017 08:40:53 -0800
Subject: [PATCH 067/177] MINOR: Update KTable JavaDoc

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Damian Guy <damian.guy@gmail.com>

Closes #2438 from mjsax/ktableJavaDocs

(cherry picked from commit 1bd11b23ab55b25d5669813f47ad1d5670c6ec9c)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../kafka/streams/kstream/GlobalKTable.java   |  51 +-
 .../kafka/streams/kstream/KGroupedStream.java | 377 ++++---
 .../kafka/streams/kstream/KGroupedTable.java  | 539 ++++++++--
 .../apache/kafka/streams/kstream/KStream.java |  37 +-
 .../apache/kafka/streams/kstream/KTable.java  | 972 +++++++++++++-----
 5 files changed, 1434 insertions(+), 542 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/GlobalKTable.java b/streams/src/main/java/org/apache/kafka/streams/kstream/GlobalKTable.java
index 6616c908aa155..56f7bc8638ee5 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/GlobalKTable.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/GlobalKTable.java
@@ -19,40 +19,49 @@
 
 import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.streams.KafkaStreams;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.state.ReadOnlyKeyValueStore;
 
 /**
  * {@link GlobalKTable} is an abstraction of a <i>changelog stream</i> from a primary-keyed table.
- * Each record in this stream is an update on the primary-keyed table with the record key as the primary key.
+ * Each record in this changelog stream is an update on the primary-keyed table with the record key as the primary key.
  * <p>
- * A {@link GlobalKTable} is fully replicated per {@link KafkaStreams} instance. Every partition of the underlying topic
- * is consumed by each {@link GlobalKTable}, such that the full set of data is available in every {@link KafkaStreams} instance.
- * This provides the ability to perform joins with {@link KStream}, and {@link KTable},
- * without having to repartition the input streams. All joins with the {@link GlobalKTable} require that a {@link KeyValueMapper}
- * is provided that can map from the (key, value) of the left hand side to the key of the right hand side {@link GlobalKTable}
+ * {@link GlobalKTable} can only be used as right-hand side input for {@link KStream stream}-table joins.
+ * <p>
+ * In contrast to a {@link KTable} that is partitioned over all {@link KafkaStreams} instances, a {@link GlobalKTable}
+ * is fully replicated per {@link KafkaStreams} instance.
+ * Every partition of the underlying topic is consumed by each {@link GlobalKTable}, such that the full set of data is
+ * available in every {@link KafkaStreams} instance.
+ * This provides the ability to perform joins with {@link KStream} without having to repartition the input stream.
+ * All joins with the {@link GlobalKTable} require that a {@link KeyValueMapper} is provided that can map from the
+ * {@link KeyValue} of the left hand side {@link KStream} to the key of the right hand side {@link GlobalKTable}.
  * <p>
  * A {@link GlobalKTable} is created via a {@link KStreamBuilder}. For example:
- * <pre>
- *     builder.globalTable("topic-name", "queryable-store-name");
- * </pre>
- * all {@link GlobalKTable}s are backed by a {@link org.apache.kafka.streams.state.ReadOnlyKeyValueStore ReadOnlyKeyValueStore}
- * and are therefore queryable via the interactive queries API.
+ * <pre>{@code
+ * builder.globalTable("topic-name", "queryable-store-name");
+ * }</pre>
+ * all {@link GlobalKTable}s are backed by a {@link ReadOnlyKeyValueStore} and are therefore queryable via the
+ * interactive queries API.
  * For example:
  * <pre>{@code
- *     final GlobalKTable globalOne = builder.globalTable("g1", "g1-store");
- *     final GlobalKTable globalTwo = builder.globalTable("g2", "g2-store");
- *     ...
- *     final KafkaStreams streams = ...;
- *     streams.start()
- *     ...
- *     ReadOnlyKeyValueStore view = streams.store("g1-store", QueryableStoreTypes.keyValueStore());
- *     view.get(key);
+ * final GlobalKTable globalOne = builder.globalTable("g1", "g1-store");
+ * final GlobalKTable globalTwo = builder.globalTable("g2", "g2-store");
+ * ...
+ * final KafkaStreams streams = ...;
+ * streams.start()
+ * ...
+ * ReadOnlyKeyValueStore view = streams.store("g1-store", QueryableStoreTypes.keyValueStore());
+ * view.get(key); // can be done on any key, as all keys are present
  *}</pre>
- *
+ * Note that in contrast to {@link KTable} a {@link GlobalKTable}'s state holds a full copy if the underlying topic and
+ * thus, all keys can be queried locally.
  *
  * @param <K> Type of primary keys
  * @param <V> Type of value changes
- *
  * @see KTable
+ * @see KStreamBuilder#globalTable(String, String)
+ * @see KStream#join(GlobalKTable, KeyValueMapper, ValueJoiner)
+ * @see KStream#leftJoin(GlobalKTable, KeyValueMapper, ValueJoiner)
  */
 @InterfaceStability.Unstable
 public interface GlobalKTable<K, V> {
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java
index 586061f3dfc69..6cfd2026ae85f 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java
@@ -17,20 +17,24 @@
 import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.common.serialization.Serde;
 import org.apache.kafka.streams.KafkaStreams;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.StreamsConfig;
 import org.apache.kafka.streams.processor.StateStoreSupplier;
 import org.apache.kafka.streams.state.KeyValueStore;
 import org.apache.kafka.streams.state.QueryableStoreType;
-import org.apache.kafka.streams.state.WindowStore;
 import org.apache.kafka.streams.state.SessionStore;
-import org.apache.kafka.streams.StreamsConfig;
+import org.apache.kafka.streams.state.WindowStore;
 
 /**
- * {@link KGroupedStream} is an abstraction of a <i>grouped</i> record stream of key-value pairs.
+ * {@link KGroupedStream} is an abstraction of a <i>grouped</i> record stream of {@link KeyValue} pairs.
  * It is an intermediate representation of a {@link KStream} in order to apply an aggregation operation on the original
  * {@link KStream} records.
  * <p>
- * A {@link KGroupedStream} must be obtained from a {@link KStream} via {@link KStream#groupByKey() #groupByKey()} or
- * {@link KStream#groupBy(KeyValueMapper) #groupBy(...)}.
+ * It is an intermediate representation after a grouping of a {@link KStream} before an aggregation is applied to the
+ * new partitions resulting in a {@link KTable}.
+ * <p>
+ * A {@link KGroupedStream} must be obtained from a {@link KStream} via {@link KStream#groupByKey() groupByKey()} or
+ * {@link KStream#groupBy(KeyValueMapper) groupBy(...)}.
  *
  * @param <K> Type of keys
  * @param <V> Type of values
@@ -41,7 +45,7 @@ public interface KGroupedStream<K, V> {
 
     /**
      * Count the number of records in this stream by the grouped key.
-     * Records with {@code null} value are ignored.
+     * Records with {@code null} key or value are ignored.
      * The result is written into a local {@link KeyValueStore} (which is basically an ever-updating materialized view)
      * that can be queried using the provided {@code storeName}.
      * Furthermore, updates to the store are sent downstream into a {@link KTable} changelog stream.
@@ -49,9 +53,9 @@ public interface KGroupedStream<K, V> {
      * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
      * the same key.
      * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
-     * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link StreamsConfig} parameter
-     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
      * <p>
      * To query the local {@link KeyValueStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
@@ -72,17 +76,25 @@ public interface KGroupedStream<K, V> {
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
      * @param storeName the name of the underlying {@link KTable} state store
-     * @return a {@link KTable} that contains "update" records with unmodified keys and values that represent the latest
-     * (rolling) count (i.e., number of records) for each key
+     * @return a {@link KTable} that contains "update" records with unmodified keys and {@link Long} values that
+     * represent the latest (rolling) count (i.e., number of records) for each key
      */
     KTable<K, Long> count(final String storeName);
 
     /**
      * Count the number of records in this stream by the grouped key.
-     * Records with {@code null} value are ignored.
-     * The result is written into a local {@link KeyValueStore} provided by the given {@code storeSupplier}.
+     * Records with {@code null} key or value are ignored.
+     * The result is written into a local {@link KeyValueStore} (which is basically an ever-updating materialized view)
+     * provided by the given {@code storeSupplier}.
      * Furthermore, updates to the store are sent downstream into a {@link KTable} changelog stream.
      * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
      * To query the local {@link KeyValueStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
@@ -96,15 +108,15 @@ public interface KGroupedStream<K, V> {
      * For non-local keys, a custom RPC mechanism must be implemented using {@link KafkaStreams#allMetadata()} to
      * query the value of the key on a parallel running instance of your Kafka Streams application.
      *
-     * @param storeSupplier user defined state store supplier {@link StateStoreSupplier}
-     * @return a {@link KTable} that contains "update" records with unmodified keys and values that represent the latest
-     * (rolling) count (i.e., number of records) for each key
+     * @param storeSupplier user defined state store supplier
+     * @return a {@link KTable} that contains "update" records with unmodified keys and {@link Long} values that
+     * represent the latest (rolling) count (i.e., number of records) for each key
      */
     KTable<K, Long> count(final StateStoreSupplier<KeyValueStore> storeSupplier);
 
     /**
      * Count the number of records in this stream by the grouped key and the defined windows.
-     * Records with {@code null} value are ignored.
+     * Records with {@code null} key or value are ignored.
      * The specified {@code windows} define either hopping time windows that can be overlapping or tumbling (c.f.
      * {@link TimeWindows}) or they define landmark windows (c.f. {@link UnlimitedWindows}).
      * The result is written into a local windowed {@link KeyValueStore} (which is basically an ever-updating
@@ -116,9 +128,9 @@ public interface KGroupedStream<K, V> {
      * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
      * the same window and key.
      * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
-     * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link StreamsConfig} parameter
-     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
      * <p>
      * To query the local windowed {@link KeyValueStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
@@ -142,22 +154,30 @@ public interface KGroupedStream<K, V> {
      *
      * @param windows   the specification of the aggregation {@link Windows}
      * @param storeName the name of the underlying {@link KTable} state store
-     * @return a windowed {@link KTable} that contains "update" records with unmodified keys and values that represent
-     * the latest (rolling) count (i.e., number of records) for each key within a window
+     * @return a windowed {@link KTable} that contains "update" records with unmodified keys and {@link Long} values
+     * that represent the latest (rolling) count (i.e., number of records) for each key within a window
      */
     <W extends Window> KTable<Windowed<K>, Long> count(final Windows<W> windows,
                                                        final String storeName);
 
     /**
      * Count the number of records in this stream by the grouped key and the defined windows.
-     * Records with {@code null} value are ignored.
+     * Records with {@code null} key or value are ignored.
      * The specified {@code windows} define either hopping time windows that can be overlapping or tumbling (c.f.
      * {@link TimeWindows}) or they define landmark windows (c.f. {@link UnlimitedWindows}).
-     * The result is written into a local windowed {@link KeyValueStore} provided by the given {@code storeSupplier}.
+     * The result is written into a local windowed {@link KeyValueStore} (which is basically an ever-updating
+     * materialized view) provided by the given {@code storeSupplier}.
      * Windows are retained until their retention time expires (c.f. {@link Windows#until(long)}).
      * Furthermore, updates to the store are sent downstream into a windowed {@link KTable} changelog stream, where
      * "windowed" implies that the {@link KTable} key is a combined key of the original record key and a window ID.
      * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same window and key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
      * To query the local windowed {@link KeyValueStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
@@ -174,9 +194,9 @@ <W extends Window> KTable<Windowed<K>, Long> count(final Windows<W> windows,
      * query the value of the key on a parallel running instance of your Kafka Streams application.
      *
      * @param windows       the specification of the aggregation {@link Windows}
-     * @param storeSupplier user defined state store supplier {@link StateStoreSupplier}
-     * @return a windowed {@link KTable} that contains "update" records with unmodified keys and values that represent
-     * the latest (rolling) count (i.e., number of records) for each key within a window
+     * @param storeSupplier user defined state store supplier
+     * @return a windowed {@link KTable} that contains "update" records with unmodified keys and {@link Long} values
+     * that represent the latest (rolling) count (i.e., number of records) for each key within a window
      */
     <W extends Window> KTable<Windowed<K>, Long> count(final Windows<W> windows,
                                                        final StateStoreSupplier<WindowStore> storeSupplier);
@@ -184,13 +204,20 @@ <W extends Window> KTable<Windowed<K>, Long> count(final Windows<W> windows,
 
     /**
      * Count the number of records in this stream by the grouped key into {@link SessionWindows}.
-     * Records with {@code null} value are ignored.
+     * Records with {@code null} key or value are ignored.
      * The result is written into a local {@link SessionStore} (which is basically an ever-updating
      * materialized view) that can be queried using the provided {@code storeName}.
      * SessionWindows are retained until their retention time expires (c.f. {@link SessionWindows#until(long)}).
      * Furthermore, updates to the store are sent downstream into a windowed {@link KTable} changelog stream, where
      * "windowed" implies that the {@link KTable} key is a combined key of the original record key and a window ID.
      * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same window and key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
      * To query the local {@link SessionStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
@@ -207,20 +234,27 @@ <W extends Window> KTable<Windowed<K>, Long> count(final Windows<W> windows,
      *
      * @param sessionWindows the specification of the aggregation {@link SessionWindows}
      * @param storeName      the name of the state store created from this operation.
-     * @return a windowed {@link KTable} which can be treated as a list of {@code KTable}s
-     *         where each table contains records with unmodified keys and values
-     *         that represent the latest (rolling) count (i.e., number of records) for each key within that window
+     * @return a windowed {@link KTable} that contains "update" records with unmodified keys and {@link Long} values
+     * that represent the latest (rolling) count (i.e., number of records) for each key within a window
      */
     KTable<Windowed<K>, Long> count(final SessionWindows sessionWindows, final String storeName);
 
     /**
      * Count the number of records in this stream by the grouped key into {@link SessionWindows}.
-     * Records with {@code null} value are ignored.
-     * The result is written into a local {@link SessionStore} provided by the given {@code storeSupplier}.
+     * Records with {@code null} key or value are ignored.
+     * The result is written into a local {@link SessionStore} (which is basically an ever-updating materialized view)
+     * provided by the given {@code storeSupplier}.
      * SessionWindows are retained until their retention time expires (c.f. {@link SessionWindows#until(long)}).
      * Furthermore, updates to the store are sent downstream into a windowed {@link KTable} changelog stream, where
      * "windowed" implies that the {@link KTable} key is a combined key of the original record key and a window ID.
      * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same window and key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
      * To query the local {@link SessionStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
@@ -236,36 +270,35 @@ <W extends Window> KTable<Windowed<K>, Long> count(final Windows<W> windows,
      *
      *
      * @param sessionWindows the specification of the aggregation {@link SessionWindows}
-     * @param storeSupplier  user defined state store supplier {@link StateStoreSupplier}
-     * @return a windowed {@link KTable} which can be treated as a list of {@code KTable}s
-     *         where each table contains records with unmodified keys and values
-     *         that represent the latest (rolling) count (i.e., number of records) for each key within that window
+     * @param storeSupplier  user defined state store supplier
+     * @return a windowed {@link KTable} that contains "update" records with unmodified keys and {@link Long} values
+     * that represent the latest (rolling) count (i.e., number of records) for each key within a window
      */
     KTable<Windowed<K>, Long> count(final SessionWindows sessionWindows,
                                     final StateStoreSupplier<SessionStore> storeSupplier);
 
     /**
      * Combine the values of records in this stream by the grouped key.
-     * Records with {@code null} value are ignored.
+     * Records with {@code null} key or value are ignored.
      * Combining implies that the type of the aggregate result is the same as the type of the input value
      * (c.f. {@link #aggregate(Initializer, Aggregator, Serde, String)}).
      * The result is written into a local {@link KeyValueStore} (which is basically an ever-updating materialized view)
      * that can be queried using the provided {@code storeName}.
      * Furthermore, updates to the store are sent downstream into a {@link KTable} changelog stream.
      * <p>
-     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
-     * the same key.
-     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
-     * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link StreamsConfig} parameter
-     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
-     * <p>
      * The specified {@link Reducer} is applied for each input record and computes a new aggregate using the current
      * aggregate and the record's value.
-     * If there is no current aggregate the {@link Reducer} is not applied an the new aggregate will be the record's
+     * If there is no current aggregate the {@link Reducer} is not applied and the new aggregate will be the record's
      * value as-is.
      * Thus, {@code reduce(Reducer, String)} can be used to compute aggregate functions like sum, min, or max.
      * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
      * To query the local {@link KeyValueStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
      * <pre>{@code
@@ -286,27 +319,35 @@ KTable<Windowed<K>, Long> count(final SessionWindows sessionWindows,
      *
      * @param reducer   a {@link Reducer} that computes a new aggregate result
      * @param storeName the name of the underlying {@link KTable} state store
-     * @return a {@link KTable} that contains "update" records with unmodified keys and values that represent the latest
-     * (rolling) aggregate for each key
+     * @return a {@link KTable} that contains "update" records with unmodified keys, and values that represent the
+     * latest (rolling) aggregate for each key
      */
     KTable<K, V> reduce(final Reducer<V> reducer,
                         final String storeName);
 
     /**
      * Combine the value of records in this stream by the grouped key.
-     * Records with {@code null} value are ignored.
+     * Records with {@code null} key or value are ignored.
      * Combining implies that the type of the aggregate result is the same as the type of the input value
      * (c.f. {@link #aggregate(Initializer, Aggregator, StateStoreSupplier)}).
-     * The result is written into a local {@link KeyValueStore} provided by the given {@code storeSupplier}.
+     * The result is written into a local {@link KeyValueStore} (which is basically an ever-updating materialized view)
+     * provided by the given {@code storeSupplier}.
      * Furthermore, updates to the store are sent downstream into a {@link KTable} changelog stream.
      * <p>
      * The specified {@link Reducer} is applied for each input record and computes a new aggregate using the current
      * aggregate and the record's value.
-     * If there is no current aggregate the {@link Reducer} is not applied an the new aggregate will be the record's
+     * If there is no current aggregate the {@link Reducer} is not applied and the new aggregate will be the record's
      * value as-is.
      * Thus, {@code reduce(Reducer, StateStoreSupplier)} can be used to compute aggregate functions like sum, min, or
      * max.
      * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
      * To query the local {@link KeyValueStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
@@ -320,16 +361,16 @@ KTable<K, V> reduce(final Reducer<V> reducer,
      * query the value of the key on a parallel running instance of your Kafka Streams application.
      *
      * @param reducer   a {@link Reducer} that computes a new aggregate result
-     * @param storeSupplier user defined state store supplier {@link StateStoreSupplier}
-     * @return a {@link KTable} that contains "update" records with unmodified keys and values that represent the latest
-     * (rolling) aggregate for each key
+     * @param storeSupplier user defined state store supplier
+     * @return a {@link KTable} that contains "update" records with unmodified keys, and values that represent the
+     * latest (rolling) aggregate for each key
      */
     KTable<K, V> reduce(final Reducer<V> reducer,
                         final StateStoreSupplier<KeyValueStore> storeSupplier);
 
     /**
      * Combine the number of records in this stream by the grouped key and the defined windows.
-     * Records with {@code null} value are ignored.
+     * Records with {@code null} key or value are ignored.
      * Combining implies that the type of the aggregate result is the same as the type of the input value
      * (c.f. {@link #aggregate(Initializer, Aggregator, Windows, Serde, String)}).
      * The specified {@code windows} define either hopping time windows that can be overlapping or tumbling (c.f.
@@ -340,19 +381,19 @@ KTable<K, V> reduce(final Reducer<V> reducer,
      * Furthermore, updates to the store are sent downstream into a windowed {@link KTable} changelog stream, where
      * "windowed" implies that the {@link KTable} key is a combined key of the original record key and a window ID.
      * <p>
-     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
-     * the same key.
-     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
-     * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link StreamsConfig} parameter
-     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
-     * <p>
      * The specified {@link Reducer} is applied for each input record and computes a new aggregate using the current
      * aggregate and the record's value.
-     * If there is no current aggregate the {@link Reducer} is not applied an the new aggregate will be the record's
+     * If there is no current aggregate the {@link Reducer} is not applied and the new aggregate will be the record's
      * value as-is.
      * Thus, {@code reduce(Reducer, Windows, String)} can be used to compute aggregate functions like sum, min, or max.
      * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same window and key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
      * To query the local windowed {@link KeyValueStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
      * <pre>{@code
@@ -376,7 +417,7 @@ KTable<K, V> reduce(final Reducer<V> reducer,
      * @param reducer   a {@link Reducer} that computes a new aggregate result
      * @param windows   the specification of the aggregation {@link Windows}
      * @param storeName the name of the state store created from this operation
-     * @return a windowed {@link KTable} that contains "update" records with unmodified keys and values that represent
+     * @return a windowed {@link KTable} that contains "update" records with unmodified keys, and values that represent
      * the latest (rolling) aggregate for each key within a window
      */
     <W extends Window> KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
@@ -385,23 +426,31 @@ <W extends Window> KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
 
     /**
      * Combine the values of records in this stream by the grouped key and the defined windows.
-     * Records with {@code null} value are ignored.
+     * Records with {@code null} key or value are ignored.
      * Combining implies that the type of the aggregate result is the same as the type of the input value
      * (c.f. {@link #aggregate(Initializer, Aggregator, Windows, Serde, String)}).
      * The specified {@code windows} define either hopping time windows that can be overlapping or tumbling (c.f.
      * {@link TimeWindows}) or they define landmark windows (c.f. {@link UnlimitedWindows}).
-     * The result is written into a local windowed {@link KeyValueStore} provided by the given {@code storeSupplier}.
+     * The result is written into a local windowed {@link KeyValueStore} (which is basically an ever-updating
+     * materialized view) provided by the given {@code storeSupplier}.
      * Windows are retained until their retention time expires (c.f. {@link Windows#until(long)}).
      * Furthermore, updates to the store are sent downstream into a windowed {@link KTable} changelog stream, where
      * "windowed" implies that the {@link KTable} key is a combined key of the original record key and a window ID.
      * <p>
      * The specified {@link Reducer} is applied for each input record and computes a new aggregate using the current
      * aggregate and the record's value.
-     * If there is no current aggregate the {@link Reducer} is not applied an the new aggregate will be the record's
+     * If there is no current aggregate the {@link Reducer} is not applied and the new aggregate will be the record's
      * value as-is.
      * Thus, {@code reduce(Reducer, Windows, StateStoreSupplier)} can be used to compute aggregate functions like sum,
      * min, or max.
      * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same window and key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
      * To query the local windowed {@link KeyValueStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
@@ -419,8 +468,8 @@ <W extends Window> KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      *
      * @param reducer       a {@link Reducer} that computes a new aggregate result
      * @param windows       the specification of the aggregation {@link Windows}
-     * @param storeSupplier user defined state store supplier {@link StateStoreSupplier}
-     * @return a windowed {@link KTable} that contains "update" records with unmodified keys and values that represent
+     * @param storeSupplier user defined state store supplier
+     * @return a windowed {@link KTable} that contains "update" records with unmodified keys, and values that represent
      * the latest (rolling) aggregate for each key within a window
      */
     <W extends Window> KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
@@ -429,6 +478,7 @@ <W extends Window> KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
 
     /**
      * Combine values of this stream by the grouped key into {@link SessionWindows}.
+     * Records with {@code null} key or value are ignored.
      * Combining implies that the type of the aggregate result is the same as the type of the input value
      * (c.f. {@link #aggregate(Initializer, Aggregator, Merger, SessionWindows, Serde, String)}).
      * The result is written into a local {@link SessionStore} (which is basically an ever-updating
@@ -437,20 +487,20 @@ <W extends Window> KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      * Furthermore, updates to the store are sent downstream into a windowed {@link KTable} changelog stream, where
      * "windowed" implies that the {@link KTable} key is a combined key of the original record key and a window ID.
      * <p>
-     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
-     * the same key.
-     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
-     * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link StreamsConfig} parameter
-     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
-     * <p>
      * The specified {@link Reducer} is applied for each input record and computes a new aggregate using the current
      * aggregate and the record's value.
-     * If there is no current aggregate the {@link Reducer} is not applied an the new aggregate will be the record's
+     * If there is no current aggregate the {@link Reducer} is not applied and the new aggregate will be the record's
      * value as-is.
      * Thus, {@code reduce(Reducer, SessionWindows, String)} can be used to compute aggregate functions like sum, min,
      * or max.
      * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same window and key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
      * To query the local {@link SessionStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
      * <pre>{@code
@@ -471,9 +521,8 @@ <W extends Window> KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      * @param reducer           the instance of {@link Reducer}
      * @param sessionWindows    the specification of the aggregation {@link SessionWindows}
      * @param storeName         the name of the state store created from this operation
-     * @return a windowed {@link KTable} which can be treated as a list of {@code KTable}s
-     *         where each table contains records with unmodified keys and values
-     *         that represent the latest (rolling) aggregate for each key within that window
+     * @return a windowed {@link KTable} that contains "update" records with unmodified keys, and values that represent
+     * the latest (rolling) aggregate for each key within a window
      */
     KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
                                   final SessionWindows sessionWindows,
@@ -481,27 +530,29 @@ KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
 
     /**
      * Combine values of this stream by the grouped key into {@link SessionWindows}.
+     * Records with {@code null} key or value are ignored.
      * Combining implies that the type of the aggregate result is the same as the type of the input value
      * (c.f. {@link #aggregate(Initializer, Aggregator, Merger, SessionWindows, Serde, String)}).
-     * The result is written into a local {@link SessionStore} provided by the given {@code storeSupplier}.
+     * The result is written into a local {@link SessionStore} (which is basically an ever-updating materialized view)
+     * provided by the given {@code storeSupplier}.
      * SessionWindows are retained until their retention time expires (c.f. {@link SessionWindows#until(long)}).
      * Furthermore, updates to the store are sent downstream into a windowed {@link KTable} changelog stream, where
      * "windowed" implies that the {@link KTable} key is a combined key of the original record key and a window ID.
      * <p>
-     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
-     * the same key.
-     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
-     * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link StreamsConfig} parameter
-     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
-     * <p>
      * The specified {@link Reducer} is applied for each input record and computes a new aggregate using the current
      * aggregate and the record's value.
-     * If there is no current aggregate the {@link Reducer} is not applied an the new aggregate will be the record's
+     * If there is no current aggregate the {@link Reducer} is not applied and the new aggregate will be the record's
      * value as-is.
      * Thus, {@code reduce(Reducer, SessionWindows, StateStoreSupplier)} can be used to compute aggregate functions like
      * sum, min, or max.
      * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same window and key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
      * To query the local {@link SessionStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
      * <pre>{@code
@@ -521,10 +572,9 @@ KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * @param reducer           the instance of {@link Reducer}
      * @param sessionWindows    the specification of the aggregation {@link SessionWindows}
-     * @param storeSupplier     user defined state store supplier {@link StateStoreSupplier}
-     * @return a windowed {@link KTable} which can be treated as a list of {@code KTable}s
-     *         where each table contains records with unmodified keys and values
-     *         that represent the latest (rolling) aggregate for each key within that window
+     * @param storeSupplier     user defined state store supplier
+     * @return a windowed {@link KTable} that contains "update" records with unmodified keys, and values that represent
+     * the latest (rolling) aggregate for each key within a window
      */
     KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
                                   final SessionWindows sessionWindows,
@@ -533,27 +583,27 @@ KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
 
     /**
      * Aggregate the values of records in this stream by the grouped key.
-     * Records with {@code null} value are ignored.
-     * Aggregating is a generalization of {@link #reduce(Reducer, String) combining via reduce(...)} as it allows the
-     * result to have a different type than the input values.
+     * Records with {@code null} key or value are ignored.
+     * Aggregating is a generalization of {@link #reduce(Reducer, String) combining via reduce(...)} as it, for example,
+     * allows the result to have a different type than the input values.
      * The result is written into a local {@link KeyValueStore} (which is basically an ever-updating materialized view)
      * that can be queried using the provided {@code storeName}.
      * Furthermore, updates to the store are sent downstream into a {@link KTable} changelog stream.
      * <p>
-     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
-     * the same key.
-     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
-     * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link StreamsConfig} parameter
-     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
-     * <p>
      * The specified {@link Initializer} is applied once directly before the first input record is processed to
      * provide an initial intermediate aggregation result that is used to process the first record.
      * The specified {@link Aggregator} is applied for each input record and computes a new aggregate using the current
      * aggregate (or for the very first record using the intermediate aggregation result provided via the
      * {@link Initializer}) and the record's value.
      * Thus, {@code aggregate(Initializer, Aggregator, Serde, String)} can be used to compute aggregate functions like
-     * count (c.f. {@link #count(String)})
+     * count (c.f. {@link #count(String)}).
+     * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
      * <p>
      * To query the local {@link KeyValueStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
@@ -579,8 +629,8 @@ KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      *                      if not specified the default serdes defined in the configs will be used
      * @param storeName     the name of the state store created from this operation
      * @param <VR>          the value type of the resulting {@link KTable}
-     * @return a {@link KTable} that contains "update" records with unmodified keys and values that represent the latest
-     * (rolling) aggregate for each key
+     * @return a {@link KTable} that contains "update" records with unmodified keys, and values that represent the
+     * latest (rolling) aggregate for each key
      */
     <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
                                  final Aggregator<? super K, ? super V, VR> aggregator,
@@ -589,10 +639,11 @@ <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
 
     /**
      * Aggregate the values of records in this stream by the grouped key.
-     * Records with {@code null} value are ignored.
-     * Aggregating is a generalization of {@link #reduce(Reducer, StateStoreSupplier)} combining via reduce(...)} as it
-     * allows the result to have a different type than the input values.
-     * The result is written into a local {@link KeyValueStore} provided by the given {@code storeSupplier}.
+     * Records with {@code null} key or value are ignored.
+     * Aggregating is a generalization of {@link #reduce(Reducer, StateStoreSupplier) combining via reduce(...)} as it,
+     * for example, allows the result to have a different type than the input values.
+     * The result is written into a local {@link KeyValueStore} (which is basically an ever-updating materialized view)
+     * provided by the given {@code storeSupplier}.
      * Furthermore, updates to the store are sent downstream into a {@link KTable} changelog stream.
      * <p>
      * The specified {@link Initializer} is applied once directly before the first input record is processed to
@@ -601,7 +652,14 @@ <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
      * aggregate (or for the very first record using the intermediate aggregation result provided via the
      * {@link Initializer}) and the record's value.
      * Thus, {@code aggregate(Initializer, Aggregator, StateStoreSupplier)} can be used to compute aggregate functions
-     * like count (c.f. {@link #count(String)})
+     * like count (c.f. {@link #count(String)}).
+     * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
      * <p>
      * To query the local {@link KeyValueStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
@@ -617,10 +675,10 @@ <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
      *
      * @param initializer   an {@link Initializer} that computes an initial intermediate aggregation result
      * @param aggregator    an {@link Aggregator} that computes a new aggregate result
-     * @param storeSupplier user defined state store supplier {@link StateStoreSupplier}
+     * @param storeSupplier user defined state store supplier
      * @param <VR>          the value type of the resulting {@link KTable}
-     * @return a {@link KTable} that contains "update" records with unmodified keys and values that represent the latest
-     * (rolling) aggregate for each key
+     * @return a {@link KTable} that contains "update" records with unmodified keys, and values that represent the
+     * latest (rolling) aggregate for each key
      */
     <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
                                  final Aggregator<? super K, ? super V, VR> aggregator,
@@ -628,9 +686,9 @@ <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
 
     /**
      * Aggregate the values of records in this stream by the grouped key and defined windows.
-     * Records with {@code null} value are ignored.
-     * Aggregating is a generalization of {@link #reduce(Reducer, Windows, String)} combining via reduce(...)} as it
-     * allows the result to have a different type than the input values.
+     * Records with {@code null} key or value are ignored.
+     * Aggregating is a generalization of {@link #reduce(Reducer, Windows, String) combining via reduce(...)} as it,
+     * for example, allows the result to have a different type than the input values.
      * The specified {@code windows} define either hopping time windows that can be overlapping or tumbling (c.f.
      * {@link TimeWindows}) or they define landmark windows (c.f. {@link UnlimitedWindows}).
      * The result is written into a local windowed {@link KeyValueStore} (which is basically an ever-updating
@@ -639,20 +697,20 @@ <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
      * Furthermore, updates to the store are sent downstream into a windowed {@link KTable} changelog stream, where
      * "windowed" implies that the {@link KTable} key is a combined key of the original record key and a window ID.
      * <p>
-     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
-     * the same key.
-     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
-     * parallel running Kafka Streams instances, and the cache size.
-     * You can configure the cache size via {@link StreamsConfig} parameter
-     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG CACHE_MAX_BYTES_BUFFERING_CONFIG}.
-     * <p>
      * The specified {@link Initializer} is applied once per window directly before the first input record is
      * processed to provide an initial intermediate aggregation result that is used to process the first record.
      * The specified {@link Aggregator} is applied for each input record and computes a new aggregate using the current
      * aggregate (or for the very first record using the intermediate aggregation result provided via the
      * {@link Initializer}) and the record's value.
      * Thus, {@code aggregate(Initializer, Aggregator, Windows, Serde, String)} can be used to compute aggregate
-     * functions like count (c.f. {@link #count(String)})
+     * functions like count (c.f. {@link #count(String)}).
+     * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same window and key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
      * <p>
      * To query the local windowed {@link KeyValueStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
@@ -682,7 +740,7 @@ <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
      *                      if not specified the default serdes defined in the configs will be used
      * @param <VR>          the value type of the resulting {@link KTable}
      * @param storeName     the name of the state store created from this operation
-     * @return a windowed {@link KTable} that contains "update" records with unmodified keys and values that represent
+     * @return a windowed {@link KTable} that contains "update" records with unmodified keys, and values that represent
      * the latest (rolling) aggregate for each key within a window
      */
     <W extends Window, VR> KTable<Windowed<K>, VR> aggregate(final Initializer<VR> initializer,
@@ -693,12 +751,13 @@ <W extends Window, VR> KTable<Windowed<K>, VR> aggregate(final Initializer<VR> i
 
     /**
      * Aggregate the values of records in this stream by the grouped key and defined windows.
-     * Records with {@code null} value are ignored.
-     * Aggregating is a generalization of {@link #reduce(Reducer, Windows, StateStoreSupplier)} combining via
-     * reduce(...)} as it allows the result to have a different type than the input values.
+     * Records with {@code null} key or value are ignored.
+     * Aggregating is a generalization of {@link #reduce(Reducer, Windows, StateStoreSupplier) combining via
+     * reduce(...)} as it, for example, allows the result to have a different type than the input values.
      * The specified {@code windows} define either hopping time windows that can be overlapping or tumbling (c.f.
      * {@link TimeWindows}) or they define landmark windows (c.f. {@link UnlimitedWindows}).
-     * The result is written into a local windowed {@link KeyValueStore} provided by the given {@code storeSupplier}.
+     * The result is written into a local windowed {@link KeyValueStore} (which is basically an ever-updating
+     * materialized view) provided by the given {@code storeSupplier}.
      * Windows are retained until their retention time expires (c.f. {@link Windows#until(long)}).
      * Furthermore, updates to the store are sent downstream into a windowed {@link KTable} changelog stream, where
      * "windowed" implies that the {@link KTable} key is a combined key of the original record key and a window ID.
@@ -709,13 +768,20 @@ <W extends Window, VR> KTable<Windowed<K>, VR> aggregate(final Initializer<VR> i
      * aggregate (or for the very first record using the intermediate aggregation result provided via the
      * {@link Initializer}) and the record's value.
      * Thus, {@code aggregate(Initializer, Aggregator, Windows, StateStoreSupplier)} can be used to compute aggregate
-     * functions like count (c.f. {@link #count(String)}) TODO add more examples.
+     * functions like count (c.f. {@link #count(String)}).
+     * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same window and key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
      * <p>
      * To query the local windowed {@link KeyValueStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
      * <pre>{@code
-     * KafkaStreams streams = ... // some windowed aggregation on value type double TODO update example
+     * KafkaStreams streams = ... // some windowed aggregation on value type Long
      * Sting storeName = storeSupplier.name();
      * ReadOnlyWindowStore<String,Long> localWindowStore = streams.store(storeName, QueryableStoreTypes.<String, Long>windowStore());
      * String key = "some-key";
@@ -730,8 +796,8 @@ <W extends Window, VR> KTable<Windowed<K>, VR> aggregate(final Initializer<VR> i
      * @param aggregator    an {@link Aggregator} that computes a new aggregate result
      * @param windows       the specification of the aggregation {@link Windows}
      * @param <VR>          the value type of the resulting {@link KTable}
-     * @param storeSupplier user defined state store supplier {@link StateStoreSupplier}
-     * @return a windowed {@link KTable} that contains "update" records with unmodified keys and values that represent
+     * @param storeSupplier user defined state store supplier
+     * @return a windowed {@link KTable} that contains "update" records with unmodified keys, and values that represent
      * the latest (rolling) aggregate for each key within a window
      */
     <W extends Window, VR> KTable<Windowed<K>, VR> aggregate(final Initializer<VR> initializer,
@@ -741,9 +807,9 @@ <W extends Window, VR> KTable<Windowed<K>, VR> aggregate(final Initializer<VR> i
 
     /**
      * Aggregate the values of records in this stream by the grouped key and defined {@link SessionWindows}.
-     * Records with {@code null} value are ignored.
-     * Aggregating is a generalization of {@link #reduce(Reducer, SessionWindows, String)} combining via
-     * reduce(...)} as it allows the result to have a different type than the input values.
+     * Records with {@code null} key or value are ignored.
+     * Aggregating is a generalization of {@link #reduce(Reducer, SessionWindows, String) combining via
+     * reduce(...)} as it, for example, allows the result to have a different type than the input values.
      * The result is written into a local {@link SessionStore} (which is basically an ever-updating
      * materialized view) that can be queried using the provided {@code storeName}.
      * SessionWindows are retained until their retention time expires (c.f. {@link SessionWindows#until(long)}).
@@ -758,6 +824,13 @@ <W extends Window, VR> KTable<Windowed<K>, VR> aggregate(final Initializer<VR> i
      * Thus, {@code aggregate(Initializer, Aggregator, Merger, SessionWindows, Serde, String)} can be used to compute
      * aggregate functions like count (c.f. {@link #count(String)})
      * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same window and key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
      * To query the local {@link SessionStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
      * Use {@link StateStoreSupplier#name()} to get the store name:
@@ -779,9 +852,8 @@ <W extends Window, VR> KTable<Windowed<K>, VR> aggregate(final Initializer<VR> i
      *                      if not specified the default serdes defined in the configs will be used
      * @param <T>           the value type of the resulting {@link KTable}
      * @param storeName     the name of the state store created from this operation
-     * @return a windowed {@link KTable} which can be treated as a list of {@code KTable}s
-     *         where each table contains records with unmodified keys and values with type {@code T}
-     *         that represent the latest (rolling) aggregate for each key within that window
+     * @return a windowed {@link KTable} that contains "update" records with unmodified keys, and values that represent
+     * the latest (rolling) aggregate for each key within a window
      */
     <T> KTable<Windowed<K>, T> aggregate(final Initializer<T> initializer,
                                          final Aggregator<? super K, ? super V, T> aggregator,
@@ -792,10 +864,11 @@ <T> KTable<Windowed<K>, T> aggregate(final Initializer<T> initializer,
 
     /**
      * Aggregate the values of records in this stream by the grouped key and defined {@link SessionWindows}.
-     * Records with {@code null} value are ignored.
-     * Aggregating is a generalization of {@link #reduce(Reducer, SessionWindows, String)} combining via
-     * reduce(...)} as it allows the result to have a different type than the input values.
-     * The result is written into a local {@link SessionStore} provided by the given {@code storeSupplier}.
+     * Records with {@code null} key or value are ignored.
+     * Aggregating is a generalization of {@link #reduce(Reducer, SessionWindows, String) combining via
+     * reduce(...)} as it, for example, allows the result to have a different type than the input values.
+     * The result is written into a local {@link SessionStore} (which is basically an ever-updating materialized view)
+     * provided by the given {@code storeSupplier}.
      * SessionWindows are retained until their retention time expires (c.f. {@link SessionWindows#until(long)}).
      * Furthermore, updates to the store are sent downstream into a windowed {@link KTable} changelog stream, where
      * "windowed" implies that the {@link KTable} key is a combined key of the original record key and a window ID.
@@ -806,7 +879,14 @@ <T> KTable<Windowed<K>, T> aggregate(final Initializer<T> initializer,
      * aggregate (or for the very first record using the intermediate aggregation result provided via the
      * {@link Initializer}) and the record's value.
      * Thus, {@code #aggregate(Initializer, Aggregator, Merger, SessionWindows, Serde, StateStoreSupplier)} can be used
-     * to compute aggregate functions like count (c.f. {@link #count(String)})
+     * to compute aggregate functions like count (c.f. {@link #count(String)}).
+     * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same window and key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
      * <p>
      * To query the local {@link SessionStore} it must be obtained via
      * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
@@ -828,11 +908,10 @@ <T> KTable<Windowed<K>, T> aggregate(final Initializer<T> initializer,
      * @param sessionWindows the specification of the aggregation {@link SessionWindows}
      * @param aggValueSerde  aggregate value serdes for materializing the aggregated table,
      *                       if not specified the default serdes defined in the configs will be used
-     * @param storeSupplier  user defined state store supplier {@link StateStoreSupplier}
+     * @param storeSupplier  user defined state store supplier
      * @param <T>           the value type of the resulting {@link KTable}
-     * @return a windowed {@link KTable} which can be treated as a list of {@code KTable}s
-     *         where each table contains records with unmodified keys and values with type {@code T}
-     *         that represent the latest (rolling) aggregate for each key within that window
+     * @return a windowed {@link KTable} that contains "update" records with unmodified keys, and values that represent
+     * the latest (rolling) aggregate for each key within a window
      */
     <T> KTable<Windowed<K>, T> aggregate(final Initializer<T> initializer,
                                          final Aggregator<? super K, ? super V, T> aggregator,
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedTable.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedTable.java
index 9e23c071de6ed..c736a8567a6eb 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedTable.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedTable.java
@@ -19,139 +19,488 @@
 
 import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.common.serialization.Serde;
+import org.apache.kafka.streams.KafkaStreams;
+import org.apache.kafka.streams.StreamsConfig;
 import org.apache.kafka.streams.processor.StateStoreSupplier;
 import org.apache.kafka.streams.state.KeyValueStore;
+import org.apache.kafka.streams.state.QueryableStoreType;
 
 /**
- * {@link KGroupedTable} is an abstraction of a <i>grouped changelog stream</i> from a primary-keyed table,
+ * {@link KGroupedTable} is an abstraction of a <i>re-grouped changelog stream</i> from a primary-keyed table,
  * usually on a different grouping key than the original primary key.
  * <p>
- * It is an intermediate representation after a re-grouping of a {@link KTable} before an aggregation is applied
- * to the new partitions resulting in a new {@link KTable}.
+ * It is an intermediate representation after a re-grouping of a {@link KTable} before an aggregation is applied to the
+ * new partitions resulting in a new {@link KTable}.
+ * <p>
+ * A {@link KGroupedTable} must be obtained from a {@link KTable} via {@link KTable#groupBy(KeyValueMapper)
+ * groupBy(...)}.
  *
- * @param <K> Type of primary keys
- * @param <V> Type of value changes
+ * @param <K> Type of keys
+ * @param <V> Type of values
+ * @see KTable
  */
 @InterfaceStability.Unstable
 public interface KGroupedTable<K, V> {
 
     /**
-     * Combine updating values of this stream by the selected key into a new instance of {@link KTable}.
-     * The resulting {@link KTable} will be materialized in a local state
-     * store with the given store name. Also a changelog topic named "${applicationId}-${storeName}-changelog"
-     * will be automatically created in Kafka for failure recovery, where "applicationID"
-     * is specified by the user in {@link org.apache.kafka.streams.StreamsConfig}.
+     * Count number of records of the original {@link KTable} that got {@link KTable#groupBy(KeyValueMapper) mapped} to
+     * the same key into a new instance of {@link KTable}.
+     * Records with {@code null} key are ignored.
+     * The result is written into a local {@link KeyValueStore} (which is basically an ever-updating materialized view)
+     * that can be queried using the provided {@code storeName}.
+     * Furthermore, updates to the store are sent downstream into a {@link KTable} changelog stream.
+     * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
+     * To query the local {@link KeyValueStore} it must be obtained via
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * <pre>{@code
+     * KafkaStreams streams = ... // counting words
+     * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
+     * String key = "some-word";
+     * Long countForWord = localStore.get(key); // key must be local (application state is shared over all running Kafka Streams instances)
+     * }</pre>
+     * For non-local keys, a custom RPC mechanism must be implemented using {@link KafkaStreams#allMetadata()} to
+     * query the value of the key on a parallel running instance of your Kafka Streams application.
+     * <p>
+     * For failure and recovery the store will be backed by an internal changelog topic that will be created in Kafka.
+     * The changelog topic will be named "${applicationId}-${storeName}-changelog", where "applicationId" is
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
+     * provide {@code storeName}, and "-changelog" is a fixed suffix.
+     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
-     * @param adder         the instance of {@link Reducer} for addition
-     * @param subtractor    the instance of {@link Reducer} for subtraction
-     * @param storeName     the name of the underlying {@link KTable} state store
-     * @return a {@link KTable} with the same key and value types as this {@link KGroupedTable},
-     *         containing aggregated values for each key
+     * @param storeName the name of the underlying {@link KTable} state store
+     * @return a {@link KTable} that contains "update" records with unmodified keys and {@link Long} values that
+     * represent the latest (rolling) count (i.e., number of records) for each key
      */
-    KTable<K, V> reduce(Reducer<V> adder,
-                        Reducer<V> subtractor,
-                        String storeName);
+    KTable<K, Long> count(final String storeName);
 
     /**
-     * Combine updating values of this stream by the selected key into a new instance of {@link KTable}.
-     * The resulting {@link KTable} will be materialized in a state
-     * store provided by the {@link StateStoreSupplier}.
+     * Count number of records of the original {@link KTable} that got {@link KTable#groupBy(KeyValueMapper) mapped} to
+     * the same key into a new instance of {@link KTable}.
+     * Records with {@code null} key are ignored.
+     * The result is written into a local {@link KeyValueStore} (which is basically an ever-updating materialized view)
+     * provided by the given {@code storeSupplier}.
+     * Furthermore, updates to the store are sent downstream into a {@link KTable} changelog stream.
+     * <p>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
+     * To query the local {@link KeyValueStore} it must be obtained via
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * <pre>{@code
+     * KafkaStreams streams = ... // counting words
+     * String storeName = storeSupplier.name();
+     * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
+     * String key = "some-word";
+     * Long countForWord = localStore.get(key); // key must be local (application state is shared over all running Kafka Streams instances)
+     * }</pre>
+     * For non-local keys, a custom RPC mechanism must be implemented using {@link KafkaStreams#allMetadata()} to
+     * query the value of the key on a parallel running instance of your Kafka Streams application.
+     * <p>
+     * For failure and recovery the store will be backed by an internal changelog topic that will be created in Kafka.
+     * The changelog topic will be named "${applicationId}-${storeName}-changelog", where "applicationId" is
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
+     * provide {@code storeName}, and "-changelog" is a fixed suffix.
+     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
-     * @param adder         the instance of {@link Reducer} for addition
-     * @param subtractor    the instance of {@link Reducer} for subtraction
-     * @param storeSupplier user defined state store supplier {@link StateStoreSupplier}
-     * @return a {@link KTable} with the same key and value types as this {@link KGroupedTable},
-     *         containing aggregated values for each key
+     * @param storeSupplier user defined state store supplier
+     * @return a {@link KTable} that contains "update" records with unmodified keys and {@link Long} values that
+     * represent the latest (rolling) count (i.e., number of records) for each key
      */
-    KTable<K, V> reduce(Reducer<V> adder,
-                        Reducer<V> subtractor,
-                        final StateStoreSupplier<KeyValueStore> storeSupplier);
+    KTable<K, Long> count(final StateStoreSupplier<KeyValueStore> storeSupplier);
 
     /**
-     * Aggregate updating values of this stream by the selected key into a new instance of {@link KTable}.
-     * The resulting {@link KTable} will be materialized in a local state
-     * store with the given store name. Also a changelog topic named "${applicationId}-${storeName}-changelog"
-     * will be automatically created in Kafka for failure recovery, where "applicationID"
-     * is specified by the user in {@link org.apache.kafka.streams.StreamsConfig}.
+     * Combine the value of records of the original {@link KTable} that got {@link KTable#groupBy(KeyValueMapper)
+     * mapped} to the same key into a new instance of {@link KTable}.
+     * Records with {@code null} key are ignored.
+     * Combining implies that the type of the aggregate result is the same as the type of the input value
+     * (c.f. {@link #aggregate(Initializer, Aggregator, Aggregator, Serde, String)}).
+     * The result is written into a local {@link KeyValueStore} (which is basically an ever-updating materialized view)
+     * that can be queried using the provided {@code storeName}.
+     * Furthermore, updates to the store are sent downstream into a {@link KTable} changelog stream.
+     * <p>
+     * Each update to the original {@link KTable} results in a two step update of the result {@link KTable}.
+     * The specified {@link Reducer adder} is applied for each update record and computes a new aggregate using the
+     * current aggregate and the record's value by adding the new record to the aggregate.
+     * The specified {@link Reducer substractor} is applied for each "replaced" record of the original {@link KTable}
+     * and computes a new aggregate using the current aggregate and the record's value by "removing" the "replaced"
+     * record from the aggregate.
+     * If there is no current aggregate the {@link Reducer} is not applied and the new aggregate will be the record's
+     * value as-is.
+     * Thus, {@code reduce(Reducer, Reducer, String)} can be used to compute aggregate functions like sum.
+     * For sum, the adder and substractor would work as follows:
+     * <pre>{@code
+     * public class SumAdder implements Reducer<Integer> {
+     *   public Integer apply(Integer currentAgg, Integer newValue) {
+     *     return currentAgg + newValue;
+     *   }
+     * }
      *
-     * @param initializer   the instance of {@link Initializer}
-     * @param adder         the instance of {@link Aggregator} for addition
-     * @param subtractor    the instance of {@link Aggregator} for subtraction
-     * @param aggValueSerde value serdes for materializing the aggregated table,
-     *                      if not specified the default serdes defined in the configs will be used
-     * @param storeName     the name of the underlying {@link KTable} state store
-     * @param <T>           the value type of the aggregated {@link KTable}
-     * @return a {@link KTable} with same key and aggregated value type {@code T},
-     *         containing aggregated values for each key
+     * public class SumSubtractor implements Reducer<Integer> {
+     *   public Integer apply(Integer currentAgg, Integer oldValue) {
+     *     return currentAgg - oldValue;
+     *   }
+     * }
+     * }</pre>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
+     * To query the local {@link KeyValueStore} it must be obtained via
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * <pre>{@code
+     * KafkaStreams streams = ... // counting words
+     * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
+     * String key = "some-word";
+     * Long countForWord = localStore.get(key); // key must be local (application state is shared over all running Kafka Streams instances)
+     * }</pre>
+     * For non-local keys, a custom RPC mechanism must be implemented using {@link KafkaStreams#allMetadata()} to
+     * query the value of the key on a parallel running instance of your Kafka Streams application.
+     * <p>
+     * For failure and recovery the store will be backed by an internal changelog topic that will be created in Kafka.
+     * The changelog topic will be named "${applicationId}-${storeName}-changelog", where "applicationId" is
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
+     * provide {@code storeName}, and "-changelog" is a fixed suffix.
+     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
+     *
+     * @param adder      a {@link Reducer} that adds a new value to the aggregate result
+     * @param subtractor a {@link Reducer} that removed an old value from the aggregate result
+     * @param storeName  the name of the underlying {@link KTable} state store
+     * @return a {@link KTable} that contains "update" records with unmodified keys, and values that represent the
+     * latest (rolling) aggregate for each key
      */
-    <T> KTable<K, T> aggregate(Initializer<T> initializer,
-                               Aggregator<? super K, ? super V, T> adder,
-                               Aggregator<? super K, ? super V, T> subtractor,
-                               Serde<T> aggValueSerde,
-                               String storeName);
+    KTable<K, V> reduce(final Reducer<V> adder,
+                        final Reducer<V> subtractor,
+                        final String storeName);
 
     /**
-     * Aggregate updating values of this stream by the selected key into a new instance of {@link KTable}
-     * using default serializers and deserializers.
-     * The resulting {@link KTable} will be materialized in a local state
-     * store with the given store name. Also a changelog topic named "${applicationId}-${storeName}-changelog"
-     * will be automatically created in Kafka for failure recovery, where "applicationID"
-     * is specified by the user in {@link org.apache.kafka.streams.StreamsConfig}.
+     * Combine the value of records of the original {@link KTable} that got {@link KTable#groupBy(KeyValueMapper)
+     * mapped} to the same key into a new instance of {@link KTable}.
+     * Records with {@code null} key are ignored.
+     * Combining implies that the type of the aggregate result is the same as the type of the input value
+     * (c.f. {@link #aggregate(Initializer, Aggregator, Aggregator, Serde, String)}).
+     * The result is written into a local {@link KeyValueStore} (which is basically an ever-updating materialized view)
+     * provided by the given {@code storeSupplier}.
+     * Furthermore, updates to the store are sent downstream into a {@link KTable} changelog stream.
+     * <p>
+     * Each update to the original {@link KTable} results in a two step update of the result {@link KTable}.
+     * The specified {@link Reducer adder} is applied for each update record and computes a new aggregate using the
+     * current aggregate and the record's value by adding the new record to the aggregate.
+     * The specified {@link Reducer substractor} is applied for each "replaced" record of the original {@link KTable}
+     * and computes a new aggregate using the current aggregate and the record's value by "removing" the "replaced"
+     * record from the aggregate.
+     * If there is no current aggregate the {@link Reducer} is not applied and the new aggregate will be the record's
+     * value as-is.
+     * Thus, {@code reduce(Reducer, Reducer, String)} can be used to compute aggregate functions like sum.
+     * For sum, the adder and substractor would work as follows:
+     * <pre>{@code
+     * public class SumAdder implements Reducer<Integer> {
+     *   public Integer apply(Integer currentAgg, Integer newValue) {
+     *     return currentAgg + newValue;
+     *   }
+     * }
      *
-     * @param initializer   the instance of {@link Initializer}
-     * @param adder         the instance of {@link Aggregator} for addition
-     * @param subtractor   the instance of {@link Aggregator} for subtraction
-     * @param storeName     the name of the underlying {@link KTable} state store
-     * @param <T>           the value type of the aggregated {@link KTable}
-     * @return a {@link KTable} with same key and aggregated value type {@code T},
-     *         containing aggregated values for each key
+     * public class SumSubtractor implements Reducer<Integer> {
+     *   public Integer apply(Integer currentAgg, Integer oldValue) {
+     *     return currentAgg - oldValue;
+     *   }
+     * }
+     * }</pre>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
+     * To query the local {@link KeyValueStore} it must be obtained via
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * <pre>{@code
+     * KafkaStreams streams = ... // counting words
+     * String storeName = storeSupplier.name();
+     * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
+     * String key = "some-word";
+     * Long countForWord = localStore.get(key); // key must be local (application state is shared over all running Kafka Streams instances)
+     * }</pre>
+     * For non-local keys, a custom RPC mechanism must be implemented using {@link KafkaStreams#allMetadata()} to
+     * query the value of the key on a parallel running instance of your Kafka Streams application.
+     * <p>
+     * For failure and recovery the store will be backed by an internal changelog topic that will be created in Kafka.
+     * The changelog topic will be named "${applicationId}-${storeName}-changelog", where "applicationId" is
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
+     * provide {@code storeName}, and "-changelog" is a fixed suffix.
+     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
+     *
+     * @param adder         a {@link Reducer} that adds a new value to the aggregate result
+     * @param subtractor    a {@link Reducer} that removed an old value from the aggregate result
+     * @param storeSupplier user defined state store supplier
+     * @return a {@link KTable} that contains "update" records with unmodified keys, and values that represent the
+     * latest (rolling) aggregate for each key
      */
-    <T> KTable<K, T> aggregate(Initializer<T> initializer,
-                               Aggregator<? super K, ? super V, T> adder,
-                               Aggregator<? super K, ? super V, T> subtractor,
-                               String storeName);
+    KTable<K, V> reduce(final Reducer<V> adder,
+                        final Reducer<V> subtractor,
+                        final StateStoreSupplier<KeyValueStore> storeSupplier);
 
     /**
-     * Aggregate updating values of this stream by the selected key into a new instance of {@link KTable}
-     * using default serializers and deserializers.
-     * The resulting {@link KTable} will be materialized in a state
-     * store provided by the {@link StateStoreSupplier}.
+     * Aggregate the value of records of the original {@link KTable} that got {@link KTable#groupBy(KeyValueMapper)
+     * mapped} to the same key into a new instance of {@link KTable} using default serializers and deserializers.
+     * Records with {@code null} key are ignored.
+     * Aggregating is a generalization of {@link #reduce(Reducer, Reducer, String) combining via reduce(...)} as it,
+     * for example, allows the result to have a different type than the input values.
+     * If the result value type does not match the {@link StreamsConfig#VALUE_SERDE_CLASS_CONFIG default value
+     * serde} you should use {@link KGroupedTable#aggregate(Initializer, Aggregator, Aggregator, Serde, String)
+     * aggregate(Initializer, Aggregator, Aggregator, Serde, String)}.
+     * The result is written into a local {@link KeyValueStore} (which is basically an ever-updating materialized view)
+     * provided by the given {@code storeSupplier}.
+     * Furthermore, updates to the store are sent downstream into a {@link KTable} changelog stream.
+     * <p>
+     * The specified {@link Initializer} is applied once directly before the first input record is processed to
+     * provide an initial intermediate aggregation result that is used to process the first record.
+     * Each update to the original {@link KTable} results in a two step update of the result {@link KTable}.
+     * The specified {@link Aggregator adder} is applied for each update record and computes a new aggregate using the
+     * current aggregate (or for the very first record using the intermediate aggregation result provided via the
+     * {@link Initializer}) and the record's value by adding the new record to the aggregate.
+     * The specified {@link Aggregator substractor} is applied for each "replaced" record of the original {@link KTable}
+     * and computes a new aggregate using the current aggregate and the record's value by "removing" the "replaced"
+     * record from the aggregate.
+     * Thus, {@code aggregate(Initializer, Aggregator, Aggregator, String)} can be used to compute aggregate functions
+     * like sum.
+     * For sum, the initializer, adder, and substractor would work as follows:
+     * <pre>{@code
+     * // in this example, LongSerde.class must be set as default value serde in StreamsConfig
+     * public class SumInitializer implements Initializer<Long> {
+     *   public Long apply() {
+     *     return 0L;
+     *   }
+     * }
+     *
+     * public class SumAdder implements Aggregator<String, Integer, Long> {
+     *   public Long apply(String key, Integer newValue, Long aggregate) {
+     *     return aggregate + newValue;
+     *   }
+     * }
+     *
+     * public class SumSubstractor implements Aggregator<String, Integer, Long> {
+     *   public Long apply(String key, Integer oldValue, Long aggregate) {
+     *     return aggregate - oldValue;
+     *   }
+     * }
+     * }</pre>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
+     * To query the local {@link KeyValueStore} it must be obtained via
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * <pre>{@code
+     * KafkaStreams streams = ... // counting words
+     * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
+     * String key = "some-word";
+     * Long countForWord = localStore.get(key); // key must be local (application state is shared over all running Kafka Streams instances)
+     * }</pre>
+     * For non-local keys, a custom RPC mechanism must be implemented using {@link KafkaStreams#allMetadata()} to
+     * query the value of the key on a parallel running instance of your Kafka Streams application.
+     * <p>
+     * For failure and recovery the store will be backed by an internal changelog topic that will be created in Kafka.
+     * The changelog topic will be named "${applicationId}-${storeName}-changelog", where "applicationId" is
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
+     * provide {@code storeName}, and "-changelog" is a fixed suffix.
+     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
-     * @param initializer   the instance of {@link Initializer}
-     * @param adder         the instance of {@link Aggregator} for addition
-     * @param subtractor    the instance of {@link Aggregator} for subtraction
-     * @param storeSupplier user defined state store supplier {@link StateStoreSupplier}
-     * @param <T>           the value type of the aggregated {@link KTable}
-     * @return a {@link KTable} with same key and aggregated value type {@code T},
-     *         containing aggregated values for each key
+     * @param initializer a {@link Initializer} that provides an initial aggregate result value
+     * @param adder       a {@link Aggregator} that adds a new record to the aggregate result
+     * @param subtractor  a {@link Aggregator} that removed an old record from the aggregate result
+     * @param storeName   the name of the underlying {@link KTable} state store
+     * @param <VR>        the value type of the aggregated {@link KTable}
+     * @return a {@link KTable} that contains "update" records with unmodified keys, and values that represent the
+     * latest (rolling) aggregate for each key
      */
-    <T> KTable<K, T> aggregate(Initializer<T> initializer,
-                               Aggregator<? super K, ? super V, T> adder,
-                               Aggregator<? super K, ? super V, T> subtractor,
-                               final StateStoreSupplier<KeyValueStore> storeSupplier);
+    <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
+                                 final Aggregator<? super K, ? super V, VR> adder,
+                                 final Aggregator<? super K, ? super V, VR> subtractor,
+                                 final String storeName);
 
     /**
-     * Count number of records of this stream by the selected key into a new instance of {@link KTable}.
-     * The resulting {@link KTable} will be materialized in a local state
-     * store with the given store name. Also a changelog topic named "${applicationId}-${storeName}-changelog"
-     * will be automatically created in Kafka for failure recovery, where "applicationID"
-     * is specified by the user in {@link org.apache.kafka.streams.StreamsConfig}.
+     * Aggregate the value of records of the original {@link KTable} that got {@link KTable#groupBy(KeyValueMapper)
+     * mapped} to the same key into a new instance of {@link KTable} using default serializers and deserializers.
+     * Records with {@code null} key are ignored.
+     * Aggregating is a generalization of {@link #reduce(Reducer, Reducer, String) combining via reduce(...)} as it,
+     * for example, allows the result to have a different type than the input values.
+     * The result is written into a local {@link KeyValueStore} (which is basically an ever-updating materialized view)
+     * that can be queried using the provided {@code storeName}.
+     * Furthermore, updates to the store are sent downstream into a {@link KTable} changelog stream.
+     * <p>
+     * The specified {@link Initializer} is applied once directly before the first input record is processed to
+     * provide an initial intermediate aggregation result that is used to process the first record.
+     * Each update to the original {@link KTable} results in a two step update of the result {@link KTable}.
+     * The specified {@link Aggregator adder} is applied for each update record and computes a new aggregate using the
+     * current aggregate (or for the very first record using the intermediate aggregation result provided via the
+     * {@link Initializer}) and the record's value by adding the new record to the aggregate.
+     * The specified {@link Aggregator substractor} is applied for each "replaced" record of the original {@link KTable}
+     * and computes a new aggregate using the current aggregate and the record's value by "removing" the "replaced"
+     * record from the aggregate.
+     * Thus, {@code aggregate(Initializer, Aggregator, Aggregator, String)} can be used to compute aggregate functions
+     * like sum.
+     * For sum, the initializer, adder, and substractor would work as follows:
+     * <pre>{@code
+     * public class SumInitializer implements Initializer<Long> {
+     *   public Long apply() {
+     *     return 0L;
+     *   }
+     * }
+     *
+     * public class SumAdder implements Aggregator<String, Integer, Long> {
+     *   public Long apply(String key, Integer newValue, Long aggregate) {
+     *     return aggregate + newValue;
+     *   }
+     * }
+     *
+     * public class SumSubstractor implements Aggregator<String, Integer, Long> {
+     *   public Long apply(String key, Integer oldValue, Long aggregate) {
+     *     return aggregate - oldValue;
+     *   }
+     * }
+     * }</pre>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
+     * To query the local {@link KeyValueStore} it must be obtained via
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * <pre>{@code
+     * KafkaStreams streams = ... // counting words
+     * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
+     * String key = "some-word";
+     * Long countForWord = localStore.get(key); // key must be local (application state is shared over all running Kafka Streams instances)
+     * }</pre>
+     * For non-local keys, a custom RPC mechanism must be implemented using {@link KafkaStreams#allMetadata()} to
+     * query the value of the key on a parallel running instance of your Kafka Streams application.
+     * <p>
+     * For failure and recovery the store will be backed by an internal changelog topic that will be created in Kafka.
+     * The changelog topic will be named "${applicationId}-${storeName}-changelog", where "applicationId" is
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
+     * provide {@code storeName}, and "-changelog" is a fixed suffix.
+     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
+     * @param initializer   a {@link Initializer} that provides an initial aggregate result value
+     * @param adder         a {@link Aggregator} that adds a new record to the aggregate result
+     * @param subtractor    a {@link Aggregator} that removed an old record from the aggregate result
+     * @param aggValueSerde aggregate value serdes for materializing the aggregated table,
+     *                      if not specified the default serdes defined in the configs will be used
      * @param storeName     the name of the underlying {@link KTable} state store
-     * @return a {@link KTable} with same key and {@link Long} value type as this {@link KGroupedTable},
-     *         containing the number of values for each key
+     * @param <VR>          the value type of the aggregated {@link KTable}
+     * @return a {@link KTable} that contains "update" records with unmodified keys, and values that represent the
+     * latest (rolling) aggregate for each key
      */
-    KTable<K, Long> count(String storeName);
+    <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
+                                 final Aggregator<? super K, ? super V, VR> adder,
+                                 final Aggregator<? super K, ? super V, VR> subtractor,
+                                 final Serde<VR> aggValueSerde,
+                                 final String storeName);
 
     /**
-     * Count number of records of this stream by the selected key into a new instance of {@link KTable}.
-     * The resulting {@link KTable} will be materialized in a state
-     * store provided by the {@link StateStoreSupplier}.
+     * Aggregate the value of records of the original {@link KTable} that got {@link KTable#groupBy(KeyValueMapper)
+     * mapped} to the same key into a new instance of {@link KTable} using default serializers and deserializers.
+     * Records with {@code null} key are ignored.
+     * Aggregating is a generalization of {@link #reduce(Reducer, Reducer, String) combining via reduce(...)} as it,
+     * for example, allows the result to have a different type than the input values.
+     * The result is written into a local {@link KeyValueStore} (which is basically an ever-updating materialized view)
+     * provided by the given {@code storeSupplier}.
+     * Furthermore, updates to the store are sent downstream into a {@link KTable} changelog stream.
+     * <p>
+     * The specified {@link Initializer} is applied once directly before the first input record is processed to
+     * provide an initial intermediate aggregation result that is used to process the first record.
+     * Each update to the original {@link KTable} results in a two step update of the result {@link KTable}.
+     * The specified {@link Aggregator adder} is applied for each update record and computes a new aggregate using the
+     * current aggregate (or for the very first record using the intermediate aggregation result provided via the
+     * {@link Initializer}) and the record's value by adding the new record to the aggregate.
+     * The specified {@link Aggregator substractor} is applied for each "replaced" record of the original {@link KTable}
+     * and computes a new aggregate using the current aggregate and the record's value by "removing" the "replaced"
+     * record from the aggregate.
+     * Thus, {@code aggregate(Initializer, Aggregator, Aggregator, String)} can be used to compute aggregate functions
+     * like sum.
+     * For sum, the initializer, adder, and substractor would work as follows:
+     * <pre>{@code
+     * public class SumInitializer implements Initializer<Long> {
+     *   public Long apply() {
+     *     return 0L;
+     *   }
+     * }
+     *
+     * public class SumAdder implements Aggregator<String, Integer, Long> {
+     *   public Long apply(String key, Integer newValue, Long aggregate) {
+     *     return aggregate + newValue;
+     *   }
+     * }
      *
-     * @param storeSupplier user defined state store supplier {@link StateStoreSupplier}
-     * @return a {@link KTable} with same key and {@link Long} value type as this {@link KGroupedTable},
-     * containing the number of values for each key
+     * public class SumSubstractor implements Aggregator<String, Integer, Long> {
+     *   public Long apply(String key, Integer oldValue, Long aggregate) {
+     *     return aggregate - oldValue;
+     *   }
+     * }
+     * }</pre>
+     * Not all updates might get sent downstream, as an internal cache is used to deduplicate consecutive updates to
+     * the same key.
+     * The rate of propagated updates depends on your input data rate, the number of distinct keys, the number of
+     * parallel running Kafka Streams instances, and the {@link StreamsConfig configuration} parameters for
+     * {@link StreamsConfig#CACHE_MAX_BYTES_BUFFERING_CONFIG cache size}, and
+     * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
+     * <p>
+     * To query the local {@link KeyValueStore} it must be obtained via
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * <pre>{@code
+     * KafkaStreams streams = ... // counting words
+     * String storeName = storeSupplier.name();
+     * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
+     * String key = "some-word";
+     * Long countForWord = localStore.get(key); // key must be local (application state is shared over all running Kafka Streams instances)
+     * }</pre>
+     * For non-local keys, a custom RPC mechanism must be implemented using {@link KafkaStreams#allMetadata()} to
+     * query the value of the key on a parallel running instance of your Kafka Streams application.
+     * <p>
+     * For failure and recovery the store will be backed by an internal changelog topic that will be created in Kafka.
+     * The changelog topic will be named "${applicationId}-${storeName}-changelog", where "applicationId" is
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "storeName" is the
+     * provide {@code storeName}, and "-changelog" is a fixed suffix.
+     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
+     *
+     * @param initializer   a {@link Initializer} that provides an initial aggregate result value
+     * @param adder         a {@link Aggregator} that adds a new record to the aggregate result
+     * @param subtractor    a {@link Aggregator} that removed an old record from the aggregate result
+     * @param storeSupplier user defined state store supplier
+     * @param <VR>          the value type of the aggregated {@link KTable}
+     * @return a {@link KTable} that contains "update" records with unmodified keys, and values that represent the
+     * latest (rolling) aggregate for each key
      */
-    KTable<K, Long> count(final StateStoreSupplier<KeyValueStore> storeSupplier);
+    <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
+                                 final Aggregator<? super K, ? super V, VR> adder,
+                                 final Aggregator<? super K, ? super V, VR> subtractor,
+                                 final StateStoreSupplier<KeyValueStore> storeSupplier);
 
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
index 2b8e040326e81..15eb05820c96d 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
@@ -31,14 +31,14 @@
 import org.apache.kafka.streams.processor.TopologyBuilder;
 
 /**
- * {@link KStream} is an abstraction of a <i>record stream</i> of key-value pairs, i.e., each record is an independent
- * entity/event in the real world.
+ * {@link KStream} is an abstraction of a <i>record stream</i> of {@link KeyValue} pairs, i.e., each record is an
+ * independent entity/event in the real world.
  * For example a user X might buy two items I1 and I2, and thus there might be two records {@code <K:I1>, <K:I2>}
  * in the stream.
  * <p>
- * A {@link KStream} is either defined from one or multiple Kafka topics that are consumed message by message or the
- * result of a {@link KStream} transformation.
- * A {@link KTable} can also be converted into a {@link KStream}.
+ * A {@link KStream} is either {@link KStreamBuilder#stream(String...) defined from one or multiple Kafka topics} that
+ * are consumed message by message or the result of a {@link KStream} transformation.
+ * A {@link KTable} can also be {@link KTable#toStream() converted} into a {@link KStream}.
  * <p>
  * A {@link KStream} can be transformed record by record, joined with another {@link KStream}, {@link KTable},
  * {@link GlobalKTable}, or can be aggregated into a {@link KTable}.
@@ -51,6 +51,7 @@
  * @param <V> Type of values
  * @see KTable
  * @see KGroupedStream
+ * @see KStreamBuilder#stream(String...)
  */
 @SuppressWarnings("unused")
 @InterfaceStability.Unstable
@@ -265,8 +266,8 @@ public interface KStream<K, V> {
 
     /**
      * Print the records of this stream to {@code System.out}.
-     * This function will use the generated name of the parent processor node to label the key/value pairs printed out
-     * to the console.
+     * This function will use the generated name of the parent processor node to label the key/value pairs printed to
+     * the console.
      * <p>
      * The default serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
      * {@code toString()} on the deserialized object.
@@ -278,7 +279,7 @@ public interface KStream<K, V> {
 
     /**
      * Print the records of this stream to {@code System.out}.
-     * This function will use the given name to label the key/value pairs printed out to the console.
+     * This function will use the given name to label the key/value pairs printed to the console.
      * <p>
      * The default serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
      * {@code toString()} on the deserialized object.
@@ -286,14 +287,14 @@ public interface KStream<K, V> {
      * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
      * {@link Integer} etc. to get meaningful information.
      *
-     * @param streamName the name used to label the key/value pairs printed out to the console
+     * @param streamName the name used to label the key/value pairs printed to the console
      */
     void print(final String streamName);
 
     /**
      * Print the records of this stream to {@code System.out}.
-     * This function will use the generated name of the parent processor node to label the key/value pairs printed out
-     * to the console.
+     * This function will use the generated name of the parent processor node to label the key/value pairs printed to
+     * the console.
      * <p>
      * The provided serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
      * {@code toString()} on the deserialized object.
@@ -318,7 +319,7 @@ void print(final Serde<K> keySerde,
      *
      * @param keySerde   key serde used to deserialize key if type is {@code byte[]},
      * @param valSerde   value serde used to deserialize value if type is {@code byte[]},
-     * @param streamName the name used to label the key/value pairs printed out to the console
+     * @param streamName the name used to label the key/value pairs printed to the console
      */
     void print(final Serde<K> keySerde,
                final Serde<V> valSerde,
@@ -326,8 +327,8 @@ void print(final Serde<K> keySerde,
 
     /**
      * Write the records of this stream to a file at the given path.
-     * This function will use the generated name of the parent processor node to label the key/value pairs printed out
-     * to the file.
+     * This function will use the generated name of the parent processor node to label the key/value pairs printed to
+     * the file.
      * <p>
      * The default serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
      * {@code toString()} on the deserialized object.
@@ -341,7 +342,7 @@ void print(final Serde<K> keySerde,
 
     /**
      * Write the records of this stream to a file at the given path.
-     * This function will use the given name to label the key/value printed out to the file.
+     * This function will use the given name to label the key/value printed to the file.
      * <p>
      * The default serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
      * {@code toString()} on the deserialized object.
@@ -357,8 +358,8 @@ void writeAsText(final String filePath,
 
     /**
      * Write the records of this stream to a file at the given path.
-     * This function will use the generated name of the parent processor node to label the key/value pairs printed out
-     * to the file.
+     * This function will use the generated name of the parent processor node to label the key/value pairs printed to
+     * the file.
      * <p>
      * The provided serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
      * {@code toString()} on the deserialized object.
@@ -376,7 +377,7 @@ void writeAsText(final String filePath,
 
     /**
      * Write the records of this stream to a file at the given path.
-     * This function will use the given name to label the key/value printed out to the file.
+     * This function will use the given name to label the key/value printed to the file.
      * <p>
      * The provided serde will be used to deserialize the key or value in case the type is {@code byte[]}
      * before calling {@code toString()} on the deserialized object.
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java
index d95af0e8aa82f..bfb470a2d71b9 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java
@@ -17,378 +17,832 @@
 
 package org.apache.kafka.streams.kstream;
 
+import org.apache.kafka.clients.producer.internals.DefaultPartitioner;
 import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.common.serialization.Serde;
+import org.apache.kafka.streams.KafkaStreams;
 import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.StreamsConfig;
+import org.apache.kafka.streams.kstream.internals.WindowedSerializer;
+import org.apache.kafka.streams.kstream.internals.WindowedStreamPartitioner;
 import org.apache.kafka.streams.processor.StreamPartitioner;
-import org.apache.kafka.clients.producer.internals.DefaultPartitioner;
+import org.apache.kafka.streams.state.ReadOnlyKeyValueStore;
 
 /**
  * {@link KTable} is an abstraction of a <i>changelog stream</i> from a primary-keyed table.
- * Each record in this stream is an update on the primary-keyed table with the record key as the primary key.
+ * Each record in this changelog stream is an update on the primary-keyed table with the record key as the primary key.
  * <p>
- * A {@link KTable} is either defined from one or multiple Kafka topics that are consumed message by message or
- * the result of a {@link KTable} transformation. An aggregation of a {@link KStream} also yields a {@link KTable}.
+ * A {@link KTable} is either {@link KStreamBuilder#table(String, String) defined from a single Kafka topic} that is
+ * consumed message by message or the result of a {@link KTable} transformation.
+ * An aggregation of a {@link KStream} also yields a {@link KTable}.
  * <p>
  * A {@link KTable} can be transformed record by record, joined with another {@link KTable} or {@link KStream}, or
  * can be re-partitioned and aggregated into a new {@link KTable}.
+ * <p>
+ * Some {@link KTable}s have an internal state (a {@link ReadOnlyKeyValueStore}) and are therefore queryable via the
+ * interactive queries API.
+ * For example:
+ * <pre>{@code
+ *     final KTable table = ...
+ *     ...
+ *     final KafkaStreams streams = ...;
+ *     streams.start()
+ *     ...
+ *     final String queryableStoreName = table.getStoreName(); // returns null if KTable is not queryable
+ *     ReadOnlyKeyValueStore view = streams.store(queryableStoreName, QueryableStoreTypes.keyValueStore());
+ *     view.get(key);
+ *}</pre>
  *
  * @param <K> Type of primary keys
  * @param <V> Type of value changes
- *
  * @see KStream
+ * @see KGroupedTable
+ * @see GlobalKTable
+ * @see KStreamBuilder#table(String, String)
  */
 @InterfaceStability.Unstable
 public interface KTable<K, V> {
 
     /**
-     * Create a new instance of {@link KTable} that consists of all elements of this stream which satisfy a predicate.
-     *
-     * @param predicate     the instance of {@link Predicate}
-     *
+     * Create a new {@link KTable} that consists of all records of this {@link KTable} which satisfy the given
+     * predicate.
+     * All records that do not satisfy the predicate are dropped.
+     * For each {@link KTable} update the filter is evaluated on the update record to produce an update record for the
+     * result {@link KTable}.
+     * This is a stateless record-by-record operation.
+     * <p>
+     * Note that {@code filter} for a <i>changelog stream</i> works different to {@link KStream#filter(Predicate)
+     * record stream filters}, because {@link KeyValue records} with {@code null} values (so-called tombstone records)
+     * have delete semantics.
+     * Thus, for tombstones the provided filter predicate is not evaluated but the tombstone record is forwarded
+     * directly if required (i.e., if there is anything to be deleted).
+     * Furthermore, for each record that gets dropped (i.e., dot not satisfied the given predicate) a tombstone record
+     * is forwarded.
+     *
+     * @param predicate a filter {@link Predicate} that is applied to each record
      * @return a {@link KTable} that contains only those records that satisfy the given predicate
+     * @see #filterNot(Predicate)
      */
-    KTable<K, V> filter(Predicate<? super K, ? super V> predicate);
+    KTable<K, V> filter(final Predicate<? super K, ? super V> predicate);
 
     /**
-     * Create a new instance of {@link KTable} that consists all elements of this stream which do not satisfy a predicate.
-     *
-     * @param predicate     the instance of {@link Predicate}
-     *
-     * @return a {@link KTable} that contains only those records that do not satisfy the given predicate
+     * Create a new {@link KTable} that consists all records of this {@link KTable} which do <em>not</em> satisfy the
+     * given predicate.
+     * All records that <em>do</em> satisfy the predicate are dropped.
+     * For each {@link KTable} update the filter is evaluated on the update record to produce an update record for the
+     * result {@link KTable}.
+     * This is a stateless record-by-record operation.
+     * <p>
+     * Note that {@code filterNot} for a <i>changelog stream</i> works different to {@link KStream#filterNot(Predicate)
+     * record stream filters}, because {@link KeyValue records} with {@code null} values (so-called tombstone records)
+     * have delete semantics.
+     * Thus, for tombstones the provided filter predicate is not evaluated but the tombstone record is forwarded
+     * directly if required (i.e., if there is anything to be deleted).
+     * Furthermore, for each record that gets dropped (i.e., does satisfy the given predicate) a tombstone record is
+     * forwarded.
+     *
+     * @param predicate a filter {@link Predicate} that is applied to each record
+     * @return a {@link KTable} that contains only those records that do <em>not</em> satisfy the given predicate
+     * @see #filter(Predicate)
      */
-    KTable<K, V> filterNot(Predicate<? super K, ? super V> predicate);
+    KTable<K, V> filterNot(final Predicate<? super K, ? super V> predicate);
 
     /**
-     * Create a new instance of {@link KTable} by transforming the value of each element in this stream into a new value in the new stream.
-     *
-     * @param mapper        the instance of {@link ValueMapper}
-     * @param <V1>          the value type of the new stream
-     *
-     * @return a {@link KTable} that contains records with unmodified keys and new values of different type
+     * Create a new {@link KTable} by transforming the value of each record in this {@link KTable} into a new value
+     * (with possible new type)in the new {@link KTable}.
+     * For each {@link KTable} update the provided {@link ValueMapper} is applied to the value of the update record and
+     * computes a new value for it, resulting in an update record for the result {@link KTable}.
+     * Thus, an input record {@code <K,V>} can be transformed into an output record {@code <K:V'>}.
+     * This is a stateless record-by-record operation.
+     * <p>
+     * The example below counts the number of token of the value string.
+     * <pre>{@code
+     * KTable<String, String> inputTable = builder.table("topic");
+     * KTable<String, Integer> outputTable = inputTable.mapValue(new ValueMapper<String, Integer> {
+     *     Integer apply(String value) {
+     *         return value.split(" ").length;
+     *     }
+     * });
+     * }</pre>
+     * <p>
+     * This operation preserves data co-location with respect to the key.
+     * Thus, <em>no</em> internal data redistribution is required if a key based operator (like a join) is applied to
+     * the result {@link KTable}.
+     * <p>
+     * Note that {@code mapValues} for a <i>changelog stream</i> works different to {@link KStream#mapValues(ValueMapper)
+     * record stream filters}, because {@link KeyValue records} with {@code null} values (so-called tombstone records)
+     * have delete semantics.
+     * Thus, for tombstones the provided value-mapper is not evaluated but the tombstone record is forwarded directly to
+     * delete the corresponding record in the result {@link KTable}.
+     *
+     * @param mapper a {@link ValueMapper} that computes a new output value
+     * @param <VR>   the value type of the result {@link KTable}
+     * @return a {@link KTable} that contains records with unmodified keys and new values (possibly of different type)
      */
-    <V1> KTable<K, V1> mapValues(ValueMapper<? super V, ? extends V1> mapper);
+    <VR> KTable<K, VR> mapValues(final ValueMapper<? super V, ? extends VR> mapper);
 
 
     /**
-     * Print the elements of this stream to {@code System.out}. This function
-     * will use the generated name of the parent processor node to label the key/value pairs
-     * printed out to the console.
-     *
-     * Implementors will need to override toString for keys and values that are not of
-     * type String, Integer etc to get meaningful information.
+     * Print the update records of this {@link KTable} to {@code System.out}.
+     * This function will use the generated name of the parent processor node to label the key/value pairs printed to
+     * the console.
+     * <p>
+     * The provided serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
+     * {@code toString()} on the deserialized object.
+     * <p>
+     * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
+     * {@link Integer} etc. to get meaningful information.
+     * <p>
+     * Note that {@code print()} is not applied to the internal state store and only called for each new {@link KTable}
+     * update record.
      */
     void print();
 
     /**
-     * Print the elements of this stream to {@code System.out}.  This function
-     * will use the given name to label the key/value printed out to the console.
-     *
-     * @param streamName the name used to label the key/value pairs printed out to the console
-     *
-     * Implementors will need to override toString for keys and values that are not of
-     * type String, Integer etc to get meaningful information.
+     * Print the update records of this {@link KTable} to {@code System.out}.
+     * This function will use the given name to label the key/value pairs printed to the console.
+     * <p>
+     * The provided serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
+     * {@code toString()} on the deserialized object.
+     * <p>
+     * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
+     * {@link Integer} etc. to get meaningful information.
+     * <p>
+     * Note that {@code print()} is not applied to the internal state store and only called for each new {@link KTable}
+     * update record.
+     *
+     * @param streamName the name used to label the key/value pairs printed to the console
      */
-    void print(String streamName);
+    void print(final String streamName);
 
     /**
-     * Print the elements of this stream to {@code System.out}
-     * @param keySerde key serde used to send key-value pairs,
-     *                 if not specified the default serde defined in the configs will be used
-     * @param valSerde value serde used to send key-value pairs,
-     *                 if not specified the default serde defined in the configs will be used
-     *
-     * Implementors will need to override toString for keys and values that are not of
-     * type String, Integer etc to get meaningful information.
+     * Print the update records of this {@link KTable} to {@code System.out}.
+     * This function will use the generated name of the parent processor node to label the key/value pairs printed to
+     * the console.
+     * <p>
+     * The provided serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
+     * {@code toString()} on the deserialized object.
+     * <p>
+     * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
+     * {@link Integer} etc. to get meaningful information.
+     * <p>
+     * Note that {@code print()} is not applied to the internal state store and only called for each new {@link KTable}
+     * update record.
+     *
+     * @param keySerde key serde used to deserialize key if type is {@code byte[]},
+     * @param valSerde value serde used to deserialize value if type is {@code byte[]},
      */
-    void print(Serde<K> keySerde, Serde<V> valSerde);
+    void print(final Serde<K> keySerde,
+               final Serde<V> valSerde);
 
     /**
-     * Print the elements of this stream to System.out
-     *
-     * @param keySerde key serde used to send key-value pairs,
-     *                 if not specified the default serde defined in the configs will be used
-     * @param valSerde value serde used to send key-value pairs,
-     *                 if not specified the default serde defined in the configs will be used
-     * @param streamName the name used to label the key/value pairs printed out to the console
-     *
-     * Implementors will need to override toString for keys and values that are not of
-     * type String, Integer etc to get meaningful information.
+     * Print the update records of this {@link KTable} to {@code System.out}.
+     * This function will use the given name to label the key/value pairs printed to the console.
+     * <p>
+     * The provided serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
+     * {@code toString()} on the deserialized object.
+     * <p>
+     * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
+     * {@link Integer} etc. to get meaningful information.
+     * <p>
+     * Note that {@code print()} is not applied to the internal state store and only called for each new {@link KTable}
+     * update record.
+     *
+     * @param keySerde   key serde used to deserialize key if type is {@code byte[]},
+     * @param valSerde   value serde used to deserialize value if type is {@code byte[]},
+     * @param streamName the name used to label the key/value pairs printed to the console
      */
-    void print(Serde<K> keySerde, Serde<V> valSerde, String streamName);
+    void print(final Serde<K> keySerde,
+               final Serde<V> valSerde,
+               final String streamName);
 
     /**
-     * Write the elements of this stream to a file at the given path using default serializers and deserializers.
-     * @param filePath name of file to write to
+     * Write the update records of this {@link KTable} to a file at the given path.
+     * This function will use the generated name of the parent processor node to label the key/value pairs printed to
+     * the file.
+     * <p>
+     * The default serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
+     * {@code toString()} on the deserialized object.
+     * <p>
+     * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
+     * {@link Integer} etc. to get meaningful information.
+     * <p>
+     * Note that {@code writeAsText()} is not applied to the internal state store and only called for each new
+     * {@link KTable} update record.
      *
-     * Implementors will need to override {@code toString} for keys and values that are not of
-     * type {@link String}, {@link Integer} etc. to get meaningful information.
+     * @param filePath name of file to write to
      */
-    void writeAsText(String filePath);
+    void writeAsText(final String filePath);
 
     /**
-     * Write the elements of this stream to a file at the given path.
-     *
-     * @param filePath name of file to write to
+     * Write the update records of this {@link KTable} to a file at the given path.
+     * This function will use the given name to label the key/value printed to the file.
+     * <p>
+     * The default serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
+     * {@code toString()} on the deserialized object.
+     * <p>
+     * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
+     * {@link Integer} etc. to get meaningful information.
+     * <p>
+     * Note that {@code writeAsText()} is not applied to the internal state store and only called for each new
+     * {@link KTable} update record.
+     *
+     * @param filePath   name of file to write to
      * @param streamName the name used to label the key/value pairs printed out to the console
-     *
-     * Implementors will need to override {@code toString} for keys and values that are not of
-     * type {@link String}, {@link Integer} etc. to get meaningful information.
      */
-    void writeAsText(String filePath, String streamName);
+    void writeAsText(final String filePath,
+                     final String streamName);
 
     /**
-     * Write the elements of this stream to a file at the given path.
+     * Write the update records of this {@link KTable} to a file at the given path.
+     * This function will use the generated name of the parent processor node to label the key/value pairs printed to
+     * the file.
+     * <p>
+     * The provided serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
+     * {@code toString()} on the deserialized object.
+     * <p>
+     * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
+     * {@link Integer} etc. to get meaningful information.
+     * <p>
+     * Note that {@code writeAsText()} is not applied to the internal state store and only called for each new
+     * {@link KTable} update record.
      *
      * @param filePath name of file to write to
-     * @param keySerde key serde used to send key-value pairs,
-     *                 if not specified the default serde defined in the configs will be used
-     * @param valSerde value serde used to send key-value pairs,
-     *                 if not specified the default serde defined in the configs will be used
-     *
-     * Implementors will need to override {@code toString} for keys and values that are not of
-     * type {@link String}, {@link Integer} etc. to get meaningful information.
+     * @param keySerde key serde used to deserialize key if type is {@code byte[]},
+     * @param valSerde value serde used to deserialize value if type is {@code byte[]},
      */
-    void  writeAsText(String filePath, Serde<K> keySerde, Serde<V> valSerde);
+    void  writeAsText(final String filePath,
+                      final Serde<K> keySerde,
+                      final Serde<V> valSerde);
 
     /**
-     * @param filePath name of file to write to
-     * @param streamName the name used to label the key/value pairs printed out to the console
-     * @param keySerde key serde used to send key-value pairs,
-     *                 if not specified the default serde defined in the configs will be used
-     * @param valSerde value serde used to send key-value pairs,
-     *                 if not specified the default serde defined in the configs will be used
+     * Write the update records of this {@link KTable} to a file at the given path.
+     * This function will use the given name to label the key/value printed to the file.
+     * <p>
+     * The default serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
+     * {@code toString()} on the deserialized object.
+     * <p>
+     * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
+     * {@link Integer} etc. to get meaningful information.
+     * <p>
+     * Note that {@code writeAsText()} is not applied to the internal state store and only called for each new
+     * {@link KTable} update record.
      *
-     * Implementors will need to override {@code toString} for keys and values that are not of
-     * type {@link String}, {@link Integer} etc. to get meaningful information.
+     * @param filePath name of file to write to
+     * @param streamName the name used to label the key/value pairs printed to the console
+     * @param keySerde key serde used to deserialize key if type is {@code byte[]},
+     * @param valSerde value serde used to deserialize value if type is {@code byte[]},
      */
-
-    void writeAsText(String filePath, String streamName, Serde<K> keySerde, Serde<V> valSerde);
+    void writeAsText(final String filePath,
+                     final String streamName,
+                     final Serde<K> keySerde,
+                     final Serde<V> valSerde);
 
     /**
-     * Materialize this stream to a topic, also creates a new instance of {@link KTable} from the topic
-     * using default serializers and deserializers and producer's {@link DefaultPartitioner}.
-     * This is equivalent to calling {@link #to(String)} and {@link org.apache.kafka.streams.kstream.KStreamBuilder#table(String, String)}.
-     * The resulting {@link KTable} will be materialized in a local state
-     * store with the given store name. Also a changelog topic named "${applicationId}-${storeName}-changelog"
-     * will be automatically created in Kafka for failure recovery, where "applicationID"
-     * is specified by the user in {@link org.apache.kafka.streams.StreamsConfig}.
+     * Perform an action on each update record of this {@link KTable}.
+     * Note that this is a terminal operation that returns void.
+     * <p>
+     * Note that {@code foreach()} is not applied to the internal state store and only called for each new
+     * {@link KTable} update record.
      *
-     * @param topic         the topic name
-     * @param storeName     the state store name used for this KTable
-     * @return a new {@link KTable} that contains the exact same records as this {@link KTable}
+     * @param action an action to perform on each record
      */
-    KTable<K, V> through(String topic, String storeName);
+    void foreach(final ForeachAction<? super K, ? super V> action);
 
     /**
-     * Materialize this stream to a topic, also creates a new instance of {@link KTable} from the topic using default serializers
-     * and deserializers and a customizable {@link StreamPartitioner} to determine the distribution of records to partitions.
-     * This is equivalent to calling {@link #to(String)} and {@link org.apache.kafka.streams.kstream.KStreamBuilder#table(String, String)}.
-     * The resulting {@link KTable} will be materialized in a local state
-     * store with the given store name. Also a changelog topic named "${applicationId}-${storeName}-changelog"
-     * will be automatically created in Kafka for failure recovery, where "applicationID"
-     * is specified by the user in {@link org.apache.kafka.streams.StreamsConfig}.
+     * Convert this changelog stream to a {@link KStream}.
+     * <p>
+     * Note that this is a logical operation and only changes the "interpretation" of the stream, i.e., each record of
+     * this changelog stream is no longer treated as an update record (cf. {@link KStream} vs {@link KTable}).
      *
-     * @param partitioner  the function used to determine how records are distributed among partitions of the topic,
-     *                     if not specified producer's {@link DefaultPartitioner} will be used
-     * @param topic        the topic name
-     * @param storeName    the state store name used for this KTable
-     * @return a new {@link KTable} that contains the exact same records as this {@link KTable}
+     * @return a {@link KStream} that contains the same records as this {@link KTable}
      */
-    KTable<K, V> through(StreamPartitioner<? super K, ? super V> partitioner, String topic, String storeName);
+    KStream<K, V> toStream();
 
     /**
-     * Materialize this stream to a topic, also creates a new instance of {@link KTable} from the topic.
-     * If {@code keySerde} provides a {@link org.apache.kafka.streams.kstream.internals.WindowedSerializer}
-     * for the key {@link org.apache.kafka.streams.kstream.internals.WindowedStreamPartitioner} is used
-     * &mdash; otherwise producer's {@link DefaultPartitioner} is used.
-     * This is equivalent to calling {@link #to(Serde, Serde, String)} and
-     * {@link org.apache.kafka.streams.kstream.KStreamBuilder#table(Serde, Serde, String, String)}.
-     * The resulting {@link KTable} will be materialized in a local state
-     * store with the given store name. Also a changelog topic named "${applicationId}-${storeName}-changelog"
-     * will be automatically created in Kafka for failure recovery, where "applicationID"
-     * is specified by the user in {@link org.apache.kafka.streams.StreamsConfig}.
-     *
-     * @param keySerde     key serde used to send key-value pairs,
-     *                     if not specified the default key serde defined in the configuration will be used
-     * @param valSerde     value serde used to send key-value pairs,
-     *                     if not specified the default value serde defined in the configuration will be used
-     * @param topic        the topic name
-     * @param storeName    the state store name used for this KTable
-     * @return a new {@link KTable} that contains the exact same records as this {@link KTable}
+     * Convert this changelog stream to a {@link KStream} using the given {@link KeyValueMapper} to select the new key.
+     * <p>
+     * For example, you can compute the new key as the length of the value string.
+     * <pre>{@code
+     * KTable<String, String> table = builder.table("topic");
+     * KTable<Integer, String> keyedStream = table.toStream(new KeyValueMapper<String, String, Integer> {
+     *     Integer apply(String key, String value) {
+     *         return value.length();
+     *     }
+     * });
+     * }</pre>
+     * Setting a new key might result in an internal data redistribution if a key based operator (like an aggregation or
+     * join) is applied to the result {@link KStream}.
+     * <p>
+     * This operation is equivalent to calling
+     * {@code table.}{@link #toStream() toStream}{@code ().}{@link KStream#selectKey(KeyValueMapper) selectKey(KeyValueMapper)}.
+     * <p>
+     * Note that {@link #toStream()} is a logical operation and only changes the "interpretation" of the stream, i.e.,
+     * each record of this changelog stream is no longer treated as an update record (cf. {@link KStream} vs {@link KTable}).
+     *
+     * @param mapper a {@link KeyValueMapper} that computes a new key for each record
+     * @param <KR> the new key type of the result stream
+     * @return a {@link KStream} that contains the same records as this {@link KTable}
      */
-    KTable<K, V> through(Serde<K> keySerde, Serde<V> valSerde, String topic, String storeName);
+    <KR> KStream<KR, V> toStream(final KeyValueMapper<? super K, ? super V, ? extends KR> mapper);
 
     /**
-     * Materialize this stream to a topic, also creates a new instance of {@link KTable} from the topic
-     * using a customizable {@link StreamPartitioner} to determine the distribution of records to partitions.
-     * This is equivalent to calling {@link #to(Serde, Serde, StreamPartitioner, String)} and
-     * {@link org.apache.kafka.streams.kstream.KStreamBuilder#table(Serde, Serde, String, String)}.
-     * The resulting {@link KTable} will be materialized in a local state
-     * store with the given store name. Also a changelog topic named "${applicationId}-${storeName}-changelog"
-     * will be automatically created in Kafka for failure recovery, where "applicationID"
-     * is specified by the user in {@link org.apache.kafka.streams.StreamsConfig}.
-     *
-     * @param keySerde     key serde used to send key-value pairs,
-     *                     if not specified the default key serde defined in the configuration will be used
-     * @param valSerde     value serde used to send key-value pairs,
-     *                     if not specified the default value serde defined in the configuration will be used
-     * @param partitioner  the function used to determine how records are distributed among partitions of the topic,
-     *                     if not specified and {@code keySerde} provides a {@link org.apache.kafka.streams.kstream.internals.WindowedSerializer} for the key
-     *                     {@link org.apache.kafka.streams.kstream.internals.WindowedStreamPartitioner} will be used
-     *                     &mdash; otherwise {@link DefaultPartitioner} will be used
-     * @param topic        the topic name
-     * @param storeName    the state store name used for this KTable
-     * @return a new {@link KTable} that contains the exact same records as this {@link KTable}
+     * Materialize this changelog stream to a topic and creates a new {@link KTable} from the topic using default
+     * serializers and deserializers and producer's {@link DefaultPartitioner}.
+     * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
+     * started).
+     * <p>
+     * This is equivalent to calling {@link #to(String) #to(someTopicName)} and
+     * {@link KStreamBuilder#table(String, String) KStreamBuilder#table(someTopicName, queryableStoreName)}.
+     * <p>
+     * The resulting {@link KTable} will be materialized in a local state store with the given store name (cf.
+     * {@link KStreamBuilder#table(String, String)})
+     *
+     * @param topic     the topic name
+     * @param storeName the state store name used for the result {@link KTable}
+     * @return a {@link KTable} that contains the exact same (and potentially repartitioned) records as this {@link KTable}
      */
-    KTable<K, V> through(Serde<K> keySerde, Serde<V> valSerde, StreamPartitioner<? super K, ? super V> partitioner, String topic, String storeName);
+    KTable<K, V> through(final String topic,
+                         final String storeName);
 
     /**
-     * Materialize this stream to a topic using default serializers specified in the config
-     * and producer's {@link DefaultPartitioner}.
-     *
-     * @param topic         the topic name
+     * Materialize this changelog stream to a topic and creates a new {@link KTable} from the topic using default
+     * serializers and deserializers and a customizable {@link StreamPartitioner} to determine the distribution of
+     * records to partitions.
+     * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
+     * started).
+     * <p>
+     * This is equivalent to calling {@link #to(StreamPartitioner, String) #to(partitioner, someTopicName)} and
+     * {@link KStreamBuilder#table(String, String) KStreamBuilder#table(someTopicName, queryableStoreName)}.
+     * <p>
+     * The resulting {@link KTable} will be materialized in a local state store with the given store name (cf.
+     * {@link KStreamBuilder#table(String, String)})
+     *
+     * @param partitioner the function used to determine how records are distributed among partitions of the topic,
+     *                    if not specified producer's {@link DefaultPartitioner} will be used
+     * @param topic       the topic name
+     * @param storeName   the state store name used for the result {@link KTable}
+     * @return a {@link KTable} that contains the exact same (and potentially repartitioned) records as this {@link KTable}
      */
-    void to(String topic);
+    KTable<K, V> through(final StreamPartitioner<? super K, ? super V> partitioner,
+                         final String topic,
+                         final String storeName);
 
     /**
-     * Materialize this stream to a topic using default serializers specified in the config
-     * and a customizable {@link StreamPartitioner} to determine the distribution of records to partitions.
-     *
-     * @param partitioner  the function used to determine how records are distributed among partitions of the topic,
-     *                     if not specified producer's {@link DefaultPartitioner} will be used
-     * @param topic        the topic name
+     * Materialize this changelog stream to a topic and creates a new {@link KTable} from the topic.
+     * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
+     * started).
+     * <p>
+     * If {@code keySerde} provides a {@link WindowedSerializer} for the key {@link WindowedStreamPartitioner} is
+     * used&mdash;otherwise producer's {@link DefaultPartitioner} is used.
+     * <p>
+     * This is equivalent to calling {@link #to(Serde, Serde, String) #to(keySerde, valueSerde, someTopicName)} and
+     * {@link KStreamBuilder#table(String, String) KStreamBuilder#table(someTopicName, queryableStoreName)}.
+     * <p>
+     * The resulting {@link KTable} will be materialized in a local state store with the given store name (cf.
+     * {@link KStreamBuilder#table(String, String)})
+     *
+     * @param keySerde  key serde used to send key-value pairs,
+     *                  if not specified the default key serde defined in the configuration will be used
+     * @param valSerde  value serde used to send key-value pairs,
+     *                  if not specified the default value serde defined in the configuration will be used
+     * @param topic     the topic name
+     * @param storeName the state store name used for the result {@link KTable}
+     * @return a {@link KTable} that contains the exact same (and potentially repartitioned) records as this {@link KTable}
      */
-    void to(StreamPartitioner<? super K, ? super V> partitioner, String topic);
+    KTable<K, V> through(final Serde<K> keySerde, Serde<V> valSerde,
+                         final String topic,
+                         final String storeName);
 
     /**
-     * Materialize this stream to a topic. If {@code keySerde} provides a
-     * {@link org.apache.kafka.streams.kstream.internals.WindowedSerializer} for the key
-     * {@link org.apache.kafka.streams.kstream.internals.WindowedStreamPartitioner} is used
-     * &mdash; otherwise producer's {@link DefaultPartitioner} is used.
-     *
-     * @param keySerde     key serde used to send key-value pairs,
-     *                     if not specified the default serde defined in the configs will be used
-     * @param valSerde     value serde used to send key-value pairs,
-     *                     if not specified the default serde defined in the configs will be used
-     * @param topic        the topic name
+     * Materialize this changelog stream to a topic and creates a new {@link KTable} from the topic using a customizable
+     * {@link StreamPartitioner} to determine the distribution of records to partitions.
+     * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
+     * started).
+     * <p>
+     * This is equivalent to calling {@link #to(Serde, Serde, StreamPartitioner, String)
+     * #to(keySerde, valueSerde, partitioner, someTopicName)} and
+     * {@link KStreamBuilder#table(String, String) KStreamBuilder#table(someTopicName, queryableStoreName)}.
+     * <p>
+     * The resulting {@link KTable} will be materialized in a local state store with the given store name (cf.
+     * {@link KStreamBuilder#table(String, String)})
+     *
+     * @param keySerde    key serde used to send key-value pairs,
+     *                    if not specified the default key serde defined in the configuration will be used
+     * @param valSerde    value serde used to send key-value pairs,
+     *                    if not specified the default value serde defined in the configuration will be used
+     * @param partitioner the function used to determine how records are distributed among partitions of the topic,
+     *                    if not specified and {@code keySerde} provides a {@link WindowedSerializer} for the key
+     *                    {@link WindowedStreamPartitioner} will be used&mdash;otherwise {@link DefaultPartitioner} will
+     *                    be used
+     * @param topic      the topic name
+     * @param storeName  the state store name used for the result {@link KTable}
+     * @return a {@link KTable} that contains the exact same (and potentially repartitioned) records as this {@link KTable}
      */
-    void to(Serde<K> keySerde, Serde<V> valSerde, String topic);
+    KTable<K, V> through(final Serde<K> keySerde,
+                         final Serde<V> valSerde,
+                         final StreamPartitioner<? super K, ? super V> partitioner,
+                         final String topic,
+                         final String storeName);
 
     /**
-     * Materialize this stream to a topic using a customizable {@link StreamPartitioner} to determine the distribution of records to partitions.
+     * Materialize this changelog stream to a topic using default serializers and deserializers and producer's
+     * {@link DefaultPartitioner}.
+     * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
+     * started).
      *
-     * @param keySerde     key serde used to send key-value pairs,
-     *                     if not specified the default serde defined in the configs will be used
-     * @param valSerde     value serde used to send key-value pairs,
-     *                     if not specified the default serde defined in the configs will be used
-     * @param partitioner  the function used to determine how records are distributed among partitions of the topic,
-     *                     if not specified and {@code keySerde} provides a {@link org.apache.kafka.streams.kstream.internals.WindowedSerializer} for the key
-     *                     {@link org.apache.kafka.streams.kstream.internals.WindowedStreamPartitioner} will be used
-     *                     &mdash; otherwise {@link DefaultPartitioner} will be used
-     * @param topic        the topic name
+     * @param topic the topic name
      */
-    void to(Serde<K> keySerde, Serde<V> valSerde, StreamPartitioner<? super K, ? super V> partitioner, String topic);
+    void to(final String topic);
 
     /**
-     * Convert this stream to a new instance of {@link KStream}.
-     *
-     * @return a {@link KStream} that contains the same records as this {@link KTable};
-     *         the records are no longer treated as updates on a primary-keyed table,
-     *         but rather as normal key-value pairs in a record stream
+     * Materialize this changelog stream to a topic using default serializers and deserializers and a customizable
+     * {@link StreamPartitioner} to determine the distribution of records to partitions.
+     * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
+     * started).
+     *
+     * @param partitioner the function used to determine how records are distributed among partitions of the topic,
+     *                    if not specified producer's {@link DefaultPartitioner} will be used
+     * @param topic       the topic name
      */
-    KStream<K, V> toStream();
+    void to(final StreamPartitioner<? super K, ? super V> partitioner,
+            final String topic);
 
     /**
-     *  Convert this stream to a new instance of {@link KStream} using the given {@link KeyValueMapper} to select
-     *  the new key.
-     *
-     * @param mapper  @param mapper  the instance of {@link KeyValueMapper}
-     * @param <K1> the new key type
+     * Materialize this changelog stream to a topic.
+     * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
+     * started).
+     * <p>
+     * If {@code keySerde} provides a {@link WindowedSerializer} for the key {@link WindowedStreamPartitioner} is
+     * used&mdash;otherwise producer's {@link DefaultPartitioner} is used.
      *
-     * @return a {@link KStream} that contains the transformed records from this {@link KTable};
-     *         the records are no longer treated as updates on a primary-keyed table,
-     *         but rather as normal key-value pairs in a record stream
+     * @param keySerde key serde used to send key-value pairs,
+     *                 if not specified the default key serde defined in the configuration will be used
+     * @param valSerde value serde used to send key-value pairs,
+     *                 if not specified the default value serde defined in the configuration will be used
+     * @param topic    the topic name
      */
-    <K1> KStream<K1, V> toStream(KeyValueMapper<? super K, ? super V, ? extends K1> mapper);
+    void to(final Serde<K> keySerde,
+            final Serde<V> valSerde,
+            final String topic);
 
     /**
-     * Combine values of this stream with another {@link KTable} stream's elements of the same key using Inner Join.
-     *
-     * @param other         the instance of {@link KTable} joined with this stream
-     * @param joiner        the instance of {@link ValueJoiner}
-     * @param <V1>          the value type of the other stream
-     * @param <R>           the value type of the new stream
-     *
-     * @return a {@link KTable} that contains join-records for each key and values computed by the given {@link ValueJoiner},
-     *         one for each matched record-pair with the same key
+     * Materialize this changelog stream to a topic using a customizable {@link StreamPartitioner} to determine the
+     * distribution of records to partitions.
+     * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
+     * started).
+     *
+     * @param keySerde    key serde used to send key-value pairs,
+     *                    if not specified the default key serde defined in the configuration will be used
+     * @param valSerde    value serde used to send key-value pairs,
+     *                    if not specified the default value serde defined in the configuration will be used
+     * @param partitioner the function used to determine how records are distributed among partitions of the topic,
+     *                    if not specified and {@code keySerde} provides a {@link WindowedSerializer} for the key
+     *                    {@link WindowedStreamPartitioner} will be used&mdash;otherwise {@link DefaultPartitioner} will
+     *                    be used
+     * @param topic      the topic name
      */
-    <V1, R> KTable<K, R> join(KTable<K, V1> other, ValueJoiner<? super V, ? super V1, ? extends R> joiner);
+    void to(final Serde<K> keySerde,
+            final Serde<V> valSerde,
+            final StreamPartitioner<? super K, ? super V> partitioner,
+            final String topic);
 
     /**
-     * Combine values of this stream with another {@link KTable} stream's elements of the same key using Outer Join.
-     *
-     * @param other         the instance of {@link KTable} joined with this stream
-     * @param joiner        the instance of {@link ValueJoiner}
-     * @param <V1>          the value type of the other stream
-     * @param <R>           the value type of the new stream
-     *
-     * @return a {@link KTable} that contains join-records for each key and values computed by the given {@link ValueJoiner},
-     *         one for each matched record-pair with the same key
+     * Re-groups the records of this {@link KTable} using the provided {@link KeyValueMapper} and default serializers
+     * and deserializers.
+     * Each {@link KeyValue} pair of this {@link KTable} is mapped to a new {@link KeyValue} pair by applying the
+     * provided {@link KeyValueMapper}.
+     * Re-grouping a {@link KTable} is required before an aggregation operator can be applied to the data
+     * (cf. {@link KGroupedTable}).
+     * The {@link KeyValueMapper} selects a new key and value (with should both have unmodified type).
+     * If the new record key is {@code null} the record will not be included in the resulting {@link KGroupedTable}
+     * <p>
+     * Because a new key is selected, an internal repartitioning topic will be created in Kafka.
+     * This topic will be named "${applicationId}-XXX-repartition", where "applicationId" is user-specified in
+     * {@link  StreamsConfig} via parameter {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is
+     * an internally generated name, and "-repartition" is a fixed suffix.
+     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
+     * <p>
+     * All data of this {@link KTable} will be redistributed through the repartitioning topic by writing all update
+     * records to and rereading all update records from it, such that the resulting {@link KGroupedTable} is partitioned
+     * on the new key.
+     * <p>
+     * If the key or value type is changed, it is recommended to use {@link #groupBy(KeyValueMapper, Serde, Serde)}
+     * instead.
+     *
+     * @param selector a {@link KeyValueMapper} that computes a new grouping key and value to be aggregated
+     * @param <KR>     the key type of the result {@link KGroupedTable}
+     * @param <VR>     the value type of the result {@link KGroupedTable}
+     * @return a {@link KGroupedTable} that contains the re-grouped records of the original {@link KTable}
      */
-    <V1, R> KTable<K, R> outerJoin(KTable<K, V1> other, ValueJoiner<? super V, ? super V1, ? extends R> joiner);
+    <KR, VR> KGroupedTable<KR, VR> groupBy(final KeyValueMapper<? super K, ? super V, KeyValue<KR, VR>> selector);
 
     /**
-     * Combine values of this stream with another {@link KTable} stream's elements of the same key using Left Join.
-     *
-     * @param other         the instance of {@link KTable} joined with this stream
-     * @param joiner        the instance of {@link ValueJoiner}
-     * @param <V1>          the value type of the other stream
-     * @param <R>           the value type of the new stream
-     *
-     * @return a {@link KTable} that contains join-records for each key and values computed by the given {@link ValueJoiner},
-     *         one for each matched record-pair with the same key
+     * Re-groups the records of this {@link KTable} using the provided {@link KeyValueMapper}.
+     * Each {@link KeyValue} pair of this {@link KTable} is mapped to a new {@link KeyValue} pair by applying the
+     * provided {@link KeyValueMapper}.
+     * Re-grouping a {@link KTable} is required before an aggregation operator can be applied to the data
+     * (cf. {@link KGroupedTable}).
+     * The {@link KeyValueMapper} selects a new key and value (both with potentially different type).
+     * If the new record key is {@code null} the record will not be included in the resulting {@link KGroupedTable}
+     * <p>
+     * Because a new key is selected, an internal repartitioning topic will be created in Kafka.
+     * This topic will be named "${applicationId}-XXX-repartition", where "applicationId" is user-specified in
+     * {@link  StreamsConfig} via parameter {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is
+     * an internally generated name, and "-repartition" is a fixed suffix.
+     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
+     * <p>
+     * All data of this {@link KTable} will be redistributed through the repartitioning topic by writing all update
+     * records to and rereading all update records from it, such that the resulting {@link KGroupedTable} is partitioned
+     * on the new key.
+     *
+     * @param selector   a {@link KeyValueMapper} that computes a new grouping key and value to be aggregated
+     * @param keySerde   key serdes for materializing this stream,
+     *                   if not specified the default serdes defined in the configs will be used
+     * @param valueSerde value serdes for materializing this stream,
+     *                   if not specified the default serdes defined in the configs will be used
+     * @param <KR>       the key type of the result {@link KGroupedTable}
+     * @param <VR>       the value type of the result {@link KGroupedTable}
+     * @return a {@link KGroupedTable} that contains the re-grouped records of the original {@link KTable}
      */
-    <V1, R> KTable<K, R> leftJoin(KTable<K, V1> other, ValueJoiner<? super V, ? super V1, ? extends R> joiner);
-
+    <KR, VR> KGroupedTable<KR, VR> groupBy(final KeyValueMapper<? super K, ? super V, KeyValue<KR, VR>> selector,
+                                           final Serde<KR> keySerde,
+                                           final Serde<VR> valueSerde);
 
     /**
-     * Group the records of this {@link KTable} using the provided {@link KeyValueMapper}.
-     * 
-     * @param selector      select the grouping key and value to be aggregated
-     * @param keySerde      key serdes for materializing this stream,
-     *                      if not specified the default serdes defined in the configs will be used
-     * @param valueSerde    value serdes for materializing this stream,
-     *                      if not specified the default serdes defined in the configs will be used
-     * @param <K1>          the key type of the {@link KGroupedTable}
-     * @param <V1>          the value type of the {@link KGroupedTable}
-     *
-     * @return a {@link KGroupedTable} that contains the re-partitioned records of this {@link KTable}
+     * Join records of this {@link KTable} with another {@link KTable}'s records using non-windowed inner equi join.
+     * The join is a primary key join with join attribute {@code thisKTable.key == otherKTable.key}.
+     * The result is an ever updating {@link KTable} that represents the <em>current</em> (i.e., processing time) result
+     * of the join.
+     * <p>
+     * The join is computed by (1) updating the internal state of one {@link KTable} and (2) performing a lookup for a
+     * matching record in the <em>current</em> (i.e., processing time) internal state of the other {@link KTable}.
+     * This happens in a symmetric way, i.e., for each update of either {@code this} or the {@code other} input
+     * {@link KTable} the result gets updated.
+     * <p>
+     * For each {@link KTable} record that finds a corresponding record in the other {@link KTable} the provided
+     * {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
+     * The key of the result record is the same as for both joining input records.
+     * <p>
+     * Note that {@link KeyValue records} with {@code null} values (so-called tombstone records) have delete semantics.
+     * Thus, for input tombstones the provided value-joiner is not called but a tombstone record is forwarded
+     * directly to delete a record in the result {@link KTable} if required (i.e., if there is anything to be deleted).
+     * <p>
+     * A {@link KTable} input record key cannot be {@code null}.
+     * <p>
+     * Example:
+     * <table border='1'>
+     * <tr>
+     * <th>thisKTable</th>
+     * <th>thisState</th>
+     * <th>otherKTable</th>
+     * <th>otherState</th>
+     * <th>result update record</th>
+     * </tr>
+     * <tr>
+     * <td>&lt;K1:A&gt;</td>
+     * <td>&lt;K1:A&gt;</td>
+     * <td></td>
+     * <td></td>
+     * <td></td>
+     * </tr>
+     * <tr>
+     * <td></td>
+     * <td>&lt;K1:A&gt;</td>
+     * <td>&lt;K1:b&gt;</td>
+     * <td>&lt;K1:b&gt;</td>
+     * <td>&lt;K1:ValueJoiner(A,b)&gt;</td>
+     * </tr>
+     * <tr>
+     * <td>&lt;K1:C&gt;</td>
+     * <td>&lt;K1:C&gt;</td>
+     * <td></td>
+     * <td>&lt;K1:b&gt;</td>
+     * <td>&lt;K1:ValueJoiner(C,b)&gt;</td>
+     * </tr>
+     * <tr>
+     * <td></td>
+     * <td>&lt;K1:C&gt;</td>
+     * <td>&lt;K1:null&gt;</td>
+     * <td></td>
+     * <td>&lt;K1:null&gt;</td>
+     * </tr>
+     * </table>
+     * Both input streams need to be co-partitioned on the join key.
+     * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
+     * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
+     * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
+     * "-repartition" is a fixed suffix.
+     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
+     * <p>
+     * Repartitioning can happen both input {@link KTable}s.
+     * For this case, all data of a {@link KTable} will be redistributed through the repartitioning topic by writing all
+     * update records to and rereading all update records from it, such that the join input {@link KTable} is
+     * partitioned correctly on its key.
+     *
+     * @param other  the other {@link KTable} to be joined with this {@link KTable}
+     * @param joiner a {@link ValueJoiner} that computes the join result for a pair of matching records
+     * @param <VO>   the value type of the other {@link KTable}
+     * @param <VR>   the value type of the result {@link KTable}
+     * @return a {@link KTable} that contains join-records for each key and values computed by the given
+     * {@link ValueJoiner}, one for each matched record-pair with the same key
+     * @see #leftJoin(KTable, ValueJoiner)
+     * @see #outerJoin(KTable, ValueJoiner)
      */
-    <K1, V1> KGroupedTable<K1, V1> groupBy(KeyValueMapper<? super K, ? super V, KeyValue<K1, V1>> selector, Serde<K1> keySerde, Serde<V1> valueSerde);
+    <VO, VR> KTable<K, VR> join(final KTable<K, VO> other,
+                                final ValueJoiner<? super V, ? super VO, ? extends VR> joiner);
 
     /**
-     * Group the records of this {@link KTable} using the provided {@link KeyValueMapper} and default serializers and deserializers.
-     *
-     * @param selector      select the grouping key and value to be aggregated
-     * @param <K1>          the key type of the {@link KGroupedTable}
-     * @param <V1>          the value type of the {@link KGroupedTable}
-     *
-     * @return a {@link KGroupedTable} that contains the re-partitioned records of this {@link KTable}
+     * Join records of this {@link KTable} (left input) with another {@link KTable}'s (right input) records using
+     * non-windowed left equi join.
+     * The join is a primary key join with join attribute {@code thisKTable.key == otherKTable.key}.
+     * In contrast to {@link #join(KTable, ValueJoiner) inner-join}, all records from left {@link KTable} will produce
+     * an output record (cf. below).
+     * The result is an ever updating {@link KTable} that represents the <em>current</em> (i.e., processing time) result
+     * of the join.
+     * <p>
+     * The join is computed by (1) updating the internal state of one {@link KTable} and (2) performing a lookup for a
+     * matching record in the <em>current</em> (i.e., processing time) internal state of the other {@link KTable}.
+     * This happens in a symmetric way, i.e., for each update of either {@code this} or the {@code other} input
+     * {@link KTable} the result gets updated.
+     * <p>
+     * For each {@link KTable} record that finds a corresponding record in the other {@link KTable}'s state the
+     * provided {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
+     * Additionally, for each record of left {@link KTable} that does not find a corresponding record in the
+     * right {@link KTable}'s state the provided {@link ValueJoiner} will be called with {@code rightValue =
+     * null} to compute a value (with arbitrary type) for the result record.
+     * The key of the result record is the same as for both joining input records.
+     * <p>
+     * Note that {@link KeyValue records} with {@code null} values (so-called tombstone records) have delete semantics.
+     * For example, for left input tombstones the provided value-joiner is not called but a tombstone record is
+     * forwarded directly to delete a record in the result {@link KTable} if required (i.e., if there is anything to be
+     * deleted).
+     * <p>
+     * A {@link KTable} input record key cannot be {@code null}.
+     * <p>
+     * Example:
+     * <table border='1'>
+     * <tr>
+     * <th>thisKTable</th>
+     * <th>thisState</th>
+     * <th>otherKTable</th>
+     * <th>otherState</th>
+     * <th>result update record</th>
+     * </tr>
+     * <tr>
+     * <td>&lt;K1:A&gt;</td>
+     * <td>&lt;K1:A&gt;</td>
+     * <td></td>
+     * <td></td>
+     * <td>&lt;K1:ValueJoiner(A,null)&gt;</td>
+     * </tr>
+     * <tr>
+     * <td></td>
+     * <td>&lt;K1:A&gt;</td>
+     * <td>&lt;K1:b&gt;</td>
+     * <td>&lt;K1:b&gt;</td>
+     * <td>&lt;K1:ValueJoiner(A,b)&gt;</td>
+     * </tr>
+     * <tr>
+     * <td>&lt;K1:null&gt;</td>
+     * <td></td>
+     * <td></td>
+     * <td>&lt;K1:b&gt;</td>
+     * <td>&lt;K1:null&gt;</td>
+     * </tr>
+     * <tr>
+     * <td></td>
+     * <td></td>
+     * <td>&lt;K1:null&gt;</td>
+     * <td></td>
+     * <td></td>
+     * </tr>
+     * </table>
+     * Both input streams need to be co-partitioned on the join key.
+     * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
+     * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
+     * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
+     * "-repartition" is a fixed suffix.
+     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
+     * <p>
+     * Repartitioning can happen both input {@link KTable}s.
+     * For this case, all data of a {@link KTable} will be redistributed through the repartitioning topic by writing all
+     * update records to and rereading all update records from it, such that the join input {@link KTable} is
+     * partitioned correctly on its key.
+     *
+     * @param other  the other {@link KTable} to be joined with this {@link KTable}
+     * @param joiner a {@link ValueJoiner} that computes the join result for a pair of matching records
+     * @param <VO>   the value type of the other {@link KTable}
+     * @param <VR>   the value type of the result {@link KTable}
+     * @return a {@link KTable} that contains join-records for each key and values computed by the given
+     * {@link ValueJoiner}, one for each matched record-pair with the same key plus one for each non-matching record of
+     * left {@link KTable}
+     * @see #join(KTable, ValueJoiner)
+     * @see #outerJoin(KTable, ValueJoiner)
      */
-    <K1, V1> KGroupedTable<K1, V1> groupBy(KeyValueMapper<? super K, ? super V, KeyValue<K1, V1>> selector);
+    <VO, VR> KTable<K, VR> leftJoin(final KTable<K, VO> other,
+                                    final ValueJoiner<? super V, ? super VO, ? extends VR> joiner);
 
     /**
-     * Perform an action on each element of {@link KTable}.
-     * Note that this is a terminal operation that returns void.
-     *
-     * @param action an action to perform on each element
+     * Join records of this {@link KTable} (left input) with another {@link KTable}'s (right input) records using
+     * non-windowed outer equi join.
+     * The join is a primary key join with join attribute {@code thisKTable.key == otherKTable.key}.
+     * In contrast to {@link #join(KTable, ValueJoiner) inner-join} or {@link #leftJoin(KTable, ValueJoiner) left-join},
+     * all records from both input {@link KTable}s will produce an output record (cf. below).
+     * The result is an ever updating {@link KTable} that represents the <em>current</em> (i.e., processing time) result
+     * of the join.
+     * <p>
+     * The join is computed by (1) updating the internal state of one {@link KTable} and (2) performing a lookup for a
+     * matching record in the <em>current</em> (i.e., processing time) internal state of the other {@link KTable}.
+     * This happens in a symmetric way, i.e., for each update of either {@code this} or the {@code other} input
+     * {@link KTable} the result gets updated.
+     * <p>
+     * For each {@link KTable} record that finds a corresponding record in the other {@link KTable}'s state the
+     * provided {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
+     * Additionally, for each record that does not find a corresponding record in the corresponding other
+     * {@link KTable}'s state the provided {@link ValueJoiner} will be called with {@code null} value for the
+     * corresponding other value to compute a value (with arbitrary type) for the result record.
+     * The key of the result record is the same as for both joining input records.
+     * <p>
+     * Note that {@link KeyValue records} with {@code null} values (so-called tombstone records) have delete semantics.
+     * Thus, for input tombstones the provided value-joiner is not called but a tombstone record is forwarded directly
+     * to delete a record in the result {@link KTable} if required (i.e., if there is anything to bedeleted).
+     * <p>
+     * A {@link KTable} input record key cannot be {@code null}.
+     * <p>
+     * Example:
+     * <table border='1'>
+     * <tr>
+     * <th>thisKTable</th>
+     * <th>thisState</th>
+     * <th>otherKTable</th>
+     * <th>otherState</th>
+     * <th>result update record</th>
+     * </tr>
+     * <tr>
+     * <td>&lt;K1:A&gt;</td>
+     * <td>&lt;K1:A&gt;</td>
+     * <td></td>
+     * <td></td>
+     * <td>&lt;K1:ValueJoiner(A,null)&gt;</td>
+     * </tr>
+     * <tr>
+     * <td></td>
+     * <td>&lt;K1:A&gt;</td>
+     * <td>&lt;K1:b&gt;</td>
+     * <td>&lt;K1:b&gt;</td>
+     * <td>&lt;K1:ValueJoiner(A,b)&gt;</td>
+     * </tr>
+     * <tr>
+     * <td>&lt;K1:null&gt;</td>
+     * <td></td>
+     * <td></td>
+     * <td>&lt;K1:b&gt;</td>
+     * <td>&lt;K1:ValueJoiner(null,b)&gt;</td>
+     * </tr>
+     * <tr>
+     * <td></td>
+     * <td></td>
+     * <td>&lt;K1:null&gt;</td>
+     * <td></td>
+     * <td>&lt;K1:null&gt;</td>
+     * </tr>
+     * </table>
+     * Both input streams need to be co-partitioned on the join key.
+     * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
+     * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
+     * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
+     * user-specified in {@link StreamsConfig} via parameter
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
+     * "-repartition" is a fixed suffix.
+     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
+     * <p>
+     * Repartitioning can happen both input {@link KTable}s.
+     * For this case, all data of a {@link KTable} will be redistributed through the repartitioning topic by writing all
+     * update records to and rereading all update records from it, such that the join input {@link KTable} is
+     * partitioned correctly on its key.
+     *
+     * @param other  the other {@link KTable} to be joined with this {@link KTable}
+     * @param joiner a {@link ValueJoiner} that computes the join result for a pair of matching records
+     * @param <VO>   the value type of the other {@link KTable}
+     * @param <VR>   the value type of the result {@link KTable}
+     * @return a {@link KTable} that contains join-records for each key and values computed by the given
+     * {@link ValueJoiner}, one for each matched record-pair with the same key plus one for each non-matching record of
+     * both {@link KTable}s
+     * @see #join(KTable, ValueJoiner)
+     * @see #leftJoin(KTable, ValueJoiner)
      */
-    void foreach(ForeachAction<? super K, ? super V> action);
+    <VO, VR> KTable<K, VR> outerJoin(final KTable<K, VO> other,
+                                     final ValueJoiner<? super V, ? super VO, ? extends VR> joiner);
 
     /**
-     * Get the name of the local state store used for materializing this {@link KTable}
-     * @return the underlying state store name, or {@code null} if KTable does not have one
+     * Get the name of the local state store used for materializing this {@link KTable}.
+     *
+     * @return the underlying state store name, or {@code null} if this {@link KTable} is not materialized
      */
     String getStoreName();
 }

From 634c167348e9548ed2ef87239fbd5d881fa019e7 Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Fri, 27 Jan 2017 08:47:19 -0800
Subject: [PATCH 068/177] KAFKA-4644: Improve test coverage of
 StreamsPartitionAssignor

Some exception paths not previously covered. Extracted `ensureCopartitioning` into a static class.

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2448 from dguy/KAFKA-4644

(cherry picked from commit 662c2f893c95128a9d5033f730f1538d368fd151)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../internals/StreamPartitionAssignor.java    | 109 +++++++-------
 .../CopartitionedTopicsValidatorTest.java     | 137 ++++++++++++++++++
 .../StreamPartitionAssignorTest.java          | 128 +++++-----------
 3 files changed, 237 insertions(+), 137 deletions(-)
 create mode 100644 streams/src/test/java/org/apache/kafka/streams/processor/internals/CopartitionedTopicsValidatorTest.java

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java
index c790a1e99970b..1ad6dbcbfb4db 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java
@@ -124,7 +124,7 @@ public String toString() {
         }
     }
 
-    private static class InternalTopicMetadata {
+    static class InternalTopicMetadata {
         public final InternalTopicConfig config;
 
         public int numPartitions;
@@ -160,6 +160,7 @@ public int compare(TopicPartition p1, TopicPartition p2) {
     private Map<TaskId, Set<TopicPartition>> activeTasks;
 
     private InternalTopicManager internalTopicManager;
+    private CopartitionedTopicsValidator copartitionedTopicsValidator;
 
     /**
      * We need to have the PartitionAssignor and its StreamThread to be mutually accessible
@@ -211,6 +212,8 @@ public void configure(Map<String, ?> configs) {
                 configs.containsKey(StreamsConfig.WINDOW_STORE_CHANGE_LOG_ADDITIONAL_RETENTION_MS_CONFIG) ?
                         (Long) configs.get(StreamsConfig.WINDOW_STORE_CHANGE_LOG_ADDITIONAL_RETENTION_MS_CONFIG)
                         : WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT);
+
+        this.copartitionedTopicsValidator = new CopartitionedTopicsValidator(streamThread.getName());
     }
 
     @Override
@@ -642,54 +645,7 @@ private void ensureCopartitioning(Collection<Set<String>> copartitionGroups,
                                       Map<String, InternalTopicMetadata> allRepartitionTopicsNumPartitions,
                                       Cluster metadata) {
         for (Set<String> copartitionGroup : copartitionGroups) {
-            ensureCopartitioning(copartitionGroup, allRepartitionTopicsNumPartitions, metadata);
-        }
-    }
-
-    private void ensureCopartitioning(Set<String> copartitionGroup,
-                                      Map<String, InternalTopicMetadata> allRepartitionTopicsNumPartitions,
-                                      Cluster metadata) {
-        int numPartitions = UNKNOWN;
-
-        for (String topic : copartitionGroup) {
-            if (!allRepartitionTopicsNumPartitions.containsKey(topic)) {
-                Integer partitions = metadata.partitionCountForTopic(topic);
-
-                if (partitions == null)
-                    throw new TopologyBuilderException(String.format("stream-thread [%s] Topic not found: %s", streamThread.getName(), topic));
-
-                if (numPartitions == UNKNOWN) {
-                    numPartitions = partitions;
-                } else if (numPartitions != partitions) {
-                    String[] topics = copartitionGroup.toArray(new String[copartitionGroup.size()]);
-                    Arrays.sort(topics);
-                    throw new TopologyBuilderException(String.format("stream-thread [%s] Topics not co-partitioned: [%s]", streamThread.getName(), Utils.mkString(Arrays.asList(topics), ",")));
-                }
-            } else {
-                if (allRepartitionTopicsNumPartitions.get(topic).numPartitions == NOT_AVAILABLE) {
-                    numPartitions = NOT_AVAILABLE;
-                    break;
-                }
-            }
-        }
-
-        // if all topics for this co-partition group is repartition topics,
-        // then set the number of partitions to be the maximum of the number of partitions.
-        if (numPartitions == UNKNOWN) {
-            for (Map.Entry<String, InternalTopicMetadata> entry: allRepartitionTopicsNumPartitions.entrySet()) {
-                if (copartitionGroup.contains(entry.getKey())) {
-                    int partitions = entry.getValue().numPartitions;
-                    if (partitions > numPartitions) {
-                        numPartitions = partitions;
-                    }
-                }
-            }
-        }
-        // enforce co-partitioning restrictions to repartition topics by updating their number of partitions
-        for (Map.Entry<String, InternalTopicMetadata> entry : allRepartitionTopicsNumPartitions.entrySet()) {
-            if (copartitionGroup.contains(entry.getKey())) {
-                entry.getValue().numPartitions = numPartitions;
-            }
+            copartitionedTopicsValidator.validate(copartitionGroup, allRepartitionTopicsNumPartitions, metadata);
         }
     }
 
@@ -757,4 +713,59 @@ public String toString() {
     public void close() {
         internalTopicManager.close();
     }
+
+    static class CopartitionedTopicsValidator {
+        private final String threadName;
+
+        CopartitionedTopicsValidator(final String threadName) {
+            this.threadName = threadName;
+        }
+
+        void validate(final Set<String> copartitionGroup,
+                      final Map<String, InternalTopicMetadata> allRepartitionTopicsNumPartitions,
+                      final Cluster metadata) {
+            int numPartitions = UNKNOWN;
+
+            for (final String topic : copartitionGroup) {
+                if (!allRepartitionTopicsNumPartitions.containsKey(topic)) {
+                    final Integer partitions = metadata.partitionCountForTopic(topic);
+
+                    if (partitions == null) {
+                        throw new TopologyBuilderException(String.format("stream-thread [%s] Topic not found: %s", threadName, topic));
+                    }
+
+                    if (numPartitions == UNKNOWN) {
+                        numPartitions = partitions;
+                    } else if (numPartitions != partitions) {
+                        final String[] topics = copartitionGroup.toArray(new String[copartitionGroup.size()]);
+                        Arrays.sort(topics);
+                        throw new TopologyBuilderException(String.format("stream-thread [%s] Topics not co-partitioned: [%s]", threadName, Utils.mkString(Arrays.asList(topics), ",")));
+                    }
+                } else if (allRepartitionTopicsNumPartitions.get(topic).numPartitions == NOT_AVAILABLE) {
+                    numPartitions = NOT_AVAILABLE;
+                    break;
+                }
+            }
+
+            // if all topics for this co-partition group is repartition topics,
+            // then set the number of partitions to be the maximum of the number of partitions.
+            if (numPartitions == UNKNOWN) {
+                for (Map.Entry<String, InternalTopicMetadata> entry: allRepartitionTopicsNumPartitions.entrySet()) {
+                    if (copartitionGroup.contains(entry.getKey())) {
+                        final int partitions = entry.getValue().numPartitions;
+                        if (partitions > numPartitions) {
+                            numPartitions = partitions;
+                        }
+                    }
+                }
+            }
+            // enforce co-partitioning restrictions to repartition topics by updating their number of partitions
+            for (Map.Entry<String, InternalTopicMetadata> entry : allRepartitionTopicsNumPartitions.entrySet()) {
+                if (copartitionGroup.contains(entry.getKey())) {
+                    entry.getValue().numPartitions = numPartitions;
+                }
+            }
+
+        }
+    }
 }
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/CopartitionedTopicsValidatorTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/CopartitionedTopicsValidatorTest.java
new file mode 100644
index 0000000000000..e7235b03c9bc3
--- /dev/null
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/CopartitionedTopicsValidatorTest.java
@@ -0,0 +1,137 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.kafka.streams.processor.internals;
+
+import org.apache.kafka.common.Cluster;
+import org.apache.kafka.common.PartitionInfo;
+import org.apache.kafka.common.TopicPartition;
+import org.apache.kafka.common.utils.Utils;
+import org.apache.kafka.streams.errors.TopologyBuilderException;
+import org.junit.Before;
+import org.junit.Test;
+
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.Map;
+
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.MatcherAssert.assertThat;
+
+public class CopartitionedTopicsValidatorTest {
+
+    private final StreamPartitionAssignor.CopartitionedTopicsValidator validator
+            = new StreamPartitionAssignor.CopartitionedTopicsValidator("thread");
+    private final Map<TopicPartition, PartitionInfo> partitions = new HashMap<>();
+    private final Cluster cluster = Cluster.empty();
+
+    @Before
+    public void before() {
+        partitions.put(new TopicPartition("first", 0), new PartitionInfo("first", 0, null, null, null));
+        partitions.put(new TopicPartition("first", 1), new PartitionInfo("first", 1, null, null, null));
+        partitions.put(new TopicPartition("second", 0), new PartitionInfo("second", 0, null, null, null));
+        partitions.put(new TopicPartition("second", 1), new PartitionInfo("second", 1, null, null, null));
+    }
+
+    @Test(expected = TopologyBuilderException.class)
+    public void shouldThrowTopologyBuilderExceptionIfNoPartitionsFoundForCoPartitionedTopic() throws Exception {
+        validator.validate(Collections.singleton("topic"),
+                           Collections.<String, StreamPartitionAssignor.InternalTopicMetadata>emptyMap(),
+                           cluster);
+    }
+
+    @Test(expected = TopologyBuilderException.class)
+    public void shouldThrowTopologyBuilderExceptionIfPartitionCountsForCoPartitionedTopicsDontMatch() throws Exception {
+        partitions.remove(new TopicPartition("second", 0));
+        validator.validate(Utils.mkSet("first", "second"),
+                           Collections.<String, StreamPartitionAssignor.InternalTopicMetadata>emptyMap(),
+                           cluster.withPartitions(partitions));
+    }
+
+
+    @Test
+    public void shouldEnforceCopartitioningOnRepartitionTopics() throws Exception {
+        final StreamPartitionAssignor.InternalTopicMetadata metadata = createTopicMetadata("repartitioned", 10);
+
+        validator.validate(Utils.mkSet("first", "second", metadata.config.name()),
+                           Collections.singletonMap(metadata.config.name(),
+                                                    metadata),
+                           cluster.withPartitions(partitions));
+
+        assertThat(metadata.numPartitions, equalTo(2));
+    }
+
+
+    @Test
+    public void shouldSetNumPartitionsToMaximumPartitionsWhenAllTopicsAreRepartitionTopics() throws Exception {
+        final StreamPartitionAssignor.InternalTopicMetadata one = createTopicMetadata("one", 1);
+        final StreamPartitionAssignor.InternalTopicMetadata two = createTopicMetadata("two", 15);
+        final StreamPartitionAssignor.InternalTopicMetadata three = createTopicMetadata("three", 5);
+        final Map<String, StreamPartitionAssignor.InternalTopicMetadata> repartitionTopicConfig = new HashMap<>();
+
+        repartitionTopicConfig.put(one.config.name(), one);
+        repartitionTopicConfig.put(two.config.name(), two);
+        repartitionTopicConfig.put(three.config.name(), three);
+
+        validator.validate(Utils.mkSet(one.config.name(),
+                                       two.config.name(),
+                                       three.config.name()),
+                           repartitionTopicConfig,
+                           cluster
+        );
+
+        assertThat(one.numPartitions, equalTo(15));
+        assertThat(two.numPartitions, equalTo(15));
+        assertThat(three.numPartitions, equalTo(15));
+    }
+
+    @Test
+    public void shouldSetRepartitionTopicsPartitionCountToNotAvailableIfAnyNotAvaliable() throws Exception {
+        final StreamPartitionAssignor.InternalTopicMetadata one = createTopicMetadata("one", 1);
+        final StreamPartitionAssignor.InternalTopicMetadata two = createTopicMetadata("two", StreamPartitionAssignor.NOT_AVAILABLE);
+        final Map<String, StreamPartitionAssignor.InternalTopicMetadata> repartitionTopicConfig = new HashMap<>();
+
+        repartitionTopicConfig.put(one.config.name(), one);
+        repartitionTopicConfig.put(two.config.name(), two);
+
+        validator.validate(Utils.mkSet("first",
+                                       "second",
+                                       one.config.name(),
+                                       two.config.name()),
+                           repartitionTopicConfig,
+                           cluster.withPartitions(partitions));
+
+        assertThat(one.numPartitions, equalTo(StreamPartitionAssignor.NOT_AVAILABLE));
+        assertThat(two.numPartitions, equalTo(StreamPartitionAssignor.NOT_AVAILABLE));
+
+    }
+
+    private StreamPartitionAssignor.InternalTopicMetadata createTopicMetadata(final String repartitionTopic,
+                                                                              final int partitions) {
+        final InternalTopicConfig repartitionTopicConfig
+                = new InternalTopicConfig(repartitionTopic,
+                                          Collections.singleton(InternalTopicConfig.CleanupPolicy.compact),
+                                          Collections.<String, String>emptyMap());
+
+
+        final StreamPartitionAssignor.InternalTopicMetadata metadata
+                = new StreamPartitionAssignor.InternalTopicMetadata(repartitionTopicConfig);
+        metadata.numPartitions = partitions;
+        return metadata;
+    }
+
+}
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignorTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignorTest.java
index eff2179abcb5e..6503038e5b3ef 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignorTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignorTest.java
@@ -19,6 +19,7 @@
 
 import org.apache.kafka.clients.consumer.internals.PartitionAssignor;
 import org.apache.kafka.common.Cluster;
+import org.apache.kafka.common.KafkaException;
 import org.apache.kafka.common.Node;
 import org.apache.kafka.common.PartitionInfo;
 import org.apache.kafka.common.TopicPartition;
@@ -99,7 +100,11 @@ public class StreamPartitionAssignorTest {
     private final TaskId task1 = new TaskId(0, 1);
     private final TaskId task2 = new TaskId(0, 2);
     private final TaskId task3 = new TaskId(0, 3);
-    private String userEndPoint = "localhost:2171";
+    private final String userEndPoint = "localhost:2171";
+    private final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
+    private final MockClientSupplier mockClientSupplier = new MockClientSupplier();
+    private final TopologyBuilder builder = new TopologyBuilder();
+    private final StreamsConfig config = new StreamsConfig(configProps());
 
     private Properties configProps() {
         return new Properties() {
@@ -115,9 +120,6 @@ private Properties configProps() {
     @SuppressWarnings("unchecked")
     @Test
     public void testSubscription() throws Exception {
-        StreamsConfig config = new StreamsConfig(configProps());
-
-        TopologyBuilder builder = new TopologyBuilder();
         builder.addSource("source1", "topic1");
         builder.addSource("source2", "topic2");
         builder.addProcessor("processor", new MockProcessorSupplier(), "source1", "source2");
@@ -142,7 +144,6 @@ public Set<TaskId> cachedTasks() {
             }
         };
 
-        StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(thread, "test", clientId));
 
         PartitionAssignor.Subscription subscription = partitionAssignor.subscription(Utils.mkSet("topic1", "topic2"));
@@ -159,9 +160,6 @@ public Set<TaskId> cachedTasks() {
 
     @Test
     public void testAssignBasic() throws Exception {
-        StreamsConfig config = new StreamsConfig(configProps());
-
-        TopologyBuilder builder = new TopologyBuilder();
         builder.addSource("source1", "topic1");
         builder.addSource("source2", "topic2");
         builder.addProcessor("processor", new MockProcessorSupplier(), "source1", "source2");
@@ -180,12 +178,10 @@ public void testAssignBasic() throws Exception {
         String client1 = "client1";
 
 
-        MockClientSupplier mockClientSupplier = new MockClientSupplier();
         StreamThread thread10 = new StreamThread(builder, config, mockClientSupplier, "test", client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
                                                  0);
 
 
-        StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(thread10, "test", client1));
         partitionAssignor.setInternalTopicManager(new MockInternalTopicManager(thread10.config, mockClientSupplier.restoreConsumer));
 
@@ -236,7 +232,6 @@ public void testAssignWithPartialTopology() throws Exception {
         props.put(StreamsConfig.PARTITION_GROUPER_CLASS_CONFIG, SingleGroupPartitionGrouperStub.class);
         StreamsConfig config = new StreamsConfig(props);
 
-        TopologyBuilder builder = new TopologyBuilder();
         builder.addSource("source1", "topic1");
         builder.addProcessor("processor1", new MockProcessorSupplier(), "source1");
         builder.addStateStore(new MockStateStoreSupplier("store1", false), "processor1");
@@ -249,10 +244,8 @@ public void testAssignWithPartialTopology() throws Exception {
         UUID uuid1 = UUID.randomUUID();
         String client1 = "client1";
 
-        final MockClientSupplier mockClientSupplier = new MockClientSupplier();
         StreamThread thread10 = new StreamThread(builder, config, mockClientSupplier, "test", client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST), 0);
 
-        StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(thread10, "test", client1));
         partitionAssignor.setInternalTopicManager(new MockInternalTopicManager(thread10.config, mockClientSupplier.restoreConsumer));
         Map<String, PartitionAssignor.Subscription> subscriptions = new HashMap<>();
@@ -275,9 +268,6 @@ public void testAssignWithPartialTopology() throws Exception {
 
     @Test
     public void testAssignEmptyMetadata() throws Exception {
-        StreamsConfig config = new StreamsConfig(configProps());
-
-        TopologyBuilder builder = new TopologyBuilder();
         builder.addSource("source1", "topic1");
         builder.addSource("source2", "topic2");
         builder.addProcessor("processor", new MockProcessorSupplier(), "source1", "source2");
@@ -295,7 +285,6 @@ public void testAssignEmptyMetadata() throws Exception {
 
         StreamThread thread10 = new StreamThread(builder, config, new MockClientSupplier(), "test", client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST), 0);
 
-        StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(thread10, "test", client1));
 
         Map<String, PartitionAssignor.Subscription> subscriptions = new HashMap<>();
@@ -336,9 +325,6 @@ public void testAssignEmptyMetadata() throws Exception {
 
     @Test
     public void testAssignWithNewTasks() throws Exception {
-        StreamsConfig config = new StreamsConfig(configProps());
-
-        TopologyBuilder builder = new TopologyBuilder();
         builder.addSource("source1", "topic1");
         builder.addSource("source2", "topic2");
         builder.addSource("source3", "topic3");
@@ -355,12 +341,9 @@ public void testAssignWithNewTasks() throws Exception {
         UUID uuid2 = UUID.randomUUID();
         String client1 = "client1";
 
-
-        MockClientSupplier mockClientSupplier = new MockClientSupplier();
         StreamThread thread10 = new StreamThread(builder, config, mockClientSupplier, "test", client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
                                                  0);
 
-        StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(thread10, "test", client1));
         partitionAssignor.setInternalTopicManager(new MockInternalTopicManager(thread10.config, mockClientSupplier.restoreConsumer));
 
@@ -399,9 +382,7 @@ public void testAssignWithNewTasks() throws Exception {
 
     @Test
     public void testAssignWithStates() throws Exception {
-        StreamsConfig config = new StreamsConfig(configProps());
         String applicationId = "test";
-        TopologyBuilder builder = new TopologyBuilder();
         builder.setApplicationId(applicationId);
         builder.addSource("source1", "topic1");
         builder.addSource("source2", "topic2");
@@ -428,10 +409,8 @@ public void testAssignWithStates() throws Exception {
         String client1 = "client1";
 
 
-        MockClientSupplier mockClientSupplier = new MockClientSupplier();
         StreamThread thread10 = new StreamThread(builder, config, mockClientSupplier, applicationId, client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
                                                  0);
-        StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
 
         partitionAssignor.configure(config.getConsumerConfigs(thread10, applicationId, client1));
         partitionAssignor.setInternalTopicManager(new MockInternalTopicManager(thread10.config, mockClientSupplier.restoreConsumer));
@@ -496,7 +475,6 @@ public void testAssignWithStandbyReplicas() throws Exception {
         props.setProperty(StreamsConfig.NUM_STANDBY_REPLICAS_CONFIG, "1");
         StreamsConfig config = new StreamsConfig(props);
 
-        TopologyBuilder builder = new TopologyBuilder();
         builder.addSource("source1", "topic1");
         builder.addSource("source2", "topic2");
         builder.addProcessor("processor", new MockProcessorSupplier(), "source1", "source2");
@@ -515,11 +493,9 @@ public void testAssignWithStandbyReplicas() throws Exception {
         UUID uuid2 = UUID.randomUUID();
         String client1 = "client1";
 
-        final MockClientSupplier mockClientSupplier = new MockClientSupplier();
         StreamThread thread10 = new StreamThread(builder, config, mockClientSupplier, "test", client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
                                                  0);
 
-        StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(thread10, "test", client1));
         partitionAssignor.setInternalTopicManager(new MockInternalTopicManager(thread10.config, mockClientSupplier.restoreConsumer));
 
@@ -568,8 +544,6 @@ public void testAssignWithStandbyReplicas() throws Exception {
 
     @Test
     public void testOnAssignment() throws Exception {
-        StreamsConfig config = new StreamsConfig(configProps());
-
         TopicPartition t2p3 = new TopicPartition("topic2", 3);
 
         TopologyBuilder builder = new TopologyBuilder();
@@ -580,10 +554,9 @@ public void testOnAssignment() throws Exception {
         UUID uuid = UUID.randomUUID();
         String client1 = "client1";
 
-        StreamThread thread = new StreamThread(builder, config, new MockClientSupplier(), "test", client1, uuid, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
+        StreamThread thread = new StreamThread(builder, config, mockClientSupplier, "test", client1, uuid, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
                                                0);
 
-        StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(thread, "test", client1));
 
         List<TaskId> activeTaskList = Utils.mkList(task0, task3);
@@ -604,9 +577,7 @@ public void testOnAssignment() throws Exception {
 
     @Test
     public void testAssignWithInternalTopics() throws Exception {
-        StreamsConfig config = new StreamsConfig(configProps());
         String applicationId = "test";
-        TopologyBuilder builder = new TopologyBuilder();
         builder.setApplicationId(applicationId);
         builder.addInternalTopic("topicX");
         builder.addSource("source1", "topic1");
@@ -620,14 +591,12 @@ public void testAssignWithInternalTopics() throws Exception {
         UUID uuid1 = UUID.randomUUID();
         String client1 = "client1";
 
-        MockClientSupplier clientSupplier = new MockClientSupplier();
 
-        StreamThread thread10 = new StreamThread(builder, config, clientSupplier, applicationId, client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
+        StreamThread thread10 = new StreamThread(builder, config, mockClientSupplier, applicationId, client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
                                                  0);
 
-        StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(thread10, applicationId, client1));
-        MockInternalTopicManager internalTopicManager = new MockInternalTopicManager(thread10.config, clientSupplier.restoreConsumer);
+        MockInternalTopicManager internalTopicManager = new MockInternalTopicManager(thread10.config, mockClientSupplier.restoreConsumer);
         partitionAssignor.setInternalTopicManager(internalTopicManager);
 
         Map<String, PartitionAssignor.Subscription> subscriptions = new HashMap<>();
@@ -644,9 +613,7 @@ public void testAssignWithInternalTopics() throws Exception {
 
     @Test
     public void testAssignWithInternalTopicThatsSourceIsAnotherInternalTopic() throws Exception {
-        StreamsConfig config = new StreamsConfig(configProps());
         String applicationId = "test";
-        TopologyBuilder builder = new TopologyBuilder();
         builder.setApplicationId(applicationId);
         builder.addInternalTopic("topicX");
         builder.addSource("source1", "topic1");
@@ -663,14 +630,11 @@ public void testAssignWithInternalTopicThatsSourceIsAnotherInternalTopic() throw
         UUID uuid1 = UUID.randomUUID();
         String client1 = "client1";
 
-        MockClientSupplier clientSupplier = new MockClientSupplier();
-
-        StreamThread thread10 = new StreamThread(builder, config, clientSupplier, applicationId, client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
+        StreamThread thread10 = new StreamThread(builder, config, mockClientSupplier, applicationId, client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
                                                  0);
 
-        StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(thread10, applicationId, client1));
-        MockInternalTopicManager internalTopicManager = new MockInternalTopicManager(thread10.config, clientSupplier.restoreConsumer);
+        MockInternalTopicManager internalTopicManager = new MockInternalTopicManager(thread10.config, mockClientSupplier.restoreConsumer);
         partitionAssignor.setInternalTopicManager(internalTopicManager);
 
         Map<String, PartitionAssignor.Subscription> subscriptions = new HashMap<>();
@@ -690,7 +654,6 @@ public void shouldAddUserDefinedEndPointToSubscription() throws Exception {
         final Properties properties = configProps();
         properties.put(StreamsConfig.APPLICATION_SERVER_CONFIG, "localhost:8080");
         final StreamsConfig config = new StreamsConfig(properties);
-        final TopologyBuilder builder = new TopologyBuilder();
         final String applicationId = "application-id";
         builder.setApplicationId(applicationId);
         builder.addSource("source", "input");
@@ -700,12 +663,9 @@ public void shouldAddUserDefinedEndPointToSubscription() throws Exception {
         final UUID uuid1 = UUID.randomUUID();
         final String client1 = "client1";
 
-        final MockClientSupplier clientSupplier = new MockClientSupplier();
-
-        final StreamThread streamThread = new StreamThread(builder, config, clientSupplier, applicationId, client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
+        final StreamThread streamThread = new StreamThread(builder, config, mockClientSupplier, applicationId, client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
                                                            0);
 
-        final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(streamThread, applicationId, client1));
         final PartitionAssignor.Subscription subscription = partitionAssignor.subscription(Utils.mkSet("input"));
         final SubscriptionInfo subscriptionInfo = SubscriptionInfo.decode(subscription.userData());
@@ -718,7 +678,6 @@ public void shouldMapUserEndPointToTopicPartitions() throws Exception {
         final String myEndPoint = "localhost:8080";
         properties.put(StreamsConfig.APPLICATION_SERVER_CONFIG, myEndPoint);
         final StreamsConfig config = new StreamsConfig(properties);
-        final TopologyBuilder builder = new TopologyBuilder();
         final String applicationId = "application-id";
         builder.setApplicationId(applicationId);
         builder.addSource("source", "topic1");
@@ -730,14 +689,12 @@ public void shouldMapUserEndPointToTopicPartitions() throws Exception {
         final UUID uuid1 = UUID.randomUUID();
         final String client1 = "client1";
 
-        final MockClientSupplier clientSupplier = new MockClientSupplier();
-
-        final StreamThread streamThread = new StreamThread(builder, config, clientSupplier, applicationId, client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
+        final StreamThread streamThread = new StreamThread(builder, config, mockClientSupplier, applicationId, client1, uuid1, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
                                                            0);
 
         final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(streamThread, applicationId, client1));
-        partitionAssignor.setInternalTopicManager(new MockInternalTopicManager(streamThread.config, clientSupplier.restoreConsumer));
+        partitionAssignor.setInternalTopicManager(new MockInternalTopicManager(streamThread.config, mockClientSupplier.restoreConsumer));
 
         final Map<String, PartitionAssignor.Subscription> subscriptions = new HashMap<>();
         final Set<TaskId> emptyTasks = Collections.emptySet();
@@ -761,18 +718,14 @@ public void shouldThrowExceptionIfApplicationServerConfigIsNotHostPortPair() thr
         final StreamsConfig config = new StreamsConfig(properties);
         final UUID uuid1 = UUID.randomUUID();
         final String client1 = "client1";
-        final TopologyBuilder builder = new TopologyBuilder();
         final String applicationId = "application-id";
         builder.setApplicationId(applicationId);
 
-        final MockClientSupplier clientSupplier = new MockClientSupplier();
-
-        final StreamThread streamThread = new StreamThread(builder, config, clientSupplier, applicationId, client1, uuid1,
+        final StreamThread streamThread = new StreamThread(builder, config, mockClientSupplier, applicationId, client1, uuid1,
                                                            new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
                                                            0);
 
-        final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
-        partitionAssignor.setInternalTopicManager(new MockInternalTopicManager(streamThread.config, clientSupplier.restoreConsumer));
+        partitionAssignor.setInternalTopicManager(new MockInternalTopicManager(streamThread.config, mockClientSupplier.restoreConsumer));
 
         try {
             partitionAssignor.configure(config.getConsumerConfigs(streamThread, applicationId, client1));
@@ -790,18 +743,14 @@ public void shouldThrowExceptionIfApplicationServerConfigPortIsNotAnInteger() th
         final StreamsConfig config = new StreamsConfig(properties);
         final UUID uuid1 = UUID.randomUUID();
         final String client1 = "client1";
-        final TopologyBuilder builder = new TopologyBuilder();
         final String applicationId = "application-id";
         builder.setApplicationId(applicationId);
 
-        final MockClientSupplier clientSupplier = new MockClientSupplier();
 
-        final StreamThread streamThread = new StreamThread(builder, config, clientSupplier, applicationId, client1, uuid1,
+        final StreamThread streamThread = new StreamThread(builder, config, mockClientSupplier, applicationId, client1, uuid1,
                                                            new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST),
                                                            0);
 
-        final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
-
         try {
             partitionAssignor.configure(config.getConsumerConfigs(streamThread, applicationId, client1));
             Assert.fail("expected to an exception due to invalid config");
@@ -812,7 +761,6 @@ public void shouldThrowExceptionIfApplicationServerConfigPortIsNotAnInteger() th
 
     @Test
     public void shouldExposeHostStateToTopicPartitionsOnAssignment() throws Exception {
-        final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         List<TopicPartition> topic = Collections.singletonList(new TopicPartition("topic", 0));
         final Map<HostInfo, Set<TopicPartition>> hostState =
                 Collections.singletonMap(new HostInfo("localhost", 80),
@@ -826,8 +774,6 @@ public void shouldExposeHostStateToTopicPartitionsOnAssignment() throws Exceptio
 
     @Test
     public void shouldSetClusterMetadataOnAssignment() throws Exception {
-        final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
-
         final List<TopicPartition> topic = Collections.singletonList(new TopicPartition("topic", 0));
         final Map<HostInfo, Set<TopicPartition>> hostState =
                 Collections.singletonMap(new HostInfo("localhost", 80),
@@ -848,7 +794,6 @@ public void shouldSetClusterMetadataOnAssignment() throws Exception {
 
     @Test
     public void shouldReturnEmptyClusterMetadataIfItHasntBeenBuilt() throws Exception {
-        final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         final Cluster cluster = partitionAssignor.clusterMetadata();
         assertNotNull(cluster);
     }
@@ -916,11 +861,8 @@ public Object apply(Object value1, Object value2) {
         final UUID uuid = UUID.randomUUID();
         final String client = "client1";
 
-        final StreamsConfig config = new StreamsConfig(configProps());
-        final MockClientSupplier mockClientSupplier = new MockClientSupplier();
         final StreamThread streamThread = new StreamThread(builder, config, mockClientSupplier, applicationId, client, uuid, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST), 0);
 
-        final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(streamThread, applicationId, client));
         final MockInternalTopicManager mockInternalTopicManager = new MockInternalTopicManager(streamThread.config, mockClientSupplier.restoreConsumer);
         partitionAssignor.setInternalTopicManager(mockInternalTopicManager);
@@ -954,7 +896,6 @@ public Object apply(Object value1, Object value2) {
 
     @Test
     public void shouldUpdatePartitionHostInfoMapOnAssignment() throws Exception {
-        final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         final TopicPartition partitionOne = new TopicPartition("topic", 1);
         final TopicPartition partitionTwo = new TopicPartition("topic", 2);
         final Map<HostInfo, Set<TopicPartition>> firstHostState = Collections.singletonMap(
@@ -972,7 +913,6 @@ public void shouldUpdatePartitionHostInfoMapOnAssignment() throws Exception {
 
     @Test
     public void shouldUpdateClusterMetadataOnAssignment() throws Exception {
-        final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         final TopicPartition topicOne = new TopicPartition("topic", 1);
         final TopicPartition topicTwo = new TopicPartition("topic2", 2);
         final Map<HostInfo, Set<TopicPartition>> firstHostState = Collections.singletonMap(
@@ -987,15 +927,6 @@ public void shouldUpdateClusterMetadataOnAssignment() throws Exception {
         assertEquals(Utils.mkSet("topic", "topic2"), partitionAssignor.clusterMetadata().topics());
     }
 
-    private PartitionAssignor.Assignment createAssignment(final Map<HostInfo, Set<TopicPartition>> firstHostState) {
-        final AssignmentInfo info = new AssignmentInfo(Collections.<TaskId>emptyList(),
-                                                       Collections.<TaskId, Set<TopicPartition>>emptyMap(),
-                                                       firstHostState);
-
-        return new PartitionAssignor.Assignment(
-                Collections.<TopicPartition>emptyList(), info.encode());
-    }
-
     @Test
     public void shouldNotAddStandbyTaskPartitionsToPartitionsForHost() throws Exception {
         final Properties props = configProps();
@@ -1009,10 +940,8 @@ public void shouldNotAddStandbyTaskPartitionsToPartitionsForHost() throws Except
         final UUID uuid = UUID.randomUUID();
         final String client = "client1";
 
-        final MockClientSupplier mockClientSupplier = new MockClientSupplier();
         final StreamThread streamThread = new StreamThread(builder, config, mockClientSupplier, applicationId, client, uuid, new Metrics(), Time.SYSTEM, new StreamsMetadataState(builder, StreamsMetadataState.UNKNOWN_HOST), 0);
 
-        final StreamPartitionAssignor partitionAssignor = new StreamPartitionAssignor();
         partitionAssignor.configure(config.getConsumerConfigs(streamThread, applicationId, client));
         partitionAssignor.setInternalTopicManager(new MockInternalTopicManager(streamThread.config, mockClientSupplier.restoreConsumer));
 
@@ -1046,6 +975,29 @@ public void shouldNotAddStandbyTaskPartitionsToPartitionsForHost() throws Except
         assertThat(allAssignedPartitions, equalTo(allPartitions));
     }
 
+    @Test(expected = KafkaException.class)
+    public void shouldThrowKafkaExceptionIfStreamThreadNotConfigured() throws Exception {
+        partitionAssignor.configure(Collections.singletonMap(StreamsConfig.NUM_STANDBY_REPLICAS_CONFIG, 1));
+    }
+
+    @Test(expected = KafkaException.class)
+    public void shouldThrowKafkaExceptionIfStreamThreadConfigIsNotStreamThreadInstance() throws Exception {
+        final Map<String, Object> config = new HashMap<>();
+        config.put(StreamsConfig.NUM_STANDBY_REPLICAS_CONFIG, 1);
+        config.put(StreamsConfig.InternalConfig.STREAM_THREAD_INSTANCE, "i am not a stream thread");
+
+        partitionAssignor.configure(config);
+    }
+
+    private PartitionAssignor.Assignment createAssignment(final Map<HostInfo, Set<TopicPartition>> firstHostState) {
+        final AssignmentInfo info = new AssignmentInfo(Collections.<TaskId>emptyList(),
+                                                       Collections.<TaskId, Set<TopicPartition>>emptyMap(),
+                                                       firstHostState);
+
+        return new PartitionAssignor.Assignment(
+                Collections.<TopicPartition>emptyList(), info.encode());
+    }
+
     private AssignmentInfo checkAssignment(Set<String> expectedTopics, PartitionAssignor.Assignment assignment) {
 
         // This assumed 1) DefaultPartitionGrouper is used, and 2) there is a only one topic group.

From 063fe5e8b0e568ea62e13369c94720e3d315fe47 Mon Sep 17 00:00:00 2001
From: Akash Sethi <akash.sethi@knoldus.in>
Date: Fri, 27 Jan 2017 09:45:01 -0800
Subject: [PATCH 069/177] MINOR: Replace for within for each; replace if-elseif
 with match

In some Places for the loop was used but it can be replaced by the for each.
In One file if else if else was used so I replaced the same with match.

Author: Akash Sethi <akash.sethi@knoldus.in>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2435 from akashsethi24/trunk

(cherry picked from commit 9213de8f14dfd2754d913667ae9a703f76277022)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../common/network/ByteBufferReceive.java     |  4 +--
 .../kafka/admin/ConsumerGroupCommand.scala    | 31 ++++++++++---------
 .../internals/KTableKTableJoinTest.java       | 16 +++++-----
 3 files changed, 26 insertions(+), 25 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/common/network/ByteBufferReceive.java b/clients/src/main/java/org/apache/kafka/common/network/ByteBufferReceive.java
index 159c30190e985..307eadf8db6c9 100644
--- a/clients/src/main/java/org/apache/kafka/common/network/ByteBufferReceive.java
+++ b/clients/src/main/java/org/apache/kafka/common/network/ByteBufferReceive.java
@@ -33,8 +33,8 @@ public ByteBufferReceive(String source, ByteBuffer... buffers) {
         super();
         this.source = source;
         this.buffers = buffers;
-        for (int i = 0; i < buffers.length; i++)
-            remaining += buffers[i].remaining();
+        for (ByteBuffer buffer : buffers)
+            remaining += buffer.remaining();
     }
 
     @Override
diff --git a/core/src/main/scala/kafka/admin/ConsumerGroupCommand.scala b/core/src/main/scala/kafka/admin/ConsumerGroupCommand.scala
index d4e407a6d6c73..c3d9f243ff4ab 100755
--- a/core/src/main/scala/kafka/admin/ConsumerGroupCommand.scala
+++ b/core/src/main/scala/kafka/admin/ConsumerGroupCommand.scala
@@ -306,22 +306,23 @@ object ConsumerGroupCommand extends Logging {
       val offsetFetchResponse = OffsetFetchResponse.readFrom(channel.receive().payload())
 
       offsetFetchResponse.requestInfo.foreach { case (topicAndPartition, offsetAndMetadata) =>
-        if (offsetAndMetadata == OffsetMetadataAndError.NoOffset) {
-          val topicDirs = new ZKGroupTopicDirs(group, topicAndPartition.topic)
-          // this group may not have migrated off zookeeper for offsets storage (we don't expose the dual-commit option in this tool
-          // (meaning the lag may be off until all the consumers in the group have the same setting for offsets storage)
-          try {
-            val offset = zkUtils.readData(topicDirs.consumerOffsetDir + "/" + topicAndPartition.partition)._1.toLong
-            offsetMap.put(topicAndPartition, offset)
-          } catch {
-            case z: ZkNoNodeException =>
-              printError(s"Could not fetch offset from zookeeper for group '$group' partition '$topicAndPartition' due to missing offset data in zookeeper.", Some(z))
-          }
+        offsetAndMetadata match {
+          case OffsetMetadataAndError.NoOffset =>
+            val topicDirs = new ZKGroupTopicDirs(group, topicAndPartition.topic)
+            // this group may not have migrated off zookeeper for offsets storage (we don't expose the dual-commit option in this tool
+            // (meaning the lag may be off until all the consumers in the group have the same setting for offsets storage)
+            try {
+              val offset = zkUtils.readData(topicDirs.consumerOffsetDir + "/" + topicAndPartition.partition)._1.toLong
+              offsetMap.put(topicAndPartition, offset)
+            } catch {
+              case z: ZkNoNodeException =>
+                printError(s"Could not fetch offset from zookeeper for group '$group' partition '$topicAndPartition' due to missing offset data in zookeeper.", Some(z))
+            }
+          case offsetAndMetaData if offsetAndMetaData.error == Errors.NONE.code =>
+            offsetMap.put(topicAndPartition, offsetAndMetadata.offset)
+          case _ =>
+            printError(s"Could not fetch offset from kafka for group '$group' partition '$topicAndPartition' due to ${Errors.forCode(offsetAndMetadata.error).exception}.")
         }
-        else if (offsetAndMetadata.error == Errors.NONE.code)
-          offsetMap.put(topicAndPartition, offsetAndMetadata.offset)
-        else
-          printError(s"Could not fetch offset from kafka for group '$group' partition '$topicAndPartition' due to ${Errors.forCode(offsetAndMetadata.error).exception}.")
       }
       channel.disconnect()
       offsetMap.toMap
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableJoinTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableJoinTest.java
index 4bb64b87d363b..a938605ef4ef8 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableJoinTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableJoinTest.java
@@ -119,8 +119,8 @@ public void testJoin() throws Exception {
 
         // push all four items to the primary stream. this should produce two items.
 
-        for (int i = 0; i < expectedKeys.length; i++) {
-            driver.process(topic1, expectedKeys[i], "XX" + expectedKeys[i]);
+        for (int expectedKey : expectedKeys) {
+            driver.process(topic1, expectedKey, "XX" + expectedKey);
         }
         driver.flushState();
 
@@ -128,8 +128,8 @@ public void testJoin() throws Exception {
         checkJoinedValues(getter, kv(0, "XX0+Y0"), kv(1, "XX1+Y1"));
 
         // push all items to the other stream. this should produce four items.
-        for (int i = 0; i < expectedKeys.length; i++) {
-            driver.process(topic2, expectedKeys[i], "YY" + expectedKeys[i]);
+        for (int expectedKey : expectedKeys) {
+            driver.process(topic2, expectedKey, "YY" + expectedKey);
         }
         driver.flushState();
 
@@ -138,8 +138,8 @@ public void testJoin() throws Exception {
 
         // push all four items to the primary stream. this should produce four items.
 
-        for (int i = 0; i < expectedKeys.length; i++) {
-            driver.process(topic1, expectedKeys[i], "X" + expectedKeys[i]);
+        for (int expectedKey : expectedKeys) {
+            driver.process(topic1, expectedKey, "X" + expectedKey);
         }
         driver.flushState();
 
@@ -311,8 +311,8 @@ public void testSendingOldValues() throws Exception {
 
         // push all four items to the primary stream. this should produce four items.
 
-        for (int i = 0; i < expectedKeys.length; i++) {
-            driver.process(topic1, expectedKeys[i], "X" + expectedKeys[i]);
+        for (int expectedKey : expectedKeys) {
+            driver.process(topic1, expectedKey, "X" + expectedKey);
         }
         driver.flushState();
         proc.checkAndClearProcessResult("0:(X0+YY0<-XX0+YY0)", "1:(X1+YY1<-XX1+YY1)", "2:(X2+YY2<-XX2+YY2)", "3:(X3+YY3<-XX3+YY3)");

From f328f77fd359c7fbb9e14ca31f8986c6a21af481 Mon Sep 17 00:00:00 2001
From: Jason Gustafson <jason@confluent.io>
Date: Fri, 27 Jan 2017 20:30:00 +0000
Subject: [PATCH 070/177] KAFKA-4704; Coordinator cache loading fails if
 groupId is reused for offset storage after group is removed

Author: Jason Gustafson <jason@confluent.io>

Reviewers: Guozhang Wang <wangguoz@gmail.com>, Ismael Juma <ismael@juma.me.uk>

Closes #2455 from hachikuji/KAFKA-4704

(cherry picked from commit 57f0cb29973bb40e76ed6deb64b934b4b2e0592a)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../kafka/coordinator/GroupCoordinator.scala  |   2 +-
 .../kafka/coordinator/GroupMetadata.scala     |   6 +-
 .../coordinator/GroupMetadataManager.scala    | 220 +++++++++---------
 core/src/main/scala/kafka/log/Log.scala       |   2 +-
 .../src/main/scala/kafka/log/LogManager.scala |  44 ++--
 .../scala/kafka/server/ReplicaManager.scala   |  12 +-
 .../GroupMetadataManagerTest.scala            | 215 +++++++++++++++--
 .../kafka/coordinator/GroupMetadataTest.scala |  16 +-
 .../kafka/producer/AsyncProducerTest.scala    |   3 +-
 .../scala/unit/kafka/utils/TestUtils.scala    |   5 +
 10 files changed, 358 insertions(+), 167 deletions(-)

diff --git a/core/src/main/scala/kafka/coordinator/GroupCoordinator.scala b/core/src/main/scala/kafka/coordinator/GroupCoordinator.scala
index c7edcefc1057e..36b0c865f4620 100644
--- a/core/src/main/scala/kafka/coordinator/GroupCoordinator.scala
+++ b/core/src/main/scala/kafka/coordinator/GroupCoordinator.scala
@@ -621,7 +621,7 @@ class GroupCoordinator(val brokerId: Int,
     val member = new MemberMetadata(memberId, group.groupId, clientId, clientHost, rebalanceTimeoutMs,
       sessionTimeoutMs, protocolType, protocols)
     member.awaitingJoinCallback = callback
-    group.add(member.memberId, member)
+    group.add(member)
     maybePrepareRebalance(group)
     member
   }
diff --git a/core/src/main/scala/kafka/coordinator/GroupMetadata.scala b/core/src/main/scala/kafka/coordinator/GroupMetadata.scala
index 0e49995fa5e06..4ea5bdda76261 100644
--- a/core/src/main/scala/kafka/coordinator/GroupMetadata.scala
+++ b/core/src/main/scala/kafka/coordinator/GroupMetadata.scala
@@ -158,7 +158,7 @@ private[coordinator] class GroupMetadata(val groupId: String, initialState: Grou
   def has(memberId: String) = members.contains(memberId)
   def get(memberId: String) = members(memberId)
 
-  def add(memberId: String, member: MemberMetadata) {
+  def add(member: MemberMetadata) {
     if (members.isEmpty)
       this.protocolType = Some(member.protocolType)
 
@@ -167,8 +167,8 @@ private[coordinator] class GroupMetadata(val groupId: String, initialState: Grou
     assert(supportsProtocols(member.protocols))
 
     if (leaderId == null)
-      leaderId = memberId
-    members.put(memberId, member)
+      leaderId = member.memberId
+    members.put(member.memberId, member)
   }
 
   def remove(memberId: String) {
diff --git a/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala b/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
index 45ed77b9069db..c66ce7496ace5 100644
--- a/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
+++ b/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
@@ -235,7 +235,7 @@ class GroupMetadataManager(val brokerId: Int,
       case Some((magicValue, timestampType, timestamp)) =>
         val records = filteredOffsetMetadata.map { case (topicPartition, offsetAndMetadata) =>
           Record.create(magicValue, timestampType, timestamp,
-            GroupMetadataManager.offsetCommitKey(group.groupId, topicPartition.topic, topicPartition.partition),
+            GroupMetadataManager.offsetCommitKey(group.groupId, topicPartition),
             GroupMetadataManager.offsetCommitValue(offsetAndMetadata))
         }.toSeq
 
@@ -367,115 +367,128 @@ class GroupMetadataManager(val brokerId: Int,
   /**
    * Asynchronously read the partition from the offsets topic and populate the cache
    */
-  def loadGroupsForPartition(offsetsPartition: Int,
-                             onGroupLoaded: GroupMetadata => Unit) {
+  def loadGroupsForPartition(offsetsPartition: Int, onGroupLoaded: GroupMetadata => Unit) {
     val topicPartition = new TopicPartition(Topic.GroupMetadataTopicName, offsetsPartition)
-    scheduler.schedule(topicPartition.toString, loadGroupsAndOffsets)
 
-    def loadGroupsAndOffsets() {
-      info("Loading offsets and group metadata from " + topicPartition)
+    def doLoadGroupsAndOffsets() {
+      info(s"Loading offsets and group metadata from $topicPartition")
 
       inLock(partitionLock) {
         if (loadingPartitions.contains(offsetsPartition)) {
-          info("Offset load from %s already in progress.".format(topicPartition))
+          info(s"Offset load from $topicPartition already in progress.")
           return
         } else {
           loadingPartitions.add(offsetsPartition)
         }
       }
 
-      val startMs = time.milliseconds()
       try {
-        replicaManager.logManager.getLog(topicPartition) match {
-          case Some(log) =>
-            var currOffset = log.logSegments.head.baseOffset
-            val buffer = ByteBuffer.allocate(config.loadBufferSize)
-            // loop breaks if leader changes at any time during the load, since getHighWatermark is -1
-            val loadedOffsets = mutable.Map[GroupTopicPartition, OffsetAndMetadata]()
-            val removedOffsets = mutable.Set[GroupTopicPartition]()
-            val loadedGroups = mutable.Map[String, GroupMetadata]()
-            val removedGroups = mutable.Set[String]()
-
-            while (currOffset < getHighWatermark(offsetsPartition) && !shuttingDown.get()) {
-              buffer.clear()
-              val fileRecords = log.read(currOffset, config.loadBufferSize, minOneMessage = true).records.asInstanceOf[FileRecords]
-              fileRecords.readInto(buffer, 0)
-
-              MemoryRecords.readableRecords(buffer).deepEntries.asScala.foreach { entry =>
-                val record = entry.record
-
-                require(record.hasKey, "Offset entry key should not be null")
-                val baseKey = GroupMetadataManager.readMessageKey(record.key)
-
-                if (baseKey.isInstanceOf[OffsetKey]) {
-                  // load offset
-                  val key = baseKey.key.asInstanceOf[GroupTopicPartition]
-                  if (record.hasNullValue) {
-                    loadedOffsets.remove(key)
-                    removedOffsets.add(key)
-                  } else {
-                    val value = GroupMetadataManager.readOffsetMessageValue(record.value)
-                    loadedOffsets.put(key, value)
-                    removedOffsets.remove(key)
-                  }
+        loadGroupsAndOffsets(topicPartition, onGroupLoaded)
+      } catch {
+        case t: Throwable => error(s"Error loading offsets from $topicPartition", t)
+      } finally {
+        inLock(partitionLock) {
+          ownedPartitions.add(offsetsPartition)
+          loadingPartitions.remove(offsetsPartition)
+        }
+      }
+    }
+
+    scheduler.schedule(topicPartition.toString, doLoadGroupsAndOffsets)
+  }
+
+  private[coordinator] def loadGroupsAndOffsets(topicPartition: TopicPartition, onGroupLoaded: GroupMetadata => Unit) {
+    def highWaterMark = replicaManager.getHighWatermark(topicPartition).getOrElse(-1L)
+
+    val startMs = time.milliseconds()
+    replicaManager.getLog(topicPartition) match {
+      case None =>
+        warn(s"Attempted to load offsets and group metadata from $topicPartition, but found no log")
+
+      case Some(log) =>
+        var currOffset = log.logStartOffset
+        val buffer = ByteBuffer.allocate(config.loadBufferSize)
+        // loop breaks if leader changes at any time during the load, since getHighWatermark is -1
+        val loadedOffsets = mutable.Map[GroupTopicPartition, OffsetAndMetadata]()
+        val removedOffsets = mutable.Set[GroupTopicPartition]()
+        val loadedGroups = mutable.Map[String, GroupMetadata]()
+        val removedGroups = mutable.Set[String]()
+
+        while (currOffset < highWaterMark && !shuttingDown.get()) {
+          buffer.clear()
+          val fileRecords = log.read(currOffset, config.loadBufferSize, maxOffset = None, minOneMessage = true)
+            .records.asInstanceOf[FileRecords]
+          val bufferRead = fileRecords.readInto(buffer, 0)
+
+          MemoryRecords.readableRecords(bufferRead).deepEntries.asScala.foreach { entry =>
+            val record = entry.record
+            require(record.hasKey, "Group metadata/offset entry key should not be null")
+
+            GroupMetadataManager.readMessageKey(record.key) match {
+              case offsetKey: OffsetKey =>
+                // load offset
+                val key = offsetKey.key
+                if (record.hasNullValue) {
+                  loadedOffsets.remove(key)
+                  removedOffsets.add(key)
                 } else {
-                  // load group metadata
-                  val groupId = baseKey.key.asInstanceOf[String]
-                  val groupMetadata = GroupMetadataManager.readGroupMessageValue(groupId, record.value)
-                  if (groupMetadata != null) {
-                    trace(s"Loaded group metadata for group ${groupMetadata.groupId} with generation ${groupMetadata.generationId}")
-                    removedGroups.remove(groupId)
-                    loadedGroups.put(groupId, groupMetadata)
-                  } else {
-                    loadedGroups.remove(groupId)
-                    removedGroups.add(groupId)
-                  }
+                  val value = GroupMetadataManager.readOffsetMessageValue(record.value)
+                  loadedOffsets.put(key, value)
+                  removedOffsets.remove(key)
                 }
 
-                currOffset = entry.nextOffset
-              }
-            }
-
-            val (groupOffsets, noGroupOffsets) = loadedOffsets
-              .groupBy(_._1.group)
-              .mapValues(_.map{ case (groupTopicPartition, offsetAndMetadata) => (groupTopicPartition.topicPartition, offsetAndMetadata)})
-              .partition(value => loadedGroups.contains(value._1))
+              case groupMetadataKey: GroupMetadataKey =>
+                // load group metadata
+                val groupId = groupMetadataKey.key
+                val groupMetadata = GroupMetadataManager.readGroupMessageValue(groupId, record.value)
+                if (groupMetadata != null) {
+                  trace(s"Loaded group metadata for group $groupId with generation ${groupMetadata.generationId}")
+                  removedGroups.remove(groupId)
+                  loadedGroups.put(groupId, groupMetadata)
+                } else {
+                  loadedGroups.remove(groupId)
+                  removedGroups.add(groupId)
+                }
 
-            loadedGroups.values.foreach { group =>
-              val offsets = groupOffsets.getOrElse(group.groupId, Map.empty[TopicPartition, OffsetAndMetadata])
-              loadGroup(group, offsets)
-              onGroupLoaded(group)
+              case unknownKey =>
+                throw new IllegalStateException(s"Unexpected message key $unknownKey while loading offsets and group metadata")
             }
 
-            noGroupOffsets.foreach { case (groupId, offsets) =>
-              val group = new GroupMetadata(groupId)
-              loadGroup(group, offsets)
-              onGroupLoaded(group)
-            }
+            currOffset = entry.nextOffset
+          }
+        }
 
-            removedGroups.foreach { groupId =>
-              if (groupMetadataCache.contains(groupId))
-                throw new IllegalStateException(s"Unexpected unload of active group $groupId while " +
-                  s"loading partition $topicPartition")
-            }
+        val (groupOffsets, emptyGroupOffsets) = loadedOffsets
+          .groupBy(_._1.group)
+          .mapValues(_.map { case (groupTopicPartition, offset) => (groupTopicPartition.topicPartition, offset)} )
+          .partition { case (group, _) => loadedGroups.contains(group) }
 
-            if (!shuttingDown.get())
-              info("Finished loading offsets from %s in %d milliseconds."
-                .format(topicPartition, time.milliseconds() - startMs))
-          case None =>
-            warn("No log found for " + topicPartition)
+        loadedGroups.values.foreach { group =>
+          val offsets = groupOffsets.getOrElse(group.groupId, Map.empty[TopicPartition, OffsetAndMetadata])
+          loadGroup(group, offsets)
+          onGroupLoaded(group)
         }
-      }
-      catch {
-        case t: Throwable =>
-          error("Error in loading offsets from " + topicPartition, t)
-      }
-      finally {
-        inLock(partitionLock) {
-          ownedPartitions.add(offsetsPartition)
-          loadingPartitions.remove(offsetsPartition)
+
+        // load groups which store offsets in kafka, but which have no active members and thus no group
+        // metadata stored in the log
+        emptyGroupOffsets.foreach { case (groupId, offsets) =>
+          val group = new GroupMetadata(groupId)
+          loadGroup(group, offsets)
+          onGroupLoaded(group)
         }
-      }
+
+        removedGroups.foreach { groupId =>
+          // if the cache already contains a group which should be removed, raise an error. Note that it
+          // is possible (however unlikely) for a consumer group to be removed, and then to be used only for
+          // offset storage (i.e. by "simple" consumers)
+          if (groupMetadataCache.contains(groupId) && !emptyGroupOffsets.contains(groupId))
+            throw new IllegalStateException(s"Unexpected unload of active group $groupId while " +
+              s"loading partition $topicPartition")
+        }
+
+        if (!shuttingDown.get())
+          info("Finished loading offsets from %s in %d milliseconds."
+            .format(topicPartition, time.milliseconds() - startMs))
     }
   }
 
@@ -568,7 +581,7 @@ class GroupMetadataManager(val brokerId: Int,
           partitionOpt.foreach { partition =>
             val tombstones = removedOffsets.map { case (topicPartition, offsetAndMetadata) =>
               trace(s"Removing expired/deleted offset and metadata for $groupId, $topicPartition: $offsetAndMetadata")
-              val commitKey = GroupMetadataManager.offsetCommitKey(groupId, topicPartition.topic, topicPartition.partition)
+              val commitKey = GroupMetadataManager.offsetCommitKey(groupId, topicPartition)
               Record.create(magicValue, timestampType, timestamp, commitKey, null)
             }.toBuffer
             trace(s"Marked ${removedOffsets.size} offsets in $appendPartition for deletion.")
@@ -606,16 +619,6 @@ class GroupMetadataManager(val brokerId: Int,
     info(s"Removed $offsetsRemoved expired offsets in ${time.milliseconds() - startMs} milliseconds.")
   }
 
-  private def getHighWatermark(partitionId: Int): Long = {
-    val partitionOpt = replicaManager.getPartition(new TopicPartition(Topic.GroupMetadataTopicName, partitionId))
-
-    val hw = partitionOpt.map { partition =>
-      partition.leaderReplicaIfLocal.map(_.highWatermark.messageOffset).getOrElse(-1L)
-    }.getOrElse(-1L)
-
-    hw
-  }
-
   /*
    * Check if the offset metadata length is valid
    */
@@ -816,11 +819,12 @@ object GroupMetadataManager {
    *
    * @return key for offset commit message
    */
-  private def offsetCommitKey(group: String, topic: String, partition: Int, versionId: Short = 0): Array[Byte] = {
+  private[coordinator] def offsetCommitKey(group: String, topicPartition: TopicPartition,
+                                           versionId: Short = 0): Array[Byte] = {
     val key = new Struct(CURRENT_OFFSET_KEY_SCHEMA)
     key.set(OFFSET_KEY_GROUP_FIELD, group)
-    key.set(OFFSET_KEY_TOPIC_FIELD, topic)
-    key.set(OFFSET_KEY_PARTITION_FIELD, partition)
+    key.set(OFFSET_KEY_TOPIC_FIELD, topicPartition.topic)
+    key.set(OFFSET_KEY_PARTITION_FIELD, topicPartition.partition)
 
     val byteBuffer = ByteBuffer.allocate(2 /* version */ + key.sizeOf)
     byteBuffer.putShort(CURRENT_OFFSET_KEY_SCHEMA_VERSION)
@@ -833,7 +837,7 @@ object GroupMetadataManager {
    *
    * @return key bytes for group metadata message
    */
-  def groupMetadataKey(group: String): Array[Byte] = {
+  private[coordinator] def groupMetadataKey(group: String): Array[Byte] = {
     val key = new Struct(CURRENT_GROUP_KEY_SCHEMA)
     key.set(GROUP_KEY_GROUP_FIELD, group)
 
@@ -849,7 +853,7 @@ object GroupMetadataManager {
    * @param offsetAndMetadata consumer's current offset and metadata
    * @return payload for offset commit message
    */
-  private def offsetCommitValue(offsetAndMetadata: OffsetAndMetadata): Array[Byte] = {
+  private[coordinator] def offsetCommitValue(offsetAndMetadata: OffsetAndMetadata): Array[Byte] = {
     // generate commit value with schema version 1
     val value = new Struct(CURRENT_OFFSET_VALUE_SCHEMA)
     value.set(OFFSET_VALUE_OFFSET_FIELD_V1, offsetAndMetadata.offset)
@@ -871,9 +875,9 @@ object GroupMetadataManager {
    * @param version the version of the value message to use
    * @return payload for offset commit message
    */
-  def groupMetadataValue(groupMetadata: GroupMetadata,
-                         assignment: Map[String, Array[Byte]],
-                         version: Short = 0): Array[Byte] = {
+  private[coordinator] def groupMetadataValue(groupMetadata: GroupMetadata,
+                                              assignment: Map[String, Array[Byte]],
+                                              version: Short = 0): Array[Byte] = {
     val value = if (version == 0) new Struct(GROUP_METADATA_VALUE_SCHEMA_V0) else new Struct(CURRENT_GROUP_VALUE_SCHEMA)
 
     value.set(PROTOCOL_TYPE_KEY, groupMetadata.protocolType.getOrElse(""))
@@ -1013,7 +1017,7 @@ object GroupMetadataManager {
 
           member.assignment = Utils.toArray(memberMetadata.get(ASSIGNMENT_KEY).asInstanceOf[ByteBuffer])
 
-          group.add(memberId, member)
+          group.add(member)
         }
 
         group
diff --git a/core/src/main/scala/kafka/log/Log.scala b/core/src/main/scala/kafka/log/Log.scala
index 8dea5ca25c08e..25bb83d3f074f 100644
--- a/core/src/main/scala/kafka/log/Log.scala
+++ b/core/src/main/scala/kafka/log/Log.scala
@@ -316,7 +316,7 @@ class Log(@volatile var dir: File,
   /**
    * Check if we have the "clean shutdown" file
    */
-  private def hasCleanShutdownFile() = new File(dir.getParentFile, CleanShutdownFile).exists()
+  private def hasCleanShutdownFile = new File(dir.getParentFile, CleanShutdownFile).exists()
 
   /**
    * The number of segments in the log.
diff --git a/core/src/main/scala/kafka/log/LogManager.scala b/core/src/main/scala/kafka/log/LogManager.scala
index 8cd9b34f6e5f8..761edf9ac762c 100755
--- a/core/src/main/scala/kafka/log/LogManager.scala
+++ b/core/src/main/scala/kafka/log/LogManager.scala
@@ -349,13 +349,7 @@ class LogManager(val logDirs: Array[File],
   /**
    * Get the log if it exists, otherwise return None
    */
-  def getLog(topicPartition: TopicPartition): Option[Log] = {
-    val log = logs.get(topicPartition)
-    if (log == null)
-      None
-    else
-      Some(log)
-  }
+  def getLog(topicPartition: TopicPartition): Option[Log] = Option(logs.get(topicPartition))
 
   /**
    * Create a log for the given topic and the given partition
@@ -363,28 +357,20 @@ class LogManager(val logDirs: Array[File],
    */
   def createLog(topicPartition: TopicPartition, config: LogConfig): Log = {
     logCreationOrDeletionLock synchronized {
-      var log = logs.get(topicPartition)
-      
-      // check if the log has already been created in another thread
-      if(log != null)
-        return log
-      
-      // if not, create it
-      val dataDir = nextLogDir()
-      val dir = new File(dataDir, topicPartition.topic + "-" + topicPartition.partition)
-      dir.mkdirs()
-      log = new Log(dir, 
-                    config,
-                    recoveryPoint = 0L,
-                    scheduler,
-                    time)
-      logs.put(topicPartition, log)
-      info("Created log for partition [%s,%d] in %s with properties {%s}."
-           .format(topicPartition.topic,
-                   topicPartition.partition,
-                   dataDir.getAbsolutePath,
-                   config.originals.asScala.mkString(", ")))
-      log
+      // create the log if it has not already been created in another thread
+      getLog(topicPartition).getOrElse {
+        val dataDir = nextLogDir()
+        val dir = new File(dataDir, topicPartition.topic + "-" + topicPartition.partition)
+        dir.mkdirs()
+        val log = new Log(dir, config, recoveryPoint = 0L, scheduler, time)
+        logs.put(topicPartition, log)
+        info("Created log for partition [%s,%d] in %s with properties {%s}."
+          .format(topicPartition.topic,
+            topicPartition.partition,
+            dataDir.getAbsolutePath,
+            config.originals.asScala.mkString(", ")))
+        log
+      }
     }
   }
 
diff --git a/core/src/main/scala/kafka/server/ReplicaManager.scala b/core/src/main/scala/kafka/server/ReplicaManager.scala
index dd8fc03a798c9..1aa88a2bb6005 100644
--- a/core/src/main/scala/kafka/server/ReplicaManager.scala
+++ b/core/src/main/scala/kafka/server/ReplicaManager.scala
@@ -25,7 +25,7 @@ import kafka.api._
 import kafka.cluster.{Partition, Replica}
 import kafka.common._
 import kafka.controller.KafkaController
-import kafka.log.{LogAppendInfo, LogManager}
+import kafka.log.{Log, LogAppendInfo, LogManager}
 import kafka.metrics.KafkaMetricsGroup
 import kafka.server.QuotaFactory.UnboundedQuota
 import kafka.utils._
@@ -189,6 +189,8 @@ class ReplicaManager(val config: KafkaConfig,
     }
   }
 
+  def getLog(topicPartition: TopicPartition): Option[Log] = logManager.getLog(topicPartition)
+
   /**
    * Try to complete some delayed produce requests with the request key;
    * this can be triggered when:
@@ -926,10 +928,16 @@ class ReplicaManager(val config: KafkaConfig,
     }
   }
 
-  private def getLeaderPartitions() : List[Partition] = {
+  private def getLeaderPartitions(): List[Partition] = {
     allPartitions.values.filter(_.leaderReplicaIfLocal.isDefined).toList
   }
 
+  def getHighWatermark(topicPartition: TopicPartition): Option[Long] = {
+    getPartition(topicPartition).flatMap { partition =>
+      partition.leaderReplicaIfLocal.map(_.highWatermark.messageOffset)
+    }
+  }
+
   // Flushes the highwatermark value for all partitions to the highwatermark file
   def checkpointHighWatermarks() {
     val replicas = allPartitions.values.flatMap(_.getReplica(localBrokerId))
diff --git a/core/src/test/scala/unit/kafka/coordinator/GroupMetadataManagerTest.scala b/core/src/test/scala/unit/kafka/coordinator/GroupMetadataManagerTest.scala
index 9478122ffbc7d..30dfc6366c4d0 100644
--- a/core/src/test/scala/unit/kafka/coordinator/GroupMetadataManagerTest.scala
+++ b/core/src/test/scala/unit/kafka/coordinator/GroupMetadataManagerTest.scala
@@ -17,20 +17,23 @@
 
 package kafka.coordinator
 
+import java.nio.ByteBuffer
+
 import kafka.api.ApiVersion
 import kafka.cluster.Partition
 import kafka.common.{OffsetAndMetadata, Topic}
-import kafka.log.LogAppendInfo
-import kafka.server.{KafkaConfig, ReplicaManager}
+import kafka.log.{Log, LogAppendInfo}
+import kafka.server.{FetchDataInfo, KafkaConfig, LogOffsetMetadata, ReplicaManager}
 import kafka.utils.{KafkaScheduler, MockTime, TestUtils, ZkUtils}
 import org.apache.kafka.common.TopicPartition
 import org.apache.kafka.common.protocol.Errors
-import org.apache.kafka.common.record.{MemoryRecords, Record, TimestampType}
+import org.apache.kafka.common.record.{FileRecords, MemoryRecords, Record, TimestampType}
 import org.apache.kafka.common.requests.OffsetFetchResponse
 import org.apache.kafka.common.requests.ProduceResponse.PartitionResponse
 import org.easymock.{Capture, EasyMock, IAnswer}
-import org.junit.{After, Before, Test}
-import org.junit.Assert._
+import org.junit.{Before, Test}
+import org.junit.Assert.{assertEquals, assertFalse, assertTrue}
+import kafka.utils.TestUtils.fail
 
 import scala.collection._
 import JavaConverters._
@@ -79,10 +82,153 @@ class GroupMetadataManagerTest {
     partition = EasyMock.niceMock(classOf[Partition])
   }
 
-  @After
-  def tearDown() {
-    EasyMock.reset(replicaManager)
-    EasyMock.reset(partition)
+  @Test
+  def testLoadOffsetsWithoutGroup() {
+    val groupMetadataTopicPartition = new TopicPartition(Topic.GroupMetadataTopicName, groupPartitionId)
+    val startOffset = 15L
+
+    val committedOffsets = Map(
+      new TopicPartition("foo", 0) -> 23L,
+      new TopicPartition("foo", 1) -> 455L,
+      new TopicPartition("bar", 0) -> 8992L
+    )
+
+    val offsetCommitRecords = createCommittedOffsetRecords(committedOffsets)
+    val records = MemoryRecords.withRecords(startOffset, offsetCommitRecords: _*)
+    expectGroupMetadataLoad(groupMetadataTopicPartition, startOffset, records)
+
+    EasyMock.replay(replicaManager)
+    
+    groupMetadataManager.loadGroupsAndOffsets(groupMetadataTopicPartition, _ => ())
+
+    val group = groupMetadataManager.getGroup(groupId).getOrElse(fail("Group was not loaded into the cache"))
+    assertEquals(groupId, group.groupId)
+    assertEquals(Empty, group.currentState)
+    assertEquals(committedOffsets.size, group.allOffsets.size)
+    committedOffsets.foreach { case (topicPartition, offset) =>
+      assertEquals(Some(offset), group.offset(topicPartition).map(_.offset))
+    }
+  }
+
+  @Test
+  def testLoadOffsetsWithTombstones() {
+    val groupMetadataTopicPartition = new TopicPartition(Topic.GroupMetadataTopicName, groupPartitionId)
+    val startOffset = 15L
+
+    val tombstonePartition = new TopicPartition("foo", 1)
+    val committedOffsets = Map(
+      new TopicPartition("foo", 0) -> 23L,
+      tombstonePartition -> 455L,
+      new TopicPartition("bar", 0) -> 8992L
+    )
+
+    val offsetCommitRecords = createCommittedOffsetRecords(committedOffsets)
+    val tombstone = Record.create(GroupMetadataManager.offsetCommitKey(groupId, tombstonePartition), null)
+    val records = MemoryRecords.withRecords(startOffset, offsetCommitRecords ++ Seq(tombstone): _*)
+
+    expectGroupMetadataLoad(groupMetadataTopicPartition, startOffset, records)
+
+    EasyMock.replay(replicaManager)
+
+    groupMetadataManager.loadGroupsAndOffsets(groupMetadataTopicPartition, _ => ())
+
+    val group = groupMetadataManager.getGroup(groupId).getOrElse(fail("Group was not loaded into the cache"))
+    assertEquals(groupId, group.groupId)
+    assertEquals(Empty, group.currentState)
+    assertEquals(committedOffsets.size - 1, group.allOffsets.size)
+    committedOffsets.foreach { case (topicPartition, offset) =>
+      if (topicPartition == tombstonePartition)
+        assertEquals(None, group.offset(topicPartition))
+      else
+        assertEquals(Some(offset), group.offset(topicPartition).map(_.offset))
+    }
+  }
+
+  @Test
+  def testLoadOffsetsAndGroup() {
+    val groupMetadataTopicPartition = new TopicPartition(Topic.GroupMetadataTopicName, groupPartitionId)
+    val startOffset = 15L
+    val committedOffsets = Map(
+      new TopicPartition("foo", 0) -> 23L,
+      new TopicPartition("foo", 1) -> 455L,
+      new TopicPartition("bar", 0) -> 8992L
+    )
+
+    val offsetCommitRecords = createCommittedOffsetRecords(committedOffsets)
+    val memberId = "98098230493"
+    val groupMetadataRecord = buildStableGroupRecordWithMember(memberId)
+    val records = MemoryRecords.withRecords(startOffset, offsetCommitRecords ++ Seq(groupMetadataRecord): _*)
+
+    expectGroupMetadataLoad(groupMetadataTopicPartition, startOffset, records)
+
+    EasyMock.replay(replicaManager)
+
+    groupMetadataManager.loadGroupsAndOffsets(groupMetadataTopicPartition, _ => ())
+
+    val group = groupMetadataManager.getGroup(groupId).getOrElse(fail("Group was not loaded into the cache"))
+    assertEquals(groupId, group.groupId)
+    assertEquals(Stable, group.currentState)
+    assertEquals(memberId, group.leaderId)
+    assertEquals(Set(memberId), group.allMembers)
+    assertEquals(committedOffsets.size, group.allOffsets.size)
+    committedOffsets.foreach { case (topicPartition, offset) =>
+      assertEquals(Some(offset), group.offset(topicPartition).map(_.offset))
+    }
+  }
+
+  @Test
+  def testLoadGroupWithTombstone() {
+    val groupMetadataTopicPartition = new TopicPartition(Topic.GroupMetadataTopicName, groupPartitionId)
+    val startOffset = 15L
+
+    val memberId = "98098230493"
+    val groupMetadataRecord = buildStableGroupRecordWithMember(memberId)
+    val groupMetadataTombstone = Record.create(GroupMetadataManager.groupMetadataKey(groupId), null)
+    val records = MemoryRecords.withRecords(startOffset, Seq(groupMetadataRecord, groupMetadataTombstone): _*)
+
+    expectGroupMetadataLoad(groupMetadataTopicPartition, startOffset, records)
+
+    EasyMock.replay(replicaManager)
+
+    groupMetadataManager.loadGroupsAndOffsets(groupMetadataTopicPartition, _ => ())
+
+    assertEquals(None, groupMetadataManager.getGroup(groupId))
+  }
+
+  @Test
+  def testOffsetWriteAfterGroupRemoved(): Unit = {
+    // this test case checks the following scenario:
+    // 1. the group exists at some point in time, but is later removed (because all members left)
+    // 2. a "simple" consumer (i.e. not a consumer group) then uses the same groupId to commit some offsets
+
+    val groupMetadataTopicPartition = new TopicPartition(Topic.GroupMetadataTopicName, groupPartitionId)
+    val startOffset = 15L
+
+    val committedOffsets = Map(
+      new TopicPartition("foo", 0) -> 23L,
+      new TopicPartition("foo", 1) -> 455L,
+      new TopicPartition("bar", 0) -> 8992L
+    )
+    val offsetCommitRecords = createCommittedOffsetRecords(committedOffsets)
+    val memberId = "98098230493"
+    val groupMetadataRecord = buildStableGroupRecordWithMember(memberId)
+    val groupMetadataTombstone = Record.create(GroupMetadataManager.groupMetadataKey(groupId), null)
+    val records = MemoryRecords.withRecords(startOffset,
+      Seq(groupMetadataRecord, groupMetadataTombstone) ++ offsetCommitRecords: _*)
+
+    expectGroupMetadataLoad(groupMetadataTopicPartition, startOffset, records)
+
+    EasyMock.replay(replicaManager)
+
+    groupMetadataManager.loadGroupsAndOffsets(groupMetadataTopicPartition, _ => ())
+
+    val group = groupMetadataManager.getGroup(groupId).getOrElse(TestUtils.fail("Group was not loaded into the cache"))
+    assertEquals(groupId, group.groupId)
+    assertEquals(Empty, group.currentState)
+    assertEquals(committedOffsets.size, group.allOffsets.size)
+    committedOffsets.foreach { case (topicPartition, offset) =>
+      assertEquals(Some(offset), group.offset(topicPartition).map(_.offset))
+    }
   }
 
   @Test
@@ -156,7 +302,7 @@ class GroupMetadataManagerTest {
     val member = new MemberMetadata(memberId, groupId, clientId, clientHost, rebalanceTimeout, sessionTimeout,
       protocolType, List(("protocol", Array[Byte]())))
     member.awaitingJoinCallback = _ => ()
-    group.add(memberId, member)
+    group.add(member)
     group.transitionTo(PreparingRebalance)
     group.initNextGeneration()
 
@@ -185,7 +331,7 @@ class GroupMetadataManagerTest {
     val member = new MemberMetadata(memberId, groupId, clientId, clientHost, rebalanceTimeout, sessionTimeout,
       protocolType, List(("protocol", Array[Byte]())))
     member.awaitingJoinCallback = _ => ()
-    group.add(memberId, member)
+    group.add(member)
     group.transitionTo(PreparingRebalance)
     group.initNextGeneration()
 
@@ -264,7 +410,7 @@ class GroupMetadataManagerTest {
       commitErrors = Some(errors)
     }
 
-    val delayedStoreOpt = groupMetadataManager.prepareStoreOffsets(group, memberId, generationId, offsets, callback)
+    groupMetadataManager.prepareStoreOffsets(group, memberId, generationId, offsets, callback)
 
     assertFalse(commitErrors.isEmpty)
     val maybeError = commitErrors.get.get(topicPartition)
@@ -557,7 +703,7 @@ class GroupMetadataManagerTest {
     val member = new MemberMetadata(memberId, groupId, clientId, clientHost, rebalanceTimeout, sessionTimeout,
       protocolType, List(("protocol", Array[Byte]())))
     member.awaitingJoinCallback = _ => ()
-    group.add(memberId, member)
+    group.add(member)
     group.transitionTo(PreparingRebalance)
     group.initNextGeneration()
 
@@ -620,4 +766,47 @@ class GroupMetadataManagerTest {
       .andStubReturn(Some(Record.MAGIC_VALUE_V1, TimestampType.CREATE_TIME))
   }
 
+  private def buildStableGroupRecordWithMember(memberId: String): Record = {
+    val group = new GroupMetadata(groupId)
+    group.transitionTo(PreparingRebalance)
+    val memberProtocols = List(("roundrobin", Array.emptyByteArray))
+    val member = new MemberMetadata(memberId, groupId, "clientId", "clientHost", 30000, 10000, "consumer", memberProtocols)
+    group.add(member)
+    member.awaitingJoinCallback = _ => {}
+    group.initNextGeneration()
+    group.transitionTo(Stable)
+
+    val groupMetadataKey = GroupMetadataManager.groupMetadataKey(groupId)
+    val groupMetadataValue = GroupMetadataManager.groupMetadataValue(group, Map(memberId -> Array.empty[Byte]))
+    Record.create(groupMetadataKey, groupMetadataValue)
+  }
+
+  private def expectGroupMetadataLoad(groupMetadataTopicPartition: TopicPartition,
+                                      startOffset: Long,
+                                      records: MemoryRecords): Unit = {
+    val endOffset = startOffset + records.deepEntries.asScala.size
+    val logMock =  EasyMock.mock(classOf[Log])
+    val fileRecordsMock = EasyMock.mock(classOf[FileRecords])
+
+    EasyMock.expect(replicaManager.getLog(groupMetadataTopicPartition)).andStubReturn(Some(logMock))
+    EasyMock.expect(logMock.logStartOffset).andStubReturn(startOffset)
+    EasyMock.expect(replicaManager.getHighWatermark(groupMetadataTopicPartition)).andStubReturn(Some(endOffset))
+    EasyMock.expect(logMock.read(EasyMock.eq(startOffset), EasyMock.anyInt(), EasyMock.eq(None), EasyMock.eq(true)))
+      .andReturn(FetchDataInfo(LogOffsetMetadata(startOffset), fileRecordsMock))
+    EasyMock.expect(fileRecordsMock.readInto(EasyMock.anyObject(classOf[ByteBuffer]), EasyMock.anyInt()))
+      .andReturn(records.buffer)
+
+    EasyMock.replay(logMock, fileRecordsMock)
+  }
+
+  private def createCommittedOffsetRecords(committedOffsets: Map[TopicPartition, Long],
+                                           groupId: String = groupId): Seq[Record] = {
+    committedOffsets.map { case (topicPartition, offset) =>
+      val offsetAndMetadata = OffsetAndMetadata(offset)
+      val offsetCommitKey = GroupMetadataManager.offsetCommitKey(groupId, topicPartition)
+      val offsetCommitValue = GroupMetadataManager.offsetCommitValue(offsetAndMetadata)
+      Record.create(offsetCommitKey, offsetCommitValue)
+    }.toSeq
+  }
+
 }
diff --git a/core/src/test/scala/unit/kafka/coordinator/GroupMetadataTest.scala b/core/src/test/scala/unit/kafka/coordinator/GroupMetadataTest.scala
index bf695bf7eab1a..3db7818538118 100644
--- a/core/src/test/scala/unit/kafka/coordinator/GroupMetadataTest.scala
+++ b/core/src/test/scala/unit/kafka/coordinator/GroupMetadataTest.scala
@@ -180,14 +180,14 @@ class GroupMetadataTest extends JUnitSuite {
     val member = new MemberMetadata(memberId, groupId, clientId, clientHost, rebalanceTimeoutMs, sessionTimeoutMs,
       protocolType, List(("range", Array.empty[Byte]), ("roundrobin", Array.empty[Byte])))
 
-    group.add(memberId, member)
+    group.add(member)
     assertEquals("range", group.selectProtocol)
 
     val otherMemberId = "otherMemberId"
     val otherMember = new MemberMetadata(otherMemberId, groupId, clientId, clientHost, rebalanceTimeoutMs,
       sessionTimeoutMs, protocolType, List(("roundrobin", Array.empty[Byte]), ("range", Array.empty[Byte])))
 
-    group.add(otherMemberId, otherMember)
+    group.add(otherMember)
     // now could be either range or robin since there is no majority preference
     assertTrue(Set("range", "roundrobin")(group.selectProtocol))
 
@@ -195,7 +195,7 @@ class GroupMetadataTest extends JUnitSuite {
     val lastMember = new MemberMetadata(lastMemberId, groupId, clientId, clientHost, rebalanceTimeoutMs,
       sessionTimeoutMs, protocolType, List(("roundrobin", Array.empty[Byte]), ("range", Array.empty[Byte])))
 
-    group.add(lastMemberId, lastMember)
+    group.add(lastMember)
     // now we should prefer 'roundrobin'
     assertEquals("roundrobin", group.selectProtocol)
   }
@@ -216,8 +216,8 @@ class GroupMetadataTest extends JUnitSuite {
     val otherMember = new MemberMetadata(otherMemberId, groupId, clientId, clientHost, rebalanceTimeoutMs,
       sessionTimeoutMs, protocolType, List(("roundrobin", Array.empty[Byte]), ("blah", Array.empty[Byte])))
 
-    group.add(memberId, member)
-    group.add(otherMemberId, otherMember)
+    group.add(member)
+    group.add(otherMember)
     assertEquals("roundrobin", group.selectProtocol)
   }
 
@@ -230,7 +230,7 @@ class GroupMetadataTest extends JUnitSuite {
     val member = new MemberMetadata(memberId, groupId, clientId, clientHost, rebalanceTimeoutMs,
       sessionTimeoutMs, protocolType, List(("range", Array.empty[Byte]), ("roundrobin", Array.empty[Byte])))
 
-    group.add(memberId, member)
+    group.add(member)
     assertTrue(group.supportsProtocols(Set("roundrobin", "foo")))
     assertTrue(group.supportsProtocols(Set("range", "foo")))
     assertFalse(group.supportsProtocols(Set("foo", "bar")))
@@ -239,7 +239,7 @@ class GroupMetadataTest extends JUnitSuite {
     val otherMember = new MemberMetadata(otherMemberId, groupId, clientId, clientHost, rebalanceTimeoutMs,
       sessionTimeoutMs, protocolType, List(("roundrobin", Array.empty[Byte]), ("blah", Array.empty[Byte])))
 
-    group.add(otherMemberId, otherMember)
+    group.add(otherMember)
 
     assertTrue(group.supportsProtocols(Set("roundrobin", "foo")))
     assertFalse(group.supportsProtocols(Set("range", "foo")))
@@ -253,7 +253,7 @@ class GroupMetadataTest extends JUnitSuite {
 
     group.transitionTo(PreparingRebalance)
     member.awaitingJoinCallback = _ => ()
-    group.add(memberId, member)
+    group.add(member)
 
     assertEquals(0, group.generationId)
     assertNull(group.protocol)
diff --git a/core/src/test/scala/unit/kafka/producer/AsyncProducerTest.scala b/core/src/test/scala/unit/kafka/producer/AsyncProducerTest.scala
index 7a00f2a7b6998..6358bdc83a00a 100755
--- a/core/src/test/scala/unit/kafka/producer/AsyncProducerTest.scala
+++ b/core/src/test/scala/unit/kafka/producer/AsyncProducerTest.scala
@@ -21,7 +21,7 @@ import java.util.Properties
 import java.util.concurrent.LinkedBlockingQueue
 
 import org.apache.kafka.common.protocol.{Errors, SecurityProtocol}
-import org.junit.Assert._
+import org.junit.Assert.{assertEquals, assertTrue}
 import org.easymock.EasyMock
 import org.junit.Test
 import kafka.api._
@@ -36,7 +36,6 @@ import kafka.utils.TestUtils._
 import scala.collection.Map
 import scala.collection.mutable.ArrayBuffer
 import kafka.utils._
-import org.apache.kafka.common.network.ListenerName
 import org.apache.kafka.common.utils.Time
 
 @deprecated("This test has been deprecated and it will be removed in a future release.", "0.10.0.0")
diff --git a/core/src/test/scala/unit/kafka/utils/TestUtils.scala b/core/src/test/scala/unit/kafka/utils/TestUtils.scala
index c530e07604c2d..d4173ef9fcff3 100755
--- a/core/src/test/scala/unit/kafka/utils/TestUtils.scala
+++ b/core/src/test/scala/unit/kafka/utils/TestUtils.scala
@@ -288,6 +288,11 @@ object TestUtils extends Logging {
     props
   }
 
+  /**
+   * Fail a test case explicitly. Return Nothing so that we are not constrained by the return type.
+   */
+  def fail(msg: String): Nothing = throw new AssertionError(msg)
+
   /**
    * Wrap a single record log buffer.
    */

From f0f5c345446fc7eb47c0acf48a862b501c6aaa4b Mon Sep 17 00:00:00 2001
From: "Colin P. Mccabe" <cmccabe@confluent.io>
Date: Fri, 27 Jan 2017 12:30:10 +0000
Subject: [PATCH 071/177] KAFKA-4664; Update docs/protocol.html with KIP-97
 information

Author: Colin P. Mccabe <cmccabe@confluent.io>

Reviewers: Gwen Shapira <cshapi@gmail.com>, Ismael Juma <ismael@juma.me.uk>

Closes #2387 from cmccabe/KAFKA-4664

(cherry picked from commit 4a14adbb63205e052b7620420b306e29320a4343)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 docs/protocol.html | 25 ++++++++++++-------------
 1 file changed, 12 insertions(+), 13 deletions(-)

diff --git a/docs/protocol.html b/docs/protocol.html
index bd29905d83e97..5285f2e3ec8a1 100644
--- a/docs/protocol.html
+++ b/docs/protocol.html
@@ -109,22 +109,22 @@ <h5><a id="protocol_batching" href="#protocol_batching">Batching</a></h5>
 
 <h5><a id="protocol_compatibility" href="#protocol_compatibility">Versioning and Compatibility</a></h5>
 
-<p>The protocol is designed to enable incremental evolution in a backward compatible fashion. Our versioning is on a per-api basis, each version consisting of a request and response pair. Each request contains an API key that identifies the API being invoked and a version number that indicates the format of the request and the expected format of the response.</p>
+<p>The protocol is designed to enable incremental evolution in a backward compatible fashion. Our versioning is on a per API basis, each version consisting of a request and response pair. Each request contains an API key that identifies the API being invoked and a version number that indicates the format of the request and the expected format of the response.</p>
 
-<p>The intention is that clients would implement a particular version of the protocol, and indicate this version in their requests. Our goal is primarily to allow API evolution in an environment where downtime is not allowed and clients and servers cannot all be changed at once.</p>
+<p>The intention is that clients will support a range of API versions. When communicating with a particular broker, a given client should use the highest API version supported by both and indicate this version in their requests.</p>
 
 <p>The server will reject requests with a version it does not support, and will always respond to the client with exactly the protocol format it expects based on the version it included in its request. The intended upgrade path is that new features would first be rolled out on the server (with the older clients not making use of them) and then as newer clients are deployed these new features would gradually be taken advantage of.</p>
 
+<p>Our goal is primarily to allow API evolution in an environment where downtime is not allowed and clients and servers cannot all be changed at once.</p>
+
 <p>Currently all versions are baselined at 0, as we evolve these APIs we will indicate the format for each version individually.</p>
 
 <h5><a id="api_versions" href="#api_versions">Retrieving Supported API versions</a></h5>
-<p>In order for a client to successfully talk to a broker, it must use request versions supported by the broker. Clients
-    may work against multiple broker versions, however to do so the clients need to know what versions of various APIs a
-    broker supports. Starting from 0.10.0.0, brokers provide information on various versions of APIs they support. Details
-    of this new capability can be found <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-35+-+Retrieving+protocol+version">here</a>.
-    Clients may use the supported API versions information to take appropriate actions such as propagating an unsupported
-    API version error to application or choose an API request/response version supported by both the client and broker.
-    The following sequence maybe used by a client to obtain supported API versions from a broker.</p>
+<p>In order to work against multiple broker versions, clients need to know what versions of various APIs a
+    broker supports. The broker exposes this information since 0.10.0.0 as described in <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-35+-+Retrieving+protocol+version">KIP-35</a>.
+    Clients should use the supported API versions information to choose the highest API version supported by both client and broker. If no such version
+    exists, an error should be reported to the user.</p>
+<p>The following sequence may be used by a client to obtain supported API versions from a broker.</p>
 <ol>
     <li>Client sends <code>ApiVersionsRequest</code> to a broker after connection has been established with the broker. If SSL is enabled,
         this happens after SSL connection has been established.</li>
@@ -136,13 +136,12 @@ <h5><a id="api_versions" href="#api_versions">Retrieving Supported API versions<
         than 0.10.0.0 do not support this API and will either ignore the request or close connection in response to the request.</li>
     <li>If multiple versions of an API are supported by broker and client, clients are recommended to use the latest version supported
         by the broker and itself.</li>
-    <li>Deprecation of a protocol version is done by marking an API version as deprecated in protocol documentation.</li>
-    <li>Supported API versions obtained from a broker, is valid only for current connection on which that information is obtained.
-        In the event of disconnection, the client should obtain the information from broker again, as the broker might have
+    <li>Deprecation of a protocol version is done by marking an API version as deprecated in the protocol documentation.</li>
+    <li>Supported API versions obtained from a broker are only valid for the connection on which that information is obtained.
+        In the event of disconnection, the client should obtain the information from the broker again, as the broker might have been
         upgraded/downgraded in the mean time.</li>
 </ol>
 
-
 <h5><a id="sasl_handshake" href="#sasl_handshake">SASL Authentication Sequence</a></h5>
 <p>The following sequence is used for SASL authentication:
 <ol>

From b81f311bcc915a3a27643c64e04786862a345646 Mon Sep 17 00:00:00 2001
From: Ewen Cheslack-Postava <me@ewencp.org>
Date: Fri, 27 Jan 2017 14:49:12 -0800
Subject: [PATCH 072/177] MINOR: Update copyright year in the NOTICE file.

Author: Ewen Cheslack-Postava <me@ewencp.org>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2460 from ewencp/minor-update-notice-year

(cherry picked from commit 1b964396b88b3d6eea3148fe7c8b4b870910cd8b)
Signed-off-by: Ewen Cheslack-Postava <me@ewencp.org>
---
 NOTICE | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/NOTICE b/NOTICE
index 3a1f5496d71cf..7a62b7fed60cd 100644
--- a/NOTICE
+++ b/NOTICE
@@ -1,5 +1,5 @@
 Apache Kafka
-Copyright 2016 The Apache Software Foundation.
+Copyright 2017 The Apache Software Foundation.
 
 This product includes software developed at
 The Apache Software Foundation (http://www.apache.org/).

From 05b1ebd9ea6ca36a77269c71d598a7f613b277ba Mon Sep 17 00:00:00 2001
From: Rajini Sivaram <rajinisivaram@googlemail.com>
Date: Fri, 27 Jan 2017 23:26:09 +0000
Subject: [PATCH 073/177] KAFKA-4557; Handle Producer.send correctly in expiry
 callbacks

When iterating deque for expiring record batches, delay the
invocation of the callback and deallocation until iteration is
complete since callbacks invoked during expiry may send more
records, modifying the deque, resulting in a
ConcurrentModificationException in the iterator.

Author: Rajini Sivaram <rajinisivaram@googlemail.com>

Reviewers: Jason Gustafson <jason@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2449 from rajinisivaram/KAFKA-4557

(cherry picked from commit aef6927a42cde193dd6acc36cd4d9f32167da622)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../producer/internals/RecordAccumulator.java | 13 +++--
 .../producer/internals/RecordBatch.java       | 48 ++++++++++++-------
 .../internals/RecordAccumulatorTest.java      | 45 +++++++++++++++++
 3 files changed, 85 insertions(+), 21 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordAccumulator.java b/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordAccumulator.java
index 06d39ecc68cab..d3ae89e30881f 100644
--- a/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordAccumulator.java
+++ b/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordAccumulator.java
@@ -243,12 +243,14 @@ public List<RecordBatch> abortExpiredBatches(int requestTimeout, long now) {
                     while (batchIterator.hasNext()) {
                         RecordBatch batch = batchIterator.next();
                         boolean isFull = batch != lastBatch || batch.isFull();
-                        // check if the batch is expired
+                        // Check if the batch has expired. Expired batches are closed by maybeExpire, but callbacks
+                        // are invoked after completing the iterations, since sends invoked from callbacks
+                        // may append more batches to the deque being iterated. The batch is deallocated after
+                        // callbacks are invoked.
                         if (batch.maybeExpire(requestTimeout, retryBackoffMs, now, this.lingerMs, isFull)) {
                             expiredBatches.add(batch);
                             count++;
                             batchIterator.remove();
-                            deallocate(batch);
                         } else {
                             // Stop at the first batch that has not expired.
                             break;
@@ -257,8 +259,13 @@ public List<RecordBatch> abortExpiredBatches(int requestTimeout, long now) {
                 }
             }
         }
-        if (!expiredBatches.isEmpty())
+        if (!expiredBatches.isEmpty()) {
             log.trace("Expired {} batches in accumulator", count);
+            for (RecordBatch batch : expiredBatches) {
+                batch.expirationDone();
+                deallocate(batch);
+            }
+        }
 
         return expiredBatches;
     }
diff --git a/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordBatch.java b/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordBatch.java
index c8eddd5d93d7a..6346fe9c9f033 100644
--- a/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordBatch.java
+++ b/clients/src/main/java/org/apache/kafka/clients/producer/internals/RecordBatch.java
@@ -25,6 +25,7 @@
 import java.nio.ByteBuffer;
 import java.util.ArrayList;
 import java.util.List;
+import java.util.concurrent.atomic.AtomicBoolean;
 
 /**
  * A batch of records that is or will be sent.
@@ -48,6 +49,8 @@ public final class RecordBatch {
     long drainedMs;
     long lastAttemptMs;
     long lastAppendTime;
+    private String expiryErrorMessage;
+    private AtomicBoolean completed;
     private boolean retry;
 
     public RecordBatch(TopicPartition tp, MemoryRecordsBuilder recordsBuilder, long now) {
@@ -57,6 +60,7 @@ public RecordBatch(TopicPartition tp, MemoryRecordsBuilder recordsBuilder, long
         this.topicPartition = tp;
         this.lastAppendTime = createdMs;
         this.produceFuture = new ProduceRequestResult(topicPartition);
+        this.completed = new AtomicBoolean();
     }
 
     /**
@@ -93,6 +97,9 @@ public void done(long baseOffset, long logAppendTime, RuntimeException exception
         log.trace("Produced messages to topic-partition {} with base offset offset {} and error: {}.",
                   topicPartition, baseOffset, exception);
 
+        if (completed.getAndSet(true))
+            throw new IllegalStateException("Batch has already been completed");
+
         // Set the future before invoking the callbacks as we rely on its state for the `onCompletion` call
         produceFuture.set(baseOffset, logAppendTime, exception);
 
@@ -137,29 +144,34 @@ public String toString() {
      *     <li> the batch is not in retry AND request timeout has elapsed after it is ready (full or linger.ms has reached).
      *     <li> the batch is in retry AND request timeout has elapsed after the backoff period ended.
      * </ol>
+     * This methods closes this batch and sets {@code expiryErrorMessage} if the batch has timed out.
+     * {@link #expirationDone()} must be invoked to complete the produce future and invoke callbacks.
      */
     public boolean maybeExpire(int requestTimeoutMs, long retryBackoffMs, long now, long lingerMs, boolean isFull) {
-        boolean expire = false;
-        String errorMessage = null;
-
-        if (!this.inRetry() && isFull && requestTimeoutMs < (now - this.lastAppendTime)) {
-            expire = true;
-            errorMessage = (now - this.lastAppendTime) + " ms has passed since last append";
-        } else if (!this.inRetry() && requestTimeoutMs < (now - (this.createdMs + lingerMs))) {
-            expire = true;
-            errorMessage = (now - (this.createdMs + lingerMs)) + " ms has passed since batch creation plus linger time";
-        } else if (this.inRetry() && requestTimeoutMs < (now - (this.lastAttemptMs + retryBackoffMs))) {
-            expire = true;
-            errorMessage = (now - (this.lastAttemptMs + retryBackoffMs)) + " ms has passed since last attempt plus backoff time";
-        }
 
-        if (expire) {
+        if (!this.inRetry() && isFull && requestTimeoutMs < (now - this.lastAppendTime))
+            expiryErrorMessage = (now - this.lastAppendTime) + " ms has passed since last append";
+        else if (!this.inRetry() && requestTimeoutMs < (now - (this.createdMs + lingerMs)))
+            expiryErrorMessage = (now - (this.createdMs + lingerMs)) + " ms has passed since batch creation plus linger time";
+        else if (this.inRetry() && requestTimeoutMs < (now - (this.lastAttemptMs + retryBackoffMs)))
+            expiryErrorMessage = (now - (this.lastAttemptMs + retryBackoffMs)) + " ms has passed since last attempt plus backoff time";
+
+        boolean expired = expiryErrorMessage != null;
+        if (expired)
             close();
-            this.done(-1L, Record.NO_TIMESTAMP,
-                      new TimeoutException("Expiring " + recordCount + " record(s) for " + topicPartition + " due to " + errorMessage));
-        }
+        return expired;
+    }
 
-        return expire;
+    /**
+     * Completes the produce future with timeout exception and invokes callbacks.
+     * This method should be invoked only if {@link #maybeExpire(int, long, long, long, boolean)}
+     * returned true.
+     */
+    void expirationDone() {
+        if (expiryErrorMessage == null)
+            throw new IllegalStateException("Batch has not expired");
+        this.done(-1L, Record.NO_TIMESTAMP,
+                  new TimeoutException("Expiring " + recordCount + " record(s) for " + topicPartition + ": " + expiryErrorMessage));
     }
 
     /**
diff --git a/clients/src/test/java/org/apache/kafka/clients/producer/internals/RecordAccumulatorTest.java b/clients/src/test/java/org/apache/kafka/clients/producer/internals/RecordAccumulatorTest.java
index 04e14112d3291..f8bb1e9942d19 100644
--- a/clients/src/test/java/org/apache/kafka/clients/producer/internals/RecordAccumulatorTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/producer/internals/RecordAccumulatorTest.java
@@ -18,6 +18,7 @@
 import org.apache.kafka.common.Node;
 import org.apache.kafka.common.PartitionInfo;
 import org.apache.kafka.common.TopicPartition;
+import org.apache.kafka.common.errors.TimeoutException;
 import org.apache.kafka.common.metrics.Metrics;
 import org.apache.kafka.common.record.CompressionType;
 import org.apache.kafka.common.record.LogEntry;
@@ -38,10 +39,12 @@
 import java.util.Map;
 import java.util.Set;
 import java.util.concurrent.atomic.AtomicInteger;
+import java.util.concurrent.atomic.AtomicReference;
 
 import static java.util.Arrays.asList;
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertNull;
 import static org.junit.Assert.assertTrue;
 import static org.junit.Assert.fail;
 
@@ -409,6 +412,48 @@ public void testExpiredBatches() throws InterruptedException {
         assertEquals("The batch should be expired when the partition is not muted.", 1, expiredBatches.size());
     }
 
+    @Test
+    public void testAppendInExpiryCallback() throws InterruptedException {
+        long retryBackoffMs = 100L;
+        long lingerMs = 3000L;
+        int requestTimeout = 60;
+        int messagesPerBatch = 1024 / msgSize;
+
+        final RecordAccumulator accum = new RecordAccumulator(1024, 10 * 1024, CompressionType.NONE, lingerMs,
+                retryBackoffMs, metrics, time);
+        final AtomicInteger expiryCallbackCount = new AtomicInteger();
+        final AtomicReference<Exception> unexpectedException = new AtomicReference<Exception>();
+        Callback callback = new Callback() {
+            @Override
+            public void onCompletion(RecordMetadata metadata, Exception exception) {
+                if (exception instanceof TimeoutException) {
+                    expiryCallbackCount.incrementAndGet();
+                    try {
+                        accum.append(tp1, 0L, key, value, null, maxBlockTimeMs);
+                    } catch (InterruptedException e) {
+                        throw new RuntimeException("Unexpected interruption", e);
+                    }
+                } else if (exception != null)
+                    unexpectedException.compareAndSet(null, exception);
+            }
+        };
+
+        for (int i = 0; i < messagesPerBatch + 1; i++)
+            accum.append(tp1, 0L, key, value, callback, maxBlockTimeMs);
+
+        assertEquals(2, accum.batches().get(tp1).size());
+        assertTrue("First batch not full", accum.batches().get(tp1).peekFirst().isFull());
+
+        // Advance the clock to expire the first batch.
+        time.sleep(requestTimeout + 1);
+        List<RecordBatch> expiredBatches = accum.abortExpiredBatches(requestTimeout, time.milliseconds());
+        assertEquals("The batch was not expired", 1, expiredBatches.size());
+        assertEquals("Callbacks not invoked for expiry", messagesPerBatch, expiryCallbackCount.get());
+        assertNull("Unexpected exception", unexpectedException.get());
+        assertEquals("Some messages not appended from expiry callbacks", 2, accum.batches().get(tp1).size());
+        assertTrue("First batch not full after expiry callbacks with appends", accum.batches().get(tp1).peekFirst().isFull());
+    }
+
     @Test
     public void testMutedPartitions() throws InterruptedException {
         long now = time.milliseconds();

From 903548f1a0f4365ae11315a4c36a5e80b90d1ff8 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Fri, 27 Jan 2017 16:48:44 -0800
Subject: [PATCH 074/177] MINOR: update JavaDocs for Kafka Streams DSL helpers

 - also deprecate ZK config for Streams

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Ismael Juma, Guozhang Wang

Closes #2459 from mjsax/javaDocImprovements8

(cherry picked from commit 4c42654b1eecebae272dfe5ce018b85ad4db7709)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../kafka/streams/KafkaClientSupplier.java    |  42 +-
 .../apache/kafka/streams/KafkaStreams.java    | 393 ++++++-----
 .../org/apache/kafka/streams/KeyValue.java    |  30 +-
 .../apache/kafka/streams/StreamsConfig.java   | 648 ++++++++++--------
 .../apache/kafka/streams/StreamsMetrics.java  | 116 ++--
 .../kafka/streams/kstream/KGroupedStream.java |   6 +-
 .../kafka/streams/kstream/KStreamBuilder.java | 483 ++++++++-----
 .../WallclockTimestampExtractor.java          |   1 +
 .../internals/StreamsKafkaClient.java         |  12 +-
 .../GlobalKTableIntegrationTest.java          |   1 -
 .../integration/JoinIntegrationTest.java      |   1 -
 .../KTableKTableJoinIntegrationTest.java      |   1 -
 12 files changed, 1043 insertions(+), 691 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/KafkaClientSupplier.java b/streams/src/main/java/org/apache/kafka/streams/KafkaClientSupplier.java
index e0312f92304aa..ed3d4884a4b57 100644
--- a/streams/src/main/java/org/apache/kafka/streams/KafkaClientSupplier.java
+++ b/streams/src/main/java/org/apache/kafka/streams/KafkaClientSupplier.java
@@ -17,31 +17,43 @@
 
 package org.apache.kafka.streams;
 
-import java.util.Map;
-
 import org.apache.kafka.clients.consumer.Consumer;
 import org.apache.kafka.clients.producer.Producer;
+import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.processor.internals.StreamThread;
+
+import java.util.Map;
 
+/**
+ * {@code KafkaClientSupplier} can be used to provide custom Kafka clients to a {@link KafkaStreams} instance.
+ *
+ * @see KafkaStreams#KafkaStreams(org.apache.kafka.streams.processor.TopologyBuilder, StreamsConfig, KafkaClientSupplier)
+ */
 public interface KafkaClientSupplier {
     /**
-     * Creates an instance of Producer which is used to produce records.
-     * @param config producer config which supplied by {@link StreamsConfig} given to {@link KafkaStreams}
-     * @return an instance of kafka Producer
+     * Create a {@link Producer} which is used to write records to sink topics.
+     *
+     * @param config {@link StreamsConfig#getProducerConfigs(String) producer config} which is supplied by the
+     *               {@link StreamsConfig} given to the {@link KafkaStreams} instance
+     * @return an instance of Kafka producer
      */
-    Producer<byte[], byte[]> getProducer(Map<String, Object> config);
+    Producer<byte[], byte[]> getProducer(final Map<String, Object> config);
 
     /**
-     * Creates an instance of Consumer which is used to consume records of source topics.
-     * @param config consumer config which supplied by {@link StreamsConfig} given to {@link KafkaStreams}
-     * @return an instance of kafka Consumer
+     * Create a {@link Consumer} which is used to read records of source topics.
+     *
+     * @param config {@link StreamsConfig#getConsumerConfigs(StreamThread, String, String) consumer config} which is
+     *               supplied by the {@link StreamsConfig} given to the {@link KafkaStreams} instance
+     * @return an instance of Kafka consumer
      */
-    Consumer<byte[], byte[]> getConsumer(Map<String, Object> config);
+    Consumer<byte[], byte[]> getConsumer(final Map<String, Object> config);
 
     /**
-     * Creates an instance of Consumer which is used to consume records of internal topics.
-     * @param config restore consumer config which supplied by {@link StreamsConfig} given to
-     * {@link KafkaStreams}
-     * @return an instance of kafka Consumer
+     * Create a {@link Consumer} which is used to read records to restore {@link StateStore}s.
+     *
+     * @param config {@link StreamsConfig#getRestoreConsumerConfigs(String) restore consumer config} which is supplied
+     *               by the {@link StreamsConfig} given to the {@link KafkaStreams}
+     * @return an instance of Kafka consumer
      */
-    Consumer<byte[], byte[]> getRestoreConsumer(Map<String, Object> config);
+    Consumer<byte[], byte[]> getRestoreConsumer(final Map<String, Object> config);
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java b/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
index 27c8d22d90c71..ef0e72dd3a8ef 100644
--- a/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
+++ b/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
@@ -17,6 +17,9 @@
 
 package org.apache.kafka.streams;
 
+import org.apache.kafka.clients.consumer.KafkaConsumer;
+import org.apache.kafka.clients.producer.KafkaProducer;
+import org.apache.kafka.clients.producer.ProducerConfig;
 import org.apache.kafka.common.Metric;
 import org.apache.kafka.common.MetricName;
 import org.apache.kafka.common.annotation.InterfaceStability;
@@ -28,6 +31,12 @@
 import org.apache.kafka.common.metrics.Sensor;
 import org.apache.kafka.common.serialization.Serializer;
 import org.apache.kafka.common.utils.Time;
+import org.apache.kafka.streams.errors.InvalidStateStoreException;
+import org.apache.kafka.streams.errors.StreamsException;
+import org.apache.kafka.streams.kstream.KStream;
+import org.apache.kafka.streams.kstream.KStreamBuilder;
+import org.apache.kafka.streams.kstream.KTable;
+import org.apache.kafka.streams.processor.Processor;
 import org.apache.kafka.streams.processor.StateStore;
 import org.apache.kafka.streams.processor.StreamPartitioner;
 import org.apache.kafka.streams.processor.TopologyBuilder;
@@ -67,43 +76,44 @@
 import static org.apache.kafka.common.utils.Utils.getPort;
 
 /**
- * Kafka Streams allows for performing continuous computation on input coming from one or more input topics and
- * sends output to zero or more output topics.
+ * A Kafka client that allows for performing continuous computation on input coming from one or more input topics and
+ * sends output to zero, one, or more output topics.
  * <p>
- * The computational logic can be specified either by using the {@link TopologyBuilder} class to define the a DAG topology of
- * {@link org.apache.kafka.streams.processor.Processor}s or by using the {@link org.apache.kafka.streams.kstream.KStreamBuilder}
- * class which provides the high-level {@link org.apache.kafka.streams.kstream.KStream} DSL to define the transformation.
+ * The computational logic can be specified either by using the {@link TopologyBuilder} to define a DAG topology of
+ * {@link Processor}s or by using the {@link KStreamBuilder} which provides the high-level DSL to define transformations.
  * <p>
- * The {@link KafkaStreams} class manages the lifecycle of a Kafka Streams instance. One stream instance can contain one or
- * more threads specified in the configs for the processing work.
+ * One {@code KafkaStreams} instance can contain one or more threads specified in the configs for the processing work.
  * <p>
- * A {@link KafkaStreams} instance can co-ordinate with any other instances with the same application ID (whether in this same process, on other processes
- * on this machine, or on remote machines) as a single (possibly distributed) stream processing client. These instances will divide up the work
- * based on the assignment of the input topic partitions so that all partitions are being
- * consumed. If instances are added or failed, all instances will rebalance the partition assignment among themselves
- * to balance processing load.
- * <p>
- * Internally the {@link KafkaStreams} instance contains a normal {@link org.apache.kafka.clients.producer.KafkaProducer KafkaProducer}
- * and {@link org.apache.kafka.clients.consumer.KafkaConsumer KafkaConsumer} instance that is used for reading input and writing output.
+ * A {@code KafkaStreams} instance can co-ordinate with any other instances with the same
+ * {@link StreamsConfig#APPLICATION_ID_CONFIG application ID} (whether in the same process, on other processes on this
+ * machine, or on remote machines) as a single (possibly distributed) stream processing application.
+ * These instances will divide up the work based on the assignment of the input topic partitions so that all partitions
+ * are being consumed.
+ * If instances are added or fail, all (remaining) instances will rebalance the partition assignment among themselves
+ * to balance processing load and ensure that all input topic partitions are processed.
  * <p>
+ * Internally a {@link KafkaStreams} instance contains a normal {@link KafkaProducer} and {@link KafkaConsumer} instance
+ * that is used for reading input and writing output.
  * <p>
  * A simple example might look like this:
- * <pre>
- *    Map&lt;String, Object&gt; props = new HashMap&lt;&gt;();
- *    props.put(StreamsConfig.APPLICATION_ID_CONFIG, "my-stream-processing-application");
- *    props.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, "localhost:9092");
- *    props.put(StreamsConfig.KEY_SERDE_CLASS_CONFIG, Serdes.String().getClass().getName());
- *    props.put(StreamsConfig.VALUE_SERDE_CLASS_CONFIG, Serdes.String().getClass().getName());
- *    StreamsConfig config = new StreamsConfig(props);
+ * <pre>{@code
+ * Map&lt;String, Object&gt; props = new HashMap&lt;&gt;();
+ * props.put(StreamsConfig.APPLICATION_ID_CONFIG, "my-stream-processing-application");
+ * props.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, "localhost:9092");
+ * props.put(StreamsConfig.KEY_SERDE_CLASS_CONFIG, Serdes.String().getClass());
+ * props.put(StreamsConfig.VALUE_SERDE_CLASS_CONFIG, Serdes.String().getClass());
+ * StreamsConfig config = new StreamsConfig(props);
+ *
+ * KStreamBuilder builder = new KStreamBuilder();
+ * builder.stream("my-input-topic").mapValues(value -&gt; value.length().toString()).to("my-output-topic");
  *
- *    KStreamBuilder builder = new KStreamBuilder();
- *    builder.stream("my-input-topic").mapValues(value -&gt; value.length().toString()).to("my-output-topic");
+ * KafkaStreams streams = new KafkaStreams(builder, config);
+ * streams.start();
+ * }</pre>
  *
- *    KafkaStreams streams = new KafkaStreams(builder, config);
- *    streams.start();
- * </pre>
+ * @see KStreamBuilder
+ * @see TopologyBuilder
  */
-
 @InterfaceStability.Unstable
 public class KafkaStreams {
 
@@ -163,15 +173,15 @@ public enum State {
 
         private final Set<Integer> validTransitions = new HashSet<>();
 
-        State(final Integer...validTransitions) {
+        State(final Integer... validTransitions) {
             this.validTransitions.addAll(Arrays.asList(validTransitions));
         }
 
         public boolean isRunning() {
-            return this.equals(RUNNING) || this.equals(REBALANCING);
+            return equals(RUNNING) || equals(REBALANCING);
         }
         public boolean isCreatedOrRunning() {
-            return isRunning() || this.equals(CREATED);
+            return isRunning() || equals(CREATED);
         }
         public boolean isValidTransition(final State newState) {
             return validTransitions.contains(newState.ordinal());
@@ -179,33 +189,34 @@ public boolean isValidTransition(final State newState) {
     }
     private volatile State state = KafkaStreams.State.CREATED;
     private StateListener stateListener = null;
-    private final StreamStateListener streamStateListener = new StreamStateListener();
+
 
     /**
-     * Listen to state change events
+     * Listen to {@link State} change events.
      */
     public interface StateListener {
 
         /**
-         * Called when state changes
-         * @param newState     current state
-         * @param oldState     previous state
+         * Called when state changes.
+         *
+         * @param newState new state
+         * @param oldState previous state
          */
         void onChange(final State newState, final State oldState);
     }
 
     /**
-     * An app can set {@link StateListener} so that the app is notified when state changes
-     * @param listener
+     * An app can set a single {@link StateListener} so that the app is notified when state changes.
+     * @param listener a new state listener
      */
     public void setStateListener(final StateListener listener) {
-        this.stateListener = listener;
+        stateListener = listener;
     }
 
-    private synchronized void setState(State newState) {
-        State oldState = state;
+    private synchronized void setState(final State newState) {
+        final State oldState = state;
         if (!state.isValidTransition(newState)) {
-            log.warn("Unexpected state transition from " + state + " to " + newState);
+            log.warn("Unexpected state transition from {} to {}.", oldState, newState);
         }
         state = newState;
         if (stateListener != null) {
@@ -213,31 +224,35 @@ private synchronized void setState(State newState) {
         }
     }
 
-
     /**
-     * @return The state this instance is in
+     * Return the current {@link State} of this {@code KafkaStreams} instance.
+     *
+     * @return the currnt state of this Kafka Streams instance
      */
     public synchronized State state() {
         return state;
     }
 
     /**
-     * Get read-only handle on global metrics registry
+     * Get read-only handle on global metrics registry.
+     *
      * @return Map of all metrics.
      */
     public Map<MetricName, ? extends Metric> metrics() {
-        return Collections.unmodifiableMap(this.metrics.metrics());
+        return Collections.unmodifiableMap(metrics.metrics());
     }
 
     private class StreamStateListener implements StreamThread.StateListener {
         @Override
-        public synchronized void onChange(final StreamThread thread, final StreamThread.State newState, final StreamThread.State oldState) {
+        public synchronized void onChange(final StreamThread thread,
+                                          final StreamThread.State newState,
+                                          final StreamThread.State oldState) {
             threadState.put(thread.getId(), newState);
             if (newState == StreamThread.State.PARTITIONS_REVOKED ||
                 newState == StreamThread.State.ASSIGNING_PARTITIONS) {
                 setState(State.REBALANCING);
             } else if (newState == StreamThread.State.RUNNING) {
-                for (StreamThread.State state : threadState.values()) {
+                for (final StreamThread.State state : threadState.values()) {
                     if (state != StreamThread.State.RUNNING) {
                         return;
                     }
@@ -246,35 +261,38 @@ public synchronized void onChange(final StreamThread thread, final StreamThread.
             }
         }
     }
+
     /**
-     * Construct the stream instance.
+     * Create a {@code KafkaStreams} instance.
      *
      * @param builder the processor topology builder specifying the computational logic
-     * @param props   properties for the {@link StreamsConfig}
+     * @param props   properties for {@link StreamsConfig}
      */
     public KafkaStreams(final TopologyBuilder builder, final Properties props) {
         this(builder, new StreamsConfig(props), new DefaultKafkaClientSupplier());
     }
 
     /**
-     * Construct the stream instance.
+     * Create a {@code KafkaStreams} instance.
      *
      * @param builder the processor topology builder specifying the computational logic
-     * @param config  the stream configs
+     * @param config  the Kafka Streams configuration
      */
     public KafkaStreams(final TopologyBuilder builder, final StreamsConfig config) {
         this(builder, config, new DefaultKafkaClientSupplier());
     }
 
     /**
-     * Construct the stream instance.
+     * Create a {@code KafkaStreams} instance.
      *
      * @param builder        the processor topology builder specifying the computational logic
-     * @param config         the stream configs
-     * @param clientSupplier the kafka clients supplier which provides underlying producer and consumer clients
-     *                       for this {@link KafkaStreams} instance
+     * @param config         the Kafka Streams configuration
+     * @param clientSupplier the Kafka clients supplier which provides underlying producer and consumer clients
+     *                       for the new {@code KafkaStreams} instance
      */
-    public KafkaStreams(final TopologyBuilder builder, final StreamsConfig config, final KafkaClientSupplier clientSupplier) {
+    public KafkaStreams(final TopologyBuilder builder,
+                        final StreamsConfig config,
+                        final KafkaClientSupplier clientSupplier) {
         // create the metrics
         final Time time = Time.SYSTEM;
 
@@ -338,7 +356,7 @@ public KafkaStreams(final TopologyBuilder builder, final StreamsConfig config, f
                                           time,
                                           streamsMetadataState,
                                           cacheSizeBytes);
-            threads[i].setStateListener(streamStateListener);
+            threads[i].setStateListener(new StreamStateListener());
             threadState.put(threads[i].getId(), threads[i].state());
             storeProviders.add(new StreamThreadStateStoreProvider(threads[i]));
         }
@@ -360,7 +378,15 @@ private static HostInfo parseHostInfo(final String endPoint) {
         return new HostInfo(host, port);
     }
 
-    private void checkBrokerVersionCompatibility() {
+    /**
+     * Check if the used brokers have version 0.10.1.x or higher.
+     * <p>
+     * Note, for <em>pre</em> 0.10.x brokers the broker version cannot be checked and the client will hang and retry
+     * until it {@link StreamsConfig#REQUEST_TIMEOUT_MS_CONFIG times out}.
+     *
+     * @throws StreamsException if brokers have version 0.10.0.x
+     */
+    private void checkBrokerVersionCompatibility() throws StreamsException {
         final StreamsKafkaClient client = new StreamsKafkaClient(config);
 
         client.checkBrokerCompatibility();
@@ -374,12 +400,17 @@ private void checkBrokerVersionCompatibility() {
     }
 
     /**
-     * Start the stream instance by starting all its threads.
-     *
+     * Start the {@code KafkaStreams} instance by starting all its threads.
+     * <p>
+     * Note, for brokers with version {@code 0.9.x} or lower, the broker version cannot be checked.
+     * There will be no error and the client will hang and retry to verify the broker version until it
+     * {@link StreamsConfig#REQUEST_TIMEOUT_MS_CONFIG times out}.
+
      * @throws IllegalStateException if process was already started
+     * @throws StreamsException if the Kafka brokers have version 0.10.0.x
      */
-    public synchronized void start() {
-        log.debug("Starting Kafka Stream process");
+    public synchronized void start() throws IllegalStateException, StreamsException {
+        log.debug("Starting Kafka Stream process.");
 
         if (state == KafkaStreams.State.CREATED) {
             checkBrokerVersionCompatibility();
@@ -400,9 +431,7 @@ public synchronized void start() {
     }
 
     /**
-     * Shutdown this stream instance by signaling all the threads to stop,
-     * and then wait for them to join.
-     *
+     * Shutdown this {@code KafkaStreams} instance by signaling all the threads to stop, and then wait for them to join.
      * This will block until all threads have stopped.
      */
     public void close() {
@@ -410,17 +439,17 @@ public void close() {
     }
 
     /**
-     * Shutdown this stream instance by signaling all the threads to stop,
-     * and then wait up to the timeout for the threads to join.
-     *
-     * A timeout of 0 means to wait forever
+     * Shutdown this {@code KafkaStreams} by signaling all the threads to stop, and then wait up to the timeout for the
+     * threads to join.
+     * A {@code timeout} of 0 means to wait forever.
      *
-     * @param timeout   how long to wait for {@link StreamThread}s to shutdown
-     * @param timeUnit  unit of time used for timeout
-     * @return true if all threads were successfully stopped
+     * @param timeout  how long to wait for the threads to shutdown
+     * @param timeUnit unit of time used for timeout
+     * @return {@code true} if all threads were successfully stopped&mdash;{@code false} if the timeout was reached
+     * before all threads stopped
      */
     public synchronized boolean close(final long timeout, final TimeUnit timeUnit) {
-        log.debug("Stopping Kafka Stream process");
+        log.debug("Stopping Kafka Stream process.");
         if (state.isCreatedOrRunning()) {
             setState(KafkaStreams.State.PENDING_SHUTDOWN);
             // save the current thread so that if it is a stream thread
@@ -428,42 +457,42 @@ public synchronized boolean close(final long timeout, final TimeUnit timeUnit) {
             final Thread shutdown = new Thread(new Runnable() {
                 @Override
                 public void run() {
-                        // signal the threads to stop and wait
-                        for (final StreamThread thread : threads) {
-                            // avoid deadlocks by stopping any further state reports
-                            // from the thread since we're shutting down
-                            thread.setStateListener(null);
-                            thread.close();
-                        }
-                        if (globalStreamThread != null) {
-                            globalStreamThread.close();
-                            if (!globalStreamThread.stillRunning()) {
-                                try {
-                                    globalStreamThread.join();
-                                } catch (InterruptedException e) {
-                                    Thread.interrupted();
-                                }
-                            }
-                        }
-                        for (final StreamThread thread : threads) {
+                    // signal the threads to stop and wait
+                    for (final StreamThread thread : threads) {
+                        // avoid deadlocks by stopping any further state reports
+                        // from the thread since we're shutting down
+                        thread.setStateListener(null);
+                        thread.close();
+                    }
+                    if (globalStreamThread != null) {
+                        globalStreamThread.close();
+                        if (!globalStreamThread.stillRunning()) {
                             try {
-                                if (!thread.stillRunning()) {
-                                    thread.join();
-                                }
-                            } catch (final InterruptedException ex) {
+                                globalStreamThread.join();
+                            } catch (final InterruptedException e) {
                                 Thread.interrupted();
                             }
                         }
-
-                        metrics.close();
-                        log.info("Stopped Kafka Streams process");
                     }
+                    for (final StreamThread thread : threads) {
+                        try {
+                            if (!thread.stillRunning()) {
+                                thread.join();
+                            }
+                        } catch (final InterruptedException ex) {
+                            Thread.interrupted();
+                        }
+                    }
+
+                    metrics.close();
+                    log.info("Stopped Kafka Streams process.");
+                }
             }, "kafka-streams-close-thread");
             shutdown.setDaemon(true);
             shutdown.start();
             try {
                 shutdown.join(TimeUnit.MILLISECONDS.convert(timeout, timeUnit));
-            } catch (InterruptedException e) {
+            } catch (final InterruptedException e) {
                 Thread.interrupted();
             }
             setState(KafkaStreams.State.NOT_RUNNING);
@@ -473,9 +502,10 @@ public void run() {
     }
 
     /**
-     * Produces a string representation containing useful information about Kafka Streams
-     * Such as thread IDs, task IDs and a representation of the topology. This is useful
-     * in debugging scenarios.
+     * Produce a string representation containing useful information about this {@code KafkaStream} instance such as
+     * thread IDs, task IDs, and a representation of the topology DAG including {@link StateStore}s (cf.
+     * {@link TopologyBuilder} and {@link KStreamBuilder}).
+     *
      * @return A string representation of the Kafka Streams instance.
      */
     @Override
@@ -484,13 +514,19 @@ public String toString() {
     }
 
     /**
-     * Produces a string representation containing useful information about Kafka Streams
-     * such as thread IDs, task IDs and a representation of the topology starting with the given indent. This is useful
-     * in debugging scenarios.
+     * Produce a string representation containing useful information about this {@code KafkaStream} instance such as
+     * thread IDs, task IDs, and a representation of the topology DAG including {@link StateStore}s (cf.
+     * {@link TopologyBuilder} and {@link KStreamBuilder}).
+     *
+     * @param indent the top-level indent for each line
      * @return A string representation of the Kafka Streams instance.
      */
     public String toString(final String indent) {
-        final StringBuilder sb = new StringBuilder(indent + "KafkaStreams processID:" + processId + "\n");
+        final StringBuilder sb = new StringBuilder()
+            .append(indent)
+            .append("KafkaStreams processID: ")
+            .append(processId)
+            .append("\n");
         for (final StreamThread thread : threads) {
             sb.append(thread.toString(indent + "\t"));
         }
@@ -500,11 +536,16 @@ public String toString(final String indent) {
     }
 
     /**
-     * Cleans up local state store directory ({@code state.dir}), by deleting all data with regard to the application-id.
+     * Do a clean up of the local {@link StateStore} directory ({@link StreamsConfig#STATE_DIR_CONFIG}) by deleting all
+     * data with regard to the {@link StreamsConfig#APPLICATION_ID_CONFIG application ID}.
+     * <p>
+     * May only be called either before this {@code KafkaStreams} instance is {@link KafkaStreams#start() started} or
+     * after the instance is {@link KafkaStreams#close() closed}.
      * <p>
-     * May only be called either before instance is started or after instance is closed.
+     * Calling this method triggers a restore of local {@link StateStore}s on the next {@link KafkaStreams#start()
+     * application start}.
      *
-     * @throws IllegalStateException if instance is currently running
+     * @throws IllegalStateException if the instance is currently running
      */
     public void cleanUp() {
         if (state.isRunning()) {
@@ -515,7 +556,7 @@ public void cleanUp() {
         final String stateDir = config.getString(StreamsConfig.STATE_DIR_CONFIG);
 
         final String localApplicationDir = stateDir + File.separator + appId;
-        log.debug("Removing local Kafka Streams application data in {} for application {}",
+        log.debug("Removing local Kafka Streams application data in {} for application {}.",
             localApplicationDir,
             appId);
 
@@ -524,9 +565,10 @@ public void cleanUp() {
     }
 
     /**
-     * Sets the handler invoked when a stream thread abruptly terminates due to an uncaught exception.
+     * Set the handler invoked when a {@link StreamsConfig#NUM_STREAM_THREADS_CONFIG internal thread} abruptly
+     * terminates due to an uncaught exception.
      *
-     * @param eh the object to use as this thread's uncaught exception handler. If null then this thread has no explicit handler.
+     * @param eh the uncaught exception handler for all internal threads; {@code null} deletes the current handler
      */
     public void setUncaughtExceptionHandler(final Thread.UncaughtExceptionHandler eh) {
         for (final StreamThread thread : threads) {
@@ -538,25 +580,34 @@ public void setUncaughtExceptionHandler(final Thread.UncaughtExceptionHandler eh
         }
     }
 
-
     /**
-     * Find all of the instances of {@link StreamsMetadata} in the {@link KafkaStreams} application that this instance belongs to
-     *
+     * Find all currently running {@code KafkaStreams} instances (potentially remotely) that use the same
+     * {@link StreamsConfig#APPLICATION_ID_CONFIG application ID} as this instance (i.e., all instances that belong to
+     * the same Kafka Streams application) and return {@link StreamsMetadata} for each discovered instance.
+     * <p>
      * Note: this is a point in time view and it may change due to partition reassignment.
-     * @return collection containing all instances of {@link StreamsMetadata} in the {@link KafkaStreams} application that this instance belongs to
+     *
+     * @return {@link StreamsMetadata} for each {@code KafkaStreams} instances of this application
      */
     public Collection<StreamsMetadata> allMetadata() {
         validateIsRunning();
         return streamsMetadataState.getAllMetadata();
     }
 
-
     /**
-     * Find instances of {@link StreamsMetadata} that contains the given storeName
-     *
+     * Find all currently running {@code KafkaStreams} instances (potentially remotely) that
+     * <ul>
+     *   <li>use the same {@link StreamsConfig#APPLICATION_ID_CONFIG application ID} as this instance (i.e., all
+     *       instances that belong to the same Kafka Streams application)</li>
+     *   <li>and that contain a {@link StateStore} with the given {@code storeName}</li>
+     * </ul>
+     * and return {@link StreamsMetadata} for each discovered instance.
+     * <p>
      * Note: this is a point in time view and it may change due to partition reassignment.
-     * @param storeName the storeName to find metadata for
-     * @return  A collection containing instances of {@link StreamsMetadata} that have the provided storeName
+     *
+     * @param storeName the {@code storeName} to find metadata for
+     * @return {@link StreamsMetadata} for each {@code KafkaStreams} instances with the provide {@code storeName} of
+     * this application
      */
     public Collection<StreamsMetadata> allMetadataForStore(final String storeName) {
         validateIsRunning();
@@ -564,22 +615,35 @@ public Collection<StreamsMetadata> allMetadataForStore(final String storeName) {
     }
 
     /**
-     * Find the {@link StreamsMetadata} instance that contains the given storeName
-     * and the corresponding hosted store instance contains the given key. This will use
-     * the {@link org.apache.kafka.streams.processor.internals.DefaultStreamPartitioner} to
-     * locate the partition. If a custom partitioner has been used please use
-     * {@link KafkaStreams#metadataForKey(String, Object, StreamPartitioner)}
-     *
-     * Note: the key may not exist in the {@link org.apache.kafka.streams.processor.StateStore},
-     * this method provides a way of finding which host it would exist on.
+     * Find the currently running {@code KafkaStreams} instance (potentially remotely) that
+     * <ul>
+     *   <li>use the same {@link StreamsConfig#APPLICATION_ID_CONFIG application ID} as this instance (i.e., all
+     *       instances that belong to the same Kafka Streams application)</li>
+     *   <li>and that contain a {@link StateStore} with the given {@code storeName}</li>
+     *   <li>and the {@link StateStore} contains the given {@code key}</li>
+     * </ul>
+     * and return {@link StreamsMetadata} for it.
+     * <p>
+     * This will use the default Kafka Streams partitioner to locate the partition.
+     * If a {@link StreamPartitioner custom partitioner} has been
+     * {@link ProducerConfig#PARTITIONER_CLASS_CONFIG configured} via {@link StreamsConfig},
+     * {@link KStream#through(StreamPartitioner, String)}, or {@link KTable#through(StreamPartitioner, String, String)},
+     * or if the original {@link KTable}'s input {@link KStreamBuilder#table(String, String) topic} is partitioned
+     * differently, please use {@link KafkaStreams#metadataForKey(String, Object, StreamPartitioner)}.
+     * <p>
+     * Note:
+     * <ul>
+     *   <li>this is a point in time view and it may change due to partition reassignment</li>
+     *   <li>the key may not exist in the {@link StateStore}; this method provides a way of finding which host it
+     *       <em>would</em> exist on</li>
+     * </ul>
      *
-     * Note: this is a point in time view and it may change due to partition reassignment.
-     * @param storeName         Name of the store
-     * @param key               Key to use to for partition
-     * @param keySerializer     Serializer for the key
-     * @param <K>               key type
-     * @return  The {@link StreamsMetadata} for the storeName and key or {@link StreamsMetadata#NOT_AVAILABLE}
-     * if streams is (re-)initializing
+     * @param storeName     the {@code storeName} to find metadata for
+     * @param key           the key to find metadata for
+     * @param keySerializer serializer for the key
+     * @param <K>           key type
+     * @return {@link StreamsMetadata} for the {@code KafkaStreams} instance with the provide {@code storeName} and
+     * {@code key} of this application or {@link StreamsMetadata#NOT_AVAILABLE} if Kafka Streams is (re-)initializing
      */
     public <K> StreamsMetadata metadataForKey(final String storeName,
                                               final K key,
@@ -589,19 +653,28 @@ public <K> StreamsMetadata metadataForKey(final String storeName,
     }
 
     /**
-     * Find the {@link StreamsMetadata} instance that contains the given storeName
-     * and the corresponding hosted store instance contains the given key
-     *
-     * Note: the key may not exist in the {@link org.apache.kafka.streams.processor.StateStore},
-     * this method provides a way of finding which host it would exist on.
+     * Find the currently running {@code KafkaStreams} instance (potentially remotely) that
+     * <ul>
+     *   <li>use the same {@link StreamsConfig#APPLICATION_ID_CONFIG application ID} as this instance (i.e., all
+     *       instances that belong to the same Kafka Streams application)</li>
+     *   <li>and that contain a {@link StateStore} with the given {@code storeName}</li>
+     *   <li>and the {@link StateStore} contains the given {@code key}</li>
+     * </ul>
+     * and return {@link StreamsMetadata} for it.
+     * <p>
+     * Note:
+     * <ul>
+     *   <li>this is a point in time view and it may change due to partition reassignment</li>
+     *   <li>the key may not exist in the {@link StateStore}; this method provides a way of finding which host it
+     *       <em>would</em> exist on</li>
+     * </ul>
      *
-     * Note: this is a point in time view and it may change due to partition reassignment.
-     * @param storeName         Name of the store
-     * @param key               Key to use to for partition
-     * @param partitioner       Partitioner for the store
-     * @param <K>               key type
-     * @return  The {@link StreamsMetadata} for the storeName and key or {@link StreamsMetadata#NOT_AVAILABLE}
-     * if streams is (re-)initializing
+     * @param storeName   the {@code storeName} to find metadata for
+     * @param key         the key to find metadata for
+     * @param partitioner the partitioner to be use to locate the host for the key
+     * @param <K>         key type
+     * @return {@link StreamsMetadata} for the {@code KafkaStreams} instance with the provide {@code storeName} and
+     * {@code key} of this application or {@link StreamsMetadata#NOT_AVAILABLE} if Kafka Streams is (re-)initializing
      */
     public <K> StreamsMetadata metadataForKey(final String storeName,
                                               final K key,
@@ -610,17 +683,17 @@ public <K> StreamsMetadata metadataForKey(final String storeName,
         return streamsMetadataState.getMetadataWithKey(storeName, key, partitioner);
     }
 
-
     /**
-     * Get a facade wrapping the {@link org.apache.kafka.streams.processor.StateStore} instances
-     * with the provided storeName and accepted by {@link QueryableStoreType#accepts(StateStore)}.
-     * The returned object can be used to query the {@link org.apache.kafka.streams.processor.StateStore} instances
-     * @param storeName             name of the store to find
-     * @param queryableStoreType    accept only stores that are accepted by {@link QueryableStoreType#accepts(StateStore)}
-     * @param <T>                   return type
-     * @return  A facade wrapping the {@link org.apache.kafka.streams.processor.StateStore} instances
-     * @throws org.apache.kafka.streams.errors.InvalidStateStoreException if the streams are (re-)initializing or
-     * a store with storeName and queryableStoreType doesnt' exist.
+     * Get a facade wrapping the local {@link StateStore} instances with the provided {@code storeName} if the Store's
+     * type is accepted by the provided {@link QueryableStoreType#accepts(StateStore) queryableStoreType}.
+     * The returned object can be used to query the {@link StateStore} instances.
+     *
+     * @param storeName           name of the store to find
+     * @param queryableStoreType  accept only stores that are accepted by {@link QueryableStoreType#accepts(StateStore)}
+     * @param <T>                 return type
+     * @return A facade wrapping the local {@link StateStore} instances
+     * @throws InvalidStateStoreException if Kafka Streams is (re-)initializing or a store with {@code storeName} and
+     * {@code queryableStoreType} doesnt' exist
      */
     public <T> T store(final String storeName, final QueryableStoreType<T> queryableStoreType) {
         validateIsRunning();
@@ -629,7 +702,7 @@ public <T> T store(final String storeName, final QueryableStoreType<T> queryable
 
     private void validateIsRunning() {
         if (!state.isRunning()) {
-            throw new IllegalStateException("KafkaStreams is not running. State is " + state);
+            throw new IllegalStateException("KafkaStreams is not running. State is " + state + ".");
         }
     }
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/KeyValue.java b/streams/src/main/java/org/apache/kafka/streams/KeyValue.java
index 64b38cdfbf36c..0c1d2afbcba3c 100644
--- a/streams/src/main/java/org/apache/kafka/streams/KeyValue.java
+++ b/streams/src/main/java/org/apache/kafka/streams/KeyValue.java
@@ -21,8 +21,7 @@
 
 /**
  * A key-value pair defined for a single Kafka Streams record.
- * If the record comes directly from a Kafka topic then its
- * key / value are defined as the message key / value.
+ * If the record comes directly from a Kafka topic then its key/value are defined as the message key/value.
  *
  * @param <K> Key type
  * @param <V> Value type
@@ -37,10 +36,10 @@ public class KeyValue<K, V> {
     /**
      * Create a new key-value pair.
      *
-     * @param key    the key
-     * @param value  the value
+     * @param key   the key
+     * @param value the value
      */
-    public KeyValue(K key, V value) {
+    public KeyValue(final K key, final V value) {
         this.key = key;
         this.value = value;
     }
@@ -48,22 +47,23 @@ public KeyValue(K key, V value) {
     /**
      * Create a new key-value pair.
      *
-     * @param key    the key
-     * @param value  the value
-     * @param <K>    the type of the key
-     * @param <V>    the type of the value
-     * @return       a new key value pair
+     * @param key   the key
+     * @param value the value
+     * @param <K>   the type of the key
+     * @param <V>   the type of the value
+     * @return a new key-value pair
      */
-    public static <K, V> KeyValue<K, V> pair(K key, V value) {
+    public static <K, V> KeyValue<K, V> pair(final K key, final V value) {
         return new KeyValue<>(key, value);
     }
 
+    @Override
     public String toString() {
         return "KeyValue(" + key + ", " + value + ")";
     }
 
     @Override
-    public boolean equals(Object obj) {
+    public boolean equals(final Object obj) {
         if (this == obj)
             return true;
 
@@ -71,9 +71,9 @@ public boolean equals(Object obj) {
             return false;
         }
 
-        KeyValue other = (KeyValue) obj;
-        return (this.key == null ? other.key == null : this.key.equals(other.key))
-                && (this.value == null ? other.value == null : this.value.equals(other.value));
+        final KeyValue other = (KeyValue) obj;
+        return (key == null ? other.key == null : key.equals(other.key))
+                && (value == null ? other.value == null : value.equals(other.value));
     }
 
     @Override
diff --git a/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java b/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java
index d7d65662f58a5..57db027e83ea0 100644
--- a/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java
+++ b/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java
@@ -19,6 +19,8 @@
 
 import org.apache.kafka.clients.CommonClientConfigs;
 import org.apache.kafka.clients.consumer.ConsumerConfig;
+import org.apache.kafka.clients.consumer.KafkaConsumer;
+import org.apache.kafka.clients.producer.KafkaProducer;
 import org.apache.kafka.clients.producer.ProducerConfig;
 import org.apache.kafka.common.config.AbstractConfig;
 import org.apache.kafka.common.config.ConfigDef;
@@ -29,8 +31,8 @@
 import org.apache.kafka.common.serialization.Serde;
 import org.apache.kafka.common.serialization.Serdes;
 import org.apache.kafka.streams.errors.StreamsException;
-import org.apache.kafka.streams.processor.FailOnInvalidTimestamp;
 import org.apache.kafka.streams.processor.DefaultPartitionGrouper;
+import org.apache.kafka.streams.processor.FailOnInvalidTimestamp;
 import org.apache.kafka.streams.processor.internals.StreamPartitionAssignor;
 import org.apache.kafka.streams.processor.internals.StreamThread;
 
@@ -43,303 +45,345 @@
 import static org.apache.kafka.common.config.ConfigDef.ValidString.in;
 
 /**
- * Configuration for Kafka Streams. Documentation for these configurations can be found in the <a
- * href="http://kafka.apache.org/documentation.html#streamsconfigs">Kafka documentation</a>
+ * Configuration for a {@link KafkaStreams} instance.
+ * Can also be use to configure the Kafka Streams internal {@link KafkaConsumer} and {@link KafkaProducer}.
+ * To avoid consumer/producer property conflicts, you should prefix those properties using
+ * {@link #consumerPrefix(String)} and {@link #producerPrefix(String)}, respectively.
+ * <p>
+ * Example:
+ * <pre>{@code
+ * // potentially wrong: sets "metadata.max.age.ms" to 1 minute for producer AND consumer
+ * Properties streamsProperties = new Properties();
+ * streamsProperties.put(ConsumerConfig.METADATA_MAX_AGE_CONFIG, 60000);
+ * // or
+ * streamsProperties.put(ProducerConfig.METADATA_MAX_AGE_CONFIG, 60000);
+ *
+ * // suggested:
+ * Properties streamsProperties = new Properties();
+ * // sets "metadata.max.age.ms" to 1 minute for consumer only
+ * streamsProperties.put(StreamsConfig.consumerPrefix(ConsumerConfig.METADATA_MAX_AGE_CONFIG), 60000);
+ * // sets "metadata.max.age.ms" to 1 minute for producer only
+ * streamsProperties.put(StreamsConfig.producerPrefix(ProducerConfig.METADATA_MAX_AGE_CONFIG), 60000);
+ *
+ * StreamsConfig streamsConfig = new StreamsConfig(streamsProperties);
+ * }</pre>
+ * Kafka Streams required to set at least properties {@link #APPLICATION_ID_CONFIG "application.id"} and
+ * {@link #BOOTSTRAP_SERVERS_CONFIG "bootstrap.servers"}.
+ * Furthermore, it is not allowed to enable {@link ConsumerConfig#ENABLE_AUTO_COMMIT_CONFIG "enable.auto.commit"} that
+ * is disabled by Kafka Streams by default.
+ *
+ * @see KafkaStreams#KafkaStreams(org.apache.kafka.streams.processor.TopologyBuilder, StreamsConfig)
+ * @see ConsumerConfig
+ * @see ProducerConfig
  */
 public class StreamsConfig extends AbstractConfig {
 
     private static final ConfigDef CONFIG;
 
-    // Prefix used to isolate consumer configs from producer configs.
+    /**
+     * Prefix used to isolate {@link KafkaConsumer consumer} configs from {@link KafkaProducer producer} configs.
+     * It is recommended to use {@link #consumerPrefix(String)} to add this prefix to {@link ConsumerConfig consumer
+     * properties}.
+     */
     public static final String CONSUMER_PREFIX = "consumer.";
 
     // Prefix used to isolate producer configs from consumer configs.
+    /**
+     * Prefix used to isolate {@link KafkaProducer producer} configs from {@link KafkaConsumer consumer} configs.
+     * It is recommended to use {@link #producerPrefix(String)} to add this prefix to {@link ProducerConfig producer
+     * properties}.
+     */
     public static final String PRODUCER_PREFIX = "producer.";
 
-    /** <code>state.dir</code> */
+    /** {@code state.dir} */
     public static final String STATE_DIR_CONFIG = "state.dir";
     private static final String STATE_DIR_DOC = "Directory location for state store.";
 
-    /** <code>zookeeper.connect<code/> */
+    /**
+     * {@code zookeeper.connect}
+     * @deprecated Kakfa Streams does not use Zookeeper anymore and this parameter will be ignored.
+     */
+    @Deprecated
     public static final String ZOOKEEPER_CONNECT_CONFIG = "zookeeper.connect";
     private static final String ZOOKEEPER_CONNECT_DOC = "Zookeeper connect string for Kafka topics management.";
 
-    /** <code>commit.interval.ms</code> */
+    /** {@code commit.interval.ms} */
     public static final String COMMIT_INTERVAL_MS_CONFIG = "commit.interval.ms";
     private static final String COMMIT_INTERVAL_MS_DOC = "The frequency with which to save the position of the processor.";
 
-    /** <code>poll.ms</code> */
+    /** {@code poll.ms} */
     public static final String POLL_MS_CONFIG = "poll.ms";
     private static final String POLL_MS_DOC = "The amount of time in milliseconds to block waiting for input.";
 
-    /** <code>num.stream.threads</code> */
+    /** {@code num.stream.threads} */
     public static final String NUM_STREAM_THREADS_CONFIG = "num.stream.threads";
     private static final String NUM_STREAM_THREADS_DOC = "The number of threads to execute stream processing.";
 
-    /** <code>num.standby.replicas</code> */
+    /** {@code num.standby.replicas} */
     public static final String NUM_STANDBY_REPLICAS_CONFIG = "num.standby.replicas";
     private static final String NUM_STANDBY_REPLICAS_DOC = "The number of standby replicas for each task.";
 
-    /** <code>buffered.records.per.partition</code> */
+    /** {@code buffered.records.per.partition} */
     public static final String BUFFERED_RECORDS_PER_PARTITION_CONFIG = "buffered.records.per.partition";
     private static final String BUFFERED_RECORDS_PER_PARTITION_DOC = "The maximum number of records to buffer per partition.";
 
-    /** <code>state.cleanup.delay</code> */
+    /** {@code state.cleanup.delay} */
     public static final String STATE_CLEANUP_DELAY_MS_CONFIG = "state.cleanup.delay.ms";
     private static final String STATE_CLEANUP_DELAY_MS_DOC = "The amount of time in milliseconds to wait before deleting state when a partition has migrated.";
 
-    /** <code>timestamp.extractor</code> */
+    /** {@code timestamp.extractor} */
     public static final String TIMESTAMP_EXTRACTOR_CLASS_CONFIG = "timestamp.extractor";
     private static final String TIMESTAMP_EXTRACTOR_CLASS_DOC = "Timestamp extractor class that implements the <code>TimestampExtractor</code> interface.";
 
-    /** <code>partition.grouper</code> */
+    /** {@code partition.grouper} */
     public static final String PARTITION_GROUPER_CLASS_CONFIG = "partition.grouper";
     private static final String PARTITION_GROUPER_CLASS_DOC = "Partition grouper class that implements the <code>PartitionGrouper</code> interface.";
 
-    /** <code>application.id</code> */
+    /** {@code application.id} */
     public static final String APPLICATION_ID_CONFIG = "application.id";
-    public static final String APPLICATION_ID_DOC = "An identifier for the stream processing application. Must be unique within the Kafka cluster. It is used as 1) the default client-id prefix, 2) the group-id for membership management, 3) the changelog topic prefix.";
+    private static final String APPLICATION_ID_DOC = "An identifier for the stream processing application. Must be unique within the Kafka cluster. It is used as 1) the default client-id prefix, 2) the group-id for membership management, 3) the changelog topic prefix.";
 
-    /** <code>replication.factor</code> */
+    /** {@code replication.factor} */
     public static final String REPLICATION_FACTOR_CONFIG = "replication.factor";
-    public static final String REPLICATION_FACTOR_DOC = "The replication factor for change log topics and repartition topics created by the stream processing application.";
+    private static final String REPLICATION_FACTOR_DOC = "The replication factor for change log topics and repartition topics created by the stream processing application.";
 
-    /** <code>key.serde</code> */
+    /** {@code key.serde} */
     public static final String KEY_SERDE_CLASS_CONFIG = "key.serde";
-    public static final String KEY_SERDE_CLASS_DOC = "Serializer / deserializer class for key that implements the <code>Serde</code> interface.";
+    private static final String KEY_SERDE_CLASS_DOC = "Serializer / deserializer class for key that implements the <code>Serde</code> interface.";
 
-    /** <code>value.serde</code> */
+    /** {@code value.serde} */
     public static final String VALUE_SERDE_CLASS_CONFIG = "value.serde";
-    public static final String VALUE_SERDE_CLASS_DOC = "Serializer / deserializer class for value that implements the <code>Serde</code> interface.";
+    private static final String VALUE_SERDE_CLASS_DOC = "Serializer / deserializer class for value that implements the <code>Serde</code> interface.";
 
-    /**<code>user.endpoint</code> */
+    /**{@code user.endpoint} */
     public static final String APPLICATION_SERVER_CONFIG = "application.server";
-    public static final String APPLICATION_SERVER_DOC = "A host:port pair pointing to an embedded user defined endpoint that can be used for discovering the locations of state stores within a single KafkaStreams application";
+    private static final String APPLICATION_SERVER_DOC = "A host:port pair pointing to an embedded user defined endpoint that can be used for discovering the locations of state stores within a single KafkaStreams application";
 
-    /** <code>metrics.sample.window.ms</code> */
+    /** {@code metrics.sample.window.ms} */
     public static final String METRICS_SAMPLE_WINDOW_MS_CONFIG = CommonClientConfigs.METRICS_SAMPLE_WINDOW_MS_CONFIG;
 
-    /** <code>metrics.num.samples</code> */
+    /** {@code metrics.num.samples} */
     public static final String METRICS_NUM_SAMPLES_CONFIG = CommonClientConfigs.METRICS_NUM_SAMPLES_CONFIG;
 
-    /** <code>metrics.record.level</code> */
+    /** {@code metrics.record.level} */
     public static final String METRICS_RECORDING_LEVEL_CONFIG = CommonClientConfigs.METRICS_RECORDING_LEVEL_CONFIG;
 
-    /** <code>metric.reporters</code> */
+    /** {@code metric.reporters} */
     public static final String METRIC_REPORTER_CLASSES_CONFIG = CommonClientConfigs.METRIC_REPORTER_CLASSES_CONFIG;
 
-    /** <code>bootstrap.servers</code> */
+    /** {@code bootstrap.servers} */
     public static final String BOOTSTRAP_SERVERS_CONFIG = CommonClientConfigs.BOOTSTRAP_SERVERS_CONFIG;
 
-    /** <code>client.id</code> */
+    /** {@code client.id} */
     public static final String CLIENT_ID_CONFIG = CommonClientConfigs.CLIENT_ID_CONFIG;
 
-    /** <code>rocksdb.config.setter</code> */
+    /** {@code rocksdb.config.setter} */
     public static final String ROCKSDB_CONFIG_SETTER_CLASS_CONFIG = "rocksdb.config.setter";
-    public static final String ROCKSDB_CONFIG_SETTER_CLASS_DOC = "A Rocks DB config setter class that implements the <code>RocksDBConfigSetter</code> interface";
+    private static final String ROCKSDB_CONFIG_SETTER_CLASS_DOC = "A Rocks DB config setter class that implements the <code>RocksDBConfigSetter</code> interface";
 
-    /** <code>windowstore.changelog.additional.retention.ms</code> */
+    /** {@code windowstore.changelog.additional.retention.ms} */
     public static final String WINDOW_STORE_CHANGE_LOG_ADDITIONAL_RETENTION_MS_CONFIG = "windowstore.changelog.additional.retention.ms";
-    public static final String WINDOW_STORE_CHANGE_LOG_ADDITIONAL_RETENTION_MS_DOC = "Added to a windows maintainMs to ensure data is not deleted from the log prematurely. Allows for clock drift. Default is 1 day";
+    private static final String WINDOW_STORE_CHANGE_LOG_ADDITIONAL_RETENTION_MS_DOC = "Added to a windows maintainMs to ensure data is not deleted from the log prematurely. Allows for clock drift. Default is 1 day";
 
-    /** <code>cache.max.bytes.buffering</code> */
+    /** {@code cache.max.bytes.buffering} */
     public static final String CACHE_MAX_BYTES_BUFFERING_CONFIG = "cache.max.bytes.buffering";
-    public static final String CACHE_MAX_BYTES_BUFFERING_DOC = "Maximum number of memory bytes to be used for buffering across all threads";
+    private static final String CACHE_MAX_BYTES_BUFFERING_DOC = "Maximum number of memory bytes to be used for buffering across all threads";
 
     public static final String SECURITY_PROTOCOL_CONFIG = CommonClientConfigs.SECURITY_PROTOCOL_CONFIG;
-    public static final String SECURITY_PROTOCOL_DOC = CommonClientConfigs.SECURITY_PROTOCOL_DOC;
+    private static final String SECURITY_PROTOCOL_DOC = CommonClientConfigs.SECURITY_PROTOCOL_DOC;
     public static final String DEFAULT_SECURITY_PROTOCOL = CommonClientConfigs.DEFAULT_SECURITY_PROTOCOL;
 
     public static final String CONNECTIONS_MAX_IDLE_MS_CONFIG = CommonClientConfigs.CONNECTIONS_MAX_IDLE_MS_CONFIG;
-    public static final String CONNECTIONS_MAX_IDLE_MS_DOC = CommonClientConfigs.CONNECTIONS_MAX_IDLE_MS_DOC;
+    private static final String CONNECTIONS_MAX_IDLE_MS_DOC = CommonClientConfigs.CONNECTIONS_MAX_IDLE_MS_DOC;
 
     public static final String RETRY_BACKOFF_MS_CONFIG = CommonClientConfigs.RETRY_BACKOFF_MS_CONFIG;
-    public static final String RETRY_BACKOFF_MS_DOC = CommonClientConfigs.RETRY_BACKOFF_MS_DOC;
+    private static final String RETRY_BACKOFF_MS_DOC = CommonClientConfigs.RETRY_BACKOFF_MS_DOC;
 
     public static final String METADATA_MAX_AGE_CONFIG = CommonClientConfigs.METADATA_MAX_AGE_CONFIG;
-    public static final String METADATA_MAX_AGE_DOC = CommonClientConfigs.METADATA_MAX_AGE_DOC;
+    private static final String METADATA_MAX_AGE_DOC = CommonClientConfigs.METADATA_MAX_AGE_DOC;
 
     public static final String RECONNECT_BACKOFF_MS_CONFIG = CommonClientConfigs.RECONNECT_BACKOFF_MS_CONFIG;
-    public static final String RECONNECT_BACKOFF_MS_DOC = CommonClientConfigs.RECONNECT_BACKOFF_MS_DOC;
+    private static final String RECONNECT_BACKOFF_MS_DOC = CommonClientConfigs.RECONNECT_BACKOFF_MS_DOC;
 
     public static final String SEND_BUFFER_CONFIG = CommonClientConfigs.SEND_BUFFER_CONFIG;
-    public static final String SEND_BUFFER_DOC = CommonClientConfigs.SEND_BUFFER_DOC;
+    private static final String SEND_BUFFER_DOC = CommonClientConfigs.SEND_BUFFER_DOC;
 
     public static final String RECEIVE_BUFFER_CONFIG = CommonClientConfigs.RECEIVE_BUFFER_CONFIG;
-    public static final String RECEIVE_BUFFER_DOC = CommonClientConfigs.RECEIVE_BUFFER_DOC;
+    private static final String RECEIVE_BUFFER_DOC = CommonClientConfigs.RECEIVE_BUFFER_DOC;
 
     public static final String REQUEST_TIMEOUT_MS_CONFIG = CommonClientConfigs.REQUEST_TIMEOUT_MS_CONFIG;
-    public static final String REQUEST_TIMEOUT_MS_DOC = CommonClientConfigs.REQUEST_TIMEOUT_MS_DOC;
+    private static final String REQUEST_TIMEOUT_MS_DOC = CommonClientConfigs.REQUEST_TIMEOUT_MS_DOC;
 
     static {
-        CONFIG = new ConfigDef().define(APPLICATION_ID_CONFIG,      // required with no default value
-                Type.STRING,
-                Importance.HIGH,
-                StreamsConfig.APPLICATION_ID_DOC)
-                .define(BOOTSTRAP_SERVERS_CONFIG,       // required with no default value
-                        Type.LIST,
-                        Importance.HIGH,
-                        CommonClientConfigs.BOOTSTRAP_SERVERS_DOC)
-                .define(CLIENT_ID_CONFIG,
-                        Type.STRING,
-                        "",
-                        Importance.HIGH,
-                        CommonClientConfigs.CLIENT_ID_DOC)
-                .define(ZOOKEEPER_CONNECT_CONFIG,
-                        Type.STRING,
-                        "",
-                        Importance.HIGH,
-                        StreamsConfig.ZOOKEEPER_CONNECT_DOC)
-                .define(STATE_DIR_CONFIG,
-                        Type.STRING,
-                        "/tmp/kafka-streams",
-                        Importance.MEDIUM,
-                        STATE_DIR_DOC)
-                .define(REPLICATION_FACTOR_CONFIG,
-                        Type.INT,
-                        1,
-                        Importance.MEDIUM,
-                        REPLICATION_FACTOR_DOC)
-                .define(TIMESTAMP_EXTRACTOR_CLASS_CONFIG,
-                        Type.CLASS,
-                        FailOnInvalidTimestamp.class.getName(),
-                        Importance.MEDIUM,
-                        TIMESTAMP_EXTRACTOR_CLASS_DOC)
-                .define(PARTITION_GROUPER_CLASS_CONFIG,
-                        Type.CLASS,
-                        DefaultPartitionGrouper.class.getName(),
-                        Importance.MEDIUM,
-                        PARTITION_GROUPER_CLASS_DOC)
-                .define(KEY_SERDE_CLASS_CONFIG,
-                        Type.CLASS,
-                        Serdes.ByteArraySerde.class.getName(),
-                        Importance.MEDIUM,
-                        KEY_SERDE_CLASS_DOC)
-                .define(VALUE_SERDE_CLASS_CONFIG,
-                        Type.CLASS,
-                        Serdes.ByteArraySerde.class.getName(),
-                        Importance.MEDIUM,
-                        VALUE_SERDE_CLASS_DOC)
-                .define(COMMIT_INTERVAL_MS_CONFIG,
-                        Type.LONG,
-                        30000,
-                        Importance.LOW,
-                        COMMIT_INTERVAL_MS_DOC)
-                .define(POLL_MS_CONFIG,
-                        Type.LONG,
-                        100,
-                        Importance.LOW,
-                        POLL_MS_DOC)
-                .define(NUM_STREAM_THREADS_CONFIG,
-                        Type.INT,
-                        1,
-                        Importance.LOW,
-                        NUM_STREAM_THREADS_DOC)
-                .define(NUM_STANDBY_REPLICAS_CONFIG,
-                        Type.INT,
-                        0,
-                        Importance.LOW,
-                        NUM_STANDBY_REPLICAS_DOC)
-                .define(BUFFERED_RECORDS_PER_PARTITION_CONFIG,
-                        Type.INT,
-                        1000,
-                        Importance.LOW,
-                        BUFFERED_RECORDS_PER_PARTITION_DOC)
-                .define(STATE_CLEANUP_DELAY_MS_CONFIG,
-                        Type.LONG,
-                        60000,
-                        Importance.LOW,
-                        STATE_CLEANUP_DELAY_MS_DOC)
-                .define(METRIC_REPORTER_CLASSES_CONFIG,
-                        Type.LIST,
-                        "",
-                        Importance.LOW,
-                        CommonClientConfigs.METRIC_REPORTER_CLASSES_DOC)
-                .define(METRICS_SAMPLE_WINDOW_MS_CONFIG,
-                        Type.LONG,
-                        30000,
-                        atLeast(0),
-                        Importance.LOW,
-                        CommonClientConfigs.METRICS_SAMPLE_WINDOW_MS_DOC)
-                .define(METRICS_NUM_SAMPLES_CONFIG,
-                        Type.INT,
-                        2,
-                        atLeast(1),
-                        Importance.LOW,
-                        CommonClientConfigs.METRICS_NUM_SAMPLES_DOC)
-                .define(METRICS_RECORDING_LEVEL_CONFIG,
-                        Type.STRING,
-                        Sensor.RecordingLevel.INFO.toString(),
-                        in(Sensor.RecordingLevel.INFO.toString(), Sensor.RecordingLevel.DEBUG.toString()),
-                        Importance.LOW,
-                        CommonClientConfigs.METRICS_RECORDING_LEVEL_DOC)
-                .define(APPLICATION_SERVER_CONFIG,
-                        Type.STRING,
-                        "",
-                        Importance.LOW,
-                        APPLICATION_SERVER_DOC)
-                .define(ROCKSDB_CONFIG_SETTER_CLASS_CONFIG,
-                        Type.CLASS,
-                        null,
-                        Importance.LOW,
-                        ROCKSDB_CONFIG_SETTER_CLASS_DOC)
-                .define(WINDOW_STORE_CHANGE_LOG_ADDITIONAL_RETENTION_MS_CONFIG,
-                        Type.LONG,
-                        24 * 60 * 60 * 1000,
-                        Importance.MEDIUM,
-                        WINDOW_STORE_CHANGE_LOG_ADDITIONAL_RETENTION_MS_DOC)
-                .define(CACHE_MAX_BYTES_BUFFERING_CONFIG,
-                        Type.LONG,
-                        10 * 1024 * 1024L,
-                        atLeast(0),
-                        Importance.LOW,
-                        CACHE_MAX_BYTES_BUFFERING_DOC)
-                .define(SECURITY_PROTOCOL_CONFIG,
-                        Type.STRING,
-                        DEFAULT_SECURITY_PROTOCOL,
-                        Importance.MEDIUM,
-                        SECURITY_PROTOCOL_DOC)
-                .define(CONNECTIONS_MAX_IDLE_MS_CONFIG,
-                        ConfigDef.Type.LONG,
-                        9 * 60 * 1000,
-                        ConfigDef.Importance.MEDIUM,
-                        CONNECTIONS_MAX_IDLE_MS_DOC)
-                .define(RETRY_BACKOFF_MS_CONFIG,
-                        ConfigDef.Type.LONG,
-                        100L,
-                        atLeast(0L),
-                        ConfigDef.Importance.LOW,
-                        RETRY_BACKOFF_MS_DOC)
-                .define(METADATA_MAX_AGE_CONFIG,
-                        ConfigDef.Type.LONG,
-                        5 * 60 * 1000,
-                        atLeast(0),
-                        ConfigDef.Importance.LOW,
-                        METADATA_MAX_AGE_DOC)
-                .define(RECONNECT_BACKOFF_MS_CONFIG,
-                        ConfigDef.Type.LONG,
-                        50L,
-                        atLeast(0L),
-                        ConfigDef.Importance.LOW,
-                        RECONNECT_BACKOFF_MS_DOC)
-                .define(SEND_BUFFER_CONFIG,
-                        ConfigDef.Type.INT,
-                        128 * 1024,
-                        atLeast(0),
-                        ConfigDef.Importance.MEDIUM,
-                        SEND_BUFFER_DOC)
-                .define(RECEIVE_BUFFER_CONFIG,
-                        ConfigDef.Type.INT,
-                        32 * 1024,
-                        atLeast(0),
-                        ConfigDef.Importance.MEDIUM,
-                        RECEIVE_BUFFER_DOC)
-                .define(REQUEST_TIMEOUT_MS_CONFIG,
-                        ConfigDef.Type.INT,
-                        40 * 1000,
-                        atLeast(0),
-                        ConfigDef.Importance.MEDIUM,
-                        REQUEST_TIMEOUT_MS_DOC);
+        CONFIG = new ConfigDef()
+            .define(APPLICATION_ID_CONFIG, // required with no default value
+                    Type.STRING,
+                    Importance.HIGH,
+                    APPLICATION_ID_DOC)
+            .define(BOOTSTRAP_SERVERS_CONFIG, // required with no default value
+                    Type.LIST,
+                    Importance.HIGH,
+                    CommonClientConfigs.BOOTSTRAP_SERVERS_DOC)
+            .define(CLIENT_ID_CONFIG,
+                    Type.STRING,
+                    "",
+                    Importance.HIGH,
+                    CommonClientConfigs.CLIENT_ID_DOC)
+            .define(ZOOKEEPER_CONNECT_CONFIG,
+                    Type.STRING,
+                    "",
+                    Importance.HIGH,
+                    ZOOKEEPER_CONNECT_DOC)
+            .define(STATE_DIR_CONFIG,
+                    Type.STRING,
+                    "/tmp/kafka-streams",
+                    Importance.MEDIUM,
+                    STATE_DIR_DOC)
+            .define(REPLICATION_FACTOR_CONFIG,
+                    Type.INT,
+                    1,
+                    Importance.MEDIUM,
+                    REPLICATION_FACTOR_DOC)
+            .define(TIMESTAMP_EXTRACTOR_CLASS_CONFIG,
+                    Type.CLASS,
+                    FailOnInvalidTimestamp.class.getName(),
+                    Importance.MEDIUM,
+                    TIMESTAMP_EXTRACTOR_CLASS_DOC)
+            .define(PARTITION_GROUPER_CLASS_CONFIG,
+                    Type.CLASS,
+                    DefaultPartitionGrouper.class.getName(),
+                    Importance.MEDIUM,
+                    PARTITION_GROUPER_CLASS_DOC)
+            .define(KEY_SERDE_CLASS_CONFIG,
+                    Type.CLASS,
+                    Serdes.ByteArraySerde.class.getName(),
+                    Importance.MEDIUM,
+                    KEY_SERDE_CLASS_DOC)
+            .define(VALUE_SERDE_CLASS_CONFIG,
+                    Type.CLASS,
+                    Serdes.ByteArraySerde.class.getName(),
+                    Importance.MEDIUM,
+                    VALUE_SERDE_CLASS_DOC)
+            .define(COMMIT_INTERVAL_MS_CONFIG,
+                    Type.LONG,
+                    30000,
+                    Importance.LOW,
+                    COMMIT_INTERVAL_MS_DOC)
+            .define(POLL_MS_CONFIG,
+                    Type.LONG,
+                    100,
+                    Importance.LOW,
+                    POLL_MS_DOC)
+            .define(NUM_STREAM_THREADS_CONFIG,
+                    Type.INT,
+                    1,
+                    Importance.LOW,
+                    NUM_STREAM_THREADS_DOC)
+            .define(NUM_STANDBY_REPLICAS_CONFIG,
+                    Type.INT,
+                    0,
+                    Importance.LOW,
+                    NUM_STANDBY_REPLICAS_DOC)
+            .define(BUFFERED_RECORDS_PER_PARTITION_CONFIG,
+                    Type.INT,
+                    1000,
+                    Importance.LOW,
+                    BUFFERED_RECORDS_PER_PARTITION_DOC)
+            .define(STATE_CLEANUP_DELAY_MS_CONFIG,
+                    Type.LONG,
+                    60000,
+                    Importance.LOW,
+                    STATE_CLEANUP_DELAY_MS_DOC)
+            .define(METRIC_REPORTER_CLASSES_CONFIG,
+                    Type.LIST,
+                    "",
+                    Importance.LOW,
+                    CommonClientConfigs.METRIC_REPORTER_CLASSES_DOC)
+            .define(METRICS_SAMPLE_WINDOW_MS_CONFIG,
+                    Type.LONG,
+                    30000,
+                    atLeast(0),
+                    Importance.LOW,
+                    CommonClientConfigs.METRICS_SAMPLE_WINDOW_MS_DOC)
+            .define(METRICS_NUM_SAMPLES_CONFIG,
+                    Type.INT,
+                    2,
+                    atLeast(1),
+                    Importance.LOW,
+                    CommonClientConfigs.METRICS_NUM_SAMPLES_DOC)
+            .define(METRICS_RECORDING_LEVEL_CONFIG,
+                    Type.STRING,
+                    Sensor.RecordingLevel.INFO.toString(),
+                    in(Sensor.RecordingLevel.INFO.toString(), Sensor.RecordingLevel.DEBUG.toString()),
+                    Importance.LOW,
+                    CommonClientConfigs.METRICS_RECORDING_LEVEL_DOC)
+            .define(APPLICATION_SERVER_CONFIG,
+                    Type.STRING,
+                    "",
+                    Importance.LOW,
+                    APPLICATION_SERVER_DOC)
+            .define(ROCKSDB_CONFIG_SETTER_CLASS_CONFIG,
+                    Type.CLASS,
+                    null,
+                    Importance.LOW,
+                    ROCKSDB_CONFIG_SETTER_CLASS_DOC)
+            .define(WINDOW_STORE_CHANGE_LOG_ADDITIONAL_RETENTION_MS_CONFIG,
+                    Type.LONG,
+                    24 * 60 * 60 * 1000,
+                    Importance.MEDIUM,
+                    WINDOW_STORE_CHANGE_LOG_ADDITIONAL_RETENTION_MS_DOC)
+            .define(CACHE_MAX_BYTES_BUFFERING_CONFIG,
+                    Type.LONG,
+                    10 * 1024 * 1024L,
+                    atLeast(0),
+                    Importance.LOW,
+                    CACHE_MAX_BYTES_BUFFERING_DOC)
+            .define(SECURITY_PROTOCOL_CONFIG,
+                    Type.STRING,
+                    DEFAULT_SECURITY_PROTOCOL,
+                    Importance.MEDIUM,
+                    SECURITY_PROTOCOL_DOC)
+            .define(CONNECTIONS_MAX_IDLE_MS_CONFIG,
+                    ConfigDef.Type.LONG,
+                    9 * 60 * 1000,
+                    ConfigDef.Importance.MEDIUM,
+                    CONNECTIONS_MAX_IDLE_MS_DOC)
+            .define(RETRY_BACKOFF_MS_CONFIG,
+                    ConfigDef.Type.LONG,
+                    100L,
+                    atLeast(0L),
+                    ConfigDef.Importance.LOW,
+                    RETRY_BACKOFF_MS_DOC)
+            .define(METADATA_MAX_AGE_CONFIG,
+                    ConfigDef.Type.LONG,
+                    5 * 60 * 1000,
+                    atLeast(0),
+                    ConfigDef.Importance.LOW,
+                    METADATA_MAX_AGE_DOC)
+            .define(RECONNECT_BACKOFF_MS_CONFIG,
+                    ConfigDef.Type.LONG,
+                    50L,
+                    atLeast(0L),
+                    ConfigDef.Importance.LOW,
+                    RECONNECT_BACKOFF_MS_DOC)
+            .define(SEND_BUFFER_CONFIG,
+                    ConfigDef.Type.INT,
+                    128 * 1024,
+                    atLeast(0),
+                    ConfigDef.Importance.MEDIUM,
+                    SEND_BUFFER_DOC)
+            .define(RECEIVE_BUFFER_CONFIG,
+                    ConfigDef.Type.INT,
+                    32 * 1024,
+                    atLeast(0),
+                    ConfigDef.Importance.MEDIUM,
+                    RECEIVE_BUFFER_DOC)
+            .define(REQUEST_TIMEOUT_MS_CONFIG,
+                    ConfigDef.Type.INT,
+                    40 * 1000,
+                    atLeast(0),
+                    ConfigDef.Importance.MEDIUM,
+                    REQUEST_TIMEOUT_MS_DOC);
     }
 
     // this is the list of configs for underlying clients
@@ -347,7 +391,7 @@ public class StreamsConfig extends AbstractConfig {
     private static final Map<String, Object> PRODUCER_DEFAULT_OVERRIDES;
     static
     {
-        Map<String, Object> tempProducerDefaultOverrides = new HashMap<>();
+        final Map<String, Object> tempProducerDefaultOverrides = new HashMap<>();
         tempProducerDefaultOverrides.put(ProducerConfig.LINGER_MS_CONFIG, "100");
 
         PRODUCER_DEFAULT_OVERRIDES = Collections.unmodifiableMap(tempProducerDefaultOverrides);
@@ -356,7 +400,7 @@ public class StreamsConfig extends AbstractConfig {
     private static final Map<String, Object> CONSUMER_DEFAULT_OVERRIDES;
     static
     {
-        Map<String, Object> tempConsumerDefaultOverrides = new HashMap<>();
+        final Map<String, Object> tempConsumerDefaultOverrides = new HashMap<>();
         tempConsumerDefaultOverrides.put(ConsumerConfig.MAX_POLL_RECORDS_CONFIG, "1000");
         tempConsumerDefaultOverrides.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
         tempConsumerDefaultOverrides.put(ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG, "false");
@@ -369,160 +413,177 @@ public static class InternalConfig {
     }
 
     /**
-     * Prefix a property with {@link StreamsConfig#CONSUMER_PREFIX}. This is used to isolate consumer configs
-     * from producer configs
-     * @param consumerProp
-     * @return CONSUMER_PREFIX + consumerProp
+     * Prefix a property with {@link #CONSUMER_PREFIX}. This is used to isolate {@link ConsumerConfig consumer configs}
+     * from {@link ProducerConfig producer configs}.
+     *
+     * @param consumerProp the consumer property to be masked
+     * @return {@link #CONSUMER_PREFIX} + {@code consumerProp}
      */
     public static String consumerPrefix(final String consumerProp) {
         return CONSUMER_PREFIX + consumerProp;
     }
 
     /**
-     * Prefix a property with {@link StreamsConfig#PRODUCER_PREFIX}. This is used to isolate producer configs
-     * from consumer configs
-     * @param producerProp
-     * @return PRODUCER_PREFIX + consumerProp
+     * Prefix a property with {@link #PRODUCER_PREFIX}. This is used to isolate {@link ProducerConfig producer configs}
+     * from {@link ConsumerConfig consumer configs}.
+     *
+     * @param producerProp the producer property to be masked
+     * @return PRODUCER_PREFIX + {@code producerProp}
      */
     public static String producerPrefix(final String producerProp) {
         return PRODUCER_PREFIX + producerProp;
     }
 
     /**
-     * Returns a copy of the config definition.
+     * Return a copy of the config definition.
+     *
+     * @return a copy of the config definition
      */
     public static ConfigDef configDef() {
         return new ConfigDef(CONFIG);
     }
 
-    public StreamsConfig(Map<?, ?> props) {
-        super(CONFIG, props);
-    }
-
     /**
-     * Get the configs specific to the Consumer. Properties using the prefix {@link StreamsConfig#CONSUMER_PREFIX}
-     * will be used in favor over their non-prefixed versions except in the case of {@link ConsumerConfig#BOOTSTRAP_SERVERS_CONFIG}
-     * where we always use the non-prefixed version as we only support reading/writing from/to the same Kafka Cluster
-     * @param streamThread   the {@link StreamThread} creating a consumer
-     * @param groupId        consumer groupId
-     * @param clientId       clientId
-     * @return  Map of the Consumer configuration.
-     * @throws ConfigException
+     * Create a new {@code StreamsConfig} using the given properties.
+     *
+     * @param props properties that specify Kafka Streams and internal consumer/producer configuration
      */
-    public Map<String, Object> getConsumerConfigs(StreamThread streamThread, String groupId, String clientId) throws ConfigException {
-
-        final Map<String, Object> consumerProps = new HashMap<>(CONSUMER_DEFAULT_OVERRIDES);
+    public StreamsConfig(final Map<?, ?> props) {
+        super(CONFIG, props);
+    }
 
+    private Map<String, Object> getCommonConsumerConfigs() throws ConfigException {
         final Map<String, Object> clientProvidedProps = getClientPropsWithPrefix(CONSUMER_PREFIX, ConsumerConfig.configNames());
 
         // disable auto commit and throw exception if there is user overridden values,
         // this is necessary for streams commit semantics
         if (clientProvidedProps.containsKey(ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG)) {
             throw new ConfigException("Unexpected user-specified consumer config " + ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG
-                    + ", as the streams client will always turn off auto committing.");
+                + ", as the streams client will always turn off auto committing.");
         }
 
+        final Map<String, Object> consumerProps = new HashMap<>(CONSUMER_DEFAULT_OVERRIDES);
         consumerProps.putAll(clientProvidedProps);
 
         // bootstrap.servers should be from StreamsConfig
-        consumerProps.put(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG, this.originals().get(BOOTSTRAP_SERVERS_CONFIG));
+        consumerProps.put(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG, originals().get(BOOTSTRAP_SERVERS_CONFIG));
+        // remove deprecate ZK config
+        consumerProps.remove(ZOOKEEPER_CONNECT_CONFIG);
+
+        return consumerProps;
+    }
+
+    /**
+     * Get the configs to the {@link KafkaConsumer consumer}.
+     * Properties using the prefix {@link #CONSUMER_PREFIX} will be used in favor over their non-prefixed versions
+     * except in the case of {@link ConsumerConfig#BOOTSTRAP_SERVERS_CONFIG} where we always use the non-prefixed
+     * version as we only support reading/writing from/to the same Kafka Cluster.
+     *
+     * @param streamThread the {@link StreamThread} creating a consumer
+     * @param groupId      consumer groupId
+     * @param clientId     clientId
+     * @return Map of the consumer configuration.
+     * @throws ConfigException if {@code "enable.auto.commit"} was set to {@code false} by the user
+     */
+    public Map<String, Object> getConsumerConfigs(final StreamThread streamThread,
+                                                  final String groupId,
+                                                  final String clientId) throws ConfigException {
+        final Map<String, Object> consumerProps = getCommonConsumerConfigs();
+
         // add client id with stream client id prefix, and group id
         consumerProps.put(ConsumerConfig.GROUP_ID_CONFIG, groupId);
         consumerProps.put(CommonClientConfigs.CLIENT_ID_CONFIG, clientId + "-consumer");
 
         // add configs required for stream partition assignor
-        consumerProps.put(StreamsConfig.InternalConfig.STREAM_THREAD_INSTANCE, streamThread);
-        consumerProps.put(StreamsConfig.REPLICATION_FACTOR_CONFIG, getInt(REPLICATION_FACTOR_CONFIG));
-        consumerProps.put(StreamsConfig.NUM_STANDBY_REPLICAS_CONFIG, getInt(NUM_STANDBY_REPLICAS_CONFIG));
+        consumerProps.put(InternalConfig.STREAM_THREAD_INSTANCE, streamThread);
+        consumerProps.put(REPLICATION_FACTOR_CONFIG, getInt(REPLICATION_FACTOR_CONFIG));
+        consumerProps.put(NUM_STANDBY_REPLICAS_CONFIG, getInt(NUM_STANDBY_REPLICAS_CONFIG));
         consumerProps.put(ConsumerConfig.PARTITION_ASSIGNMENT_STRATEGY_CONFIG, StreamPartitionAssignor.class.getName());
-        consumerProps.put(StreamsConfig.WINDOW_STORE_CHANGE_LOG_ADDITIONAL_RETENTION_MS_CONFIG, getLong(WINDOW_STORE_CHANGE_LOG_ADDITIONAL_RETENTION_MS_CONFIG));
-        if (!getString(ZOOKEEPER_CONNECT_CONFIG).equals("")) {
-            consumerProps.put(StreamsConfig.ZOOKEEPER_CONNECT_CONFIG, getString(ZOOKEEPER_CONNECT_CONFIG));
-        }
+        consumerProps.put(WINDOW_STORE_CHANGE_LOG_ADDITIONAL_RETENTION_MS_CONFIG, getLong(WINDOW_STORE_CHANGE_LOG_ADDITIONAL_RETENTION_MS_CONFIG));
 
         consumerProps.put(APPLICATION_SERVER_CONFIG, getString(APPLICATION_SERVER_CONFIG));
+
         return consumerProps;
     }
 
-
     /**
-     * Get the consumer config for the restore-consumer. Properties using the prefix {@link StreamsConfig#CONSUMER_PREFIX}
-     * will be used in favor over their non-prefixed versions except in the case of {@link ConsumerConfig#BOOTSTRAP_SERVERS_CONFIG}
-     * where we always use the non-prefixed version as we only support reading/writing from/to the same Kafka Cluster
-     * @param clientId  clientId
-     * @return  Map of the Consumer configuration
-     * @throws ConfigException
+     * Get the configs for the {@link KafkaConsumer restore-consumer}.
+     * Properties using the prefix {@link #CONSUMER_PREFIX} will be used in favor over their non-prefixed versions
+     * except in the case of {@link ConsumerConfig#BOOTSTRAP_SERVERS_CONFIG} where we always use the non-prefixed
+     * version as we only support reading/writing from/to the same Kafka Cluster.
+     *
+     * @param clientId clientId
+     * @return Map of the consumer configuration.
+     * @throws ConfigException if {@code "enable.auto.commit"} was set to {@code false} by the user
      */
-    public Map<String, Object> getRestoreConsumerConfigs(String clientId) throws ConfigException {
-        Map<String, Object> consumerProps = new HashMap<>(CONSUMER_DEFAULT_OVERRIDES);
-
-        final Map<String, Object> clientProvidedProps = getClientPropsWithPrefix(CONSUMER_PREFIX, ConsumerConfig.configNames());
-
-        // disable auto commit and throw exception if there is user overridden values,
-        // this is necessary for streams commit semantics
-        if (clientProvidedProps.containsKey(ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG)) {
-            throw new ConfigException("Unexpected user-specified consumer config " + ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG
-                    + ", as the streams client will always turn off auto committing.");
-        }
-
-        consumerProps.putAll(clientProvidedProps);
-
-        // bootstrap.servers should be from StreamsConfig
-        consumerProps.put(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG, this.originals().get(BOOTSTRAP_SERVERS_CONFIG));
+    public Map<String, Object> getRestoreConsumerConfigs(final String clientId) throws ConfigException {
+        final Map<String, Object> consumerProps = getCommonConsumerConfigs();
 
         // no need to set group id for a restore consumer
         consumerProps.remove(ConsumerConfig.GROUP_ID_CONFIG);
-
         // add client id with stream client id prefix
         consumerProps.put(CommonClientConfigs.CLIENT_ID_CONFIG, clientId + "-restore-consumer");
 
         return consumerProps;
     }
 
-
     /**
-     * Get the configs for the Producer. Properties using the prefix {@link StreamsConfig#PRODUCER_PREFIX}
-     * will be used in favor over their non-prefixed versions except in the case of {@link ProducerConfig#BOOTSTRAP_SERVERS_CONFIG}
-     * where we always use the non-prefixed version as we only support reading/writing from/to the same Kafka Cluster
-     * @param clientId  clientId
-     * @return  Map of the Consumer configuration
-     * @throws ConfigException
+     * Get the configs for the {@link KafkaProducer producer}.
+     * Properties using the prefix {@link #PRODUCER_PREFIX} will be used in favor over their non-prefixed versions
+     * except in the case of {@link ProducerConfig#BOOTSTRAP_SERVERS_CONFIG} where we always use the non-prefixed
+     * version as we only support reading/writing from/to the same Kafka Cluster.
+     *
+     * @param clientId clientId
+     * @return Map of the producer configuration.
      */
-    public Map<String, Object> getProducerConfigs(String clientId) {
+    public Map<String, Object> getProducerConfigs(final String clientId) {
         // generate producer configs from original properties and overridden maps
         final Map<String, Object> props = new HashMap<>(PRODUCER_DEFAULT_OVERRIDES);
         props.putAll(getClientPropsWithPrefix(PRODUCER_PREFIX, ProducerConfig.configNames()));
 
-        props.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, this.originals().get(BOOTSTRAP_SERVERS_CONFIG));
+        props.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, originals().get(BOOTSTRAP_SERVERS_CONFIG));
         // add client id with stream client id prefix
         props.put(CommonClientConfigs.CLIENT_ID_CONFIG, clientId + "-producer");
 
         return props;
     }
 
-    private Map<String, Object> getClientPropsWithPrefix(final String prefix, final Set<String> configNames) {
+    private Map<String, Object> getClientPropsWithPrefix(final String prefix,
+                                                         final Set<String> configNames) {
         final Map<String, Object> props = clientProps(configNames, originals());
-        props.putAll(this.originalsWithPrefix(prefix));
+        props.putAll(originalsWithPrefix(prefix));
         return props;
     }
 
+    /**
+     * Return an {@link Serde#configure(Map, boolean) configured} instance of {@link #KEY_SERDE_CLASS_CONFIG key Serde
+     * class}.
+     *
+     * @return an configured instance of key Serde class
+     */
     public Serde keySerde() {
         try {
-            Serde<?> serde = getConfiguredInstance(StreamsConfig.KEY_SERDE_CLASS_CONFIG, Serde.class);
+            final Serde<?> serde = getConfiguredInstance(KEY_SERDE_CLASS_CONFIG, Serde.class);
             serde.configure(originals(), true);
             return serde;
-        } catch (Exception e) {
-            throw new StreamsException(String.format("Failed to configure key serde %s", get(StreamsConfig.KEY_SERDE_CLASS_CONFIG)), e);
+        } catch (final Exception e) {
+            throw new StreamsException(String.format("Failed to configure key serde %s", get(KEY_SERDE_CLASS_CONFIG)), e);
         }
     }
 
+    /**
+     * Return an {@link Serde#configure(Map, boolean) configured} instance of {@link #VALUE_SERDE_CLASS_CONFIG value
+     * Serde class}.
+     *
+     * @return an configured instance of value Serde class
+     */
     public Serde valueSerde() {
         try {
-            Serde<?> serde = getConfiguredInstance(StreamsConfig.VALUE_SERDE_CLASS_CONFIG, Serde.class);
+            final Serde<?> serde = getConfiguredInstance(VALUE_SERDE_CLASS_CONFIG, Serde.class);
             serde.configure(originals(), false);
             return serde;
-        } catch (Exception e) {
-            throw new StreamsException(String.format("Failed to configure value serde %s", get(StreamsConfig.VALUE_SERDE_CLASS_CONFIG)), e);
+        } catch (final Exception e) {
+            throw new StreamsException(String.format("Failed to configure value serde %s", get(VALUE_SERDE_CLASS_CONFIG)), e);
         }
     }
 
@@ -530,14 +591,15 @@ public Serde valueSerde() {
      * Override any client properties in the original configs with overrides
      *
      * @param configNames The given set of configuration names.
-     * @param originals The original configs to be filtered.
+     * @param originals   The original configs to be filtered.
      * @return client config with any overrides
      */
-    private Map<String, Object> clientProps(Set<String> configNames, Map<String, Object> originals) {
+    private Map<String, Object> clientProps(final Set<String> configNames,
+                                            final Map<String, Object> originals) {
         // iterate all client config names, filter out non-client configs from the original
         // property map and use the overridden values when they are not specified by users
-        Map<String, Object> parsed = new HashMap<>();
-        for (String configName: configNames) {
+        final Map<String, Object> parsed = new HashMap<>();
+        for (final String configName: configNames) {
             if (originals.containsKey(configName)) {
                 parsed.put(configName, originals.get(configName));
             }
@@ -546,7 +608,7 @@ private Map<String, Object> clientProps(Set<String> configNames, Map<String, Obj
         return parsed;
     }
 
-    public static void main(String[] args) {
+    public static void main(final String[] args) {
         System.out.println(CONFIG.toHtmlTable());
     }
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/StreamsMetrics.java b/streams/src/main/java/org/apache/kafka/streams/StreamsMetrics.java
index 7b68137fe55c0..a7bd889862b69 100644
--- a/streams/src/main/java/org/apache/kafka/streams/StreamsMetrics.java
+++ b/streams/src/main/java/org/apache/kafka/streams/StreamsMetrics.java
@@ -31,84 +31,118 @@
 public interface StreamsMetrics {
 
     /**
-     * Get read-only handle on global metrics registry
+     * Get read-only handle on global metrics registry.
+     *
      * @return Map of all metrics.
      */
     Map<MetricName, ? extends Metric> metrics();
 
     /**
-     * Add a latency and throughput sensor and default associated metrics. Metrics include both latency ones
-     * (average and max latency) and throughput ones (operations/time unit).
+     * Add a latency and throughput sensor for a specific operation, which will include the following sensors:
+     * <ol>
+     *   <li>average latency</li>
+     *   <li>max latency</li>
+     *   <li>throughput (num.operations / time unit)</li>
+     * </ol>
+     * Also create a parent sensor with the same metrics that aggregates all entities with the same operation under the
+     * same scope if it has not been created.
      *
-     * @param scopeName Name of the scope, could be the type of the state store, etc.
-     * @param entityName Name of the entity, could be the name of the state store instance, etc.
-     * @param recordingLevel The recording level (e.g., INFO or DEBUG) for this sensor.
-     * @param operationName Name of the operation, could be get / put / delete / etc.
-     * @param tags Additional tags of the sensor.
+     * @param scopeName      name of the scope, could be the type of the state store, etc.
+     * @param entityName     name of the entity, could be the name of the state store instance, etc.
+     * @param operationName  name of the operation, could be get / put / delete / etc.
+     * @param recordingLevel the recording level (e.g., INFO or DEBUG) for this sensor.
+     * @param tags           additional tags of the sensor
      * @return The added sensor.
      */
-    Sensor addLatencyAndThroughputSensor(String scopeName, String entityName, String operationName, Sensor.RecordingLevel recordingLevel, String... tags);
+    Sensor addLatencyAndThroughputSensor(final String scopeName,
+                                         final String entityName,
+                                         final String operationName,
+                                         final Sensor.RecordingLevel recordingLevel,
+                                         final String... tags);
 
     /**
-     * Record the given latency value of the sensor. If the passed sensor includes throughput metrics,
-     * e.g., when created by the {@link #addLatencyAndThroughputSensor(String, String, String, Sensor.RecordingLevel, String...)}
-     * method, then the throughput metrics will also be recorded from this event.
+     * Record the given latency value of the sensor.
+     * If the passed sensor includes throughput metrics, e.g., when created by the
+     * {@link #addLatencyAndThroughputSensor(String, String, String, Sensor.RecordingLevel, String...)} method, then the
+     * throughput metrics will also be recorded from this event.
      *
-     * @param sensor sensor whose latency we are recording.
+     * @param sensor  sensor whose latency we are recording.
      * @param startNs start of measurement time in nanoseconds.
-     * @param endNs end of measurement time in nanoseconds.
+     * @param endNs   end of measurement time in nanoseconds.
      */
-    void recordLatency(Sensor sensor, long startNs, long endNs);
+    void recordLatency(final Sensor sensor,
+                       final long startNs,
+                       final long endNs);
 
     /**
-     * Add a throughput sensor and default associated metrics. Metrics include throughput ones
-     * (operations/time unit). This sensor is a strict subset of the sensor created by
+     * Add a throughput sensor for a specific operation:
+     * <ol>
+     *   <li>throughput (num.operations / time unit)</li>
+     * </ol>
+     * Also create a parent sensor with the same metrics that aggregates all entities with the same operation under the
+     * same scope if it has not been created.
+     * This sensor is a strict subset of the sensors created by
      * {@link #addLatencyAndThroughputSensor(String, String, String, Sensor.RecordingLevel, String...)}.
      *
-     * @param scopeName Name of the scope, could be the type of the state store, etc.
-     * @param entityName Name of the entity, could be the name of the state store instance, etc.
-     * @param recordingLevel The recording level (e.g., INFO or DEBUG) for this sensor.
-     * @param operationName Name of the operation, could be get / put / delete / etc.
-     * @param tags Additional tags of the sensor.
+     * @param scopeName      name of the scope, could be the type of the state store, etc.
+     * @param entityName     name of the entity, could be the name of the state store instance, etc.
+     * @param operationName  name of the operation, could be get / put / delete / etc.
+     * @param recordingLevel the recording level (e.g., INFO or DEBUG) for this sensor.
+     * @param tags           additional tags of the sensor
      * @return The added sensor.
      */
-    Sensor addThroughputSensor(String scopeName, String entityName, String operationName, Sensor.RecordingLevel recordingLevel, String... tags);
+    Sensor addThroughputSensor(final String scopeName,
+                               final String entityName,
+                               final String operationName,
+                               final Sensor.RecordingLevel recordingLevel,
+                               final String... tags);
 
     /**
-     * Records the throughput value of a sensor.
-     * @param sensor addSensor whose throughput we are recording.
-     * @param value throughput value.
+     * Record the throughput value of a sensor.
+     *
+     * @param sensor add Sensor whose throughput we are recording
+     * @param value  throughput value
      */
-    void recordThroughput(Sensor sensor, long value);
+    void recordThroughput(final Sensor sensor,
+                          final long value);
 
 
     /**
      * Generic method to create a sensor.
-     * Note that for most cases it is advisable to use {@link #addThroughputSensor(String, String, String, Sensor.RecordingLevel, String...)}
+     * Note that for most cases it is advisable to use
+     * {@link #addThroughputSensor(String, String, String, Sensor.RecordingLevel, String...)}
      * or {@link #addLatencyAndThroughputSensor(String, String, String, Sensor.RecordingLevel, String...)} to ensure
-     * metric name well-formedness and conformity with the rest of the streams code base. However,
-     * if the above two methods are not sufficient, this method can also be used.
-     * @param name Name of the sensor.
-     * @param recordingLevel The recording level (e.g., INFO or DEBUG) for this sensor.
+     * metric name well-formedness and conformity with the rest of the streams code base.
+     * However, if the above two methods are not sufficient, this method can also be used.
+     *
+     * @param name           name of the sensor.
+     * @param recordingLevel the recording level (e.g., INFO or DEBUG) for this sensor
+     * @return The added sensor.
      */
-    Sensor addSensor(String name, Sensor.RecordingLevel recordingLevel);
+    Sensor addSensor(final String name,
+                     final Sensor.RecordingLevel recordingLevel);
 
     /**
      * Generic method to create a sensor with parent sensors.
-     * Note that for most cases it is advisable to use {@link #addThroughputSensor(String, String, String, Sensor.RecordingLevel, String...)}
+     * Note that for most cases it is advisable to use
+     * {@link #addThroughputSensor(String, String, String, Sensor.RecordingLevel, String...)}
      * or {@link #addLatencyAndThroughputSensor(String, String, String, Sensor.RecordingLevel, String...)} to ensure
-     * metric name well-formedness and conformity with the rest of the streams code base. However,
-     * if the above two methods are not sufficient, this method can also be used.
-     * @param name Name of the sensor.
-     * @param recordingLevel The recording level (e.g., INFO or DEBUG) for this sensor.
+     * metric name well-formedness and conformity with the rest of the streams code base.
+     * However, if the above two methods are not sufficient, this method can also be used.
+     *
+     * @param name           name of the sensor
+     * @param recordingLevel the recording level (e.g., INFO or DEBUG) for this sensor
+     * @return The added sensor.
      */
-    Sensor addSensor(String name, Sensor.RecordingLevel recordingLevel, Sensor... parents);
+    Sensor addSensor(final String name,
+                     final Sensor.RecordingLevel recordingLevel,
+                     final Sensor... parents);
 
     /**
      * Remove a sensor.
-     * @param sensor Sensor to be removed.
+     * @param sensor sensor to be removed
      */
-    void removeSensor(Sensor sensor);
+    void removeSensor(final Sensor sensor);
 }
 
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java
index 6cfd2026ae85f..f1f13381abb6c 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java
@@ -353,6 +353,7 @@ KTable<K, V> reduce(final Reducer<V> reducer,
      * Use {@link StateStoreSupplier#name()} to get the store name:
      * <pre>{@code
      * KafkaStreams streams = ... // compute sum
+     * String storeName = storeSupplier.name();
      * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
      * String key = "some-key";
      * Long sumForKey = localStore.get(key); // key must be local (application state is shared over all running Kafka Streams instances)
@@ -554,9 +555,11 @@ KTable<Windowed<K>, V> reduce(final Reducer<V> reducer,
      * {@link StreamsConfig#COMMIT_INTERVAL_MS_CONFIG commit intervall}.
      * <p>
      * To query the local {@link SessionStore} it must be obtained via
-     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}.
+     * Use {@link StateStoreSupplier#name()} to get the store name:
      * <pre>{@code
      * KafkaStreams streams = ... // compute sum
+     * Sting storeName = storeSupplier.name();
      * ReadOnlySessionStore<String,Long> sessionStore = streams.store(storeName, QueryableStoreTypes.<String, Long>sessionStore());
      * String key = "some-key";
      * KeyValueIterator<Windowed<String>, Long> sumForKeyForSession = localWindowStore.fetch(key); // key must be local (application state is shared over all running Kafka Streams instances)
@@ -666,6 +669,7 @@ <VR> KTable<K, VR> aggregate(final Initializer<VR> initializer,
      * Use {@link StateStoreSupplier#name()} to get the store name:
      * <pre>{@code
      * KafkaStreams streams = ... // some aggregation on value type double
+     * Sting storeName = storeSupplier.name();
      * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
      * String key = "some-key";
      * Long aggForKey = localStore.get(key); // key must be local (application state is shared over all running Kafka Streams instances)
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java
index aecd8abd744d3..8f67d457156bb 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java
@@ -19,15 +19,20 @@
 
 import org.apache.kafka.common.serialization.Deserializer;
 import org.apache.kafka.common.serialization.Serde;
+import org.apache.kafka.streams.KafkaStreams;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.StreamsConfig;
 import org.apache.kafka.streams.kstream.internals.GlobalKTableImpl;
 import org.apache.kafka.streams.kstream.internals.KStreamImpl;
 import org.apache.kafka.streams.kstream.internals.KTableImpl;
 import org.apache.kafka.streams.kstream.internals.KTableSource;
 import org.apache.kafka.streams.kstream.internals.KTableSourceValueGetterSupplier;
 import org.apache.kafka.streams.processor.ProcessorSupplier;
+import org.apache.kafka.streams.processor.StateStore;
 import org.apache.kafka.streams.processor.StateStoreSupplier;
 import org.apache.kafka.streams.processor.TopologyBuilder;
-import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.state.KeyValueStore;
+import org.apache.kafka.streams.state.QueryableStoreType;
 import org.apache.kafka.streams.state.internals.RocksDBKeyValueStoreSupplier;
 
 import java.util.Collections;
@@ -35,113 +40,139 @@
 import java.util.regex.Pattern;
 
 /**
- * {@link KStreamBuilder} is a subclass of {@link TopologyBuilder} that provides the Kafka Streams DSL
- * for users to specify computational logic and translates the given logic to a {@link org.apache.kafka.streams.processor.internals.ProcessorTopology}.
+ * {@link KStreamBuilder} provide the high-level Kafka Streams DSL to specify a Kafka Streams topology.
+ *
+ * @see TopologyBuilder
+ * @see KStream
+ * @see KTable
+ * @see GlobalKTable
  */
 public class KStreamBuilder extends TopologyBuilder {
 
     private final AtomicInteger index = new AtomicInteger(0);
 
     /**
-     * Create a new {@link KStreamBuilder} instance.
-     */
-    public KStreamBuilder() {
-        super();
-    }
-
-    /**
-     * Create a {@link KStream} instance from the specified topics.
-     * The default deserializers specified in the config are used.
+     * Create a {@link KStream} from the specified topics.
+     * The default {@code "auto.offset.reset"} strategy and default key and value deserializers as specified in the
+     * {@link StreamsConfig config} are used.
+     * <p>
+     * If multiple topics are specified there are no ordering guaranteed for records from different topics.
      * <p>
-     * If multiple topics are specified there are nor ordering guaranteed for records from different topics.
+     * Note that the specified input topics must be partitioned by key.
+     * If this is not the case it is the user's responsibility to repartition the date before any key based operation
+     * (like aggregation or join) is applied to the returned {@link KStream}.
      *
-     * @param topics    the topic names; must contain at least one topic name
+     * @param topics the topic names; must contain at least one topic name
      * @return a {@link KStream} for the specified topics
      */
-    public <K, V> KStream<K, V> stream(String... topics) {
+    public <K, V> KStream<K, V> stream(final String... topics) {
         return stream(null, null, null, topics);
     }
 
-
     /**
-     * Create a {@link KStream} instance from the specified topics.
-     * The default deserializers specified in the config are used.
+     * Create a {@link KStream} from the specified topics.
+     * The default key and value deserializers as specified in the {@link StreamsConfig config} are used.
+     * <p>
+     * If multiple topics are specified there are no ordering guaranteed for records from different topics.
      * <p>
-     * If multiple topics are specified there are nor ordering guaranteed for records from different topics.
+     * Note that the specified input topics must be partitioned by key.
+     * If this is not the case it is the user's responsibility to repartition the date before any key based operation
+     * (like aggregation or join) is applied to the returned {@link KStream}.
      *
-     * @param offsetReset the auto offset reset policy to use for this stream if no committed offsets available; acceptable values are earliest or latest
-     * @param topics    the topic names; must contain at least one topic name
+     * @param offsetReset the {@code "auto.offset.reset"} policy to use for the specified topics if no valid committed
+     *                    offsets are available
+     * @param topics      the topic names; must contain at least one topic name
      * @return a {@link KStream} for the specified topics
      */
-    public <K, V> KStream<K, V> stream(AutoOffsetReset offsetReset, String... topics) {
+    public <K, V> KStream<K, V> stream(final AutoOffsetReset offsetReset,
+                                       final String... topics) {
         return stream(offsetReset, null, null, topics);
     }
 
-
     /**
-     * Create a {@link KStream} instance from the specified Pattern.
-     * The default deserializers specified in the config are used.
+     * Create a {@link KStream} from the specified topic pattern.
+     * The default {@code "auto.offset.reset"} strategy and default key and value deserializers as specified in the
+     * {@link StreamsConfig config} are used.
+     * <p>
+     * If multiple topics are matched by the specified pattern, the created {@link KStream} will read data from all of
+     * them and there is no ordering guarantee between records from different topics.
      * <p>
-     * If multiple topics are matched by the specified pattern, the created stream will read data from all of them,
-     * and there is no ordering guarantee between records from different topics
+     * Note that the specified input topics must be partitioned by key.
+     * If this is not the case it is the user's responsibility to repartition the date before any key based operation
+     * (like aggregation or join) is applied to the returned {@link KStream}.
      *
-     * @param topicPattern    the Pattern to match for topic names
+     * @param topicPattern the pattern to match for topic names
      * @return a {@link KStream} for topics matching the regex pattern.
      */
-    public <K, V> KStream<K, V> stream(Pattern topicPattern) {
+    public <K, V> KStream<K, V> stream(final Pattern topicPattern) {
         return stream(null, null, null, topicPattern);
     }
 
     /**
-     * Create a {@link KStream} instance from the specified Pattern.
-     * The default deserializers specified in the config are used.
+     * Create a {@link KStream} from the specified topic pattern.
+     * The default key and value deserializers as specified in the {@link StreamsConfig config} are used.
      * <p>
-     * If multiple topics are matched by the specified pattern, the created stream will read data from all of them,
-     * and there is no ordering guarantee between records from different topics
+     * If multiple topics are matched by the specified pattern, the created {@link KStream} will read data from all of
+     * them and there is no ordering guarantee between records from different topics.
+     * <p>
+     * Note that the specified input topics must be partitioned by key.
+     * If this is not the case it is the user's responsibility to repartition the date before any key based operation
+     * (like aggregation or join) is applied to the returned {@link KStream}.
      *
-     * @param offsetReset the auto offset reset policy to use for this stream if no committed offsets available; acceptable values are earliest or latest
-     * @param topicPattern    the Pattern to match for topic names
+     * @param offsetReset  the {@code "auto.offset.reset"} policy to use for the matched topics if no valid committed
+     *                     offsets are available
+     * @param topicPattern the pattern to match for topic names
      * @return a {@link KStream} for topics matching the regex pattern.
      */
-    public <K, V> KStream<K, V> stream(AutoOffsetReset offsetReset, Pattern topicPattern) {
+    public <K, V> KStream<K, V> stream(final AutoOffsetReset offsetReset, final Pattern topicPattern) {
         return stream(offsetReset, null, null, topicPattern);
     }
 
-
-
     /**
-     * Create a {@link KStream} instance from the specified topics.
+     * Create a {@link KStream} from the specified topics.
+     * The default {@code "auto.offset.reset"} strategy as specified in the {@link StreamsConfig config} is used.
      * <p>
-     * If multiple topics are specified there are nor ordering guaranteed for records from different topics.
+     * If multiple topics are specified there are no ordering guaranteed for records from different topics.
+     * <p>
+     * Note that the specified input topics must be partitioned by key.
+     * If this is not the case it is the user's responsibility to repartition the date before any key based operation
+     * (like aggregation or join) is applied to the returned {@link KStream}.
      *
-     * @param keySerde  key serde used to read this source {@link KStream},
-     *                  if not specified the default serde defined in the configs will be used
-     * @param valSerde  value serde used to read this source {@link KStream},
-     *                  if not specified the default serde defined in the configs will be used
-     * @param topics    the topic names; must contain at least one topic name
+     * @param keySerde key serde used to read this source {@link KStream},
+     *                 if not specified the default serde defined in the configs will be used
+     * @param valSerde value serde used to read this source {@link KStream},
+     *                 if not specified the default serde defined in the configs will be used
+     * @param topics   the topic names; must contain at least one topic name
      * @return a {@link KStream} for the specified topics
      */
-    public <K, V> KStream<K, V> stream(Serde<K> keySerde, Serde<V> valSerde, String... topics) {
+    public <K, V> KStream<K, V> stream(final Serde<K> keySerde, final Serde<V> valSerde, final String... topics) {
         return stream(null, keySerde, valSerde, topics);
     }
 
 
     /**
-     * Create a {@link KStream} instance from the specified topics.
+     * Create a {@link KStream} from the specified topics.
      * <p>
-     * If multiple topics are specified there are nor ordering guaranteed for records from different topics.
-     *
-     * @param offsetReset the auto offset reset policy to use for this stream if no committed offsets available; acceptable values are earliest or latest
+     * If multiple topics are specified there are no ordering guaranteed for records from different topics.
+     * <p>
+     * Note that the specified input topics must be partitioned by key.
+     * If this is not the case it is the user's responsibility to repartition the date before any key based operation
+     * (like aggregation or join) is applied to the returned {@link KStream}.
      *
-     * @param keySerde  key serde used to read this source {@link KStream},
-     *                  if not specified the default serde defined in the configs will be used
-     * @param valSerde  value serde used to read this source {@link KStream},
-     *                  if not specified the default serde defined in the configs will be used
-     * @param topics    the topic names; must contain at least one topic name
+     * @param offsetReset the {@code "auto.offset.reset"} policy to use for the specified topics if no valid committed
+     *                    offsets are available
+     * @param keySerde    key serde used to read this source {@link KStream},
+     *                    if not specified the default serde defined in the configs will be used
+     * @param valSerde    value serde used to read this source {@link KStream},
+     *                    if not specified the default serde defined in the configs will be used
+     * @param topics      the topic names; must contain at least one topic name
      * @return a {@link KStream} for the specified topics
      */
-    public <K, V> KStream<K, V> stream(AutoOffsetReset offsetReset, Serde<K> keySerde, Serde<V> valSerde, String... topics) {
-        String name = newName(KStreamImpl.SOURCE_NAME);
+    public <K, V> KStream<K, V> stream(final AutoOffsetReset offsetReset,
+                                       final Serde<K> keySerde,
+                                       final Serde<V> valSerde,
+                                       final String... topics) {
+        final String name = newName(KStreamImpl.SOURCE_NAME);
 
         addSource(offsetReset, name,  keySerde == null ? null : keySerde.deserializer(), valSerde == null ? null : valSerde.deserializer(), topics);
 
@@ -150,38 +181,53 @@ public <K, V> KStream<K, V> stream(AutoOffsetReset offsetReset, Serde<K> keySerd
 
 
     /**
-     * Create a {@link KStream} instance from the specified Pattern.
+     * Create a {@link KStream} from the specified topic pattern.
+     * The default {@code "auto.offset.reset"} strategy as specified in the {@link StreamsConfig config} is used.
+     * <p>
+     * If multiple topics are matched by the specified pattern, the created {@link KStream} will read data from all of
+     * them and there is no ordering guarantee between records from different topics.
      * <p>
-     * If multiple topics are matched by the specified pattern, the created stream will read data from all of them,
-     * and there is no ordering guarantee between records from different topics.
+     * Note that the specified input topics must be partitioned by key.
+     * If this is not the case it is the user's responsibility to repartition the date before any key based operation
+     * (like aggregation or join) is applied to the returned {@link KStream}.
      *
-     * @param keySerde  key serde used to read this source {@link KStream},
-     *                  if not specified the default serde defined in the configs will be used
-     * @param valSerde  value serde used to read this source {@link KStream},
-     *                  if not specified the default serde defined in the configs will be used
-     * @param topicPattern    the Pattern to match for topic names
-     * @return a {@link KStream} for the specified topics
+     * @param keySerde     key serde used to read this source {@link KStream},
+     *                     if not specified the default serde defined in the configs will be used
+     * @param valSerde     value serde used to read this source {@link KStream},
+     *                     if not specified the default serde defined in the configs will be used
+     * @param topicPattern the pattern to match for topic names
+     * @return a {@link KStream} for topics matching the regex pattern.
      */
-    public <K, V> KStream<K, V> stream(Serde<K> keySerde, Serde<V> valSerde, Pattern topicPattern) {
+    public <K, V> KStream<K, V> stream(final Serde<K> keySerde,
+                                       final Serde<V> valSerde,
+                                       final Pattern topicPattern) {
         return stream(null, keySerde, valSerde, topicPattern);
     }
 
     /**
-     * Create a {@link KStream} instance from the specified Pattern.
+     * Create a {@link KStream} from the specified topic pattern.
      * <p>
-     * If multiple topics are matched by the specified pattern, the created stream will read data from all of them,
-     * and there is no ordering guarantee between records from different topics.
+     * If multiple topics are matched by the specified pattern, the created {@link KStream} will read data from all of
+     * them and there is no ordering guarantee between records from different topics.
+     * <p>
+     * Note that the specified input topics must be partitioned by key.
+     * If this is not the case it is the user's responsibility to repartition the date before any key based operation
+     * (like aggregation or join) is applied to the returned {@link KStream}.
      *
-     * @param offsetReset the auto offset reset policy to use for this stream if no committed offsets available; acceptable values are earliest or latest
-     * @param keySerde  key serde used to read this source {@link KStream},
-     *                  if not specified the default serde defined in the configs will be used
-     * @param valSerde  value serde used to read this source {@link KStream},
-     *                  if not specified the default serde defined in the configs will be used
-     * @param topicPattern    the Pattern to match for topic names
-     * @return a {@link KStream} for the specified topics
+     * @param offsetReset  the {@code "auto.offset.reset"} policy to use for the matched topics if no valid committed
+     *                     offsets are available
+     * @param keySerde     key serde used to read this source {@link KStream},
+     *                     if not specified the default serde defined in the configs will be used
+     * @param valSerde     value serde used to read this source {@link KStream},
+     *                     if not specified the default serde defined in the configs will be used
+     * @param topicPattern the pattern to match for topic names
+     * @return a {@link KStream} for topics matching the regex pattern.
      */
-    public <K, V> KStream<K, V> stream(AutoOffsetReset offsetReset, Serde<K> keySerde, Serde<V> valSerde, Pattern topicPattern) {
-        String name = newName(KStreamImpl.SOURCE_NAME);
+    public <K, V> KStream<K, V> stream(final AutoOffsetReset offsetReset,
+                                       final Serde<K> keySerde,
+                                       final Serde<V> valSerde,
+                                       final Pattern topicPattern) {
+        final String name = newName(KStreamImpl.SOURCE_NAME);
 
         addSource(offsetReset, name, keySerde == null ? null : keySerde.deserializer(), valSerde == null ? null : valSerde.deserializer(), topicPattern);
 
@@ -189,71 +235,152 @@ public <K, V> KStream<K, V> stream(AutoOffsetReset offsetReset, Serde<K> keySerd
     }
 
     /**
-     * Create a {@link KTable} instance for the specified topic.
-     * Record keys of the topic should never by null, otherwise an exception will be thrown at runtime.
-     * The default deserializers specified in the config are used.
-     * The resulting {@link KTable} will be materialized in a local state store with the given store name.
-     * However, no new changelog topic is created in this case since the underlying topic acts as one.
+     * Create a {@link KTable} for the specified topic.
+     * The default {@code "auto.offset.reset"} strategy and default key and value deserializers as specified in the
+     * {@link StreamsConfig config} are used.
+     * Input {@link KeyValue} pairs with {@code null} key will be dropped.
+     * <p>
+     * Note that the specified input topics must be partitioned by key.
+     * If this is not the case the returned {@link KTable} will be corrupted.
+     * <p>
+     * The resulting {@link KTable} will be materialized in a local {@link KeyValueStore} with the given
+     * {@code storeName}.
+     * However, no internal changelog topic is created since the original input topic can be used for recovery (cf.
+     * methods of {@link KGroupedStream} and {@link KGroupedTable} that return a {@link KTable}).
+     * <p>
+     * To query the local {@link KeyValueStore} it must be obtained via
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * <pre>{@code
+     * KafkaStreams streams = ...
+     * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
+     * String key = "some-key";
+     * Long valueForKey = localStore.get(key); // key must be local (application state is shared over all running Kafka Streams instances)
+     * }</pre>
+     * For non-local keys, a custom RPC mechanism must be implemented using {@link KafkaStreams#allMetadata()} to
+     * query the value of the key on a parallel running instance of your Kafka Streams application.
      *
-     * @param offsetReset the auto offset reset policy to use for this stream if no committed offsets available; acceptable values are earliest or latest
-     * @param topic     the topic name; cannot be null
-     * @param storeName the state store name used if this KTable is materialized, can be null if materialization not expected
-     * @return a {@link KTable} for the specified topics
+     * @param topic     the topic name; cannot be {@code null}
+     * @param storeName the state store name; cannot be {@code null}
+     * @return a {@link KTable} for the specified topic
      */
-    public <K, V> KTable<K, V> table(AutoOffsetReset offsetReset, String topic, final String storeName) {
-        return table(offsetReset, null, null, topic, storeName);
+    public <K, V> KTable<K, V> table(final String topic,
+                                     final String storeName) {
+        return table(null, null, null, topic, storeName);
     }
 
     /**
-     * Create a {@link KTable} instance for the specified topic.
-     * Record keys of the topic should never by null, otherwise an exception will be thrown at runtime.
-     * The default deserializers specified in the config are used.
-     * The resulting {@link KTable} will be materialized in a local state store with the given store name.
-     * However, no new changelog topic is created in this case since the underlying topic acts as one.
+     * Create a {@link KTable} for the specified topic.
+     * The default key and value deserializers as specified in the {@link StreamsConfig config} are used.
+     * Input {@link KeyValue} pairs with {@code null} key will be dropped.
+     * <p>
+     * Note that the specified input topics must be partitioned by key.
+     * If this is not the case the returned {@link KTable} will be corrupted.
+     * <p>
+     * The resulting {@link KTable} will be materialized in a local {@link KeyValueStore} with the given
+     * {@code storeName}.
+     * However, no internal changelog topic is created since the original input topic can be used for recovery (cf.
+     * methods of {@link KGroupedStream} and {@link KGroupedTable} that return a {@link KTable}).
+     * <p>
+     * To query the local {@link KeyValueStore} it must be obtained via
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * <pre>{@code
+     * KafkaStreams streams = ...
+     * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
+     * String key = "some-key";
+     * Long valueForKey = localStore.get(key); // key must be local (application state is shared over all running Kafka Streams instances)
+     * }</pre>
+     * For non-local keys, a custom RPC mechanism must be implemented using {@link KafkaStreams#allMetadata()} to
+     * query the value of the key on a parallel running instance of your Kafka Streams application.
      *
-     * @param topic     the topic name; cannot be null
-     * @param storeName the state store name used if this KTable is materialized, can be null if materialization not expected
-     * @return a {@link KTable} for the specified topics
+     * @param offsetReset the {@code "auto.offset.reset"} policy to use for the specified topic if no valid committed
+     *                    offsets are available
+     * @param topic       the topic name; cannot be {@code null}
+     * @param storeName   the state store name; cannot be {@code null}
+     * @return a {@link KTable} for the specified topic
      */
-    public <K, V> KTable<K, V> table(String topic, final String storeName) {
-        return table(null, null, null, topic, storeName);
+    public <K, V> KTable<K, V> table(final AutoOffsetReset offsetReset,
+                                     final String topic,
+                                     final String storeName) {
+        return table(offsetReset, null, null, topic, storeName);
     }
 
-
     /**
-     * Create a {@link KTable} instance for the specified topic.
-     * Record keys of the topic should never by null, otherwise an exception will be thrown at runtime.
-     * The resulting {@link KTable} will be materialized in a local state store with the given store name.
-     * However, no new changelog topic is created in this case since the underlying topic acts as one.
+     * Create a {@link KTable} for the specified topic.
+     * The default {@code "auto.offset.reset"} strategy as specified in the {@link StreamsConfig config} is used.
+     * Input {@link KeyValue} pairs with {@code null} key will be dropped.
+     * <p>
+     * Note that the specified input topics must be partitioned by key.
+     * If this is not the case the returned {@link KTable} will be corrupted.
+     * <p>
+     * The resulting {@link KTable} will be materialized in a local {@link KeyValueStore} with the given
+     * {@code storeName}.
+     * However, no internal changelog topic is created since the original input topic can be used for recovery (cf.
+     * methods of {@link KGroupedStream} and {@link KGroupedTable} that return a {@link KTable}).
+     * <p>
+     * To query the local {@link KeyValueStore} it must be obtained via
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * <pre>{@code
+     * KafkaStreams streams = ...
+     * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
+     * String key = "some-key";
+     * Long valueForKey = localStore.get(key); // key must be local (application state is shared over all running Kafka Streams instances)
+     * }</pre>
+     * For non-local keys, a custom RPC mechanism must be implemented using {@link KafkaStreams#allMetadata()} to
+     * query the value of the key on a parallel running instance of your Kafka Streams application.
      *
-     * @param keySerde   key serde used to send key-value pairs,
-     *                   if not specified the default key serde defined in the configuration will be used
-     * @param valSerde   value serde used to send key-value pairs,
-     *                   if not specified the default value serde defined in the configuration will be used
-     * @param topic      the topic name; cannot be null
-     * @param storeName  the state store name used for the materialized KTable
-     * @return a {@link KTable} for the specified topics
+     * @param keySerde  key serde used to send key-value pairs,
+     *                  if not specified the default key serde defined in the configuration will be used
+     * @param valSerde  value serde used to send key-value pairs,
+     *                  if not specified the default value serde defined in the configuration will be used
+     * @param topic     the topic name; cannot be {@code null}
+     * @param storeName the state store name; cannot be {@code null}
+     * @return a {@link KTable} for the specified topic
      */
-    public <K, V> KTable<K, V> table(Serde<K> keySerde, Serde<V> valSerde, String topic, final String storeName) {
+    public <K, V> KTable<K, V> table(final Serde<K> keySerde,
+                                     final Serde<V> valSerde,
+                                     final String topic,
+                                     final String storeName) {
         return table(null, keySerde, valSerde, topic, storeName);
     }
 
     /**
-     * Create a {@link KTable} instance for the specified topic.
-     * Record keys of the topic should never by null, otherwise an exception will be thrown at runtime.
-     * The resulting {@link KTable} will be materialized in a local state store with the given store name.
-     * However, no new changelog topic is created in this case since the underlying topic acts as one.
+     * Create a {@link KTable} for the specified topic.
+     * Input {@link KeyValue} pairs with {@code null} key will be dropped.
+     * <p>
+     * Note that the specified input topics must be partitioned by key.
+     * If this is not the case the returned {@link KTable} will be corrupted.
+     * <p>
+     * The resulting {@link KTable} will be materialized in a local {@link KeyValueStore} with the given
+     * {@code storeName}.
+     * However, no internal changelog topic is created since the original input topic can be used for recovery (cf.
+     * methods of {@link KGroupedStream} and {@link KGroupedTable} that return a {@link KTable}).
+     * <p>
+     * To query the local {@link KeyValueStore} it must be obtained via
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * <pre>{@code
+     * KafkaStreams streams = ...
+     * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
+     * String key = "some-key";
+     * Long valueForKey = localStore.get(key); // key must be local (application state is shared over all running Kafka Streams instances)
+     * }</pre>
+     * For non-local keys, a custom RPC mechanism must be implemented using {@link KafkaStreams#allMetadata()} to
+     * query the value of the key on a parallel running instance of your Kafka Streams application.
      *
-     * @param offsetReset the auto offset reset policy to use for this stream if no committed offsets available; acceptable values are earliest or latest
-     * @param keySerde   key serde used to send key-value pairs,
-     *                   if not specified the default key serde defined in the configuration will be used
-     * @param valSerde   value serde used to send key-value pairs,
-     *                   if not specified the default value serde defined in the configuration will be used
-     * @param topic      the topic name; cannot be null
-     * @param storeName  the state store name used if this KTable is materialized, can be null if materialization not expected
-     * @return a {@link KTable} for the specified topics
+     * @param offsetReset the {@code "auto.offset.reset"} policy to use for the specified topic if no valid committed
+     *                    offsets are available
+     * @param keySerde    key serde used to send key-value pairs,
+     *                    if not specified the default key serde defined in the configuration will be used
+     * @param valSerde    value serde used to send key-value pairs,
+     *                    if not specified the default value serde defined in the configuration will be used
+     * @param topic       the topic name; cannot be {@code null}
+     * @param storeName   the state store name; cannot be {@code null}
+     * @return a {@link KTable} for the specified topic
      */
-    public <K, V> KTable<K, V> table(AutoOffsetReset offsetReset, Serde<K> keySerde, Serde<V> valSerde, String topic, final String storeName) {
+    public <K, V> KTable<K, V> table(final AutoOffsetReset offsetReset,
+                                     final Serde<K> keySerde,
+                                     final Serde<V> valSerde,
+                                     final String topic,
+                                     final String storeName) {
         final String source = newName(KStreamImpl.SOURCE_NAME);
         final String name = newName(KTableImpl.SOURCE_NAME);
         final ProcessorSupplier<K, V> processorSupplier = new KTableSource<>(storeName);
@@ -265,7 +392,7 @@ public <K, V> KTable<K, V> table(AutoOffsetReset offsetReset, Serde<K> keySerde,
 
         // only materialize the KTable into a state store if the storeName is not null
         if (storeName != null) {
-            StateStoreSupplier storeSupplier = new RocksDBKeyValueStoreSupplier<>(storeName,
+            final StateStoreSupplier storeSupplier = new RocksDBKeyValueStoreSupplier<>(storeName,
                     keySerde,
                     valSerde,
                     false,
@@ -279,22 +406,70 @@ public <K, V> KTable<K, V> table(AutoOffsetReset offsetReset, Serde<K> keySerde,
         return kTable;
     }
 
+    /**
+     * Create a {@link GlobalKTable} for the specified topic.
+     * The default key and value deserializers as specified in the {@link StreamsConfig config} are used.
+     * Input {@link KeyValue} pairs cannot have a {@code null} key (otherwise an exception will be thrown).
+     * <p>
+     * The resulting {@link GlobalKTable} will be materialized in a local {@link KeyValueStore} with the given
+     * {@code storeName}.
+     * However, no internal changelog topic is created since the original input topic can be used for recovery (cf.
+     * methods of {@link KGroupedStream} and {@link KGroupedTable} that return a {@link KTable}).
+     * <p>
+     * To query the local {@link KeyValueStore} it must be obtained via
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * <pre>{@code
+     * KafkaStreams streams = ...
+     * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
+     * String key = "some-key";
+     * Long valueForKey = localStore.get(key);
+     * }</pre>
+     * Note that {@link GlobalKTable} always applies {@code "auto.offset.reset"} strategy {@code "earliest"}
+     * regardless of the specified value in {@link StreamsConfig}.
+     *
+     * @param topic     the topic name; cannot be {@code null}
+     * @param storeName the state store name; cannot be {@code null}
+     * @return a {@link GlobalKTable} for the specified topic
+     */
+    public <K, V> GlobalKTable<K, V> globalTable(final String topic,
+                                                 final String storeName) {
+        return globalTable(null, null, topic, storeName);
+    }
 
     /**
-     * Create a new  {@link GlobalKTable} instance for the specified topic.
-     * Record keys of the topic should never by null, otherwise an exception will be thrown at runtime.
-     * The resulting {@link GlobalKTable} will be materialized in a local state store with the given store name.
-     * However, no new changelog topic is created in this case since the underlying topic acts as one.
-     * @param keySerde   key serde used to send key-value pairs,
-     *                   if not specified the default key serde defined in the configuration will be used
-     * @param valSerde   value serde used to send key-value pairs,
-     *                   if not specified the default value serde defined in the configuration will be used
-     * @param topic      the topic name; cannot be null
-     * @param storeName  the state store name used
-     * @return a {@link GlobalKTable} for the specified topics
+     * Create a {@link GlobalKTable} for the specified topic.
+     * The default key and value deserializers as specified in the {@link StreamsConfig config} are used.
+     * Input {@link KeyValue} pairs cannot have a {@code null} key (otherwise an exception will be thrown).
+     * <p>
+     * The resulting {@link GlobalKTable} will be materialized in a local {@link KeyValueStore} with the given
+     * {@code storeName}.
+     * However, no internal changelog topic is created since the original input topic can be used for recovery (cf.
+     * methods of {@link KGroupedStream} and {@link KGroupedTable} that return a {@link KTable}).
+     * <p>
+     * To query the local {@link KeyValueStore} it must be obtained via
+     * {@link KafkaStreams#store(String, QueryableStoreType) KafkaStreams#store(...)}:
+     * <pre>{@code
+     * KafkaStreams streams = ...
+     * ReadOnlyKeyValueStore<String,Long> localStore = streams.store(storeName, QueryableStoreTypes.<String, Long>keyValueStore());
+     * String key = "some-key";
+     * Long valueForKey = localStore.get(key);
+     * }</pre>
+     * Note that {@link GlobalKTable} always applies {@code "auto.offset.reset"} strategy {@code "earliest"}
+     * regardless of the specified value in {@link StreamsConfig}.
+     *
+     * @param keySerde  key serde used to send key-value pairs,
+     *                  if not specified the default key serde defined in the configuration will be used
+     * @param valSerde  value serde used to send key-value pairs,
+     *                  if not specified the default value serde defined in the configuration will be used
+     * @param topic     the topic name; cannot be {@code null}
+     * @param storeName the state store name; cannot be {@code null}
+     * @return a {@link GlobalKTable} for the specified topic
      */
     @SuppressWarnings("unchecked")
-    public <K, V> GlobalKTable<K, V> globalTable(final Serde<K> keySerde, final Serde<V> valSerde, final String topic, final String storeName) {
+    public <K, V> GlobalKTable<K, V> globalTable(final Serde<K> keySerde,
+                                                 final Serde<V> valSerde,
+                                                 final String topic,
+                                                 final String storeName) {
         final String sourceName = newName(KStreamImpl.SOURCE_NAME);
         final String processorName = newName(KTableImpl.SOURCE_NAME);
         final KTableSource<K, V> tableSource = new KTableSource<>(storeName);
@@ -315,41 +490,27 @@ public <K, V> GlobalKTable<K, V> globalTable(final Serde<K> keySerde, final Serd
     }
 
     /**
-     * Create a new  {@link GlobalKTable} instance for the specified topic using the default key and value {@link Serde}s
-     * Record keys of the topic should never by null, otherwise an exception will be thrown at runtime.
-     * The resulting {@link GlobalKTable} will be materialized in a local state store with the given store name.
-     * However, no new changelog topic is created in this case since the underlying topic acts as one.
-     *
-     * @param topic      the topic name; cannot be null
-     * @param storeName  the state store name used if this KTable is materialized, can be null if materialization not expected
-     * @return a {@link GlobalKTable} for the specified topics
-     */
-    public <K, V> GlobalKTable<K, V> globalTable(final String topic, final String storeName) {
-        return globalTable(null, null, topic, storeName);
-    }
-
-    /**
-     * Create a new instance of {@link KStream} by merging the given streams.
+     * Create a new instance of {@link KStream} by merging the given {@link KStream}s.
      * <p>
-     * There are nor ordering guaranteed for records from different streams.
+     * There are nor ordering guaranteed for records from different {@link KStream}s.
      *
-     * @param streams   the instances of {@link KStream} to be merged
+     * @param streams the {@link KStream}s to be merged
      * @return a {@link KStream} containing all records of the given streams
      */
-    public <K, V> KStream<K, V> merge(KStream<K, V>... streams) {
+    public <K, V> KStream<K, V> merge(final KStream<K, V>... streams) {
         return KStreamImpl.merge(this, streams);
     }
 
     /**
+     * <strong>This function is only for internal usage only and should not be called.</strong>
+     * <p>
      * Create a unique processor name used for translation into the processor topology.
-     * This function is only for internal usage.
      *
-     * @param prefix    processor name prefix
+     * @param prefix processor name prefix
      * @return a new unique name
      */
-    public String newName(String prefix) {
+    public String newName(final String prefix) {
         return prefix + String.format("%010d", index.getAndIncrement());
     }
 
-
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/WallclockTimestampExtractor.java b/streams/src/main/java/org/apache/kafka/streams/processor/WallclockTimestampExtractor.java
index 6df9481331537..e00a102ab9222 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/WallclockTimestampExtractor.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/WallclockTimestampExtractor.java
@@ -29,6 +29,7 @@
  *
  * @see FailOnInvalidTimestamp
  * @see LogAndSkipOnInvalidTimestamp
+ * @see UsePreviousTimeOnInvalidTimestamp
  */
 public class WallclockTimestampExtractor implements TimestampExtractor {
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
index 5edc10d84886a..8a9b255115c0e 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
@@ -135,7 +135,7 @@ public void close() throws IOException {
     }
 
     /**
-     * Creates a set of new topics using batch request.
+     * Create a set of new topics using batch request.
      */
     public void createTopics(final Map<InternalTopicConfig, Integer> topicsMap, final int replicationFactor, final long windowChangeLogAdditionalRetention) {
 
@@ -253,7 +253,15 @@ public Collection<MetadataResponse.TopicMetadata> fetchTopicsMetadata() {
         return metadataResponse.topicMetadata();
     }
 
-    public void checkBrokerCompatibility() {
+    /**
+     * Check if the used brokers have version 0.10.1.x or higher.
+     * <p>
+     * Note, for <em>pre</em> 0.10.x brokers the broker version cannot be checked and the client will hang and retry
+     * until it {@link StreamsConfig#REQUEST_TIMEOUT_MS_CONFIG times out}.
+     *
+     * @throws StreamsException if brokers have version 0.10.0.x
+     */
+    public void checkBrokerCompatibility() throws StreamsException {
         final ClientRequest clientRequest = kafkaClient.newClientRequest(
             getBrokerId(),
             new ApiVersionsRequest.Builder(),
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/GlobalKTableIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/GlobalKTableIntegrationTest.java
index 6ac87ae1fe64a..9e59113ada28e 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/GlobalKTableIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/GlobalKTableIntegrationTest.java
@@ -90,7 +90,6 @@ public void before() throws InterruptedException {
         streamsConfiguration.put(StreamsConfig.APPLICATION_ID_CONFIG, applicationId);
         streamsConfiguration
                 .put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, CLUSTER.bootstrapServers());
-        streamsConfiguration.put(StreamsConfig.ZOOKEEPER_CONNECT_CONFIG, CLUSTER.zKConnectString());
         streamsConfiguration.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
         streamsConfiguration.put(StreamsConfig.STATE_DIR_CONFIG, TestUtils.tempDirectory().getPath());
         streamsConfiguration.put(StreamsConfig.CACHE_MAX_BYTES_BUFFERING_CONFIG, 0);
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/JoinIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/JoinIntegrationTest.java
index b443abc08ede8..ac8abd45a459d 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/JoinIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/JoinIntegrationTest.java
@@ -121,7 +121,6 @@ public static void setupConfigsAndUtils() throws Exception {
         RESULT_CONSUMER_CONFIG.put(ConsumerConfig.VALUE_DESERIALIZER_CLASS_CONFIG, StringDeserializer.class);
 
         STREAMS_CONFIG.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, CLUSTER.bootstrapServers());
-        STREAMS_CONFIG.put(StreamsConfig.ZOOKEEPER_CONNECT_CONFIG, CLUSTER.zKConnectString());
         STREAMS_CONFIG.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
         STREAMS_CONFIG.put(StreamsConfig.STATE_DIR_CONFIG, TestUtils.tempDirectory().getPath());
         STREAMS_CONFIG.put(StreamsConfig.KEY_SERDE_CLASS_CONFIG, Serdes.Long().getClass());
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/KTableKTableJoinIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/KTableKTableJoinIntegrationTest.java
index eeb9177cd3b32..7061507f6e688 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/KTableKTableJoinIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/KTableKTableJoinIntegrationTest.java
@@ -133,7 +133,6 @@ public static void beforeTest() throws Exception {
 
         streamsConfig = new Properties();
         streamsConfig.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, CLUSTER.bootstrapServers());
-        streamsConfig.put(StreamsConfig.ZOOKEEPER_CONNECT_CONFIG, CLUSTER.zKConnectString());
         streamsConfig.put(StreamsConfig.KEY_SERDE_CLASS_CONFIG, Serdes.String().getClass().getName());
         streamsConfig.put(StreamsConfig.VALUE_SERDE_CLASS_CONFIG, Serdes.String().getClass().getName());
         streamsConfig.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");

From 6829d9615ab13d1314a73b77b6781e8daec18ea8 Mon Sep 17 00:00:00 2001
From: "Colin P. Mccabe" <cmccabe@confluent.io>
Date: Sat, 28 Jan 2017 00:58:35 +0000
Subject: [PATCH 075/177] KAFKA-4635; Client Compatibility follow-ups

Author: Colin P. Mccabe <cmccabe@confluent.io>

Reviewers: Jason Gustafson <jason@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2414 from cmccabe/KAFKA-4635

(cherry picked from commit 8827a5b34ed2a2a570219fb8f29d955918867796)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../apache/kafka/clients/NetworkClient.java   | 23 +++---
 .../apache/kafka/clients/NodeApiVersions.java | 72 ++++++++++------
 .../kafka/clients/consumer/KafkaConsumer.java |  9 +-
 .../clients/consumer/OffsetAndTimestamp.java  |  9 +-
 .../clients/consumer/internals/Fetcher.java   | 82 +++++++++++++------
 .../kafka/clients/producer/KafkaProducer.java |  4 +
 .../errors/ObsoleteBrokerException.java       | 31 -------
 .../common/requests/CreateTopicsRequest.java  |  5 +-
 .../common/requests/ListOffsetRequest.java    |  6 +-
 .../common/requests/OffsetFetchRequest.java   |  5 +-
 .../kafka/clients/NodeApiVersionsTest.java    | 29 ++++++-
 .../common/requests/RequestResponseTest.java  |  4 +-
 .../kafka/tools/ClientCompatibilityTest.java  |  6 +-
 13 files changed, 171 insertions(+), 114 deletions(-)
 delete mode 100644 clients/src/main/java/org/apache/kafka/common/errors/ObsoleteBrokerException.java

diff --git a/clients/src/main/java/org/apache/kafka/clients/NetworkClient.java b/clients/src/main/java/org/apache/kafka/clients/NetworkClient.java
index 5e97eacd970a6..0eb76704be853 100644
--- a/clients/src/main/java/org/apache/kafka/clients/NetworkClient.java
+++ b/clients/src/main/java/org/apache/kafka/clients/NetworkClient.java
@@ -14,7 +14,6 @@
 
 import org.apache.kafka.common.Cluster;
 import org.apache.kafka.common.Node;
-import org.apache.kafka.common.errors.ObsoleteBrokerException;
 import org.apache.kafka.common.errors.UnsupportedVersionException;
 import org.apache.kafka.common.network.NetworkReceive;
 import org.apache.kafka.common.network.Selectable;
@@ -289,20 +288,17 @@ private void doSend(ClientRequest clientRequest, boolean isInternalRequest, long
             // the case when sending the initial ApiVersionRequest which fetches the version
             // information itself.  It is also the case when discoverBrokerVersions is set to false.
             if (versionInfo == null) {
-                if ((!discoverBrokerVersions) && (log.isTraceEnabled()))
-                    log.trace("No version information found when sending message of type {} to node {}",
-                            clientRequest.apiKey(), nodeId);
+                if (discoverBrokerVersions && log.isTraceEnabled())
+                    log.trace("No version information found when sending message of type {} to node {}. " +
+                            "Assuming version {}.", clientRequest.apiKey(), nodeId, builder.version());
             } else {
                 short version = versionInfo.usableVersion(clientRequest.apiKey());
-                if (log.isTraceEnabled())
-                    log.trace("When sending message of type {} to node {}, the best usable version is {}",
-                            clientRequest.apiKey(), nodeId, version);
                 builder.setVersion(version);
             }
             // The call to build may also throw UnsupportedVersionException, if there are essential
             // fields that cannot be represented in the chosen version.
             request = builder.build();
-        } catch (ObsoleteBrokerException | UnsupportedVersionException e) {
+        } catch (UnsupportedVersionException e) {
             // If the version is not supported, skip sending the request over the wire.
             // Instead, simply add it to the local queue of aborted requests.
             log.debug("Version mismatch when attempting to send {} to {}",
@@ -314,8 +310,15 @@ private void doSend(ClientRequest clientRequest, boolean isInternalRequest, long
             return;
         }
         RequestHeader header = clientRequest.makeHeader();
-        if (log.isTraceEnabled())
-            log.trace("Sending {} to node {}", request,  nodeId);
+        if (log.isDebugEnabled()) {
+            int latestClientVersion = ProtoUtils.latestVersion(clientRequest.apiKey().id);
+            if (header.apiVersion() == latestClientVersion) {
+                log.trace("Sending {} to node {}.", request, nodeId);
+            } else {
+                log.debug("Using older server API v{} to send {} to node {}.",
+                    header.apiVersion(), request, nodeId);
+            }
+        }
         Send send = request.toSend(nodeId, header);
         InFlightRequest inFlightRequest = new InFlightRequest(
                 header,
diff --git a/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java b/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java
index 1c5d8fb37c041..aa9c85a5664ce 100644
--- a/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java
+++ b/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java
@@ -27,10 +27,18 @@
 import java.util.NoSuchElementException;
 import java.util.TreeMap;
 
+/**
+ * An internal class which represents the API versions supported by a particular node.
+ */
 public class NodeApiVersions {
-    private final Collection<ApiVersion> apiVersions;
+    private static final Short API_NOT_ON_NODE = null;
+    private static final short NODE_TOO_OLD = (short) -1;
+    private static final short NODE_TOO_NEW = (short) -2;
+    private final Collection<ApiVersion> nodeApiVersions;
 
-    // An array of the usable versions of each API, indexed by ApiKeys ID.
+    /**
+     * An array of the usable versions of each API, indexed by the ApiKeys ID.
+     */
     private final Map<ApiKeys, Short> usableVersions = new EnumMap<>(ApiKeys.class);
 
     /**
@@ -67,30 +75,39 @@ public static NodeApiVersions create(Collection<ApiVersion> overrides) {
         return new NodeApiVersions(apiVersions);
     }
 
-    public NodeApiVersions(Collection<ApiVersion> apiVersions) {
-        this.apiVersions = apiVersions;
-        for (ApiVersion apiVersion : apiVersions) {
-            int apiKeyId = apiVersion.apiKey;
+    public NodeApiVersions(Collection<ApiVersion> nodeApiVersions) {
+        this.nodeApiVersions = nodeApiVersions;
+        for (ApiVersion nodeApiVersion : nodeApiVersions) {
+            int nodeApiKey = nodeApiVersion.apiKey;
             // Newer brokers may support ApiKeys we don't know about, ignore them
-            if (ApiKeys.hasId(apiKeyId)) {
-                short version = Utils.min(ProtoUtils.latestVersion(apiKeyId), apiVersion.maxVersion);
-                if (version >= apiVersion.minVersion && version >= ProtoUtils.oldestVersion(apiKeyId))
-                    usableVersions.put(ApiKeys.forId(apiKeyId), version);
+            if (ApiKeys.hasId(nodeApiKey)) {
+                short v = Utils.min(ProtoUtils.latestVersion(nodeApiKey), nodeApiVersion.maxVersion);
+                if (v < nodeApiVersion.minVersion) {
+                    usableVersions.put(ApiKeys.forId(nodeApiKey), NODE_TOO_NEW);
+                } else if (v < ProtoUtils.oldestVersion(nodeApiKey)) {
+                    usableVersions.put(ApiKeys.forId(nodeApiKey), NODE_TOO_OLD);
+                } else {
+                    usableVersions.put(ApiKeys.forId(nodeApiKey), v);
+                }
             }
         }
     }
 
     /**
-     * Return the most recent version supported by both the client and the server.
+     * Return the most recent version supported by both the node and the local software.
      */
     public short usableVersion(ApiKeys apiKey) {
         Short usableVersion = usableVersions.get(apiKey);
-        if (usableVersion == null) {
-            throw new UnsupportedVersionException("The client cannot send an " +
-                    "API request of type " + apiKey + ", because the " +
-                    "server does not understand any of the versions this client supports.");
-        }
-        return usableVersion;
+        if (usableVersion == API_NOT_ON_NODE)
+            throw new UnsupportedVersionException("The broker does not support " + apiKey);
+        else if (usableVersion == NODE_TOO_OLD)
+            throw new UnsupportedVersionException("The broker is too old to support " + apiKey +
+                " version " + ProtoUtils.oldestVersion(apiKey.id));
+        else if (usableVersion == NODE_TOO_NEW)
+            throw new UnsupportedVersionException("The broker is too new to support " + apiKey +
+                " version " + ProtoUtils.latestVersion(apiKey.id));
+        else
+            return usableVersion;
     }
 
     /**
@@ -113,11 +130,11 @@ public String toString(boolean lineBreaks) {
         // a TreeMap before printing it out to ensure that we always print in
         // ascending order.
         TreeMap<Short, String> apiKeysText = new TreeMap<>();
-        for (ApiVersion apiVersion : this.apiVersions)
+        for (ApiVersion apiVersion : this.nodeApiVersions)
             apiKeysText.put(apiVersion.apiKey, apiVersionToText(apiVersion));
 
-        // Also handle the case where some apiKey types are
-        // unknown, which may happen when either the client or server is newer.
+        // Also handle the case where some apiKey types are not specified at all in the given ApiVersions,
+        // which may happen when the remote is too old.
         for (ApiKeys apiKey : ApiKeys.values()) {
             if (!apiKeysText.containsKey(apiKey.id)) {
                 StringBuilder bld = new StringBuilder();
@@ -156,19 +173,20 @@ private String apiVersionToText(ApiVersion apiVersion) {
         }
         if (apiKey != null) {
             Short usableVersion = usableVersions.get(apiKey);
-            if (usableVersion == null) {
-                bld.append(" [usable: NONE]");
-            } else {
+            if (usableVersion == NODE_TOO_OLD)
+                bld.append(" [unusable: node too old]");
+            else if (usableVersion == NODE_TOO_NEW)
+                bld.append(" [unusable: node too new]");
+            else
                 bld.append(" [usable: ").append(usableVersion).append("]");
-            }
         }
         return bld.toString();
     }
 
     public ApiVersion apiVersion(ApiKeys apiKey) {
-        for (ApiVersion apiVersion : apiVersions) {
-            if (apiVersion.apiKey == apiKey.id) {
-                return apiVersion;
+        for (ApiVersion nodeApiVersion : nodeApiVersions) {
+            if (nodeApiVersion.apiKey == apiKey.id) {
+                return nodeApiVersion;
             }
         }
         throw new NoSuchElementException();
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
index 2936f0f8f034f..6064c39c41948 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
@@ -75,6 +75,13 @@
  * Failure to close the consumer after use will leak these connections.
  * The consumer is not thread-safe. See <a href="#multithreaded">Multi-threaded Processing</a> for more details.
  *
+ * <h3>Cross-Version Compatibility</h3>
+ * This client can communicate with brokers that are version 0.10.0 or newer. Older or newer brokers may not support
+ * certain features. For example, 0.10.0 brokers do not support offsetsForTimes, because this feature was added
+ * in version 0.10.1. You will receive an UnsupportedVersionException when invoking an API that is not available on the
+ * running broker version.
+ * <p>
+ *
  * <h3>Offsets and Consumer Position</h3>
  * Kafka maintains a numerical offset for each record in a partition. This offset acts as a unique identifier of
  * a record within that partition, and also denotes the position of the consumer in the partition. For example, a consumer
@@ -497,7 +504,6 @@
  * There are many possible variations on this approach. For example each processor thread can have its own queue, and
  * the consumer threads can hash into these queues using the TopicPartition to ensure in-order consumption and simplify
  * commit.
- *
  */
 public class KafkaConsumer<K, V> implements Consumer<K, V> {
 
@@ -1437,6 +1443,7 @@ public Set<TopicPartition> paused() {
      *         than or equal to the target timestamp. {@code null} will be returned for the partition if there is no
      *         such message.
      * @throws IllegalArgumentException if the target timestamp is negative.
+     * @throws UnsupportedVersionException if the broker does not support looking up the offsets by timestamp.
      */
     @Override
     public Map<TopicPartition, OffsetAndTimestamp> offsetsForTimes(Map<TopicPartition, Long> timestampsToSearch) {
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/OffsetAndTimestamp.java b/clients/src/main/java/org/apache/kafka/clients/consumer/OffsetAndTimestamp.java
index f74a333733bf0..2f95291112ac2 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/OffsetAndTimestamp.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/OffsetAndTimestamp.java
@@ -20,11 +20,6 @@
 
 /**
  * A container class for offset and timestamp.
- *
- * Offset must be non-negative.
- *
- * The timestamp should never be negative, unless it is invalid.  This could happen when
- * handling a response from a broker that doesn't support KIP-79.
  */
 public final class OffsetAndTimestamp {
     private final long timestamp;
@@ -32,7 +27,9 @@ public final class OffsetAndTimestamp {
 
     public OffsetAndTimestamp(long offset, long timestamp) {
         this.offset = offset;
+        assert this.offset >= 0;
         this.timestamp = timestamp;
+        assert this.timestamp >= 0;
     }
 
     public long timestamp() {
@@ -45,7 +42,7 @@ public long offset() {
 
     @Override
     public String toString() {
-        return "{timestamp=" + timestamp + ", offset=" + offset + "}";
+        return "(timestamp=" + timestamp + ", offset=" + offset + ")";
     }
 
     @Override
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
index af82570a1ab0f..d4ecfc6a93ff4 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
@@ -130,6 +130,28 @@ public Fetcher(ConsumerNetworkClient client,
         subscriptions.addListener(this);
     }
 
+    /**
+     * Represents data about an offset returned by a broker.
+     */
+    private static class OffsetData {
+        /**
+         * The offset
+         */
+        final long offset;
+
+        /**
+         * The timestamp.
+         *
+         * Will be null if the broker does not support returning timestamps.
+         */
+        final Long timestamp;
+
+        OffsetData(long offset, Long timestamp) {
+            this.offset = offset;
+            this.timestamp = timestamp;
+        }
+    }
+
     /**
      * Return whether we have any completed fetches pending return to the user. This method is thread-safe.
      * @return true if there are completed fetches, false otherwise
@@ -344,12 +366,12 @@ else if (strategy == OffsetResetStrategy.LATEST)
             timestamp = ListOffsetRequest.LATEST_TIMESTAMP;
         else
             throw new NoOffsetForPartitionException(partition);
-        Map<TopicPartition, OffsetAndTimestamp> offsetsByTimes = retrieveOffsetsByTimes(
+        Map<TopicPartition, OffsetData> offsetsByTimes = retrieveOffsetsByTimes(
                 Collections.singletonMap(partition, timestamp), Long.MAX_VALUE, false);
-        OffsetAndTimestamp offsetAndTimestamp = offsetsByTimes.get(partition);
-        if (offsetAndTimestamp == null)
+        OffsetData offsetData = offsetsByTimes.get(partition);
+        if (offsetData == null)
             throw new NoOffsetForPartitionException(partition);
-        long offset = offsetAndTimestamp.offset();
+        long offset = offsetData.offset;
         // we might lose the assignment while fetching the offset, so check it is still active
         if (subscriptions.isAssigned(partition))
             this.subscriptions.seek(partition, offset);
@@ -357,10 +379,19 @@ else if (strategy == OffsetResetStrategy.LATEST)
 
     public Map<TopicPartition, OffsetAndTimestamp> getOffsetsByTimes(Map<TopicPartition, Long> timestampsToSearch,
                                                                      long timeout) {
-        return retrieveOffsetsByTimes(timestampsToSearch, timeout, true);
+        Map<TopicPartition, OffsetData> offsetData = retrieveOffsetsByTimes(timestampsToSearch, timeout, true);
+        HashMap<TopicPartition, OffsetAndTimestamp> offsetsByTimes = new HashMap<>(offsetData.size());
+        for (Map.Entry<TopicPartition, OffsetData> entry : offsetData.entrySet()) {
+            OffsetData data = entry.getValue();
+            if (data == null)
+                offsetsByTimes.put(entry.getKey(), null);
+            else
+                offsetsByTimes.put(entry.getKey(), new OffsetAndTimestamp(data.offset, data.timestamp));
+        }
+        return offsetsByTimes;
     }
 
-    private Map<TopicPartition, OffsetAndTimestamp> retrieveOffsetsByTimes(
+    private Map<TopicPartition, OffsetData> retrieveOffsetsByTimes(
             Map<TopicPartition, Long> timestampsToSearch, long timeout, boolean requireTimestamps) {
         if (timestampsToSearch.isEmpty())
             return Collections.emptyMap();
@@ -368,7 +399,7 @@ private Map<TopicPartition, OffsetAndTimestamp> retrieveOffsetsByTimes(
         long startMs = time.milliseconds();
         long remaining = timeout;
         do {
-            RequestFuture<Map<TopicPartition, OffsetAndTimestamp>> future =
+            RequestFuture<Map<TopicPartition, OffsetData>> future =
                     sendListOffsetRequests(requireTimestamps, timestampsToSearch);
             client.poll(future, remaining);
 
@@ -412,9 +443,9 @@ private Map<TopicPartition, Long> beginningOrEndOffset(Collection<TopicPartition
         for (TopicPartition tp : partitions)
             timestampsToSearch.put(tp, timestamp);
         Map<TopicPartition, Long> result = new HashMap<>();
-        for (Map.Entry<TopicPartition, OffsetAndTimestamp> entry :
+        for (Map.Entry<TopicPartition, OffsetData> entry :
                 retrieveOffsetsByTimes(timestampsToSearch, timeout, false).entrySet()) {
-            result.put(entry.getKey(), entry.getValue().offset());
+            result.put(entry.getKey(), entry.getValue().offset);
         }
         return result;
     }
@@ -503,12 +534,12 @@ private List<ConsumerRecord<K, V>> drainRecords(PartitionRecords<K, V> partition
     /**
      * Search the offsets by target times for the specified partitions.
      *
-     * @param requireTimestamps true if we should fail with an ObsoleteBrokerException if the broker does not support
-     *                         fetching precise timestamps for offsets
+     * @param requireTimestamps true if we should fail with an UnsupportedVersionException if the broker does
+     *                         not support fetching precise timestamps for offsets
      * @param timestampsToSearch the mapping between partitions and target time
      * @return A response which can be polled to obtain the corresponding timestamps and offsets.
      */
-    private RequestFuture<Map<TopicPartition, OffsetAndTimestamp>> sendListOffsetRequests(
+    private RequestFuture<Map<TopicPartition, OffsetData>> sendListOffsetRequests(
             final boolean requireTimestamps,
             final Map<TopicPartition, Long> timestampsToSearch) {
         // Group the partitions by node.
@@ -534,14 +565,14 @@ private RequestFuture<Map<TopicPartition, OffsetAndTimestamp>> sendListOffsetReq
             }
         }
 
-        final RequestFuture<Map<TopicPartition, OffsetAndTimestamp>> listOffsetRequestsFuture = new RequestFuture<>();
-        final Map<TopicPartition, OffsetAndTimestamp> fetchedTimestampOffsets = new HashMap<>();
+        final RequestFuture<Map<TopicPartition, OffsetData>> listOffsetRequestsFuture = new RequestFuture<>();
+        final Map<TopicPartition, OffsetData> fetchedTimestampOffsets = new HashMap<>();
         final AtomicInteger remainingResponses = new AtomicInteger(timestampsToSearchByNode.size());
         for (Map.Entry<Node, Map<TopicPartition, Long>> entry : timestampsToSearchByNode.entrySet()) {
             sendListOffsetRequest(entry.getKey(), entry.getValue(), requireTimestamps)
-                    .addListener(new RequestFutureListener<Map<TopicPartition, OffsetAndTimestamp>>() {
+                    .addListener(new RequestFutureListener<Map<TopicPartition, OffsetData>>() {
                         @Override
-                        public void onSuccess(Map<TopicPartition, OffsetAndTimestamp> value) {
+                        public void onSuccess(Map<TopicPartition, OffsetData> value) {
                             synchronized (listOffsetRequestsFuture) {
                                 fetchedTimestampOffsets.putAll(value);
                                 if (remainingResponses.decrementAndGet() == 0 && !listOffsetRequestsFuture.isDone())
@@ -570,7 +601,7 @@ public void onFailure(RuntimeException e) {
      * @param requireTimestamp  True if we require a timestamp in the response.
      * @return A response which can be polled to obtain the corresponding timestamps and offsets.
      */
-    private RequestFuture<Map<TopicPartition, OffsetAndTimestamp>> sendListOffsetRequest(final Node node,
+    private RequestFuture<Map<TopicPartition, OffsetData>> sendListOffsetRequest(final Node node,
                                                                                          final Map<TopicPartition, Long> timestampsToSearch,
                                                                                          boolean requireTimestamp) {
         ListOffsetRequest.Builder builder = new ListOffsetRequest.Builder().setTargetTimes(timestampsToSearch);
@@ -581,9 +612,9 @@ private RequestFuture<Map<TopicPartition, OffsetAndTimestamp>> sendListOffsetReq
 
         log.trace("Sending ListOffsetRequest {} to broker {}", builder, node);
         return client.send(node, builder)
-                .compose(new RequestFutureAdapter<ClientResponse, Map<TopicPartition, OffsetAndTimestamp>>() {
+                .compose(new RequestFutureAdapter<ClientResponse, Map<TopicPartition, OffsetData>>() {
                     @Override
-                    public void onSuccess(ClientResponse response, RequestFuture<Map<TopicPartition, OffsetAndTimestamp>> future) {
+                    public void onSuccess(ClientResponse response, RequestFuture<Map<TopicPartition, OffsetData>> future) {
                         ListOffsetResponse lor = (ListOffsetResponse) response.responseBody();
                         log.trace("Received ListOffsetResponse {} from broker {}", lor, node);
                         handleListOffsetResponse(timestampsToSearch, lor, future);
@@ -600,8 +631,8 @@ public void onSuccess(ClientResponse response, RequestFuture<Map<TopicPartition,
     @SuppressWarnings("deprecation")
     private void handleListOffsetResponse(Map<TopicPartition, Long> timestampsToSearch,
                                           ListOffsetResponse listOffsetResponse,
-                                          RequestFuture<Map<TopicPartition, OffsetAndTimestamp>> future) {
-        Map<TopicPartition, OffsetAndTimestamp> timestampOffsetMap = new HashMap<>();
+                                          RequestFuture<Map<TopicPartition, OffsetData>> future) {
+        Map<TopicPartition, OffsetData> timestampOffsetMap = new HashMap<>();
         for (Map.Entry<TopicPartition, Long> entry : timestampsToSearch.entrySet()) {
             TopicPartition topicPartition = entry.getKey();
             ListOffsetResponse.PartitionData partitionData = listOffsetResponse.responseData().get(topicPartition);
@@ -622,17 +653,16 @@ private void handleListOffsetResponse(Map<TopicPartition, Long> timestampsToSear
                     log.debug("Handling v0 ListOffsetResponse response for {}. Fetched offset {}",
                             topicPartition, offset);
                     if (offset != ListOffsetResponse.UNKNOWN_OFFSET) {
-                        OffsetAndTimestamp offsetAndTimestamp = new OffsetAndTimestamp(offset, -1);
-                        timestampOffsetMap.put(topicPartition, offsetAndTimestamp);
+                        OffsetData offsetData = new OffsetData(offset, null);
+                        timestampOffsetMap.put(topicPartition, offsetData);
                     }
                 } else {
                     // Handle v1 and later response
                     log.debug("Handling ListOffsetResponse response for {}. Fetched offset {}, timestamp {}",
                             topicPartition, partitionData.offset, partitionData.timestamp);
                     if (partitionData.offset != ListOffsetResponse.UNKNOWN_OFFSET) {
-                        OffsetAndTimestamp offsetAndTimestamp =
-                                new OffsetAndTimestamp(partitionData.offset, partitionData.timestamp);
-                        timestampOffsetMap.put(topicPartition, offsetAndTimestamp);
+                        OffsetData offsetData = new OffsetData(partitionData.offset, partitionData.timestamp);
+                        timestampOffsetMap.put(topicPartition, offsetData);
                     }
                 }
             } else if (error == Errors.UNSUPPORTED_FOR_MESSAGE_FORMAT) {
diff --git a/clients/src/main/java/org/apache/kafka/clients/producer/KafkaProducer.java b/clients/src/main/java/org/apache/kafka/clients/producer/KafkaProducer.java
index c604daa86a5c7..29defbbe2a787 100644
--- a/clients/src/main/java/org/apache/kafka/clients/producer/KafkaProducer.java
+++ b/clients/src/main/java/org/apache/kafka/clients/producer/KafkaProducer.java
@@ -124,6 +124,10 @@
  * The <code>key.serializer</code> and <code>value.serializer</code> instruct how to turn the key and value objects the user provides with
  * their <code>ProducerRecord</code> into bytes. You can use the included {@link org.apache.kafka.common.serialization.ByteArraySerializer} or
  * {@link org.apache.kafka.common.serialization.StringSerializer} for simple string or byte types.
+ * <p>
+ * This client can communicate with brokers that are version 0.10.0 or newer. Older or newer brokers may not support
+ * certain client features.  You will receive an UnsupportedVersionException when invoking an API that is not available
+ * with the running broker verion.
  */
 public class KafkaProducer<K, V> implements Producer<K, V> {
 
diff --git a/clients/src/main/java/org/apache/kafka/common/errors/ObsoleteBrokerException.java b/clients/src/main/java/org/apache/kafka/common/errors/ObsoleteBrokerException.java
deleted file mode 100644
index 18f822d7750bf..0000000000000
--- a/clients/src/main/java/org/apache/kafka/common/errors/ObsoleteBrokerException.java
+++ /dev/null
@@ -1,31 +0,0 @@
-/**
- * Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE
- * file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file
- * to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the
- * License. You may obtain a copy of the License at
- * 
- * http://www.apache.org/licenses/LICENSE-2.0
- * 
- * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
- * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
- * specific language governing permissions and limitations under the License.
- */
-package org.apache.kafka.common.errors;
-
-/**
- * Indicates that a request cannot be completed because an obsolete broker
- * does not support the required functionality.
- */
-public class ObsoleteBrokerException extends ApiException {
-
-    private static final long serialVersionUID = 1L;
-
-    public ObsoleteBrokerException(String message, Throwable cause) {
-        super(message, cause);
-    }
-
-    public ObsoleteBrokerException(String message) {
-        super(message);
-    }
-
-}
diff --git a/clients/src/main/java/org/apache/kafka/common/requests/CreateTopicsRequest.java b/clients/src/main/java/org/apache/kafka/common/requests/CreateTopicsRequest.java
index 542c6af19943d..0a4bce01394ac 100644
--- a/clients/src/main/java/org/apache/kafka/common/requests/CreateTopicsRequest.java
+++ b/clients/src/main/java/org/apache/kafka/common/requests/CreateTopicsRequest.java
@@ -16,7 +16,7 @@
  */
 package org.apache.kafka.common.requests;
 
-import org.apache.kafka.common.errors.ObsoleteBrokerException;
+import org.apache.kafka.common.errors.UnsupportedVersionException;
 import org.apache.kafka.common.protocol.ApiKeys;
 import org.apache.kafka.common.protocol.Errors;
 import org.apache.kafka.common.protocol.ProtoUtils;
@@ -115,7 +115,8 @@ public Builder(Map<String, TopicDetails> topics, int timeout, boolean validateOn
         @Override
         public CreateTopicsRequest build() {
             if (validateOnly && version() == 0)
-                throw new ObsoleteBrokerException("validateOnly is not supported in version 0 of CreateTopicsRequest");
+                throw new UnsupportedVersionException("validateOnly is not supported in version 0 of " +
+                        "CreateTopicsRequest");
             return new CreateTopicsRequest(topics, timeout, validateOnly, version());
         }
 
diff --git a/clients/src/main/java/org/apache/kafka/common/requests/ListOffsetRequest.java b/clients/src/main/java/org/apache/kafka/common/requests/ListOffsetRequest.java
index 33613831ffdcd..79251ed794317 100644
--- a/clients/src/main/java/org/apache/kafka/common/requests/ListOffsetRequest.java
+++ b/clients/src/main/java/org/apache/kafka/common/requests/ListOffsetRequest.java
@@ -17,7 +17,6 @@
 package org.apache.kafka.common.requests;
 
 import org.apache.kafka.common.TopicPartition;
-import org.apache.kafka.common.errors.ObsoleteBrokerException;
 import org.apache.kafka.common.errors.UnsupportedVersionException;
 import org.apache.kafka.common.protocol.ApiKeys;
 import org.apache.kafka.common.protocol.Errors;
@@ -88,7 +87,8 @@ public Builder setTargetTimes(Map<TopicPartition, Long> partitionTimestamps) {
         public ListOffsetRequest build() {
             short version = version();
             if (version < minVersion) {
-                throw new ObsoleteBrokerException("The broker is too old to send this request.");
+                throw new UnsupportedVersionException("Cannot create a v" + version + " ListOffsetRequest because " +
+                    "we require features supported only in " + minVersion + " or later.");
             }
             if (version == 0) {
                 if (offsetData == null) {
@@ -106,7 +106,7 @@ public ListOffsetRequest build() {
                 }
             } else {
                 if (offsetData != null) {
-                    throw new UnsupportedVersionException("Cannot create a v" + version + " ListOffsetRequest with v0 " +
+                    throw new RuntimeException("Cannot create a v" + version + " ListOffsetRequest with v0 " +
                         "PartitionData.");
                 } else if (partitionTimestamps == null) {
                     throw new RuntimeException("Must set partitionTimestamps when creating a v" +
diff --git a/clients/src/main/java/org/apache/kafka/common/requests/OffsetFetchRequest.java b/clients/src/main/java/org/apache/kafka/common/requests/OffsetFetchRequest.java
index 553fd9695c3b6..43ddf88d02b4f 100644
--- a/clients/src/main/java/org/apache/kafka/common/requests/OffsetFetchRequest.java
+++ b/clients/src/main/java/org/apache/kafka/common/requests/OffsetFetchRequest.java
@@ -13,7 +13,7 @@
 package org.apache.kafka.common.requests;
 
 import org.apache.kafka.common.TopicPartition;
-import org.apache.kafka.common.errors.ObsoleteBrokerException;
+import org.apache.kafka.common.errors.UnsupportedVersionException;
 import org.apache.kafka.common.protocol.ApiKeys;
 import org.apache.kafka.common.protocol.Errors;
 import org.apache.kafka.common.protocol.ProtoUtils;
@@ -60,7 +60,8 @@ public boolean isAllTopicPartitions() {
         @Override
         public OffsetFetchRequest build() {
             if (isAllTopicPartitions() && version() < 2)
-                throw new ObsoleteBrokerException("The broker is too old to send this request.");
+                throw new UnsupportedVersionException("The broker only supports OffsetFetchRequest " +
+                        "v" + version() + ", but we need v2 or newer to request all topic partitions.");
             return new OffsetFetchRequest(groupId, partitions, version());
         }
 
diff --git a/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java b/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java
index f72137bd4be64..8773d9cd2a59b 100644
--- a/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java
@@ -19,12 +19,14 @@
 import org.apache.kafka.common.errors.UnsupportedVersionException;
 import org.apache.kafka.common.protocol.ApiKeys;
 import org.apache.kafka.common.protocol.ProtoUtils;
+import org.apache.kafka.common.requests.ApiVersionsResponse;
 import org.apache.kafka.common.requests.ApiVersionsResponse.ApiVersion;
 import org.junit.Assert;
 import org.junit.Test;
 
 import java.util.ArrayList;
 import java.util.Collections;
+import java.util.LinkedList;
 import java.util.List;
 
 import static org.junit.Assert.assertEquals;
@@ -51,6 +53,8 @@ public void testVersionsToString() {
         for (ApiKeys apiKey : ApiKeys.values()) {
             if (apiKey == ApiKeys.CONTROLLED_SHUTDOWN_KEY) {
                 versionList.add(new ApiVersion(apiKey.id, (short) 0, (short) 0));
+            } else if (apiKey == ApiKeys.DELETE_TOPICS) {
+                versionList.add(new ApiVersion(apiKey.id, (short) 10000, (short) 10001));
             } else {
                 versionList.add(new ApiVersion(apiKey.id,
                         ProtoUtils.oldestVersion(apiKey.id), ProtoUtils.latestVersion(apiKey.id)));
@@ -62,7 +66,9 @@ public void testVersionsToString() {
         for (ApiKeys apiKey : ApiKeys.values()) {
             bld.append(prefix);
             if (apiKey == ApiKeys.CONTROLLED_SHUTDOWN_KEY) {
-                bld.append("ControlledShutdown(7): 0 [usable: NONE]");
+                bld.append("ControlledShutdown(7): 0 [unusable: node too old]");
+            } else if (apiKey == ApiKeys.DELETE_TOPICS) {
+                bld.append("DeleteTopics(20): 10000 to 10001 [unusable: node too new]");
             } else {
                 bld.append(apiKey.name).append("(").
                         append(apiKey.id).append("): ");
@@ -97,4 +103,25 @@ public void testUsableVersionCalculation() {
         }
         assertEquals(2, versions.usableVersion(ApiKeys.FETCH));
     }
+
+    @Test(expected = UnsupportedVersionException.class)
+    public void testUsableVersionCalculationNoKnownVersions() {
+        List<ApiVersion> versionList = new ArrayList<>();
+        NodeApiVersions versions =  new NodeApiVersions(versionList);
+        versions.usableVersion(ApiKeys.FETCH);
+    }
+
+    @Test
+    public void testUsableVersionLatestVersions() {
+        List<ApiVersion> versionList = new LinkedList<>();
+        for (ApiVersion apiVersion: ApiVersionsResponse.API_VERSIONS_RESPONSE.apiVersions()) {
+            versionList.add(apiVersion);
+        }
+        // Add an API key that we don't know about.
+        versionList.add(new ApiVersion((short) 100, (short) 0, (short) 1));
+        NodeApiVersions versions =  new NodeApiVersions(versionList);
+        for (ApiKeys apiKey: ApiKeys.values()) {
+            assertEquals(ProtoUtils.latestVersion(apiKey.id), versions.usableVersion(apiKey));
+        }
+    }
 }
diff --git a/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java b/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java
index 7b71f8fe74093..69f6276571832 100644
--- a/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java
+++ b/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java
@@ -15,9 +15,9 @@
 
 import org.apache.kafka.common.Node;
 import org.apache.kafka.common.TopicPartition;
-import org.apache.kafka.common.errors.ObsoleteBrokerException;
 import org.apache.kafka.common.errors.NotCoordinatorForGroupException;
 import org.apache.kafka.common.errors.UnknownServerException;
+import org.apache.kafka.common.errors.UnsupportedVersionException;
 import org.apache.kafka.common.network.ListenerName;
 import org.apache.kafka.common.network.Send;
 import org.apache.kafka.common.protocol.ApiKeys;
@@ -269,7 +269,7 @@ public void testRequestHeaderWithNullClientId() {
         assertEquals("", deserialized.clientId()); // null is defaulted to ""
     }
 
-    @Test(expected = ObsoleteBrokerException.class)
+    @Test(expected = UnsupportedVersionException.class)
     public void testCreateTopicRequestV0FailsIfValidateOnly() {
         createCreateTopicRequest(0, true);
     }
diff --git a/tools/src/main/java/org/apache/kafka/tools/ClientCompatibilityTest.java b/tools/src/main/java/org/apache/kafka/tools/ClientCompatibilityTest.java
index d7eb717b7227f..6ed97bba0dee4 100644
--- a/tools/src/main/java/org/apache/kafka/tools/ClientCompatibilityTest.java
+++ b/tools/src/main/java/org/apache/kafka/tools/ClientCompatibilityTest.java
@@ -35,8 +35,8 @@
 import org.apache.kafka.common.ClusterResourceListener;
 import org.apache.kafka.common.PartitionInfo;
 import org.apache.kafka.common.TopicPartition;
-import org.apache.kafka.common.errors.ObsoleteBrokerException;
 import org.apache.kafka.common.errors.RecordTooLargeException;
+import org.apache.kafka.common.errors.UnsupportedVersionException;
 import org.apache.kafka.common.serialization.ByteArraySerializer;
 import org.apache.kafka.common.serialization.Deserializer;
 import org.apache.kafka.common.utils.Time;
@@ -362,8 +362,8 @@ private void tryFeature(String featureName, boolean supported, Runnable invoker,
         try {
             invoker.run();
             log.info("Successfully used feature {}", featureName);
-        } catch (ObsoleteBrokerException e) {
-            log.info("Got ObsoleteBrokerException when attempting to use feature {}", featureName);
+        } catch (UnsupportedVersionException e) {
+            log.info("Got UnsupportedVersionException when attempting to use feature {}", featureName);
             if (supported) {
                 throw new RuntimeException("Expected " + featureName + " to be supported, but it wasn't.", e);
             }

From 6cb76b95af8c00cdfb6d49401da7362744e72d64 Mon Sep 17 00:00:00 2001
From: Ewen Cheslack-Postava <me@ewencp.org>
Date: Sat, 28 Jan 2017 01:40:10 +0000
Subject: [PATCH 076/177] KAFKA-4450; Add upgrade tests for 0.10.1 and rename
 TRUNK to DEV_BRANCH to reduce confusion

Author: Ewen Cheslack-Postava <me@ewencp.org>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2457 from ewencp/kafka-4450-upgrade-tests
---
 tests/docker/run_tests.sh                      |  4 ++--
 tests/kafkatest/__init__.py                    |  2 +-
 .../benchmarks/core/benchmark_test.py          | 18 +++++++++---------
 tests/kafkatest/directory_layout/kafka_path.py | 14 +++++++-------
 .../sanity_checks/test_kafka_version.py        |  6 +++---
 .../sanity_checks/test_performance_services.py |  6 +++---
 .../sanity_checks/test_verifiable_producer.py  | 16 ++++++++--------
 tests/kafkatest/services/console_consumer.py   |  4 ++--
 tests/kafkatest/services/kafka/kafka.py        |  4 ++--
 .../performance/consumer_performance.py        |  4 ++--
 .../services/performance/end_to_end_latency.py |  4 ++--
 .../performance/producer_performance.py        | 12 ++++++------
 tests/kafkatest/services/security/minikdc.py   |  6 +++---
 .../kafkatest/services/verifiable_consumer.py  |  4 ++--
 .../kafkatest/services/verifiable_producer.py  | 10 +++++-----
 tests/kafkatest/services/zookeeper.py          |  4 ++--
 .../client_compatibility_features_test.py      |  4 ++--
 ...lient_compatibility_produce_consume_test.py |  4 ++--
 .../tests/client/message_format_change_test.py |  8 ++++----
 .../core/compatibility_test_new_broker_test.py | 17 +++++++++--------
 tests/kafkatest/tests/core/upgrade_test.py     | 11 +++++++----
 tests/kafkatest/version.py                     | 17 +++++++----------
 .../directory_layout/check_project_paths.py    | 14 +++++++-------
 tests/unit/version/check_version.py            |  6 +++---
 .../kafka/tools/VerifiableLog4jAppender.java   |  2 +-
 .../apache/kafka/tools/VerifiableProducer.java |  2 +-
 vagrant/base.sh                                |  6 +++---
 vagrant/broker.sh                              |  2 +-
 vagrant/zk.sh                                  |  2 +-
 29 files changed, 107 insertions(+), 106 deletions(-)

diff --git a/tests/docker/run_tests.sh b/tests/docker/run_tests.sh
index dadb031c251f1..0e5378a8f26b8 100755
--- a/tests/docker/run_tests.sh
+++ b/tests/docker/run_tests.sh
@@ -55,7 +55,7 @@ docker network inspect knw
 
 for i in $(seq -w 1 ${KAFKA_NUM_CONTAINERS}); do
   echo knode${i}
-  docker exec knode${i} bash -c "(tar xfz /kafka_src/core/build/distributions/kafka_*SNAPSHOT.tgz -C /opt || echo missing kafka tgz did you build kafka tarball) && mv /opt/kafka*SNAPSHOT /opt/kafka-trunk && ls -l /opt"
+  docker exec knode${i} bash -c "(tar xfz /kafka_src/core/build/distributions/kafka_*SNAPSHOT.tgz -C /opt || echo missing kafka tgz did you build kafka tarball) && mv /opt/kafka*SNAPSHOT /opt/kafka-dev && ls -l /opt"
   docker exec knode01 bash -c "ssh knode$i hostname"
 done
 
@@ -64,7 +64,7 @@ done
 (cd ${KAFKA_SRC} && ./gradlew copyDependantTestLibs)
 for i in $(seq -w 1 ${KAFKA_NUM_CONTAINERS}); do
   echo knode${i}
-  docker exec knode${i} bash -c "cp /kafka_src/core/build/dependant-testlibs/* /opt/kafka-trunk/libs/"
+  docker exec knode${i} bash -c "cp /kafka_src/core/build/dependant-testlibs/* /opt/kafka-dev/libs/"
   docker exec knode01 bash -c "ssh knode$i hostname"
 done
 
diff --git a/tests/kafkatest/__init__.py b/tests/kafkatest/__init__.py
index 7006860f28c0a..f337765e38853 100644
--- a/tests/kafkatest/__init__.py
+++ b/tests/kafkatest/__init__.py
@@ -19,7 +19,7 @@
 # due to python version naming restrictions, which are enforced by python packaging tools
 # (see  https://www.python.org/dev/peps/pep-0440/)
 #
-# Instead, in trunk, the version should have a suffix of the form ".devN"
+# Instead, in development branches, the version should have a suffix of the form ".devN"
 #
 # For example, when Kafka is at version 0.9.0.0-SNAPSHOT, this should be something like "0.9.0.0.dev0"
 __version__ = '0.10.2.0.dev0'
diff --git a/tests/kafkatest/benchmarks/core/benchmark_test.py b/tests/kafkatest/benchmarks/core/benchmark_test.py
index 14fab2f45ec65..b068fff63caf4 100644
--- a/tests/kafkatest/benchmarks/core/benchmark_test.py
+++ b/tests/kafkatest/benchmarks/core/benchmark_test.py
@@ -22,7 +22,7 @@
 from kafkatest.services.kafka import KafkaService
 from kafkatest.services.performance import ProducerPerformanceService, EndToEndLatencyService, ConsumerPerformanceService, throughput, latency, compute_aggregate_throughput
 from kafkatest.services.zookeeper import ZookeeperService
-from kafkatest.version import TRUNK, KafkaVersion
+from kafkatest.version import DEV_BRANCH, KafkaVersion
 
 TOPIC_REP_ONE = "topic-replication-factor-one"
 TOPIC_REP_THREE = "topic-replication-factor-three"
@@ -72,8 +72,8 @@ def start_kafka(self, security_protocol, interbroker_security_protocol, version)
     @cluster(num_nodes=7)
     @parametrize(acks=1, topic=TOPIC_REP_THREE, num_producers=3)
     def test_producer_throughput(self, acks, topic, num_producers=1, message_size=DEFAULT_RECORD_SIZE,
-                                 compression_type="none", security_protocol='PLAINTEXT', client_version=str(TRUNK),
-                                 broker_version=str(TRUNK)):
+                                 compression_type="none", security_protocol='PLAINTEXT', client_version=str(DEV_BRANCH),
+                                 broker_version=str(DEV_BRANCH)):
         """
         Setup: 1 node zk + 3 node kafka cluster
         Produce ~128MB worth of messages to a topic with 6 partitions. Required acks, topic replication factor,
@@ -104,8 +104,8 @@ def test_producer_throughput(self, acks, topic, num_producers=1, message_size=DE
     @parametrize(security_protocol='SSL', interbroker_security_protocol='PLAINTEXT')
     @matrix(security_protocol=['PLAINTEXT', 'SSL'], compression_type=["none", "snappy"])
     def test_long_term_producer_throughput(self, compression_type="none", security_protocol='PLAINTEXT',
-                                           interbroker_security_protocol=None, client_version=str(TRUNK),
-                                           broker_version=str(TRUNK)):
+                                           interbroker_security_protocol=None, client_version=str(DEV_BRANCH),
+                                           broker_version=str(DEV_BRANCH)):
         """
         Setup: 1 node zk + 3 node kafka cluster
         Produce 10e6 100 byte messages to a topic with 6 partitions, replication-factor 3, and acks=1.
@@ -162,8 +162,8 @@ def test_long_term_producer_throughput(self, compression_type="none", security_p
     @cluster(num_nodes=6)
     @matrix(security_protocol=['SASL_PLAINTEXT', 'SASL_SSL'], compression_type=["none", "snappy"])
     def test_end_to_end_latency(self, compression_type="none", security_protocol="PLAINTEXT",
-                                interbroker_security_protocol=None, client_version=str(TRUNK),
-                                broker_version=str(TRUNK)):
+                                interbroker_security_protocol=None, client_version=str(DEV_BRANCH),
+                                broker_version=str(DEV_BRANCH)):
         """
         Setup: 1 node zk + 3 node kafka cluster
         Produce (acks = 1) and consume 10e3 messages to a topic with 6 partitions and replication-factor 3,
@@ -194,7 +194,7 @@ def test_end_to_end_latency(self, compression_type="none", security_protocol="PL
     @matrix(security_protocol=['PLAINTEXT', 'SSL'], compression_type=["none", "snappy"])
     def test_producer_and_consumer(self, compression_type="none", security_protocol="PLAINTEXT",
                                    interbroker_security_protocol=None, new_consumer=True,
-                                   client_version=str(TRUNK), broker_version=str(TRUNK)):
+                                   client_version=str(DEV_BRANCH), broker_version=str(DEV_BRANCH)):
         """
         Setup: 1 node zk + 3 node kafka cluster
         Concurrently produce and consume 10e6 messages with a single producer and a single consumer,
@@ -243,7 +243,7 @@ def test_producer_and_consumer(self, compression_type="none", security_protocol=
     @matrix(security_protocol=['PLAINTEXT', 'SSL'], compression_type=["none", "snappy"])
     def test_consumer_throughput(self, compression_type="none", security_protocol="PLAINTEXT",
                                  interbroker_security_protocol=None, new_consumer=True, num_consumers=1,
-                                 client_version=str(TRUNK), broker_version=str(TRUNK)):
+                                 client_version=str(DEV_BRANCH), broker_version=str(DEV_BRANCH)):
         """
         Consume 10e6 100-byte messages with 1 or more consumers from a topic with 6 partitions
         (using new consumer iff new_consumer == True), and report throughput.
diff --git a/tests/kafkatest/directory_layout/kafka_path.py b/tests/kafkatest/directory_layout/kafka_path.py
index 0e60affa2426a..ece8be58214e0 100644
--- a/tests/kafkatest/directory_layout/kafka_path.py
+++ b/tests/kafkatest/directory_layout/kafka_path.py
@@ -16,7 +16,7 @@
 import importlib
 import os
 
-from kafkatest.version import get_version, KafkaVersion, TRUNK
+from kafkatest.version import get_version, KafkaVersion, DEV_BRANCH
 
 
 """This module serves a few purposes:
@@ -43,7 +43,7 @@
 TOOLS_DEPENDANT_TEST_LIBS_JAR_NAME = "tools-dependant-libs"
 
 JARS = {
-    "trunk": {
+    "dev": {
         CORE_JAR_NAME: "core/build/*/*.jar",
         CORE_LIBS_JAR_NAME: "core/build/libs/*.jar",
         CORE_DEPENDANT_TEST_LIBS_JAR_NAME: "core/build/dependant-testlibs/*.jar",
@@ -97,7 +97,7 @@ def path(self):
 class KafkaSystemTestPathResolver(object):
     """Path resolver for Kafka system tests which assumes the following layout:
 
-        /opt/kafka-trunk        # Current version of kafka under test
+        /opt/kafka-dev          # Current version of kafka under test
         /opt/kafka-0.9.0.1      # Example of an older version of kafka installed from tarball
         /opt/kafka-<version>    # Other previous versions of kafka
         ...
@@ -106,7 +106,7 @@ def __init__(self, context, project="kafka"):
         self.context = context
         self.project = project
 
-    def home(self, node_or_version=TRUNK):
+    def home(self, node_or_version=DEV_BRANCH):
         version = self._version(node_or_version)
         home_dir = self.project
         if version is not None:
@@ -114,15 +114,15 @@ def home(self, node_or_version=TRUNK):
 
         return os.path.join(KAFKA_INSTALL_ROOT, home_dir)
 
-    def bin(self, node_or_version=TRUNK):
+    def bin(self, node_or_version=DEV_BRANCH):
         version = self._version(node_or_version)
         return os.path.join(self.home(version), "bin")
 
-    def script(self, script_name, node_or_version=TRUNK):
+    def script(self, script_name, node_or_version=DEV_BRANCH):
         version = self._version(node_or_version)
         return os.path.join(self.bin(version), script_name)
 
-    def jar(self, jar_name, node_or_version=TRUNK):
+    def jar(self, jar_name, node_or_version=DEV_BRANCH):
         version = self._version(node_or_version)
         return os.path.join(self.home(version), JARS[str(version)][jar_name])
 
diff --git a/tests/kafkatest/sanity_checks/test_kafka_version.py b/tests/kafkatest/sanity_checks/test_kafka_version.py
index 35500935c69f4..7e65807270e5f 100644
--- a/tests/kafkatest/sanity_checks/test_kafka_version.py
+++ b/tests/kafkatest/sanity_checks/test_kafka_version.py
@@ -19,7 +19,7 @@
 from kafkatest.services.kafka import KafkaService, config_property
 from kafkatest.services.zookeeper import ZookeeperService
 from kafkatest.utils import is_version
-from kafkatest.version import LATEST_0_8_2, TRUNK
+from kafkatest.version import LATEST_0_8_2, DEV_BRANCH
 
 
 class KafkaVersionTest(Test):
@@ -47,12 +47,12 @@ def test_0_8_2(self):
     @cluster(num_nodes=3)
     def test_multi_version(self):
         """Test kafka service node-versioning api - ensure we can bring up a 2-node cluster, one on version 0.8.2.X,
-        the other on trunk."""
+        the other on the current development branch."""
         self.kafka = KafkaService(self.test_context, num_nodes=2, zk=self.zk,
                                   topics={self.topic: {"partitions": 1, "replication-factor": 2}})
         self.kafka.nodes[1].version = LATEST_0_8_2
         self.kafka.nodes[1].config[config_property.INTER_BROKER_PROTOCOL_VERSION] = "0.8.2.X"
         self.kafka.start()
 
-        assert is_version(self.kafka.nodes[0], [TRUNK.vstring])
+        assert is_version(self.kafka.nodes[0], [DEV_BRANCH.vstring])
         assert is_version(self.kafka.nodes[1], [LATEST_0_8_2])
diff --git a/tests/kafkatest/sanity_checks/test_performance_services.py b/tests/kafkatest/sanity_checks/test_performance_services.py
index b939f2b61ce98..6ff34b8606bee 100644
--- a/tests/kafkatest/sanity_checks/test_performance_services.py
+++ b/tests/kafkatest/sanity_checks/test_performance_services.py
@@ -21,7 +21,7 @@
 from kafkatest.services.performance import ProducerPerformanceService, ConsumerPerformanceService, EndToEndLatencyService
 from kafkatest.services.performance import latency, compute_aggregate_throughput
 from kafkatest.services.zookeeper import ZookeeperService
-from kafkatest.version import TRUNK, LATEST_0_8_2, LATEST_0_9, KafkaVersion
+from kafkatest.version import DEV_BRANCH, LATEST_0_8_2, LATEST_0_9, KafkaVersion
 
 
 class PerformanceServiceTest(Test):
@@ -42,8 +42,8 @@ def setUp(self):
     @parametrize(version=str(LATEST_0_8_2), new_consumer=False)
     @parametrize(version=str(LATEST_0_9), new_consumer=False)
     @parametrize(version=str(LATEST_0_9))
-    @parametrize(version=str(TRUNK), new_consumer=False)
-    @parametrize(version=str(TRUNK))
+    @parametrize(version=str(DEV_BRANCH), new_consumer=False)
+    @parametrize(version=str(DEV_BRANCH))
     def test_version(self, version=str(LATEST_0_9), new_consumer=True):
         """
         Sanity check out producer performance service - verify that we can run the service with a small
diff --git a/tests/kafkatest/sanity_checks/test_verifiable_producer.py b/tests/kafkatest/sanity_checks/test_verifiable_producer.py
index 544d7b989193f..b4ca4e94f4b56 100644
--- a/tests/kafkatest/sanity_checks/test_verifiable_producer.py
+++ b/tests/kafkatest/sanity_checks/test_verifiable_producer.py
@@ -23,7 +23,7 @@
 from kafkatest.services.verifiable_producer import VerifiableProducer
 from kafkatest.services.zookeeper import ZookeeperService
 from kafkatest.utils import is_version
-from kafkatest.version import LATEST_0_8_2, LATEST_0_9, TRUNK, KafkaVersion
+from kafkatest.version import LATEST_0_8_2, LATEST_0_9, DEV_BRANCH, KafkaVersion
 
 
 class TestVerifiableProducer(Test):
@@ -48,10 +48,10 @@ def setUp(self):
     @cluster(num_nodes=3)
     @parametrize(producer_version=str(LATEST_0_8_2))
     @parametrize(producer_version=str(LATEST_0_9))
-    @parametrize(producer_version=str(TRUNK))
-    def test_simple_run(self, producer_version=TRUNK):
+    @parametrize(producer_version=str(DEV_BRANCH))
+    def test_simple_run(self, producer_version=DEV_BRANCH):
         """
-        Test that we can start VerifiableProducer on trunk or against the 0.8.2 jar, and
+        Test that we can start VerifiableProducer on the current branch snapshot version or against the 0.8.2 jar, and
         verify that we can produce a small number of messages.
         """
         node = self.producer.nodes[0]
@@ -61,11 +61,11 @@ def test_simple_run(self, producer_version=TRUNK):
              err_msg="Producer failed to start in a reasonable amount of time.")
 
         # using version.vstring (distutils.version.LooseVersion) is a tricky way of ensuring
-        # that this check works with TRUNK
-        # When running VerifiableProducer 0.8.X, both trunk version and 0.8.X should show up because of the way
-        # verifiable producer pulls in some trunk directories into its classpath
+        # that this check works with DEV_BRANCH
+        # When running VerifiableProducer 0.8.X, both the current branch version and 0.8.X should show up because of the
+        # way verifiable producer pulls in some development directories into its classpath
         if node.version <= LATEST_0_8_2:
-            assert is_version(node, [node.version.vstring, TRUNK.vstring])
+            assert is_version(node, [node.version.vstring, DEV_BRANCH.vstring])
         else:
             assert is_version(node, [node.version.vstring])
 
diff --git a/tests/kafkatest/services/console_consumer.py b/tests/kafkatest/services/console_consumer.py
index cdc46cdca985d..94acb65bd0b8b 100644
--- a/tests/kafkatest/services/console_consumer.py
+++ b/tests/kafkatest/services/console_consumer.py
@@ -21,7 +21,7 @@
 
 from kafkatest.directory_layout.kafka_path import KafkaPathResolverMixin
 from kafkatest.services.monitor.jmx import JmxMixin
-from kafkatest.version import TRUNK, LATEST_0_8_2, LATEST_0_9, LATEST_0_10_0, V_0_10_0_0
+from kafkatest.version import DEV_BRANCH, LATEST_0_8_2, LATEST_0_9, LATEST_0_10_0, V_0_10_0_0
 
 """
 0.8.2.1 ConsoleConsumer options
@@ -87,7 +87,7 @@ class ConsoleConsumer(KafkaPathResolverMixin, JmxMixin, BackgroundThreadService)
     }
 
     def __init__(self, context, num_nodes, kafka, topic, group_id="test-consumer-group", new_consumer=True,
-                 message_validator=None, from_beginning=True, consumer_timeout_ms=None, version=TRUNK,
+                 message_validator=None, from_beginning=True, consumer_timeout_ms=None, version=DEV_BRANCH,
                  client_id="console-consumer", print_key=False, jmx_object_names=None, jmx_attributes=None,
                  enable_systest_events=False, stop_timeout_sec=15, print_timestamp=False):
         """
diff --git a/tests/kafkatest/services/kafka/kafka.py b/tests/kafkatest/services/kafka/kafka.py
index 8ef0f356f43cc..2e65e099ac437 100644
--- a/tests/kafkatest/services/kafka/kafka.py
+++ b/tests/kafkatest/services/kafka/kafka.py
@@ -30,7 +30,7 @@
 from kafkatest.services.monitor.jmx import JmxMixin
 from kafkatest.services.security.minikdc import MiniKdc
 from kafkatest.services.security.security_config import SecurityConfig
-from kafkatest.version import TRUNK
+from kafkatest.version import DEV_BRANCH
 
 Port = collections.namedtuple('Port', ['name', 'number', 'open'])
 
@@ -67,7 +67,7 @@ class KafkaService(KafkaPathResolverMixin, JmxMixin, Service):
 
     def __init__(self, context, num_nodes, zk, security_protocol=SecurityConfig.PLAINTEXT, interbroker_security_protocol=SecurityConfig.PLAINTEXT,
                  client_sasl_mechanism=SecurityConfig.SASL_MECHANISM_GSSAPI, interbroker_sasl_mechanism=SecurityConfig.SASL_MECHANISM_GSSAPI,
-                 authorizer_class_name=None, topics=None, version=TRUNK, jmx_object_names=None,
+                 authorizer_class_name=None, topics=None, version=DEV_BRANCH, jmx_object_names=None,
                  jmx_attributes=None, zk_connect_timeout=5000, zk_session_timeout=6000, server_prop_overides=[]):
         """
         :type context
diff --git a/tests/kafkatest/services/performance/consumer_performance.py b/tests/kafkatest/services/performance/consumer_performance.py
index 3e02a5ba2fbac..e1cd3a0e1b834 100644
--- a/tests/kafkatest/services/performance/consumer_performance.py
+++ b/tests/kafkatest/services/performance/consumer_performance.py
@@ -18,7 +18,7 @@
 
 from kafkatest.services.performance import PerformanceService
 from kafkatest.services.security.security_config import SecurityConfig
-from kafkatest.version import TRUNK, V_0_9_0_0, LATEST_0_10_0
+from kafkatest.version import DEV_BRANCH, V_0_9_0_0, LATEST_0_10_0
 
 
 class ConsumerPerformanceService(PerformanceService):
@@ -70,7 +70,7 @@ class ConsumerPerformanceService(PerformanceService):
             "collect_default": True}
     }
 
-    def __init__(self, context, num_nodes, kafka, topic, messages, version=TRUNK, new_consumer=True, settings={}):
+    def __init__(self, context, num_nodes, kafka, topic, messages, version=DEV_BRANCH, new_consumer=True, settings={}):
         super(ConsumerPerformanceService, self).__init__(context, num_nodes)
         self.kafka = kafka
         self.security_config = kafka.security_config.client_config()
diff --git a/tests/kafkatest/services/performance/end_to_end_latency.py b/tests/kafkatest/services/performance/end_to_end_latency.py
index 917ac85bc5dce..bdaf5502c751e 100644
--- a/tests/kafkatest/services/performance/end_to_end_latency.py
+++ b/tests/kafkatest/services/performance/end_to_end_latency.py
@@ -17,7 +17,7 @@
 
 from kafkatest.services.performance import PerformanceService
 from kafkatest.services.security.security_config import SecurityConfig
-from kafkatest.version import TRUNK, V_0_9_0_0
+from kafkatest.version import DEV_BRANCH, V_0_9_0_0
 
 
 
@@ -45,7 +45,7 @@ class EndToEndLatencyService(PerformanceService):
             "collect_default": True}
     }
 
-    def __init__(self, context, num_nodes, kafka, topic, num_records, compression_type="none", version=TRUNK, acks=1):
+    def __init__(self, context, num_nodes, kafka, topic, num_records, compression_type="none", version=DEV_BRANCH, acks=1):
         super(EndToEndLatencyService, self).__init__(context, num_nodes)
         self.kafka = kafka
         self.security_config = kafka.security_config.client_config()
diff --git a/tests/kafkatest/services/performance/producer_performance.py b/tests/kafkatest/services/performance/producer_performance.py
index 1113e0db65ca0..ff92da86bbf06 100644
--- a/tests/kafkatest/services/performance/producer_performance.py
+++ b/tests/kafkatest/services/performance/producer_performance.py
@@ -22,7 +22,7 @@
 from kafkatest.services.monitor.jmx import JmxMixin
 from kafkatest.services.performance import PerformanceService
 from kafkatest.services.security.security_config import SecurityConfig
-from kafkatest.version import TRUNK, V_0_9_0_0
+from kafkatest.version import DEV_BRANCH, V_0_9_0_0
 
 
 class ProducerPerformanceService(JmxMixin, PerformanceService):
@@ -34,7 +34,7 @@ class ProducerPerformanceService(JmxMixin, PerformanceService):
     LOG_FILE = os.path.join(LOG_DIR, "producer_performance.log")
     LOG4J_CONFIG = os.path.join(PERSISTENT_ROOT, "tools-log4j.properties")
 
-    def __init__(self, context, num_nodes, kafka, topic, num_records, record_size, throughput, version=TRUNK, settings=None,
+    def __init__(self, context, num_nodes, kafka, topic, num_records, record_size, throughput, version=DEV_BRANCH, settings=None,
                  intermediate_stats=False, client_id="producer-performance", jmx_object_names=None, jmx_attributes=None):
 
         JmxMixin.__init__(self, num_nodes, jmx_object_names, jmx_attributes or [])
@@ -89,11 +89,11 @@ def start_cmd(self, node):
 
         cmd = ""
 
-        if node.version < TRUNK:
+        if node.version < DEV_BRANCH:
             # In order to ensure more consistent configuration between versions, always use the ProducerPerformance
-            # tool from trunk
-            tools_jar = self.path.jar(TOOLS_JAR_NAME, TRUNK)
-            tools_dependant_libs_jar = self.path.jar(TOOLS_DEPENDANT_TEST_LIBS_JAR_NAME, TRUNK)
+            # tool from the development branch
+            tools_jar = self.path.jar(TOOLS_JAR_NAME, DEV_BRANCH)
+            tools_dependant_libs_jar = self.path.jar(TOOLS_DEPENDANT_TEST_LIBS_JAR_NAME, DEV_BRANCH)
 
             cmd += "for file in %s; do CLASSPATH=$CLASSPATH:$file; done; " % tools_jar
             cmd += "for file in %s; do CLASSPATH=$CLASSPATH:$file; done; " % tools_dependant_libs_jar
diff --git a/tests/kafkatest/services/security/minikdc.py b/tests/kafkatest/services/security/minikdc.py
index b3cbeaef53060..86a713882b010 100644
--- a/tests/kafkatest/services/security/minikdc.py
+++ b/tests/kafkatest/services/security/minikdc.py
@@ -24,7 +24,7 @@
 from ducktape.services.service import Service
 
 from kafkatest.directory_layout.kafka_path import KafkaPathResolverMixin, CORE_LIBS_JAR_NAME, CORE_DEPENDANT_TEST_LIBS_JAR_NAME
-from kafkatest.version import TRUNK
+from kafkatest.version import DEV_BRANCH
 
 
 class MiniKdc(KafkaPathResolverMixin, Service):
@@ -103,8 +103,8 @@ def start_node(self, node):
         principals = 'client ' + kafka_principals + ' ' + self.extra_principals
         self.logger.info("Starting MiniKdc with principals " + principals)
 
-        core_libs_jar = self.path.jar(CORE_LIBS_JAR_NAME, TRUNK)
-        core_dependant_test_libs_jar = self.path.jar(CORE_DEPENDANT_TEST_LIBS_JAR_NAME, TRUNK)
+        core_libs_jar = self.path.jar(CORE_LIBS_JAR_NAME, DEV_BRANCH)
+        core_dependant_test_libs_jar = self.path.jar(CORE_DEPENDANT_TEST_LIBS_JAR_NAME, DEV_BRANCH)
 
         cmd = "for file in %s; do CLASSPATH=$CLASSPATH:$file; done;" % core_libs_jar
         cmd += " for file in %s; do CLASSPATH=$CLASSPATH:$file; done;" % core_dependant_test_libs_jar
diff --git a/tests/kafkatest/services/verifiable_consumer.py b/tests/kafkatest/services/verifiable_consumer.py
index 711554c07ce99..d7fca876e6a85 100644
--- a/tests/kafkatest/services/verifiable_consumer.py
+++ b/tests/kafkatest/services/verifiable_consumer.py
@@ -22,7 +22,7 @@
 
 from kafkatest.directory_layout.kafka_path import KafkaPathResolverMixin
 from kafkatest.services.kafka import TopicPartition
-from kafkatest.version import TRUNK
+from kafkatest.version import DEV_BRANCH
 
 
 class ConsumerState:
@@ -136,7 +136,7 @@ class VerifiableConsumer(KafkaPathResolverMixin, BackgroundThreadService):
     def __init__(self, context, num_nodes, kafka, topic, group_id,
                  max_messages=-1, session_timeout_sec=30, enable_autocommit=False,
                  assignment_strategy="org.apache.kafka.clients.consumer.RangeAssignor",
-                 version=TRUNK, stop_timeout_sec=30):
+                 version=DEV_BRANCH, stop_timeout_sec=30):
         super(VerifiableConsumer, self).__init__(context, num_nodes)
         self.log_level = "TRACE"
         
diff --git a/tests/kafkatest/services/verifiable_producer.py b/tests/kafkatest/services/verifiable_producer.py
index d873e1f82b525..f545634aa6419 100644
--- a/tests/kafkatest/services/verifiable_producer.py
+++ b/tests/kafkatest/services/verifiable_producer.py
@@ -24,7 +24,7 @@
 
 from kafkatest.directory_layout.kafka_path import KafkaPathResolverMixin, TOOLS_JAR_NAME, TOOLS_DEPENDANT_TEST_LIBS_JAR_NAME
 from kafkatest.utils import is_int, is_int_with_prefix
-from kafkatest.version import TRUNK, LATEST_0_8_2
+from kafkatest.version import DEV_BRANCH, LATEST_0_8_2
 from kafkatest.utils.remote_account import line_count
 
 
@@ -50,7 +50,7 @@ class VerifiableProducer(KafkaPathResolverMixin, BackgroundThreadService):
         }
 
     def __init__(self, context, num_nodes, kafka, topic, max_messages=-1, throughput=100000,
-                 message_validator=is_int, compression_types=None, version=TRUNK, acks=None,
+                 message_validator=is_int, compression_types=None, version=DEV_BRANCH, acks=None,
                  stop_timeout_sec=150):
         """
         :param max_messages is a number of messages to be produced per producer
@@ -181,9 +181,9 @@ def start_cmd(self, node, idx):
         cmd = ""
         if node.version <= LATEST_0_8_2:
             # 0.8.2.X releases do not have VerifiableProducer.java, so cheat and add
-            # the tools jar from trunk to the classpath
-            tools_jar = self.path.jar(TOOLS_JAR_NAME, TRUNK)
-            tools_dependant_libs_jar = self.path.jar(TOOLS_DEPENDANT_TEST_LIBS_JAR_NAME, TRUNK)
+            # the tools jar from the development branch to the classpath
+            tools_jar = self.path.jar(TOOLS_JAR_NAME, DEV_BRANCH)
+            tools_dependant_libs_jar = self.path.jar(TOOLS_DEPENDANT_TEST_LIBS_JAR_NAME, DEV_BRANCH)
 
             cmd += "for file in %s; do CLASSPATH=$CLASSPATH:$file; done; " % tools_jar
             cmd += "for file in %s; do CLASSPATH=$CLASSPATH:$file; done; " % tools_dependant_libs_jar
diff --git a/tests/kafkatest/services/zookeeper.py b/tests/kafkatest/services/zookeeper.py
index 8d38d48535143..571956b1a6a45 100644
--- a/tests/kafkatest/services/zookeeper.py
+++ b/tests/kafkatest/services/zookeeper.py
@@ -23,7 +23,7 @@
 
 from kafkatest.directory_layout.kafka_path import KafkaPathResolverMixin
 from kafkatest.services.security.security_config import SecurityConfig
-from kafkatest.version import TRUNK
+from kafkatest.version import DEV_BRANCH
 
 
 class ZookeeperService(KafkaPathResolverMixin, Service):
@@ -122,7 +122,7 @@ def query(self, path):
         """
         Queries zookeeper for data associated with 'path' and returns all fields in the schema
         """
-        kafka_run_class = self.path.script("kafka-run-class.sh", TRUNK)
+        kafka_run_class = self.path.script("kafka-run-class.sh", DEV_BRANCH)
         cmd = "%s kafka.tools.ZooKeeperMainWrapper -server %s get %s" % \
               (kafka_run_class, self.connect_setting(), path)
         self.logger.debug(cmd)
diff --git a/tests/kafkatest/tests/client/client_compatibility_features_test.py b/tests/kafkatest/tests/client/client_compatibility_features_test.py
index 36d76b4b06726..d478590dcfd36 100644
--- a/tests/kafkatest/tests/client/client_compatibility_features_test.py
+++ b/tests/kafkatest/tests/client/client_compatibility_features_test.py
@@ -23,7 +23,7 @@
 from kafkatest.services.zookeeper import ZookeeperService
 from kafkatest.services.kafka import KafkaService
 from ducktape.tests.test import Test
-from kafkatest.version import TRUNK, LATEST_0_10_0, LATEST_0_10_1, V_0_10_1_0, KafkaVersion
+from kafkatest.version import DEV_BRANCH, LATEST_0_10_0, LATEST_0_10_1, V_0_10_1_0, KafkaVersion
 
 def get_broker_features(broker_version):
     features = {}
@@ -93,7 +93,7 @@ def invoke_compatibility_program(self, features):
           self.logger.info("** Command failed.  See %s for log messages." % ssh_log_file)
           raise e
 
-    @parametrize(broker_version=str(TRUNK))
+    @parametrize(broker_version=str(DEV_BRANCH))
     @parametrize(broker_version=str(LATEST_0_10_0))
     @parametrize(broker_version=str(LATEST_0_10_1))
     def run_compatibility_test(self, broker_version):
diff --git a/tests/kafkatest/tests/client/client_compatibility_produce_consume_test.py b/tests/kafkatest/tests/client/client_compatibility_produce_consume_test.py
index 35b904b77ae01..c5e80cbec4d0a 100644
--- a/tests/kafkatest/tests/client/client_compatibility_produce_consume_test.py
+++ b/tests/kafkatest/tests/client/client_compatibility_produce_consume_test.py
@@ -22,7 +22,7 @@
 from kafkatest.services.console_consumer import ConsoleConsumer
 from kafkatest.tests.produce_consume_validate import ProduceConsumeValidateTest
 from kafkatest.utils import is_int_with_prefix
-from kafkatest.version import TRUNK, LATEST_0_10_0, LATEST_0_10_1, KafkaVersion
+from kafkatest.version import DEV_BRANCH, LATEST_0_10_0, LATEST_0_10_1, KafkaVersion
 
 class ClientCompatibilityProduceConsumeTest(ProduceConsumeValidateTest):
     """
@@ -52,7 +52,7 @@ def min_cluster_size(self):
         # Override this since we're adding services outside of the constructor
         return super(ClientCompatibilityProduceConsumeTest, self).min_cluster_size() + self.num_producers + self.num_consumers
 
-    @parametrize(broker_version=str(TRUNK))
+    @parametrize(broker_version=str(DEV_BRANCH))
     @parametrize(broker_version=str(LATEST_0_10_0))
     @parametrize(broker_version=str(LATEST_0_10_1))
     def test_produce_consume(self, broker_version):
diff --git a/tests/kafkatest/tests/client/message_format_change_test.py b/tests/kafkatest/tests/client/message_format_change_test.py
index edcead2abf080..e58f58b06b156 100644
--- a/tests/kafkatest/tests/client/message_format_change_test.py
+++ b/tests/kafkatest/tests/client/message_format_change_test.py
@@ -22,7 +22,7 @@
 from kafkatest.services.zookeeper import ZookeeperService
 from kafkatest.tests.produce_consume_validate import ProduceConsumeValidateTest
 from kafkatest.utils import is_int
-from kafkatest.version import LATEST_0_9, LATEST_0_10, TRUNK, KafkaVersion
+from kafkatest.version import LATEST_0_9, LATEST_0_10, DEV_BRANCH, KafkaVersion
 
 
 class MessageFormatChangeTest(ProduceConsumeValidateTest):
@@ -58,7 +58,7 @@ def produce_and_consume(self, producer_version, consumer_version, group):
             err_msg="Producer did not produce all messages in reasonable amount of time"))
 
     @cluster(num_nodes=10)
-    @parametrize(producer_version=str(TRUNK), consumer_version=str(TRUNK))
+    @parametrize(producer_version=str(DEV_BRANCH), consumer_version=str(DEV_BRANCH))
     @parametrize(producer_version=str(LATEST_0_9), consumer_version=str(LATEST_0_9))
     def test_compatibility(self, producer_version, consumer_version):
         """ This tests performs the following checks:
@@ -70,7 +70,7 @@ def test_compatibility(self, producer_version, consumer_version):
         - The producers and consumers should not have any issue.
         - Note that for 0.9.x consumers/producers we only do steps 1 and 2
         """
-        self.kafka = KafkaService(self.test_context, num_nodes=3, zk=self.zk, version=TRUNK, topics={self.topic: {
+        self.kafka = KafkaService(self.test_context, num_nodes=3, zk=self.zk, version=DEV_BRANCH, topics={self.topic: {
                                                                     "partitions": 3,
                                                                     "replication-factor": 3,
                                                                     'configs': {"min.insync.replicas": 2}}})
@@ -84,7 +84,7 @@ def test_compatibility(self, producer_version, consumer_version):
         self.kafka.alter_message_format(self.topic, str(LATEST_0_10))
         self.produce_and_consume(producer_version, consumer_version, "group2")
 
-        if producer_version == str(TRUNK) and consumer_version == str(TRUNK):
+        if producer_version == str(DEV_BRANCH) and consumer_version == str(DEV_BRANCH):
             self.logger.info("Third format change back to 0.9.0")
             self.kafka.alter_message_format(self.topic, str(LATEST_0_9))
             self.produce_and_consume(producer_version, consumer_version, "group3")
diff --git a/tests/kafkatest/tests/core/compatibility_test_new_broker_test.py b/tests/kafkatest/tests/core/compatibility_test_new_broker_test.py
index f3931ec9864f3..da6483d9023b3 100644
--- a/tests/kafkatest/tests/core/compatibility_test_new_broker_test.py
+++ b/tests/kafkatest/tests/core/compatibility_test_new_broker_test.py
@@ -23,7 +23,7 @@
 from kafkatest.services.zookeeper import ZookeeperService
 from kafkatest.tests.produce_consume_validate import ProduceConsumeValidateTest
 from kafkatest.utils import is_int
-from kafkatest.version import LATEST_0_10_0, LATEST_0_9, LATEST_0_8_2, TRUNK, KafkaVersion
+from kafkatest.version import LATEST_0_10_1, LATEST_0_10_0, LATEST_0_9, LATEST_0_8_2, DEV_BRANCH, KafkaVersion
 
 
 # Compatibility tests for moving to a new broker (e.g., 0.10.x) and using a mix of old and new clients (e.g., 0.9.x)
@@ -47,17 +47,18 @@ def setUp(self):
     @cluster(num_nodes=6)
     @parametrize(producer_version=str(LATEST_0_8_2), consumer_version=str(LATEST_0_8_2), compression_types=["none"], new_consumer=False, timestamp_type=None)
     @parametrize(producer_version=str(LATEST_0_8_2), consumer_version=str(LATEST_0_9), compression_types=["none"], new_consumer=False, timestamp_type=None)
-    @parametrize(producer_version=str(LATEST_0_9), consumer_version=str(TRUNK), compression_types=["none"], new_consumer=False, timestamp_type=None)
-    @parametrize(producer_version=str(TRUNK), consumer_version=str(LATEST_0_9), compression_types=["none"], new_consumer=False, timestamp_type=None)
-    @parametrize(producer_version=str(LATEST_0_9), consumer_version=str(TRUNK), compression_types=["snappy"], timestamp_type=None)
-    @parametrize(producer_version=str(TRUNK), consumer_version=str(LATEST_0_9), compression_types=["snappy"], timestamp_type=str("CreateTime"))
-    @parametrize(producer_version=str(TRUNK), consumer_version=str(TRUNK), compression_types=["snappy"], timestamp_type=str("LogAppendTime"))
+    @parametrize(producer_version=str(LATEST_0_9), consumer_version=str(DEV_BRANCH), compression_types=["none"], new_consumer=False, timestamp_type=None)
+    @parametrize(producer_version=str(DEV_BRANCH), consumer_version=str(LATEST_0_9), compression_types=["none"], new_consumer=False, timestamp_type=None)
+    @parametrize(producer_version=str(LATEST_0_9), consumer_version=str(DEV_BRANCH), compression_types=["snappy"], timestamp_type=None)
+    @parametrize(producer_version=str(DEV_BRANCH), consumer_version=str(LATEST_0_9), compression_types=["snappy"], timestamp_type=str("CreateTime"))
+    @parametrize(producer_version=str(DEV_BRANCH), consumer_version=str(DEV_BRANCH), compression_types=["snappy"], timestamp_type=str("LogAppendTime"))
+    @parametrize(producer_version=str(LATEST_0_10_1), consumer_version=str(LATEST_0_10_1), compression_types=["snappy"], timestamp_type=str("LogAppendTime"))
     @parametrize(producer_version=str(LATEST_0_10_0), consumer_version=str(LATEST_0_10_0), compression_types=["snappy"], timestamp_type=str("LogAppendTime"))
     @parametrize(producer_version=str(LATEST_0_9), consumer_version=str(LATEST_0_9), compression_types=["snappy"], timestamp_type=str("LogAppendTime"))
-    @parametrize(producer_version=str(TRUNK), consumer_version=str(TRUNK), compression_types=["none"], new_consumer=False, timestamp_type=str("LogAppendTime"))
+    @parametrize(producer_version=str(DEV_BRANCH), consumer_version=str(DEV_BRANCH), compression_types=["none"], new_consumer=False, timestamp_type=str("LogAppendTime"))
     def test_compatibility(self, producer_version, consumer_version, compression_types, new_consumer=True, timestamp_type=None):
 
-        self.kafka = KafkaService(self.test_context, num_nodes=3, zk=self.zk, version=TRUNK, topics={self.topic: {
+        self.kafka = KafkaService(self.test_context, num_nodes=3, zk=self.zk, version=DEV_BRANCH, topics={self.topic: {
                                                                     "partitions": 3,
                                                                     "replication-factor": 3,
                                                                     'configs': {"min.insync.replicas": 2}}})
diff --git a/tests/kafkatest/tests/core/upgrade_test.py b/tests/kafkatest/tests/core/upgrade_test.py
index 34af4eb56c7e1..8d89b7c13c36d 100644
--- a/tests/kafkatest/tests/core/upgrade_test.py
+++ b/tests/kafkatest/tests/core/upgrade_test.py
@@ -25,7 +25,7 @@
 from kafkatest.services.zookeeper import ZookeeperService
 from kafkatest.tests.produce_consume_validate import ProduceConsumeValidateTest
 from kafkatest.utils import is_int
-from kafkatest.version import LATEST_0_8_2, LATEST_0_9, LATEST_0_10_0, TRUNK, KafkaVersion
+from kafkatest.version import LATEST_0_8_2, LATEST_0_9, LATEST_0_10_0, LATEST_0_10_1, DEV_BRANCH, KafkaVersion
 
 class TestUpgrade(ProduceConsumeValidateTest):
 
@@ -46,7 +46,7 @@ def perform_upgrade(self, from_kafka_version, to_message_format_version=None):
         self.logger.info("First pass bounce - rolling upgrade")
         for node in self.kafka.nodes:
             self.kafka.stop_node(node)
-            node.version = TRUNK
+            node.version = DEV_BRANCH
             node.config[config_property.INTER_BROKER_PROTOCOL_VERSION] = from_kafka_version
             node.config[config_property.MESSAGE_FORMAT_VERSION] = from_kafka_version
             self.kafka.start_node(node)
@@ -62,6 +62,8 @@ def perform_upgrade(self, from_kafka_version, to_message_format_version=None):
             self.kafka.start_node(node)
 
     @cluster(num_nodes=6)
+    @parametrize(from_kafka_version=str(LATEST_0_10_1), to_message_format_version=None, compression_types=["lz4"])
+    @parametrize(from_kafka_version=str(LATEST_0_10_1), to_message_format_version=None, compression_types=["snappy"], new_consumer=False)
     @parametrize(from_kafka_version=str(LATEST_0_10_0), to_message_format_version=None, compression_types=["snappy"], new_consumer=False)
     @parametrize(from_kafka_version=str(LATEST_0_10_0), to_message_format_version=None, compression_types=["snappy"])
     @parametrize(from_kafka_version=str(LATEST_0_9), to_message_format_version=None, compression_types=["none"], new_consumer=False)
@@ -80,7 +82,7 @@ def perform_upgrade(self, from_kafka_version, to_message_format_version=None):
     @parametrize(from_kafka_version=str(LATEST_0_8_2), to_message_format_version=None, compression_types=["snappy"], new_consumer=False)
     def test_upgrade(self, from_kafka_version, to_message_format_version, compression_types,
                      new_consumer=True, security_protocol="PLAINTEXT"):
-        """Test upgrade of Kafka broker cluster from 0.8.2, 0.9.0 or 0.10.0 to the current version
+        """Test upgrade of Kafka broker cluster from 0.8.2, 0.9.0, 0.10.0, 0.10.1 to the current version
 
         from_kafka_version is a Kafka version to upgrade from: either 0.8.2.X, 0.9.0.x or 0.10.0.x
 
@@ -112,7 +114,8 @@ def test_upgrade(self, from_kafka_version, to_message_format_version, compressio
                                            compression_types=compression_types,
                                            version=KafkaVersion(from_kafka_version))
 
-        assert self.zk.query("/cluster/id") is None
+        if from_kafka_version <= LATEST_0_10_0:
+            assert self.zk.query("/cluster/id") is None
 
         # TODO - reduce the timeout
         self.consumer = ConsoleConsumer(self.test_context, self.num_consumers, self.kafka,
diff --git a/tests/kafkatest/version.py b/tests/kafkatest/version.py
index cd361e836b49d..7cd489d87ac64 100644
--- a/tests/kafkatest/version.py
+++ b/tests/kafkatest/version.py
@@ -31,11 +31,8 @@ class KafkaVersion(LooseVersion):
         assert v10 > v9  # assertion passes!
     """
     def __init__(self, version_string):
-        self.is_trunk = (version_string.lower() == "trunk")
-        if self.is_trunk:
-            # Since "trunk" may actually be a branch that is not trunk,
-            # use kafkatest_version() for comparison purposes,
-            # and track whether we're in "trunk" with a flag
+        self.is_dev = (version_string.lower() == "dev")
+        if self.is_dev:
             version_string = kafkatest_version()
 
             # Drop dev suffix if present
@@ -48,22 +45,22 @@ def __init__(self, version_string):
         LooseVersion.__init__(self, version_string)
 
     def __str__(self):
-        if self.is_trunk:
-            return "trunk"
+        if self.is_dev:
+            return "dev"
         else:
             return LooseVersion.__str__(self)
 
 
 def get_version(node=None):
     """Return the version attached to the given node.
-    Default to trunk if node or node.version is undefined (aka None)
+    Default to DEV_BRANCH if node or node.version is undefined (aka None)
     """
     if node is not None and hasattr(node, "version") and node.version is not None:
         return node.version
     else:
-        return TRUNK
+        return DEV_BRANCH
 
-TRUNK = KafkaVersion("trunk")
+DEV_BRANCH = KafkaVersion("dev")
 
 # 0.8.2.X versions
 V_0_8_2_1 = KafkaVersion("0.8.2.1")
diff --git a/tests/unit/directory_layout/check_project_paths.py b/tests/unit/directory_layout/check_project_paths.py
index 284e4d5150c41..b9b76f13276be 100644
--- a/tests/unit/directory_layout/check_project_paths.py
+++ b/tests/unit/directory_layout/check_project_paths.py
@@ -16,7 +16,7 @@
 
 from kafkatest.directory_layout.kafka_path import create_path_resolver, KafkaSystemTestPathResolver, \
     KAFKA_PATH_RESOLVER_KEY
-from kafkatest.version import V_0_9_0_1, TRUNK, KafkaVersion
+from kafkatest.version import V_0_9_0_1, DEV_BRANCH, KafkaVersion
 
 
 class DummyContext(object):
@@ -56,9 +56,9 @@ def check_paths(self):
         """Check expected path resolution without any version specified."""
         resolver = create_path_resolver(DummyContext())
 
-        assert resolver.home() == "/opt/kafka-trunk"
-        assert resolver.bin() == "/opt/kafka-trunk/bin"
-        assert resolver.script("kafka-run-class.sh") == "/opt/kafka-trunk/bin/kafka-run-class.sh"
+        assert resolver.home() == "/opt/kafka-dev"
+        assert resolver.bin() == "/opt/kafka-dev/bin"
+        assert resolver.script("kafka-run-class.sh") == "/opt/kafka-dev/bin/kafka-run-class.sh"
 
     def check_versioned_source_paths(self):
         """Check expected paths when using versions."""
@@ -74,16 +74,16 @@ def check_node_or_version_helper(self):
         """
         resolver = create_path_resolver(DummyContext())
 
-        # Node with no version attribute should resolve to TRUNK
+        # Node with no version attribute should resolve to DEV_BRANCH
         node = DummyNode()
-        assert resolver._version(node) == TRUNK
+        assert resolver._version(node) == DEV_BRANCH
 
         # Node with version attribute should resolve to the version attribute
         node.version = V_0_9_0_1
         assert resolver._version(node) == V_0_9_0_1
 
         # A KafkaVersion object should resolve to itself
-        assert resolver._version(TRUNK) == TRUNK
+        assert resolver._version(DEV_BRANCH) == DEV_BRANCH
         version = KafkaVersion("999.999.999")
         assert resolver._version(version) == version
 
diff --git a/tests/unit/version/check_version.py b/tests/unit/version/check_version.py
index 7b855518207da..8cf8e9a06e7b9 100644
--- a/tests/unit/version/check_version.py
+++ b/tests/unit/version/check_version.py
@@ -15,18 +15,18 @@
 
 from mock import Mock
 
-from kafkatest.version import TRUNK, V_0_8_2_2, get_version
+from kafkatest.version import DEV_BRANCH, V_0_8_2_2, get_version
 
 
 class CheckVersion(object):
     def check_get_version(self):
         """Check default and override behavior of get_version"""
         node = None
-        assert get_version(node) == TRUNK
+        assert get_version(node) == DEV_BRANCH
 
         node = Mock()
         node.version = None
-        assert get_version(node) == TRUNK
+        assert get_version(node) == DEV_BRANCH
 
         node = Mock()
         node.version = V_0_8_2_2
diff --git a/tools/src/main/java/org/apache/kafka/tools/VerifiableLog4jAppender.java b/tools/src/main/java/org/apache/kafka/tools/VerifiableLog4jAppender.java
index daf569cd77173..faa9698e5a48d 100644
--- a/tools/src/main/java/org/apache/kafka/tools/VerifiableLog4jAppender.java
+++ b/tools/src/main/java/org/apache/kafka/tools/VerifiableLog4jAppender.java
@@ -158,7 +158,7 @@ private static ArgumentParser argParser() {
      *
      * Note: this duplication of org.apache.kafka.common.utils.Utils.loadProps is unfortunate
      * but *intentional*. In order to use VerifiableProducer in compatibility and upgrade tests,
-     * we use VerifiableProducer from trunk tools package, and run it against 0.8.X.X kafka jars.
+     * we use VerifiableProducer from the development tools package, and run it against 0.8.X.X kafka jars.
      * Since this method is not in Utils in the 0.8.X.X jars, we have to cheat a bit and duplicate.
      */
     public static Properties loadProps(String filename) throws IOException, FileNotFoundException {
diff --git a/tools/src/main/java/org/apache/kafka/tools/VerifiableProducer.java b/tools/src/main/java/org/apache/kafka/tools/VerifiableProducer.java
index 54d53f10bea13..e81eb8f3ae01b 100644
--- a/tools/src/main/java/org/apache/kafka/tools/VerifiableProducer.java
+++ b/tools/src/main/java/org/apache/kafka/tools/VerifiableProducer.java
@@ -160,7 +160,7 @@ private static ArgumentParser argParser() {
      *                 
      * Note: this duplication of org.apache.kafka.common.utils.Utils.loadProps is unfortunate 
      * but *intentional*. In order to use VerifiableProducer in compatibility and upgrade tests, 
-     * we use VerifiableProducer from trunk tools package, and run it against 0.8.X.X kafka jars.
+     * we use VerifiableProducer from the development tools package, and run it against 0.8.X.X kafka jars.
      * Since this method is not in Utils in the 0.8.X.X jars, we have to cheat a bit and duplicate.
      */
     public static Properties loadProps(String filename) throws IOException, FileNotFoundException {
diff --git a/vagrant/base.sh b/vagrant/base.sh
index 5f07cc3658b36..448c640d2bfc9 100755
--- a/vagrant/base.sh
+++ b/vagrant/base.sh
@@ -37,11 +37,11 @@ if [ -z `which javac` ]; then
 fi
 
 chmod a+rw /opt
-if [ -h /opt/kafka-trunk ]; then
+if [ -h /opt/kafka-dev ]; then
     # reset symlink
-    rm /opt/kafka-trunk
+    rm /opt/kafka-dev
 fi
-ln -s /vagrant /opt/kafka-trunk
+ln -s /vagrant /opt/kafka-dev
 
 get_kafka() {
     version=$1
diff --git a/vagrant/broker.sh b/vagrant/broker.sh
index 06dee6b97abec..986f0fae43650 100755
--- a/vagrant/broker.sh
+++ b/vagrant/broker.sh
@@ -23,7 +23,7 @@ PUBLIC_ADDRESS=$2
 PUBLIC_ZOOKEEPER_ADDRESSES=$3
 JMX_PORT=$4
 
-kafka_dir=/opt/kafka-trunk
+kafka_dir=/opt/kafka-dev
 cd $kafka_dir
 
 sed \
diff --git a/vagrant/zk.sh b/vagrant/zk.sh
index 67924d129d98e..e8c690a060e32 100755
--- a/vagrant/zk.sh
+++ b/vagrant/zk.sh
@@ -22,7 +22,7 @@ ZKID=$1
 NUM_ZK=$2
 JMX_PORT=$3
 
-kafka_dir=/opt/kafka-trunk
+kafka_dir=/opt/kafka-dev
 cd $kafka_dir
 
 cp $kafka_dir/config/zookeeper.properties $kafka_dir/config/zookeeper-$ZKID.properties

From 1434b61d5d5511e5297d6ad81e2417db157986aa Mon Sep 17 00:00:00 2001
From: Balint Molnar <balintmolnar91@gmail.com>
Date: Fri, 27 Jan 2017 19:36:31 -0800
Subject: [PATCH 077/177] KAFKA-4679: Remove unstable markers from Connect APIs

ewencp ignore this PR if you are already started to work on this ticket.

Author: Balint Molnar <balintmolnar91@gmail.com>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2423 from baluchicken/KAFKA-4679
---
 .../java/org/apache/kafka/connect/connector/ConnectRecord.java | 2 --
 .../java/org/apache/kafka/connect/connector/Connector.java     | 2 --
 .../org/apache/kafka/connect/connector/ConnectorContext.java   | 3 ---
 .../src/main/java/org/apache/kafka/connect/connector/Task.java | 3 ---
 .../java/org/apache/kafka/connect/errors/ConnectException.java | 2 --
 .../main/java/org/apache/kafka/connect/sink/SinkConnector.java | 2 --
 .../main/java/org/apache/kafka/connect/sink/SinkRecord.java    | 2 --
 .../src/main/java/org/apache/kafka/connect/sink/SinkTask.java  | 2 --
 .../java/org/apache/kafka/connect/sink/SinkTaskContext.java    | 2 --
 .../java/org/apache/kafka/connect/source/SourceConnector.java  | 2 --
 .../java/org/apache/kafka/connect/source/SourceRecord.java     | 2 --
 .../main/java/org/apache/kafka/connect/source/SourceTask.java  | 2 --
 .../org/apache/kafka/connect/source/SourceTaskContext.java     | 2 --
 .../main/java/org/apache/kafka/connect/storage/Converter.java  | 2 --
 .../org/apache/kafka/connect/storage/OffsetStorageReader.java  | 3 ---
 .../java/org/apache/kafka/connect/util/ConnectorUtils.java     | 3 ---
 .../java/org/apache/kafka/connect/cli/ConnectDistributed.java  | 2 --
 .../java/org/apache/kafka/connect/cli/ConnectStandalone.java   | 2 --
 .../main/java/org/apache/kafka/connect/runtime/Connect.java    | 2 --
 .../java/org/apache/kafka/connect/runtime/WorkerConfig.java    | 2 --
 20 files changed, 44 deletions(-)

diff --git a/connect/api/src/main/java/org/apache/kafka/connect/connector/ConnectRecord.java b/connect/api/src/main/java/org/apache/kafka/connect/connector/ConnectRecord.java
index 6236f7e93682d..f3487c07017de 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/connector/ConnectRecord.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/connector/ConnectRecord.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.connect.connector;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.connect.data.Schema;
 
 /**
@@ -28,7 +27,6 @@
  * notion of offset, it is not included here because they differ in type.
  * </p>
  */
-@InterfaceStability.Unstable
 public abstract class ConnectRecord<R extends ConnectRecord<R>> {
     private final String topic;
     private final Integer kafkaPartition;
diff --git a/connect/api/src/main/java/org/apache/kafka/connect/connector/Connector.java b/connect/api/src/main/java/org/apache/kafka/connect/connector/Connector.java
index 137015603c59b..a46babd352660 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/connector/Connector.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/connector/Connector.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.connect.connector;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.common.config.Config;
 import org.apache.kafka.common.config.ConfigDef;
 import org.apache.kafka.common.config.ConfigValue;
@@ -42,7 +41,6 @@
  * Tasks.
  * </p>
  */
-@InterfaceStability.Unstable
 public abstract class Connector {
 
     protected ConnectorContext context;
diff --git a/connect/api/src/main/java/org/apache/kafka/connect/connector/ConnectorContext.java b/connect/api/src/main/java/org/apache/kafka/connect/connector/ConnectorContext.java
index c8a06e8e1a238..3b887c19e9704 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/connector/ConnectorContext.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/connector/ConnectorContext.java
@@ -17,12 +17,9 @@
 
 package org.apache.kafka.connect.connector;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
-
 /**
  * ConnectorContext allows Connectors to proactively interact with the Kafka Connect runtime.
  */
-@InterfaceStability.Unstable
 public interface ConnectorContext {
     /**
      * Requests that the runtime reconfigure the Tasks for this source. This should be used to
diff --git a/connect/api/src/main/java/org/apache/kafka/connect/connector/Task.java b/connect/api/src/main/java/org/apache/kafka/connect/connector/Task.java
index 850954daa3a49..261134d2b4951 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/connector/Task.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/connector/Task.java
@@ -17,8 +17,6 @@
 
 package org.apache.kafka.connect.connector;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
-
 import java.util.Map;
 
 /**
@@ -34,7 +32,6 @@
  * {@link org.apache.kafka.connect.sink.SinkTask}.
  * </p>
  */
-@InterfaceStability.Unstable
 public interface Task {
     /**
      * Get the version of this task. Usually this should be the same as the corresponding {@link Connector} class's version.
diff --git a/connect/api/src/main/java/org/apache/kafka/connect/errors/ConnectException.java b/connect/api/src/main/java/org/apache/kafka/connect/errors/ConnectException.java
index 1202be36aad47..bdddca03cbc96 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/errors/ConnectException.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/errors/ConnectException.java
@@ -18,12 +18,10 @@
 package org.apache.kafka.connect.errors;
 
 import org.apache.kafka.common.KafkaException;
-import org.apache.kafka.common.annotation.InterfaceStability;
 
 /**
  * ConnectException is the top-level exception type generated by Kafka Connect and connector implementations.
  */
-@InterfaceStability.Unstable
 public class ConnectException extends KafkaException {
 
     public ConnectException(String s) {
diff --git a/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkConnector.java b/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkConnector.java
index fbe6975f36f08..fd99c93b1ba6d 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkConnector.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkConnector.java
@@ -17,13 +17,11 @@
 
 package org.apache.kafka.connect.sink;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.connect.connector.Connector;
 
 /**
  * SinkConnectors implement the Connector interface to send Kafka data to another system.
  */
-@InterfaceStability.Unstable
 public abstract class SinkConnector extends Connector {
 
     /**
diff --git a/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkRecord.java b/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkRecord.java
index ad1b2d55e154d..894bf0d29d608 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkRecord.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkRecord.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.connect.sink;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.common.record.TimestampType;
 import org.apache.kafka.connect.connector.ConnectRecord;
 import org.apache.kafka.connect.data.Schema;
@@ -30,7 +29,6 @@
  * It also includes the {@link TimestampType}, which may be {@link TimestampType#NO_TIMESTAMP_TYPE}, and the relevant
  * timestamp, which may be {@code null}.
  */
-@InterfaceStability.Unstable
 public class SinkRecord extends ConnectRecord<SinkRecord> {
     private final long kafkaOffset;
     private final TimestampType timestampType;
diff --git a/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkTask.java b/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkTask.java
index 99a26832a86d1..0ea1ecf86b5c0 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkTask.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkTask.java
@@ -18,7 +18,6 @@
 
 import org.apache.kafka.clients.consumer.OffsetAndMetadata;
 import org.apache.kafka.common.TopicPartition;
-import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.connect.connector.Task;
 
 import java.util.Collection;
@@ -52,7 +51,6 @@
   * </ol>
  *
  */
-@InterfaceStability.Unstable
 public abstract class SinkTask implements Task {
 
     /**
diff --git a/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkTaskContext.java b/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkTaskContext.java
index 14f13d1179ac4..a9d2c05a7e39f 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkTaskContext.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/sink/SinkTaskContext.java
@@ -18,7 +18,6 @@
 package org.apache.kafka.connect.sink;
 
 import org.apache.kafka.common.TopicPartition;
-import org.apache.kafka.common.annotation.InterfaceStability;
 
 import java.util.Map;
 import java.util.Set;
@@ -26,7 +25,6 @@
 /**
  * Context passed to SinkTasks, allowing them to access utilities in the Kafka Connect runtime.
  */
-@InterfaceStability.Unstable
 public interface SinkTaskContext {
     /**
      * Reset the consumer offsets for the given topic partitions. SinkTasks should use this if they manage offsets
diff --git a/connect/api/src/main/java/org/apache/kafka/connect/source/SourceConnector.java b/connect/api/src/main/java/org/apache/kafka/connect/source/SourceConnector.java
index 2ba5139395348..b67245bcb77d5 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/source/SourceConnector.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/source/SourceConnector.java
@@ -16,14 +16,12 @@
  **/
 package org.apache.kafka.connect.source;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.connect.connector.Connector;
 
 /**
  * SourceConnectors implement the connector interface to pull data from another system and send
  * it to Kafka.
  */
-@InterfaceStability.Unstable
 public abstract class SourceConnector extends Connector {
 
 }
diff --git a/connect/api/src/main/java/org/apache/kafka/connect/source/SourceRecord.java b/connect/api/src/main/java/org/apache/kafka/connect/source/SourceRecord.java
index 444979a41dfbf..66d7e89307db9 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/source/SourceRecord.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/source/SourceRecord.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.connect.source;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.connect.connector.ConnectRecord;
 import org.apache.kafka.connect.data.Schema;
 
@@ -41,7 +40,6 @@
  * "table_name"} and the sourceOffset as a Long containing the timestamp of the row.
  * </p>
  */
-@InterfaceStability.Unstable
 public class SourceRecord extends ConnectRecord<SourceRecord> {
     private final Map<String, ?> sourcePartition;
     private final Map<String, ?> sourceOffset;
diff --git a/connect/api/src/main/java/org/apache/kafka/connect/source/SourceTask.java b/connect/api/src/main/java/org/apache/kafka/connect/source/SourceTask.java
index c08508553dcd9..9caca05191176 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/source/SourceTask.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/source/SourceTask.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.connect.source;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.connect.connector.Task;
 
 import java.util.List;
@@ -26,7 +25,6 @@
 /**
  * SourceTask is a Task that pulls records from another system for storage in Kafka.
  */
-@InterfaceStability.Unstable
 public abstract class SourceTask implements Task {
 
     protected SourceTaskContext context;
diff --git a/connect/api/src/main/java/org/apache/kafka/connect/source/SourceTaskContext.java b/connect/api/src/main/java/org/apache/kafka/connect/source/SourceTaskContext.java
index 200fa5ff04c1e..674f33c741dd4 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/source/SourceTaskContext.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/source/SourceTaskContext.java
@@ -16,14 +16,12 @@
  **/
 package org.apache.kafka.connect.source;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.connect.storage.OffsetStorageReader;
 
 /**
  * SourceTaskContext is provided to SourceTasks to allow them to interact with the underlying
  * runtime.
  */
-@InterfaceStability.Unstable
 public interface SourceTaskContext {
     /**
      * Get the OffsetStorageReader for this SourceTask.
diff --git a/connect/api/src/main/java/org/apache/kafka/connect/storage/Converter.java b/connect/api/src/main/java/org/apache/kafka/connect/storage/Converter.java
index c2fda2be32e79..763ce5ee09390 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/storage/Converter.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/storage/Converter.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.connect.storage;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.connect.data.Schema;
 import org.apache.kafka.connect.data.SchemaAndValue;
 
@@ -28,7 +27,6 @@
  * and byte[]. Internally, this likely includes an intermediate step to the format used by the serialization
  * layer (e.g. JsonNode, GenericRecord, Message).
  */
-@InterfaceStability.Unstable
 public interface Converter {
 
     /**
diff --git a/connect/api/src/main/java/org/apache/kafka/connect/storage/OffsetStorageReader.java b/connect/api/src/main/java/org/apache/kafka/connect/storage/OffsetStorageReader.java
index 9307c23b28bd2..10e099cab4a1b 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/storage/OffsetStorageReader.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/storage/OffsetStorageReader.java
@@ -17,8 +17,6 @@
 
 package org.apache.kafka.connect.storage;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
-
 import java.util.Collection;
 import java.util.Map;
 
@@ -33,7 +31,6 @@
  * {@link org.apache.kafka.connect.data.Schema} other than Array, Map, and Struct.
  * </p>
  */
-@InterfaceStability.Unstable
 public interface OffsetStorageReader {
     /**
      * Get the offset for the specified partition. If the data isn't already available locally, this
diff --git a/connect/api/src/main/java/org/apache/kafka/connect/util/ConnectorUtils.java b/connect/api/src/main/java/org/apache/kafka/connect/util/ConnectorUtils.java
index 35250eb0eefcb..6b3eb935e1c5b 100644
--- a/connect/api/src/main/java/org/apache/kafka/connect/util/ConnectorUtils.java
+++ b/connect/api/src/main/java/org/apache/kafka/connect/util/ConnectorUtils.java
@@ -17,8 +17,6 @@
 
 package org.apache.kafka.connect.util;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
-
 import java.util.ArrayList;
 import java.util.List;
 
@@ -26,7 +24,6 @@
  * Utilities that connector implementations might find useful. Contains common building blocks
  * for writing connectors.
  */
-@InterfaceStability.Unstable
 public class ConnectorUtils {
     /**
      * Given a list of elements and a target number of groups, generates list of groups of
diff --git a/connect/runtime/src/main/java/org/apache/kafka/connect/cli/ConnectDistributed.java b/connect/runtime/src/main/java/org/apache/kafka/connect/cli/ConnectDistributed.java
index fc957a73c35f8..778673bc8165b 100644
--- a/connect/runtime/src/main/java/org/apache/kafka/connect/cli/ConnectDistributed.java
+++ b/connect/runtime/src/main/java/org/apache/kafka/connect/cli/ConnectDistributed.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.connect.cli;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.common.utils.Time;
 import org.apache.kafka.common.utils.Utils;
 import org.apache.kafka.connect.runtime.Connect;
@@ -47,7 +46,6 @@
  * instances.
  * </p>
  */
-@InterfaceStability.Unstable
 public class ConnectDistributed {
     private static final Logger log = LoggerFactory.getLogger(ConnectDistributed.class);
 
diff --git a/connect/runtime/src/main/java/org/apache/kafka/connect/cli/ConnectStandalone.java b/connect/runtime/src/main/java/org/apache/kafka/connect/cli/ConnectStandalone.java
index c125a335e0f83..e3be1c5ebb1e7 100644
--- a/connect/runtime/src/main/java/org/apache/kafka/connect/cli/ConnectStandalone.java
+++ b/connect/runtime/src/main/java/org/apache/kafka/connect/cli/ConnectStandalone.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.connect.cli;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.common.utils.Time;
 import org.apache.kafka.common.utils.Utils;
 import org.apache.kafka.connect.runtime.Connect;
@@ -51,7 +50,6 @@
  * fault tolerant by overriding the settings to use file storage for both.
  * </p>
  */
-@InterfaceStability.Unstable
 public class ConnectStandalone {
     private static final Logger log = LoggerFactory.getLogger(ConnectStandalone.class);
 
diff --git a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/Connect.java b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/Connect.java
index 86f7f23f7a295..219baf0876e8f 100644
--- a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/Connect.java
+++ b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/Connect.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.connect.runtime;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.connect.runtime.rest.RestServer;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -29,7 +28,6 @@
  * This class ties together all the components of a Kafka Connect process (herder, worker,
  * storage, command interface), managing their lifecycle.
  */
-@InterfaceStability.Unstable
 public class Connect {
     private static final Logger log = LoggerFactory.getLogger(Connect.class);
 
diff --git a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/WorkerConfig.java b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/WorkerConfig.java
index fc3fe7182aa14..249d41a4ae5de 100644
--- a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/WorkerConfig.java
+++ b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/WorkerConfig.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.connect.runtime;
 
-import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.common.config.AbstractConfig;
 import org.apache.kafka.common.config.ConfigDef;
 import org.apache.kafka.common.config.ConfigDef.Importance;
@@ -28,7 +27,6 @@
 /**
  * Common base class providing configuration for Kafka Connect workers, whether standalone or distributed.
  */
-@InterfaceStability.Unstable
 public class WorkerConfig extends AbstractConfig {
 
     public static final String BOOTSTRAP_SERVERS_CONFIG = "bootstrap.servers";

From ba64b918af4c2363b0c6829d2a0f348096839255 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Sun, 29 Jan 2017 14:05:34 -0800
Subject: [PATCH 078/177] MINOR: JavaDoc markup cleanup

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2462 from mjsax/javaDocImprovements9

(cherry picked from commit 413444c0ec01ea51019df436cc1f2b664ac61e5a)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../apache/kafka/streams/KafkaStreams.java    |  21 +-
 .../kafka/streams/kstream/Aggregator.java     |   6 +-
 .../kafka/streams/kstream/ForeachAction.java  |   2 +-
 .../kafka/streams/kstream/GlobalKTable.java   |  18 +-
 .../kafka/streams/kstream/Initializer.java    |   4 +-
 .../kafka/streams/kstream/JoinWindows.java    |  10 +-
 .../kafka/streams/kstream/KGroupedStream.java |   4 +-
 .../kafka/streams/kstream/KGroupedTable.java  |   4 +-
 .../apache/kafka/streams/kstream/KStream.java | 274 +++++++++---------
 .../kafka/streams/kstream/KStreamBuilder.java |   2 +-
 .../apache/kafka/streams/kstream/KTable.java  | 250 ++++++++--------
 .../kafka/streams/kstream/KeyValueMapper.java |   4 +-
 .../kafka/streams/kstream/Predicate.java      |   2 +-
 .../apache/kafka/streams/kstream/Reducer.java |   4 +-
 .../kafka/streams/kstream/SessionWindows.java |   6 +-
 .../kafka/streams/kstream/TimeWindows.java    |   9 +-
 .../kafka/streams/kstream/Transformer.java    |   4 +-
 .../streams/kstream/TransformerSupplier.java  |   2 +-
 .../streams/kstream/UnlimitedWindows.java     |   4 +-
 .../kafka/streams/kstream/ValueJoiner.java    |   2 +-
 .../kafka/streams/kstream/ValueMapper.java    |   4 +-
 .../streams/kstream/ValueTransformer.java     |   6 +-
 .../kstream/ValueTransformerSupplier.java     |   2 +-
 .../apache/kafka/streams/kstream/Window.java  |   6 +-
 .../kafka/streams/kstream/Windowed.java       |   2 +-
 25 files changed, 324 insertions(+), 328 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java b/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
index ef0e72dd3a8ef..c57804e532510 100644
--- a/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
+++ b/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
@@ -92,7 +92,7 @@
  * If instances are added or fail, all (remaining) instances will rebalance the partition assignment among themselves
  * to balance processing load and ensure that all input topic partitions are processed.
  * <p>
- * Internally a {@link KafkaStreams} instance contains a normal {@link KafkaProducer} and {@link KafkaConsumer} instance
+ * Internally a {@code KafkaStreams} instance contains a normal {@link KafkaProducer} and {@link KafkaConsumer} instance
  * that is used for reading input and writing output.
  * <p>
  * A simple example might look like this:
@@ -187,7 +187,7 @@ public boolean isValidTransition(final State newState) {
             return validTransitions.contains(newState.ordinal());
         }
     }
-    private volatile State state = KafkaStreams.State.CREATED;
+    private volatile State state = State.CREATED;
     private StateListener stateListener = null;
 
 
@@ -412,9 +412,9 @@ private void checkBrokerVersionCompatibility() throws StreamsException {
     public synchronized void start() throws IllegalStateException, StreamsException {
         log.debug("Starting Kafka Stream process.");
 
-        if (state == KafkaStreams.State.CREATED) {
+        if (state == State.CREATED) {
             checkBrokerVersionCompatibility();
-            setState(KafkaStreams.State.RUNNING);
+            setState(State.RUNNING);
 
             if (globalStreamThread != null) {
                 globalStreamThread.start();
@@ -451,7 +451,7 @@ public void close() {
     public synchronized boolean close(final long timeout, final TimeUnit timeUnit) {
         log.debug("Stopping Kafka Stream process.");
         if (state.isCreatedOrRunning()) {
-            setState(KafkaStreams.State.PENDING_SHUTDOWN);
+            setState(State.PENDING_SHUTDOWN);
             // save the current thread so that if it is a stream thread
             // we don't attempt to join it and cause a deadlock
             final Thread shutdown = new Thread(new Runnable() {
@@ -495,7 +495,7 @@ public void run() {
             } catch (final InterruptedException e) {
                 Thread.interrupted();
             }
-            setState(KafkaStreams.State.NOT_RUNNING);
+            setState(State.NOT_RUNNING);
             return !shutdown.isAlive();
         }
         return true;
@@ -539,11 +539,10 @@ public String toString(final String indent) {
      * Do a clean up of the local {@link StateStore} directory ({@link StreamsConfig#STATE_DIR_CONFIG}) by deleting all
      * data with regard to the {@link StreamsConfig#APPLICATION_ID_CONFIG application ID}.
      * <p>
-     * May only be called either before this {@code KafkaStreams} instance is {@link KafkaStreams#start() started} or
-     * after the instance is {@link KafkaStreams#close() closed}.
+     * May only be called either before this {@code KafkaStreams} instance is {@link #start() started} or after the
+     * instance is {@link #close() closed}.
      * <p>
-     * Calling this method triggers a restore of local {@link StateStore}s on the next {@link KafkaStreams#start()
-     * application start}.
+     * Calling this method triggers a restore of local {@link StateStore}s on the next {@link #start() application start}.
      *
      * @throws IllegalStateException if the instance is currently running
      */
@@ -629,7 +628,7 @@ public Collection<StreamsMetadata> allMetadataForStore(final String storeName) {
      * {@link ProducerConfig#PARTITIONER_CLASS_CONFIG configured} via {@link StreamsConfig},
      * {@link KStream#through(StreamPartitioner, String)}, or {@link KTable#through(StreamPartitioner, String, String)},
      * or if the original {@link KTable}'s input {@link KStreamBuilder#table(String, String) topic} is partitioned
-     * differently, please use {@link KafkaStreams#metadataForKey(String, Object, StreamPartitioner)}.
+     * differently, please use {@link #metadataForKey(String, Object, StreamPartitioner)}.
      * <p>
      * Note:
      * <ul>
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Aggregator.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Aggregator.java
index e433ea7334558..786cfa2b727d1 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Aggregator.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Aggregator.java
@@ -20,12 +20,12 @@
 import org.apache.kafka.common.annotation.InterfaceStability;
 
 /**
- * The {@link Aggregator} interface for aggregating values of the given key.
+ * The {@code Aggregator} interface for aggregating values of the given key.
  * This is a generalization of {@link Reducer} and allows to have different types for input value and aggregation
  * result.
- * {@link Aggregator} is used in combination with {@link Initializer} that provides an initial aggregation value.
+ * {@code Aggregator} is used in combination with {@link Initializer} that provides an initial aggregation value.
  * <p>
- * {@link Aggregator} can be used to implement aggregation functions like count.
+ * {@code Aggregator} can be used to implement aggregation functions like count.
 
  * @param <K> key type
  * @param <V> input value type
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/ForeachAction.java b/streams/src/main/java/org/apache/kafka/streams/kstream/ForeachAction.java
index e68bf8dbe75e5..92fdf99434ab2 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/ForeachAction.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/ForeachAction.java
@@ -19,7 +19,7 @@
 import org.apache.kafka.common.annotation.InterfaceStability;
 
 /**
- * The {@link ForeachAction} interface for performing an action on a {@link org.apache.kafka.streams.KeyValue key-value
+ * The {@code ForeachAction} interface for performing an action on a {@link org.apache.kafka.streams.KeyValue key-value
  * pair}.
  * This is a stateless record-by-record operation, i.e, {@link #apply(Object, Object)} is invoked individually for each
  * record of a stream.
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/GlobalKTable.java b/streams/src/main/java/org/apache/kafka/streams/kstream/GlobalKTable.java
index 56f7bc8638ee5..fa1a5f29be5df 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/GlobalKTable.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/GlobalKTable.java
@@ -23,24 +23,24 @@
 import org.apache.kafka.streams.state.ReadOnlyKeyValueStore;
 
 /**
- * {@link GlobalKTable} is an abstraction of a <i>changelog stream</i> from a primary-keyed table.
+ * {@code GlobalKTable} is an abstraction of a <i>changelog stream</i> from a primary-keyed table.
  * Each record in this changelog stream is an update on the primary-keyed table with the record key as the primary key.
  * <p>
- * {@link GlobalKTable} can only be used as right-hand side input for {@link KStream stream}-table joins.
+ * {@code GlobalKTable} can only be used as right-hand side input for {@link KStream stream}-table joins.
  * <p>
- * In contrast to a {@link KTable} that is partitioned over all {@link KafkaStreams} instances, a {@link GlobalKTable}
+ * In contrast to a {@link KTable} that is partitioned over all {@link KafkaStreams} instances, a {@code GlobalKTable}
  * is fully replicated per {@link KafkaStreams} instance.
- * Every partition of the underlying topic is consumed by each {@link GlobalKTable}, such that the full set of data is
+ * Every partition of the underlying topic is consumed by each {@code GlobalKTable}, such that the full set of data is
  * available in every {@link KafkaStreams} instance.
  * This provides the ability to perform joins with {@link KStream} without having to repartition the input stream.
- * All joins with the {@link GlobalKTable} require that a {@link KeyValueMapper} is provided that can map from the
- * {@link KeyValue} of the left hand side {@link KStream} to the key of the right hand side {@link GlobalKTable}.
+ * All joins with the {@code GlobalKTable} require that a {@link KeyValueMapper} is provided that can map from the
+ * {@link KeyValue} of the left hand side {@link KStream} to the key of the right hand side {@code GlobalKTable}.
  * <p>
- * A {@link GlobalKTable} is created via a {@link KStreamBuilder}. For example:
+ * A {@code GlobalKTable} is created via a {@link KStreamBuilder}. For example:
  * <pre>{@code
  * builder.globalTable("topic-name", "queryable-store-name");
  * }</pre>
- * all {@link GlobalKTable}s are backed by a {@link ReadOnlyKeyValueStore} and are therefore queryable via the
+ * all {@code GlobalKTable}s are backed by a {@link ReadOnlyKeyValueStore} and are therefore queryable via the
  * interactive queries API.
  * For example:
  * <pre>{@code
@@ -53,7 +53,7 @@
  * ReadOnlyKeyValueStore view = streams.store("g1-store", QueryableStoreTypes.keyValueStore());
  * view.get(key); // can be done on any key, as all keys are present
  *}</pre>
- * Note that in contrast to {@link KTable} a {@link GlobalKTable}'s state holds a full copy if the underlying topic and
+ * Note that in contrast to {@link KTable} a {@code GlobalKTable}'s state holds a full copy if the underlying topic and
  * thus, all keys can be queried locally.
  *
  * @param <K> Type of primary keys
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Initializer.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Initializer.java
index 96a6995605f8f..bcd16b1321a1f 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Initializer.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Initializer.java
@@ -20,8 +20,8 @@
 import org.apache.kafka.common.annotation.InterfaceStability;
 
 /**
- * The {@link Initializer} interface for creating an initial value in aggregations.
- * {@link Initializer} is used in combination with {@link Aggregator}.
+ * The {@code Initializer} interface for creating an initial value in aggregations.
+ * {@code Initializer} is used in combination with {@link Aggregator}.
  *
  * @param <VA> aggregate value type
  * @see Aggregator
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java
index 720efb298f1df..3869721bdaf9d 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/JoinWindows.java
@@ -25,7 +25,7 @@
 /**
  * The window specifications used for joins.
  * <p>
- * A {@link JoinWindows} instance defines a maximum time difference for a {@link KStream#join(KStream, ValueJoiner,
+ * A {@code JoinWindows} instance defines a maximum time difference for a {@link KStream#join(KStream, ValueJoiner,
  * JoinWindows) join over two streams} on the same key.
  * In SQL-style you would express this join as
  * <pre>{@code
@@ -47,7 +47,7 @@
  * Both values (before and after) must not result in an "inverse" window, i.e., upper-interval bound cannot be smaller
  * than lower-interval bound.
  * <p>
- * {@link JoinWindows} are sliding windows, thus, they are aligned to the actual record timestamps.
+ * {@code JoinWindows} are sliding windows, thus, they are aligned to the actual record timestamps.
  * This implies, that each input record defines its own window with start and end time being relative to the record's
  * timestamp.
  * <p>
@@ -65,7 +65,7 @@
  * @see TimestampExtractor
  */
 @InterfaceStability.Unstable
-public class JoinWindows extends Windows<Window> {
+public final class JoinWindows extends Windows<Window> {
 
     /** Maximum time difference for tuples that are before the join tuple. */
     public final long beforeMs;
@@ -121,7 +121,7 @@ public JoinWindows after(final long timeDifferenceMs) throws IllegalArgumentExce
     }
 
     /**
-     * Not supported by {@link JoinWindows}.
+     * Not supported by {@code JoinWindows}.
      * Throws {@link UnsupportedOperationException}.
      *
      * @throws UnsupportedOperationException at every invocation
@@ -137,8 +137,6 @@ public long size() {
     }
 
     /**
-     * {@inheritDoc}
-     *
      * @param durationMs the window retention time in milliseconds
      * @return itself
      * @throws IllegalArgumentException if {@code durationMs} is smaller than the window size
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java
index f1f13381abb6c..d767f0be62087 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedStream.java
@@ -26,14 +26,14 @@
 import org.apache.kafka.streams.state.WindowStore;
 
 /**
- * {@link KGroupedStream} is an abstraction of a <i>grouped</i> record stream of {@link KeyValue} pairs.
+ * {@code KGroupedStream} is an abstraction of a <i>grouped</i> record stream of {@link KeyValue} pairs.
  * It is an intermediate representation of a {@link KStream} in order to apply an aggregation operation on the original
  * {@link KStream} records.
  * <p>
  * It is an intermediate representation after a grouping of a {@link KStream} before an aggregation is applied to the
  * new partitions resulting in a {@link KTable}.
  * <p>
- * A {@link KGroupedStream} must be obtained from a {@link KStream} via {@link KStream#groupByKey() groupByKey()} or
+ * A {@code KGroupedStream} must be obtained from a {@link KStream} via {@link KStream#groupByKey() groupByKey()} or
  * {@link KStream#groupBy(KeyValueMapper) groupBy(...)}.
  *
  * @param <K> Type of keys
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedTable.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedTable.java
index c736a8567a6eb..53c0a127fc409 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedTable.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KGroupedTable.java
@@ -26,13 +26,13 @@
 import org.apache.kafka.streams.state.QueryableStoreType;
 
 /**
- * {@link KGroupedTable} is an abstraction of a <i>re-grouped changelog stream</i> from a primary-keyed table,
+ * {@code KGroupedTable} is an abstraction of a <i>re-grouped changelog stream</i> from a primary-keyed table,
  * usually on a different grouping key than the original primary key.
  * <p>
  * It is an intermediate representation after a re-grouping of a {@link KTable} before an aggregation is applied to the
  * new partitions resulting in a new {@link KTable}.
  * <p>
- * A {@link KGroupedTable} must be obtained from a {@link KTable} via {@link KTable#groupBy(KeyValueMapper)
+ * A {@code KGroupedTable} must be obtained from a {@link KTable} via {@link KTable#groupBy(KeyValueMapper)
  * groupBy(...)}.
  *
  * @param <K> Type of keys
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
index 15eb05820c96d..21135fb23b442 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
@@ -31,16 +31,16 @@
 import org.apache.kafka.streams.processor.TopologyBuilder;
 
 /**
- * {@link KStream} is an abstraction of a <i>record stream</i> of {@link KeyValue} pairs, i.e., each record is an
+ * {@code KStream} is an abstraction of a <i>record stream</i> of {@link KeyValue} pairs, i.e., each record is an
  * independent entity/event in the real world.
  * For example a user X might buy two items I1 and I2, and thus there might be two records {@code <K:I1>, <K:I2>}
  * in the stream.
  * <p>
- * A {@link KStream} is either {@link KStreamBuilder#stream(String...) defined from one or multiple Kafka topics} that
- * are consumed message by message or the result of a {@link KStream} transformation.
- * A {@link KTable} can also be {@link KTable#toStream() converted} into a {@link KStream}.
+ * A {@code KStream} is either {@link KStreamBuilder#stream(String...) defined from one or multiple Kafka topics} that
+ * are consumed message by message or the result of a {@code KStream} transformation.
+ * A {@link KTable} can also be {@link KTable#toStream() converted} into a {@code KStream}.
  * <p>
- * A {@link KStream} can be transformed record by record, joined with another {@link KStream}, {@link KTable},
+ * A {@code KStream} can be transformed record by record, joined with another {@code KStream}, {@link KTable},
  * {@link GlobalKTable}, or can be aggregated into a {@link KTable}.
  * Kafka Streams DSL can be mixed-and-matched with Processor API (PAPI) (c.f. {@link TopologyBuilder}) via
  * {@link #process(ProcessorSupplier, String...) process(...)},
@@ -58,24 +58,24 @@
 public interface KStream<K, V> {
 
     /**
-     * Create a new {@link KStream} that consists of all records of this stream which satisfy the given predicate.
+     * Create a new {@code KStream} that consists of all records of this stream which satisfy the given predicate.
      * All records that do not satisfy the predicate are dropped.
      * This is a stateless record-by-record operation.
      *
      * @param predicate a filter {@link Predicate} that is applied to each record
-     * @return a {@link KStream} that contains only those records that satisfy the given predicate
+     * @return a {@code KStream} that contains only those records that satisfy the given predicate
      * @see #filterNot(Predicate)
      */
     KStream<K, V> filter(Predicate<? super K, ? super V> predicate);
 
     /**
-     * Create a new {@link KStream} that consists all records of this stream which do <em>not</em> satisfy the given
+     * Create a new {@code KStream} that consists all records of this stream which do <em>not</em> satisfy the given
      * predicate.
      * All records that <em>do</em> satisfy the predicate are dropped.
      * This is a stateless record-by-record operation.
      *
      * @param predicate a filter {@link Predicate} that is applied to each record
-     * @return a {@link KStream} that contains only those records that do <em>not</em> satisfy the given predicate
+     * @return a {@code KStream} that contains only those records that do <em>not</em> satisfy the given predicate
      * @see #filter(Predicate)
      */
     KStream<K, V> filterNot(Predicate<? super K, ? super V> predicate);
@@ -99,11 +99,11 @@ public interface KStream<K, V> {
      * }</pre>
      * <p>
      * Setting a new key might result in an internal data redistribution if a key based operator (like an aggregation or
-     * join) is applied to the result {@link KStream}.
+     * join) is applied to the result {@code KStream}.
      *
      * @param mapper a {@link KeyValueMapper} that computes a new key for each record
      * @param <KR>   the new key type of the result stream
-     * @return a {@link KStream} that contains records with new key (possibly of different type) and unmodified value
+     * @return a {@code KStream} that contains records with new key (possibly of different type) and unmodified value
      * @see #map(KeyValueMapper)
      * @see #flatMap(KeyValueMapper)
      * @see #mapValues(ValueMapper)
@@ -132,12 +132,12 @@ public interface KStream<K, V> {
      * The provided {@link KeyValueMapper} must return a {@link KeyValue} type and must not return {@code null}.
      * <p>
      * Mapping records might result in an internal data redistribution if a key based operator (like an aggregation or
-     * join) is applied to the result {@link KStream}. (cf. {@link #mapValues(ValueMapper)})
+     * join) is applied to the result {@code KStream}. (cf. {@link #mapValues(ValueMapper)})
      *
      * @param mapper a {@link KeyValueMapper} that computes a new output record
      * @param <KR>   the key type of the result stream
      * @param <VR>   the value type of the result stream
-     * @return a {@link KStream} that contains records with new key and value (possibly both of different type)
+     * @return a {@code KStream} that contains records with new key and value (possibly both of different type)
      * @see #selectKey(KeyValueMapper)
      * @see #flatMap(KeyValueMapper)
      * @see #mapValues(ValueMapper)
@@ -166,11 +166,11 @@ public interface KStream<K, V> {
      * <p>
      * Setting a new value preserves data co-location with respect to the key.
      * Thus, <em>no</em> internal data redistribution is required if a key based operator (like an aggregation or join)
-     * is applied to the result {@link KStream}. (cf. {@link #map(KeyValueMapper)})
+     * is applied to the result {@code KStream}. (cf. {@link #map(KeyValueMapper)})
      *
      * @param mapper a {@link ValueMapper} that computes a new output value
      * @param <VR>   the value type of the result stream
-     * @return a {@link KStream} that contains records with unmodified key and new values (possibly of different type)
+     * @return a {@code KStream} that contains records with unmodified key and new values (possibly of different type)
      * @see #selectKey(KeyValueMapper)
      * @see #map(KeyValueMapper)
      * @see #flatMap(KeyValueMapper)
@@ -210,12 +210,12 @@ public interface KStream<K, V> {
      * and the return value must not be {@code null}.
      * <p>
      * Flat-mapping records might result in an internal data redistribution if a key based operator (like an aggregation
-     * or join) is applied to the result {@link KStream}. (cf. {@link #flatMapValues(ValueMapper)})
+     * or join) is applied to the result {@code KStream}. (cf. {@link #flatMapValues(ValueMapper)})
      *
      * @param mapper a {@link KeyValueMapper} that computes the new output records
      * @param <KR>   the key type of the result stream
      * @param <VR>   the value type of the result stream
-     * @return a {@link KStream} that contains more or less records with new key and value (possibly of different type)
+     * @return a {@code KStream} that contains more or less records with new key and value (possibly of different type)
      * @see #selectKey(KeyValueMapper)
      * @see #map(KeyValueMapper)
      * @see #mapValues(ValueMapper)
@@ -226,7 +226,7 @@ public interface KStream<K, V> {
     <KR, VR> KStream<KR, VR> flatMap(final KeyValueMapper<? super K, ? super V, ? extends Iterable<? extends KeyValue<? extends KR, ? extends VR>>> mapper);
 
     /**
-     * Create a new {@link KStream} by transforming the value of each record in this stream into zero or more values
+     * Create a new {@code KStream} by transforming the value of each record in this stream into zero or more values
      * with the same key in the new stream.
      * Transform the value of each input record into zero or more records with the same (unmodified) key in the output
      * stream (value type can be altered arbitrarily).
@@ -250,11 +250,11 @@ public interface KStream<K, V> {
      * <p>
      * Splitting a record into multiple records with the same key preserves data co-location with respect to the key.
      * Thus, <em>no</em> internal data redistribution is required if a key based operator (like an aggregation or join)
-     * is applied to the result {@link KStream}. (cf. {@link #flatMap(KeyValueMapper)})
+     * is applied to the result {@code KStream}. (cf. {@link #flatMap(KeyValueMapper)})
      *
      * @param processor a {@link ValueMapper} the computes the new output values
      * @param <VR>      the value type of the result stream
-     * @return a {@link KStream} that contains more or less records with unmodified keys and new values of different type
+     * @return a {@code KStream} that contains more or less records with unmodified keys and new values of different type
      * @see #selectKey(KeyValueMapper)
      * @see #map(KeyValueMapper)
      * @see #flatMap(KeyValueMapper)
@@ -396,7 +396,7 @@ void writeAsText(final String filePath,
                      final Serde<V> valSerde);
 
     /**
-     * Perform an action on each record of {@link KStream}.
+     * Perform an action on each record of {@code KStream}.
      * This is a stateless record-by-record operation (cf. {@link #process(ProcessorSupplier, String...)}).
      * Note that this is a terminal operation that returns void.
      *
@@ -406,7 +406,7 @@ void writeAsText(final String filePath,
     void foreach(final ForeachAction<? super K, ? super V> action);
 
     /**
-     * Creates an array of {@link KStream} from this stream by branching the records in the original stream based on
+     * Creates an array of {@code KStream} from this stream by branching the records in the original stream based on
      * the supplied predicates.
      * Each record is evaluated against the supplied predicates, and predicates are evaluated in order.
      * Each stream in the result array corresponds position-wise (index) to the predicate in the supplied predicates.
@@ -416,13 +416,13 @@ void writeAsText(final String filePath,
      * This is a stateless record-by-record operation.
      *
      * @param predicates the ordered list of {@link Predicate} instances
-     * @return multiple distinct substreams of this {@link KStream}
+     * @return multiple distinct substreams of this {@code KStream}
      */
     @SuppressWarnings("unchecked")
     KStream<K, V>[] branch(final Predicate<? super K, ? super V>... predicates);
 
     /**
-     * Materialize this stream to a topic and creates a new {@link KStream} from the topic using default serializers and
+     * Materialize this stream to a topic and creates a new {@code KStream} from the topic using default serializers and
      * deserializers and producer's {@link DefaultPartitioner}.
      * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
      * started).
@@ -431,12 +431,12 @@ void writeAsText(final String filePath,
      * KStreamBuilder#stream(someTopicName)}.
      *
      * @param topic the topic name
-     * @return a {@link KStream} that contains the exact same (and potentially repartitioned) records as this {@link KStream}
+     * @return a {@code KStream} that contains the exact same (and potentially repartitioned) records as this {@code KStream}
      */
     KStream<K, V> through(final String topic);
 
     /**
-     * Materialize this stream to a topic and creates a new {@link KStream} from the topic using default serializers and
+     * Materialize this stream to a topic and creates a new {@code KStream} from the topic using default serializers and
      * deserializers and a customizable {@link StreamPartitioner} to determine the distribution of records to partitions.
      * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
      * started).
@@ -447,13 +447,13 @@ void writeAsText(final String filePath,
      * @param partitioner the function used to determine how records are distributed among partitions of the topic,
      *                    if not specified producer's {@link DefaultPartitioner} will be used
      * @param topic       the topic name
-     * @return a {@link KStream} that contains the exact same (and potentially repartitioned) records as this {@link KStream}
+     * @return a {@code KStream} that contains the exact same (and potentially repartitioned) records as this {@code KStream}
      */
     KStream<K, V> through(final StreamPartitioner<? super K, ? super V> partitioner,
                           final String topic);
 
     /**
-     * Materialize this stream to a topic, and creates a new {@link KStream} from the topic.
+     * Materialize this stream to a topic, and creates a new {@code KStream} from the topic.
      * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
      * started).
      * <p>
@@ -468,14 +468,14 @@ KStream<K, V> through(final StreamPartitioner<? super K, ? super V> partitioner,
      * @param valSerde value serde used to send key-value pairs,
      *                 if not specified the default value serde defined in the configuration will be used
      * @param topic    the topic name
-     * @return a {@link KStream} that contains the exact same (and potentially repartitioned) records as this {@link KStream}
+     * @return a {@code KStream} that contains the exact same (and potentially repartitioned) records as this {@code KStream}
      */
     KStream<K, V> through(final Serde<K> keySerde,
                           final Serde<V> valSerde,
                           final String topic);
 
     /**
-     * Materialize this stream to a topic and creates a new {@link KStream} from the topic using a customizable
+     * Materialize this stream to a topic and creates a new {@code KStream} from the topic using a customizable
      * {@link StreamPartitioner} to determine the distribution of records to partitions.
      * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
      * started).
@@ -493,7 +493,7 @@ KStream<K, V> through(final Serde<K> keySerde,
      *                    {@link WindowedStreamPartitioner} will be used&mdash;otherwise {@link DefaultPartitioner} will
      *                    be used
      * @param topic       the topic name
-     * @return a {@link KStream} that contains the exact same (and potentially repartitioned) records as this {@link KStream}
+     * @return a {@code KStream} that contains the exact same (and potentially repartitioned) records as this {@code KStream}
      */
     KStream<K, V> through(final Serde<K> keySerde,
                           final Serde<V> valSerde,
@@ -626,14 +626,14 @@ void to(final Serde<K> keySerde,
      * }</pre>
      * <p>
      * Transforming records might result in an internal data redistribution if a key based operator (like an aggregation
-     * or join) is applied to the result {@link KStream}.
+     * or join) is applied to the result {@code KStream}.
      * (cf. {@link #transformValues(ValueTransformerSupplier, String...)})
      *
      * @param transformerSupplier a instance of {@link TransformerSupplier} that generates a {@link Transformer}
      * @param stateStoreNames     the names of the state stores used by the processor
      * @param <K1>                the key type of the new stream
      * @param <V1>                the value type of the new stream
-     * @return a {@link KStream} that contains more or less records with new key and value (possibly of different type)
+     * @return a {@code KStream} that contains more or less records with new key and value (possibly of different type)
      * @see #flatMap(KeyValueMapper)
      * @see #transformValues(ValueTransformerSupplier, String...)
      * @see #process(ProcessorSupplier, String...)
@@ -703,13 +703,13 @@ <K1, V1> KStream<K1, V1> transform(final TransformerSupplier<? super K, ? super
      * <p>
      * Setting a new value preserves data co-location with respect to the key.
      * Thus, <em>no</em> internal data redistribution is required if a key based operator (like an aggregation or join)
-     * is applied to the result {@link KStream}. (cf. {@link #transform(TransformerSupplier, String...)})
+     * is applied to the result {@code KStream}. (cf. {@link #transform(TransformerSupplier, String...)})
      *
      * @param valueTransformerSupplier a instance of {@link ValueTransformerSupplier} that generates a
      *                                 {@link ValueTransformer}
      * @param stateStoreNames          the names of the state stores used by the processor
      * @param <VR>                     the value type of the result stream
-     * @return a {@link KStream} that contains records with unmodified key and new values (possibly of different type)
+     * @return a {@code KStream} that contains records with unmodified key and new values (possibly of different type)
      * @see #mapValues(ValueMapper)
      * @see #transform(TransformerSupplier, String...)
      */
@@ -800,7 +800,7 @@ void process(final ProcessorSupplier<? super K, ? super V> processorSupplier,
      * If the last key changing operator changed the key type, it is recommended to use
      * {@link #groupByKey(Serde, Serde)} instead.
      *
-     * @return a {@link KGroupedStream} that contains the grouped records of the original {@link KStream}
+     * @return a {@link KGroupedStream} that contains the grouped records of the original {@code KStream}
      * @see #groupBy(KeyValueMapper)
      */
     KGroupedStream<K, V> groupByKey();
@@ -828,13 +828,13 @@ void process(final ProcessorSupplier<? super K, ? super V> processorSupplier,
      *                 if not specified the default serdes defined in the configs will be used
      * @param valSerde value serdes for materializing this stream,
      *                 if not specified the default serdes defined in the configs will be used
-     * @return a {@link KGroupedStream} that contains the grouped records of the original {@link KStream}
+     * @return a {@link KGroupedStream} that contains the grouped records of the original {@code KStream}
      */
     KGroupedStream<K, V> groupByKey(final Serde<K> keySerde,
                                     final Serde<V> valSerde);
 
     /**
-     * Group the records of this {@link KStream} on a new key that is selected using the provided {@link KeyValueMapper}
+     * Group the records of this {@code KStream} on a new key that is selected using the provided {@link KeyValueMapper}
      * and default serializers and deserializers.
      * Grouping a stream on the record key is required before an aggregation operator can be applied to the data
      * (cf. {@link KGroupedStream}).
@@ -855,12 +855,12 @@ KGroupedStream<K, V> groupByKey(final Serde<K> keySerde,
      *
      * @param selector a {@link KeyValueMapper} that computes a new key for grouping
      * @param <KR>     the key type of the result {@link KGroupedStream}
-     * @return a {@link KGroupedStream} that contains the grouped records of the original {@link KStream}
+     * @return a {@link KGroupedStream} that contains the grouped records of the original {@code KStream}
      */
     <KR> KGroupedStream<KR, V> groupBy(final KeyValueMapper<? super K, ? super V, KR> selector);
 
     /**
-     * Group the records of this {@link KStream} on a new key that is selected using the provided {@link KeyValueMapper}.
+     * Group the records of this {@code KStream} on a new key that is selected using the provided {@link KeyValueMapper}.
      * Grouping a stream on the record key is required before an aggregation operator can be applied to the data
      * (cf. {@link KGroupedStream}).
      * The {@link KeyValueMapper} selects a new key (with potentially different type) while preserving the original values.
@@ -884,7 +884,7 @@ KGroupedStream<K, V> groupByKey(final Serde<K> keySerde,
      * @param valSerde value serdes for materializing this stream,
      *                 if not specified the default serdes defined in the configs will be used
      * @param <KR>     the key type of the result {@link KGroupedStream}
-     * @return a {@link KGroupedStream} that contains the grouped records of the original {@link KStream}
+     * @return a {@link KGroupedStream} that contains the grouped records of the original {@code KStream}
      * @see #groupByKey()
      */
     <KR> KGroupedStream<KR, V> groupBy(final KeyValueMapper<? super K, ? super V, KR> selector,
@@ -892,7 +892,7 @@ <KR> KGroupedStream<KR, V> groupBy(final KeyValueMapper<? super K, ? super V, KR
                                        final Serde<V> valSerde);
 
     /**
-     * Join records of this stream with another {@link KStream}'s records using windowed inner equi join with default
+     * Join records of this stream with another {@code KStream}'s records using windowed inner equi join with default
      * serializers and deserializers.
      * The join is computed on the records' key with join attribute {@code thisKStream.key == otherKStream.key}.
      * Furthermore, two records are only joined if their timestamps are close to each other as defined by the given
@@ -902,7 +902,7 @@ <KR> KGroupedStream<KR, V> groupBy(final KeyValueMapper<? super K, ? super V, KR
      * a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
      * If an input record key or value is {@code null} the record will not be included in the join operation and thus no
-     * output record will be added to the resulting {@link KStream}.
+     * output record will be added to the resulting {@code KStream}.
      * <p>
      * Example (assuming all input records belong to the correct windows):
      * <table border='1'>
@@ -936,12 +936,12 @@ <KR> KGroupedStream<KR, V> groupBy(final KeyValueMapper<? super K, ? super V, KR
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen for one or both of the joining {@link KStream}s.
+     * Repartitioning can happen for one or both of the joining {@code KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * records to it, and rereading all records from it, such that the join input {@code KStream} is partitioned
      * correctly on its key.
      * <p>
-     * Both of the joining {@link KStream}s will be materialized in local state stores with auto-generated store names.
+     * Both of the joining {@code KStream}s will be materialized in local state stores with auto-generated store names.
      * For failure and recovery each store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-storeName-changelog", where "applicationId" is user-specified
      * in {@link StreamsConfig} via parameter
@@ -949,12 +949,12 @@ <KR> KGroupedStream<KR, V> groupBy(final KeyValueMapper<? super K, ? super V, KR
      * internally generated name, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
-     * @param otherStream the {@link KStream} to be joined with this stream
+     * @param otherStream the {@code KStream} to be joined with this stream
      * @param joiner      a {@link ValueJoiner} that computes the join result for a pair of matching records
      * @param windows     the specification of the {@link JoinWindows}
      * @param <VO>        the value type of the other stream
      * @param <VR>        the value type of the result stream
-     * @return a {@link KStream} that contains join-records for each key and values computed by the given
+     * @return a {@code KStream} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one for each matched record-pair with the same key and within the joining window intervals
      * @see #leftJoin(KStream, ValueJoiner, JoinWindows)
      * @see #outerJoin(KStream, ValueJoiner, JoinWindows)
@@ -964,7 +964,7 @@ <VO, VR> KStream<K, VR> join(final KStream<K, VO> otherStream,
                                  final JoinWindows windows);
 
     /**
-     * Join records of this stream with another {@link KStream}'s records using windowed inner equi join.
+     * Join records of this stream with another {@code KStream}'s records using windowed inner equi join.
      * The join is computed on the records' key with join attribute {@code thisKStream.key == otherKStream.key}.
      * Furthermore, two records are only joined if their timestamps are close to each other as defined by the given
      * {@link JoinWindows}, i.e., the window defines an additional join predicate on the record timestamps.
@@ -973,7 +973,7 @@ <VO, VR> KStream<K, VR> join(final KStream<K, VO> otherStream,
      * a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
      * If an input record key or value is {@code null} the record will not be included in the join operation and thus no
-     * output record will be added to the resulting {@link KStream}.
+     * output record will be added to the resulting {@code KStream}.
      * <p>
      * Example (assuming all input records belong to the correct windows):
      * <table border='1'>
@@ -1007,19 +1007,19 @@ <VO, VR> KStream<K, VR> join(final KStream<K, VO> otherStream,
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen for one or both of the joining {@link KStream}s.
+     * Repartitioning can happen for one or both of the joining {@code KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * records to it, and rereading all records from it, such that the join input {@code KStream} is partitioned
      * correctly on its key.
      * <p>
-     * Both of the joining {@link KStream}s will be materialized in local state stores with auto-generated store names.
+     * Both of the joining {@code KStream}s will be materialized in local state stores with auto-generated store names.
      * For failure and recovery each store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-storeName-changelog", where "applicationId" is user-specified
      * in {@link StreamsConfig} via parameter {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG},
      * "storeName" is an internally generated name, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
-     * @param otherStream     the {@link KStream} to be joined with this stream
+     * @param otherStream     the {@code KStream} to be joined with this stream
      * @param joiner          a {@link ValueJoiner} that computes the join result for a pair of matching records
      * @param windows         the specification of the {@link JoinWindows}
      * @param keySerde        key serdes for materializing both streams,
@@ -1030,7 +1030,7 @@ <VO, VR> KStream<K, VR> join(final KStream<K, VO> otherStream,
      *                        if not specified the default serdes defined in the configs will be used
      * @param <VO>            the value type of the other stream
      * @param <VR>            the value type of the result stream
-     * @return a {@link KStream} that contains join-records for each key and values computed by the given
+     * @return a {@code KStream} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one for each matched record-pair with the same key and within the joining window intervals
      * @see #leftJoin(KStream, ValueJoiner, JoinWindows, Serde, Serde, Serde)
      * @see #outerJoin(KStream, ValueJoiner, JoinWindows, Serde, Serde, Serde)
@@ -1043,7 +1043,7 @@ <VO, VR> KStream<K, VR> join(final KStream<K, VO> otherStream,
                                  final Serde<VO> otherValueSerde);
 
     /**
-     * Join records of this stream with another {@link KStream}'s records using windowed left equi join with default
+     * Join records of this stream with another {@code KStream}'s records using windowed left equi join with default
      * serializers and deserializers.
      * In contrast to {@link #join(KStream, ValueJoiner, JoinWindows) inner-join}, all records from this stream will
      * produce at least one output record (cf. below).
@@ -1054,10 +1054,10 @@ <VO, VR> KStream<K, VR> join(final KStream<K, VO> otherStream,
      * For each pair of records meeting both join predicates the provided {@link ValueJoiner} will be called to compute
      * a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
-     * Furthermore, for each input record of this {@link KStream} that does not satisfy the join predicate the provided
+     * Furthermore, for each input record of this {@code KStream} that does not satisfy the join predicate the provided
      * {@link ValueJoiner} will be called with a {@code null} value for the other stream.
      * If an input record key or value is {@code null} the record will not be included in the join operation and thus no
-     * output record will be added to the resulting {@link KStream}.
+     * output record will be added to the resulting {@code KStream}.
      * <p>
      * Example (assuming all input records belong to the correct windows):
      * <table border='1'>
@@ -1091,26 +1091,26 @@ <VO, VR> KStream<K, VR> join(final KStream<K, VO> otherStream,
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen for one or both of the joining {@link KStream}s.
+     * Repartitioning can happen for one or both of the joining {@code KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * records to it, and rereading all records from it, such that the join input {@code KStream} is partitioned
      * correctly on its key.
      * <p>
-     * Both of the joining {@link KStream}s will be materialized in local state stores with auto-generated store names.
+     * Both of the joining {@code KStream}s will be materialized in local state stores with auto-generated store names.
      * For failure and recovery each store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-storeName-changelog", where "applicationId" is user-specified
      * in {@link StreamsConfig} via parameter {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG},
      * "storeName" is an internally generated name, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
-     * @param otherStream the {@link KStream} to be joined with this stream
+     * @param otherStream the {@code KStream} to be joined with this stream
      * @param joiner      a {@link ValueJoiner} that computes the join result for a pair of matching records
      * @param windows     the specification of the {@link JoinWindows}
      * @param <VO>        the value type of the other stream
      * @param <VR>        the value type of the result stream
-     * @return a {@link KStream} that contains join-records for each key and values computed by the given
+     * @return a {@code KStream} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one for each matched record-pair with the same key plus one for each non-matching record of
-     * this {@link KStream} and within the joining window intervals
+     * this {@code KStream} and within the joining window intervals
      * @see #join(KStream, ValueJoiner, JoinWindows)
      * @see #outerJoin(KStream, ValueJoiner, JoinWindows)
      */
@@ -1119,7 +1119,7 @@ <VO, VR> KStream<K, VR> leftJoin(final KStream<K, VO> otherStream,
                                      final JoinWindows windows);
 
     /**
-     * Join records of this stream with another {@link KStream}'s records using windowed left equi join.
+     * Join records of this stream with another {@code KStream}'s records using windowed left equi join.
      * In contrast to {@link #join(KStream, ValueJoiner, JoinWindows, Serde, Serde, Serde) inner-join}, all records from
      * this stream will produce at least one output record (cf. below).
      * The join is computed on the records' key with join attribute {@code thisKStream.key == otherKStream.key}.
@@ -1129,10 +1129,10 @@ <VO, VR> KStream<K, VR> leftJoin(final KStream<K, VO> otherStream,
      * For each pair of records meeting both join predicates the provided {@link ValueJoiner} will be called to compute
      * a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
-     * Furthermore, for each input record of this {@link KStream} that does not satisfy the join predicate the provided
+     * Furthermore, for each input record of this {@code KStream} that does not satisfy the join predicate the provided
      * {@link ValueJoiner} will be called with a {@code null} value for the other stream.
      * If an input record key or value is {@code null} the record will not be included in the join operation and thus no
-     * output record will be added to the resulting {@link KStream}.
+     * output record will be added to the resulting {@code KStream}.
      * <p>
      * Example (assuming all input records belong to the correct windows):
      * <table border='1'>
@@ -1166,12 +1166,12 @@ <VO, VR> KStream<K, VR> leftJoin(final KStream<K, VO> otherStream,
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen for one or both of the joining {@link KStream}s.
+     * Repartitioning can happen for one or both of the joining {@code KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * records to it, and rereading all records from it, such that the join input {@code KStream} is partitioned
      * correctly on its key.
      * <p>
-     * Both of the joining {@link KStream}s will be materialized in local state stores with auto-generated store names.
+     * Both of the joining {@code KStream}s will be materialized in local state stores with auto-generated store names.
      * For failure and recovery each store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-storeName-changelog", where "applicationId" is user-specified
      * in {@link StreamsConfig} via parameter
@@ -1179,7 +1179,7 @@ <VO, VR> KStream<K, VR> leftJoin(final KStream<K, VO> otherStream,
      * internally generated name, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
-     * @param otherStream     the {@link KStream} to be joined with this stream
+     * @param otherStream     the {@code KStream} to be joined with this stream
      * @param joiner          a {@link ValueJoiner} that computes the join result for a pair of matching records
      * @param windows         the specification of the {@link JoinWindows}
      * @param keySerde        key serdes for materializing the other stream,
@@ -1190,9 +1190,9 @@ <VO, VR> KStream<K, VR> leftJoin(final KStream<K, VO> otherStream,
      *                        if not specified the default serdes defined in the configs will be used
      * @param <VO>            the value type of the other stream
      * @param <VR>            the value type of the result stream
-     * @return a {@link KStream} that contains join-records for each key and values computed by the given
+     * @return a {@code KStream} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one for each matched record-pair with the same key plus one for each non-matching record of
-     * this {@link KStream} and within the joining window intervals
+     * this {@code KStream} and within the joining window intervals
      * @see #join(KStream, ValueJoiner, JoinWindows, Serde, Serde, Serde)
      * @see #outerJoin(KStream, ValueJoiner, JoinWindows, Serde, Serde, Serde)
      */
@@ -1204,7 +1204,7 @@ <VO, VR> KStream<K, VR> leftJoin(final KStream<K, VO> otherStream,
                                      final Serde<VO> otherValueSerde);
 
     /**
-     * Join records of this stream with another {@link KStream}'s records using windowed left equi join with default
+     * Join records of this stream with another {@code KStream}'s records using windowed left equi join with default
      * serializers and deserializers.
      * In contrast to {@link #join(KStream, ValueJoiner, JoinWindows) inner-join} or
      * {@link #leftJoin(KStream, ValueJoiner, JoinWindows) left-join}, all records from both streams will produce at
@@ -1216,10 +1216,10 @@ <VO, VR> KStream<K, VR> leftJoin(final KStream<K, VO> otherStream,
      * For each pair of records meeting both join predicates the provided {@link ValueJoiner} will be called to compute
      * a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
-     * Furthermore, for each input record of both {@link KStream}s that does not satisfy the join predicate the provided
+     * Furthermore, for each input record of both {@code KStream}s that does not satisfy the join predicate the provided
      * {@link ValueJoiner} will be called with a {@code null} value for the this/other stream, respectively.
      * If an input record key or value is {@code null} the record will not be included in the join operation and thus no
-     * output record will be added to the resulting {@link KStream}.
+     * output record will be added to the resulting {@code KStream}.
      * <p>
      * Example (assuming all input records belong to the correct windows):
      * <table border='1'>
@@ -1253,26 +1253,26 @@ <VO, VR> KStream<K, VR> leftJoin(final KStream<K, VO> otherStream,
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen for one or both of the joining {@link KStream}s.
+     * Repartitioning can happen for one or both of the joining {@code KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * records to it, and rereading all records from it, such that the join input {@code KStream} is partitioned
      * correctly on its key.
      * <p>
-     * Both of the joining {@link KStream}s will be materialized in local state stores with auto-generated store names.
+     * Both of the joining {@code KStream}s will be materialized in local state stores with auto-generated store names.
      * For failure and recovery each store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-storeName-changelog", where "applicationId" is user-specified
      * in {@link StreamsConfig} via parameter {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG},
      * "storeName" is an internally generated name, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
-     * @param otherStream the {@link KStream} to be joined with this stream
+     * @param otherStream the {@code KStream} to be joined with this stream
      * @param joiner      a {@link ValueJoiner} that computes the join result for a pair of matching records
      * @param windows     the specification of the {@link JoinWindows}
      * @param <VO>        the value type of the other stream
      * @param <VR>        the value type of the result stream
-     * @return a {@link KStream} that contains join-records for each key and values computed by the given
+     * @return a {@code KStream} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one for each matched record-pair with the same key plus one for each non-matching record of
-     * both {@link KStream} and within the joining window intervals
+     * both {@code KStream} and within the joining window intervals
      * @see #join(KStream, ValueJoiner, JoinWindows)
      * @see #leftJoin(KStream, ValueJoiner, JoinWindows)
      */
@@ -1281,7 +1281,7 @@ <VO, VR> KStream<K, VR> outerJoin(final KStream<K, VO> otherStream,
                                       final JoinWindows windows);
 
     /**
-     * Join records of this stream with another {@link KStream}'s records using windowed left equi join.
+     * Join records of this stream with another {@code KStream}'s records using windowed left equi join.
      * In contrast to {@link #join(KStream, ValueJoiner, JoinWindows, Serde, Serde, Serde) inner-join} or
      * {@link #leftJoin(KStream, ValueJoiner, JoinWindows, Serde, Serde, Serde) left-join}, all records from both
      * streams will produce at least one output record (cf. below).
@@ -1292,10 +1292,10 @@ <VO, VR> KStream<K, VR> outerJoin(final KStream<K, VO> otherStream,
      * For each pair of records meeting both join predicates the provided {@link ValueJoiner} will be called to compute
      * a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
-     * Furthermore, for each input record of both {@link KStream}s that does not satisfy the join predicate the provided
+     * Furthermore, for each input record of both {@code KStream}s that does not satisfy the join predicate the provided
      * {@link ValueJoiner} will be called with a {@code null} value for this/other stream, respectively.
      * If an input record key or value is {@code null} the record will not be included in the join operation and thus no
-     * output record will be added to the resulting {@link KStream}.
+     * output record will be added to the resulting {@code KStream}.
      * <p>
      * Example (assuming all input records belong to the correct windows):
      * <table border='1'>
@@ -1329,19 +1329,19 @@ <VO, VR> KStream<K, VR> outerJoin(final KStream<K, VO> otherStream,
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen for one or both of the joining {@link KStream}s.
+     * Repartitioning can happen for one or both of the joining {@code KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * records to it, and rereading all records from it, such that the join input {@code KStream} is partitioned
      * correctly on its key.
      * <p>
-     * Both of the joining {@link KStream}s will be materialized in local state stores with auto-generated store names.
+     * Both of the joining {@code KStream}s will be materialized in local state stores with auto-generated store names.
      * For failure and recovery each store will be backed by an internal changelog topic that will be created in Kafka.
      * The changelog topic will be named "${applicationId}-storeName-changelog", where "applicationId" is user-specified
      * in {@link StreamsConfig} via parameter {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG},
      * "storeName" is an internally generated name, and "-changelog" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      *
-     * @param otherStream     the {@link KStream} to be joined with this stream
+     * @param otherStream     the {@code KStream} to be joined with this stream
      * @param joiner          a {@link ValueJoiner} that computes the join result for a pair of matching records
      * @param windows         the specification of the {@link JoinWindows}
      * @param keySerde        key serdes for materializing both streams,
@@ -1352,9 +1352,9 @@ <VO, VR> KStream<K, VR> outerJoin(final KStream<K, VO> otherStream,
      *                        if not specified the default serdes defined in the configs will be used
      * @param <VO>            the value type of the other stream
      * @param <VR>            the value type of the result stream
-     * @return a {@link KStream} that contains join-records for each key and values computed by the given
+     * @return a {@code KStream} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one for each matched record-pair with the same key plus one for each non-matching record of
-     * both {@link KStream}s and within the joining window intervals
+     * both {@code KStream}s and within the joining window intervals
      * @see #join(KStream, ValueJoiner, JoinWindows, Serde, Serde, Serde)
      * @see #leftJoin(KStream, ValueJoiner, JoinWindows, Serde, Serde, Serde)
      */
@@ -1369,17 +1369,17 @@ <VO, VR> KStream<K, VR> outerJoin(final KStream<K, VO> otherStream,
      * Join records of this stream with {@link KTable}'s records using non-windowed inner equi join with default
      * serializers and deserializers.
      * The join is a primary key table lookup join with join attribute {@code stream.key == table.key}.
-     * "Table lookup join" means, that results are only computed if {@link KStream} records are processed.
+     * "Table lookup join" means, that results are only computed if {@code KStream} records are processed.
      * This is done by performing a lookup for matching records in the <em>current</em> (i.e., processing time) internal
      * {@link KTable} state.
      * In contrast, processing {@link KTable} input records will only update the internal {@link KTable} state and
      * will not produce any result records.
      * <p>
-     * For each {@link KStream} record that finds a corresponding record in {@link KTable} the provided
+     * For each {@code KStream} record that finds a corresponding record in {@link KTable} the provided
      * {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
-     * If an {@link KStream} input record key or value is {@code null} the record will not be included in the join
-     * operation and thus no output record will be added to the resulting {@link KStream}.
+     * If an {@code KStream} input record key or value is {@code null} the record will not be included in the join
+     * operation and thus no output record will be added to the resulting {@code KStream}.
      * <p>
      * Example:
      * <table border='1'>
@@ -1418,16 +1418,16 @@ <VO, VR> KStream<K, VR> outerJoin(final KStream<K, VO> otherStream,
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen only for this {@link KStream}s.
+     * Repartitioning can happen only for this {@code KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * records to it, and rereading all records from it, such that the join input {@code KStream} is partitioned
      * correctly on its key.
      *
      * @param table  the {@link KTable} to be joined with this stream
      * @param joiner a {@link ValueJoiner} that computes the join result for a pair of matching records
      * @param <VT>   the value type of the table
      * @param <VR>   the value type of the result stream
-     * @return a {@link KStream} that contains join-records for each key and values computed by the given
+     * @return a {@code KStream} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one for each matched record-pair with the same key
      * @see #leftJoin(KTable, ValueJoiner)
      * @see #join(GlobalKTable, KeyValueMapper, ValueJoiner)
@@ -1438,17 +1438,17 @@ <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
     /**
      * Join records of this stream with {@link KTable}'s records using non-windowed inner equi join.
      * The join is a primary key table lookup join with join attribute {@code stream.key == table.key}.
-     * "Table lookup join" means, that results are only computed if {@link KStream} records are processed.
+     * "Table lookup join" means, that results are only computed if {@code KStream} records are processed.
      * This is done by performing a lookup for matching records in the <em>current</em> (i.e., processing time) internal
      * {@link KTable} state.
      * In contrast, processing {@link KTable} input records will only update the internal {@link KTable} state and
      * will not produce any result records.
      * <p>
-     * For each {@link KStream} record that finds a corresponding record in {@link KTable} the provided
+     * For each {@code KStream} record that finds a corresponding record in {@link KTable} the provided
      * {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
-     * If an {@link KStream} input record key or value is {@code null} the record will not be included in the join
-     * operation and thus no output record will be added to the resulting {@link KStream}.
+     * If an {@code KStream} input record key or value is {@code null} the record will not be included in the join
+     * operation and thus no output record will be added to the resulting {@code KStream}.
      * <p>
      * Example:
      * <table border='1'>
@@ -1487,9 +1487,9 @@ <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen only for this {@link KStream}s.
+     * Repartitioning can happen only for this {@code KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * records to it, and rereading all records from it, such that the join input {@code KStream} is partitioned
      * correctly on its key.
      *
      * @param table    the {@link KTable} to be joined with this stream
@@ -1500,7 +1500,7 @@ <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
      *                 if not specified the default serdes defined in the configs will be used
      * @param <VT>     the value type of the table
      * @param <VR>     the value type of the result stream
-     * @return a {@link KStream} that contains join-records for each key and values computed by the given
+     * @return a {@code KStream} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one for each matched record-pair with the same key
      * @see #leftJoin(KTable, ValueJoiner, Serde, Serde)
      * @see #join(GlobalKTable, KeyValueMapper, ValueJoiner)
@@ -1516,18 +1516,18 @@ <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
      * In contrast to {@link #join(KTable, ValueJoiner) inner-join}, all records from this stream will produce an
      * output record (cf. below).
      * The join is a primary key table lookup join with join attribute {@code stream.key == table.key}.
-     * "Table lookup join" means, that results are only computed if {@link KStream} records are processed.
+     * "Table lookup join" means, that results are only computed if {@code KStream} records are processed.
      * This is done by performing a lookup for matching records in the <em>current</em> (i.e., processing time) internal
      * {@link KTable} state.
      * In contrast, processing {@link KTable} input records will only update the internal {@link KTable} state and
      * will not produce any result records.
      * <p>
-     * For each {@link KStream} record weather or not it finds a corresponding record in {@link KTable} the provided
+     * For each {@code KStream} record weather or not it finds a corresponding record in {@link KTable} the provided
      * {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
      * If no {@link KTable} record was found during lookup, a {@code null} value will be provided to {@link ValueJoiner}.
      * The key of the result record is the same as for both joining input records.
-     * If an {@link KStream} input record key or value is {@code null} the record will not be included in the join
-     * operation and thus no output record will be added to the resulting {@link KStream}.
+     * If an {@code KStream} input record key or value is {@code null} the record will not be included in the join
+     * operation and thus no output record will be added to the resulting {@code KStream}.
      * <p>
      * Example:
      * <table border='1'>
@@ -1566,17 +1566,17 @@ <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen only for this {@link KStream}s.
+     * Repartitioning can happen only for this {@code KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * records to it, and rereading all records from it, such that the join input {@code KStream} is partitioned
      * correctly on its key.
      *
      * @param table  the {@link KTable} to be joined with this stream
      * @param joiner a {@link ValueJoiner} that computes the join result for a pair of matching records
      * @param <VT>   the value type of the table
      * @param <VR>   the value type of the result stream
-     * @return a {@link KStream} that contains join-records for each key and values computed by the given
-     * {@link ValueJoiner}, one output for each input {@link KStream} record
+     * @return a {@code KStream} that contains join-records for each key and values computed by the given
+     * {@link ValueJoiner}, one output for each input {@code KStream} record
      * @see #join(KTable, ValueJoiner)
      * @see #leftJoin(GlobalKTable, KeyValueMapper, ValueJoiner)
      */
@@ -1588,18 +1588,18 @@ <VT, VR> KStream<K, VR> leftJoin(final KTable<K, VT> table,
      * In contrast to {@link #join(KTable, ValueJoiner) inner-join}, all records from this stream will produce an
      * output record (cf. below).
      * The join is a primary key table lookup join with join attribute {@code stream.key == table.key}.
-     * "Table lookup join" means, that results are only computed if {@link KStream} records are processed.
+     * "Table lookup join" means, that results are only computed if {@code KStream} records are processed.
      * This is done by performing a lookup for matching records in the <em>current</em> (i.e., processing time) internal
      * {@link KTable} state.
      * In contrast, processing {@link KTable} input records will only update the internal {@link KTable} state and
      * will not produce any result records.
      * <p>
-     * For each {@link KStream} record weather or not it finds a corresponding record in {@link KTable} the provided
+     * For each {@code KStream} record weather or not it finds a corresponding record in {@link KTable} the provided
      * {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
      * If no {@link KTable} record was found during lookup, a {@code null} value will be provided to {@link ValueJoiner}.
      * The key of the result record is the same as for both joining input records.
-     * If an {@link KStream} input record key or value is {@code null} the record will not be included in the join
-     * operation and thus no output record will be added to the resulting {@link KStream}.
+     * If an {@code KStream} input record key or value is {@code null} the record will not be included in the join
+     * operation and thus no output record will be added to the resulting {@code KStream}.
      * <p>
      * Example:
      * <table border='1'>
@@ -1638,9 +1638,9 @@ <VT, VR> KStream<K, VR> leftJoin(final KTable<K, VT> table,
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen only for this {@link KStream}s.
+     * Repartitioning can happen only for this {@code KStream}s.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
-     * records to it, and rereading all records from it, such that the join input {@link KStream} is partitioned
+     * records to it, and rereading all records from it, such that the join input {@code KStream} is partitioned
      * correctly on its key.
      *
      * @param table    the {@link KTable} to be joined with this stream
@@ -1651,8 +1651,8 @@ <VT, VR> KStream<K, VR> leftJoin(final KTable<K, VT> table,
      *                 if not specified the default serdes defined in the configs will be used
      * @param <VT>     the value type of the table
      * @param <VR>     the value type of the result stream
-     * @return a {@link KStream} that contains join-records for each key and values computed by the given
-     * {@link ValueJoiner}, one output for each input {@link KStream} record
+     * @return a {@code KStream} that contains join-records for each key and values computed by the given
+     * {@link ValueJoiner}, one output for each input {@code KStream} record
      * @see #join(KTable, ValueJoiner, Serde, Serde)
      * @see #leftJoin(GlobalKTable, KeyValueMapper, ValueJoiner)
      */
@@ -1665,17 +1665,17 @@ <VT, VR> KStream<K, VR> leftJoin(final KTable<K, VT> table,
      * Join records of this stream with {@link GlobalKTable}'s records using non-windowed inner equi join.
      * The join is a primary key table lookup join with join attribute
      * {@code keyValueMapper.map(stream.keyValue) == table.key}.
-     * "Table lookup join" means, that results are only computed if {@link KStream} records are processed.
+     * "Table lookup join" means, that results are only computed if {@code KStream} records are processed.
      * This is done by performing a lookup for matching records in the <em>current</em> internal {@link GlobalKTable}
      * state.
      * In contrast, processing {@link GlobalKTable} input records will only update the internal {@link GlobalKTable}
      * state and will not produce any result records.
      * <p>
-     * For each {@link KStream} record that finds a corresponding record in {@link GlobalKTable} the provided
+     * For each {@code KStream} record that finds a corresponding record in {@link GlobalKTable} the provided
      * {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
-     * The key of the result record is the same as the key of this {@link KStream}.
-     * If an {@link KStream} input record key or value is {@code null} the record will not be included in the join
-     * operation and thus no output record will be added to the resulting {@link KStream}.
+     * The key of the result record is the same as the key of this {@code KStream}.
+     * If an {@code KStream} input record key or value is {@code null} the record will not be included in the join
+     * operation and thus no output record will be added to the resulting {@code KStream}.
      *
      * @param globalKTable   the {@link GlobalKTable} to be joined with this stream
      * @param keyValueMapper instance of {@link KeyValueMapper} used to map from the (key, value) of this stream
@@ -1683,9 +1683,9 @@ <VT, VR> KStream<K, VR> leftJoin(final KTable<K, VT> table,
      * @param joiner         a {@link ValueJoiner} that computes the join result for a pair of matching records
      * @param <GK>           the key type of {@link GlobalKTable}
      * @param <GV>           the value type of the {@link GlobalKTable}
-     * @param <RV>           the value type of the resulting {@link KStream}
-     * @return a {@link KStream} that contains join-records for each key and values computed by the given
-     * {@link ValueJoiner}, one output for each input {@link KStream} record
+     * @param <RV>           the value type of the resulting {@code KStream}
+     * @return a {@code KStream} that contains join-records for each key and values computed by the given
+     * {@link ValueJoiner}, one output for each input {@code KStream} record
      * @see #leftJoin(GlobalKTable, KeyValueMapper, ValueJoiner)
      */
     <GK, GV, RV> KStream<K, RV> join(final GlobalKTable<GK, GV> globalKTable,
@@ -1698,19 +1698,19 @@ <GK, GV, RV> KStream<K, RV> join(final GlobalKTable<GK, GV> globalKTable,
      * will produce an output record (cf. below).
      * The join is a primary key table lookup join with join attribute
      * {@code keyValueMapper.map(stream.keyValue) == table.key}.
-     * "Table lookup join" means, that results are only computed if {@link KStream} records are processed.
+     * "Table lookup join" means, that results are only computed if {@code KStream} records are processed.
      * This is done by performing a lookup for matching records in the <em>current</em> internal {@link GlobalKTable}
      * state.
      * In contrast, processing {@link GlobalKTable} input records will only update the internal {@link GlobalKTable}
      * state and will not produce any result records.
      * <p>
-     * For each {@link KStream} record whether or not it finds a corresponding record in {@link GlobalKTable} the
+     * For each {@code KStream} record whether or not it finds a corresponding record in {@link GlobalKTable} the
      * provided {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
      * If no {@link GlobalKTable} record was found during lookup, a {@code null} value will be provided to
      * {@link ValueJoiner}.
-     * The key of the result record is the same as this {@link KStream}.
-     * If an {@link KStream} input record key or value is {@code null} the record will not be included in the join
-     * operation and thus no output record will be added to the resulting {@link KStream}.
+     * The key of the result record is the same as this {@code KStream}.
+     * If an {@code KStream} input record key or value is {@code null} the record will not be included in the join
+     * operation and thus no output record will be added to the resulting {@code KStream}.
      *
      * @param globalKTable   the {@link GlobalKTable} to be joined with this stream
      * @param keyValueMapper instance of {@link KeyValueMapper} used to map from the (key, value) of this stream
@@ -1718,9 +1718,9 @@ <GK, GV, RV> KStream<K, RV> join(final GlobalKTable<GK, GV> globalKTable,
      * @param valueJoiner    a {@link ValueJoiner} that computes the join result for a pair of matching records
      * @param <GK>           the key type of {@link GlobalKTable}
      * @param <GV>           the value type of the {@link GlobalKTable}
-     * @param <RV>           the value type of the resulting {@link KStream}
-     * @return a {@link KStream} that contains join-records for each key and values computed by the given
-     * {@link ValueJoiner}, one output for each input {@link KStream} record
+     * @param <RV>           the value type of the resulting {@code KStream}
+     * @return a {@code KStream} that contains join-records for each key and values computed by the given
+     * {@link ValueJoiner}, one output for each input {@code KStream} record
      * @see #join(GlobalKTable, KeyValueMapper, ValueJoiner)
      */
     <GK, GV, RV> KStream<K, RV> leftJoin(final GlobalKTable<GK, GV> globalKTable,
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java
index 8f67d457156bb..7c64e6fc52e1a 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java
@@ -40,7 +40,7 @@
 import java.util.regex.Pattern;
 
 /**
- * {@link KStreamBuilder} provide the high-level Kafka Streams DSL to specify a Kafka Streams topology.
+ * {@code KStreamBuilder} provide the high-level Kafka Streams DSL to specify a Kafka Streams topology.
  *
  * @see TopologyBuilder
  * @see KStream
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java
index bfb470a2d71b9..4b703979b5bf2 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java
@@ -29,17 +29,17 @@
 import org.apache.kafka.streams.state.ReadOnlyKeyValueStore;
 
 /**
- * {@link KTable} is an abstraction of a <i>changelog stream</i> from a primary-keyed table.
+ * {@code KTable} is an abstraction of a <i>changelog stream</i> from a primary-keyed table.
  * Each record in this changelog stream is an update on the primary-keyed table with the record key as the primary key.
  * <p>
- * A {@link KTable} is either {@link KStreamBuilder#table(String, String) defined from a single Kafka topic} that is
- * consumed message by message or the result of a {@link KTable} transformation.
- * An aggregation of a {@link KStream} also yields a {@link KTable}.
+ * A {@code KTable} is either {@link KStreamBuilder#table(String, String) defined from a single Kafka topic} that is
+ * consumed message by message or the result of a {@code KTable} transformation.
+ * An aggregation of a {@link KStream} also yields a {@code KTable}.
  * <p>
- * A {@link KTable} can be transformed record by record, joined with another {@link KTable} or {@link KStream}, or
- * can be re-partitioned and aggregated into a new {@link KTable}.
+ * A {@code KTable} can be transformed record by record, joined with another {@code KTable} or {@link KStream}, or
+ * can be re-partitioned and aggregated into a new {@code KTable}.
  * <p>
- * Some {@link KTable}s have an internal state (a {@link ReadOnlyKeyValueStore}) and are therefore queryable via the
+ * Some {@code KTable}s have an internal state (a {@link ReadOnlyKeyValueStore}) and are therefore queryable via the
  * interactive queries API.
  * For example:
  * <pre>{@code
@@ -64,11 +64,11 @@
 public interface KTable<K, V> {
 
     /**
-     * Create a new {@link KTable} that consists of all records of this {@link KTable} which satisfy the given
+     * Create a new {@code KTable} that consists of all records of this {@code KTable} which satisfy the given
      * predicate.
      * All records that do not satisfy the predicate are dropped.
-     * For each {@link KTable} update the filter is evaluated on the update record to produce an update record for the
-     * result {@link KTable}.
+     * For each {@code KTable} update the filter is evaluated on the update record to produce an update record for the
+     * result {@code KTable}.
      * This is a stateless record-by-record operation.
      * <p>
      * Note that {@code filter} for a <i>changelog stream</i> works different to {@link KStream#filter(Predicate)
@@ -80,17 +80,17 @@ public interface KTable<K, V> {
      * is forwarded.
      *
      * @param predicate a filter {@link Predicate} that is applied to each record
-     * @return a {@link KTable} that contains only those records that satisfy the given predicate
+     * @return a {@code KTable} that contains only those records that satisfy the given predicate
      * @see #filterNot(Predicate)
      */
     KTable<K, V> filter(final Predicate<? super K, ? super V> predicate);
 
     /**
-     * Create a new {@link KTable} that consists all records of this {@link KTable} which do <em>not</em> satisfy the
+     * Create a new {@code KTable} that consists all records of this {@code KTable} which do <em>not</em> satisfy the
      * given predicate.
      * All records that <em>do</em> satisfy the predicate are dropped.
-     * For each {@link KTable} update the filter is evaluated on the update record to produce an update record for the
-     * result {@link KTable}.
+     * For each {@code KTable} update the filter is evaluated on the update record to produce an update record for the
+     * result {@code KTable}.
      * This is a stateless record-by-record operation.
      * <p>
      * Note that {@code filterNot} for a <i>changelog stream</i> works different to {@link KStream#filterNot(Predicate)
@@ -102,16 +102,16 @@ public interface KTable<K, V> {
      * forwarded.
      *
      * @param predicate a filter {@link Predicate} that is applied to each record
-     * @return a {@link KTable} that contains only those records that do <em>not</em> satisfy the given predicate
+     * @return a {@code KTable} that contains only those records that do <em>not</em> satisfy the given predicate
      * @see #filter(Predicate)
      */
     KTable<K, V> filterNot(final Predicate<? super K, ? super V> predicate);
 
     /**
-     * Create a new {@link KTable} by transforming the value of each record in this {@link KTable} into a new value
-     * (with possible new type)in the new {@link KTable}.
-     * For each {@link KTable} update the provided {@link ValueMapper} is applied to the value of the update record and
-     * computes a new value for it, resulting in an update record for the result {@link KTable}.
+     * Create a new {@code KTable} by transforming the value of each record in this {@code KTable} into a new value
+     * (with possible new type)in the new {@code KTable}.
+     * For each {@code KTable} update the provided {@link ValueMapper} is applied to the value of the update record and
+     * computes a new value for it, resulting in an update record for the result {@code KTable}.
      * Thus, an input record {@code <K,V>} can be transformed into an output record {@code <K:V'>}.
      * This is a stateless record-by-record operation.
      * <p>
@@ -127,23 +127,23 @@ public interface KTable<K, V> {
      * <p>
      * This operation preserves data co-location with respect to the key.
      * Thus, <em>no</em> internal data redistribution is required if a key based operator (like a join) is applied to
-     * the result {@link KTable}.
+     * the result {@code KTable}.
      * <p>
      * Note that {@code mapValues} for a <i>changelog stream</i> works different to {@link KStream#mapValues(ValueMapper)
      * record stream filters}, because {@link KeyValue records} with {@code null} values (so-called tombstone records)
      * have delete semantics.
      * Thus, for tombstones the provided value-mapper is not evaluated but the tombstone record is forwarded directly to
-     * delete the corresponding record in the result {@link KTable}.
+     * delete the corresponding record in the result {@code KTable}.
      *
      * @param mapper a {@link ValueMapper} that computes a new output value
-     * @param <VR>   the value type of the result {@link KTable}
-     * @return a {@link KTable} that contains records with unmodified keys and new values (possibly of different type)
+     * @param <VR>   the value type of the result {@code KTable}
+     * @return a {@code KTable} that contains records with unmodified keys and new values (possibly of different type)
      */
     <VR> KTable<K, VR> mapValues(final ValueMapper<? super V, ? extends VR> mapper);
 
 
     /**
-     * Print the update records of this {@link KTable} to {@code System.out}.
+     * Print the update records of this {@code KTable} to {@code System.out}.
      * This function will use the generated name of the parent processor node to label the key/value pairs printed to
      * the console.
      * <p>
@@ -153,13 +153,13 @@ public interface KTable<K, V> {
      * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
      * {@link Integer} etc. to get meaningful information.
      * <p>
-     * Note that {@code print()} is not applied to the internal state store and only called for each new {@link KTable}
+     * Note that {@code print()} is not applied to the internal state store and only called for each new {@code KTable}
      * update record.
      */
     void print();
 
     /**
-     * Print the update records of this {@link KTable} to {@code System.out}.
+     * Print the update records of this {@code KTable} to {@code System.out}.
      * This function will use the given name to label the key/value pairs printed to the console.
      * <p>
      * The provided serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
@@ -168,7 +168,7 @@ public interface KTable<K, V> {
      * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
      * {@link Integer} etc. to get meaningful information.
      * <p>
-     * Note that {@code print()} is not applied to the internal state store and only called for each new {@link KTable}
+     * Note that {@code print()} is not applied to the internal state store and only called for each new {@code KTable}
      * update record.
      *
      * @param streamName the name used to label the key/value pairs printed to the console
@@ -176,7 +176,7 @@ public interface KTable<K, V> {
     void print(final String streamName);
 
     /**
-     * Print the update records of this {@link KTable} to {@code System.out}.
+     * Print the update records of this {@code KTable} to {@code System.out}.
      * This function will use the generated name of the parent processor node to label the key/value pairs printed to
      * the console.
      * <p>
@@ -186,7 +186,7 @@ public interface KTable<K, V> {
      * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
      * {@link Integer} etc. to get meaningful information.
      * <p>
-     * Note that {@code print()} is not applied to the internal state store and only called for each new {@link KTable}
+     * Note that {@code print()} is not applied to the internal state store and only called for each new {@code KTable}
      * update record.
      *
      * @param keySerde key serde used to deserialize key if type is {@code byte[]},
@@ -196,7 +196,7 @@ void print(final Serde<K> keySerde,
                final Serde<V> valSerde);
 
     /**
-     * Print the update records of this {@link KTable} to {@code System.out}.
+     * Print the update records of this {@code KTable} to {@code System.out}.
      * This function will use the given name to label the key/value pairs printed to the console.
      * <p>
      * The provided serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
@@ -205,7 +205,7 @@ void print(final Serde<K> keySerde,
      * Implementors will need to override {@code toString()} for keys and values that are not of type {@link String},
      * {@link Integer} etc. to get meaningful information.
      * <p>
-     * Note that {@code print()} is not applied to the internal state store and only called for each new {@link KTable}
+     * Note that {@code print()} is not applied to the internal state store and only called for each new {@code KTable}
      * update record.
      *
      * @param keySerde   key serde used to deserialize key if type is {@code byte[]},
@@ -217,7 +217,7 @@ void print(final Serde<K> keySerde,
                final String streamName);
 
     /**
-     * Write the update records of this {@link KTable} to a file at the given path.
+     * Write the update records of this {@code KTable} to a file at the given path.
      * This function will use the generated name of the parent processor node to label the key/value pairs printed to
      * the file.
      * <p>
@@ -228,14 +228,14 @@ void print(final Serde<K> keySerde,
      * {@link Integer} etc. to get meaningful information.
      * <p>
      * Note that {@code writeAsText()} is not applied to the internal state store and only called for each new
-     * {@link KTable} update record.
+     * {@code KTable} update record.
      *
      * @param filePath name of file to write to
      */
     void writeAsText(final String filePath);
 
     /**
-     * Write the update records of this {@link KTable} to a file at the given path.
+     * Write the update records of this {@code KTable} to a file at the given path.
      * This function will use the given name to label the key/value printed to the file.
      * <p>
      * The default serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
@@ -245,7 +245,7 @@ void print(final Serde<K> keySerde,
      * {@link Integer} etc. to get meaningful information.
      * <p>
      * Note that {@code writeAsText()} is not applied to the internal state store and only called for each new
-     * {@link KTable} update record.
+     * {@code KTable} update record.
      *
      * @param filePath   name of file to write to
      * @param streamName the name used to label the key/value pairs printed out to the console
@@ -254,7 +254,7 @@ void writeAsText(final String filePath,
                      final String streamName);
 
     /**
-     * Write the update records of this {@link KTable} to a file at the given path.
+     * Write the update records of this {@code KTable} to a file at the given path.
      * This function will use the generated name of the parent processor node to label the key/value pairs printed to
      * the file.
      * <p>
@@ -265,7 +265,7 @@ void writeAsText(final String filePath,
      * {@link Integer} etc. to get meaningful information.
      * <p>
      * Note that {@code writeAsText()} is not applied to the internal state store and only called for each new
-     * {@link KTable} update record.
+     * {@code KTable} update record.
      *
      * @param filePath name of file to write to
      * @param keySerde key serde used to deserialize key if type is {@code byte[]},
@@ -276,7 +276,7 @@ void  writeAsText(final String filePath,
                       final Serde<V> valSerde);
 
     /**
-     * Write the update records of this {@link KTable} to a file at the given path.
+     * Write the update records of this {@code KTable} to a file at the given path.
      * This function will use the given name to label the key/value printed to the file.
      * <p>
      * The default serde will be used to deserialize the key or value in case the type is {@code byte[]} before calling
@@ -286,7 +286,7 @@ void  writeAsText(final String filePath,
      * {@link Integer} etc. to get meaningful information.
      * <p>
      * Note that {@code writeAsText()} is not applied to the internal state store and only called for each new
-     * {@link KTable} update record.
+     * {@code KTable} update record.
      *
      * @param filePath name of file to write to
      * @param streamName the name used to label the key/value pairs printed to the console
@@ -299,11 +299,11 @@ void writeAsText(final String filePath,
                      final Serde<V> valSerde);
 
     /**
-     * Perform an action on each update record of this {@link KTable}.
+     * Perform an action on each update record of this {@code KTable}.
      * Note that this is a terminal operation that returns void.
      * <p>
      * Note that {@code foreach()} is not applied to the internal state store and only called for each new
-     * {@link KTable} update record.
+     * {@code KTable} update record.
      *
      * @param action an action to perform on each record
      */
@@ -313,9 +313,9 @@ void writeAsText(final String filePath,
      * Convert this changelog stream to a {@link KStream}.
      * <p>
      * Note that this is a logical operation and only changes the "interpretation" of the stream, i.e., each record of
-     * this changelog stream is no longer treated as an update record (cf. {@link KStream} vs {@link KTable}).
+     * this changelog stream is no longer treated as an update record (cf. {@link KStream} vs {@code KTable}).
      *
-     * @return a {@link KStream} that contains the same records as this {@link KTable}
+     * @return a {@link KStream} that contains the same records as this {@code KTable}
      */
     KStream<K, V> toStream();
 
@@ -338,16 +338,16 @@ void writeAsText(final String filePath,
      * {@code table.}{@link #toStream() toStream}{@code ().}{@link KStream#selectKey(KeyValueMapper) selectKey(KeyValueMapper)}.
      * <p>
      * Note that {@link #toStream()} is a logical operation and only changes the "interpretation" of the stream, i.e.,
-     * each record of this changelog stream is no longer treated as an update record (cf. {@link KStream} vs {@link KTable}).
+     * each record of this changelog stream is no longer treated as an update record (cf. {@link KStream} vs {@code KTable}).
      *
      * @param mapper a {@link KeyValueMapper} that computes a new key for each record
      * @param <KR> the new key type of the result stream
-     * @return a {@link KStream} that contains the same records as this {@link KTable}
+     * @return a {@link KStream} that contains the same records as this {@code KTable}
      */
     <KR> KStream<KR, V> toStream(final KeyValueMapper<? super K, ? super V, ? extends KR> mapper);
 
     /**
-     * Materialize this changelog stream to a topic and creates a new {@link KTable} from the topic using default
+     * Materialize this changelog stream to a topic and creates a new {@code KTable} from the topic using default
      * serializers and deserializers and producer's {@link DefaultPartitioner}.
      * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
      * started).
@@ -355,18 +355,18 @@ void writeAsText(final String filePath,
      * This is equivalent to calling {@link #to(String) #to(someTopicName)} and
      * {@link KStreamBuilder#table(String, String) KStreamBuilder#table(someTopicName, queryableStoreName)}.
      * <p>
-     * The resulting {@link KTable} will be materialized in a local state store with the given store name (cf.
+     * The resulting {@code KTable} will be materialized in a local state store with the given store name (cf.
      * {@link KStreamBuilder#table(String, String)})
      *
      * @param topic     the topic name
-     * @param storeName the state store name used for the result {@link KTable}
-     * @return a {@link KTable} that contains the exact same (and potentially repartitioned) records as this {@link KTable}
+     * @param storeName the state store name used for the result {@code KTable}
+     * @return a {@code KTable} that contains the exact same (and potentially repartitioned) records as this {@code KTable}
      */
     KTable<K, V> through(final String topic,
                          final String storeName);
 
     /**
-     * Materialize this changelog stream to a topic and creates a new {@link KTable} from the topic using default
+     * Materialize this changelog stream to a topic and creates a new {@code KTable} from the topic using default
      * serializers and deserializers and a customizable {@link StreamPartitioner} to determine the distribution of
      * records to partitions.
      * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
@@ -375,21 +375,21 @@ KTable<K, V> through(final String topic,
      * This is equivalent to calling {@link #to(StreamPartitioner, String) #to(partitioner, someTopicName)} and
      * {@link KStreamBuilder#table(String, String) KStreamBuilder#table(someTopicName, queryableStoreName)}.
      * <p>
-     * The resulting {@link KTable} will be materialized in a local state store with the given store name (cf.
+     * The resulting {@code KTable} will be materialized in a local state store with the given store name (cf.
      * {@link KStreamBuilder#table(String, String)})
      *
      * @param partitioner the function used to determine how records are distributed among partitions of the topic,
      *                    if not specified producer's {@link DefaultPartitioner} will be used
      * @param topic       the topic name
-     * @param storeName   the state store name used for the result {@link KTable}
-     * @return a {@link KTable} that contains the exact same (and potentially repartitioned) records as this {@link KTable}
+     * @param storeName   the state store name used for the result {@code KTable}
+     * @return a {@code KTable} that contains the exact same (and potentially repartitioned) records as this {@code KTable}
      */
     KTable<K, V> through(final StreamPartitioner<? super K, ? super V> partitioner,
                          final String topic,
                          final String storeName);
 
     /**
-     * Materialize this changelog stream to a topic and creates a new {@link KTable} from the topic.
+     * Materialize this changelog stream to a topic and creates a new {@code KTable} from the topic.
      * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
      * started).
      * <p>
@@ -399,7 +399,7 @@ KTable<K, V> through(final StreamPartitioner<? super K, ? super V> partitioner,
      * This is equivalent to calling {@link #to(Serde, Serde, String) #to(keySerde, valueSerde, someTopicName)} and
      * {@link KStreamBuilder#table(String, String) KStreamBuilder#table(someTopicName, queryableStoreName)}.
      * <p>
-     * The resulting {@link KTable} will be materialized in a local state store with the given store name (cf.
+     * The resulting {@code KTable} will be materialized in a local state store with the given store name (cf.
      * {@link KStreamBuilder#table(String, String)})
      *
      * @param keySerde  key serde used to send key-value pairs,
@@ -407,15 +407,15 @@ KTable<K, V> through(final StreamPartitioner<? super K, ? super V> partitioner,
      * @param valSerde  value serde used to send key-value pairs,
      *                  if not specified the default value serde defined in the configuration will be used
      * @param topic     the topic name
-     * @param storeName the state store name used for the result {@link KTable}
-     * @return a {@link KTable} that contains the exact same (and potentially repartitioned) records as this {@link KTable}
+     * @param storeName the state store name used for the result {@code KTable}
+     * @return a {@code KTable} that contains the exact same (and potentially repartitioned) records as this {@code KTable}
      */
     KTable<K, V> through(final Serde<K> keySerde, Serde<V> valSerde,
                          final String topic,
                          final String storeName);
 
     /**
-     * Materialize this changelog stream to a topic and creates a new {@link KTable} from the topic using a customizable
+     * Materialize this changelog stream to a topic and creates a new {@code KTable} from the topic using a customizable
      * {@link StreamPartitioner} to determine the distribution of records to partitions.
      * The specified topic should be manually created before it is used (i.e., before the Kafka Streams application is
      * started).
@@ -424,7 +424,7 @@ KTable<K, V> through(final Serde<K> keySerde, Serde<V> valSerde,
      * #to(keySerde, valueSerde, partitioner, someTopicName)} and
      * {@link KStreamBuilder#table(String, String) KStreamBuilder#table(someTopicName, queryableStoreName)}.
      * <p>
-     * The resulting {@link KTable} will be materialized in a local state store with the given store name (cf.
+     * The resulting {@code KTable} will be materialized in a local state store with the given store name (cf.
      * {@link KStreamBuilder#table(String, String)})
      *
      * @param keySerde    key serde used to send key-value pairs,
@@ -436,8 +436,8 @@ KTable<K, V> through(final Serde<K> keySerde, Serde<V> valSerde,
      *                    {@link WindowedStreamPartitioner} will be used&mdash;otherwise {@link DefaultPartitioner} will
      *                    be used
      * @param topic      the topic name
-     * @param storeName  the state store name used for the result {@link KTable}
-     * @return a {@link KTable} that contains the exact same (and potentially repartitioned) records as this {@link KTable}
+     * @param storeName  the state store name used for the result {@code KTable}
+     * @return a {@code KTable} that contains the exact same (and potentially repartitioned) records as this {@code KTable}
      */
     KTable<K, V> through(final Serde<K> keySerde,
                          final Serde<V> valSerde,
@@ -508,11 +508,11 @@ void to(final Serde<K> keySerde,
             final String topic);
 
     /**
-     * Re-groups the records of this {@link KTable} using the provided {@link KeyValueMapper} and default serializers
+     * Re-groups the records of this {@code KTable} using the provided {@link KeyValueMapper} and default serializers
      * and deserializers.
-     * Each {@link KeyValue} pair of this {@link KTable} is mapped to a new {@link KeyValue} pair by applying the
+     * Each {@link KeyValue} pair of this {@code KTable} is mapped to a new {@link KeyValue} pair by applying the
      * provided {@link KeyValueMapper}.
-     * Re-grouping a {@link KTable} is required before an aggregation operator can be applied to the data
+     * Re-grouping a {@code KTable} is required before an aggregation operator can be applied to the data
      * (cf. {@link KGroupedTable}).
      * The {@link KeyValueMapper} selects a new key and value (with should both have unmodified type).
      * If the new record key is {@code null} the record will not be included in the resulting {@link KGroupedTable}
@@ -523,7 +523,7 @@ void to(final Serde<K> keySerde,
      * an internally generated name, and "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * All data of this {@link KTable} will be redistributed through the repartitioning topic by writing all update
+     * All data of this {@code KTable} will be redistributed through the repartitioning topic by writing all update
      * records to and rereading all update records from it, such that the resulting {@link KGroupedTable} is partitioned
      * on the new key.
      * <p>
@@ -533,15 +533,15 @@ void to(final Serde<K> keySerde,
      * @param selector a {@link KeyValueMapper} that computes a new grouping key and value to be aggregated
      * @param <KR>     the key type of the result {@link KGroupedTable}
      * @param <VR>     the value type of the result {@link KGroupedTable}
-     * @return a {@link KGroupedTable} that contains the re-grouped records of the original {@link KTable}
+     * @return a {@link KGroupedTable} that contains the re-grouped records of the original {@code KTable}
      */
     <KR, VR> KGroupedTable<KR, VR> groupBy(final KeyValueMapper<? super K, ? super V, KeyValue<KR, VR>> selector);
 
     /**
-     * Re-groups the records of this {@link KTable} using the provided {@link KeyValueMapper}.
-     * Each {@link KeyValue} pair of this {@link KTable} is mapped to a new {@link KeyValue} pair by applying the
+     * Re-groups the records of this {@code KTable} using the provided {@link KeyValueMapper}.
+     * Each {@link KeyValue} pair of this {@code KTable} is mapped to a new {@link KeyValue} pair by applying the
      * provided {@link KeyValueMapper}.
-     * Re-grouping a {@link KTable} is required before an aggregation operator can be applied to the data
+     * Re-grouping a {@code KTable} is required before an aggregation operator can be applied to the data
      * (cf. {@link KGroupedTable}).
      * The {@link KeyValueMapper} selects a new key and value (both with potentially different type).
      * If the new record key is {@code null} the record will not be included in the resulting {@link KGroupedTable}
@@ -552,7 +552,7 @@ void to(final Serde<K> keySerde,
      * an internally generated name, and "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * All data of this {@link KTable} will be redistributed through the repartitioning topic by writing all update
+     * All data of this {@code KTable} will be redistributed through the repartitioning topic by writing all update
      * records to and rereading all update records from it, such that the resulting {@link KGroupedTable} is partitioned
      * on the new key.
      *
@@ -563,32 +563,32 @@ void to(final Serde<K> keySerde,
      *                   if not specified the default serdes defined in the configs will be used
      * @param <KR>       the key type of the result {@link KGroupedTable}
      * @param <VR>       the value type of the result {@link KGroupedTable}
-     * @return a {@link KGroupedTable} that contains the re-grouped records of the original {@link KTable}
+     * @return a {@link KGroupedTable} that contains the re-grouped records of the original {@code KTable}
      */
     <KR, VR> KGroupedTable<KR, VR> groupBy(final KeyValueMapper<? super K, ? super V, KeyValue<KR, VR>> selector,
                                            final Serde<KR> keySerde,
                                            final Serde<VR> valueSerde);
 
     /**
-     * Join records of this {@link KTable} with another {@link KTable}'s records using non-windowed inner equi join.
+     * Join records of this {@code KTable} with another {@code KTable}'s records using non-windowed inner equi join.
      * The join is a primary key join with join attribute {@code thisKTable.key == otherKTable.key}.
-     * The result is an ever updating {@link KTable} that represents the <em>current</em> (i.e., processing time) result
+     * The result is an ever updating {@code KTable} that represents the <em>current</em> (i.e., processing time) result
      * of the join.
      * <p>
-     * The join is computed by (1) updating the internal state of one {@link KTable} and (2) performing a lookup for a
-     * matching record in the <em>current</em> (i.e., processing time) internal state of the other {@link KTable}.
+     * The join is computed by (1) updating the internal state of one {@code KTable} and (2) performing a lookup for a
+     * matching record in the <em>current</em> (i.e., processing time) internal state of the other {@code KTable}.
      * This happens in a symmetric way, i.e., for each update of either {@code this} or the {@code other} input
-     * {@link KTable} the result gets updated.
+     * {@code KTable} the result gets updated.
      * <p>
-     * For each {@link KTable} record that finds a corresponding record in the other {@link KTable} the provided
+     * For each {@code KTable} record that finds a corresponding record in the other {@code KTable} the provided
      * {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
      * <p>
      * Note that {@link KeyValue records} with {@code null} values (so-called tombstone records) have delete semantics.
      * Thus, for input tombstones the provided value-joiner is not called but a tombstone record is forwarded
-     * directly to delete a record in the result {@link KTable} if required (i.e., if there is anything to be deleted).
+     * directly to delete a record in the result {@code KTable} if required (i.e., if there is anything to be deleted).
      * <p>
-     * A {@link KTable} input record key cannot be {@code null}.
+     * A {@code KTable} input record key cannot be {@code null}.
      * <p>
      * Example:
      * <table border='1'>
@@ -637,16 +637,16 @@ <KR, VR> KGroupedTable<KR, VR> groupBy(final KeyValueMapper<? super K, ? super V
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen both input {@link KTable}s.
-     * For this case, all data of a {@link KTable} will be redistributed through the repartitioning topic by writing all
-     * update records to and rereading all update records from it, such that the join input {@link KTable} is
+     * Repartitioning can happen both input {@code KTable}s.
+     * For this case, all data of a {@code KTable} will be redistributed through the repartitioning topic by writing all
+     * update records to and rereading all update records from it, such that the join input {@code KTable} is
      * partitioned correctly on its key.
      *
-     * @param other  the other {@link KTable} to be joined with this {@link KTable}
+     * @param other  the other {@code KTable} to be joined with this {@code KTable}
      * @param joiner a {@link ValueJoiner} that computes the join result for a pair of matching records
-     * @param <VO>   the value type of the other {@link KTable}
-     * @param <VR>   the value type of the result {@link KTable}
-     * @return a {@link KTable} that contains join-records for each key and values computed by the given
+     * @param <VO>   the value type of the other {@code KTable}
+     * @param <VR>   the value type of the result {@code KTable}
+     * @return a {@code KTable} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one for each matched record-pair with the same key
      * @see #leftJoin(KTable, ValueJoiner)
      * @see #outerJoin(KTable, ValueJoiner)
@@ -655,32 +655,32 @@ <VO, VR> KTable<K, VR> join(final KTable<K, VO> other,
                                 final ValueJoiner<? super V, ? super VO, ? extends VR> joiner);
 
     /**
-     * Join records of this {@link KTable} (left input) with another {@link KTable}'s (right input) records using
+     * Join records of this {@code KTable} (left input) with another {@code KTable}'s (right input) records using
      * non-windowed left equi join.
      * The join is a primary key join with join attribute {@code thisKTable.key == otherKTable.key}.
-     * In contrast to {@link #join(KTable, ValueJoiner) inner-join}, all records from left {@link KTable} will produce
+     * In contrast to {@link #join(KTable, ValueJoiner) inner-join}, all records from left {@code KTable} will produce
      * an output record (cf. below).
-     * The result is an ever updating {@link KTable} that represents the <em>current</em> (i.e., processing time) result
+     * The result is an ever updating {@code KTable} that represents the <em>current</em> (i.e., processing time) result
      * of the join.
      * <p>
-     * The join is computed by (1) updating the internal state of one {@link KTable} and (2) performing a lookup for a
-     * matching record in the <em>current</em> (i.e., processing time) internal state of the other {@link KTable}.
+     * The join is computed by (1) updating the internal state of one {@code KTable} and (2) performing a lookup for a
+     * matching record in the <em>current</em> (i.e., processing time) internal state of the other {@code KTable}.
      * This happens in a symmetric way, i.e., for each update of either {@code this} or the {@code other} input
-     * {@link KTable} the result gets updated.
+     * {@code KTable} the result gets updated.
      * <p>
-     * For each {@link KTable} record that finds a corresponding record in the other {@link KTable}'s state the
+     * For each {@code KTable} record that finds a corresponding record in the other {@code KTable}'s state the
      * provided {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
-     * Additionally, for each record of left {@link KTable} that does not find a corresponding record in the
-     * right {@link KTable}'s state the provided {@link ValueJoiner} will be called with {@code rightValue =
+     * Additionally, for each record of left {@code KTable} that does not find a corresponding record in the
+     * right {@code KTable}'s state the provided {@link ValueJoiner} will be called with {@code rightValue =
      * null} to compute a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
      * <p>
      * Note that {@link KeyValue records} with {@code null} values (so-called tombstone records) have delete semantics.
      * For example, for left input tombstones the provided value-joiner is not called but a tombstone record is
-     * forwarded directly to delete a record in the result {@link KTable} if required (i.e., if there is anything to be
+     * forwarded directly to delete a record in the result {@code KTable} if required (i.e., if there is anything to be
      * deleted).
      * <p>
-     * A {@link KTable} input record key cannot be {@code null}.
+     * A {@code KTable} input record key cannot be {@code null}.
      * <p>
      * Example:
      * <table border='1'>
@@ -729,18 +729,18 @@ <VO, VR> KTable<K, VR> join(final KTable<K, VO> other,
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen both input {@link KTable}s.
-     * For this case, all data of a {@link KTable} will be redistributed through the repartitioning topic by writing all
-     * update records to and rereading all update records from it, such that the join input {@link KTable} is
+     * Repartitioning can happen both input {@code KTable}s.
+     * For this case, all data of a {@code KTable} will be redistributed through the repartitioning topic by writing all
+     * update records to and rereading all update records from it, such that the join input {@code KTable} is
      * partitioned correctly on its key.
      *
-     * @param other  the other {@link KTable} to be joined with this {@link KTable}
+     * @param other  the other {@code KTable} to be joined with this {@code KTable}
      * @param joiner a {@link ValueJoiner} that computes the join result for a pair of matching records
-     * @param <VO>   the value type of the other {@link KTable}
-     * @param <VR>   the value type of the result {@link KTable}
-     * @return a {@link KTable} that contains join-records for each key and values computed by the given
+     * @param <VO>   the value type of the other {@code KTable}
+     * @param <VR>   the value type of the result {@code KTable}
+     * @return a {@code KTable} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one for each matched record-pair with the same key plus one for each non-matching record of
-     * left {@link KTable}
+     * left {@code KTable}
      * @see #join(KTable, ValueJoiner)
      * @see #outerJoin(KTable, ValueJoiner)
      */
@@ -748,31 +748,31 @@ <VO, VR> KTable<K, VR> leftJoin(final KTable<K, VO> other,
                                     final ValueJoiner<? super V, ? super VO, ? extends VR> joiner);
 
     /**
-     * Join records of this {@link KTable} (left input) with another {@link KTable}'s (right input) records using
+     * Join records of this {@code KTable} (left input) with another {@code KTable}'s (right input) records using
      * non-windowed outer equi join.
      * The join is a primary key join with join attribute {@code thisKTable.key == otherKTable.key}.
      * In contrast to {@link #join(KTable, ValueJoiner) inner-join} or {@link #leftJoin(KTable, ValueJoiner) left-join},
-     * all records from both input {@link KTable}s will produce an output record (cf. below).
-     * The result is an ever updating {@link KTable} that represents the <em>current</em> (i.e., processing time) result
+     * all records from both input {@code KTable}s will produce an output record (cf. below).
+     * The result is an ever updating {@code KTable} that represents the <em>current</em> (i.e., processing time) result
      * of the join.
      * <p>
-     * The join is computed by (1) updating the internal state of one {@link KTable} and (2) performing a lookup for a
-     * matching record in the <em>current</em> (i.e., processing time) internal state of the other {@link KTable}.
+     * The join is computed by (1) updating the internal state of one {@code KTable} and (2) performing a lookup for a
+     * matching record in the <em>current</em> (i.e., processing time) internal state of the other {@code KTable}.
      * This happens in a symmetric way, i.e., for each update of either {@code this} or the {@code other} input
-     * {@link KTable} the result gets updated.
+     * {@code KTable} the result gets updated.
      * <p>
-     * For each {@link KTable} record that finds a corresponding record in the other {@link KTable}'s state the
+     * For each {@code KTable} record that finds a corresponding record in the other {@code KTable}'s state the
      * provided {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
      * Additionally, for each record that does not find a corresponding record in the corresponding other
-     * {@link KTable}'s state the provided {@link ValueJoiner} will be called with {@code null} value for the
+     * {@code KTable}'s state the provided {@link ValueJoiner} will be called with {@code null} value for the
      * corresponding other value to compute a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
      * <p>
      * Note that {@link KeyValue records} with {@code null} values (so-called tombstone records) have delete semantics.
      * Thus, for input tombstones the provided value-joiner is not called but a tombstone record is forwarded directly
-     * to delete a record in the result {@link KTable} if required (i.e., if there is anything to bedeleted).
+     * to delete a record in the result {@code KTable} if required (i.e., if there is anything to bedeleted).
      * <p>
-     * A {@link KTable} input record key cannot be {@code null}.
+     * A {@code KTable} input record key cannot be {@code null}.
      * <p>
      * Example:
      * <table border='1'>
@@ -821,18 +821,18 @@ <VO, VR> KTable<K, VR> leftJoin(final KTable<K, VO> other,
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen both input {@link KTable}s.
-     * For this case, all data of a {@link KTable} will be redistributed through the repartitioning topic by writing all
-     * update records to and rereading all update records from it, such that the join input {@link KTable} is
+     * Repartitioning can happen both input {@code KTable}s.
+     * For this case, all data of a {@code KTable} will be redistributed through the repartitioning topic by writing all
+     * update records to and rereading all update records from it, such that the join input {@code KTable} is
      * partitioned correctly on its key.
      *
-     * @param other  the other {@link KTable} to be joined with this {@link KTable}
+     * @param other  the other {@code KTable} to be joined with this {@code KTable}
      * @param joiner a {@link ValueJoiner} that computes the join result for a pair of matching records
-     * @param <VO>   the value type of the other {@link KTable}
-     * @param <VR>   the value type of the result {@link KTable}
-     * @return a {@link KTable} that contains join-records for each key and values computed by the given
+     * @param <VO>   the value type of the other {@code KTable}
+     * @param <VR>   the value type of the result {@code KTable}
+     * @return a {@code KTable} that contains join-records for each key and values computed by the given
      * {@link ValueJoiner}, one for each matched record-pair with the same key plus one for each non-matching record of
-     * both {@link KTable}s
+     * both {@code KTable}s
      * @see #join(KTable, ValueJoiner)
      * @see #leftJoin(KTable, ValueJoiner)
      */
@@ -840,9 +840,9 @@ <VO, VR> KTable<K, VR> outerJoin(final KTable<K, VO> other,
                                      final ValueJoiner<? super V, ? super VO, ? extends VR> joiner);
 
     /**
-     * Get the name of the local state store used for materializing this {@link KTable}.
+     * Get the name of the local state store used for materializing this {@code KTable}.
      *
-     * @return the underlying state store name, or {@code null} if this {@link KTable} is not materialized
+     * @return the underlying state store name, or {@code null} if this {@code KTable} is not materialized
      */
     String getStoreName();
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KeyValueMapper.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KeyValueMapper.java
index 13daca8f41ffe..e2434e37692fb 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KeyValueMapper.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KeyValueMapper.java
@@ -20,7 +20,7 @@
 import org.apache.kafka.streams.KeyValue;
 
 /**
- * The {@link KeyValueMapper} interface for mapping a {@link KeyValue key-value pair} to a new value of arbitrary type.
+ * The {@code KeyValueMapper} interface for mapping a {@link KeyValue key-value pair} to a new value of arbitrary type.
  * For example, it can be used to
  * <ul>
  * <li>map from an input {@link KeyValue} pair to an output {@link KeyValue} pair with different key and/or value type
@@ -29,7 +29,7 @@
  * </ul>
  * This is a stateless record-by-record operation, i.e, {@link #apply(Object, Object)} is invoked individually for each
  * record of a stream (cf. {@link Transformer} for stateful record transformation).
- * {@link KeyValueMapper} is a generalization of {@link ValueMapper}.
+ * {@code KeyValueMapper} is a generalization of {@link ValueMapper}.
  *
  * @param <K>  key type
  * @param <V>  value type
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Predicate.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Predicate.java
index ef22f24a62aa9..cf1a1f335b2f2 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Predicate.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Predicate.java
@@ -20,7 +20,7 @@
 import org.apache.kafka.streams.KeyValue;
 
 /**
- * The {@link Predicate} interface represents a predicate (boolean-valued function) of a {@link KeyValue} pair.
+ * The {@code Predicate} interface represents a predicate (boolean-valued function) of a {@link KeyValue} pair.
  * This is a stateless record-by-record operation, i.e, {@link #test(Object, Object)} is invoked individually for each
  * record of a stream.
  *
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Reducer.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Reducer.java
index 328f6236dcd65..5a273e4ee135f 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Reducer.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Reducer.java
@@ -20,13 +20,13 @@
 import org.apache.kafka.common.annotation.InterfaceStability;
 import org.apache.kafka.streams.KeyValue;
 /**
- * The {@link Reducer} interface for combining two values of the same type into a new value.
+ * The {@code Reducer} interface for combining two values of the same type into a new value.
  * In contrast to {@link Aggregator} the result type must be the same as the input type.
  * <p>
  * The provided values can be either original values from input {@link KeyValue} pair records or be a previously
  * computed result from {@link Reducer#apply(Object, Object)}.
  * <p>
- * {@link Reducer} can be used to implement aggregation functions like sum, min, or max.
+ * {@code Reducer} can be used to implement aggregation functions like sum, min, or max.
  *
  * @param <V> value type
  * @see KGroupedStream#reduce(Reducer, String)
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java
index 2eee43e7335ed..943092365dffd 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/SessionWindows.java
@@ -65,10 +65,10 @@
  * @see KGroupedStream#reduce(Reducer, SessionWindows, org.apache.kafka.streams.processor.StateStoreSupplier)
  * @see KGroupedStream#aggregate(Initializer, Aggregator, Merger, SessionWindows, org.apache.kafka.common.serialization.Serde, String)
  * @see KGroupedStream#aggregate(Initializer, Aggregator, Merger, SessionWindows, org.apache.kafka.common.serialization.Serde, org.apache.kafka.streams.processor.StateStoreSupplier)
- * @see org.apache.kafka.streams.processor.TimestampExtractor
+ * @see TimestampExtractor
  */
 @InterfaceStability.Unstable
-public class SessionWindows {
+public final class SessionWindows {
 
     private final long gapMs;
     private long maintainDurationMs;
@@ -121,7 +121,7 @@ public long inactivityGap() {
     /**
      * Return the window maintain duration (retention time) in milliseconds.
      * <p>
-     * For {@link SessionWindows} the maintain duration is at least as small as the window gap.
+     * For {@code SessionWindows} the maintain duration is at least as small as the window gap.
      *
      * @return the window maintain duration
      */
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java
index bcd3d8721ded8..14af875bebcaa 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/TimeWindows.java
@@ -56,7 +56,7 @@
  * @see TimestampExtractor
  */
 @InterfaceStability.Unstable
-public class TimeWindows extends Windows<TimeWindow> {
+public final class TimeWindows extends Windows<TimeWindow> {
 
     /** The size of the windows in milliseconds. */
     public final long sizeMs;
@@ -128,12 +128,11 @@ public long size() {
     }
 
     /**
-     * {@inheritDoc}
-     *
      * @param durationMs the window retention time
      * @return itself
      * @throws IllegalArgumentException if {@code duration} is smaller than the window size
      */
+    @Override
     public TimeWindows until(final long durationMs) throws IllegalArgumentException {
         if (durationMs < sizeMs) {
             throw new IllegalArgumentException("Window retention time (durationMs) cannot be smaller than the window size.");
@@ -145,7 +144,7 @@ public TimeWindows until(final long durationMs) throws IllegalArgumentException
     /**
      * {@inheritDoc}
      * <p>
-     * For {@link TimeWindows} the maintain duration is at least as small as the window size.
+     * For {@code TimeWindows} the maintain duration is at least as small as the window size.
      *
      * @return the window maintain duration
      */
@@ -155,7 +154,7 @@ public long maintainMs() {
     }
 
     @Override
-    public final boolean equals(final Object o) {
+    public boolean equals(final Object o) {
         if (o == this) {
             return true;
         }
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Transformer.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Transformer.java
index d9a814b94c33f..6d18477977e17 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Transformer.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Transformer.java
@@ -25,7 +25,7 @@
 import org.apache.kafka.streams.processor.TimestampExtractor;
 
 /**
- * The {@link Transformer} interface for stateful mapping of an input record to zero, one, or multiple new output
+ * The {@code Transformer} interface for stateful mapping of an input record to zero, one, or multiple new output
  * records (both key and value type can be altered arbitrarily).
  * This is a stateful record-by-record operation, i.e, {@link #transform(Object, Object)} is invoked individually for
  * each record of a stream and can access and modify a state that is available beyond a single call of
@@ -33,7 +33,7 @@
  * Additionally, the interface can be called in regular intervals based on the processing progress
  * (cf. {@link #punctuate(long)}.
  * <p>
- * Use {@link TransformerSupplier} to provide new instances of {@link Transformer} to Kafka Stream's runtime.
+ * Use {@link TransformerSupplier} to provide new instances of {@code Transformer} to Kafka Stream's runtime.
  * <p>
  * If only a record's value should be modified {@link ValueTransformer} can be used.
  *
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/TransformerSupplier.java b/streams/src/main/java/org/apache/kafka/streams/kstream/TransformerSupplier.java
index 0a0148982528d..f5385aeeba5c2 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/TransformerSupplier.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/TransformerSupplier.java
@@ -20,7 +20,7 @@
 import org.apache.kafka.common.annotation.InterfaceStability;
 
 /**
- * A {@link TransformerSupplier} interface which can create one or more {@link Transformer} instances.
+ * A {@code TransformerSupplier} interface which can create one or more {@link Transformer} instances.
  *
  * @param <K> key type
  * @param <V> value type
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java b/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java
index cab614204908d..14598e41e87bb 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/UnlimitedWindows.java
@@ -45,7 +45,7 @@
  * @see TimestampExtractor
  */
 @InterfaceStability.Unstable
-public class UnlimitedWindows extends Windows<UnlimitedWindow> {
+public final class UnlimitedWindows extends Windows<UnlimitedWindow> {
 
     private static final long DEFAULT_START_TIMESTAMP_MS = 0L;
 
@@ -123,7 +123,7 @@ public long maintainMs() {
     }
 
     @Override
-    public final boolean equals(final Object o) {
+    public boolean equals(final Object o) {
         if (o == this) {
             return true;
         }
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/ValueJoiner.java b/streams/src/main/java/org/apache/kafka/streams/kstream/ValueJoiner.java
index ab91bb4f7e327..94de484c28220 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/ValueJoiner.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/ValueJoiner.java
@@ -19,7 +19,7 @@
 import org.apache.kafka.common.annotation.InterfaceStability;
 
 /**
- * The {@link ValueJoiner} interface for joining two values into a new value of arbitrary type.
+ * The {@code ValueJoiner} interface for joining two values into a new value of arbitrary type.
  * This is a stateless operation, i.e, {@link #apply(Object, Object)} is invoked individually for each joining
  * record-pair of a {@link KStream}-{@link KStream}, {@link KStream}-{@link KTable}, or {@link KTable}-{@link KTable}
  * join.
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/ValueMapper.java b/streams/src/main/java/org/apache/kafka/streams/kstream/ValueMapper.java
index 71acc1d13c7c2..63e0cc471aaca 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/ValueMapper.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/ValueMapper.java
@@ -19,10 +19,10 @@
 import org.apache.kafka.common.annotation.InterfaceStability;
 
 /**
- * The {@link ValueMapper} interface for mapping a value to a new value of arbitrary type.
+ * The {@code ValueMapper} interface for mapping a value to a new value of arbitrary type.
  * This is a stateless record-by-record operation, i.e, {@link #apply(Object)} is invoked individually for each record
  * of a stream (cf. {@link ValueTransformer} for stateful value transformation).
- * If {@link ValueMapper} is applied to a {@link org.apache.kafka.streams.KeyValue key-value pair} record the record's
+ * If {@code ValueMapper} is applied to a {@link org.apache.kafka.streams.KeyValue key-value pair} record the record's
  * key is preserved.
  * If a record's key and value should be modified {@link KeyValueMapper} can be used.
  *
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformer.java b/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformer.java
index 02c3ba7270d62..b2008f5ba1f4d 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformer.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformer.java
@@ -25,15 +25,15 @@
 import org.apache.kafka.streams.processor.TimestampExtractor;
 
 /**
- * The {@link ValueTransformer} interface for stateful mapping of a value to a new value (with possible new type).
+ * The {@code ValueTransformer} interface for stateful mapping of a value to a new value (with possible new type).
  * This is a stateful record-by-record operation, i.e, {@link #transform(Object)} is invoked individually for each
  * record of a stream and can access and modify a state that is available beyond a single call of
  * {@link #transform(Object)} (cf. {@link ValueMapper} for stateless value transformation).
  * Additionally, the interface can be called in regular intervals based on the processing progress
  * (cf. {@link #punctuate(long)}.
- * If {@link ValueTransformer} is applied to a {@link KeyValue} pair record the record's key is preserved.
+ * If {@code ValueTransformer} is applied to a {@link KeyValue} pair record the record's key is preserved.
  * <p>
- * Use {@link ValueTransformerSupplier} to provide new instances of {@link ValueTransformer} to Kafka Stream's runtime.
+ * Use {@link ValueTransformerSupplier} to provide new instances of {@code ValueTransformer} to Kafka Stream's runtime.
  * <p>
  * If a record's key and value should be modified {@link Transformer} can be used.
  *
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformerSupplier.java b/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformerSupplier.java
index 3d357ee296141..01c920e95e4e9 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformerSupplier.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/ValueTransformerSupplier.java
@@ -19,7 +19,7 @@
 import org.apache.kafka.common.annotation.InterfaceStability;
 
 /**
- * A {@link ValueTransformerSupplier} interface which can create one or more {@link ValueTransformer} instances.
+ * A {@code ValueTransformerSupplier} interface which can create one or more {@link ValueTransformer} instances.
  *
  * @param <V>  value type
  * @param <VR> transformed value type
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java
index 5388affee9b90..0c8b3047d5560 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Window.java
@@ -21,10 +21,10 @@
 
 /**
  * A single window instance, defined by its start and end timestamp.
- * {@link Window} is agnostic if start/end boundaries are inclusive or exclusive; this is defined by concrete
+ * {@code Window} is agnostic if start/end boundaries are inclusive or exclusive; this is defined by concrete
  * window implementations.
  * <p>
- * To specify how {@link Window} boundaries are defined use {@link Windows}.
+ * To specify how {@code Window} boundaries are defined use {@link Windows}.
  * For time semantics, see {@link TimestampExtractor}.
  *
  * @see Windows
@@ -46,7 +46,7 @@ public abstract class Window {
      * @param endMs   the end timestamp of the window
      * @throws IllegalArgumentException if {@code startMs} is negative or if {@code endMs} is smaller than {@code startMs}
      */
-    public Window(long startMs, long endMs) throws IllegalArgumentException {
+    public Window(final long startMs, final long endMs) throws IllegalArgumentException {
         if (startMs < 0) {
             throw new IllegalArgumentException("Window startMs time cannot be negative.");
         }
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/Windowed.java b/streams/src/main/java/org/apache/kafka/streams/kstream/Windowed.java
index 2941136dc9856..63074c37b1593 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/Windowed.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/Windowed.java
@@ -25,7 +25,7 @@
  * If a {@link KStream} gets grouped and aggregated using a window-aggregation the resulting {@link KTable} is a
  * so-called "windowed {@link KTable}" with a combined key type that encodes the corresponding aggregation window and
  * the original record key.
- * Thus, a windowed {@link KTable} has type {@link Windowed &lt;Windowed&lt;K&gt;,V&gt;}
+ * Thus, a windowed {@link KTable} has type {@code <Windowed<K>,V>}.
  *
  * @param <K> type of the key
  * @see KGroupedStream#count(Windows, String)

From 619a9b09e5d6b226881014c4e9579ee30c51f628 Mon Sep 17 00:00:00 2001
From: Jeyhun Karimov <je.karimov@gmail.com>
Date: Mon, 30 Jan 2017 15:14:49 -0800
Subject: [PATCH 079/177] KAFKA-4613: Treat null-key records the same way for
 joins and aggreations

Author: Jeyhun Karimov <je.karimov@gmail.com>

Reviewers: Matthias J. Sax, Eno Thereska, Damian Guy, Guozhang Wang

Closes #2420 from jeyhunkarimov/KAFKA-4613

(cherry picked from commit b559846f2f8151e41a6259e8a570b9422932c836)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../apache/kafka/streams/kstream/KTable.java  | 21 +++++++------------
 .../kstream/internals/KTableKTableJoin.java   | 11 ++++------
 .../internals/KTableKTableLeftJoin.java       | 11 ++++------
 .../internals/KTableKTableOuterJoin.java      | 11 ++++------
 .../internals/KTableKTableRightJoin.java      | 11 ++++------
 .../kstream/internals/KTableSource.java       |  5 ++---
 .../internals/KTableKTableJoinTest.java       |  8 +++++++
 .../internals/KTableKTableLeftJoinTest.java   |  4 ++++
 .../internals/KTableKTableOuterJoinTest.java  |  4 ++++
 9 files changed, 42 insertions(+), 44 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java
index 4b703979b5bf2..77f74a8854e58 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java
@@ -530,6 +530,8 @@ void to(final Serde<K> keySerde,
      * If the key or value type is changed, it is recommended to use {@link #groupBy(KeyValueMapper, Serde, Serde)}
      * instead.
      *
+     * If the new record key is {@code null} the record will not be included in the resulting {@link KGroupedTable}.
+     *
      * @param selector a {@link KeyValueMapper} that computes a new grouping key and value to be aggregated
      * @param <KR>     the key type of the result {@link KGroupedTable}
      * @param <VR>     the value type of the result {@link KGroupedTable}
@@ -556,6 +558,8 @@ void to(final Serde<K> keySerde,
      * records to and rereading all update records from it, such that the resulting {@link KGroupedTable} is partitioned
      * on the new key.
      *
+     * If the new record key is {@code null} the record will not be included in the resulting {@link KGroupedTable}.
+     *
      * @param selector   a {@link KeyValueMapper} that computes a new grouping key and value to be aggregated
      * @param keySerde   key serdes for materializing this stream,
      *                   if not specified the default serdes defined in the configs will be used
@@ -584,12 +588,9 @@ <KR, VR> KGroupedTable<KR, VR> groupBy(final KeyValueMapper<? super K, ? super V
      * {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
      * <p>
-     * Note that {@link KeyValue records} with {@code null} values (so-called tombstone records) have delete semantics.
+     * Note that {@link KeyValue records} with {@code null} keys or values (so-called tombstone records) have delete semantics.
      * Thus, for input tombstones the provided value-joiner is not called but a tombstone record is forwarded
      * directly to delete a record in the result {@code KTable} if required (i.e., if there is anything to be deleted).
-     * <p>
-     * A {@code KTable} input record key cannot be {@code null}.
-     * <p>
      * Example:
      * <table border='1'>
      * <tr>
@@ -675,13 +676,10 @@ <VO, VR> KTable<K, VR> join(final KTable<K, VO> other,
      * null} to compute a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
      * <p>
-     * Note that {@link KeyValue records} with {@code null} values (so-called tombstone records) have delete semantics.
+     * Note that {@link KeyValue records} with {@code null} keys or values (so-called tombstone records) have delete semantics.
      * For example, for left input tombstones the provided value-joiner is not called but a tombstone record is
      * forwarded directly to delete a record in the result {@code KTable} if required (i.e., if there is anything to be
      * deleted).
-     * <p>
-     * A {@code KTable} input record key cannot be {@code null}.
-     * <p>
      * Example:
      * <table border='1'>
      * <tr>
@@ -768,12 +766,9 @@ <VO, VR> KTable<K, VR> leftJoin(final KTable<K, VO> other,
      * corresponding other value to compute a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
      * <p>
-     * Note that {@link KeyValue records} with {@code null} values (so-called tombstone records) have delete semantics.
+     * Note that {@link KeyValue records} with {@code null} keys or values (so-called tombstone records) have delete semantics.
      * Thus, for input tombstones the provided value-joiner is not called but a tombstone record is forwarded directly
-     * to delete a record in the result {@code KTable} if required (i.e., if there is anything to bedeleted).
-     * <p>
-     * A {@code KTable} input record key cannot be {@code null}.
-     * <p>
+     * to delete a record in the result {@code KTable} if required (i.e., if there is anything to be deleted).
      * Example:
      * <table border='1'>
      * <tr>
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableJoin.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableJoin.java
index 21a11766a4f99..f8e3f15791ae2 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableJoin.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableJoin.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.streams.kstream.internals;
 
-import org.apache.kafka.streams.errors.StreamsException;
 import org.apache.kafka.streams.kstream.KeyValueMapper;
 import org.apache.kafka.streams.kstream.ValueJoiner;
 import org.apache.kafka.streams.processor.AbstractProcessor;
@@ -76,14 +75,12 @@ public void init(ProcessorContext context) {
             valueGetter.init(context);
         }
 
-        /**
-         * @throws StreamsException if key is null
-         */
         @Override
         public void process(final K key, final Change<V1> change) {
-            // the keys should never be null
-            if (key == null)
-                throw new StreamsException("Record key for KTable join operator should not be null.");
+            // we do join iff keys are equal, thus, if key is null we cannot join and just ignore the record
+            if (key == null) {
+                return;
+            }
 
             R newValue = null;
             R oldValue = null;
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableLeftJoin.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableLeftJoin.java
index cfdaf6123a7ac..ea625a7880e46 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableLeftJoin.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableLeftJoin.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.streams.kstream.internals;
 
-import org.apache.kafka.streams.errors.StreamsException;
 import org.apache.kafka.streams.kstream.ValueJoiner;
 import org.apache.kafka.streams.processor.AbstractProcessor;
 import org.apache.kafka.streams.processor.Processor;
@@ -66,14 +65,12 @@ public void init(ProcessorContext context) {
             valueGetter.init(context);
         }
 
-        /**
-         * @throws StreamsException if key is null
-         */
         @Override
         public void process(final K key, final Change<V1> change) {
-            // the keys should never be null
-            if (key == null)
-                throw new StreamsException("Record key for KTable left-join operator should not be null.");
+            // we do join iff keys are equal, thus, if key is null we cannot join and just ignore the record
+            if (key == null) {
+                return;
+            }
 
             R newValue = null;
             R oldValue = null;
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableOuterJoin.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableOuterJoin.java
index 5b3241536ff5a..0809d65b58506 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableOuterJoin.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableOuterJoin.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.streams.kstream.internals;
 
-import org.apache.kafka.streams.errors.StreamsException;
 import org.apache.kafka.streams.kstream.ValueJoiner;
 import org.apache.kafka.streams.processor.AbstractProcessor;
 import org.apache.kafka.streams.processor.Processor;
@@ -65,14 +64,12 @@ public void init(ProcessorContext context) {
             valueGetter.init(context);
         }
 
-        /**
-         * @throws StreamsException if key is null
-         */
         @Override
         public void process(final K key, final Change<V1> change) {
-            // the keys should never be null
-            if (key == null)
-                throw new StreamsException("Record key for KTable outer-join operator should not be null.");
+            // we do join iff keys are equal, thus, if key is null we cannot join and just ignore the record
+            if (key == null) {
+                return;
+            }
 
             R newValue = null;
             R oldValue = null;
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableRightJoin.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableRightJoin.java
index 17fa5cb2d2db5..938bd436ac838 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableRightJoin.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableKTableRightJoin.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.streams.kstream.internals;
 
-import org.apache.kafka.streams.errors.StreamsException;
 import org.apache.kafka.streams.kstream.ValueJoiner;
 import org.apache.kafka.streams.processor.AbstractProcessor;
 import org.apache.kafka.streams.processor.Processor;
@@ -66,14 +65,12 @@ public void init(ProcessorContext context) {
             valueGetter.init(context);
         }
 
-        /**
-         * @throws StreamsException if key is null
-         */
         @Override
         public void process(final K key, final Change<V1> change) {
-            // the keys should never be null
-            if (key == null)
-                throw new StreamsException("Record key for KTable right-join operator should not be null.");
+            // we do join iff keys are equal, thus, if key is null we cannot join and just ignore the record
+            if (key == null) {
+                return;
+            }
 
             final R newValue;
             R oldValue = null;
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableSource.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableSource.java
index d3911515d7c08..93d9de7eb576b 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableSource.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KTableSource.java
@@ -17,7 +17,6 @@
 
 package org.apache.kafka.streams.kstream.internals;
 
-import org.apache.kafka.streams.errors.StreamsException;
 import org.apache.kafka.streams.processor.AbstractProcessor;
 import org.apache.kafka.streams.processor.Processor;
 import org.apache.kafka.streams.processor.ProcessorContext;
@@ -58,9 +57,9 @@ public void init(ProcessorContext context) {
 
         @Override
         public void process(K key, V value) {
-            // the keys should never be null
+            // if the key is null, then ignore the record
             if (key == null)
-                throw new StreamsException("Record key for the source KTable from store name " + storeName + " should not be null.");
+                return;
             V oldValue = store.get(key);
             store.put(key, value);
             tupleForwarder.maybeForward(key, value, oldValue);
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableJoinTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableJoinTest.java
index a938605ef4ef8..83cf96518f5d5 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableJoinTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableJoinTest.java
@@ -103,6 +103,8 @@ public void testJoin() throws Exception {
         for (int i = 0; i < 2; i++) {
             driver.process(topic1, expectedKeys[i], "X" + expectedKeys[i]);
         }
+        // pass tuple with null key, it will be discarded in join process
+        driver.process(topic1, null, "SomeVal");
         driver.flushState();
 
         processor.checkAndClearProcessResult();
@@ -112,6 +114,8 @@ public void testJoin() throws Exception {
         for (int i = 0; i < 2; i++) {
             driver.process(topic2, expectedKeys[i], "Y" + expectedKeys[i]);
         }
+        // pass tuple with null key, it will be discarded in join process
+        driver.process(topic2, null, "AnotherVal");
         driver.flushState();
 
         processor.checkAndClearProcessResult("0:X0+Y0", "1:X1+Y1");
@@ -165,6 +169,10 @@ public void testJoin() throws Exception {
 
         processor.checkAndClearProcessResult("2:XX2+YY2", "3:XX3+YY3");
         checkJoinedValues(getter, kv(2, "XX2+YY2"), kv(3, "XX3+YY3"));
+
+        driver.process(topic1, null, "XX" + 1);
+        checkJoinedValues(getter, kv(2, "XX2+YY2"), kv(3, "XX3+YY3"));
+
     }
 
     @Test
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableLeftJoinTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableLeftJoinTest.java
index 97900449aebf3..9483c6ba3ba1c 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableLeftJoinTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableLeftJoinTest.java
@@ -104,6 +104,8 @@ public void testJoin() throws Exception {
         for (int i = 0; i < 2; i++) {
             driver.process(topic1, expectedKeys[i], "X" + expectedKeys[i]);
         }
+        // pass tuple with null key, it will be discarded in join process
+        driver.process(topic1, null, "SomeVal");
         driver.flushState();
 
         processor.checkAndClearProcessResult("0:X0+null", "1:X1+null");
@@ -114,6 +116,8 @@ public void testJoin() throws Exception {
         for (int i = 0; i < 2; i++) {
             driver.process(topic2, expectedKeys[i], "Y" + expectedKeys[i]);
         }
+        // pass tuple with null key, it will be discarded in join process
+        driver.process(topic2, null, "AnotherVal");
         driver.flushState();
         processor.checkAndClearProcessResult("0:X0+Y0", "1:X1+Y1");
         checkJoinedValues(getter, kv(0, "X0+Y0"), kv(1, "X1+Y1"), kv(2, null), kv(3, null));
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableOuterJoinTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableOuterJoinTest.java
index 02e4e605a4991..65e5595de72dd 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableOuterJoinTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/KTableKTableOuterJoinTest.java
@@ -102,6 +102,8 @@ public void testJoin() throws Exception {
         for (int i = 0; i < 2; i++) {
             driver.process(topic1, expectedKeys[i], "X" + expectedKeys[i]);
         }
+        // pass tuple with null key, it will be discarded in join process
+        driver.process(topic1, null, "SomeVal");
         driver.flushState();
         processor.checkAndClearProcessResult("0:X0+null", "1:X1+null");
         checkJoinedValues(getter, kv(0, "X0+null"), kv(1, "X1+null"), kv(2, null), kv(3, null));
@@ -111,6 +113,8 @@ public void testJoin() throws Exception {
         for (int i = 0; i < 2; i++) {
             driver.process(topic2, expectedKeys[i], "Y" + expectedKeys[i]);
         }
+        // pass tuple with null key, it will be discarded in join process
+        driver.process(topic2, null, "AnotherVal");
         driver.flushState();
         processor.checkAndClearProcessResult("0:X0+Y0", "1:X1+Y1");
         checkJoinedValues(getter, kv(0, "X0+Y0"), kv(1, "X1+Y1"), kv(2, null), kv(3, null));

From 61024c9d2a2a1bc462a70d7c8af8ee7566716cc9 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Mon, 30 Jan 2017 16:32:31 -0800
Subject: [PATCH 080/177] KAFKA-4613: Follow-up to fix JavaDocs

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2468 from mjsax/kafka-4613-null-keys-follow-up

(cherry picked from commit e108a8b4ed4512b021f9326cf079517523c83060)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../kafka/streams/kstream/KStreamBuilder.java | 12 ++++++------
 .../apache/kafka/streams/kstream/KTable.java  | 19 ++++++++++++-------
 2 files changed, 18 insertions(+), 13 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java
index 7c64e6fc52e1a..28326892f6bf3 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java
@@ -238,7 +238,7 @@ public <K, V> KStream<K, V> stream(final AutoOffsetReset offsetReset,
      * Create a {@link KTable} for the specified topic.
      * The default {@code "auto.offset.reset"} strategy and default key and value deserializers as specified in the
      * {@link StreamsConfig config} are used.
-     * Input {@link KeyValue} pairs with {@code null} key will be dropped.
+     * Input {@link KeyValue records} with {@code null} key will be dropped.
      * <p>
      * Note that the specified input topics must be partitioned by key.
      * If this is not the case the returned {@link KTable} will be corrupted.
@@ -271,7 +271,7 @@ public <K, V> KTable<K, V> table(final String topic,
     /**
      * Create a {@link KTable} for the specified topic.
      * The default key and value deserializers as specified in the {@link StreamsConfig config} are used.
-     * Input {@link KeyValue} pairs with {@code null} key will be dropped.
+     * Input {@link KeyValue records} with {@code null} key will be dropped.
      * <p>
      * Note that the specified input topics must be partitioned by key.
      * If this is not the case the returned {@link KTable} will be corrupted.
@@ -307,7 +307,7 @@ public <K, V> KTable<K, V> table(final AutoOffsetReset offsetReset,
     /**
      * Create a {@link KTable} for the specified topic.
      * The default {@code "auto.offset.reset"} strategy as specified in the {@link StreamsConfig config} is used.
-     * Input {@link KeyValue} pairs with {@code null} key will be dropped.
+     * Input {@link KeyValue records} with {@code null} key will be dropped.
      * <p>
      * Note that the specified input topics must be partitioned by key.
      * If this is not the case the returned {@link KTable} will be corrupted.
@@ -345,7 +345,7 @@ public <K, V> KTable<K, V> table(final Serde<K> keySerde,
 
     /**
      * Create a {@link KTable} for the specified topic.
-     * Input {@link KeyValue} pairs with {@code null} key will be dropped.
+     * Input {@link KeyValue records} with {@code null} key will be dropped.
      * <p>
      * Note that the specified input topics must be partitioned by key.
      * If this is not the case the returned {@link KTable} will be corrupted.
@@ -409,7 +409,7 @@ public <K, V> KTable<K, V> table(final AutoOffsetReset offsetReset,
     /**
      * Create a {@link GlobalKTable} for the specified topic.
      * The default key and value deserializers as specified in the {@link StreamsConfig config} are used.
-     * Input {@link KeyValue} pairs cannot have a {@code null} key (otherwise an exception will be thrown).
+     * Input {@link KeyValue records} with {@code null} key will be dropped.
      * <p>
      * The resulting {@link GlobalKTable} will be materialized in a local {@link KeyValueStore} with the given
      * {@code storeName}.
@@ -439,7 +439,7 @@ public <K, V> GlobalKTable<K, V> globalTable(final String topic,
     /**
      * Create a {@link GlobalKTable} for the specified topic.
      * The default key and value deserializers as specified in the {@link StreamsConfig config} are used.
-     * Input {@link KeyValue} pairs cannot have a {@code null} key (otherwise an exception will be thrown).
+     * Input {@link KeyValue records} with {@code null} key will be dropped.
      * <p>
      * The resulting {@link GlobalKTable} will be materialized in a local {@link KeyValueStore} with the given
      * {@code storeName}.
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java
index 77f74a8854e58..9de2644b41a05 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java
@@ -530,8 +530,6 @@ void to(final Serde<K> keySerde,
      * If the key or value type is changed, it is recommended to use {@link #groupBy(KeyValueMapper, Serde, Serde)}
      * instead.
      *
-     * If the new record key is {@code null} the record will not be included in the resulting {@link KGroupedTable}.
-     *
      * @param selector a {@link KeyValueMapper} that computes a new grouping key and value to be aggregated
      * @param <KR>     the key type of the result {@link KGroupedTable}
      * @param <VR>     the value type of the result {@link KGroupedTable}
@@ -558,8 +556,6 @@ void to(final Serde<K> keySerde,
      * records to and rereading all update records from it, such that the resulting {@link KGroupedTable} is partitioned
      * on the new key.
      *
-     * If the new record key is {@code null} the record will not be included in the resulting {@link KGroupedTable}.
-     *
      * @param selector   a {@link KeyValueMapper} that computes a new grouping key and value to be aggregated
      * @param keySerde   key serdes for materializing this stream,
      *                   if not specified the default serdes defined in the configs will be used
@@ -588,9 +584,12 @@ <KR, VR> KGroupedTable<KR, VR> groupBy(final KeyValueMapper<? super K, ? super V
      * {@link ValueJoiner} will be called to compute a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
      * <p>
-     * Note that {@link KeyValue records} with {@code null} keys or values (so-called tombstone records) have delete semantics.
+     * Note that {@link KeyValue records} with {@code null} values (so-called tombstone records) have delete semantics.
      * Thus, for input tombstones the provided value-joiner is not called but a tombstone record is forwarded
      * directly to delete a record in the result {@code KTable} if required (i.e., if there is anything to be deleted).
+     * <p>
+     * Input records with {@code null} key will be dropped and no join computation is performed.
+     * <p>
      * Example:
      * <table border='1'>
      * <tr>
@@ -676,10 +675,13 @@ <VO, VR> KTable<K, VR> join(final KTable<K, VO> other,
      * null} to compute a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
      * <p>
-     * Note that {@link KeyValue records} with {@code null} keys or values (so-called tombstone records) have delete semantics.
+     * Note that {@link KeyValue records} with {@code null} values (so-called tombstone records) have delete semantics.
      * For example, for left input tombstones the provided value-joiner is not called but a tombstone record is
      * forwarded directly to delete a record in the result {@code KTable} if required (i.e., if there is anything to be
      * deleted).
+     * <p>
+     * Input records with {@code null} key will be dropped and no join computation is performed.
+     * <p>
      * Example:
      * <table border='1'>
      * <tr>
@@ -766,9 +768,12 @@ <VO, VR> KTable<K, VR> leftJoin(final KTable<K, VO> other,
      * corresponding other value to compute a value (with arbitrary type) for the result record.
      * The key of the result record is the same as for both joining input records.
      * <p>
-     * Note that {@link KeyValue records} with {@code null} keys or values (so-called tombstone records) have delete semantics.
+     * Note that {@link KeyValue records} with {@code null} values (so-called tombstone records) have delete semantics.
      * Thus, for input tombstones the provided value-joiner is not called but a tombstone record is forwarded directly
      * to delete a record in the result {@code KTable} if required (i.e., if there is anything to be deleted).
+     * <p>
+     * Input records with {@code null} key will be dropped and no join computation is performed.
+     * <p>
      * Example:
      * <table border='1'>
      * <tr>

From a5063521943f8d0f6940b18d4f0d57045aa395ae Mon Sep 17 00:00:00 2001
From: Jason Gustafson <jason@confluent.io>
Date: Tue, 31 Jan 2017 12:27:00 -0800
Subject: [PATCH 081/177] MINOR: Logging improvements in consumer internals

Author: Jason Gustafson <jason@confluent.io>

Reviewers: Manikumar reddy O <manikumar.reddy@gmail.com>, Ewen Cheslack-Postava <ewen@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2469 from hachikuji/improve-consumer-logging

(cherry picked from commit 5afe959647fcad9d01365427f4b455e1586b1fd5)
Signed-off-by: Jason Gustafson <jason@confluent.io>
---
 .../apache/kafka/clients/NetworkClient.java   |  9 ++++
 .../kafka/clients/consumer/KafkaConsumer.java |  8 ++--
 .../internals/AbstractCoordinator.java        | 33 +++++++++------
 .../internals/ConsumerCoordinator.java        | 41 +++++++++++--------
 .../internals/ConsumerNetworkClient.java      |  9 ++--
 .../clients/consumer/internals/Fetcher.java   |  5 ++-
 .../kafka/common/utils/KafkaThread.java       |  9 ++++
 .../clients/consumer/KafkaConsumerTest.java   |  2 -
 .../internals/ConsumerCoordinatorTest.java    | 30 +++++++-------
 9 files changed, 90 insertions(+), 56 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/NetworkClient.java b/clients/src/main/java/org/apache/kafka/clients/NetworkClient.java
index 0eb76704be853..3a7528822e7cc 100644
--- a/clients/src/main/java/org/apache/kafka/clients/NetworkClient.java
+++ b/clients/src/main/java/org/apache/kafka/clients/NetworkClient.java
@@ -427,14 +427,23 @@ public Node leastLoadedNode(long now) {
             int currInflight = this.inFlightRequests.inFlightRequestCount(node.idString());
             if (currInflight == 0 && this.connectionStates.isReady(node.idString())) {
                 // if we find an established connection with no in-flight requests we can stop right away
+                log.trace("Found least loaded node {} connected with no in-flight requests", node);
                 return node;
             } else if (!this.connectionStates.isBlackedOut(node.idString(), now) && currInflight < inflight) {
                 // otherwise if this is the best we have found so far, record that
                 inflight = currInflight;
                 found = node;
+            } else if (log.isTraceEnabled()) {
+                log.trace("Removing node {} from least loaded node selection: is-blacked-out: {}, in-flight-requests: {}",
+                        node, this.connectionStates.isBlackedOut(node.idString(), now), currInflight);
             }
         }
 
+        if (found != null)
+            log.trace("Found least loaded node {}", found);
+        else
+            log.trace("Least loaded node selection failed to find an available node");
+
         return found;
     }
 
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
index 6064c39c41948..ed3d6070ed574 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
@@ -78,8 +78,8 @@
  * <h3>Cross-Version Compatibility</h3>
  * This client can communicate with brokers that are version 0.10.0 or newer. Older or newer brokers may not support
  * certain features. For example, 0.10.0 brokers do not support offsetsForTimes, because this feature was added
- * in version 0.10.1. You will receive an UnsupportedVersionException when invoking an API that is not available on the
- * running broker version.
+ * in version 0.10.1. You will receive an {@link org.apache.kafka.common.errors.UnsupportedVersionException}
+ * when invoking an API that is not available on the running broker version.
  * <p>
  *
  * <h3>Offsets and Consumer Position</h3>
@@ -685,7 +685,6 @@ private KafkaConsumer(ConsumerConfig config,
                     metricGrpPrefix,
                     this.time,
                     retryBackoffMs,
-                    new ConsumerCoordinator.DefaultOffsetCommitCallback(),
                     config.getBoolean(ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG),
                     config.getInt(ConsumerConfig.AUTO_COMMIT_INTERVAL_MS_CONFIG),
                     this.interceptors,
@@ -1443,7 +1442,8 @@ public Set<TopicPartition> paused() {
      *         than or equal to the target timestamp. {@code null} will be returned for the partition if there is no
      *         such message.
      * @throws IllegalArgumentException if the target timestamp is negative.
-     * @throws UnsupportedVersionException if the broker does not support looking up the offsets by timestamp.
+     * @throws org.apache.kafka.common.errors.UnsupportedVersionException if the broker does not support looking up
+     *         the offsets by timestamp.
      */
     @Override
     public Map<TopicPartition, OffsetAndTimestamp> offsetsForTimes(Map<TopicPartition, Long> timestampsToSearch) {
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/AbstractCoordinator.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/AbstractCoordinator.java
index 7d77c0bcbd38a..6eea04573d759 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/AbstractCoordinator.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/AbstractCoordinator.java
@@ -43,6 +43,7 @@
 import org.apache.kafka.common.requests.OffsetCommitRequest;
 import org.apache.kafka.common.requests.SyncGroupRequest;
 import org.apache.kafka.common.requests.SyncGroupResponse;
+import org.apache.kafka.common.utils.KafkaThread;
 import org.apache.kafka.common.utils.Time;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -211,6 +212,7 @@ protected synchronized boolean ensureCoordinatorReady(long startTimeMs, long tim
                     if (remainingMs <= 0)
                         break;
 
+                    log.debug("Coordinator discovery failed for group {}, refreshing metadata", groupId);
                     client.awaitMetadataUpdate(remainingMs);
                 } else
                     throw future.exception();
@@ -236,6 +238,7 @@ protected synchronized RequestFuture<Void> lookupCoordinator() {
             if (node == null) {
                 // TODO: If there are no brokers left, perhaps we should use the bootstrap set
                 // from configuration?
+                log.debug("No broker available to send GroupCoordinator request for group {}", groupId);
                 return RequestFuture.noBrokersAvailable();
             } else
                 findCoordinatorFuture = sendGroupCoordinatorRequest(node);
@@ -419,7 +422,7 @@ private class JoinGroupResponseHandler extends CoordinatorResponseHandler<JoinGr
         public void handle(JoinGroupResponse joinResponse, RequestFuture<ByteBuffer> future) {
             Errors error = Errors.forCode(joinResponse.errorCode());
             if (error == Errors.NONE) {
-                log.debug("Received successful join group response for group {}: {}", groupId, joinResponse);
+                log.debug("Received successful JoinGroup response for group {}: {}", groupId, joinResponse);
                 sensors.joinLatency.record(response.requestLatencyMs());
 
                 synchronized (AbstractCoordinator.this) {
@@ -542,7 +545,7 @@ public void handle(SyncGroupResponse syncResponse,
      */
     private RequestFuture<Void> sendGroupCoordinatorRequest(Node node) {
         // initiate the group metadata request
-        log.debug("Sending coordinator request for group {} to broker {}", groupId, node);
+        log.debug("Sending GroupCoordinator request for group {} to broker {}", groupId, node);
         GroupCoordinatorRequest.Builder requestBuilder =
                 new GroupCoordinatorRequest.Builder(this.groupId);
         return client.send(node, requestBuilder)
@@ -553,7 +556,7 @@ private class GroupCoordinatorResponseHandler extends RequestFutureAdapter<Clien
 
         @Override
         public void onSuccess(ClientResponse resp, RequestFuture<Void> future) {
-            log.debug("Received group coordinator response {}", resp);
+            log.debug("Received GroupCoordinator response {} for group {}", resp, groupId);
 
             GroupCoordinatorResponse groupCoordinatorResponse = (GroupCoordinatorResponse) resp.responseBody();
             // use MAX_VALUE - node.id as the coordinator id to mimic separate connections
@@ -671,6 +674,7 @@ public synchronized void maybeLeaveGroup() {
         if (!coordinatorUnknown() && state != MemberState.UNJOINED && generation != Generation.NO_GENERATION) {
             // this is a minimal effort attempt to leave the group. we do not
             // attempt any resending if the request fails or times out.
+            log.debug("Sending LeaveGroup request to coordinator {} for group {}", coordinator, groupId);
             LeaveGroupRequest.Builder request =
                     new LeaveGroupRequest.Builder(groupId, generation.memberId);
             client.send(coordinator, request)
@@ -697,6 +701,7 @@ public void handle(LeaveGroupResponse leaveResponse, RequestFuture<Void> future)
 
     // visible for testing
     synchronized RequestFuture<Void> sendHeartbeatRequest() {
+        log.debug("Sending Heartbeat request for group {} to coordinator {}", groupId, coordinator);
         HeartbeatRequest.Builder requestBuilder =
                 new HeartbeatRequest.Builder(this.groupId, this.generation.generationId, this.generation.memberId);
         return client.send(coordinator, requestBuilder)
@@ -709,24 +714,24 @@ public void handle(HeartbeatResponse heartbeatResponse, RequestFuture<Void> futu
             sensors.heartbeatLatency.record(response.requestLatencyMs());
             Errors error = Errors.forCode(heartbeatResponse.errorCode());
             if (error == Errors.NONE) {
-                log.debug("Received successful heartbeat response for group {}", groupId);
+                log.debug("Received successful Heartbeat response for group {}", groupId);
                 future.complete(null);
             } else if (error == Errors.GROUP_COORDINATOR_NOT_AVAILABLE
                     || error == Errors.NOT_COORDINATOR_FOR_GROUP) {
-                log.debug("Attempt to heart beat failed for group {} since coordinator {} is either not started or not valid.",
+                log.debug("Attempt to heartbeat failed for group {} since coordinator {} is either not started or not valid.",
                         groupId, coordinator());
                 coordinatorDead();
                 future.raise(error);
             } else if (error == Errors.REBALANCE_IN_PROGRESS) {
-                log.debug("Attempt to heart beat failed for group {} since it is rebalancing.", groupId);
+                log.debug("Attempt to heartbeat failed for group {} since it is rebalancing.", groupId);
                 requestRejoin();
                 future.raise(Errors.REBALANCE_IN_PROGRESS);
             } else if (error == Errors.ILLEGAL_GENERATION) {
-                log.debug("Attempt to heart beat failed for group {} since generation id is not legal.", groupId);
+                log.debug("Attempt to heartbeat failed for group {} since generation id is not legal.", groupId);
                 resetGeneration();
                 future.raise(Errors.ILLEGAL_GENERATION);
             } else if (error == Errors.UNKNOWN_MEMBER_ID) {
-                log.debug("Attempt to heart beat failed for group {} since member id is not valid.", groupId);
+                log.debug("Attempt to heartbeat failed for group {} since member id is not valid.", groupId);
                 resetGeneration();
                 future.raise(Errors.UNKNOWN_MEMBER_ID);
             } else if (error == Errors.GROUP_AUTHORIZATION_FAILED) {
@@ -818,18 +823,18 @@ public double measure(MetricConfig config, long now) {
         }
     }
 
-    private class HeartbeatThread extends Thread {
+    private class HeartbeatThread extends KafkaThread {
         private boolean enabled = false;
         private boolean closed = false;
         private AtomicReference<RuntimeException> failed = new AtomicReference<>(null);
 
-        HeartbeatThread() {
-            super("kafka-coordinator-heartbeat-thread" + (groupId.isEmpty() ? "" : " | " + groupId));
-            setDaemon(true);
+        private HeartbeatThread() {
+            super("kafka-coordinator-heartbeat-thread" + (groupId.isEmpty() ? "" : " | " + groupId), true);
         }
 
         public void enable() {
             synchronized (AbstractCoordinator.this) {
+                log.trace("Enabling heartbeat thread for group {}", groupId);
                 this.enabled = true;
                 heartbeat.resetTimeouts(time.milliseconds());
                 AbstractCoordinator.this.notify();
@@ -838,6 +843,7 @@ public void enable() {
 
         public void disable() {
             synchronized (AbstractCoordinator.this) {
+                log.trace("Disabling heartbeat thread for group {}", groupId);
                 this.enabled = false;
             }
         }
@@ -860,6 +866,7 @@ private RuntimeException failureCause() {
         @Override
         public void run() {
             try {
+                log.debug("Heartbeat thread for group {} started", groupId);
                 while (true) {
                     synchronized (AbstractCoordinator.this) {
                         if (closed)
@@ -936,6 +943,8 @@ public void onFailure(RuntimeException e) {
             } catch (RuntimeException e) {
                 log.error("Heartbeat thread for group {} failed due to unexpected error" , groupId, e);
                 this.failed.set(e);
+            } finally {
+                log.debug("Heartbeat thread for group {} has closed", groupId);
             }
         }
 
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java
index 03b767a4cd8a2..8669527cd2024 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java
@@ -100,7 +100,6 @@ public ConsumerCoordinator(ConsumerNetworkClient client,
                                String metricGrpPrefix,
                                Time time,
                                long retryBackoffMs,
-                               OffsetCommitCallback defaultOffsetCommitCallback,
                                boolean autoCommitEnabled,
                                int autoCommitIntervalMs,
                                ConsumerInterceptors<?, ?> interceptors,
@@ -117,7 +116,7 @@ public ConsumerCoordinator(ConsumerNetworkClient client,
         this.metadata = metadata;
         this.metadataSnapshot = new MetadataSnapshot(subscriptions, metadata.fetch());
         this.subscriptions = subscriptions;
-        this.defaultOffsetCommitCallback = defaultOffsetCommitCallback;
+        this.defaultOffsetCommitCallback = new DefaultOffsetCommitCallback();
         this.autoCommitEnabled = autoCommitEnabled;
         this.autoCommitIntervalMs = autoCommitIntervalMs;
         this.assignors = assignors;
@@ -355,13 +354,15 @@ protected Map<String, ByteBuffer> performAssignment(String leaderId,
         if (!assignedTopics.containsAll(allSubscribedTopics)) {
             Set<String> notAssignedTopics = new HashSet<>(allSubscribedTopics);
             notAssignedTopics.removeAll(assignedTopics);
-            log.warn("The following subscribed topics are not assigned to any members in the group {} : {} ", groupId, notAssignedTopics);
+            log.warn("The following subscribed topics are not assigned to any members in the group {} : {} ", groupId,
+                    notAssignedTopics);
         }
 
         if (!allSubscribedTopics.containsAll(assignedTopics)) {
             Set<String> newlyAddedTopics = new HashSet<>(assignedTopics);
             newlyAddedTopics.removeAll(allSubscribedTopics);
-            log.info("The following not-subscribed topics are assigned to group {}, and their metadata will be fetched from the brokers : {}", groupId, newlyAddedTopics);
+            log.info("The following not-subscribed topics are assigned to group {}, and their metadata will be " +
+                    "fetched from the brokers : {}", groupId, newlyAddedTopics);
 
             allSubscribedTopics.addAll(assignedTopics);
             this.subscriptions.groupSubscribe(allSubscribedTopics);
@@ -487,7 +488,6 @@ void invokeCompletedOffsetCommitCallbacks() {
         }
     }
 
-
     public void commitOffsetsAsync(final Map<TopicPartition, OffsetAndMetadata> offsets, final OffsetCommitCallback callback) {
         invokeCompletedOffsetCommitCallbacks();
 
@@ -612,15 +612,19 @@ public void maybeAutoCommitOffsetsNow() {
     }
 
     private void doAutoCommitOffsetsAsync() {
-        commitOffsetsAsync(subscriptions.allConsumed(), new OffsetCommitCallback() {
+        Map<TopicPartition, OffsetAndMetadata> allConsumedOffsets = subscriptions.allConsumed();
+        log.debug("Sending asynchronous auto-commit of offsets {} for group {}", allConsumedOffsets, groupId);
+
+        commitOffsetsAsync(allConsumedOffsets, new OffsetCommitCallback() {
             @Override
             public void onComplete(Map<TopicPartition, OffsetAndMetadata> offsets, Exception exception) {
                 if (exception != null) {
-                    log.warn("Auto offset commit failed for group {}: {}", groupId, exception.getMessage());
+                    log.warn("Auto-commit of offsets {} failed for group {}: {}", offsets, groupId,
+                            exception.getMessage());
                     if (exception instanceof RetriableException)
                         nextAutoCommitDeadline = Math.min(time.milliseconds() + retryBackoffMs, nextAutoCommitDeadline);
                 } else {
-                    log.debug("Completed autocommit of offsets {} for group {}", offsets, groupId);
+                    log.debug("Completed auto-commit of offsets {} for group {}", offsets, groupId);
                 }
             }
         });
@@ -628,25 +632,30 @@ public void onComplete(Map<TopicPartition, OffsetAndMetadata> offsets, Exception
 
     private void maybeAutoCommitOffsetsSync(long timeoutMs) {
         if (autoCommitEnabled) {
+            Map<TopicPartition, OffsetAndMetadata> allConsumedOffsets = subscriptions.allConsumed();
             try {
-                if (!commitOffsetsSync(subscriptions.allConsumed(), timeoutMs))
-                    log.debug("Automatic commit of offsets {} for group {} timed out before completion", subscriptions.allConsumed(), groupId);
+                log.debug("Sending synchronous auto-commit of offsets {} for group {}", allConsumedOffsets, groupId);
+                if (!commitOffsetsSync(allConsumedOffsets, timeoutMs))
+                    log.debug("Auto-commit of offsets {} for group {} timed out before completion",
+                            allConsumedOffsets, groupId);
             } catch (WakeupException | InterruptException e) {
-                log.debug("Automatic commit of offsets {} for group {} was interrupted before completion", subscriptions.allConsumed(), groupId);
+                log.debug("Auto-commit of offsets {} for group {} was interrupted before completion",
+                        allConsumedOffsets, groupId);
                 // rethrow wakeups since they are triggered by the user
                 throw e;
             } catch (Exception e) {
                 // consistent with async auto-commit failures, we do not propagate the exception
-                log.warn("Auto offset commit failed for group {}: {}", groupId, e.getMessage());
+                log.warn("Auto-commit of offsets {} failed for group {}: {}", allConsumedOffsets, groupId,
+                        e.getMessage());
             }
         }
     }
 
-    public static class DefaultOffsetCommitCallback implements OffsetCommitCallback {
+    private class DefaultOffsetCommitCallback implements OffsetCommitCallback {
         @Override
         public void onComplete(Map<TopicPartition, OffsetAndMetadata> offsets, Exception exception) {
             if (exception != null)
-                log.error("Offset commit failed.", exception);
+                log.error("Offset commit with offsets {} failed for group {}", offsets, groupId, exception);
         }
     }
 
@@ -694,7 +703,7 @@ private RequestFuture<Void> sendOffsetCommitRequest(final Map<TopicPartition, Of
                         setMemberId(generation.memberId).
                         setRetentionTime(OffsetCommitRequest.DEFAULT_RETENTION_TIME);
 
-        log.trace("Sending offset-commit request with {} to coordinator {} for group {}", offsets, coordinator, groupId);
+        log.trace("Sending OffsetCommit request with {} to coordinator {} for group {}", offsets, coordinator, groupId);
 
         return client.send(coordinator, builder)
                 .compose(new OffsetCommitResponseHandler(offsets));
@@ -704,7 +713,7 @@ private class OffsetCommitResponseHandler extends CoordinatorResponseHandler<Off
 
         private final Map<TopicPartition, OffsetAndMetadata> offsets;
 
-        public OffsetCommitResponseHandler(Map<TopicPartition, OffsetAndMetadata> offsets) {
+        private OffsetCommitResponseHandler(Map<TopicPartition, OffsetAndMetadata> offsets) {
             this.offsets = offsets;
         }
 
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerNetworkClient.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerNetworkClient.java
index ea92ab76d4b15..e5c5cf67daffd 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerNetworkClient.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerNetworkClient.java
@@ -90,8 +90,7 @@ public ConsumerNetworkClient(KafkaClient client,
      * @param requestBuilder A builder for the request payload
      * @return A future which indicates the result of the send.
      */
-    public RequestFuture<ClientResponse> send(Node node,
-                                              AbstractRequest.Builder<?> requestBuilder) {
+    public RequestFuture<ClientResponse> send(Node node, AbstractRequest.Builder<?> requestBuilder) {
         long now = time.milliseconds();
         RequestFutureCompletionHandler completionHandler = new RequestFutureCompletionHandler();
         ClientRequest clientRequest = client.newClientRequest(node.idString(), requestBuilder, now, true,
@@ -157,6 +156,7 @@ public void ensureFreshMetadata() {
     public void wakeup() {
         // wakeup should be safe without holding the client lock since it simply delegates to
         // Selector's wakeup, which is threadsafe
+        log.trace("Received user wakeup");
         this.wakeup.set(true);
         this.client.wakeup();
     }
@@ -406,6 +406,7 @@ private boolean trySend(long now) {
 
     private void maybeTriggerWakeup() {
         if (wakeupDisabledCount == 0 && wakeup.get()) {
+            log.trace("Raising wakeup exception in response to user wakeup");
             wakeup.set(false);
             throw new WakeupException();
         }
@@ -446,7 +447,7 @@ public void close() throws IOException {
 
     /**
      * Find whether a previous connection has failed. Note that the failure state will persist until either
-     * {@link #tryConnect(Node)} or {@link #send(Node, ApiKeys, AbstractRequest)} has been called.
+     * {@link #tryConnect(Node)} or {@link #send(Node, AbstractRequest.Builder)} has been called.
      * @param node Node to connect to if possible
      */
     public boolean connectionFailed(Node node) {
@@ -457,7 +458,7 @@ public boolean connectionFailed(Node node) {
 
     /**
      * Initiate a connection if currently possible. This is only really useful for resetting the failed
-     * status of a socket. If there is an actual request to send, then {@link #send(Node, ApiKeys, AbstractRequest)}
+     * status of a socket. If there is an actual request to send, then {@link #send(Node, AbstractRequest.Builder)}
      * should be used.
      * @param node The node to connect to
      */
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
index d4ecfc6a93ff4..6a13d46068650 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
@@ -177,6 +177,7 @@ public int sendFetches() {
             final FetchRequest.Builder request = fetchEntry.getValue();
             final Node fetchTarget = fetchEntry.getKey();
 
+            log.debug("Sending fetch for partitions {} to broker {}", request.fetchData().keySet(), fetchTarget);
             client.send(fetchTarget, request)
                     .addListener(new RequestFutureListener<ClientResponse>() {
                         @Override
@@ -208,7 +209,7 @@ public void onSuccess(ClientResponse resp) {
 
                         @Override
                         public void onFailure(RuntimeException e) {
-                            log.debug("Fetch request to {} failed", fetchTarget, e);
+                            log.debug("Fetch request to {} for partitions {} failed", fetchTarget, request.fetchData().keySet(), e);
                         }
                     });
         }
@@ -722,7 +723,7 @@ private Map<Node, FetchRequest.Builder> createFetchRequests() {
 
                 long position = this.subscriptions.position(partition);
                 fetch.put(partition, new FetchRequest.PartitionData(position, this.fetchSize));
-                log.trace("Added fetch request for partition {} at offset {}", partition, position);
+                log.trace("Added fetch request for partition {} at offset {} to node {}", partition, position, node);
             } else {
                 log.trace("Skipping fetch for partition {} because there is an in-flight request to {}", partition, node);
             }
diff --git a/clients/src/main/java/org/apache/kafka/common/utils/KafkaThread.java b/clients/src/main/java/org/apache/kafka/common/utils/KafkaThread.java
index 57247c85ba13b..faca68574fb4c 100644
--- a/clients/src/main/java/org/apache/kafka/common/utils/KafkaThread.java
+++ b/clients/src/main/java/org/apache/kafka/common/utils/KafkaThread.java
@@ -22,8 +22,17 @@ public class KafkaThread extends Thread {
 
     private final Logger log = LoggerFactory.getLogger(getClass());
 
+    public KafkaThread(final String name, boolean daemon) {
+        super(name);
+        configureThread(name, daemon);
+    }
+
     public KafkaThread(final String name, Runnable runnable, boolean daemon) {
         super(runnable, name);
+        configureThread(name, daemon);
+    }
+
+    private void configureThread(final String name, boolean daemon) {
         setDaemon(daemon);
         setUncaughtExceptionHandler(new Thread.UncaughtExceptionHandler() {
             public void uncaughtException(Thread t, Throwable e) {
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
index 8346e932fd840..4aaa17230f957 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
@@ -1486,7 +1486,6 @@ private KafkaConsumer<String, String> newConsumer(Time time,
         Deserializer<String> valueDeserializer = new StringDeserializer();
 
         OffsetResetStrategy autoResetStrategy = OffsetResetStrategy.EARLIEST;
-        OffsetCommitCallback defaultCommitCallback = new ConsumerCoordinator.DefaultOffsetCommitCallback();
         List<PartitionAssignor> assignors = Arrays.asList(assignor);
         ConsumerInterceptors<String, String> interceptors = null;
 
@@ -1506,7 +1505,6 @@ private KafkaConsumer<String, String> newConsumer(Time time,
                 metricGroupPrefix,
                 time,
                 retryBackoffMs,
-                defaultCommitCallback,
                 autoCommitEnabled,
                 autoCommitIntervalMs,
                 interceptors,
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java
index e13d49faccbaa..e11bf304efad8 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java
@@ -112,10 +112,9 @@ public class ConsumerCoordinatorTest {
     private Metrics metrics;
     private ConsumerNetworkClient consumerClient;
     private MockRebalanceListener rebalanceListener;
-    private MockCommitCallback defaultOffsetCommitCallback;
+    private MockCommitCallback mockOffsetCommitCallback;
     private ConsumerCoordinator coordinator;
 
-
     @Before
     public void setup() {
         this.time = new MockTime();
@@ -126,7 +125,7 @@ public void setup() {
         this.consumerClient = new ConsumerNetworkClient(client, metadata, time, 100, 1000);
         this.metrics = new Metrics(time);
         this.rebalanceListener = new MockRebalanceListener();
-        this.defaultOffsetCommitCallback = new MockCommitCallback();
+        this.mockOffsetCommitCallback = new MockCommitCallback();
         this.partitionAssignor.clear();
 
         client.setNode(node);
@@ -1010,14 +1009,14 @@ public void testCommitOffsetMetadata() {
 
     @Test
     public void testCommitOffsetAsyncWithDefaultCallback() {
-        int invokedBeforeTest = defaultOffsetCommitCallback.invoked;
+        int invokedBeforeTest = mockOffsetCommitCallback.invoked;
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
         client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.NONE.code())));
-        coordinator.commitOffsetsAsync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L)), null);
+        coordinator.commitOffsetsAsync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L)), mockOffsetCommitCallback);
         coordinator.invokeCompletedOffsetCommitCallbacks();
-        assertEquals(invokedBeforeTest + 1, defaultOffsetCommitCallback.invoked);
-        assertNull(defaultOffsetCommitCallback.exception);
+        assertEquals(invokedBeforeTest + 1, mockOffsetCommitCallback.invoked);
+        assertNull(mockOffsetCommitCallback.exception);
     }
 
     @Test
@@ -1059,14 +1058,14 @@ public boolean matches(AbstractRequest body) {
 
     @Test
     public void testCommitOffsetAsyncFailedWithDefaultCallback() {
-        int invokedBeforeTest = defaultOffsetCommitCallback.invoked;
+        int invokedBeforeTest = mockOffsetCommitCallback.invoked;
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
         client.prepareResponse(offsetCommitResponse(Collections.singletonMap(t1p, Errors.GROUP_COORDINATOR_NOT_AVAILABLE.code())));
-        coordinator.commitOffsetsAsync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L)), null);
+        coordinator.commitOffsetsAsync(Collections.singletonMap(t1p, new OffsetAndMetadata(100L)), mockOffsetCommitCallback);
         coordinator.invokeCompletedOffsetCommitCallbacks();
-        assertEquals(invokedBeforeTest + 1, defaultOffsetCommitCallback.invoked);
-        assertTrue(defaultOffsetCommitCallback.exception instanceof RetriableCommitFailedException);
+        assertEquals(invokedBeforeTest + 1, mockOffsetCommitCallback.invoked);
+        assertTrue(mockOffsetCommitCallback.exception instanceof RetriableCommitFailedException);
     }
 
     @Test
@@ -1220,12 +1219,12 @@ public void testCommitSyncNegativeOffset() {
 
     @Test
     public void testCommitAsyncNegativeOffset() {
-        int invokedBeforeTest = defaultOffsetCommitCallback.invoked;
+        int invokedBeforeTest = mockOffsetCommitCallback.invoked;
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
-        coordinator.commitOffsetsAsync(Collections.singletonMap(t1p, new OffsetAndMetadata(-1L)), null);
+        coordinator.commitOffsetsAsync(Collections.singletonMap(t1p, new OffsetAndMetadata(-1L)), mockOffsetCommitCallback);
         coordinator.invokeCompletedOffsetCommitCallbacks();
-        assertEquals(invokedBeforeTest + 1, defaultOffsetCommitCallback.invoked);
-        assertTrue(defaultOffsetCommitCallback.exception instanceof IllegalArgumentException);
+        assertEquals(invokedBeforeTest + 1, mockOffsetCommitCallback.invoked);
+        assertTrue(mockOffsetCommitCallback.exception instanceof IllegalArgumentException);
     }
 
     @Test
@@ -1531,7 +1530,6 @@ private ConsumerCoordinator buildCoordinator(Metrics metrics,
                 "consumer" + groupId,
                 time,
                 retryBackoffMs,
-                defaultOffsetCommitCallback,
                 autoCommitEnabled,
                 autoCommitIntervalMs,
                 null,

From 54512cbaf7b624103cb1ad43bec455bbb0709c55 Mon Sep 17 00:00:00 2001
From: Ewen Cheslack-Postava <me@ewencp.org>
Date: Tue, 31 Jan 2017 16:06:10 -0800
Subject: [PATCH 082/177] KAFKA-4717: Use absolute paths to files in root
 directory so all jars include LICENSE and NOTICE files

Author: Ewen Cheslack-Postava <me@ewencp.org>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2473 from ewencp/kafka-4717-connect-license-and-notice-files

(cherry picked from commit 82744414d50d28a7bf7b0084118b68a4411c5781)
Signed-off-by: Ewen Cheslack-Postava <me@ewencp.org>
---
 build.gradle | 42 +++++++++++++++++++++---------------------
 1 file changed, 21 insertions(+), 21 deletions(-)

diff --git a/build.gradle b/build.gradle
index 7a34c25d6d3b4..32ce14a8249ed 100644
--- a/build.gradle
+++ b/build.gradle
@@ -177,21 +177,21 @@ subprojects {
   }
 
   jar {
-    from '../LICENSE'
-    from '../NOTICE'
+    from "$rootDir/LICENSE"
+    from "$rootDir/NOTICE"
   }
 
   task srcJar(type: Jar) {
     classifier = 'sources'
-    from '../LICENSE'
-    from '../NOTICE'
+    from "$rootDir/LICENSE"
+    from "$rootDir/NOTICE"
     from sourceSets.main.allSource
   }
 
   task javadocJar(type: Jar, dependsOn: javadoc) {
     classifier 'javadoc'
-    from '../LICENSE'
-    from '../NOTICE'
+    from "$rootDir/LICENSE"
+    from "$rootDir/NOTICE"
     from javadoc.destinationDir
   }
 
@@ -213,15 +213,15 @@ subprojects {
   if(!sourceSets.test.allSource.isEmpty()) {
     task testJar(type: Jar) {
       classifier = 'test'
-      from '../LICENSE'
-      from '../NOTICE'
+      from "$rootDir/LICENSE"
+      from "$rootDir/NOTICE"
       from sourceSets.test.output
     }
 
     task testSrcJar(type: Jar, dependsOn: testJar) {
       classifier = 'test-sources'
-      from '../LICENSE'
-      from '../NOTICE'
+      from "$rootDir/LICENSE"
+      from "$rootDir/NOTICE"
       from sourceSets.test.allSource
     }
 
@@ -234,8 +234,8 @@ subprojects {
   plugins.withType(ScalaPlugin) {
     task scaladocJar(type:Jar) {
       classifier = 'scaladoc'
-      from '../LICENSE'
-      from '../NOTICE'
+      from "$rootDir/LICENSE"
+      from "$rootDir/NOTICE"
       from scaladoc.destinationDir
     }
 
@@ -511,7 +511,7 @@ project(':core') {
                                ':streams:genStreamsConfigDocs'], type: Tar) {
     classifier = 'site-docs'
     compression = Compression.GZIP
-    from project.file("../docs")
+    from project.file("$rootDir/docs")
     into 'site-docs'
     duplicatesStrategy 'exclude'
   }
@@ -519,10 +519,10 @@ project(':core') {
   tasks.create(name: "releaseTarGz", dependsOn: configurations.archives.artifacts, type: Tar) {
     into "kafka_${versions.baseScala}-${version}"
     compression = Compression.GZIP
-    from(project.file("../bin")) { into "bin/" }
-    from(project.file("../config")) { into "config/" }
-    from '../LICENSE'
-    from '../NOTICE'
+    from(project.file("$rootDir/bin")) { into "bin/" }
+    from(project.file("$rootDir/config")) { into "config/" }
+    from "$rootDir/LICENSE"
+    from "$rootDir/NOTICE"
     from(configurations.runtime) { into("libs/") }
     from(configurations.archives.artifacts.files) { into("libs/") }
     from(project.siteDocsTar) { into("site-docs/") }
@@ -606,12 +606,12 @@ project(':clients') {
   task determineCommitId {
     ext.commitId = "unknown"
     def takeFromHash = 16
-    if (file("../.git/HEAD").exists()) {
-      def headRef = file("../.git/HEAD").text
+    if (file("$rootDir/.git/HEAD").exists()) {
+      def headRef = file("$rootDir/.git/HEAD").text
       if (headRef.contains('ref: ')) {
         headRef = headRef.replaceAll('ref: ', '').trim()
-        if (file("../.git/$headRef").exists()) {
-        commitId = file("../.git/$headRef").text.trim().take(takeFromHash)
+        if (file("$rootDir/.git/$headRef").exists()) {
+        commitId = file("$rootDir/.git/$headRef").text.trim().take(takeFromHash)
         }
       } else {
         commitId = headRef.trim().take(takeFromHash)

From 9cf6f9790abea84681285b17da1c5abd0c314915 Mon Sep 17 00:00:00 2001
From: Ewen Cheslack-Postava <me@ewencp.org>
Date: Wed, 1 Feb 2017 10:25:24 -0800
Subject: [PATCH 083/177] MINOR: Update docs for version 0.10.2.0

Author: Ewen Cheslack-Postava <me@ewencp.org>

Reviewers: Jason Gustafson <jason@confluent.io>

Closes #2480 from ewencp/docs-version-0.10.2.0

(cherry picked from commit cea46135338150e409e140b8b96856e060be8780)
Signed-off-by: Jason Gustafson <jason@confluent.io>
---
 docs/api.html           | 14 +++++++-------
 docs/documentation.html |  4 ++--
 docs/quickstart.html    |  8 ++++----
 3 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/docs/api.html b/docs/api.html
index 20c3642d00e9e..9b9cd96211ca8 100644
--- a/docs/api.html
+++ b/docs/api.html
@@ -31,7 +31,7 @@ <h3><a id="producerapi" href="#producerapi">2.1 Producer API</a></h3>
 	The Producer API allows applications to send streams of data to topics in the Kafka cluster.
 	<p>
 	Examples showing how to use the producer are given in the
-	<a href="/{{version}}/javadoc/index.html?org/apache/kafka/clients/producer/KafkaProducer.html" title="Kafka 0.10.0 Javadoc">javadocs</a>.
+	<a href="/{{version}}/javadoc/index.html?org/apache/kafka/clients/producer/KafkaProducer.html" title="Kafka 0.10.2 Javadoc">javadocs</a>.
 	<p>
 	To use the producer, you can use the following maven dependency:
 
@@ -39,7 +39,7 @@ <h3><a id="producerapi" href="#producerapi">2.1 Producer API</a></h3>
 		&lt;dependency&gt;
 			&lt;groupId&gt;org.apache.kafka&lt;/groupId&gt;
 			&lt;artifactId&gt;kafka-clients&lt;/artifactId&gt;
-			&lt;version&gt;0.10.0.0&lt;/version&gt;
+			&lt;version&gt;0.10.2.0&lt;/version&gt;
 		&lt;/dependency&gt;
 	</pre>
 
@@ -48,14 +48,14 @@ <h3><a id="consumerapi" href="#consumerapi">2.2 Consumer API</a></h3>
 	The Consumer API allows applications to read streams of data from topics in the Kafka cluster.
 	<p>
 	Examples showing how to use the consumer are given in the
-	<a href="/{{version}}/javadoc/index.html?org/apache/kafka/clients/consumer/KafkaConsumer.html" title="Kafka 0.10.0 Javadoc">javadocs</a>.
+	<a href="/{{version}}/javadoc/index.html?org/apache/kafka/clients/consumer/KafkaConsumer.html" title="Kafka 0.10.2 Javadoc">javadocs</a>.
 	<p>
 	To use the consumer, you can use the following maven dependency:
 	<pre>
 		&lt;dependency&gt;
 			&lt;groupId&gt;org.apache.kafka&lt;/groupId&gt;
 			&lt;artifactId&gt;kafka-clients&lt;/artifactId&gt;
-			&lt;version&gt;0.10.0.0&lt;/version&gt;
+			&lt;version&gt;0.10.2.0&lt;/version&gt;
 		&lt;/dependency&gt;
 	</pre>
 
@@ -64,7 +64,7 @@ <h3><a id="streamsapi" href="#streamsapi">2.3 Streams API</a></h3>
 	The <a href="#streamsapi">Streams</a> API allows transforming streams of data from input topics to output topics.
 	<p>
 	Examples showing how to use this library are given in the
-	<a href="/{{version}}/javadoc/index.html?org/apache/kafka/streams/KafkaStreams.html" title="Kafka 0.10.0 Javadoc">javadocs</a>
+	<a href="/{{version}}/javadoc/index.html?org/apache/kafka/streams/KafkaStreams.html" title="Kafka 0.10.2 Javadoc">javadocs</a>
 	<p>
 	Additional documentation on using the Streams API is available <a href="/documentation.html#streams">here</a>.
 	<p>
@@ -74,7 +74,7 @@ <h3><a id="streamsapi" href="#streamsapi">2.3 Streams API</a></h3>
 		&lt;dependency&gt;
 			&lt;groupId&gt;org.apache.kafka&lt;/groupId&gt;
 			&lt;artifactId&gt;kafka-streams&lt;/artifactId&gt;
-			&lt;version&gt;0.10.0.0&lt;/version&gt;
+			&lt;version&gt;0.10.2.0&lt;/version&gt;
 		&lt;/dependency&gt;
 	</pre>
 
@@ -84,7 +84,7 @@ <h3><a id="connectapi" href="#connectapi">2.4 Connect API</a></h3>
 	<p>
 	Many users of Connect won't need to use this API directly, though, they can use pre-built connectors without needing to write any code. Additional information on using Connect is available <a href="/documentation.html#connect">here</a>.
 	<p>
-	Those who want to implement custom connectors can see the <a href="/{{version}}/javadoc/index.html?org/apache/kafka/connect" title="Kafka 0.10.0 Javadoc">javadoc</a>.
+	Those who want to implement custom connectors can see the <a href="/{{version}}/javadoc/index.html?org/apache/kafka/connect" title="Kafka 0.10.2 Javadoc">javadoc</a>.
 	<p>
 
 	<h3><a id="legacyapis" href="#streamsapi">2.5 Legacy APIs</a></h3>
diff --git a/docs/documentation.html b/docs/documentation.html
index e8516f909e40c..626998437aa0c 100644
--- a/docs/documentation.html
+++ b/docs/documentation.html
@@ -25,8 +25,8 @@
 	<div class="right">
 		<!--#include virtual="../includes/_docs_banner.htm" -->
     <h1>Documentation</h1>
-    <h3>Kafka 0.10.0 Documentation</h3>
-    Prior releases: <a href="/07/documentation.html">0.7.x</a>, <a href="/08/documentation.html">0.8.0</a>, <a href="/081/documentation.html">0.8.1.X</a>, <a href="/082/documentation.html">0.8.2.X</a>, <a href="/090/documentation.html">0.9.0.X</a>.
+    <h3>Kafka 0.10.2 Documentation</h3>
+    Prior releases: <a href="/07/documentation.html">0.7.x</a>, <a href="/08/documentation.html">0.8.0</a>, <a href="/081/documentation.html">0.8.1.X</a>, <a href="/082/documentation.html">0.8.2.X</a>, <a href="/090/documentation.html">0.9.0.X</a>, <a href="/0100/documentation.html">0.10.0.X</a>, <a href="/0101/documentation.html">0.10.1.X</a>.
     </ul>
 
     <ul class="toc">
diff --git a/docs/quickstart.html b/docs/quickstart.html
index c8f01d49c51e5..763d3e36ff01e 100644
--- a/docs/quickstart.html
+++ b/docs/quickstart.html
@@ -22,11 +22,11 @@
 
 <h4><a id="quickstart_download" href="#quickstart_download">Step 1: Download the code</a></h4>
 
-<a href="https://www.apache.org/dyn/closer.cgi?path=/kafka/0.10.0.1/kafka_2.11-0.10.0.1.tgz" title="Kafka downloads">Download</a> the 0.10.0.1 release and un-tar it.
+<a href="https://www.apache.org/dyn/closer.cgi?path=/kafka/0.10.2.0/kafka_2.11-0.10.2.0.tgz" title="Kafka downloads">Download</a> the 0.10.2.0 release and un-tar it.
 
 <pre>
-&gt; <b>tar -xzf kafka_2.11-0.10.0.1.tgz</b>
-&gt; <b>cd kafka_2.11-0.10.0.1</b>
+&gt; <b>tar -xzf kafka_2.11-0.10.2.0.tgz</b>
+&gt; <b>cd kafka_2.11-0.10.2.0</b>
 </pre>
 
 <h4><a id="quickstart_startserver" href="#quickstart_startserver">Step 2: Start the server</a></h4>
@@ -184,7 +184,7 @@ <h4><a id="quickstart_multibroker" href="#quickstart_multibroker">Step 6: Settin
 On Windows use:
 <pre>
 &gt; <b>wmic process get processid,caption,commandline | find "java.exe" | find "server-1.properties"</b>
-java.exe    java  -Xmx1G -Xms1G -server -XX:+UseG1GC ... build\libs\kafka_2.10-0.10.1.0.jar"  kafka.Kafka config\server-1.properties    <i>644</i>
+java.exe    java  -Xmx1G -Xms1G -server -XX:+UseG1GC ... build\libs\kafka_2.10-0.10.2.0.jar"  kafka.Kafka config\server-1.properties    <i>644</i>
 &gt; <b>taskkill /pid 644 /f</b>
 </pre>
 

From dfd34aeb29d73551a6c91a65aeeadd85b79508a7 Mon Sep 17 00:00:00 2001
From: Guozhang Wang <wangguoz@gmail.com>
Date: Thu, 2 Feb 2017 10:35:58 -0800
Subject: [PATCH 084/177] MINOR: Update Streams docs: quickstart and concepts

Added figures for topology and table-stream duality; added sections about aggregations; misc code fixes.

Author: Guozhang Wang <wangguoz@gmail.com>

Reviewers: Damian Guy, Sriram Subramanian

Closes #2482 from guozhangwang/KMinor-streams-docs-first-pass

(cherry picked from commit c8baf28545984ef8c88d43899004224c6ef54013)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 docs/images/streams-concepts-topology.jpg | Bin 0 -> 136983 bytes
 docs/images/streams-table-duality-01.png  | Bin 0 -> 14534 bytes
 docs/images/streams-table-duality-02.png  | Bin 0 -> 56736 bytes
 docs/images/streams-table-duality-03.png  | Bin 0 -> 91331 bytes
 docs/images/streams-table-updates-01.png  | Bin 0 -> 78069 bytes
 docs/images/streams-table-updates-02.png  | Bin 0 -> 91880 bytes
 docs/js/templateData.js                   |   1 +
 docs/quickstart.html                      |  61 +++++--
 docs/streams.html                         | 189 +++++++++++++++-------
 9 files changed, 181 insertions(+), 70 deletions(-)
 create mode 100644 docs/images/streams-concepts-topology.jpg
 create mode 100644 docs/images/streams-table-duality-01.png
 create mode 100644 docs/images/streams-table-duality-02.png
 create mode 100644 docs/images/streams-table-duality-03.png
 create mode 100644 docs/images/streams-table-updates-01.png
 create mode 100644 docs/images/streams-table-updates-02.png

diff --git a/docs/images/streams-concepts-topology.jpg b/docs/images/streams-concepts-topology.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..832f6d43a4235c53ae745e6c0ae6d62d311e24f3
GIT binary patch
literal 136983
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
E08e7LE&u=k

literal 0
HcmV?d00001

diff --git a/docs/images/streams-table-duality-01.png b/docs/images/streams-table-duality-01.png
new file mode 100644
index 0000000000000000000000000000000000000000..4fa4d1bf8e4747120ce1db3df20b73f27e0f6771
GIT binary patch
literal 14534
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
LC{ZJ382rBg!Rr=4

literal 0
HcmV?d00001

diff --git a/docs/images/streams-table-duality-02.png b/docs/images/streams-table-duality-02.png
new file mode 100644
index 0000000000000000000000000000000000000000..4e805c10ff56cb221f95e4bffcc4c0d63c2a9b45
GIT binary patch
literal 56736
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

literal 0
HcmV?d00001

diff --git a/docs/images/streams-table-duality-03.png b/docs/images/streams-table-duality-03.png
new file mode 100644
index 0000000000000000000000000000000000000000..b0b04f59176f28afd1924fe58afa22d9b96b09a4
GIT binary patch
literal 91331
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
HdBFbx#L5zz

literal 0
HcmV?d00001

diff --git a/docs/images/streams-table-updates-01.png b/docs/images/streams-table-updates-01.png
new file mode 100644
index 0000000000000000000000000000000000000000..3a2c35ef3b90dfc639242e94941f1971d200c824
GIT binary patch
literal 78069
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

literal 0
HcmV?d00001

diff --git a/docs/images/streams-table-updates-02.png b/docs/images/streams-table-updates-02.png
new file mode 100644
index 0000000000000000000000000000000000000000..a0a5b1ff53fc2ef3c3091959e481be69fc4f1c67
GIT binary patch
literal 91880
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

literal 0
HcmV?d00001

diff --git a/docs/js/templateData.js b/docs/js/templateData.js
index 40c5da195b471..fbb9e4e1b0986 100644
--- a/docs/js/templateData.js
+++ b/docs/js/templateData.js
@@ -18,4 +18,5 @@ limitations under the License.
 // Define variables for doc templates
 var context={
     "version": "0101"
+    "dotVersion": "0.10.1"
 };
\ No newline at end of file
diff --git a/docs/quickstart.html b/docs/quickstart.html
index 763d3e36ff01e..2080cc4dbd746 100644
--- a/docs/quickstart.html
+++ b/docs/quickstart.html
@@ -279,18 +279,30 @@ <h4><a id="quickstart_kafkastreams" href="#quickstart_kafkastreams">Step 8: Use
 <p>
 Kafka Streams is a client library of Kafka for real-time stream processing and analyzing data stored in Kafka brokers.
 This quickstart example will demonstrate how to run a streaming application coded in this library. Here is the gist
-of the <code>WordCountDemo</code> example code (converted to use Java 8 lambda expressions for easy reading).
+of the <code><a href="https://github.com/apache/kafka/blob/{dotVersion}/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountDemo.java">WordCountDemo</a></code> example code (converted to use Java 8 lambda expressions for easy reading).
 </p>
 <pre>
+// Serializers/deserializers (serde) for String and Long types
+final Serde&lt;String&gt; stringSerde = Serdes.String();
+final Serde&lt;Long&gt; longSerde = Serdes.Long();
+
+// Construct a `KStream` from the input topic ""streams-file-input", where message values
+// represent lines of text (for the sake of this example, we ignore whatever may be stored
+// in the message keys).
+KStream&lt;String, String&gt; textLines = builder.stream(stringSerde, stringSerde, "streams-file-input");
+
 KTable&lt;String, Long&gt; wordCounts = textLines
     // Split each text line, by whitespace, into words.
     .flatMapValues(value -> Arrays.asList(value.toLowerCase().split("\\W+")))
 
-    // Ensure the words are available as record keys for the next aggregate operation.
-    .map((key, value) -> new KeyValue<>(value, value))
+    // Group the text words as message keys
+    .groupBy((key, value) -> value)
 
-    // Count the occurrences of each word (record key) and store the results into a table named "Counts".
-    .countByKey("Counts")
+    // Count the occurrences of each word (message key).
+    .count("Counts")
+
+// Store the running counts as a changelog stream to the output topic.
+wordCounts.to(stringSerde, longSerde, "streams-wordcount-output");
 </pre>
 
 <p>
@@ -303,7 +315,7 @@ <h4><a id="quickstart_kafkastreams" href="#quickstart_kafkastreams">Step 8: Use
 because it cannot know when it has processed "all" the input data.
 </p>
 <p>
-We will now prepare input data to a Kafka topic, which will subsequently be processed by a Kafka Streams application.
+As the first step, we will prepare input data to a Kafka topic, which will subsequently be processed by a Kafka Streams application.
 </p>
 
 <!--
@@ -329,7 +341,8 @@ <h4><a id="quickstart_kafkastreams" href="#quickstart_kafkastreams">Step 8: Use
 </pre>
 
 <p>
-Next, we send this input data to the input topic named <b>streams-file-input</b> using the console producer (in practice,
+Next, we send this input data to the input topic named <b>streams-file-input</b> using the console producer,
+which reads the data from STDIN line-by-line, and publishes each line as a separate Kafka message with null key and value encoded a string to the topic (in practice,
 stream data will likely be flowing continuously into Kafka where the application will be up and running):
 </p>
 
@@ -343,7 +356,7 @@ <h4><a id="quickstart_kafkastreams" href="#quickstart_kafkastreams">Step 8: Use
 
 
 <pre>
-&gt; <b>bin/kafka-console-producer.sh --broker-list localhost:9092 --topic streams-file-input < file-input.txt</b>
+&gt; <b>cat file-input.txt | ./bin/kafka-console-producer --broker-list localhost:9092 --topic streams-file-input</b>
 </pre>
 
 <p>
@@ -355,7 +368,9 @@ <h4><a id="quickstart_kafkastreams" href="#quickstart_kafkastreams">Step 8: Use
 </pre>
 
 <p>
-There won't be any STDOUT output except log entries as the results are continuously written back into another topic named <b>streams-wordcount-output</b> in Kafka.
+The demo application will read from the input topic <b>streams-file-input</b>, perform the computations of the WordCount algorithm on each of the read messages,
+and continuously write its current results to the output topic <b>streams-wordcount-output</b>.
+Hence there won't be any STDOUT output except log entries as the results are written back into in Kafka.
 The demo will run for a few seconds and then, unlike typical stream processing applications, terminate automatically.
 </p>
 <p>
@@ -379,9 +394,12 @@ <h4><a id="quickstart_kafkastreams" href="#quickstart_kafkastreams">Step 8: Use
 
 <pre>
 all     1
+streams 1
 lead    1
 to      1
+kafka   1
 hello   1
+kafka   2
 streams 2
 join    1
 kafka   3
@@ -389,11 +407,34 @@ <h4><a id="quickstart_kafkastreams" href="#quickstart_kafkastreams">Step 8: Use
 </pre>
 
 <p>
-Here, the first column is the Kafka message key, and the second column is the message value, both in <code>java.lang.String</code> format.
+Here, the first column is the Kafka message key in <code>java.lang.String</code> format, and the second column is the message value in <code>java.lang.Long</code> format.
 Note that the output is actually a continuous stream of updates, where each data record (i.e. each line in the original output above) is
 an updated count of a single word, aka record key such as "kafka". For multiple records with the same key, each later record is an update of the previous one.
 </p>
 
+<p>
+The two diagrams below illustrate what is essentially happening behind the scenes.
+The first column shows the evolution of the current state of the <code>KTable&lt;String, Long&gt;</code> that is counting word occurrences for <code>count</code>.
+The second column shows the change records that result from state updates to the KTable and that are being sent to the output Kafka topic <b>streams-wordcount-output</b>.
+</p>
+
+<p>
+First the text line “all streams lead to kafka” is being processed.
+The <code>KTable</code> is being built up as each new word results in a new table entry (highlighted with a green background), and a corresponding change record is sent to the downstream <code>KStream</code>.
+</p>
+<img class="centered" src="/{{version}}/images/streams-table-updates-01.png">
+<p>
+When the second text line “hello kafka streams” is processed, we observe, for the first time, that existing entries in the <code>KTable</code> are being updated (here: for the words “kafka” and for “streams”). And again, change records are being sent to the output topic.
+</p>
+<img class="centered" src="/{{version}}/images/streams-table-updates-01.png">
+<p>
+And so on (we skip the illustration of how the third line is being processed). This explains why the output topic has the contents we showed above, because it contains the full record of changes.
+</p>
+
+<p>
+Looking beyond the scope of this concrete example, what Kafka Streams is doing here is to leverage the duality between a table and a changelog stream (here: table = the KTable, changelog stream = the downstream KStream): you can publish every change of the table to a stream, and if you consume the entire changelog stream from beginning to end, you can reconstruct the contents of the table.
+</p>
+
 <p>
 Now you can write more input messages to the <b>streams-file-input</b> topic and observe additional messages added
 to <b>streams-wordcount-output</b> topic, reflecting updated word counts (e.g., using the console producer and the
diff --git a/docs/streams.html b/docs/streams.html
index dec17efa2d270..af1b2b06456e1 100644
--- a/docs/streams.html
+++ b/docs/streams.html
@@ -17,13 +17,16 @@
 
 <script><!--#include virtual="js/templateData.js" --></script>
 
-<script id="streams-template" type="text/x-handlebars-template">
+<pre id="streams-template" type="text/x-handlebars-template">
     <h1>Streams</h1>
 
         <ol class="toc">
             <li>
                 <a href="#streams_overview">Overview</a>
             </li>
+            <li>
+                <a href="#streams_concepts">Overview</a>
+            </li>
             <li>
                 <a href="#streams_developer">Developer guide</a>
                 <ul>
@@ -34,7 +37,7 @@ <h1>Streams</h1>
             </li>
         </ol>
 
-        <h2><a id="streams_overview" href="#overview">Overview</a></h2>
+        <h2><a id="streams_overview" href="#streams_overview">Overview</a></h2>
 
         <p>
         Kafka Streams is a client library for processing and analyzing data stored in Kafka and either write the resulting data back to Kafka or send the final output to an external system. It builds upon important stream processing concepts such as properly distinguishing between event time and processing time, windowing support, and simple yet efficient management of application state.
@@ -47,70 +50,66 @@ <h2><a id="streams_overview" href="#overview">Overview</a></h2>
         <ul>
             <li>Designed as a <b>simple and lightweight client library</b>, which can be easily embedded in any Java application and integrated with any existing packaging, deployment and operational tools that users have for their streaming applications.</li>
             <li>Has <b>no external dependencies on systems other than Apache Kafka itself</b> as the internal messaging layer; notably, it uses Kafka's partitioning model to horizontally scale processing while maintaining strong ordering guarantees.</li>
-            <li>Supports <b>fault-tolerant local state</b>, which enables very fast and efficient stateful operations like joins and windowed aggregations.</li>
-            <li>Employs <b>one-record-at-a-time processing</b> to achieve low processing latency, and supports <b>event-time based windowing operations</b>.</li>
+            <li>Supports <b>fault-tolerant local state</b>, which enables very fast and efficient stateful operations like joins and aggregations.</li>
+            <li>Employs <b>one-record-at-a-time processing</b> to achieve millisecond processing latency, and supports <b>event-time based windowing operations</b> with late arrival of records.</li>
             <li>Offers necessary stream processing primitives, along with a <b>high-level Streams DSL</b> and a <b>low-level Processor API</b>.</li>
 
         </ul>
+        <br>
 
-        <h2><a id="streams_developer" href="#streams_developer">Developer Guide</a></h2>
-
-        <p>
-        There is a <a href="#quickstart_kafkastreams">quickstart</a> example that provides how to run a stream processing program coded in the Kafka Streams library.
-        This section focuses on how to write, configure, and execute a Kafka Streams application.
-        </p>
-
-        <h4><a id="streams_concepts" href="#streams_concepts">Core Concepts</a></h4>
+        <h2><a id="streams_concepts" href="#streams_concepts">Overview</a></h2>
 
         <p>
-        We first summarize the key concepts of Kafka Streams.
+            We first summarize the key concepts of Kafka Streams.
         </p>
 
         <h5><a id="streams_topology" href="#streams_topology">Stream Processing Topology</a></h5>
 
         <ul>
             <li>A <b>stream</b> is the most important abstraction provided by Kafka Streams: it represents an unbounded, continuously updating data set. A stream is an ordered, replayable, and fault-tolerant sequence of immutable data records, where a <b>data record</b> is defined as a key-value pair.</li>
-            <li>A <b>stream processing application</b> written in Kafka Streams defines its computational logic through one or more <b>processor topologies</b>, where a processor topology is a graph of stream processors (nodes) that are connected by streams (edges).</li>
-            <li>A <b>stream processor</b> is a node in the processor topology; it represents a processing step to transform data in streams by receiving one input record at a time from its upstream processors in the topology, applying its operation to it, and may subsequently producing one or more output records to its downstream processors.</li>
+            <li>A <b>stream processing application</b> is any program that makes use of the Kafka Streams library. It defines its computational logic through one or more <b>processor topologies</b>, where a processor topology is a graph of stream processors (nodes) that are connected by streams (edges).</li>
+            <li>A <b>stream processor</b> is a node in the processor topology; it represents a processing step to transform data in streams by receiving one input record at a time from its upstream processors in the topology, applying its operation to it, and may subsequently produce one or more output records to its downstream processors. </li>
         </ul>
+        <img class="centered" src="/{{version}}/images/streams-concepts-topology.jpg">
+
 
         <p>
-        Kafka Streams offers two ways to define the stream processing topology: the <a href="#streams_dsl"><b>Kafka Streams DSL</b></a> provides
-        the most common data transformation operations such as <code>map</code> and <code>filter</code>; the lower-level <a href="#streams_processor"><b>Processor API</b></a> allows
-        developers define and connect custom processors as well as to interact with <a href="#streams_state">state stores</a>.
+            Kafka Streams offers two ways to define the stream processing topology: the <a href="#streams_dsl"><b>Kafka Streams DSL</b></a> provides
+            the most common data transformation operations such as <code>map</code>, <code>filter</code>, <code>join</code> and <code>aggregations</code> out of the box; the lower-level <a href="#streams_processor"><b>Processor API</b></a> allows
+            developers define and connect custom processors as well as to interact with <a href="#streams_state">state stores</a>.
         </p>
 
         <h5><a id="streams_time" href="#streams_time">Time</a></h5>
 
         <p>
-        A critical aspect in stream processing is the notion of <b>time</b>, and how it is modeled and integrated.
-        For example, some operations such as <b>windowing</b> are defined based on time boundaries.
+            A critical aspect in stream processing is the notion of <b>time</b>, and how it is modeled and integrated.
+            For example, some operations such as <b>windowing</b> are defined based on time boundaries.
         </p>
         <p>
-        Common notions of time in streams are:
+            Common notions of time in streams are:
         </p>
 
         <ul>
-            <li><b>Event time</b> - The point in time when an event or data record occurred, i.e. was originally created "at the source".</li>
-            <li><b>Processing time</b> - The point in time when the event or data record happens to be processed by the stream processing application, i.e. when the record is being consumed. The processing time may be milliseconds, hours, or days etc. later than the original event time.</li>
-            <li><b>Ingestion time</b> - The point in time when an event or data record is stored in a topic partition by a Kafka broker. The difference to event time is that this ingestion timestamp is generated when the record is appended to the target topic by the Kafka broker, not when the record is created "at the source". The difference to processing time is that processing time is when the stream processing application processes the record. For example, if a record is never processed, there is no notion of processing time for it, but it still has an ingestion time.
+            <li><b>Event time</b> - The point in time when an event or data record occurred, i.e. was originally created "at the source". <b>Example:</b> If the event is a geo-location change reported by a GPS sensor in a car, then the associated event-time would be the time when the GPS sensor captured the location change.</li>
+            <li><b>Processing time</b> - The point in time when the event or data record happens to be processed by the stream processing application, i.e. when the record is being consumed. The processing time may be milliseconds, hours, or days etc. later than the original event time. <b>Example:</b> Imagine an analytics application that reads and processes the geo-location data reported from car sensors to present it to a fleet management dashboard. Here, processing-time in the analytics application might be milliseconds or seconds (e.g. for real-time pipelines based on Apache Kafka and Kafka Streams) or hours (e.g. for batch pipelines based on Apache Hadoop or Apache Spark) after event-time.</li>
+            <li><b>Ingestion time</b> - The point in time when an event or data record is stored in a topic partition by a Kafka broker. The difference to event time is that this ingestion timestamp is generated when the record is appended to the target topic by the Kafka broker, not when the record is created "at the source". The difference to processing time is that processing time is when the stream processing application processes the record. <b>For example,</b> if a record is never processed, there is no notion of processing time for it, but it still has an ingestion time.
         </ul>
         <p>
-        The choice between event-time and ingestion-time is actually done through the configuration of Kafka (not Kafka Streams): From Kafka 0.10.x onwards, timestamps are automatically embedded into Kafka messages. Depending on Kafka's configuration these timestamps represent event-time or ingestion-time. The respective Kafka configuration setting can be specified on the broker level or per topic. The default timestamp extractor in Kafka Streams will retrieve these embedded timestamps as-is. Hence, the effective time semantics of your application depend on the effective Kafka configuration for these embedded timestamps.
+            The choice between event-time and ingestion-time is actually done through the configuration of Kafka (not Kafka Streams): From Kafka 0.10.x onwards, timestamps are automatically embedded into Kafka messages. Depending on Kafka's configuration these timestamps represent event-time or ingestion-time. The respective Kafka configuration setting can be specified on the broker level or per topic. The default timestamp extractor in Kafka Streams will retrieve these embedded timestamps as-is. Hence, the effective time semantics of your application depend on the effective Kafka configuration for these embedded timestamps.
         </p>
         <p>
-        Kafka Streams assigns a <b>timestamp</b> to every data record
-        via the <code>TimestampExtractor</code> interface.
-        Concrete implementations of this interface may retrieve or compute timestamps based on the actual contents of data records such as an embedded timestamp field
-        to provide event-time semantics, or use any other approach such as returning the current wall-clock time at the time of processing,
-        thereby yielding processing-time semantics to stream processing applications.
-        Developers can thus enforce different notions of time depending on their business needs. For example,
-        per-record timestamps describe the progress of a stream with regards to time (although records may be out-of-order within the stream) and
-        are leveraged by time-dependent operations such as joins.
+            Kafka Streams assigns a <b>timestamp</b> to every data record
+            via the <code>TimestampExtractor</code> interface.
+            Concrete implementations of this interface may retrieve or compute timestamps based on the actual contents of data records such as an embedded timestamp field
+            to provide event-time semantics, or use any other approach such as returning the current wall-clock time at the time of processing,
+            thereby yielding processing-time semantics to stream processing applications.
+            Developers can thus enforce different notions of time depending on their business needs. For example,
+            per-record timestamps describe the progress of a stream with regards to time (although records may be out-of-order within the stream) and
+            are leveraged by time-dependent operations such as joins.
         </p>
 
         <p>
-        Finally, whenever a Kafka Streams application writes records to Kafka, then it will also assign timestamps to these new records. The way the timestamps are assigned depends on the context:
+            Finally, whenever a Kafka Streams application writes records to Kafka, then it will also assign timestamps to these new records. The way the timestamps are assigned depends on the context:
         <ul>
             <li> When new output records are generated via processing some input record, for example, <code>context.forward()</code> triggered in the <code>process()</code> function call, output record timestamps are inherited from input record timestamps directly.</li>
             <li> When new output records are generated via periodic functions such as <code>punctuate()</code>, the output record timestamp is defined as the current internal time (obtained through <code>context.timestamp()</code>) of the stream task.</li>
@@ -121,22 +120,31 @@ <h5><a id="streams_time" href="#streams_time">Time</a></h5>
         <h5><a id="streams_state" href="#streams_state">States</a></h5>
 
         <p>
-        Some stream processing applications don't require state, which means the processing of a message is independent from
-        the processing of all other messages.
-        However, being able to maintain state opens up many possibilities for sophisticated stream processing applications: you
-        can join input streams, or group and aggregate data records. Many such stateful operators are provided by the <a href="#streams_dsl"><b>Kafka Streams DSL</b></a>.
+            Some stream processing applications don't require state, which means the processing of a message is independent from
+            the processing of all other messages.
+            However, being able to maintain state opens up many possibilities for sophisticated stream processing applications: you
+            can join input streams, or group and aggregate data records. Many such stateful operators are provided by the <a href="#streams_dsl"><b>Kafka Streams DSL</b></a>.
         </p>
         <p>
-        Kafka Streams provides so-called <b>state stores</b>, which can be used by stream processing applications to store and query data.
-        This is an important capability when implementing stateful operations.
-        Every task in Kafka Streams embeds one or more state stores that can be accessed via APIs to store and query data required for processing.
-        These state stores can either be a persistent key-value store, an in-memory hashmap, or another convenient data structure.
-        Kafka Streams offers fault-tolerance and automatic recovery for local state stores.
+            Kafka Streams provides so-called <b>state stores</b>, which can be used by stream processing applications to store and query data.
+            This is an important capability when implementing stateful operations.
+            Every task in Kafka Streams embeds one or more state stores that can be accessed via APIs to store and query data required for processing.
+            These state stores can either be a persistent key-value store, an in-memory hashmap, or another convenient data structure.
+            Kafka Streams offers fault-tolerance and automatic recovery for local state stores.
         </p>
         <p>
-        Kafka Streams allows direct read-only queries of the state stores by methods, threads, processes or applications external to the stream processing application that created the state stores. This is provided through a feature called <b>Interactive Queries</b>. All stores are named and Interactive Queries exposes only the read operations of the underlying implementation. 
+            Kafka Streams allows direct read-only queries of the state stores by methods, threads, processes or applications external to the stream processing application that created the state stores. This is provided through a feature called <b>Interactive Queries</b>. All stores are named and Interactive Queries exposes only the read operations of the underlying implementation.
         </p>
         <br>
+
+        <h2><a id="streams_developer" href="#streams_developer">Developer Guide</a></h2>
+
+        <p>
+        There is a <a href="#quickstart_kafkastreams">quickstart</a> example that provides how to run a stream processing program coded in the Kafka Streams library.
+        This section focuses on how to write, configure, and execute a Kafka Streams application.
+        </p>
+
+
         <p>
         As we have mentioned above, the computational logic of a Kafka Streams application is defined as a <a href="#streams_topology">processor topology</a>.
         Currently Kafka Streams provides two sets of APIs to define the processor topology, which will be described in the subsequent sections.
@@ -157,16 +165,16 @@ <h5><a id="streams_processor_process" href="#streams_processor_process">Processo
         </p>
 
         <pre>
-            public class MyProcessor extends Processor<String, String> {
+            public class MyProcessor extends Processor&lt;String, String&gt; {
                 private ProcessorContext context;
-                private KeyValueStore<String, Integer> kvStore;
+                private KeyValueStore&lt;String, Integer&gt; kvStore;
 
                 @Override
                 @SuppressWarnings("unchecked")
                 public void init(ProcessorContext context) {
                     this.context = context;
                     this.context.schedule(1000);
-                    this.kvStore = (KeyValueStore<String, Integer>) context.getStateStore("Counts");
+                    this.kvStore = (KeyValueStore&lt;String, Integer&gt;) context.getStateStore("Counts");
                 }
 
                 @Override
@@ -186,10 +194,10 @@ <h5><a id="streams_processor_process" href="#streams_processor_process">Processo
 
                 @Override
                 public void punctuate(long timestamp) {
-                    KeyValueIterator<String, Integer> iter = this.kvStore.all();
+                    KeyValueIterator&lt;String, Integer&gt; iter = this.kvStore.all();
 
                     while (iter.hasNext()) {
-                        KeyValue<String, Integer> entry = iter.next();
+                        KeyValue&lt;String, Integer&gt; entry = iter.next();
                         context.forward(entry.key, entry.value.toString());
                     }
 
@@ -280,12 +288,52 @@ <h4><a id="streams_dsl" href="#streams_dsl">High-Level Streams DSL</a></h4>
         To build a processor topology using the Streams DSL, developers can apply the <code>KStreamBuilder</code> class, which is extended from the <code>TopologyBuilder</code>.
         A simple example is included with the source code for Kafka in the <code>streams/examples</code> package. The rest of this section will walk
         through some code to demonstrate the key steps in creating a topology using the Streams DSL, but we recommend developers to read the full example source
-        codes for details. 
+        codes for details.
+
+        <h5><a id="streams_duality" href="#streams_duality">Duality of Streams and Tables</a></h5>
+
+        <p>
+        Before we discuss concepts such as aggregations in Kafka Streams we must first introduce tables, and most importantly the relationship between tables and streams:
+        the so-called <a href="https://engineering.linkedin.com/distributed-systems/log-what-every-software-engineer-should-know-about-real-time-datas-unifying">stream-table duality</a>.
+        Essentially, this duality means that a stream can be viewed as a table, and vice versa. Kafka’s log compaction feature, for example, exploits this duality.
+        </p>
+
+        <p>
+        A simple form of a table is a collection of key-value pairs, also called a map or associative array. Such a table may look as follows:
+        </p>
+        <img class="centered" src="/{{version}}/images/streams-table-duality-01.png">
+
+        The <b>stream-table duality</b> describes the close relationship between streams and tables.
+        <ul>
+        <li><b>Stream as Table</b>: A stream can be considered a changelog of a table, where each data record in the stream captures a state change of the table. A stream is thus a table in disguise, and it can be easily turned into a “real” table by replaying the changelog from beginning to end to reconstruct the table. Similarly, in a more general analogy, aggregating data records in a stream – such as computing the total number of pageviews by user from a stream of pageview events – will return a table (here with the key and the value being the user and its corresponding pageview count, respectively).</li>
+        <li><b>Table as Stream</b>: A table can be considered a snapshot, at a point in time, of the latest value for each key in a stream (a stream’s data records are key-value pairs). A table is thus a stream in disguise, and it can be easily turned into a “real” stream by iterating over each key-value entry in the table.</li>
+        </ul>
+
+        <p>
+        Let’s illustrate this with an example. Imagine a table that tracks the total number of pageviews by user (first column of diagram below). Over time, whenever a new pageview event is processed, the state of the table is updated accordingly. Here, the state changes between different points in time – and different revisions of the table – can be represented as a changelog stream (second column).
+        </p>
+        <img class="centered" src="/{{version}}/images/streams-table-duality-02.png">
+
+        <p>
+        Interestingly, because of the stream-table duality, the same stream can be used to reconstruct the original table (third column):
+        </p>
+        <img class="centered" src="/{{version}}/images/streams-table-duality-03.png">
+
+        <p>
+        The same mechanism is used, for example, to replicate databases via change data capture (CDC) and, within Kafka Streams, to replicate its so-called state stores across machines for fault-tolerance.
+        The stream-table duality is such an important concept that Kafka Streams models it explicitly via the <a href="#streams_kstream_ktable">KStream and KTable</a> interfaces, which we describe in the next sections.
+        </p>
 
         <h5><a id="streams_kstream_ktable" href="#streams_kstream_ktable">KStream and KTable</a></h5>
-        The DSL uses two main abstractions. A <b>KStream</b> is an abstraction of a record stream, where each data record represents a self-contained datum in the unbounded data set. A <b>KTable</b> is an abstraction of a changelog stream, where each data record represents an update. More precisely, the value in a data record is considered to be an update of the last value for the same record key, if any (if a corresponding key doesn't exist yet, the update will be considered a create). To illustrate the difference between KStreams and KTables, let’s imagine the following two data records are being sent to the stream: <code>("alice", 1) --> ("alice", 3)</code>. If these records a KStream and the stream processing application were to sum the values it would return <code>4</code>. If these records were a KTable, the return would be <code>3</code>, since the last record would be considered as an update.
+        The DSL uses two main abstractions. A <b>KStream</b> is an abstraction of a record stream, where each data record represents a self-contained datum in the unbounded data set.
+        A <b>KTable</b> is an abstraction of a changelog stream, where each data record represents an update. More precisely, the value in a data record is considered to be an update of the last value for the same record key,
+        if any (if a corresponding key doesn't exist yet, the update will be considered a create). To illustrate the difference between KStreams and KTables, let’s imagine the following two data records are being sent to the stream:
 
+        <pre>
+            ("alice", 1) --> ("alice", 3)
+        </pre>
 
+        If these records a KStream and the stream processing application were to sum the values it would return <code>4</code>. If these records were a KTable, the return would be <code>3</code>, since the last record would be considered as an update.
 
         <h5><a id="streams_dsl_source" href="#streams_dsl_source">Create Source Streams from Kafka</a></h5>
 
@@ -298,8 +346,8 @@ <h5><a id="streams_dsl_source" href="#streams_dsl_source">Create Source Streams
         <pre>
             KStreamBuilder builder = new KStreamBuilder();
 
-            KStream<String, GenericRecord> source1 = builder.stream("topic1", "topic2");
-            KTable<String, GenericRecord> source2 = builder.table("topic3", "stateStoreName");
+            KStream&lt;String, GenericRecord&gt; source1 = builder.stream("topic1", "topic2");
+            KTable&lt;String, GenericRecord&gt; source2 = builder.table("topic3", "stateStoreName");
         </pre>
 
         <h5><a id="streams_dsl_windowing" href="#streams_dsl_windowing">Windowing a stream</a></h5>
@@ -310,7 +358,18 @@ <h5><a id="streams_dsl_windowing" href="#streams_dsl_windowing">Windowing a stre
         <li><b>Sliding windows</b> model a fixed-size window that slides continuously over the time axis; here, two data records are said to be included in the same window if the difference of their timestamps is within the window size. Thus, sliding windows are not aligned to the epoch, but on the data record timestamps. In Kafka Streams, sliding windows are used only for join operations, and can be specified through the <code>JoinWindows</code> class.</li>
         </ul>
 
-        <h5><a id="streams_dsl_joins" href="#streams_dsl_joins">Joins</a></h5>
+        <p>
+        In the Kafka Streams DSL users can specify a <b>retention period</b> for the window. This allows Kafka Streams to retain old window buckets for a period of time in order to wait for the late arrival of records whose timestamps fall within the window interval.
+        If a record arrives after the retention period has passed, the record cannot be processed and is dropped.
+        </p>
+
+        <p>
+        Late-arriving records are always possible in real-time data streams. However, it depends on the effective <a href="#streams_team">time semantics</a> how late records are handled. Using processing-time, the semantics are “when the data is being processed”,
+        which means that the notion of late records is not applicable as, by definition, no record can be late. Hence, late-arriving records only really can be considered as such (i.e. as arriving “late”) for event-time or ingestion-time semantics. In both cases,
+        Kafka Streams is able to properly handle late-arriving records.
+        </p>
+
+        <h5><a id="streams_dsl_joins" href="#streams_dsl_joins">Join multiple streams</a></h5>
         A <b>join</b> operation merges two streams based on the keys of their data records, and yields a new stream. A join over record streams usually needs to be performed on a windowing basis because otherwise the number of records that must be maintained for performing the join may grow indefinitely. In Kafka Streams, you may perform the following join operations:
         <ul>
         <li><b>KStream-to-KStream Joins</b> are always windowed joins, since otherwise the memory and state required to compute the join would grow infinitely in size. Here, a newly received record from one of the streams is joined with the other stream's records within the specified window interval to produce one result for each matching pair based on user-provided <code>ValueJoiner</code>. A new <code>KStream</code> instance representing the result stream of the join is returned from this operator.</li>
@@ -320,11 +379,20 @@ <h5><a id="streams_dsl_joins" href="#streams_dsl_joins">Joins</a></h5>
         </ul>
 
         Depending on the operands the following join operations are supported: <b>inner joins</b>, <b>outer joins</b> and <b>left joins</b>. Their semantics are similar to the corresponding operators in relational databases.
-        a
+
+        <h5><a id="streams_dsl_aggregations" href="#streams_dsl_aggregations">Aggregate a stream</a></h5>
+        An <b>aggregation</b> operation takes one input stream, and yields a new stream by combining multiple input records into a single output record. Examples of aggregations are computing counts or sum. An aggregation over record streams usually needs to be performed on a windowing basis because otherwise the number of records that must be maintained for performing the aggregation may grow indefinitely.
+
+        <p>
+        In the Kafka Streams DSL, an input stream of an aggregation can be a <code>KStream</code> or a <code>KTable</code>, but the output stream will always be a <code>KTable</code>.
+        This allows Kafka Streams to update an aggregate value upon the late arrival of further records after the value was produced and emitted.
+        When such late arrival happens, the aggregating <code>KStream</code> or <code>KTable</code> simply emits a new aggregate value. Because the output is a <code>KTable</code>, the new value is considered to overwrite the old value with the same key in subsequent processing steps.
+        </p>
+
         <h5><a id="streams_dsl_transform" href="#streams_dsl_transform">Transform a stream</a></h5>
 
         <p>
-        There is a list of transformation operations provided for <code>KStream</code> and <code>KTable</code> respectively.
+        Besides join and aggregation operations, there is a list of other transformation operations provided for <code>KStream</code> and <code>KTable</code> respectively.
         Each of these operations may generate either one or more <code>KStream</code> and <code>KTable</code> objects and
         can be translated into one or more connected processors into the underlying processor topology.
         All these transformation methods can be chained together to compose a complex processor topology.
@@ -342,7 +410,7 @@ <h5><a id="streams_dsl_transform" href="#streams_dsl_transform">Transform a stre
 
         <pre>
             // written in Java 8+, using lambda expressions
-            KStream<String, GenericRecord> mapped = source1.mapValue(record -> record.get("category"));
+            KStream&lt;String, GenericRecord&gt; mapped = source1.mapValue(record -> record.get("category"));
         </pre>
 
         <p>
@@ -356,14 +424,14 @@ <h5><a id="streams_dsl_transform" href="#streams_dsl_transform">Transform a stre
 
         <pre>
             // written in Java 8+, using lambda expressions
-            KTable<Windowed<String>, Long> counts = source1.groupByKey().aggregate(
+            KTable&lt;Windowed&lt;String&gt;, Long&gt; counts = source1.groupByKey().aggregate(
                 () -> 0L,  // initial value
                 (aggKey, value, aggregate) -> aggregate + 1L,   // aggregating value
                 TimeWindows.of("counts", 5000L).advanceBy(1000L), // intervals in milliseconds
                 Serdes.Long() // serde for aggregated value
             );
 
-            KStream<String, String> joined = source1.leftJoin(source2,
+            KStream&lt;String, String&gt; joined = source1.leftJoin(source2,
                 (record1, record2) -> record1.get("user") + "-" + record2.get("region");
             );
         </pre>
@@ -388,7 +456,7 @@ <h5><a id="streams_dsl_sink" href="#streams_dsl_sink">Write streams back to Kafk
             //
             // joined.to("topic4");
             // materialized = builder.stream("topic4");
-            KStream<String, String> materialized = joined.through("topic4");
+            KStream&lt;String, String&gt; materialized = joined.through("topic4");
         </pre>
 
 
@@ -398,6 +466,7 @@ <h5><a id="streams_dsl_sink" href="#streams_dsl_sink">Write streams back to Kafk
         in <code>StreamsConfig</code> before running it. A complete list of
         Kafka Streams configs can be found <a href="#streamsconfigs"><b>here</b></a>.
         </p>
+</pre>
 </script>
 
 <!--#include virtual="../includes/_header.htm" -->

From 7b5bceeb4c58f4d236482228c2c82d8f80866293 Mon Sep 17 00:00:00 2001
From: Jason Gustafson <jason@confluent.io>
Date: Thu, 2 Feb 2017 10:49:11 -0800
Subject: [PATCH 085/177] KAFKA-4719: Consumption timeout should take into
 account producer request timeout

Author: Jason Gustafson <jason@confluent.io>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2479 from hachikuji/KAFKA-4719

(cherry picked from commit 76550dd8956b07f24713f10992fc15aeedabe2c9)
Signed-off-by: Ewen Cheslack-Postava <me@ewencp.org>
---
 .../kafkatest/services/verifiable_consumer.py | 32 ++++++++++++-------
 .../kafkatest/services/verifiable_producer.py |  6 +++-
 tests/kafkatest/tests/client/consumer_test.py |  6 ++--
 .../tests/verifiable_consumer_test.py         | 13 +++++---
 4 files changed, 39 insertions(+), 18 deletions(-)

diff --git a/tests/kafkatest/services/verifiable_consumer.py b/tests/kafkatest/services/verifiable_consumer.py
index d7fca876e6a85..013913239e8ba 100644
--- a/tests/kafkatest/services/verifiable_consumer.py
+++ b/tests/kafkatest/services/verifiable_consumer.py
@@ -55,12 +55,17 @@ def handle_offsets_committed(self, event):
                 partition = offset_commit["partition"]
                 tp = TopicPartition(topic, partition)
                 offset = offset_commit["offset"]
-                assert tp in self.assignment, "Committed offsets for a partition not assigned"
-                assert self.position[tp] >= offset, "The committed offset was greater than the current position"
+                assert tp in self.assignment, \
+                    "Committed offsets for partition %s not assigned (current assignment: %s)" % \
+                    (str(tp), str(self.assignment))
+                assert self.position[tp] >= offset, \
+                    "The committed offset %d was greater than the current position %d for partition %s" % \
+                    (offset, self.position[t], str(tp))
                 self.committed[tp] = offset
 
     def handle_records_consumed(self, event):
-        assert self.state == ConsumerState.Joined, "Consumed records should only be received when joined"
+        assert self.state == ConsumerState.Joined, \
+            "Consumed records should only be received when joined (current state: %s)" % str(self.state)
 
         for record_batch in event["partitions"]:
             tp = TopicPartition(topic=record_batch["topic"],
@@ -68,9 +73,12 @@ def handle_records_consumed(self, event):
             min_offset = record_batch["minOffset"]
             max_offset = record_batch["maxOffset"]
 
-            assert tp in self.assignment, "Consumed records for a partition not assigned"
+            assert tp in self.assignment, \
+                "Consumed records for partition %s which is not assigned (current assignment: %s)" % \
+                (str(tp), str(self.assignment))
             assert tp not in self.position or self.position[tp] == min_offset, \
-                "Consumed from an unexpected offset (%s, %s)" % (str(self.position[tp]), str(min_offset))
+                "Consumed from an unexpected offset (%d, %d) for partition %s" % \
+                (self.position[tp], min_offset, str(tp))
             self.position[tp] = max_offset + 1 
 
         self.total_consumed += event["count"]
@@ -136,9 +144,9 @@ class VerifiableConsumer(KafkaPathResolverMixin, BackgroundThreadService):
     def __init__(self, context, num_nodes, kafka, topic, group_id,
                  max_messages=-1, session_timeout_sec=30, enable_autocommit=False,
                  assignment_strategy="org.apache.kafka.clients.consumer.RangeAssignor",
-                 version=DEV_BRANCH, stop_timeout_sec=30):
+                 version=DEV_BRANCH, stop_timeout_sec=30, log_level="INFO"):
         super(VerifiableConsumer, self).__init__(context, num_nodes)
-        self.log_level = "TRACE"
+        self.log_level = log_level
         
         self.kafka = kafka
         self.topic = topic
@@ -204,13 +212,14 @@ def _update_global_position(self, consumed_event):
             if tp in self.global_committed:
                 # verify that the position never gets behind the current commit.
                 assert self.global_committed[tp] <= consumed_partition["minOffset"], \
-                    "Consumed position %d is behind the current committed offset %d" % (consumed_partition["minOffset"], self.global_committed[tp])
+                    "Consumed position %d is behind the current committed offset %d for partition %s" % \
+                    (consumed_partition["minOffset"], self.global_committed[tp], str(tp))
 
             # the consumer cannot generally guarantee that the position increases monotonically
             # without gaps in the face of hard failures, so we only log a warning when this happens
             if tp in self.global_position and self.global_position[tp] != consumed_partition["minOffset"]:
-                self.logger.warn("Expected next consumed offset of %d, but instead saw %d" %
-                                 (self.global_position[tp], consumed_partition["minOffset"]))
+                self.logger.warn("Expected next consumed offset of %d for partition %s, but instead saw %d" %
+                                 (self.global_position[tp], str(tp), consumed_partition["minOffset"]))
 
             self.global_position[tp] = consumed_partition["maxOffset"] + 1
 
@@ -220,7 +229,8 @@ def _update_global_committed(self, commit_event):
                 tp = TopicPartition(offset_commit["topic"], offset_commit["partition"])
                 offset = offset_commit["offset"]
                 assert self.global_position[tp] >= offset, \
-                    "committed offset is ahead of the current partition"
+                    "Committed offset %d for partition %s is ahead of the current position %d" % \
+                    (offset, str(tp), self.global_position[tp])
                 self.global_committed[tp] = offset
 
     def start_cmd(self, node):
diff --git a/tests/kafkatest/services/verifiable_producer.py b/tests/kafkatest/services/verifiable_producer.py
index f545634aa6419..bc327c7283baf 100644
--- a/tests/kafkatest/services/verifiable_producer.py
+++ b/tests/kafkatest/services/verifiable_producer.py
@@ -51,7 +51,7 @@ class VerifiableProducer(KafkaPathResolverMixin, BackgroundThreadService):
 
     def __init__(self, context, num_nodes, kafka, topic, max_messages=-1, throughput=100000,
                  message_validator=is_int, compression_types=None, version=DEV_BRANCH, acks=None,
-                 stop_timeout_sec=150):
+                 stop_timeout_sec=150, request_timeout_sec=30, log_level="INFO"):
         """
         :param max_messages is a number of messages to be produced per producer
         :param message_validator checks for an expected format of messages produced. There are
@@ -64,6 +64,7 @@ def __init__(self, context, num_nodes, kafka, topic, max_messages=-1, throughput
         compression types, one per producer (could be "none").
         """
         super(VerifiableProducer, self).__init__(context, num_nodes)
+        self.log_level = log_level
 
         self.kafka = kafka
         self.topic = topic
@@ -82,6 +83,7 @@ def __init__(self, context, num_nodes, kafka, topic, max_messages=-1, throughput
         self.clean_shutdown_nodes = set()
         self.acks = acks
         self.stop_timeout_sec = stop_timeout_sec
+        self.request_timeout_sec = request_timeout_sec
 
     def prop_file(self, node):
         idx = self.idx(node)
@@ -109,6 +111,8 @@ def _worker(self, idx, node):
         if self.acks is not None:
             self.logger.info("VerifiableProducer (index = %d) will use acks = %s", idx, self.acks)
             producer_prop_file += "\nacks=%s\n" % self.acks
+
+        producer_prop_file += "\nrequest.timeout.ms=%d\n" % self.request_timeout_sec
         self.logger.info("verifiable_producer.properties:")
         self.logger.info(producer_prop_file)
         node.account.create_file(VerifiableProducer.CONFIG_FILE, producer_prop_file)
diff --git a/tests/kafkatest/tests/client/consumer_test.py b/tests/kafkatest/tests/client/consumer_test.py
index a68e23ec803af..9c55955f00734 100644
--- a/tests/kafkatest/tests/client/consumer_test.py
+++ b/tests/kafkatest/tests/client/consumer_test.py
@@ -150,11 +150,13 @@ def test_consumer_bounce(self, clean_shutdown, bounce_mode):
             # if the total records consumed matches the current position, we haven't seen any duplicates
             # this can only be guaranteed with a clean shutdown
             assert consumer.current_position(partition) == consumer.total_consumed(), \
-                "Total consumed records did not match consumed position"
+                "Total consumed records %d did not match consumed position %d" % \
+                (consumer.total_consumed(), consumer.current_position(partition))
         else:
             # we may have duplicates in a hard failure
             assert consumer.current_position(partition) <= consumer.total_consumed(), \
-                "Current position greater than the total number of consumed records"
+                "Current position %d greater than the total number of consumed records %d" % \
+                (consumer.current_position(partition), consumer.total_consumed())
 
     @cluster(num_nodes=7)
     @matrix(clean_shutdown=[True, False], enable_autocommit=[True, False])
diff --git a/tests/kafkatest/tests/verifiable_consumer_test.py b/tests/kafkatest/tests/verifiable_consumer_test.py
index 6417e615f5468..2ba2a619994f0 100644
--- a/tests/kafkatest/tests/verifiable_consumer_test.py
+++ b/tests/kafkatest/tests/verifiable_consumer_test.py
@@ -23,14 +23,16 @@
 from kafkatest.services.kafka import TopicPartition
 
 class VerifiableConsumerTest(KafkaTest):
+    PRODUCER_REQUEST_TIMEOUT_SEC = 30
 
     def __init__(self, test_context, num_consumers=1, num_producers=0,
-                 group_id="test_group_id", session_timeout_sec=10,  **kwargs):
+                 group_id="test_group_id", session_timeout_sec=10, **kwargs):
         super(VerifiableConsumerTest, self).__init__(test_context, **kwargs)
         self.num_consumers = num_consumers
         self.num_producers = num_producers
         self.group_id = group_id
         self.session_timeout_sec = session_timeout_sec
+        self.consumption_timeout_sec = max(self.PRODUCER_REQUEST_TIMEOUT_SEC + 5, 2 * session_timeout_sec)
 
     def _all_partitions(self, topic, num_partitions):
         partitions = set()
@@ -56,11 +58,14 @@ def min_cluster_size(self):
     def setup_consumer(self, topic, enable_autocommit=False, assignment_strategy="org.apache.kafka.clients.consumer.RangeAssignor"):
         return VerifiableConsumer(self.test_context, self.num_consumers, self.kafka,
                                   topic, self.group_id, session_timeout_sec=self.session_timeout_sec,
-                                  assignment_strategy=assignment_strategy, enable_autocommit=enable_autocommit)
+                                  assignment_strategy=assignment_strategy, enable_autocommit=enable_autocommit,
+                                  log_level="TRACE")
 
     def setup_producer(self, topic, max_messages=-1):
         return VerifiableProducer(self.test_context, self.num_producers, self.kafka, topic,
-                                  max_messages=max_messages, throughput=500)
+                                  max_messages=max_messages, throughput=500,
+                                  request_timeout_sec=self.PRODUCER_REQUEST_TIMEOUT_SEC,
+                                  log_level="DEBUG")
 
     def await_produced_messages(self, producer, min_messages=1000, timeout_sec=10):
         current_acked = producer.num_acked
@@ -70,7 +75,7 @@ def await_produced_messages(self, producer, min_messages=1000, timeout_sec=10):
     def await_consumed_messages(self, consumer, min_messages=1):
         current_total = consumer.total_consumed()
         wait_until(lambda: consumer.total_consumed() >= current_total + min_messages,
-                   timeout_sec=self.session_timeout_sec*2,
+                   timeout_sec=self.consumption_timeout_sec,
                    err_msg="Timed out waiting for consumption")
 
     def await_members(self, consumer, num_consumers):

From d952d94e5f0dad08af3ec935fe43e3a17ea97359 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Thu, 2 Feb 2017 21:36:27 -0800
Subject: [PATCH 086/177] MINOR: added upgrade and API changes to docs

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Ismael Juma, Will Marshall, Damian Guy, Guozhang Wang, Michael G. Noll

Closes #2461 from mjsax/addStreamsUpdateSecton

(cherry picked from commit ab4ebb4bb93fbaab432d3f91dbc362d18796c83c)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 docs/streams.html | 84 +++++++++++++++++++++++++++++++++++++++++++++++
 docs/upgrade.html | 20 ++++++-----
 2 files changed, 96 insertions(+), 8 deletions(-)

diff --git a/docs/streams.html b/docs/streams.html
index af1b2b06456e1..3e9334b2d3250 100644
--- a/docs/streams.html
+++ b/docs/streams.html
@@ -35,6 +35,9 @@ <h1>Streams</h1>
                     <li><a href="#streams_dsl">High-level streams DSL</a>
                 </ul>
             </li>
+            <li>
+                <a href="#streams_upgrade">Upgrade guide and API changes</a>
+            </li>
         </ol>
 
         <h2><a id="streams_overview" href="#streams_overview">Overview</a></h2>
@@ -466,7 +469,88 @@ <h5><a id="streams_dsl_sink" href="#streams_dsl_sink">Write streams back to Kafk
         in <code>StreamsConfig</code> before running it. A complete list of
         Kafka Streams configs can be found <a href="#streamsconfigs"><b>here</b></a>.
         </p>
+
+        <h2><a id="streams_upgrade" href="#upgrade">Upgrade guide and API changes</a></h2>
+
+        <h3><a id="streams_upgrade_1020" href="#upgrade_1020">Upgrading a Kafka Streams Application</a></h3>
+
+        <h4>Upgrading from 0.10.1.x to 0.10.2.0</h4>
+        <p>
+        See <a href="../#upgrade_1020_streams">Upgrade Section</a> for details.
+        </p>
+
+        <h3><a id="streams_api_changes" href="#api_changes">Streams API changes in 0.10.2.0</a></h3>
+        <li> New methods in <code>KafkaStreams</code>:
+            <ul>
+                <li> set a listener to react on application state change via <code>#setStateListener(StateListener listener)</code> </li>
+                <li> retrieve the current application state via <code>#state()</code> </li>
+                <li> retrieve the global metrics registry via <code>#metrics()</code> </li>
+                <li> apply a timeout when closing an application via <code>#close(long timeout, TimeUnit timeUnit)</code> </li>
+                <li> specify a custom indent when retrieving Kafka Streams information via <code>#toString(String indent)</code> </li>
+            </ul>
+        </li>
+        <li> Parameter updates in <code>StreamsConfig</code>:
+            <ul>
+                <li> parameter <code>zookeeper.connect</code> was deprecated </li>
+                <ul>
+                    <li> a Kafka Streams application does no longer interact with Zookeeper for topic management but uses the new broker admin protocol
+                         (cf. <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-4+-+Command+line+and+centralized+administrative+operations#KIP-4-Commandlineandcentralizedadministrativeoperations-TopicAdminSchema.1">KIP-4, Section "Topic Admin Schema"</a>) </li>
+                    <li> thus, parameter "zookeeper.connect" is ignored in 0.10.2 and should be removed from <code>StreamsConfig</code> </li>
+                </ul>
+                <li> added many new parameters for metrics, security, and client configurations </li>
+            </ul>
+        </li>
+        <li> Changes in <code>StreamsMetrics</code> interface:
+            <ul>
+                <li> removed methods: <code>#addLatencySensor()</code> </li>
+                <li> added methods: <code>#addLatencyAndThroughputSensor()</code>, <code>#addThroughputSensor()</code>, <code>#recordThroughput()</code>,
+                     <code>#addSensor()</code>, <code>#removeSensor()</code> </li>
+            </ul>
+        </li>
+        <li> New methods in <code>TopologyBuilder</code>:
+            <ul>
+                <li> added overloads for <code>#addSource()</code> that allow to define a <code>auto.offset.reset</code> policy per source node </li>
+                <li> added methods <code>#addGlobalStore()</code> to add global <code>StateStore</code>s </li>
+            </ul>
+        </li>
+        <li> New methods in <code>KStreamBuilder</code>:
+            <ul>
+                <li> added overloads for <code>#stream()</code> and <code>#table()</code> that allow to define a <code>auto.offset.reset</code> policy per input stream/table </li>
+                <li> <code>#table()</code> always requires store name </li>
+                <li> added method <code>#globalKTable()</code> to create a <code>GlobalKTable</code> </li>
+            </ul>
+        </li>
+        <li> New joins for <code>KStream</code>:
+            <ul>
+                <li> added overloads for <code>#join()</code> to join with <code>KTable</code> </li>
+                <li> added overloads for <code>#join()</code> and <code>leftJoin()</code> to join with <code>GlobalKTable</code> </li>
+            </ul>
+        </li>
+        <li> Aligned <code>null</code>-key handling for <code>KTable</code> joins:
+            <ul>
+                <li> like all other KTable operations, <code>KTable-KTable</code> joins do not throw an exception on <code>null</code> key records anymore, but drop those records silently </li>
+            </ul>
+        </li>
+        <li> New window type <em>Session Windows</em>:
+            <ul>
+                <li> added class <code>SessionWindows</code> to specify session windows </li>
+                <li> added overloads for <code>KGroupedStream</code> methods <code>#count()</code>, <code>#reduce()</code>, and <code>#aggregate()</code>
+                     to allow session window aggregations </li>
+            </ul>
+        </li>
+        <li> Changes to <code>TimestampExtractor</code>:
+            <ul>
+                <li> method <code>#extract()</code> has a second parameter now </li>
+                <li> new default timestamp extractor class <code>FailOnInvalidTimestamp</code>
+                     (it gives the same behavior as old (and removed) default extractor <code>ConsumerRecordTimestampExtractor</code>) </li>
+                <li> new alternative timestamp extractor classes <code>LogAndSkipOnInvalidTimestamp</code> and <code>UsePreviousTimeOnInvalidTimestamps</code> </li>
+            </ul>
+        </li>
+        <li> Relaxed type constraints of many DSL interfaces, classes, and methods (cf. <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-100+-+Relax+Type+constraints+in+Kafka+Streams+API">KIP-100</a>). </li>
+    </ul>
 </pre>
+
+
 </script>
 
 <!--#include virtual="../includes/_header.htm" -->
diff --git a/docs/upgrade.html b/docs/upgrade.html
index ebc61dbb053be..79c376d53560a 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -47,14 +47,16 @@ <h4><a id="upgrade_10_2_0" href="#upgrade_10_2_0">Upgrading from 0.8.x, 0.9.x, 0
 
 <p><b>Note:</b> Bumping the protocol version and restarting can be done any time after the brokers were upgraded. It does not have to be immediately after.
 
-<ol>
-    <li>Upgrading a Kafka Streams Applications:
-        <ul>
-            <li>You need to recompile your code. Just swapping the jar file will not work and will break your appliation.</li>
-            <li>If you use a custom timestamp extractor, you will need to update this code, because the <code>TimestampExtractor</code> interface was changed.</li>
-        </ul>
-    </li>
-</ol>
+<h5><a id="upgrade_1020_streams" href="#upgrade_1020_streams">Upgrading a Kafka Streams Application</a></h5>
+<ul>
+    <li> Upgrading your Streams application from 0.10.1 to 0.10.2 does not require a broker upgrade.
+         A Kafka Streams 0.10.2 application can connect to 0.10.2 and 0.10.1 brokers (it is not possible to connect to 0.10.0 brokers though). </li>
+    <li> You need to recompile your code. Just swapping the Kafka Streams library jar file will not work and will break your application. </li>
+    <li> <code>KStreamBuilder#table()</code> always requires a store name. </li>
+    <li> <code>KTable#through()</code> always requires a store name. </li>
+    <li> If you use a custom (i.e., user implemented) timestamp extractor, you will need to update this code, because the <code>TimestampExtractor</code> interface was changed. </li>
+    <li> If you register custom metrics, you will need to update this code, because the <code>StreamsMetric</code> interface was changed. </li>
+</ul>
 
 <h5><a id="upgrade_1020_notable" href="#upgrade_1020_notable">Notable changes in 0.10.2.0</a></h5>
 <ul>
@@ -67,6 +69,8 @@ <h5><a id="upgrade_1020_notable" href="#upgrade_1020_notable">Notable changes in
         A new close API with timeout has been added to <code>KafkaConsumer</code> to control the maximum wait time.</li>
     <li>Multiple regular expressions separated by commas can be passed to MirrorMaker with the new Java consumer via the --whitelist option. This
         makes the behaviour consistent with MirrorMaker when used the old Scala consumer.</li>
+    <li>Upgrading your Streams application from 0.10.1 to 0.10.2 does not require a broker upgrade.
+        A Kafka Streams 0.10.2 application can connect to 0.10.2 and 0.10.1 brokers (it is not possible to connect to 0.10.0 brokers though).</li>
     <li>The Zookeeper dependency was removed from the Streams API. The Streams API now uses the Kafka protocol to manage internal topics instead of
         modifying Zookeeper directly. This eliminates the need for privileges to access Zookeeper directly and "StreamsConfig.ZOOKEEPER_CONFIG"
         should not be set in the Streams app any more. If the Kafka cluster is secured, Streams apps must have the required security privileges to create new topics.</li>

From 0578e294500b220d09e46ec1c11cea42829e39f4 Mon Sep 17 00:00:00 2001
From: Jason Gustafson <jason@confluent.io>
Date: Fri, 3 Feb 2017 13:47:14 -0800
Subject: [PATCH 087/177] HOTFIX: Verifiable producer request timeout needs
 conversion to milliseconds

Author: Jason Gustafson <jason@confluent.io>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2494 from hachikuji/hotfix-verifiable-producer-request-timeout

(cherry picked from commit 88809b9b8eb7895f3756a39ee2ad7dffd0b4d516)
Signed-off-by: Jason Gustafson <jason@confluent.io>
---
 tests/kafkatest/services/verifiable_producer.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/kafkatest/services/verifiable_producer.py b/tests/kafkatest/services/verifiable_producer.py
index bc327c7283baf..5f39df21f9339 100644
--- a/tests/kafkatest/services/verifiable_producer.py
+++ b/tests/kafkatest/services/verifiable_producer.py
@@ -112,7 +112,7 @@ def _worker(self, idx, node):
             self.logger.info("VerifiableProducer (index = %d) will use acks = %s", idx, self.acks)
             producer_prop_file += "\nacks=%s\n" % self.acks
 
-        producer_prop_file += "\nrequest.timeout.ms=%d\n" % self.request_timeout_sec
+        producer_prop_file += "\nrequest.timeout.ms=%d\n" % (self.request_timeout_sec * 1000)
         self.logger.info("verifiable_producer.properties:")
         self.logger.info(producer_prop_file)
         node.account.create_file(VerifiableProducer.CONFIG_FILE, producer_prop_file)

From e321cd4f5daf78046554d24e0f454a8cd2d5b394 Mon Sep 17 00:00:00 2001
From: Apurva Mehta <apurva.1618@gmail.com>
Date: Sun, 5 Feb 2017 10:24:43 +0000
Subject: [PATCH 088/177] KAFKA-4558; throttling_test fails if the producer
 starts too fast

With this change, the consumer will be considered initialized in the
ProduceConsumeValidate tests once its partitions have been assigned.

Author: Apurva Mehta <apurva.1618@gmail.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2347 from apurvam/KAFKA-4588-fix-race-between-producer-consumer-start

(cherry picked from commit d0932b0286d8e69a704211aeaba9fa9503c0fb42)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 core/src/main/scala/kafka/tools/JmxTool.scala | 35 +++++++++++++++++--
 tests/kafkatest/services/console_consumer.py  | 34 ++++++++++++++++--
 tests/kafkatest/services/monitor/jmx.py       |  6 ++--
 tests/kafkatest/tests/core/throttling_test.py |  5 ++-
 .../tests/produce_consume_validate.py         | 20 +++++++++--
 5 files changed, 89 insertions(+), 11 deletions(-)

diff --git a/core/src/main/scala/kafka/tools/JmxTool.scala b/core/src/main/scala/kafka/tools/JmxTool.scala
index 3538874d5f2d9..5a672aaebfcce 100644
--- a/core/src/main/scala/kafka/tools/JmxTool.scala
+++ b/core/src/main/scala/kafka/tools/JmxTool.scala
@@ -28,6 +28,13 @@ import scala.collection.mutable
 import scala.math._
 import kafka.utils.{CommandLineUtils, Logging}
 
+
+/**
+  * A program for reading JMX metrics from a given endpoint.
+  *
+  * This tool only works reliably if the JmxServer is fully initialized prior to invoking the tool. See KAFKA-4620 for
+  * details.
+  */
 object JmxTool extends Logging {
 
   def main(args: Array[String]) {
@@ -80,8 +87,32 @@ object JmxTool extends Logging {
     val attributesWhitelist = if(attributesWhitelistExists) Some(options.valueOf(attributesOpt).split(",")) else None
     val dateFormatExists = options.has(dateFormatOpt)
     val dateFormat = if(dateFormatExists) Some(new SimpleDateFormat(options.valueOf(dateFormatOpt))) else None
-    val jmxc = JMXConnectorFactory.connect(url, null)
-    val mbsc = jmxc.getMBeanServerConnection()
+
+    var jmxc: JMXConnector = null
+    var mbsc: MBeanServerConnection = null
+    var retries = 0
+    val maxNumRetries = 10
+    var connected = false
+    while (retries < maxNumRetries && !connected) {
+      try {
+        System.err.println(s"Trying to connect to JMX url: $url.")
+        jmxc = JMXConnectorFactory.connect(url, null)
+        mbsc = jmxc.getMBeanServerConnection
+        connected = true
+      } catch {
+        case e : Exception =>
+          System.err.println(s"Could not connect to JMX url: $url. Exception ${e.getMessage}.")
+          e.printStackTrace()
+          retries += 1
+          Thread.sleep(500)
+      }
+    }
+
+    if (!connected) {
+      System.err.println(s"Could not connect to JMX url $url after $maxNumRetries retries.")
+      System.err.println("Exiting.")
+      sys.exit(1)
+    }
 
     val queries: Iterable[ObjectName] =
       if(options.has(objectNameOpt))
diff --git a/tests/kafkatest/services/console_consumer.py b/tests/kafkatest/services/console_consumer.py
index 94acb65bd0b8b..d55d012e7f491 100644
--- a/tests/kafkatest/services/console_consumer.py
+++ b/tests/kafkatest/services/console_consumer.py
@@ -73,6 +73,8 @@ class ConsoleConsumer(KafkaPathResolverMixin, JmxMixin, BackgroundThreadService)
     LOG_FILE = os.path.join(LOG_DIR, "console_consumer.log")
     LOG4J_CONFIG = os.path.join(PERSISTENT_ROOT, "tools-log4j.properties")
     CONFIG_FILE = os.path.join(PERSISTENT_ROOT, "console_consumer.properties")
+    JMX_TOOL_LOG = "/mnt/jmx_tool.log"
+    JMX_TOOL_ERROR_LOG = "/mnt/jmx_tool.err.log"
 
     logs = {
         "consumer_stdout": {
@@ -83,7 +85,13 @@ class ConsoleConsumer(KafkaPathResolverMixin, JmxMixin, BackgroundThreadService)
             "collect_default": False},
         "consumer_log": {
             "path": LOG_FILE,
-            "collect_default": True}
+            "collect_default": True},
+        "jmx_log": {
+            "path" : JMX_TOOL_LOG,
+            "collect_default": False},
+        "jmx_err_log": {
+            "path": JMX_TOOL_ERROR_LOG,
+            "collect_default": False}
     }
 
     def __init__(self, context, num_nodes, kafka, topic, group_id="test-consumer-group", new_consumer=True,
@@ -245,11 +253,12 @@ def _worker(self, idx, node):
         first_line = next(consumer_output, None)
 
         if first_line is not None:
+            self.logger.debug("collecting following jmx objects: %s", self.jmx_object_names)
+            self.init_jmx_attributes()
             self.start_jmx_tool(idx, node)
 
             for line in itertools.chain([first_line], consumer_output):
                 msg = line.strip()
-
                 if msg == "shutdown_complete":
                     # Note that we can only rely on shutdown_complete message if running 0.10.0 or greater
                     if node in self.clean_shutdown_nodes:
@@ -281,3 +290,24 @@ def clean_node(self, node):
         node.account.kill_process("java", clean_shutdown=False, allow_fail=True)
         node.account.ssh("rm -rf %s" % ConsoleConsumer.PERSISTENT_ROOT, allow_fail=False)
         self.security_config.clean_node(node)
+
+    def has_partitions_assigned(self, node):
+       if self.new_consumer is False:
+          return False
+       idx = self.idx(node)
+       self.init_jmx_attributes()
+       self.start_jmx_tool(idx, node)
+       self.read_jmx_output(idx, node)
+       if not self.assigned_partitions_jmx_attr in self.maximum_jmx_value:
+           return False
+       self.logger.debug("Number of partitions assigned %f" % self.maximum_jmx_value[self.assigned_partitions_jmx_attr])
+       return self.maximum_jmx_value[self.assigned_partitions_jmx_attr] > 0.0
+
+    def init_jmx_attributes(self):
+        if self.new_consumer is True:
+            if self.jmx_object_names is None:
+                self.jmx_object_names = []
+                self.jmx_object_names += ["kafka.consumer:type=consumer-coordinator-metrics,client-id=%s" % self.client_id]
+                self.jmx_attributes += ["assigned-partitions"]
+                self.assigned_partitions_jmx_attr = "kafka.consumer:type=consumer-coordinator-metrics,client-id=%s:assigned-partitions" % self.client_id
+
diff --git a/tests/kafkatest/services/monitor/jmx.py b/tests/kafkatest/services/monitor/jmx.py
index e71040bb5de30..e64d03afd48d7 100644
--- a/tests/kafkatest/services/monitor/jmx.py
+++ b/tests/kafkatest/services/monitor/jmx.py
@@ -35,6 +35,7 @@ def __init__(self, num_nodes, jmx_object_names=None, jmx_attributes=None):
         self.average_jmx_value = {}  # map from object_attribute_name to average value observed over time
 
         self.jmx_tool_log = "/mnt/jmx_tool.log"
+        self.jmx_tool_err_log = "/mnt/jmx_tool.err.log"
 
     def clean_node(self, node):
         node.account.kill_process("jmx", clean_shutdown=False, allow_fail=True)
@@ -55,11 +56,12 @@ def start_jmx_tool(self, idx, node):
             cmd += " --object-name %s" % jmx_object_name
         for jmx_attribute in self.jmx_attributes:
             cmd += " --attributes %s" % jmx_attribute
-        cmd += " >> %s &" % self.jmx_tool_log
+        cmd += " 1>> %s" % self.jmx_tool_log
+        cmd += " 2>> %s &" % self.jmx_tool_err_log
 
         self.logger.debug("%s: Start JmxTool %d command: %s" % (node.account, idx, cmd))
         node.account.ssh(cmd, allow_fail=False)
-        wait_until(lambda: self._jmx_has_output(node), timeout_sec=5, backoff_sec=.5, err_msg="%s: Jmx tool took too long to start" % node.account)
+        wait_until(lambda: self._jmx_has_output(node), timeout_sec=10, backoff_sec=.5, err_msg="%s: Jmx tool took too long to start" % node.account)
         self.started[idx-1] = True
 
     def _jmx_has_output(self, node):
diff --git a/tests/kafkatest/tests/core/throttling_test.py b/tests/kafkatest/tests/core/throttling_test.py
index 80b5658ac3029..17a60ea5f7200 100644
--- a/tests/kafkatest/tests/core/throttling_test.py
+++ b/tests/kafkatest/tests/core/throttling_test.py
@@ -15,7 +15,7 @@
 
 import time
 import math
-from ducktape.mark import parametrize,ignore
+from ducktape.mark import parametrize
 from ducktape.mark.resource import cluster
 from ducktape.utils.util import wait_until
 
@@ -138,10 +138,9 @@ def reassign_partitions(self, bounce_brokers, throttle):
                 estimated_throttled_time,
                 time_taken))
 
-    @ignore
     @cluster(num_nodes=10)
-    @parametrize(bounce_brokers=False)
     @parametrize(bounce_brokers=True)
+    @parametrize(bounce_brokers=False)
     def test_throttled_reassignment(self, bounce_brokers):
         security_protocol = 'PLAINTEXT'
         self.kafka.security_protocol = security_protocol
diff --git a/tests/kafkatest/tests/produce_consume_validate.py b/tests/kafkatest/tests/produce_consume_validate.py
index 801ccde2e4e94..cad9150fcd0a0 100644
--- a/tests/kafkatest/tests/produce_consume_validate.py
+++ b/tests/kafkatest/tests/produce_consume_validate.py
@@ -15,7 +15,7 @@
 
 from ducktape.tests.test import Test
 from ducktape.utils.util import wait_until
-
+import time
 
 class ProduceConsumeValidateTest(Test):
     """This class provides a shared template for tests which follow the common pattern of:
@@ -50,12 +50,28 @@ def start_producer_and_consumer(self):
         # Start background producer and consumer
         self.consumer.start()
         if (self.consumer_init_timeout_sec > 0):
-            self.logger.debug("Waiting %ds for the consumer to fork.",
+            self.logger.debug("Waiting %ds for the consumer to initialize.",
                               self.consumer_init_timeout_sec)
+            start = int(time.time())
             wait_until(lambda: self.consumer.alive(self.consumer.nodes[0]) is True,
                        timeout_sec=self.consumer_init_timeout_sec,
                        err_msg="Consumer process took more than %d s to fork" %\
                        self.consumer_init_timeout_sec)
+            end = int(time.time())
+            # If `JMXConnectFactory.connect` is invoked during the
+            # initialization of the JMX server, it may fail to throw the
+            # specified IOException back to the calling code. The sleep is a
+            # workaround that should allow initialization to complete before we
+            # try to connect. See KAFKA-4620 for more details.
+            time.sleep(1)
+            remaining_time = self.consumer_init_timeout_sec - (end - start)
+            if remaining_time < 0 :
+                remaining_time = 0
+            if self.consumer.new_consumer is True:
+                wait_until(lambda: self.consumer.has_partitions_assigned(self.consumer.nodes[0]) is True,
+                           timeout_sec=remaining_time,
+                           err_msg="Consumer process took more than %d s to have partitions assigned" %\
+                           remaining_time)
 
         self.producer.start()
         wait_until(lambda: self.producer.num_acked > 5,

From f4276b7cfb2aefd61a937b7138094b936e6bceca Mon Sep 17 00:00:00 2001
From: Jan Lukavsky <jan.lukavsky@o2.cz>
Date: Mon, 6 Feb 2017 11:47:45 -0800
Subject: [PATCH 089/177] KAFKA-4728; KafkaConsumer#commitSync should copy its
 input

Author: Jan Lukavsky <jan.lukavsky@o2.cz>

Reviewers: Jason Gustafson <jason@confluent.io>

Closes #2491 from je-ik/KAFKA-4728

(cherry picked from commit b31a7a9022bfb645cb61e6fbc0b22829108b3a3f)
Signed-off-by: Jason Gustafson <jason@confluent.io>
---
 .../java/org/apache/kafka/clients/consumer/KafkaConsumer.java | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
index ed3d6070ed574..d125e7ee5b3ca 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
@@ -1088,7 +1088,7 @@ public boolean shouldBlock() {
     public void commitSync() {
         acquire();
         try {
-            commitSync(subscriptions.allConsumed());
+            coordinator.commitOffsetsSync(subscriptions.allConsumed(), Long.MAX_VALUE);
         } finally {
             release();
         }
@@ -1122,7 +1122,7 @@ public void commitSync() {
     public void commitSync(final Map<TopicPartition, OffsetAndMetadata> offsets) {
         acquire();
         try {
-            coordinator.commitOffsetsSync(offsets, Long.MAX_VALUE);
+            coordinator.commitOffsetsSync(new HashMap<>(offsets), Long.MAX_VALUE);
         } finally {
             release();
         }

From 13a09557a4949cb795bc2dec07a2ae488fd273cb Mon Sep 17 00:00:00 2001
From: Edoardo Comar <ecomar@uk.ibm.com>
Date: Mon, 6 Feb 2017 12:23:24 -0800
Subject: [PATCH 090/177] KAFKA-4441; Monitoring incorrect during topic
 creation and deletion

OfflinePartitionsCount PreferredReplicaImbalanceCount metrics check for
topic being deleted

Added integration test which polls the metrics while topics are being
created and deleted

Developed with mimaison

Author: Edoardo Comar <ecomar@uk.ibm.com>

Reviewers: Dong Lin <lindong28@gmail.com>, Ismael Juma <ismael@juma.me.uk>, Jun Rao <junrao@gmail.com>

Closes #2325 from edoardocomar/KAFKA-4441

(cherry picked from commit 48aec6ef1e8065bd14e54172d6443144fb80738b)
Signed-off-by: Jun Rao <junrao@gmail.com>
---
 .../main/scala/kafka/cluster/Replica.scala    |   5 +-
 .../kafka/controller/KafkaController.scala    |  10 +-
 ...tricsDuringTopicCreationDeletionTest.scala | 161 ++++++++++++++++++
 3 files changed, 172 insertions(+), 4 deletions(-)
 create mode 100644 core/src/test/scala/unit/kafka/integration/MetricsDuringTopicCreationDeletionTest.scala

diff --git a/core/src/main/scala/kafka/cluster/Replica.scala b/core/src/main/scala/kafka/cluster/Replica.scala
index 346e5d60ea43f..8597b06cdbbce 100644
--- a/core/src/main/scala/kafka/cluster/Replica.scala
+++ b/core/src/main/scala/kafka/cluster/Replica.scala
@@ -68,9 +68,9 @@ class Replica(val brokerId: Int,
    */
   def updateLogReadResult(logReadResult : LogReadResult) {
     if (logReadResult.info.fetchOffsetMetadata.messageOffset >= logReadResult.leaderLogEndOffset)
-      _lastCaughtUpTimeMs = logReadResult.fetchTimeMs
+      _lastCaughtUpTimeMs = math.max(_lastCaughtUpTimeMs, logReadResult.fetchTimeMs)
     else if (logReadResult.info.fetchOffsetMetadata.messageOffset >= lastFetchLeaderLogEndOffset)
-      _lastCaughtUpTimeMs = lastFetchTimeMs
+      _lastCaughtUpTimeMs = math.max(_lastCaughtUpTimeMs, lastFetchTimeMs)
 
     logEndOffset = logReadResult.info.fetchOffsetMetadata
     lastFetchLeaderLogEndOffset = logReadResult.leaderLogEndOffset
@@ -130,6 +130,7 @@ class Replica(val brokerId: Int,
     replicaString.append("; Topic: " + partition.topic)
     replicaString.append("; Partition: " + partition.partitionId)
     replicaString.append("; isLocal: " + isLocal)
+    replicaString.append("; lastCaughtUpTimeMs: " + lastCaughtUpTimeMs)
     if (isLocal) replicaString.append("; Highwatermark: " + highWatermark)
     replicaString.toString
   }
diff --git a/core/src/main/scala/kafka/controller/KafkaController.scala b/core/src/main/scala/kafka/controller/KafkaController.scala
index e38adf891fbe2..774316b9f613f 100644
--- a/core/src/main/scala/kafka/controller/KafkaController.scala
+++ b/core/src/main/scala/kafka/controller/KafkaController.scala
@@ -188,7 +188,10 @@ class KafkaController(val config: KafkaConfig, zkUtils: ZkUtils, val brokerState
           if (!isActive)
             0
           else
-            controllerContext.partitionLeadershipInfo.count(p => !controllerContext.liveOrShuttingDownBrokerIds.contains(p._2.leaderAndIsr.leader))
+            controllerContext.partitionLeadershipInfo.count(p => 
+              (!controllerContext.liveOrShuttingDownBrokerIds.contains(p._2.leaderAndIsr.leader))
+              && (!deleteTopicManager.isTopicQueuedUpForDeletion(p._1.topic))
+            )
         }
       }
     }
@@ -203,7 +206,10 @@ class KafkaController(val config: KafkaConfig, zkUtils: ZkUtils, val brokerState
             0
           else
             controllerContext.partitionReplicaAssignment.count {
-              case (topicPartition, replicas) => controllerContext.partitionLeadershipInfo(topicPartition).leaderAndIsr.leader != replicas.head
+              case (topicPartition, replicas) => 
+                (controllerContext.partitionLeadershipInfo(topicPartition).leaderAndIsr.leader != replicas.head 
+                && (!deleteTopicManager.isTopicQueuedUpForDeletion(topicPartition.topic))
+                )
             }
         }
       }
diff --git a/core/src/test/scala/unit/kafka/integration/MetricsDuringTopicCreationDeletionTest.scala b/core/src/test/scala/unit/kafka/integration/MetricsDuringTopicCreationDeletionTest.scala
new file mode 100644
index 0000000000000..19a0f9d776cd7
--- /dev/null
+++ b/core/src/test/scala/unit/kafka/integration/MetricsDuringTopicCreationDeletionTest.scala
@@ -0,0 +1,161 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package kafka.integration
+
+import java.util.Properties
+import kafka.server.KafkaConfig
+import kafka.utils.{Logging, TestUtils}
+import scala.collection.JavaConverters.mapAsScalaMapConverter
+
+import org.junit.{Before, Test}
+import com.yammer.metrics.Metrics
+import com.yammer.metrics.core.Gauge
+
+
+class MetricsDuringTopicCreationDeletionTest extends KafkaServerTestHarness with Logging {
+
+  private val nodesNum = 3
+  private val topicName = "topic"
+  private val topicNum = 2
+  private val replicationFactor = 3
+  private val partitionNum = 3
+  private val createDeleteIterations = 3
+  
+  private val overridingProps = new Properties
+  overridingProps.put(KafkaConfig.DeleteTopicEnableProp, "true")
+  overridingProps.put(KafkaConfig.AutoCreateTopicsEnableProp, "false")
+  // speed up the test for UnderReplicatedPartitions 
+  // which relies on the ISR expiry thread to execute concurrently with topic creation
+  overridingProps.put(KafkaConfig.ReplicaLagTimeMaxMsProp, "2000") 
+
+  private val testedMetrics = List("OfflinePartitionsCount","PreferredReplicaImbalanceCount","UnderReplicatedPartitions")
+  private val topics = List.tabulate(topicNum) (n => topicName + n)
+
+  @volatile private var running = true
+  
+  override def generateConfigs() = TestUtils.createBrokerConfigs(nodesNum, zkConnect)
+    .map(KafkaConfig.fromProps(_, overridingProps))
+
+  @Before
+  override def setUp {
+    // Do some Metrics Registry cleanup by removing the metrics that this test checks. 
+    // This is a test workaround to the issue that prior harness runs may have left a populated registry.
+    // see https://issues.apache.org/jira/browse/KAFKA-4605
+    for (m <- (testedMetrics)) {
+        Metrics.defaultRegistry.allMetrics.asScala
+        .filterKeys(k => k.getName.endsWith(m))
+        .headOption match {
+           case Some(e) => Metrics.defaultRegistry.removeMetric(e._1)
+           case None =>
+        }
+    }
+    
+    super.setUp
+  }
+
+  /*
+   * checking all metrics we care in a single test is faster though it would be more elegant to have 3 @Test methods
+   */
+  @Test
+  def testMetricsDuringTopicCreateDelete() {
+
+    // For UnderReplicatedPartitions, because of https://issues.apache.org/jira/browse/KAFKA-4605
+    // we can't access the metrics value of each server. So instead we directly invoke the method 
+    // replicaManager.underReplicatedPartitionCount() that defines the metrics value.
+    @volatile var underReplicatedPartitionCount = 0
+
+    // For OfflinePartitionsCount and PreferredReplicaImbalanceCount even with https://issues.apache.org/jira/browse/KAFKA-4605
+    // the test has worked reliably because the metric that gets triggered is the one generated by the first started server (controller)
+    val offlinePartitionsCountGauge = getGauge("OfflinePartitionsCount")
+    @volatile var offlinePartitionsCount = offlinePartitionsCountGauge.value
+    assert(offlinePartitionsCount == 0)
+
+    val preferredReplicaImbalanceCountGauge = getGauge("PreferredReplicaImbalanceCount")
+    @volatile var preferredReplicaImbalanceCount = preferredReplicaImbalanceCountGauge.value
+    assert(preferredReplicaImbalanceCount == 0)
+
+    // Thread checking the metric continuously
+    running = true
+    val thread = new Thread(new Runnable {
+      def run() {
+        while (running) {
+          for ( s <- servers if running) {
+            underReplicatedPartitionCount = s.replicaManager.underReplicatedPartitionCount
+            if (underReplicatedPartitionCount > 0) {
+              running = false
+            }
+          }
+
+          preferredReplicaImbalanceCount = preferredReplicaImbalanceCountGauge.value
+          if (preferredReplicaImbalanceCount > 0) {
+             running = false
+          }
+
+          offlinePartitionsCount = offlinePartitionsCountGauge.value
+          if (offlinePartitionsCount > 0) {
+             running = false
+          }
+        }
+      }
+    })
+    thread.start
+
+    // breakable loop that creates and deletes topics
+    createDeleteTopics()
+
+    // if the thread checking the gauge is still run, stop it
+    running = false;
+    thread.join
+    
+    assert(offlinePartitionsCount==0, "OfflinePartitionCount not 0: "+ offlinePartitionsCount)
+    assert(preferredReplicaImbalanceCount==0, "PreferredReplicaImbalanceCount not 0: " + preferredReplicaImbalanceCount)
+    assert(underReplicatedPartitionCount==0, "UnderReplicatedPartitionCount not 0: " + underReplicatedPartitionCount)
+  }
+
+  private def getGauge(metricName: String) = {
+    Metrics.defaultRegistry.allMetrics.asScala
+           .filterKeys(k => k.getName.endsWith(metricName))
+           .headOption
+           .getOrElse { fail( "Unable to find metric " + metricName ) }
+           ._2.asInstanceOf[Gauge[Int]]
+  }
+  
+  private def createDeleteTopics() {
+    for (l <- 1 to createDeleteIterations if running) {
+      // Create topics
+      for (t <- topics if running) {
+        try {
+          kafka.admin.AdminUtils.createTopic(zkUtils, t, partitionNum, replicationFactor)
+        } catch {
+          case e: Exception => e.printStackTrace
+        }
+      }
+      Thread.sleep(500)
+
+      // Delete topics
+      for (t <- topics if running) {
+          try {
+              kafka.admin.AdminUtils.deleteTopic(zkUtils, t)
+          } catch {
+          case e: Exception => e.printStackTrace
+          }
+      }
+      Thread.sleep(500)
+    }
+  }
+}

From 588c5667f2e460dfd23ea40da5b2ee958567308e Mon Sep 17 00:00:00 2001
From: Ewen Cheslack-Postava <me@ewencp.org>
Date: Mon, 6 Feb 2017 13:53:22 -0800
Subject: [PATCH 091/177] MINOR: Fix import for streams broker compatibility
 test to use new DEV_BRANCH constant

Author: Ewen Cheslack-Postava <me@ewencp.org>

Reviewers: Matthias J. Sax <matthias@confluent.io>, Guozhang Wang <wangguoz@gmail.com>

Closes #2508 from ewencp/minor-streams-compatibility-trunk-dev-branch

(cherry picked from commit 82e75b960737b50456e862f127f857832b22624e)
Signed-off-by: Ewen Cheslack-Postava <me@ewencp.org>
---
 tests/kafkatest/tests/streams/streams_broker_compatibility.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/kafkatest/tests/streams/streams_broker_compatibility.py b/tests/kafkatest/tests/streams/streams_broker_compatibility.py
index 7c7a751ecbc60..4a035a476d7df 100644
--- a/tests/kafkatest/tests/streams/streams_broker_compatibility.py
+++ b/tests/kafkatest/tests/streams/streams_broker_compatibility.py
@@ -20,7 +20,7 @@
 from kafkatest.services.streams import StreamsBrokerCompatibilityService
 from kafkatest.services.verifiable_consumer import VerifiableConsumer
 from kafkatest.services.zookeeper import ZookeeperService
-from kafkatest.version import TRUNK, LATEST_0_10_1, LATEST_0_10_0, KafkaVersion
+from kafkatest.version import DEV_BRANCH, LATEST_0_10_1, LATEST_0_10_0, KafkaVersion
 
 
 class StreamsBrokerCompatibility(Test):
@@ -55,7 +55,7 @@ def __init__(self, test_context):
     def setUp(self):
         self.zk.start()
 
-    @parametrize(broker_version=str(TRUNK))
+    @parametrize(broker_version=str(DEV_BRANCH))
     @parametrize(broker_version=str(LATEST_0_10_1))
     def test_compatible_brokers(self, broker_version):
         self.kafka.set_version(KafkaVersion(broker_version))

From 7bb1d2a44cab8209557e6427c61f05a00140b73e Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Mon, 6 Feb 2017 23:08:12 -0800
Subject: [PATCH 092/177] MINOR: fixed some JavaDoc typos

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2497 from mjsax/hofixJavaDocs0102
---
 .../kafka/streams/kstream/KStreamBuilder.java  | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java
index 28326892f6bf3..0a3304dc0cf3e 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KStreamBuilder.java
@@ -56,7 +56,7 @@ public class KStreamBuilder extends TopologyBuilder {
      * The default {@code "auto.offset.reset"} strategy and default key and value deserializers as specified in the
      * {@link StreamsConfig config} are used.
      * <p>
-     * If multiple topics are specified there are no ordering guaranteed for records from different topics.
+     * If multiple topics are specified there is no ordering guarantee for records from different topics.
      * <p>
      * Note that the specified input topics must be partitioned by key.
      * If this is not the case it is the user's responsibility to repartition the date before any key based operation
@@ -73,7 +73,7 @@ public <K, V> KStream<K, V> stream(final String... topics) {
      * Create a {@link KStream} from the specified topics.
      * The default key and value deserializers as specified in the {@link StreamsConfig config} are used.
      * <p>
-     * If multiple topics are specified there are no ordering guaranteed for records from different topics.
+     * If multiple topics are specified there is no ordering guarantee for records from different topics.
      * <p>
      * Note that the specified input topics must be partitioned by key.
      * If this is not the case it is the user's responsibility to repartition the date before any key based operation
@@ -132,7 +132,7 @@ public <K, V> KStream<K, V> stream(final AutoOffsetReset offsetReset, final Patt
      * Create a {@link KStream} from the specified topics.
      * The default {@code "auto.offset.reset"} strategy as specified in the {@link StreamsConfig config} is used.
      * <p>
-     * If multiple topics are specified there are no ordering guaranteed for records from different topics.
+     * If multiple topics are specified there is no ordering guarantee for records from different topics.
      * <p>
      * Note that the specified input topics must be partitioned by key.
      * If this is not the case it is the user's responsibility to repartition the date before any key based operation
@@ -153,7 +153,7 @@ public <K, V> KStream<K, V> stream(final Serde<K> keySerde, final Serde<V> valSe
     /**
      * Create a {@link KStream} from the specified topics.
      * <p>
-     * If multiple topics are specified there are no ordering guaranteed for records from different topics.
+     * If multiple topics are specified there is no ordering guarantee for records from different topics.
      * <p>
      * Note that the specified input topics must be partitioned by key.
      * If this is not the case it is the user's responsibility to repartition the date before any key based operation
@@ -240,7 +240,7 @@ public <K, V> KStream<K, V> stream(final AutoOffsetReset offsetReset,
      * {@link StreamsConfig config} are used.
      * Input {@link KeyValue records} with {@code null} key will be dropped.
      * <p>
-     * Note that the specified input topics must be partitioned by key.
+     * Note that the specified input topic must be partitioned by key.
      * If this is not the case the returned {@link KTable} will be corrupted.
      * <p>
      * The resulting {@link KTable} will be materialized in a local {@link KeyValueStore} with the given
@@ -273,7 +273,7 @@ public <K, V> KTable<K, V> table(final String topic,
      * The default key and value deserializers as specified in the {@link StreamsConfig config} are used.
      * Input {@link KeyValue records} with {@code null} key will be dropped.
      * <p>
-     * Note that the specified input topics must be partitioned by key.
+     * Note that the specified input topic must be partitioned by key.
      * If this is not the case the returned {@link KTable} will be corrupted.
      * <p>
      * The resulting {@link KTable} will be materialized in a local {@link KeyValueStore} with the given
@@ -309,7 +309,7 @@ public <K, V> KTable<K, V> table(final AutoOffsetReset offsetReset,
      * The default {@code "auto.offset.reset"} strategy as specified in the {@link StreamsConfig config} is used.
      * Input {@link KeyValue records} with {@code null} key will be dropped.
      * <p>
-     * Note that the specified input topics must be partitioned by key.
+     * Note that the specified input topic must be partitioned by key.
      * If this is not the case the returned {@link KTable} will be corrupted.
      * <p>
      * The resulting {@link KTable} will be materialized in a local {@link KeyValueStore} with the given
@@ -347,7 +347,7 @@ public <K, V> KTable<K, V> table(final Serde<K> keySerde,
      * Create a {@link KTable} for the specified topic.
      * Input {@link KeyValue records} with {@code null} key will be dropped.
      * <p>
-     * Note that the specified input topics must be partitioned by key.
+     * Note that the specified input topic must be partitioned by key.
      * If this is not the case the returned {@link KTable} will be corrupted.
      * <p>
      * The resulting {@link KTable} will be materialized in a local {@link KeyValueStore} with the given
@@ -492,7 +492,7 @@ public <K, V> GlobalKTable<K, V> globalTable(final Serde<K> keySerde,
     /**
      * Create a new instance of {@link KStream} by merging the given {@link KStream}s.
      * <p>
-     * There are nor ordering guaranteed for records from different {@link KStream}s.
+     * There is no ordering guarantee for records from different {@link KStream}s.
      *
      * @param streams the {@link KStream}s to be merged
      * @return a {@link KStream} containing all records of the given streams

From 6bdc0da9a53ffe527fe2f75439221087009d72c6 Mon Sep 17 00:00:00 2001
From: huxi <huxi@zhenrongbao.com>
Date: Tue, 7 Feb 2017 08:40:30 -0800
Subject: [PATCH 093/177] KAFKA-4727; A Production server configuration needs
 to be updated

1. Update value for queued.max.requests to 500
2. Removed invalid config 'controller.message.queue.size'
3. Removed flush configs including 'log.flush.interval.messages', 'log.flush.interval.ms' and 'log.flush.scheduler.interval.ms'

Author: huxi <huxi@zhenrongbao.com>

Reviewers: Grant Henke <granthenke@gmail.com>, Jun Rao <junrao@gmail.com>

Closes #2490 from amethystic/kafka4727_server_config_doc_update

(cherry picked from commit be98865dfcddd38e3e411d41126fa6049c509cae)
Signed-off-by: Jun Rao <junrao@gmail.com>
---
 docs/ops.html | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/docs/ops.html b/docs/ops.html
index c5f621287ad01..0bbcbec2c9c0c 100644
--- a/docs/ops.html
+++ b/docs/ops.html
@@ -551,7 +551,6 @@ <h4><a id="prodconfig" href="#prodconfig">A Production Server Config</a></h4>
   Here is our production server configuration:
   <pre>
   # Replication configurations
-  num.replica.fetchers=4
   replica.fetch.max.bytes=1048576
   replica.fetch.wait.max.ms=500
   replica.high.watermark.checkpoint.interval.ms=5000
@@ -560,7 +559,6 @@ <h4><a id="prodconfig" href="#prodconfig">A Production Server Config</a></h4>
   replica.lag.time.max.ms=10000
 
   controller.socket.timeout.ms=30000
-  controller.message.queue.size=10
 
   # Log configuration
   num.partitions=8
@@ -569,9 +567,6 @@ <h4><a id="prodconfig" href="#prodconfig">A Production Server Config</a></h4>
   log.index.interval.bytes=4096
   log.index.size.max.bytes=10485760
   log.retention.hours=168
-  log.flush.interval.ms=10000
-  log.flush.interval.messages=20000
-  log.flush.scheduler.interval.ms=2000
   log.roll.hours=168
   log.retention.check.interval.ms=300000
   log.segment.bytes=1073741824
@@ -586,7 +581,7 @@ <h4><a id="prodconfig" href="#prodconfig">A Production Server Config</a></h4>
   socket.request.max.bytes=104857600
   socket.receive.buffer.bytes=1048576
   socket.send.buffer.bytes=1048576
-  queued.max.requests=16
+  queued.max.requests=500
   fetch.purgatory.purge.interval.requests=100
   producer.purgatory.purge.interval.requests=100
   </pre>

From aca81877fbdaa17649ada327370526a713e751e4 Mon Sep 17 00:00:00 2001
From: Jiangjie Qin <becket.qin@gmail.com>
Date: Tue, 7 Feb 2017 08:43:02 -0800
Subject: [PATCH 094/177] KAFKA-4734; Trim the time index on old segments

Author: Jiangjie Qin <becket.qin@gmail.com>

Reviewers: Dong Lin <lindong28@gmail.com>, Jun Rao <junrao@gmail.com>

Closes #2501 from becketqin/KAFKA-4734

(cherry picked from commit 6cef4f5e4c3a73911a43378caf5cfc2736814333)
Signed-off-by: Jun Rao <junrao@gmail.com>
---
 core/src/main/scala/kafka/log/Log.scala          | 4 ++++
 core/src/test/scala/unit/kafka/log/LogTest.scala | 4 +++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/core/src/main/scala/kafka/log/Log.scala b/core/src/main/scala/kafka/log/Log.scala
index 25bb83d3f074f..417122c0d7977 100644
--- a/core/src/main/scala/kafka/log/Log.scala
+++ b/core/src/main/scala/kafka/log/Log.scala
@@ -206,6 +206,7 @@ class Log(@volatile var dir: File,
         val timeIndexFile = Log.timeIndexFilename(dir, start)
 
         val indexFileExists = indexFile.exists()
+        val timeIndexFileExists = timeIndexFile.exists()
         val segment = new LogSegment(dir = dir,
                                      startOffset = start,
                                      indexIntervalBytes = config.indexInterval,
@@ -217,6 +218,9 @@ class Log(@volatile var dir: File,
         if (indexFileExists) {
           try {
             segment.index.sanityCheck()
+            // Resize the time index file to 0 if it is newly created.
+            if (!timeIndexFileExists)
+              segment.timeIndex.resize(0)
             segment.timeIndex.sanityCheck()
           } catch {
             case e: java.lang.IllegalArgumentException =>
diff --git a/core/src/test/scala/unit/kafka/log/LogTest.scala b/core/src/test/scala/unit/kafka/log/LogTest.scala
index 08cdac5807176..9e0deb2dc075a 100755
--- a/core/src/test/scala/unit/kafka/log/LogTest.scala
+++ b/core/src/test/scala/unit/kafka/log/LogTest.scala
@@ -659,8 +659,10 @@ class LogTest extends JUnitSuite {
     // The rebuilt time index should be empty
     log = new Log(logDir, config, recoveryPoint = numMessages + 1, time.scheduler, time)
     val segArray = log.logSegments.toArray
-    for (i <- 0 until segArray.size - 1)
+    for (i <- 0 until segArray.size - 1) {
       assertEquals("The time index should be empty", 0, segArray(i).timeIndex.entries)
+      assertEquals("The time index file size should be 0", 0, segArray(i).timeIndex.file.length)
+    }
 
   }
 

From bec105d48a5cce57080fec949da48cb79f4c1994 Mon Sep 17 00:00:00 2001
From: Tim Carey-Smith <tim@spork.in>
Date: Tue, 7 Feb 2017 15:12:47 -0800
Subject: [PATCH 095/177] KAFKA-4725; Stop leaking messages in produce request
 body when requests are delayed

This change is in response to [KAFKA-4725](https://issues.apache.org/jira/browse/KAFKA-4725).

When a produce request is received, if the user/client is exceeding their produce quota, the response will be delayed until the quota is refilled appropriately.

Unfortunately, the request body is still referenced in the callback which in turn leaks the messages contained within the request.

This change allows the `KafkaApis` method to take ownership of the request body from the `RequestChannel.Request` object.

I am not sure whether this breaks other invariants which are assumed within other parts of Kafka.

Author: Tim Carey-Smith <tim@spork.in>

Reviewers: Ismael Juma <ismael@juma.me.uk>, Jun Rao <junrao@gmail.com>

Closes #2496 from halorgium/fix-throttled-response-leak

(cherry picked from commit 7f6bf5d44796ac14665d5ba8c2243f5d7f5d30bd)
Signed-off-by: Jun Rao <junrao@gmail.com>
---
 .../java/org/apache/kafka/common/requests/ProduceRequest.java    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/clients/src/main/java/org/apache/kafka/common/requests/ProduceRequest.java b/clients/src/main/java/org/apache/kafka/common/requests/ProduceRequest.java
index e4a2aae9272cd..bd3ae8ff3b531 100644
--- a/clients/src/main/java/org/apache/kafka/common/requests/ProduceRequest.java
+++ b/clients/src/main/java/org/apache/kafka/common/requests/ProduceRequest.java
@@ -160,6 +160,7 @@ public Map<TopicPartition, MemoryRecords> partitionRecords() {
     }
 
     public void clearPartitionRecords() {
+        struct.clear();
         partitionRecords.clear();
     }
 

From b75d37a2a97a6c75ceeb06914128fa7bc9176fe4 Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno@confluent.io>
Date: Wed, 8 Feb 2017 12:50:04 -0800
Subject: [PATCH 096/177] HOTFIX: renamed test so it is picked up by ducktape

Author: Eno Thereska <eno@confluent.io>

Reviewers: Matthias J. Sax, Guozhang Wang

Closes #2517 from enothereska/hotfix-broker-test

(cherry picked from commit e7c869e65d25dcf2d0a8f949da31c15d1d843950)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 ..._compatibility.py => streams_broker_compatibility_test.py} | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
 rename tests/kafkatest/tests/streams/{streams_broker_compatibility.py => streams_broker_compatibility_test.py} (98%)

diff --git a/tests/kafkatest/tests/streams/streams_broker_compatibility.py b/tests/kafkatest/tests/streams/streams_broker_compatibility_test.py
similarity index 98%
rename from tests/kafkatest/tests/streams/streams_broker_compatibility.py
rename to tests/kafkatest/tests/streams/streams_broker_compatibility_test.py
index 4a035a476d7df..d6e6c9a0d236e 100644
--- a/tests/kafkatest/tests/streams/streams_broker_compatibility.py
+++ b/tests/kafkatest/tests/streams/streams_broker_compatibility_test.py
@@ -25,8 +25,8 @@
 
 class StreamsBrokerCompatibility(Test):
     """
-    These tests validate that Streams v0.10.2+ can connect to older brokers v0.10+
-    and that Streams fails fast for pre-0.10 brokers
+    These tests validate that Streams v0.10.2+ can connect to older brokers v0.10.1+
+    and that Streams fails fast for pre-0.10.0 brokers
     """
 
     input = "brokerCompatibilitySourceTopic"

From 39f1a7d8c62fe2525d933e92a85fcd882cc770ce Mon Sep 17 00:00:00 2001
From: Alex Loddengaard <alexloddengaard@gmail.com>
Date: Wed, 8 Feb 2017 17:18:55 -0800
Subject: [PATCH 097/177] MINOR: changes to the production broker configuration
 docs.

Author: Alex Loddengaard <alexloddengaard@gmail.com>

Reviewers: Jun Rao <junrao@gmail.com>

Closes #2519 from alexlod/production-config-docs

(cherry picked from commit 8bd8751aa776990d1847e4d6ab187a0aea90c051)
Signed-off-by: Jun Rao <junrao@gmail.com>
---
 docs/ops.html | 53 +++++++++++++++++++--------------------------------
 1 file changed, 20 insertions(+), 33 deletions(-)

diff --git a/docs/ops.html b/docs/ops.html
index 0bbcbec2c9c0c..a3423a7032709 100644
--- a/docs/ops.html
+++ b/docs/ops.html
@@ -537,53 +537,40 @@ <h3><a id="datacenters" href="#datacenters">6.2 Datacenters</a></h3>
   <h3><a id="config" href="#config">6.3 Kafka Configuration</a></h3>
 
   <h4><a id="clientconfig" href="#clientconfig">Important Client Configurations</a></h4>
-  The most important producer configurations control
+  The most important old Scala producer configurations control
   <ul>
+      <li>acks</li>
       <li>compression</li>
       <li>sync vs async production</li>
       <li>batch size (for async producers)</li>
   </ul>
+  The most important new Java producer configurations control
+  <ul>
+      <li>acks</li>
+      <li>compression</li>
+      <li>batch size</li>
+  </ul>
   The most important consumer configuration is the fetch size.
   <p>
   All configurations are documented in the <a href="#configuration">configuration</a> section.
   <p>
   <h4><a id="prodconfig" href="#prodconfig">A Production Server Config</a></h4>
-  Here is our production server configuration:
+  Here is an example production server configuration:
   <pre>
-  # Replication configurations
-  replica.fetch.max.bytes=1048576
-  replica.fetch.wait.max.ms=500
-  replica.high.watermark.checkpoint.interval.ms=5000
-  replica.socket.timeout.ms=30000
-  replica.socket.receive.buffer.bytes=65536
-  replica.lag.time.max.ms=10000
-
-  controller.socket.timeout.ms=30000
+  # ZooKeeper
+  zookeeper.connect=[list of ZooKeeper servers]
 
   # Log configuration
   num.partitions=8
-  message.max.bytes=1000000
-  auto.create.topics.enable=true
-  log.index.interval.bytes=4096
-  log.index.size.max.bytes=10485760
-  log.retention.hours=168
-  log.roll.hours=168
-  log.retention.check.interval.ms=300000
-  log.segment.bytes=1073741824
-
-  # ZK configuration
-  zookeeper.connection.timeout.ms=6000
-  zookeeper.sync.time.ms=2000
-
-  # Socket server configuration
-  num.io.threads=8
-  num.network.threads=8
-  socket.request.max.bytes=104857600
-  socket.receive.buffer.bytes=1048576
-  socket.send.buffer.bytes=1048576
-  queued.max.requests=500
-  fetch.purgatory.purge.interval.requests=100
-  producer.purgatory.purge.interval.requests=100
+  default.replication.factor=3
+  log.dir=[List of directories. Kafka should have its own dedicated disk(s) or SSD(s).]
+
+  # Other configurations
+  broker.id=[An integer. Start with 0 and increment by 1 for each new broker.]
+  listeners=[list of listeners]
+  auto.create.topics.enable=false
+  min.insync.replicas=2
+  queued.max.requests=[number of concurrent requests]
   </pre>
 
   Our client configuration varies a fair amount between different use cases.

From bad631a7c6d06a9bf3985af0881538a5dda60d59 Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno@confluent.io>
Date: Thu, 9 Feb 2017 14:02:33 -0800
Subject: [PATCH 098/177] KAFKA-4716: Fix case when controller cannot be
 reached

Author: Eno Thereska <eno@confluent.io>

Reviewers: Dan Norwood, Ismael Juma, Guozhang Wang

Closes #2526 from enothereska/0.10.2-KAFKA-4716
---
 .../internals/InternalTopicManager.java       | 13 ++---
 .../internals/StreamsKafkaClient.java         | 52 +++++++++++++------
 .../internals/InternalTopicManagerTest.java   | 13 +++--
 3 files changed, 52 insertions(+), 26 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java
index a9bd5d7e6ccff..52536e11d4bf2 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java
@@ -58,9 +58,10 @@ public InternalTopicManager(final StreamsKafkaClient streamsKafkaClient, final i
     public void makeReady(final Map<InternalTopicConfig, Integer> topics) {
         for (int i = 0; i < MAX_TOPIC_READY_TRY; i++) {
             try {
-                final Map<String, Integer> existingTopicPartitions = fetchExistingPartitionCountByTopic();
+                final MetadataResponse metadata = streamsKafkaClient.fetchMetadata();
+                final Map<String, Integer> existingTopicPartitions = fetchExistingPartitionCountByTopic(metadata);
                 final Map<InternalTopicConfig, Integer> topicsToBeCreated = validateTopicPartitions(topics, existingTopicPartitions);
-                streamsKafkaClient.createTopics(topicsToBeCreated, replicationFactor, windowChangeLogAdditionalRetention);
+                streamsKafkaClient.createTopics(topicsToBeCreated, replicationFactor, windowChangeLogAdditionalRetention, metadata);
                 return;
             } catch (StreamsException ex) {
                 log.warn("Could not create internal topics: " + ex.getMessage() + " Retry #" + i);
@@ -73,7 +74,8 @@ public void makeReady(final Map<InternalTopicConfig, Integer> topics) {
      * Get the number of partitions for the given topics
      */
     public Map<String, Integer> getNumPartitions(final Set<String> topics) {
-        final Map<String, Integer> existingTopicPartitions = fetchExistingPartitionCountByTopic();
+        final MetadataResponse metadata = streamsKafkaClient.fetchMetadata();
+        final Map<String, Integer> existingTopicPartitions = fetchExistingPartitionCountByTopic(metadata);
         existingTopicPartitions.keySet().retainAll(topics);
 
         return existingTopicPartitions;
@@ -108,11 +110,10 @@ private Map<InternalTopicConfig, Integer> validateTopicPartitions(final Map<Inte
         return topicsToBeCreated;
     }
 
-    private Map<String, Integer> fetchExistingPartitionCountByTopic() {
+    private Map<String, Integer> fetchExistingPartitionCountByTopic(final MetadataResponse metadata) {
         // The names of existing topics and corresponding partition counts
         final Map<String, Integer> existingPartitionCountByTopic = new HashMap<>();
-
-        Collection<MetadataResponse.TopicMetadata> topicsMetadata = streamsKafkaClient.fetchTopicsMetadata();
+        final Collection<MetadataResponse.TopicMetadata> topicsMetadata = metadata.topicMetadata();
 
         for (MetadataResponse.TopicMetadata topicMetadata: topicsMetadata) {
             existingPartitionCountByTopic.put(topicMetadata.topic(), topicMetadata.partitionMetadata().size());
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
index 8a9b255115c0e..94d8854901a63 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
@@ -47,7 +47,7 @@
 
 import java.io.IOException;
 import java.net.InetSocketAddress;
-import java.util.Collection;
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.LinkedHashMap;
 import java.util.List;
@@ -137,7 +137,8 @@ public void close() throws IOException {
     /**
      * Create a set of new topics using batch request.
      */
-    public void createTopics(final Map<InternalTopicConfig, Integer> topicsMap, final int replicationFactor, final long windowChangeLogAdditionalRetention) {
+    public void createTopics(final Map<InternalTopicConfig, Integer> topicsMap, final int replicationFactor,
+                             final long windowChangeLogAdditionalRetention, final MetadataResponse metadata) {
 
         final Map<String, CreateTopicsRequest.TopicDetails> topicRequestDetails = new HashMap<>();
         for (InternalTopicConfig internalTopicConfig:topicsMap.keySet()) {
@@ -155,7 +156,7 @@ public void createTopics(final Map<InternalTopicConfig, Integer> topicsMap, fina
         }
 
         final ClientRequest clientRequest = kafkaClient.newClientRequest(
-            getBrokerId(),
+            getControllerReadyBrokerId(metadata),
             new CreateTopicsRequest.Builder(
                 topicRequestDetails,
                 streamsConfig.getInt(StreamsConfig.REQUEST_TIMEOUT_MS_CONFIG)),
@@ -180,15 +181,13 @@ public void createTopics(final Map<InternalTopicConfig, Integer> topicsMap, fina
         }
     }
 
-    private String getBrokerId() {
+    /**
+     *
+     * @param nodes List of nodes to pick from.
+     * @return The first node that is ready to accept requests.
+     */
+    private String ensureOneNodeIsReady(final List<Node> nodes) {
         String brokerId = null;
-        final Metadata metadata = new Metadata(
-            streamsConfig.getLong(StreamsConfig.RETRY_BACKOFF_MS_CONFIG),
-            streamsConfig.getLong(StreamsConfig.METADATA_MAX_AGE_CONFIG));
-        final List<InetSocketAddress> addresses = ClientUtils.parseAndValidateAddresses(streamsConfig.getList(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG));
-        metadata.update(Cluster.bootstrap(addresses), Time.SYSTEM.milliseconds());
-
-        final List<Node> nodes = metadata.fetch().nodes();
         final long readyTimeout = Time.SYSTEM.milliseconds() + streamsConfig.getInt(StreamsConfig.REQUEST_TIMEOUT_MS_CONFIG);
         boolean foundNode = false;
         while (!foundNode && (Time.SYSTEM.milliseconds() < readyTimeout)) {
@@ -207,6 +206,29 @@ private String getBrokerId() {
         return brokerId;
     }
 
+    /**
+     *
+     * @return if Id of the controller node, or an exception if no controller is found or
+     * controller is not ready
+     */
+    private String getControllerReadyBrokerId(final MetadataResponse metadata) {
+        return ensureOneNodeIsReady(Collections.singletonList(metadata.controller()));
+    }
+
+    /**
+     * @return the Id of any broker that is ready, or an exception if no broker is ready.
+     */
+    private String getAnyReadyBrokerId() {
+        final Metadata metadata = new Metadata(
+            streamsConfig.getLong(StreamsConfig.RETRY_BACKOFF_MS_CONFIG),
+            streamsConfig.getLong(StreamsConfig.METADATA_MAX_AGE_CONFIG));
+        final List<InetSocketAddress> addresses = ClientUtils.parseAndValidateAddresses(streamsConfig.getList(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG));
+        metadata.update(Cluster.bootstrap(addresses), Time.SYSTEM.milliseconds());
+
+        final List<Node> nodes = metadata.fetch().nodes();
+        return ensureOneNodeIsReady(nodes);
+    }
+
     private ClientResponse sendRequest(final ClientRequest clientRequest) {
         kafkaClient.send(clientRequest, Time.SYSTEM.milliseconds());
         final long responseTimeout = Time.SYSTEM.milliseconds() + streamsConfig.getInt(StreamsConfig.REQUEST_TIMEOUT_MS_CONFIG);
@@ -234,10 +256,10 @@ private ClientResponse sendRequest(final ClientRequest clientRequest) {
     /**
      * Fetch the metadata for all topics
      */
-    public Collection<MetadataResponse.TopicMetadata> fetchTopicsMetadata() {
+    public MetadataResponse fetchMetadata() {
 
         final ClientRequest clientRequest = kafkaClient.newClientRequest(
-            getBrokerId(),
+            getAnyReadyBrokerId(),
             new MetadataRequest.Builder(null),
             Time.SYSTEM.milliseconds(),
             true);
@@ -250,7 +272,7 @@ public Collection<MetadataResponse.TopicMetadata> fetchTopicsMetadata() {
                 "Expected MetadataResponse but received " + clientResponse.responseBody().getClass().getName());
         }
         final MetadataResponse metadataResponse = (MetadataResponse) clientResponse.responseBody();
-        return metadataResponse.topicMetadata();
+        return metadataResponse;
     }
 
     /**
@@ -263,7 +285,7 @@ public Collection<MetadataResponse.TopicMetadata> fetchTopicsMetadata() {
      */
     public void checkBrokerCompatibility() throws StreamsException {
         final ClientRequest clientRequest = kafkaClient.newClientRequest(
-            getBrokerId(),
+            getAnyReadyBrokerId(),
             new ApiVersionsRequest.Builder(),
             Time.SYSTEM.milliseconds(),
             true);
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java
index 548cb45bc9719..69b3c46d162bf 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java
@@ -30,7 +30,6 @@
 
 import java.io.IOException;
 import java.util.ArrayList;
-import java.util.Collection;
 import java.util.Collections;
 import java.util.Map;
 import java.util.Properties;
@@ -96,15 +95,19 @@ private class MockStreamKafkaClient extends StreamsKafkaClient {
         }
 
         @Override
-        public void createTopics(final Map<InternalTopicConfig, Integer> topicsMap, final int replicationFactor, final long windowChangeLogAdditionalRetention) {
+        public void createTopics(final Map<InternalTopicConfig, Integer> topicsMap, final int replicationFactor,
+                                 final long windowChangeLogAdditionalRetention, final MetadataResponse metadata) {
             // do nothing
         }
 
         @Override
-        public Collection<MetadataResponse.TopicMetadata> fetchTopicsMetadata() {
-            MetadataResponse.PartitionMetadata partitionMetadata = new MetadataResponse.PartitionMetadata(Errors.NONE, 1, null, new ArrayList<Node>(), new ArrayList<Node>());
+        public MetadataResponse fetchMetadata() {
+            Node node = new Node(1, "host1", 1001);
+            MetadataResponse.PartitionMetadata partitionMetadata = new MetadataResponse.PartitionMetadata(Errors.NONE, 1, node, new ArrayList<Node>(), new ArrayList<Node>());
             MetadataResponse.TopicMetadata topicMetadata = new MetadataResponse.TopicMetadata(Errors.NONE, topic, true, Collections.singletonList(partitionMetadata));
-            return Collections.singleton(topicMetadata);
+            MetadataResponse response = new MetadataResponse(Collections.<Node>emptyList(), null, MetadataResponse.NO_CONTROLLER_ID,
+                Collections.singletonList(topicMetadata), 0);
+            return response;
         }
     }
 }
\ No newline at end of file

From b11768460fbdd3691a5c957b9b34c544782a2685 Mon Sep 17 00:00:00 2001
From: Guozhang Wang <wangguoz@gmail.com>
Date: Thu, 9 Feb 2017 19:12:50 -0800
Subject: [PATCH 099/177] MINOR: add architecture section and configure /
 execution for streams

1. Added an architecture section.
2. Added a configuration / execution sub-section to developer guide.

Minor tweaks and a bunch of missing fixes from `kafka-site` repo.

Author: Guozhang Wang <wangguoz@gmail.com>

Reviewers: Matthias J. Sax <matthias@confluent.io>, Derrick Or <derrickor@gmail.com>, Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2488 from guozhangwang/KMinor-streams-docs-second-pass

(cherry picked from commit a15fcea799a843c1b4888fffbb2d382ee2e2ee36)
Signed-off-by: Ewen Cheslack-Postava <me@ewencp.org>
---
 docs/documentation.html                       | 144 +----
 docs/documentation/streams.html               |  19 +
 docs/images/streams-architecture-overview.jpg | Bin 0 -> 420929 bytes
 docs/images/streams-architecture-states.jpg   | Bin 0 -> 147338 bytes
 docs/images/streams-architecture-tasks.jpg    | Bin 0 -> 130435 bytes
 docs/images/streams-architecture-threads.jpg  | Bin 0 -> 153622 bytes
 docs/images/streams-architecture-topology.jpg | Bin 0 -> 182199 bytes
 docs/introduction.html                        |  17 +-
 docs/js/templateData.js                       |   4 +-
 docs/migration.html                           |   4 +-
 docs/protocol.html                            |   8 +-
 docs/quickstart.html                          |  12 +-
 docs/streams.html                             | 544 ++++++++++++++----
 docs/toc.html                                 | 154 +++++
 docs/upgrade.html                             |   2 +-
 docs/uses.html                                |   2 +-
 16 files changed, 630 insertions(+), 280 deletions(-)
 create mode 100644 docs/documentation/streams.html
 create mode 100644 docs/images/streams-architecture-overview.jpg
 create mode 100644 docs/images/streams-architecture-states.jpg
 create mode 100644 docs/images/streams-architecture-tasks.jpg
 create mode 100644 docs/images/streams-architecture-threads.jpg
 create mode 100644 docs/images/streams-architecture-topology.jpg
 create mode 100644 docs/toc.html

diff --git a/docs/documentation.html b/docs/documentation.html
index 626998437aa0c..f9ab6738c663a 100644
--- a/docs/documentation.html
+++ b/docs/documentation.html
@@ -20,6 +20,7 @@
 <!--#include virtual="../includes/_header.htm" -->
 <!--#include virtual="../includes/_top.htm" -->
 
+
 <div class="content documentation documentation--current">
 	<!--#include virtual="../includes/_nav.htm" -->
 	<div class="right">
@@ -27,134 +28,8 @@
     <h1>Documentation</h1>
     <h3>Kafka 0.10.2 Documentation</h3>
     Prior releases: <a href="/07/documentation.html">0.7.x</a>, <a href="/08/documentation.html">0.8.0</a>, <a href="/081/documentation.html">0.8.1.X</a>, <a href="/082/documentation.html">0.8.2.X</a>, <a href="/090/documentation.html">0.9.0.X</a>, <a href="/0100/documentation.html">0.10.0.X</a>, <a href="/0101/documentation.html">0.10.1.X</a>.
-    </ul>
-
-    <ul class="toc">
-        <li><a href="#gettingStarted">1. Getting Started</a>
-             <ul>
-                 <li><a href="#introduction">1.1 Introduction</a>
-                 <li><a href="#uses">1.2 Use Cases</a>
-                 <li><a href="#quickstart">1.3 Quick Start</a>
-                 <li><a href="#ecosystem">1.4 Ecosystem</a>
-                 <li><a href="#upgrade">1.5 Upgrading</a>
-             </ul>
-        </li>
-        <li><a href="#api">2. APIs</a>
-              <ul>
-                  <li><a href="#producerapi">2.1 Producer API</a>
-                  <li><a href="#consumerapi">2.2 Consumer API</a>
-                  <li><a href="#streamsapi">2.3 Streams API</a>
-    			  <li><a href="#connectapi">2.4 Connect API</a>
-    			  <li><a href="#legacyapis">2.5 Legacy APIs</a>
-              </ul>
-        </li>
-        <li><a href="#configuration">3. Configuration</a>
-            <ul>
-                <li><a href="#brokerconfigs">3.1 Broker Configs</a>
-                <li><a href="#producerconfigs">3.2 Producer Configs</a>
-                <li><a href="#consumerconfigs">3.3 Consumer Configs</a>
-                    <ul>
-                        <li><a href="#newconsumerconfigs">3.3.1 New Consumer Configs</a>
-                        <li><a href="#oldconsumerconfigs">3.3.2 Old Consumer Configs</a>
-                    </ul>
-                <li><a href="#connectconfigs">3.4 Kafka Connect Configs</a>
-                <li><a href="#streamsconfigs">3.5 Kafka Streams Configs</a>
-            </ul>
-        </li>
-        <li><a href="#design">4. Design</a>
-            <ul>
-                 <li><a href="#majordesignelements">4.1 Motivation</a>
-                 <li><a href="#persistence">4.2 Persistence</a>
-                 <li><a href="#maximizingefficiency">4.3 Efficiency</a>
-                 <li><a href="#theproducer">4.4 The Producer</a>
-                 <li><a href="#theconsumer">4.5 The Consumer</a>
-                 <li><a href="#semantics">4.6 Message Delivery Semantics</a>
-                 <li><a href="#replication">4.7 Replication</a>
-                 <li><a href="#compaction">4.8 Log Compaction</a>
-                 <li><a href="#design_quotas">4.9 Quotas</a>
-            </ul>
-        </li>
-        <li><a href="#implementation">5. Implementation</a>
-            <ul>
-                  <li><a href="#apidesign">5.1 API Design</a>
-                  <li><a href="#networklayer">5.2 Network Layer</a>
-                  <li><a href="#messages">5.3 Messages</a>
-                  <li><a href="#messageformat">5.4 Message format</a>
-                  <li><a href="#log">5.5 Log</a>
-                  <li><a href="#distributionimpl">5.6 Distribution</a>
-            </ul>
-        </li>
-        <li><a href="#operations">6. Operations</a>
-            <ul>
-                 <li><a href="#basic_ops">6.1 Basic Kafka Operations</a>
-                    <ul>
-                         <li><a href="#basic_ops_add_topic">Adding and removing topics</a>
-                         <li><a href="#basic_ops_modify_topic">Modifying topics</a>
-                         <li><a href="#basic_ops_restarting">Graceful shutdown</a>
-                         <li><a href="#basic_ops_leader_balancing">Balancing leadership</a>
-                         <li><a href="#basic_ops_consumer_lag">Checking consumer position</a>
-                         <li><a href="#basic_ops_mirror_maker">Mirroring data between clusters</a>
-                         <li><a href="#basic_ops_cluster_expansion">Expanding your cluster</a>
-                         <li><a href="#basic_ops_decommissioning_brokers">Decommissioning brokers</a>
-                         <li><a href="#basic_ops_increase_replication_factor">Increasing replication factor</a>
-                    </ul>
-                 <li><a href="#datacenters">6.2 Datacenters</a>
-                 <li><a href="#config">6.3 Important Configs</a>
-                     <ul>
-                         <li><a href="#clientconfig">Important Client Configs</a>
-                         <li><a href="#prodconfig">A Production Server Configs</a>
-                     </ul>
-                   <li><a href="#java">6.4 Java Version</a>
-                   <li><a href="#hwandos">6.5 Hardware and OS</a>
-                    <ul>
-                        <li><a href="#os">OS</a>
-                        <li><a href="#diskandfs">Disks and Filesystems</a>
-                        <li><a href="#appvsosflush">Application vs OS Flush Management</a>
-                        <li><a href="#linuxflush">Linux Flush Behavior</a>
-                        <li><a href="#ext4">Ext4 Notes</a>
-                    </ul>
-                  <li><a href="#monitoring">6.6 Monitoring</a>
-                  <li><a href="#zk">6.7 ZooKeeper</a>
-                    <ul>
-                        <li><a href="#zkversion">Stable Version</a>
-                        <li><a href="#zkops">Operationalization</a>
-                    </ul>
-            </ul>
-        </li>
-        <li><a href="#security">7. Security</a>
-            <ul>
-                <li><a href="#security_overview">7.1 Security Overview</a></li>
-                <li><a href="#security_ssl">7.2 Encryption and Authentication using SSL</a></li>
-                <li><a href="#security_sasl">7.3 Authentication using SASL</a></li>
-                <li><a href="#security_authz">7.4 Authorization and ACLs</a></li>
-                <li><a href="#security_rolling_upgrade">7.5 Incorporating Security Features in a Running Cluster</a></li>
-                <li><a href="#zk_authz">7.6 ZooKeeper Authentication</a></li>
-                <ul>
-                    <li><a href="#zk_authz_new">New Clusters</a></li>
-                    <li><a href="#zk_authz_migration">Migrating Clusters</a></li>
-                    <li><a href="#zk_authz_ensemble">Migrating the ZooKeeper Ensemble</a></li>
-                </ul>
-            </ul>
-        </li>
-        <li><a href="#connect">8. Kafka Connect</a>
-            <ul>
-                <li><a href="#connect_overview">8.1 Overview</a></li>
-                <li><a href="#connect_user">8.2 User Guide</a></li>
-                <li><a href="#connect_development">8.3 Connector Development Guide</a></li>
-            </ul>
-        </li>
-        <li><a href="#streams">9. Kafka Streams</a>
-            <ul>
-                <li><a href="#streams_overview">9.1 Overview</a></li>
-                <li><a href="#streams_developer">9.2 Developer Guide</a></li>
-                <ul>
-                    <li><a href="#streams_concepts">Core Concepts</a></li>
-                    <li><a href="#streams_processor">Low-Level Processor API</a></li>
-                    <li><a href="#streams_dsl">High-Level Streams DSL</a></li>
-                </ul>
-            </ul>
-        </li>
-    </ul>
+
+    <!--#include virtual="toc.html" -->
 
     <h2><a id="gettingStarted" href="#gettingStarted">1. Getting Started</a></h2>
       <h3><a id="introduction" href="#introduction">1.1 Introduction</a></h3>
@@ -194,8 +69,15 @@ <h2><a id="security" href="#security">7. Security</a></h2>
     <h2><a id="connect" href="#connect">8. Kafka Connect</a></h2>
     <!--#include virtual="connect.html" -->
 
-    <h2><a id="streams" href="#streams">9. Kafka Streams</a></h2>
-    <!--#include virtual="streams.html" -->
+    <h2><a id="streams" href="/0102/documentation/streams">9. Kafka Streams</a></h2>
+    <p>
+        Kafka Streams is a client library for processing and analyzing data stored in Kafka and either write the resulting data back to Kafka or send the final output to an external system. It builds upon important stream processing concepts such as properly distinguishing between event time and processing time, windowing support, and simple yet efficient management of application state.
+    </p>
+    <p>
+        Kafka Streams has a <b>low barrier to entry</b>: You can quickly write and run a small-scale proof-of-concept on a single machine; and you only need to run additional instances of your application on multiple machines to scale up to high-volume production workloads. Kafka Streams transparently handles the load balancing of multiple instances of the same application by leveraging Kafka's parallelism model.
+    </p>
+
+    <p>Learn More about Kafka Streams read <a href="/0102/documentation/streams">this</a> Section.</p>
 
-<!--#include virtual="../includes/footer.html" -->
+<!--#include virtual="../includes/_footer.htm" -->
 <!--#include virtual="../includes/_docs_footer.htm" -->
diff --git a/docs/documentation/streams.html b/docs/documentation/streams.html
new file mode 100644
index 0000000000000..d8d2bb21779dc
--- /dev/null
+++ b/docs/documentation/streams.html
@@ -0,0 +1,19 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements.  See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License.  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<!-- should always link the the latest release's documentation -->
+<!--#include virtual="../streams.html" -->
diff --git a/docs/images/streams-architecture-overview.jpg b/docs/images/streams-architecture-overview.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..92220791aa70a5abdcd855b47ed61015ab4a2ba3
GIT binary patch
literal 420929
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
R?<dUl|K7cSETSLn{|7Sv^~(SN

literal 0
HcmV?d00001

diff --git a/docs/images/streams-architecture-states.jpg b/docs/images/streams-architecture-states.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..fde12db522475f275e44346f76d112e60fff2315
GIT binary patch
literal 147338
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
YM{#8kfKo;0-?pT`aXS6`RDb6F4-Gf?82|tP

literal 0
HcmV?d00001

diff --git a/docs/images/streams-architecture-tasks.jpg b/docs/images/streams-architecture-tasks.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..2e957f9763f05a94c6cdfac15bb371748496ae6d
GIT binary patch
literal 130435
zcmeFaXIK<X(=a;Al5>(INkA}>GYBgg1SDq>VOcUPl7p~D5J>_G2m(sZh?1j<h)B*k
z=Ojp!xMvpB+xto1^S<XgKh8Ne*UnT|S9e!+SNC*J^%UrS^aO3Cf|soo0H~`27XSdj
z2Z$j600kikKIQ^BfpIY~)-jApON8K_-~lWUPx%7|GeS=NfI%t<1Av3c2L4hZr+>k@
zkaNG~<;Ro&aDcxeh`=#S4Z{6_wg5JG$K+iGZyX?Bm_NdUI{?5%{_`$liL^klYT6*(
zkghgJXI42mRslYKVb*i%=5Sjl4DvhxB19zk1SR<SSoy>y1cW5`g#iHj2>{@MWn=RR
z2=KrBAtR=?msmgRg(6-;f5KQvAT1`~LZCl*2OH!s`5-QT$p`WIT|O+x&oUtQuzr<I
z!+%m7pbXwIG9KU2{pb~d_*f=0IduSn{tA#D#{kPa7&`P2@Bkpj$HynYCng{urXV6D
zqBuoHOiXr)j*99O6%`!?@p1TZJBj?`6+%KpL_$hJPD)BnO-f2ijk%CgpJbu<Zwf%a
z11Ru;+rUdGgbl!=fIulA=n+szLi9%n4CE3AavVU0F#!r{4K@xg9zFpf5#%2eApjQi
zXCgTO!G=Jwu(5FPaPe`V#DZWV1r+-XB|nagmN^yMt-Aua)Df==W!X7SX}`A+6mq%O
zA%}N1QfF=A8{AcxCi%^MPWdQZON9?9ZX&dudXtFtw-4&N+^04axt^vzEPD2_dwMgi
zxV~p*OW(>PAUeI|Q}67ysFH!TXJAZ5X+z)K4h4XP1#*jh%o83ij_@%HXZR_xK@M)Q
zQQ-*OjiAPG@Ls!PO_0N4!sTA1oX#n@tI)TzxEKcTIE6oSf=r~)S}N#?xFIHgvGDIX
z;QEUN^dLYCJ+6}ifB{>&kt%1|{Wkk*{X&uHV_NH123t_dt0UIMYGUO063o)}7e#W&
zbZDhBMgqPpZPB%>RY~_5SiL`FUq%Be-Du#0z*wh)CXJO<|0hd$<R`0ZO?0zG+Py{#
zhNd(kEv15}17zC%R_0-gT}8X~HssNh=x6oZMMniY2~UUOB`uwT!qy6J3HaoT@Gv=j
z@{3AaxhvfLi9f_%YIL9FV72y$ra<G6em$$n2~}W_V@qAt34z;_F|R82kzE^8Uqzr6
zD0eOy1}#|BdMm|bX}z#ZtGl>cCdHHdu+%_RO4YPD5_`8SK=ddoTF=1UH{VJs1SgcZ
zWa?n#4(*La`95T)Z{dPtu^*X6w@!14BrHQK{N`p}`MYWIb|_RXA6eRs`mV3t=9uOC
z;2xaHJ?&_{`YyfvwOcuiikyoqRg0+)Lmb7nPCqa<?7GQ+rek$adMx#EDlvx^dntk=
zQss;?che`=*xo8y;~TvY0d>ogvE|;`mC=yG^EsJQ@X^I@O>fpkB`WVal)4VD%6w>W
zuufU@d5Q+^zCGYwfF)Q?!;KAlH>;oDf`_~>2ORJRD0V9nc{}dEcFZ(dh$%9Z4^WQ%
zHgxz*IM4&8UEIK`x98Q+Kgqx>5-i=ZnXusGG`FXAgzVWw1N^3GBQgU<)YH1NljQUY
zd9I%L%sW+q$U}~!aC>rk0*Q~S=}B=5<AC7{b)qMew0kh#)!Qq*QsLOI0|8YPTzA{S
zSu}w7qRL!#BSlV?zpj7o#$m6-yIphl@cg!GeTJV5R*`vywYH^b07pG&UwcmUQgoT&
zY+(UKb<x+?L(7u(d+Hgx{xJs^<j%Cy#a|G^Q4WciV6gMMmhjxGczEzqc}VfMk~iaw
zmMh58U8lWsO)ObDPY>e#Xbe?{v~JoP8}8^YnJtX&G-T-S7%ciehYuVK_EBMZe@&pL
zRAxs!KSTEk`}8D3@X->w{aCHf^Hbt~)7yL4r}cR0JTOomV#DSiKVX2<Q|eheR8emn
zu*IHWR8<Bs6nW1awEZ4_db1j3Hdc8^1)HE!o4+f+^8JkxEwx%%GEm)?xrPSjn+y3(
zJV?*B_%4=d8PdF7IxRD}E$Oa*$h(#+&$}q(CnCz7D0~#ww(r!ykc$RNv(P}W_5y0%
zit9iDwMC-;^ueOf;(NM185$CjxY*K(u?R%5*xpPCqFCB^JAk%4KFh!F?e5$@8j!j)
z+-Fe{U6Nv3UjMq&)3%_n(zJXCHHilDgCl}MBY}$7>m!C=8M~%TLxV3K)jhLzJBT(i
zEkcNY${V8hRk%NribSS)?rs~#pUFsFi$APMS5^+XA@k|nvc1h7)%f6kmhY%1g?lqz
zD81t|KHL2~i`QAixnEGJ7L=pg@XBsx%kBxivF#Dh^G96^`$QwYbf;6|HVWSzEiJuu
z4DnpQ-u*xsKu%Q*SO!JFxFfwZ(uyKe_Vr3o@(s0|Ue4C(ZTp^F9rm?LzMW{`lIhWX
zii|q<RWvZ-GlT~2WjH5Rc!PRU1y5_*uSA8e=UiAGE7c1REwy#p=OBgl_o?vgNk2!m
zTW>rve2#+WZEZ0I#Fr+7@Q}TJ<gfzA%PQVR`Z)|N=h1HKc`ywam`2WryOxN+Ji9(o
z7q%SLY*~dkIC!iyWIYpFr)wYEd-@(Y`_WP(aQ@AUH+<vdA-<pYGLp$kMyxk)o0yI7
zTSTLQ@!AYDFyJmCm?^d5USgmFi86KM<?vt4vuZn7%S}!2yU#+fsDcLKx)<`H8M<>U
z_C}3sl%XMC=;cm_A2h29b1C`ON=_DjD^%3^#;|k=ZX!3b%*SCow!w6$;a^`Es+GZz
zeO)fWgyF+DD`iKCM|z~%O!}P&hkLB%ftgWf=;=1EMyjwCqdT^AqYZBC%N@NBRa7s#
zf03ilvB-hO!I9qRG{aI(dEN-()R9H94^u<p+a75HT^Q$utDaxeVqWua6p4qof68@r
zv_9lKH$B}GY*;cWM-=yA{)s44s4E(9j}PxMguP}O%h{4c1FyJQwuG=5Tb~66g*i1Z
zCTMg-zb;)NdtKco9e*Bis(YXJ%^XumdWnC;83Q{`J-LO!k($s5(^x(20iI9!*~?O;
zdk(I#ef}PeJ1Ge3smYp(W$FEEcdiU}Y<_)RRh*k$J9_;qDGiNL@l%Amn&f%bp@97a
znOvjt9;u?@eCrgCCK2h<LzsT;oPFW-oL5r@)_L0@l{{UJB_q`z#D=Pa`l#5{yO`9j
zK(5Q?bx9e}55h&7Q{HVFULV`{8{$U;YnG!KdZqI^`hwOA##8W=BhG|pXkfXsm5EKP
zt&L@mT;ouOF~{9Jp-aO3dD(~(ciXET@+NhC{`b8-I{k<JN9lcFDGQW^?S46BmYy-+
zYhtXo-FugwJ$FyMl>68S4cu|8Jy_}vR9<-Xn!lfsI2e2HPI&7U8b};DDA2mDLdrf`
zRb)`g+;_NYaL5_czj6L3G<tHhXIiv}<su{-4eYxN=^W;WBrVXTjiVkkIC~xS==<oS
zfg%4lWs%oS-(8r<3t|aB<P6?xB_fi!MLFIOh}B>KQ*6pE?J9pJe$=MZWe{^dyi3rh
zK=os-XwHn(0CkV+odP=H^iLuUA|)XnrS_gjs0G->sdTrHZT?&)-%Q*h@Xvf6_x@3b
zI8~i&{$BQF53lSBo%UCj(*~ic1toqWij&yyI7GdV<hVekcv1+nv`X}u)8=YgPC3fJ
z(RA!DnLZ4yMrBpEy`Bp8(AoAhhKxKO9vc|5^j9iw*{n93gDD)W7K+Np=P@0H`yoG3
z3w`wiknH+R!NYVc`}=;aN0l`9=9cE$QXM`mdKc*lT*#eT!K>Yf^?;2Wy2*5{Hykd_
z9khatKSFIO!|~t>1v%-sn<u4V9hsPoM2&SzSs)s4iwoZJ<>lg{{PxVeqWN~!i(9rN
z_AdtW{M^M?vT_Sh=`j8f8CP`YCUX&-H`RN#47HqZcY)0K=y^xr;i%_CP@-0(c6kRJ
zF)f)h(-+*CM<ONh&GAtErIDU~aY0tUTVa>JlWCEeqk-UVF0Rp%k@a9Tp?;wDr&8YZ
znMob%6ek7Vtmvf`-qW7GXVAc`f7A{Q^2$wXtwlW;Lt;YI9=U`EU))3C;M0ok`h?$x
zqP9zo5dLq^<#g-|i^cdyKYbdL%K!aPE^}&Ta5-d-;VV7a;Fu0|QD4a5V!@`{TS7EY
z3?I-#CGGVjb<w<;lNjYRJ#^3eG<whxR(IdeQ{vUV4oie-{1sOtckldx`QBMe|Mq?1
z*wIk8slBGuTR0y>vF9nZn|PO$4(>jmz5sLY&Qo~46{{iB%*>sO8ZYL^NLJy9)Q(h9
zm@W=;p2pJF32txR<cYoQ{0$9k^w=$?w4<h(W6;2Z!sGb*Rr^`%o_iO0?DJ}N96o(2
zFmdwgLvTkQvaFT%&uWFVb&fgOQ&us4O)yhT$($A#jSqHodwky3Ccl56GwE3r8nDkw
z;p%D_+rG`KBQWexc~K+gp`)q)i;%cQ>p?*y1e38w_Lsp=ZxVw~n{1<s``hG3Jp14H
znbfZM>*-#sH8wetFB@jO1<l!abo6Mt)W9?3BrVuF*309aSFBgr{rM=|V8K!4TK3g&
z1uJ_#IG^!{B?tFYmX}TZ+-Us^uIWwm?v?V_u9d<LPQ{oY?AEVp=WM}u!(PHR;Lp)O
zQleg($zuB<ndZi#IBIvR@jSX~wPGUVYY-X;d;#0mkTR5CloAMgIjB(ZCS%HINe97u
z$=B@77wIR5iv`7xv*xK9wA)y~(Z6bORqf5*EY9=$6f3XF9U6QOZ^NyV_w5P`=ii`#
z<i%<a9lx^ZnhF;whT8Uvfr}fp>s^^-dmE_D$kP?rQpJgd-3&YTjK_>3<=}4Wu=w(`
z?DJk^@7`^GwV|gOK=k=X^hplS`6b58nC@LqDxCD8b1X*#&#y|mZ+DnD<lbrY%vu(a
zfSOv($}J(kOC_R#&Bt7eBO?`k+ALdxwP6BGBUoSTMNInko;i>cg+9F!Rch9Axt*;Z
zsuJ=*gMtQk{7pty$<ks$ho5YxvHCrcGQ!aj|M2uxoh~#GswdI2ZPp=Jw<zr3=U!rM
z)}=e*DV($kQ(85E&5jxznYqI@K!w=}V&5|FU9mFLZ)<ufUf@Slai?L~)zSWjO?~=G
z{J?JXOYDI4+T`7<*t)mY7WRitQBO^aB2~mguhO6a5j3!v^f^8Djtt)YS1Q+7t_W_S
z(pVTTArH2Ut8(CnH~d9}#mWwKL@N0E2eWVPiwE#Iz&(u~?f8+W`tWFCC%%mXx+D4B
zz~?pf)7)Vz#Dt|q^|OB7tmOe`p4=Gd+a7zrA<>n+i?nHOA@>u)qv93S9Y3bVgfzc;
z%H87e$*-0n-NaANN2v5{O-ZxHf?4v%oGuf&<e4(8(c%O=%_|?#z$o?DYp~~5B@c#S
zhvO<LBek}hb*gAUNJ7qf*TnBjsFWscNoBvEs>a(++e<)ox9>_}-Nrz<#x}1O?<J&J
z^JqJx$-+b=<Vhb&=3pgUW1lDoLb9|ApSs5AH)dhyknBKlVUPF0ID|6r)G{(4rlGBX
zEsh(mEIP12Lxqz8&-Xl}@r88?Zay~CZ<rSh57%r$18r^iX0I!nLq|{?cfkkxH?Enz
z?2d&5@dQcQ<(1-{@?InNQj=2O<>IduePy~|vXRwjK(V6#5jKhX5&rWa>DaZfK2SJx
z_sIg8h@Bz#@wTCuWZbxUi}S=*m2d2(Zlo44Z)|2)O1|96+Vj%MkbEpa74@$6h;|p8
zmf!h@r8(ajH<rKu3h%w;SoeC8>5!dJZ<D(0N`A@Bq3eX(eIOHhdi&S+(10NtP!2UU
z5)&5r^1LPzQc6(~*X(=La1ek7hLQVl>ka)!t%4HB?_8YcCxIqSb!7cHG%zN(<F+vK
zo&8Y{xVxPGhS~-fj6^7<iay~LQd?5{2SuSWcx77Yiv?LFo#T6>XY(0P>1`R^Gj+O1
z^sRBkNzmKj@Zv3{quUK=fZ$*TmVWf)aAzcZrrVxn54K0-`~*7+aM8Ap+YWpkDEz^A
zB9nE8h-c*az@~KY;k_8c51ls?T9Dz}+}npFTinEUe#CZJ&o^Uxm5-DMQ?MfyY=o?y
zvYny7W%Q(C?P~Ik-X{b=<@`N&{`|+P(g((?i_Pw#9D2&m{Hd!?h^BTWs|yt6AHVXj
z)qE5oVgslmSuTX6pFZcmeV>xUV`O)%st;+s+PA8=a;wd?aH;E5YAIXC?zGK;4{A|>
z8x7<d>>+iQd*&P1{c(lEF4?j;d})_dEGdEOytOy6e)(kx5prZ#yI+XRx)D$JrGIeA
z22KYx?tKK1K#eIv?-17@8!f*h*jQCQkr*AGeFwgXg1o~QH<Es2PdBE+2CgOeIsCXT
zA0dR%z{9toqU^b+#XKFh5@B$ts4IyxX&Pxpoz2_RH##B-hFwfIadg;vF*j{yFWtU(
z6l@O}du4B0x#fcfo*kVAH<+y)Zb8q?%=f=Mnv8w8b_8OaQDdTO^9c1@V~fK(>f7II
zKS&MHwWXM%Vslw7ru-60L_NlLV!|w;4C1Xkt|J*;N>>}Zzeci=$oHQ<5AL4H&^;$=
z3c|{TnVT0cjZ~N+q8c{B{W=blv`%qEVm-u;RN?sQZaWliB^CCi4v1Ou7v~!yTkX{-
z$xWI;iF&qI9tsQ8wH0vh@ZY(w8Yes*C?tKoi!`sre=o@d4M-RH+GQ_}=;b;-tCEWy
z$7kPFzff%GB_&>J*=3f&9WN4T$tOO@myp$aZuF4uJL035zqUKePL7#sp@YW_KIU~P
z9|95@s+WFF9=&h5jvk_cmZ2lk#h{0A&9x>s@2YO!R_ryZ1h>w9Qt?ciR78bu)ni)=
zdf>)mx>7G+)A|mn?w}qbyIf)XWH<@D%=?*j0md2&hD6DR^qZc(QZ;X3@p54tcJ6~0
ztE=uAlPNRmFxBRc8VyLPjOO(}qv^6|>?KN6><ui=7g_QAx)+iUt~%??&;Z^dH`dLo
zS=VT<m8=e4$}2H(wjZ)jeIin74mUgKD?Ar_zrc|~tod$TdQHlBe?xMWkBR!t6`Scr
z6^Zgy&pD~DJJs{_39?nH7xG$MTVBnc&I*8Rn(VInh3A*>XE)twpcT%?eqDD*;-2EF
z=l0dMMWM}jfgJHX-XbC4!m8pt*OEY!g`=>N>N%@@)M^lc{OO1ePAc|5x-DC|y}S@L
zU(px2Po%qUhNftlh;Lqm?e4X$^`hRtiCZd4F?Gl;=`)d|d&kfl3P2T$&U2_glh;h+
zh*UlcE@-Zz(7nI3;wol^^ThSyn_<<QY$>JQ**9t=AIS&KHL`k$#Ey~YE$cj4W=^{%
zY#19ab;*}uw(4^4PVazs{z!=D!gVw-$Fj-0hXfTrRl>u1@WSgVh5`3&skcSZMsV)z
z*Na1ygR?$uBL{OEuoiCJr+VS)8dq29_PFye?d`!mrFml>wFO*9rEMIb0rrH@z!wK5
zxAx+5s`^#?$5rn64T&sUzsW#}tRCFU@*uszNl}<@C3$P!H*t`0HgpAkIEX7UX0U0p
zQeK;~i2@hYnWfa+o7G%<Lw?*D-D9Uc8fyJlom#Re2pQt@c)r(UhrGR|yw(sH+|6FM
zGPdA+6!@jH{(V#O;PC#T{(X3!L{V9#O@?RJ)@gNA@*z7Khz>^3t2Oy6io@&k?3sr+
zXqI^b`J2f`4yJ0A(15y$ikP!zvS*jyLYNXS#U#b9pBXP18Os(bKNTEp@4(Ah%ox-_
z51?0A(*Jt-Ey%+Mh{>v`V`E;N0{|H##2A2{KC8qCzF^0^V?Rzidz?nz(zfT9*-%4(
z<Lr@NfKzwvI86eR24M#;<QM=G1Bjemz!&Kn?rzTRZeSGiJ|EC@b<?pxA{~w?RGi!p
z2q$+(OacbR+~pixFmbZuygIgC7z$ZiH%uN(@=2Kpmuu#Z2weq3T@b|zz5z!9jsOCL
z&H*ZbCU72v6u`R<paEP1VFN%B;08niVL$-<u>$gd3*ZjG0ediy3#QZ`)oHpQkybhg
zH+N?Z3p+T7CI$;}0SiY0R$w+AklYQ-=zN@o(D@fN7>8hRvJP%eKja~{aJO}EvvoQy
z5=<gErj}DTQax!)Nen#}H+cE0y(oWcFAZlmTcndKm`;nKlyi1-`q>0v6Ir<YifCKA
zs{e|}xj4!F6>)O=E23uM;QA}&nzft9uZV)9gZ!@u*b9FZEep4|{?QP};sJoRlB^ua
z4HUzYwk0d8CDPsE3UVA1Jq}7PPXC0Hb@*pGSr<!PJtsFsc5MfYX8a1W4wkI{3a{<z
z;C77H^m4eO{fnH?0|9qKy2zWmnPVh4W>V8y)AgrLVPFg~c*n2}s3ELQius3XbwTsb
zzp7RT?r?(Fbb((n!jy0v$l)$XX9F7q*twv7+d5hQY(7#<f;PyLEYi&l>F9uTvi^~U
z_-6`+h2QWbKk?eO);7N<5dBO5dHY3=8EMd!6CQq;f3SYuk4GWraT@85O2HfK&X2K6
za*V@_Zsuc3`oG7a8^>{i<12W99BV0PEW-rCALAKR*kca1j<L!Buay;;;s9PT7Cua-
z6U?jUalbGE$9QA#`jZB<pn;Sa&HsTpF7rDW2QVWG{VxM_9+UhplhFTn(vI5#A5-?v
zafo#V6chaYXg6jIbZmw@8Mh3WDAX3boN$kc0vHn?6f=7<0IuK+;R4PR=HP_n3QB1X
z#^8VrU<=|AAcUDeFzMVNWDZi;gTEiM2d1Ro!jB<`!C=b%Wk&o(@*BY~++ULk;N<Rr
znK3c5H?9TJ-O1ARAI37=4P!|>p71dP;Fp$x$bZmMK=zk5pRl3*OIeS_#&vbDg(F<`
z9n_A6`CC0W$7x`hl;98VIHDr|TU~h8E=YIhzoBrEF1FUTzh+Ve9ZcyO$2hPI5_5Mq
zq!Pjj;bQKFumll+uDA2g#|YsGF$RN4QE{|p1#kaP%MW#Tarp5t`q3$v#{WA;-PQW%
z1M7qa*WAHP*WCJVRHSeOm=EFQrsArstFHEQQp5j={u?oY4bsI&#=+M5XG@Wt2(SDT
z4N8t@iLf$vKb~X>JP<B!|AJiqC;IQ?L>AU^NC%|LZ;eZFQogLxuLLj)a1H5%X=?&E
zq%-)acSZa@ixE12)7?K|i7k$&$A7{Tfn99#kL1TA^c<!l@M#RHGi>b`J{gS|bN`77
zLyqY%6abAnc)_&sOYnCa1jhkj{tk%e2j~FEA4B;cL-`*=`5#01A4B;cL-`*=`5#01
zA4B;cL-`*=`5#01A4B;cL-`*=`5#01A4B;cL-`*=`5#01A4B;cL;10x{NzpZ8Sq^)
z0GNV5@T)e^UJS?pmY`YK0yO2Yf<|H+5OxE9uE!8)#sbZ@|CxdnkOTi%L5nmWzz<rb
zF|VwT-(jEFmGF-3OJH5-3F2iNH#cVqUS20x9&^k`YdmnIBd?daGcP|6A1`nj=H+Y-
zw@0|KS|C8Hi4@yvWi1=4t)&#3fv`HCy0aX@##Y(K1)<|}O&9KC4;Qy&gGsYq_LA^&
zbaq6znX`I1IykvXcuBDx7cK$97&I>%>oJL&y%gK=hh(gV>YA)_NEZaFFpmf~oS&bc
zRaBgZUsy~~K={(}r*ph~;=KHP+<g4t_i_>fe5^kL8(5o*rIm!XyyB0#z?c-<51~9g
zJ$XC@d5|vFy!_(g;=FtUyaEE;AO*Lpx09Q>7q^ou`_B^O5w36-+hfZ(E2c!y>g(<%
z#RhVEB7&o{y85qz|7B}AI%4EHrgn8x@BlOar?z#)7(aNm5w1vg7dS$}1L5Sx{xiEJ
z{8wIQ(EM{OfF+z4;ec=i$y~v{;r~^Y^UseAe`Wa_bH9?0JM?D-VE6oM@}E7AAp`}M
zkVnGZF?FiQOR)*^2@A<6$O*{`3kV1bD~j@q2n&je%L>WL^YM$x2n+tqqvGW1X6^(>
zVDf;a@Yvc~N?3^U@gdClMY#FRg+#f91TDn5#rUoGxWxqE7H|Q6VR2D0^Pl-ota0WJ
z|FgO+;SyFz7e{lj*=-%otr5I-&IoHZ)?e~V92=I@k(LNhlHc(va&q873M*R&Fu@f(
zgutqzASc2vE+WD$z{7vclZ2cL0<;H$M*%<*%x9b2e1hEke7fLgoBaF|g2ER;t>oi7
zAq6Y2wetQ~q{m-){*4qI36|jTg8vgSW<VWxhO(_Icp}03hsx_9ZvB89Y*~*LPQo0H
zIoJV;VeWyjWcz`%{a<&-Nui$LVT6Aa`){(GkhvnQ+&s-)5Hi-Fy8Im0nm?8EUwr}l
zlR>zRxsx>loKtw&ctMGHF{AH9INpDh`#9~lk@}My9R3*a*SsVBbAI@9|I-40THsF$
z{AqzdE%2uW{(sa0f9+flPT<nQ6Wo`eCy5Qg#h#g_wuYjLn!@pBi&$CB)(MFP9&K|3
zPp4v5e}+cJtaz>9(KZ5bmjoVSGl#o6tLrFY4g&+=%8(VaM8v><h3($s6G1>1x3VTH
z>tFc)3Zj5JyMV`3A(|kype48m0pSNA?BMC<jKO10BvD(~V_+=IaXM-jkU<cp!@$-j
z@TFs#6Zi@Swsdp?53gZicy_jQw8X$4LHLn}JLXUuR1Jg!JZur3AlwbY91iY|;Hg6>
z=A0z8Bf=a!XornC?Zn}RfZKpD9|#k>=xT%KT(K{Mo>+*je}gT4gWbT>WgsmehjjKn
zK5xZ(4t|~$+<J+zDkD4{5N>YVn&5WQ+{F^y>^VA{J9z`ZiOiT>0Oda|zmL%;m;adf
z8{K~bF@1ZIzM*y8XAqj^zi@x${0oOn2G44OXHub0{=!*22Y}Lt06;hR7mnj4xNm;|
z03~g|$wPzDm*2Lcwg@;6ra^y&|0BUK%6||1Rv!<hzF%7xR{4|Td8`<%hJ(lL++A2*
z!QDK9mHQu+_<x=8H@1G`<B~SQ3gLnPw}7nrpq7D$n8EILvb4o)PFQW7{<gvTt%Uz&
zw%<y?fG2tl0#vC-0JRwpK;A|TKv$XpY$_rEdOZ<Lf&A(>H3EI`1q%Qeu*{w4JqUy8
z$Jf7Iu)@J8maFaYkxxKQTbC8??&5Jmf{nT1fG3&B0BV39U<TO1PX)NamoK7#Bya`%
zSl}x7semqE1l%}2t?LM$(e(t+4&DU<fMDPW@C=9pl7Lho3&;oF0Hr_`@E-UCGy&~E
z4=@Cb12e!9um)@c`=I+8JO~Md3PKNIft-b0ga|;yAkq*8h#Ev2Vg$Jfv4%K7+#$Ci
z_aVWMNJt#y6(kE%2q}lWhcrSuAOnyI$O2>?vWEr5BF3V|V#4CY;>8lflEG5N(#0~x
zvc|fF<%9JAD-0_ZD;X;ns|4#kRufha);QJ@))wephzLppJp<*2ib3U|8c<`X71Ral
z4}A=ch9*Pvp%u^uXcu%Gx(waL#>J+>X2s^lmc&-Z*29Kl-@^9C4#AGY&crUk{)pX$
zJ%PQ3eS|}T!-#VcM*>F$#}LOF#}g+2CmJUmrx>Rmrw3;SXB!t6mj;&$R}@zn*9g}R
z*B3VgHvzW*_Z@Br?iB789v&V&-bFkqJPkZ^JU6@myytkic(r()cr$q4@rm$R@CEP{
z@s07F@bBSA<7ea7;CJHB;qMcW6PzWGAkZMNB=9B(CrBlzAZR0)A=oFRAmk#HBGe_c
zBfLu(OPEhsPdH4tK}1BvMkG$8MPy5KhbWflHPL6H38GzMO5zK|a>Un(-HF49Gl<_2
z4-jvVkdSbaTp=+gaU%&M$s(yE8728nN=3>;szPc>iXx3CEg|hB{Ypkac9u+r>;{<+
zSv1*OvNp11asqNrayfEya)0u8@^bP%@+}G~3VsR=3P*|%ifoETig`*rN=`}zN=wQI
zlqr;Tlv7ktDt0P4Dmc}Bs#L0asu^lrYA$LOYCGy+>OAUJ>a|mpr-V-FpYl2tf2#V_
zI1QABlSYNcfhL^h4NWi29xW5C3@w5-h&G?LlXi#hG~E?C1l?o00=gc$J$hDp1$uk>
z2>Md`5e96A3k+Heo(zc$^$g3WsZUFuhM#_X`pxM<Ml8k)jM|L8j46!Gj9X01OiE17
zOwXC>n3kDon6EI~F+XLlVP0UNVv%OCWqHa{%d*INidBZyfi;%(BkS53#xu%i+|Rr^
z(|Tr~jf+i>?H*eJ+Xy=$yBNC_`&0H0>}wn>9O@jmIdV7#&k~#!J8N?`=4`{+9ZoJz
z1I|FsQqFlUIxZD1AFdp(;d3PCVCQa~OFq|q9{0T1dHeGT=i4t}T@b!tb0Pjh+eNI4
zA{T8hCS2^egmX#!lGCN+OMTqL+%nuA+&SD6JTyFNJok7?dA{;;@EY?*@HX%s@d@)e
z@TKw%@l*0&<-f;Y!M`qWK>#igFVHPWBB&^c5-bz^CUj8<A(SZ8FH9w@E)0GPDtss+
zD&iuNFR~!YA$n8vg=n7`wV0+@h}dUw9C2B3lz5f+u7rq$o5UN5RY`71d&z9c`O93F
z5tmahPf4*!nM=Kr8kc63zA61udK`8JW)4e+O<rNYVtFO~%ACx389SL=nXj^ZvM#d4
zvO97Ta(;5}<e~CP@{i?P6(|+-6yg*{71<Q66>}8Vl!TRhmEI}iD61+*DEFx_slZjT
zRMxJFUiG{BQI%L#M>S4$Qtg78i&}*`mikroDD~lMXRkS3E7brrR5YSAMl`uJZ)sL)
z;c97W#cR!K^K0MMZqT99G1JM`+18cS4c8sgJE!Na_d%ab|GIt_=uJo7Aktvmkk`=9
zu*rzQ$kwRL7|&SWINf;5M8V{l$;@@(>jBq$O}R|HOdD@7+;F&2ZANBhZua&j&P{`x
z**6c&HO!OEw=7gFURbQb<=`>!CCe+8Pc0V^Qiw>zoRySSq}9B&ly#K#f(^_j+Gg2S
z&Nj~Wo1L;<lHHEIhJA)T+QGn~z!Bf^renDirIWqWM<g@S3)$g((K*0*{FcP6XSdc|
zR9(_tA+DybWp32qVyfBwoclxf2@h$Hc#rR%`krsSD7>7!n!PW02YJu=DEg%NV*A2<
zKiocZ`|j-tKN-JQ{t$l){|_j3)C1Ja9i=;&cM0#>-)*_acQ5kZ=6!?v6%Uvm+<7qd
zQ0ZY#0BL|rKwqF_VA3P(N4Aezg9L+~2OT}OeEcPtFE~2*AOs%rC6qrjHWVFZ71kOq
z5}x=3_leV!-UwJkW+X+VPvlgTdQ{0%)~Ao3Zay=6))*}mofJbD;~p~}s}@`Koa6bE
z=Lc~%aXs;}@dYm!Uj)6_Nw7@lOuUkqpTv|DoV54S_GSMorB@}%oXOECxG5efv#I*2
z4QXO&S?LVv!Rdz?P8s8w+L<4-M6<H88MDK4uyWjU7ILrWw&%&`mF08izbc?92!0K`
zc7MHCc(btgjp~~ZZ^ho`7o9D7QA}0*xCBz-U9whcQ#xK|RMt^`wfsYcWJPf$Pi02c
znX35eQ`O-$gf$Op(6v6bTko9TEx)&ZKlQ=v!%&@JUH3<=kFE8p^`Ac}eyVGbX{h}y
z^|`81qOtso*q72Kk*1Pn;pXBN;g;f7k=Bwn(YCU7@%D<2%N;eHu+H~g@?D?0Rl1vc
zuJv^E>h<>bUGE$3x9p!Ea2WVD=rOoIbY~c6`0)t&Nc1S<X!6+kv4U}t@#+criRMY2
z$)PFu)Y7!;^uf%7S(4f4IhMJsd4c(=1;vH-MU%yuCFiC6<$x86l^0*neJxtOvf8|6
zxHj|6<r{iEWP^SqV^e7J!<OdO=(gkb{?6m?^xrdg#daI^4EE;sJrD2>Vh_(BRvf7w
z4Wk{wFNgkeh<62C3!FH_!}=AVAOyt*ub=}rY)rtx#W@bRxOjN@czC!31cZd3<GjBI
z2ows%!NwuL#U&siBp@Uq!#Knv1KsL@;m3{mB=+}wzhY>NLp-b`C;|!rJ;?p#5YG{G
zhzBlf0leS+;Q`n<P%K;s@WUY<$m{Q^e|Lz71+oS@#KXmdf)^}T2o{tA8^8fQ;>l>?
zQkjDu@u&qNUg4cOaY#2INMo_a;d1ZWSvet{$mBP0*AK$-Tu~`+MQC*`-Re3g@j34k
z5Yo{<c&eb7TBP5lcaC9wY6IgG58?js*@<Jkf8!TVOxe)J>rrfG+2{WG@8`u;jBLGw
zo@bRe4lL|mkhp4W=kqu&yW-2>;@*h^Jtz*?oVeKdP^jZCAAT}8S|G=`x9&y=yeeFy
ze%~>{E_+Jb!sVMFhmhPonn<0q$?!KH@LW5EC*|+c>PCU?0_o^EMHCpgEZy`(*Hhls
zojcz(wejF-YSG_WR{YJG-|xQs{>JlvVEOMp_x5)mSDx~?u&mdgQ)pn3UvK*V>L|MX
z|6}rW{5yHFLum3dKjcm3*Beh?zGa|mA*%oFf6{-~1BSNh6<1uC#X>vm3swJTeXpO*
zZ$Ja+CKN7R6?Ip<;NeupZ5o<$Jur;wP3gbVpB}{vi;wloGDSvi{YxH;wYsQH-0OMr
z|I$M<bmzYl{bu^;A^$A3%Yf|#GShDpg{n%)n2hoa(XU=I9k_^+2M^ynZMwhgV;Oc3
zeYr%hp69>UYCZBgpE!!4I_z||D^i9lT`BIvI<-1M{i%Dl2892^v60n|ti4ets$iH_
z{MD20iTIXI&3j$953jPr883dMuJdnP>YrA@)y;4W8gYpWD=xTwv8+GaBIch5p>h6&
zA{L()%1Y$ihhm}{XZ!zgux5woAtd{l+Eqw4>C%_t-9h(9r%1NnH=2C-IiNu|D_#Gt
zJ(YU{#}~T%%dSAMpImbFK2<tL`z#-H(wMY9OUDzhL%Mc|dbC#_C)S+Da>E^R?ZEcN
zZf2nUM0CbG%5qPwdENw1DIPP+VlUsz9(MtF{|2r6T3Gd5`SRt!Fh`YFh}pePsCJLg
zA-hIpkMPCRw_VF@w)tOE3#jE!akNuCX^9qt*9*#&;u6e#=6`oRoOPYI3DznlxxuT`
zTQnraJf(I>9VDcEby6Xk)1_EQ>wRSxD$&kYuw*J<nC`IlwG^x<v2k|U!En9Rv*G4S
zA5zf&FtM#%n+_SDY#-IAY#R3X;hn`>r&FEASbZn&AS1`LE?!*?8j8EtR8Csl(0Hwd
zR;zoQvpj1k-knab>ZED&blvN1^Hq%vZU;S~^`mf_E>81oJX>)$G{@^?n$%x6?yQ{j
z&>m3~!HhwSX55xU1LE{^W`f?X8!Sz?Y>iiXli=`-_nupl-t-iy_Ca#bHE;9KYZ3}8
zTsU8Ipi$(P5~ZH?iTySEw~npV?=0KQQKm1OUE!25r?8Nfqx+`URT&*JcATo71?;=i
z4~~x4$SsCsZY&1>>eT;o($)=C(x?P>*sIrB5^IGoucZ5X&5x>e6m<3}Jl;?*sw}dx
zaF1U~7L9oRC1wBtXg<~%o?|aqxn8((ZX%HT?o79t>!MV|a&LftTbofdtwaQF>o8ZK
zop4v?K8qO^87k4ePj-wKciV#5eIq(z+L3U{v}cZh`l|jQ<Z$L=_hq&aPb>CmiG;Vb
zM!5~?fk98ZQA|UX%%7KYM^a)f>X^^7IPZTZi-&Ps?%91fS9^KM-=bUiyh#&z3inDd
z%cjk!@!<_g_vJ6Nlk7fz`6=SH)?0C*`rc~cN>wQPdFDY6CB(MkeP+6borb(GEv_6!
zETvIPTUqJ5eX2P#h1iPW!Vc%{Qcfusql9*mSK>y;O!^$$o_}4~vT@2#PQ04P{<sjk
zd*$hL8!<{NgB>@D$9HWKVcJ;R>)0$iu9l7~!y3yHc=r^^ji>2bO?fZnqfBL!n@(rC
zJAYP?BYnWAUz+yr{#DO<>d}+gORt#vo%(r|+wb#jk4!p>nOyZElDmpN8~euS@pLm`
z6}VihyU><Mchg!>i&Q^YB}y+^tdQtMIjNZ+E^HbmJzpDZEMM^{a4A>wnqxj|xeR0B
z=TpWZ)Nj7#lE|>1@323U9nLIxYuE3qhQqeBf72I!>u};ng=Mf?m!>tt6RoJOy<ROe
z`!NgW%QfI+4cJED=>!R7AiiUiTQ|j|7j#y|yC4xznys<rD5-Y$D=!z}^<0|^HrWKQ
zD_=IO!szIm+Zl&Ld15$oF5R-A6=#5&*EU$+X#^EqZr7t^($KNkBu2_ndql6H`SW6J
zm}}Q|iZZYN4W%t9(7V~)K70A$WZ<X>WsF6(`vrBjk(b_$+u~e*SI-0#xU6iXvj3XQ
zcC*;Guk0v&IcZINg&Y=eIJH%s(};>q)ZJLg-PlEH(`wj$ykYb?l)8gv|MJvL5;BVm
zWMPh*rYZLgtf}+Mmz74LUpz`J?DlzNC1RZ^FFBD7QOb$U?9BRR;&`0@xuQXL|GQZ)
zzwFiS?(XfBqX5tY)PyE(aRE6VeBKnf!7-OOUpr;vJ99K$voKh@5!kTz8V#gJ_${FP
ztkVat+c7+B_V5tVdhX<uc1DYwWFTlB*9SY5efqn{Wx*zX{9vvO-|?~L@McrrjX<-K
zb%V&2G)IyQBAhZt<8M>2F*TEL{H{#A44pFSaY?zNxj~(SnxqBTa>W)_4YJf%a``A}
zV1>WeUfmLU$aR&GBZ#V0sTcKZEJg$t!)y|)`Y5k8!|j8g)d8W;o6ftsx*g;WDYL#W
zmMVGQP9-<I6W_XBI><BJIK)tH72PpIF)S^!;C{KrkJMq_)eXA`ckfUvO4ZF&6C$Qx
zfj2i6hnhQcu*3Dd_;fh8Sv_KA>0*G%MVgYw2rtb?hbpEibNh8Q&F3|xHrm{!JM1!E
zeCG;af$jv4>^OniaCgqSL5a@pjJKt9&XbhZJCu1feQ&*MH&U(#uD3NYd#>jvIqfi1
zjRq81>PJhSr_BDWdx||O3leVUdDGQ3XQe7bjzsZ{qWr<RKCRx$#EWmLBkHBQ8k4(Q
zL!=XGa%kIEWWxovYMV4J%j`a!k(BZ|=bz(Zl(%)-yew?;f-9lTh4h!<@S5F<<(8X0
z=2YHcW6Rziif@d)oy6}?d%N?><&O$Ax4O7}GBGrZJXv{UL3=aOp(XRcUBpD~#*-!R
zS$Uz<IJ(obbd#${^fCeCq<1G<-Xwvuatm*fP9its92svFUePuo`H_A-JrTC*VI%C7
z^}$q09#6)ubw*lq%jGykPfJGj^xIpM^wgA|{bK2Jb_oAA%S3fLMw8(E6~C&E293e4
zi5XV1e&&Ub&@aVOZQ%}MNZlKJW<Dh+Ywzp?C7y&^r-P02M%LDuTJfW<DrB3VFkCBC
zJ9k!?qxPVu=S*l_=!MSK=7`RkC$Zr#n-UQ#(&pUOWX>$kydAJLu}&|)XY@%^0x&kE
zdB3Jz_1py1`c&gye7U!oMi~9@SGDMm@1_q11zf9^UmQutFw2eXIDC&O8e~sdxzt~o
z20xgn-@6eJPpkM}K3IOPhs;+tC&OOt?(g1%EuFihK!Q@6=R$t3v;S_Lw1@_#tfyFZ
z&g}4fd4dLHx%QsJMjE$~iI=xt`J2sm+B0--^6D18mNUvvV`2~SV@q9@oU_jFo9dXH
zN_ywdz0T9H9I9kHOXvKlO{b);)`f*)V9<N$$c3v_<CfbBJlRnA>{H-o*Ghl4;=QcJ
ztKDPei#91@k4Tgp5pRo>D!X<}Yg%GN?)M+kk#8YlH<-`hJ>Pq9r8Zn?#NS}O<k|Eg
zO_NNAqdX1GW1p|<;v=aM6>s^6lPc~ztO^Y(+t$l`V{Tu$w09`~c1Bb@Vb`(itEC%B
zCBuu)Sf$PyFuuHC&YZ`!0=LKG=4Mf|1}_j@&k8sS_ofDAlW6xiU*tyQUX?79xgvTt
zXJdoOLvWB`;Ik9FYh>L&XgTD&B=im6_vEtjjlERwtyLe?v%K5yXTx_vUvZ+g3=d*N
z$i0n~Dm(Mf>ZpvDn&noPlgR2R-z2+ob!9Cg-jq>bNs`BFW`TdH?IyCRe5TSwB<Ag5
za$O>G0hKLDJ*Ak;QtO_lV8L#EEuWon^xXm*&#0p9IO6S<wDpk)9{IEsymxeqc;(HY
zA8mKa#(SC(g_KMN2UL=hq)B>#LO81Do^8xAGaV@{`)P^@<te&TOSs-{CLDbBM&)>J
z&5q&on6E1V$b_^O=~!kT5Zu~zoij|k`B=!l5t?{6IVeG8&w#H|R+=->^Gialxm7f`
zKmA81PU(?E2pSMeaBfNW?(F_rXlnFD+J)m~Qbt#+>%f`$MyhIx?Xg8a=n<jUcURjv
zie}a2i9=+5$-KJEykH@)#rrh=bk2_@vhvo7tJ?Z#lwaNwt!$fGSG$U*i;NTNYdzrH
z*<jGXdf}Q*W(%=c^Ew0cTgR7<`Sm4%1{!{sh?g*@=8K<EaYtGQ?-JMB<SU*dmvwrg
zzs#~T2Jp!EDJ&A+yCT`Gt82w#y<Ng&%m2wCoDC*dypm+KH4;JBro#|Yej4v9N41j3
zwY&W}uSxATSX#{vp4E6292(E;e1+YxuY@1yaFx$XJp;eZQDf;n#941Rm`a){jXGFL
z^S-aO!4vH+zPZ#tQKA@U6QP$vqRr-(wc95Svyv3l$f_5=CZ(jaH+BtlPK{UO^R=ZZ
zoF?uz#ZwhY#p|`XL<{t_Y~ZBD!){~pMf0VUv1IVmn|{v`c=HPhYL!GP=lbvlQ6_U@
zex)m3pJV4Z!sqKY>({^DwSrxO&9RQRyDdyJxSBP<>*rNX7Rhry<@$cJr9z!*)ljd0
zxpF2vtz(A*UfZ}?)86U}ABf8Q!gJGf_mi7CA>&>DJKa!O4_JT?UN;L-^*h2c?H}_*
z0lMekJ!Nm+^kI%octW~)@O51z%RB>g%_qOKH=5zf6c(Sp=yO;<(j7Ri{9#y;fUQ_E
z?D?FJT12@0^C($PgQKT`qmnwfYKdRq^$?e*Hvu$onWa5wqc-t&-|pP3FY>&%_Nd_|
zOt&~K=(5~{eFFn+oe51*U|E8&MAf9AX^6gxQFdZ&cU2(}zAYUyV0xx!v9#q|f6_R$
zrL^!|<5s~;;EYG`u47tko~>{GjdO?GxdI)j>61dni4+AlCAOqTP*xt-g>DUbGh5eA
z_)43sa1|NtTf-PzWJT+kLQQXMUW!}XBK?s3bS0k6W?7V1OiFPWKa0!BtPYQibi!wF
z{EH9M+J;umvO#M_yv>p3hID3#-m*|rR*HFFoP0fMA}e+;w@R$Jft4s}!0@)8CI3b_
zS@kziQ`#cjP!hH`P$hki#wHh^78XC&b%{JPcd1n?aNtY?{<4o-X6wa)JYr$KFPuDF
zfy;09$qvYU;V^5f&Nl4DTT_<<wJ7>VZ#3;D%#d(3vP4KD*0+OC=Y`;QG&LWLjI54Z
zd2rbsJQVaC98~kU(b`Byc-nj8iPx%?uNll{UoKeM`+7L}G~TW_>0L5#uvU2;nJsc;
z0``Jk3y+!0_IV*pbQ@<;<Kd_;33CsmRxa1SY|2%g`Ce?VBK%pWCq~6ccld%Pv!cX0
z)&u5*hA<?15`7XNoj(`Ia66IZF`Jj~o~Pf!*jb^m0=1gKYo8JtJ;ySxYdNkniw&A;
z?O3GE?2XNl&Gf|x$0tCIHrR~q^dBm8vlx^`z^ydjt2R(^+bDPrWnAyEUP<62_(IPm
zZy@VGzG)1z+}AM5U<ffRd&Q&lm_5%$052)39wlBYe);Y!%NhG4)Ar)%?qY8F!ABk3
z`RrQr!}WqaGeLL*Az|g|D>Xx%vz=`;;@3mnq{g?H+ThEcg(DfsE0>I4eE)ui`Qj+o
z3pK?L@>^fMt!K>Uo`uh}J>wCAzr1d@qchs%QLy#ko`gj5!vZ|m+ljdR#+5P~=d}pS
zB+q$X)fJ`JyS{MKDdKw+FUc~3V|L#!v&5h_o=Eg19IR&SdT3lyus6@leW^m6cj>i{
z&AO|LmTuOR-0N=z4#V4KMfAcxcOOk<#*eP1t-oBq(cy~|{AN?2J7gPf;@mR;-EFAe
zGDk37a~HWVCbV>I`m%FgnLy(Ags5xNHDZvW%S1;mEC)JAP_8C3Lkgn)TJ^(gHKjc^
z4NfeyEINS~JeG=G6;^;|x4uUmcqq^M<?06q8S5b^{_Ei+;Om;Pk-Y_Qf!xXuizkhr
zmC22-ZD&raorili?GLIf`JCCAXn1H_?Bm(2f%xPa=JMHrAz!Wr4akB2dEwq=A!!j_
ztSX)Q27{)qI?qxRZ}8%g>QsX2?B-Y1sYfHBl~2BXTrRB^dvixc2%1&TWj(!}hV-68
z1A_iHz3+`pnh4eOChCn~Q>X#PD@RMP0B`B*f_;d_CnTR%yTsfL_fIROcYW^Z_P>0v
zR|EPbexcKMR6AX5A`^Y3b6(=E&D4=0&wIE15i^M~OLumj*mo#`{V_g}vw%mFEBJQ6
z=5#nr><-x|i>`|q<6>)DT&dR79dhrBUjO)l<v+a~O}{oAsQxXlx76R+A7Q^;p>Z(H
znNe^(HOj<h@8Q!G2ETNB6J?tmGg_HM`$6#lp5AB`7i?5HS^JH)?c2pSn(Bz9vp&hq
zJ=xu1+aw`s0sUV;NxT(r(Bov>rBsAa9r_6EEPBwLS6x8~@nC_?BB4$(H2!_vx02F@
zZ<l+z+4L<5)qI}+L@XD~QM$Bv6tS0GL)+CfdStf#HDbn(txLXrIkN8BTVn-6Cl$%J
zf(+3Xo*Z+i^!LPk6n9=qNT1H{o#{nHUvGHqI@k4eK#KEO=AO$C#jV`JHvZkxrbMkG
z)m4GTHCvi4er00|RY{W1@>iNalC<E$t$U{4@t%K)VqzR^TOLuY<if?LSFJ==wd=31
z##L3%Hc@4Id+G)1zBS;lDs;gy^l!R|gMjfzzRzw*ysRlgQLucl$C$|MwbnH5-(fCP
zRbgVU8XxIV`fx^gL0(&9v1#TExynMzrv~Qpk4P<R=)wNIUP^nzb%QhKB29TomlxJ;
zCob)e`$-yNFw0~_q&DM{=OAqSm0-BieQKZ2XrK_fRa0_MuQ_^UBTuGaUh?RIM7K#}
z`$|HLO{CEJ4sD|(v)qPP+h&UOq=d8wSiBk<@V>oy6%ACnO&Ftrs9T4w(c2nc2yjKV
zSpz=Hajvj)^D$wA4w<D+8y#$RxwSR>vak-!w`CLXOcZtt8>YVsm~^2DrcEEd=fc=_
zW^C7U(0Zl6L0{<Gv`6iLS=ww-&8O+M0hhkk+d@42Ig_;4znAPv9i=pgZhw>WDCfPp
zSvOns^{V9N(qn@3MgF3gCe(|h_#=;XmghISgrsN&)!7##hNTX>1(e@Z(h#5Oc*0BQ
zM55vUyxF7HVYb5(i@$8=2s-cIxX+ck;wau2#Y=oQ8#>c7QDX&)cjw^U24`UQg3Cgj
zUw*u=!}i{Tb`!PMEP>dzPn`mJ-a5D9NR*1ix9AWHnd`Ohe3`+;;oYNPmCOgNI_FLA
znzf8o2OVAS_jeo}uw!38<bC*XdWrOva84c8b9QY#wMc;{y0EaGX6EL)e6gUeu-iM~
z3!aIc*30~n{3}>ulOoJ-+xFs-8kXzf({poYHWY*Mb_0!~G=ep%!+guX3PU~lgXjd=
zlB*tj-~D*6JHw24Y(bLURO(8!k@MYJxwZZ(1AAYM{uK2n+;|pR@>kcjSWZK>6J}H3
z8G~(pD9=*~3EA{KPU$xzKBeRc3Ip^5Uu5|wFDG%;hZ!l8(`ax#Cu`IA5>P<{ZxuPp
z5+c1>PJ#M7MVqm?-eSH|O_vm4y|}|tleIurSe?uNJrOc-ROJ8l;y&{;k*o}p{)B73
z^A=svX9Udz@8XBvIkUStDYIm3^~H#t?i<zHRwe2g9^lf>1*5S6JCWC;{iX`u*3MPq
z6%X%!TI$UH@G?C5ssJU8I6J2}T=<MUA4~JfX~hk$sA5ylNAk^f*6xt=$gJxE4^(<S
zMm!dLY4<FH+2rwTWwFq=?we~NW%3n0>mn<Mi7Uhj33&k-jACU-r!^V8SNVQzf(Ho)
zPs$EzdU+1&bL`gaXkAT&^OKMcx$L?T_k}{HA4gpQ(s1o1Sqf2S&s#msO$uD_F|(I?
zdt_M0DE4g)aENp|qP{r0rxDpr_|?Z+S^YBfc3_xDe&!gnDw6+T)*M`GR<`b=fzCH(
zz2$i;2}RygV`=k#Pr;?Fsn}7>JTEn<TB;e}ty=<*dLuMJzu**cF!=Ok`f$E&*qSbF
zULC3h_G(ip?)JACGftD!N&NQYhWv^)+_CF%S3Sanae`o%=8GkoB{bD$%wU7NJ678_
zGK#F<-(!^D4;-|SKDU0~4)y|;FxA30Ae^6o@J42t@(;@(EwM~;MBY^e@STHwVK;wq
zBa&)`x&7On&5@)#uSSOVS?ojn+xDe}T%WaSu{t(?{-#>x=(pOgaP!LOgH8H*f!i0_
zOdsd}^`fZv-z{O);#Q0;{Ufn<W2Qc3cpxv=<qqe*(%;*gRbiyMs&d}d7<yymZ9_5F
z$CgWXdSaH;IbT?GzN4_>Keg`v)c@KpZPStFdP3@;R5L^IXfdTmrv2L27(5pm!EQF)
zJ7mqPiO>7@7>ym|?k`?$U2T=_-X6^;+LE7PWRt{S_VV3%<vF&;TqPT4@Uo?p^hkr>
zL??bIbM;;+fpE{7!K~=)T*B?K*``Ch&jx)oandnMv8it^GDZdKStoitz4IQB`{;s|
zV5i(lR#a&wlEQ6!6w%aH8#}Na_I}&ot(ycSdj)?u!{qc}i##bMa(X*yx1pd}%D#1w
zvoOQ^9^5-~*L~%~*lWnly>T&_vp~-IpzM+N%%>!4tt<6?K3~N~5{`|nF|~26tiJs&
z$*U92`9fC!x-bT3sBYxSX-A1=Q1~0}w(MXpwBAel2FE@UPZ|<<(rKCRCcQR)7!?>a
z7|VXh+pY?3dFQC7&_DvbdHox#s)vFO4P@a9p@D!F*qfRcl=(a0e=xe|wq){{Jyqkw
z!aVpN6jDWJSmIUK)1n(P_D66Xs$XH-xQuP0M(|{osl(TMNlLd+Wl`@@=W7M4YIj|C
z4N%;h_m+$*dz`LCq$=ESNxDkW_$X6XrzgB4j`Z`&Wn&UNis49`+kW8sCubX}Gk927
z7bbm|?whJ(jiu2#A#5Z3hH+0-*PN;9#zli@MN?^&ILY*(CEC)f^W%X37sWX{9cSEr
zUnt|2Pf|<M0__c}N7BB&r7lvnD~zT|uL7+tPAikt#?w7fYTn)CEkPn3g_cx9W!K${
z-@XZ*EiZRfkeAViuR|qOX6Pmn>~E*MZmFIpzcZ?2{dq9yV8*n%rgVPchJk3@B>{oc
zLHWcwt<}(M9|!i~ZrnVj02ia`97an;5j>N_@ElvzxOueCtxM%)F3j);6fEK3e>uSG
zV{qS;NC=Hia~RGm7!R8qDfu3$N1S077Fgn5wodR)+5L77&v|&`In@{H>@7GVOVK7~
zQFWKcc5$X_#g+^zR)%8+-TyDjzB{PNuiZ9?f{IeaN(%x~L_j*y5u}Lp4g%6UNGG%i
zC`C#@N~j4%x`0TpQR##ty%T!qCDf4O&3Df^cg}owes|9OGc%dY`)2R`l(p8gHZgbS
z$=FPPp2<W2W|gh6lsu4Zbt-sd8%L#8mXRHaMqMt})X3ECQ4e=8J&azCKPE@bW9N>`
zG5-B<sI1ADfKSFjWmVPbWA|ZSwnR2Mwa2+iI%lb1CUj8H50P2vm!6Et8<#ZIu*n^q
zk=Zkl>M~v12Q(%~YprJ;^2Hq?&|3Y?8D?CKnDDSp1MTnU->JdCG$|5Ze`eL@mSdVf
zqjA_m@Fcty(>OneLe7v4rw+B=Hjys{!vW+T%MV7es56<%p4Vd{=^rKC;U2{ui2c1)
z<EhTw+yHx`WI#{AO@Z6V(ipmKS7;w93l6&+Y_IcPr$M4AT<pcpn_G2a3PI&+Y+;X#
zsVSH3i!E|^vm0Fe@T<ZQO~(Yp_XJ2u5YMi~twxF}%aeU2|MkT;8hBX`o{1`ij2wSL
z&W4P?@wglN__~~4<UU5KWCptW^lU@zN;r)s`{tl*fq>JdJWS7WO9OwcO*vL!7wys?
z;B$Dj)8nlT+;_@*0W3r+L|Xg45)H8egNqi9B5ituce(|r@?YyFN%d{1u)b69EmWNj
zO45v|m2%b|RT1NhYxc%<bmByJi?YOBHbxyzRhZ9X_vh(URu?fiOKd+}qHLBbo=O8A
zUed(c$Ed12fNY}b4G&}p+JHZ(YkH%QBF=P9fM^I@JaCHPa9{-+5v4Oh5Tcis<%F*Q
zUsW>S*qhI<EJtVEMmf6GW1jGC1r~-5(_Xg);4M0D<rvkDB}IMuF8vp9Rbm!+!L;%V
zBEB(93w-k_zB%&_dd=-@-B_Rb=e+ppn3N8Ehl782*@pszO1~`02t7NeX4JPOUKkm8
zXU9-XDA0RbPxH^WfucAzEsbbK+J~pRJlT~svjNt9+{)4hXv@4)mVZIgMdr$6$+BA4
zVLHnzc^d&y$bwnKGsJT@u#nG<x?Yh!ky6&?AoW=B<Z-e;yapUMv%_x5*?Q<?CG_tJ
z46m%xEt3!Z1;_`W99yW(A?1fpWCi8B4Gd{g;eH3Il_$l+V(;|wr1a1zY@duI28|(U
zK<4yZuAjIx^7H31eP~j9__F#-agBsCLwv&#(_cVsV#dhp_ad)CzEU=mo^Hdjqt51$
zV)Otl&C^`1c_2NO8aFJdQB=c~>Jt?I5@q^v>+<8#wCHR~-ulBQ4{sjNJJ8HH7!`d)
z2(UaB@ZV~fA{0RE9bgj9U&(qJ?*~r#`afCJ9hIH|ZRo8nu&sn}8BEx_xMaPs4|?U$
zU=&Kv+}>-L%U=1@=<(N%(xdL{ERWRT{NeMJ(-V#b`3W_w^dGN9G+mY$pYNR`w4~$n
zw-+ri2~qhw{;02~8nURdw$?RclFkNTfA3xHr>pz&rNdf(mSMN(J`VO_5p}2Ob&}sQ
zj#MIrq-Z_>ofe=KiogQl8x1DC*WUgYI`m%@^#2P~)^jUuCqyNX4dg0sVP&vUPlhV6
zP_)y#NOdSf-QnZA)i+#sKh<yE)BSozN;cf;I#ub+q<^oNkRx$;CYC*L7)E!@bqbw9
zk-~HcW~h9<#e;j+q$__XP{|HmW5{7aezvcZ`K<>V#t|PiQ{>k^yz_mSw&Qjo9r}2I
zbOn(|5S2mU1X7Q^=T;Q#cm0(Tmh7+!!ok<uFFcx<WwW;c8;U=(*xI{(9>@p!K19ua
zc$El*N!D0|28Oz;+b|zY)H2$qvNm148=+ZO>ZH%yr0Re5+{!!>G^wUlFWTAT3eKeo
zn<pH!ZYhPN?OHyFIv*`RPLiXm4Vk121d||^Hqr4=(DCh@?1b4j%{F}!oMAAYRod#i
zjGz3-e-{g!X$G78Q05v_JQ<51ouz5=f?qEP?-FHME$4yyp>|lL0tTGsVQDrlTg+eX
z;ptYS#13Lmi_?(5!mE8VTy0LWePVKTbV>H{<tLh-G#NosGm@2m#yhQ|=wc|$!d~Kg
zaX@BLlP`zG^)J2xi#xMeAzZAa@5k6(dBp({yv_4IOyM4*VeO+XKT5~tk+=vhc5`CL
z&vwM#U%<O<+?%BY7?YBx#S&PoDQV*pHDF;o8a#tl+sFaGg6~NB<>hX3-hZl7me`vR
zSMl<?9V^-mE-QWc!ZxfiJu^5;YX)1(Tz>0CfnMCIb&n}~YJ!sN9Sm?Ip?K{!)xfMj
zblG4+6w4PPqw&+OUiE6;=Wc~tgF_#3qQZt{c8L>du}l|~Wd?`k7@30>zk?cMoTXkQ
zXt)4)uLnDCFivM+`CtT?D3>Z(2+KvKTe!yLw>KJv+#d?rSogFv+|Uk1G9>06yi_B1
z-D)BKfhJ!?GeW-lTMAd>P||1U**KFUqT=fix=OYeZU)RfuQzVX<{VSBSgp6w=uMrz
zkl|(Kr^xi%clxfgKOoP79oraJq!vyyBO5%fxSz~frNboA)vp|JY%_?+U<o`9IqgYD
zk5`H8NiMFl{iv_WSc#m;7FH_%S!%!XF-?j{E<LO>8(8tSIFTV**0MxSfmEh3XU!ZY
zWPQ~1qUdW$_1>08FX9jwk3pNk_Ln1-`=Zwn6Ry^mmETXxV-k~agHfGGWw~!?@bqle
zpi`b~OT@*@k${Vo09M@c3qb!yBd!Dlt1`T5KY|V{_1s3)zCSXV0g$mNl5XNbvvD~h
zp88JjXnh;DdxY{<Pe*xNF#QQq4e;@*SvZfXJp)*}u5cAUz{OlGCVJ-2SmEnUKJkJ|
z&0lxww%mh&fz_$F=U06S2H<U^_B)&df~k%2u{k%}G(BgFXdL=@{NvEb#{U;Ma~73O
zy1fV?yn=5V<v0-`i0$pV@tHJsW4c=_`JZfAkeNn=K;7mf_@|N3T3>i-OfL08poxs^
z`5Yl_#3_jWhnC~oqP_T(l@I&4M}t-%WCOBRABOc<3z9LYb7}btc>dNx!PPiL-Opax
z=}PgP@tYqZpW9F7D4qTInOQOqChBp7NuAx{ddbSEJ>d1uTlyMqHg0YDl11W>k_P-r
z>&q3M%H=d-TJq!B>-X_6Ed@i}ZDqoAfGy?*>4J?g%bCs&AmFTH)G@4)=qW)QEWu7?
zA>{<*o=Kmg3HOh6FzY9DCQc7-yT*9?aws7?UmHF#cqjJWIUt^xJ>lnJw=roW^xF@Z
zP^Cgbm1p_;$9q^*Jzra|4_o#6$T@i5J*LTOohX}`2Kf(|rc70XLY=xADi^;-4|Y9b
zc>U$q8}Mz-38^tbQPcUckDhCC8t0)=9y8|g`D3=Q5D}NoD_AV7xB{WmTJ3Tv(0_R?
zyHabDAU4aD)W>n@$<2|BaNB{E7sVAsvRB9n@2szGJ3O85-8&G7YDI1w$cFlWHVzap
zZfhje$6m3>RPjaq$Br9$jX7N}9x?7t<+74ls7Sb84yrgiO9-luj6t<R9?aA-LuM9-
zHrY!jsrvYXFaH9r=PP&gokXp{N!Pjw;#+JgW{K}C)V#i^Q*Ig;HJLTt<@V$aEZcwC
z@aq+qGjmiZq`G=X@V8~A%(xhC1$$7}yf`qv_OV4)g!?GuWnbClhvT(##jF{xfJ=}H
zIyh3GA0jDnU|Ry78D#hiU>ZN$s-V_-kLwu2F;mM<k3qJ8=TDA3){0^_n7uLH$5%S~
zp<unqgF4lfx@2gff$EYIts3shpC42B9;xZ)NVtOF?ZQy4pgmZFR`K3~^r_BD&%-SA
zID?cw1NM12iIzhQ_N_Y=jjT53^a%)~=7a^0o)nf|dcO^UO%1>V!4HYyCl6)XcLT`i
zzT`{3A0|FQEz1p6^{ex=cDO<r_%rT)o*H)Z_VB*$T$YzcJ9M2hyijXojB>4x0F55F
zdC^I%=c;WXpJghz+S`|W;i}1%nzJn<jj|@{gj&%IXg#eg^t|)yo3W~!Z#1pWtq)gz
zJT6wzrKv6%8m`7ExqQE|xN38ei>0Y0MBpLi5-aYM0q_w+%^r`sos0%h&wo;8;J;J<
z)aUY!?|(|jDY2*l@R2x?sdo~OtzAy+USMv$=cwOWUa^e}{31KG(XiIAK3Kf*3Y~E>
z*OWPHrXgxOc3_BT&MCCu`24w)1o~3X9l#u>%`<KXW5WIKT?TiYsMNP1pw*GL(y@;i
znU}~WAwfbIAY2-WW#3S*;sMo98jdh{oXklcpQyVwhz%m1ST*TP5!@1x3RTD%Q1Gpl
zybF|z520x~(8F1z!=ym2johXk-^ST{rDf~9D79?b#niW`w9vdK#0vB<ZE~O8z?ZA!
zu=pj7V$S5V>Onegm`4=4BbnO7rdPs_UdjJ?)gb&iavhEw7IFTrYSm&Ud@Vbo4C#fu
z@_l-rYU+8ArT%-zby*eXi$vz(8s=<KLS7Wzx?ji$g=OC1d2;2hbOF`@Ehnf>mu!0c
z7QQ@q{q|>-j-2riW5xFYV`t%ED-vy25j=(2Q7;H`)FA|drOjTe*Pi>-ufnQ@m8Rhp
ze)hbrKd?|OQs&P#8X;D!dkAjt-fynYW1{=u9AKKqR!nd*6L0Ug`gR8nLM<JE4>hL(
zng;@+4we1_epHRu5WQ@Wi=J&GOOv&23Q#12K@-Dddh)}vgQsP^+O!;$iFZZWa>ONY
zI#D9k7vE*mkJrb?Xf7CcMBYyXfR=GHA$L%@9G@Azwy_Azd7ov*;`=fFz1Grae;n07
z>N6TEb3eImetcly$xi#NC{L^2TPCY;(!Mj8xgdxH`{f6z%o37v`=69PNWcB*^(Ho~
z1Ch0Z8f=rrspBIjeD*X?oW;)!O>M=YYkHGuQZ07&i^X1&*}E+sOx0(>yE7+$0nIci
zL66g3gyeQeP}9EI^bh2?Q0$|{dhHA}zh&{tbaA_4_8~Lwh~b{@(?W=LDytx4n5o~e
z-0sNdz_43$%9aU`#<P753mJYj$Mb$bp5p4TO&!9pHtV*y`k3oC5to1pk(Pi|SGT3&
zqUxMqdW&@xL8rrJ9SIUES1E>(nQ>U5b>Y6&J~3<+(JN~3#}>?T6kqNlUd)wl>*UMb
zV_9x?@3GpUKRb~k=Q#bW%H&x9d!#h_{AS1lA_XA{8?Rpn+%~YlnxF3DP|PmXPHAGM
zoKQztQK8%2AK38Sa2{{rn`R$^<fBPsH+Q|~Y~xBdg@n6`tWDNVTc+3gAXMa&{8Z#K
zuPa}{LsAE$@KErO%ntMtz224VY{a?0s?h}NRmC+XNQyZ3AnrMPwDIKp1=L^*p~?d3
zqG#>&dqW8f7US8TpD7@n@x-adWW5y%kD%D@Q&(8Z+|{&ASuN7ms!A7t;tT0S1WGjV
zfrRuAB*d;J`RqIVCi5g%aT|QdA13*&(<d6|Mp9{{U8ZH^5_Li9+N9oktQHsYl*gUF
z_}%BcvL0`|u*Xc3O@s=$us(}Q!;$UyS-YbR<Zj$1*}mPP;c-=(^p2A+c)dbLl-EUt
z?yZCxo2~WJr(g0#uWvdjW(1nsGi$GOyEh#ZM0SGItLx0O5*2l*A2DzL!da^ZTav2Z
zVb@IPhHQE1+kAD=_8d=<Cy_hPFx^y@3jt|Yr_O3VpV_K#mU)$l4(AYyrw~i2FRXWW
z10qL+@})LiA*2^gJ7x;CKDG~ABRpwu@GPKI8)c*6ZJCTW1fHg_5%@Hl9O_IOj}>o;
zC!!BTHNb~2MnbhzvP`nZ9!&tbJ+Fj1v=s1@ekL5#RT+zwTEp=_uEf`f=A_pBbk=@&
zQ(fT?hMPunCTovBlU<SJajO&Q8tI>Z0hZE)h7?pWD+k2y2x~UvBR2@=$68_xd-~1-
zT_t<c>z=e}C@<QQuJnqUXiAP9?4@?K;q6kXQ{BpJlXJ8FHS@j8C~=w{jAmFYPn9Bo
ze*{*J?rm-VV7a9uSWvxA`}7+_byIO1$bM*JYH-o;a-n4|Hs|GUN2Tyj`7WO>8gn+C
zs`tgWGR;|1IyhvcdNDzo6XPBHQ36rCCA~rQp$VbycWSU6nAJha_?q;}Pi3>SufI|n
zHTy(-!IgNSlmoR~*AHvQ;1;A&9~dF^&uxEat1f}BU$n5f$i3nZ;2{aD8L}E1WO*Ew
z@wi5C(EF6isVX4Q>CPu7*~N~m?~H!|{Ei`MBT6=DHUoQ@An*m-SsG~DbIX%{i%E(4
zE1|`x#ea&yJRzfK#%y-8zW&TKfN3wc&cHa@4J*K0;$mJ?*&|O4EW`}V{MhKX`=SJE
z82;kYSTyH<hP(kVaf+^hbAyMBc9fC*p%#Bur5R1fS)8KfoOwk`b>*f~wMMcb^$ZEO
zrQd1X05-!(a)~g%h|WnZxyPU7Tz5mmPpW#&X&vFIizd3YS$Z+2RB1=zLc-lnbLV!-
zt_0Z6=T59NGJO~D2`#C;Zp3j;McUhyr|ig&Wao41azmnj0p!G>jtySV&5mc6q2I53
zo^UKBafkLJGNGXUv);6*+U{J2HI@F@ZI(Xz+4f;(zWu9tXBpJ{ALW$pVs8F4%x?`l
z8h*)mFmY%ZitJ@edBltA162M0sCNy7HQTzJl2)civ2s#>0c=-xz&V*|U;8-{lqNg^
zzONq+Z3yo=KUr+^9+tYUqBHwoI0Hv@z%ozMe|Ae`Y2*Zwbcb-O_}Cj0VSrICSq#C@
zl(S^rLYcr8XWJ`tSVcFozKkTB?j4@6C)oM*SZk?6k0nFRgWDZWB!}%nzIDt#jEt~s
zVhck}tpzA|x=n$Drsa6#q-%$z6kQ5jMpcSI)uGpPB|3tpR$`rb|F}n08I)`_@51II
zEA!;uM0FDfVOp~YYs{I2A{1Coqu5Z4%-{gE2^@17hfwyy+$LC)$1-n=>9{?S9r#gI
zOk()Lt+Fis483<+7yJ`~lSaRDl6z6r72bs0-3Z-3N25}GkJh!=K<$_j0-wvE@UH@=
zhU@ZQxE~v4o~E3Y^)XCUsIq(NpaacS)<v3BMS1=J$r0d}xE`0yD91C{Ew2Z+*mU9T
z^6z~q)7z>B_Yuc2)wA?yCj*tKL}PB}lTU5l4TB`MTiKnElqkzx#vXOj>W{x$DCBeg
zT^j5_vlCRjL81j~<-|Zz23f`pAp1YA`&B-DY<@;+hIbsf9To50yUMgFWu^kr`*;-p
zb7natbuUND!FhEl=Lg*#vGvdpOD5v0P$NgV^oG!Pl56Ll9R*Z|pBWwW?_?0Pe=9#V
zbH9?pE`e|e62D&wlGf;Sal0g`p@QZRj&<fqOma}xM@JSvG0T<j&Y?3f=RZD>XQBF_
z8pS`mlRa;$|M*@DA5j;dja0Ta>Eo#8_@e3m=unX&&3NT08`lwP@F<?8fxo6saAT04
zC!;gx!?sk3oal*hof}_N=1GY<XB5cYVkbJuI`ie=gOZ}$$R*{KjP+SC{Vh#nDq8l?
zozT=Nt^4`x>M0{g`g&a0sk>DDHh~#mk6*w{ZCuNV(^=@T*)U<Z0p+P`J>Pt~N5^`D
z77|U@$m|5mn8~S%vf$?|#4ns3EPg^r;uLnfi+^|_<1C(s2+h3@4&(55KL%p^Jp|jJ
zX(s}F9jun5zQQx$!@gB5RVUq&?R%BxjpEsgS2hWc@ecdNMWoXXap>Xy5ttB4JBP;s
z-v=jc=zt4N92bpX+<Emi;WC;rJ=rze&wF@9;%H_Sx}Vd?Bi0=rSEl5$7fD?|K=~tn
zw;h!EiGM1~KCPDh78$)y%gNpXmo*QD9g}j>DjLO$)$AEe3$>kC8kMbnQa6#M@ja0{
ziG!;1j_QTqP}EFF=rdW)7yTddUtm!x(WK2QV7)Cm^Iq%ftxu{f76t<l@o8DZV@R4b
z+DY_0%~yYducGk8!B>sl7JTJP+4Cx!*G#)2&AX;08P=&`Ya~JQ8ljK`%nbMaDv7$m
zhK)GuOzi9K3GQE*qF=<G6TPfTu?~{sI;T|HKNEh%`e7ZU_MQ#+=q@$@gBHO*Nl84l
zKrzMcT)G1@cO2Ufh9XjD4N}JkOLn?l`X0QhuX@hnpO^MhqPXLwv&)jO$&7h*gi2nV
zoq%y$$vLc6@efXY7uHbMVhv*DeYi|v=C;NBjQ%jtat*Q3kO3Av!2ir_kG%%Vu`W3?
zn(SZJ$%sDTaNv+iUCb3wtjD?H9@PDC8Tj~#8eW_Ws&Z*d|25t5um_r;+g4V84<UqI
zMK*6h*9EY>d^U#1uZA~~yl$4pr~Ek_p>oFb-&8*HiawOcBhRaPgMN;VOs<pokrO6*
zMA?i|7~d3jA!PK#YO(M<>~SGa36t*KR|@q2ooNlx2s^^`F(2=kZ`GeuFv~Qiiu((V
z*3imxM;BO+=aw^2r}=fap2e*ek0m_a>ECbpxqe`^3%B_T$Xnpou&5ei6W{qsCKdQ5
zY^8eS1i0ZILz#kL^#u$3?hdGJlN_BM{8K})XB{T?#kg+bw66Lr<Vg4cLY9{Z8B<!d
zG6g-EZ_zyT>zk?mLGTAy@j;ls#+75tUqJs20p`%7jn>Pr!TWX_N!{8K#61<7m@sC4
zR^JsLhCTV;K9`>IIYX$z)1kTD&|!v>vxIMiD<8xahu!UQzyAW{Lf>w~p|QEIDkQ~<
zE6fIEx>}V)-d~^R*0iyIC(hw2dGqx7p6pOsoMPwYu-2@Y+b)fh;29$JnRWFFD>;6r
zZ99yq?cmQ}fN0xxsHw{rr=%9k$}sT>cKHxZu#t4YXZ`QHQrRaJhHAH8Jim;d!S2*7
z)2u)AWPm)ZISN+83Su+XtB__M!p;nJpC-=AOJW^sH!FUJZFSr77b(BHdk1MAGwnb=
zol_X4nD8<*-#K!1FCS-AA3C&+GYt@YS9#sjleu}qRdqiEfek@t2@C-F6*m~AUbq@;
ze4&a}i?)V50*rK#U%5W-5Hxdn;UXBL;(j!LfpGT|)9jzfz9Xi5j%x6Qd&_cuwRe(X
z){yo;zLbZjgnEgxrdR0e;maEzTx?{`KDxdsM33}1SJ;vH^kB}^6D{!L4yXse;!L*Y
z7SifF13<Y|R2-AfSP1m@o<5oX3-~2zG%F9>pd7EGlK12C5-z>`)b6Xae>gmZ7!csz
zw9q>SLJveA?u#xM{&rD!V<R6jaQVnxc~TO`2MX4&5F6xj-8phP!F(*#O`MkT|6v~S
zZOZv*t&^9D<5pqA;{#UMUOFXyB{hDYfhP07F8)jZ8D>#R%u4>?rd*j}oBT!ry1^zB
zVJC=;;CjGg5KJmN6-mqVOVJ>fzxb|oh|Zmri;0k)<ej)3l)(QPV))0Y#t%fhfio0z
z(JzhlO-#O}$UFU!Hp=4F^ya2RtE7F(eZP<xYCb<Q%Wm280r+ureGqp4Wc)dS`Ic>b
zDKT+S>*DQNNNil3(2!yYFlY;PXfz=AE0>aA?i^Bp5JWsX5g3RUbv>16uP8B%Bs{86
z=6!apfi0COWz1J9IKh{JIMh?#ZS5yR<3HDe4vE;KE~u^vNcX4QW^|WXV>plMHVv)7
z#*>2S`36rd4hgQ@oZ>UA^9n8Yiy+M0`XFAk<U3n%7It@t+hM|w<3hC&?q5!r(A#M`
zY0KD)%(ng5D3o9yBZy%irIIGa<PA~uM${UyxOCQ0&q?w1WJTUYfm&Rz^-UAAbfvkh
zLT9nLIboc7?USlMuU|@Y&`n-KST}=cW-k1I?kio-vaNNX)bmnPzQ}`x<DvK>5PX<!
z3-)&884E^Ez;t2wUaO@orC+9zHP~&lL>%?G$|ieJM%K;8CQ`7SYJUfjycxJ>0j*w7
z*2@f97i5AQCeU6Z?`6c+3?soqIf|Gug>fH7x7(tR_&tdAH5yVXTN88~T5ldp9bRSF
zYoDp!U7Uk`c>ms57W}<g&XEw)GZ&cdOl?7<VMKH9+@n(#Jqgb=ssTk|RLmwmrKEY3
zIvM&OSn-9ZlBGS$;9!d^A*<5NLYvQi!FPvyRrFG{v$h-T)`EHG(yjd1d8pPyGstSl
zNo|ZSOyIB~!;L)jjM>1}v;DW~U7CxqLH{4#afg~M3+H%xPvmhU`cKb(AP~Ps$%!vG
z*48#ow)uW_SKu8-rVrrObdaKof)pu^`7l5DE<|4c9=P)t(3rddXC-P1Y&=*Go{j$&
zTa5iYrq@KE^X6vbjSf({<&|XKM3D#hGgUq0uQ)?H>Dbs?YJwvifaeycY<FQ(X)h9<
z>BhNwRWvOC!F{A3OoCbB=P*O1K?R^6Tn(6<_+lzmP8e0#4o2@`Sb_b!JdnQ6RzoD}
zd+qE1MGfO8H{^*srhRrNh|%Qw#wg<;`}VBo+;H@Dd;<uIUmHrQ=t0W}SY&pqS5R%!
zDSA9FSNfsI+Zw&Bu%h+ce`l`9xvjJV%5*eTdF6br!tL#1GLho)8>M<OAk~(0xFv7j
z%0eAqb*!?n-v+Kk&GCnQwHOrbB9<i{#vxg4eqZmqR)%tpj40*UOAplS@2l!}Fd&~=
zUU=6MI)0X{wz~+EbXDm@vSh_K&4@m})RO`}4h_bV_;Vv<{dxVF_*h^CKV16Cqs;7(
zR~Z?mG9R|}_Zkmtu;O(hE7i=1LBf;n;knQuzucbE30nJWjP%v(TL55E2n1_h2tp`h
z{NPq-_2J5$B<aFfRZgGiIvX|4tH<x8#_`9sySt!BTH!2c$BC>O=?to6ne#ZYcSK{*
zZPY&g!0;2@mlH8_?G6xeWz~fBB{)1(eo7j*z94}Oxi(ag|F#xcd|&DGi^0t<^BH|1
zZ92WiO2?4AU99u>Fcx^idBYid{h^;lrJ_##iw_bFqDFtN1h#vQA~;E8G=9xzLC&1s
ziGeef!E8<x-?uf_nGbJjh%Yk@PtC3J8}b0!y3~D8;VDUI0e*jg7!NX^&dKV6s_pd2
zm5@CSJ$|gXgk!|)U{J5{^`rJ<Crx%OO>Mr(I^*^tpd2zPrF#ZCdh*i#TvGf)yVFjB
zhbrg`fn>jP4`(Tx=Y7x=kB@F!ltZ5|8<xB-@FaM~qTcbnQ}p`$s8-Pe)Xb$^s&^Ni
z@ZfRVBc&gO@|)K=Yb$$RNH4^cj%mfdcJ<$DxU^~6YSwZM;;j?u06I}WQb}jiy(6>q
z(+y`4i&el<d9Sx=3W$UHR+}c5ZTR7Z?18bjDoh8T<&|J=W|C=3j%U*S*bV)a2Iqpn
zxA*riBHCL20_sBN;{D|Mo$7mf;pp2XI??PKq^Y<eT~-fdkgn#@&iw((p%*GgNSTTx
z243dnE>b01K|Og78ENT#8~*_h$G}S0a~Ovi=K0DO&810vlMOMRO2Lyup^=X&`8VP|
zYVCZ$!$FFR<qhqyOdp~(;oN)gyiRi7bUssBB@#fj9@NR=8xph#N7M9iOHZKpfJ3pB
zjMrUnmzz7~1J>iSydY!A=~NbxWlnQq42!=LLf#0IpAe-M9exlhCHaS7kdBp==F|zx
zfPx@wR556{f6~I|U!-almW44yQxs^dG0Vg5`-KN^)hM<^q>>=)QZ>?H6up{0gKlB3
z#rXM^F~ouOB|)?b8#FHiWyQ6yq<566JNgbaA4^tJQ>V(s)FcKzZ&;yxN~UeOH6%s2
zY0ufX8H8}zMiXx|t9IHRYDEW=?gbBxnt|zJRzT{=Kso5+rl8G}SkEiwy%M!qUo=Q=
zJbw44-Ev@%H_xpf{#wHdIPVO#=*cMDwRcCjqr9JRMy8YwB=XNw&4bz{@F)21B=sX2
zUK>*z``9}-L{ln&|IG-8-vCqV?)K2P8zrKEae#2bUi<Kb^QrM>AZ5$x+zv|zPJLz}
zH5VT9w9oGq(8$+SWz~O5(mjVFx!Bk#P5t+jRzt$<g7lpy*AX9vTCQIK_){XiH_}{-
zITA1&@YoH+uvXu&aHusl3VB%tU8|v;n`4xbpKppUV99&Gq>Z`DWu<7@k-oRsnbyEz
zOS8IhPVB^)7w-nYuu9{Yx$2Gel5^SGaeUR*O3U-aD&9sna76ymxRNZ0-4Vj{h4Ftr
z*KTB8;!iz-D4JL2SqZ^00nT>|oT%1-PlyUcEo@KkqU)3>TxjN(i|aGf?q3C&Ja0DC
zY`{8KgzxEW5f`XeUDrZjyK$G&-6pTD@TL>4ozl3sm5rQLLT`y+gc3QBHZ05^Dt;m&
z=VWVq40YqkdBbnQQrJCnJZ{IM1QO;FASrUfU^LU1eoKfy=5%>XfHWaI!gTo_TJa{a
z&+@}X)y!d$S5EOR`jK$QmW&FxGY775<}!zU_u*FsMF94OFZsar`L?r`e#=yF=7V;v
z<6)@u`nMmPZ65B;ui7R?+IXbz1m?v?hF%XSOT2NESA^D>$^4cHS{Z(twBAeTigLug
znh6k{4N;C_j<bKOGA<DP9+SA$w04Z(AstN-(C-7&2FPIkZGo3z$oaloTO!HYQ=gwQ
zH_<-r&ho45Fv~x)5sxvck3J{CN;#w{ma8HB()Wr^ZKdnk+RlMZH^A5%*y{B?Mco?A
z*P@-*Z5|qxd>&uMk=NZ-xzsomb>^upde~)uPuQfaMjuz45uT(0-GhMU4~I=99H?Iw
zKIO`J-`#M$b~%N#(4BMx^S#4FrHg7+xd=H;iTO7}I1|Y|x8G}b$Nd(4pPMtto8t#j
zmvHRnf$`{If{SZg)G6FYC3B=D-f>)i(Ep(wJj4p;4H(9+7Jms|UFWkLM6BFq&=498
zco$}$Qgy%?GY`><WqC~wj4jr<+(@3OpeRt6j$lQbFNO@ekY0{ue#9@037FQ`#hqc%
z<5GDj1y{!QC^sHcrb>6^nY4Po-M;i4ENtnsAlrz`UDwz`yxkHt9(t<_2`C;8k}_bH
zEoL#HqDz$H`b>OH)Y+Cb_!B%;44UnqT@LO)d?lMTXs;Yj#>&*c*OWLKiRe(94oON@
zi}V~s-183&w?NL(IOoku#tDypq2Mh*KRqCC8Q=;v!AD@ADfk7-ET8i7eM4o#>e0eP
z5kZl%kuOXMw%2Ur)y^wzw{VmcOdZcac(7U39?-4sl0Y}Q&Q@sX=uURkl`_B*JBU@`
z+AyeudKaMz6RHa?%K`ADNaGEjUO~oErfb)M9h7coM(9<B>24CK*yAl{+xAT+o~K)9
zwMVjTGn^m7j_O0pK@rFCPKC~iI~M+k2>rB0EnQ}|xh(nJmdG^2r2#S&gq9{SzQ%l}
zedxmbg;3V|#l}7^h<H7D(y5hMg!(zC|Cj6%@1AWt2^-F~$3(W250*JyrY?rvn~zk_
zkzFt}#?tHB2r(3Dp3Dc_bjvVBI0)LqnY1Va(3fvnNb;m`&KC8k-|6)1Ng~(JFZ~1I
ziC}&a8f1mos>Ywr;}9<$(e*tf=~-^xHHtR4%M2hF%cLIe%J2CV>$1~?TePWf@z9yY
zUOlDgUE`){qzL{R4;jlK@QuY6v@jhTrPd-O9Q~WAt7*y|0>$le1Li|A*ri5N_Gu0W
zLNs9v*~)j;-Y!reIHM#6<3?z1j)2h*rJ+`#4W_Wd5|^~ipIugujkP}ns*dPnZSrP5
zlO1>$*I3+iK@2|&th!+L`*;*>^Ub0CV-=biuDCU85DBq!DRS~layq*o`+ITp-p$Vi
zKWPw>(mKnK+pdR!aW&(r!;hO-s)UbGYlviNf}bznOU8IPLpv(5VmmI%MDF|;x(Ie!
zN(<4gHesW0yKZ77M{hh1<SI6U7-!r3?c_VIM$sIrQo=Ltr(+*r;Qc`8X_jh@QymXE
zM`qnvU~-B`*|?6rTcg3fgX9rEW%z54hp5%dSt*Cv5PuhaZ{!&M4*>X1J~Rl3y}IZ%
zi`e|Lcia>kT;3p|3=wDyS?)jM23MKB2fani_pOsK#UvFX)$#3L@gd&dYTZOB`L8VA
z<dd%;8#MZ%OaF_9tgVd_e^&@xNf#}fMAwkDb=v`HN||ojcRI*6X5c2P$QRQTV|$WQ
zs@oblvBHaaG-mtjR<38P0DNiEZfv@T?P~H6$2grPO8Kn@?VsSL)}jN99EJoMXuD~m
z`x6QFDnhT5G(7LV>1q1>!a(-3UXLh9icuvk*t=)@9R9}ws<j7kUjDVzBVJU#6@z=@
zu@@+tRcP#VU)!nKJVny?Q|_vpgL@deyoSczfSe)M0y?_i>@`ChNa@klj8m4<2m`}{
zK-=wJE4q=-AXI<aq7SCBYCU!?hR^NPctT^q?1!}b4|afR#iMHq+rso_#SGcPoq>>9
z^qIKR@Q*s<)93R)2}=>EKj*USHDd@8uKm>g6wV8hMQJCinN2mC&4q|DrZkoqkG?bI
z`JAS7Pa8$E5|F+Xq+atE;2X8|uVIY2T@zp8u-`a)+2o&I`Kz8<9s*j|adh4!0pJUP
zjgiwEV<xKh`8DtB$6f)uMy!h4sF@<_PUTt<=fLVR@)^Fz!Z8p20-o4i&NO@>>0TZ_
zak3sKRc>X01D4s%PqOYjq}Szax++Gvph@;0*n9Bf`<<0xUYQ9?NB)9(#8MJFebg(+
zN3T`RGfZ6mB}!v-*C&Y4Tv)v(p+~Dmfw}JM%jnNiWI28kig%UR`!Ks$bf&$xw61i&
zQ<|vMf4VLG{YPsb>cej(eb21EyyAW4K(ahjI4ip0QD-dAB-FSI-7;lK&NCB*#TL$P
ziB++`o;<7mrfTa^yRHpT+xMdFV6x7CI#+}4%Y18cBk5S<bv5hMW?yZh2dtNIL2OJn
zY|ocb!ov-|_e+wuAb6texu#&^GFykebj`;~&eC!>{{H>}V^iZ_Zgww=hPWrJAGiNm
z5ks-x@{An0dmm&c+{L$6Q0&-jpTv~pWa?I*#T3V&x>sPF3VEGaTl#Rdo7KdAIQelC
zJ;&WeUChGJ*UYXS=n1w?HCz3D?xC_hwVb02ug+>BzLsK1OwkPXkTm@m4YSGj_I9|p
zc4yZ7CG`GS!7J%Ifd0*;a$fRrT1T%j#+J3W0sV^a9ly4lW8fq{)8z>iDpKN;W%5;M
z@UDS$_No0dHMvlu;<1kFCEeL=U`J=sCh0fF!mJ>grWcKojM3|nj-$q$FO!v5zx)vE
z6v`ZDO1feZ{!GH!cYFWkbY%{6zGC4el@*y|!RI+hQQ^b#+~x02e}+pjrPwSdJnZ>G
zt&rJwN<Y=c!Y#%uEiGhw$6xCKxT_z))#w^0FP;8DoK<9^L?jox)^uzu)qUC*iu1$2
z7fkE18|NVZbFq}7u+bYl-&*Eedx&EA&KGEDP<Z2Uln#pH_DyTH7cjSx$a!ZeTYvl8
z4a&@AQZ_>nL$-s=KTP^ZsP7$q5h$~&0#|udV^8AO$peyE1J7#+GS=;rnNj_f_CB5=
zk6F-rr{Ibc;01%nY<|MLkS+W;!M0%?m?jSh<GU#N3rO!vz<SgGS7>Gb0?uEN!bJGP
z_POEpU&IxG_hj`<0SUM%@t<ThU8j}tpIBW5Sz)C=K#hgU1Stp;+basz&-`R1H||Ls
zGxycFlQop=%+U`r#W<Gk@+1(pZNT^YVJOw^DJbg_V_-s~n>+T?&xjADzRGux*IKUp
zkA1}|^sQs5B*LaPABsnBWVV=f-V~h8sZOb{eIMW6jRk0)GWSGYp?RLweC#PAb>3lC
zkmX}F;w&2gI<;Ie>k5<7XS%C;-(M5I=g-{pPRi<P(H!r2LOMi@^OA4LX{?Ut!xfI#
zYBG$Eql;PE{5y@G%JbbVDOQ*dSl)3I_jfmNUv)=*Ag`{SJa;K^`F`oSnU`Bje5i@z
zYlcx>tcGkJZ|}2ZeO}u5LgvXHQeB|mI>>iQTMbD(y-Q(Rxx^e+JQ5SnxS8<ScfL8k
zH*+`0sx2-4*z@)n1-j1}>0G<_Mn>PiF;^nN`5GgL65RsC>chO*OB)*QZcT185FdRd
zi71b5WqCB<a!+9$e*xV?R0mL8hBT7sDX5PX7_g1+t{*3{kx)mMbc=p+W|62Y1ZfpL
z{{r6HSPsyX14QMjB*QI5-%}zMBA`#ugOwbaN$qU7$zjguz|TG%p{i9HzHiAyOA3Rm
zL9Uq#WzQL@a}H+#%glTCtSs0!d&A7GRVJ(uh}o_X(R@CCdTsfw54+qHhTFj6o|{+j
z|K-V5_0Nu6|27`!fQ|S}F((Zqda>(_i=dD_K~#OaFtm2~;)*JVBT{J_pP0&e<a{#$
z`(w96h0|?;rZ%H6O7)G@m_RSxUjS<{QiSoioeO>1*A}T*Coh>{#Mizww@V<tzV9!7
zp5}z!qcS`eNb${~Q5r|Qat{3Xx_+uK1F*{0!Y*{>m$`zj@`=o)y;z#!-Ohxi7qfW!
z;c)Gke6ZQ7nWadm3sKD(Tu?W?G42z^s^aEzAoI1Ly1sEf??{K(C!8zseW&YZus^Oo
zAl<ocAyxKKh|D4!;r|DwL8{e0U@S9Pcr}y|X})SDrMFip8vJFhyahZ6oe!T9HBCUm
zZugV~w<81jXgsz~9X?*#Ei~aAWhP9FsX3mrm8rb8Z^kVgrmsD?Q|wH5xc@>(>>lsM
ze+skyh4mhD;nx*_n97Q4WFBMpPpa_N>3io6FZQ&PM%@;H3M8C>be_$xF`V=zk(w3>
z5*eMUvc430r^eD~w!v$?eQ^4ZVr(m6owSL<X)9+3)LNGQ0z4nI+GAI8{<|$(8P|8t
zx`XBD2hIHT+so!VjWX1Cf}kHUoD<)l{M%Cg)5p@!@kbXW?UkGbD?nwrdt9G9qH*Rj
z-*5Lz_${E%<uc*Ww5cgmyQ!>`xgg{t2F6A^Xw;3niTx%YOiQmaFemgphd3?8#l0zO
zBTf3u^~?}_j&8x|1k=tN7W@WwPpSBHCj><1dOg0a7Z-Yye~U(O>M9Jh>V53$oc0BI
zsxviu-BbzF=AC;oFbCk#`@fypD)u0v#vs3+@92*FS%dZiZ48=a^J<nWEDp3WD)_Z`
zEkV#sJ|o=^!onft=C2HeB3nG;>h99vSkY<;w0-&C#j8dSo3qjCvn|XqK*x}Y?A68p
zNZhM(aAiaa%uA&7gb%UJPnYSAiUYHMIhzhy-X?sM+gYRuM$D^ifRAH}U~i830z*mA
zPjx_z!EV@{u}qYI9%*S}?(ALHMunZG`3`6NbBwI|XT!FCTNH<pXqg?ue-VV*;9d#y
zdWOOVyz-mrGiepbAqeH<fr(nAM__x-s@9F5Q5JU=!{s*j^&;w2E)>YqP~QGEp5%&T
zK?mp18jpFOt;~H3wEsYg%tU;}35`pT+r5Qv`CsM+V%eUb8<xD_XQ#KxdL;iwXMG;K
zGYmdX2sNAfIJIbSV?9UrW327fnb#q!J9Ot7QJC!6trjB=S<>>dptJXY_TTN9jN61R
z;H|B%rBK5HeJ93t;oIiay(7BDT}1d+#LQ^Lo#e)g#EqY!My7t#c(BdaBT~hO-D5dW
z!}$mLr;*Auu9MhQ)!>Odt>QNtw@+gO4}o6sUE@JlW@6#r(U1U-i}Mx@t~z6Mz3L$h
z$3@uLq~XW@1@tYt+-#;y=Mz9%S(Z@<4pGKL%KxA#^wvw(k_KxR=Z*PA-c~vHLWBVW
z?C{VY6c5FGkAA>PWl5L0PWXs>$!~G>K7<6xG3%6O0KzTyso4CLUC6b0@wB3q_Sjmh
zl!DZ2DV|==Wb?Pi&xReC{ip$ssMV4{IlCY)8OXPUBAu1oSLWU<D;Y#XkkE0jh1#fe
zO^`S9-a-;gJtqH}4O)7bN5687+NX5>w9ilT<7REay_pARS;x+2(0caSS?qQJ3*FP%
zgA}FU78oQ;<>mh#q%e#iH)YB3lwvzCB4N@-o-xy=G30&Uf1XH`h)sze{k+c8&<D(f
zXDz<}BPZe`z=_q!GiDFsKG=H_!!$n_uoR8_@ueVwe@9W*e@LZH%8Xz3Pr^fYv3B!U
z=dwAw=pUIHT6VUR+xQDjV&-=Z^0&B-9nM?hWxE|Amkt(U=j|3Y{=un7w*Rl8j{l^u
z3|gT*mE3I=ypwec?8s)f$?6Kro?@qZXNHY^(<5yyy6;!NsO19mv&&^2--Trl0@k*C
zGJH)ap6RTlG|}wMEE|E3NkuyJeqMX!?5A@&(^u}=^vfo%?Gr-Bw)n$p_T@@<mPulr
z_Nm@ion!<@VtCjOQmoFy+#8(tJD2pUC{|?mblJ*}S%uWSeZ`KLFMdpNA0x@>tOy!S
za!dZR9|GmM7Uk4}XtI2LEFWXDOujeX`7NT}(!yH;j8~bM85xzoEv+y(RP{XJ#v2wJ
zn?sNc#SLZ)X|KBhKV<^jsqwk^uUdl-r8`6}S2xkBF1|67WO5~AG0w&hUTbsNprmot
zEi979FJ7DNjh#g;%6vb|J-d5E27y36cO4Q$*ZI%1utwe$MAJ~uh9rma+lz32zq1F2
zg-W_LN)|VMvnZIh%DyZpvh&l&IQlM<$!1mci0kYr^U1mUvF?#kKk77|&wQW+zKw^2
zDJZSl18+5mT)3)Ar#>$v1q#m8iJ!O2%RiZauIu%!WcOukF1RNpSwR1z)?EL-jr=t=
z*@y9eG^9y+1wV?Rget|BVvG8?5?U+X*?4lxUVBX4vGph!@(L=zx^v20T091M+um_W
z-t9Y#?FR~&MnM!XgpG368T)46y4VfCofp98!cstM`qse^MB%9YSq-gd0+Zz(*^9QZ
z-gd{ofJY!bwPWDs`52>a{LJoG_gA;PL~J8-%Nkf-2SsEKYSMjHX5BrJ<TDvxp%=^#
zG$&Mj0l&CLk{n%8m19XVJt?k~L@Ul<mPa!KhGqa~=~V)avfD#W2mg`ZQk-Y`b1Ju{
z0+p*Ap_g{}(A4$p)RmpdEL!Cy?TEKkoZRa%AG^XAipJMR*ArZYma_v3+l?_`C_bww
zhYKmGA7~JkTI5K#fb1Q=ma%4U?U<_%`#?RTnXCp;r)IKlcQ|NZua#1lMTp13-s)ER
zP)-AG6$@oQ_-{%4--7c$8_@mR7d>3B1-1$hz4%FKJxwxVw1^R@!ZMK}u<bhIr$)HA
zAPhy!Dg?d=>RG%?LQ?I8h^BKYf6TTYc!up7%k2b1ogpardrSNHEy`BHLEyf((FltF
zH`KaJ|1Rr+c>?D!UmDC|!=s-Dc_1QEW4TE?yNI09uCAz^M`W}~^1@FiYPcw>_yxWa
zhRTg*7|az~lW<y_0`Oo`OD)k+Ix9Yj&!~E`1X)e!#s|{#SY&fTmN{@`_+!u5hO3Cy
zco1r{7&eaM<@QK03@U3M<9tj5{|k^r@D{3T1oD=;{#r_Oq01^U%~A4yI>DI(NQAi7
zo0{`~d#lw0ZgIHo7m27L2s8Qzf^~u(ken9KoWTvHB8EhVv0}_gC&0tHVz5q2Hz14+
z{PX+yz%v5m3;EbKmS%L{r+wTCd3s6NZTUWg?(0sbSc|iOh=%5zLEWZ9U8=2iFk_5}
zY)|mmTIW0GmoO-`qg`~$?Szv-jaRCudTP!&89#F!O@uUenPnLN|AEtQJWHB;#ewPl
z-f>fSkT>&b+2=26n}FUU?ft@NDJ3e95(<V&y^pCC*x1b3(bO?r=>Linc`pP<h~C*F
zT$fs#2dSUR7|K}(IdBR}EL9U6Y1-A=<FPeZ-wpMWZz2#;QxZygEqqZwZDAoMSD*fC
zaLnPOq~bkuej8)7!#r5^eT(8u<>;TDSTS}wlqVGT#UiRVtXcc)-eBCfC`DRFh6`CT
zeBV7%n9CfKrL!DkAY*qUGP><p6iA=f%Kew)8VSP8R<@jg<C^3Yf`$KRiFaiEkJN{{
zg@Dd|ZH?Gq90^Y0DR@;vG+RKah47U-8X2Ao{*L%EG%C?>eWjqdv=``#Zu>gcZ~B53
zM0ehX!qbTA{+dnv5PuXyy<L)g$s&cN#G0%j#ISxiy<-cQs8mx`CZ7<!xAg5T`Iy1R
zE;fCGmJRp}5jp12wPMetjPIGZsF|yB#;GWjCCEH$ylT@vB842%k&#M*!xnY$Wtd{9
z?i}(gt=S`UaNN?UE)ryy()l6~mM;zIa%$5Gw8i-=7K}L^&=!QO5!TD6Vbgo&p_Mhg
z$lHvwtmbaL<ijl_(Xv4!BAMt3F}$31y6I$^?dM7et$dQg!_v>I^-jv(K3wVSm3pom
z$cIo9L3@_1%t+3SLVOI_@*pWYy7HY^JU<o1S%lcnsx+*<xO|#GK34HmwbBOnL?YWe
z3gk_)Afe||2E5R34|-0+jRa<c(d=Kx_bjJs%ylvA4tj^_q`O4pqh5y_$l`yFPKHhk
zMJ@pw_1gD%SccEcey5kd?=(97DuBonXy2ycKPd_Xq-F*`o6s>J9p?(`yQOI?63K4@
z@>l$hSR|gE*ddgEv51~^Vk=m_37FwKF#=HaqMD5$DiiB_K{{OJq;LWgqy%>e2|A&(
zw(c)EODSqa;rfhz5<eU*co4n(`_A63j)=4n++X4DG%y;Qtqu3}jAm5#OgDjJJ(39g
zP`Nr|K>|4h4Qv<SCDn7;5%_^)5sV2|PbIQ%5%$@5wv8}4MR?Z>UNatO^s~4nwJrzV
z<Sz>yb*`hRrY1jxF4Ascov=ITrBRnDsNtkH%UfR;)a$3`h2MgEFSTzaO*%byiwpS+
zC<OMk<&~qj5ptx+qwoiTzJD@((YK)`G;dM8u;<D~8WpZT<v6ACAsP(4$*GY%`HT<B
z#<TRVQl9@<xu82&+ieD}{RNPWqb50PFm)AOo#3N$kXb1e%`9Q-9nEE~eG5NAR?}hM
ze_D!N<71%J8GQ02dPUVnb>&rp2${}<cYtYtl%610m$=pSo`<;?{>P+-tJnRH=5Khu
z)`DE{7ETVYjklm`@Y@4~px%?(f-%%TSMdLR@b#Y^(*7+CSpD?3s3HyQXGfS44R!|c
z$tI+ZSWSm!HH!sFB+3DsMsTl)PvoK&NfrsD!E+40tyPb>GwE*RcG-1<_`<_w55B|%
zwi~|SW^p(Oxt9rpsJ7f}xo4^j;8Aa!s=Uy>%|}-HMk|??+enmW&#F06Jt+N4z!M9h
zUu==edgHXtG-J_EC|Hlzj(}pMCQ}wmKM+<t<~G+qweeM}81UGJXwY=QLoB90$hyT`
z00oW*M6LFXxP-uel`P7}`0s}zgO@8qbwVA8rt>*2$Ob*sTu0-0t-o)E0T?y8gkcS9
zBd@YBsY__l%GN)_!kac~{P?RB`JYL_2vO5&c0_H`yJwB>NtlAh-k2*t$<HzDeWq8!
z{3Zz)25C;g+L^-o$OA%Urvy~?-YnPWTEYc>JU-P*lipj0NGP1b1$Lf0Kh_tS+zuE7
z3Y@RKxi>XiAkyT6>Gr2F`8s7iLDj>HDY!K8c$`8WoIRx<u&h_(`%{D0fcbrd^S=yy
zc_&2X+$^=mMOwyBpPfGBsBe;YeB+g;eDD0~x_9>zdg@ON6gIJ}*`RQmzC-1#H7z6~
zd|(F5e`BhcZAD#wa&WM@s^XU0W5qjj<1`;DK)#C+5^n=#sLicLuhTCEKoo)zF1y$k
zhkC&??L9h)FvYRoFCJY#zF2sVHy}mZzW~l!Eo3~q#$>IA#kP%aV10#y&xkkf){1KX
zQ{cyvO6vLD;6RC6(<FqBbYN<xhh0u(%3%Sbba$_X%WhXzRUo)e=c)vWZ$V~;h{R!k
zzM5aYytF2>vqllgdM$yzFDA|`ypvTPA+y$r6Mn%WGKE>U#G+Zl2=AU;T5^QilIB$u
zUlifliBgheZao+?ZG5+vdG3w9qzxP5nrz-Qn&|cjYzW>*o=~@p$pDUNqALGKImP&A
zqOy`3uUT<4ct|mVg!yL;IK&&P+h~yRe4wX2WR|p_KMW1~<8n!+F>+j32LO>2YrZD0
zX>kzWfU1Tiuffx$TS`pXVm4}<K5rX+DiBOkR#plOXAEfxLUZNqzR7G=<alBU3EDPq
z*h_%_I29gS@7DbJS+06l){wNP43|a3W#3PAR<lz;Nmh{`(2c^?lre>3@*&;sK18I_
z8!e8ieuPWE9~4iI=1$-8e4mV0im==`Btj>@J4yPsr)4tT*HQVZ;&%FKYy#}N>ABni
z`6M>f@H>j~n%g|~?J0d<;*iR?#@s4gm~?UkcIs#2pe(8rdxIYbh&eestwKK`+S;%4
zHLWAF!Wv?R<P3H@@ru$y<y$zl5El}<b2S_EJlaK&p8qSbtcd|&^lJ~8Oj4Vtq0;Kl
z89uF(IF$6$haZi^>B89>qG{hePj0y)&ymQh@V&?l2dvJ^V^RbGdq5x>XOfZf+!wk^
zCeJl74j3*EbJ2#dHq3A568}N+q4L=%?F;tQ5bw42)2q2Vi9cAU;m2rr45TsmASV}1
zpcC5^BUj#@E=KToMS?Vx%wpi?QJMlA<x61sfT6m7@hfZba+!{2{{M@y_Y7;Y+qQ;5
zR4hPL1nE&hQ4tX7H7EiqN|hp2Kzftj6BVUM2~|1~k=}bJC?GZT8k)4wTLOVpzuRY@
zz0ZE%bN2IoKXSnZTtL>n)?9OrImVdOSFwnOSSf1p`2e)N6!8M)r#w7~^039M7|8nz
z)ftt>aNx{knE~>0XS(N=0}pPYPUR<TcU6N-HFOkd0J(Dtu-R>t%J<uRd#Ef&SDqu#
z0oZA_h2x;35AVdl11^1DH@6&^(a#`06BU6fgZUeQtRlSn<alYDux}$NoZxUcH^g@H
zNFkGIOL?~W5O~IhW0+r5D;#%o?4g6hnZ7Mp_aUFiyWcb?rdOo>Jzxyb`N`FFN&<rL
zWN@eS7&k2j?t=6NGQn>~5ocR-cMoqrn}sY^FR>H##dWsjaGPfQfk9<rNyy-VCTeZ5
z!FmmcRRel`T+_fvc&fH0(&7PDmj=rI@pcz(cKXK&xsSXw;<BEbF_kl@nE(l?2X`Fn
z=$>+EnUDZ`CLda{Dw!5$^6ndmOqF{V=$V~yB-4Cz31P(RRkKJ-&7OSS<L!%kq@W!#
zCWBG{zz_Q!tQ(7|wlWzZEY4p>pv@wNE`Kwq!|eBeG%)(VZWz1Wx9$&?_Ys6HTC*O+
zeSdj4MMWu<rw1s`z~H(DGh1Z4%^tx0V}p|yNzBXguQ;4a2A;zD<jd!Uw&A-iO#Bs{
zWbh)eM#9hj%kun>Q?cGL&tyE0gA{Z5dT8wHlfk<ZIK&DhPHv|{E#L0_h)&?d%ZhK3
z;`<h~`hbXr$;$3<N^Eu5Y1~1U|8$YxPYNK&2H){TVCe@kH0zv<dc2*Ar_s!Judp&W
z?JnlJUb$1w-7LYELY8jqMAub*>JnHb(sgf8GDg=?3kmQylp9x8%m`g@312s}A*g$q
zlbe9*JrpmzaK63g@ts4>5|!zDjEkM8p*@}PrlO|CRBVHpo!f$(3|zlUpQuSh_JEV9
zTDbNHRoq%UYv)ke1Ej`y!cX;sT-`hrYv4^|*~j__$+97@C`N-O6{_VfZTfqd?Fvm$
z_dtc8&a07<vmCmBzj{Fu9sKP)=Z3yN)X_I%$!G{BE7#_^B5PLc;MI^YQ*+^Za&r2D
zSM*nLUk(wu0Iys}oczl)|Hr)`S%`P)0l&4XM(Wg-<qHS)P<q5QVL?K${#U3b)D~*H
zp|zRe+fqN`__9SHl^AIGjyG1x{v6TLIpQ*iZbX93pZO*FB=?gAcpL2Cn@;|i|H~=)
zkf7GVN6&h8B7!Mr?_WZCwk!@-J%{ufDj+iLTsZ?F&pw*hJRKeM<U8bx(++U28eZRD
z-;dB*2D6XbS8U+aB$V7^Dvs4~TtFO>md#~4uQ6h3b~5g1?B^;zpJSVg=!?nQNpU@$
zGbDY>6Y|jjM%NaXd$3G7b9qCe|0rp85B*Qu?Z3~Gid%gJ+L5c*x*+j$7QbmCY9NPK
zm~1K8;9sK0um+GFfbRUJIYxKvB$C4T5V!~gK`>HTAb%Fj(*+6E-D)l7Z?A{!sYZHL
zAq&Cv2l5UFtIFoTii$6v_@cQ`y}0ZAH6dI5QP<VoZuq8xBX%HBpVIG8BcnHV)?J1-
zW-(8L_kf{>%_e?SxypKMv0ccm^qtR6J@B5d5n$P$;m@vQn8)D_(Y%*UXpd8%Cml7E
zr4iv3_Ys9IwFeEx)M2~*ZIFH+Gz9K|z{OE*8V_|82e&+YA|I-~L3!Ug{S~=WO`kdY
zxMUjBdBx&UI*NkG9@+>j=+!;*Cg2fruFPy0k#3gMXLz<6^>o}1aiBRq?g(;zd_8=Z
z|NbKnv`$Os63Lj&X2QXj=h~lOhg1TBofR(oH_estLr(5<5@N3zoH1J3XV0_0n0t=^
ztJkZTPQ6{0Y8e<@S*Iip@NOi6TEWA3Cwi)DZdZfd6HkZm-Fwf@2*p7%&+?L!0AR*H
zZG3s#xPmAT;U#hd4)jeIc#!&ifE^Z^KfbAYr9*eHN<jWjP?*0@f=O^I7FN|h_#)OJ
zg|G?`IUCbB?iwh(Gm}tO8r->`6?i^6(D+Br<$pbMy|Pon?~(FsrK>_|-$R#pl2m4I
zQJUOyw+8mj5P-79C1slyh<v-o7|Fm>PO4EHsu$jfvE)!$+MT1F>`op|Ujq5XnV50Z
zrU#4xUX0RQXz~79Pl*^o;w1GGNX?v~=6e=pVu~UA-Q82_u0d55oz+p70wMd;JAu~R
zL0@~f1~4l3?w^@wJ+govO+CsGmlrLE-#5EK7ph(I<iD%_|0_;T7XD|gJn*BsO&{${
z_J-~LK(1^-&dYLsuTBqdz`0!f^y-W4OnzP-sTYotx1;mSeg|2dron_c?hgzsnf1U$
zVWpO4#OFa0^6{`Ay!)i^Y<xIb1qM2L5DcUZLeT;6;*vv-<=owx8fvn)<EP%eH-Yhx
zI)$SVdU0Xxe~Y+=^KC5l8IxM-nK|d5{`fGS${Z3}zOW&2mmf8ssGyCj5=z;Lxm;^3
zrBt9yYRv0kl<KMCJK@k#P`#bFF!uU~^NqG~FE8#F_LjR8m$;@00O(o3Y%?vY?efo+
z)Z3jEc43yPZHYLS;{33g=F7Er;!~o&A=UfKEQuql13MsaA>Kwp)F%*j?I=F+0eOww
zhds4E9MH{0Y|@OqF;e|z)2*?r$onMw8U9B1%V4ILag}d2PAyIE@7j*w@ug~aPym2a
zrx1rluC7K0bo}5f#I5xH6k{bO@J1Z2OBDr%pask_><;Bq6X~zPgvSqv8n#vF$n13p
zGm&SSrJea_+=DyM8Q$mLeSN=d|Ktm<*4zL_><hs3c9_p0CCR)Q2(Fy7w}_zu>|YQi
zuzt--K^hK#h^lyoGWP8^4ZQ7WmG-^l^!>N1HWXCLY<_e|#Yx7lh=7*-&cl|2r3a>~
zCElYN`t3f-jeffo@J?n$?F=~0ID}WFl2GYFh*7A~8|MsH`#FTZfZBZdGmPzt@7A}U
zY-9!AW>rYy)ba8-<I9X+*pda~-2?fS)M@6Bat#|FqiEGDSDvVaC-@$<yrs<({ets}
zvrqb4zu7Sr0rk9WSDi{=>e35~V*Qd6DZVzVl8Mz2QL2e=i0aTbdRIH%2<6~dwM_lk
z?p9HH{ghAs7nF^YU2guc8jpyZcx_$K*cv5fVsX$bLyiDvI5qXveo^(BP4cVXG_e6l
zVWhCUuw1v(%1a?}&aiEZmgH+OUj^70Hc*;lCv}Q%FD3ZPejNzcSm+lQz&hiPs;iO@
zu>(;7nhTsmYm)1B89=HoeV*X`jowJ0w-{=!wLbaKXY|FnZpoag={$aP{a9OtJC7?#
zbu(aExXRBK@vQV0OsCTmN$8Qcx9DC0gv5q+n?u$uF(u&g(vt^ocV{pGvX?|wg)8w5
zCaTqO1s|j|09WC;riRr4WGd7zq4?LBXP{DY*2{G*F*TLkA3w&lzXWM~YB}tiwDUOr
z7}Gnq0k?Ii4v3sTglTGc036qWzI4yXj>B&pd~O*o3RyBlxT#7@nrW8jW*<}Y{d{~4
z8yrv&Lq=yqrkeG1Hn_kSg@J&1p6cqZR4dYp0gIU0YYVa$7hiN*x><cKIU-86ZqeN=
zvBnLY>(W_2yH1JkxJc@D4LI|gCIBBvkFD*38XwF*!!}3PMa4JOnH4?P(g+_-YNV_7
zl6N;r)Q#gGHQ7n6I3T+0ESWJA)#QIEpZG*umVKLQDKh(!Abb_i(!TR8Q9CQ=I%!BB
z<pc`cH|504bA0k>eXy2coVf6h@eqH4?3fBo={uxCs9FDcm8;uK=`&9IUVHtBN=QfH
z{85Yd_SxSwATV&$j`H%jamk>s9=`Jk<ozZ9j<j;}EHzf!m=_gHNT~3O>-~|oc2<|x
z_uOam32`EIs3WVCRX3o9e}`$QtdUL^Jsdrv6dqjq<_^LA+A=-Wt+e}<t_P#tN68yb
z9gyW3d(~<gJ2zzQp}aBdmmS(>Lxcby?;`_~A(n+DHZIuRzA+x2XL>JcocrOu@Vg;j
z@5WSSYdq-slpbtl=kKkSHYiJiZ+OaQZ<*PyiKvPFV&Lt2uds<M$91N+mj8hTD$^Ay
zJEdQ1FILMx7R-Y9&WmwObC<Gv@CCLiyqkKxj91a(kGG+2CC)WoV)N?X?cV2DyjrlB
z_&4zUf0S1J3GoRKVaKOuvOlgHa=e?EW)AGmDx>XL$Wz(y{}umMeC#>)nx{Iotwg-x
z)ca!uP6^j$iaT9T4<t)>SLz~9V#ZfBYjqDx`ByshPAKcr<6baNSh2|I+v5*b<9-a|
zng?JBj}@A?Cd&N+6_NlOEvG&@f7PZva2eK851ax^MI<zA=O9+Qc1o)-a;qc4AG9Cu
z>xYY7d16?$*?4hLvczI(+r%qe%rZ?g5t0jwmP`NaV%2!1)?+x)<{~?2@sJ#0t?GSG
zZr*d9BRi)$$Bx*NelMd_>z$BbHp_9W;<=OyXEp%=UeK*xT9K}hj>`3wobJ0i#IJTM
zNJOtj4?@(1<OMn8JniUz7y1W#S`EzlO>+U!Mj14R;lgdG9w;9l2f%4UbI@Af={Jqv
zFVbyFd-KvkOUiaiNWsScN&%_~fk7t=xp4IH<Yr8vs1-(#XZ}U-2mT@?m*+`lu5eW)
zr0&&~Xw+TnMPn!RM4lY+&l2*h2RfK}zz?+lo<ZO1dMva8FVtRP=NGbjjU|7v@+yY@
z!M*^PIW<tyv4?kDcz?$?UB6;ac0o+Gp7O29&`A;(1bETd!XDezXqCGZ8)@&Vzd3&{
zMm2(UW~fzRs*HKWL4p$j-}2D@Uc5E0KMX+u<k1$unIi4W*!C1JPBQV=sKwgR=lg7Y
z+)&}?L4_P%%UL3oUSOtuaiHle2(FG>5$V9gn*DPVf78grgydS^aT-$2yDcqNjShZ)
zn&KkdaRs)D(sS-dy$|CI;HH9X0ew1`C+{$P{skcsi^rVbC3H)>2<CoTL^~N7#d3y*
zdc-g`Pq6B7UQl%{9}pX)Q<zw!cK})elq=J8K~qBP?hBoJhaE?ICEg#*^xHWspO?LT
zDEZ=V!5F=Ay?Tbnx=kVKNhevuT+P+1d8B-Ai=$}sHi&vL^yAe|Pp6;N(8S4)7M^pO
zSadu6ROJ5hgk0I%dbvasGL>9A<onI9DrIKF)_f$>PBtSJa%MmsMf_=Fu{A@G230|8
zHBxJ<%EWGT?C~DR`I`U>nBDwFr`Ocr)2v<fT-NRQ9odd6G`C>A;`qK}udCGCW<QW>
z*`p*w8p<eClDLQ!w8X)1vM8Ovm!7?;?$X~3p|Kh7#FpFXE*u(Yy6guM5KR5wnGmo|
zkKye|>%1+OUYAkMVF*89^Ex42AIP*Z*`rzrE9_q54yB7lk;aLaw+~)@MrwpQ2^@n*
zBTT{yM^ovXDM+J9F=0YS*yAU1D2!*spx<XdN4dzyb8)@E9k6e@Bu?;u#iL1rSvGcT
zWy9x|k#{KC{wf~{>;#9eCp`z5b<-iU=<w<esB8HFazT`i-*&aT3O-9r-$9gB)iH)r
zau1u;hkuU$I9Xj*{iz=<^635L7s@<6UuZ|}<!)fMd80&FxMQl&@vVKQCjYc)|2vrf
ztD~;xv*`PQ$!d>(l|YAcX3aZxI=~%g)Q{lJjzH-oC8|6YNSU*=M(X+v(&v?z&64MF
z(N}nEn{m{9*ODn?!^!DqPGUD-o6}9J;-9IjvI?6%S29fTV#l<M_+%M8qox<mKBP{p
zA&$XNZSD--(4e?90*-GYQLx4@F@Ya=bj~$c>mYZ`neEky#quyuTc3^7)(r=vJ(mSp
z(;5J%0yA-vB;0xerVD$r(x?Qk!j7v;Np#wTkO~&o>*o)ebo%ubv?iL`a=#O7R{UqV
zMA@`wdijP;o*BHc&APi4Vy`Jd;t*u?kXe7#oy2(8C*TP3I%A?dt7K@MKduTJHoiJc
ze`eEKj%p-Nhhr2!59vqTNq;$Z_(H+VNqIbtVeLB87<c_`RHE%!rlH8A&K;2K*5PZs
z|1J244ypIx?z?#l_rV>+dD+N`zr6zfBN6w{6>u8;mNYVd)k<sH;uDLiH)f}hkV(id
z^j+#RH5-y^^I6p%U9AB8a?CFcT~Gcja#6rwEo<>A+&#k+QC(dz=5sIONbv<s=YSPH
z<=pjsYVwdH&C+%z?EdEH5am3%7cd$D^%gonBpf(8P+6P_VXvboC043d);xKI*K{5-
zEptg%HBcB-d^zWP@zq|=$Z~&E8`V!&s<F|WzK$dqAkswX_znOc9^)9&^mcZJm75p#
z^6EZRX}fa2^W^ilahf6`QFg%^i>1~3JJVYuQ?ps}kjGsCp_jNdl;#M`RM#N2iY8o3
zcAm+@n{~rt_&5y<SVOG-#Y)<xj!+&J=}vzEwgIhJ{1?C^ypzoA=_|5UzVvST+C1^0
zm}=L~0l)<4E)Gc~=R5X9`buPpl}UryqHewK?nIX)9OXF4m&U8JJxY<RopO-`kT|j^
zdCsmgI+T9N^XN($RPBLa>56w8Z`vi)>*4oy_?rpK>WJks)PzNAr)q>+68PK1BsOE>
zb(HDYz^x;A#Z_?Cjd{cvB!S0T0c81`Myt$5bxNiBBH6<SWD7bz{V)JIdzulbWU64R
znz%Dt;(otrMw)c{N~Wm?GQg-K&<;OP?Bq6Jk~fI|-k<rm16Y%=Ie($pHRpsNBg^s`
zbIl(gIJlel3ziep2tnAmE*`7<Px1)%<Fd&LV=G@IhU3Z$#gu)y^Y`g$tjxz(I=U$R
zl{!-#fj|Qt83uOsQ31%BQWYP>S`2W!ne!i`a@ouWLA#kJ(tp!fO87KdE57M707tDV
z<>3w5lg+yy5ug?Oh48L<6zt|aqmIT%PKKK4a~D{av0IEmK7FXl%a*RK=Jg3_(=NRC
zldSRd2i>pSxcJ;z`UiyF*G<R$J<;-|Q*;l-4yE<Ej+e;yFY#osMQ&zJNelx6bYNoS
zT**<-myv|1%p%WJiyMZQa!O9RrCcOET6IzA8(HB=Z-Eu>Z<#a}jeuV+9@7$e#=gM%
zH3(k2BO!e<+;edP9P(q8f}^~%A+5gx;xUbqmapN1F8jOQDK7S9%it!Kef}Mg#~|!p
zQyj)EJd^Obhv=(-%FSONXg<By#rj~P0n;dvcvHAY2RVWdX829>2q*;}TZ^+tG1lkW
zoCYlIS-h{+m8#dpn;y)%s{QM^*aMW6hA$R>v9iLZOtjvn=)3Vq1=*H`)HhaFeq3#=
ziyA+(-fw4c{Zq=hxCg<q*hk;4-)$;1A@7lE2HS#h41PuH!_&|88U)K_WvH8ZIlIY|
zjSz_ku5dKOD1Ttu@0oQrq>P#yxjB!E@1pBmLEf#s2RfhrR8#J@fki2D8{?(W4ge`r
zB$Jykhf~lUu*)Xkw>3YY(bw!&p6-4i2LiZmXh${L-C?s&&VUX6F{T%6wGcXE)=sTe
zO+_=BDjmKd(^Af|rY^hmxk%6O4ca#3<X}^vG0m75jtc^tGb}n9mNm~d-YgQc@vNb1
zo-%O<`vHo6I{<_&)r|3P<H~q7UUXoPq?=jG=zVXqJTvn2!CI%|_ulDyVR=8P;zaKL
z)Tw82SESzr(2~C4)9I+L16b1I*NK|%H~T~d&q!9XM2J7givm5<agH?e!!+{STPO0G
z36JiIQTx_iIinXL7m23GZ@vx>2CpA@$a4%liFnKHWd68b=aoTTAvoie#<k>nPH&%s
zy`Oik$CU_9n=edUodNlnC?Q<}Y;VbLkF;^<<-O6`)t%HWdLjAmq|^UCZ8rPuxO37i
zK&L4!$QhEdHYTp7c8UHD@Jsu%DnfR^GWc*OCj>z3p=R<=OTVJ29a7(of~*QDiw*Dv
z@WHap0$SR6r3M_1qJ)Ikp&=8HUs^U2UrCu%f?AguE|U6kA^^F9yl<Z}o^{=x=vlpF
zw->s2Zsbu>Z-2z&e6cU|{9o|yOwTO&P?IaiLJ&v5e&M`Ph{Q9tue{%{OVvoK)`bl7
z=#s0kF0m~TA=@`oCinMaDdB3eOoy>5)-=Z_=xaRu)ce0@LmDFimFg28h0$$_w_VR6
zJ41*k4P^2ya9>jpkIBD=J;T1b6!NiN(JBKw8uj=VWPBjgy96vXXU24tL@6C?BkK?0
z<}{;T63^v)r@-q)Eqj$sA)1xd%{4CCb6CC%fPSC#w#QcS`j=JTvuE3Rj@m1hq;g*Q
zwhznR{QkdZ4JN>v!~T}3tt(M##x(h9IqYc=j=6{GT!sZ<=9A<)Jzo(&cwIq%^TL;3
zh%kNmI!xpG8AAa{%Y_WH>~Th>hL?Q8?#F=N51Kn6v6^&+HREQ)hbM9bE$q%NL)!o>
zrNxGfNg3!dH5ueN&u;xh=UGJ9&dme?m00yV7hfRE$*6^7w0vP=_3L{UT-V9)IlBBU
z4QsIs6kXBi@*%DMqcd|e?-E&BegX^c(efNC6t_~CFK^WKHDP!8vcSfStZc#VkgqGx
zRU4}*G^A%e__ljMDw=14s=dvS@>YURzm7(>sTdnVUSe1`U!8SVtN&`Ok<%5*)ZWBg
ztiSpcktHo`egDmBn(C-x>Bs2}$lfy^i4azUos;#1$0sXsss@QTcbv_0?9X?%>PEJ$
zOoV>?a;~1;DLG}gR}4bwHDkF8lklHwq<9Y^LwW|h-D9>|q7(-3cMp9#o+^dHBNd$j
zwmi^Bf%`cIMs|LIQOVZtW!28`)>el?`&@4+gWmwcJyrz<3;FMReN)+~d=(jP64-%(
zLC}h7ia;%EIplzJ+OhE#?1R$M(G{g_&~XG6yc6{2l)QxC3JCG~IR!ZgDc(O<8D3%a
z<yP(y^AUWQ80M}v+H7Y65d8jyxBky$vQ^iH1OMY3gA@N)6(gr<wM0sPqC>&7q=EC-
zC#vOK?=o2?BjVlE*vkyD3&G|(SMYLXePCP^kJ4B#Du?3GTUkbuDBWl?Y3P)MFn#I~
zwG64QXd74|rt{=Zp(LI!N<nQ7njnAjeQR7vhN%e?vA6Hy&HY^A0`+zuzHh*MhZ~|c
z;We&U-jHnyQxK$L%Df2#?tug(MfmNms;-n9WT(CyE;j#Su(Kp75r6skMNh>~n)5@T
zmMQPksd_HS$MDews!f#`PbxrZR|CMnc_E-0)SB=3AuLAl5*TG!_0NTTTTBo?__kbZ
z(g0lb4DG#>ZO6}jq35ec{B>`A>SiSE9xCrbjma2tBaWYK+w=H<^mBT{@U29@#w+&U
zG+ylh7S<{LvJoOAWVz!fDCx9bed0sy5qR`aEQXt9>D5r#DK3uppodK6{^@!1F~&@@
z(6sBo?8ed(8kR{rBY-`Yf9@7lO1}38XQ^dOyi2kXqgaeeq(I%{K~`V3A;lBlV*P37
z`SpUde1A3)8VQ~&dz*on@F%$%$A=X+H`JBNF9e^1jq~1rv*x}+JVizt6_0wAB%aOh
zZ#hZ%zDS%PuiT8I5g~Z@N=km?IG?(%H%mMJCiDh>HSJZ*0N7&S7zLHzfopBQ<~{g9
z6{j99p;yVvV2na#zkt)j`G@a5a>$-}A%9zA_r@U?IEFo)skiN7-68=#ybidg6m}nE
zT-<|XzE!qdEtQ)ITdElk7?71XVyHB}j^&FsDad1#ue{gGl;&4MsN-Tkv<_W_(C66#
z9B^<F$CoGKyjEXY53G&Cn(b`usGA?|Q?_KRPdlSqrJ01oz?tav=H$_3o>IkQpbZfT
z0+P-iuba}I%@!mR4{=+|^ET&QOvcperk%b~FHfv&r+x4X{L_e-16zp!13~1>M5u(V
zhAS(pu>qB>Yb`I!D^o-|oSPwf(0D3d-31wlGl|oYLu%Ff=MKIaIrqT<1I6}9#i27~
zS01Vx@OkKFpO%Pg*gE&G;_5%27TpXskQfqzT)oa#iivSv?CDA1R$pE3FRVb;k-b}7
zw}p@ATLT9MMbh#xW-0;h0P^VzNQDRZJOKct6l!L1cS*jS=o$c1+C=Q}Q%PDoaMJ1^
zGQo@>7!Wc#qEyaFdYC-o<#Jpl{~cE{2e2OoDDFqiG#H1xwVwgsSA>Op3j_?BI<lti
z*R3&XT5sOfiRvUMc(8D<iGp=<I^&t{VQj0>k=$w8UwyF}!#5s9iD_OE`FZc_JH<&F
zx!cJn_oC_f8G570LsEYOE5rU)UZ5*#NI~S(y+~OmZ;^|K#hSfw1EwS5;cT92XG=VT
zQ~ELY_UoURyn8j4dHRDt{Il<X)emV|ZLR2X<P2$`3LTLopWb<kLmbqkfFF`8{o-qX
z``VzGk^IfuXYLCYse$jymY>LVss$n<&lyYNDFtx;IA%;OTr2{f;@`ggtfn+Ia%_JB
zqXCRUOezf+2*g0Hn>>u!7;ZY!)9!Iv4u1LWuvwa3*X@b?QO=SyxA&_RjyQz6En-YH
zInZco-g)oUP^Vf^m>gI3oY2o!cW$aaY8?`Xh%JYjc1n~M{b5cf@A4k>#k}ZnVkbRe
zmo0ay7vX8MpO7shos&;@zqt$@sA@W@ZW-^bakxwy#dff2)3OE*nzyU_LUjKkoA`-7
zR~1eTge~Xebd^<!Ad2dPR3>0t7JEqNj!+_+*6%I?^T*{DAXcXt{HBSw?3?3%0Z52e
z-~WY_`7$qW2F6n{mVMB~(IDsg><!bh|2L23#i(Rpd3EDjqx+~uK*A_LhiSlQ21^W&
z^o1u}Zws?D-{<D>W}dFfk??bDs+X(mL&Sj-=dAC`5l<Qhj()2&Tc2MWcC#N#;%{w_
z8;egvwV~O|1NnD6WlDYwZ-6cbQ*p$(vlzgw1Eo#JH}_)VYfHFWjp2LZeGu)&7b~a6
zed8&M?U<g2NS@X7QGbD38Fy94g@@fMEr``CE0$yW27}v9sd1Nql&Gxa=QofxT|Hgk
zdh&0YU+ChNtbL|DMsJ&4!235FQoPRd5?C0-gy6F`ghG`Ny|<1NHD+tL$Y6|UH{0Q)
zYoFX~#MuKLaP2{(pk(z+-Wr4b0EeCMb;KR0EdkuG#$m@X^N`R<cH2R^x}BMM$4M#h
zzV(<rci>xZ$j0SEKhxpwdBhvA6AF6=imh9qp`=&!`177T5cMZ_!6xKxEdS^BAbp(j
z$EG3Y@i5^+2<+&E@qBIYYm4FK-h=Qrp4{2FBfu=UJIBmN^x+OLpsA}@ad>@DOl{lZ
zMc$=;y>aGW4-~RSFhQdGUJ^Qo9Ay7l9y7bWN6-y97&Ev@&f6GxdvNlP(caD+@r-w8
zNvG#%#WEcXuOL$5p4Vul-ZhB}=AGCe!0Q_1RjY_;AtP%9wF9||C0$%?y7Nh$*-aj+
z^e(F^9dXo|Y@hazZ#PL-{V}gy7r)nWLGEw#JE`Q2?FR(O4kE82?|XhNm55;tcRVQW
zAa}E8@+R(N3ExoM*GeMz8(sF>hsyUu5mP9==bItRFg3IogwRoV=6x>)B5G{XWowB3
zapT>CTn%ldYqGnhyy9`&VKAD~+5_1>o}RZb-`Gx1SZ79OCRLqkvUWn$ZpGgyKhD)P
zfN>go`8cG+`1Ukjv5z5zJSCmzo4XY$fmr)%7bRT2*v8RuS?#jzt@1Clig-E^#zZT&
zP^>XaFkcKNotQAA;Z)9J`-PKbx8+3Y8$)xxlI>rZ;(zOD{O3qrBwxm34@MwyF$J&{
zn`#h`7wc<rw!!ypWqaI}1zV*%5boVHk{VTV5A1%xl(pM$SR2TL0L*IpP0A#ARA^!q
z%Ap#;z4V9u!qec~D}?#XL*y|t&;id=0Jw(%L{4lPoS>KSXbbWX*reUr{c)8V$6`RR
z9<V*-75oO4Vfs-kd1XZG!Cr|Rq1Y&Y`<a9m3i_`>V*j((VD`5f0NpzMEF2DN4yQ2O
zEU!N<@hsS$Sc2BCrbqs!;Q)jzvOB^J{ss^Xx^pLF4*aElP2=M~61~ize8uJc-GPKv
zf(|D0>9)0>e)jU^EqC)N#FEG{rDKHjfXW+3o<Dl9YK993V<UYL?HgL#01BXDg`Xb-
zce)qhbx8H3&h@~jei6ew%A5M;O8=_2|LHyVKi|%us}mq(ihTWa(Xs5yZjdM1`18dr
zsf@am^N+Snxd~y*$nL_r6&EqJ9D*~Y^BT-a%&Yd%c*3tcd^6Nx2}cjVh<$N5EOFh#
zBr9tW*C#-coB=Zu3ZG&76Z6DO4R9j38*qbF|0hmto?_SV_D;<-^1&XH6|a-#SoVQ>
z>tztrS?Vf3J2f9Z*L?u$*XYv_n(DT)#GDlpeEiM9FWk#w6VIX9?zwL0Z}qZ@&DvQD
zaC4a1;;t<oQS}`>Qau!*c;o2$TVCInsKhvI=6&O9uIL$hP`^UyQ)YJgtic+`B-mP-
z8eX`~ML@kyAk(j%MJ6C`lMgY+yiG$@+K#WqI6k%ywXy!pNei_cN1RIwb{_l=w-hd;
z=4?y8-l#sYbe?CQI5(9E>lZYG(Bt@%GizRu^oWis+TOoupuIm3AOg3$QCv;ULFYCl
ziUg_%Hk*6e0^VP(T!Ta-KNBxysbxV^>Yi$^YP$<RJ&g3}oF}-ODU1v#RAVXXyJ}n1
z)H5sXfy>auVgtKzj@RcMa$i0$cSKmsp~b`KyESQ#tr^1Pdh3EkctU$PQk+Z)j185N
zbNR9VvoiRX=HWk;lST4xJkNm<X1Ev<)LQKUa*d?kMsBGe^U^;8M;-MC0wfg9V^BSj
zhIa9G?Hj)lY3;{14s>`fJbEq{0yqz+L&WcTgu55lM7m}@=ZhX#3p8i9KF4+WkazCW
z8F3WE5ihk(d*S(;`Ds(j`pv*N{8y8pShqd$gL^W2*p_Ocqby&SM<Km_OyMgeUtr{w
zgOuZ9%2PMjb0;yQJEJ9zRmTB$A94>!7mTK>+pR#_T`(EKQKphi!phJ79|MSf)BG(d
zTQ`BFJw^Ed>PLP0xRmglCa*zKJT}lO=I5_`yIW9Ix!v;DAp57t?4v7lfhA$^%4qte
z3#7IKN%@O=-hUmMs(YTdxH9AkSXy!(&Pq|tNJcM&3VF4U3bBSobOJS=#y0(Nlm-r%
zSqCs7`vqc%^eD9&^auWG?~oPKIqAe{*b5CL;KclTU}tp~oPDUZA^O;~+Uv6Hf1m;C
z72GqNF1S}1Mptr+kN(B0o3V_I(VHesZwie+CzMR4$8Vz=;9TlGiS~v+<FZ<v|8#qv
z*U%tLF}h(AGvsHA-72SzQ!1>3Mcl-&jNVi?I_#!0CVC^zAyMQK52MVb#VqRGxRD47
zgS#Zi$|iZ`2wJO^isrs~t*Q=Q2Or!|hf&?&dP!AKBkW3Z>^tg#{Ux#8=SLSi*WcQy
z7ug25TQPN9B(C706RHSweXpZdDI9>%Jm*pHKFIxYV9czkGDBmadiTd7$8VZZ_ded0
z50fry`|>@=72G_u(P*QeI&#}-2b>Sef*L|!5i&INHLxi1SFdFk=lJQY&&6hAb+<U1
zZ8drs4(qPl+w7_UEMOV9o|IWTG#39HC_23R5{<!q9NQUj%mEsw3Yuq9OI4OFH6Ls~
zR1JRhdb`M#XbuBU?%ea||7^63042}?k^(<T@)CSyE~R=@a98g8?aQm)Z-(*|?$ls}
z+yA0WjjXH_z=OMQ{Kdb$J!IkqvdVHZao~B1tR=P-55!kL@lXrWd#-?~WnJERSd?(c
z>?V1mhCL={yS|O|9R_y~%f}mCVKkRhFaor(*N?FCz@fozs5Nq`9VgtTE>}It(DkIp
ze|RJ>L#g8SX0MPzDSQL`eI7L(ZxwsR>PP4!at~s=<N%ae8oY{P%WkPXg-rSt`gU6m
zreF6ZXRhe!m0T|s1-|9`cm-+D;{_5FJD-C`XoZmG&3Yhj{C7XYR<D!8iiukGIk3C4
z@~4DGduc77f3|%$J^LP$D`|<LA9f6&U-y&euS#*unph_w2JsY0{o(4+Q{xGFM)rE0
z*&RiNcQ}A7_d~>l8heOjAVWD~*a?j7at+p9Mgm)~Ldhd?#(=TA_3^pqGFj(pKQ+|-
zuPv|tP?gzjehOKgColW&lTlu!lOs-y0#szne8_%(ZiV;v<K2K&w97v7EeQd;dgDTV
zwj%#dzfpc5>s8fPEVstiW3Hy2lbvRnwl|*}FO2<lkM@D!a>9R#cK^6q|CURudueo~
zW=<OXTzfXMzR9c$95bgwZkZ@;YRh@z?dvV|y6lSjIkf6Ex$%2n^u7!i>pa+T*ZR8U
zXy`b1596|r+8{YhbGtY!L~*shiSnS&J7}&c6&}TJ%`|2Gb^98&N*8v)<h{uGICDt1
zt;|UAGS3p3#FJbG@a00u(8YDim)|rOyZ>->d4Lv(6foOISiIC6Mw>%<rqZZ?9LQf|
z<^-efJdi=WMm8dvpowFFxTlA+SN`|A{Lf9F852?b^oKs*&&BN|Xi=p8O~r(g{q~}r
zO%9c&^vS_f+}-l0pN3(+P4`zLQOI5tUCJDxVED<>)OPXNhUg25nHNG9y}8{5uGp;f
z9(3+doNKkv=m5xzO@QXp;kgUYe1vYq0+p@(;x<v$6LzOHfv)rn<zZX1w9piwG>WA=
ziY@&}O;kdl>lCRwlB=-&iEzM(3}Kecu`0DRHlb4O=5RXwQoG-ngQ$CSAcH_EgGq8Q
zSif+UID6B~*0cWOLnH7lY7W2E3aC$5#`t_=AXtCmMn=#<WKWlF9zChW?Mf!qJh4|d
zh^cjt+#3@9q+pcu!(CF_IKU1136Y*lLKuxYib<V4UV7*Z_=EkXIk&H#t{~TjLLdKZ
zbqz#hPXEH2X+;xP+V<#oge?GZ5<59E_f4P$hSYceR+cI+MUN-`SdU2v@(X7oG|>x%
zYjjaVJcFhJ<>+_iZ59<4@q(akQ*G>m-XOWzJg2Aee5kpWuye%)V+#L0{=DwE4I!My
zmyV!yFl^IGY;&$&g~FArg~|UY)M2>YA~$+FA&=(MFTSY9@w`HgI(-U{upudJuu!>X
zo4l?ch?lPyq}K5^5k=vH9*&JnUwtB5sR}|ufvkdxMSu070!V)qc0#|pB@?Qrir9AU
zx(sSuoPNb;dN&KhDN#qV_5{L_&6@A5e#Kx+6Mx7yX?fpC2b+sC>JqKSr#kozb>cmr
zpR=)iP91*Od+YM)YD3LKRD@@P<Fs1o^H~NGr%{%i7K@29q*xqSoom1ht^-NdhO*iT
z-Vb{z0$t6V?;bwk`4(WSY`1@Vnm4gxZ+XT~!RDZLosv1aaL~0MKtlmJ4E~Y%H)Z=-
z!i|Srs-BppVbmoxg%zQEOV{?PyW+{RV1B7xJT%ca1YN|eP~L`v?3xaJ1+M3A)7J(_
zCEw3K@J|$PJKi`eaj?mdX6%`>nZ!IYa54X!cap3Ullhy(N!Vj6N<Q8p>CiZBz}*9#
zKy<w_7Pvie_Rie3KM>wO0>IyghslBwARtYUmqUNkL?`eAoWiHQPY<WJNlxh+z=3q#
z4_E>MQsoX%f1GAEu(+Q3HAX#MG*LL~l;hdI&#V9O-M{CZUMNQ1D3)<~yIpoh4$qZ%
z%G@xcE;fZV|KmUY`O4@S{eV!}VHvqpT)R8D5NH2R`+5x@jlapm*}???q<}131gwDS
z8sN5&cDDe?EImNm?iV;A29ek<N50Ph&oU>cS1G{ZYn}?-FmH$tMYy2%TqN$Xm*3J%
zLsrSfhFW9RKUjrfUWYnr;#8qAFfE$pvGH{BvlFjHh0&oGy8_v-pJ4_3aK;SlE)8Av
z>^M2%`Q6STdcW=Ij#4L!r^=llhx2{l8@>*sfbOJ5LiEucd`oUVgd7$jx@%I?yKjeG
zQAncnvqA^I=kV13rBn=br@FcHNL*VQtSa1gGdELL%`RdbM=)cfJ%Ga<(ka14;=D%0
z6TkqL>8~5|S)>C84ltDl&T;<}-y>}hPXc#hqJ>M@UdLwN>1k1oZVja&db5khlWl+W
zC#huLD^K$A2)U1s-UMV5*{)WRN676~MSi<Ui?I<rO1EoHeu|t7)wd=JB+})4@0vih
zMtGuUcj1&<6b<D+dzQUvAGY37?rr|%QRh*f*{0~Nd`c3W4ww}u!<8lJu*lVHX0ztS
z0kd-N-ISyI1)G<TdjvoPud%uz^y9+2hwG}-;nCG^4=71U-zDl6*&F3ZGP|wtR}k^d
z#alj)@M~6Ggs4p%nDqj(8DIYq8P(5@ce6jG39+)+`2!Q{&EisC97=!ui&*G1v#>>G
zYYClbM>JJX6}X8Qd4hDy;iy=ve2;RqQf!s3=bO{1%ih|YSMfiKuL}Knn#6nH8{R{a
z2{~`kNjOaLNR9YR;kj+~NjqPhrQvFvTrtM%c-NNIFzeH)&pz>8G+TV&3j}?^&J3TH
zAax-p*1Pit$kd;QrG%d_Ui)*~-)80sP)iE>8}j7`ut!P>G=v=iuMwr&m|un{We;rq
zOuc%*M7N(fXDV3?>lY!6w>Pe#6N2l{QIe)2t56ePySq=>${-I>Q3{it!g=~jGix}1
z;k=L|H=rwh^qCDs7$R8v$~yRoSC{ABEFOzJ+$Bvz2|nbS+|R3v3y&R0kT+7Q1b~Ml
z&<o%<#Ewc;P)gM;&s#O1z*m81L!hQ{SQW7?c6VloC0)~V05~6cvTfX26tk#6Bz+~)
z^+M7iiBM}1<<ku*R?Agq&GSKpkJT=mC=?N?ziWG<T)J@J3o3jAj^=?spXPA<nf0f4
zT+n&vX*i!cUu5fRPw|u7-|1V-$7HpxT{G8-JuIPZn63wLX>Ua6w!dq+bu(HLos*jL
z5Fp%={Lir06-`{a`_uqmctM~BAYF;EEq8PIcMS{P{Pg09Wz6d+MGoo9V+I#BA8@Ov
z7T-Tjy_3)(R03Sw|68Cce&N|!d>vm4^vBPBiyX(&zwv74oRvc$03VHqh-4-Qd{wVf
zElF;p5ln)IW2htB1;}eh3Y01<iNOmFq^kMSt%#MC%C)bGU!{egE<43cdHsiq<KN54
z-+#xX{O=#kzWe^x+{3dM^DXFgp6TwJ1BW02$E9E$lT%&;&{S`9X5V<Lv=JKQy39wl
z_u1Y~XI1FF)JYNUOl<?%xv6UUgybBNb!L!~!cLxu9+1cetIpl=#2N|Qbl2CW#EGyD
z8JM+$7+sLo1>jI9HE#!$qrN1sIZy_Dfw7LjNqxiP;HFrTdB&;s@`od$yD0ESo8cYf
z{&(crugd68!}6o3mQX)J@O)pbp?AFS^{NrEdik4a9b7q!%3|*O!C#|Bb6$Sk8j{l&
zg25%h)r~MQ_XwYQkoP($mmG;XUn=UWp)w)#i}gqnzsa{>I<+!W?9Vm4VgCINNH??3
zZGB0!ukze(0(Ve~-yi8g@%)7>RLR41ulC2+>oUNEYC@&MvcJS|Rjpd-{n={=UyJpo
zI4RToNNg0LY;esgFFJ+@<MCRTHL6Amti#8l17#tdbLxpGzuokM-s1Zk8=IzejW4Yl
zm-|{z7m7ua-+FT2p04rW2ny%2R~p&(NoT;>jBWW594W#=wAt=azjgxE+`C&IHu)`_
zS!9j3Z!sUNVrzDCFsK;*dLnaY^>HDVK^YnmZ!Vn@TGNzl8DWf~j{@x5f$_D8DH>8+
z&dvefWk!Bgh88%}Qn4=2JRp_ElNMVMm8<JuI-&_r7W(;3`49gn5F>%2GN{k{;iEw@
zPWkJin*0r34bhC9*B)G=n}4G^AYnkd#Op33{1KX{nvX9P0XM=y=|M*w7#-hmoD1%f
z-a*M>vo*iVr@0OuS#xb8&$oB|b)3zhRt$!L5D~LW8$U~5mdGNQdu^#X8ed`k(o_rk
zU<qXKNG~3fhTidvRjg(a;Nt4An@k|yFKW&YmV<)<)s85ArC(ae#2Nuy*9`v?l})hQ
zc~8VCen)z-Z<|=VK9_UXYHQ>z`&{Tv*-9_vJzxTGY1tx$o>!ri<+_%Wuoi!XFoM}K
zNGJ*M6k8o3`omY*9T?J{P-qxtEz~;EiaB}cYtz@*ENNv|^_yn)M++ZiCH>UmiR{a?
ziu8)~!In>Z%dQ?3{^#`kzfSoJAMD9{3}-TR2H~F>NrUvMsHP6UrQ9E5>SpHaHiyQj
z*Vc$vC+3N}sDJ9T4^Z4r_NlHfqtNeorj&FJZ!j)@Bm<=aEe=dxTp2aa#wI3ddu-Hj
zr0lum_`Ey01A7%HUHN_bq3kmt+Tt1zuklT8^9@MjjMsA}<Q;Oo7csr1+R_Qs{`^Cv
zx4k0EvNrE^niGsuUYuMgfTdO{x=)EJTK88~?j4q;@E=ylp9jW-4;Vgs&kgOFF#B{#
z+scEO-FaggE;X7bJ~=L$u(IXos}Ka_aM?ZIw<QX}M?vrvaGgBzkCZb8dpf^E+}w9%
zU46^>x~TGCiokbNRI8^}N?&?R;>GE)KS^K^`nix6Y2d+e?+(afC}4I4AyO)M-lTji
zS(QI(?zOiTRhzCWkoVqwi!|R5@7!_A(ev#-Etb2lb(ti4>Ize1?<xSsPH9QQho46e
z1T9L1-qy_PDoPrZL`0yv^xk%*DT>X*YdpB&QbX@B`wF9$Nzo~ESYe#z+Qda)S+n{a
zxYy{=E+1r9tO(X<NhP^?ZGp<g5O%g!vS}(yh*XeGqe0t|4w^r4eSHkyc`a?bxodVz
zYWV$s$TAI1Z+0&s(=q}_o5H@loLRreJ8!Rl`b=(u@3#l~F*p3<2K5~$y_{2|v05I@
z^~IkPSvvRetTzaf1f(y9R2WIu=W=eNr=|E~yFD-SEz;8$nr=L;R+P-lz2}{YOQ`lO
z^-1z~snvn~86I{3F91lMaqMTsOX3{VktpFX$VW)nl$UbEqXXaHG<G4!CV+t^{z|&s
zg2OWG_VZ$6*I27C-m<rdU2EP2?k9vD_XoKnX;V_N8Pg^u<Q!&c90hWHPZ-dV_LoW!
zLi$-7gzDE!r#7N`F9hF+XjS?3KFbw{DygkpfP*i?zz+Rh8ZOoYsX<rK#`Vy*M3R{B
z{|`5*|LmIjf82y)BKqIWGUgNk8i2#9$w=lx)@D)vLr}0lRLKV~`n-Ms7;53O&Ctjo
zDSaUqMQI)MQGxN$hPWlkmE3f>u)H3W5wB}zz3kfx-tH?y>WTr_mmUe9r9;#lM)2vj
zx$l+Sb#X1b!+^#E0Cef8280TMCsG^4oo_WY9<pEk=tiRh0M~>XZuO*<Ue0AfxQzo+
z@LRXpi^Bb0R4CPqpt3r^V_P;f2rg_SqSHIEKR&RE?~CQUwm+mh&2w$&$JRDiwc%UZ
zGIfB0d{EQhGxuW{{d4#lV|9_k<qIX>b(Lw@J0I_J3g<2T6ls6tcBbLAlBExzKJD4w
ze!u4Yt`VRzNWjFm<>1z6uas_Yj6;>e$L0q{p3bpA_Q+8R`|Mc7L6<nH(jQXeZ(yhV
zh=}A--kU9MDaXv(<|mXMK3CDXfg0VRDTdzW^ZKIM!Z*mUZWSxVt7Ja2XTdJcywq~t
z7Z@fNkcBbp5$+MZ{l(?J(Wa?+y{0E;<4K2{=%Y`Pk<aW4e;MePzU5%p8+EvGKnz^M
z%SXj&Wp2&Dbo+2<vnoD-r9ob~dMyh(kT9J{D#7VQ2mU;x{+k9XD%du8bf~dKDG`F%
zXI=AIfO-=dOm)2p*@U*$Fpi1mjYv<6(Tc%sw2a%n&x<Y^hSR&d69N6?&#4#cLCC`f
z*h;!{(cVuz*#bx&uNbmR0|gT4nMg@*@-wf?lAkMd@6j)QaznHChCTgs4&|O&)t&_p
z9FRLMR9>k>H+3Gx{86D_DOm$l4l>W=_;8?P=Td|P9<OzyL9hC1WAe*)yJZT5pv0OA
zwRILeHN-b)%Jz}p3hW$3*kT9*oGYO!TIQF&di@TewO91t&UW{j_f#gH^P)t{SDM5b
zeGWj8g8(MCN-Aw#8_bvDq8fEMSS;$+INt+hWtv+&t&XCcp&8D-*>^7Zdv@)l=B(L;
z(VEm;r*V5?*lQZXL|MxkEckz37kc~XBx#&p9e(?5`+-=N_4)@EL!DATe0#X2KpYDW
z6w{Q8N#HfbQZllyaX~AuyCyMqoXpd0J%+3FmfPDz%&3JRD)&}dq~-?>u6%MZ!$p{C
zHQU6gjFlcpdgXnrn|+A9x?;BLPVq7zS>7Vn5<r7M@g@8gF`EHSrU<i*19cG(<lezq
zg~rSQm*Q|Q5W{Ef>gM5S6*5=xnVVVRakb9L2&T!7=)D1#&S(!mxOKG@{Ib02F9qz!
zL8L51R4!6x-Ed3WUdxE((mJ|Nn7c>#$E}KJu1lw92#ll!gw3x}@PpM|^PKH%(^yj;
z4PB4Pz%N(I(NHMVlrW-RHz>E1W4ty_j4+Lyj1IJ(VSY|%r^{!olau%&-pB6cY<!8H
z=WvH|W6lx}*C=?`k@jZaX_V5c@CxUhcpW=euy3$&Z&OAdWi@n|YV(pe<B~nC6(7Ck
zsQKhbyY(ikQmmZzWE7%$*<b0YSf^zN6V=Rm<q)=PgGoGoKMuLIdBiealm!3+iTAm8
zG9Q@oWmH_{JT9R;;8#Y=@PLfHL6(!;#Y+e#)lmrdK(;UKggDJSf3B?atjeD%`QN0T
z|HLJn?zz}r`$)j`uu?s-v(&IRnN~5rll^utlA*nz-1{Dc{@eTXpehg7(WQkA^2&P?
zqwWmLmzTve3NvT55_3D5ok8W`V9$^ct<XbIvLZ0>F=9(~36%hK_x(J9YOxp+C+VR{
z4{Ht=f71kZRrGO#hVN$#{BUh;$GVX$b-7;zKN#5G(SS&k59S;u;+|I~wZOl?AI`&n
z@Wne~HT}2bE4b5h_CnY>6ZvaMk2bQuGrxikT*V6$I^owS+Wjsv_V=_g$7~+)=IZw*
z7Nh;kr&m(u#>V`}Qt9avm4O*55Y~VJ;a1@S(PxKIf59>KS%207sG7#u3jZO1T>J}r
zFwy!{Yy8jp$LwE>$HA+AStmG+u@yIDb(RP?13n5)Ga*sHCx1S|pXtqNeL~NfZJVop
zpD8yBQvN~tddg3Km&#W9UAbgCwrS_O`t{=OQB9phIH1S9s}Eh4-9Q_g&20el29Wlz
zxo?~1R;$i`+MNk@5wSgsKSarU=NyTE&<o^wRPBJHK6E7rrSS6VMU3FRpr_h9JcodD
zBsuN~%wQ)`&|-ll1*W@exP*M35CMn4Whf<S-lf6E!_%y|4?McKki<job4M>ndQ4OT
z&qlWEe$vf7OW!eBMg+AO<@UM0J}K4E%qMQp2hzvj%X0^^=FQeCD~NdQC(Lrs*p0%n
zl}^}$o^6$NSw$WMl*%!&tFf<Mu9$`AXr?EGUoCwIXf@8g-n8GbiwI?zAx&T<d%R3_
zumkHxgfHPQC+zMn%ql5eSiB_I-??;>6qAOuvk!Qd#v2{TJhgq{dq^lQajAJ1{4&U8
z{w77?+M?<n#1-X$oUbo;J%6sKpso19Ne_B}3Q=xCN{}u!RVtP_D!zTRh&;XdiOdGZ
zK$3RIh07>+laVinyN<yAQhj)bCH*~)_q&5}*U%Dk7q5^yz1_x2&@-D0WYnm*iIRSE
zJ+h_Fzi_%%SiWs%$EX>mxpvx%?ckRak4D0PTxFbbPeOC!%o8phW5I9gOYs%BTga6Q
z@207j)5_wQjLJV)iq;>u1Y;q~fF~5DB}V)RW2|3$iN@?%g>rTDMRcvW1!Oe|rBGOf
zQ;Js@B4(sklEBZ?Tt1WQ9#e#~J%qdAy(Ske{apm7H<+^_!==e3Vb@dlqbulYt=RK>
z(S{LUvxUo`xdm;LXyfZk+?3VB=KJT3{G}}456=lW_`JRN;8MX=ZW>xe?o*<tA7%JA
zYCgJFA?h5zJ#yl0L(6f_tnr`CIPFtd_^DcJ>C;GooU5TjG-*%3lTEkjpIiH%NB{rG
zZ~j^Mx1OjrzLWh>F)tJ71~{DBtr&t|{~0h~xgxvCqu^9KVm-1{%A9}Z_?rCFs`$)F
z4{0xHtB4Y=8K)N_J&@*=<DG!4RX9IXv7uKeW|d{I^wu-Yb!twoQ!hoCNm1d1GJE5Q
zy{DT(rsXdl*(x#lWFw8Yq-_4aiO;<bu3~!LFtZwc%2=QMP>9xGysM`7x(3(mqgcrU
zN~!SGSN1nMVK<9BWl=IabNFHX+NLVc&vQQAOc5cm3G$(k)d_}>Pg0K`x%IPLw+&fW
zT`@~X476xhjoX9_B5Pxc4zDV7r`-Ei;d7dSQTCFGE3uD<Rq0~)0kwO)^W_JPMwg%8
z*FAZpL$|qsr2|YYJyoLw)R%!3{Ogmv{gS_829H!>{kh>rz-1YT14h8h5O~>*0bgF$
z0Ng^Z(OBYYQqPpOF;x{nmW^}QCe!Bd>V;#irjlsW{)M9bm5F^==02tSc+l&d6r6Ej
zK_~qT3x7lp?1QHtWMwsOCtw#7E_j=km}jn#FAcV4k&D!@m=&crN_+KAsJGI?Z5$H{
z2LBuwc92yIR2ZM@85cQK{mtR>MPbE)Tc_PFC4XK`-4N+yV`9Uqx?L{zYVAqy@+dhj
zmTBGupy<EeN@<IL`k&W-{o}<lS)DAofI)55#5G{g_!Jh%Ot^6APBZ*-%ly+g*kPIl
zg!)ZG=m(UA!YFXJiE0<rgj_r7RK+e%l5M2uyo?<`-wn^=b5*@;=gt*Vu+srQp+0&&
zwf{PL6_}B7L|*A6FK6VK<dWwnG`p%SZHEj?dAPiYO|B#6qnZ<o#c#GI+6|WHaex~&
zE?P8mm4I4RR#{QvsrF}|hYJpC`ZJMShI2}K+ciaD{fg88^?oeX!*@9jpO0ZwRz)95
zobWrx6HnJ>J~Z|JQT82BO{UBHSWy%a1q&^RAV?8Wiqr^57eYrsh>9phK#(FWL8K^1
zZ%PZ&dlN)zR6t5-8j5s*gir+%+6N)~f7#u;yZ7F`_jmv2_#KXfeC?fg=9!siW*%iR
zL7$+Src+cr#nU?NKxHjO^QuAN&PzDDfiu4S49yN@bD0AxM(r|jNV-)IF9*=x<5-9~
z3=ckig?WR1b7E0+n*I$R$I}%D;{~dmyo{5m4xCZOU>N+tUgR~;t{E7z)2y#O)#v&6
zZ3#Pig<`a|nrQq^>7y@%$`ZLLk2#l`en(%WFJ|?PWC`PYcG`ANV=Pw{&MZ{%-K9_E
zC|j-kB9T#Qo*x4St@a@{oqXJp{+p{#3b$W($mrCId3o`1*W5!%9?`tCib5{buMDCX
zn+aI>?cC!KqT}@8<sQC3yr}BoQswWLxkhEI%I(|Eo+buQyR~e9K%-4+UaRvrC-Wbx
zko$|pM&E63tMY+p1y~!V>uh@=ERM@Lw$kRLa_^Z$I_-<}chttoE!GqAZT?_>)6<GD
z7&V_snm5G5<f~|c*YaG?<}Y-XuNUh0t1ZwZE<pGh;fBSgKH><;AJD3{=(O#l2lZkp
zs+=+UhF}t^8+8rz;1W#ggguM|SOxIjMBzlv+NX;;w-ze-kXxsjy8S@~d7Rd?nG<sL
zuy4U;71Z-%D9`TB_qi<?`5~D?$!X^ysZkKbme<0r{6(Eb)c3`0juRm@(bBApO_-Lq
zXR8(#@3hRmNu$VD4+irFsUL}?x`}F2il0Hjd7ck-5$7N^L(0JdnIvobYi9#k^(}B*
zJZ}~0j4KzD7~PA-!kT_s&|87vSBJ0{J@Qjk%X6AD;2JRK-=Z1YTPN1N&b*TvH_tsj
zxxAw$9j)kl>ei;G5EIl4dK?-5peLeA6~z^A9XR}eb9#k-Y2#D*aw^ejixnt<_$efg
z5scpKiyvQDG0;3atHaCG$e9qZ!DB*mR;IbA<Q#>IREpk~xRL#{<M>#P<pUB_HNUhJ
z7WhNH9k^20Koys?z<d?)OS%HrM!(SVa+XvLyYmoc!MCimj=uUTxKR_DODcOV>3Qo=
zvWK2JgN}rQy!zucB5oejU2ngHJi%`s{^()&4WnD4ND!YC#*(g7^o5CHMeycTf`_-h
zWMrvbG&}g#wT?5wO}aGLPKS9IGu4Klt50oyZRo4ujrq3j%MMrr?+N+#@Hh{d+t?~$
zui_XvWp_@MAE>@<P6`}mHw8DznMNyT^lnR}^0X8X;F{+R$WBSFcAN&vwPiVrH9?5C
zJ#lcw4ysqH)@&S=^Mb`GAJt4D;?~&1X>9wFgeOI_<{LH2`U&mg<o(jEte$eFCN6cd
zc+?l=^OrMrW$g3fnW=L_>s&rlA~!}9U_<0*;Pq64*Yom-v5?5k%P1vvYNt&th4(nB
zhRMJ(h4zZHKR{==e&xi$k69`p3gZfn?|ymV;~flY3@j9f*IB2Y)8fxBFk(%@*%@xM
zUx2s4psre#gNJ>l7*_Ib`Ha(v7kOREnQD+czCS7yLW1rMbnoRd`lvhXPo{2Br*qI5
z2D3|H0ll?RVvrOKb=s*Vyb=m(y10$9TazrZUqM#k*pKM{ROLleRu~0NvjwLT8CYLP
zEsrh8C)#>#-W{}4U!#5oY3MN9<XPI~82p`1oJwiU$ZD3u{oHkS?>mFO>XqQG0aFk2
zeAchcm)L#fcFTUhHolhV*z*SKTFTaECVdQdt_fTqU}?b~v?r%Nmsvtr1~VC}tI2%?
zCvtl0^W`u8Be9EE(j<}+Id*&C4q6IAC?~e2U4c-(3iI0TI_7O0VL~#Ad($G@;jzi$
zOnj4~L*19=<5R84wBTvkgN#-sv;8%3QAbN|IZm2pY{tgHkE|VhWBTau^nW2G{s}8?
z6;KK&6xx#w1T}@)G=RM%?u6@JaR6P2I}5$S-(AR$@2Ax*x5zd{wK&Og?Y$oG?&7gC
z&cmK`{r92NB^t^Tifr6zp_xN=-+P^$B?#M&i0{#&WOPRe7iV?Z3Fef3+#;I9i=@Ph
zO*=`9&zdRJ?)9~#sDxV`s4vg{l&1C4^mD!R$=09hB{yekWu6Af$ihNDt&d?898@U5
zjobS2YLtl9#9K~<p6Oro>rdfRMt!l5IUeW@+=Ux10fNCZuC_kHmKE|0?fn7Jud_=F
z(jU3<{ni{?QbhSAZ^%_z+js)?k`=D<JX6LB<roV7@Chb&nHn*BhYdp|tXGMh*CaQG
zmF>jW#cRy3s?A_p#LCyZlqA_{a>)y*j>(C&_U;eA&^2FKJVJYdr3`~U(K7rA!SSp0
zGW*(iB5q#tWQ*s^iu)d|Lk#Z)Q<xG92ah53rdMko>3)jv=kdRUgf_vX%%&v%H?FTG
zb3SF7p+(uKn!^K=(6&R|<Ep1w`+)()fYwnRb`2h7uX@5N9ImbH5vrqKh-&p-u#;qB
z*v#5Zlx%?`4RDK6<~jv6hE?zgGlL@R0^VuesJQp3!6fTx@cBA8GVa+z!H&<uOu|Dm
z7gwI773CF=GvQFRQ=c2oDN9jF9#o<jH<(i0wKq1G?NXTPTM_KmslF0BhX{tvz(eDd
zWH==@K$m9MCF3Zb!p-@NvoJUUT2u@4Q3^mqooJ~2?7oB4fw~ccANbY2okWv~3QjEN
z)>4rFwH`n(m3{*bDLxJAP_Lg{LvyA7w@j}7oje3Z!bbF@GVKZIaqSdcMJ*~)UozV<
z`w~1!)bvHREDvXY@3G`l1mArN4w+NWDGzmX8vDO}#FUTHipDCp>-I1nm~;k@*A0#o
zp63*MU1&$Y5i&&Mr2Muw=Jm~vd?|*L!22Ny?BS;w*G~{jVHvBPRiM3$a4I}#RPu}e
zN-+ZJ1YKv&G@qte&abN=b-s1$SV{&LAtrtZTm!FA4_tefN~L}g(P{2amqT?~jX?%5
z{6bfUI<m3UpTotv!hjoxIx$dNn9kWEH_;Af&%18RqqiEOG7k~-sqJj0{(EM1758BS
ze%$0eWY;<WGN2)PW1J6K(gs0=JN;p+V(n4r>N6I-XYRx7<F^@>QXG@6rHVByCE8c$
zH(sGzU4{Fvq-fDxhA9SZTvmPDU?{B|n`DepkOn)VtX7JV{on)All`yg8?W!#8z=9<
zv0?M@Y?ksYlhgODt6AZbS(i{o6f+DZ6)fUMD)J4p!gyu6&D6Sjaldj)LdUVD=Ox^-
zF+9>dCuvUxXfChd=SkZSSxd5AEiPefwI$yl#Jn4LD?j6$mMVP-0d<4b){#TExPOy6
zxk3xX3tg{G6v<`XDaHhepAJ_C$WM9+9GZMWG|_htm~cHZBEdSyhdU%9VsIXby48a?
zYXmR`VErfOa_^ZAy{;J|HKWDV9)um)*e|s$N}LKiFeR|7L@D6NV=!OsOWM;H9&AUi
zfv^b%Cd3cwORKYHg;A-X-wcZXpw=jlE)y41dfI;StdW4dMa}94Sk|}|P;c7|v<wej
z8$5xJrKBaxpdS9fa0#6K;wv<T3~asndtcc$N@D5e>U^3Vy00GjZg{0w{Pe4AW^{K4
zS^>WZS+(LFs)QKT(M@jWcE1Sr0VSgAdS6m2?Pi>`Yq*FaBRoEPZDWHf2JT57kh3vq
z5besrx6obUcE;C+5)Ze7Q#)vLAS7o+Fw`AENHY{LQ*17n>2)?Vd`%3WKq6v(7Rw1u
zUP*#OTT=17P8;VS<$QB~269#3+YfSe0_#1COUMj*1|L-=423e@{>={uc}{2AIWiaC
zGTE_`SzJP7fYWo8Kv%(QAB6OvPt%L=)|FYa?pSJL5rUWPgxy7!_yOVE+x$iQs_5?&
zsaU_|d6s{jC-fZm_TwK9ehVu7&Pcca(2RTqbk8c-cCryfWrO0d+;F7O3v99J!Q_aq
zSV3i$RAcgR+kWeD&2n3X<HJdA^j=Qyn902NMQQ{1OCH+%5E}aY!#Lz?9{V%P260x1
zDeXie13bN=T#Hk(r)*n$CJWKrT?9`;r*1k#9J=kgDF49(QKj&PL+FHqlKRy9USXXv
zxSYdNrKqnJE&{GeSMi0+>-(7o7Z??i9iA%3sC}~<lNan{^D|UD^Ieoq(h^sNdj$Sm
z@>)iy&D1S`#P@jb8U9E|Ukd5HH)Qo#$q7?iy*AY2KD?cnXy~3T8R7vYZX2R9!ir>D
z&{4Fm6nKziBBN7PS#Ggp#p#SXM_%RTfrZk=O35!@bv!%|d!DHk%j1n1dOh@Qw5ntt
zt|M8oNJV$0pq>ul8=ehitkJIV`d>3k<MtOa8~FHq^70qgH%eF7KM32Ush!bo;J&Ej
z?NGY3dC#TG2OoYTgt;WN0o^$JsqGbF&zht*>b`D2R&63^(7<SU&g&OC#8g<36!z;6
zbe6)aLmqR@X7g2c9<$_T^SqxLEAsQSQ8A<T>(;z3x*n_m-S{{T?)zNU$01XG(3riz
z@z65&V)WUZV>kI+Xt2s7PC4IAD<U3RJK6G%kJX9soEoce<Tn0botq3*DxVVA*|(%Z
zIM`Vm-_rgetE6%KEmh3Ki9AegxoI>`dM`Ms;tmbedvneQ;dQp?u~3ix>mhv2z{geS
zsVlqhwV{h++^!e0G1JbKIa3d*RQ0!10=Zm(Bcbhm;ETPrbEjAHvd|L|t!|RaF*nvl
z2Vl?__JLmDePAyX^9tWY8Q>lA&7-mkg&d{QvcIk_e#<E~HqU5Vx^?0op^X2+y)v#7
z)1_XflE}dcKI7m$9PX=oJ8gea0wHRjm>R>CcW*<A;l8Q(5!0tH^%Z&ONOuaaJ!{gt
ze!E=cz<Th`VH4_<1q-^pK4v2O7rJZ-%aI5wP&jd0_48bpE_@A8(Et|XFqXu@doWcc
zRmQKN#kiLS3l6h!RG-Hp8Xs}-X0*L3Q@Z^bct^=R;CP$||51>x!TSqcwZjd!9BQ5W
z)apiw)y3$jAZ7wUyrjc$68qqr;Alr(sRc%J{qsd$Nzq;o133+wdjys@W3e;pa1uv8
z)20mBKMwJ2VAb(LEp4k_a=5Btb6A0{0S0}BLoJ79yW37nv1Ivbo9nUW2=0Ui&g0OZ
zQ-&?+-T<_G?IAb@Pty#XFAjT3SQynXxNeQgZ@Fy=3@z_>L3f=4I7nJm02?p)(9Uqo
zj(+{AM~(chkq#@NGXV-&3p|Hg7My4@yR)&jB#WnsuJ52O6qOuODWOhcsZ&Gb9O8qh
z72o_f5sNNE<!nw9+V5xIOV*t`dzv~WMd09LKpA@a*2_FTVZN2Zo=U};pxG9yv`dGU
z1ALH_a4_9nH-w+a9~Yrbz>5&JC1`F6@cvr8%8A33IRrEzEGO55?9}E`@p87`;#l)c
z-8F|>5sp~2#Y*J_!z?5XDW6rq5KUsH2#CR+)n%zHFU9c}+rdHL22Nn&U~##hZ-6rK
ze02p}aoD{>o6s7w37~q(gKr-hAipDjI&hLa)jm`ENZk8e&v6-*?_w~Gl`jJUf&lcq
zqgHXkMSUvZi};5>PVcP!po17(!Dm9~_F8HKp_{g!ypcN%&X&F?h`8j&j~|~LCpCZz
zn^5-<Ziq*;dC@VbFwDL$Ff&d$&nXS7+XRYADVL0hp-UqNg`EC)%X|}Dhu?1>;o?MC
z$srTuMNcDGFG6@$gU`P6(T{_5)%|aU)~leUsCVK`hg>WhjLDxJQ*VFkS(&O#mcO>V
zZ^3m6D7na2Ej(YWLN`%;u05{TIt^6HG^==w$N0wb`&cX&_LNkGU4Fywcfj!LY5<3U
z);pCffl}220xANhKfTyOd7d!P#NE9gRA9Xq!_2lBv_Suusl$X_?U3QA^(kkkGvYae
zdcDjO6T2&Fp{H;Gegrh&OdM!z@c~M=PCgLcy#!u~Z1r#nlBt#mp2B`)&#IsAFLWJK
z_Mh1V&*<igv#>$~?3Tx~*OwKR_CK;i@c5-{ZMuPP2}q{g`GwB$^XU4%$(K4~?61J<
z3AIVQx>L{7wo%f&{~?-l_lpS#!nnZg#1T&ewUm7A`(;%Q-3B#WAHW|Y;KYZ-Krnxc
zT1BpJcUs0}3|<>A{vzlE?nC_&m=E_09j|Dt8k`7=W#J#ZJk$S}dA0cjrUjfdQi?jc
zL7k#tC8_yemGzTUfB4LBSlNGuMQ(ZY)&&BS`Rw88gh>k_E%Ly0xw-9n<hy{7F2?&x
zcR38<`;Lo6DK9UsxLt{fXvJnmMY@=O-0fO{{i9BV3U(bPJxgvJ(&jtudtQG}!HR=3
zqx+Uit2hA_0jbgS;6e-Vsi=qLQB^-rHe3%Hx_|A&f}RdwoD|8jX3vM<3qtTl*Rr4I
zJDVMOW6F5Oi9)}2ui{kiWCiE%%+t{_gIXAcKS{2Luqa>YBnic6k-x+ThuX0fjYvKw
zXFUym6M4c%=EvYoOFk#?JWqD@z!T3kf!(pFd`Sr~ed9y{d+c_DdcVS`=iQYPPix0W
zX`V5-277#ZAGM^!mS*+s!H@{zW_8HV(Xc&f@u%F14v7~thD4q$#v%{{fye&T#B`am
zd`(G_1dEp!CyN!ohe1UvPu%zaQGa4|<B$=q>Xe=#`%fP+BRQi@5N?Ds*)ow3@x3KK
z2ip35gj)A%)6#A+^g1li<KvZMRCS#CVNjDhc#p}CsBbSZM7<U4A<vYzXDq_@keBIn
z?;m+2$&`8d%Kt)>wLFuH5<=ZgM0ewYznJW_&(sT`XOk;da6I2U@oQQ_`Gg@J&KFVE
zrEbnD^j6l6)qmW$id6ONIBRxQk?dsRvAkv*nH<)%xn$$rW!e3&tdH^Yf{^9lr`vAL
z;tRS<sX~h1m&c7pTrM@My9?5}3*_9ZSTIfr!Izo23;n*h;8%0W28w;xiVi5VAL=*I
zxukwDy^?Fx*^I&MS`j^EY8r||lLYEIWeVu9iKiV+UKXjAx8%r!>e#AvoX$_NY1$i~
zD>=Ns^-KY^N&jf)O$Gf)Fd67}1L%g0fNQ<($q^cD{Qa-^49N%d87EQZ8M0?xV&7w?
zzNwOKZu2*i2ma;lc{KdN6a))25z+v{dC67a=!hT-ZZYvd=XEM5^wX@(HKTS{kS^Zx
zf`=6^C#a9IX(an7O4FTsW#6V4mW@ftAy3g<01<b9qO98M1EqNeYn1nPxc@>o8M<>}
zdO-EtBUWj#Dvb`k;~tKOsG0XX@;;Un?`|0jNUvgw1(xJhZdWHD%7^FnMtSRQ?R9gM
zbzKu$3J!E2^C$Yefk;4>VNgW+e2ryAm6>Y(M3IF3d4X?hFVdXGOp)dihaMN{=eQBr
zq;m7W%!-bn+c6y}OrTt58wY!hLNan;rezVP3xso-??0&86g!NBOW0%?oB2uW*B@&0
zZ=L}JiT_%4@~ikByN*p!FuRKgZHvF1PX~&XgVOeF-=O9L@wFm+O-Nd^qCK9&tct*5
zT?N%<UMh66q3gjO<Wun)@EXXafAq{Tf*%hy{r_<-a3@AN*{pL^BkGq2NC>*a9YvdV
z<rWYcz{Nl3KNYnzwPqmX_%G||prL=p_wC4JF`Rjv)&6%*W}R=%WJwrW9!`=3QCy%J
z*9NKS>l<TFC=QXxZ(f!$vxkHSpYg~h<=ql&Q&QM(BB;=J`9vb>o+7lX55e+Cqo)@i
zYLK&Qb0xBBc3em}Hl4H@g}A#m_xFkktlhgx*F<-_?c9zopKv@0v_qvm@g@(!@TunY
z{ru6x8}Inz>%Me8-s_`UdN|$FV=lMI@<(`<<qlX&kouOcola5i>_^7JQz-{~or=+_
zHYmqxKeN$h6gyr^M3ax9E`@dg#qeo{m)KfUrJgf?dU-zPzm}nn_3;-eq;7(xq;!(L
z0ls~593|A~B5YbGP4^iL7JSRgNoOxs@agk}V>)7JoqYl>=AVC4;{)5!uUeMsxVxo9
zsSDUxQN@Ng1p@NxiQh39jl$1$)MgT**%PAc(taEurq2=tMs$Z&ZI>cNIxv47XIs>R
zk7Hu{RuA%azpHJqo`w+}Lu;70x~gf|)w%s5!3nOz^~PH{FIFE-cw(O5CoDe{tN`I@
zY2AQPB0;ad1}EwSg({Rk<av((`L7S@bzOAxhLXQGDZ)lS@_6W(G3iKbOYf=W{|TGW
z!{P_{ZdwEg{QwD_&8nH_;O)-BXPHl0MqIJAQWVuuntS(zIlS_+*Ql&X<9Y7LoL}e^
zrb4y=j(lK`HR!=~%4FE4^{4u2x!p-xy&^O)*1-Ddxb8Oo!tR^-8#dbaDeO7qQKQ0N
z#dyktO4Ybdog~NLpAd%cBDbF+9Z{SOZsTi%5izQkPQ6&D@m>ziIe{FRcOlXGBX8nQ
zQO7;wAsd_*Hwa9U-+#gocm4-%*Y7(*pW5aKr;sb<LIA)nqVwg)_1{4|>WG}*ZkcN^
z9{JBZs}2DM&QkQy7tmmiDyg+S#rSitxu?qoj=oCv_gnROLOlWQ(;%Ew6oS2iCLIJA
zTs)$4yIUOPigK_8N~}o4?QoH+gOpxjnVn2*Z2Z<bL5wT?%YBBo`Gv%nV{(NT#!I-2
z$x_jEVGi;M(bTu;km|SDsGmiv_D8%~;xhINsf&D5xN(ptyB-mKi%wZ^;efk*4cG{S
zFH9x?)rp$aR>L2UmISP+#bd1aHN>^qD~O^O^x2kkpLJilHruY0Un%llrZ0vLA4Gib
z#yMDScYxH8(m>_;ZvB30ZPpyyb2gKK>WXk%FGJt#^B0;E{}Tsj^nj2BRm}L;dNO1;
zVj7tTqY|o88DtNmiT9DOiG|65ZfZhJE2K)vG=-*(4=&CTQmaE(68L^gJO9Duras=?
zDNfVyww*w<nmzjlZEJXW8OM!}+B!)%$Vh<mmhKHpo6X$QW8AOsX732DROr`h{w7nS
z+Shtlik_}FoBc(|n$RRZVK;3pGCd`zTV0uNVa%xam9xlU*IQ?^jbIgK5_jmmR-2Lg
z(A}kVc%r>8oFddl9{*%Ny`!{+*Q+Xx>a(tW7exPROH*BBrrPnk<G$y3Zpr(|!e8hL
ztzX$iJBdM|O5~s@?-D4(q=HNf%~7>(=v^Y-Iu~YZG1$r~{@qQ!^a3UjPKiOLdX0l5
z=X7u!`Vv-Xbv|iaXm+FMAyJlJRbx$P_}Lfx*`APQw)E6<&H9(SdI{~7tp)25WDoLK
z3ps*}Yr`hEpU7&5>=Cz|MD?zTG>-(}+^$)sX^4k^WJ_t*_P`xq?f5_Jz$OTo!ddj;
zl5(#{w3%YlIcS0oXb(I}V!V{TDJAcLg7#TYECNe93ItTC1-kik8KmeyN6E{ef%$gS
zwo1g5^7lROl?xmd5V_0$3u?;8;~Caa7f?15a1!y5-A7akd1ljgT(P{ZIft6D=J78^
zr}zP}W#UMaf#YWW$e)jbm4uT>Y$=OaA}p#R*E1_VW4baPYJ6li);{%36-p3>_pJ}{
zom)jxCmK?6X0a3yWQtv$C98=W%tnuP3+_>t?;N4r%<*k+UBHOFGFl};_zOzMWm5C9
zXKLJjmJ}j~XT2;_j*KAZr1XU^H?rI-Cd)>$2+V1GOhnP6oS*`Ip!U1Kf%)nx%G>;e
zKY`0eoJpj^up}pISd(mN=W_9_?x)P8NsbSXjW=@-xLmASN=><In`OJsX7P%LT|{z7
z$Xq~mf+ujVYJJUtvsNq*{(wk-k=4J*GR+Gs#cDuv(dzyY4T64~^@b*sy|-eNChNUR
zOCSkcF#j0}TKoCMIYQ9NZnXpQ52h*=q*8VPoF1fF7ff}jL_WuEtZx$|ZCiKfsa1~X
zgj6M$c2DSu=DCFXV_h=(_2mbu6OYrgu`Ob|_x{Dc{8>Y>VB}J!YHViYow8yi&CGi&
zJY;6-)eFPpMu7~a5-hTlB_vsz%X~XF9vO#DIXOEXZE5`>b@S$cOmXmCy<@>X3x_Hy
zY6GFG`;eo7h29tMx!*cD61mnXvrR)urOm!~cQ2#e88IDEX6Yy6_M2s<OCK;4r>Hse
zB)T2_7{2;Rg>M>`42y?R61KWyB#<5BUFJ?=NYIvQFFzVzHGlOwf83oyGcV1~<N6=p
zdD&g8zNRj?Jx}wkB$l*qV{x3y-E0>^)TVFB1bzvd9yME6lq*XQNM(7qY4SBlee^J$
zQHpsC*AXST9%R-V-ajz=pO3%f^QR=%vZ55w-Ob-HiCk)t`Afvdbq#EZmLrL<p|s+@
z;l>8jUkwx<34NYILSIDN?LYz{-1kSibM{amke>qw+$Dx8=j&bQlfVwjEB)Vh(0P<S
za6H<q!~p=2Wr|lF+v4-vu5)p=#g4&E>3DnGq|Kka;Ewcq^}7xIS4~|I%)q6o#Z+pK
zXMO5KC8!aKQ=m2IZUJ;`ZoxJ&qTtk9V*RZW-pXEw#usKPb9!-OQu|QC%_zY;=NvZU
z2qjRfQ#TT7LR^_2kL$6Mc~D@Tj+FDl#4cI5X-f(PNkk4K90WBE-|MqBrEfw%O`c0H
zHC2cKQH^xylS7Xhq>*vtqk=S{*O6`S_{xhLjPlh3<NP)`t*{i({t}jqPWjx=Bxk?x
z2HAI~MM(6LZKQ@nW_)1qMXn$X$D=p$HV4~jt@Jz&qJyGP(>SQ0y?|2lv}6(+vNNVR
zQ!q(|cT+dI9_O8!?y@$`c#dGK`P^qLtag#{2;JWNc7;bs<o{KI{k;GJlaLN!DAAT^
zaXEO4)J?@nAzGqo?$hJ&AKLO8MU649Jh9o&V%J=hpYFo?KgZMm>M^AQ*T?`;8=y&>
z<v3umRZH=TIp<gRk<024I8j{A{!+Bi?9sD<hl^tQa~{2PIJ(4>@UKhs8#MBGFG!68
zng(Qrl4m|t)z(olRDZ1fsGX+{W*R2<-Pl-zW9vb;#zkCmR>R3FVKr(d8HF0!SGu7_
zC+M^2@{M>{5;D2p)|-^qS_gO+amBV*W*@EHb@ng|s+It$lu?gO8cuUZ0p>9}p0{Jl
zD+ajRo)0xBIq`Czh@9>tw`Urx@jqQVbx!QLz@9tAe?F4?@=<jK@#UtUB~46FQ@4aY
zj1r2b#BtrDCQ>Q~dRHT^j-!LzG+r<JjR_@uT^g9A6P~<YVEIy#)}yt7F1eZbk6;5p
zt^e3okLb{CX9{lp`3sa1NU3}Qpcc-pvBHJ2j5BolQsBX_oretdonMdz$WO=8=^GaM
zjMW9P#>+H=H;4J>Od2PNW{jFMqQh^~I3=@W93q7$+SU{fI{v*<{U<DE=5^N+JW%Hp
z0)kk0^|6ykLF4Qs&ht9-YlO)jbRDW9f-815uBx^X`|>}XZhUdFq}>Su%nYb2Dnl!m
zrbkm5OVR3}T)pM_yxUl<S4-pevbTkJj;OvDRfK0DU<C{#<IvE)fTRSWDFKT_{&&<d
z>P)E=%Dtv&Ac0!oC6D;pDZo22cCbV?cz<M(C2Jm7t<UdwnBegs7ety5CU4+W$yp7R
zTNk=}iPVuD!GUo`o^dvGcO(2lI%R<1M{#_alQTQs{?gnaj5|zOGKweP?$BG+_K*|z
zyblfUIcyBf!&8(?$uvKq-4kX|Z7PR@j8|qKW%`k4uN1H!zP7R2XLc-w*}nE3OT$jv
zxxXyh@BX3jj1A)Mz#ksr?q(njQ-*t=(_Bot7iXiVy7XmonXpSeMFPqjL%~GtyvKy8
zRHs=#Yx&!LzbAz7|L~3M!0n`$f>xC%gG*~{s@bYjb<6Jax62u&VLminIK17dokY~7
z>3?O9Q=GTjGbh;^-?OTD(rmAdAj<U5nLq!KD|f*q%Jv5BOg`H>xm){PO|KjK2iF~i
zFZ`+NThl5bXYRc+8q?qiG}5c)?O|LonWCo>PXp@48?<C)0u`helikDDNgDn9G8Vtk
zy{_0CUk$1j&UyL1Ol8lM->T^KZ%l-Uglo=bNPQ6VMt8ByfRdI|>k7WqPyWNVsrXa{
z_a3g3W;1u28HQ8(NRu|?u%Nl1IN|H&D1RTS{nFCJCLwZH3dw3Tlm!G6em`^?L?Pne
z+LXAW3ub8UHg+6Jw`mdegkxW%4+kcdG;_*uygbZQ0Vgp7&PzIVgPPK_wmlpOSQ|c!
zC%bw~rnVMqMA<`5AlP5Dx9MNRMbo;DD=N<}#0mWqH2x>a-(5zC697SWP0uOvPfMku
zw2_Mz1uE6z#cMxpE9JZG#mKg}&MkT1^=Y-x0=>x@FOQ}V=;d*E(PC?JH%)_D94lAo
z7Pw6tW9I6Pj{coP_b(T$Sp8g&3>r_ld6I^bc0?z2rs}ZDhOLeYb7AC?&6oz92IPwB
z$3}mJGXLfv=G{gd$UHeRdNaO%{cA<l)%H&(uJyP)bho3U8;R+03c<2tNgxtIl9F)h
zkcB{S1Ww{K`?)o4{6WUDh{PyyW^^uE*302x_I{3ln=PT52ksZ0i0ZAo^lfV&?eRA4
zai}IWJ-m@}nsRA~@gYS<#k8X6+Dal``55C--^}WjnDm8{wJ};wU+-4Jk?6juXyr1a
zBemxC^X5rHttaNXe)9Xzjp?=VhN}p)w!6PI(7YoEd*&rPltBGaMV&s{?=kI0ZRq8{
ztbMIOq&wbCLt0rvXhl9FkZ6HxYRtH=(}8K|K^*8kK5Bk5;nV<g;rk8d%dSypj7&}K
z4srJ~4_s(A`S*I*QTOvL#e)5RqDW*nU{A6MBPr3C*WMs))CJJu?8@lZhV$zl#cQAy
z`S>M{<R_gwqDONIBH4dcXy|`U%j%=Qz+-8!w`(Ug(YPiHG6*yK&O^c@AiV&;m>NqW
zbRKwdKFmJn(=d;@GTtbpKOkhGcPUEiFKYZZ6@l&gP%u5-6#=y`wT-vdey?znnm=tq
zyB{x(p-N<2ukwg$BIr#YU1?@j%r9s?6ZY}^9^t&r-SN*LIVNpC9RanLhz&!s?Hg5=
zH>nw>BF*npP$~tZn(e7YUHJ}U*7w8OCfMEy=oU36FYYzQWW#p#X*ebp7O!CPylYIK
za_J3}GQDFdS}=$5E_Y2F`yN@umlDnJ`c&qV>HQH^-03gM_Z-;Z4^#0usB!Gqw_%m)
zL@o{`VT3%Nw>4N*o~}9lrUF`B)E`+ByM0bo0Bzl@EX3I7cNgTa1F@8dF{c3_a*S}&
zMK>%CE{ot*Fz7GAU#GBioV{a{h4Qj2PJ6Z-__%33jPNt<{=qiUaU`Xro8RVl9r~xf
z`pZsvugK0}1YHC>lZ!!a6ncQRUj?~05bhHZTOE2n?zMev-HL!uNLoeE9>3TFc4sYQ
zP|ZKL72gM6bE{i1Tv^U}cK*rUE)I;zj|YD_@81Mme*N^<M5hRq;s~RxgkI4WBEfj^
zUdHcbbOEw#tvEeDW;|A#(D=naj)=qJSk3=!pO2S*Pc{mGGAKgirM63Do-N%dB)PCF
zNc~6Onvl8lSw*@yjZ9UZOva$SMw<oD6j)n%2;@Sgy-E8((v2@2IS8HCjchy>VRzJ{
zrcm!V*StY2*X7~j4&79t?MI#0%dXttISQ0AF!{-{<ZkNJ`Wx75x1|El1d4&)iz1++
zuem(e30t?<hQHp=U?`V)5QSk#l@?<;J(N0HC)2x)d8GLp_@GjOoe89=!aBO!ttmf)
zA3UHuBtDMce9`l6WQOeI%hafU)9_>-zqJYMy~~xOMWW!(Jy1S5)1t&EYT1BeBUDTN
zeC9{lv6kMNp0>kwKe*Nxx1Vc%z45T%9s?{Lr7-FOV)g&+oulZ`T^hV)yM!^+T`vdj
z7^(`p>inF`{z6`Z5c2Z&c_IiPN>9_`f(-gv87Ftq;9oL9AjO4wTkk`G%;L6XSSilA
zLsf!8I`uWXe%&^StRD(VK$^_Y1;`Klq=Q(1)8We5ta{^paL)aIZ%Z}-DAbswWt2Kf
z-xJeq7~)_l(BFtVrH={n)tSqqySuH$c{IGf?+gPQ$Egxr3Dg8!84Wmzr_upU$)OZ`
z*L&kkq$q`_zIE~%%zHiK%Skl7XYCdwxRUuuTI%y5L++*v<C>n`G~YbPq6B*Dh8BX}
z8Isi!vQ0tLCLFU;6{-Iok+G<kd@w{J_W<YpTz2N$;-|)8C?gA~c2^_2^fTe?>+gUj
zbjE#!uG(&W48!BLTRBX5V`r+lL{AqMqIitMvB!(9^J#5FTnPRZNN0KVS7v!WQR|b~
zaiMXFs(y8_uJ3a@JN!!5{9_g&D#G7SN08=%CS8UrxT2v}IDFVML6MvZkPdO)Q@mc*
zFdB>OeY9i1t8ejang7&7fdVu7jH_I6(QS*!SS)1)0|q460P$W*^Z^a)m(+TSCd$m)
zZuTb@#xF-`D~}XtoW#;8TnLC(xm7lPND)<vQbu>F(*TU<QnbNaLOOHWa3tPJZGf7A
zGIDY_!giKL#MmbEQTe$X%6|AUb#~>MqyI^MpnJt7K1Pr%Pz>BgT=%I(zWG}ZGE+gd
zX-}lWfZb~Lcz%cX!Q_$gw@6CBIW_9!I1#~xG3k>JL~B`^IBJiN&mhaW-5(x96kfji
z-=*}oPc6?BEF&l$x;rA^k_`S+y~cq0a+z9Si@bT`a5<ZA6_-Lr?{iim+~gdq{YTSN
z&pWq;08;*UGX<FgVj0ba6;6VIBE<yVZ~g2Ma!?kbl<by_Yh(U=FqNz#p8v5J%d~iv
zdq!h#AC$DqG`e;d0=}d4`80cY63T;8L9>YI=$7aTM(3H!uT2+8PR(D5kH5-spyl{*
z{Jsgxa~gpxWwn@H9z(k*?xoMyY2>9rzH(2kxX$>>w|29PV;TF;C3jkL9DCPi<mnux
z7jeT__H;n@_)~P(VRV;{{dm$AsuJ=g&ExYReEa(-AZ-h&i8yq2f$-6XQ%c{i|MaU@
z;Qm-ftd70!zr*x9C}!oR7=zCLLXd~)0Chaq%ob&a7qN73T;GmJi#)C@RIm>h_cV|$
zp8v)E#Ct~65y*q`<T@3^rjlc7sIAmgt=c8-Av-)LT(u6F-{zJ+=HPt)BSnDas_>(}
z^C4IF+GVHN#;hxoH)v0mXwFOB9`T88(`9Iaw$jpz0MF?C{@-g$b+P9D8WW23p6aa?
zOYzS84HnO2hdfPBJ*;o@P?7iQ`GY2^tVataxx=RzSjGO<=+v@4Iw5nf=w8W3QK;<$
zNE-5?FXMmcZY|atZn<twJS))u<h^lsNqhD;5U*>^2|)a>EB$BAP#b8c)DaizS88o#
zaSvol6f!7{UUw^!*7XgqQ}NLj5Pp7hJOdW{ESQKOhH1HQ8GJ=u5H`0z<Q?5o<$`)x
z3^dhSH(K?-<9U=Cy1R$k=M2*D8Eu!_zVu-=?7adkQg5s-7KQm3p8W(PGBHl@2G0x-
zOkx(P&w*KSAPSskroANZL^kO4jE<=C*E(QRJvkeaUmx<SPMbsBiY)o;)McNGl|Yl=
zuA@RXxGGLrI+AH2_%HjSwnXP9q1Ga}Ynwoh|0dxCvQ}EG{C5)q_^_Br&wdgP8#Uw<
z|LCDj7G(_UWQ$@Ap_IQ<tBo{d+L%+(8!;)qkqM^8hG8fn;|VB``$^U=@2MkZm5<XN
zrS-2lcy;3=^q%dX03^i%omp<(s2i^g^Yl&UvU9jt8s3tT)G2-<eGFX40V|M%I}Vk!
zm&s8^-(xvUJWNiTsNAf&V5GhyEs&r8RgjgT;w@|AO=KjOOV1@Z=@<YcmsVBC;Tey|
zkW~$(y~6q?h0!yKNnR$BPYfd`uE$?)K?m}R+v%U<+ur$aSubkl?xP0oNI^PE)CY~m
zN5?*EnW4Jpt;n#-YZcSeJAgr)d@g5)fkf1ngqift1JllF-c2@H^A+j+@(B3gsQ<|a
z-z5b4aXqd}Fa+20(~$3M9H~IQ8S*V}6N*3g=;z%aar)kEfil5-@(kTn6-T*<JhBo-
zx>;2H?@p=71c^$lZzhqPsME*<wBWgvU+7eAP0Xa?-cEkZL|clDB5%{}d8_x>sAd4)
z$_saJ9hGcU!#@%a6YQ525!I*)$Lo~6a8|$b?1u9fKUX7Ny0*6`#lM<2i*%3+FJBKb
z&2~?_aosfKbq^g~k(U80iXGkE5IeWqtJ%7DHO^)=w}R7dF~R2ZaHpqZ)ZY5s``Wcn
zdklm^v^Hdge@ieTBe4{6cSn)syaid5@IFEgYY^Y(w&?g}Z(r?)4{sI=@7}2(&TctQ
zc;s0-;?!F+FM9q$NApec^(7*4ui>I{%{haf`Tbn5Hy&Pu4X&_`cf$8^_s@mgNk4e(
z?IDg>f6EMyKnLKGCZZ{eOWb3gSES*BB}=YIxtSp!d(O(yM(v!rjmtM!JJQ`fsyx3N
zvc}-`Z5zYqmWxUe&<2te{Kf>?59jt7c5`-qXlpCK6cbO3$g>hjdIo4`s&x!yZpiPz
z(dvA6B5R8T+@SxUPuvBmj6goJl(3W-^y@>f`W!4l`|Dhi{Uh&lb`0wVi<avxG2xzo
z@-htK*T=MfZNrTGqYD{T8VEyD8;<g>O)mt4Xp`(Xz+~L(w6QJ!aiIl^7%FGHib_J=
z;*KB>lh-9i)QClVcJ>CeU{)a`%W*<P{EhcPp66e3zR~5WS~&KGCGS@#^%vVz(y^P=
z94C~#mYXG_g=sdP_r6%@qtCTGv7Zi8*e`k+pL3CCRPYkfVU+2zj1YNHuj@uYz;p5u
z8tNS3wNGBUC#WqL*8S?%d90sZbj2d2*3xve<-`HgoN&QTj;!m%<})XaH|<z>v~G4&
zN@yrf$TZzkb8CS7#4x6-!KL@Ejq7~>yPC?f(kmDDPC6AeA5m{J%NLAnS-i|?z?TyR
z;$Zb?9*I%q4#1oPMH=pvua&-zC=)zO4qvsj7;`ZnRV`X^X6R(AT8u{%=#R5tEwB8J
zJt?PYC^zDw{swu2OzL=FR+orOsKgam7)3^(x8G#>{PUuw@nEdjj2WiVFLO6Mn=DK1
zB4aS1Z<yTk>=~I?^k!t8msW2*6O`6iZVz?eJ@JwE=~m!t?kMxOd91m2jvHePCX|=a
zlx!Njy9DYAlf`YZg!*O;dp=huPu~9c<GDljl@!%GpVI<_q;tOqwlDH+f4p+{*yrD3
zn|}j6AmHG@xvh6(A$`nyVF@Las<{`eaxA#&o41aLbTw8POJe9z1Bl=gbTjR_xe%$O
zc1}v0+6jEpd#lVz*IaxN&yxPLApQZ!&6b;y-2v%ZB~Z8b59L#c&VuxP^d)E9_}{+O
zx4lthtLbDZON_Fe+o^q}YH_2mJ!MdpHfZkB@z>D*Z@0gkK}n}kXwJYY=V8TsaM=j&
zG_4}VX)P%g)(`lSqMfs23@b;MrQ@#i8sS~`5F;<5Iy_HOv_RdO)Xl2Cy3pyJs~zqe
z%v(Y1=7CaT$7bcLd2YQncszG#xy|`NPAgdRBqSvU3=XL#AFGF+5bGa^C{x(GPPy2A
zGaJ(6b-2|2<IK;8DX|zGRVCbsfjGpa(Av8!pTX2;Z0u>kpN79iOH>v-cwbMUsMr!)
z2|AY&jgrJ{n?3eU-?RN*Xw&$hSd}LlnKdZ>Te4%*13)dLv(sJhV}NMBbhY(8%CfRg
zE=6wOiP3or8EI}?g79bH=vAI~h<Mgch}>yn_f!255|P7iqgP$+-!(S*bMC(XP`_m2
zw1>E1*q#Ru<o))3FxmuMk83wdND&Zj=Si33A^p#X>RP4`3uZlS^gUM<rWqEfJ+!#E
z7zs3_*6$$xFT3<liP=04ZVY}ViRKdAt#{(=gZ>I)u8?MBQK<x<|JuskC7u4?w29t7
zX_J4n2cz->ZIS>6HBoRcY;K^`@OVeSq-{~wbC}g<YVLU!uafQ5i^d(NCzcRr_8*t4
z%nalSU|ze1jg3M?ogW8*4(Zl^pO{!DNu}3b&jH*fbt+h~WWaw-_N2Dg)btkD<%!0w
zc@NlLs)UQ&6h8WD@|AX(hQl-dNnRCw54+T|32iKQ-41jWK$>fD&_D)E!Bdl|1B>gc
zm6A~#P;Rs>yafx4ecgK4`H=6|YEkaP#!5naPwcExizyq?=&N!OZ$00Uw|*Xp5V5#k
zIy8JE^yJ_fKSo<|p&fi<dF+hj<Wp8@>$03Q@3k|(32&iCXM-Wg1f=>@6?$rQvbop|
z9jtfkABqd8oSf<9_CF-p-hNhn=A)Ee2=+7_I2j~H>}52G6BMtNLFQ19h)))A&HMF|
zxt@$prPX2XLM5Zs=pXTNYT4~wPoJHYzvHgm@Q92|fs=r@AnVhat406~c_^Jj(YJgN
z#;0V$+7%gJ<@kk91e7(h)$Xf}YVE6ebt(~+16(5xbQk+5O>-1GEjlgSKY)I1BH3-9
zF)LYo;kjCnb!Op%EZ&rskD5M$b$$<tdV<QU{Jg)pdw(k_5U?C@ZYO9EEo7V`KB^sD
zeN~x;K*B<Q?&LM+NJ#<HNS)}=fKjL5M7A8|%=Wbn@9OWg_6=Ew)v6(}U2P)$ziJaN
zc&hn%B-G7`xC19#o=b_3Wow%Hkc9>yWna<;laSNjD7z_i3JkO{!(g~>hvH~ncuqpu
z!<ZWb3xjui#UZX|Lu2}d0#r5L$F02w;`1|A;~*_44-jjHsO{u0Nd@-k1k1<el*)!T
zM=aDbwD$MQ6yi8dGpbasHlO!9Oji@1#p06oN#kh*b)uWtO@vLKo=&NX2U6yS3l-{3
zlp>SjEsWW<EoYC=zpJk1y&}f#{7PU=fp41aMLY7VNM&VZO2sMn$7=Sr4^JrD+A_SD
z3gP9@V?J$d#6rjDm#rQ04_aRnmhu{aTMQXn;S29T8AOjYQuuL_OHOw-L}nXv2gz5C
zXxuhDXCnNyY&hn4FMafvXevZ*p%R^_L?-GKi<swW$`PEto!5iJbWSO4ibLVNoSr~B
zU)JiQ)O@ta&5(ob*Jn<>CcVLu<bX7Cqa~?TB`6E!%-K^ep6w6bsr3ju>ZCh3K2s}w
zW@Za{`K|Es=c-(n4cW(w-wll+Y0fRC)HpJ#Y&t^LEL2p^bK$!6H`C_|DLIX8Z~gU!
zzL=gJB<O0>)7g9q(mdy|5u_3NpG^oA1TB(-UlyZDLe$~CWCQq{ito=d{Ew(TN?XXP
zU8f(aUyR`AprF;BzXyREj-+309rn+3JO|J}F|t@Hfh(~Xai}gOJ5x}Lxn<s@sMH}(
z-<{o;7nq%-HP9CWLoJBFE$P=`8_o1kx1W{tPL5Xl7;VTBv}_(g|Lz&>%GWd|2?T5r
zpj5#)hY%tCJv8)4-<4bA+<H%}T+?0@7o`TjdTF_RIlt2A#h18EK%clu14_ATAI;qY
zvg%~+EbwGEjbb;de8FsAFx&hhRQH|9y;DyE)lS$kT3KmInzY4ih_*M__V_FkN6&XQ
znDkEetund~$rfGJ3+THaR(sq=dG8^?>p+L>XO3t5Ud|A~?BDktG=?%Lu^*C(TXjHm
zDBSBUT6H+7`rf<Vz@WyN<FfLZ0@<?Jt!~8zK`K9WhB`%U1}}J;`u!VR5H7gjC_)W<
z=-!?29V^h3$2=ujmM=+VW^G`F-;p|gG@|a<?BF&d!~~rq!dv0ovouX|laR>ABhJ$z
zp0UDPagdpYvxv+d9kE<-l{DJDn`&Mni)Z=%W-I>TKwvLmNmD=2A#kBi4+kOL1HJ((
z`q<Mt75Vt0!;8QAIsow|EAOKPz9aiF=-MRVospJiG`thd75Oe|S7q@3f2a%#`4`}9
z<lfd2QRueJhoQ=x+0Y20Ae!x|zmPdkk2Ll%`TfSdKW*P1w^_SwkDuW$>Ao9KK*rOa
zJft}@Xx~QC+-dr@i}Y`VBL?J1!~)g~ix;g{xn}!EZlB{wG4WLRMkA-I>pP^PyI9d(
zx6$o=rB&2&Y7-W)K);D}&p6yOXqtDA;%`Da(_+{{KvescBgaGqTzSh4`aKwBi0R<E
z`&BM4-7fV$g)7G?!^TXcc66>L3m*`2$cpvB1NdW3jqe}_a|jT^u~*^1aDY84UEzd_
zz<JAtik`DIsI}>@qAPU%9H6G~E;o?><)J1)<NQqSf_KIoc&G2(ZBDIDxTV(di?a&m
z<oGbVfqvbnJSgA(DVQ-k-hF|hE%(DEgVTRsvvG*z*>kK_6+YW++uNHcY3|@V|0!U$
z8#|>(%V#iwTXCK?ypx6O+_JHYWe{4k8$j`-61?%1WxFZK8N#nA$={+G-~N%3JPCGe
zgp?@M`a<oqFI><z_6TBQ@#|*ZK#A|{SS*eQFE!UfG~dF+!xET``0C0s#RN}>uj{eV
z#nSn_U)~2GgWTUhhF>*|B|EsI0}v|_(>>0O^wcs1JrBGeZzvd0__Nt8WVXXtn+44H
z(@YIAM4t<mmova#!zsbzZ)kw@oa{?ot_MF{sf{NTGwrv^zI7$>KFcWWx8655a4IwM
zsL7r5MBmcZ#_VNwzO68*09=U?Qid))liMa8@r4_{@f?P{`Ye}p-DD3+_5@k$AM2Pf
zT$fhh4)&YHP*y<Cq$Befr8!V^!NzM2DwoD=9lyGzZ8}(bEFsJAj@4Wez77shFu@yp
z0Y1%FmFPNK7sdLrH-{qFfi(&rv^w#w^%uHQBb~XAmt~nPO3B*r<8Y8d1plspGFkK$
z*YS2(yNJx9+zU~rnK0fM<_4QEq(L9dnM1G0)abop^+6@Nmx4PW(w%G%jz{DO>Qqil
zP*m1(A9c8((8Uwm*?q>;k$7D_h}+J}pU37Utu4QW@!V>-#=oTu{|O!-fulnqAAnE7
z+6Q2jId*r}cHR_iE$YxDR`%I-?Rps+Skm!NFc7kdl>i3!vDFi^p3aM$*B4ixo{(zo
zOqN!N{@D5FR{Zxc=kIPt(bIeNux`eT0C4+Dy>I*gq85rV)O@6ZG)+;{ZOr2=_$d>*
zyUU&b(=KQAfL7<kOr}8M5L87mZV>xRF_cJjj5}raRQyIku4jo3UNKzz!sa#W-bJOI
z*C5DIw{N>DgXvjPfVy@=FSsypsFEW=DxSX8h1061lKP39lVd-P6UYs{_SlzwMpysk
zWrMcso41(PHSZo^%8@7$gS>I>pD7(?KQU=$Y%4Xrj_H-JR<dmHSHkiy=LdyOcMC$1
zV&tVa6-D090MJ#l{N$!od)$}bp~c7OWXb%NXk3K_q62lWcX8F>h-#I0k%8f^qF3_I
zN{N^lNeS9agC7QRfK`BB!IC7fVyjC)5I7}&!g-FAy4G{_pZB>V?qFc#+obzN%21Zy
zg22r{Fs0kE+7$wDIFoaLAVeD|eS2z`YSVY)354x*I%Dc|iG@uyWy)VLijC<+r!g-9
z%;~tI`G>>zw<1C1qi$-Pq`CY;hurrj7OK?{8^DOZbU15Ub*TZSYQ_Qbqi0?f{Fxv9
zgQdW{s}f|ZsDzt#BUlfj#bs{C8_aXJF~RX44O9K&O1yqI;$dTmb`0(?hm;gK`xO#%
zNipn|M2So#%6l^=O62VfAS~?sr%p>+KT4nub3{9`-CGtUD9j@+n%SXK#74|*8x*mr
z_7N(TXZjM^aiNBB_hJXX6waA4H8E?z_UyA}0>f(0Vo4_?uu$uEm@*}SQexg`j`JEN
zM4Lu&TPT}Xn`FKd|5<4D>=p}$agowV|6Hp*EDKvC%1N4UH^e{faHXB;T$?v!pFj9y
z&1oue$~a_3;@Zm}bsu<Hxg)Jy*%O~v@_hue7SyN&DFS91%sjQsA5-gH8+5A6BB>u;
zAJ}^It<gGP&7Sw>*AeqmEKgy0KC?6<^$WE(zH6-m5_&C}zYQCUjzyVKjz!Jb(H>Dh
ze-p06h<O(7YgaFxG=CxDfTL?WdhTO(^H6cGxM8w~;^6wJe@vbUcTMyNbT7H7I$e|I
z<o5OZTJf6ukt57aHnKZdZ1yqkjHhpoDGr{m68A&!-=&LD45N_UkHxpYue#^1T>8y+
z@Yp$5zel&+Z-yAWE0<((YWuEUY&#+AiRH(V2q0B<oM!AOg|8IrHL*=wG{YB3uFMZP
z+jMqr=>hEgDj5`4q6G|lKnr_5hrGV*s0byGanj_T;q#J@30rFWr2f`g|FepyoCv|D
ze8>ceUFpGG2|)x&H7(6ioBehiLMbPwUOxQC;AxI0sA;0(e+;Q9jhmX;8Ji?J>{NKf
zvjs3Y`PvEwh2P55k6_OmjEjv@9)6^Wh539XrijvfN#4^DSD}Ypq9m9!?Sbuv3?kB}
z$k}#AG5c0g$CEZRYODft%Z8!QnJ)hfncwlca<p;>S{NYhle=Xdf>y9Z<m)ld7?p38
z<w)&;wdN#UY+Y!6eHP|gl*m@#4#Dc~Cx#{ekcAu)8u|o>T9NIDE9OuH`Mn3Fxj1Nf
z+=lkxYpOh4Kj_v>pQL_QcN_cNS-Iq(ZNprf;%*ko((Wh&IF+F3sYVv+I2~=57}+1)
zYFjp36xN@C`We|&^TP6wFa1#jpYGvHztElVKWQsE%mg@p&=-sl=&}rn+xFiRL3Y)2
zIJc2tk_Y69`Sg$l!{j~DV^`Ewexf8tdNj}1ht4KP|850R!Y))z%mKPe=1HAT{jrX=
zz2Ze;v$nA}RT4OB7JT4G>HI_I7Wl1a9h;om4qiXv&OMm9+7SNf?%wPEUi5cmc^7Ob
z?ng)jKSl8cu{8_VoApw@oDpVo^<$1rA>ug?C!|O%0K-cAmiV#6OpkJ-I++@6q*x~H
z$1+G`?}LGFpt?_Rj&N{gH(vVZbhh0fDdtrVx=W=^=RD0VML1Q?-mF96lKiYr?YES?
zUjq|MZ6+sZIw*tIGhC>fJ^3bKLTiTvPY2R*H99fe*Rt_)DY>AsEmxZyV!`9(*v_7?
zPe(ahu<D<s?;o~srJIHdF0_QdfnTg^XdXaR;@#v`4E4h#n!eu9;M7nF(61NtaXF!m
z%B304Y<VOA+JVorbX%o!IkPAWyvQQk@j5n%O3iC~)5xO*W7XnUvB%bCL$KUHaAwBt
zRmSL1-;$GkwAbR^7Zi;8qj*Dzixd8-bgy~gs-t9n*Wg(u!i8XGVs{&?-QvW`QIAA)
zY(-#QU_z*xSVf2ii=Q?_b=Kpii(X@3-#^;hBrp=ANNF~Av-zG8E}R_z<1lhO%r+Wv
ztZyXN^SR!KZ{qUi`tROJZ5T^NcQPjSmsi;9R<O!$JH^@EzkBRl=l2=co<2LPAk}B^
za1!n~@Oo}Q(IYZrGpA0pX9t{%X7k<O@c0+Hna_`DM@rzE^Yb~hgEIPx;re^#KO?pY
zS5Z$<_vUZn(r4XQo*Oa`4Yj#(!!?{>N39kwy_37)90J?75v2B=tNs5`_SOMWt!w)*
zCKh1OT>_G#lrS&?(!zjrj(|uBBi#%JAqYbVC@Io8bi=5CLwDCm4P7(Tz%ct;?sxBf
z&VIjh-gAC`@Q1E7tDfh%pF6Jmx&|ph_<6Qvs(OQcOlN>1UO*?=AiZ}$D}l1$;Nlu}
zP2z~qF28a?5$&7Wom_v+!NpAT58Z1%jL6(R0+MMnA-!x@ky!?0Ry2!WstWM)!uc5@
z)_SlHu8`rq?<k1FznjP11$Ef+#R!~jn6-5yWM@qJ%!_aVgn0Y82~t38I(I{G@Uy%6
zEoj(X8kW-vP2tIJEYPKAa-{XGQxV-a6QGF((E67b{?e=fZBqYUCl(XMBUb|Bxm3JR
z(=>4>?8q;__9|1TUm(32k620q|G}LL%Snw@xfa6daOCQNVToOJg_$x!xBq(g9gC6m
zk7(U+83x#{+s?uBFW$YXt(~$b=LyE<iW!t|&(b^d`7)khAK5S`hms3}-nO^vWtzU2
zCG)N}R?Nh~Nr4a1L`8y8)sdmr@c5M)gCxx7)u}3~cQQ5~31T+b)4RZS4^e>-&}={j
z35tvQ8YriqdH=>iO*Z9B{?LneKn45De^<da|G`gk&v9WRE{pHl<bhLbxJqf{EMH28
zFzI;`u6xlcp_wuD6Q<F1Iw{cwYGiRZ78m{6f1pwS7BQkIz%m?=J`qA+1QplX#vv=T
zY;+GLES~4AS30y{nmj&M{Gek!wVrm>99PE;b}8PRtA5SoX!K-ua#B2M_R<G#7c~8R
zUU&n4-e+nin=pMjF+$V_-lJ2X${vUBWl{$0z}wX_f)4G~13dDBtTFo)0sj`reJM=X
z?c@dSfX~y7uGi8VeAwH7(7Lex*M<|8zO!%qb%gQ-Ob?HUuhb~BEL=a3_Lz|89ogd1
zdzzaeE@LQq-|^+wo%VsF23hd4wS8~mV;vqa)!>s)@cSr{ISUAOMm%Wt9iQ9bZ7n@N
z>&F-Im}$6fJlk_W4RK|uo|A>+K_Hzb0~WGk@(G$|TZ|f9NpEbuXqj&3ZiFa+K11nN
zwfshQZg%vzQTWEG9oyl$JE9lC<tSYh5@GA%UL*bCHIvV?SFv0IjGQ;Uj*=~R7E4bQ
z-$=kH?=3IFpLnFT9E3!i$91yCprin{qnrEhXDD)KS?>kSZA)x`VsGC$ORnN~#CU6a
zE}B~zWD^{7<DTH5%<lHyvrN84S_aiVUOL)kr&Pp9g+OzBp!2u+otv^<TpTqNM03*E
z(A@i4$ADUt0{b<G>Smw@>qvFK^%ngN;adaaGs%`zIwIe<`_A?OMmxT6cS(1d<+`)Q
zm)G4M%g`gsP4rVC3i9M*J_bWW_P_dLNB)csfhucyB;Y}2gx~%c4Jyn2xZWA$R=fK-
z8?upPI9vD3<oT%z5%C<>0q>M>HU5q4TM~_N9Z=u=tZ0JIcyM!)HM>SD6T_Jpz*0}S
z{I4x_nIRgA{{+M%H2_H$tJ=_QTzB-hWfYH^EIKjP(`ddiWKJ9M9CuxcPLzx5R_oo_
zln6mp)j$^?UXm*cAi*cOgv^fNruyV`j}H>RJStsf6#2AiTT@qEtr;UEyl|(N=G<If
zw64ulva>ST>oq9+UZk_;gUlfmub_~Jr@GMoj~c;)Y1F6B8d7Emm_hTA6EzM3`0U6Y
zz(s}k%0PQWy4UZ(zZQB>&svT>dpl*U>G(_@p)s@owi8!iyh-EJAPKGvGQc#f6$J5<
zg=dE6QJ-7cVR)+OO*38?taPV}LcY!XiKZHN+!HO}8-M^N?UGk7r+jsbU3oZ_5#02~
z4PRI_3FFlO8%;@<piX7)X#V+N6?V<;XWMlr?C%FpRHXYKr}-HkKRsmq+G$<2%Qm+U
zuT4ZJ=>k3*pb&{(w0~x$nyg#<tYqraym|gO%>$JR(R)K@+P9YA-}ueUGZx8E(bj>^
zL{fy-2+vSsSx#HNqAf>Mfb!f&?v%j(cLwQH+VmT~uO7E-QaLCK=148LFxL?9lzpW@
z3$>f9)|q5oxpP8a3#Vqe_uxV#JG&%woHKDI4_=#BS$%hHbh>W$gUftb|JmslO0XwD
zY*i5<@e!LaE#B5WvLPMNCo~z@z9we=Ma&x!X0w-?IoNmq@IyrhIK`JP#lu+4&7LR5
z@3tvKZCWZlOq{G(s_6_nYx9H1jLm7^{3G!-P~*DWU>!McO+d)7r*b;F8F*_tzA<^C
z3M%slSbW3@NXJxu8ur(ke9`tnJB^aIiuH^%HguArYOHguS$;bpGLh{my}@h-slCZd
zhqyMdNu0A@3Xu4=@10v4)r;2)F*%=LaQV^u3@r6NJHq)Bs%w+kI-j0hDzv%Y52ewz
z+7vQu)6eqUXNRRd@|?SGj8HSgzK3Y%8?t@o+6T2I$W7uto~Q6L!DJAlQ7cjIXvi~*
z^$?3z;1cY7>%M4rc_(i>Wx3L%&VGmTTqBAF3gG`=En8cTt}VL3n4eyk#KLM3Rddp?
zC7w*5MJJWs$&f6;Zi!f^k@3r$pT4|z6XJeV5S(9{A@`tbZsYQ^A(qF>D(NCq$87Q=
zC$LZ|dx~qKyRb(S%ragtxAA^J-g&kv&w<r^#J#J|WFDhj8|i-N5XY!h)I%>WMwTI#
z>%Y>JFx<z->5u*y&<7-r&i7EtN>s2Ky>LBe4WFB%gMF?jMCwN&lRgHiktgGzq(E6d
zIVWPp>vU=p&ArGPdtolJTM(Qdu$6Q_5MQE&=B48!N-M#51Y4ZLH+ebzp%j-Z7g*UB
zHi85c=b$&W2se9~(+IEP{(b8CuVB_>OVkjb7^n_-F)q;f^JT=HRJ#WTk=T2ekFKNv
zI57C*a$&IH)|SDdu%So3!5tmtT;KUZmw!{A54;WUh5GRJ!K2ghF{40t@T^{?{T_?8
zZso|vzA%O04F^$WuKMzNc7M*7?;n<|ZBUPRz75WjE5Jz-iJ>@%d1<Ab`_Mj;%VAMu
zY~i?U_(jW&1{K*V8yn<%{(y2bd3#wrib#|JYNTD0vOQxT_GMN2Ci}7ivvW+0%qNte
zfo(_9j`^f`-)W=2xy)aMM4*<h5)oKrA3&ScWQ)i27%Ww$3$IC<jAr{=FPxujo3E{|
z4F3{3K(*E%5EMo=X%cQ4h?%?eOD8Cwx%h@vkpIK*>l6a`HoaX#%Ud9Sy)x$eEZ^n>
zy@+vx{>w-RmTpwoeZ3(o(%DLN^pW*VK?f!En4LUoBr3`+AbVp=*4g4d|50H7VPLPH
zTXNZ6CWPLFObttZAKnv3{;LzmbFgw#MjHjcH={M`S)p}ZA&enY`6a(`9>sn0#0k5H
z>SmtOPA3*|n!vp2Cg8%Zae^LE75qjv+la?GwwutUl~k?l_Z3kOan;z-lHV8`x#wE)
zqw?pSA+hEjPh}Qc`gR{fxak&G-I{E}L8$Ho{Z5yb_v0gE%u>rNmEXz<TjzEc;&weD
za#N{c)%}w=)6}Oc-@o>YUp>#$#7{{gjQ!jYqWq9jr3^YuT=%cg-$XcirXNYtymQj0
zI*K_gpCRuh>Egu(P3?TA=?+Dayw%K^abauUxb>~b!x$<C4?-vm4_&9G;i~Qdx#NtR
zWaPStw_ekblUTidlpH~^D{){oX|#?aaxc6{XyTb`MstU2_&3L~c`hd$W7N>lYL0b+
z8SgY?n!!#sb!@#%L->-*Bad1{X|y)xqodGvG_ifsWA(LSu57pDUGP*C|6_&Hjg@Q%
zkgII=9gRniC8zdk{O*6S+BCBk^bU%@;W1e6MF&J6y>jbgbQTt4l_%@5qm#_Lebj?x
zSvu1K3CxjagGF!cr3{{k6eSpSA&z{A&dtk!ZGNp4WI1Zpb*A~@3%KE1x1**O6+p!7
zuDnohM815!;?-j}wR5iX!^Kn~Q_Cv3BUZyVU6@Mze<Raa_ATk@`SLMJ^<`Yw%fNZv
z_nkMfW?b!W8n9qO2gQ@E$*ImskH&3k$tUIzDP45T+ec+@AXGZ28Y!e>)vchm?+!<(
z+2*?6$j&xV3g+tExjOd~iLXU&QTgIRktAx|*l3Pla$L3vLkYLIt@ZVM-nwnwRIS&K
z7Rc}u_^7d<s2X;JFlT!O@5hXuk=A2REb$(3dJas)X3xLf*J&ht;o?|pmHiUU|JD;+
z4xjkdMBP4fdh=R-JM4Ea;vZ<dYro>kAn-C5cdh{-a$P;+^H}C);EtSm4^U~^1N1J=
z#}U{Fk9^L8zcb3szafF<cLW8hPxd#Ye}$A-CE?%k@PBiG|A-+A$aMzyW~@dwJOZT0
z^vdIW1h?kY=AW}%j#3ghdYWB*j%~4KaYHgai-VYhdtpfII`wg9k$t|XskVO}RG_tA
z?2=uR&24}4%cFvK^j8`AuFxp)QInCKO)V|>%hvr$+<Ds)7b(Uv7X7@>U71~rMx)#G
zZ^x0u7<x{06g9qUwIZ7KM2;ArE^Jcqy*6_9EougkGAV&&j>Z6te5%WdIeBwG;@$gT
z`=LYChjI^!7~i}px8f?3B(0D_{gPFP8Jo}Elfrb6o}%XHHE+jLs0yz5Lqd&Cs%f{Y
zmhimxwde^&)d325fpsuf^&;PfeacSQkp0`x2QvhniR~?uCim9N)o(4Pr^;3xxVa-z
zM!9A-YH35l#Pc)G;pG~y_SoJkc@7QLG3es`L9N>fpZygR)vqif=?7lEJ4S`+Z0`~L
zla!fTs=CXSKPy=$ppOFlD9{89Wf-Chb8p4M0<Vn7TdU_(XSZauP!bEbvOT)C_1@eh
zrRH4N4h@4`$FSAVQcy=!d(#mD%HA^R+%f97$8dMP%h2>CI^$wd%yj3kx~U?Y?6+1)
z@Ib;ISyK9}M(vhl&T~H<Xvz&XRkn<w-^jj>4NYX-DvdcANRKgO)vOugcCvYI@eE8E
zD*lbl@JukhiiyjIJq%JQBTwQ)To&YJ*0)V1>=zh04LjnPA4?UVCoLZ}r`AlREwYJ3
zY?L%aq7e&eq3kNcun>hu<{tj*fPYQr1Zsx%J1;2on_#3NoZ&nBTp$fybg0>4K=Ir1
zxlk$vxZ)~mN2KeL174vfnp$>jBxE+w!H$BUNfrO1$$cy;oi<fali^B1)@5cX?(3bG
zSPr|Hn@|XX)X$sy+RO-V+^O)1#ztU?Y=e-6&Pj4}de78RZ5=_D4R=mC8G`fZ&3>7d
zyq*XXyy75mP5p-HY!UODxn$ULvGTT@1<)c6wWG3m>Dj2asD$V%Jp0W<vsE%MZ(p{I
z-0~uXNVG>S!--AMMI5nP<tgK8&55Z&+Bq!z`FNG)F%UmUZM=eWfNvk|$*J}mG3r`d
zUf$|ECcWx^h__{h*nUm?Z?c2aK>yrTQ#gd=1~u>%`9_#}X(Y+YOY)S+_HjB~ig7tc
z`IOiEi$1(RxA%t*z80T~$ER0)ds7_??Gw9JXIE=txOdd!m()08)Jp+;Jpfcuz{7|?
zRfr3)q!ONnH=Q-jy0x{oKBfxIv6l#_P3~K#R(z}DoM$#)$Gxz92v`s|z|mhB+qJ;_
zM)r<4Lj9O&&$BpRxm2?3II=10L&<Msuw!ctSQW8u38-Z%s+9lgHQjTRJ@;rR^M>)N
z=iQ>aKR%x+&pVs*IyYZd?fcv9e~xvYz(j$DS#XK_ulDFMi}dMc>os_t-2CzZ^k^2m
zPTq~dN3w0hl2Hp664#TZ`mEu=j7}yI_EARyKt~KftOq`w@9S%FJ=DdsA{N)xq)eu=
zTzhUzJgch%>D81A$>HM;GIbZQ^dgph8{o)Ez-fnNwB!sdj&{R@LggMt2ikUEEmWem
zrtoyCZ@Ma&@||Fdw78Ik{V<O6?T%IFWAeY83<VxrbiK_e4nudr8+z7GKi};bC-CMo
z-{6$&)nBLC+w#iFg=kQTIhtfOJC0%0n}*MIT+9@75>(zyw@C>vzcZ~z73v(MJrK0e
z6Kl(Tq*fsAzPyIB*_Z)weL<t?@yz;)7=fnK?Yu_RQn6nLDn8An6i=DW+*l-HQ~sLQ
z-n!=fRQZ6>U}LiH8Ld;bT>I<+n}HQqtCT!8j%~dEn<_s;&B>XnP@XiVS!`e7&xZvw
zID=#?i=%q!NM+$wbVb>ytZ4p^SMu@Jlo?l_eD;6Fc*A19m;7RhZ=jTQV%8pV^u)8G
zyz=<dd{->U4ec)zQ-_pZc`&uX2GsI|C+ud8(hgXZr=B#8@)(Plj6!rcjq3Ox`RW8a
zjL=}FWXUHQ>F3^rv-mVKY#!S685h%cd;1IAU^z5XUh(ok@mASB(p37{yB&>M<}OiO
zPcx~wn8U=71Bk`6QwNaJUb2ou4r>>tsiq*cfH^|aQ6_^<x&wQ8M<&ftBVt`w)pggZ
zcUlyuUSHTuolRrr*p1YJ-O|0|6^rP2rPNx&6v#v<HdrUQCC&0=+zhl|y&+Yw#~55b
zn1P1jLVyY8+4aWIa8K@D0(R$DZU^}fjOnjEGEy6GFqBj?eSK^-mUW?1DT66WV77G2
zUm?6Su%Y;|lavFWTvr3n$@01KGznQ#7n5s!$eFo!zWVh6^JTB0y?<Wa_U4fSW!au$
zB|qZF2OIvR@A>t=rJOV2Q)Q-}0?utt<He=hG6Vq#zBf8alZZFDWUCS3_fgZBML+Ik
zU_bxj^M*=43C3yVo1nTtL79@4%})mwZb?j=`k38Jy#$B!gnEhW#Rv#D12$v`Vl>%F
z4EBlDv+{`!yk+tD67_hJF8{En7AQ$42u>x^R(A|>s8~IDv>sHavBu;q5K`x~LnVpB
z0I^VNuEQN4q$697)90rHtGn_mS#RMeHLu%#E-Wh0YeOri@n{4utD1|Ce!v%q&Ln2%
zaZi5B++5pST(6lK)H2BSWuPYE%7};38;y86{TfI6>wR2dF$j^Fi#%_y=VYa&ogcGj
zv)%Jv5~erD&q9lr@14LVeR!|Mb+lS8-SFB9SIP)f^wCfo*43`BYaBgK$vQc>_&JPb
z#wS?YA`P215s?k3(7xeo4|wE<UUh5Gm^$?=qzk_FZMm!&$azjsVYfR2AU&+`ay)ZV
zioh4%k;t|>LEiVKkqhrH%qub`#Z^J7DZH$@bPIRi?QPbyG*6u{O$nN(PN-;HgEwOQ
zmTgn%W4d}&`Y^Gya!>0{1(x1f4tU%#tJ<u1EwqF*)UNt@+H--a1YP8(JF()x&5N-2
zz%QBg4o_@gh}Z9}Sk5_+GfO*PaO3@;iAkPtr;uJy9S|!P#_d)y70ZqC@uJ{WT%5s6
zO^{g!H+XiNpbl9wSK;@Ar~<}F<;VS@mtyK0km1q?okKcRX=v@5C|vK7x0z{o#>lr_
z-90aY&Cq*S#Sn!_vEz64IG2U-D2OOqY<gm$ca61b;_IZ-$J5=Gyo+X4vUR#sVwn@C
z^dK|Z0Ng3en1lc*ndTlit01p|=PmM?b-ppb{2sx4H&6A8HZ^|`*%k7KchsM6-K9Sj
zJyt~bKIwSCklb9j6YCA}ecVSAL<H7N`uhw3c#w$mS8lfW=zgRmyg1wF$<sizV4^5|
zX5tD4&;iS=V}ry{Vxlq=GKScEhW*WNWXvlv_wtGNE~NO#Mx6bZ<=4OYc%J-YF5#%;
zzPlB?L~K-byLUOsWBP-oc^DqRU+@(NKKy;>^Sk$J=W7h8mijlz**~ire~Y5|@MmRK
zq$ibAQj3HYvIU-4IgpWC)G2?qxI_8*!Re>!LWb2=Hb5jqEHeTr*{Sn3FftaOk?klk
z(knSWp4_$EatsABcduK6+J4_@7KXs0U_L?6E}XW^DPJP4AS^*3RP=a2oto@zl!IPg
zUf#yViP}x)Zy^;NDO6`bJy7)}%f+To2g@SX3p+Mcx7g&ZKmZP+g%h@6J!?pei0evw
zHsJ9M3oYXL_-Lp#nto!5Eb7Yi)KBr8lfmW(?>-+qT@^pa?K)0Jl$}SVm?t{Iznyoi
z^ttOT-qvDKSP-3vSMl;=7z4(EO<be+Id(y1WRvc3<EQKekG0Dgh7R#Z`gKoolB3>W
zL_JtLpFOx%)(7)ikE`0i9NlhVP2&;<1S3!IzmZwjOzy+FBZLgPaD(eg{X#awi&0k{
zFVmdy2}IKCd0pZ+8nE-*Hk&>uVTh!96=poO-Ha+;Xo??x+B5lb*n#SrmD-wDrdea3
zTVG=+K{Cf7O*J>El2GIksqDjBk(MKnY`2n^@gZD$XQ}Pg`oa)&BH&e&iErPPc9<W^
ziwmN%NnXQH>KT+4Wf*qGFTm7GU4n13##PM;&>4LNz}1Y+eIWYAMUU5PhH2$tKkm-(
z27knpc`_Gne)K*eH_q&$x@e};M2b0#-MH`PG!c;h<%37*+{Y!Rn2J-o)-$^S)~T(p
za({fqLYV>s3a3d{D+XWhUmPlaa{Kd9#Ps7!P}YgBeov&Ttm?D_hDhYM=uhqo5=rX;
zaSJ-oGpU4{?|pvd8a+o|B`ScwlCn{z4$gy1R3_-3A-J6KI?HDZ9QdC(Rwmf;M9iF0
zyw7j?-+Wdyz+ys7b<q(QK{wSH9@XPYK5<`DBwH(=;dp9NMV7%vIptpL+MdY95s*!|
zLjW2R1U{2=0*zNp&{%^vIct-K36))%>fcQZ)Xwite)gUgx6>=WwE0tl4B+w4SOah}
z54Z?dTF(&5mg?i=O^4Z#<d;?3fxE6)gE?dYum*=)mxAtXspKPt-Q8ke>+ex_D@Y-d
zI4&6Bs+<wc?l1=%nw4hZ3V;{k!f^+~2&RGhnRhJB)z1K-v`x%Ufgdb@tT7b<xMHGP
zXA^4G7KS-Z16}a`zI{v&ZATFs0`<3n;8`Yc1`cCA+i2NBa;3xZ?GdMOIY6YDom~Sz
z@ZJG#kO@pSoYZJ~a@vz4Uw~-M4}!f)BJOhS@6mg!`#;QrFLR(c<9*nAQ2hN@HuI<A
z2Aj_PM)ql{1a#Z~VHs+f6U=F7O{iJ2Zju=OEZe?;StMmnTYuO2{rPSYZUL#W&M90K
zcr%+k9DxN4NTA$B#AS=SHKdUHIL=_yk`uu!n1<cqZd`v_N}+kZcfSW0>&-?>P1G_M
z@Rdehv-Kc^a6)Lu@!tJhoheMV<m#`VX9I69M7aFx>SMTFGDFADaNERC6VGGmxjBow
zfYZ{e9;k3}4#4?Xcf})F6?WCf64|N-<F_r6_t3%K-!aDw&~|l0k^w3)AGk=9BEiSo
zBNxU}KQ{*nqeBuG5sUZ1zecZgB->=4nk`JY+m3P>opUNW2fZ%LhL2^7Zq*BXL2%6W
zYJTs@i=Nt^Dp7fh3<F?f83<xX1{hcEUr_~LIF@UrVuO$UbeR*FzxZqPQ5*-qkwsT5
zrH6k2Xul)sxX@Gk-tX<1e+`f%jy;+j+n3<Q{OXwaP!}OwwL|n=uNG^xG$e)a;soY_
zUsf%_LV!+fS8Y!KetR0YmKL<2@%y*FL7>?|5KJu$j`AUgx5-_V0qTw!xi!|e)*3&U
zfczc2J+~Mv2`b<d*mdw+Ke^pdyCHX4KbN(8;Wx6qyYQF~NMdo{ofwp+!PLP+-h)#B
ziu3A6VwePcnH|NYNCO5YNFF!ap^&3yG6MP}6;1&}8Lf1PzU_AWkM!hb?O(SQwVjRz
z&or|yXtXl1rK4gt)dQUgiu2h5MH5k((d#0id+V<g!}x(gJ0!*dEyoRuTL2^r?Tr4c
zjXs_E>5@HvHFO!d_=%gUXPZag$MCdwTz4+pYrpA-Sfjiy$q>GX=0xGDiOD*{fvH14
z;1PNP{G8E(y$F>85PtM(^J39)M(q!ylD5)(^uxmgfeh?BRYLf$Cq*vvE?v!YCywC!
zII@`?lYH1{ytmg6=j|61f4}h<9*+A&LSqphlAn5xZcw(#K7==u%t=OryXVc|No)ym
za5uucrB9x`KSzqDo;D)X;EC{rBjBhjVY_|nGW5a9;|q?O%Hw;V!CQT}&{>d6)^0F>
zuM$OxI9cyIHxibn?COtW*Al{-RM!Syji??|g#bfKU;u2z(lYpt&k&xgQ<7B&Px}e$
z=Oo!RKZ`q5uMgSc!%Di<<U9-hsCVaL{A4phv;uJ-HVJ9>^Qt5wh$&UkXSi8aaC<Ox
z<T(n7X-4XT!KQCq96Y-n>;E08dc%8t;*3xHFO!vuyhA=uT&+9*Bx|f2qJE_~P``_F
zAqqCTmFn3!wTWq=sZ!&zJ91^mTPVC`8^KJ`RDlepGIrXWiVS8H!>3SFZBCfbKAIY<
z>KUql23U=+RrQFp-(H*3>}jKmsdH!x{2FlLR6t=(h=7xyRrMO%_uAqH^c0}a_{TYb
zGY-U%zy6m<+W2+tgEl85Rp7_shGWAOK*F)5>de%Ub(>1qzS2V-8O(~#>&e*>W2evI
z(=v%3k!Q~?7hbQ-U#(lm@V6nD<=<a`HZ?y<(99N?TPm*!ML}|f?16_{JDrs+qoXyr
z*jDb9t>o($zTug_j<{yiqkKovo9;>T{)!g15~=w5Zq5VSJE@a|O|7a!nilR)WGuwH
zumK777dSqqND<A(`l_aeq0KF%AVff*?u%jUt<kcEvwCB-r#=>sy>o@{AetH|3%q~2
zeAlCjm4Xey6HFF>cq5S6ff}$-DVwF*c|S?8RhM`UGO>}LPbgGw+TE!w_KQnUL(3%Y
zfxrgx9n8spP)`s1QRXDj0frpt#cv0gLua23fQE`4lX4UGXE<B!V`uE=8E#?+p7~^|
z-L!GI2SO;5XJlNAP`JvVi~+L|4#=0#ux`}7jS-V?w!k(Lv`%twX>Iv_1;D$=HQ_E2
z;rEGO`A5!Any@rdp_)NzJKq6}d|wGMzJ{&G{Dr^1cxm;FzeF@_8*y`o!;}=@vg8JV
z;NA2zJDg4QgtUF(=&zX8L-afE>#p#=V)r+vW6QGhHz|DVT&hp&p_CuJ$6f*99e!O#
z^Ay~>nz*sMwDi+nt4UmR&)fP(<0WJ8@+ePw9dU;yA5539TH~CQak9H$ah^FHzizH^
zIz||Kfqk8_M{eF{krd%HhhW^{K&>Q9E_o6c%W_Z4xOV|um{59`?vYm>$nGaUIq-m3
zhcs~Vq~)RX<FBLXcp89DeG47wePser9h9?Un+b&3JA0k@>U9mLUj?|)XZ<C;2j()S
zNC95U90zdmJ?kOZK+U=OqsIZHxrLoZ$GHp$@%XTBZwe3YA_m=-uWZQnPTNPC1hBby
zkF@}v>7!<1%MyfOoMt{}ju>$c8OiqE&9+BbpaMa_kDmcf$5WCWydE$Lpdt+ATxOH`
zD)g|+sSAdlVin)%2X<_^R^k-Z2@33^G!*}!0$TWT(JObvG?1qfX<m3@w2KUR9Y+d?
zB#bsFE<?Db7ETPMV`1pYZzx9?&{49u@S~X#uqVqC@U+fF6>J|D$YzCkc8#MJcP<7x
z&}8SMEm;jb$>(HJKrVrlkze9-JFhXwT=`@kq?U8+J^Lly%V~E3N^uQ?-$WAH^?4FW
z5LcO!Y`5{CJEo$esFwtN;3%+>;kN*MS=9+wC(ivuIx}1^9UJ7HJ00i_l4oU*?*d+9
z1DN13^7=!KO%FJ;cnadlBkgy;gpa|}tB-as>~sQt%knG=AG@Y%eop13fU>5^xWRj}
zTpkujXy%WgMtT2xAz=J=AE9Gp0di;cz1hIgIxYB;pz?mSo|7(wjWOuYi;w{q;!Dhp
zd9nCqY;Lr&xACgBYc138OTq~Zaa|>pn;C_Fm5%=~K&gnEWXLy9G#OYgr9LstEVh$_
z@&osIz=0vX1f<zg8KMIX6BZ7PJyPjkpL02Ha9D>~Y6bx(uqTsV#*thj6%vT~b)a@8
z2Vb3;cjvOPQ~B!)TcYz<=Q@5(YJhqsuET`%1S5H!9>8eZZ<bjElpr8uHD=zgk6aZ{
z#5sTls1@#ri__-}Ze}Q&vbloZm}YGaEU5)vWid34<O1MdpRf}F7pbcJdh|Ehi}_D3
zPTPo2N2R_TS2?2tBebFj9n?$EP742R1p{swe6BrJ0LgR@!*unlHo&?Iyo4YS=cVGs
zjq)e^)3WlWS?U8bhYBsduY{gnIRv16*8x{Ahd3gy4zDFR?w<A4_GD%9)3XLnNIbpD
z3t&h|#_5s)(U{$?+EsKqj$(BR?OZD;a>kJq4154OKt5?KxnA;=e~WUM5^jwFTpr-o
zx=c_)8x^5_>iZLs4vZ+r?N|GoZ_hax`WVZkHu|}byPQ9AwUvevf2I?cD6^%}yi1ez
zI^yTdEgb3{lrx8~)}vjw>=isMk`L*BeTZXg9GVo6ime_IE7rj4_L}HN#W}iBv>hh8
z>&4<6KgJa7fbfE%ZS7ZX(wav-jBbB8b-*|}IQxBc@<->ajH!%N>{SiB51dNW4m3BY
zUz`mhV`ZRSH26On68<SrMWW$7P{QHZGFuW@3P9&Wc?dOK5=kl_tJVR2WxB&d!)ikp
z%{(*N>6n*Qm38w6xSJUSqPl(?eK~h)ko`}IU$W{_zu=?+P8V8B17F(T>R^79UCC-a
zMyn=u)<Aq;Fou7IoabyqT*!BCb%+OWHqiI;pzs;H#B2a#=%`R;tbR3Kf6Z6W(bPxQ
zlEs)$038e4Df{t#=R*@P(}59OmWoSc6SL@2MNi;gpy&u->Xu`_1xp&?MZt9ZI}|=u
zbU3G~;PJzY@36;uQRxn=lJw&yiLO8%pjQ~)>&r!yJjN3}_HXrSM*`+(9!0)$ELvJ6
zyvPOby$A0N;E&?!?taJ>gwM`}Q0&Vc{rYVTu$JwCKN8a=(BSuoT6}icGzDtaaf-Me
z8JzDWfx<_^@jK^Ft`qVlxM0%bkqDjYVqjW6+0p~!quB5}3TNZ-_S(K|GUF%k$uZ)q
zL#k^pgf!}uP|J(})kFH`luz~n*s-^ow@PLWfT1r~I+%AsfM!7A@|5I#TkPwRVo0i>
zfXQgpsQ{qzN1HtzXF-yO_j(y$J`IrUyLnYTl$K<z5tSA?z6VQBKkPVgJTL_sGk-mS
z8aFW&c=YK7g8{JUCx5V-S&gl1349cA96P5ss<<BzlYqlR#gIg>=)2+v0iJ7BSkx{Y
z?*dj4naE=jQacOh13vn_g+=&xAnt)*(c6tB5<yH(Su(qeC<yBw+9sb5-U+1LQ_#j&
z(ggzT@Jk0lBbQDbq(gEi=P@e6BfuH#@FfeNw*UDlD1%U;WR4yYM^=1`l<ULcpt%TN
zI-7hiAt*O6LYC}L)AWcx^-oI$_jfH)<<1c^w^->ns(4V}((xbNbB}cK2t?>GFmK>E
za3|PjS8Ah5c$tj{-upC0aS76U4<wg~Ji0)FENROjt^mS?>TU!m$rU%5NXKeU{Q2fX
z*$<xBAq$f(!OzMMsFA!eK^9A4pYwqy6s<!7g-Lhp-j*=X7b0k!8Ll5?Ebjd-%BVZ0
zdGW=r=u^LZK?&}K^5N(wK5=-QIFFNG-|mkGhVi2XnHxx<E-z;Cna!x~7kQ`@uxw@m
z0-G+I)!5txb+D}S{ZN8~qa;=j05Q}T8K@=8K=(Gr^xeKxt1y}?aJ4o5&o$ES(H@yY
z0VENBPg6cm;vf;D2q1Sw8|QNoibc>j=piJ;FgF)<+&sQfZ2<3_Bu=sbvhcH#TqGIE
z8O;aqhKBwC4F4ISL!~Y&2_QJc)uJQ|p#+n_m&K0Ip`=i}8}P{hLQSCEVJ9hi>+zPC
zZL&R~gYb=kf(@ISawAx3$P7iDs}*;E*+$!xHv(MXu20f&Rm4R~%wFTLpU4f;_C|w$
zHE=8sm5NGP0ppwq-6A*nJZ2P<qi9G#4vFak46!x=CnCYUrN9=@IfGA%HA-5a3|0{a
zp=M@VmSW~27-iQmxMsLagbciM79V!c1Du0IB`08-r{GtdYBbAV5ETl*V1QBZLk3%N
zGmKeku)b{>?>bw)jf(UHl=1F_#pBHZ3U9jQ6f1FP4^l$%;*;zu$2tLY{Fx;Vr1`qZ
zrb)jxLRBoRJu+&J2{<!xx%=!pLK#*9$+FnwBYhTC4bcufJ?;;S+>KUV-4zyxItT(2
z4+8u>EI$uUs^7nZwhsb7qs(xeLYJI6s7*-d%HGGjkzC{O7nk?E5<zpz+xIN`)}C~A
zZTsSCa*bKvJw4~oKHUF8wrt`>b1|?GfQzN55*O=<Q#dp>7n>HGPq0?#-%7SHZ8BJ;
z(?bn&L?7$)IB(w`bp7Dw28dlS-D-cPcI_<%%7N%g(KG+6%?|aKlKcNkPX6bALRGr0
zN^-0DM<kJiQ>nr{7lYc<+3`YD??-*i*xCB@Nl}B7(T|1sn}B#iq>Q1zlWFeGNtxjj
z6jt>A&nob@^yPoiYE)>yd0b}Du-|6(P>j^AKON8jq+9Ms7S_gW`MVgpVD_yF^TX@k
z(0E+rFOU2wJzu=L%O<E_UPbUbnJ?kYq;W)41M)nM?{<)bE`W+r{^rqqBggOopiPoC
zUVP#5=F|GuevWxuwKa9hQP^1}D(0|-2!Z^(r^>B26hr}8B^iQl*S%vah|p@R;2mxk
z^2*@atbU=Q0{#Z_SF}9mtb*<wDFb3Zf^oQY9LeN3?GbJ-zSze;A*3qXw+$19>;lwt
zLf`<Z#aLhsV8XN^oHm<i#vt4Jd|Oa$s6Id!NFkJ10PP&KMlPktUkXo)cXwn9d2i-&
z+B<9o>Hb{`2+Rw=BY!^7fbd8c!DyGj<bq^7gg7gw(a1?n?gV!My>Hqd<_ORwvDE{2
z(=!9!l+i#<3nNrkHFqsj8P}KSU&lNE^gbPXzD@+ml_q%<Nfh$tNac!N`RvSPY4PTl
z?wbeNvZfDsRLo6@&8f47zfYM48u)L2HU|A)v&13uj94+P&hXqt0(%k`!%=<eYZcQ_
zAZq$Qc#XdXxk@KYqSzJ6tgR^tNQ;}B8BG0K{KfxE4*ZYnn+THo>;DoU_xM*=HElQe
z7^k7>W(M=sl@I*8_u>e@rauKJnIDUqcn$ng{{E*q`Wx9F+>!qZCGw9GjRX##UJO}p
ze?fQ}Xz!D&O2pRTP#;ScAi`!)CMG`-O={&hK8cFUXG6Jh7W&-I{ud;nvG4bYF3S);
zKT`?H{+-;txTTq`039exg$B$}i^A-->i=eAP!Gw;M8cVG(si82`FjwWK|tNUn+XCo
zf_Ay&n0GKvyzaJ)7<w--(H_(<5M=6Lkae12wj#zwn@RUpNn-);Jv)_<sZtR2g=b-B
zt6=?5E*Qs)<xK=UWUHao`}8oUVHQQzlvg0`Lm=*REVbP0-%LtXjslXY77_B3M*Gq8
zua^4KFi&efGu{}i+Wd$fYACHgESUdqYXAS_6#lEG-#<#``fX2~yo@Svq?mk1-&dA4
zISPk#%;Y@$ue12JAo8(ow;sH#T)X#P`@SswVGQUbi}cjqZ7u1MA?>Q8jH#LF41ZDh
z&x>r9sjBQzp@PG!OK%5U_87<4GTLa}nxvOR-Rk}Y;wP_yljy8a@LJ>6L$Y<VsFRDd
zmuvc<@$h7m<#f<Y@v5N#?ZC>x0nXeW|FEQ7IiFuSe4|^@)gXTywwdhY9A>}!BVb#0
zf~6|XG|2_2x^(pUSVSDA`hP8$|CvjFsbBqHry46`oNHq&Ukoi{df}a>ebT;imi-JD
zQI_PHLdn-(Z`}rcAm_f|!TqYef6VnxvRvQjd$~`pKC@FB@76NW?~l<7`Dd^eszm%~
zWBvmi274iOWZK}7!dOWb)HJ4w*B~QW*Y^~;Um>D1G0-kmnoRVmZ=!OBXsq<%Nnekb
zRY%=>;E)LYf$cBD?k5>W&X(fjtvAXH$gM8r$+~GsF+b1ZPivtx>gD3re6yp)Pi|IR
zSO16c`28&lK0XB7B6ZAYn)0?EI+$pNR9L&@tX0QAjm&eeMi?i?-X-|4d|RU=@Tq<`
zlSlIKb-zsg=5M;(*9E;BsK1uKEOOgIYf`*1<y22Rsk_Dq%T{w^Rd=DSfp*2czTLt4
zTihq2yLVv!MoMZbN8Yz~HlcbC-mQSE1am@u4&k`f6!IP2?U^T6my0{HfgWzi3Cx3^
zZEhzuS%etf4q!!;`&luL!zx2XkH}>GVvqJ$KXSP^FV^TBT1gu0{)s#Jzt{eMI+|;u
zms;wf(*qO+h>PSY?lWASZUo!J!Xm;uZKboR^RFM!q!}K7r1G``RV13?b3Wi*3|jU<
zm`dptt08)5-rmtk3;?c`zC9bWc;ChA^1J=6RgvP6VEV65q!z3<W<ObOxHb><&G({t
z`fSC}klcKV&8?Fmc&_-u%k3Wv9*_S{jOiG?+osjy24(g&*{kUVr-GAR2+wC1Iw!A1
z@O~7r5(sb`c`^S|Wr%}?d}Cj>!f|4fD{)L%9(&?deeulCN4`r3uDDFNH5_1ul^^!6
z%7*$xn7o~wU0=OvJW;#AZO~z`#J=&&+Jg5p&6+Be!y3{45~X}V+6KXXL9m?Kc4#I5
zR=7eOk>&a)EBmik0P-)S-@iWory&_V1(ce=c;pf$p>fxio3Sb>`?y$e-#b{CLpBdn
z3GQ&J;MFWlyX+J28(IFCqn{*g0c$Zru^HpM9lN;&+9aI8!V0HFR#`5dMu60fOf7zZ
z?X^fL1=1V#B<-GMN?GqIE4jY<S-G2i<8^Aww}xPb=wT((4LBd6O95XU$6ENs+_!9_
zMxs}$=X~e^w*~qu5V7f`kaDl>bcXpk(bmxBfQ<Su$Hq{00o@_~LP{eEJCVQdQhD~4
zQO{x-GL0?c)zz4SIy;rFM0>K2etgGj`R?qYza=4?V3_A~^VENP(TC@aW_99N8okkR
zl7HyIP+eGRq_4X}32e`#eT_Uc?!-c%>g1j;*TU0d6$lo`+yOEOgg6uPh@<8B{qS*2
zxrxu0&b!W=@@Jf>Up#;7?aVK8>!*A-g=dI~z0+PpFM88^o$JXY6h6+{GrZwuu3zi*
zh~HA<KMvQQ!}0G1%cRX@k!rWK@G8D9RSd~x=eEw684@rADZh4Zx@Ur}nB3Km0(UBr
zX7WBo^kvoYxV>mf>=ET*2Q)EFcLYHB6X*P}+hU^&N>#Ntp%r@Ey(nsf7;nyS*IfB6
zWth0Jbym<@pHqw<`rvt5Kz^FBYk+K^S#|ET%lFbRO4N?bE_p@+N;G;e$XKcwdUs7{
z70#Z0T}`R}prq|@yMq3`uapf(PkEZ!Wk7%yHeP~?-EN)YlNzxjzmP&=JW4^ln9+xh
zU|6~p@T&Wi^8MQF02c6zgCcjSA~z6<+Cl~>Z`!(GuVRVc@NYG}n9D!yHTWe}n05ci
zS$pW4$GuCQkNM18(V%F+E+ty;{B5HHTdW)y045`aj<eZLqN40FZCwv|GHdm}|L2YM
zA7pa>?yLWaPq1MMDCOW7Bi3a5WUAK<RCS3pmesOZHV;bLDz6pE+(>8<EMt13m8pRc
z^M>%YH9x~afH?nlRScF&$U@WOO9DuoZ@4^c9jbo7p`QV+>fdKJ36~Z$DKh!i5|_SE
zpT?#$F>xYz^szZTboKT&JQ12&&z2G(bYK5+1|c|)c4q33?tE$!o$O_j0j4Fv!J{b=
zq<kC*ntf9t17}4Jh&*oQ-6L;sC3o18dESJn(RnvvTI^y_AgWvOheM`!lyvfxb3o(v
zE1t;tcv{uPC*{gtX>2&(UiV~wFQM1U>Yq*%Xdh_kkoIsmG?f^OH(h<%wcehvd<ZO)
z+O@~Zm6*?B4)0gorB|?s;J96!chu-c-RkWH%SE}qPZ9?hpzWuNN_G;R<KV=CNGgsy
zJV4n9$NP3s4K#@8;4tFHo98Qk%nRS1IRL*<G^J!<GlYUmWowcK8$%pZH(^@BnfX9p
zEnSoF-zU_6-bGCEzG?~-+$}7)$UpmsYidYisxx#(EF;3Fp=S~tyJx&#{2Z=MUr;@|
z2KRBfLt~VAG2R*yO~Vs(EAeNG;9%ZWVb%&`ga)f%NNDTn=uz{JzMk~-G<V0s8b?{i
z?pI>(8fgt$H>o{7+q0ny8RL}5C|_H!hO%M|z2LK~JlFdsk6+#6XQK!m*Vv-CsxahV
zmo;HGsgzeaw86FaGtAjvLv*WKjXN#(L1Udwf|(oku=b_mwMUkvmwRN(g(_!B^wc%M
zf6le>LitxKE)ONP6yi(9&r~*U<8R^5sS%q8CP}zN#`r$&L3aQVk2|9tcfwc2oIFjL
zbuKY$uuE6&Mpx6AC&JEp;9;+d+Yo9)j9?0&Ej#L$fkJmuiT@0?j@6v;P7AbiN^mPV
zyXagwU$%X}(=c}1FpW|5$h#K+Ssuo1%v{tO=yh8<20(K!RJ`1_ye*A5qv$h@tb!Gk
zZj#aHE0K}CAY<s6Y5KWX*c4EDHvX>&<==a$$iJk!{?kGOE~Y2&qe6xI$(Ii5&L^tl
zXN$75UsDcCsrcQLs$QKXAn;5i7u=Y(y$6i5$RuDDl+$nYwg!Id>ThKAePu@wf>=*;
zT-CLJ`_qA-G-zd0`aA|wwzUjrVEM=!i+bSSw<v>OLV%{sp++XPAxbGX{Ori6=YOPq
z(e-6J5Ymh?$gG&lXEyqctY%-jhtAn%P@`q|>N$t0A>2jGGrP&rI4p%6g`qMkLc6q<
zCLGJ9WAXEiLY6yw`1}56Z_Bzu6yv6V6#T%gR}E{)dbh^>gNN+jIimtOxIF&pJ1J@~
zyZ+c!FXVobZx|V5^VIh>mG#@36d~L}e9dyiZenb6{}wOaHrhn#^(>^QC(E?rc3UAu
z*JOFA)tPC&qfm!~S-bs#_Vf1w<sfX6Gw%d>f3zGC5{wC&gt?2APQ-@gt8c4E)ovKA
zVc*e=Jw;4BJ6xGXTWd8`L<ud_o;1%)r=d3oqOTcy#w;!4sB#?Z&Yv>mN?7D(UoiW7
zboZa!vkm>no|Cy~vPd_RW+%~eQ<zH<hQmH$WW{R8sH@?Z$fNZLmXO=Ps~eQ@kNDp`
zTcp?<=r+)Z$kHfsy!E6?Lq=@Y^pkz13xe%dzgKsp+~wzqmtO8qZuma-caz(0qx)fC
z5a>!I;{D9c+MV1ZBo@TJ-g2^ZHa)3*_1VWHe%Ap8IDzMTWiQG$XCC3HZbUsefr`!_
ztH@cTH-xVq^d<Nsvj`e$)dTLPmOyz;jz^|3N~MiE^5pUG^yxW=YgoKZg09V0Ws<7>
zf_%)_R{Mi<t_^=@(K2wA8S=HtP3V^Fopl>*M0|l1trZ#FxiMiZaOQR^dgDi`y~T1V
zMtJCF!slT#A<ue7K?@*z%I3EK7qJU`4)nLB{wOX|-?gXRLS;F}*==TA%y)W0p~6Xt
z(GXX|WOPW`xxA#xpLZX3J?MpB-z4)|syT^0N!J+MJH4e<Iat}?US3-IUdhS%&73}4
zQLF>xiC6ElUfr16+b&j7Qtw}mQ>s;8T>fW}=|4j2|22N_zX-?vi-oA40l!9FOj9yb
zb}rayS<a7G-S2;DRpw9{V5(Dd-pKL#&}c;d6+h`Q*W8ti?k0&6qipNAl1<7UbV=}I
zy-<<1&~^=8EcqhjWA`(<p%T_?P0h$-zO|;9uTzA?X%CEnkpIIbl1xA!Em(A%KyeDD
zAmNTr+Toup%<!AJLK3jTwU>F4Nub5c3%gG*_BLOWOL`umpV^TsE(#UtKL|*l{8*(p
z_~HbyM)gSWf~M!@$COlrQ0H;DA$4l1wu@3t`2U#H$~T&!17Q=ef>~Y|)iu>EC5t6I
z8+L5*tu$)1v19SbfWj<JI3u%|R;GBZkM3c)SFW<$#m4Gm)&Wt@2M+@JM5b8Y-anVf
zCf5wVUvZ0AOx&s)$cpHk^^1iTd?y8`Rot}}FS}+qSWmHgUD|c6a{5O7;(CKj#Mqgh
zmW|#SDU?UL!=levyWEeE`Kw`>X|vDLE`I>sS5_3rr@5e-$BwwR+}me&iN7&4>Q0TG
zRY@KYVf+yV{t7q5)_zuUY$1hSd``e_xmQ;QYxICZ!#Q6)F^>95<*!C&ywZ97zW5Cr
zn}iJOe3KTx+?h5%Ti2_mGY`KlyrkeSsygp9b)JW}(M#*G>krlFFE>8%Q2yP0{vY4d
z#9W>%t?91CXeEYYA@a*GKcAhQ%8T<?FYsF1#{B?ju%*P1UCDNvoR3Bt(H<oHs)CkW
ztjGRycF7yfErp)rH^o_yQ`ZN`z+ohrh>;VKjWp-!b~O-vX0O@lu;8t(pSwsQAg`;h
zb?73GMF_Vh#MT<1O5+P}#vQzWOkaAgm@&6StRCu68@6lxohp?STDD1bM5j*QUHW`J
zdc_(Fqgx4p18=zI>3JOdw!_25=ccB;8<VTrjjuK~a_1SBt)r~D&xaazxLT)yLYdpH
ze_H(505}3uXJo1GqGSj|DmY;TPjO*aU4hYf25WKa@T3%aT{eUe^X7bcQdkYSc`-U0
zL93{^a4fW&lbl0n!7umVEG#+!xBhu{PyhL;iK)2LVRcVi2mg-gep~rFE%H~Gx^}m{
z8;vRsnl%zyP}axkFMZs)d?E4f5$1GCRkYQfnOK}GnLRgb@_Ei8vEEiPk)z}O1G@Ub
z)rFiNqF=SIy<uk#)ddIxVORdzKJ_z(_oP&_EcQp5713v>nDLUI#M1Aq9QtCbT!l6^
zgUL?om`}q7{3=-A2)2bAb8`X=aZQiKN*_G8quTJ76l-=Q9^t=p-l-}J(-AOu1F1ay
z;&&g_Z`S`J)A_?C&p=V(++FNW+yg(TuKwzg>&ewEu#k_fDlR9|He=<06q#Cp2uo^2
zoIFv*RQ61tvhdyi)R$yz)5g^>yDHW{^iYLO1ntLOvd0tJB5*Hb8@7l_I+~|QQn_9T
zi{AY)A^A_9%)bkJ;Qz1rbb~V%!{1*E#6n8!7$Kj;2zyP=--Q%@{0zihR(dG=38LLn
z#x&QG;Jsv7D3QhxtSTptM=v5jf#SVEZHvjt$)|Dy?*{_R;!za~D5Z=TmGJF(nY1@5
zCFtaV#Po%_`4h#md#fm)(3g^{tAx}E#1e+MDCipD#MYNyAHA#E*uqGput+zGRQV3?
zv}pRe{=rd3@awEB5oIq71*i}L0l?QPYT>h7K}~H<{cC{;`&d68Jz$N0iy7X!Qab)-
zGfB-%ldkyH`4>fY@(j0DXnR+6|B0hCSHbuF4Uj^=VjIA^z_XVQQWDP0y|jnC&rg&b
z<`j4>E%cRa%<|z^J@^MQhSL7^<)Gsl%ET%ePR6p;aT2Iy8O%>O=}nKT?`}57)1=^6
zMWv2=V`N~Aai^PEZ(|fUylcuZ5`?|l{WnoeKHDd(rfQRnQJo!gOLVN8p_69<kV~k0
zE3=M6oFjWO!_Ae6&jl)e?B%On-zoxK>h+Rfuui-dEQ?LoN9df1V<-(+*nUPso>A;;
z<E6Q0io}Ge3IHPw@S0r-DIBAwbkOShUIZisjS&yY-CiI0ASpH!&SDG(k<N^>ecCk*
zwQp|;imH}$N=yf7N-tVQvt^fi-=^PHHFWVwT&^lN3)J)JfW{V>D)QNIGq$<hBC{XX
z(?(nyIoLa2=_8q`xJ{+8p`}PUKJ+oNgX{F251Ke1+|xR%I=Z<SlQ!FD<nkiq!^54{
zZo1}W|Iw2>)gQN?&%PmD9?v9ZG8pEyLR&Th^iwskTmQ-m`bYjQK+ObS>;pN<8CBt?
z=@OFEvlM)6pLr#z#sV!*S4w|AI8Dn*RdS2nq_V%AJ;JQW61HED6=~?%BYg$h(}(>a
z@)T-4-(4-HCG|PMDKcq}0GxprJF!$)99e0i-hLUZ4J(Z2d3CK@?I6!GDepw7cy9O7
z-l5as5DLA)W@GgAxfUeyWNj6|NR6dzHl8k-gS)jA_l>dp9H`2ru7NbJwuI*MI-z9@
z69-;)krwG~Y$9L%b8BSi544axX{IBv*-K@^W0I})5<#es;I!kC<l<?uQM{w{+nS6J
zoZ_=Vmyj<XF6ih^_<HtoL2{*MhdBL9NKoE!{K2aYlr0B{GmBH8y&XThoxB1iv~LUg
z1fWEgMooSQ1Q@C$&C1@x-oEthb_|zyQnJfjElU`6@0&?;36aiExVr_*!$CW!9qBRK
zP<!<C`0r15DeBLvOih1;_llcam<5_DQFJAS3~ASef4w!x)z;2LHT8U##Nbu&s7s9r
zgxo$YX4_Fh(|cCFSH_C+V)PGnSA1Wkp8GCi-9MkewhWfGYgQgu8rk>pf707Qwe5WS
z>=!9?q;y;<i|eUensF8<vyf*4D}s%g#0qDJ(vBPXpz!Ox_snP7ohqjst|kWwI9a~X
z8fc|BCo_aayUC|si~8j~BGHW?tsCi86=}i>$i&=KFVihHA%Y_yKpyXuX;=Myws*pQ
z9w$ouyD8s-2j5TXN$}B3Y#6e)4AL{ElyArW8GQcXi0M)@F_SluX=lY*jO`%>S0#OC
z%RH+SXdOF^P4i`ARGxHuo)bjB$AUy1`tn2QUAmqgIhu|(juF<E1p@ACz4|#c$Gb**
z4U%mO(`NMxVXIW)4^)>uHuH8_;b@cX!yGo!zDSB18@}{PK~~V$85vNry1$$#MkPox
zw4)up(Rbm)wXbWwO+!UIKK2a_60@C|xwCFbqmCEV7#772n-V7iSw#`oc@!H80EEbW
zpyVZ=>9g?Y{1^<WINnbhwG8yS1lIOMmy4UbbS-vmmTbZ{N3p%$TTahu!o5FA-(|W<
z@6lC;y@j~`lJ~Mz;^pzsAL-F@FYv-ughZ@{tf@&osw(LR7OP>OeNVYu#pPy3<mE5g
z52!6L94YXMnT%w)oIs9~bmN2da<L?#i_9ONa;lXy^;P}Y>+Qx<#h$Yoo6{&WctxJ`
zS5*J6J>37U%JzpJte^2=G&I+YwtD=jl4G?*gpu5h+T5sHi<O+r<|?|6&pssH)O0og
z!dz-z#(S3*A9~wjB^N`2u}gI$V)CrP*gO22{Nbi%HBb!ao7S?mHG%1no*YD_?Hgz7
z-T#lZw+@S{?fQmM6fgi0r9%NhrMpX{yQNFIq+^&FR0O4lMsnyOq`SMjn~@r%V_;xl
z;QHpeyPo&C?(cp7oC9XhvG=*pwbr@TFE)NPs+S!*oJUSbT;GhL;e)1L$kC0JYUYq)
zgJI@m$W45fnnUir1tUdODXcfIHXPV9DUd=|=l1sS_!`0so7oX%VF`(HKDs8mG8$-c
z8Ee|gWiHAzeehMlV2#hf0@TDLgHpJHI9H|*e|q;q>&dyHxQn=+gqY2Z)uFZV7gm#s
zPj-`W-mX!(j+6K1$*ccb|JDZFF$~dIl}(`Dl4P_q^_zgJ&J=$%zgIEEh@<Xuoh$%b
zA?oFvbg&K9Cnq+_?ETT(9t9eWCJu9T5<5qeAnXn@pi|{_e4(4T)S|z7_mqP6etMU_
z5G`Qz80&dgeOw~DMkKCowaN4Vzog@ax@GW$Gu;y`VK?rOY~}AEciTaLsBO@h9Xk@h
zFRXQIHK~M7*>43+b&J=0HX&4TVV>`nH_bo@Esx-OU3_*JH@~a6NYW6oY^;&!5SwBm
zak**q@zaVT?nKqkoSCG1$u8YQuWqfFC4f{W#g5StKL$68MfDo%9LLW6KP@ly|H8?O
zVEdE<8pCy2OWHJn(#qSZcaoL`gzSN0_ao$Oz3B*ctZ%u^>B8$gFfK!wE3_kmv%d(!
zwj1Tx@8;vh7rb&X{!s2-#!vfWUiXJoDWT492!xXsXyX$r0#jMuqkRIDi}xh$_--cF
zhCee)P~C19(<3}5nAY9_4`J<(K)(ZgK+^%8Z5>__oa#wYph06}DO%8{E?a|zq_<Zh
z9$V(XRV1gir#ya@&{4Wu+)ZC!`6#-Z;=UiTLCP0#pt}ZL^P9!R$fSt9uk>+iCGYFO
zN2<|@_8(62@u$#JE#7;&uKUFIsn-7en1`56b3RQ1Z!z#wU^+$Qvr0-`B?|a@zCKg-
z-87%tm+ra<M>@Z^!c=-J-R8VzZ<Y3bTPZ(pH;9M)$-ocqk=L&Rxq&?VNHtDOvo|?8
zmIz(e^@4>yw?Sx|3%eN_Dk+~j$luR5%L!jbZMoQw;D+LV9fa4KZbhOb=Q+l^OM{Dq
zj@BQDt*JAJ(A5rOIRzuUzZw!^H;ft^e+@lyOx*X$>*@4(6v1#teAz94qKx0`5tdQx
zku?w%8NFcGEw|l&-P?+DTYeNezi|v1SU&?}r9QM?&HX4XaQvEaGk$#q%22Zx<#m~k
z7I!@W5Zj4^2BmtV!X=mS%&^EcO~hQdKXEL3&JXNL<eV{SkG<q>gE{XgCj%Z1qe?Xh
zf?pm2pcQFmm<Nrlp?>@^+uM+yi?Cmu15mc%P043|K5rYsI{{DY)32#g6C4xmlc+)p
zJ=RZce#5Eo%vR6q!IuI}y5jD0+DDGfZjRFDM0W%P;tn<zjqeb{jprK##Icf!+ooFM
zC1=B?KV|Ig8ecM|R*)R^QivNg0<U?7d~;)rxyh6x@~1lQsN~t<cXG>P^-RFxWYNhh
zBfM9$xN%g#@BBD=fsNWOd(*#KZS(5910-`V&YPYDxXcf?tN@&E5O5Da+d+T%xGG0g
za@iU(ly}FEUcVPnA4d#~P-zAAmv?b+JSbsou~<aXm2zHi3PtxVDbFka3bD_CmhgN3
zaL~{z<id5>33t{S*48c?=eugw*Q!@mrhYk8D@bJbR1VJD(ni?d-@%jGC9hYoNs;m1
z55GO#5h<DU8;(c-+&TN#nB>%*Zch_|DusB^^w5U$KyXg_XNy@-HW8FAm_|$VM*I-!
zP;CIvmkc2?!Grt3=1iqd$YRlc84(iG3Ci_4s>KdJGWaH5@{3-_DMb~Tgw!)3FN-xt
z8F^5^wE41$HHys90ywy85(!7*V`Zg6&=G8tJA_2v#4+Af)`Oh<wUs<<ma>sW2OFf?
z>Cy`#?M2i3uOntT%skHI&An9s<Q2USg({AgzRW&pzJf&g`#>d`0&+J9$<{TdTe%F*
z@V-PQ<rXLZsO5?LsG*`x*B#krGi$VWLr5c(n~;00J&HgA!}fbBtGzV4!&Ga{-pvJA
z3Lf|iV%EYh<B~a380u_+%+!q*d6kcKRJ3G16q&}+B|Y=KLJZEo+BmYNOm74wVwHD3
z1+#ID2KCxUb3EUyCBE8%f=966uZ`(h6t%s6BN2RC13M|M<l&tfb%{K@A-M9kA>IXr
ztV}Oy2OJg-u0h@NURT9%>$SmF-2Rur>K_7J{52br$jsKt1m0&l&zEq7XxEyab@@Co
zxF66i=C5DS_Pn#-w=JGL<;EIhZ3j=J5^ic{*wU-lr{ajZM<`l=6VtB#)Kn@4B;%2M
zGr9lL&W%!eM=S)~^VOfz7MMPT8u5V8jXmvVZ)RM!yly{XlSD?DrIcx#)P15nef8pX
zA&SP?+u?~~9A5r*V{Gcz{rwO1M@#+>=z$WslID$!EEjCn23dlFteZX^*6LV9BO93e
zbaW`<;f{B7in!8v0=tz8Q~4(?;>X3({l>R-Fzrh;y8zBAtC9{T;Yh1v^>~2H-i=G|
zRI0Wh{i^tSskYe@<Oo)O0dttEn7gZY_CT+qCGwM_pJckgv$2a%4a62vo-Y%DpNUNf
z8I1l;Z(};#aV<?-4x7YnlNeenQmf-TpHxppgU4Ogs4umdF@`B)$)6i$OFX}ytj+f1
zj;>$PkqZ#2zkk0@4d*aAKX0kPG-4*lTDjQugmO(JO~0@Lvijt?)k?869B<A+w<{@Z
zJ1aB&`#80Dh>drN_`91Zgy7=36nR0YRvNz5cfEb-ih{rNu(0jA!X^C}83a9ty{X;A
zK^4$u&Uk*gfQV=);)){#WuW#mJe{Vp%Sq@mjg2=ncD30|0SVqvPg%oyMkE6TR+F3#
z@BfCAy&^N!$rBMDxFZ6oY7w5WN)UGukvxU$`igz$^_KWx36vz(2P2D8b`PI}EbTzx
z$%qjwB2|CNc?uLWzG1P`u`EoCc;nA?Y3CuEKcRf*e0O@UQL>7A_e<}Z;Nl+HDUY0`
z8@{#Y%$7??FH=QCNw<<g(Mx9*EiGYOXTcZ87ew=VE~=Lv23Ci}gNFm~A*0d3uwo;v
z$*R6;>XeJ@>Mh=<3RA*XC|QRt=el2jtpsmL2kUVqsh-^-P}Vi;zJBHSe!dLN$%hY*
z{Y;kqLNdO#VvE<UXJ?D{9P5wl5;%NE9?4kSQ*%AkfQA|nzM75*AkXXltiQ-}C-iH}
z;T+P6)B5Up?lae98MmE!AFv2F;*u0OsaAb5yW!lMxQF{dlsj);Mq5jZ`s;VHb1}j5
zk+9nGaPf2t`sb*SFDQDxYLmu?6{44r5hhT)I=bg2kaLh?14immV4`S7^%Qc$-w)so
zmwC(CbiIp}c}g;K?8C)yUqR)z-X8tasPwOsEvz8lq;xe>60>2Gn_(u}?OeFS)y`MW
zMf9=wQLvT+F5%bnMX^P*ykO8QS2RNYD(d>yyh#7A=J;Tzfc3}V`NWA8?6@M;<pe*G
zQ|snv86EoWofy~7!@Ro|CPSKc2xqf(0Jge0C?C9g-;n5=+F?=o#g)mKb)kzOOF)q8
zmOAjQ?%RkbuU{X(rN+U@y^H6XrAU)6rjo0*bZ~)%s`g8`p6DZ9VtP)1;Yh=!k=k$K
zRiOG$o3TOLY?iR_c;+1KHF4zEeG@vE@()bUEvwaK6EiE6S&gT7<~+E+p<a{Pi%h8Q
ziv~^2?zruy?ItX#>1vA^3+RAa)P?qQNYv=9KIAbqmXpu>BpLKWvCBIX=Ov0ZX+Fs-
z89Id65OH4KkY9q@H)l_vTtZH$Nb455FK-EeGMolRO^VM2rOjwZ;c4Bj>X8a#iUI8i
zLe_yx)tTxa%f-17S<}lcliXJ?!>&|%&GFR9URg&4;q6nNJ(^q>=Aptp9zW`-E%s|f
zPL7aWdZ*#aSdh|>qwanUp12>WPySF~a{^YMRdPj_O^1~Ph}^8--8yd~%GOM&;r-BQ
zF6@4Kes0FHK&Nn`7Q10WM98S3u2~avdEL!am;9+@3avrZ>4Z3=+)CCnU6;uSPM~2-
z;VErZDHz<U$iq|n$L51BZy@|F-RX<{>x4vGH*o&4ytTDmuyRVl_t$dSjoke>wq;ha
zOcr#noN!m^ha`t+9g$XMRVVO-eVB-Rai_{8-h}ZW7WErP^f|&?^ksqQtcWv543!<F
zI#hr3O1r8875Q$pvoEdQ6?yASeG|M{14RR~zrw$)G=oCDfC@x8F3&?VNT}#@Be%+^
z*!4;bVDeELXV;1IAI2?zZZQs>pF7(W^>34Q(sn)W6!9+``VmvGP}mXVy#E~*FZ#|p
zDk@F{E88w27MABnJnHRFpO{n6wQSJtLz2`fqRcmuuVemX>@Ln@MLINswlOO*MVExG
zu~im8zL*41mU*>fca(gv5aKZ>R*U5z^ds1{(5_AACAm#BpO+REh3o5+p%s(-PeE1*
z%U?X)@=%t3HZ1w^P@f%67HnepBtSzkB2I>FE(hyNfs-w-9!Q_u#BKtaXJyCPANQ(O
z7)rYYo-zLz>dC1j)lwYkB%|?t#vm-A`D12t#wNk3qF!Ns^OF8Cwptaya&Yq+%Onq8
zpa1#|N2zu@RlSm=Sm&@FC3(T9f8zb8tQ;Z5x;iV`LSlW)B^2+j=*5baqWYIP%fEaC
z{~@&6U%xbj)!H*lPPfA}Bo3g`4IJ&D+T^?|iehg}mG6ChjkAd3mz>_pwt1bkZ=6g=
zL{xhz7WON>1Hca3&rCK9<BlN8_5gPI0Mgm9dmG)yDcN%w{OzpWT%vdCS@6Ow^{<5r
zKY35FYAC+D03*YPWogah*L-I&dk`A{bGZX+xJM-qcy10LxIv7lDc@o&^m81Vec(~F
zJ^rEx3TW5d3>3UaCaa56!EF}S?6ahE08HCA*!kF<=s|nf`V()Ib$_<vLX@vlB2`a#
zjvH?Ix|S*J{9L;atL?HLgG6E_fP5@yl1*}y@K%9F-=v>;9<~nhwM@!D^a)P<Ar~|o
z6pex$YE5PzfDvw+a87$VCFr2LK~F$4Y`a2+Jtw8;?N@^^!EcfzuC&PN;20s#-bYI~
zXeKW|q$6I|;q&;FrJF;Jt$s6PXqeZ{OQayag$>_acSq<kkAL=Lez5>eL5<r=9}!Iw
zBZi5vdFHYd^W-g<6-E=0eDZ|zRAP_S1S4YWFA!i@TUDwve!A?VUN^}Ppr|I4*nczZ
z$TO|p`js)C@q-Uu{Y!<mIg7+6?nIO>57t_T)cc2B`}8H(Twg9Nnb-@&_-DQQX4FXK
z^WvovF@hF<fp%0jcb~wPhSKjwG@ZQaip-yT&2ovj5}`c#8xEF*EY5zG>6qcy;aN3v
zkHpYn@3ySF|J^9U7^N{^K?fVU+R7K<$LnO0bS{hKSN_6*!Rke=SGe2h$`j4JYG-8d
z=QDL_^+mpaJ`);Z$+1M;TH-#^lVbh3OWRb#aXy#8iDTdQw8S>rQ(QX)OYh4z6JFus
zg<sm)d<#0idrX`r_7MRcAatPT@pCxwnP7~mF>Ep?4}u2Cx>w~AD@AuVH`vO5)`aNN
zQSSLio(IjKyj=zdvA5u}f2jzh$9jO(=b=&ao>(r6x*Af9;2}z^fM!+h#Axc^RpYB=
zU=O-r);pjq<=5$T?Bb)D`z+HJC&adF<o?%`rH`9K1U;WyYZK<OPYX_*-PggED$0|k
z^TMVko!-QU*kU0VyhZvmbbZLwG19JU9Lq&%Z)2^>ab2Hv-5(*Ir$uh?8xc=j>0_R>
z`oP+(%Ga>`L!7H2Ir6;>Q@FR!7RWUO=N3!z1~yUN$jt;?ZxmFC6TP#Xx;sVwGLf)D
z_|E%j<v^vh9f93il_}JyZ5k-G&B^=fhFEnk(P?cj0t^wF%aQ=!4#Q-hNMxeH8)>3a
zQ!Zq?8V1aD%_Oxivtw-8I~aV{?n)%5qd9uUXvtEo5)h;7MP}9Fm2}gy>Y5Z|eE4m*
zHqOKrnvnl#EMf-rkH*C^|0wcd+l>}V7YjYC$V23)NFR8%f`QX*6Z8DsM2K;24IfE-
z&BxhVvqYlNOytizE0eM+_AI!A$}^LeYxyM&i>({h;*WY>VP(PaV+;0vAL0<nL}?LF
zA0#?76bFaEOdJ;CI}GhnBvrM79KWCP6j{tgVkcQ5S(pN87LYcPVzx{p?MJprm_Y<|
zq*ZWX+far0jD(c~lBXBlPQGt!%r!@)QNAbf6u$2z#JxVY&LgQ0KW_mROl|HPchU&b
z3Ok=0?O`SAo^6{-jccowYq|kEdQ|nbS-THj+)k6UCd+w^+MSB=8&=E0qSdqjrXyoA
zvf*#Ue#4=&{>4xqxn~Hg!D&jg_-ldW{d!ss$2DfstD^vT1GC6|x9lMDWx!x=Ue3Cq
zE+$ix++B^LD~TYo*pH`|MrZ^0{3sDYjNoWSmliLgT?h4M=`+(c8eC#B?z!X`LiL=t
ztMA=c#aTLR@oaFW;VWMstX=Q_*{ED~f=ZD7{AdBSc`0=TSH01_(V0iz?pj(VI27ym
z4>U6^V2kGHod~WHa}eaa+lU&Ls5N5Sa#2^G7muZ7a)M}XUDTEaE+g+QyW6G1>e__S
zuS7Kvm}~4S7f5e{*&ExJm_6XDyA3(nvZ@_T@cRv?N>DsN-b-S0j|JPxV8d*fWf%i%
zMy0ogj|NtjbiY3Hd4fxQqVW<g_}P#A<P9++dP@)KTvKsQR%_2=fK}Y5zgzcV(^Sp5
z?*)!okSBhL9UpB7El0)%zSYGcz;prC%VPhFdmBcq<1l>gbN?w4P_LJ_2(Y=?jq=T=
zep3ARqs6~BlK#?b1^+=1>7UUA9dKmgOFXP%0@0qct6qACLIjv*RlKA;mheE_EE83F
zK|1@TfbPRp&fqibLkT{yjcdxy{RJ|f<nU6y<``gA_PzMdj_&!WTv@gu?U0rLTP(2w
zXAyD`3iU?ni)_lDX=ne2BW03VI-|_&M<Dk$#yc9G&<2_71#eM_75^|rhv_1xmm3YX
zSAu570$%9(xiAr7UV{cc><E-BSJKa?amd6NCOHvrV|+yEFBnmg1ly}wAJ^hP`RyCG
zfKDMd?y|BlL}Un1h<R>10n$h1Ogq#Ryh3dwS(W|SAW}XXid8cAyJ${Ir13kZuM)q)
z+UJaL`MLH98aiolZqxG@85l6s+<b)1&~LUKqsxX5s|?Fw6VaqQ>2SN&@}Jkid*D&;
zp!f3G<oQ?Ut2-ixM+#U|mVhFTu+0Z>u4T?#!DL&#DlNgw>QbRG=vi7SrXc=`H|xla
z29~<J!9I_b31_L6gBf#mU4DqTM&hKWz4U2G9Z5pw6(|8L3uSLT$(2{4Q55SCNEGac
zr@*5JcD)b~rumOAe<bI9ydTO%oy4BlTdx*^@|ipEq|L_g`q3@yk;ZI&b~(PzRX%Y<
z!XVR4*;}m5Arw_<?l#-=&(oSOS?Qzuy+dr>{ExHC0q%XBDXs|U9z9^!{}kWd-zJI<
zVj@?pPxkkMR^^NW>rS}x%P~b6(8pZW_=UsSg#-(GkfNle(I|Q~_eu1<#Ve^fE1@2M
zf&?385|hz#;@pk|$I^kvA1SdU6Da#%dKBbGQ_#tYobNQF;3BkiW$#bbldizpU8qtk
zbtN$sqmM&i!8Nr*JxnHM<MVL2^yVm!N<xcugzv&K)oZi6PZultr5u`xb&n{LZ$^)<
zH8#&hO?&n;i|EK?b`NiS`fynHfy8G1+Wh+J3YLiuu<Py}ar-lSf3GWi*1@uxeF1cq
zSm!Dn-IXPu955!BImuZ11*oY$o61r_4}X9Dr(E;2wfh73-F5qUiO*=rKLYsvCB7qP
zbsVt8rPf>ZM?}p|f^*;xfk06pdTTyg2sI};L4P1~aOn#@rStg>huI&j(kgv^$vb98
z2q&OPTr26;K&n6F9^|X|p(*tR5#Oh)tEn~AYmT#0_i-$Mggt~LfDv7Q{#XFA_6sIv
z^|N?UKb}$d&hyHyVP%Q5ciQ#D|G1=07gDR5Js!a(W^jf;V`c8WQ?KN?x<7AkUvqwc
zY7Er?>4S_6Zp`fRV_q9Op6`_YFe_P)7YJqWAqas%wC4z!EA`nXS|IxKz!X|KksHq5
zB>xDtvr9EgkBxm$w6*>}Bc^nASl5m3(0xV9n5-<!Ei9R?s3gqPL|4_4)@NlsE8>>G
zc^D^8*B(?s5c$f9p5Vs%#%c$iOtoB_&{Tb=_boXqU78g|PHn8G!TW9LWt~&%n%{72
z^TzE~VILFJfC1?bsv6aRnTZ{}12<qUdTgWy=^LQ&l}SzRG$7e8XSJGfNT_1X-Z1C-
z-oGE)$gdtqWnxo>Nb~%4MjJiPJ-&YC$~b!J^?Z*q=)fejK;w*-h-vS0GY$rWnfP6_
zEH!Rof8j^@PQyc;U%t^Uh>+{wgSCB!fv62*E~HLkdk$wErR7dP486*t&!qfC94z|3
z)c=32?EgVp@DJdx^gAVyiC)()Hlq9VcV?#-!PP_`Ky##P76)h81HTfs*tr)dRE=}k
z1cr+j4g7`^4Nc&*$l2vZ+lV$c7Adg2PXGjmr1a!|{o3CZnjWO#P1!QxO&0!PgW_6u
z1+?oMIfh!S9wnnE%ewbe6T2q}uS?y77g&8WYd<{=Ub%bkiNfu|tkBo_)Hrx;Hb)P{
z3eyGNruA1GxsI9*q{$$0)h1m}?}YCzaC=40FI$m68qkmN50`qFD{Z(x%O~DCuQemb
z8(81FdMO0}TLNK__lP(Tu#ZS3W}z8%Cml$47i;nY9%>bJY_LZzEWfk6)NxyE9$p%+
zN)Iw3$kefPkk@0xHqwcp<^2As<CwO52p4!Mv3eF@HgA%W_kC}N7y2Oz-gF!Zb>$RX
zMo|H4l58FG=8STyzr-ot&8@Nwqp`bP7<qL|<sdWMD%@Nczq@iX!9Gc0o_WA3fxq#o
zfgH{x_~Dxe(vH)1qOK9l4QBzJ=yvpL{)Bp@WSnz6f3QRzEaw$LBK<Iv)Yv_u?hv_M
zRKxx$ZFc)FC`<f)Nf#x9yCwA*5}oiIt&Lt52z72M+VZiP%w~8%Xek9$HWek<!uM8N
zYABV_-Ht8ZTj4a7>>a8ziC<j7Kk%RpVZ^`#vGcOfwR`K4cGiknNiv<U9}VnuWX45&
zeKwQL_XO4UxnD2)w$Wdj1$nn%*f<{$t=kVI5{M@c7m4#CioD-Yb_WaM{yb%ch@>Wt
z{0)b{^#uoCQXbMQ+T6{alsasgY6+?}A2&NylZTO&=vxNcuFm@`sEs|oEv(KVe}&uQ
zU237k0#Oq@IJoFLNXHgFfL>qcfaWcOga?Iedj3}$@+{Uyp+Ia&&6#;9Q(tN}pDOs0
zu$9i~inVr4#p3(8C~+Hcc2l>HqwVIf!wJGVbY`Vv%^=T8R_EPZ0!!O1!!5~z#5+#S
zGm&_H>l6oy^nf)mx~o#1AN`#Un*AvD<h$*IJ-?<(aRTB>Y>w0TX8(Z%vwn`hk{Nd@
zF0uvQxB$ms{zqUc7PbJAMd#nRFZ&(pP8Yu)*Vc~JuJT-2Q$HVKr+@V1Syn;;A8xOU
zHhm?M3YpJyx_okS-Vz<Vs3O_-S(<>3gO0Ri=>RQJjPnuuI_w0(hC}+j<epUbJ1QN9
zwg_U7m}!yJN<ZpB{k!{`UH+SU%q>kH3(nr>ooY!ih(JTiORg%bbi@>~koc8-j~KIr
zE^jdmrj}Y0>94<0y6J$HX!p8y!3h{GkUx3@Ki<L({o1y-CjmDEMz7R0XO;*<2rlIp
z_8Unn<Ps#9x>ZhS;r7(cm+A9G8>bwZr91690){640IDhqZKx{@6Je;VCkVY~!(xta
zm>Tf;v9I4rfH3y$&6P|$yK|BlpR_p^<Mt#*uG;Y`-k*gCHhCvNg2iLZRxxYrg5;RT
z85{|@w+Jj?cWR<B{)q9obx0p)7Kgf#FH_am`DTlh#aQh=c9PAic6|8u@oUFpuH8ka
z>D_7=_hRD8DJ^84QI-C&Wd(iZezvP?<|VJ0+Nsm;T@aWYey-!x&mwt0D{={ylj(zI
zM?_fj{RuFaL14{7Q3mg`+hMI=OL}XadeR{@6&Gp7d%(>6-k_hP4EV5hZ~Y`S(tk;w
z|MN#IyY#R2-G3;WnjsTy8lW+<@>ipP+CK-=-*EiGmcTOmW=G67hnk0wtF5_o9kHg;
z&6&luNoTcX!EYYblVBfuj}7t68{XK<-oy98fM6`>nO(f>mh$`3lE+Ocf7zS4vlo_6
zoQ~9oCHs|$1;f%@rF14S!@a3t746;wlFQJ6tqj)-jxMJv+6*@;C<}C7tvfh-nlSeQ
z3Ht&v0om`u6Ov>7%!VH=DQ9-R3SH|k2Li}he1fYBlc#d+m+f2G^J=AO%}R-S57CLx
zy_T8&ObI%Z^`leF#~0@uDfx2_GXf2fDV~Wng3;fcORV_yWyZo0Fj7)^+ooP_p>Me6
zc@)&Ne`{5lbv`blbZmuxjU}ZHm_@_T<o2c4wnKE9p`wJgYY9kY`iJBys>+=2qt5qw
ziv?Mnv-TP92cdy*n?u2c<shC|F`4NpAB^JsCNvS8%!_v1m5{--*CuZb^8QF5XLT>$
znP>e>-OF&D7aH`bS$^-r#>~#!iT_cZD|oMEInCA5`$m<{^kHj<+?Bs0NQ#afuH#4A
z2U0pQ$(cZls)rKrN0KTB#5A|35&ZB>kayR>JsO*AZE>eE9qG=Z5n7jD$2J{AtFJR>
zyxYUic-Kg%op9g-&v?hk9XyYZhSs~}-MpBnH;0Y>kEyv}_SbpeS(VrWWGhk-^CAx%
za{BEPI_zCgVzlC>z0;Y@Gln>Cegc423uX1*GI@jqWB*nopc*fh9_KO_1q_}e-Voe$
zRGPU7K;B_0c!6oPeQB=jDab)6AXz4QUAj4xJ~8{?Xtlq6k7xj^mq##obPb>%yWF@<
zv=%@7s1a~$MYrsq4`0q|D?$_Ze4dH?Y*d%;g{MPPUU^|XG|(<<W!V&%_JZdRnKD-9
zi33H2iyefp5)z)YiJ7G<s_UYFn%;AYOQht2q%tQa29smPDUF{J(CcdAzj<$xZ6otC
zl?{i;{$|g@6boTX_G15@mRZab9WIgH8tGzd;mzG9W(+sDl8}QcUeiBMu7&*z{rvaM
z{lD+B{{~*Jk5w>1CaQpy(Omkgm$|FA(>cjcM@ScM?e-o>W};dzNL|DJyd^;zUJ^Pd
zSbmD5auwsv+Y)bo1Kh}`OZ4>nw<Z6)DeI%wM4uX+>QfuJ{_6f~wyX$ofTZ6RG*yiX
zaAW9b3PTE>6e%OGztu}6m|E4mVXJ;7*@Wx%WNN2{ws#<7>(^ODo85`$a`8O(j9kwI
zedG~6mml>g$O;2R-knVh=yv3uxKlNCnzx)~H34w<=HIci>x2g^?eHDV^oCLoHg5tX
zt9Vd)+7K3w{g$H#2gQsA6KDGpaGeQGtCsQxjj<(pLz17;I0dxrIFab#_aA#4jL2Ks
z(<!riv76I4v6o?SVsYd3T_16-iHPMs-=A0xkd)7MaE#ywbAK8FyyZ|6WVaqpPxX_d
zZd|L4WA$P10IRyVVM{@7j<>0OO=Q#()oYX25n10+8S_T@+mpPfRP***wz1j!k$sUB
zV&?w6i>SaO&VkXPYvq%3-Pi$BXHxkrrk+;}-^pUt5*p)afjs^nZ^{l$N-E`PIw6!5
z$m{5Z%JDvn!7BCnle_14c-y_62<lbjc9G`$vP67lWxfB2VD1xdauk;+5>WSj=-wS0
zGF2VRj78(wUc#44Mqbo_({=^slz--Q{f_DqY<@=VCHKl`*c)D|Lf(v(K4{1$j(I1a
zF17{pqnB!$IZP#&vYOoM&&D>K#2C%$Vt?Ke20_)_`=o@#GmC>`@Z1q1KG&xgi&&1+
zz$FxMo_6Tf%9WU?8fjMSSS#(zSkoc;K69b)Rn4mWpa`L<@AijqH^eb8Ew6vUV8h*&
z4(5ELbA_OIydv~7m_L*t-YS&omM)gwq#=Oyu^%x%Y}FroEA@0-E20{Il+Gexnp^o#
zsmL(D+j*KEghi!I%e}72@PX%vlNBS)wp<YtXb>d^wz(MZ?1JD)jyQcUIJFMS7h|%P
z+>^#H=5?K4hW73zvLx=W%uy)zlI~#qxF!2W2f)SRrRie*x9r9fz?^fE`?Z?xKc~h>
z-<_X}7rELwcKiB{EUSY@V<YB((Kp&Jm)z-LmX{Z|SqH&R<G4#G>XSc0b^JTI>~Hz>
zzr$dUnk7S{!_Y|xc4`AKw{otul?yv3TM&c!_%|vwO;Uy+?+u+8V&|I7Er1zT%}-ot
zDBUdb2z4_Au;S>R-0Y?aa8J5JU6>*NS`Z~Z(1A7f?V0FUD7u@<-A>N=H7MduvE#~T
z5rVgJ42&7RL-Vl2=hy}jQ=T7l?Z3kQ3cbW%wMKF`EI+MonnY5c%qn6!Cf^uq^}eg7
zKM>V_`*3^e(siureOfoL$J(CXqn-8FuBd#a+pgQ}E09>{h6%YT78?%!zByU_Ku&<S
zm38>lTy^yXt~B3cPr@>qK$JPawZgo&6!OIHMtqbyOgn$?N7G|6k%-!>ZPaWmW;4@o
zQCZbUrr}K6x}nOSZA|$3n|}F`II+`~$M#mRF%O`bu92*iB9#yV*}fG&rDJ`YZ_|Wn
z_QrC|v+?_nGg{M`0ffg@K6AV-WK7NIp%z1%-C$vF=o=nUjCPdf6i>QR+oR4*O4Ice
zU&ik)RmGxK{SKcnf8n8r+&F=>4A7|QYH==kTSSUZjv!%$$;&4sD!|}@<p$5~^0D1W
z+)nm26JjTCF|YEq;E5|teQ3ZL+7Asy5D(HCU`i3+IjChrU6l^i<MaS5R;aaI-IZLq
z-omSWFaMVg@?_$p>&;sL(Q5Z!FIG3PTq>i0kHA6LjviHYL`^2lL>^$}{Ye>+AE7yQ
zL4(*L#nl2V8Cb=Lxh*jYzcfq>yb~KO%7b@qRU_eYGLoIIoISVeooE=x|JXqO8ON(x
zry4`QE(0PlexWT60%&tI)oJNu+~;OtM(2UNe@-$5pYTCx$BY1Za*`aF&g`klleY^s
zMUHvjMk!RgLQ^5tYG@(zxZ%LbSnY>$IriMazAl!E`<n)t(K50;bV>vMkL0>&LhgOb
z9<EYQxJRTQuB}u4JIqO2tIkOI0mV=)Z+(U?{cIWK%eNbe1c*+KcWWQ}Ii!!wzE{I}
zKt6tJld6*pUKK>g+hk5)A7>YZGY*!#X@)P5e!aZ-?PH7JFp|{z-!V=*yx7+F+M~^8
z_r=yUGnT~_jgyj;jpo~f(v#%p0$G*DT-n2{z<SfPx$BP4H6DJIsV6*~9+~5v%HdXF
ztOKdNe|yKvT$RpylX1$%S=Fk#TvBk|a}pmZ4^G6t|LI$&ZAg!+cHv+m^XM)5skThn
z)AnJhyI4`-RQlv-KYDd4z1Y|4hzM!o>7F6Bby5G5R}b&8SZgEqWy<!hNk+xdA`%Px
z>H{BXY-jxZe2{m@LvA!cI>zXcQ><nBC&emmR>dd0G4H3C@%M#YzxEJ1I3CkB=nDX|
zizA7bJ5#duOnZd4*05&AoZz;WWrZNS{LrTwIEC0~na`WHR@)GC=k8tOZ}al}bN?)v
z@JH$fY)~rwLuxsHxtK0b4r+Vy5o;j<zW?%);_c=S@d($LygUC^r5MOu%RR?CwAJ`H
z0mGND7cG|*^y7Vttcm7`E?&GGzb;bFxv;5?iF+)!BJnJgF1Q{<__ka*l!LiaCQP5`
z;iq0TK)}}k)xvE$4@?;Hz2J->v*W9|Yc&izd#O3G_QTyP_O<Fcj1pi=7Q!Jh26>2L
zJl;5(FLMy37ksqBQnH8<1SV~$i`mlw#x15jXHK_FUlnW*IljQIZt+CMncji;4!&r?
zr1Fzr%{8B^o)`7Jpv4Z*o?N6L8y@Vs4gsB(2PW<fdCWgnT)n5+#TksA@O~c>Ea2+`
z5ASINhU@{o(7Xt8Bym(#5=-2$k0oK+Aa@ZdS$hhCS9U=tKrBey$6_Y{DEJ+577Bs2
zSddiKHO_-x{pmRt4(OK<qMwNsAz4o<6)|n)9KLgosPXv8GjmqWDOoP+3ewYpB_Di2
znWBUQeL9no(yB%ds`6Hekj7ODY}$<xJ48tKk8+Q0mhvnP@L36&$g4||=bC&OF8?J>
z9VK9KShu|6SvG4W%s7N)<7&$k56&kAur<nIT4fU#MB;}G;qlcE(#ZB*7^kYX7uA}+
z6jC&)ki=n-Dcz*^rW(lW`sAE^NXv<bAsh}qROHEgX>XOrhpqD8PS%OWpS^k}er~vB
zmGUS-9LhevA>?&CzzB=`Bcpsf*8SS$g{<3&Il%~9PhJ2NOGNqh&n1X1V_oL<`nNgG
zr{rx=WRzj}EcAO~jVmLcp-FWUSC6W$O7ypHIM_qF@%Ghg+>Xj=WUF0;!cI7++hy@-
z>xNh&JK8#H(Cd}g<K-~-t-YSuh6z~NYmf}zauLb;-kHRx%AgGHD0Ib49OQ^?xN2eg
zkTi4}C#3~G*)s0WD?Sm`&g#MnSGY?sj@7TXFlj9zs<eCo#wql@9wXi@Ex^oF`(syX
zj0f%^P#kT6cC$c(vwqw!a4R-@-BMa`t5NXkfX9afdka&DM5DrlETa?umchNbUzr`k
z>EJL<6&8P+XHWJZ{&|01>EF*7MGtPxT79MMWB%NWHEb0dmP}}ZfM#N=n^F0LwsyaK
z%eGMS>XvvmC~x}5fCf|ev@eym@gRb;kCI;w(^eZf;$vk0EUEf!X~(Z@7c2h*?-G|r
zJ??OV;uW*`p(M4O-q7AUiB_y`Lw872Q?px<v0K9NE?K;#Dq+{20G*hA5k0XxuXN4?
z&HPJosNJqrc8B8D#d*tHOyh}ODY_m}1m{La+NLOe+EDzl{8&0&N!QsDCavV2D^x(+
zH+)kn<{7mbGIg95pOI*9EzB}laCjwiNWi}KyNRxE0tNfH)u$)7bTzRe72Y_6m5D8{
zjO$xI65!xa<AlMgxhi3<t6#PLg`@F@L(|k>^p5}c6VTtvtN(Cq1*$#&^g6$1hX)E`
zgPReo!~U`}VLukb!bIc6)a65!9#zOK%e>;p|FvDCOk{5<Km$~R{0>FzhJ>vaEz%2t
z-lBU%Q@ri>HeWcyUduLLmx=cL)WLfSZ%8INoRoXlC{O4fb$-)!WDo%A9U+!EI3uo!
zEgfOEl128!Zo)->h5L>F@CswTL9IBrYqFG6vl4y>Yyy*6g5_ya8eKVPT`0CXK)>Nk
znt5RH2&p!+&7#AA!3v34f<*5Dbv^Yj+o!Ja-ZS+2)Jc0Kuvs?XPf+5VsQy;!g#ap`
zR_8A}%%Lvmao)k#2cma0ry)*ugE0e^j6UD7O@5<o`1fRCjef`C`AiXk0@aVZ+X`|B
z0dc_RV`AL+?CC*u(O)}P>Xpw+g16lI&fQzG(<I(wsxWO>{SsEOPOpta!CpQp!4k`+
zTDRdJHj)Rw+KMgBrOm7F1Sq!*H_mL!72+~;fFsZ2_96mKg(DwkWl8Y)o#Gv?oVbe4
z$>yO;O{;4?6Xr}r7Y2f!`fj|4o(lbRKlyXgf?tvpxq3-pZ-SINzU?pY=1TFUYrlli
z6vau5<I4o?8^f1c#1p(RGgd$QStdmV1tVZVSDiuw#(&S-*cYR4!ATCc;Q?0k#D8}e
z`u)Z+q5AYtoa#569*P+ea7XGMA46I15*q3}3Na7{wEU#YEJ3ehUZF)dIbYg)d_RM7
z+3)l3KF>CqA34~#qEyzjUyME)ViN(A>$ofU%kOyCU%e6X6gsjJ?V}GqpYm!!`JqYB
zVEjZr8)QwxW4Pw@bG$Bf*~{W2coLhpJ@_sx%!b}>C(_`;ZG$$XaygaD@_0kYnlpkJ
zs$c#NWQk_co(}$Eg%CALQ-x3z>(usiRtRf^13wN2oF*}_g?K@#Jkczx-&_wQ3zBC+
zjlR~;hqH&Z|32!`&1)_rl{R|{9#KLEF7IBdCuaF~=eD`nnqAbGgkWBdgq0s@tZ@?V
zOTfa|+<ZK)o=U#p<a1^6vmG+U_Dfd6d3omT`vm<40&Ik48}&Z75su8$P0(>j6Y%U&
zb}EPZjm(<auGa@uqKlC5k^XL~2Nd3Ov91>OgT>x=7t;L8QPkFhG<-tR_|q5Xb%H6?
zl|-ace#EMn;&b^#vDRF)kwWEI)z`bt5#a$k#8tyrT38hh2gMO9rbwAC(<^mYWI7G^
zMtWLvMZ?Ns$@R|n|6g@W3AX>&`d{I@{#NY$TQtG-;WaW`HfErtT49N{qJ395MGSjr
z<>8oGXQ{A3kGpc?e`CR1>g7R}Nkj7OyS(}Fs|Xy2yO~e(DW|OVmb3#gpv2KiZv+g9
zmn%i5BdO&IKyS3zOju(v&zk^e(;lxogHAoKqI>6K1o-a{8h*krpNqzlG+2(_uYD}-
zZEm`f^5POg%7n6vl$J_YwjUfY)&T0NuD&IAAmYyOAMX(AD659yHp`z;);*&g6--OL
zkj6z|y*R`=_~^y$1iP<=tW%9lbZ)xf_b9&=hlB;4*Dpf~DEPUO_(U+!+_r-47PqAu
zpi<)MpRpaqEDqs*%upflh^%B%qU?lPxQo8(8T7Ph;p7e#v3in8$4q_oUO6Oe#?)$o
z5)m#REO9u2HhY8VLc$VF)KW@K7?=?&HfL5WZAB=w&5gf`U-tkX5OpF1P}U4uQeVD|
zg$RHwU{H4F-Xy-S&u7^}s8vD3Qto-xk#=)|{o0x`x}uReGyznSg9Ggsg1e0hj&4UA
z)RE1<;XI?$e=+EvX|f=zOOTO_VKm48fFClRG)_W-TXK+R@USQ>3Am0$D{dA&fHMxl
zDs`(;<{5Xj^pq5c2mNii7qDGF+afrCGxh!ChtB~l;BS1Fr2G)2e_C^+KHS+7oM!rj
z7Vjo<Qx~M{rb8`N?na@=6yJ~(y_|Q024g6<*!D?;XI+IF@Sd`Bb#SakWov7#s-}|`
z!OV=iib~C|f+wn~1A$rDb&D;A7OSB&$yWJman>)#Y0l9+#60M$VUTlFnwfrr-90fj
zMv2r1no4Z;vfH()R|pAqA~v^0kK=3S%gBk*bQ<1x4E_$5>yiMDPj{X1TBg<$324xZ
zwe}$#S_oR7U}N~OAr~C3n9HhU!%=Av78K~?EuJ_p3`<oB{km&))+&{p5xlE5Kls`D
zRGRvA-QTy94s*PDq+;q9g{jK&UpP-$4tltG77N)3N3rq{>1XQ*Vgbj?&T2ix_BB1R
zs(^-gK5JS@3T1FAQEBWh(sv%AE~=cUbIrD(mzHnFpB|A{N-)F6!Jzl7ZznKP?X+ae
zLrMYnMH?eEE*L->ry|G0#|VCK1%I<mpH8QFA{Uj+8Pf#yV6qcd2Y|&s^ovzxCTLQ`
zl}mEhbOhc?wnrIP42HUAA6%EphtwX~TeXMLM&2-9O3R|LI<ulf<SXVCRnw<{TRAI3
zQSmj8e;gzE2>a9G^TGWTTYGkEz2=7(Nasm_a*RQcEiDAP2Mp0v)15mXCU{yo=XQTh
zr#t2UR22M!EX==^4A=?B%>R?h<L&)3dhTz08qym`VlI#xnsi8e)W;_~%&~s-l?%H`
zmW|cY@iWq-=$VbLMPB~tz3nOf@D;F8KbC*hBYID`CIms5!RElw7_QLzy1;le#A);*
zWce~pz}0&7`F0`}mqO=fgPq(7U2W|P#x5)xIg$`T^%ElDd+&&6ljg3BNT_e1Q`<;@
zczzF%yY(x5?$!)AQNlmWu&M$wSX*X%+20}m^~jKmDUqHCF4i|#++%Lv);;eR^d-{t
zaORq)EYyyTEwj$WheVo6ZH1!{m%bJ2M;873?B&}icKRrrKkX`A@nK>W@0Z+g>zJ;X
zOhpYv>QEjM4UpGvM0CFm<8v*)gI2Wmh8cIT<1!Hi2ZgJb^HqW5s`pT;|BvsN4SUzo
zupvRn0@$catP^`HL(nHJMzi-LiyZx{VP#(M!{I!-xkGwLY{nFT3*0||DLPC1;um`Y
z8TG&4X!6T_shu7ZumD0!t~z+whgFp;AAz+qhUckLdGJ~eXD-Qa+)Aa8c+pm+D-H?n
zbMvNE3<JVb*}N<qDo+kow<r0oi<5;3U|2glBBu|~M@1!vg42|F{{PhdD*V3WnF}zN
z)R2bAZ`zb^9&&RgxmJZm@N8B~dpvV|ACdO`ggO5S)#o*V5jb5I9fgE?wC#j?7dQ99
z)ynWDJ-Qddw|iUote<ocB@Sf1tsFya`0RyV3llWKvC{j8+dd(7AuZr`z|{W4T|P<L
z?lXLBc6f<N+$5o?X>fq=+>^OfI*CytIH;ZneM~mK+)IkQ5;uiZeAt%HaXr4a-nO_M
zSoku##?nA+Ip>b0fT=f}z?7Qx=yw62KS%s>PEpwc^-XaQE$xFH_j#onJCOv2I7;vD
zpSfK)YVesU36L-ZADtQU?)6fF-lh2d@RaKIpd-y=(IVpc*M$ng^YYBk2}f7ZYT{yB
zF`99L=glngm^e)D^zH9Wbtn?<%!JFgfgcZI1oOc^J%~)Q^B|L~7xYv6TqwLkd0+i5
zP;K6}Br@D^ugS;|Nt>RY4I*<B?}vRc?o`j_ez7P8<h}x1)pYMQ^{sdvwN9M1zP^$6
zlN>bsl2^nu>py&!g8z9}<<k?lD`l#e7{y_4)3JVTwJq5>3Qq(Y3fTn&Qcr~f5OpSt
zP2a@gKm4l*?cbimzcniUW$%Ok=0W*S3FBY>>wo`fOLd<po#GA7>c$$ele5pEOWgKH
z7Ox*Ur#+ZBDjza&IRQ=mAwd~+sPStn$3iYrMe4dT>e$eTB?6&`fqdCMIu_a$?Xq)g
zVo`UUux=}i)C%JJ4Al}G*?BK+iz8-9H0w&l;=&xDAc7NhQe#KyAkt}?`q!3;f2(oE
zo}IP>CK7e@(vAwF4{!=7q*lflb)w&ul(S#&Iwb3Usk+~J>b%@MILe#9yTjT}jtjSO
zC7R~LI*op1pMMSs`Vb2`T!0=sHvu+3J>v%!<@@Y?$QR!a{mE2hbYWrm4~=bI4hhlO
z{PymEg#0-#YKQxDTaP&lUw5CmZg+Y&p4XZMkO5*R7GX6{H)csygD(`ND>qvIkOSd=
zT!Q~<_WZZU@gFbsm%nP`5JznX(iIske2ez0vW`>ijf%{wVvdIeKL|_|pXx0TWhD$b
z?$<+wRaSJg9p7!3b@1v99?pmYb|#xx{n++Tt^KgQ@TGaL=CQxvxHLoGSU)E6Njm$U
z&w$)JWjkv2d9KagN4Ae|Z6s^MKJM_W&A3c+>suDSFIk+VswVRj=(?q4C-%W(-Y#AF
zPe!P}m$r>hwfW$nG`EuchGqL*&3f80!r_9*t13e2Ju#6<yfwv4+G(66XzM*hC<5?1
zW&h9n{BQ5KE_YoqDAnnllfzkHS#(YHnRB0jKftFiNuR&Cpe@w7TI3=3vl9ip0`2>M
z`_8{y;*Wf6{jVmEe`q<ho=tvzdL)#jO<QD9`4h~tvf=<n#wAuPttbxjo9I1#z2P3Z
zu;LlXBN_kZmRgGK-JH1GMdr=z%9~Bp!Bpo%(>|FX@WXo-L)7S-SLbbcZD&U#s5hN!
zmT&=(?~R-ErZP2@)z5!@8mYPmN}D=P4x?CzXBvZO#$lehwA!Ic1sBuG_{M&Axd7n{
zbid)uLEq;t7~sLUerQT=L%h2liQN!zqI-!4_hkkbOb%1{gA-PeLkb19=4Vf8w1?kE
zt6|a#rS>EM`g^0c%Ic6%TlZxwAx#b5T|7w3!M+M9J*`=c5_R9X1Q+DK#y1Pt{<adf
zCDuN#Q+7LNKgL=uznd5ji52Z9j}E9tP(wJD!WIjha!y?j_t*4mzisQ?Ng(n~gFF@8
zPZrmAu|GwN2`leO7VI`k&SBZn7L?^}nwxdxsLD|;kQG{H(2zL|L94B&a9V86XzxRk
z6ALsK@hBviju1N3;uRFM-#%KSRB7hfEWcKRO3zU(gZ#|9AH)eC+zsfnzH}*o?Vtpb
z)3NY|1oH83&Ky>y<T7KSq1Wi7NULXSk*l*??P8={-wWg|NtQw)RWqnv|8h=MUd;v2
z)!ke4W(qy=gCbhfI5FQgc1O9ku`CeNZa%J#Ski4+;i_NV6E;x|lKNpEM~BUvHh1}`
zqKm{#lx=zD!oshgsddtKmd&06S4q)kTa-=b8^gRq+Kau80QZS*fGf!hGKKf=3upbg
zZsq&yC2<VS+&JR&`Bz`b&W-OycviI?zr~S04+M;wq=)noMxO4b+|Ss4{Uu)M^QVr8
zWz8?Y&#Q|O8551^a}hJk{XTH4K*c9}@4wuDdK9%ecSSQhaukucH4?v}yv;|*-0!vQ
z&qcU)87#yerV+UJB*Btcc6$jm0;mRN21kNu<exOwgFc;`4qcJt?;BeQDEj(FjAyvi
zY<3X~hRb7_^4f?hS2)^7H9p{JuFPSxn!SAWyp>O6+g39uq*U^Vy`6D;L>^sxgFXds
z>LZ#%5MF8MFg0gZ?FkjIS%v+bLOoMyrihDTog@B*?Cq!90M_d41rolOkwCCi0CE9r
zUFprCaI754+d?X3Mrb<Y_#Hszykh-_^WT5SZ2zrf)IVf~{~>}Hw1Vo0HeQ{8Kp>NJ
zFfw)_w&-@zkKM(O<#cIdupt`cHG$-y?!@NJM$6{n<I?vGBHuf&mrMuI<LFKDc!|nQ
z$g6=$bVOWUW&v@eDE(8MP`;{tLrx%Sc-9&9bJA2ye)?t$A?QbM1^gzSZI~uES88!n
zFy#5H3m3V)(k00ZW^&<w@V)7H>%!2A7igt6e&8_5%dcMQrES_6<O1_P8j|SQQ+%HY
zftIQ-Jg7o7E-G|Vj{O2fz1E_I50goZnOQ}y`Z(<qaK@6nS)bO!+NMdd(<THzy<J_R
z90E|kSM<ueG(Rsk*TFw0r5k2A?7?zb&M0{_P@(>rGWr*_XI-#Ubl?^P{!lAF<}=!>
z2xM!7p1JJNl&H+>bro+=TH_Y)UfRsr*a*C*uo85Bg&b;>th6l-){@BVM8$4xTvIMC
zw}zG3=Jh^*m)k`w9wfE8@C^a3J^;C#;N@mwLC<2>X2XM&vtq>`YN?cZR&RdP>K9N(
zq}?OdiQ2ED_O+ER9ZLnq$hmwdt&wS5Il7KmjGDeu?}ptR3QXK267fi9-J*tYR;PhS
zxYhYu6SaGp!jBgmW=Yy2#vkRV=?37lFn_Mcsy$fe-r%>a4Pt-t6BllEc*wh+8{JEK
zIZ{2%fw<DiG`g*&qxbY7x=w#Sl<Gdsq^7!s0+ut^m;6le9mQ-A=YU@YOzvpJJJPE_
z5tn=P9ranLFpT_j`tjdzJn35J7#SCZ?7*VeUEhf@>!sgMfz&4lyQedy_PHGm#hr5J
z+DtMKf?Ars#dr_W`5(trGF^V;&e(X%&Y`kg;M>mBBldaG6EXy0a9pVJXAVO+ip%T7
zn`BmhOsWquRqfvH{(3tHHzif%TEhP88$A#wEwt>c!B|2<#YX4~byafH^P!5GW+bj)
z`f9M=2QM3M-CaMpz638DHXcJ3=$le9N0_&wjjlw0g(j>RhUrH3IS9_yD%)E*jcDRl
zR3>`k>=ibP#7Z0LM3_0Ef~tIb6naBV?#{OQbIR|vnh(}ggNVrqZub|Jeu?}6z%l_G
z)Q1LvmW!H`*^_4`^yBs_4|`r^r=;Eg^g35b<CD7Pp;9AxHI{P9$lKXrW#XEKCfX8R
zfWOC@f`+r)JAUKStV?2Q+k7b8;QME3%5q{+bR^bSQr#5!Fpfo~+V+dOTzm@w_JHwY
z56@!POGYu+fLMLcTO5)hvTrIza>I!7khEHFMfbKc%5JH1InsF{`M^1=leT!oKLRWr
zw~H7RR$kmHxzhc(pXyV2$vI>z65e>^j%5B_ROq}q#KyiHE7Fqw%yodFC=Gdj%2}6J
zSy?ah1U0S_^GZ%$qYXlMW$PtoEVtn&!TB&J1wVG9b%1!VRK$-Osc-PuzLY*bh@49x
zXDIkphV7=)pd3^ES~YIQrlBq4ym(TI>JI^N#^s}(%fxEa@m~P5igG$m_~!sVZ?W8F
zf|F}Vxkq_G@&8r4`y=il{~=EP&%ddiZ`zE<=JZyQB@bzun~9xE4f~_QxISGToNFrs
zGH@xnr$#8J=vLoNwjHJ`c~$lnB>0{~Yi)NP0wH0#^Fn3Tmv61Wguj!cWN(y%jU*-f
z25`l@x{QArzF+^~Up&=O&E}tPQM<6K<azyhE<p|^DB(uC0-!w{M!Gs*m$8J&Wb@N$
zN$i}4k+DW+T@f`aES-<^bxym+lb$%+;jEX@mVHEY;k>RFqee0!4+mGIr>WnD_Lu<l
zK7VVe4b^<;jp=^V81G+>SB1+*o4b$4&J>Qb7KIQ7h16mxEkHBJ&TgKg<8-;8(p7Ve
zLGR`)f+!mOElZ#@rw4Un)b|`KhM@XBSnYYfDvr7ITx30VG9JM1MuWEtjc?#s-lMsW
z$UlNLABeSGq+yaV^Qj9rhJG_|7HeYN$T^@ZocFQDO6L0pdMPh_1OUQ8Hv4Q`hf!C8
zzF@2z$SqG!L1VXUb>JP9<?Sa<Q<uV9l6zn4)Qn472CrSQk>LMp?K`}hT=#TAP!J2n
zLMKR9no^}DAYDWdX;MT*2oQ?2&<P4sg-|vv7>YFMAibmXj`SL&w}g^FAQ0l@tTVIb
zoVjby-RIu(54`#Ez2ExPr(ER7STeO<U<&j+P0uC}7qPU&xnJt=PFzdvU|AKnj!HbS
zb%7=ge|6DmYv&YpIP`=(GsweEJtbC7R$rM5si~}-aJH#O4&Ij1x?^h#q;N?I9JFQp
z>FP$2O!h;g*3uJ)&}#a;>!6R+B)AePHeetUWYEc8khsNdp@?u-Wnq}(xgV-3PC?2B
zaTd+Te8^_6RCq4dXsUcl(|B|Nt(1v3SDCSl;eSB7QFAOh%ur!$UFEWRx)*ye^c_2g
zN(m%uk*`Jz8(H2kzyULC3M((l81&sr45y}1x*4lZ#c0vqJIiuMjP)_Rb9xz#G`7%`
zdXPXlb<lW!RhC@T^w*kQLzA^dKgu=(K}51j)J9&`hOW5@wlv>MCR#!BROX7Vw#W|+
zUVXzK*pBLJW(j6TLz>l6$ShH{+z<<B$+G;FjrG&8%I19Zq13zX;&9fBGd#A((ucvL
z={E=;*Fb}V^crw|+yZ84tV}FvQo%1;%TicdBMwFulBb|}e7G&CGMgejz2t*u!bPm@
z`oY0|s^!@2I;jU7uWr23@*`!EX%u2)ISI}qdU=A^6C5API!wEA{9GgEVy$G)Z8<gx
z?IT`_TDC}AJ+Pmw=u4J$iKWKbvJ&@-`Cn%$<V#?IIv4uB4vWz*IVnn^A>=2ve82*T
zE9=3lC2su#y2X||Z0YG7vqgofbd6b0{cl$A2{TYSc;!FYlHwYEJ-T`zK5=mFk`CRd
zMYN2yi$0{{;2&_}9U_c?0V!4pk`b}#gY-n6Uy1RO&#c|#kIJ6vdmIV-U&a{?0*wYR
zUJh?Y;3&?s+H>_Wym%#|Wipk8CdVj^-71a;b=R6)_gUuZ`NlbL>D5(?&9t2!nnWoS
zCNxUDjPzhf&t!ID9Bp_6W5Qs!&OeLW7m}q6ogKYT$Qo}MIB##*j4LUuj;xiS)0eJ?
z#V4;v?G!jyHQQy5w&Vl8;vyJ&SXEs!mxb#AfgZl4qu=v8B!-M`^!z+GKHyA4lPaqu
zhxH<v;{p2R!pm9!2NMWkjqt)F=@9ppL8&jBHaF5!c)(EPll5|riSOsm?zvfQhKB^~
zG$~(Lu%fvrgw<Oh>@b^*jEE&c2*cQ#^?q$^_h;LH$Ng3-UJx&v-lQ3$$lR&IF!WUH
ziI1TngNACgr<t~z^#C-vHNU<O5B_#$(vg(^=$>hfY&%gkQKvV<=LUACAC_EWVw`UE
zexhvQB?$`^7eS@mq2dgpV;K>ma$iaHy*}KY3uwHlN7g@H069W;i>kq_8;Sc1bW|BY
z6{#tI!s?>Pg1U8?PfWK?Q>v<_lVT8v$&RITmEOI^Ji{`Kx(<8~#LTWe<BPO-Qr^~c
zy>&Lj{xlC+WTqaFyQuQ@g|5}(?S+oG+8e4G1{&QG4_0GTTxG6=C395hgua2hfdsx!
z7p=Jv`l6l9LHF#;_#|#xI-KV=P&gi#2{{X%rxlz^CgRHsTwlci6F|FmEy-k(;x*dA
zl62V7!}D(yr&q`Y44=otD*AqqNJqF@Lk=LPG$RY#aK4;?{Zx2P1~x0ne$4r#2L!J)
z4*FS@%9F+hfkEML4|N~U+EN#*TXI!px{BYG?zS<hdgI$g>#5T{jQ(ev|0fmppQNXM
zMWpDjovb=6VcssaYgeA-1*BAedcn@hO<C|2@e^4i<7iJ-r+E0w59eL7j_<g0mfjvK
zRS*hs{JO7-9pRJ?${p1+09)QYEvr^|t~=vT_2BEk$hr?bx0Pd{Rv=Um!5h{`g4CNT
z_A*?~M^)c)(Wn1rC&W+TLR_dF+NtmZcLT3m?SU5Dl`hf&$Sbfayga#?c#yYvdE*?A
z$`_0}_2&9@w1*U@rE<zp;OwPAc=j|^tPMg2Zomyh1xC%2qVgpoALpM5WcF3dt$bkW
z@u66U2F9BWs=e#}+(SPM;@@I`G{Dvc*TvHwqSUir47@h~@NnKCIV*{GDo_NXciTW7
zjI`sH_*9SGy<>Glm=oZIA!0{|b!TRknp9i=c&%Bsv#B~u4r@1x^KNrN$Jrr}2(;+(
z{?VNm3wXlg`Ud<XrVt4&?A&2fKJg}Qh1KI^Wr&Ad$|2jWT*>x%8@y!mL;B=HFxG8L
z)Sbj%Wt;Hao{sNvJjE@O_p2Sz$2S3rJ^1989@C0!Ex?xLEAPpl;4rvVp@2BW>CNY4
z0;M;<MHU5Y6@kg^!pQ!E1@^{fY!0%Bk0%Yx5(Cc|mH3`2-nwkPpT1J+zK}deHc#*V
zai<g9(yEH`(?*+OkcRF$f)p1D%MQaPKxv3##Nw(<Nr?_v04b0U&Yf@mqp?ZDywO-_
zg6f^_J>{XYnr~N;$h(xrl)ow70wnMty<calQ7ke%wxDV41Lh?2L6q}{e(av|=W{dc
z!S2VP*hlfbojSde@p9Cr+m{aW<~A6!2Q!|tY`LEErDINs_Zk;%F^ckB!(`f|zLN5_
z<E?UvD;u7@r;KFP1Dib3i_Lg571=4z0QGoF@N?k~tsZ*XpAL2rJ!AFKf^EL^Hh5d5
z>ynI3aLL7macu2(rCdB5<g|TB+xImfPl2tWdDC)YH;A}{L$|159gk%sSdNe{I+H&A
z2<cii*7gFF2gU6@DXTeCw%g|-ID!Brt<$7-&Vn+A-t%#<<V|)4FQo+l(l;;B%RYb0
ztQym4i=!!X=Xff7CsOX=<@toxLgLoS<0*e!@$|QFO{o}MC02YyUer;-rZ<cO+No-d
zlJj|fScXj-yzf)ngW$@&De-7uO{6s5fF;!_C_3dn1;co0yOM0Bblmt>HqaP|$@qMp
zkDh_T?DVc4SH2?XxS|f@7qq4FEv8d0GiSv8n#US$VLS5E)~pD9GxlpPBFZ2aBcHn~
zKP~|dYTQ~T**fWc&gt`DZS8>DwS0})$8(b~fe{tL>(!2Yrc>WuJ;1Zn-xMp3^LQzW
zpDR?ZRyoOW_)6|%2$;9H#e-^$lJ2f$nE!Mv1gy-@06+#l8cD#V;WSO^a7y#o*<Oz0
zWB+TcKRJ0qFY<ggQl+3p-&HZ&NW%xxLX%20AIvHeNk)1t_}zw=gLq>_-)EY!O5NLW
z*<OB?079=4Zy(9L78@9qX;&j}+0UL91uyJ~5X@;}0zRSPVU6<Kl_fWv4iBu`IlK=d
zH%>W0#B0*5M?Rjc?plbYb>DQcjEiLW3_>6`KTv~Y`UA}*Dm5pQ<*<mloL_5eCQIN?
z0ifIG5cVr*w7!yDIbPvK6v)Nlnu~DusvHsj253pl#|A8}allgKj}gvN=Kb$IL=B5w
zocSZYLWRzOz?@GcWZ-R@-2qEx>m{WOjxk`iCl2VmSk+uO^%}F-vvqK}t80={mW#&`
zThtodrC8Vc5(h{Y72^|kKE}uLw5pqYHZtUz;4fHd^&i<>>Q3U&*laGdpS&jU;{Em#
z-`Un_?)u*S?`u|~kn}f5>Zt5l#T`ax#d$g&*ta*Ae22=O{aTWfr*!E*Ps>WLeRfR|
zDk*)kcHBZwtRYs7!{m+t5`^FZ`SHov?)yh&6Sp-H+g4FQSC#1^bQ}G-ojx<$;Gs{)
z(w`7)OxFB}v;pn2R(1z|(oxqlbgyk<{Id_3P9wxCK_W15r&iIb%N|<Na?-ZxTf4i?
zIeJ=do`#gXt3+i(&Ou$ha*TrbBPnlhwYu63Bm4{h;8`(L@9b#?m;SE`Wy=Ylk;e5y
z^mGIBo3c-^4Utz3Z?Q`Ac4k9Vup19IxvW%z1T(*?>al@YF;IojyP7EyCvE{Qq>DZk
z9ou(2Y`$Av7oR+(!B!3+=u?{DnVf7}g1YiusL|5}sGrZ5XrpWow1W&<V>w%1tZ!WP
zSzbh!uSw%N;kXKkOj9rF<y8Knd-i?a%~$2sMSJXEqInKgctZ|8OX=wqjz7GRiLU?0
zwEV9nyT51Ee-q~9AKJw?K%dqC$=*Q6al-={GxgOSv;i~sI<WK+OP+sJ+KhLT<x8PM
z34q_K6`=#7B2cse`B`6GQxTjfbB-GrFC$`y#HXiOKgY*TPXv^e!oFJxv3O)R4G`;K
z=KREUViaO|9VSP(&da&!QtZ&c2cq<P-ZO8G7+3NVl0UlXTpv(5t*D7(0hYcEL=JCy
za`l`!aolGUb>3g)gN3+MWHm1;K(N^)H#R{A0tCn83ifh3D{^_D^R1QhgT+^?kH0DU
zH(?G)Z8Y4jZf(hd{;TJCkl-x*1kevSc^WoBRUhV6*Jm6s{x?VXrlp)klEK2foqTRh
zzD=>i?MaYDb)qGN{S=*O;B`JhyDyhKcbYP+rgm*1U^jdE>2M0>Yd1HKK9e-bDKNQ9
zw&hj053d@wIc;3q$F&IZ$JS28X>${}V&$fP>rBkb!-DPZwbvg6Tcb8=e*rs#zqL+1
zX()(!^njcjWhbVFYB^;Bl*nu5Bf|SNkSKxI;2Z9GJvh7nQt=*#yEK;?LTHny%(t6k
zQqI0%f?jXDo}t|y`;%t4j7&{-IlEy}fMHbBmtcY`g^i7+kpXgwD`R`VDeg9P`xjkY
z4j0WUZ<KP?7Q2(3tv?oz4Btr;LoxP#K@v;`6c;NvOwS+;^Gt8)fAFtm;G#%YBV|pE
z#oNiVO329q`@)oxvfKzZyM&(+bwzRdR}3+W(xm=3A>~?AJcm~MIuq-m4UC`Qm!l?N
z8{8IxYl3O^)q$Cf^z1wSGiNH+e{W-vcsfPP`k?E9jlU@p-TZlTd`t$QD3dT8pufuo
zt}&hyxofBXw#qx{E|Y^xFTFgI`bF7k%#W=qxopa>on#}zBGlQ-${LSvll_&|R6A5H
z`PND8E@>E0AN|lK=)NsndEC*ge?X?jcG)ky2jZ9Uq_C0uLIt8+QP*#;1{x4G7i@lm
z?TEhnoxl6+qV=$KAf9QtORr0IEL9M7Ko0U4V=~iUe$$sa-q+aICQ^&DrN^(HUT|5F
z8iD{hxL@Arh7)RFV<y{vE+?$NSfqR;Dcw@fc+bnOOgIVP=n>9n|LUV?UwWhEkvQvj
z>q87((x!9oZcFbUC_Qy2ED?|@-602*{cG#^29d?skxz)i4jBBTRxl&K6<ii*MDm#>
zSrE*Q)tX1Z6VBJ>=4V*eO`k^<hQ44aV$`7iaPw$z%EnKHlPlv#>@qiI?2!2ne8%*r
z=8Do7(^bZZo6v?*OZApsVgs%TkOF*BjpH-(+tL+@SLM%cE$Ga4<|{gQs(dm6wx2mA
z4`G*=sX~t3&ndCw8Ak-vxX{d6?B1$F*%EjUTs?QR?w-f7g$*OF*)(?`XcC=yKcY~m
zQ&-n}k%f|7O;lVHS$S^hlWqN1g|o!-e^azIidYx)UkES=&)RMDk+RAFzNx}yBsV3j
zHcJ;fql>dE>&AO-%<FJJW~5fpvWm*$k5-^UeDza_{T0LUAlqn&w0}5?XQw`rlWv%q
z*OpkCr^Cf2p2NvL*}R7^&{m*XE6}&OF3Ef=WY(x;zSXqugG4K%7k~Jw-6JM@93NPF
znx*>Tfh$->ukjG*f(b3EbaPmiV!Xvz&upLoQ%H2_Pg`~2A=DgW^@hyQzAYig#}H~n
zKxb<5_L`QbXPjxbAiuNprL^E@sHRZ(3$fnbJMkQ+i}#MHpr_=)y)no^$`t#iw~ex~
zRGdeyJAoG)6TI#+3<qUM?%>y?uK4J0o7}m3;rq2GP*>y6{fruUD{gkaYxW*9ekMlC
z1BM`W56|Y3ve7ePGB75g&E+n;`+P#vU<7?_kB^rgq0d=|;N-|lK~-!n?DX@I&WP>t
zY$~7+;C+S?Cta#07J~`|2Vu#8KLWjp-D8KTZ|foSLguLkbI*{3FJ*<K!nrvtbw!{N
zi1v6+E^rX-q-kdjXD#O0MEmYl2M-?V*##7h;DL@G9xM+*A{AnSLsFk{6eZUu5sI)G
z2H4j1u!Lg8vMiLPUB5uaz3n?!BloVh4dHYe3TAWIDDEmV%dnm?c}rL9uWZiwVR5p9
zqfoDEZ_nn$44e<hTV)nbsQw{be+1f)2`(VxUls=tPvMN|B(++E@GCnTbDx#e5$|-N
z$1&@v<Iu?@vuKWrw!Lb9T2K}a_EtfYE2{ebTAu@V9BeWIzU8m8x;H4UND$OY=tY^1
z@r05fQ|Vv`7=iBDF6tiTN#syI6LehmP%0_-4!FYMwFx~dzyqi8V3pYyLygZs%Heaq
zg?rS@n}GN|&q39GHvYX-r;DMDo(}M@b3!ZM2Vr2m_Dw$MR(e=Y`jfhB#ki$pFHrq{
z;8<t|SE2Xe`a$rP!XD0s5WA#s%NhvAwnT4SyS<|_C8|F0ak_v#Ow+28&r#O+`N;XD
z%(#@(XaU9j{S9`wXMHnrR<4S5<!hV6vsLIZ7xct^0F>OC0*m(@!O<t|366VY;XPS+
z*R*z;OrS^aOo)ZgTe?!)*U=>=w(G3-)9;L<fj6}Sl2tJDwqz*kzGsj|z{Lb`3m+{p
zp`Tndw@UKS)&`oF*CRE%6%Bfs63`(^K;k#x<SNw!eJ%c>59pUwa7?Hh<?2Hh%(AYO
zIH9K%=#xEgsverWW^O#TQ6DKh_t5x7?t`8s%YixCACZW}{Ft{}&0mINF;`CD<4e$F
zB7Idr2H7#yL1eN!=zVR2W*X)*dQsp{n)bi6H2>EGqyEy7)+FnnPQ>=i9ky#LRmQWO
zIg{@FfH|X7I;NK8YF1-MpqS+K{Z+do$+5K<)97Ut01cA#Jn;F8K%-g6{m!D^63ZQl
zj$>wV+8~j4G>n<bSdaAy>BTnNvTuF@N@<^dHWIzao8IhM|K`Srk6nMUe9!VX?<>pk
z3!W09>C|m<cjMFPqn)1nbs#<f=z-rO>|(05auSp$!EdHa@P(XUsa%_gaO$%Um-j4w
z;^D7eO*%tCfJv_Q@_?!d{96rB89)mSH29)#241B}LMtW|5oA^j8d{yqw#3a1mn)hi
z)h={dD?c8gP$_{t$EbvrXI%q*<n6=<CM}rM%730caag9fPfd%4^28jSGNeBtw-)Z$
z{3Pd6aZgCS|4*q{Z5L`U#_%`MwvXavFG7oMy`dC*<!j<!q=Lp@6<FIQz(*J6xKP_i
z6%1X9LO6v8OLq4C=%$9FHzs6}L^jFA)RLwdpW7)GH{MM4;NF!yE+&0>|Fomaoi4Cv
zSwcV}Yr%v>m|Gz))&ldnu2Y5Ra05&j09;&bC+3UQE__?F@HjEW2x>Sa4=F9RqaAJe
zg;B`#^X`>f_vkHgxq~?|7J|%oj9h54F%~J(?IuHSER6OxM(erOc?q%vdl&(d<4|K3
z`W5kMHg|OR$1P!wN7BFUJ~uG+BwTGn#|+4`^ifRn1<EBmVZ5sJF~$3zUH9L8kXzim
zx-x`%UWF@5k_L$^>hTw|Mdpg#In(;7^-WkG!Pu*=vMs4#nZwp(&@HCXYW@|S{xbu-
zy;RU$AAOz~yf|{q4H9qqm>+26<Eq$d<IaC#pIg_^nD{95ZG6y#3O7Y2h0?duA@s>+
z`H8jb2~KpOe(r^WiJ|-ItydHZL7az5TQzZO;v$>OUS^?TnJ?_U5TR4aw||P*v`JGO
z<W1bl+)Fjxx9$)tXd9lD|GXcgn82qQD`GxOUYVf`iCqu~(w4QvQ&{bRN}<_9?Peax
zRxNj58(S=`R6+jp6a;CYvpD)KbRhx*to=qA^LgB6fPogf4qVlXg9$g~6Z}hOIisYB
zo7Qy`r2u4mUiU{Roy;w|i|;lY#jnRme<H*2oGdFaT(#BVY!QxfYLr&5&VI^=t%a?T
z3JQP~Uw!nRHjWE8yAK@DX)O-&&<SU_N%%;~+dtmmB#E;4xmyO)1YZqNZFHG%>>C}O
z{6UK@c3S>cUCZ&h=Hms8sF#sN%0TqMeuuRsr?Yn7%j`kcCyK|fpfbr02;;QknL#pM
zLw{R_nfo$&mqD97$l+eevx>#Ly`ggIS~5%hijphuzr@>dsbOJ>tM<g!wK-9VrB1GG
zp|C>Du&)yi0dg9g0<`R1!W*X+gD&>lo}suW{cESJ&!#=*T5NkR$a=0)D8yd__mM27
z26W5ppz_^WBwSh@lL7KFohg$n>yyLjb;l^TcMiB;e9Ng^tEkaQR2NEEN7xSI<TTDF
zb0DOqzHh`%nM6xV7w)<iJGAO0o(|f$3&WbLGz%Ba1%Rkihy0$CgveG$e!nSB{zl^{
zC*`Cv6Ias7HwZK(ulxgP^YspAhDdU-O3*S3xy&LjiY@d`?!dZGE;!J<Iwpj{*JbGx
z=eHC*xU7DpINx?e<<I@HJ3bcplr|H)OvM@H#qH7d+IHrGiT;Vn)(<;$3{TPD5LYJ=
zBrE57R?T`XVN=fI#Tr)HxNVivw3{sf0G)c6!HRB8x+)&IY%I9Ndq?EH5_@(U-=&T(
zB^XikNVh#Tw5K~xYh0*cuZBf4EEXbn6<*|Ft9$)FbxQs>1lpfP{<41)8u1@`O;c4v
zZ?CSJ9Cz~{#ip2-*(~TF*_NU@gnqzD+TC@_jxp=nP(?zC%W8Sib2w+1s)fn|kEZ8$
zEkb(!rB&x_Cj^~w5ZzeoFk99)8l`%%tOBXL>s(EdWaJEzCY0;zg^w3Y0OD`tIUpYI
zJ~)1y*VXR5fY_d5(&qDz(HOq>^c+L9tl95~j&&;KLw0HiaCb%8xo>aZFwlHC!$+y!
zz<7An6CRY+##xg;7M9G1wF{oM)_P#6I&VEFMn|I(t{i^lVY$*hMc44mCWVC>D#{hO
zbhwh0H2EtqlqCj7S)DnO$C$nKPu*XR|E7opcn8psE`@MS0>%?~$N~J_E0_?mUX`@l
z@|)soz1yBG6io!5F78G}katLWC-Z~5VQ1mZqiK_=E#C3F(qEOX-)I;`U22A`1gTw*
zke+X4D}9V2lcg(+gHL{4h*N1MKG+zP8Q~hocZZ0Y2psQyRQbQdU;ga2|ITRnSEP0R
zQXc=`e(s;3e^xTEA$>DT3z7xz+#?)+dV!1d)J4&)?jMF?<Cxx{Qumgzl|QO#8U30!
zh}SDMI19LVO<3szd&v&*E6vrNwQHc{+w08lbK<e4E3vL`qCM{#XQ4uz6*bJ!t2UgM
zfOpia&c3YpkyUFjpGG5EbNreg%<QH%d;b%g>%RcY|MX=4(mS>K_d^o@@+&l~tEQz|
td+#g7SkN;4nCC*xf73w!4(j~NC;iD^{`Z5i{(qn7A7ab@!%@Fy{sZ2)t!n@P

literal 0
HcmV?d00001

diff --git a/docs/images/streams-architecture-threads.jpg b/docs/images/streams-architecture-threads.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..d5f10dbe69da6a24b470fb268554e233b5d6ab9d
GIT binary patch
literal 153622
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%0Duy1>Y6}qst4hs
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%0A5)
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
F{{<0EDNFzW

literal 0
HcmV?d00001

diff --git a/docs/images/streams-architecture-topology.jpg b/docs/images/streams-architecture-topology.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..f42e8cddf448cff0992158898a76234e544e491b
GIT binary patch
literal 182199
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
Dw+P?z

literal 0
HcmV?d00001

diff --git a/docs/introduction.html b/docs/introduction.html
index 7ff62f9099bc2..7672a5154aa73 100644
--- a/docs/introduction.html
+++ b/docs/introduction.html
@@ -18,7 +18,7 @@
 <script><!--#include virtual="js/templateData.js" --></script>
 
 <script id="introduction-template" type="text/x-handlebars-template">
-  <h3> Kafka is <i>a distributed streaming platform</i>. What exactly does that mean?</h3>
+  <h3> Apache Kafka&trade; is <i>a distributed streaming platform</i>. What exactly does that mean?</h3>
   <p>We think of a streaming platform as having three key capabilities:</p>
   <ol>
     <li>It lets you publish and subscribe to streams of records. In this respect it is similar to a message queue or enterprise messaging system.
@@ -203,17 +203,4 @@ <h4>Putting the Pieces Together</h4>
   </p>
 </script>
 
-<!--#include virtual="../includes/_header.htm" -->
-<!--#include virtual="../includes/_top.htm" -->
-<div class="content documentation documentation--current">
-	<!--#include virtual="../includes/_nav.htm" -->
-	<div class="right">
-    <div class="p-introduction"></div>
-  </div>
-</div>
-<!--#include virtual="../includes/_footer.htm" -->
-
-<script>
-// Show selected style on nav item
-$(function() { $('.b-nav__intro').addClass('selected'); });
-</script>
+<div class="p-introduction"></div>
\ No newline at end of file
diff --git a/docs/js/templateData.js b/docs/js/templateData.js
index fbb9e4e1b0986..b4aedf56abfad 100644
--- a/docs/js/templateData.js
+++ b/docs/js/templateData.js
@@ -17,6 +17,6 @@ limitations under the License.
 
 // Define variables for doc templates
 var context={
-    "version": "0101"
-    "dotVersion": "0.10.1"
+    "version": "0102",
+    "dotVersion": "0.10.2"
 };
\ No newline at end of file
diff --git a/docs/migration.html b/docs/migration.html
index db5fe60432d46..08a62715d675a 100644
--- a/docs/migration.html
+++ b/docs/migration.html
@@ -15,7 +15,7 @@
  limitations under the License.
 -->
 
-<!--#include virtual="../includes/_header.html" -->
+<!--#include virtual="../includes/_header.htm" -->
 <h2><a id="migration" href="#migration">Migrating from 0.7.x to 0.8</a></h2>
 
 0.8 is our first (and hopefully last) release with a non-backwards-compatible wire protocol, ZooKeeper     layout, and on-disk data format. This was a chance for us to clean up a lot of cruft and start fresh. This means performing a no-downtime upgrade is more painful than normal&mdash;you cannot just swap in the new code in-place.
@@ -31,4 +31,4 @@ <h3><a id="migration_steps" href="#migration_steps">Migration Steps</a></h3>
     <li>Drink.
 </ol>
 
-<!--#include virtual="../includes/_footer.html" -->
+<!--#include virtual="../includes/_footer.htm" -->
diff --git a/docs/protocol.html b/docs/protocol.html
index 5285f2e3ec8a1..40422237e1f73 100644
--- a/docs/protocol.html
+++ b/docs/protocol.html
@@ -15,10 +15,10 @@
  limitations under the License.
 -->
 
-<!--#include virtual="../includes/_header.html" -->
-<!--#include virtual="../includes/_top.html" -->
+<!--#include virtual="../includes/_header.htm" -->
+<!--#include virtual="../includes/_top.htm" -->
 <div class="content">
-    <!--#include virtual="../includes/_nav.html" -->
+    <!--#include virtual="../includes/_nav.htm" -->
     <div class="right">
         <h1>Kafka protocol guide</h1>
 
@@ -227,4 +227,4 @@ <h4><a id="protocol_philosophy" href="#protocol_philosophy">Some Common Philosop
         $(function() { $('.b-nav__project').addClass('selected'); });
     </script>
 
-<!--#include virtual="../includes/_footer.html" -->
+<!--#include virtual="../includes/_footer.htm" -->
diff --git a/docs/quickstart.html b/docs/quickstart.html
index 2080cc4dbd746..bfc9af3f7221f 100644
--- a/docs/quickstart.html
+++ b/docs/quickstart.html
@@ -15,6 +15,9 @@
  limitations under the License.
 -->
 
+<script><!--#include virtual="js/templateData.js" --></script>
+
+<script id="quickstart-template" type="text/x-handlebars-template">
 <p>
 This tutorial assumes you are starting fresh and have no existing Kafka or ZooKeeper data.
 Since Kafka console scripts are different for Unix-based and Windows platforms, on Windows platforms use <code>bin\windows\</code> instead of <code>bin/</code>, and change the script extension to <code>.bat</code>.
@@ -418,15 +421,16 @@ <h4><a id="quickstart_kafkastreams" href="#quickstart_kafkastreams">Step 8: Use
 The second column shows the change records that result from state updates to the KTable and that are being sent to the output Kafka topic <b>streams-wordcount-output</b>.
 </p>
 
+<img src="/{{version}}/images/streams-table-updates-02.png" style="float: right; width: 25%;">
+<img src="/{{version}}/images/streams-table-updates-01.png" style="float: right; width: 25%;">
+
 <p>
 First the text line “all streams lead to kafka” is being processed.
 The <code>KTable</code> is being built up as each new word results in a new table entry (highlighted with a green background), and a corresponding change record is sent to the downstream <code>KStream</code>.
 </p>
-<img class="centered" src="/{{version}}/images/streams-table-updates-01.png">
 <p>
 When the second text line “hello kafka streams” is processed, we observe, for the first time, that existing entries in the <code>KTable</code> are being updated (here: for the words “kafka” and for “streams”). And again, change records are being sent to the output topic.
 </p>
-<img class="centered" src="/{{version}}/images/streams-table-updates-01.png">
 <p>
 And so on (we skip the illustration of how the third line is being processed). This explains why the output topic has the contents we showed above, because it contains the full record of changes.
 </p>
@@ -442,3 +446,7 @@ <h4><a id="quickstart_kafkastreams" href="#quickstart_kafkastreams">Step 8: Use
 </p>
 
 <p>You can stop the console consumer via <b>Ctrl-C</b>.</p>
+
+</script>
+
+<div class="p-quickstart"></div>
\ No newline at end of file
diff --git a/docs/streams.html b/docs/streams.html
index 3e9334b2d3250..19af2b326ccf5 100644
--- a/docs/streams.html
+++ b/docs/streams.html
@@ -1,23 +1,23 @@
-<!--~
-  ~ Licensed to the Apache Software Foundation (ASF) under one or more
-  ~ contributor license agreements.  See the NOTICE file distributed with
-  ~ this work for additional information regarding copyright ownership.
-  ~ The ASF licenses this file to You under the Apache License, Version 2.0
-  ~ (the "License"); you may not use this file except in compliance with
-  ~ the License.  You may obtain a copy of the License at
-  ~
-  ~    http://www.apache.org/licenses/LICENSE-2.0
-  ~
-  ~ Unless required by applicable law or agreed to in writing, software
-  ~ distributed under the License is distributed on an "AS IS" BASIS,
-  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  ~ See the License for the specific language governing permissions and
-  ~ limitations under the License.
-  ~-->
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements.  See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License.  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
 
 <script><!--#include virtual="js/templateData.js" --></script>
 
-<pre id="streams-template" type="text/x-handlebars-template">
+<script id="streams-template" type="text/x-handlebars-template">
     <h1>Streams</h1>
 
         <ol class="toc">
@@ -25,18 +25,21 @@ <h1>Streams</h1>
                 <a href="#streams_overview">Overview</a>
             </li>
             <li>
-                <a href="#streams_concepts">Overview</a>
+                <a href="#streams_concepts">Core Concepts</a>
             </li>
             <li>
-                <a href="#streams_developer">Developer guide</a>
+                <a href="#streams_architecture">Architecture</a>
+            </li>
+            <li>
+                <a href="#streams_developer">Developer Guide</a>
                 <ul>
-                    <li><a href="#streams_concepts">Core concepts</a>
-                    <li><a href="#streams_processor">Low-level processor API</a>
-                    <li><a href="#streams_dsl">High-level streams DSL</a>
+                    <li><a href="#streams_processor">Low-level Processor API</a></li>
+                    <li><a href="#streams_dsl">High-level Streams DSL</a></li>
+                    <li><a href="#streams_execute">Application Configuration and Execution</a></li>
                 </ul>
             </li>
             <li>
-                <a href="#streams_upgrade">Upgrade guide and API changes</a>
+                <a href="#streams_upgrade">Upgrade Guide and API Changes</a>
             </li>
         </ol>
 
@@ -44,6 +47,8 @@ <h2><a id="streams_overview" href="#streams_overview">Overview</a></h2>
 
         <p>
         Kafka Streams is a client library for processing and analyzing data stored in Kafka and either write the resulting data back to Kafka or send the final output to an external system. It builds upon important stream processing concepts such as properly distinguishing between event time and processing time, windowing support, and simple yet efficient management of application state.
+        </p>
+        <p>
         Kafka Streams has a <b>low barrier to entry</b>: You can quickly write and run a small-scale proof-of-concept on a single machine; and you only need to run additional instances of your application on multiple machines to scale up to high-volume production workloads. Kafka Streams transparently handles the load balancing of multiple instances of the same application by leveraging Kafka's parallelism model.
         </p>
         <p>
@@ -53,28 +58,35 @@ <h2><a id="streams_overview" href="#streams_overview">Overview</a></h2>
         <ul>
             <li>Designed as a <b>simple and lightweight client library</b>, which can be easily embedded in any Java application and integrated with any existing packaging, deployment and operational tools that users have for their streaming applications.</li>
             <li>Has <b>no external dependencies on systems other than Apache Kafka itself</b> as the internal messaging layer; notably, it uses Kafka's partitioning model to horizontally scale processing while maintaining strong ordering guarantees.</li>
-            <li>Supports <b>fault-tolerant local state</b>, which enables very fast and efficient stateful operations like joins and aggregations.</li>
+            <li>Supports <b>fault-tolerant local state</b>, which enables very fast and efficient stateful operations like windowed joins and aggregations.</li>
             <li>Employs <b>one-record-at-a-time processing</b> to achieve millisecond processing latency, and supports <b>event-time based windowing operations</b> with late arrival of records.</li>
             <li>Offers necessary stream processing primitives, along with a <b>high-level Streams DSL</b> and a <b>low-level Processor API</b>.</li>
 
         </ul>
         <br>
 
-        <h2><a id="streams_concepts" href="#streams_concepts">Overview</a></h2>
+        <h2><a id="streams_concepts" href="#streams_concepts">Core Concepts</a></h2>
 
         <p>
             We first summarize the key concepts of Kafka Streams.
         </p>
 
-        <h5><a id="streams_topology" href="#streams_topology">Stream Processing Topology</a></h5>
+        <h3><a id="streams_topology" href="#streams_topology">Stream Processing Topology</a></h3>
 
         <ul>
             <li>A <b>stream</b> is the most important abstraction provided by Kafka Streams: it represents an unbounded, continuously updating data set. A stream is an ordered, replayable, and fault-tolerant sequence of immutable data records, where a <b>data record</b> is defined as a key-value pair.</li>
             <li>A <b>stream processing application</b> is any program that makes use of the Kafka Streams library. It defines its computational logic through one or more <b>processor topologies</b>, where a processor topology is a graph of stream processors (nodes) that are connected by streams (edges).</li>
             <li>A <b>stream processor</b> is a node in the processor topology; it represents a processing step to transform data in streams by receiving one input record at a time from its upstream processors in the topology, applying its operation to it, and may subsequently produce one or more output records to its downstream processors. </li>
         </ul>
-        <img class="centered" src="/{{version}}/images/streams-concepts-topology.jpg">
 
+        There are two special processors in the topology:
+
+        <ul>
+            <li><b>Source Processor</b>: A source processor is a special type of stream processor that does not have any upstream processors. It produces an input stream to its topology from one or multiple Kafka topics by consuming records from these topics and forward them to its down-stream processors.</li>
+            <li><b>Sink Processor</b>: A sink processor is a special type of stream processor that does not have down-stream processors. It sends any received records from its up-stream processors to a specified Kafka topic.</li>
+        </ul>
+
+        <img class="centered" src="/{{version}}/images/streams-architecture-topology.jpg" style="width:400px">
 
         <p>
             Kafka Streams offers two ways to define the stream processing topology: the <a href="#streams_dsl"><b>Kafka Streams DSL</b></a> provides
@@ -82,7 +94,12 @@ <h5><a id="streams_topology" href="#streams_topology">Stream Processing Topology
             developers define and connect custom processors as well as to interact with <a href="#streams_state">state stores</a>.
         </p>
 
-        <h5><a id="streams_time" href="#streams_time">Time</a></h5>
+        <p>
+            A processor topology is merely a logical abstraction for your stream processing code.
+            At runtime, the logical topology is instantiated and replicated inside the application for parallel processing (see <a href="#streams_architecture_tasks">Stream Partitions and Tasks</a> for details).
+        </p>
+
+        <h3><a id="streams_time" href="#streams_time">Time</a></h3>
 
         <p>
             A critical aspect in stream processing is the notion of <b>time</b>, and how it is modeled and integrated.
@@ -95,7 +112,7 @@ <h5><a id="streams_time" href="#streams_time">Time</a></h5>
         <ul>
             <li><b>Event time</b> - The point in time when an event or data record occurred, i.e. was originally created "at the source". <b>Example:</b> If the event is a geo-location change reported by a GPS sensor in a car, then the associated event-time would be the time when the GPS sensor captured the location change.</li>
             <li><b>Processing time</b> - The point in time when the event or data record happens to be processed by the stream processing application, i.e. when the record is being consumed. The processing time may be milliseconds, hours, or days etc. later than the original event time. <b>Example:</b> Imagine an analytics application that reads and processes the geo-location data reported from car sensors to present it to a fleet management dashboard. Here, processing-time in the analytics application might be milliseconds or seconds (e.g. for real-time pipelines based on Apache Kafka and Kafka Streams) or hours (e.g. for batch pipelines based on Apache Hadoop or Apache Spark) after event-time.</li>
-            <li><b>Ingestion time</b> - The point in time when an event or data record is stored in a topic partition by a Kafka broker. The difference to event time is that this ingestion timestamp is generated when the record is appended to the target topic by the Kafka broker, not when the record is created "at the source". The difference to processing time is that processing time is when the stream processing application processes the record. <b>For example,</b> if a record is never processed, there is no notion of processing time for it, but it still has an ingestion time.
+            <li><b>Ingestion time</b> - The point in time when an event or data record is stored in a topic partition by a Kafka broker. The difference to event time is that this ingestion timestamp is generated when the record is appended to the target topic by the Kafka broker, not when the record is created "at the source". The difference to processing time is that processing time is when the stream processing application processes the record. <b>For example,</b> if a record is never processed, there is no notion of processing time for it, but it still has an ingestion time.</li>
         </ul>
         <p>
             The choice between event-time and ingestion-time is actually done through the configuration of Kafka (not Kafka Streams): From Kafka 0.10.x onwards, timestamps are automatically embedded into Kafka messages. Depending on Kafka's configuration these timestamps represent event-time or ingestion-time. The respective Kafka configuration setting can be specified on the broker level or per topic. The default timestamp extractor in Kafka Streams will retrieve these embedded timestamps as-is. Hence, the effective time semantics of your application depend on the effective Kafka configuration for these embedded timestamps.
@@ -113,14 +130,15 @@ <h5><a id="streams_time" href="#streams_time">Time</a></h5>
 
         <p>
             Finally, whenever a Kafka Streams application writes records to Kafka, then it will also assign timestamps to these new records. The way the timestamps are assigned depends on the context:
+        </p>
+
         <ul>
             <li> When new output records are generated via processing some input record, for example, <code>context.forward()</code> triggered in the <code>process()</code> function call, output record timestamps are inherited from input record timestamps directly.</li>
             <li> When new output records are generated via periodic functions such as <code>punctuate()</code>, the output record timestamp is defined as the current internal time (obtained through <code>context.timestamp()</code>) of the stream task.</li>
             <li> For aggregations, the timestamp of a resulting aggregate update record will be that of the latest arrived input record that triggered the update.</li>
         </ul>
-        </p>
 
-        <h5><a id="streams_state" href="#streams_state">States</a></h5>
+        <h3><a id="streams_state" href="#streams_state">States</a></h3>
 
         <p>
             Some stream processing applications don't require state, which means the processing of a message is independent from
@@ -140,26 +158,143 @@ <h5><a id="streams_state" href="#streams_state">States</a></h5>
         </p>
         <br>
 
+        <h2><a id="streams_architecture" href="#streams_architecture">Architecture</a></h2>
+
+        Kafka Streams simplifies application development by building on the Kafka producer and consumer libraries and leveraging the native capabilities of
+        Kafka to offer data parallelism, distributed coordination, fault tolerance, and operational simplicity. In this section, we describe how Kafka Streams works underneath the covers.
+
+        <p>
+        The picture below shows the anatomy of an application that uses the Kafka Streams library. Let's walk through some details.
+        </p>
+        <img class="centered" src="/{{version}}/images/streams-architecture-overview.jpg" style="width:750px">
+
+        <h3><a id="streams_architecture_tasks" href="#streams_architecture_tasks">Stream Partitions and Tasks</a></h3>
+
+        <p>
+        The messaging layer of Kafka partitions data for storing and transporting it. Kafka Streams partitions data for processing it.
+        In both cases, this partitioning is what enables data locality, elasticity, scalability, high performance, and fault tolerance.
+        Kafka Streams uses the concepts of <b>partitions</b> and <b>tasks</b> as logical units of its parallelism model based on Kafka topic partitions.
+        There are close links between Kafka Streams and Kafka in the context of parallelism:
+        </p>
+
+        <ul>
+            <li>Each <b>stream partition</b> is a totally ordered sequence of data records and maps to a Kafka <b>topic partition</b>.</li>
+            <li>A <b>data record</b> in the stream maps to a Kafka <b>message</b> from that topic.</li>
+            <li>The <b>keys</b> of data records determine the partitioning of data in both Kafka and Kafka Streams, i.e., how data is routed to specific partitions within topics.</li>
+        </ul>
+
+        <p>
+        An application's processor topology is scaled by breaking it into multiple tasks.
+        More specifically, Kafka Streams creates a fixed number of tasks based on the input stream partitions for the application,
+        with each task assigned a list of partitions from the input streams (i.e., Kafka topics). The assignment of partitions to tasks
+        never changes so that each task is a fixed unit of parallelism of the application. Tasks can then instantiate their own processor topology
+        based on the assigned partitions; they also maintain a buffer for each of its assigned partitions and process messages one-at-a-time from
+        these record buffers. As a result stream tasks can be processed independently and in parallel without manual intervention.
+        </p>
+
+        <p>
+        It is important to understand that Kafka Streams is not a resource manager, but a library that “runs” anywhere its stream processing application runs.
+        Multiple instances of the application are executed either on the same machine, or spread across multiple machines and tasks can be distributed automatically
+        by the library to those running application instances. The assignment of partitions to tasks never changes; if an application instance fails, all its assigned
+        tasks will be automatically restarted on other instances and continue to consume from the same stream partitions.
+        </p>
+
+        <p>
+        The following diagram shows two tasks each assigned with one partition of the input streams.
+        </p>
+        <img class="centered" src="/{{version}}/images/streams-architecture-tasks.jpg" style="width:400px">
+        <br>
+
+        <h3><a id="streams_architecture_threads" href="#streams_architecture_threads">Threading Model</a></h3>
+
+        <p>
+        Kafka Streams allows the user to configure the number of <b>threads</b> that the library can use to parallelize processing within an application instance.
+        Each thread can execute one or more tasks with their processor topologies independently. For example, the following diagram shows one stream thread running two stream tasks.
+        </p>
+        <img class="centered" src="/{{version}}/images/streams-architecture-threads.jpg" style="width:400px">
+
+        <p>
+        Starting more stream threads or more instances of the application merely amounts to replicating the topology and having it process a different subset of Kafka partitions, effectively parallelizing processing.
+        It is worth noting that there is no shared state amongst the threads, so no inter-thread coordination is necessary. This makes it very simple to run topologies in parallel across the application instances and threads.
+        The assignment of Kafka topic partitions amongst the various stream threads is transparently handled by Kafka Streams leveraging <a href="https://cwiki.apache.org/confluence/display/KAFKA/Kafka+Client-side+Assignment+Proposal">Kafka's coordination</a> functionality.
+        </p>
+
+        <p>
+        As we described above, scaling your stream processing application with Kafka Streams is easy: you merely need to start additional instances of your application,
+        and Kafka Streams takes care of distributing partitions amongst tasks that run in the application instances. You can start as many threads of the application
+        as there are input Kafka topic partitions so that, across all running instances of an application, every thread (or rather, the tasks it runs) has at least one input partition to process.
+        </p>
+        <br>
+
+        <h3><a id="streams_architecture_state" href="#streams_architecture_state">Local State Stores</a></h3>
+
+        <p>
+        Kafka Streams provides so-called <b>state stores</b>, which can be used by stream processing applications to store and query data,
+        which is an important capability when implementing stateful operations. The <a href="streams_dsl">Kafka Streams DSL</a>, for example, automatically creates
+        and manages such state stores when you are calling stateful operators such as <code>join()</code> or <code>aggregate()</code>, or when you are windowing a stream.
+        </p>
+
+        <p>
+        Every stream task in a Kafka Streams application may embed one or more local state stores that can be accessed via APIs to store and query data required for processing.
+        Kafka Streams offers fault-tolerance and automatic recovery for such local state stores.
+        </p>
+
+        <p>
+        The following diagram shows two stream tasks with their dedicated local state stores.
+        </p>
+        <img class="centered" src="/{{version}}/images/streams-architecture-states.jpg" style="width:400px">
+        <br>
+
+        <h3><a id="streams_architecture_recovery" href="#streams_architecture_recovery">Fault Tolerance</a></h3>
+
+        <p>
+        Kafka Streams builds on fault-tolerance capabilities integrated natively within Kafka. Kafka partitions are highly available and replicated; so when stream data is persisted to Kafka it is available
+        even if the application fails and needs to re-process it. Tasks in Kafka Streams leverage the fault-tolerance capability
+        offered by the <a href="https://www.confluent.io/blog/tutorial-getting-started-with-the-new-apache-kafka-0.9-consumer-client/">Kafka consumer client</a> to handle failures.
+        If a task runs on a machine that fails, Kafka Streams automatically restarts the task in one of the remaining running instances of the application.
+        </p>
+
+        <p>
+        In addition, Kafka Streams makes sure that the local state stores are robust to failures, too. For each state store, it maintains a replicated changelog Kafka topic in which it tracks any state updates.
+        These changelog topics are partitioned as well so that each local state store instance, and hence the task accessing the store, has its own dedicated changelog topic partition.
+        <a href="/documentation/#compaction">Log compaction</a> is enabled on the changelog topics so that old data can be purged safely to prevent the topics from growing indefinitely.
+        If tasks run on a machine that fails and are restarted on another machine, Kafka Streams guarantees to restore their associated state stores to the content before the failure by
+        replaying the corresponding changelog topics prior to resuming the processing on the newly started tasks. As a result, failure handling is completely transparent to the end user.
+        </p>
+
+        <p>
+        Note that the cost of task (re)initialization typically depends primarily on the time for restoring the state by replaying the state stores' associated changelog topics.
+        To minimize this restoration time, users can configure their applications to have <b>standby replicas</b> of local states (i.e. fully replicated copies of the state).
+        When a task migration happens, Kafka Streams then attempts to assign a task to an application instance where such a standby replica already exists in order to minimize
+        the task (re)initialization cost. See <code>num.standby.replicas</code> at the <a href="/documentation/#streamsconfigs">Kafka Streams Configs</a> Section.
+        </p>
+        <br>
+
         <h2><a id="streams_developer" href="#streams_developer">Developer Guide</a></h2>
 
         <p>
-        There is a <a href="#quickstart_kafkastreams">quickstart</a> example that provides how to run a stream processing program coded in the Kafka Streams library.
+        There is a <a href="/documentation/#quickstart_kafkastreams">quickstart</a> example that provides how to run a stream processing program coded in the Kafka Streams library.
         This section focuses on how to write, configure, and execute a Kafka Streams application.
         </p>
 
-
         <p>
         As we have mentioned above, the computational logic of a Kafka Streams application is defined as a <a href="#streams_topology">processor topology</a>.
         Currently Kafka Streams provides two sets of APIs to define the processor topology, which will be described in the subsequent sections.
         </p>
 
-        <h4><a id="streams_processor" href="#streams_processor">Low-Level Processor API</a></h4>
+        <h3><a id="streams_processor" href="#streams_processor">Low-Level Processor API</a></h3>
 
-        <h5><a id="streams_processor_process" href="#streams_processor_process">Processor</a></h5>
+        <h4><a id="streams_processor_process" href="#streams_processor_process">Processor</a></h4>
+
+        <p>
+        As mentioned in the <a href="#streams_concepts">Core Concepts</a> section, a stream processor is a node in the processor topology that represents a single processing step.
+        With the <code>Processor</code> API developers can define arbitrary stream processors that process one received record at a time, and connect these processors with
+        their associated state stores to compose the processor topology that represents their customized processing logic.
+        </p>
 
         <p>
-        Developers can define their customized processing logic by implementing the <code>Processor</code> interface, which
-        provides <code>process</code> and <code>punctuate</code> methods. The <code>process</code> method is performed on each
+        The <code>Processor</code> interface provides two main API methods:
+        <code>process</code> and <code>punctuate</code>. The <code>process</code> method is performed on each
         of the received record; and the <code>punctuate</code> method is performed periodically based on elapsed time.
         In addition, the processor can maintain the current <code>ProcessorContext</code> instance variable initialized in the
         <code>init</code> method, and use the context to schedule the punctuation period (<code>context().schedule</code>), to
@@ -167,17 +302,26 @@ <h5><a id="streams_processor_process" href="#streams_processor_process">Processo
         processing progress (<code>context().commit</code>), etc.
         </p>
 
+        <p>
+        The following example <code>Processor</code> implementation defines a simple word-count algorithm:
+        </p>
+
         <pre>
             public class MyProcessor extends Processor&lt;String, String&gt; {
                 private ProcessorContext context;
-                private KeyValueStore&lt;String, Integer&gt; kvStore;
+                private KeyValueStore&lt;String, Long&gt; kvStore;
 
                 @Override
                 @SuppressWarnings("unchecked")
                 public void init(ProcessorContext context) {
+                    // keep the processor context locally because we need it in punctuate() and commit()
                     this.context = context;
+
+                    // call this processor's punctuate() method every 1000 milliseconds.
                     this.context.schedule(1000);
-                    this.kvStore = (KeyValueStore&lt;String, Integer&gt;) context.getStateStore("Counts");
+
+                    // retrieve the key-value store named "Counts"
+                    this.kvStore = (KeyValueStore&lt;String, Long&gt;) context.getStateStore("Counts");
                 }
 
                 @Override
@@ -185,31 +329,33 @@ <h5><a id="streams_processor_process" href="#streams_processor_process">Processo
                     String[] words = line.toLowerCase().split(" ");
 
                     for (String word : words) {
-                        Integer oldValue = this.kvStore.get(word);
+                        Long oldValue = this.kvStore.get(word);
 
                         if (oldValue == null) {
-                            this.kvStore.put(word, 1);
+                            this.kvStore.put(word, 1L);
                         } else {
-                            this.kvStore.put(word, oldValue + 1);
+                            this.kvStore.put(word, oldValue + 1L);
                         }
                     }
                 }
 
                 @Override
                 public void punctuate(long timestamp) {
-                    KeyValueIterator&lt;String, Integer&gt; iter = this.kvStore.all();
+                    KeyValueIterator&lt;String, Long&gt; iter = this.kvStore.all();
 
                     while (iter.hasNext()) {
-                        KeyValue&lt;String, Integer&gt; entry = iter.next();
+                        KeyValue&lt;String, Long&gt; entry = iter.next();
                         context.forward(entry.key, entry.value.toString());
                     }
 
                     iter.close();
+                    // commit the current processing progress
                     context.commit();
                 }
 
                 @Override
                 public void close() {
+                    // close the key-value store
                     this.kvStore.close();
                 }
             };
@@ -217,31 +363,45 @@ <h5><a id="streams_processor_process" href="#streams_processor_process">Processo
 
         <p>
         In the above implementation, the following actions are performed:
+        </p>
 
         <ul>
             <li>In the <code>init</code> method, schedule the punctuation every 1 second and retrieve the local state store by its name "Counts".</li>
             <li>In the <code>process</code> method, upon each received record, split the value string into words, and update their counts into the state store (we will talk about this feature later in the section).</li>
             <li>In the <code>punctuate</code> method, iterate the local state store and send the aggregated counts to the downstream processor, and commit the current stream state.</li>
         </ul>
-        </p>
 
-        <h5><a id="streams_processor_topology" href="#streams_processor_topology">Processor Topology</a></h5>
+
+        <h4><a id="streams_processor_topology" href="#streams_processor_topology">Processor Topology</a></h4>
 
         <p>
         With the customized processors defined in the Processor API, developers can use the <code>TopologyBuilder</code> to build a processor topology
         by connecting these processors together:
+        </p>
 
         <pre>
             TopologyBuilder builder = new TopologyBuilder();
 
             builder.addSource("SOURCE", "src-topic")
+                // add "PROCESS1" node which takes the source processor "SOURCE" as its upstream processor
+                .addProcessor("PROCESS1", () -> new MyProcessor1(), "SOURCE")
 
-                .addProcessor("PROCESS1", MyProcessor1::new /* the ProcessorSupplier that can generate MyProcessor1 */, "SOURCE")
-                .addProcessor("PROCESS2", MyProcessor2::new /* the ProcessorSupplier that can generate MyProcessor2 */, "PROCESS1")
-                .addProcessor("PROCESS3", MyProcessor3::new /* the ProcessorSupplier that can generate MyProcessor3 */, "PROCESS1")
+                // add "PROCESS2" node which takes "PROCESS1" as its upstream processor
+                .addProcessor("PROCESS2", () -> new MyProcessor2(), "PROCESS1")
+
+                // add "PROCESS3" node which takes "PROCESS1" as its upstream processor
+                .addProcessor("PROCESS3", () -> new MyProcessor3(), "PROCESS1")
 
+                // add the sink processor node "SINK1" that takes Kafka topic "sink-topic1"
+                // as output and the "PROCESS1" node as its upstream processor
                 .addSink("SINK1", "sink-topic1", "PROCESS1")
+
+                // add the sink processor node "SINK2" that takes Kafka topic "sink-topic2"
+                // as output and the "PROCESS2" node as its upstream processor
                 .addSink("SINK2", "sink-topic2", "PROCESS2")
+
+                // add the sink processor node "SINK3" that takes Kafka topic "sink-topic3"
+                // as output and the "PROCESS3" node as its upstream processor
                 .addSink("SINK3", "sink-topic3", "PROCESS3");
         </pre>
 
@@ -252,16 +412,30 @@ <h5><a id="streams_processor_topology" href="#streams_processor_topology">Proces
             <li>Three processor nodes are then added using the <code>addProcessor</code> method; here the first processor is a child of the "SOURCE" node, but is the parent of the other two processors.</li>
             <li>Finally three sink nodes are added to complete the topology using the <code>addSink</code> method, each piping from a different parent processor node and writing to a separate topic.</li>
         </ul>
+
+        <h4><a id="streams_processor_statestore" href="#streams_processor_statestore">State Stores</a></h4>
+
+        <p>
+        Note that the <code>Processor</code> API is not limited to only accessing the current records as they arrive in the <code>process()</code> method, but can also maintain processing states
+        that keep recently arrived records to use in stateful processing operations such as windowed joins or aggregation.
+        To take advantage of these states, users can define a state store by implementing the <code>StateStore</code> interface (the Kafka Streams library also has a few extended interfaces such as <code>KeyValueStore</code>);
+        in practice, though, users usually do not need to customize such a state store from scratch but can simply use the <code>Stores</code> factory to define a state store by specifying whether it should be persistent, log-backed, etc.
+        In the following example, a persistent key-value store named “Counts” with key type <code>String</code> and value type <code>Long</code> is created.
         </p>
 
-        <h5><a id="streams_processor_statestore" href="#streams_processor_statestore">Local State Store</a></h5>
+        <pre>
+            StateStoreSupplier countStore = Stores.create("Counts")
+              .withKeys(Serdes.String())
+              .withValues(Serdes.Long())
+              .persistent()
+              .build();
+        </pre>
 
         <p>
-        Note that the Processor API is not limited to only accessing the current records as they arrive, but can also maintain local state stores
-        that keep recently arrived records to use in stateful processing operations such as aggregation or windowed joins.
-        To take advantage of this local states, developers can use the <code>TopologyBuilder.addStateStore</code> method when building the
+        To take advantage of these state stores, developers can use the <code>TopologyBuilder.addStateStore</code> method when building the
         processor topology to create the local state and associate it with the processor nodes that needs to access it; or they can connect a created
-        local state store with the existing processor nodes through <code>TopologyBuilder.connectProcessorAndStateStores</code>.
+        state store with the existing processor nodes through <code>TopologyBuilder.connectProcessorAndStateStores</code>.
+        </p>
 
         <pre>
             TopologyBuilder builder = new TopologyBuilder();
@@ -269,8 +443,8 @@ <h5><a id="streams_processor_statestore" href="#streams_processor_statestore">Lo
             builder.addSource("SOURCE", "src-topic")
 
                 .addProcessor("PROCESS1", MyProcessor1::new, "SOURCE")
-                // create the in-memory state store "COUNTS" associated with processor "PROCESS1"
-                .addStateStore(Stores.create("COUNTS").withStringKeys().withStringValues().inMemory().build(), "PROCESS1")
+                // add the created state store "COUNTS" associated with processor "PROCESS1"
+                .addStateStore(countStore, "PROCESS1")
                 .addProcessor("PROCESS2", MyProcessor3::new /* the ProcessorSupplier that can generate MyProcessor3 */, "PROCESS1")
                 .addProcessor("PROCESS3", MyProcessor3::new /* the ProcessorSupplier that can generate MyProcessor3 */, "PROCESS1")
 
@@ -282,23 +456,22 @@ <h5><a id="streams_processor_statestore" href="#streams_processor_statestore">Lo
                 .addSink("SINK3", "sink-topic3", "PROCESS3");
         </pre>
 
-        </p>
-
         In the next section we present another way to build the processor topology: the Kafka Streams DSL.
+        <br>
 
-        <h4><a id="streams_dsl" href="#streams_dsl">High-Level Streams DSL</a></h4>
+        <h3><a id="streams_dsl" href="#streams_dsl">High-Level Streams DSL</a></h3>
 
         To build a processor topology using the Streams DSL, developers can apply the <code>KStreamBuilder</code> class, which is extended from the <code>TopologyBuilder</code>.
         A simple example is included with the source code for Kafka in the <code>streams/examples</code> package. The rest of this section will walk
         through some code to demonstrate the key steps in creating a topology using the Streams DSL, but we recommend developers to read the full example source
         codes for details.
 
-        <h5><a id="streams_duality" href="#streams_duality">Duality of Streams and Tables</a></h5>
+        <h4><a id="streams_duality" href="#streams_duality">Duality of Streams and Tables</a></h4>
 
         <p>
         Before we discuss concepts such as aggregations in Kafka Streams we must first introduce tables, and most importantly the relationship between tables and streams:
         the so-called <a href="https://engineering.linkedin.com/distributed-systems/log-what-every-software-engineer-should-know-about-real-time-datas-unifying">stream-table duality</a>.
-        Essentially, this duality means that a stream can be viewed as a table, and vice versa. Kafka’s log compaction feature, for example, exploits this duality.
+        Essentially, this duality means that a stream can be viewed as a table, and vice versa. Kafka's log compaction feature, for example, exploits this duality.
         </p>
 
         <p>
@@ -309,18 +482,18 @@ <h5><a id="streams_duality" href="#streams_duality">Duality of Streams and Table
         The <b>stream-table duality</b> describes the close relationship between streams and tables.
         <ul>
         <li><b>Stream as Table</b>: A stream can be considered a changelog of a table, where each data record in the stream captures a state change of the table. A stream is thus a table in disguise, and it can be easily turned into a “real” table by replaying the changelog from beginning to end to reconstruct the table. Similarly, in a more general analogy, aggregating data records in a stream – such as computing the total number of pageviews by user from a stream of pageview events – will return a table (here with the key and the value being the user and its corresponding pageview count, respectively).</li>
-        <li><b>Table as Stream</b>: A table can be considered a snapshot, at a point in time, of the latest value for each key in a stream (a stream’s data records are key-value pairs). A table is thus a stream in disguise, and it can be easily turned into a “real” stream by iterating over each key-value entry in the table.</li>
+        <li><b>Table as Stream</b>: A table can be considered a snapshot, at a point in time, of the latest value for each key in a stream (a stream's data records are key-value pairs). A table is thus a stream in disguise, and it can be easily turned into a “real” stream by iterating over each key-value entry in the table.</li>
         </ul>
 
         <p>
-        Let’s illustrate this with an example. Imagine a table that tracks the total number of pageviews by user (first column of diagram below). Over time, whenever a new pageview event is processed, the state of the table is updated accordingly. Here, the state changes between different points in time – and different revisions of the table – can be represented as a changelog stream (second column).
+        Let's illustrate this with an example. Imagine a table that tracks the total number of pageviews by user (first column of diagram below). Over time, whenever a new pageview event is processed, the state of the table is updated accordingly. Here, the state changes between different points in time – and different revisions of the table – can be represented as a changelog stream (second column).
         </p>
-        <img class="centered" src="/{{version}}/images/streams-table-duality-02.png">
+        <img class="centered" src="/{{version}}/images/streams-table-duality-02.png" style="width:300px">
 
         <p>
         Interestingly, because of the stream-table duality, the same stream can be used to reconstruct the original table (third column):
         </p>
-        <img class="centered" src="/{{version}}/images/streams-table-duality-03.png">
+        <img class="centered" src="/{{version}}/images/streams-table-duality-03.png" style="width:600px">
 
         <p>
         The same mechanism is used, for example, to replicate databases via change data capture (CDC) and, within Kafka Streams, to replicate its so-called state stores across machines for fault-tolerance.
@@ -330,7 +503,7 @@ <h5><a id="streams_duality" href="#streams_duality">Duality of Streams and Table
         <h5><a id="streams_kstream_ktable" href="#streams_kstream_ktable">KStream and KTable</a></h5>
         The DSL uses two main abstractions. A <b>KStream</b> is an abstraction of a record stream, where each data record represents a self-contained datum in the unbounded data set.
         A <b>KTable</b> is an abstraction of a changelog stream, where each data record represents an update. More precisely, the value in a data record is considered to be an update of the last value for the same record key,
-        if any (if a corresponding key doesn't exist yet, the update will be considered a create). To illustrate the difference between KStreams and KTables, let’s imagine the following two data records are being sent to the stream:
+        if any (if a corresponding key doesn't exist yet, the update will be considered a create). To illustrate the difference between KStreams and KTables, let's imagine the following two data records are being sent to the stream:
 
         <pre>
             ("alice", 1) --> ("alice", 3)
@@ -338,7 +511,7 @@ <h5><a id="streams_kstream_ktable" href="#streams_kstream_ktable">KStream and KT
 
         If these records a KStream and the stream processing application were to sum the values it would return <code>4</code>. If these records were a KTable, the return would be <code>3</code>, since the last record would be considered as an update.
 
-        <h5><a id="streams_dsl_source" href="#streams_dsl_source">Create Source Streams from Kafka</a></h5>
+        <h4><a id="streams_dsl_source" href="#streams_dsl_source">Create Source Streams from Kafka</a></h4>
 
         <p>
         Either a <b>record stream</b> (defined as <code>KStream</code>) or a <b>changelog stream</b> (defined as <code>KTable</code>)
@@ -353,7 +526,7 @@ <h5><a id="streams_dsl_source" href="#streams_dsl_source">Create Source Streams
             KTable&lt;String, GenericRecord&gt; source2 = builder.table("topic3", "stateStoreName");
         </pre>
 
-        <h5><a id="streams_dsl_windowing" href="#streams_dsl_windowing">Windowing a stream</a></h5>
+        <h4><a id="streams_dsl_windowing" href="#streams_dsl_windowing">Windowing a stream</a></h4>
         A stream processor may need to divide data records into time buckets, i.e. to <b>window</b> the stream by time. This is usually needed for join and aggregation operations, etc. Kafka Streams currently defines the following types of windows:
         <ul>
         <li><b>Hopping time windows</b> are windows based on time intervals. They model fixed-sized, (possibly) overlapping windows. A hopping window is defined by two properties: the window's size and its advance interval (aka "hop"). The advance interval specifies by how much a window moves forward relative to the previous one. For example, you can configure a hopping window with a size 5 minutes and an advance interval of 1 minute. Since hopping windows can overlap a data record may belong to more than one such windows.</li>
@@ -367,12 +540,12 @@ <h5><a id="streams_dsl_windowing" href="#streams_dsl_windowing">Windowing a stre
         </p>
 
         <p>
-        Late-arriving records are always possible in real-time data streams. However, it depends on the effective <a href="#streams_team">time semantics</a> how late records are handled. Using processing-time, the semantics are “when the data is being processed”,
+        Late-arriving records are always possible in real-time data streams. However, it depends on the effective <a href="#streams_time">time semantics</a> how late records are handled. Using processing-time, the semantics are “when the data is being processed”,
         which means that the notion of late records is not applicable as, by definition, no record can be late. Hence, late-arriving records only really can be considered as such (i.e. as arriving “late”) for event-time or ingestion-time semantics. In both cases,
         Kafka Streams is able to properly handle late-arriving records.
         </p>
 
-        <h5><a id="streams_dsl_joins" href="#streams_dsl_joins">Join multiple streams</a></h5>
+        <h4><a id="streams_dsl_joins" href="#streams_dsl_joins">Join multiple streams</a></h4>
         A <b>join</b> operation merges two streams based on the keys of their data records, and yields a new stream. A join over record streams usually needs to be performed on a windowing basis because otherwise the number of records that must be maintained for performing the join may grow indefinitely. In Kafka Streams, you may perform the following join operations:
         <ul>
         <li><b>KStream-to-KStream Joins</b> are always windowed joins, since otherwise the memory and state required to compute the join would grow infinitely in size. Here, a newly received record from one of the streams is joined with the other stream's records within the specified window interval to produce one result for each matching pair based on user-provided <code>ValueJoiner</code>. A new <code>KStream</code> instance representing the result stream of the join is returned from this operator.</li>
@@ -392,7 +565,7 @@ <h5><a id="streams_dsl_aggregations" href="#streams_dsl_aggregations">Aggregate
         When such late arrival happens, the aggregating <code>KStream</code> or <code>KTable</code> simply emits a new aggregate value. Because the output is a <code>KTable</code>, the new value is considered to overwrite the old value with the same key in subsequent processing steps.
         </p>
 
-        <h5><a id="streams_dsl_transform" href="#streams_dsl_transform">Transform a stream</a></h5>
+        <h4><a id="streams_dsl_transform" href="#streams_dsl_transform">Transform a stream</a></h4>
 
         <p>
         Besides join and aggregation operations, there is a list of other transformation operations provided for <code>KStream</code> and <code>KTable</code> respectively.
@@ -439,7 +612,7 @@ <h5><a id="streams_dsl_transform" href="#streams_dsl_transform">Transform a stre
             );
         </pre>
 
-        <h5><a id="streams_dsl_sink" href="#streams_dsl_sink">Write streams back to Kafka</a></h5>
+        <h4><a id="streams_dsl_sink" href="#streams_dsl_sink">Write streams back to Kafka</a></h4>
 
         <p>
         At the end of the processing, users can choose to (continuously) write the final resulted streams back to a Kafka topic through
@@ -461,96 +634,223 @@ <h5><a id="streams_dsl_sink" href="#streams_dsl_sink">Write streams back to Kafk
             // materialized = builder.stream("topic4");
             KStream&lt;String, String&gt; materialized = joined.through("topic4");
         </pre>
+        <br>
 
+        <h3><a id="streams_execute" href="#streams_execute">Application Configuration and Execution</a></h3>
 
-        <br>
         <p>
         Besides defining the topology, developers will also need to configure their applications
         in <code>StreamsConfig</code> before running it. A complete list of
-        Kafka Streams configs can be found <a href="#streamsconfigs"><b>here</b></a>.
+        Kafka Streams configs can be found <a href="/documentation/#streamsconfigs"><b>here</b></a>.
         </p>
 
-        <h2><a id="streams_upgrade" href="#upgrade">Upgrade guide and API changes</a></h2>
+        <p>
+        Specifying the configuration in Kafka Streams is similar to the Kafka Producer and Consumer clients. Typically, you create a <code>java.util.Properties</code> instance,
+        set the necessary parameters, and construct a <code>StreamsConfig</code> instance from the <code>Properties</code> instance.
+        </p>
 
-        <h3><a id="streams_upgrade_1020" href="#upgrade_1020">Upgrading a Kafka Streams Application</a></h3>
+        <pre>
+            import java.util.Properties;
+            import org.apache.kafka.streams.StreamsConfig;
+
+            Properties settings = new Properties();
+            // Set a few key parameters
+            settings.put(StreamsConfig.APPLICATION_ID_CONFIG, "my-first-streams-application");
+            settings.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, "kafka-broker1:9092");
+            settings.put(StreamsConfig.ZOOKEEPER_CONNECT_CONFIG, "zookeeper1:2181");
+            // Any further settings
+            settings.put(... , ...);
+
+            // Create an instance of StreamsConfig from the Properties instance
+            StreamsConfig config = new StreamsConfig(settings);
+        </pre>
 
-        <h4>Upgrading from 0.10.1.x to 0.10.2.0</h4>
         <p>
-        See <a href="../#upgrade_1020_streams">Upgrade Section</a> for details.
+        Apart from Kafka Streams' own configuration parameters you can also specify parameters for the Kafka consumers and producers that are used internally,
+        depending on the needs of your application. Similar to the Streams settings you define any such consumer and/or producer settings via <code>StreamsConfig</code>.
+        Note that some consumer and producer configuration parameters do use the same parameter name. For example, <code>send.buffer.bytes</code> or <code>receive.buffer.bytes</code> which
+        are used to configure TCP buffers; <code>request.timeout.ms</code> and <code>retry.backoff.ms</code> which control retries for client request (and some more).
+        If you want to set different values for consumer and producer for such a parameter, you can prefix the parameter name with <code>consumer.</code> or <code>producer.</code>:
         </p>
 
-        <h3><a id="streams_api_changes" href="#api_changes">Streams API changes in 0.10.2.0</a></h3>
-        <li> New methods in <code>KafkaStreams</code>:
-            <ul>
-                <li> set a listener to react on application state change via <code>#setStateListener(StateListener listener)</code> </li>
-                <li> retrieve the current application state via <code>#state()</code> </li>
-                <li> retrieve the global metrics registry via <code>#metrics()</code> </li>
-                <li> apply a timeout when closing an application via <code>#close(long timeout, TimeUnit timeUnit)</code> </li>
-                <li> specify a custom indent when retrieving Kafka Streams information via <code>#toString(String indent)</code> </li>
-            </ul>
-        </li>
-        <li> Parameter updates in <code>StreamsConfig</code>:
-            <ul>
-                <li> parameter <code>zookeeper.connect</code> was deprecated </li>
-                <ul>
-                    <li> a Kafka Streams application does no longer interact with Zookeeper for topic management but uses the new broker admin protocol
-                         (cf. <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-4+-+Command+line+and+centralized+administrative+operations#KIP-4-Commandlineandcentralizedadministrativeoperations-TopicAdminSchema.1">KIP-4, Section "Topic Admin Schema"</a>) </li>
-                    <li> thus, parameter "zookeeper.connect" is ignored in 0.10.2 and should be removed from <code>StreamsConfig</code> </li>
-                </ul>
-                <li> added many new parameters for metrics, security, and client configurations </li>
-            </ul>
-        </li>
-        <li> Changes in <code>StreamsMetrics</code> interface:
-            <ul>
-                <li> removed methods: <code>#addLatencySensor()</code> </li>
-                <li> added methods: <code>#addLatencyAndThroughputSensor()</code>, <code>#addThroughputSensor()</code>, <code>#recordThroughput()</code>,
-                     <code>#addSensor()</code>, <code>#removeSensor()</code> </li>
-            </ul>
-        </li>
-        <li> New methods in <code>TopologyBuilder</code>:
+        <pre>
+            Properties settings = new Properties();
+            // Example of a "normal" setting for Kafka Streams
+            settings.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, "kafka-broker-01:9092");
+
+            // Customize the Kafka consumer settings
+            streamsSettings.put(ConsumerConfig.SESSION_TIMEOUT_MS_CONFIG, 60000);
+
+            // Customize a common client setting for both consumer and producer
+            settings.put(CommonClientConfigs.RETRY_BACKOFF_MS_CONFIG, 100L);
+
+            // Customize different values for consumer and producer
+            settings.put("consumer." + ConsumerConfig.RECEIVE_BUFFER_CONFIG, 1024 * 1024);
+            settings.put("producer." + ProducerConfig.RECEIVE_BUFFER_CONFIG, 64 * 1024);
+            // Alternatively, you can use
+            settings.put(StreamsConfig.consumerPrefix(ConsumerConfig.RECEIVE_BUFFER_CONFIG), 1024 * 1024);
+            settings.put(StremasConfig.producerConfig(ProducerConfig.RECEIVE_BUFFER_CONFIG), 64 * 1024);
+        </pre>
+
+        <p>
+        You can call Kafka Streams from anywhere in your application code.
+        Very commonly though you would do so within the <code>main()</code> method of your application, or some variant thereof.
+        </p>
+
+        <p>
+        First, you must create an instance of <code>KafkaStreams</code>. The first argument of the <code>KafkaStreams</code> constructor takes a topology
+        builder (either <code>KStreamBuilder</code> for the Kafka Streams DSL, or <code>TopologyBuilder</code> for the Processor API)
+        that is used to define a topology; The second argument is an instance of <code>StreamsConfig</code> mentioned above.
+        </p>
+
+        <pre>
+            import org.apache.kafka.streams.KafkaStreams;
+            import org.apache.kafka.streams.StreamsConfig;
+            import org.apache.kafka.streams.kstream.KStreamBuilder;
+            import org.apache.kafka.streams.processor.TopologyBuilder;
+
+            // Use the builders to define the actual processing topology, e.g. to specify
+            // from which input topics to read, which stream operations (filter, map, etc.)
+            // should be called, and so on.
+
+            KStreamBuilder builder = ...;  // when using the Kafka Streams DSL
+            //
+            // OR
+            //
+            TopologyBuilder builder = ...; // when using the Processor API
+
+            // Use the configuration to tell your application where the Kafka cluster is,
+            // which serializers/deserializers to use by default, to specify security settings,
+            // and so on.
+            StreamsConfig config = ...;
+
+            KafkaStreams streams = new KafkaStreams(builder, config);
+        </pre>
+
+        <p>
+        At this point, internal structures have been initialized, but the processing is not started yet. You have to explicitly start the Kafka Streams thread by calling the <code>start()</code> method:
+        </p>
+
+        <pre>
+            // Start the Kafka Streams instance
+            streams.start();
+        </pre>
+
+        <p>
+        To catch any unexpected exceptions, you may set an <code>java.lang.Thread.UncaughtExceptionHandler</code> before you start the application. This handler is called whenever a stream thread is terminated by an unexpected exception:
+        </p>
+
+        <pre>
+            streams.setUncaughtExceptionHandler(new Thread.UncaughtExceptionHandler() {
+                public uncaughtException(Thread t, throwable e) {
+                    // here you should examine the exception and perform an appropriate action!
+                }
+            );
+        </pre>
+
+        <p>
+        To stop the application instance call the <code>close()</code> method:
+        </p>
+
+        <pre>
+            // Stop the Kafka Streams instance
+            streams.close();
+        </pre>
+
+        Now it's time to execute your application that uses the Kafka Streams library, which can be run just like any other Java application – there is no special magic or requirement on the side of Kafka Streams.
+        For example, you can package your Java application as a fat jar file and then start the application via:
+
+        <pre>
+            # Start the application in class `com.example.MyStreamsApp`
+            # from the fat jar named `path-to-app-fatjar.jar`.
+            $ java -cp path-to-app-fatjar.jar com.example.MyStreamsApp
+        </pre>
+
+        <p>
+        When the application instance starts running, the defined processor topology will be initialized as one or more stream tasks that can be executed in parallel by the stream threads within the instance.
+        If the processor topology defines any state stores, these state stores will also be (re-)constructed, if possible, during the initialization
+        period of their associated stream tasks.
+        It is important to understand that, when starting your application as described above, you are actually launching what Kafka Streams considers to be one instance of your application.
+        More than one instance of your application may be running at a time, and in fact the common scenario is that there are indeed multiple instances of your application running in parallel (e.g., on another JVM or another machine).
+        In such cases, Kafka Streams transparently re-assigns tasks from the existing instances to the new instance that you just started.
+        See <a href="#streams_architecture_tasks">Stream Partitions and Tasks</a> and <a href="#streams_architecture_threads">Threading Model</a> for details.
+        </p>
+        <br>
+
+        <h2><a id="streams_upgrade" href="#streams_upgrade">Upgrade Guide and API Changes</a></h2>
+
+        <p>
+        See the <a href="/documentation/#upgrade_1020_streams">Upgrade Section</a> for upgrading a Kafka Streams Application from 0.10.1.x to 0.10.2.0.
+        </p>
+
+        <h3><a id="streams_api_changes" href="#streams_api_changes">Streams API changes in 0.10.2.0</a></h3>
+
+        <p>
+            New methods in <code>KafkaStreams</code>:
+        </p>
+        <ul>
+            <li> set a listener to react on application state change via <code>#setStateListener(StateListener listener)</code> </li>
+            <li> retrieve the current application state via <code>#state()</code> </li>
+            <li> retrieve the global metrics registry via <code>#metrics()</code> </li>
+            <li> apply a timeout when closing an application via <code>#close(long timeout, TimeUnit timeUnit)</code> </li>
+            <li> specify a custom indent when retrieving Kafka Streams information via <code>#toString(String indent)</code> </li>
+        </ul>
+
+        <p>
+            Parameter updates in <code>StreamsConfig</code>:
+        </p>
+        <ul>
+            <li> parameter <code>zookeeper.connect</code> was deprecated; a Kafka Streams application does no longer interact with Zookeeper for topic management but uses the new broker admin protocol
+                (cf. <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-4+-+Command+line+and+centralized+administrative+operations#KIP-4-Commandlineandcentralizedadministrativeoperations-TopicAdminSchema.1">KIP-4, Section "Topic Admin Schema"</a>) </li>
+            <li> added many new parameters for metrics, security, and client configurations </li>
+        </ul>
+
+        <p> Changes in <code>StreamsMetrics</code> interface: </p>
+        <ul>
+            <li> removed methods: <code>#addLatencySensor()</code> </li>
+            <li> added methods: <code>#addLatencyAndThroughputSensor()</code>, <code>#addThroughputSensor()</code>, <code>#recordThroughput()</code>,
+            <code>#addSensor()</code>, <code>#removeSensor()</code> </li>
+        </ul>
+        <p> New methods in <code>TopologyBuilder</code>: </p>
             <ul>
                 <li> added overloads for <code>#addSource()</code> that allow to define a <code>auto.offset.reset</code> policy per source node </li>
                 <li> added methods <code>#addGlobalStore()</code> to add global <code>StateStore</code>s </li>
             </ul>
-        </li>
-        <li> New methods in <code>KStreamBuilder</code>:
+
+        <p> New methods in <code>KStreamBuilder</code>: </p>
             <ul>
                 <li> added overloads for <code>#stream()</code> and <code>#table()</code> that allow to define a <code>auto.offset.reset</code> policy per input stream/table </li>
                 <li> <code>#table()</code> always requires store name </li>
                 <li> added method <code>#globalKTable()</code> to create a <code>GlobalKTable</code> </li>
             </ul>
-        </li>
-        <li> New joins for <code>KStream</code>:
+
+        <p> New joins for <code>KStream</code>: </p>
             <ul>
                 <li> added overloads for <code>#join()</code> to join with <code>KTable</code> </li>
                 <li> added overloads for <code>#join()</code> and <code>leftJoin()</code> to join with <code>GlobalKTable</code> </li>
             </ul>
-        </li>
-        <li> Aligned <code>null</code>-key handling for <code>KTable</code> joins:
+
+        <p> Aligned <code>null</code>-key handling for <code>KTable</code> joins: </p>
             <ul>
                 <li> like all other KTable operations, <code>KTable-KTable</code> joins do not throw an exception on <code>null</code> key records anymore, but drop those records silently </li>
             </ul>
-        </li>
-        <li> New window type <em>Session Windows</em>:
+
+        <p> New window type <em>Session Windows</em>: </p>
             <ul>
                 <li> added class <code>SessionWindows</code> to specify session windows </li>
                 <li> added overloads for <code>KGroupedStream</code> methods <code>#count()</code>, <code>#reduce()</code>, and <code>#aggregate()</code>
                      to allow session window aggregations </li>
             </ul>
-        </li>
-        <li> Changes to <code>TimestampExtractor</code>:
+
+        <p> Changes to <code>TimestampExtractor</code>: </p>
             <ul>
                 <li> method <code>#extract()</code> has a second parameter now </li>
                 <li> new default timestamp extractor class <code>FailOnInvalidTimestamp</code>
                      (it gives the same behavior as old (and removed) default extractor <code>ConsumerRecordTimestampExtractor</code>) </li>
                 <li> new alternative timestamp extractor classes <code>LogAndSkipOnInvalidTimestamp</code> and <code>UsePreviousTimeOnInvalidTimestamps</code> </li>
             </ul>
-        </li>
-        <li> Relaxed type constraints of many DSL interfaces, classes, and methods (cf. <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-100+-+Relax+Type+constraints+in+Kafka+Streams+API">KIP-100</a>). </li>
-    </ul>
-</pre>
-
 
+        <p> Relaxed type constraints of many DSL interfaces, classes, and methods (cf. <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-100+-+Relax+Type+constraints+in+Kafka+Streams+API">KIP-100</a>). </p>
 </script>
 
 <!--#include virtual="../includes/_header.htm" -->
diff --git a/docs/toc.html b/docs/toc.html
new file mode 100644
index 0000000000000..792dc4e4f2575
--- /dev/null
+++ b/docs/toc.html
@@ -0,0 +1,154 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements.  See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License.  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<script><!--#include virtual="js/templateData.js" --></script>
+
+<script id="toc-template" type="text/x-handlebars-template">
+
+    <ul class="toc">
+        <li><a href="#gettingStarted">1. Getting Started</a>
+            <ul>
+                <li><a href="#introduction">1.1 Introduction</a>
+                <li><a href="#uses">1.2 Use Cases</a>
+                <li><a href="#quickstart">1.3 Quick Start</a>
+                <li><a href="#ecosystem">1.4 Ecosystem</a>
+                <li><a href="#upgrade">1.5 Upgrading</a>
+            </ul>
+        </li>
+        <li><a href="#api">2. APIs</a>
+            <ul>
+                <li><a href="#producerapi">2.1 Producer API</a>
+                <li><a href="#consumerapi">2.2 Consumer API</a>
+                <li><a href="#streamsapi">2.3 Streams API</a>
+                <li><a href="#connectapi">2.4 Connect API</a>
+                <li><a href="#legacyapis">2.5 Legacy APIs</a>
+            </ul>
+        </li>
+        <li><a href="#configuration">3. Configuration</a>
+            <ul>
+                <li><a href="#brokerconfigs">3.1 Broker Configs</a>
+                <li><a href="#producerconfigs">3.2 Producer Configs</a>
+                <li><a href="#consumerconfigs">3.3 Consumer Configs</a>
+                    <ul>
+                        <li><a href="#newconsumerconfigs">3.3.1 New Consumer Configs</a>
+                        <li><a href="#oldconsumerconfigs">3.3.2 Old Consumer Configs</a>
+                    </ul>
+                <li><a href="#connectconfigs">3.4 Kafka Connect Configs</a>
+                <li><a href="#streamsconfigs">3.5 Kafka Streams Configs</a>
+            </ul>
+        </li>
+        <li><a href="#design">4. Design</a>
+            <ul>
+                <li><a href="#majordesignelements">4.1 Motivation</a>
+                <li><a href="#persistence">4.2 Persistence</a>
+                <li><a href="#maximizingefficiency">4.3 Efficiency</a>
+                <li><a href="#theproducer">4.4 The Producer</a>
+                <li><a href="#theconsumer">4.5 The Consumer</a>
+                <li><a href="#semantics">4.6 Message Delivery Semantics</a>
+                <li><a href="#replication">4.7 Replication</a>
+                <li><a href="#compaction">4.8 Log Compaction</a>
+                <li><a href="#design_quotas">4.9 Quotas</a>
+            </ul>
+        </li>
+        <li><a href="#implementation">5. Implementation</a>
+            <ul>
+                <li><a href="#apidesign">5.1 API Design</a>
+                <li><a href="#networklayer">5.2 Network Layer</a>
+                <li><a href="#messages">5.3 Messages</a>
+                <li><a href="#messageformat">5.4 Message format</a>
+                <li><a href="#log">5.5 Log</a>
+                <li><a href="#distributionimpl">5.6 Distribution</a>
+            </ul>
+        </li>
+        <li><a href="#operations">6. Operations</a>
+            <ul>
+                <li><a href="#basic_ops">6.1 Basic Kafka Operations</a>
+                    <ul>
+                        <li><a href="#basic_ops_add_topic">Adding and removing topics</a>
+                        <li><a href="#basic_ops_modify_topic">Modifying topics</a>
+                        <li><a href="#basic_ops_restarting">Graceful shutdown</a>
+                        <li><a href="#basic_ops_leader_balancing">Balancing leadership</a>
+                        <li><a href="#basic_ops_consumer_lag">Checking consumer position</a>
+                        <li><a href="#basic_ops_mirror_maker">Mirroring data between clusters</a>
+                        <li><a href="#basic_ops_cluster_expansion">Expanding your cluster</a>
+                        <li><a href="#basic_ops_decommissioning_brokers">Decommissioning brokers</a>
+                        <li><a href="#basic_ops_increase_replication_factor">Increasing replication factor</a>
+                    </ul>
+                <li><a href="#datacenters">6.2 Datacenters</a>
+                <li><a href="#config">6.3 Important Configs</a>
+                    <ul>
+                        <li><a href="#clientconfig">Important Client Configs</a>
+                        <li><a href="#prodconfig">A Production Server Configs</a>
+                    </ul>
+                <li><a href="#java">6.4 Java Version</a>
+                <li><a href="#hwandos">6.5 Hardware and OS</a>
+                    <ul>
+                        <li><a href="#os">OS</a>
+                        <li><a href="#diskandfs">Disks and Filesystems</a>
+                        <li><a href="#appvsosflush">Application vs OS Flush Management</a>
+                        <li><a href="#linuxflush">Linux Flush Behavior</a>
+                        <li><a href="#ext4">Ext4 Notes</a>
+                    </ul>
+                <li><a href="#monitoring">6.6 Monitoring</a>
+                <li><a href="#zk">6.7 ZooKeeper</a>
+                    <ul>
+                        <li><a href="#zkversion">Stable Version</a>
+                        <li><a href="#zkops">Operationalization</a>
+                    </ul>
+            </ul>
+        </li>
+        <li><a href="#security">7. Security</a>
+            <ul>
+                <li><a href="#security_overview">7.1 Security Overview</a></li>
+                <li><a href="#security_ssl">7.2 Encryption and Authentication using SSL</a></li>
+                <li><a href="#security_sasl">7.3 Authentication using SASL</a></li>
+                <li><a href="#security_authz">7.4 Authorization and ACLs</a></li>
+                <li><a href="#security_rolling_upgrade">7.5 Incorporating Security Features in a Running Cluster</a></li>
+                <li><a href="#zk_authz">7.6 ZooKeeper Authentication</a></li>
+                <ul>
+                    <li><a href="#zk_authz_new">New Clusters</a></li>
+                    <li><a href="#zk_authz_migration">Migrating Clusters</a></li>
+                    <li><a href="#zk_authz_ensemble">Migrating the ZooKeeper Ensemble</a></li>
+                </ul>
+            </ul>
+        </li>
+        <li><a href="#connect">8. Kafka Connect</a>
+            <ul>
+                <li><a href="#connect_overview">8.1 Overview</a></li>
+                <li><a href="#connect_user">8.2 User Guide</a></li>
+                <li><a href="#connect_development">8.3 Connector Development Guide</a></li>
+            </ul>
+        </li>
+        <li><a href="/{{version}}/documentation/streams">9. Kafka Streams</a>
+            <ul>
+                <li><a href="/{{version}}/documentation/streams#streams_overview">9.1 Overview</a></li>
+                <li><a href="/{{version}}/documentation/streams#streams_concepts">9.2 Core Concepts</a></li>
+                <li><a href="/{{version}}/documentation/streams#streams_architecture">9.3 Architecture</a></li>
+                <li><a href="/{{version}}/documentation/streams#streams_developer">9.4 Developer Guide</a></li>
+                <ul>
+                    <li><a href="/{{version}}/documentation/streams#streams_processor">Low-Level Processor API</a></li>
+                    <li><a href="/{{version}}/documentation/streams#streams_dsl">High-Level Streams DSL</a></li>
+                    <li><a href="/{{version}}/documentation/streams#streams_execute">Application Configuration and Execution</a></li>
+                </ul>
+                <li><a href="/{{version}}/documentation/streams#streams_upgrade">9.5 Upgrade Guide and API Changes</a></li>
+            </ul>
+        </li>
+    </ul>
+
+</script>
+
+<div class="p-toc"></div>
\ No newline at end of file
diff --git a/docs/upgrade.html b/docs/upgrade.html
index 79c376d53560a..a06eeb6840304 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -75,7 +75,7 @@ <h5><a id="upgrade_1020_notable" href="#upgrade_1020_notable">Notable changes in
         modifying Zookeeper directly. This eliminates the need for privileges to access Zookeeper directly and "StreamsConfig.ZOOKEEPER_CONFIG"
         should not be set in the Streams app any more. If the Kafka cluster is secured, Streams apps must have the required security privileges to create new topics.</li>
     <li>Several new fields including "security.protocol", "connections.max.idle.ms", "retry.backoff.ms", "reconnect.backoff.ms" and "request.timeout.ms" were added to
-        StreamsConfig class. User should pay attenntion to the default values and set these if needed. For more details please refer to <a id="streamsconfigs" href="#streamsconfigs">3.5 Kafka Streams Configs</a>.</li>
+        StreamsConfig class. User should pay attenntion to the default values and set these if needed. For more details please refer to <a href="#streamsconfigs">3.5 Kafka Streams Configs</a>.</li>
 </ul>
 
 <h5><a id="upgrade_1020_new_protocols" href="#upgrade_1020_new_protocols">New Protocol Versions</a></h5>
diff --git a/docs/uses.html b/docs/uses.html
index b86d917a265fb..2d238c2239fb4 100644
--- a/docs/uses.html
+++ b/docs/uses.html
@@ -15,7 +15,7 @@
  limitations under the License.
 -->
 
-<p> Here is a description of a few of the popular use cases for Apache Kafka. For an overview of a number of these areas in action, see <a href="http://engineering.linkedin.com/distributed-systems/log-what-every-software-engineer-should-know-about-real-time-datas-unifying">this blog post</a>. </p>
+<p> Here is a description of a few of the popular use cases for Apache Kafka&trade;. For an overview of a number of these areas in action, see <a href="http://engineering.linkedin.com/distributed-systems/log-what-every-software-engineer-should-know-about-real-time-datas-unifying">this blog post</a>. </p>
 
 <h4><a id="uses_messaging" href="#uses_messaging">Messaging</a></h4>
 

From 415df0052c5aa3016bfaac841a660ddb287e4fc1 Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Fri, 10 Feb 2017 09:45:13 -0800
Subject: [PATCH 100/177] MINOR: add GlobalKTable doc to streams.html

Update streams.html with GlobalKTable docs

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Michael G. Noll, Matthias J. Sax, Guozhang Wang

Closes #2516 from dguy/global-tables-doc

(cherry picked from commit 1c45f79c91a9f2b98f9549f51f80de2e89146490)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 docs/streams.html | 29 +++++++++++++++++++++--------
 1 file changed, 21 insertions(+), 8 deletions(-)

diff --git a/docs/streams.html b/docs/streams.html
index 19af2b326ccf5..94ce7a951bc0f 100644
--- a/docs/streams.html
+++ b/docs/streams.html
@@ -497,25 +497,31 @@ <h4><a id="streams_duality" href="#streams_duality">Duality of Streams and Table
 
         <p>
         The same mechanism is used, for example, to replicate databases via change data capture (CDC) and, within Kafka Streams, to replicate its so-called state stores across machines for fault-tolerance.
-        The stream-table duality is such an important concept that Kafka Streams models it explicitly via the <a href="#streams_kstream_ktable">KStream and KTable</a> interfaces, which we describe in the next sections.
+        The stream-table duality is such an important concept that Kafka Streams models it explicitly via the <a href="#streams_kstream_ktable">KStream, KTable, and GlobalKTable</a> interfaces, which we describe in the next sections.
         </p>
 
-        <h5><a id="streams_kstream_ktable" href="#streams_kstream_ktable">KStream and KTable</a></h5>
-        The DSL uses two main abstractions. A <b>KStream</b> is an abstraction of a record stream, where each data record represents a self-contained datum in the unbounded data set.
+        <h5><a id="streams_kstream_ktable" href="#streams_kstream_ktable">KStream, KTable, and GlobalKTable</a></h5>
+        The DSL uses three main abstractions. A <b>KStream</b> is an abstraction of a record stream, where each data record represents a self-contained datum in the unbounded data set.
         A <b>KTable</b> is an abstraction of a changelog stream, where each data record represents an update. More precisely, the value in a data record is considered to be an update of the last value for the same record key,
-        if any (if a corresponding key doesn't exist yet, the update will be considered a create). To illustrate the difference between KStreams and KTables, let's imagine the following two data records are being sent to the stream:
+        if any (if a corresponding key doesn't exist yet, the update will be considered a create).
+        Like a <b>KTable</b>, a <b>GlobalKTable</b> is an abstraction of a changelog stream, where each data record represents an update.
+        However, a <b>GlobalKTable</b> is different from a <b>KTable</b> in that it is fully replicated on each KafkaStreams instance.
+        <b>GlobalKTable</b> also provides the ability to look up current values of data records by keys.
+        This table-lookup functionality is available through <a href="#streams_dsl_joins">join operations</a>.
+
+        To illustrate the difference between KStreams and KTables/GlobalKTables, let’s imagine the following two data records are being sent to the stream:
 
         <pre>
             ("alice", 1) --> ("alice", 3)
         </pre>
 
-        If these records a KStream and the stream processing application were to sum the values it would return <code>4</code>. If these records were a KTable, the return would be <code>3</code>, since the last record would be considered as an update.
+        If these records a KStream and the stream processing application were to sum the values it would return <code>4</code>. If these records were a KTable or GlobalKTable, the return would be <code>3</code>, since the last record would be considered as an update.
 
         <h4><a id="streams_dsl_source" href="#streams_dsl_source">Create Source Streams from Kafka</a></h4>
 
         <p>
-        Either a <b>record stream</b> (defined as <code>KStream</code>) or a <b>changelog stream</b> (defined as <code>KTable</code>)
-        can be created as a source stream from one or more Kafka topics (for <code>KTable</code> you can only create the source stream
+        Either a <b>record stream</b> (defined as <code>KStream</code>) or a <b>changelog stream</b> (defined as <code>KTable</code> or <code>GlobalKTable</code>)
+        can be created as a source stream from one or more Kafka topics (for <code>KTable</code> and <code>GlobalKTable</code> you can only create the source stream
         from a single topic).
         </p>
 
@@ -524,6 +530,7 @@ <h4><a id="streams_dsl_source" href="#streams_dsl_source">Create Source Streams
 
             KStream&lt;String, GenericRecord&gt; source1 = builder.stream("topic1", "topic2");
             KTable&lt;String, GenericRecord&gt; source2 = builder.table("topic3", "stateStoreName");
+            GlobalKTable&lt;String, GenericRecord&gt; source2 = builder.globalTable("topic4", "globalStoreName");
         </pre>
 
         <h4><a id="streams_dsl_windowing" href="#streams_dsl_windowing">Windowing a stream</a></h4>
@@ -551,7 +558,13 @@ <h4><a id="streams_dsl_joins" href="#streams_dsl_joins">Join multiple streams</a
         <li><b>KStream-to-KStream Joins</b> are always windowed joins, since otherwise the memory and state required to compute the join would grow infinitely in size. Here, a newly received record from one of the streams is joined with the other stream's records within the specified window interval to produce one result for each matching pair based on user-provided <code>ValueJoiner</code>. A new <code>KStream</code> instance representing the result stream of the join is returned from this operator.</li>
         
         <li><b>KTable-to-KTable Joins</b> are join operations designed to be consistent with the ones in relational databases. Here, both changelog streams are materialized into local state stores first. When a new record is received from one of the streams, it is joined with the other stream's materialized state stores to produce one result for each matching pair based on user-provided ValueJoiner. A new <code>KTable</code> instance representing the result stream of the join, which is also a changelog stream of the represented table, is returned from this operator.</li>
-        <li><b>KStream-to-KTable Joins</b> allow you to perform table lookups against a changelog stream (<code>KTable</code>) upon receiving a new record from another record stream (KStream). An example use case would be to enrich a stream of user activities (<code>KStream</code>) with the latest user profile information (<code>KTable</code>). Only records received from the record stream will trigger the join and produce results via <code>ValueJoiner</code>, not vice versa (i.e., records received from the changelog stream will be used only to update the materialized state store). A new <code>KStream</code> instance representing the result stream of the join is returned from this operator.</li>
+        <li><b>KStream-to-KTable Joins</b> allow you to perform table lookups against a changelog stream (<code>KTable</code>) upon receiving a new record from another record stream (<code>KStream</code>). An example use case would be to enrich a stream of user activities (<code>KStream</code>) with the latest user profile information (<code>KTable</code>). Only records received from the record stream will trigger the join and produce results via <code>ValueJoiner</code>, not vice versa (i.e., records received from the changelog stream will be used only to update the materialized state store). A new <code>KStream</code> instance representing the result stream of the join is returned from this operator.</li>
+        <li><b>KStream-to-GlobalKTable Joins</b> allow you to perform table lookups against a fully replicated changelog stream (<code>GlobalKTable</code>) upon receiving a new record from another record stream (<code>KStream</code>).
+            Joins with a <code>GlobalKTable</code> don't require repartitioning of the input <code>KStream</code> as all partitions of the <code>GlobalKTable</code> are available on every KafkaStreams instance.
+            The <code>KeyValueMapper</code> provided with the join operation is applied to each KStream record to extract the join-key that is used to do the lookup to the GlobalKTable so non-record-key joins are possible.
+            An example use case would be to enrich a stream of user activities (<code>KStream</code>) with the latest user profile information (<code>GlobalKTable</code>).
+            Only records received from the record stream will trigger the join and produce results via <code>ValueJoiner</code>, not vice versa (i.e., records received from the changelog stream will be used only to update the materialized state store).
+            A new <code>KStream</code> instance representing the result stream of the join is returned from this operator.</li>
         </ul>
 
         Depending on the operands the following join operations are supported: <b>inner joins</b>, <b>outer joins</b> and <b>left joins</b>. Their semantics are similar to the corresponding operators in relational databases.

From 3ac10d5aefc6d12805ee6b43d5ce8d566ad4abdd Mon Sep 17 00:00:00 2001
From: Vahid Hashemian <vahidhashemian@us.ibm.com>
Date: Fri, 10 Feb 2017 15:06:54 -0800
Subject: [PATCH 101/177] MINOR: Fix quickstart in docs

Reverting some of the recent changes to quickstart doc. Further explanation is provided inline.

Author: Vahid Hashemian <vahidhashemian@us.ibm.com>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2539 from vahidhashemian/doc/fix_quickstart_issues

(cherry picked from commit 601d4040d446599bb01c45389b3e90645245e9af)
Signed-off-by: Ewen Cheslack-Postava <me@ewencp.org>
---
 docs/quickstart.html | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/docs/quickstart.html b/docs/quickstart.html
index bfc9af3f7221f..69f6a7a5d4f7a 100644
--- a/docs/quickstart.html
+++ b/docs/quickstart.html
@@ -359,7 +359,7 @@ <h4><a id="quickstart_kafkastreams" href="#quickstart_kafkastreams">Step 8: Use
 
 
 <pre>
-&gt; <b>cat file-input.txt | ./bin/kafka-console-producer --broker-list localhost:9092 --topic streams-file-input</b>
+&gt; <b>bin/kafka-console-producer.sh --broker-list localhost:9092 --topic streams-file-input < file-input.txt</b>
 </pre>
 
 <p>
@@ -397,12 +397,9 @@ <h4><a id="quickstart_kafkastreams" href="#quickstart_kafkastreams">Step 8: Use
 
 <pre>
 all     1
-streams 1
 lead    1
 to      1
-kafka   1
 hello   1
-kafka   2
 streams 2
 join    1
 kafka   3

From dfbe944e96e4f26bb99bf122e8cac122d069764c Mon Sep 17 00:00:00 2001
From: "Colin P. Mccabe" <cmccabe@confluent.io>
Date: Mon, 13 Feb 2017 13:46:37 -0800
Subject: [PATCH 102/177] =?UTF-8?q?KAFKA-4756;=20The=20auto-generated=20br?=
 =?UTF-8?q?oker=20id=20should=20be=20passed=20to=20MetricRe=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

…porter.configure

Author: Colin P. Mccabe <cmccabe@confluent.io>

Reviewers: Ismael Juma <ismael@juma.me.uk>, Jun Rao <junrao@gmail.com>

Closes #2540 from cmccabe/KAFKA-4756

(cherry picked from commit ed91af512fcb5c0ea3032ed259451817c96b5ee1)
Signed-off-by: Jun Rao <junrao@gmail.com>
---
 .../kafka/common/config/AbstractConfig.java   | 17 ++++++++++++-
 .../apache/kafka/common/metrics/Metrics.java  |  4 +++
 .../main/scala/kafka/server/KafkaConfig.scala |  2 +-
 .../main/scala/kafka/server/KafkaServer.scala | 23 +++++++++--------
 .../KafkaMetricReporterClusterIdTest.scala    | 25 ++++++++++++++++++-
 5 files changed, 57 insertions(+), 14 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/common/config/AbstractConfig.java b/clients/src/main/java/org/apache/kafka/common/config/AbstractConfig.java
index 096047f395744..5bc057026491e 100644
--- a/clients/src/main/java/org/apache/kafka/common/config/AbstractConfig.java
+++ b/clients/src/main/java/org/apache/kafka/common/config/AbstractConfig.java
@@ -217,10 +217,25 @@ public <T> T getConfiguredInstance(String key, Class<T> t) {
      * @return The list of configured instances
      */
     public <T> List<T> getConfiguredInstances(String key, Class<T> t) {
+        return getConfiguredInstances(key, t, Collections.EMPTY_MAP);
+    }
+
+    /**
+     * Get a list of configured instances of the given class specified by the given configuration key. The configuration
+     * may specify either null or an empty string to indicate no configured instances. In both cases, this method
+     * returns an empty list to indicate no configured instances.
+     * @param key The configuration key for the class
+     * @param t The interface the class should implement
+     * @param configOverrides Configuration overrides to use.
+     * @return The list of configured instances
+     */
+    public <T> List<T> getConfiguredInstances(String key, Class<T> t, Map<String, Object> configOverrides) {
         List<String> klasses = getList(key);
         List<T> objects = new ArrayList<T>();
         if (klasses == null)
             return objects;
+        Map<String, Object> configPairs = originals();
+        configPairs.putAll(configOverrides);
         for (Object klass : klasses) {
             Object o;
             if (klass instanceof String) {
@@ -236,7 +251,7 @@ public <T> List<T> getConfiguredInstances(String key, Class<T> t) {
             if (!t.isInstance(o))
                 throw new KafkaException(klass + " is not an instance of " + t.getName());
             if (o instanceof Configurable)
-                ((Configurable) o).configure(originals());
+                ((Configurable) o).configure(configPairs);
             objects.add(t.cast(o));
         }
         return objects;
diff --git a/clients/src/main/java/org/apache/kafka/common/metrics/Metrics.java b/clients/src/main/java/org/apache/kafka/common/metrics/Metrics.java
index 7b303facb5962..512c18e74aca2 100644
--- a/clients/src/main/java/org/apache/kafka/common/metrics/Metrics.java
+++ b/clients/src/main/java/org/apache/kafka/common/metrics/Metrics.java
@@ -443,6 +443,10 @@ public Map<MetricName, KafkaMetric> metrics() {
         return this.metrics;
     }
 
+    public List<MetricsReporter> reporters() {
+        return this.reporters;
+    }
+
     public KafkaMetric metric(MetricName metricName) {
         return this.metrics.get(metricName);
     }
diff --git a/core/src/main/scala/kafka/server/KafkaConfig.scala b/core/src/main/scala/kafka/server/KafkaConfig.scala
index c4f54c9e14a31..257754308020f 100755
--- a/core/src/main/scala/kafka/server/KafkaConfig.scala
+++ b/core/src/main/scala/kafka/server/KafkaConfig.scala
@@ -824,6 +824,7 @@ class KafkaConfig(val props: java.util.Map[_, _], doLog: Boolean) extends Abstra
   val brokerIdGenerationEnable: Boolean = getBoolean(KafkaConfig.BrokerIdGenerationEnableProp)
   val maxReservedBrokerId: Int = getInt(KafkaConfig.MaxReservedBrokerIdProp)
   var brokerId: Int = getInt(KafkaConfig.BrokerIdProp)
+
   val numNetworkThreads = getInt(KafkaConfig.NumNetworkThreadsProp)
   val backgroundThreads = getInt(KafkaConfig.BackgroundThreadsProp)
   val queuedMaxRequests = getInt(KafkaConfig.QueuedMaxRequestsProp)
@@ -940,7 +941,6 @@ class KafkaConfig(val props: java.util.Map[_, _], doLog: Boolean) extends Abstra
   /** ********* Metric Configuration **************/
   val metricNumSamples = getInt(KafkaConfig.MetricNumSamplesProp)
   val metricSampleWindowMs = getLong(KafkaConfig.MetricSampleWindowMsProp)
-  val metricReporterClasses: java.util.List[MetricsReporter] = getConfiguredInstances(KafkaConfig.MetricReporterClassesProp, classOf[MetricsReporter])
   val metricRecordingLevel = getString(KafkaConfig.MetricRecordingLevelProp)
 
   /** ********* SSL Configuration **************/
diff --git a/core/src/main/scala/kafka/server/KafkaServer.scala b/core/src/main/scala/kafka/server/KafkaServer.scala
index b5075f9472884..68a62a404f5c1 100755
--- a/core/src/main/scala/kafka/server/KafkaServer.scala
+++ b/core/src/main/scala/kafka/server/KafkaServer.scala
@@ -101,13 +101,9 @@ class KafkaServer(val config: KafkaConfig, time: Time = Time.SYSTEM, threadNameP
   private var shutdownLatch = new CountDownLatch(1)
 
   private val jmxPrefix: String = "kafka.server"
-  private val reporters: java.util.List[MetricsReporter] = config.metricReporterClasses
-  reporters.add(new JmxReporter(jmxPrefix))
 
   var metrics: Metrics = null
 
-  private val metricConfig: MetricConfig = KafkaServer.metricConfig(config)
-
   val brokerState: BrokerState = new BrokerState
 
   var apis: KafkaApis = null
@@ -182,9 +178,6 @@ class KafkaServer(val config: KafkaConfig, time: Time = Time.SYSTEM, threadNameP
 
       val canStartup = isStartingUp.compareAndSet(false, true)
       if (canStartup) {
-        metrics = new Metrics(metricConfig, reporters, time, true)
-        quotaManagers = QuotaFactory.instantiate(config, metrics, time)
-
         brokerState.newState(Starting)
 
         /* start scheduler */
@@ -197,16 +190,24 @@ class KafkaServer(val config: KafkaConfig, time: Time = Time.SYSTEM, threadNameP
         _clusterId = getOrGenerateClusterId(zkUtils)
         info(s"Cluster ID = $clusterId")
 
+        /* generate brokerId */
+        config.brokerId =  getBrokerId
+        this.logIdent = "[Kafka Server " + config.brokerId + "], "
+
+        /* create and configure metrics */
+        val reporters = config.getConfiguredInstances(KafkaConfig.MetricReporterClassesProp, classOf[MetricsReporter],
+            Map[String, AnyRef](KafkaConfig.BrokerIdProp -> (config.brokerId.toString)).asJava)
+        reporters.add(new JmxReporter(jmxPrefix))
+        val metricConfig = KafkaServer.metricConfig(config)
+        metrics = new Metrics(metricConfig, reporters, time, true)
+
+        quotaManagers = QuotaFactory.instantiate(config, metrics, time)
         notifyClusterListeners(kafkaMetricsReporters ++ reporters.asScala)
 
         /* start log manager */
         logManager = createLogManager(zkUtils.zkClient, brokerState)
         logManager.startup()
 
-        /* generate brokerId */
-        config.brokerId =  getBrokerId
-        this.logIdent = "[Kafka Server " + config.brokerId + "], "
-
         metadataCache = new MetadataCache(config.brokerId)
         credentialProvider = new CredentialProvider(config.saslEnabledMechanisms)
 
diff --git a/core/src/test/scala/unit/kafka/server/KafkaMetricReporterClusterIdTest.scala b/core/src/test/scala/unit/kafka/server/KafkaMetricReporterClusterIdTest.scala
index d235d02a10210..dfcb4ac279990 100755
--- a/core/src/test/scala/unit/kafka/server/KafkaMetricReporterClusterIdTest.scala
+++ b/core/src/test/scala/unit/kafka/server/KafkaMetricReporterClusterIdTest.scala
@@ -28,6 +28,7 @@ import org.junit.{After, Before, Test}
 import org.apache.kafka.test.TestUtils.isValidClusterId
 
 object KafkaMetricReporterClusterIdTest {
+  val setupError = new AtomicReference[String]("")
 
   class MockKafkaMetricsReporter extends KafkaMetricsReporter with ClusterResourceListener {
 
@@ -52,8 +53,26 @@ object KafkaMetricReporterClusterIdTest {
     override def onUpdate(clusterMetadata: ClusterResource) {
       MockBrokerMetricsReporter.CLUSTER_META.set(clusterMetadata)
     }
-  }
 
+    override def configure(configs: java.util.Map[String, _]): Unit = {
+      // Check that the configuration passed to the MetricsReporter includes the broker id as an Integer.
+      // This is a regression test for KAFKA-4756.
+      //
+      // Because this code is run during the test setUp phase, if we throw an exception here,
+      // it just results in the test itself being declared "not found" rather than failing.
+      // So we track an error message which we will check later in the test body.
+      val brokerId = configs.get(KafkaConfig.BrokerIdProp)
+      if (brokerId == null)
+        setupError.compareAndSet("", "No value was set for the broker id.")
+      else if (!brokerId.isInstanceOf[String])
+        setupError.compareAndSet("", "The value set for the broker id was not a string.")
+      try
+        Integer.parseInt(brokerId.asInstanceOf[String])
+      catch {
+        case e: Exception => setupError.compareAndSet("", "Error parsing broker id " + e.toString)
+      }
+    }
+  }
 }
 
 class KafkaMetricReporterClusterIdTest extends ZooKeeperTestHarness {
@@ -66,6 +85,8 @@ class KafkaMetricReporterClusterIdTest extends ZooKeeperTestHarness {
     val props = TestUtils.createBrokerConfig(1, zkConnect)
     props.setProperty("kafka.metrics.reporters", "kafka.server.KafkaMetricReporterClusterIdTest$MockKafkaMetricsReporter")
     props.setProperty(KafkaConfig.MetricReporterClassesProp, "kafka.server.KafkaMetricReporterClusterIdTest$MockBrokerMetricsReporter")
+    props.setProperty(KafkaConfig.BrokerIdGenerationEnableProp, "true")
+    props.setProperty(KafkaConfig.BrokerIdProp, "-1")
     config = KafkaConfig.fromProps(props)
     server = KafkaServerStartable.fromProps(props)
     server.startup()
@@ -73,6 +94,8 @@ class KafkaMetricReporterClusterIdTest extends ZooKeeperTestHarness {
 
   @Test
   def testClusterIdPresent() {
+    assertEquals("", KafkaMetricReporterClusterIdTest.setupError.get())
+
     assertNotNull(KafkaMetricReporterClusterIdTest.MockKafkaMetricsReporter.CLUSTER_META)
     isValidClusterId(KafkaMetricReporterClusterIdTest.MockKafkaMetricsReporter.CLUSTER_META.get().clusterId())
 

From 71a511c3460bfbc2a47e8f03926be8bff19fe916 Mon Sep 17 00:00:00 2001
From: Jason Gustafson <jason@confluent.io>
Date: Mon, 13 Feb 2017 14:07:19 -0800
Subject: [PATCH 103/177] KAFKA-4761; Fix producer regression handling small or
 zero batch size

Author: Jason Gustafson <jason@confluent.io>

Reviewers: Apurva Mehta <apurva.1618@gmail.com>, Vahid Hashemian <vahidhashemian@us.ibm.com>, Ismael Juma <ismael@juma.me.uk>, Guozhang Wang <wangguoz@gmail.com>

Closes #2545 from hachikuji/KAFKA-4761

(cherry picked from commit 3b36d5cff0b7a51e737a97144d6d479af708b2d7)
Signed-off-by: Jason Gustafson <jason@confluent.io>
---
 .../common/record/MemoryRecordsBuilder.java   | 18 ++++++++++-
 .../kafka/common/record/FileRecordsTest.java  |  4 +--
 .../record/MemoryRecordsBuilderTest.java      | 29 +++++++++++++++++
 .../common/record/MemoryRecordsTest.java      |  6 ++--
 .../java/org/apache/kafka/test/TestUtils.java | 26 +++++-----------
 .../kafka/api/BaseProducerSendTest.scala      | 31 +++++++++++++++++--
 .../kafka/api/PlaintextProducerSendTest.scala |  8 +++++
 .../message/BaseMessageSetTestCases.scala     |  4 +--
 8 files changed, 96 insertions(+), 30 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/common/record/MemoryRecordsBuilder.java b/clients/src/main/java/org/apache/kafka/common/record/MemoryRecordsBuilder.java
index 69e9003ff7f6e..02bfc24d73fbb 100644
--- a/clients/src/main/java/org/apache/kafka/common/record/MemoryRecordsBuilder.java
+++ b/clients/src/main/java/org/apache/kafka/common/record/MemoryRecordsBuilder.java
@@ -105,6 +105,20 @@ public Constructor get() throws ClassNotFoundException, NoSuchMethodException {
 
     private MemoryRecords builtRecords;
 
+    /**
+     * Construct a new builder.
+     *
+     * @param buffer The underlying buffer to use (note that this class will allocate a new buffer if necessary
+     *               to fit the records appended)
+     * @param magic The magic value to use
+     * @param compressionType The compression codec to use
+     * @param timestampType The desired timestamp type. For magic > 0, this cannot be {@link TimestampType#NO_TIMESTAMP_TYPE}.
+     * @param baseOffset The initial offset to use for
+     * @param logAppendTime The log append time of this record set. Can be set to NO_TIMESTAMP if CREATE_TIME is used.
+     * @param writeLimit The desired limit on the total bytes for this record set (note that this can be exceeded
+     *                   when compression is used since size estimates are rough, and in the case that the first
+     *                   record added exceeds the size).
+     */
     public MemoryRecordsBuilder(ByteBuffer buffer,
                                 byte magic,
                                 CompressionType compressionType,
@@ -373,7 +387,9 @@ public boolean isClosed() {
     }
 
     public boolean isFull() {
-        return isClosed() || this.writeLimit <= estimatedBytesWritten();
+        // note that the write limit is respected only after the first record is added which ensures we can always
+        // create non-empty batches (this is used to disable batching when the producer's batch size is set to 0).
+        return isClosed() || (this.numRecords > 0 && this.writeLimit <= estimatedBytesWritten());
     }
 
     public int sizeInBytes() {
diff --git a/clients/src/test/java/org/apache/kafka/common/record/FileRecordsTest.java b/clients/src/test/java/org/apache/kafka/common/record/FileRecordsTest.java
index dcd3befbd1eea..274bf9d1d224f 100644
--- a/clients/src/test/java/org/apache/kafka/common/record/FileRecordsTest.java
+++ b/clients/src/test/java/org/apache/kafka/common/record/FileRecordsTest.java
@@ -381,11 +381,11 @@ private void verifyConvertedMessageSet(List<LogEntry> initialEntries, Records co
     }
 
     private static List<LogEntry> shallowEntries(Records buffer) {
-        return TestUtils.toList(buffer.shallowEntries().iterator());
+        return TestUtils.toList(buffer.shallowEntries());
     }
 
     private static List<LogEntry> deepEntries(Records buffer) {
-        return TestUtils.toList(buffer.deepEntries().iterator());
+        return TestUtils.toList(buffer.deepEntries());
     }
 
     private FileRecords createFileRecords(Record ... records) throws IOException {
diff --git a/clients/src/test/java/org/apache/kafka/common/record/MemoryRecordsBuilderTest.java b/clients/src/test/java/org/apache/kafka/common/record/MemoryRecordsBuilderTest.java
index 034faf631dfd1..02ee75e00bcdd 100644
--- a/clients/src/test/java/org/apache/kafka/common/record/MemoryRecordsBuilderTest.java
+++ b/clients/src/test/java/org/apache/kafka/common/record/MemoryRecordsBuilderTest.java
@@ -16,6 +16,7 @@
  **/
 package org.apache.kafka.common.record;
 
+import org.apache.kafka.test.TestUtils;
 import org.junit.Test;
 import org.junit.runner.RunWith;
 import org.junit.runners.Parameterized;
@@ -28,6 +29,7 @@
 
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertTrue;
 
 @RunWith(value = Parameterized.class)
 public class MemoryRecordsBuilderTest {
@@ -177,6 +179,33 @@ public void buildUsingCreateTime() {
         }
     }
 
+    @Test
+    public void testSmallWriteLimit() {
+        // with a small write limit, we always allow at least one record to be added
+
+        byte[] key = "foo".getBytes();
+        byte[] value = "bar".getBytes();
+        int writeLimit = 0;
+        ByteBuffer buffer = ByteBuffer.allocate(512);
+        MemoryRecordsBuilder builder = new MemoryRecordsBuilder(buffer, Record.CURRENT_MAGIC_VALUE, compressionType,
+                TimestampType.CREATE_TIME, 0L, Record.NO_TIMESTAMP, writeLimit);
+
+        assertFalse(builder.isFull());
+        assertTrue(builder.hasRoomFor(key, value));
+        builder.append(0L, key, value);
+
+        assertTrue(builder.isFull());
+        assertFalse(builder.hasRoomFor(key, value));
+
+        MemoryRecords memRecords = builder.build();
+        List<Record> records = TestUtils.toList(memRecords.records());
+        assertEquals(1, records.size());
+
+        Record record = records.get(0);
+        assertEquals(ByteBuffer.wrap(key), record.key());
+        assertEquals(ByteBuffer.wrap(value), record.value());
+    }
+
     @Test
     public void writePastLimit() {
         ByteBuffer buffer = ByteBuffer.allocate(64);
diff --git a/clients/src/test/java/org/apache/kafka/common/record/MemoryRecordsTest.java b/clients/src/test/java/org/apache/kafka/common/record/MemoryRecordsTest.java
index 9c8ca7f290e8c..9271a3fa9e120 100644
--- a/clients/src/test/java/org/apache/kafka/common/record/MemoryRecordsTest.java
+++ b/clients/src/test/java/org/apache/kafka/common/record/MemoryRecordsTest.java
@@ -135,7 +135,7 @@ public void testFilterTo() {
 
         MemoryRecords filteredRecords = MemoryRecords.readableRecords(filtered);
 
-        List<ByteBufferLogInputStream.ByteBufferLogEntry> shallowEntries = TestUtils.toList(filteredRecords.shallowEntries().iterator());
+        List<ByteBufferLogInputStream.ByteBufferLogEntry> shallowEntries = TestUtils.toList(filteredRecords.shallowEntries());
         List<Long> expectedOffsets = compression == CompressionType.NONE ? asList(1L, 4L, 5L, 6L) : asList(1L, 5L, 6L);
         assertEquals(expectedOffsets.size(), shallowEntries.size());
 
@@ -148,7 +148,7 @@ public void testFilterTo() {
                     shallowEntry.record().timestampType());
         }
 
-        List<LogEntry> deepEntries = TestUtils.toList(filteredRecords.deepEntries().iterator());
+        List<LogEntry> deepEntries = TestUtils.toList(filteredRecords.deepEntries());
         assertEquals(4, deepEntries.size());
 
         LogEntry first = deepEntries.get(0);
@@ -197,7 +197,7 @@ public void testFilterToPreservesLogAppendTime() {
         filtered.flip();
         MemoryRecords filteredRecords = MemoryRecords.readableRecords(filtered);
 
-        List<ByteBufferLogInputStream.ByteBufferLogEntry> shallowEntries = TestUtils.toList(filteredRecords.shallowEntries().iterator());
+        List<ByteBufferLogInputStream.ByteBufferLogEntry> shallowEntries = TestUtils.toList(filteredRecords.shallowEntries());
         assertEquals(compression == CompressionType.NONE ? 3 : 2, shallowEntries.size());
 
         for (LogEntry shallowEntry : shallowEntries) {
diff --git a/clients/src/test/java/org/apache/kafka/test/TestUtils.java b/clients/src/test/java/org/apache/kafka/test/TestUtils.java
index c39f402bb0ede..0cb32be916b2e 100644
--- a/clients/src/test/java/org/apache/kafka/test/TestUtils.java
+++ b/clients/src/test/java/org/apache/kafka/test/TestUtils.java
@@ -31,7 +31,6 @@
 import java.nio.file.Path;
 import java.util.ArrayList;
 import java.util.Collections;
-import java.util.Iterator;
 import java.util.List;
 import java.util.Map;
 import java.util.Properties;
@@ -43,7 +42,6 @@
 
 import static java.util.Arrays.asList;
 import static org.junit.Assert.assertEquals;
-import static org.junit.Assert.assertFalse;
 import static org.junit.Assert.assertNotNull;
 import static org.junit.Assert.assertTrue;
 import static org.junit.Assert.fail;
@@ -290,28 +288,18 @@ public static void isValidClusterId(String clusterId) {
         }
     }
 
-    /**
-     * Throw an exception if the two iterators are of differing lengths or contain
-     * different messages on their Nth element
-     */
-    public static <T> void checkEquals(Iterator<T> s1, Iterator<T> s2) {
-        while (s1.hasNext() && s2.hasNext())
-            assertEquals(s1.next(), s2.next());
-        assertFalse("Iterators have uneven length--first has more", s1.hasNext());
-        assertFalse("Iterators have uneven length--second has more", s2.hasNext());
-    }
-
     /**
      * Checks the two iterables for equality by first converting both to a list.
      */
     public static <T> void checkEquals(Iterable<T> it1, Iterable<T> it2) {
-        assertEquals(toList(it1.iterator()), toList(it2.iterator()));
+        assertEquals(toList(it1), toList(it2));
     }
 
-    public static <T> List<T> toList(Iterator<? extends T> iterator) {
-        List<T> res = new ArrayList<>();
-        while (iterator.hasNext())
-            res.add(iterator.next());
-        return res;
+    public static <T> List<T> toList(Iterable<? extends T> iterable) {
+        List<T> list = new ArrayList<>();
+        for (T item : iterable)
+            list.add(item);
+        return list;
     }
+
 }
diff --git a/core/src/test/scala/integration/kafka/api/BaseProducerSendTest.scala b/core/src/test/scala/integration/kafka/api/BaseProducerSendTest.scala
index ad61a375c3d4f..da3f6519abace 100644
--- a/core/src/test/scala/integration/kafka/api/BaseProducerSendTest.scala
+++ b/core/src/test/scala/integration/kafka/api/BaseProducerSendTest.scala
@@ -96,7 +96,7 @@ abstract class BaseProducerSendTest extends KafkaServerTestHarness {
   @Test
   def testSendOffset() {
     val producer = createProducer(brokerList)
-    val partition = new Integer(0)
+    val partition = 0
 
     object callback extends Callback {
       var offset = 0L
@@ -175,8 +175,33 @@ abstract class BaseProducerSendTest extends KafkaServerTestHarness {
     sendAndVerifyTimestamp(producer, TimestampType.CREATE_TIME)
   }
 
+  protected def sendAndVerify(producer: KafkaProducer[Array[Byte], Array[Byte]],
+                              numRecords: Int = numRecords,
+                              timeoutMs: Long = 20000L) {
+    val partition = 0
+    try {
+      TestUtils.createTopic(zkUtils, topic, 1, 2, servers)
+
+      val recordAndFutures = for (i <- 1 to numRecords) yield {
+        val record = new ProducerRecord(topic, partition, s"key$i".getBytes, s"value$i".getBytes)
+        (record, producer.send(record))
+      }
+      producer.close(timeoutMs, TimeUnit.MILLISECONDS)
+      val lastOffset = recordAndFutures.foldLeft(0) { case (offset, (record, future)) =>
+        val recordMetadata = future.get
+        assertEquals(topic, recordMetadata.topic)
+        assertEquals(partition, recordMetadata.partition)
+        assertEquals(offset, recordMetadata.offset)
+        offset + 1
+      }
+      assertEquals(numRecords, lastOffset)
+    } finally {
+      producer.close()
+    }
+  }
+
   protected def sendAndVerifyTimestamp(producer: KafkaProducer[Array[Byte], Array[Byte]], timestampType: TimestampType) {
-    val partition = new Integer(0)
+    val partition = 0
 
     val baseTimestamp = 123456L
     val startTime = System.currentTimeMillis()
@@ -212,7 +237,7 @@ abstract class BaseProducerSendTest extends KafkaServerTestHarness {
       TestUtils.createTopic(zkUtils, topic, 1, 2, servers, topicProps)
 
       val recordAndFutures = for (i <- 1 to numRecords) yield {
-        val record = new ProducerRecord(topic, partition, baseTimestamp + i, "key".getBytes, "value".getBytes)
+        val record = new ProducerRecord(topic, partition, baseTimestamp + i, s"key$i".getBytes, s"value$i".getBytes)
         (record, producer.send(record, callback))
       }
       producer.close(20000L, TimeUnit.MILLISECONDS)
diff --git a/core/src/test/scala/integration/kafka/api/PlaintextProducerSendTest.scala b/core/src/test/scala/integration/kafka/api/PlaintextProducerSendTest.scala
index 956fe61dd17c1..10063a99801d3 100644
--- a/core/src/test/scala/integration/kafka/api/PlaintextProducerSendTest.scala
+++ b/core/src/test/scala/integration/kafka/api/PlaintextProducerSendTest.scala
@@ -41,6 +41,14 @@ class PlaintextProducerSendTest extends BaseProducerSendTest {
     producer.send(record)
   }
 
+  @Test
+  def testBatchSizeZero() {
+    val producerProps = new Properties()
+    producerProps.setProperty(ProducerConfig.BATCH_SIZE_CONFIG, "0")
+    val producer = createProducer(brokerList = brokerList, lingerMs = Long.MaxValue, props = Some(producerProps))
+    sendAndVerify(producer)
+  }
+
   @Test
   def testSendCompressedMessageWithLogAppendTime() {
     val producerProps = new Properties()
diff --git a/core/src/test/scala/unit/kafka/javaapi/message/BaseMessageSetTestCases.scala b/core/src/test/scala/unit/kafka/javaapi/message/BaseMessageSetTestCases.scala
index 3327a650428c3..a53602db83325 100644
--- a/core/src/test/scala/unit/kafka/javaapi/message/BaseMessageSetTestCases.scala
+++ b/core/src/test/scala/unit/kafka/javaapi/message/BaseMessageSetTestCases.scala
@@ -40,14 +40,14 @@ trait BaseMessageSetTestCases extends JUnitSuite {
   def testIteratorIsConsistent() {
     val m = createMessageSet(messages)
     // two iterators over the same set should give the same results
-    TestUtils.checkEquals(m.iterator, m.iterator)
+    TestUtils.checkEquals(m, m)
   }
 
   @Test
   def testIteratorIsConsistentWithCompression() {
     val m = createMessageSet(messages, DefaultCompressionCodec)
     // two iterators over the same set should give the same results
-    TestUtils.checkEquals(m.iterator, m.iterator)
+    TestUtils.checkEquals(m, m)
   }
 
   @Test

From 576d93a8dc0cf4215f9a6e35851399f54c5cb348 Mon Sep 17 00:00:00 2001
From: Ewen Cheslack-Postava <me@ewencp.org>
Date: Tue, 14 Feb 2017 09:26:07 -0800
Subject: [PATCH 104/177] Bump version to 0.10.2.0

---
 gradle.properties           | 2 +-
 tests/kafkatest/__init__.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/gradle.properties b/gradle.properties
index 86aedc35ca961..ac48b00ed196e 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -16,7 +16,7 @@
 group=org.apache.kafka
 # NOTE: When you change this version number, you should also make sure to update
 # the version numbers in tests/kafkatest/__init__.py and kafka-merge-pr.py.
-version=0.10.2.0-SNAPSHOT
+version=0.10.2.0
 scalaVersion=2.10.6
 task=build
 org.gradle.jvmargs=-XX:MaxPermSize=512m -Xmx1024m -Xss2m
diff --git a/tests/kafkatest/__init__.py b/tests/kafkatest/__init__.py
index f337765e38853..2f42380503aae 100644
--- a/tests/kafkatest/__init__.py
+++ b/tests/kafkatest/__init__.py
@@ -22,4 +22,4 @@
 # Instead, in development branches, the version should have a suffix of the form ".devN"
 #
 # For example, when Kafka is at version 0.9.0.0-SNAPSHOT, this should be something like "0.9.0.0.dev0"
-__version__ = '0.10.2.0.dev0'
+__version__ = 0.10.2.0

From f6226777d9797b476763c397db550021504ebca0 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Wed, 15 Feb 2017 13:17:29 -0800
Subject: [PATCH 105/177] HOTFIX: fixed section incompatible Steams API changes

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Damian Guy, Guozhang Wang

Closes #2492 from mjsax/hotfixDocs

(cherry picked from commit 2c91b324d4798138dd479f54269bdc4f39339817)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 docs/api.html          |   2 +-
 docs/introduction.html |   6 +-
 docs/streams.html      | 123 ++++++++++++++++++++++++++++-------------
 docs/toc.html          |   4 +-
 docs/upgrade.html      |  48 +++-------------
 docs/uses.html         |  49 ++++++++++++----
 6 files changed, 138 insertions(+), 94 deletions(-)

diff --git a/docs/api.html b/docs/api.html
index 9b9cd96211ca8..de0bb1d13a09b 100644
--- a/docs/api.html
+++ b/docs/api.html
@@ -66,7 +66,7 @@ <h3><a id="streamsapi" href="#streamsapi">2.3 Streams API</a></h3>
 	Examples showing how to use this library are given in the
 	<a href="/{{version}}/javadoc/index.html?org/apache/kafka/streams/KafkaStreams.html" title="Kafka 0.10.2 Javadoc">javadocs</a>
 	<p>
-	Additional documentation on using the Streams API is available <a href="/documentation.html#streams">here</a>.
+	Additional documentation on using the Streams API is available <a href="/{{version}}/documentation/streams">here</a>.
 	<p>
 	To use Kafka Streams you can use the following maven dependency:
 
diff --git a/docs/introduction.html b/docs/introduction.html
index 7672a5154aa73..556aa02eedf6f 100644
--- a/docs/introduction.html
+++ b/docs/introduction.html
@@ -43,7 +43,7 @@ <h3> Apache Kafka&trade; is <i>a distributed streaming platform</i>. What exactl
       <ul style="float: left; width: 40%;">
       <li>The <a href="/documentation.html#producerapi">Producer API</a> allows an application to publish a stream of records to one or more Kafka topics.
       <li>The <a href="/documentation.html#consumerapi">Consumer API</a> allows an application to subscribe to one or more topics and process the stream of records produced to them.
-    <li>The <a href="/documentation.html#streams">Streams API</a> allows an application to act as a <i>stream processor</i>, consuming an input stream from one or more topics and producing an output stream to one or more output topics, effectively transforming the input streams to output streams.
+    <li>The <a href="/documentation/streams">Streams API</a> allows an application to act as a <i>stream processor</i>, consuming an input stream from one or more topics and producing an output stream to one or more output topics, effectively transforming the input streams to output streams.
     <li>The <a href="/documentation.html#connect">Connector API</a> allows building and running reusable producers or consumers that connect Kafka topics to existing applications or data systems. For example, a connector to a relational database might capture every change to a table.
   </ul>
       <img src="/{{version}}/images/kafka-apis.png" style="float: right; width: 50%;">
@@ -171,7 +171,7 @@ <h4>Kafka for Stream Processing</h4>
   For example, a retail application might take in input streams of sales and shipments, and output a stream of reorders and price adjustments computed off this data.
   </p>
   <p>
-  It is possible to do simple processing directly using the producer and consumer APIs. However for more complex transformations Kafka provides a fully integrated <a href="/documentation.html#streams">Streams API</a>. This allows building applications that do non-trivial processing that compute aggregations off of streams or join streams together.
+  It is possible to do simple processing directly using the producer and consumer APIs. However for more complex transformations Kafka provides a fully integrated <a href="/documentation/streams">Streams API</a>. This allows building applications that do non-trivial processing that compute aggregations off of streams or join streams together.
   </p>
   <p>
   This facility helps solve the hard problems this type of application faces: handling out-of-order data, reprocessing input as code changes, performing stateful computations, etc.
@@ -203,4 +203,4 @@ <h4>Putting the Pieces Together</h4>
   </p>
 </script>
 
-<div class="p-introduction"></div>
\ No newline at end of file
+<div class="p-introduction"></div>
diff --git a/docs/streams.html b/docs/streams.html
index 94ce7a951bc0f..31bae5d0800a9 100644
--- a/docs/streams.html
+++ b/docs/streams.html
@@ -39,7 +39,7 @@ <h1>Streams</h1>
                 </ul>
             </li>
             <li>
-                <a href="#streams_upgrade">Upgrade Guide and API Changes</a>
+                <a href="#streams_upgrade_and_api">Upgrade Guide and API Changes</a>
             </li>
         </ol>
 
@@ -230,7 +230,7 @@ <h3><a id="streams_architecture_state" href="#streams_architecture_state">Local
 
         <p>
         Kafka Streams provides so-called <b>state stores</b>, which can be used by stream processing applications to store and query data,
-        which is an important capability when implementing stateful operations. The <a href="streams_dsl">Kafka Streams DSL</a>, for example, automatically creates
+        which is an important capability when implementing stateful operations. The <a href="#streams_dsl">Kafka Streams DSL</a>, for example, automatically creates
         and manages such state stores when you are calling stateful operators such as <code>join()</code> or <code>aggregate()</code>, or when you are windowing a stream.
         </p>
 
@@ -257,7 +257,7 @@ <h3><a id="streams_architecture_recovery" href="#streams_architecture_recovery">
         <p>
         In addition, Kafka Streams makes sure that the local state stores are robust to failures, too. For each state store, it maintains a replicated changelog Kafka topic in which it tracks any state updates.
         These changelog topics are partitioned as well so that each local state store instance, and hence the task accessing the store, has its own dedicated changelog topic partition.
-        <a href="/documentation/#compaction">Log compaction</a> is enabled on the changelog topics so that old data can be purged safely to prevent the topics from growing indefinitely.
+        <a href="/{{version}}/documentation/#compaction">Log compaction</a> is enabled on the changelog topics so that old data can be purged safely to prevent the topics from growing indefinitely.
         If tasks run on a machine that fails and are restarted on another machine, Kafka Streams guarantees to restore their associated state stores to the content before the failure by
         replaying the corresponding changelog topics prior to resuming the processing on the newly started tasks. As a result, failure handling is completely transparent to the end user.
         </p>
@@ -266,14 +266,14 @@ <h3><a id="streams_architecture_recovery" href="#streams_architecture_recovery">
         Note that the cost of task (re)initialization typically depends primarily on the time for restoring the state by replaying the state stores' associated changelog topics.
         To minimize this restoration time, users can configure their applications to have <b>standby replicas</b> of local states (i.e. fully replicated copies of the state).
         When a task migration happens, Kafka Streams then attempts to assign a task to an application instance where such a standby replica already exists in order to minimize
-        the task (re)initialization cost. See <code>num.standby.replicas</code> at the <a href="/documentation/#streamsconfigs">Kafka Streams Configs</a> Section.
+        the task (re)initialization cost. See <code>num.standby.replicas</code> at the <a href="/{{version}}/documentation/#streamsconfigs">Kafka Streams Configs</a> Section.
         </p>
         <br>
 
         <h2><a id="streams_developer" href="#streams_developer">Developer Guide</a></h2>
 
         <p>
-        There is a <a href="/documentation/#quickstart_kafkastreams">quickstart</a> example that provides how to run a stream processing program coded in the Kafka Streams library.
+        There is a <a href="/{{version}}/documentation/#quickstart_kafkastreams">quickstart</a> example that provides how to run a stream processing program coded in the Kafka Streams library.
         This section focuses on how to write, configure, and execute a Kafka Streams application.
         </p>
 
@@ -470,7 +470,7 @@ <h4><a id="streams_duality" href="#streams_duality">Duality of Streams and Table
 
         <p>
         Before we discuss concepts such as aggregations in Kafka Streams we must first introduce tables, and most importantly the relationship between tables and streams:
-        the so-called <a href="https://engineering.linkedin.com/distributed-systems/log-what-every-software-engineer-should-know-about-real-time-datas-unifying">stream-table duality</a>.
+        the so-called <a href="https://engineering.linkedin.com/distributed-systems/log-what-every-software-engineer-should-know-about-real-time-datas-unifying/">stream-table duality</a>.
         Essentially, this duality means that a stream can be viewed as a table, and vice versa. Kafka's log compaction feature, for example, exploits this duality.
         </p>
 
@@ -567,7 +567,8 @@ <h4><a id="streams_dsl_joins" href="#streams_dsl_joins">Join multiple streams</a
             A new <code>KStream</code> instance representing the result stream of the join is returned from this operator.</li>
         </ul>
 
-        Depending on the operands the following join operations are supported: <b>inner joins</b>, <b>outer joins</b> and <b>left joins</b>. Their semantics are similar to the corresponding operators in relational databases.
+        Depending on the operands the following join operations are supported: <b>inner joins</b>, <b>outer joins</b> and <b>left joins</b>.
+        Their <a href="https://cwiki.apache.org/confluence/display/KAFKA/Kafka+Streams+Join+Semantics">semantics</a> are similar to the corresponding operators in relational databases.
 
         <h5><a id="streams_dsl_aggregations" href="#streams_dsl_aggregations">Aggregate a stream</a></h5>
         An <b>aggregation</b> operation takes one input stream, and yields a new stream by combining multiple input records into a single output record. Examples of aggregations are computing counts or sum. An aggregation over record streams usually needs to be performed on a windowing basis because otherwise the number of records that must be maintained for performing the aggregation may grow indefinitely.
@@ -654,7 +655,7 @@ <h3><a id="streams_execute" href="#streams_execute">Application Configuration an
         <p>
         Besides defining the topology, developers will also need to configure their applications
         in <code>StreamsConfig</code> before running it. A complete list of
-        Kafka Streams configs can be found <a href="/documentation/#streamsconfigs"><b>here</b></a>.
+        Kafka Streams configs can be found <a href="/{{version}}/documentation/#streamsconfigs"><b>here</b></a>.
         </p>
 
         <p>
@@ -790,13 +791,21 @@ <h3><a id="streams_execute" href="#streams_execute">Application Configuration an
         </p>
         <br>
 
-        <h2><a id="streams_upgrade" href="#streams_upgrade">Upgrade Guide and API Changes</a></h2>
+        <h2><a id="streams_upgrade_and_api" href="#streams_upgrade_and_api">Upgrade Guide and API Changes</a></h2>
 
         <p>
-        See the <a href="/documentation/#upgrade_1020_streams">Upgrade Section</a> for upgrading a Kafka Streams Application from 0.10.1.x to 0.10.2.0.
+        If you want to upgrade from 0.10.1.x to 0.10.2, see the <a href="/{{version}}/documentation/#upgrade_1020_streams">Upgrade Section for 0.10.2</a>.
+        It highlights incompatible changes you need to consider to upgrade your code and application.
+        See <a href="#streams_api_changes_0102">below</a> a complete list of 0.10.2 API and semantical changes that allow you to advance your application and/or simplify your code base, including the usage of new features.
         </p>
 
-        <h3><a id="streams_api_changes" href="#streams_api_changes">Streams API changes in 0.10.2.0</a></h3>
+        <p>
+        If you want to upgrade from 0.10.0.x to 0.10.1, see the <a href="/{{version}}/documentation/#upgrade_1010_streams">Upgrade Section for 0.10.1</a>.
+        It highlights incompatible changes you need to consider to upgrade your code and application.
+        See <a href="#streams_api_changes_0101">below</a> a complete list of 0.10.1 API changes that allow you to advance your application and/or simplify your code base, including the usage of new features.
+        </p>
+
+        <h3><a id="streams_api_changes_0102" href="#streams_api_changes_0102">Streams API changes in 0.10.2.0</a></h3>
 
         <p>
             New methods in <code>KafkaStreams</code>:
@@ -824,46 +833,84 @@ <h3><a id="streams_api_changes" href="#streams_api_changes">Streams API changes
             <li> added methods: <code>#addLatencyAndThroughputSensor()</code>, <code>#addThroughputSensor()</code>, <code>#recordThroughput()</code>,
             <code>#addSensor()</code>, <code>#removeSensor()</code> </li>
         </ul>
+
         <p> New methods in <code>TopologyBuilder</code>: </p>
-            <ul>
-                <li> added overloads for <code>#addSource()</code> that allow to define a <code>auto.offset.reset</code> policy per source node </li>
-                <li> added methods <code>#addGlobalStore()</code> to add global <code>StateStore</code>s </li>
-            </ul>
+        <ul>
+            <li> added overloads for <code>#addSource()</code> that allow to define a <code>auto.offset.reset</code> policy per source node </li>
+            <li> added methods <code>#addGlobalStore()</code> to add global <code>StateStore</code>s </li>
+        </ul>
 
         <p> New methods in <code>KStreamBuilder</code>: </p>
-            <ul>
-                <li> added overloads for <code>#stream()</code> and <code>#table()</code> that allow to define a <code>auto.offset.reset</code> policy per input stream/table </li>
-                <li> <code>#table()</code> always requires store name </li>
-                <li> added method <code>#globalKTable()</code> to create a <code>GlobalKTable</code> </li>
-            </ul>
+        <ul>
+            <li> added overloads for <code>#stream()</code> and <code>#table()</code> that allow to define a <code>auto.offset.reset</code> policy per input stream/table </li>
+            <li> added method <code>#globalKTable()</code> to create a <code>GlobalKTable</code> </li>
+        </ul>
 
         <p> New joins for <code>KStream</code>: </p>
-            <ul>
-                <li> added overloads for <code>#join()</code> to join with <code>KTable</code> </li>
-                <li> added overloads for <code>#join()</code> and <code>leftJoin()</code> to join with <code>GlobalKTable</code> </li>
-            </ul>
+        <ul>
+            <li> added overloads for <code>#join()</code> to join with <code>KTable</code> </li>
+            <li> added overloads for <code>#join()</code> and <code>leftJoin()</code> to join with <code>GlobalKTable</code> </li>
+            <li> note, join semantics in 0.10.2 were improved and thus you might see different result compared to 0.10.0.x and 0.10.1.x
+                 (cf. <a href="https://cwiki.apache.org/confluence/display/KAFKA/Kafka+Streams+Join+Semantics">Kafka Streams Join Semantics</a> in the Apache Kafka wiki)
+        </ul>
 
         <p> Aligned <code>null</code>-key handling for <code>KTable</code> joins: </p>
-            <ul>
-                <li> like all other KTable operations, <code>KTable-KTable</code> joins do not throw an exception on <code>null</code> key records anymore, but drop those records silently </li>
-            </ul>
+        <ul>
+            <li> like all other KTable operations, <code>KTable-KTable</code> joins do not throw an exception on <code>null</code> key records anymore, but drop those records silently </li>
+        </ul>
 
         <p> New window type <em>Session Windows</em>: </p>
-            <ul>
-                <li> added class <code>SessionWindows</code> to specify session windows </li>
-                <li> added overloads for <code>KGroupedStream</code> methods <code>#count()</code>, <code>#reduce()</code>, and <code>#aggregate()</code>
-                     to allow session window aggregations </li>
-            </ul>
+        <ul>
+            <li> added class <code>SessionWindows</code> to specify session windows </li>
+            <li> added overloads for <code>KGroupedStream</code> methods <code>#count()</code>, <code>#reduce()</code>, and <code>#aggregate()</code>
+                 to allow session window aggregations </li>
+        </ul>
 
         <p> Changes to <code>TimestampExtractor</code>: </p>
-            <ul>
-                <li> method <code>#extract()</code> has a second parameter now </li>
-                <li> new default timestamp extractor class <code>FailOnInvalidTimestamp</code>
-                     (it gives the same behavior as old (and removed) default extractor <code>ConsumerRecordTimestampExtractor</code>) </li>
-                <li> new alternative timestamp extractor classes <code>LogAndSkipOnInvalidTimestamp</code> and <code>UsePreviousTimeOnInvalidTimestamps</code> </li>
-            </ul>
+        <ul>
+            <li> method <code>#extract()</code> has a second parameter now </li>
+            <li> new default timestamp extractor class <code>FailOnInvalidTimestamp</code>
+                 (it gives the same behavior as old (and removed) default extractor <code>ConsumerRecordTimestampExtractor</code>) </li>
+            <li> new alternative timestamp extractor classes <code>LogAndSkipOnInvalidTimestamp</code> and <code>UsePreviousTimeOnInvalidTimestamps</code> </li>
+        </ul>
 
         <p> Relaxed type constraints of many DSL interfaces, classes, and methods (cf. <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-100+-+Relax+Type+constraints+in+Kafka+Streams+API">KIP-100</a>). </p>
+
+        <h3><a id="streams_api_changes_0101" href="#streams_api_changes_0101">Streams API changes in 0.10.1.0</a></h3>
+
+        <p> Stream grouping and aggregation split into two methods: </p>
+        <ul>
+            <li> old: KStream #aggregateByKey(), #reduceByKey(), and #countByKey() </li>
+            <li> new: KStream#groupByKey() plus KGroupedStream #aggregate(), #reduce(), and #count() </li>
+            <li> Example: stream.countByKey() changes to stream.groupByKey().count() </li>
+        </ul>
+
+        <p> Auto Repartitioning: </p>
+        <ul>
+            <li> a call to through() after a key-changing operator and before an aggregation/join is no longer required </li>
+            <li> Example: stream.selectKey(...).through(...).countByKey() changes to stream.selectKey().groupByKey().count() </li>
+        </ul>
+
+        <p> TopologyBuilder: </p>
+        <ul>
+            <li> methods #sourceTopics(String applicationId) and #topicGroups(String applicationId) got simplified to #sourceTopics() and #topicGroups() </li>
+        </ul>
+
+        <p> DSL: new parameter to specify state store names: </p>
+        <ul>
+            <li> The new Interactive Queries feature requires to specify a store name for all source KTables and window aggregation result KTables (previous parameter "operator/window name" is now the storeName) </li>
+            <li> KStreamBuilder#table(String topic) changes to #topic(String topic, String storeName) </li>
+            <li> KTable#through(String topic) changes to #through(String topic, String storeName) </li>
+            <li> KGroupedStream #aggregate(), #reduce(), and #count() require additional parameter "String storeName"</li>
+            <li> Example: stream.countByKey(TimeWindows.of("windowName", 1000)) changes to stream.groupByKey().count(TimeWindows.of(1000), "countStoreName") </li>
+        </ul>
+
+        <p> Windowing: </p>
+        <ul>
+            <li> Windows are not named anymore: TimeWindows.of("name", 1000) changes to TimeWindows.of(1000) (cf. DSL: new parameter to specify state store names) </li>
+            <li> JoinWindows has no default size anymore: JoinWindows.of("name").within(1000) changes to JoinWindows.of(1000) </li>
+        </ul>
+
 </script>
 
 <!--#include virtual="../includes/_header.htm" -->
diff --git a/docs/toc.html b/docs/toc.html
index 792dc4e4f2575..787153d8cd723 100644
--- a/docs/toc.html
+++ b/docs/toc.html
@@ -144,11 +144,11 @@
                     <li><a href="/{{version}}/documentation/streams#streams_dsl">High-Level Streams DSL</a></li>
                     <li><a href="/{{version}}/documentation/streams#streams_execute">Application Configuration and Execution</a></li>
                 </ul>
-                <li><a href="/{{version}}/documentation/streams#streams_upgrade">9.5 Upgrade Guide and API Changes</a></li>
+                <li><a href="/{{version}}/documentation/streams#streams_upgrade_and_api">9.5 Upgrade Guide and API Changes</a></li>
             </ul>
         </li>
     </ul>
 
 </script>
 
-<div class="p-toc"></div>
\ No newline at end of file
+<div class="p-toc"></div>
diff --git a/docs/upgrade.html b/docs/upgrade.html
index a06eeb6840304..597605461ad5e 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -47,15 +47,14 @@ <h4><a id="upgrade_10_2_0" href="#upgrade_10_2_0">Upgrading from 0.8.x, 0.9.x, 0
 
 <p><b>Note:</b> Bumping the protocol version and restarting can be done any time after the brokers were upgraded. It does not have to be immediately after.
 
-<h5><a id="upgrade_1020_streams" href="#upgrade_1020_streams">Upgrading a Kafka Streams Application</a></h5>
+<h5><a id="upgrade_1020_streams" href="#upgrade_1020_streams">Upgrading a 0.10.1 Kafka Streams Application</a></h5>
 <ul>
     <li> Upgrading your Streams application from 0.10.1 to 0.10.2 does not require a broker upgrade.
          A Kafka Streams 0.10.2 application can connect to 0.10.2 and 0.10.1 brokers (it is not possible to connect to 0.10.0 brokers though). </li>
     <li> You need to recompile your code. Just swapping the Kafka Streams library jar file will not work and will break your application. </li>
-    <li> <code>KStreamBuilder#table()</code> always requires a store name. </li>
-    <li> <code>KTable#through()</code> always requires a store name. </li>
     <li> If you use a custom (i.e., user implemented) timestamp extractor, you will need to update this code, because the <code>TimestampExtractor</code> interface was changed. </li>
     <li> If you register custom metrics, you will need to update this code, because the <code>StreamsMetric</code> interface was changed. </li>
+    <li> See <a href="/{{version}}/documentation/streams#streams_api_changes_0102">Streams API changes in 0.10.2</a> for more details. </li>
 </ul>
 
 <h5><a id="upgrade_1020_notable" href="#upgrade_1020_notable">Notable changes in 0.10.2.0</a></h5>
@@ -75,7 +74,8 @@ <h5><a id="upgrade_1020_notable" href="#upgrade_1020_notable">Notable changes in
         modifying Zookeeper directly. This eliminates the need for privileges to access Zookeeper directly and "StreamsConfig.ZOOKEEPER_CONFIG"
         should not be set in the Streams app any more. If the Kafka cluster is secured, Streams apps must have the required security privileges to create new topics.</li>
     <li>Several new fields including "security.protocol", "connections.max.idle.ms", "retry.backoff.ms", "reconnect.backoff.ms" and "request.timeout.ms" were added to
-        StreamsConfig class. User should pay attenntion to the default values and set these if needed. For more details please refer to <a href="#streamsconfigs">3.5 Kafka Streams Configs</a>.</li>
+        StreamsConfig class. User should pay attention to the default values and set these if needed. For more details please refer to <a href="/{{version}}/documentation/#streamsconfigs">3.5 Kafka Streams Configs</a>.</li>
+    <li>The <code>offsets.topic.replication.factor</code> broker config is now enforced upon auto topic creation. Internal auto topic creation will fail with a GROUP_COORDINATOR_NOT_AVAILABLE error until the cluster size meets this replication factor requirement.</li>
 </ul>
 
 <h5><a id="upgrade_1020_new_protocols" href="#upgrade_1020_new_protocols">New Protocol Versions</a></h5>
@@ -125,41 +125,11 @@ <h5><a id="upgrade_10_1_breaking" href="#upgrade_10_1_breaking">Potential breaki
     <li> Due to the increased number of index files, on some brokers with large amount the log segments (e.g. >15K), the log loading process during the broker startup could be longer. Based on our experiment, setting the num.recovery.threads.per.data.dir to one may reduce the log loading time. </li>
 </ul>
 
-<h5><a id="upgrade_1010_streams" href="#upgrade_1010_streams">Streams API changes in 0.10.1.0</a></h5>
+<h5><a id="upgrade_1010_streams" href="#upgrade_1010_streams">Upgrading a 0.10.0 Kafka Streams Application</a></h5>
 <ul>
-    <li> Stream grouping and aggregation split into two methods:
-        <ul>
-            <li> old: KStream #aggregateByKey(), #reduceByKey(), and #countByKey() </li>
-            <li> new: KStream#groupByKey() plus KGroupedStream #aggregate(), #reduce(), and #count() </li>
-            <li> Example: stream.countByKey() changes to stream.groupByKey().count() </li>
-        </ul>
-    </li>
-    <li> Auto Repartitioning:
-        <ul>
-            <li> a call to through() after a key-changing operator and before an aggregation/join is no longer required </li>
-            <li> Example: stream.selectKey(...).through(...).countByKey() changes to stream.selectKey().groupByKey().count() </li>
-        </ul>
-    </li>
-    <li> TopologyBuilder:
-        <ul>
-            <li> methods #sourceTopics(String applicationId) and #topicGroups(String applicationId) got simplified to #sourceTopics() and #topicGroups() </li>
-        </ul>
-    </li>
-    <li> DSL: new parameter to specify state store names:
-        <ul>
-            <li> The new Interactive Queries feature requires to specify a store name for all source KTables and window aggregation result KTables (previous parameter "operator/window name" is now the storeName) </li>
-            <li> KStreamBuilder#table(String topic) changes to #topic(String topic, String storeName) </li>
-            <li> KTable#through(String topic) changes to #through(String topic, String storeName) </li>
-            <li> KGroupedStream #aggregate(), #reduce(), and #count() require additional parameter "String storeName"</li>
-            <li> Example: stream.countByKey(TimeWindows.of("windowName", 1000)) changes to stream.groupByKey().count(TimeWindows.of(1000), "countStoreName") </li>
-        </ul>
-    </li>
-    <li> Windowing:
-        <ul>
-            <li> Windows are not named anymore: TimeWindows.of("name", 1000) changes to TimeWindows.of(1000) (cf. DSL: new parameter to specify state store names) </li>
-            <li> JoinWindows has no default size anymore: JoinWindows.of("name").within(1000) changes to JoinWindows.of(1000) </li>
-        </ul>
-    </li>
+    <li> Upgrading your Streams application from 0.10.0 to 0.10.1 does require a <a href="#upgrade_10_1">broker upgrade</a> because a Kafka Streams 0.10.1 application can only connect to 0.10.1 brokers. </li>
+    <li> There are couple of API changes, that are not backward compatible (cf. <a href="/{{version}}/documentation/streams#streams_api_changes_0101">Streams API changes in 0.10.1</a> for more details).
+         Thus, you need to update and recompile your code. Just swapping the Kafka Streams library jar file will not work and will break your application. </li>
 </ul>
 
 <h5><a id="upgrade_1010_notable" href="#upgrade_1010_notable">Notable changes in 0.10.1.0</a></h5>
@@ -299,7 +269,7 @@ <h5><a id="upgrade_10_breaking" href="#upgrade_10_breaking">Potential breaking c
 <h5><a id="upgrade_10_notable" href="#upgrade_10_notable">Notable changes in 0.10.0.0</a></h5>
 
 <ul>
-    <li> Starting from Kafka 0.10.0.0, a new client library named <b>Kafka Streams</b> is available for stream processing on data stored in Kafka topics. This new client library only works with 0.10.x and upward versioned brokers due to message format changes mentioned above. For more information please read <a href="#streams_overview">this section</a>.</li>
+    <li> Starting from Kafka 0.10.0.0, a new client library named <b>Kafka Streams</b> is available for stream processing on data stored in Kafka topics. This new client library only works with 0.10.x and upward versioned brokers due to message format changes mentioned above. For more information please read <a href="/{{version}}/documentation/stream">Streams documentation</a>.</li>
     <li> The default value of the configuration parameter <code>receive.buffer.bytes</code> is now 64K for the new consumer.</li>
     <li> The new consumer now exposes the configuration parameter <code>exclude.internal.topics</code> to restrict internal topics (such as the consumer offsets topic) from accidentally being included in regular expression subscriptions. By default, it is enabled.</li>
     <li> The old Scala producer has been deprecated. Users should migrate their code to the Java producer included in the kafka-clients JAR as soon as possible. </li>
diff --git a/docs/uses.html b/docs/uses.html
index 2d238c2239fb4..4e88859229c79 100644
--- a/docs/uses.html
+++ b/docs/uses.html
@@ -15,40 +15,67 @@
  limitations under the License.
 -->
 
-<p> Here is a description of a few of the popular use cases for Apache Kafka&trade;. For an overview of a number of these areas in action, see <a href="http://engineering.linkedin.com/distributed-systems/log-what-every-software-engineer-should-know-about-real-time-datas-unifying">this blog post</a>. </p>
+<p> Here is a description of a few of the popular use cases for Apache Kafka&trade;.
+For an overview of a number of these areas in action, see <a href="https://engineering.linkedin.com/distributed-systems/log-what-every-software-engineer-should-know-about-real-time-datas-unifying/">this blog post</a>. </p>
 
 <h4><a id="uses_messaging" href="#uses_messaging">Messaging</a></h4>
 
-Kafka works well as a replacement for a more traditional message broker. Message brokers are used for a variety of reasons (to decouple processing from data producers, to buffer unprocessed messages, etc). In comparison to most messaging systems Kafka has better throughput, built-in partitioning, replication, and fault-tolerance which makes it a good solution for large scale message processing applications.
+Kafka works well as a replacement for a more traditional message broker.
+Message brokers are used for a variety of reasons (to decouple processing from data producers, to buffer unprocessed messages, etc).
+In comparison to most messaging systems Kafka has better throughput, built-in partitioning, replication, and fault-tolerance which makes it a good
+solution for large scale message processing applications.
 <p>
-In our experience messaging uses are often comparatively low-throughput, but may require low end-to-end latency and often depend on the strong durability guarantees Kafka provides.
+In our experience messaging uses are often comparatively low-throughput, but may require low end-to-end latency and often depend on the strong
+durability guarantees Kafka provides.
 <p>
-In this domain Kafka is comparable to traditional messaging systems such as <a href="http://activemq.apache.org">ActiveMQ</a> or <a href="https://www.rabbitmq.com">RabbitMQ</a>.
+In this domain Kafka is comparable to traditional messaging systems such as <a href="http://activemq.apache.org">ActiveMQ</a> or
+<a href="https://www.rabbitmq.com">RabbitMQ</a>.
 
 <h4><a id="uses_website" href="#uses_website">Website Activity Tracking</a></h4>
 
-The original use case for Kafka was to be able to rebuild a user activity tracking pipeline as a set of real-time publish-subscribe feeds. This means site activity (page views, searches, or other actions users may take) is published to central topics with one topic per activity type. These feeds are available for subscription for a range of use cases including real-time processing, real-time monitoring, and loading into Hadoop or offline data warehousing systems for offline processing and reporting.
+The original use case for Kafka was to be able to rebuild a user activity tracking pipeline as a set of real-time publish-subscribe feeds.
+This means site activity (page views, searches, or other actions users may take) is published to central topics with one topic per activity type.
+These feeds are available for subscription for a range of use cases including real-time processing, real-time monitoring, and loading into Hadoop or
+offline data warehousing systems for offline processing and reporting.
 <p>
 Activity tracking is often very high volume as many activity messages are generated for each user page view.
 
 <h4><a id="uses_metrics" href="#uses_metrics">Metrics</a></h4>
 
-Kafka is often used for operational monitoring data. This involves aggregating statistics from distributed applications to produce centralized feeds of operational data.
+Kafka is often used for operational monitoring data.
+This involves aggregating statistics from distributed applications to produce centralized feeds of operational data.
 
 <h4><a id="uses_logs" href="#uses_logs">Log Aggregation</a></h4>
 
-Many people use Kafka as a replacement for a log aggregation solution. Log aggregation typically collects physical log files off servers and puts them in a central place (a file server or HDFS perhaps) for processing. Kafka abstracts away the details of files and gives a cleaner abstraction of log or event data as a stream of messages. This allows for lower-latency processing and easier support for multiple data sources and distributed data consumption.
+Many people use Kafka as a replacement for a log aggregation solution.
+Log aggregation typically collects physical log files off servers and puts them in a central place (a file server or HDFS perhaps) for processing.
+Kafka abstracts away the details of files and gives a cleaner abstraction of log or event data as a stream of messages.
+This allows for lower-latency processing and easier support for multiple data sources and distributed data consumption.
 
-In comparison to log-centric systems like Scribe or Flume, Kafka offers equally good performance, stronger durability guarantees due to replication, and much lower end-to-end latency.
+In comparison to log-centric systems like Scribe or Flume, Kafka offers equally good performance, stronger durability guarantees due to replication,
+and much lower end-to-end latency.
 
 <h4><a id="uses_streamprocessing" href="#uses_streamprocessing">Stream Processing</a></h4>
 
-Many users of Kafka process data in processing pipelines consisting of multiple stages, where raw input data is consumed from Kafka topics and then aggregated, enriched, or otherwise transformed into new topics for further consumption or follow-up processing. For example, a processing pipeline for recommending news articles might crawl article content from RSS feeds and publish it to an "articles" topic; further processing might normalize or deduplicate this content and published the cleansed article content to a new topic; a final processing stage might attempt to recommend this content to users. Such processing pipelines create graphs of real-time data flows based on the individual topics. Starting in 0.10.0.0, a light-weight but powerful stream processing library called <a href="#streams_overview">Kafka Streams</a> is available in Apache Kafka to perform such data processing as described above. Apart from Kafka Streams, alternative open source stream processing tools include <a href="https://storm.apache.org/">Apache Storm</a> and <a href="http://samza.apache.org/">Apache Samza</a>.
+Many users of Kafka process data in processing pipelines consisting of multiple stages, where raw input data is consumed from Kafka topics and then
+aggregated, enriched, or otherwise transformed into new topics for further consumption or follow-up processing.
+For example, a processing pipeline for recommending news articles might crawl article content from RSS feeds and publish it to an "articles" topic;
+further processing might normalize or deduplicate this content and published the cleansed article content to a new topic;
+a final processing stage might attempt to recommend this content to users.
+Such processing pipelines create graphs of real-time data flows based on the individual topics.
+Starting in 0.10.0.0, a light-weight but powerful stream processing library called <a href="/{{version}}/documentation/streams">Kafka Streams</a>
+is available in Apache Kafka to perform such data processing as described above.
+Apart from Kafka Streams, alternative open source stream processing tools include <a href="https://storm.apache.org/">Apache Storm</a> and
+<a href="http://samza.apache.org/">Apache Samza</a>.
 
 <h4><a id="uses_eventsourcing" href="#uses_eventsourcing">Event Sourcing</a></h4>
 
-<a href="http://martinfowler.com/eaaDev/EventSourcing.html">Event sourcing</a> is a style of application design where state changes are logged as a time-ordered sequence of records. Kafka's support for very large stored log data makes it an excellent backend for an application built in this style.
+<a href="http://martinfowler.com/eaaDev/EventSourcing.html">Event sourcing</a> is a style of application design where state changes are logged as a
+time-ordered sequence of records. Kafka's support for very large stored log data makes it an excellent backend for an application built in this style.
 
 <h4><a id="uses_commitlog" href="#uses_commitlog">Commit Log</a></h4>
 
-Kafka can serve as a kind of external commit-log for a distributed system. The log helps replicate data between nodes and acts as a re-syncing mechanism for failed nodes to restore their data. The <a href="/documentation.html#compaction">log compaction</a> feature in Kafka helps support this usage. In this usage Kafka is similar to <a href="http://zookeeper.apache.org/bookkeeper/">Apache BookKeeper</a> project.
+Kafka can serve as a kind of external commit-log for a distributed system. The log helps replicate data between nodes and acts as a re-syncing
+mechanism for failed nodes to restore their data.
+The <a href="/documentation.html#compaction">log compaction</a> feature in Kafka helps support this usage.
+In this usage Kafka is similar to <a href="http://zookeeper.apache.org/bookkeeper/">Apache BookKeeper</a> project.

From f6d07e206799f1caabccc3e2a30eea62e4d4881d Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno@confluent.io>
Date: Wed, 15 Feb 2017 16:32:02 -0800
Subject: [PATCH 106/177] MINOR: Stream metrics documentation

Author: Eno Thereska <eno@confluent.io>

Reviewers: Matthias J. Sax, Guozhang Wang

Closes #2542 from enothereska/minor-streams-metrics

(cherry picked from commit 2e1b00f262947c4c3211df205df259ef517763f4)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 docs/ops.html | 130 +++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 124 insertions(+), 6 deletions(-)

diff --git a/docs/ops.html b/docs/ops.html
index a3423a7032709..9232f651ecae1 100644
--- a/docs/ops.html
+++ b/docs/ops.html
@@ -14,8 +14,8 @@
  See the License for the specific language governing permissions and
  limitations under the License.
 -->
-
 <script id="ops-template" type="text/x-handlebars-template">
+  
   Here is some information on actually running Kafka as a production system based on usage and experience at LinkedIn. Please send us any additional tips you know of.
 
   <h3><a id="basic_ops" href="#basic_ops">6.1 Basic Kafka Operations</a></h3>
@@ -842,9 +842,9 @@ <h3><a id="monitoring" href="#monitoring">6.6 Monitoring</a></h3>
       </tr>
   </tbody></table>
 
-  <h4><a id="selector_monitoring" href="#selector_monitoring">Common monitoring metrics for producer/consumer/connect</a></h4>
+  <h4><a id="selector_monitoring" href="#selector_monitoring">Common monitoring metrics for producer/consumer/connect/streams</a></h4>
 
-  The following metrics are available on producer/consumer/connector instances.  For specific metrics, please see following sections.
+  The following metrics are available on producer/consumer/connector/streams instances.  For specific metrics, please see following sections.
 
   <table class="data-table">
     <tbody>
@@ -931,9 +931,9 @@ <h4><a id="selector_monitoring" href="#selector_monitoring">Common monitoring me
     </tbody>
   </table>
 
-  <h4><a id="common_node_monitoring" href="#common_node_monitoring">Common Per-broker metrics for producer/consumer/connect</a></h4>
+  <h4><a id="common_node_monitoring" href="#common_node_monitoring">Common Per-broker metrics for producer/consumer/connect/streams</a></h4>
 
-  The following metrics are available on producer/consumer/connector instances.  For specific metrics, please see following sections.
+  The following metrics are available on producer/consumer/connector/streams instances.  For specific metrics, please see following sections.
 
   <table class="data-table">
     <tbody>
@@ -1314,7 +1314,125 @@ <h5><a id="topic_fetch_monitoring" href="#topic_fetch_monitoring">Topic-level Fe
     </tbody>
   </table>
 
-  <h5><a id="others_monitoring" href="#others_monitoring">Others</a></h5>
+
+
+  <h4><a id="kafka_streams_monitoring" href="#kafka_streams_monitoring">Streams Monitoring</a></h4>
+
+  A Kafka Streams instance contains all the producer and consumer metrics as well as additional metrics specific to streams. By default Kafka Streams has metrics with two recording levels: debug and info. The debug level records all metrics, while the info level records only the thread-level metrics.  Use the following configuration option to specify which metrics you want collected:
+<pre>metrics.recording.level="info"</pre>
+
+<h5><a id="kafka_streams_thread_monitoring" href="#kafka_streams_thread_monitoring">Thread Metrics</a></h5>
+All the following metrics have a recording level of ``info``:
+<table class="data-table">
+    <tbody>
+      <tr>
+        <th>Metric/Attribute name</th>
+        <th>Description</th>
+        <th>Mbean name</th>
+      </tr>
+      <tr>
+        <td>[commit | poll | process | punctuate]-latency-[avg | max]</td>
+        <td>The [average | maximum] execution time in ms, for the respective operation, across all running tasks of this thread.</td>
+        <td>kafka.streams:type=stream-metrics,thread.client-id=([-.\w]+)</td>
+      </tr>
+      <tr>
+        <td>[commit | poll | process | punctuate]-rate</td>
+        <td>The average number of respective operations per second across all tasks.</td>
+        <td>kafka.streams:type=stream-metrics,thread.client-id=([-.\w]+)</td>
+      </tr>
+      <tr>
+        <td>task-created-rate</td>
+        <td>The average number of newly created tasks per second.</td>
+        <td>kafka.streams:type=stream-metrics,thread.client-id=([-.\w]+)</td>
+      </tr>
+      <tr>
+        <td>task-closed-rate</td>
+        <td>The average number of tasks closed per second.</td>
+        <td>kafka.streams:type=stream-metrics,thread.client-id=([-.\w]+)</td>
+      </tr>
+      <tr>
+        <td>skipped-records-rate</td>
+        <td>The average number of skipped records per second. </td>
+        <td>kafka.streams:type=stream-metrics,thread.client-id=([-.\w]+)</td>
+      </tr>
+ </tbody>
+</table>
+
+<h5><a id="kafka_streams_task_monitoring" href="#kafka_streams_task_monitoring">Task Metrics</a></h5>
+All the following metrics have a recording level of ``debug``:
+ <table class="data-table">
+      <tbody>
+      <tr>
+        <th>Metric/Attribute name</th>
+        <th>Description</th>
+        <th>Mbean name</th>
+      </tr>
+      <tr>
+        <td>commit-latency-[avg | max]</td>
+        <td>The [average | maximum] commit time in ns for this task. </td>
+        <td>kafka.streams:type=stream-task-metrics,streams-task-id=([-.\w]+)</td>
+      </tr>
+      <tr>
+        <td>commit-rate</td>
+        <td>The average number of commit calls per second. </td>
+        <td>kafka.streams:type=stream-task-metrics,streams-task-id=([-.\w]+)</td>
+      </tr>
+ </tbody>
+</table>
+
+ <h5><a id="kafka_streams_node_monitoring" href="#kafka_streams_node_monitoring">Processor Node Metrics</a></h5>
+All the following metrics have a recording level of ``debug``:
+ <table class="data-table">
+      <tbody>
+      <tr>
+        <th>Metric/Attribute name</th>
+        <th>Description</th>
+        <th>Mbean name</th>
+      </tr>
+      <tr>
+        <td>[process | punctuate | create | destroy]-latency-[avg | max]</td>
+        <td>The [average | maximum] execution time in ns, for the respective operation. </td>
+        <td>kafka.streams:type=stream-processor-node-metrics, processor-node-id=([-.\w]+)</td>
+      </tr>
+      <tr>
+        <td>[process | punctuate | create | destroy]-rate</td>
+        <td>The average number of respective operations per second. </td>
+        <td>kafka.streams:type=stream-processor-node-metrics, processor-node-id=([-.\w]+)</td>
+      </tr>
+      <tr>
+        <td>forward-rate</td>
+        <td>The average rate of records being forwarded downstream, from source nodes only, per second. </td>
+        <td>kafka.streams:type=stream-processor-node-metrics, processor-node-id=([-.\w]+)</td>
+      </tr>
+ </tbody>
+ </table>
+
+ <h5><a id="kafka_streams_store_monitoring" href="#kafka_streams_store_monitoring">State Store Metrics</a></h5>
+All the following metrics have a recording level of ``debug``:
+
+ <table class="data-table">
+      <tbody>
+      <tr>
+        <th>Metric/Attribute name</th>
+        <th>Description</th>
+        <th>Mbean name</th>
+      </tr>
+      <tr>
+        <td>[put | put-if-absent | get | delete | put-all | all | range | flush | restore]-latency-[avg | max]</td>
+        <td>The average execution time in ns, for the respective operation. </td>
+        <td>kafka.streams:type=stream-[store-type]-metrics</td>
+      </tr>
+        <tr>
+        <td>[put | put-if-absent | get | delete | put-all | all | range | flush | restore]-rate</td>
+        <td>The average rate of respective operations per second for this store.</td>
+        <td>kafka.streams:type=stream-[store-type]-metrics</td>
+      </tr>
+      
+    </tbody>
+</table>
+
+
+  <h4><a id="others_monitoring" href="#others_monitoring">Others</a></h4>
 
   We recommend monitoring GC time and other stats and various server stats such as CPU utilization, I/O service time, etc.
 

From 167d5a33fd05bbd281ee2afc56b0b1f70ffaf7fe Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Wed, 15 Feb 2017 16:39:52 -0800
Subject: [PATCH 107/177] MINOR: add session windows doc to streams.html

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Michael G. Noll, Matthias J. Sax, Guozhang Wang

Closes #2547 from dguy/session-window-doc

(cherry picked from commit abe5e0e489a1d93867098da8d472060055b31b72)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 docs/streams.html | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/streams.html b/docs/streams.html
index 31bae5d0800a9..d9afee8be21fa 100644
--- a/docs/streams.html
+++ b/docs/streams.html
@@ -539,6 +539,13 @@ <h4><a id="streams_dsl_windowing" href="#streams_dsl_windowing">Windowing a stre
         <li><b>Hopping time windows</b> are windows based on time intervals. They model fixed-sized, (possibly) overlapping windows. A hopping window is defined by two properties: the window's size and its advance interval (aka "hop"). The advance interval specifies by how much a window moves forward relative to the previous one. For example, you can configure a hopping window with a size 5 minutes and an advance interval of 1 minute. Since hopping windows can overlap a data record may belong to more than one such windows.</li>
         <li><b>Tumbling time windows</b> are a special case of hopping time windows and, like the latter, are windows based on time intervals. They model fixed-size, non-overlapping, gap-less windows. A tumbling window is defined by a single property: the window's size. A tumbling window is a hopping window whose window size is equal to its advance interval. Since tumbling windows never overlap, a data record will belong to one and only one window.</li>
         <li><b>Sliding windows</b> model a fixed-size window that slides continuously over the time axis; here, two data records are said to be included in the same window if the difference of their timestamps is within the window size. Thus, sliding windows are not aligned to the epoch, but on the data record timestamps. In Kafka Streams, sliding windows are used only for join operations, and can be specified through the <code>JoinWindows</code> class.</li>
+        <li><b>Session windows</b> are used to aggregate key-based events into sessions.
+            Sessions represent a period of activity separated by a defined gap of inactivity.
+            Any events processed that fall within the inactivity gap of any existing sessions are merged into the existing sessions.
+            If the event falls outside of the session gap, then a new session will be created.
+            Session windows are tracked independently across keys (e.g. windows of different keys typically have different start and end times) and their sizes vary (even windows for the same key typically have different sizes);
+            as such session windows can't be pre-computed and are instead derived from analyzing the timestamps of the data records.
+        </li>
         </ul>
 
         <p>

From 5d1bb0a9a0f650e500ee47cfc30d2045963410ec Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Wed, 15 Feb 2017 17:02:15 -0800
Subject: [PATCH 108/177] MINOR: fix indention in <pre> tags

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2553 from mjsax/hotfixDocs2

(cherry picked from commit af182480d2f31f8ef44764fc8cfa250ec76a878f)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 docs/streams.html | 392 +++++++++++++++++++++++-----------------------
 1 file changed, 196 insertions(+), 196 deletions(-)

diff --git a/docs/streams.html b/docs/streams.html
index d9afee8be21fa..6461f867ad705 100644
--- a/docs/streams.html
+++ b/docs/streams.html
@@ -306,60 +306,60 @@ <h4><a id="streams_processor_process" href="#streams_processor_process">Processo
         The following example <code>Processor</code> implementation defines a simple word-count algorithm:
         </p>
 
-        <pre>
-            public class MyProcessor extends Processor&lt;String, String&gt; {
-                private ProcessorContext context;
-                private KeyValueStore&lt;String, Long&gt; kvStore;
-
-                @Override
-                @SuppressWarnings("unchecked")
-                public void init(ProcessorContext context) {
-                    // keep the processor context locally because we need it in punctuate() and commit()
-                    this.context = context;
-
-                    // call this processor's punctuate() method every 1000 milliseconds.
-                    this.context.schedule(1000);
-
-                    // retrieve the key-value store named "Counts"
-                    this.kvStore = (KeyValueStore&lt;String, Long&gt;) context.getStateStore("Counts");
-                }
-
-                @Override
-                public void process(String dummy, String line) {
-                    String[] words = line.toLowerCase().split(" ");
-
-                    for (String word : words) {
-                        Long oldValue = this.kvStore.get(word);
-
-                        if (oldValue == null) {
-                            this.kvStore.put(word, 1L);
-                        } else {
-                            this.kvStore.put(word, oldValue + 1L);
-                        }
-                    }
-                }
-
-                @Override
-                public void punctuate(long timestamp) {
-                    KeyValueIterator&lt;String, Long&gt; iter = this.kvStore.all();
-
-                    while (iter.hasNext()) {
-                        KeyValue&lt;String, Long&gt; entry = iter.next();
-                        context.forward(entry.key, entry.value.toString());
-                    }
-
-                    iter.close();
-                    // commit the current processing progress
-                    context.commit();
-                }
-
-                @Override
-                public void close() {
-                    // close the key-value store
-                    this.kvStore.close();
-                }
-            };
-        </pre>
+<pre>
+public class MyProcessor extends Processor&lt;String, String&gt; {
+    private ProcessorContext context;
+    private KeyValueStore&lt;String, Long&gt; kvStore;
+
+    @Override
+    @SuppressWarnings("unchecked")
+    public void init(ProcessorContext context) {
+        // keep the processor context locally because we need it in punctuate() and commit()
+        this.context = context;
+
+        // call this processor's punctuate() method every 1000 milliseconds.
+        this.context.schedule(1000);
+
+        // retrieve the key-value store named "Counts"
+        this.kvStore = (KeyValueStore&lt;String, Long&gt;) context.getStateStore("Counts");
+    }
+
+    @Override
+    public void process(String dummy, String line) {
+        String[] words = line.toLowerCase().split(" ");
+
+        for (String word : words) {
+            Long oldValue = this.kvStore.get(word);
+
+            if (oldValue == null) {
+                this.kvStore.put(word, 1L);
+            } else {
+                this.kvStore.put(word, oldValue + 1L);
+            }
+        }
+    }
+
+    @Override
+    public void punctuate(long timestamp) {
+        KeyValueIterator&lt;String, Long&gt; iter = this.kvStore.all();
+
+        while (iter.hasNext()) {
+            KeyValue&lt;String, Long&gt; entry = iter.next();
+            context.forward(entry.key, entry.value.toString());
+        }
+
+        iter.close();
+        // commit the current processing progress
+        context.commit();
+    }
+
+    @Override
+    public void close() {
+        // close the key-value store
+        this.kvStore.close();
+    }
+};
+</pre>
 
         <p>
         In the above implementation, the following actions are performed:
@@ -379,31 +379,31 @@ <h4><a id="streams_processor_topology" href="#streams_processor_topology">Proces
         by connecting these processors together:
         </p>
 
-        <pre>
-            TopologyBuilder builder = new TopologyBuilder();
+<pre>
+TopologyBuilder builder = new TopologyBuilder();
 
-            builder.addSource("SOURCE", "src-topic")
-                // add "PROCESS1" node which takes the source processor "SOURCE" as its upstream processor
-                .addProcessor("PROCESS1", () -> new MyProcessor1(), "SOURCE")
+builder.addSource("SOURCE", "src-topic")
+    // add "PROCESS1" node which takes the source processor "SOURCE" as its upstream processor
+    .addProcessor("PROCESS1", () -> new MyProcessor1(), "SOURCE")
 
-                // add "PROCESS2" node which takes "PROCESS1" as its upstream processor
-                .addProcessor("PROCESS2", () -> new MyProcessor2(), "PROCESS1")
+    // add "PROCESS2" node which takes "PROCESS1" as its upstream processor
+    .addProcessor("PROCESS2", () -> new MyProcessor2(), "PROCESS1")
 
-                // add "PROCESS3" node which takes "PROCESS1" as its upstream processor
-                .addProcessor("PROCESS3", () -> new MyProcessor3(), "PROCESS1")
+    // add "PROCESS3" node which takes "PROCESS1" as its upstream processor
+    .addProcessor("PROCESS3", () -> new MyProcessor3(), "PROCESS1")
 
-                // add the sink processor node "SINK1" that takes Kafka topic "sink-topic1"
-                // as output and the "PROCESS1" node as its upstream processor
-                .addSink("SINK1", "sink-topic1", "PROCESS1")
+    // add the sink processor node "SINK1" that takes Kafka topic "sink-topic1"
+    // as output and the "PROCESS1" node as its upstream processor
+    .addSink("SINK1", "sink-topic1", "PROCESS1")
 
-                // add the sink processor node "SINK2" that takes Kafka topic "sink-topic2"
-                // as output and the "PROCESS2" node as its upstream processor
-                .addSink("SINK2", "sink-topic2", "PROCESS2")
+    // add the sink processor node "SINK2" that takes Kafka topic "sink-topic2"
+    // as output and the "PROCESS2" node as its upstream processor
+    .addSink("SINK2", "sink-topic2", "PROCESS2")
 
-                // add the sink processor node "SINK3" that takes Kafka topic "sink-topic3"
-                // as output and the "PROCESS3" node as its upstream processor
-                .addSink("SINK3", "sink-topic3", "PROCESS3");
-        </pre>
+    // add the sink processor node "SINK3" that takes Kafka topic "sink-topic3"
+    // as output and the "PROCESS3" node as its upstream processor
+    .addSink("SINK3", "sink-topic3", "PROCESS3");
+</pre>
 
         There are several steps in the above code to build the topology, and here is a quick walk through:
 
@@ -423,13 +423,13 @@ <h4><a id="streams_processor_statestore" href="#streams_processor_statestore">St
         In the following example, a persistent key-value store named “Counts” with key type <code>String</code> and value type <code>Long</code> is created.
         </p>
 
-        <pre>
-            StateStoreSupplier countStore = Stores.create("Counts")
-              .withKeys(Serdes.String())
-              .withValues(Serdes.Long())
-              .persistent()
-              .build();
-        </pre>
+<pre>
+StateStoreSupplier countStore = Stores.create("Counts")
+    .withKeys(Serdes.String())
+    .withValues(Serdes.Long())
+    .persistent()
+    .build();
+</pre>
 
         <p>
         To take advantage of these state stores, developers can use the <code>TopologyBuilder.addStateStore</code> method when building the
@@ -437,24 +437,24 @@ <h4><a id="streams_processor_statestore" href="#streams_processor_statestore">St
         state store with the existing processor nodes through <code>TopologyBuilder.connectProcessorAndStateStores</code>.
         </p>
 
-        <pre>
-            TopologyBuilder builder = new TopologyBuilder();
+<pre>
+TopologyBuilder builder = new TopologyBuilder();
 
-            builder.addSource("SOURCE", "src-topic")
+builder.addSource("SOURCE", "src-topic")
 
-                .addProcessor("PROCESS1", MyProcessor1::new, "SOURCE")
-                // add the created state store "COUNTS" associated with processor "PROCESS1"
-                .addStateStore(countStore, "PROCESS1")
-                .addProcessor("PROCESS2", MyProcessor3::new /* the ProcessorSupplier that can generate MyProcessor3 */, "PROCESS1")
-                .addProcessor("PROCESS3", MyProcessor3::new /* the ProcessorSupplier that can generate MyProcessor3 */, "PROCESS1")
+    .addProcessor("PROCESS1", MyProcessor1::new, "SOURCE")
+    // add the created state store "COUNTS" associated with processor "PROCESS1"
+    .addStateStore(countStore, "PROCESS1")
+    .addProcessor("PROCESS2", MyProcessor3::new /* the ProcessorSupplier that can generate MyProcessor3 */, "PROCESS1")
+    .addProcessor("PROCESS3", MyProcessor3::new /* the ProcessorSupplier that can generate MyProcessor3 */, "PROCESS1")
 
-                // connect the state store "COUNTS" with processor "PROCESS2"
-                .connectProcessorAndStateStores("PROCESS2", "COUNTS");
+    // connect the state store "COUNTS" with processor "PROCESS2"
+    .connectProcessorAndStateStores("PROCESS2", "COUNTS");
 
-                .addSink("SINK1", "sink-topic1", "PROCESS1")
-                .addSink("SINK2", "sink-topic2", "PROCESS2")
-                .addSink("SINK3", "sink-topic3", "PROCESS3");
-        </pre>
+    .addSink("SINK1", "sink-topic1", "PROCESS1")
+    .addSink("SINK2", "sink-topic2", "PROCESS2")
+    .addSink("SINK3", "sink-topic3", "PROCESS3");
+</pre>
 
         In the next section we present another way to build the processor topology: the Kafka Streams DSL.
         <br>
@@ -511,9 +511,9 @@ <h5><a id="streams_kstream_ktable" href="#streams_kstream_ktable">KStream, KTabl
 
         To illustrate the difference between KStreams and KTables/GlobalKTables, let’s imagine the following two data records are being sent to the stream:
 
-        <pre>
-            ("alice", 1) --> ("alice", 3)
-        </pre>
+<pre>
+("alice", 1) --> ("alice", 3)
+</pre>
 
         If these records a KStream and the stream processing application were to sum the values it would return <code>4</code>. If these records were a KTable or GlobalKTable, the return would be <code>3</code>, since the last record would be considered as an update.
 
@@ -525,13 +525,13 @@ <h4><a id="streams_dsl_source" href="#streams_dsl_source">Create Source Streams
         from a single topic).
         </p>
 
-        <pre>
-            KStreamBuilder builder = new KStreamBuilder();
+<pre>
+KStreamBuilder builder = new KStreamBuilder();
 
-            KStream&lt;String, GenericRecord&gt; source1 = builder.stream("topic1", "topic2");
-            KTable&lt;String, GenericRecord&gt; source2 = builder.table("topic3", "stateStoreName");
-            GlobalKTable&lt;String, GenericRecord&gt; source2 = builder.globalTable("topic4", "globalStoreName");
-        </pre>
+KStream&lt;String, GenericRecord&gt; source1 = builder.stream("topic1", "topic2");
+KTable&lt;String, GenericRecord&gt; source2 = builder.table("topic3", "stateStoreName");
+GlobalKTable&lt;String, GenericRecord&gt; source2 = builder.globalTable("topic4", "globalStoreName");
+</pre>
 
         <h4><a id="streams_dsl_windowing" href="#streams_dsl_windowing">Windowing a stream</a></h4>
         A stream processor may need to divide data records into time buckets, i.e. to <b>window</b> the stream by time. This is usually needed for join and aggregation operations, etc. Kafka Streams currently defines the following types of windows:
@@ -605,10 +605,10 @@ <h4><a id="streams_dsl_transform" href="#streams_dsl_transform">Transform a stre
 
         </p>
 
-        <pre>
-            // written in Java 8+, using lambda expressions
-            KStream&lt;String, GenericRecord&gt; mapped = source1.mapValue(record -> record.get("category"));
-        </pre>
+<pre>
+// written in Java 8+, using lambda expressions
+KStream&lt;String, GenericRecord&gt; mapped = source1.mapValue(record -> record.get("category"));
+</pre>
 
         <p>
         Stateless transformations, by definition, do not depend on any state for processing, and hence implementation-wise
@@ -619,19 +619,19 @@ <h4><a id="streams_dsl_transform" href="#streams_dsl_transform">Transform a stre
         based on them.
         </p>
 
-        <pre>
-            // written in Java 8+, using lambda expressions
-            KTable&lt;Windowed&lt;String&gt;, Long&gt; counts = source1.groupByKey().aggregate(
-                () -> 0L,  // initial value
-                (aggKey, value, aggregate) -> aggregate + 1L,   // aggregating value
-                TimeWindows.of("counts", 5000L).advanceBy(1000L), // intervals in milliseconds
-                Serdes.Long() // serde for aggregated value
-            );
+<pre>
+// written in Java 8+, using lambda expressions
+KTable&lt;Windowed&lt;String&gt;, Long&gt; counts = source1.groupByKey().aggregate(
+    () -> 0L,  // initial value
+    (aggKey, value, aggregate) -> aggregate + 1L,   // aggregating value
+    TimeWindows.of("counts", 5000L).advanceBy(1000L), // intervals in milliseconds
+    Serdes.Long() // serde for aggregated value
+);
 
-            KStream&lt;String, String&gt; joined = source1.leftJoin(source2,
-                (record1, record2) -> record1.get("user") + "-" + record2.get("region");
-            );
-        </pre>
+KStream&lt;String, String&gt; joined = source1.leftJoin(source2,
+    (record1, record2) -> record1.get("user") + "-" + record2.get("region");
+);
+</pre>
 
         <h4><a id="streams_dsl_sink" href="#streams_dsl_sink">Write streams back to Kafka</a></h4>
 
@@ -640,21 +640,21 @@ <h4><a id="streams_dsl_sink" href="#streams_dsl_sink">Write streams back to Kafk
         <code>KStream.to</code> and <code>KTable.to</code>.
         </p>
 
-        <pre>
-            joined.to("topic4");
-        </pre>
+<pre>
+joined.to("topic4");
+</pre>
 
         If your application needs to continue reading and processing the records after they have been materialized
         to a topic via <code>to</code> above, one option is to construct a new stream that reads from the output topic;
         Kafka Streams provides a convenience method called <code>through</code>:
 
-        <pre>
-            // equivalent to
-            //
-            // joined.to("topic4");
-            // materialized = builder.stream("topic4");
-            KStream&lt;String, String&gt; materialized = joined.through("topic4");
-        </pre>
+<pre>
+// equivalent to
+//
+// joined.to("topic4");
+// materialized = builder.stream("topic4");
+KStream&lt;String, String&gt; materialized = joined.through("topic4");
+</pre>
         <br>
 
         <h3><a id="streams_execute" href="#streams_execute">Application Configuration and Execution</a></h3>
@@ -670,21 +670,21 @@ <h3><a id="streams_execute" href="#streams_execute">Application Configuration an
         set the necessary parameters, and construct a <code>StreamsConfig</code> instance from the <code>Properties</code> instance.
         </p>
 
-        <pre>
-            import java.util.Properties;
-            import org.apache.kafka.streams.StreamsConfig;
+<pre>
+import java.util.Properties;
+import org.apache.kafka.streams.StreamsConfig;
 
-            Properties settings = new Properties();
-            // Set a few key parameters
-            settings.put(StreamsConfig.APPLICATION_ID_CONFIG, "my-first-streams-application");
-            settings.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, "kafka-broker1:9092");
-            settings.put(StreamsConfig.ZOOKEEPER_CONNECT_CONFIG, "zookeeper1:2181");
-            // Any further settings
-            settings.put(... , ...);
+Properties settings = new Properties();
+// Set a few key parameters
+settings.put(StreamsConfig.APPLICATION_ID_CONFIG, "my-first-streams-application");
+settings.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, "kafka-broker1:9092");
+settings.put(StreamsConfig.ZOOKEEPER_CONNECT_CONFIG, "zookeeper1:2181");
+// Any further settings
+settings.put(... , ...);
 
-            // Create an instance of StreamsConfig from the Properties instance
-            StreamsConfig config = new StreamsConfig(settings);
-        </pre>
+// Create an instance of StreamsConfig from the Properties instance
+StreamsConfig config = new StreamsConfig(settings);
+</pre>
 
         <p>
         Apart from Kafka Streams' own configuration parameters you can also specify parameters for the Kafka consumers and producers that are used internally,
@@ -694,24 +694,24 @@ <h3><a id="streams_execute" href="#streams_execute">Application Configuration an
         If you want to set different values for consumer and producer for such a parameter, you can prefix the parameter name with <code>consumer.</code> or <code>producer.</code>:
         </p>
 
-        <pre>
-            Properties settings = new Properties();
-            // Example of a "normal" setting for Kafka Streams
-            settings.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, "kafka-broker-01:9092");
+<pre>
+Properties settings = new Properties();
+// Example of a "normal" setting for Kafka Streams
+settings.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, "kafka-broker-01:9092");
 
-            // Customize the Kafka consumer settings
-            streamsSettings.put(ConsumerConfig.SESSION_TIMEOUT_MS_CONFIG, 60000);
+// Customize the Kafka consumer settings
+streamsSettings.put(ConsumerConfig.SESSION_TIMEOUT_MS_CONFIG, 60000);
 
-            // Customize a common client setting for both consumer and producer
-            settings.put(CommonClientConfigs.RETRY_BACKOFF_MS_CONFIG, 100L);
+// Customize a common client setting for both consumer and producer
+settings.put(CommonClientConfigs.RETRY_BACKOFF_MS_CONFIG, 100L);
 
-            // Customize different values for consumer and producer
-            settings.put("consumer." + ConsumerConfig.RECEIVE_BUFFER_CONFIG, 1024 * 1024);
-            settings.put("producer." + ProducerConfig.RECEIVE_BUFFER_CONFIG, 64 * 1024);
-            // Alternatively, you can use
-            settings.put(StreamsConfig.consumerPrefix(ConsumerConfig.RECEIVE_BUFFER_CONFIG), 1024 * 1024);
-            settings.put(StremasConfig.producerConfig(ProducerConfig.RECEIVE_BUFFER_CONFIG), 64 * 1024);
-        </pre>
+// Customize different values for consumer and producer
+settings.put("consumer." + ConsumerConfig.RECEIVE_BUFFER_CONFIG, 1024 * 1024);
+settings.put("producer." + ProducerConfig.RECEIVE_BUFFER_CONFIG, 64 * 1024);
+// Alternatively, you can use
+settings.put(StreamsConfig.consumerPrefix(ConsumerConfig.RECEIVE_BUFFER_CONFIG), 1024 * 1024);
+settings.put(StremasConfig.producerConfig(ProducerConfig.RECEIVE_BUFFER_CONFIG), 64 * 1024);
+</pre>
 
         <p>
         You can call Kafka Streams from anywhere in your application code.
@@ -724,68 +724,68 @@ <h3><a id="streams_execute" href="#streams_execute">Application Configuration an
         that is used to define a topology; The second argument is an instance of <code>StreamsConfig</code> mentioned above.
         </p>
 
-        <pre>
-            import org.apache.kafka.streams.KafkaStreams;
-            import org.apache.kafka.streams.StreamsConfig;
-            import org.apache.kafka.streams.kstream.KStreamBuilder;
-            import org.apache.kafka.streams.processor.TopologyBuilder;
+<pre>
+import org.apache.kafka.streams.KafkaStreams;
+import org.apache.kafka.streams.StreamsConfig;
+import org.apache.kafka.streams.kstream.KStreamBuilder;
+import org.apache.kafka.streams.processor.TopologyBuilder;
 
-            // Use the builders to define the actual processing topology, e.g. to specify
-            // from which input topics to read, which stream operations (filter, map, etc.)
-            // should be called, and so on.
+// Use the builders to define the actual processing topology, e.g. to specify
+// from which input topics to read, which stream operations (filter, map, etc.)
+// should be called, and so on.
 
-            KStreamBuilder builder = ...;  // when using the Kafka Streams DSL
-            //
-            // OR
-            //
-            TopologyBuilder builder = ...; // when using the Processor API
+KStreamBuilder builder = ...;  // when using the Kafka Streams DSL
+//
+// OR
+//
+TopologyBuilder builder = ...; // when using the Processor API
 
-            // Use the configuration to tell your application where the Kafka cluster is,
-            // which serializers/deserializers to use by default, to specify security settings,
-            // and so on.
-            StreamsConfig config = ...;
+// Use the configuration to tell your application where the Kafka cluster is,
+// which serializers/deserializers to use by default, to specify security settings,
+// and so on.
+StreamsConfig config = ...;
 
-            KafkaStreams streams = new KafkaStreams(builder, config);
-        </pre>
+KafkaStreams streams = new KafkaStreams(builder, config);
+</pre>
 
         <p>
         At this point, internal structures have been initialized, but the processing is not started yet. You have to explicitly start the Kafka Streams thread by calling the <code>start()</code> method:
         </p>
 
-        <pre>
-            // Start the Kafka Streams instance
-            streams.start();
-        </pre>
+<pre>
+// Start the Kafka Streams instance
+streams.start();
+</pre>
 
         <p>
         To catch any unexpected exceptions, you may set an <code>java.lang.Thread.UncaughtExceptionHandler</code> before you start the application. This handler is called whenever a stream thread is terminated by an unexpected exception:
         </p>
 
-        <pre>
-            streams.setUncaughtExceptionHandler(new Thread.UncaughtExceptionHandler() {
-                public uncaughtException(Thread t, throwable e) {
-                    // here you should examine the exception and perform an appropriate action!
-                }
-            );
-        </pre>
+<pre>
+streams.setUncaughtExceptionHandler(new Thread.UncaughtExceptionHandler() {
+    public uncaughtException(Thread t, throwable e) {
+        // here you should examine the exception and perform an appropriate action!
+    }
+);
+</pre>
 
         <p>
         To stop the application instance call the <code>close()</code> method:
         </p>
 
-        <pre>
-            // Stop the Kafka Streams instance
-            streams.close();
-        </pre>
+<pre>
+// Stop the Kafka Streams instance
+streams.close();
+</pre>
 
         Now it's time to execute your application that uses the Kafka Streams library, which can be run just like any other Java application – there is no special magic or requirement on the side of Kafka Streams.
         For example, you can package your Java application as a fat jar file and then start the application via:
 
-        <pre>
-            # Start the application in class `com.example.MyStreamsApp`
-            # from the fat jar named `path-to-app-fatjar.jar`.
-            $ java -cp path-to-app-fatjar.jar com.example.MyStreamsApp
-        </pre>
+<pre>
+# Start the application in class `com.example.MyStreamsApp`
+# from the fat jar named `path-to-app-fatjar.jar`.
+$ java -cp path-to-app-fatjar.jar com.example.MyStreamsApp
+</pre>
 
         <p>
         When the application instance starts running, the defined processor topology will be initialized as one or more stream tasks that can be executed in parallel by the stream threads within the instance.

From 0790b352ab4f427584af8a7a2d18744c8f544ac8 Mon Sep 17 00:00:00 2001
From: Apurva Mehta <apurva@confluent.io>
Date: Sat, 18 Feb 2017 06:38:35 -0800
Subject: [PATCH 109/177] MINOR: Increase consumer init timeout in throttling
 test

The throttling system test sometimes fail because it takes longer than the current 10 second time out for partitions to get assigned to the consumer.

Author: Apurva Mehta <apurva@confluent.io>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2567 from apurvam/increase-timeout-for-partitions-assigned
---
 tests/kafkatest/tests/core/throttling_test.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/kafkatest/tests/core/throttling_test.py b/tests/kafkatest/tests/core/throttling_test.py
index 17a60ea5f7200..a80af39d3151f 100644
--- a/tests/kafkatest/tests/core/throttling_test.py
+++ b/tests/kafkatest/tests/core/throttling_test.py
@@ -53,7 +53,7 @@ def __init__(self, test_context):
         # ensure that the consumer is fully started before the producer starts
         # so that we don't miss any messages. This timeout ensures the sufficient
         # condition.
-        self.consumer_init_timeout_sec =  10
+        self.consumer_init_timeout_sec =  20
         self.num_brokers = 6
         self.num_partitions = 3
         self.kafka = KafkaService(test_context,

From ddde79a351331d12c8811354a7011c0bfce2c9a1 Mon Sep 17 00:00:00 2001
From: Ewen Cheslack-Postava <me@ewencp.org>
Date: Tue, 21 Feb 2017 07:47:09 +0000
Subject: [PATCH 110/177] Bump version to 0.10.2.1-SNAPSHOT

---
 gradle.properties           | 2 +-
 tests/kafkatest/__init__.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/gradle.properties b/gradle.properties
index ac48b00ed196e..5da0832a01b0e 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -16,7 +16,7 @@
 group=org.apache.kafka
 # NOTE: When you change this version number, you should also make sure to update
 # the version numbers in tests/kafkatest/__init__.py and kafka-merge-pr.py.
-version=0.10.2.0
+version=0.10.2.1-SNAPSHOT
 scalaVersion=2.10.6
 task=build
 org.gradle.jvmargs=-XX:MaxPermSize=512m -Xmx1024m -Xss2m
diff --git a/tests/kafkatest/__init__.py b/tests/kafkatest/__init__.py
index 2f42380503aae..d6d6f7bde0c69 100644
--- a/tests/kafkatest/__init__.py
+++ b/tests/kafkatest/__init__.py
@@ -22,4 +22,4 @@
 # Instead, in development branches, the version should have a suffix of the form ".devN"
 #
 # For example, when Kafka is at version 0.9.0.0-SNAPSHOT, this should be something like "0.9.0.0.dev0"
-__version__ = 0.10.2.0
+__version__ = 0.10.2.1.dev0

From 0cdf5c935605db3e0e8e159faea427bb4b1d0eb2 Mon Sep 17 00:00:00 2001
From: Jason Gustafson <jason@confluent.io>
Date: Tue, 21 Feb 2017 13:52:18 +0000
Subject: [PATCH 111/177] MINOR: Fix NPE handling unknown APIs in
 NodeApiVersions.toString

Author: Jason Gustafson <jason@confluent.io>

Reviewers: Colin P. Mccabe <cmccabe@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2561 from hachikuji/fix-npe-api-version-tostring

(cherry picked from commit 3b8b7a4be39cb4a3f7257f8a17f74a887572e627)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../org/apache/kafka/clients/NodeApiVersions.java     | 11 +++++------
 .../org/apache/kafka/clients/NodeApiVersionsTest.java |  8 ++++++++
 2 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java b/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java
index aa9c85a5664ce..906c2264c55ce 100644
--- a/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java
+++ b/clients/src/main/java/org/apache/kafka/clients/NodeApiVersions.java
@@ -31,7 +31,6 @@
  * An internal class which represents the API versions supported by a particular node.
  */
 public class NodeApiVersions {
-    private static final Short API_NOT_ON_NODE = null;
     private static final short NODE_TOO_OLD = (short) -1;
     private static final short NODE_TOO_NEW = (short) -2;
     private final Collection<ApiVersion> nodeApiVersions;
@@ -47,7 +46,7 @@ public class NodeApiVersions {
      * @return A new NodeApiVersions object.
      */
     public static NodeApiVersions create() {
-        return create(Collections.EMPTY_LIST);
+        return create(Collections.<ApiVersion>emptyList());
     }
 
     /**
@@ -98,7 +97,7 @@ public NodeApiVersions(Collection<ApiVersion> nodeApiVersions) {
      */
     public short usableVersion(ApiKeys apiKey) {
         Short usableVersion = usableVersions.get(apiKey);
-        if (usableVersion == API_NOT_ON_NODE)
+        if (usableVersion == null)
             throw new UnsupportedVersionException("The broker does not support " + apiKey);
         else if (usableVersion == NODE_TOO_OLD)
             throw new UnsupportedVersionException("The broker is too old to support " + apiKey +
@@ -160,17 +159,17 @@ private String apiVersionToText(ApiVersion apiVersion) {
         ApiKeys apiKey = null;
         if (ApiKeys.hasId(apiVersion.apiKey)) {
             apiKey = ApiKeys.forId(apiVersion.apiKey);
-        }
-        if (apiKey != null) {
             bld.append(apiKey.name).append("(").append(apiKey.id).append("): ");
         } else {
-            bld.append("UNKNOWN(").append(apiKey.id).append("): ");
+            bld.append("UNKNOWN(").append(apiVersion.apiKey).append("): ");
         }
+
         if (apiVersion.minVersion == apiVersion.maxVersion) {
             bld.append(apiVersion.minVersion);
         } else {
             bld.append(apiVersion.minVersion).append(" to ").append(apiVersion.maxVersion);
         }
+
         if (apiKey != null) {
             Short usableVersion = usableVersions.get(apiKey);
             if (usableVersion == NODE_TOO_OLD)
diff --git a/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java b/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java
index 8773d9cd2a59b..53c47c833bfb7 100644
--- a/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/NodeApiVersionsTest.java
@@ -30,6 +30,7 @@
 import java.util.List;
 
 import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertTrue;
 
 public class NodeApiVersionsTest {
 
@@ -47,6 +48,13 @@ public void testUnsupportedVersionsToString() {
         assertEquals(bld.toString(), versions.toString());
     }
 
+    @Test
+    public void testUnknownApiVersionsToString() {
+        ApiVersion unknownApiVersion = new ApiVersion((short) 337, (short) 0, (short) 1);
+        NodeApiVersions versions = new NodeApiVersions(Collections.singleton(unknownApiVersion));
+        assertTrue(versions.toString().endsWith("UNKNOWN(337): 0 to 1)"));
+    }
+
     @Test
     public void testVersionsToString() {
         List<ApiVersion> versionList = new ArrayList<>();

From c231f528026df6d5346963461345e5b983614c74 Mon Sep 17 00:00:00 2001
From: Ismael Juma <ismael@juma.me.uk>
Date: Wed, 22 Feb 2017 09:30:13 +0000
Subject: [PATCH 112/177] HOTFIX: Fix version in __init__.py

Quotes were missing.

Author: Ismael Juma <ismael@juma.me.uk>

Reviewers: Ewen Cheslack-Postava <me@ewencp.org>

Closes #2581 from ijuma/fix-version-in-init-py
---
 tests/kafkatest/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/kafkatest/__init__.py b/tests/kafkatest/__init__.py
index d6d6f7bde0c69..06e446ef3569f 100644
--- a/tests/kafkatest/__init__.py
+++ b/tests/kafkatest/__init__.py
@@ -22,4 +22,4 @@
 # Instead, in development branches, the version should have a suffix of the form ".devN"
 #
 # For example, when Kafka is at version 0.9.0.0-SNAPSHOT, this should be something like "0.9.0.0.dev0"
-__version__ = 0.10.2.1.dev0
+__version__ = '0.10.2.1.dev0'

From ba4eafa7874988374abcd9f48fbab96abb2032a4 Mon Sep 17 00:00:00 2001
From: Rajini Sivaram <rajinisivaram@googlemail.com>
Date: Wed, 22 Feb 2017 12:08:09 -0800
Subject: [PATCH 113/177] KAFKA-4786; Wait for heartbeat thread to terminate in
 consumer close

Author: Rajini Sivaram <rajinisivaram@googlemail.com>

Reviewers: Apurva Mehta <apurva@confluent.io>, Ismael Juma <ismael@juma.me.uk>, Jason Gustafson <jason@confluent.io>

Closes #2586 from rajinisivaram/KAFKA-4786

(cherry picked from commit 5916ef0227d099e5fa05341db3f918f5ef035816)
Signed-off-by: Jason Gustafson <jason@confluent.io>
---
 .../internals/AbstractCoordinator.java        | 46 +++++++++++++------
 1 file changed, 33 insertions(+), 13 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/AbstractCoordinator.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/AbstractCoordinator.java
index 6eea04573d759..b72769ec0cc12 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/AbstractCoordinator.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/AbstractCoordinator.java
@@ -315,6 +315,19 @@ private synchronized void disableHeartbeatThread() {
             heartbeatThread.disable();
     }
 
+    private void closeHeartbeatThread() {
+        if (heartbeatThread != null) {
+            heartbeatThread.close();
+
+            try {
+                heartbeatThread.join();
+            } catch (InterruptedException e) {
+                log.warn("Interrupted while waiting for consumer heartbeat thread to close");
+                throw new InterruptException(e);
+            }
+        }
+    }
+
     // visible for testing. Joins the group without starting the heartbeat thread.
     void joinGroupIfNeeded() {
         while (needRejoin() || rejoinIncomplete()) {
@@ -652,19 +665,26 @@ public synchronized void close() {
         close(0);
     }
 
-    protected synchronized void close(long timeoutMs) {
-        if (heartbeatThread != null)
-            heartbeatThread.close();
-        maybeLeaveGroup();
-
-        // At this point, there may be pending commits (async commits or sync commits that were
-        // interrupted using wakeup) and the leave group request which have been queued, but not
-        // yet sent to the broker. Wait up to close timeout for these pending requests to be processed.
-        // If coordinator is not known, requests are aborted.
-        Node coordinator = coordinator();
-        if (coordinator != null && !client.awaitPendingRequests(coordinator, timeoutMs))
-            log.warn("Close timed out with {} pending requests to coordinator, terminating client connections for group {}.",
-                    client.pendingRequestCount(coordinator), groupId);
+    protected void close(long timeoutMs) {
+        try {
+            closeHeartbeatThread();
+        } finally {
+
+            // Synchronize after closing the heartbeat thread since heartbeat thread
+            // needs this lock to complete and terminate after close flag is set.
+            synchronized (this) {
+                maybeLeaveGroup();
+
+                // At this point, there may be pending commits (async commits or sync commits that were
+                // interrupted using wakeup) and the leave group request which have been queued, but not
+                // yet sent to the broker. Wait up to close timeout for these pending requests to be processed.
+                // If coordinator is not known, requests are aborted.
+                Node coordinator = coordinator();
+                if (coordinator != null && !client.awaitPendingRequests(coordinator, timeoutMs))
+                    log.warn("Close timed out with {} pending requests to coordinator, terminating client connections for group {}.",
+                            client.pendingRequestCount(coordinator), groupId);
+            }
+        }
     }
 
     /**

From 9c6fa257d8e3558a9d849619c8f09079e7dc1c98 Mon Sep 17 00:00:00 2001
From: Ismael Juma <ismael@juma.me.uk>
Date: Thu, 23 Feb 2017 16:28:38 +0000
Subject: [PATCH 114/177] KAFKA-4788: Revert "KAFKA-4092: retention.bytes
 should not be allowed to be less than segment.bytes"

The intent is good, but it needs to take into account broker configs as well.
See KAFKA-4788 for more details.

This reverts commit 4ca5abe8ee7578f602fb7653cb8a09640607ea85.

Author: Ismael Juma <ismael@juma.me.uk>

Reviewers: Jun Rao <junrao@gmail.com>

Closes #2588 from ijuma/kafka-4788

(cherry picked from commit 5a2abc51821fab4d3834b615e577d97e0f0e6494)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 core/src/main/scala/kafka/log/LogConfig.scala         | 11 -----------
 .../src/test/scala/unit/kafka/log/LogConfigTest.scala | 10 ----------
 2 files changed, 21 deletions(-)

diff --git a/core/src/main/scala/kafka/log/LogConfig.scala b/core/src/main/scala/kafka/log/LogConfig.scala
index eaa60160c92e6..55669c061ec2c 100755
--- a/core/src/main/scala/kafka/log/LogConfig.scala
+++ b/core/src/main/scala/kafka/log/LogConfig.scala
@@ -323,23 +323,12 @@ object LogConfig {
         throw new InvalidConfigurationException(s"Unknown Log configuration $name.")
   }
 
-  /**
-    * Check that the property values are valid relative to each other
-    */
-  def validateValues(props: Properties) {
-    val segmentBytes = if (props.getProperty(SegmentBytesProp) == null) Defaults.SegmentSize else props.getProperty(SegmentBytesProp).toLong
-    val retentionBytes = if (props.getProperty(RetentionBytesProp) == null) Defaults.RetentionSize else props.getProperty(RetentionBytesProp).toLong
-    if (segmentBytes > retentionBytes && retentionBytes != -1)
-      throw new InvalidConfigurationException(s"segment.bytes ${segmentBytes} is not less than or equal to retention.bytes ${retentionBytes}")
-  }
-
   /**
    * Check that the given properties contain only valid log config names and that all values can be parsed and are valid
    */
   def validate(props: Properties) {
     validateNames(props)
     configDef.parse(props)
-    validateValues(props)
   }
 
 }
diff --git a/core/src/test/scala/unit/kafka/log/LogConfigTest.scala b/core/src/test/scala/unit/kafka/log/LogConfigTest.scala
index 862083daff50a..66702d683abcb 100644
--- a/core/src/test/scala/unit/kafka/log/LogConfigTest.scala
+++ b/core/src/test/scala/unit/kafka/log/LogConfigTest.scala
@@ -111,16 +111,6 @@ class LogConfigTest {
       case _: ConfigException => false
     }
   }
-  def testValueValidator() {
-    val p = new Properties()
-    p.setProperty(LogConfig.SegmentBytesProp, "100")
-    p.setProperty(LogConfig.RetentionBytesProp, "100")
-    LogConfig.validate(p)
-    p.setProperty(LogConfig.RetentionBytesProp, "90")
-    val except = intercept[IllegalArgumentException] {
-      LogConfig.validate(p)
-    }
-  }
 
   private def assertPropertyInvalid(name: String, values: AnyRef*) {
     values.foreach((value) => {

From e0447192854435b5b5aa84027b5f95a26fb9a2b5 Mon Sep 17 00:00:00 2001
From: Guozhang Wang <wangguoz@gmail.com>
Date: Thu, 23 Feb 2017 13:21:49 -0800
Subject: [PATCH 115/177] HOTFIX: add js template to upgrade.html

Author: Guozhang Wang <wangguoz@gmail.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2591 from guozhangwang/KHotfix-explicit-version
---
 docs/upgrade.html | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/docs/upgrade.html b/docs/upgrade.html
index 597605461ad5e..58754dd97aa69 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -15,6 +15,10 @@
  limitations under the License.
 -->
 
+<script><!--#include virtual="js/templateData.js" --></script>
+
+<script id="upgrade-template" type="text/x-handlebars-template">
+    
 <h4><a id="upgrade_10_2_0" href="#upgrade_10_2_0">Upgrading from 0.8.x, 0.9.x, 0.10.0.x or 0.10.1.x to 0.10.2.0</a></h4>
 <p>0.10.2.0 has wire protocol changes. By following the recommended rolling upgrade plan below, you guarantee no downtime during the upgrade.
 However, please review the <a href="#upgrade_1020_notable">notable changes in 0.10.2.0</a> before upgrading.
@@ -269,7 +273,7 @@ <h5><a id="upgrade_10_breaking" href="#upgrade_10_breaking">Potential breaking c
 <h5><a id="upgrade_10_notable" href="#upgrade_10_notable">Notable changes in 0.10.0.0</a></h5>
 
 <ul>
-    <li> Starting from Kafka 0.10.0.0, a new client library named <b>Kafka Streams</b> is available for stream processing on data stored in Kafka topics. This new client library only works with 0.10.x and upward versioned brokers due to message format changes mentioned above. For more information please read <a href="/{{version}}/documentation/stream">Streams documentation</a>.</li>
+    <li> Starting from Kafka 0.10.0.0, a new client library named <b>Kafka Streams</b> is available for stream processing on data stored in Kafka topics. This new client library only works with 0.10.x and upward versioned brokers due to message format changes mentioned above. For more information please read <a href="/{{version}}/documentation/streams">Streams documentation</a>.</li>
     <li> The default value of the configuration parameter <code>receive.buffer.bytes</code> is now 64K for the new consumer.</li>
     <li> The new consumer now exposes the configuration parameter <code>exclude.internal.topics</code> to restrict internal topics (such as the consumer offsets topic) from accidentally being included in regular expression subscriptions. By default, it is enabled.</li>
     <li> The old Scala producer has been deprecated. Users should migrate their code to the Java producer included in the kafka-clients JAR as soon as possible. </li>
@@ -339,3 +343,7 @@ <h4><a id="upgrade_81" href="#upgrade_81">Upgrading from 0.8.0 to 0.8.1</a></h4>
 <h4><a id="upgrade_7" href="#upgrade_7">Upgrading from 0.7</a></h4>
 
 Release 0.7 is incompatible with newer releases. Major changes were made to the API, ZooKeeper data structures, and protocol, and configuration in order to add replication (Which was missing in 0.7). The upgrade from 0.7 to later versions requires a <a href="https://cwiki.apache.org/confluence/display/KAFKA/Migrating+from+0.7+to+0.8">special tool</a> for migration. This migration can be done without downtime.
+
+</script>
+
+<div class="p-upgrade"></div>
\ No newline at end of file

From 11b637ec7d2b8dbd2ac57ca2f2b360b2a0707ab9 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Fri, 24 Feb 2017 11:44:31 +0000
Subject: [PATCH 116/177] KAFKA-4198; Fix race condition in
 KafkaServer.shutdown()

It contained this step:

      val canShutdown = isShuttingDown.compareAndSet(false, true)
      if (canShutdown && shutdownLatch.getCount > 0) {

without any fallback for the case of `shutdownLatch.getCount == 0`. So in the case
of `shutdownLatch.getCount == 0` (when a previous call to the shutdown method
was right about to finish) you would set `isShuttingDown` to true again without any
possibility of ever getting the server started (since `startup` will check
`isShuttingDown` before setting up a new latch with count 1).

Long story short: concurrent calls to shutdown can get the server locked in a broken state.

This fixes the reported error:

java.lang.IllegalStateException: Kafka server is still shutting down, cannot re-start!
	at kafka.server.KafkaServer.startup(KafkaServer.scala:184)
	at kafka.integration.KafkaServerTestHarness$$anonfun$restartDeadBrokers$2.apply$mcVI$sp(KafkaServerTestHarness.scala:117)
	at kafka.integration.KafkaServerTestHarness$$anonfun$restartDeadBrokers$2.apply(KafkaServerTestHarness.scala:116)
	at kafka.integration.KafkaServerTestHarness$$anonfun$restartDeadBrokers$2.apply(KafkaServerTestHarness.scala:116)
	at scala.collection.TraversableLike$WithFilter$$anonfun$foreach$1.apply(TraversableLike.scala:733)
	at scala.collection.immutable.Range.foreach(Range.scala:160)
	at scala.collection.TraversableLike$WithFilter.foreach(TraversableLike.scala:732)
	at kafka.integration.KafkaServerTestHarness$class.restartDeadBrokers(KafkaServerTestHarness.scala:116)
	at kafka.api.ConsumerBounceTest.restartDeadBrokers(ConsumerBounceTest.scala:34)
	at kafka.api.ConsumerBounceTest$BounceBrokerScheduler.doWork(ConsumerBounceTest.scala:158)

Author: Armin Braun <me@obrown.io>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2568 from original-brownbear/KAFKA-4198

(cherry picked from commit 1ed4b48d5a43af743229fafc22f78846c9c3134d)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../org/apache/kafka/clients/consumer/KafkaConsumer.java  | 2 +-
 core/src/main/scala/kafka/server/KafkaServer.scala        | 8 +++++---
 .../scala/integration/kafka/api/ConsumerBounceTest.scala  | 4 ++--
 .../unit/kafka/integration/KafkaServerTestHarness.scala   | 6 +++---
 4 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
index d125e7ee5b3ca..8149ad6d1f02b 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
@@ -1495,7 +1495,7 @@ public Map<TopicPartition, Long> endOffsets(Collection<TopicPartition> partition
      * If auto-commit is enabled, this will commit the current offsets if possible within the default
      * timeout. See {@link #close(long, TimeUnit)} for details. Note that {@link #wakeup()}
      * cannot be used to interrupt close.
-     * 
+     *
      * @throws org.apache.kafka.common.errors.InterruptException if the calling thread is interrupted
      * before or while this function is called
      */
diff --git a/core/src/main/scala/kafka/server/KafkaServer.scala b/core/src/main/scala/kafka/server/KafkaServer.scala
index 68a62a404f5c1..c773382683a83 100755
--- a/core/src/main/scala/kafka/server/KafkaServer.scala
+++ b/core/src/main/scala/kafka/server/KafkaServer.scala
@@ -574,8 +574,10 @@ class KafkaServer(val config: KafkaConfig, time: Time = Time.SYSTEM, threadNameP
       if(isStartingUp.get)
         throw new IllegalStateException("Kafka server is still starting up, cannot shut down!")
 
-      val canShutdown = isShuttingDown.compareAndSet(false, true)
-      if (canShutdown && shutdownLatch.getCount > 0) {
+      // To ensure correct behavior under concurrent calls, we need to check `shutdownLatch` first since it gets updated
+      // last in the `if` block. If the order is reversed, we could shutdown twice or leave `isShuttingDown` set to
+      // `true` at the end of this method.
+      if (shutdownLatch.getCount > 0 && isShuttingDown.compareAndSet(false, true)) {
         CoreUtils.swallow(controlledShutdown())
         brokerState.newState(BrokerShuttingDown)
         if(socketServer != null)
@@ -605,7 +607,7 @@ class KafkaServer(val config: KafkaConfig, time: Time = Time.SYSTEM, threadNameP
 
         startupComplete.set(false)
         isShuttingDown.set(false)
-        AppInfoParser.unregisterAppInfo(jmxPrefix, config.brokerId.toString)
+        CoreUtils.swallow(AppInfoParser.unregisterAppInfo(jmxPrefix, config.brokerId.toString))
         shutdownLatch.countDown()
         info("shut down completed")
       }
diff --git a/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala b/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala
index fba3239b39407..2f37b5ba63ab4 100644
--- a/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala
+++ b/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala
@@ -13,8 +13,8 @@
 
 package kafka.api
 
+import java.util.concurrent._
 import java.util.{Collection, Collections}
-import java.util.concurrent.{Callable, Executors, ExecutorService, Future, Semaphore, TimeUnit}
 
 import kafka.admin.AdminClient
 import kafka.server.KafkaConfig
@@ -23,7 +23,7 @@ import org.apache.kafka.clients.consumer._
 import org.apache.kafka.clients.producer.{ProducerConfig, ProducerRecord}
 import org.apache.kafka.common.TopicPartition
 import org.junit.Assert._
-import org.junit.{Before, After, Test}
+import org.junit.{After, Before, Test}
 
 import scala.collection.JavaConverters._
 
diff --git a/core/src/test/scala/unit/kafka/integration/KafkaServerTestHarness.scala b/core/src/test/scala/unit/kafka/integration/KafkaServerTestHarness.scala
index bfaff0bb343e3..081bdff5b95ce 100755
--- a/core/src/test/scala/unit/kafka/integration/KafkaServerTestHarness.scala
+++ b/core/src/test/scala/unit/kafka/integration/KafkaServerTestHarness.scala
@@ -5,7 +5,7 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *    http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
@@ -102,7 +102,7 @@ trait KafkaServerTestHarness extends ZooKeeperTestHarness {
     }
     super.tearDown
   }
-  
+
   /**
    * Pick a broker at random and kill it if it isn't already dead
    * Return the id of the broker killed
@@ -120,7 +120,7 @@ trait KafkaServerTestHarness extends ZooKeeperTestHarness {
       alive(index) = false
     }
   }
-  
+
   /**
    * Restart any dead brokers
    */

From ac05c343a190d2e7649e42485c62a80e5dede382 Mon Sep 17 00:00:00 2001
From: Rajini Sivaram <rajinisivaram@googlemail.com>
Date: Fri, 24 Feb 2017 17:24:07 +0000
Subject: [PATCH 117/177] KAFKA-4779; Fix security upgrade system test to be
 non-disruptive

The phase_two security upgrade test verifies upgrading inter-broker and client protocols to the same value as well as different values. The second case currently changes inter-broker protocol without first enabling the protocol, disrupting produce/consume until the whole cluster is updated. This commit changes the test to be a non-disruptive upgrade test that enables protocols first (simulating phase one of upgrade).

Author: Rajini Sivaram <rajinisivaram@googlemail.com>

Reviewers: Apurva Mehta <apurva.1618@gmail.com>, Ismael Juma <ismael@juma.me.uk>

Closes #2589 from rajinisivaram/KAFKA-4779

(cherry picked from commit 2a7b18a2ac1213b189df8585671b713373dae383)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 tests/kafkatest/services/kafka/kafka.py                   | 7 ++++++-
 tests/kafkatest/services/security/security_config.py      | 4 ++++
 .../kafkatest/tests/core/security_rolling_upgrade_test.py | 8 ++++----
 3 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/tests/kafkatest/services/kafka/kafka.py b/tests/kafkatest/services/kafka/kafka.py
index 2e65e099ac437..7e4a5899e6c48 100644
--- a/tests/kafkatest/services/kafka/kafka.py
+++ b/tests/kafkatest/services/kafka/kafka.py
@@ -126,9 +126,14 @@ def set_version(self, version):
 
     @property
     def security_config(self):
-        return SecurityConfig(self.context, self.security_protocol, self.interbroker_security_protocol,
+        config = SecurityConfig(self.context, self.security_protocol, self.interbroker_security_protocol,
                               zk_sasl=self.zk.zk_sasl,
                               client_sasl_mechanism=self.client_sasl_mechanism, interbroker_sasl_mechanism=self.interbroker_sasl_mechanism)
+        for protocol in self.port_mappings:
+            port = self.port_mappings[protocol]
+            if port.open:
+                config.enable_security_protocol(port.name)
+        return config
 
     def open_port(self, protocol):
         self.port_mappings[protocol] = self.port_mappings[protocol]._replace(open=True)
diff --git a/tests/kafkatest/services/security/security_config.py b/tests/kafkatest/services/security/security_config.py
index 846d9b10f3a6a..beb37950ce139 100644
--- a/tests/kafkatest/services/security/security_config.py
+++ b/tests/kafkatest/services/security/security_config.py
@@ -166,6 +166,10 @@ def client_config(self, template_props="", node=None):
         static_jaas_conf = node is None or (self.has_sasl and self.has_ssl)
         return SecurityConfig(self.context, self.security_protocol, client_sasl_mechanism=self.client_sasl_mechanism, template_props=template_props, static_jaas_conf=static_jaas_conf)
 
+    def enable_security_protocol(self, security_protocol):
+        self.has_sasl = self.has_sasl or self.is_sasl(security_protocol)
+        self.has_ssl = self.has_ssl or self.is_ssl(security_protocol)
+
     def setup_ssl(self, node):
         node.account.ssh("mkdir -p %s" % SecurityConfig.CONFIG_DIR, allow_fail=False)
         node.account.copy_to(SecurityConfig.ssl_stores.truststore_path, SecurityConfig.TRUSTSTORE_PATH)
diff --git a/tests/kafkatest/tests/core/security_rolling_upgrade_test.py b/tests/kafkatest/tests/core/security_rolling_upgrade_test.py
index a21e845649d71..a962a9d140222 100644
--- a/tests/kafkatest/tests/core/security_rolling_upgrade_test.py
+++ b/tests/kafkatest/tests/core/security_rolling_upgrade_test.py
@@ -69,8 +69,6 @@ def roll_in_secured_settings(self, client_protocol, broker_protocol):
 
         # Roll cluster to include inter broker security protocol.
         self.kafka.interbroker_security_protocol = broker_protocol
-        self.kafka.open_port(client_protocol)
-        self.kafka.open_port(broker_protocol)
         self.bounce()
 
         # Roll cluster to disable PLAINTEXT port
@@ -131,14 +129,16 @@ def test_rolling_upgrade_phase_one(self, client_protocol):
     def test_rolling_upgrade_phase_two(self, client_protocol, broker_protocol):
         """
         Start with a PLAINTEXT cluster with a second Secured port open (i.e. result of phase one).
-        Start an Producer and Consumer via the SECURED port
-        Incrementally upgrade to add inter-broker be the secure protocol
+        A third secure port is also open if inter-broker and client protocols are different.
+        Start a Producer and Consumer via the SECURED client port
+        Incrementally upgrade to add inter-broker be the secure broker protocol
         Incrementally upgrade again to add ACLs as well as disabling the PLAINTEXT port
         Ensure the producer and consumer ran throughout
         """
         #Given we have a broker that has both secure and PLAINTEXT ports open
         self.kafka.security_protocol = client_protocol
         self.kafka.interbroker_security_protocol = "PLAINTEXT"
+        self.kafka.open_port(broker_protocol)
         self.kafka.start()
 
         #Create Secured Producer and Consumer

From a9f4b671f5c429e57eff5a543c8ce8a58edea118 Mon Sep 17 00:00:00 2001
From: Jason Gustafson <jason@confluent.io>
Date: Fri, 24 Feb 2017 15:49:13 -0800
Subject: [PATCH 118/177] MINOR: Ensure consumer calls poll() if requests are
 outstanding

Author: Jason Gustafson <jason@confluent.io>

Reviewers: Onur Karaman <okaraman@linkedin.com>, Ismael Juma <ismael@juma.me.uk>

Closes #2596 from hachikuji/ensure-poll-with-inflight-requests

(cherry picked from commit 3749832637b58b291a45076658feb8cd6e830247)
Signed-off-by: Jason Gustafson <jason@confluent.io>
---
 .../java/org/apache/kafka/clients/consumer/KafkaConsumer.java  | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
index 8149ad6d1f02b..2791bc54d4ba2 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
@@ -1000,9 +1000,8 @@ public ConsumerRecords<K, V> poll(long timeout) {
                     //
                     // NOTE: since the consumed position has already been updated, we must not allow
                     // wakeups or any other errors to be triggered prior to returning the fetched records.
-                    if (fetcher.sendFetches() > 0) {
+                    if (fetcher.sendFetches() > 0 || client.pendingRequestCount() > 0)
                         client.pollNoWakeup();
-                    }
 
                     if (this.interceptors == null)
                         return new ConsumerRecords<>(records);

From 8488b81a52e32c4efcec16c05efa6ab9ed0d3c87 Mon Sep 17 00:00:00 2001
From: Vahid Hashemian <vahidhashemian@us.ibm.com>
Date: Sat, 25 Feb 2017 18:44:32 -0800
Subject: [PATCH 119/177] MINOR: Use API hyperlinks in 'Kafka Protocol Guide'
 to facilitate navigation

Finding the protocol associated with an API key can be a challenge in the lengthy [web page](http://kafka.apache.org/protocol.html#protocol_api_keys).
Adding hyperlinks would definitely help with that.

Co-authored with imandhan.

Author: Vahid Hashemian <vahidhashemian@us.ibm.com>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2467 from vahidhashemian/minor/hyperlinks_in_kafka_protocol_guide

(cherry picked from commit 5b682baad546e41fe7aa27be0865ea6adaca2d2a)
Signed-off-by: Ewen Cheslack-Postava <me@ewencp.org>
---
 .../main/java/org/apache/kafka/common/protocol/ApiKeys.java    | 2 +-
 .../main/java/org/apache/kafka/common/protocol/Protocol.java   | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/common/protocol/ApiKeys.java b/clients/src/main/java/org/apache/kafka/common/protocol/ApiKeys.java
index 239780ca72077..614f12f577dda 100644
--- a/clients/src/main/java/org/apache/kafka/common/protocol/ApiKeys.java
+++ b/clients/src/main/java/org/apache/kafka/common/protocol/ApiKeys.java
@@ -89,7 +89,7 @@ private static String toHtml() {
         for (ApiKeys key : ApiKeys.values()) {
             b.append("<tr>\n");
             b.append("<td>");
-            b.append(key.name);
+            b.append("<a href=\"#The_Messages_" + key.name + "\">" + key.name + "</a>");
             b.append("</td>");
             b.append("<td>");
             b.append(key.id);
diff --git a/clients/src/main/java/org/apache/kafka/common/protocol/Protocol.java b/clients/src/main/java/org/apache/kafka/common/protocol/Protocol.java
index b04587fcb86df..032e00e0a158f 100644
--- a/clients/src/main/java/org/apache/kafka/common/protocol/Protocol.java
+++ b/clients/src/main/java/org/apache/kafka/common/protocol/Protocol.java
@@ -1176,10 +1176,11 @@ public static String toHtml() {
         for (ApiKeys key : ApiKeys.values()) {
             // Key
             b.append("<h5>");
+            b.append("<a name=\"The_Messages_" + key.name + "\">");
             b.append(key.name);
             b.append(" API (Key: ");
             b.append(key.id);
-            b.append("):</h5>\n\n");
+            b.append("):</a></h5>\n\n");
             // Requests
             b.append("<b>Requests:</b><br>\n");
             Schema[] requests = REQUESTS[key.id];

From 35684acad2df18c8f39c2f72a596714263b64f64 Mon Sep 17 00:00:00 2001
From: Marco Ebert <marco_ebert@icloud.com>
Date: Mon, 27 Feb 2017 11:48:50 +0000
Subject: [PATCH 120/177] KAFKA-4806; Prevent double logging of ConsumerConfig

The consumer properties get logged twice since two instances
of ConsumerConfig are created during creation of KafkaConsumer.

I added a constructor of ConsumerConfig accepting the boolean
parameter doLog which is already passable in AbstractConfig
and set it to false during the second ConsumerConfig creating
in the KafkaConsumer constructor.

Author: Marco Ebert <marco_ebert@icloud.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2600 from Gacko/trunk

(cherry picked from commit 9260e8563c19cc1c5ac2d47ad05955774138036d)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../org/apache/kafka/clients/consumer/ConsumerConfig.java     | 4 ++++
 .../java/org/apache/kafka/clients/consumer/KafkaConsumer.java | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/ConsumerConfig.java b/clients/src/main/java/org/apache/kafka/clients/consumer/ConsumerConfig.java
index ed809a9f401ad..1b335173b8884 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/ConsumerConfig.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/ConsumerConfig.java
@@ -426,6 +426,10 @@ public static Properties addDeserializerToConfig(Properties properties,
         super(CONFIG, props);
     }
 
+    ConsumerConfig(Map<?, ?> props, boolean doLog) {
+        super(CONFIG, props, doLog);
+    }
+
     public static Set<String> configNames() {
         return CONFIG.names();
     }
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
index 2791bc54d4ba2..eac95791a0aff 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
@@ -630,7 +630,7 @@ private KafkaConsumer(ConsumerConfig config,
             // load interceptors and make sure they get clientId
             Map<String, Object> userProvidedConfigs = config.originals();
             userProvidedConfigs.put(ConsumerConfig.CLIENT_ID_CONFIG, clientId);
-            List<ConsumerInterceptor<K, V>> interceptorList = (List) (new ConsumerConfig(userProvidedConfigs)).getConfiguredInstances(ConsumerConfig.INTERCEPTOR_CLASSES_CONFIG,
+            List<ConsumerInterceptor<K, V>> interceptorList = (List) (new ConsumerConfig(userProvidedConfigs, false)).getConfiguredInstances(ConsumerConfig.INTERCEPTOR_CLASSES_CONFIG,
                     ConsumerInterceptor.class);
             this.interceptors = interceptorList.isEmpty() ? null : new ConsumerInterceptors<>(interceptorList);
             if (keyDeserializer == null) {

From 53a39bb2cc9ee2e0f13e5658495152d5117889a6 Mon Sep 17 00:00:00 2001
From: "Colin P. Mccabe" <cmccabe@confluent.io>
Date: Tue, 28 Feb 2017 12:21:46 -0800
Subject: [PATCH 121/177] KAFKA-4809: docker/run_tests.sh should set up
 /opt/kafka-dev to be the source directory
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

…0.x and not 0.8

Author: Colin P. Mccabe <cmccabe@confluent.io>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2602 from cmccabe/KAFKA-4809
---
 tests/docker/Dockerfile                       | 20 +++++++------------
 tests/docker/run_tests.sh                     | 14 ++-----------
 .../sanity_checks/test_verifiable_producer.py |  4 +++-
 3 files changed, 12 insertions(+), 26 deletions(-)

diff --git a/tests/docker/Dockerfile b/tests/docker/Dockerfile
index 82e2e55f4320a..3a3df3242259a 100644
--- a/tests/docker/Dockerfile
+++ b/tests/docker/Dockerfile
@@ -16,22 +16,16 @@
 FROM openjdk:8
 
 MAINTAINER Apache Kafka dev@kafka.apache.org
-RUN apt update
-RUN apt install -y unzip wget curl jq coreutils openssh-server net-tools vim openjdk-8-jdk python-pip python-dev libffi-dev libssl-dev
-RUN pip install -U pip
-RUN pip install --upgrade cffi
-RUN pip install ducktape==0.6.0
-
-VOLUME ["/kafka_src"]
-
+VOLUME ["/opt/kafka-dev"]
 ENV MIRROR="http://apache.cs.utah.edu/"
-RUN wget -q "${MIRROR}kafka/0.8.2.2/kafka_2.10-0.8.2.2.tgz" -O "/tmp/kafka_2.10-0.8.2.2.tgz" && tar xfz /tmp/kafka_2.10-0.8.2.2.tgz -C /opt && mv "/opt/kafka_2.10-0.8.2.2" "/opt/kafka-0.8.2.2"
-RUN wget -q "${MIRROR}kafka/0.9.0.1/kafka_2.10-0.9.0.1.tgz" -O "/tmp/kafka_2.10-0.9.0.1.tgz" && tar xfz /tmp/kafka_2.10-0.9.0.1.tgz -C /opt && mv "/opt/kafka_2.10-0.9.0.1" "/opt/kafka-0.9.0.1"
-RUN wget -q "${MIRROR}kafka/0.10.0.1/kafka_2.10-0.10.0.1.tgz" -O "/tmp/kafka_2.10-0.10.0.1.tgz" && tar xfz /tmp/kafka_2.10-0.10.0.1.tgz -C /opt && mv "/opt/kafka_2.10-0.10.0.1" "/opt/kafka-0.10.0.1"
-RUN wget -q "${MIRROR}kafka/0.10.1.1/kafka_2.10-0.10.1.1.tgz" -O "/tmp/kafka_2.10-0.10.1.1.tgz" && tar xfz /tmp/kafka_2.10-0.10.1.1.tgz -C /opt && mv "/opt/kafka_2.10-0.10.1.1" "/opt/kafka-0.10.1.1"
 
-RUN rm /tmp/kafka_*.tgz
 ADD ssh /root/.ssh
 RUN chmod 600 /root/.ssh/id_rsa
+RUN apt update && apt install -y unzip wget curl jq coreutils openssh-server net-tools vim openjdk-8-jdk python-pip python-dev libffi-dev libssl-dev
+RUN pip install -U pip && pip install --upgrade cffi ducktape==0.6.0
+RUN mkdir -p "/opt/kafka_2.10-0.8.2.2" && curl "${MIRROR}kafka/0.8.2.2/kafka_2.10-0.8.2.2.tgz" | tar xz --strip-components=1 -C "/opt/kafka_2.10-0.8.2.2"
+RUN mkdir -p "/opt/kafka_2.10-0.9.0.1" && curl "${MIRROR}kafka/0.9.0.1/kafka_2.10-0.9.0.1.tgz" | tar xz --strip-components=1 -C "/opt/kafka_2.10-0.9.0.1"
+RUN mkdir -p "/opt/kafka_2.10-0.10.0.1" && curl "${MIRROR}kafka/0.10.0.1/kafka_2.10-0.10.0.1.tgz" | tar xz --strip-components=1 -C "/opt/kafka_2.10-0.10.0.1"
+RUN mkdir -p "/opt/kafka_2.10-0.10.1.1" && curl "${MIRROR}kafka/0.10.1.1/kafka_2.10-0.10.1.1.tgz" | tar xz --strip-components=1 -C "/opt/kafka_2.10-0.10.1.1"
 
 CMD service ssh start && tail -f /dev/null
diff --git a/tests/docker/run_tests.sh b/tests/docker/run_tests.sh
index 0e5378a8f26b8..cc381cc33c2e4 100755
--- a/tests/docker/run_tests.sh
+++ b/tests/docker/run_tests.sh
@@ -46,7 +46,7 @@ fi
 echo "Using kafka image: ${KAFKA_IMAGE}"
 docker inspect ${KAFKA_IMAGE}
 for i in $(seq -w 1 ${KAFKA_NUM_CONTAINERS}); do
-  docker run -d -t --name knode${i} --network knw -v ${KAFKA_SRC}:/kafka_src ${KAFKA_IMAGE}
+  docker run -d -t --name knode${i} --network knw -v ${KAFKA_SRC}:/opt/kafka-dev ${KAFKA_IMAGE}
 done
 
 docker info
@@ -55,18 +55,8 @@ docker network inspect knw
 
 for i in $(seq -w 1 ${KAFKA_NUM_CONTAINERS}); do
   echo knode${i}
-  docker exec knode${i} bash -c "(tar xfz /kafka_src/core/build/distributions/kafka_*SNAPSHOT.tgz -C /opt || echo missing kafka tgz did you build kafka tarball) && mv /opt/kafka*SNAPSHOT /opt/kafka-dev && ls -l /opt"
-  docker exec knode01 bash -c "ssh knode$i hostname"
-done
-
-# hack to copy test dependencies
-# this is required for running MiniKDC
-(cd ${KAFKA_SRC} && ./gradlew copyDependantTestLibs)
-for i in $(seq -w 1 ${KAFKA_NUM_CONTAINERS}); do
-  echo knode${i}
-  docker exec knode${i} bash -c "cp /kafka_src/core/build/dependant-testlibs/* /opt/kafka-dev/libs/"
   docker exec knode01 bash -c "ssh knode$i hostname"
 done
 
 bash tests/cluster_file_generator.sh > tests/cluster_file.json
-docker exec knode01 bash -c "cd /kafka_src; ducktape ${_DUCKTAPE_OPTIONS} --cluster-file tests/cluster_file.json ${TC_PATHS:-tests/kafkatest/tests}"
+docker exec knode01 bash -c "cd /opt/kafka-dev; ducktape ${_DUCKTAPE_OPTIONS} --cluster-file tests/cluster_file.json ${TC_PATHS:-tests/kafkatest/tests}"
diff --git a/tests/kafkatest/sanity_checks/test_verifiable_producer.py b/tests/kafkatest/sanity_checks/test_verifiable_producer.py
index b4ca4e94f4b56..be1057471948d 100644
--- a/tests/kafkatest/sanity_checks/test_verifiable_producer.py
+++ b/tests/kafkatest/sanity_checks/test_verifiable_producer.py
@@ -23,7 +23,7 @@
 from kafkatest.services.verifiable_producer import VerifiableProducer
 from kafkatest.services.zookeeper import ZookeeperService
 from kafkatest.utils import is_version
-from kafkatest.version import LATEST_0_8_2, LATEST_0_9, DEV_BRANCH, KafkaVersion
+from kafkatest.version import LATEST_0_8_2, LATEST_0_9, LATEST_0_10_0, LATEST_0_10_1, DEV_BRANCH, KafkaVersion
 
 
 class TestVerifiableProducer(Test):
@@ -48,6 +48,8 @@ def setUp(self):
     @cluster(num_nodes=3)
     @parametrize(producer_version=str(LATEST_0_8_2))
     @parametrize(producer_version=str(LATEST_0_9))
+    @parametrize(producer_version=str(LATEST_0_10_0))
+    @parametrize(producer_version=str(LATEST_0_10_1))
     @parametrize(producer_version=str(DEV_BRANCH))
     def test_simple_run(self, producer_version=DEV_BRANCH):
         """

From 46e6081eb705cbaad0643cdc59d8cc1ffa14bc4e Mon Sep 17 00:00:00 2001
From: Clemens Valiente <clemens.valiente@trivago.com>
Date: Thu, 2 Mar 2017 13:26:30 -0800
Subject: [PATCH 122/177] KAFKA-4800: Streams State transition ASCII diagrams
 need fixing and polishing

added \<pre> tags to not break javadoc display of the ASCII diagrams.
see broken ascii here:
https://kafka.apache.org/0102/javadoc/org/apache/kafka/streams/KafkaStreams.State.html

fix can be checked with gradle :streams:javadoc and then checking streams/build/docs/javadoc/org/apache/kafka/streams/KafkaStreams.State.html

I also fixed the diagram in StreamThread.java however currently no javadoc is generated for that one (since it's internal)

enothereska please have a look

Author: Clemens Valiente <clemens.valiente@trivago.com>

Reviewers: Eno Thereska, Matthias J. Sax, Guozhang Wang

Closes #2621 from cvaliente/KAFKA-4800-ASCII-diagrams

(cherry picked from commit 670980ef29fb70838dcd462d11789c2519981164)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../apache/kafka/streams/KafkaStreams.java    | 42 +++++++-------
 .../processor/internals/StreamThread.java     | 55 ++++++++++---------
 2 files changed, 50 insertions(+), 47 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java b/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
index c57804e532510..a13626c77d565 100644
--- a/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
+++ b/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
@@ -143,30 +143,32 @@ public class KafkaStreams {
      * Note this instance will be in "Rebalancing" state if any of its threads is rebalancing
      * The expected state transition with the following defined states is:
      *
-     *                 +-----------+
-     *         +<------|Created    |
-     *         |       +-----+-----+
-     *         |             |   +--+
-     *         |             v   |  |
-     *         |       +-----+---v--+--+
-     *         +<----- | Rebalancing   |<--------+
-     *         |       +-----+---------+         ^
-     *         |                 +--+            |
-     *         |                 |  |            |
-     *         |       +-----+---v--+-----+      |
-     *         +------>|Running           |------+
-     *         |       +-----+------------+
+     * <pre>
+     *                 +--------------+
+     *         +<----- | Created      |
+     *         |       +-----+--------+
      *         |             |
      *         |             v
-     *         |     +-------+--------+
-     *         +---->|Pending         |
-     *               |Shutdown        |
-     *               +-------+--------+
+     *         |       +-----+--------+
+     *         +<----- | Rebalancing  | <----+
+     *         |       +--------------+      |
+     *         |                             |
+     *         |                             |
+     *         |       +--------------+      |
+     *         +-----> | Running      | ---->+
+     *         |       +-----+--------+
+     *         |             |
+     *         |             v
+     *         |       +-----+--------+
+     *         +-----> | Pending      |
+     *                 | Shutdown     |
+     *                 +-----+--------+
      *                       |
      *                       v
-     *                 +-----+-----+
-     *                 |Not Running|
-     *                 +-----------+
+     *                 +-----+--------+
+     *                 | Not Running  |
+     *                 +--------------+
+     * </pre>
      */
     public enum State {
         CREATED(1, 2, 3), RUNNING(2, 3), REBALANCING(1, 2, 3), PENDING_SHUTDOWN(4), NOT_RUNNING;
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
index 01281423cca35..70c139241015c 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
@@ -76,33 +76,34 @@ public class StreamThread extends Thread {
      * A thread must only be in one state at a time
      * The expected state transitions with the following defined states is:
      *
-     *                +-----------+
-     *                |Not Running|<---------------+
-     *                +-----+-----+                |
-     *                      |                      |
-     *                      v                      |
-     *                +-----+-----+                |
-     *          +-----| Running   |<------------+  |
-     *          |     +-----+-----+             |  |
-     *          |           |                   |  |
-     *          |           v                   |  |
-     *          |     +-----+------------+      |  |
-     *          <---- |Partitions        |      |  |
-     *          |     |Revoked           |      |  |
-     *          |     +-----+------------+      |  |
-     *          |           |                   |  |
-     *          |           v                   |  |
-     *          |     +-----+------------+      |  |
-     *          |     |Assigning         |      |  |
-     *          |     |Partitions        |------+  |
-     *          |     +-----+------------+         |
-     *          |           |                      |
-     *          |           |                      |
-     *          |    +------v---------+            |
-     *          +--->|Pending         |------------+
-     *               |Shutdown        |
-     *               +-----+----------+
-     *
+     * <pre>
+     *                +-------------+
+     *                | Not Running | <-------+
+     *                +-----+-------+         |
+     *                      |                 |
+     *                      v                 |
+     *                +-----+-------+         |
+     *          +<--- | Running     | <----+  |
+     *          |     +-----+-------+      |  |
+     *          |           |              |  |
+     *          |           v              |  |
+     *          |     +-----+-------+      |  |
+     *          +<--- | Partitions  |      |  |
+     *          |     | Revoked     |      |  |
+     *          |     +-----+-------+      |  |
+     *          |           |              |  |
+     *          |           v              |  |
+     *          |     +-----+-------+      |  |
+     *          |     | Assigning   |      |  |
+     *          |     | Partitions  | ---->+  |
+     *          |     +-----+-------+         |
+     *          |           |                 |
+     *          |           v                 |
+     *          |     +-----+-------+         |
+     *          +---> | Pending     | ------->+
+     *                | Shutdown    |
+     *                +-------------+
+     * </pre>
      */
     public enum State {
         NOT_RUNNING(1), RUNNING(1, 2, 4), PARTITIONS_REVOKED(3, 4), ASSIGNING_PARTITIONS(1, 4), PENDING_SHUTDOWN(0);

From 0b04d4e240c56f70f2a334cdb0d4b7a83d228278 Mon Sep 17 00:00:00 2001
From: "Colin P. Mccabe" <cmccabe@confluent.io>
Date: Fri, 3 Mar 2017 16:40:25 -0800
Subject: [PATCH 123/177] MINOR: Fix tests/docker/Dockerfile

Fix tests/docker/Dockerfile to put the old Kafka distributions in the
correct spot for tests.  Also, run_tests.sh should exit with an error
code if image rebuilding fails, rather than silently falling back to an
older image.

Author: Colin P. Mccabe <cmccabe@confluent.io>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2613 from cmccabe/dockerfix

(cherry picked from commit 4b1415c109fa75a01a11460aa80f0404baecac51)
Signed-off-by: Ewen Cheslack-Postava <me@ewencp.org>
---
 tests/docker/Dockerfile   | 8 ++++----
 tests/docker/run_tests.sh | 8 +++++++-
 2 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/tests/docker/Dockerfile b/tests/docker/Dockerfile
index 3a3df3242259a..78b2e32d35278 100644
--- a/tests/docker/Dockerfile
+++ b/tests/docker/Dockerfile
@@ -23,9 +23,9 @@ ADD ssh /root/.ssh
 RUN chmod 600 /root/.ssh/id_rsa
 RUN apt update && apt install -y unzip wget curl jq coreutils openssh-server net-tools vim openjdk-8-jdk python-pip python-dev libffi-dev libssl-dev
 RUN pip install -U pip && pip install --upgrade cffi ducktape==0.6.0
-RUN mkdir -p "/opt/kafka_2.10-0.8.2.2" && curl "${MIRROR}kafka/0.8.2.2/kafka_2.10-0.8.2.2.tgz" | tar xz --strip-components=1 -C "/opt/kafka_2.10-0.8.2.2"
-RUN mkdir -p "/opt/kafka_2.10-0.9.0.1" && curl "${MIRROR}kafka/0.9.0.1/kafka_2.10-0.9.0.1.tgz" | tar xz --strip-components=1 -C "/opt/kafka_2.10-0.9.0.1"
-RUN mkdir -p "/opt/kafka_2.10-0.10.0.1" && curl "${MIRROR}kafka/0.10.0.1/kafka_2.10-0.10.0.1.tgz" | tar xz --strip-components=1 -C "/opt/kafka_2.10-0.10.0.1"
-RUN mkdir -p "/opt/kafka_2.10-0.10.1.1" && curl "${MIRROR}kafka/0.10.1.1/kafka_2.10-0.10.1.1.tgz" | tar xz --strip-components=1 -C "/opt/kafka_2.10-0.10.1.1"
+RUN mkdir -p "/opt/kafka-0.8.2.2" && curl -s "${MIRROR}kafka/0.8.2.2/kafka_2.10-0.8.2.2.tgz" | tar xz --strip-components=1 -C "/opt/kafka-0.8.2.2"
+RUN mkdir -p "/opt/kafka-0.9.0.1" && curl -s "${MIRROR}kafka/0.9.0.1/kafka_2.10-0.9.0.1.tgz" | tar xz --strip-components=1 -C "/opt/kafka-0.9.0.1"
+RUN mkdir -p "/opt/kafka-0.10.0.1" && curl -s "${MIRROR}kafka/0.10.0.1/kafka_2.10-0.10.0.1.tgz" | tar xz --strip-components=1 -C "/opt/kafka-0.10.0.1"
+RUN mkdir -p "/opt/kafka-0.10.1.1" && curl -s "${MIRROR}kafka/0.10.1.1/kafka_2.10-0.10.1.1.tgz" | tar xz --strip-components=1 -C "/opt/kafka-0.10.1.1"
 
 CMD service ssh start && tail -f /dev/null
diff --git a/tests/docker/run_tests.sh b/tests/docker/run_tests.sh
index cc381cc33c2e4..11b551fad10c9 100755
--- a/tests/docker/run_tests.sh
+++ b/tests/docker/run_tests.sh
@@ -18,6 +18,11 @@
 #   TC_PATHS="tests/kafkatest/tests/streams tests/kafkatest/tests/tools" bash tests/docker/run_tests.sh
 set -x
 
+die() {
+    echo $@
+    exit 1
+}
+
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 TESTS_DIR=`dirname ${SCRIPT_DIR}`
 KAFKA_SRC=`dirname ${TESTS_DIR}`
@@ -40,7 +45,8 @@ docker run --rm -it ${KAFKA_IMAGE} "true"
 if [[ $? != 0 || ${KAFKA_IMAGE_REBUILD} != "" ]]; then
     echo "kafka image ${KAFKA_IMAGE} does not exist. Building it from scratch."
     COMMIT_INFO=$(git describe HEAD)
-    docker build -t ${KAFKA_IMAGE} --label=commit_info=${COMMIT_INFO} ${SCRIPT_DIR}
+    docker build -t ${KAFKA_IMAGE} --label=commit_info=${COMMIT_INFO} ${SCRIPT_DIR} \
+        || die "docker build failed"
 fi
 
 echo "Using kafka image: ${KAFKA_IMAGE}"

From 46e6601b2583a8e2b862fb41cbc6d95419228446 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Mon, 6 Mar 2017 09:52:17 -0800
Subject: [PATCH 124/177] HOTFIX: fix broken link for wordcount demo example

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2644 from mjsax/hotfixBrokerLink
---
 docs/quickstart.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/quickstart.html b/docs/quickstart.html
index 69f6a7a5d4f7a..51d85fd1b6cd3 100644
--- a/docs/quickstart.html
+++ b/docs/quickstart.html
@@ -282,7 +282,7 @@ <h4><a id="quickstart_kafkastreams" href="#quickstart_kafkastreams">Step 8: Use
 <p>
 Kafka Streams is a client library of Kafka for real-time stream processing and analyzing data stored in Kafka brokers.
 This quickstart example will demonstrate how to run a streaming application coded in this library. Here is the gist
-of the <code><a href="https://github.com/apache/kafka/blob/{dotVersion}/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountDemo.java">WordCountDemo</a></code> example code (converted to use Java 8 lambda expressions for easy reading).
+of the <code><a href="https://github.com/apache/kafka/blob/{{dotVersion}}/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountDemo.java">WordCountDemo</a></code> example code (converted to use Java 8 lambda expressions for easy reading).
 </p>
 <pre>
 // Serializers/deserializers (serde) for String and Long types
@@ -446,4 +446,4 @@ <h4><a id="quickstart_kafkastreams" href="#quickstart_kafkastreams">Step 8: Use
 
 </script>
 
-<div class="p-quickstart"></div>
\ No newline at end of file
+<div class="p-quickstart"></div>

From a05c5415460abc9c93ebd6f859b58689b0a3d56f Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Tue, 7 Mar 2017 15:31:22 -0800
Subject: [PATCH 125/177] KAFKA-4851: only search available segments during
 Segments.segments(from, to)

restrict the locating of segments in `Segments#segments(..)` to only the segments that are currently available, i.e., rather than searching the hashmap for many segments that don't exist.

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2645 from dguy/session-windows-testing

(cherry picked from commit 146edd530a6dfa534fd8cb924fd2336e27872c2a)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../streams/state/internals/Segments.java     | 21 ++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/Segments.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/Segments.java
index 13cdf6c16b523..72eb802f1326e 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/Segments.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/Segments.java
@@ -40,7 +40,8 @@ class Segments {
     private final int numSegments;
     private final long segmentInterval;
     private final SimpleDateFormat formatter;
-    private long currentSegmentId = -1L;
+    private long minSegmentId = Long.MAX_VALUE;
+    private long maxSegmentId = -1L;
 
     Segments(final String name, final long retentionPeriod, final int numSegments) {
         this.name = name;
@@ -64,7 +65,7 @@ Segment getSegmentForTimestamp(final long timestamp) {
     }
 
     Segment getOrCreateSegment(final long segmentId, final ProcessorContext context) {
-        if (segmentId > currentSegmentId || segmentId > currentSegmentId - numSegments) {
+        if (segmentId > maxSegmentId - numSegments) {
             final long key = segmentId % numSegments;
             final Segment segment = segments.get(key);
             if (!isSegment(segment, segmentId)) {
@@ -74,7 +75,10 @@ Segment getOrCreateSegment(final long segmentId, final ProcessorContext context)
                 Segment newSegment = new Segment(segmentName(segmentId), name, segmentId);
                 newSegment.openDB(context);
                 segments.put(key, newSegment);
-                currentSegmentId = segmentId > currentSegmentId ? segmentId : currentSegmentId;
+                maxSegmentId = segmentId > maxSegmentId ? segmentId : maxSegmentId;
+                if (minSegmentId == Long.MAX_VALUE) {
+                    minSegmentId = maxSegmentId;
+                }
             }
             return segments.get(key);
         } else {
@@ -112,8 +116,8 @@ void openExisting(final ProcessorContext context) {
     }
 
     List<Segment> segments(final long timeFrom, final long timeTo) {
-        final long segFrom = segmentId(Math.max(0L, timeFrom));
-        final long segTo = segmentId(Math.min(currentSegmentId * segmentInterval, Math.max(0, timeTo)));
+        final long segFrom = Math.max(minSegmentId, segmentId(Math.max(0L, timeFrom)));
+        final long segTo = Math.min(maxSegmentId, segmentId(Math.min(maxSegmentId * segmentInterval, Math.max(0, timeTo))));
 
         final List<Segment> segments = new ArrayList<>();
         for (long segmentId = segFrom; segmentId <= segTo; segmentId++) {
@@ -154,9 +158,9 @@ private boolean isSegment(final Segment store, long segmentId) {
     }
 
     private void cleanup(final long segmentId) {
-        final long oldestSegmentId = currentSegmentId < segmentId
+        final long oldestSegmentId = maxSegmentId < segmentId
                 ? segmentId - numSegments
-                : currentSegmentId - numSegments;
+                : maxSegmentId - numSegments;
 
         for (Map.Entry<Long, Segment> segmentEntry : segments.entrySet()) {
             final Segment segment = segmentEntry.getValue();
@@ -166,6 +170,9 @@ private void cleanup(final long segmentId) {
                 segment.destroy();
             }
         }
+        if (oldestSegmentId > minSegmentId) {
+            minSegmentId = oldestSegmentId + 1;
+        }
     }
 
     private long segmentIdFromSegmentName(String segmentName) {

From 3445ed0bab6a035c3bacf1fd5f2439e44fb3ca52 Mon Sep 17 00:00:00 2001
From: simplesteph <stephane.maarek@gmail.com>
Date: Wed, 8 Mar 2017 21:41:38 -0800
Subject: [PATCH 126/177] KAFKA-4864; added correct zookeeper nodes for
 security migrator

Author: simplesteph <stephane.maarek@gmail.com>

Reviewers: Jun Rao <junrao@gmail.com>

Closes #2655 from simplesteph/fix-security-migrator-tool

(cherry picked from commit 294018a578cbbc187ac123a6b99990468186e349)
Signed-off-by: Jun Rao <junrao@gmail.com>
---
 .../main/scala/kafka/admin/AdminUtils.scala   |  2 +-
 .../kafka/admin/ZkSecurityMigrator.scala      |  4 +-
 .../security/auth/SimpleAclAuthorizer.scala   |  4 +-
 .../kafka/server/DynamicConfigManager.scala   |  2 +-
 core/src/main/scala/kafka/utils/ZkUtils.scala | 56 +++++++++++--------
 ...aslScramSslEndToEndAuthorizationTest.scala |  2 +-
 .../unit/kafka/admin/TopicCommandTest.scala   |  2 +-
 .../security/auth/ZkAuthorizationTest.scala   |  6 +-
 .../server/DynamicConfigChangeTest.scala      |  2 +-
 9 files changed, 46 insertions(+), 34 deletions(-)

diff --git a/core/src/main/scala/kafka/admin/AdminUtils.scala b/core/src/main/scala/kafka/admin/AdminUtils.scala
index 65ac91cf361b4..d4ae4ff946614 100644
--- a/core/src/main/scala/kafka/admin/AdminUtils.scala
+++ b/core/src/main/scala/kafka/admin/AdminUtils.scala
@@ -565,7 +565,7 @@ object AdminUtils extends Logging with AdminUtilities {
     writeEntityConfig(zkUtils, entityConfigPath, configs)
 
     // create the change notification
-    val seqNode = ZkUtils.EntityConfigChangesPath + "/" + EntityConfigChangeZnodePrefix
+    val seqNode = ZkUtils.ConfigChangesPath + "/" + EntityConfigChangeZnodePrefix
     val content = Json.encode(getConfigChangeZnodeData(sanitizedEntityPath))
     zkUtils.zkClient.createPersistentSequential(seqNode, content)
   }
diff --git a/core/src/main/scala/kafka/admin/ZkSecurityMigrator.scala b/core/src/main/scala/kafka/admin/ZkSecurityMigrator.scala
index 9bd321c408da4..eb5c14211fc2d 100644
--- a/core/src/main/scala/kafka/admin/ZkSecurityMigrator.scala
+++ b/core/src/main/scala/kafka/admin/ZkSecurityMigrator.scala
@@ -220,12 +220,12 @@ class ZkSecurityMigrator(zkUtils: ZkUtils) extends Logging {
   private def run(): Unit = {
     try {
       setAclIndividually("/")
-      for (path <- zkUtils.securePersistentZkPaths) {
+      for (path <- ZkUtils.SecureZkRootPaths) {
         debug("Going to set ACL for %s".format(path))
         zkUtils.makeSurePersistentPathExists(path)
         setAclsRecursively(path)
       }
-      
+
       @tailrec
       def recurse(): Unit = {
         val future = futures.synchronized { 
diff --git a/core/src/main/scala/kafka/security/auth/SimpleAclAuthorizer.scala b/core/src/main/scala/kafka/security/auth/SimpleAclAuthorizer.scala
index a0e7294a19afa..28f910a199e5a 100644
--- a/core/src/main/scala/kafka/security/auth/SimpleAclAuthorizer.scala
+++ b/core/src/main/scala/kafka/security/auth/SimpleAclAuthorizer.scala
@@ -56,10 +56,10 @@ object SimpleAclAuthorizer {
    * /kafka-acl/ConsumerGroup/group-1 => {"version": 1, "acls": [ { "host":"host1", "permissionType": "Allow","operation": "Read","principal": "User:alice"}]}
    * </pre>
    */
-  val AclZkPath = "/kafka-acl"
+  val AclZkPath = ZkUtils.KafkaAclPath
 
   //notification node which gets updated with the resource name when acl on a resource is changed.
-  val AclChangedZkPath = "/kafka-acl-changes"
+  val AclChangedZkPath = ZkUtils.KafkaAclChangesPath
 
   //prefix of all the change notification sequence node.
   val AclChangedPrefix = "acl_changes_"
diff --git a/core/src/main/scala/kafka/server/DynamicConfigManager.scala b/core/src/main/scala/kafka/server/DynamicConfigManager.scala
index e0e6a03cec410..c81ce6c5e3551 100644
--- a/core/src/main/scala/kafka/server/DynamicConfigManager.scala
+++ b/core/src/main/scala/kafka/server/DynamicConfigManager.scala
@@ -148,7 +148,7 @@ class DynamicConfigManager(private val zkUtils: ZkUtils,
     }
   }
 
-  private val configChangeListener = new ZkNodeChangeNotificationListener(zkUtils, ZkUtils.EntityConfigChangesPath, AdminUtils.EntityConfigChangeZnodePrefix, ConfigChangedNotificationHandler)
+  private val configChangeListener = new ZkNodeChangeNotificationListener(zkUtils, ZkUtils.ConfigChangesPath, AdminUtils.EntityConfigChangeZnodePrefix, ConfigChangedNotificationHandler)
 
   /**
    * Begin watching for config changes
diff --git a/core/src/main/scala/kafka/utils/ZkUtils.scala b/core/src/main/scala/kafka/utils/ZkUtils.scala
index 7a6bd6336b886..e67e264b9bd69 100644
--- a/core/src/main/scala/kafka/utils/ZkUtils.scala
+++ b/core/src/main/scala/kafka/utils/ZkUtils.scala
@@ -43,19 +43,40 @@ import scala.collection._
 import scala.collection.JavaConverters._
 
 object ZkUtils {
-  val ConsumersPath = "/consumers"
-  val ClusterIdPath = "/cluster/id"
-  val BrokerIdsPath = "/brokers/ids"
-  val BrokerTopicsPath = "/brokers/topics"
+
+
+  // Important: it is necessary to add any new top level Zookeeper path here
+  val AdminPath = "/admin"
+  val BrokersPath = "/brokers"
+  val ClusterPath = "/cluster"
+  val ConfigPath = "/config"
   val ControllerPath = "/controller"
   val ControllerEpochPath = "/controller_epoch"
-  val ReassignPartitionsPath = "/admin/reassign_partitions"
-  val DeleteTopicsPath = "/admin/delete_topics"
-  val PreferredReplicaLeaderElectionPath = "/admin/preferred_replica_election"
-  val BrokerSequenceIdPath = "/brokers/seqid"
   val IsrChangeNotificationPath = "/isr_change_notification"
-  val EntityConfigPath = "/config"
-  val EntityConfigChangesPath = "/config/changes"
+  val KafkaAclPath = "/kafka-acl"
+  val KafkaAclChangesPath = "/kafka-acl-changes"
+
+  val ConsumersPath = "/consumers"
+  val ClusterIdPath = s"$ClusterPath/id"
+  val BrokerIdsPath = s"$BrokersPath/ids"
+  val BrokerTopicsPath = s"$BrokersPath/topics"
+  val ReassignPartitionsPath = s"$AdminPath/reassign_partitions"
+  val DeleteTopicsPath = s"$AdminPath/delete_topics"
+  val PreferredReplicaLeaderElectionPath = s"$AdminPath/preferred_replica_election"
+  val BrokerSequenceIdPath = s"$BrokersPath/seqid"
+  val ConfigChangesPath = s"$ConfigPath/changes"
+
+
+  // Important: it is necessary to add any new top level Zookeeper path to the Seq
+  val SecureZkRootPaths = Seq(AdminPath,
+                              BrokersPath,
+                              ClusterPath,
+                              ConfigPath,
+                              ControllerPath,
+                              ControllerEpochPath,
+                              IsrChangeNotificationPath,
+                              KafkaAclPath,
+                              KafkaAclChangesPath)
 
   def apply(zkUrl: String, sessionTimeout: Int, connectionTimeout: Int, isZkSecurityEnabled: Boolean): ZkUtils = {
     val (zkClient, zkConnection) = createZkClientAndConnection(zkUrl, sessionTimeout, connectionTimeout)
@@ -117,13 +138,13 @@ object ZkUtils {
     getTopicPartitionPath(topic, partitionId) + "/" + "state"
 
   def getEntityConfigRootPath(entityType: String): String =
-    ZkUtils.EntityConfigPath + "/" + entityType
+    ZkUtils.ConfigPath + "/" + entityType
 
   def getEntityConfigPath(entityType: String, entity: String): String =
     getEntityConfigRootPath(entityType) + "/" + entity
 
   def getEntityConfigPath(entityPath: String): String =
-    ZkUtils.EntityConfigPath + "/" + entityPath
+    ZkUtils.ConfigPath + "/" + entityPath
 
   def getDeleteTopicPath(topic: String): String =
     DeleteTopicsPath + "/" + topic
@@ -191,22 +212,13 @@ class ZkUtils(val zkClient: ZkClient,
   val persistentZkPaths = Seq(ConsumersPath,
                               BrokerIdsPath,
                               BrokerTopicsPath,
-                              EntityConfigChangesPath,
+                              ConfigChangesPath,
                               getEntityConfigRootPath(ConfigType.Topic),
                               getEntityConfigRootPath(ConfigType.Client),
                               DeleteTopicsPath,
                               BrokerSequenceIdPath,
                               IsrChangeNotificationPath)
 
-  val securePersistentZkPaths = Seq(BrokerIdsPath,
-                                    BrokerTopicsPath,
-                                    EntityConfigChangesPath,
-                                    getEntityConfigRootPath(ConfigType.Topic),
-                                    getEntityConfigRootPath(ConfigType.Client),
-                                    DeleteTopicsPath,
-                                    BrokerSequenceIdPath,
-                                    IsrChangeNotificationPath)
-
   val DefaultAcls: java.util.List[ACL] = ZkUtils.DefaultAcls(isSecure)
 
   def getController(): Int = {
diff --git a/core/src/test/scala/integration/kafka/api/SaslScramSslEndToEndAuthorizationTest.scala b/core/src/test/scala/integration/kafka/api/SaslScramSslEndToEndAuthorizationTest.scala
index fe0204ae51932..86db4074f9476 100644
--- a/core/src/test/scala/integration/kafka/api/SaslScramSslEndToEndAuthorizationTest.scala
+++ b/core/src/test/scala/integration/kafka/api/SaslScramSslEndToEndAuthorizationTest.scala
@@ -32,7 +32,7 @@ class SaslScramSslEndToEndAuthorizationTest extends SaslEndToEndAuthorizationTes
 
   override def configureSecurityBeforeServersStart() {
     super.configureSecurityBeforeServersStart()
-    zkUtils.makeSurePersistentPathExists(ZkUtils.EntityConfigChangesPath)
+    zkUtils.makeSurePersistentPathExists(ZkUtils.ConfigChangesPath)
 
     def configCommandArgs(username: String, password: String) : Array[String] = {
       val credentials = kafkaServerSaslMechanisms.map(m => s"$m=[iterations=4096,password=$password]")
diff --git a/core/src/test/scala/unit/kafka/admin/TopicCommandTest.scala b/core/src/test/scala/unit/kafka/admin/TopicCommandTest.scala
index 8ce7c90436f44..52158673e435e 100644
--- a/core/src/test/scala/unit/kafka/admin/TopicCommandTest.scala
+++ b/core/src/test/scala/unit/kafka/admin/TopicCommandTest.scala
@@ -49,7 +49,7 @@ class TopicCommandTest extends ZooKeeperTestHarness with Logging with RackAwareT
     assertTrue("Properties after creation have incorrect value", props.getProperty(cleanupKey).equals(cleanupVal))
 
     // pre-create the topic config changes path to avoid a NoNodeException
-    zkUtils.createPersistentPath(EntityConfigChangesPath)
+    zkUtils.createPersistentPath(ConfigChangesPath)
 
     // modify the topic to add new partitions
     val numPartitionsModified = 3
diff --git a/core/src/test/scala/unit/kafka/security/auth/ZkAuthorizationTest.scala b/core/src/test/scala/unit/kafka/security/auth/ZkAuthorizationTest.scala
index 8cec0c79c8a4f..3b4c48e325d70 100644
--- a/core/src/test/scala/unit/kafka/security/auth/ZkAuthorizationTest.scala
+++ b/core/src/test/scala/unit/kafka/security/auth/ZkAuthorizationTest.scala
@@ -153,7 +153,7 @@ class ZkAuthorizationTest extends ZooKeeperTestHarness with Logging {
   @Test
   def testDeleteRecursive() {
     info(s"zkConnect string: $zkConnect")
-    for (path <- zkUtils.securePersistentZkPaths) {
+    for (path <- ZkUtils.SecureZkRootPaths) {
       info(s"Creating $path")
       zkUtils.makeSurePersistentPathExists(path)
       zkUtils.createPersistentPath(s"$path/fpjwashere", "")
@@ -185,7 +185,7 @@ class ZkAuthorizationTest extends ZooKeeperTestHarness with Logging {
    */
   private def testMigration(zkUrl: String, firstZk: ZkUtils, secondZk: ZkUtils) {
     info(s"zkConnect string: $zkUrl")
-    for (path <- firstZk.securePersistentZkPaths) {
+    for (path <- ZkUtils.SecureZkRootPaths) {
       info(s"Creating $path")
       firstZk.makeSurePersistentPathExists(path)
       // Create a child for each znode to exercise the recurrent
@@ -206,7 +206,7 @@ class ZkAuthorizationTest extends ZooKeeperTestHarness with Logging {
       }
     ZkSecurityMigrator.run(Array(s"--zookeeper.acl=$secureOpt", s"--zookeeper.connect=$zkUrl"))
     info("Done with migration")
-    for (path <- secondZk.securePersistentZkPaths) {
+    for (path <- ZkUtils.SecureZkRootPaths) {
       val listParent = secondZk.zkConnection.getAcl(path).getKey
       assertTrue(path, isAclCorrect(listParent, secondZk.isSecure))
 
diff --git a/core/src/test/scala/unit/kafka/server/DynamicConfigChangeTest.scala b/core/src/test/scala/unit/kafka/server/DynamicConfigChangeTest.scala
index cf0dc6fd6cdc1..dc30fb20eb0cd 100644
--- a/core/src/test/scala/unit/kafka/server/DynamicConfigChangeTest.scala
+++ b/core/src/test/scala/unit/kafka/server/DynamicConfigChangeTest.scala
@@ -148,7 +148,7 @@ class DynamicConfigChangeTest extends KafkaServerTestHarness {
     AdminUtils.changeUserOrUserClientIdConfig(zkUtils, "ANONYMOUS/clients/overriddenUserClientId", userClientIdProps)
 
     // Remove config change znodes to force quota initialization only through loading of user/client quotas
-    zkUtils.getChildren(ZkUtils.EntityConfigChangesPath).foreach { p => zkUtils.deletePath(ZkUtils.EntityConfigChangesPath + "/" + p) }
+    zkUtils.getChildren(ZkUtils.ConfigChangesPath).foreach { p => zkUtils.deletePath(ZkUtils.ConfigChangesPath + "/" + p) }
     server.startup()
     val quotaManagers = server.apis.quotas
 

From beb0d570091cf368fe7397c73c97a2f1e1d5c2c2 Mon Sep 17 00:00:00 2001
From: Ismael Juma <ismael@juma.me.uk>
Date: Thu, 9 Mar 2017 16:45:41 -0800
Subject: [PATCH 127/177] KAFKA-4861; GroupMetadataManager record is rejected
 if broker configured with LogAppendTime

The record should be created with CreateTime (like in the producer). The conversion to
LogAppendTime happens automatically (if necessary).

Author: Ismael Juma <ismael@juma.me.uk>

Reviewers: Jason Gustafson <jason@confluent.io>

Closes #2657 from ijuma/kafka-4861-log-append-time-breaks-group-data-manager

(cherry picked from commit 7565dcd8b0547f91a5d9d19771d9cd6693079d01)
Signed-off-by: Jason Gustafson <jason@confluent.io>
---
 .../coordinator/GroupMetadataManager.scala    | 33 ++++---
 .../main/scala/kafka/server/KafkaApis.scala   |  2 +-
 .../scala/kafka/server/ReplicaManager.scala   |  6 +-
 .../kafka/api/BaseConsumerTest.scala          |  2 +-
 .../kafka/api/ConsumerBounceTest.scala        |  3 +-
 .../kafka/api/FixedPortTestUtils.scala        |  9 +-
 .../kafka/api/IntegrationTestHarness.scala    |  2 +-
 .../kafka/api/LogAppendTimeTest.scala         | 87 +++++++++++++++++++
 .../GroupCoordinatorResponseTest.scala        | 12 +--
 .../GroupMetadataManagerTest.scala            | 16 ++--
 .../integration/KafkaServerTestHarness.scala  |  4 +-
 11 files changed, 129 insertions(+), 47 deletions(-)
 create mode 100644 core/src/test/scala/integration/kafka/api/LogAppendTimeTest.scala

diff --git a/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala b/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
index c66ce7496ace5..ebdd2bb282d47 100644
--- a/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
+++ b/core/src/main/scala/kafka/coordinator/GroupMetadataManager.scala
@@ -133,8 +133,8 @@ class GroupMetadataManager(val brokerId: Int,
   def prepareStoreGroup(group: GroupMetadata,
                         groupAssignment: Map[String, Array[Byte]],
                         responseCallback: Errors => Unit): Option[DelayedStore] = {
-    getMagicAndTimestamp(partitionFor(group.groupId)) match {
-      case Some((magicValue, timestampType, timestamp)) =>
+    getMagic(partitionFor(group.groupId)) match {
+      case Some(magicValue) =>
         val groupMetadataValueVersion = {
           if (interBrokerProtocolVersion < KAFKA_0_10_1_IV0)
             0.toShort
@@ -142,6 +142,9 @@ class GroupMetadataManager(val brokerId: Int,
             GroupMetadataManager.CURRENT_GROUP_VALUE_SCHEMA_VERSION
         }
 
+        // We always use CREATE_TIME, like the producer. The conversion to LOG_APPEND_TIME (if necessary) happens automatically.
+        val timestampType = TimestampType.CREATE_TIME
+        val timestamp = time.milliseconds()
         val record = Record.create(magicValue, timestampType, timestamp,
           GroupMetadataManager.groupMetadataKey(group.groupId),
           GroupMetadataManager.groupMetadataValue(group, groupAssignment, version = groupMetadataValueVersion))
@@ -231,8 +234,11 @@ class GroupMetadataManager(val brokerId: Int,
     }
 
     // construct the message set to append
-    getMagicAndTimestamp(partitionFor(group.groupId)) match {
-      case Some((magicValue, timestampType, timestamp)) =>
+    getMagic(partitionFor(group.groupId)) match {
+      case Some(magicValue) =>
+        // We always use CREATE_TIME, like the producer. The conversion to LOG_APPEND_TIME (if necessary) happens automatically.
+        val timestampType = TimestampType.CREATE_TIME
+        val timestamp = time.milliseconds()
         val records = filteredOffsetMetadata.map { case (topicPartition, offsetAndMetadata) =>
           Record.create(magicValue, timestampType, timestamp,
             GroupMetadataManager.offsetCommitKey(group.groupId, topicPartition),
@@ -575,8 +581,12 @@ class GroupMetadataManager(val brokerId: Int,
 
       val offsetsPartition = partitionFor(groupId)
       val appendPartition = new TopicPartition(Topic.GroupMetadataTopicName, offsetsPartition)
-      getMagicAndTimestamp(offsetsPartition) match {
-        case Some((magicValue, timestampType, timestamp)) =>
+      getMagic(offsetsPartition) match {
+        case Some(magicValue) =>
+          // We always use CREATE_TIME, like the producer. The conversion to LOG_APPEND_TIME (if necessary) happens automatically.
+          val timestampType = TimestampType.CREATE_TIME
+          val timestamp = time.milliseconds()
+
           val partitionOpt = replicaManager.getPartition(appendPartition)
           partitionOpt.foreach { partition =>
             val tombstones = removedOffsets.map { case (topicPartition, offsetAndMetadata) =>
@@ -652,15 +662,10 @@ class GroupMetadataManager(val brokerId: Int,
    * Check if the replica is local and return the message format version and timestamp
    *
    * @param   partition  Partition of GroupMetadataTopic
-   * @return  Option[(MessageFormatVersion, TimeStamp)] if replica is local, None otherwise
+   * @return  Some(MessageFormatVersion) if replica is local, None otherwise
    */
-  private def getMagicAndTimestamp(partition: Int): Option[(Byte, TimestampType, Long)] = {
-    val groupMetadataTopicPartition = new TopicPartition(Topic.GroupMetadataTopicName, partition)
-    replicaManager.getMagicAndTimestampType(groupMetadataTopicPartition).map { case (messageFormatVersion, timestampType) =>
-      val timestamp = if (messageFormatVersion == Record.MAGIC_VALUE_V0) Record.NO_TIMESTAMP else time.milliseconds()
-      (messageFormatVersion, timestampType, timestamp)
-    }
-  }
+  private def getMagic(partition: Int): Option[Byte] =
+    replicaManager.getMagic(new TopicPartition(Topic.GroupMetadataTopicName, partition))
 
   /**
    * Add the partition into the owned list
diff --git a/core/src/main/scala/kafka/server/KafkaApis.scala b/core/src/main/scala/kafka/server/KafkaApis.scala
index 7bb3ed54de2ba..134793e95625f 100644
--- a/core/src/main/scala/kafka/server/KafkaApis.scala
+++ b/core/src/main/scala/kafka/server/KafkaApis.scala
@@ -475,7 +475,7 @@ class KafkaApis(val requestChannel: RequestChannel,
           // Please note that if the message format is changed from a higher version back to lower version this
           // test might break because some messages in new message format can be delivered to consumers before 0.10.0.0
           // without format down conversion.
-          val convertedData = if (versionId <= 1 && replicaManager.getMagicAndTimestampType(tp).exists(_._1 > Record.MAGIC_VALUE_V0) &&
+          val convertedData = if (versionId <= 1 && replicaManager.getMagic(tp).exists(_ > Record.MAGIC_VALUE_V0) &&
             !data.records.hasMatchingShallowMagic(Record.MAGIC_VALUE_V0)) {
             trace(s"Down converting message to V0 for fetch request from $clientId")
             FetchPartitionData(data.error, data.hw, data.records.toMessageFormat(Record.MAGIC_VALUE_V0))
diff --git a/core/src/main/scala/kafka/server/ReplicaManager.scala b/core/src/main/scala/kafka/server/ReplicaManager.scala
index 1aa88a2bb6005..040cab6eaa023 100644
--- a/core/src/main/scala/kafka/server/ReplicaManager.scala
+++ b/core/src/main/scala/kafka/server/ReplicaManager.scala
@@ -621,10 +621,8 @@ class ReplicaManager(val config: KafkaConfig,
     quota.isThrottled(topicPartition) && quota.isQuotaExceeded && !isReplicaInSync
   }
 
-  def getMagicAndTimestampType(topicPartition: TopicPartition): Option[(Byte, TimestampType)] =
-    getReplica(topicPartition).flatMap { replica =>
-      replica.log.map(log => (log.config.messageFormatVersion.messageFormatVersion, log.config.messageTimestampType))
-    }
+  def getMagic(topicPartition: TopicPartition): Option[Byte] =
+    getReplica(topicPartition).flatMap(_.log.map(_.config.messageFormatVersion.messageFormatVersion))
 
   def maybeUpdateMetadataCache(correlationId: Int, updateMetadataRequest: UpdateMetadataRequest, metadataCache: MetadataCache) : Seq[TopicPartition] =  {
     replicaStateChangeLock synchronized {
diff --git a/core/src/test/scala/integration/kafka/api/BaseConsumerTest.scala b/core/src/test/scala/integration/kafka/api/BaseConsumerTest.scala
index 802bab89233f6..27b89d5d1faf0 100644
--- a/core/src/test/scala/integration/kafka/api/BaseConsumerTest.scala
+++ b/core/src/test/scala/integration/kafka/api/BaseConsumerTest.scala
@@ -33,7 +33,7 @@ import org.apache.kafka.common.errors.WakeupException
 /**
  * Integration tests for the new consumer that cover basic usage as well as server failures
  */
-abstract class BaseConsumerTest extends IntegrationTestHarness with Logging {
+abstract class BaseConsumerTest extends IntegrationTestHarness {
 
   val epsilon = 0.1
   val producerCount = 1
diff --git a/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala b/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala
index 2f37b5ba63ab4..e848e28ce954c 100644
--- a/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala
+++ b/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala
@@ -46,7 +46,6 @@ class ConsumerBounceTest extends IntegrationTestHarness with Logging {
   val executor = Executors.newFixedThreadPool(2)
 
   // configure the servers and clients
-  this.serverConfig.setProperty(KafkaConfig.ControlledShutdownEnableProp, "false") // speed up shutdown
   this.serverConfig.setProperty(KafkaConfig.OffsetsTopicReplicationFactorProp, "3") // don't want to lose offset
   this.serverConfig.setProperty(KafkaConfig.OffsetsTopicPartitionsProp, "1")
   this.serverConfig.setProperty(KafkaConfig.GroupMinSessionTimeoutMsProp, "10") // set small enough session timeout
@@ -58,7 +57,7 @@ class ConsumerBounceTest extends IntegrationTestHarness with Logging {
   this.consumerConfig.setProperty(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest")
 
   override def generateConfigs() = {
-    FixedPortTestUtils.createBrokerConfigs(serverCount, zkConnect,enableControlledShutdown = false)
+    FixedPortTestUtils.createBrokerConfigs(serverCount, zkConnect, enableControlledShutdown = false)
       .map(KafkaConfig.fromProps(_, serverConfig))
   }
 
diff --git a/core/src/test/scala/integration/kafka/api/FixedPortTestUtils.scala b/core/src/test/scala/integration/kafka/api/FixedPortTestUtils.scala
index d15a01d055c21..bf5f8c1e6a3ec 100644
--- a/core/src/test/scala/integration/kafka/api/FixedPortTestUtils.scala
+++ b/core/src/test/scala/integration/kafka/api/FixedPortTestUtils.scala
@@ -34,9 +34,7 @@ object FixedPortTestUtils {
       sockets.foreach(_.close())
       ports
     } catch {
-      case e: IOException => {
-        throw new RuntimeException(e)
-      }
+      case e: IOException => throw new RuntimeException(e)
     }
   }
 
@@ -45,8 +43,9 @@ object FixedPortTestUtils {
     enableControlledShutdown: Boolean = true,
     enableDeleteTopic: Boolean = false): Seq[Properties] = {
     val ports = FixedPortTestUtils.choosePorts(numConfigs)
-    (0 until numConfigs)
-      .map(node => TestUtils.createBrokerConfig(node, zkConnect, enableControlledShutdown, enableDeleteTopic, ports(node)))
+    (0 until numConfigs).map { node =>
+      TestUtils.createBrokerConfig(node, zkConnect, enableControlledShutdown, enableDeleteTopic, ports(node))
+    }
   }
 
 }
diff --git a/core/src/test/scala/integration/kafka/api/IntegrationTestHarness.scala b/core/src/test/scala/integration/kafka/api/IntegrationTestHarness.scala
index 92088f8210cc0..dc30bf79fd436 100644
--- a/core/src/test/scala/integration/kafka/api/IntegrationTestHarness.scala
+++ b/core/src/test/scala/integration/kafka/api/IntegrationTestHarness.scala
@@ -45,7 +45,7 @@ trait IntegrationTestHarness extends KafkaServerTestHarness {
   val consumers = Buffer[KafkaConsumer[Array[Byte], Array[Byte]]]()
   val producers = Buffer[KafkaProducer[Array[Byte], Array[Byte]]]()
 
-  override def generateConfigs() = {
+  override def generateConfigs = {
     val cfgs = TestUtils.createBrokerConfigs(serverCount, zkConnect, interBrokerSecurityProtocol = Some(securityProtocol),
       trustStoreFile = trustStoreFile, saslProperties = serverSaslProperties)
     cfgs.foreach(_.putAll(serverConfig))
diff --git a/core/src/test/scala/integration/kafka/api/LogAppendTimeTest.scala b/core/src/test/scala/integration/kafka/api/LogAppendTimeTest.scala
new file mode 100644
index 0000000000000..c63db6f1541e0
--- /dev/null
+++ b/core/src/test/scala/integration/kafka/api/LogAppendTimeTest.scala
@@ -0,0 +1,87 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package kafka.api
+
+import java.util.Collections
+import java.util.concurrent.TimeUnit
+
+import kafka.server.KafkaConfig
+import kafka.utils.TestUtils
+import org.apache.kafka.clients.consumer.ConsumerRecord
+import org.apache.kafka.clients.producer.ProducerRecord
+import org.apache.kafka.common.record.TimestampType
+import org.junit.{Before, Test}
+import org.junit.Assert.{assertEquals, assertNotEquals, assertTrue}
+
+import scala.collection.JavaConverters._
+import scala.collection.mutable.ArrayBuffer
+
+/**
+  * Tests where the broker is configured to use LogAppendTime. For tests where LogAppendTime is configured via topic
+  * level configs, see the *ProducerSendTest classes.
+  */
+class LogAppendTimeTest extends IntegrationTestHarness {
+  val producerCount: Int = 1
+  val consumerCount: Int = 1
+  val serverCount: Int = 2
+
+  // This will be used for the offsets topic as well
+  serverConfig.put(KafkaConfig.LogMessageTimestampTypeProp, TimestampType.LOG_APPEND_TIME.name)
+  serverConfig.put(KafkaConfig.OffsetsTopicPartitionsProp, "1")
+  serverConfig.put(KafkaConfig.OffsetsTopicReplicationFactorProp, "2")
+
+  private val topic = "topic"
+
+  @Before
+  override def setUp() {
+    super.setUp()
+    TestUtils.createTopic(zkUtils, topic, servers = servers)
+  }
+
+  @Test
+  def testProduceConsume() {
+    val producer = producers.head
+    val now = System.currentTimeMillis()
+    val createTime = now - TimeUnit.DAYS.toMillis(1)
+    val producerRecords = (1 to 10).map(i => new ProducerRecord(topic, null, createTime, s"key$i".getBytes,
+      s"value$i".getBytes))
+    val recordMetadatas = producerRecords.map(producer.send).map(_.get(10, TimeUnit.SECONDS))
+    recordMetadatas.foreach { recordMetadata =>
+      assertTrue(recordMetadata.timestamp >= now)
+      assertTrue(recordMetadata.timestamp < now + TimeUnit.SECONDS.toMillis(60))
+    }
+
+    val consumer = consumers.head
+    consumer.subscribe(Collections.singleton(topic))
+    val consumerRecords = new ArrayBuffer[ConsumerRecord[Array[Byte], Array[Byte]]]
+    TestUtils.waitUntilTrue(() => {
+      consumerRecords ++= consumer.poll(50).asScala
+      consumerRecords.size == producerRecords.size
+    }, s"Consumed ${consumerRecords.size} records until timeout instead of the expected ${producerRecords.size} records")
+
+    consumerRecords.zipWithIndex.foreach { case (consumerRecord, index) =>
+      val producerRecord = producerRecords(index)
+      val recordMetadata = recordMetadatas(index)
+      assertEquals(new String(producerRecord.key), new String(consumerRecord.key))
+      assertEquals(new String(producerRecord.value), new String(consumerRecord.value))
+      assertNotEquals(producerRecord.timestamp, consumerRecord.timestamp)
+      assertEquals(recordMetadata.timestamp, consumerRecord.timestamp)
+      assertEquals(TimestampType.LOG_APPEND_TIME, consumerRecord.timestampType)
+    }
+  }
+
+}
diff --git a/core/src/test/scala/unit/kafka/coordinator/GroupCoordinatorResponseTest.scala b/core/src/test/scala/unit/kafka/coordinator/GroupCoordinatorResponseTest.scala
index 11f91021a133f..f394369a76142 100644
--- a/core/src/test/scala/unit/kafka/coordinator/GroupCoordinatorResponseTest.scala
+++ b/core/src/test/scala/unit/kafka/coordinator/GroupCoordinatorResponseTest.scala
@@ -305,8 +305,7 @@ class GroupCoordinatorResponseTest extends JUnitSuite {
 
     EasyMock.reset(replicaManager)
     EasyMock.expect(replicaManager.getPartition(new TopicPartition(Topic.GroupMetadataTopicName, groupPartitionId))).andReturn(None)
-    EasyMock.expect(replicaManager.getMagicAndTimestampType(EasyMock.anyObject()))
-      .andReturn(Some(Record.MAGIC_VALUE_V1, TimestampType.CREATE_TIME)).anyTimes()
+    EasyMock.expect(replicaManager.getMagic(EasyMock.anyObject())).andReturn(Some(Record.MAGIC_VALUE_V1)).anyTimes()
     EasyMock.replay(replicaManager)
 
     timer.advanceClock(DefaultSessionTimeout + 100)
@@ -1055,8 +1054,7 @@ class GroupCoordinatorResponseTest extends JUnitSuite {
           new PartitionResponse(Errors.NONE, 0L, Record.NO_TIMESTAMP)
         )
       )})
-    EasyMock.expect(replicaManager.getMagicAndTimestampType(EasyMock.anyObject()))
-      .andReturn(Some(Record.MAGIC_VALUE_V1, TimestampType.CREATE_TIME)).anyTimes()
+    EasyMock.expect(replicaManager.getMagic(EasyMock.anyObject())).andReturn(Some(Record.MAGIC_VALUE_V1)).anyTimes()
     EasyMock.replay(replicaManager)
 
     groupCoordinator.handleSyncGroup(groupId, generation, leaderId, assignment, responseCallback)
@@ -1137,8 +1135,7 @@ class GroupCoordinatorResponseTest extends JUnitSuite {
           new PartitionResponse(Errors.NONE, 0L, Record.NO_TIMESTAMP)
         )
       )})
-    EasyMock.expect(replicaManager.getMagicAndTimestampType(EasyMock.anyObject()))
-      .andReturn(Some(Record.MAGIC_VALUE_V1, TimestampType.CREATE_TIME)).anyTimes()
+    EasyMock.expect(replicaManager.getMagic(EasyMock.anyObject())).andReturn(Some(Record.MAGIC_VALUE_V1)).anyTimes()
     EasyMock.replay(replicaManager)
 
     groupCoordinator.handleCommitOffsets(groupId, consumerId, generationId, offsets, responseCallback)
@@ -1149,8 +1146,7 @@ class GroupCoordinatorResponseTest extends JUnitSuite {
     val (responseFuture, responseCallback) = setupHeartbeatCallback
 
     EasyMock.expect(replicaManager.getPartition(new TopicPartition(Topic.GroupMetadataTopicName, groupPartitionId))).andReturn(None)
-    EasyMock.expect(replicaManager.getMagicAndTimestampType(EasyMock.anyObject()))
-      .andReturn(Some(Record.MAGIC_VALUE_V1, TimestampType.CREATE_TIME)).anyTimes()
+    EasyMock.expect(replicaManager.getMagic(EasyMock.anyObject())).andReturn(Some(Record.MAGIC_VALUE_V1)).anyTimes()
     EasyMock.replay(replicaManager)
 
     groupCoordinator.handleLeaveGroup(groupId, consumerId, responseCallback)
diff --git a/core/src/test/scala/unit/kafka/coordinator/GroupMetadataManagerTest.scala b/core/src/test/scala/unit/kafka/coordinator/GroupMetadataManagerTest.scala
index 30dfc6366c4d0..a4c3448c4ac03 100644
--- a/core/src/test/scala/unit/kafka/coordinator/GroupMetadataManagerTest.scala
+++ b/core/src/test/scala/unit/kafka/coordinator/GroupMetadataManagerTest.scala
@@ -321,7 +321,7 @@ class GroupMetadataManagerTest {
 
   @Test
   def testStoreNonEmptyGroupWhenCoordinatorHasMoved() {
-    EasyMock.expect(replicaManager.getMagicAndTimestampType(EasyMock.anyObject())).andReturn(None)
+    EasyMock.expect(replicaManager.getMagic(EasyMock.anyObject())).andReturn(None)
     val memberId = "memberId"
     val clientId = "clientId"
     val clientHost = "localhost"
@@ -390,7 +390,7 @@ class GroupMetadataManagerTest {
 
   @Test
   def testCommitOffsetWhenCoordinatorHasMoved() {
-    EasyMock.expect(replicaManager.getMagicAndTimestampType(EasyMock.anyObject())).andReturn(None)
+    EasyMock.expect(replicaManager.getMagic(EasyMock.anyObject())).andReturn(None)
     val memberId = ""
     val generationId = -1
     val topicPartition = new TopicPartition("foo", 0)
@@ -538,8 +538,7 @@ class GroupMetadataManagerTest {
     EasyMock.reset(partition)
     val recordsCapture: Capture[MemoryRecords] = EasyMock.newCapture()
 
-    EasyMock.expect(replicaManager.getMagicAndTimestampType(EasyMock.anyObject()))
-      .andStubReturn(Some(Record.MAGIC_VALUE_V1, TimestampType.CREATE_TIME))
+    EasyMock.expect(replicaManager.getMagic(EasyMock.anyObject())).andStubReturn(Some(Record.MAGIC_VALUE_V1))
     EasyMock.expect(replicaManager.getPartition(new TopicPartition(Topic.GroupMetadataTopicName, groupPartitionId))).andStubReturn(Some(partition))
     EasyMock.expect(partition.appendRecordsToLeader(EasyMock.capture(recordsCapture), EasyMock.anyInt()))
       .andReturn(LogAppendInfo.UnknownLogAppendInfo)
@@ -584,8 +583,7 @@ class GroupMetadataManagerTest {
     EasyMock.reset(partition)
     val recordsCapture: Capture[MemoryRecords] = EasyMock.newCapture()
 
-    EasyMock.expect(replicaManager.getMagicAndTimestampType(EasyMock.anyObject()))
-      .andStubReturn(Some(Record.MAGIC_VALUE_V1, TimestampType.LOG_APPEND_TIME))
+    EasyMock.expect(replicaManager.getMagic(EasyMock.anyObject())).andStubReturn(Some(Record.MAGIC_VALUE_V1))
     EasyMock.expect(replicaManager.getPartition(new TopicPartition(Topic.GroupMetadataTopicName, groupPartitionId))).andStubReturn(Some(partition))
     EasyMock.expect(partition.appendRecordsToLeader(EasyMock.capture(recordsCapture), EasyMock.anyInt()))
       .andReturn(LogAppendInfo.UnknownLogAppendInfo)
@@ -602,7 +600,8 @@ class GroupMetadataManagerTest {
     assertTrue(metadataTombstone.hasKey)
     assertTrue(metadataTombstone.hasNullValue)
     assertEquals(Record.MAGIC_VALUE_V1, metadataTombstone.magic)
-    assertEquals(TimestampType.LOG_APPEND_TIME, metadataTombstone.timestampType)
+    // Use CREATE_TIME, like the producer. The conversion to LOG_APPEND_TIME (if necessary) happens automatically.
+    assertEquals(TimestampType.CREATE_TIME, metadataTombstone.timestampType)
     assertTrue(metadataTombstone.timestamp > 0)
 
     val groupKey = GroupMetadataManager.readMessageKey(metadataTombstone.key).asInstanceOf[GroupMetadataKey]
@@ -762,8 +761,7 @@ class GroupMetadataManagerTest {
           new PartitionResponse(error, 0L, Record.NO_TIMESTAMP)
         )
       )})
-    EasyMock.expect(replicaManager.getMagicAndTimestampType(EasyMock.anyObject()))
-      .andStubReturn(Some(Record.MAGIC_VALUE_V1, TimestampType.CREATE_TIME))
+    EasyMock.expect(replicaManager.getMagic(EasyMock.anyObject())).andStubReturn(Some(Record.MAGIC_VALUE_V1))
   }
 
   private def buildStableGroupRecordWithMember(memberId: String): Record = {
diff --git a/core/src/test/scala/unit/kafka/integration/KafkaServerTestHarness.scala b/core/src/test/scala/unit/kafka/integration/KafkaServerTestHarness.scala
index 081bdff5b95ce..3534d96152746 100755
--- a/core/src/test/scala/unit/kafka/integration/KafkaServerTestHarness.scala
+++ b/core/src/test/scala/unit/kafka/integration/KafkaServerTestHarness.scala
@@ -47,7 +47,7 @@ trait KafkaServerTestHarness extends ZooKeeperTestHarness {
    * Implementations must override this method to return a set of KafkaConfigs. This method will be invoked for every
    * test and should not reuse previous configurations unless they select their ports randomly when servers are started.
    */
-  def generateConfigs(): Seq[KafkaConfig]
+  def generateConfigs: Seq[KafkaConfig]
 
   /**
    * Override this in case ACLs or security credentials must be set before `servers` are started.
@@ -64,7 +64,7 @@ trait KafkaServerTestHarness extends ZooKeeperTestHarness {
 
   def configs: Seq[KafkaConfig] = {
     if (instanceConfigs == null)
-      instanceConfigs = generateConfigs()
+      instanceConfigs = generateConfigs
     instanceConfigs
   }
 

From f9660e16dafb9e1109704bdecb978b7046f0cc6b Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno@confluent.io>
Date: Fri, 10 Mar 2017 13:43:04 -0800
Subject: [PATCH 128/177] MINOR: increase RocksDb parallelism

Author: Eno Thereska <eno@confluent.io>
Author: Eno Thereska <eno.thereska@gmail.com>

Reviewers: Damian Guy, Guozhang Wang

Closes #2663 from enothereska/minor-rocksdb-parallel

(cherry picked from commit 0011a3dc337a41ceb21b1567db7bdc3219a07552)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../apache/kafka/streams/state/internals/RocksDBStore.java  | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
index 5c83ddfc6045c..6bb14ddbeaff0 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
@@ -35,6 +35,7 @@
 import org.rocksdb.CompactionStyle;
 import org.rocksdb.CompressionType;
 import org.rocksdb.FlushOptions;
+import org.rocksdb.InfoLogLevel;
 import org.rocksdb.Options;
 import org.rocksdb.RocksDB;
 import org.rocksdb.RocksDBException;
@@ -120,6 +121,11 @@ public void openDB(ProcessorContext context) {
         options.setMaxWriteBufferNumber(MAX_WRITE_BUFFERS);
         options.setCreateIfMissing(true);
         options.setErrorIfExists(false);
+        options.setInfoLogLevel(InfoLogLevel.ERROR_LEVEL);
+        // this is the recommended way to increase parallelism in RocksDb
+        // note that the current implementation increases the number of compaction threads
+        // but not flush threads.
+        options.setIncreaseParallelism(Runtime.getRuntime().availableProcessors());
 
         wOptions = new WriteOptions();
         wOptions.setDisableWAL(true);

From 928789bf743bb96e232fb0a2ed789cc05d2787ca Mon Sep 17 00:00:00 2001
From: Aaron Coburn <acoburn@amherst.edu>
Date: Fri, 10 Mar 2017 16:48:48 -0800
Subject: [PATCH 129/177] MINOR: incorrect javadoc formatting

When wrapped in a `{code ...}` block, `&lt;&gt;` are not formatted as `<>`.

For instance, see the formatting of the example in https://kafka.apache.org/0102/javadoc/org/apache/kafka/streams/KafkaStreams.html

Author: Aaron Coburn <acoburn@amherst.edu>

Reviewers: Matthias J. Sax, Guozhang Wang

Closes #2671 from acoburn/javadoc_formatting

(cherry picked from commit 046519d0714591785cd984ab2d57e193b54a2f19)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../src/main/java/org/apache/kafka/streams/KafkaStreams.java  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java b/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
index a13626c77d565..68157b7ee4ee2 100644
--- a/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
+++ b/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
@@ -97,7 +97,7 @@
  * <p>
  * A simple example might look like this:
  * <pre>{@code
- * Map&lt;String, Object&gt; props = new HashMap&lt;&gt;();
+ * Map<String, Object> props = new HashMap<>();
  * props.put(StreamsConfig.APPLICATION_ID_CONFIG, "my-stream-processing-application");
  * props.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, "localhost:9092");
  * props.put(StreamsConfig.KEY_SERDE_CLASS_CONFIG, Serdes.String().getClass());
@@ -105,7 +105,7 @@
  * StreamsConfig config = new StreamsConfig(props);
  *
  * KStreamBuilder builder = new KStreamBuilder();
- * builder.stream("my-input-topic").mapValues(value -&gt; value.length().toString()).to("my-output-topic");
+ * builder.stream("my-input-topic").mapValues(value -> value.length().toString()).to("my-output-topic");
  *
  * KafkaStreams streams = new KafkaStreams(builder, config);
  * streams.start();

From 94938f3734c71c69fe14612052ca16ecc0205d4d Mon Sep 17 00:00:00 2001
From: Rajini Sivaram <rajinisivaram@googlemail.com>
Date: Thu, 2 Mar 2017 17:49:01 -0800
Subject: [PATCH 130/177] KAFKA-4631; Request metadata in consumer if
 topic/partitions unavailable

If leader node of one more more partitions in a consumer subscription are temporarily unavailable, request metadata refresh so that partitions skipped for assignment dont have to wait for metadata expiry before reassignment. Metadata refresh is also requested if a subscribe topic or assigned partition doesn't exist.

Author: Rajini Sivaram <rajinisivaram@googlemail.com>

Reviewers: Vahid Hashemian <vahidhashemian@us.ibm.com>, Ismael Juma <ismael@juma.me.uk>, Jason Gustafson <jason@confluent.io>

Closes #2622 from rajinisivaram/KAFKA-4631
---
 .../org/apache/kafka/clients/Metadata.java    | 18 +++-
 .../apache/kafka/clients/NetworkClient.java   |  2 +-
 .../kafka/clients/consumer/KafkaConsumer.java |  2 +-
 .../internals/ConsumerCoordinator.java        |  6 +-
 .../kafka/clients/producer/KafkaProducer.java |  2 +-
 .../common/requests/MetadataResponse.java     | 24 +++++
 .../apache/kafka/clients/MetadataTest.java    | 66 ++++++-------
 .../org/apache/kafka/clients/MockClient.java  | 33 +++++--
 .../kafka/clients/NetworkClientTest.java      |  2 +-
 .../clients/consumer/KafkaConsumerTest.java   | 38 ++++----
 .../internals/AbstractCoordinatorTest.java    |  2 +-
 .../internals/ConsumerCoordinatorTest.java    | 94 +++++++++++++++----
 .../consumer/internals/FetcherTest.java       |  4 +-
 .../producer/internals/SenderTest.java        | 14 +--
 .../distributed/WorkerGroupMember.java        |  3 +-
 .../distributed/WorkerCoordinatorTest.java    |  2 +-
 .../main/scala/kafka/admin/AdminClient.scala  |  2 +-
 .../kafka/api/ConsumerBounceTest.scala        | 59 +++++++++++-
 .../internals/StreamsKafkaClient.java         |  4 +-
 19 files changed, 270 insertions(+), 107 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/Metadata.java b/clients/src/main/java/org/apache/kafka/clients/Metadata.java
index 75d48abf247ac..428684d4b45f3 100644
--- a/clients/src/main/java/org/apache/kafka/clients/Metadata.java
+++ b/clients/src/main/java/org/apache/kafka/clients/Metadata.java
@@ -195,8 +195,13 @@ public synchronized boolean containsTopic(String topic) {
     /**
      * Updates the cluster metadata. If topic expiry is enabled, expiry time
      * is set for topics if required and expired topics are removed from the metadata.
+     *
+     * @param cluster the cluster containing metadata for topics with valid metadata
+     * @param unavailableTopics topics which are non-existent or have one or more partitions whose
+     *        leader is not known
+     * @param now current time in milliseconds
      */
-    public synchronized void update(Cluster cluster, long now) {
+    public synchronized void update(Cluster cluster, Set<String> unavailableTopics, long now) {
         Objects.requireNonNull(cluster, "cluster should not be null");
 
         this.needUpdate = false;
@@ -219,7 +224,7 @@ else if (expireMs <= now) {
         }
 
         for (Listener listener: listeners)
-            listener.onMetadataUpdate(cluster);
+            listener.onMetadataUpdate(cluster, unavailableTopics);
 
         String previousClusterId = cluster.clusterResource().clusterId();
 
@@ -302,7 +307,14 @@ public synchronized void removeListener(Listener listener) {
      * MetadataUpdate Listener
      */
     public interface Listener {
-        void onMetadataUpdate(Cluster cluster);
+        /**
+         * Callback invoked on metadata update.
+         *
+         * @param cluster the cluster containing metadata for topics with valid metadata
+         * @param unavailableTopics topics which are non-existent or have one or more partitions whose
+         *        leader is not known
+         */
+        void onMetadataUpdate(Cluster cluster, Set<String> unavailableTopics);
     }
 
     private synchronized void requestUpdateForNewTopics() {
diff --git a/clients/src/main/java/org/apache/kafka/clients/NetworkClient.java b/clients/src/main/java/org/apache/kafka/clients/NetworkClient.java
index 3a7528822e7cc..1e8dbd37c99c5 100644
--- a/clients/src/main/java/org/apache/kafka/clients/NetworkClient.java
+++ b/clients/src/main/java/org/apache/kafka/clients/NetworkClient.java
@@ -709,7 +709,7 @@ public void handleCompletedMetadataResponse(RequestHeader requestHeader, long no
             // don't update the cluster if there are no valid nodes...the topic we want may still be in the process of being
             // created which means we will get errors and no nodes until it exists
             if (cluster.nodes().size() > 0) {
-                this.metadata.update(cluster, now);
+                this.metadata.update(cluster, response.unavailableTopics(), now);
             } else {
                 log.trace("Ignoring empty metadata response with correlation id {}.", requestHeader.correlationId());
                 this.metadata.failedUpdate(now);
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
index eac95791a0aff..64d64ba639f84 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/KafkaConsumer.java
@@ -652,7 +652,7 @@ private KafkaConsumer(ConsumerConfig config,
             ClusterResourceListeners clusterResourceListeners = configureClusterResourceListeners(keyDeserializer, valueDeserializer, reporters, interceptorList);
             this.metadata = new Metadata(retryBackoffMs, config.getLong(ConsumerConfig.METADATA_MAX_AGE_CONFIG), false, clusterResourceListeners);
             List<InetSocketAddress> addresses = ClientUtils.parseAndValidateAddresses(config.getList(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG));
-            this.metadata.update(Cluster.bootstrap(addresses), 0);
+            this.metadata.update(Cluster.bootstrap(addresses), Collections.<String>emptySet(), 0);
             String metricGrpPrefix = "consumer";
             ChannelBuilder channelBuilder = ClientUtils.createChannelBuilder(config.values());
             NetworkClient netClient = new NetworkClient(
diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java
index 8669527cd2024..2e37636af4466 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinator.java
@@ -49,6 +49,7 @@
 
 import java.nio.ByteBuffer;
 import java.util.ArrayList;
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.HashSet;
 import java.util.List;
@@ -168,7 +169,7 @@ public void updatePatternSubscription(Cluster cluster) {
     private void addMetadataListener() {
         this.metadata.addListener(new Metadata.Listener() {
             @Override
-            public void onMetadataUpdate(Cluster cluster) {
+            public void onMetadataUpdate(Cluster cluster, Set<String> unavailableTopics) {
                 // if we encounter any unauthorized topics, raise an exception to the user
                 if (!cluster.unauthorizedTopics().isEmpty())
                     throw new TopicAuthorizationException(new HashSet<>(cluster.unauthorizedTopics()));
@@ -182,6 +183,9 @@ public void onMetadataUpdate(Cluster cluster) {
                     if (!snapshot.equals(metadataSnapshot))
                         metadataSnapshot = snapshot;
                 }
+
+                if (!Collections.disjoint(metadata.topics(), unavailableTopics))
+                    metadata.requestUpdate();
             }
         });
     }
diff --git a/clients/src/main/java/org/apache/kafka/clients/producer/KafkaProducer.java b/clients/src/main/java/org/apache/kafka/clients/producer/KafkaProducer.java
index 29defbbe2a787..6f1a3b64a7b8a 100644
--- a/clients/src/main/java/org/apache/kafka/clients/producer/KafkaProducer.java
+++ b/clients/src/main/java/org/apache/kafka/clients/producer/KafkaProducer.java
@@ -301,7 +301,7 @@ private KafkaProducer(ProducerConfig config, Serializer<K> keySerializer, Serial
                     time);
 
             List<InetSocketAddress> addresses = ClientUtils.parseAndValidateAddresses(config.getList(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG));
-            this.metadata.update(Cluster.bootstrap(addresses), time.milliseconds());
+            this.metadata.update(Cluster.bootstrap(addresses), Collections.<String>emptySet(), time.milliseconds());
             ChannelBuilder channelBuilder = ClientUtils.createChannelBuilder(config.values());
             NetworkClient client = new NetworkClient(
                     new Selector(config.getLong(ProducerConfig.CONNECTIONS_MAX_IDLE_MS_CONFIG), this.metrics, time, "producer", channelBuilder),
diff --git a/clients/src/main/java/org/apache/kafka/common/requests/MetadataResponse.java b/clients/src/main/java/org/apache/kafka/common/requests/MetadataResponse.java
index a8baee52f3a08..7209db5304526 100644
--- a/clients/src/main/java/org/apache/kafka/common/requests/MetadataResponse.java
+++ b/clients/src/main/java/org/apache/kafka/common/requests/MetadataResponse.java
@@ -15,6 +15,7 @@
 import org.apache.kafka.common.Cluster;
 import org.apache.kafka.common.Node;
 import org.apache.kafka.common.PartitionInfo;
+import org.apache.kafka.common.errors.InvalidMetadataException;
 import org.apache.kafka.common.protocol.ApiKeys;
 import org.apache.kafka.common.protocol.Errors;
 import org.apache.kafka.common.protocol.ProtoUtils;
@@ -261,6 +262,29 @@ public Set<String> topicsByError(Errors error) {
         return errorTopics;
     }
 
+    /**
+     * Returns the set of topics with an error indicating invalid metadata
+     * and topics with any partition whose error indicates invalid metadata.
+     * This includes all non-existent topics specified in the metadata request
+     * and any topic returned with one or more partitions whose leader is not known.
+     */
+    public Set<String> unavailableTopics() {
+        Set<String> invalidMetadataTopics = new HashSet<>();
+        for (TopicMetadata topicMetadata : this.topicMetadata) {
+            if (topicMetadata.error.exception() instanceof InvalidMetadataException)
+                invalidMetadataTopics.add(topicMetadata.topic);
+            else {
+                for (PartitionMetadata partitionMetadata : topicMetadata.partitionMetadata) {
+                    if (partitionMetadata.error.exception() instanceof InvalidMetadataException) {
+                        invalidMetadataTopics.add(topicMetadata.topic);
+                        break;
+                    }
+                }
+            }
+        }
+        return invalidMetadataTopics;
+    }
+
     /**
      * Get a snapshot of the cluster metadata from this response
      * @return the cluster snapshot
diff --git a/clients/src/test/java/org/apache/kafka/clients/MetadataTest.java b/clients/src/test/java/org/apache/kafka/clients/MetadataTest.java
index cfd2a941eb9f5..db88b77d3b5b5 100644
--- a/clients/src/test/java/org/apache/kafka/clients/MetadataTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/MetadataTest.java
@@ -52,7 +52,7 @@ public void tearDown() {
     @Test
     public void testMetadata() throws Exception {
         long time = 0;
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
         assertFalse("No update needed.", metadata.timeToNextUpdate(time) == 0);
         metadata.requestUpdate();
         assertFalse("Still no updated needed due to backoff", metadata.timeToNextUpdate(time) == 0);
@@ -67,7 +67,7 @@ public void testMetadata() throws Exception {
         // This simulates the metadata update sequence in KafkaProducer
         while (t1.isAlive() || t2.isAlive()) {
             if (metadata.timeToNextUpdate(time) == 0) {
-                metadata.update(TestUtils.singletonCluster(topic, 1), time);
+                metadata.update(TestUtils.singletonCluster(topic, 1), Collections.<String>emptySet(), time);
                 time += refreshBackoffMs;
             }
             Thread.sleep(1);
@@ -97,7 +97,7 @@ private static void checkTimeToNextUpdate(long refreshBackoffMs, long metadataEx
         assertEquals(0, metadata.timeToNextUpdate(now));
 
         // lastSuccessfulRefreshMs updated to now.
-        metadata.update(Cluster.empty(), now);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), now);
 
         // The last update was successful so the remaining time to expire the current metadata should be returned.
         assertEquals(largerOfBackoffAndExpire, metadata.timeToNextUpdate(now));
@@ -108,7 +108,7 @@ private static void checkTimeToNextUpdate(long refreshBackoffMs, long metadataEx
         assertEquals(refreshBackoffMs, metadata.timeToNextUpdate(now));
 
         // Reset needUpdate to false.
-        metadata.update(Cluster.empty(), now);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), now);
         assertEquals(largerOfBackoffAndExpire, metadata.timeToNextUpdate(now));
 
         // Both metadataExpireMs and refreshBackoffMs elapsed.
@@ -152,13 +152,13 @@ public void testTimeToNextUpdate_OverwriteBackoff() {
         long now = 10000;
 
         // New topic added to fetch set and update requested. It should allow immediate update.
-        metadata.update(Cluster.empty(), now);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), now);
         metadata.add("new-topic");
         assertEquals(0, metadata.timeToNextUpdate(now));
 
         // Even though setTopics called, immediate update isn't necessary if the new topic set isn't
         // containing a new topic,
-        metadata.update(Cluster.empty(), now);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), now);
         metadata.setTopics(metadata.topics());
         assertEquals(metadataExpireMs, metadata.timeToNextUpdate(now));
 
@@ -167,12 +167,12 @@ public void testTimeToNextUpdate_OverwriteBackoff() {
         assertEquals(0, metadata.timeToNextUpdate(now));
 
         // If metadata requested for all topics it should allow immediate update.
-        metadata.update(Cluster.empty(), now);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), now);
         metadata.needMetadataForAllTopics(true);
         assertEquals(0, metadata.timeToNextUpdate(now));
 
         // However if metadata is already capable to serve all topics it shouldn't override backoff.
-        metadata.update(Cluster.empty(), now);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), now);
         metadata.needMetadataForAllTopics(true);
         assertEquals(metadataExpireMs, metadata.timeToNextUpdate(now));
     }
@@ -187,7 +187,7 @@ public void testTimeToNextUpdate_OverwriteBackoff() {
     @Test
     public void testMetadataUpdateWaitTime() throws Exception {
         long time = 0;
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
         assertFalse("No update needed.", metadata.timeToNextUpdate(time) == 0);
         // first try with a max wait time of 0 and ensure that this returns back without waiting forever
         try {
@@ -209,7 +209,7 @@ public void testMetadataUpdateWaitTime() throws Exception {
     @Test
     public void testFailedUpdate() {
         long time = 100;
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
 
         assertEquals(100, metadata.timeToNextUpdate(1000));
         metadata.failedUpdate(1100);
@@ -218,14 +218,14 @@ public void testFailedUpdate() {
         assertEquals(100, metadata.lastSuccessfulUpdate());
 
         metadata.needMetadataForAllTopics(true);
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
         assertEquals(100, metadata.timeToNextUpdate(1000));
     }
 
     @Test
     public void testUpdateWithNeedMetadataForAllTopics() {
         long time = 0;
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
         metadata.needMetadataForAllTopics(true);
 
         final List<String> expectedTopics = Collections.singletonList("topic");
@@ -237,7 +237,7 @@ public void testUpdateWithNeedMetadataForAllTopics() {
                     new PartitionInfo("topic1", 0, null, null, null)),
                 Collections.<String>emptySet(),
                 Collections.<String>emptySet()),
-            100);
+            Collections.<String>emptySet(), 100);
 
         assertArrayEquals("Metadata got updated with wrong set of topics.",
             expectedTopics.toArray(), metadata.topics().toArray());
@@ -255,7 +255,7 @@ public void testClusterListenerGetsNotifiedOfUpdate() {
 
         String hostName = "www.example.com";
         Cluster cluster = Cluster.bootstrap(Arrays.asList(new InetSocketAddress(hostName, 9002)));
-        metadata.update(cluster, time);
+        metadata.update(cluster, Collections.<String>emptySet(), time);
         assertFalse("ClusterResourceListener should not called when metadata is updated with bootstrap Cluster",
                 MockClusterResourceListener.IS_ON_UPDATE_CALLED.get());
 
@@ -267,7 +267,7 @@ public void testClusterListenerGetsNotifiedOfUpdate() {
                                 new PartitionInfo("topic1", 0, null, null, null)),
                         Collections.<String>emptySet(),
                         Collections.<String>emptySet()),
-                100);
+                Collections.<String>emptySet(), 100);
 
         assertEquals("MockClusterResourceListener did not get cluster metadata correctly",
                 "dummy", mockClusterListener.clusterResource().clusterId());
@@ -279,10 +279,10 @@ public void testClusterListenerGetsNotifiedOfUpdate() {
     public void testListenerGetsNotifiedOfUpdate() {
         long time = 0;
         final Set<String> topics = new HashSet<>();
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
         metadata.addListener(new Metadata.Listener() {
             @Override
-            public void onMetadataUpdate(Cluster cluster) {
+            public void onMetadataUpdate(Cluster cluster, Set<String> unavailableTopics) {
                 topics.clear();
                 topics.addAll(cluster.topics());
             }
@@ -296,7 +296,7 @@ public void onMetadataUpdate(Cluster cluster) {
                     new PartitionInfo("topic1", 0, null, null, null)),
                 Collections.<String>emptySet(),
                 Collections.<String>emptySet()),
-            100);
+            Collections.<String>emptySet(), 100);
 
         assertEquals("Listener did not update topics list correctly",
             new HashSet<>(Arrays.asList("topic", "topic1")), topics);
@@ -306,10 +306,10 @@ public void onMetadataUpdate(Cluster cluster) {
     public void testListenerCanUnregister() {
         long time = 0;
         final Set<String> topics = new HashSet<>();
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
         final Metadata.Listener listener = new Metadata.Listener() {
             @Override
-            public void onMetadataUpdate(Cluster cluster) {
+            public void onMetadataUpdate(Cluster cluster, Set<String> unavailableTopics) {
                 topics.clear();
                 topics.addAll(cluster.topics());
             }
@@ -324,7 +324,7 @@ public void onMetadataUpdate(Cluster cluster) {
                     new PartitionInfo("topic1", 0, null, null, null)),
                 Collections.<String>emptySet(),
                 Collections.<String>emptySet()),
-            100);
+            Collections.<String>emptySet(), 100);
 
         metadata.removeListener(listener);
 
@@ -336,7 +336,7 @@ public void onMetadataUpdate(Cluster cluster) {
                     new PartitionInfo("topic3", 0, null, null, null)),
                 Collections.<String>emptySet(),
                 Collections.<String>emptySet()),
-            100);
+            Collections.<String>emptySet(), 100);
 
         assertEquals("Listener did not update topics list correctly",
             new HashSet<>(Arrays.asList("topic", "topic1")), topics);
@@ -349,17 +349,17 @@ public void testTopicExpiry() throws Exception {
         // Test that topic is expired if not used within the expiry interval
         long time = 0;
         metadata.add("topic1");
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
         time += Metadata.TOPIC_EXPIRY_MS;
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
         assertFalse("Unused topic not expired", metadata.containsTopic("topic1"));
 
         // Test that topic is not expired if used within the expiry interval
         metadata.add("topic2");
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
         for (int i = 0; i < 3; i++) {
             time += Metadata.TOPIC_EXPIRY_MS / 2;
-            metadata.update(Cluster.empty(), time);
+            metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
             assertTrue("Topic expired even though in use", metadata.containsTopic("topic2"));
             metadata.add("topic2");
         }
@@ -368,9 +368,9 @@ public void testTopicExpiry() throws Exception {
         HashSet<String> topics = new HashSet<>();
         topics.add("topic4");
         metadata.setTopics(topics);
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
         time += Metadata.TOPIC_EXPIRY_MS;
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
         assertFalse("Unused topic not expired", metadata.containsTopic("topic4"));
     }
 
@@ -381,17 +381,17 @@ public void testNonExpiringMetadata() throws Exception {
         // Test that topic is not expired if not used within the expiry interval
         long time = 0;
         metadata.add("topic1");
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
         time += Metadata.TOPIC_EXPIRY_MS;
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
         assertTrue("Unused topic expired when expiry disabled", metadata.containsTopic("topic1"));
 
         // Test that topic is not expired if used within the expiry interval
         metadata.add("topic2");
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
         for (int i = 0; i < 3; i++) {
             time += Metadata.TOPIC_EXPIRY_MS / 2;
-            metadata.update(Cluster.empty(), time);
+            metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
             assertTrue("Topic expired even though in use", metadata.containsTopic("topic2"));
             metadata.add("topic2");
         }
@@ -401,7 +401,7 @@ public void testNonExpiringMetadata() throws Exception {
         topics.add("topic4");
         metadata.setTopics(topics);
         time += metadataExpireMs * 2;
-        metadata.update(Cluster.empty(), time);
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time);
         assertTrue("Unused topic expired when expiry disabled", metadata.containsTopic("topic4"));
     }
 
diff --git a/clients/src/test/java/org/apache/kafka/clients/MockClient.java b/clients/src/test/java/org/apache/kafka/clients/MockClient.java
index 50ed1319cdac3..df29f312e8265 100644
--- a/clients/src/test/java/org/apache/kafka/clients/MockClient.java
+++ b/clients/src/test/java/org/apache/kafka/clients/MockClient.java
@@ -26,6 +26,7 @@
 
 import java.util.ArrayDeque;
 import java.util.ArrayList;
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.HashSet;
 import java.util.Iterator;
@@ -63,6 +64,7 @@ public FutureResponse(AbstractResponse responseBody, boolean disconnected, Reque
 
     private final Time time;
     private final Metadata metadata;
+    private Set<String> unavailableTopics;
     private int correlation = 0;
     private Node node = null;
     private final Set<String> ready = new HashSet<>();
@@ -72,17 +74,17 @@ public FutureResponse(AbstractResponse responseBody, boolean disconnected, Reque
     // Use concurrent queue for responses so that responses may be updated during poll() from a different thread.
     private final Queue<ClientResponse> responses = new ConcurrentLinkedDeque<>();
     private final Queue<FutureResponse> futureResponses = new ArrayDeque<>();
-    private final Queue<Cluster> metadataUpdates = new ArrayDeque<>();
+    private final Queue<MetadataUpdate> metadataUpdates = new ArrayDeque<>();
     private volatile NodeApiVersions nodeApiVersions = NodeApiVersions.create();
 
     public MockClient(Time time) {
-        this.time = time;
-        this.metadata = null;
+        this(time, null);
     }
 
     public MockClient(Time time, Metadata metadata) {
         this.time = time;
         this.metadata = metadata;
+        this.unavailableTopics = Collections.emptySet();
     }
 
     @Override
@@ -167,11 +169,13 @@ public List<ClientResponse> poll(long timeoutMs, long now) {
         List<ClientResponse> copy = new ArrayList<>(this.responses);
 
         if (metadata != null && metadata.updateRequested()) {
-            Cluster cluster = metadataUpdates.poll();
-            if (cluster == null)
-                metadata.update(metadata.fetch(), time.milliseconds());
-            else
-                metadata.update(cluster, time.milliseconds());
+            MetadataUpdate metadataUpdate = metadataUpdates.poll();
+            if (metadataUpdate == null)
+                metadata.update(metadata.fetch(), this.unavailableTopics, time.milliseconds());
+            else {
+                this.unavailableTopics = metadataUpdate.unavailableTopics;
+                metadata.update(metadataUpdate.cluster, metadataUpdate.unavailableTopics, time.milliseconds());
+            }
         }
 
         while (!this.responses.isEmpty()) {
@@ -277,8 +281,8 @@ public void reset() {
         metadataUpdates.clear();
     }
 
-    public void prepareMetadataUpdate(Cluster cluster) {
-        metadataUpdates.add(cluster);
+    public void prepareMetadataUpdate(Cluster cluster, Set<String> unavailableTopics) {
+        metadataUpdates.add(new MetadataUpdate(cluster, unavailableTopics));
     }
 
     public void setNode(Node node) {
@@ -339,4 +343,13 @@ public interface RequestMatcher {
     public void setNodeApiVersions(NodeApiVersions nodeApiVersions) {
         this.nodeApiVersions = nodeApiVersions;
     }
+
+    private static class MetadataUpdate {
+        final Cluster cluster;
+        final Set<String> unavailableTopics;
+        MetadataUpdate(Cluster cluster, Set<String> unavailableTopics) {
+            this.cluster = cluster;
+            this.unavailableTopics = unavailableTopics;
+        }
+    }
 }
diff --git a/clients/src/test/java/org/apache/kafka/clients/NetworkClientTest.java b/clients/src/test/java/org/apache/kafka/clients/NetworkClientTest.java
index deaf2cc15e14e..a95af83b43e09 100644
--- a/clients/src/test/java/org/apache/kafka/clients/NetworkClientTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/NetworkClientTest.java
@@ -78,7 +78,7 @@ private NetworkClient createNetworkClientWithNoVersionDiscovery() {
 
     @Before
     public void setup() {
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
     }
 
     @Test(expected = IllegalStateException.class)
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
index 4aaa17230f957..f2905a9c97151 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/KafkaConsumerTest.java
@@ -364,7 +364,7 @@ public void verifyHeartbeatSent() throws Exception {
         Node node = cluster.nodes().get(0);
 
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         MockClient client = new MockClient(time, metadata);
         client.setNode(node);
@@ -405,7 +405,7 @@ public void verifyHeartbeatSentWhenFetchedDataReady() throws Exception {
         Node node = cluster.nodes().get(0);
 
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         MockClient client = new MockClient(time, metadata);
         client.setNode(node);
@@ -446,7 +446,7 @@ public void verifyNoCoordinatorLookupForManualAssignmentWithSeek() {
         Node node = cluster.nodes().get(0);
 
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         MockClient client = new MockClient(time, metadata);
         client.setNode(node);
@@ -482,7 +482,7 @@ public void testCommitsFetchedDuringAssign() {
         Node node = cluster.nodes().get(0);
 
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         MockClient client = new MockClient(time, metadata);
         client.setNode(node);
@@ -530,7 +530,7 @@ public void testAutoCommitSentBeforePositionUpdate() {
         Node node = cluster.nodes().get(0);
 
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         MockClient client = new MockClient(time, metadata);
         client.setNode(node);
@@ -591,7 +591,7 @@ public void testRegexSubscription() {
 
         consumer.subscribe(Pattern.compile(topic), getConsumerRebalanceListener(consumer));
 
-        client.prepareMetadataUpdate(cluster);
+        client.prepareMetadataUpdate(cluster, Collections.<String>emptySet());
 
         consumer.poll(0);
         assertEquals(singleton(topic), consumer.subscription());
@@ -622,7 +622,7 @@ public void testChangingRegexSubscription() {
         MockClient client = new MockClient(time, metadata);
         client.setNode(node);
 
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         final KafkaConsumer<String, String> consumer = newConsumer(time, client, metadata, assignor,
                 rebalanceTimeoutMs, sessionTimeoutMs, heartbeatIntervalMs, false, autoCommitIntervalMs);
@@ -630,14 +630,14 @@ public void testChangingRegexSubscription() {
         Node coordinator = prepareRebalance(client, node, singleton(topic), assignor, singletonList(tp0), null);
         consumer.subscribe(Pattern.compile(topic), getConsumerRebalanceListener(consumer));
 
-        client.prepareMetadataUpdate(cluster);
+        client.prepareMetadataUpdate(cluster, Collections.<String>emptySet());
 
         consumer.poll(0);
         assertEquals(singleton(topic), consumer.subscription());
 
         consumer.subscribe(Pattern.compile(otherTopic), getConsumerRebalanceListener(consumer));
 
-        client.prepareMetadataUpdate(cluster);
+        client.prepareMetadataUpdate(cluster, Collections.<String>emptySet());
 
         prepareRebalance(client, node, singleton(otherTopic), assignor, singletonList(otherTopicPartition), coordinator);
         consumer.poll(0);
@@ -660,7 +660,7 @@ public void testWakeupWithFetchDataAvailable() {
         Node node = cluster.nodes().get(0);
 
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         MockClient client = new MockClient(time, metadata);
         client.setNode(node);
@@ -705,7 +705,7 @@ public void testPollThrowsInterruptExceptionIfInterrupted() throws Exception {
         final Node node = cluster.nodes().get(0);
 
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         final MockClient client = new MockClient(time, metadata);
         client.setNode(node);
@@ -745,7 +745,7 @@ public void fetchResponseWithUnexpectedPartitionIsIgnored() {
         Node node = cluster.nodes().get(0);
 
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         MockClient client = new MockClient(time, metadata);
         client.setNode(node);
@@ -793,7 +793,7 @@ public void testSubscriptionChangesWithAutoCommitEnabled() {
         Node node = cluster.nodes().get(0);
 
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         MockClient client = new MockClient(time, metadata);
         client.setNode(node);
@@ -913,7 +913,7 @@ public void testSubscriptionChangesWithAutoCommitDisabled() {
         Node node = cluster.nodes().get(0);
 
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         MockClient client = new MockClient(time, metadata);
         client.setNode(node);
@@ -981,7 +981,7 @@ public void testManualAssignmentChangeWithAutoCommitEnabled() {
         Node node = cluster.nodes().get(0);
 
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         MockClient client = new MockClient(time, metadata);
         client.setNode(node);
@@ -1046,7 +1046,7 @@ public void testManualAssignmentChangeWithAutoCommitDisabled() {
         Node node = cluster.nodes().get(0);
 
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         MockClient client = new MockClient(time, metadata);
         client.setNode(node);
@@ -1107,7 +1107,7 @@ public void testOffsetOfPausedPartitions() {
         Node node = cluster.nodes().get(0);
 
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         MockClient client = new MockClient(time, metadata);
         client.setNode(node);
@@ -1226,7 +1226,7 @@ private void consumerCloseTest(final long closeTimeoutMs,
         Node node = cluster.nodes().get(0);
 
         Metadata metadata = new Metadata(0, Long.MAX_VALUE);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         MockClient client = new MockClient(time, metadata);
         client.setNode(node);
@@ -1238,7 +1238,7 @@ private void consumerCloseTest(final long closeTimeoutMs,
         consumer.subscribe(Arrays.asList(topic), getConsumerRebalanceListener(consumer));
         Node coordinator = prepareRebalance(client, node, assignor, Arrays.asList(tp0), null);
 
-        client.prepareMetadataUpdate(cluster);
+        client.prepareMetadataUpdate(cluster, Collections.<String>emptySet());
 
         // Poll with responses
         client.prepareResponseFrom(fetchResponse(tp0, 0, 1), node);
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/AbstractCoordinatorTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/AbstractCoordinatorTest.java
index bb617ae4f2479..8846b5e5b45da 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/AbstractCoordinatorTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/AbstractCoordinatorTest.java
@@ -79,7 +79,7 @@ public void setupCoordinator() {
         Metrics metrics = new Metrics();
 
         Cluster cluster = TestUtils.singletonCluster("topic", 1);
-        metadata.update(cluster, mockTime.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), mockTime.milliseconds());
         this.node = cluster.nodes().get(0);
         mockClient.setNode(node);
 
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java
index e11bf304efad8..66fe76d8a1358 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/ConsumerCoordinatorTest.java
@@ -120,7 +120,7 @@ public void setup() {
         this.time = new MockTime();
         this.subscriptions = new SubscriptionState(OffsetResetStrategy.EARLIEST);
         this.metadata = new Metadata(0, Long.MAX_VALUE);
-        this.metadata.update(cluster, time.milliseconds());
+        this.metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
         this.client = new MockClient(time, metadata);
         this.consumerClient = new ConsumerNetworkClient(client, metadata, time, 100, 1000);
         this.metrics = new Metrics(time);
@@ -292,7 +292,7 @@ public void testJoinGroupInvalidGroupId() {
 
         // ensure metadata is up-to-date for leader
         metadata.setTopics(singletonList(topic1));
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
@@ -310,7 +310,7 @@ public void testNormalJoinGroupLeader() {
 
         // ensure metadata is up-to-date for leader
         metadata.setTopics(singletonList(topic1));
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
@@ -349,7 +349,7 @@ public void testPatternJoinGroupLeader() {
         // partially update the metadata with one topic first,
         // let the leader to refresh metadata during assignment
         metadata.setTopics(singletonList(topic1));
-        metadata.update(TestUtils.singletonCluster(topic1, 1), time.milliseconds());
+        metadata.update(TestUtils.singletonCluster(topic1, 1), Collections.<String>emptySet(), time.milliseconds());
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
@@ -369,7 +369,7 @@ public boolean matches(AbstractRequest body) {
             }
         }, syncGroupResponse(Arrays.asList(t1p, t2p), Errors.NONE.code()));
         // expect client to force updating the metadata, if yes gives it both topics
-        client.prepareMetadataUpdate(cluster);
+        client.prepareMetadataUpdate(cluster, Collections.<String>emptySet());
 
         coordinator.poll(time.milliseconds());
 
@@ -389,7 +389,7 @@ public void testMetadataRefreshDuringRebalance() {
 
         subscriptions.subscribe(Pattern.compile(".*"), rebalanceListener);
         metadata.needMetadataForAllTopics(true);
-        metadata.update(TestUtils.singletonCluster(topic1, 1), time.milliseconds());
+        metadata.update(TestUtils.singletonCluster(topic1, 1), Collections.<String>emptySet(), time.milliseconds());
 
         assertEquals(singleton(topic1), subscriptions.subscription());
 
@@ -410,7 +410,7 @@ public boolean matches(AbstractRequest body) {
                 final Map<String, Integer> updatedPartitions = new HashMap<>();
                 for (String topic : updatedSubscription)
                     updatedPartitions.put(topic, 1);
-                metadata.update(TestUtils.clusterWith(1, updatedPartitions), time.milliseconds());
+                metadata.update(TestUtils.clusterWith(1, updatedPartitions), Collections.<String>emptySet(), time.milliseconds());
                 return true;
             }
         }, syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
@@ -453,7 +453,7 @@ public void testWakeupDuringJoin() {
 
         // ensure metadata is up-to-date for leader
         metadata.setTopics(singletonList(topic1));
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
@@ -524,7 +524,7 @@ public void testPatternJoinGroupFollower() {
         // partially update the metadata with one topic first,
         // let the leader to refresh metadata during assignment
         metadata.setTopics(singletonList(topic1));
-        metadata.update(TestUtils.singletonCluster(topic1, 1), time.milliseconds());
+        metadata.update(TestUtils.singletonCluster(topic1, 1), Collections.<String>emptySet(), time.milliseconds());
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
@@ -541,7 +541,7 @@ public boolean matches(AbstractRequest body) {
             }
         }, syncGroupResponse(Arrays.asList(t1p, t2p), Errors.NONE.code()));
         // expect client to force updating the metadata, if yes gives it both topics
-        client.prepareMetadataUpdate(cluster);
+        client.prepareMetadataUpdate(cluster, Collections.<String>emptySet());
 
         coordinator.joinGroupIfNeeded();
 
@@ -712,7 +712,7 @@ public void testMetadataChangeTriggersRebalance() {
 
         // ensure metadata is up-to-date for leader
         metadata.setTopics(singletonList(topic1));
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         subscriptions.subscribe(singleton(topic1), rebalanceListener);
 
@@ -731,7 +731,7 @@ public void testMetadataChangeTriggersRebalance() {
         assertFalse(coordinator.needRejoin());
 
         // a new partition is added to the topic
-        metadata.update(TestUtils.singletonCluster(topic1, 2), time.milliseconds());
+        metadata.update(TestUtils.singletonCluster(topic1, 2), Collections.<String>emptySet(), time.milliseconds());
 
         // we should detect the change and ask for reassignment
         assertTrue(coordinator.needRejoin());
@@ -751,7 +751,7 @@ public void testUpdateMetadataDuringRebalance() {
         metadata.setTopics(topics);
 
         // we only have metadata for one topic initially
-        metadata.update(TestUtils.singletonCluster(topic1, 1), time.milliseconds());
+        metadata.update(TestUtils.singletonCluster(topic1, 1), Collections.<String>emptySet(), time.milliseconds());
 
         client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
         coordinator.ensureCoordinatorReady();
@@ -772,7 +772,7 @@ public boolean matches(AbstractRequest body) {
                     Map<String, Integer> topicPartitionCounts = new HashMap<>();
                     topicPartitionCounts.put(topic1, 1);
                     topicPartitionCounts.put(topic2, 1);
-                    metadata.update(TestUtils.singletonCluster(topicPartitionCounts), time.milliseconds());
+                    metadata.update(TestUtils.singletonCluster(topicPartitionCounts), Collections.<String>emptySet(), time.milliseconds());
                     return true;
                 }
                 return false;
@@ -789,12 +789,72 @@ public boolean matches(AbstractRequest body) {
         assertEquals(new HashSet<>(Arrays.asList(tp1, tp2)), subscriptions.assignedPartitions());
     }
 
+    @Test
+    public void testRebalanceAfterTopicUnavailableWithSubscribe() {
+        unavailableTopicTest(false, false, Collections.<String>emptySet());
+    }
+
+    @Test
+    public void testRebalanceAfterTopicUnavailableWithPatternSubscribe() {
+        unavailableTopicTest(true, false, Collections.<String>emptySet());
+    }
+
+    @Test
+    public void testRebalanceAfterNotMatchingTopicUnavailableWithPatternSSubscribe() {
+        unavailableTopicTest(true, false, Collections.<String>singleton("notmatching"));
+    }
+
+    @Test
+    public void testAssignWithTopicUnavailable() {
+        unavailableTopicTest(true, false, Collections.<String>emptySet());
+    }
+
+    private void unavailableTopicTest(boolean patternSubscribe, boolean assign, Set<String> unavailableTopicsInLastMetadata) {
+        final String consumerId = "consumer";
+
+        metadata.setTopics(singletonList(topic1));
+        client.prepareMetadataUpdate(Cluster.empty(), Collections.singleton("test1"));
+
+        if (assign)
+            subscriptions.assignFromUser(singleton(t1p));
+        else if (patternSubscribe)
+            subscriptions.subscribe(Pattern.compile("test.*"), rebalanceListener);
+        else
+            subscriptions.subscribe(singleton(topic1), rebalanceListener);
+
+        client.prepareResponse(groupCoordinatorResponse(node, Errors.NONE.code()));
+        coordinator.ensureCoordinatorReady();
+
+        Map<String, List<String>> memberSubscriptions = Collections.singletonMap(consumerId, singletonList(topic1));
+        partitionAssignor.prepare(Collections.<String, List<TopicPartition>>emptyMap());
+
+        client.prepareResponse(joinGroupLeaderResponse(1, consumerId, memberSubscriptions, Errors.NONE.code()));
+        client.prepareResponse(syncGroupResponse(Collections.<TopicPartition>emptyList(), Errors.NONE.code()));
+        coordinator.poll(time.milliseconds());
+        if (!assign) {
+            assertFalse(coordinator.needRejoin());
+            assertEquals(Collections.<TopicPartition>emptySet(), rebalanceListener.assigned);
+        }
+        assertTrue("Metadata refresh not requested for unavailable partitions", metadata.updateRequested());
+
+        client.prepareMetadataUpdate(cluster, unavailableTopicsInLastMetadata);
+        client.poll(0, time.milliseconds());
+        client.prepareResponse(joinGroupLeaderResponse(2, consumerId, memberSubscriptions, Errors.NONE.code()));
+        client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
+        coordinator.poll(time.milliseconds());
+
+        assertFalse("Metadata refresh requested unnecessarily", metadata.updateRequested());
+        if (!assign) {
+            assertFalse(coordinator.needRejoin());
+            assertEquals(singleton(t1p), rebalanceListener.assigned);
+        }
+    }
 
     @Test
     public void testExcludeInternalTopicsConfigOption() {
         subscriptions.subscribe(Pattern.compile(".*"), rebalanceListener);
 
-        metadata.update(TestUtils.singletonCluster(TestUtils.GROUP_METADATA_TOPIC_NAME, 2), time.milliseconds());
+        metadata.update(TestUtils.singletonCluster(TestUtils.GROUP_METADATA_TOPIC_NAME, 2), Collections.<String>emptySet(), time.milliseconds());
 
         assertFalse(subscriptions.subscription().contains(TestUtils.GROUP_METADATA_TOPIC_NAME));
     }
@@ -804,7 +864,7 @@ public void testIncludeInternalTopicsConfigOption() {
         coordinator = buildCoordinator(new Metrics(), assignors, false, false);
         subscriptions.subscribe(Pattern.compile(".*"), rebalanceListener);
 
-        metadata.update(TestUtils.singletonCluster(TestUtils.GROUP_METADATA_TOPIC_NAME, 2), time.milliseconds());
+        metadata.update(TestUtils.singletonCluster(TestUtils.GROUP_METADATA_TOPIC_NAME, 2), Collections.<String>emptySet(), time.milliseconds());
 
         assertTrue(subscriptions.subscription().contains(TestUtils.GROUP_METADATA_TOPIC_NAME));
     }
@@ -1030,7 +1090,7 @@ public void testCommitAfterLeaveGroup() {
         client.prepareResponse(joinGroupFollowerResponse(1, "consumer", "leader", Errors.NONE.code()));
         client.prepareResponse(syncGroupResponse(singletonList(t1p), Errors.NONE.code()));
 
-        client.prepareMetadataUpdate(cluster);
+        client.prepareMetadataUpdate(cluster, Collections.<String>emptySet());
 
         coordinator.joinGroupIfNeeded();
 
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java
index ecaade25085cf..4d388e617d147 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java
@@ -108,7 +108,7 @@ public class FetcherTest {
 
     @Before
     public void setup() throws Exception {
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
         client.setNode(node);
 
         MemoryRecordsBuilder builder = MemoryRecords.builder(ByteBuffer.allocate(1024), CompressionType.NONE, TimestampType.CREATE_TIME, 1L);
@@ -837,7 +837,7 @@ private void testGetOffsetsForTimesWithError(Errors errorForTp0,
         TopicPartition tp1 = new TopicPartition(topicName, 1);
         // Ensure metadata has both partition.
         Cluster cluster = TestUtils.clusterWith(2, topicName, 2);
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         // First try should fail due to metadata error.
         client.prepareResponseFrom(listOffsetResponse(tp0, errorForTp0, offsetForTp0, offsetForTp0), cluster.leaderFor(tp0));
diff --git a/clients/src/test/java/org/apache/kafka/clients/producer/internals/SenderTest.java b/clients/src/test/java/org/apache/kafka/clients/producer/internals/SenderTest.java
index 7f5fe1587f339..a3dae6688bda3 100644
--- a/clients/src/test/java/org/apache/kafka/clients/producer/internals/SenderTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/producer/internals/SenderTest.java
@@ -84,7 +84,7 @@ public void setup() {
                             time,
                             REQUEST_TIMEOUT);
 
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
     }
 
     @After
@@ -197,7 +197,7 @@ public void testSendInOrder() throws Exception {
 
             // Create a two broker cluster, with partition 0 on broker 0 and partition 1 on broker 1
             Cluster cluster1 = TestUtils.clusterWith(2, "test", 2);
-            metadata.update(cluster1, time.milliseconds());
+            metadata.update(cluster1, Collections.<String>emptySet(), time.milliseconds());
 
             // Send the first message.
             TopicPartition tp2 = new TopicPartition("test", 1);
@@ -216,7 +216,7 @@ public void testSendInOrder() throws Exception {
 
             // Update metadata before sender receives response from broker 0. Now partition 2 moves to broker 0
             Cluster cluster2 = TestUtils.singletonCluster("test", 2);
-            metadata.update(cluster2, time.milliseconds());
+            metadata.update(cluster2, Collections.<String>emptySet(), time.milliseconds());
             // Sender should not send the second message to node 0.
             sender.run(time.milliseconds());
             assertEquals(1, client.inFlightRequestCount());
@@ -232,12 +232,12 @@ public void testSendInOrder() throws Exception {
     @Test
     public void testMetadataTopicExpiry() throws Exception {
         long offset = 0;
-        metadata.update(Cluster.empty(), time.milliseconds());
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time.milliseconds());
 
         Future<RecordMetadata> future = accumulator.append(tp, time.milliseconds(), "key".getBytes(), "value".getBytes(), null, MAX_BLOCK_TIMEOUT).future;
         sender.run(time.milliseconds());
         assertTrue("Topic not added to metadata", metadata.containsTopic(tp.topic()));
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
         sender.run(time.milliseconds());  // send produce request
         client.respond(produceResponse(tp, offset++, Errors.NONE.code(), 0));
         sender.run(time.milliseconds());
@@ -247,12 +247,12 @@ public void testMetadataTopicExpiry() throws Exception {
 
         assertTrue("Topic not retained in metadata list", metadata.containsTopic(tp.topic()));
         time.sleep(Metadata.TOPIC_EXPIRY_MS);
-        metadata.update(Cluster.empty(), time.milliseconds());
+        metadata.update(Cluster.empty(), Collections.<String>emptySet(), time.milliseconds());
         assertFalse("Unused topic has not been expired", metadata.containsTopic(tp.topic()));
         future = accumulator.append(tp, time.milliseconds(), "key".getBytes(), "value".getBytes(), null, MAX_BLOCK_TIMEOUT).future;
         sender.run(time.milliseconds());
         assertTrue("Topic not added to metadata", metadata.containsTopic(tp.topic()));
-        metadata.update(cluster, time.milliseconds());
+        metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
         sender.run(time.milliseconds());  // send produce request
         client.respond(produceResponse(tp, offset++, Errors.NONE.code(), 0));
         sender.run(time.milliseconds());
diff --git a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/distributed/WorkerGroupMember.java b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/distributed/WorkerGroupMember.java
index ac13472ea5d1a..f6ff6654aeca3 100644
--- a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/distributed/WorkerGroupMember.java
+++ b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/distributed/WorkerGroupMember.java
@@ -38,6 +38,7 @@
 import org.slf4j.LoggerFactory;
 
 import java.net.InetSocketAddress;
+import java.util.Collections;
 import java.util.LinkedHashMap;
 import java.util.List;
 import java.util.Map;
@@ -88,7 +89,7 @@ public WorkerGroupMember(DistributedConfig config,
             this.retryBackoffMs = config.getLong(CommonClientConfigs.RETRY_BACKOFF_MS_CONFIG);
             this.metadata = new Metadata(retryBackoffMs, config.getLong(CommonClientConfigs.METADATA_MAX_AGE_CONFIG));
             List<InetSocketAddress> addresses = ClientUtils.parseAndValidateAddresses(config.getList(CommonClientConfigs.BOOTSTRAP_SERVERS_CONFIG));
-            this.metadata.update(Cluster.bootstrap(addresses), 0);
+            this.metadata.update(Cluster.bootstrap(addresses), Collections.<String>emptySet(), 0);
             String metricGrpPrefix = "connect";
             ChannelBuilder channelBuilder = ClientUtils.createChannelBuilder(config.values());
             NetworkClient netClient = new NetworkClient(
diff --git a/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/distributed/WorkerCoordinatorTest.java b/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/distributed/WorkerCoordinatorTest.java
index 92393a1b4fbe5..282e1750dec09 100644
--- a/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/distributed/WorkerCoordinatorTest.java
+++ b/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/distributed/WorkerCoordinatorTest.java
@@ -91,7 +91,7 @@ public void setup() {
         this.time = new MockTime();
         this.client = new MockClient(time);
         this.metadata = new Metadata(0, Long.MAX_VALUE);
-        this.metadata.update(cluster, time.milliseconds());
+        this.metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
         this.consumerClient = new ConsumerNetworkClient(client, metadata, time, 100, 1000);
         this.metrics = new Metrics(time);
         this.rebalanceListener = new MockRebalanceListener();
diff --git a/core/src/main/scala/kafka/admin/AdminClient.scala b/core/src/main/scala/kafka/admin/AdminClient.scala
index 680c5e16f435b..6ccfe941cc953 100644
--- a/core/src/main/scala/kafka/admin/AdminClient.scala
+++ b/core/src/main/scala/kafka/admin/AdminClient.scala
@@ -231,7 +231,7 @@ object AdminClient {
     val brokerUrls = config.getList(CommonClientConfigs.BOOTSTRAP_SERVERS_CONFIG)
     val brokerAddresses = ClientUtils.parseAndValidateAddresses(brokerUrls)
     val bootstrapCluster = Cluster.bootstrap(brokerAddresses)
-    metadata.update(bootstrapCluster, 0)
+    metadata.update(bootstrapCluster, Collections.emptySet(), 0)
 
     val selector = new Selector(
       DefaultConnectionMaxIdleMs,
diff --git a/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala b/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala
index e848e28ce954c..4ec77a153c8ba 100644
--- a/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala
+++ b/core/src/test/scala/integration/kafka/api/ConsumerBounceTest.scala
@@ -43,12 +43,13 @@ class ConsumerBounceTest extends IntegrationTestHarness with Logging {
 
   // Time to process commit and leave group requests in tests when brokers are available
   val gracefulCloseTimeMs = 1000
-  val executor = Executors.newFixedThreadPool(2)
+  val executor = Executors.newScheduledThreadPool(2)
 
   // configure the servers and clients
   this.serverConfig.setProperty(KafkaConfig.OffsetsTopicReplicationFactorProp, "3") // don't want to lose offset
   this.serverConfig.setProperty(KafkaConfig.OffsetsTopicPartitionsProp, "1")
   this.serverConfig.setProperty(KafkaConfig.GroupMinSessionTimeoutMsProp, "10") // set small enough session timeout
+  this.serverConfig.setProperty(KafkaConfig.AutoCreateTopicsEnableProp, "false")
   this.producerConfig.setProperty(ProducerConfig.ACKS_CONFIG, "all")
   this.consumerConfig.setProperty(ConsumerConfig.GROUP_ID_CONFIG, "my-test")
   this.consumerConfig.setProperty(ConsumerConfig.MAX_PARTITION_FETCH_BYTES_CONFIG, 4096.toString)
@@ -160,6 +161,52 @@ class ConsumerBounceTest extends IntegrationTestHarness with Logging {
     }
   }
 
+  @Test
+  def testSubscribeWhenTopicUnavailable() {
+    val numRecords = 1000
+    val newtopic = "newtopic"
+
+    val consumer = this.consumers.head
+    consumer.subscribe(Collections.singleton(newtopic))
+    executor.schedule(new Runnable {
+        def run() = TestUtils.createTopic(zkUtils, newtopic, serverCount, serverCount, servers)
+      }, 2, TimeUnit.SECONDS)
+    consumer.poll(0)
+
+    def sendRecords(numRecords: Int, topic: String = this.topic) {
+      var remainingRecords = numRecords
+      val endTimeMs = System.currentTimeMillis + 20000
+      while (remainingRecords > 0 && System.currentTimeMillis < endTimeMs) {
+        val futures = (0 until remainingRecords).map { i =>
+          this.producers.head.send(new ProducerRecord(topic, part, i.toString.getBytes, i.toString.getBytes))
+        }
+        futures.map { future =>
+          try {
+            future.get
+            remainingRecords -= 1
+          } catch {
+            case _: Exception =>
+          }
+        }
+      }
+      assertEquals(0, remainingRecords)
+    }
+
+    sendRecords(numRecords, newtopic)
+    receiveRecords(consumer, numRecords, newtopic, 10000)
+
+    servers.foreach(server => killBroker(server.config.brokerId))
+    Thread.sleep(500)
+    restartDeadBrokers()
+
+    val future = executor.submit(new Runnable {
+      def run() = receiveRecords(consumer, numRecords, newtopic, 10000)
+    })
+    sendRecords(numRecords, newtopic)
+    future.get
+  }
+
+
   @Test
   def testClose() {
     val numRecords = 10
@@ -311,10 +358,12 @@ class ConsumerBounceTest extends IntegrationTestHarness with Logging {
     consumer
   }
 
-  private def receiveRecords(consumer: KafkaConsumer[Array[Byte], Array[Byte]], numRecords: Int) {
-    var received = 0
-    while (received < numRecords)
+  private def receiveRecords(consumer: KafkaConsumer[Array[Byte], Array[Byte]], numRecords: Int, topic: String = this.topic, timeoutMs: Long = 60000) {
+    var received = 0L
+    val endTimeMs = System.currentTimeMillis + timeoutMs
+    while (received < numRecords && System.currentTimeMillis < endTimeMs)
       received += consumer.poll(1000).count()
+    assertEquals(numRecords, received)
   }
 
   private def submitCloseAndValidate(consumer: KafkaConsumer[Array[Byte], Array[Byte]],
@@ -372,7 +421,7 @@ class ConsumerBounceTest extends IntegrationTestHarness with Logging {
     }
   }
 
-  private def sendRecords(numRecords: Int) {
+  private def sendRecords(numRecords: Int, topic: String = this.topic) {
     val futures = (0 until numRecords).map { i =>
       this.producers.head.send(new ProducerRecord(topic, part, i.toString.getBytes, i.toString.getBytes))
     }
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
index 94d8854901a63..60dd4164e6574 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
@@ -95,7 +95,7 @@ public StreamsKafkaClient(final Config streamsConfig) {
             streamsConfig.getLong(StreamsConfig.METADATA_MAX_AGE_CONFIG)
         );
         final List<InetSocketAddress> addresses = ClientUtils.parseAndValidateAddresses(streamsConfig.getList(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG));
-        metadata.update(Cluster.bootstrap(addresses), time.milliseconds());
+        metadata.update(Cluster.bootstrap(addresses), Collections.<String>emptySet(), time.milliseconds());
 
         final MetricConfig metricConfig = new MetricConfig().samples(streamsConfig.getInt(CommonClientConfigs.METRICS_NUM_SAMPLES_CONFIG))
                 .timeWindow(streamsConfig.getLong(CommonClientConfigs.METRICS_SAMPLE_WINDOW_MS_CONFIG), TimeUnit.MILLISECONDS)
@@ -223,7 +223,7 @@ private String getAnyReadyBrokerId() {
             streamsConfig.getLong(StreamsConfig.RETRY_BACKOFF_MS_CONFIG),
             streamsConfig.getLong(StreamsConfig.METADATA_MAX_AGE_CONFIG));
         final List<InetSocketAddress> addresses = ClientUtils.parseAndValidateAddresses(streamsConfig.getList(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG));
-        metadata.update(Cluster.bootstrap(addresses), Time.SYSTEM.milliseconds());
+        metadata.update(Cluster.bootstrap(addresses), Collections.<String>emptySet(), Time.SYSTEM.milliseconds());
 
         final List<Node> nodes = metadata.fetch().nodes();
         return ensureOneNodeIsReady(nodes);

From 4a019bdfaf2ab7110660b313df5bb05ab195e614 Mon Sep 17 00:00:00 2001
From: Ben Stopford <benstopford@gmail.com>
Date: Fri, 17 Mar 2017 12:39:53 +0000
Subject: [PATCH 131/177] MINOR: Increase Throttle lower bound assertion in
 throttling_test

Improves the reliability of this test by decreasing the lower bound (this is to be expected as throttling  takes the first fetch to stabilise and will "over-fetch" for this first request)

Author: Ben Stopford <benstopford@gmail.com>

Reviewers: Apurva Mehta <apurva@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2698 from benstopford/throttling-test-fix

(cherry picked from commit 6b11fb7af81390789ba449c0cd5daa81c8ee9cb5)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 tests/kafkatest/tests/core/throttling_test.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/kafkatest/tests/core/throttling_test.py b/tests/kafkatest/tests/core/throttling_test.py
index a80af39d3151f..94a40106d0a08 100644
--- a/tests/kafkatest/tests/core/throttling_test.py
+++ b/tests/kafkatest/tests/core/throttling_test.py
@@ -133,7 +133,7 @@ def reassign_partitions(self, bounce_brokers, throttle):
         self.logger.debug("Transfer took %d second. Estimated time : %ds",
                           time_taken,
                           estimated_throttled_time)
-        assert time_taken >= estimated_throttled_time, \
+        assert time_taken >= estimated_throttled_time * 0.9, \
             ("Expected rebalance to take at least %ds, but it took %ds" % (
                 estimated_throttled_time,
                 time_taken))

From 77bfe78ba4d446a92eb03910de094d472f6a2836 Mon Sep 17 00:00:00 2001
From: Ryan P <ryan.n.pridgeon@gmail.com>
Date: Tue, 21 Mar 2017 09:52:16 +0000
Subject: [PATCH 132/177] MINOR: Fix zookeeper-security-migration documentation
 example

Incorrect option in example

https://github.com/apache/kafka/blob/trunk/core/src/main/scala/kafka/admin/ZkSecurityMigrator.scala#L71

Author: Ryan P <ryan.n.pridgeon@gmail.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2714 from rnpridgeon/patch-1

(cherry picked from commit 05690f0c851007fb60ebd96c43c1141bddd510c1)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 docs/security.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/security.html b/docs/security.html
index 81d5c403c134e..3443c0c8fca37 100644
--- a/docs/security.html
+++ b/docs/security.html
@@ -903,7 +903,7 @@ <h4><a id="zk_authz_migration" href="#zk_authz_migration">7.6.2 Migrating cluste
     </ol>
     Here is an example of how to run the migration tool:
     <pre>
-    ./bin/zookeeper-security-migration --zookeeper.acl=secure --zookeeper.connection=localhost:2181
+    ./bin/zookeeper-security-migration --zookeeper.acl=secure --zookeeper.connect=localhost:2181
     </pre>
     <p>Run this to see the full list of parameters:</p>
     <pre>

From 3d294533c8613d2cf57ead76dfd75ca472659132 Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Tue, 21 Mar 2017 16:14:13 -0700
Subject: [PATCH 133/177] KAFKA-4863: Querying window store may return unwanted
 keys. Backport to 0.10.2

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2688 from dguy/kafka-4863-10.2
---
 .../kstream/internals/SessionKeySerde.java    |   9 ++
 .../state/internals/CachingSessionStore.java  |  52 --------
 .../state/internals/CachingWindowStore.java   |  12 +-
 .../internals/FilteredCacheIterator.java      |  73 +++++++++++
 .../state/internals/SessionKeySchema.java     |  14 +--
 .../state/internals/WindowStoreKeySchema.java |  25 ++--
 .../internals/SessionKeySerdeTest.java        |   8 ++
 .../internals/CachingWindowStoreTest.java     |  22 ++++
 .../internals/RocksDBSessionStoreTest.java    |  39 +++++-
 .../internals/RocksDBWindowStoreTest.java     | 116 ++++++++++++++++++
 10 files changed, 298 insertions(+), 72 deletions(-)
 create mode 100644 streams/src/main/java/org/apache/kafka/streams/state/internals/FilteredCacheIterator.java

diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionKeySerde.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionKeySerde.java
index d9a3528433916..249350e8b5e1a 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionKeySerde.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionKeySerde.java
@@ -163,4 +163,13 @@ public static Window extractWindow(final byte [] binaryKey) {
         final long end = buffer.getLong(binaryKey.length - 2 * TIMESTAMP_SIZE);
         return new TimeWindow(start, end);
     }
+
+    public static Windowed<Bytes> fromBytes(Bytes bytesKey) {
+        final byte[] binaryKey = bytesKey.get();
+        final ByteBuffer buffer = ByteBuffer.wrap(binaryKey);
+        final long start = buffer.getLong(binaryKey.length - TIMESTAMP_SIZE);
+        final long end = buffer.getLong(binaryKey.length - 2 * TIMESTAMP_SIZE);
+        return new Windowed<>(Bytes.wrap(extractKeyBytes(binaryKey)), new SessionWindow(start, end));
+    }
+
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java
index 2cea9155e6463..6cfbf810e4e09 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java
@@ -18,7 +18,6 @@
 
 import org.apache.kafka.common.serialization.Serde;
 import org.apache.kafka.common.utils.Bytes;
-import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.kstream.Windowed;
 import org.apache.kafka.streams.kstream.internals.CacheFlushListener;
 import org.apache.kafka.streams.kstream.internals.SessionKeySerde;
@@ -31,7 +30,6 @@
 import org.apache.kafka.streams.state.StateSerdes;
 
 import java.util.List;
-import java.util.NoSuchElementException;
 
 
 class CachingSessionStore<K, AGG> extends WrappedStateStore.AbstractWrappedStateStore implements SessionStore<K, AGG>, CachedStateStore<Windowed<K>, AGG> {
@@ -164,54 +162,4 @@ public void setFlushListener(CacheFlushListener<Windowed<K>, AGG> flushListener)
         this.flushListener = flushListener;
     }
 
-    private static class FilteredCacheIterator implements PeekingKeyValueIterator<Bytes, LRUCacheEntry> {
-        private final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator;
-        private final HasNextCondition hasNextCondition;
-
-        FilteredCacheIterator(final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator,
-                              final HasNextCondition hasNextCondition) {
-            this.cacheIterator = cacheIterator;
-            this.hasNextCondition = hasNextCondition;
-        }
-
-        @Override
-        public void close() {
-            // no-op
-        }
-
-        @Override
-        public Bytes peekNextKey() {
-            if (!hasNext()) {
-                throw new NoSuchElementException();
-            }
-            return cacheIterator.peekNextKey();
-        }
-
-        @Override
-        public boolean hasNext() {
-            return hasNextCondition.hasNext(cacheIterator);
-        }
-
-        @Override
-        public KeyValue<Bytes, LRUCacheEntry> next() {
-            if (!hasNext()) {
-                throw new NoSuchElementException();
-            }
-            return cacheIterator.next();
-
-        }
-
-        @Override
-        public void remove() {
-            throw new UnsupportedOperationException();
-        }
-
-        @Override
-        public KeyValue<Bytes, LRUCacheEntry> peekNext() {
-            if (!hasNext()) {
-                throw new NoSuchElementException();
-            }
-            return cacheIterator.peekNext();
-        }
-    }
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingWindowStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingWindowStore.java
index d471761f36475..33df4260824ef 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingWindowStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingWindowStore.java
@@ -39,6 +39,8 @@ class CachingWindowStore<K, V> extends WrappedStateStore.AbstractWrappedStateSto
     private final Serde<V> valueSerde;
     private CacheFlushListener<Windowed<K>, V> flushListener;
     private final long windowSize;
+    private final SegmentedBytesStore.KeySchema keySchema = new WindowStoreKeySchema();
+
     private String name;
     private ThreadCache cache;
     private InternalProcessorContext context;
@@ -146,9 +148,17 @@ public synchronized WindowStoreIterator<V> fetch(final K key, final long timeFro
 
         final WindowStoreIterator<byte[]> underlyingIterator = underlying.fetch(Bytes.wrap(serdes.rawKey(key)), timeFrom, timeTo);
         final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator = cache.range(name, binaryFrom, binaryTo);
-        return new MergedSortedCacheWindowStoreIterator<>(cacheIterator,
+
+
+        final HasNextCondition hasNextCondition = keySchema.hasNextCondition(Bytes.wrap(serdes.rawKey(key)),
+                                                                             timeFrom,
+                                                                             timeTo);
+        final PeekingKeyValueIterator<Bytes, LRUCacheEntry> filteredCacheIterator = new FilteredCacheIterator(cacheIterator, hasNextCondition);
+
+        return new MergedSortedCacheWindowStoreIterator<>(filteredCacheIterator,
                                                           underlyingIterator,
                                                           new StateSerdes<>(serdes.stateName(), Serdes.Long(), serdes.valueSerde()));
+
     }
 
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/FilteredCacheIterator.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/FilteredCacheIterator.java
new file mode 100644
index 0000000000000..135190325c854
--- /dev/null
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/FilteredCacheIterator.java
@@ -0,0 +1,73 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.common.utils.Bytes;
+import org.apache.kafka.streams.KeyValue;
+
+import java.util.NoSuchElementException;
+
+class FilteredCacheIterator implements PeekingKeyValueIterator<Bytes, LRUCacheEntry> {
+    private final PeekingKeyValueIterator<Bytes, LRUCacheEntry> cacheIterator;
+    private final HasNextCondition hasNextCondition;
+
+    FilteredCacheIterator(final PeekingKeyValueIterator<Bytes, LRUCacheEntry> cacheIterator,
+                          final HasNextCondition hasNextCondition) {
+        this.cacheIterator = cacheIterator;
+        this.hasNextCondition = hasNextCondition;
+    }
+
+    @Override
+    public void close() {
+        // no-op
+    }
+
+    @Override
+    public Bytes peekNextKey() {
+        if (!hasNext()) {
+            throw new NoSuchElementException();
+        }
+        return cacheIterator.peekNextKey();
+    }
+
+    @Override
+    public boolean hasNext() {
+        return hasNextCondition.hasNext(cacheIterator);
+    }
+
+    @Override
+    public KeyValue<Bytes, LRUCacheEntry> next() {
+        if (!hasNext()) {
+            throw new NoSuchElementException();
+        }
+        return cacheIterator.next();
+
+    }
+
+    @Override
+    public void remove() {
+        throw new UnsupportedOperationException();
+    }
+
+    @Override
+    public KeyValue<Bytes, LRUCacheEntry> peekNext() {
+        if (!hasNext()) {
+            throw new NoSuchElementException();
+        }
+        return cacheIterator.peekNext();
+    }
+}
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/SessionKeySchema.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/SessionKeySchema.java
index 604abb321382e..3747d0faa7e90 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/SessionKeySchema.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/SessionKeySchema.java
@@ -50,15 +50,15 @@ public HasNextCondition hasNextCondition(final Bytes binaryKey, final long from,
         return new HasNextCondition() {
             @Override
             public boolean hasNext(final KeyValueIterator<Bytes, ?> iterator) {
-                if (iterator.hasNext()) {
+                while (iterator.hasNext()) {
                     final Bytes bytes = iterator.peekNextKey();
-                    final Bytes keyBytes = Bytes.wrap(SessionKeySerde.extractKeyBytes(bytes.get()));
-                    if (!keyBytes.equals(binaryKey)) {
-                        return false;
+                    final Windowed<Bytes> windowedKey = SessionKeySerde.fromBytes(bytes);
+                    if (windowedKey.key().equals(binaryKey)
+                            && windowedKey.window().end() >= from
+                            && windowedKey.window().start() <= to) {
+                        return true;
                     }
-                    final long start = SessionKeySerde.extractStart(bytes.get());
-                    final long end = SessionKeySerde.extractEnd(bytes.get());
-                    return end >= from && start <= to;
+                    iterator.next();
                 }
                 return false;
             }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreKeySchema.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreKeySchema.java
index 093161ea6ca64..a4d347cf9ac91 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreKeySchema.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreKeySchema.java
@@ -24,12 +24,6 @@
 import java.util.List;
 
 class WindowStoreKeySchema implements RocksDBSegmentedBytesStore.KeySchema {
-    private static final HasNextCondition ITERATOR_HAS_NEXT = new HasNextCondition() {
-        @Override
-        public boolean hasNext(final KeyValueIterator<Bytes, ?> iterator) {
-            return iterator.hasNext();
-        }
-    };
     private final StateSerdes<Bytes, byte[]> serdes = new StateSerdes<>("window-store-key-schema", Serdes.Bytes(), Serdes.ByteArray());
 
     @Override
@@ -49,7 +43,24 @@ public long segmentTimestamp(final Bytes key) {
 
     @Override
     public HasNextCondition hasNextCondition(final Bytes binaryKey, final long from, final long to) {
-        return ITERATOR_HAS_NEXT;
+        return new HasNextCondition() {
+            @Override
+            public boolean hasNext(final KeyValueIterator<Bytes, ?> iterator) {
+                while (iterator.hasNext()) {
+                    final Bytes bytes = iterator.peekNextKey();
+                    final Bytes keyBytes = WindowStoreUtils.bytesKeyFromBinaryKey(bytes.get());
+                    final long time = WindowStoreUtils.timestampFromBinaryKey(bytes.get());
+                    if (keyBytes.equals(binaryKey)
+                            && time >= from
+                            && time <= to) {
+                        return true;
+                    }
+                    iterator.next();
+                }
+
+                return false;
+            }
+        };
     }
 
     @Override
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/SessionKeySerdeTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/SessionKeySerdeTest.java
index 3a0f490bf6d0c..3ccdc2cda9ae8 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/SessionKeySerdeTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/SessionKeySerdeTest.java
@@ -84,4 +84,12 @@ public void shouldExtractKeyBytesFromBinary() throws Exception {
         assertArrayEquals("blah".getBytes(), SessionKeySerde.extractKeyBytes(serialized.get()));
     }
 
+    @Test
+    public void shouldExtractBytesKeyFromBinary() throws Exception {
+        final Bytes bytesKey = Bytes.wrap("key".getBytes());
+        final Windowed<Bytes> windowedBytesKey = new Windowed<>(bytesKey, new SessionWindow(0, 10));
+        final Bytes serialized = SessionKeySerde.bytesToBinary(windowedBytesKey);
+        assertEquals(windowedBytesKey, SessionKeySerde.fromBytes(serialized));
+    }
+
 }
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java
index 2728aa07ea67a..11e605c143db8 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java
@@ -20,6 +20,7 @@
 import org.apache.kafka.common.metrics.Metrics;
 import org.apache.kafka.common.serialization.Serdes;
 import org.apache.kafka.common.utils.Bytes;
+import org.apache.kafka.common.utils.Utils;
 import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.errors.InvalidStateStoreException;
 import org.apache.kafka.streams.kstream.Windowed;
@@ -31,12 +32,17 @@
 import org.apache.kafka.streams.state.WindowStoreIterator;
 import org.apache.kafka.test.MockProcessorContext;
 import org.apache.kafka.test.TestUtils;
+import org.junit.After;
 import org.junit.Before;
 import org.junit.Test;
 
 import java.io.IOException;
+import java.util.List;
 
 import static org.apache.kafka.streams.state.internals.ThreadCacheTest.memoryCacheEntrySize;
+import static org.apache.kafka.test.StreamsTestUtils.toList;
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.MatcherAssert.assertThat;
 import static org.junit.Assert.assertArrayEquals;
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertFalse;
@@ -74,6 +80,10 @@ public void setUp() throws Exception {
         cachingStore.init(context, cachingStore);
     }
 
+    @After
+    public void closeStore() {
+        cachingStore.close();
+    }
 
     @Test
     public void shouldPutFetchFromCache() throws Exception {
@@ -180,6 +190,18 @@ public void shouldThrowIfTryingToWriteToClosedCachingStore() throws Exception {
         cachingStore.put("a", "a");
     }
 
+    @SuppressWarnings("unchecked")
+    @Test
+    public void shouldFetchAndIterateOverExactKeys() throws Exception {
+        cachingStore.put("a", "0001", 0);
+        cachingStore.put("aa", "0002", 0);
+        cachingStore.put("a", "0003", 1);
+        cachingStore.put("aa", "0004", 1);
+        cachingStore.put("a", "0005", 60000);
+
+        final List<KeyValue<Long, String>> expected = Utils.mkList(KeyValue.pair(0L, "0001"), KeyValue.pair(1L, "0003"), KeyValue.pair(60000L, "0005"));
+        assertThat(toList(cachingStore.fetch("a", 0, Long.MAX_VALUE)), equalTo(expected));
+    }
 
     private int addItemsToCache() throws IOException {
         int cachedSize = 0;
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreTest.java
index e1801b87cc04e..1b24f8bb25678 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSessionStoreTest.java
@@ -36,6 +36,8 @@
 import java.util.Arrays;
 import java.util.List;
 
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.MatcherAssert.assertThat;
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertFalse;
 import static org.junit.Assert.assertTrue;
@@ -43,6 +45,7 @@
 public class RocksDBSessionStoreTest {
 
     private SessionStore<String, Long> sessionStore;
+    private MockProcessorContext context;
 
     @Before
     public void before() {
@@ -53,11 +56,11 @@ public void before() {
                                                  Serdes.String(),
                                                  Serdes.Long());
 
-        final MockProcessorContext context = new MockProcessorContext(TestUtils.tempDirectory(),
-                                                                      Serdes.String(),
-                                                                      Serdes.Long(),
-                                                                      new NoOpRecordCollector(),
-                                                                      new ThreadCache("testCache", 0, new MockStreamsMetrics(new Metrics())));
+        context = new MockProcessorContext(TestUtils.tempDirectory(),
+                                           Serdes.String(),
+                                           Serdes.Long(),
+                                           new NoOpRecordCollector(),
+                                           new ThreadCache("testCache", 0, new MockStreamsMetrics(new Metrics())));
         sessionStore.init(context, sessionStore);
     }
 
@@ -145,6 +148,32 @@ public void shouldFindSessionsToMerge() throws Exception {
         assertFalse(results.hasNext());
     }
 
+    @Test
+    public void shouldFetchExactKeys() throws Exception {
+        final RocksDBSegmentedBytesStore bytesStore =
+                new RocksDBSegmentedBytesStore("session-store", 0x7a00000000000000L, 2, new SessionKeySchema());
+
+        sessionStore = new RocksDBSessionStore<>(bytesStore,
+                                                 Serdes.String(),
+                                                 Serdes.Long());
+
+        sessionStore.init(context, sessionStore);
+
+        sessionStore.put(new Windowed<>("a", new SessionWindow(0, 0)), 1L);
+        sessionStore.put(new Windowed<>("aa", new SessionWindow(0, 0)), 2L);
+        sessionStore.put(new Windowed<>("a", new SessionWindow(10, 20)), 3L);
+        sessionStore.put(new Windowed<>("aa", new SessionWindow(10, 20)), 4L);
+        sessionStore.put(new Windowed<>("a", new SessionWindow(0x7a00000000000000L - 2, 0x7a00000000000000L - 1)), 5L);
+
+        final KeyValueIterator<Windowed<String>, Long> iterator = sessionStore.findSessions("a", 0, Long.MAX_VALUE);
+        final List<Long> results = new ArrayList<>();
+        while (iterator.hasNext()) {
+            results.add(iterator.next().value);
+        }
+
+        assertThat(results, equalTo(Arrays.asList(1L, 3L, 5L)));
+    }
+
     static List<KeyValue<Windowed<String>, Long>> toList(final KeyValueIterator<Windowed<String>, Long> iterator) {
         final List<KeyValue<Windowed<String>, Long>> results = new ArrayList<>();
         while (iterator.hasNext()) {
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java
index d606e84eb8f5a..9f4afece8be79 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBWindowStoreTest.java
@@ -23,6 +23,7 @@
 import org.apache.kafka.common.serialization.Serde;
 import org.apache.kafka.common.serialization.Serdes;
 import org.apache.kafka.common.serialization.Serializer;
+import org.apache.kafka.common.utils.Bytes;
 import org.apache.kafka.common.utils.Utils;
 import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.errors.InvalidStateStoreException;
@@ -51,6 +52,8 @@
 import java.util.Map;
 import java.util.Set;
 
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.MatcherAssert.assertThat;
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertFalse;
 import static org.junit.Assert.assertNull;
@@ -969,6 +972,119 @@ public <K1, V1> void send(final String topic,
         }
     }
 
+    @SuppressWarnings("unchecked")
+    @Test
+    public void shouldFetchAndIterateOverExactKeys() throws Exception {
+        final File baseDir = TestUtils.tempDirectory();
+        final RocksDBWindowStoreSupplier<String, String> supplier =
+                new RocksDBWindowStoreSupplier<>(
+                        "window",
+                        0x7a00000000000000L, 2,
+                        true,
+                        Serdes.String(),
+                        Serdes.String(),
+                        0x7a00000000000000L,
+                        true,
+                        Collections.<String, String>emptyMap(),
+                        false);
+
+        final Producer<byte[], byte[]> producer = new MockProducer<>(true, byteArraySerde.serializer(), byteArraySerde.serializer());
+        final RecordCollector recordCollector = new RecordCollectorImpl(producer, "RocksDBWindowStoreTest-ShouldOnlyIterateOpenSegments") {
+            @Override
+            public <K1, V1> void send(final String topic,
+                                      K1 key,
+                                      V1 value,
+                                      Integer partition,
+                                      Long timestamp,
+                                      Serializer<K1> keySerializer,
+                                      Serializer<V1> valueSerializer) {
+            }
+        };
+
+        final MockProcessorContext context = new MockProcessorContext(
+                baseDir,
+                byteArraySerde, byteArraySerde,
+                recordCollector, cache);
+
+        final WindowStore<String, String> windowStore = supplier.get();
+        try {
+            windowStore.init(context, windowStore);
+
+            windowStore.put("a", "0001", 0);
+            windowStore.put("aa", "0002", 0);
+            windowStore.put("a", "0003", 1);
+            windowStore.put("aa", "0004", 1);
+            windowStore.put("a", "0005",  0x7a00000000000000L - 1);
+
+            final List expected = Utils.mkList("0001", "0003", "0005");
+            assertThat(toList(windowStore.fetch("a", 0, Long.MAX_VALUE)), equalTo(expected));
+        } finally {
+            windowStore.close();
+        }
+    }
+
+    @SuppressWarnings("unchecked")
+    @Test
+    public void shouldFetchAndIterateOverExactBinaryKeys() throws Exception {
+        final File baseDir = TestUtils.tempDirectory();
+        final RocksDBWindowStoreSupplier<Bytes, String> supplier =
+                new RocksDBWindowStoreSupplier<>(
+                        "window",
+                        60000, 2,
+                        true,
+                        Serdes.Bytes(),
+                        Serdes.String(),
+                        60000,
+                        true,
+                        Collections.<String, String>emptyMap(),
+                        false);
+
+        final Producer<byte[], byte[]> producer = new MockProducer<>(true, byteArraySerde.serializer(), byteArraySerde.serializer());
+        final RecordCollector recordCollector = new RecordCollectorImpl(producer, "RocksDBWindowStoreTest-ShouldOnlyIterateOpenSegments") {
+            @Override
+            public <K1, V1> void send(final String topic,
+                                      K1 key,
+                                      V1 value,
+                                      Integer partition,
+                                      Long timestamp,
+                                      Serializer<K1> keySerializer,
+                                      Serializer<V1> valueSerializer) {
+            }
+        };
+
+        final MockProcessorContext context = new MockProcessorContext(
+                baseDir,
+                byteArraySerde, byteArraySerde,
+                recordCollector, cache);
+
+        final WindowStore<Bytes, String> windowStore = supplier.get();
+        try {
+            windowStore.init(context, windowStore);
+
+            final Bytes key1 = Bytes.wrap(new byte[]{0});
+            final Bytes key2 = Bytes.wrap(new byte[]{0, 0});
+            final Bytes key3 = Bytes.wrap(new byte[]{0, 0, 0});
+            windowStore.put(key1, "1", 0);
+            windowStore.put(key2, "2", 0);
+            windowStore.put(key3, "3", 0);
+            windowStore.put(key1, "4", 1);
+            windowStore.put(key2, "5", 1);
+            windowStore.put(key3, "6", 59999);
+            windowStore.put(key1, "7", 59999);
+            windowStore.put(key2, "8", 59999);
+            windowStore.put(key3, "9", 59999);
+
+            final List expectedKey1 = Utils.mkList("1", "4", "7");
+            assertThat(toList(windowStore.fetch(key1, 0, Long.MAX_VALUE)), equalTo(expectedKey1));
+            final List expectedKey2 = Utils.mkList("2", "5", "8");
+            assertThat(toList(windowStore.fetch(key2, 0, Long.MAX_VALUE)), equalTo(expectedKey2));
+            final List expectedKey3 = Utils.mkList("3", "6", "9");
+            assertThat(toList(windowStore.fetch(key3, 0, Long.MAX_VALUE)), equalTo(expectedKey3));
+        } finally {
+            windowStore.close();
+        }
+    }
+
     private <E> List<E> toList(WindowStoreIterator<E> iterator) {
         ArrayList<E> list = new ArrayList<>();
         while (iterator.hasNext()) {

From 6e2698b25587b71dcec6d42d82516fc986a3ebd4 Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Tue, 21 Mar 2017 16:17:17 -0700
Subject: [PATCH 134/177] MINOR: remove unused log field from
 KStreamTransformValuesProcessor

remove unused log field from KStreamTransformValuesProcessor

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2717 from dguy/remove-unused-log-para

(cherry picked from commit c2653754d9dbc232ae5f2052993611b26ed62693)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../streams/kstream/internals/KStreamTransformValues.java      | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamTransformValues.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamTransformValues.java
index f689c9503fcdd..acc013f8ff35b 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamTransformValues.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamTransformValues.java
@@ -28,8 +28,6 @@
 import org.apache.kafka.streams.processor.StateRestoreCallback;
 import org.apache.kafka.streams.processor.StateStore;
 import org.apache.kafka.streams.processor.TaskId;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 import java.io.File;
 import java.util.Map;
@@ -49,7 +47,6 @@ public Processor<K, V> get() {
 
     public static class KStreamTransformValuesProcessor<K, V, R> implements Processor<K, V> {
 
-        private static final Logger log = LoggerFactory.getLogger(KStreamTransformValuesProcessor.class);
         private final ValueTransformer<V, R> valueTransformer;
         private ProcessorContext context;
 

From 51ffddcbc8846be57936166d2d43eed75336e0fa Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Tue, 21 Mar 2017 16:21:28 -0700
Subject: [PATCH 135/177] MINOR: updated incorrect JavaDocs for joins

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Damian Guy, Eno Thereska, Guozhang Wang

Closes #2670 from mjsax/fixJavaDocsRepartitioning
---
 .../apache/kafka/streams/kstream/KStream.java | 76 ++++++++++++++-----
 .../apache/kafka/streams/kstream/KTable.java  | 45 ++---------
 2 files changed, 64 insertions(+), 57 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
index 21135fb23b442..1b49f40ababb2 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KStream.java
@@ -927,7 +927,11 @@ <KR> KGroupedStream<KR, V> groupBy(final KeyValueMapper<? super K, ? super V, KR
      * <td></td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key.
+     * Both input streams (or to be more precise, their underlying source topics) need to have the same number of
+     * partitions.
+     * If this is not the case, you would need to call {@link #through(String)} (for one input stream) before doing the
+     * join, using a pre-created topic with the "correct" number of partitions.
+     * Furthermore, both input streams need to be co-partitioned on the join key (i.e., use the same partitioner).
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
@@ -998,7 +1002,11 @@ <VO, VR> KStream<K, VR> join(final KStream<K, VO> otherStream,
      * <td></td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key.
+     * Both input streams (or to be more precise, their underlying source topics) need to have the same number of
+     * partitions.
+     * If this is not the case, you would need to call {@link #through(String)} (for one input stream) before doing the
+     * join, using a pre-created topic with the "correct" number of partitions.
+     * Furthermore, both input streams need to be co-partitioned on the join key (i.e., use the same partitioner).
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
@@ -1082,7 +1090,11 @@ <VO, VR> KStream<K, VR> join(final KStream<K, VO> otherStream,
      * <td></td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key.
+     * Both input streams (or to be more precise, their underlying source topics) need to have the same number of
+     * partitions.
+     * If this is not the case, you would need to call {@link #through(String)} (for one input stream) before doing the
+     * join, using a pre-created topic with the "correct" number of partitions.
+     * Furthermore, both input streams need to be co-partitioned on the join key (i.e., use the same partitioner).
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
@@ -1157,7 +1169,11 @@ <VO, VR> KStream<K, VR> leftJoin(final KStream<K, VO> otherStream,
      * <td></td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key.
+     * Both input streams (or to be more precise, their underlying source topics) need to have the same number of
+     * partitions.
+     * If this is not the case, you would need to call {@link #through(String)} (for one input stream) before doing the
+     * join, using a pre-created topic with the "correct" number of partitions.
+     * Furthermore, both input streams need to be co-partitioned on the join key (i.e., use the same partitioner).
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
@@ -1244,7 +1260,11 @@ <VO, VR> KStream<K, VR> leftJoin(final KStream<K, VO> otherStream,
      * <td>&lt;K3:ValueJoiner(null,c)&gt;</td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key.
+     * Both input streams (or to be more precise, their underlying source topics) need to have the same number of
+     * partitions.
+     * If this is not the case, you would need to call {@link #through(String)} (for one input stream) before doing the
+     * join, using a pre-created topic with the "correct" number of partitions.
+     * Furthermore, both input streams need to be co-partitioned on the join key (i.e., use the same partitioner).
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
@@ -1320,7 +1340,11 @@ <VO, VR> KStream<K, VR> outerJoin(final KStream<K, VO> otherStream,
      * <td>&lt;K3:ValueJoiner(null,c)&gt;</td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key.
+     * Both input streams (or to be more precise, their underlying source topics) need to have the same number of
+     * partitions.
+     * If this is not the case, you would need to call {@link #through(String)} (for one input stream) before doing the
+     * join, using a pre-created topic with the "correct" number of partitions.
+     * Furthermore, both input streams need to be co-partitioned on the join key (i.e., use the same partitioner).
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
@@ -1408,8 +1432,12 @@ <VO, VR> KStream<K, VR> outerJoin(final KStream<K, VO> otherStream,
      * <td>&lt;K1:ValueJoiner(C,b)&gt;</td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key (cf.
-     * {@link #join(GlobalKTable, KeyValueMapper, ValueJoiner)}).
+     * Both input streams (or to be more precise, their underlying source topics) need to have the same number of
+     * partitions.
+     * If this is not the case, you would need to call {@link #through(String)} for this {@code KStream} before doing
+     * the join, using a pre-created topic with the same number of partitions as the given {@link KTable}.
+     * Furthermore, both input streams need to be co-partitioned on the join key (i.e., use the same partitioner);
+     * cf. {@link #join(GlobalKTable, KeyValueMapper, ValueJoiner)}.
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
@@ -1418,7 +1446,7 @@ <VO, VR> KStream<K, VR> outerJoin(final KStream<K, VO> otherStream,
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen only for this {@code KStream}s.
+     * Repartitioning can happen only for this {@code KStream} but not for the provided {@link KTable}.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
      * records to it, and rereading all records from it, such that the join input {@code KStream} is partitioned
      * correctly on its key.
@@ -1477,8 +1505,12 @@ <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
      * <td>&lt;K1:ValueJoiner(C,b)&gt;</td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key (cf.
-     * {@link #join(GlobalKTable, KeyValueMapper, ValueJoiner)}).
+     * Both input streams (or to be more precise, their underlying source topics) need to have the same number of
+     * partitions.
+     * If this is not the case, you would need to call {@link #through(String)} for this {@code KStream} before doing
+     * the join, using a pre-created topic with the same number of partitions as the given {@link KTable}.
+     * Furthermore, both input streams need to be co-partitioned on the join key (i.e., use the same partitioner);
+     * cf. {@link #join(GlobalKTable, KeyValueMapper, ValueJoiner)}.
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
@@ -1487,7 +1519,7 @@ <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen only for this {@code KStream}s.
+     * Repartitioning can happen only for this {@code KStream} but not for the provided {@link KTable}.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
      * records to it, and rereading all records from it, such that the join input {@code KStream} is partitioned
      * correctly on its key.
@@ -1556,8 +1588,12 @@ <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
      * <td>&lt;K1:ValueJoiner(C,b)&gt;</td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key (cf.
-     * {@link #leftJoin(GlobalKTable, KeyValueMapper, ValueJoiner)}).
+     * Both input streams (or to be more precise, their underlying source topics) need to have the same number of
+     * partitions.
+     * If this is not the case, you would need to call {@link #through(String)} for this {@code KStream} before doing
+     * the join, using a pre-created topic with the same number of partitions as the given {@link KTable}.
+     * Furthermore, both input streams need to be co-partitioned on the join key (i.e., use the same partitioner);
+     * cf. {@link #join(GlobalKTable, KeyValueMapper, ValueJoiner)}.
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
@@ -1566,7 +1602,7 @@ <VT, VR> KStream<K, VR> join(final KTable<K, VT> table,
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen only for this {@code KStream}s.
+     * Repartitioning can happen only for this {@code KStream} but not for the provided {@link KTable}.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
      * records to it, and rereading all records from it, such that the join input {@code KStream} is partitioned
      * correctly on its key.
@@ -1628,8 +1664,12 @@ <VT, VR> KStream<K, VR> leftJoin(final KTable<K, VT> table,
      * <td>&lt;K1:ValueJoiner(C,b)&gt;</td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key (cf.
-     * {@link #leftJoin(GlobalKTable, KeyValueMapper, ValueJoiner)}).
+     * Both input streams (or to be more precise, their underlying source topics) need to have the same number of
+     * partitions.
+     * If this is not the case, you would need to call {@link #through(String)} for this {@code KStream} before doing
+     * the join, using a pre-created topic with the same number of partitions as the given {@link KTable}.
+     * Furthermore, both input streams need to be co-partitioned on the join key (i.e., use the same partitioner);
+     * cf. {@link #join(GlobalKTable, KeyValueMapper, ValueJoiner)}.
      * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
      * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
      * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
@@ -1638,7 +1678,7 @@ <VT, VR> KStream<K, VR> leftJoin(final KTable<K, VT> table,
      * "-repartition" is a fixed suffix.
      * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
      * <p>
-     * Repartitioning can happen only for this {@code KStream}s.
+     * Repartitioning can happen only for this {@code KStream} but not for the provided {@link KTable}.
      * For this case, all data of the stream will be redistributed through the repartitioning topic by writing all
      * records to it, and rereading all records from it, such that the join input {@code KStream} is partitioned
      * correctly on its key.
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java b/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java
index 9de2644b41a05..eebac8fabc24f 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/KTable.java
@@ -628,19 +628,8 @@ <KR, VR> KGroupedTable<KR, VR> groupBy(final KeyValueMapper<? super K, ? super V
      * <td>&lt;K1:null&gt;</td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key.
-     * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
-     * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
-     * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
-     * user-specified in {@link StreamsConfig} via parameter
-     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
-     * "-repartition" is a fixed suffix.
-     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
-     * <p>
-     * Repartitioning can happen both input {@code KTable}s.
-     * For this case, all data of a {@code KTable} will be redistributed through the repartitioning topic by writing all
-     * update records to and rereading all update records from it, such that the join input {@code KTable} is
-     * partitioned correctly on its key.
+     * Both input streams (or to be more precise, their underlying source topics) need to have the same number of
+     * partitions.
      *
      * @param other  the other {@code KTable} to be joined with this {@code KTable}
      * @param joiner a {@link ValueJoiner} that computes the join result for a pair of matching records
@@ -720,19 +709,8 @@ <VO, VR> KTable<K, VR> join(final KTable<K, VO> other,
      * <td></td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key.
-     * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
-     * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
-     * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
-     * user-specified in {@link StreamsConfig} via parameter
-     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
-     * "-repartition" is a fixed suffix.
-     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
-     * <p>
-     * Repartitioning can happen both input {@code KTable}s.
-     * For this case, all data of a {@code KTable} will be redistributed through the repartitioning topic by writing all
-     * update records to and rereading all update records from it, such that the join input {@code KTable} is
-     * partitioned correctly on its key.
+     * Both input streams (or to be more precise, their underlying source topics) need to have the same number of
+     * partitions.
      *
      * @param other  the other {@code KTable} to be joined with this {@code KTable}
      * @param joiner a {@link ValueJoiner} that computes the join result for a pair of matching records
@@ -812,19 +790,8 @@ <VO, VR> KTable<K, VR> leftJoin(final KTable<K, VO> other,
      * <td>&lt;K1:null&gt;</td>
      * </tr>
      * </table>
-     * Both input streams need to be co-partitioned on the join key.
-     * If this requirement is not met, Kafka Streams will automatically repartition the data, i.e., it will create an
-     * internal repartitioning topic in Kafka and write and re-read the data via this topic before the actual join.
-     * The repartitioning topic will be named "${applicationId}-XXX-repartition", where "applicationId" is
-     * user-specified in {@link StreamsConfig} via parameter
-     * {@link StreamsConfig#APPLICATION_ID_CONFIG APPLICATION_ID_CONFIG}, "XXX" is an internally generated name, and
-     * "-repartition" is a fixed suffix.
-     * You can retrieve all generated internal topic names via {@link KafkaStreams#toString()}.
-     * <p>
-     * Repartitioning can happen both input {@code KTable}s.
-     * For this case, all data of a {@code KTable} will be redistributed through the repartitioning topic by writing all
-     * update records to and rereading all update records from it, such that the join input {@code KTable} is
-     * partitioned correctly on its key.
+     * Both input streams (or to be more precise, their underlying source topics) need to have the same number of
+     * partitions.
      *
      * @param other  the other {@code KTable} to be joined with this {@code KTable}
      * @param joiner a {@link ValueJoiner} that computes the join result for a pair of matching records

From b3f5f95203960ca338024cf0fc8ba437c55b9214 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Tue, 21 Mar 2017 19:18:41 -0700
Subject: [PATCH 136/177] MINOR: improve hanging ResetIntegrationTest

Sometimes `ResetIntegrationTest` hangs and thus the build times out. We suspect, that this happens if no data is written into the input topics. Right now, input data is written once and reused for both test cases. If for some reason, the broker gets recreated (between both test cases), no data will be available for the second test method and thus the test hangs.

This change ensures, that input data is written for each test case individually.

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Ismael Juma, Eno Thereska, Guozhang Wang

Closes #2630 from mjsax/minor-reset-integration-test

(cherry picked from commit 83824089f2371d6375c2713d494f276aec27c1a1)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../integration/ResetIntegrationTest.java     | 40 +++++++++++++------
 1 file changed, 28 insertions(+), 12 deletions(-)

diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java
index f1a8f6844e06c..35a58f039ecbb 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java
@@ -23,6 +23,8 @@
 import kafka.utils.ZkUtils;
 import org.apache.kafka.clients.consumer.ConsumerConfig;
 import org.apache.kafka.common.errors.GroupCoordinatorNotAvailableException;
+import org.apache.kafka.common.errors.TimeoutException;
+import org.apache.kafka.common.errors.UnknownTopicOrPartitionException;
 import org.apache.kafka.common.security.JaasUtils;
 import org.apache.kafka.common.serialization.LongDeserializer;
 import org.apache.kafka.common.serialization.LongSerializer;
@@ -44,7 +46,6 @@
 import org.junit.AfterClass;
 import org.junit.Assert;
 import org.junit.Before;
-import org.junit.BeforeClass;
 import org.junit.ClassRule;
 import org.junit.Test;
 
@@ -92,14 +93,6 @@ public class ResetIntegrationTest {
     private final MockTime mockTime = CLUSTER.time;
     private final WaitUntilConsumerGroupGotClosed consumerGroupInactive = new WaitUntilConsumerGroupGotClosed();
 
-    @BeforeClass
-    public static void startKafkaCluster() throws Exception {
-        CLUSTER.createTopic(INPUT_TOPIC);
-        CLUSTER.createTopic(OUTPUT_TOPIC);
-        CLUSTER.createTopic(OUTPUT_TOPIC_2);
-        CLUSTER.createTopic(OUTPUT_TOPIC_2_RERUN);
-    }
-
     @AfterClass
     public static void globalCleanup() {
         if (adminClient != null) {
@@ -131,9 +124,7 @@ public void cleanup() throws Exception {
             break;
         }
 
-        if (testNo == 1) {
-            prepareInputData();
-        }
+        prepareInputData();
     }
 
     @Test
@@ -290,6 +281,31 @@ private Properties prepareTest() throws Exception {
     }
 
     private void prepareInputData() throws Exception {
+        try {
+            CLUSTER.deleteTopic(INPUT_TOPIC);
+        } catch (final UnknownTopicOrPartitionException e) {
+            // ignore
+        }
+        try {
+            CLUSTER.deleteTopic(OUTPUT_TOPIC);
+        } catch (final UnknownTopicOrPartitionException e) {
+            // ignore
+        }
+        try {
+            CLUSTER.deleteTopic(OUTPUT_TOPIC_2);
+        } catch (final UnknownTopicOrPartitionException e) {
+            // ignore
+        }
+        try {
+            CLUSTER.deleteTopic(OUTPUT_TOPIC_2_RERUN);
+        } catch (final UnknownTopicOrPartitionException e) {
+            // ignore
+        }
+        CLUSTER.createTopic(INPUT_TOPIC);
+        CLUSTER.createTopic(OUTPUT_TOPIC);
+        CLUSTER.createTopic(OUTPUT_TOPIC_2);
+        CLUSTER.createTopic(OUTPUT_TOPIC_2_RERUN);
+
         final Properties producerConfig = TestUtils.producerConfig(CLUSTER.bootstrapServers(), LongSerializer.class, StringSerializer.class);
 
         mockTime.sleep(10);

From cf310ec48ff08f52f27b894dcf473048bb738db6 Mon Sep 17 00:00:00 2001
From: "Michael G. Noll" <michael@confluent.io>
Date: Wed, 22 Mar 2017 12:23:07 -0700
Subject: [PATCH 137/177] MINOR: MyProcessor doc example should implement, not
 extend `Processor`

Author: Michael G. Noll <michael@confluent.io>

Reviewers: Eno Thereska, Guozhang Wang

Closes #2723 from miguno/trunk-streams-docs-typo-fix

(cherry picked from commit 666beecec83db755335eac9cef2433d0b4870a05)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 docs/streams.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/streams.html b/docs/streams.html
index 6461f867ad705..815e1aa3bde3a 100644
--- a/docs/streams.html
+++ b/docs/streams.html
@@ -307,7 +307,7 @@ <h4><a id="streams_processor_process" href="#streams_processor_process">Processo
         </p>
 
 <pre>
-public class MyProcessor extends Processor&lt;String, String&gt; {
+public class MyProcessor implements Processor&lt;String, String&gt; {
     private ProcessorContext context;
     private KeyValueStore&lt;String, Long&gt; kvStore;
 

From 75df53f4b3923fee79a7457f1e32abca7e5e98ee Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Wed, 22 Mar 2017 12:24:33 -0700
Subject: [PATCH 138/177] MINOR: log state store restore offsets

Debug logging of the start and end offsets used during state store restoration

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2724 from dguy/log-restore-offsets-0.10.2
---
 .../streams/processor/internals/ProcessorStateManager.java    | 4 ++++
 .../kafka/streams/integration/ResetIntegrationTest.java       | 1 -
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java
index ad16c77c2a8ba..65831a24d7183 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java
@@ -219,6 +219,10 @@ private void restoreActiveState(String topicName, StateRestoreCallback stateRest
             } else {
                 restoreConsumer.seekToBeginning(singleton(storePartition));
             }
+            log.debug("restoring partition {} from offset {} to endOffset {}",
+                      storePartition,
+                      restoreConsumer.position(storePartition),
+                      endOffset);
 
             // restore its state from changelog records
             long limit = offsetLimit(storePartition);
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java
index 35a58f039ecbb..39889b15eda5c 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java
@@ -23,7 +23,6 @@
 import kafka.utils.ZkUtils;
 import org.apache.kafka.clients.consumer.ConsumerConfig;
 import org.apache.kafka.common.errors.GroupCoordinatorNotAvailableException;
-import org.apache.kafka.common.errors.TimeoutException;
 import org.apache.kafka.common.errors.UnknownTopicOrPartitionException;
 import org.apache.kafka.common.security.JaasUtils;
 import org.apache.kafka.common.serialization.LongDeserializer;

From eb0dbe850b7d56dfc851ec5fa3c45510fd7b37c0 Mon Sep 17 00:00:00 2001
From: Gwen Shapira <cshapi@gmail.com>
Date: Wed, 22 Mar 2017 23:06:26 -0700
Subject: [PATCH 139/177] MINOR: Adding example to SMT documentation

Author: Gwen Shapira <cshapi@gmail.com>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2721 from gwenshap/improve_smt_docs

(cherry picked from commit 95ef40dd31b6b0ee403413184ef974c6c051ddeb)
Signed-off-by: Ewen Cheslack-Postava <me@ewencp.org>
---
 docs/connect.html | 68 ++++++++++++++++++++++++++++++++++++++++++++++-
 docs/toc.html     |  6 +++++
 2 files changed, 73 insertions(+), 1 deletion(-)

diff --git a/docs/connect.html b/docs/connect.html
index 1af5ed95f6051..6ad06b8beb1b0 100644
--- a/docs/connect.html
+++ b/docs/connect.html
@@ -102,7 +102,7 @@ <h4><a id="connect_configuring" href="#connect_configuring">Configuring Connecto
 
     <h4><a id="connect_transforms" href="#connect_transforms">Transformations</a></h4>
 
-    Connectors can be configured with transformations to make lightweight message-at-a-time modifications. They can be convenient for minor data massaging and routing changes.
+    Connectors can be configured with transformations to make lightweight message-at-a-time modifications. They can be convenient for data massaging and event routing.
 
     A transformation chain can be specified in the connector configuration.
 
@@ -112,8 +112,74 @@ <h4><a id="connect_transforms" href="#connect_transforms">Transformations</a></h
         <li><code>transforms.$alias.$transformationSpecificConfig</code> Configuration properties for the transformation</li>
     </ul>
 
+    <p>For example, lets take the built-in file source connector and use a transformation to add a static field.</p>
+
+    <p>Throughout the example we'll use schemaless JSON data format. To use schemaless format, we changed the following two lines in <code>connect-standalone.properties</code> from true to false:</p>
+
+    <pre>
+        key.converter.schemas.enable
+        value.converter.schemas.enable
+    </pre>
+
+    The file source connector reads each line as a String. We will wrap each line in a Map and then add a second field to identify the origin of the event. To do this, we use two transformations:
+    <ul>
+        <li><b>HoistField</b> to place the input line inside a Map</li>
+        <li><b>InsertField</b> to add the static field. In this example we'll indicate that the record came from a file connector</li>
+    </ul>
+
+    After adding the transformations, <code>connect-file-source.properties</code> file looks as following:
+
+    <pre>
+        name=local-file-source
+        connector.class=FileStreamSource
+        tasks.max=1
+        file=test.txt
+        topic=connect-test
+        transforms=MakeMap, InsertSource
+        transforms.MakeMap.type=org.apache.kafka.connect.transforms.HoistField$Value
+        transforms.MakeMap.field=line
+        transforms.InsertSource.type=org.apache.kafka.connect.transforms.InsertField$Value
+        transforms.InsertSource.static.field=data_source
+        transforms.InsertSource.static.value=test-file-source
+    </pre>
+
+    <p>All the lines starting with <code>transforms</code> were added for the transformations. You can see the two transformations we created: "InsertSource" and "MakeMap" are aliases that we chose to give the transformations. The transformation types are based on the list of built-in transformations you can see below. Each transformation type has additional configuration: HoistField requires a configuration called "field", which is the name of the field in the map that will include the original String from the file. InsertField transformation lets us specify the field name and the value that we are adding.</p>
+
+    When we ran the file source connector on my sample file without the transformations, and then read them using <code>kafka-console-consumer.sh</code>, the results were:
+
+    <pre>
+        "foo"
+        "bar"
+        "hello world"
+   </pre>
+
+    We then create a new file connector, this time after adding the transformations to the configuration file. This time, the results will be:
+
+    <pre>
+        {"line":"foo","data_source":"test-file-source"}
+        {"line":"bar","data_source":"test-file-source"}
+        {"line":"hello world","data_source":"test-file-source"}
+    </pre>
+
+    You can see that the lines we've read are now part of a JSON map, and there is an extra field with the static value we specified. This is just one example of what you can do with transformations.
+
     Several widely-applicable data and routing transformations are included with Kafka Connect:
 
+    <ul>
+        <li>InsertField - Add a field using either static data or record metadata</li>
+        <li>ReplaceField - Filter or rename fields</li>
+        <li>MaskField - Replace field with valid null value for the type (0, empty string, etc)</li>
+        <li>ValueToKey</li>
+        <li>HoistField - Wrap the entire event as a single field inside a Struct or a Map</li>
+        <li>ExtractField - Extract a specific field from Struct and Map and include only this field in results</li>
+        <li>SetSchemaMetadata - modify the schema name or version</li>
+        <li>TimestampRouter - Modify the topic of a record based on original topic and timestamp. Useful when using a sink that needs to write to different tables or indexes based on timestamps</li>
+        <li>RegexpRouter - modify the topic of a record based on original topic, replacement string and a regular expression</li>
+    </ul>
+
+    Details on how to configure each transformation are listed below:
+
+
     <!--#include virtual="generated/connect_transforms.html" -->
 
     <h4><a id="connect_rest" href="#connect_rest">REST API</a></h4>
diff --git a/docs/toc.html b/docs/toc.html
index 787153d8cd723..935703bc9072a 100644
--- a/docs/toc.html
+++ b/docs/toc.html
@@ -130,6 +130,12 @@
             <ul>
                 <li><a href="#connect_overview">8.1 Overview</a></li>
                 <li><a href="#connect_user">8.2 User Guide</a></li>
+                <ul>
+                    <li><a href="#connect_running">Running Kafka Connect</a></li>
+                    <li><a href="#connect_configuring">Configuring Connectors</a></li>
+                    <li><a href="#connect_transforms">Transformations</a></li>
+                    <li><a href="#connect_rest">REST API</a></li>
+                </ul>
                 <li><a href="#connect_development">8.3 Connector Development Guide</a></li>
             </ul>
         </li>

From c96635291e963e4651e2ff5dac1b8449c16d32ba Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Thu, 23 Mar 2017 09:47:45 -0700
Subject: [PATCH 140/177] KAFKA-4919: Document that stores must not be closed
 when Processors are closed

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Michael G. Noll, Eno Thereska, Matthias J. Sax, Elias Levy, Guozhang Wang

Closes #2725 from dguy/minor-processor-java-doc

(cherry picked from commit 2269eed242d9ccd4cc3e9ae3211d01f166f6e234)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 docs/streams.html                                            | 5 +++--
 .../streams/examples/wordcount/WordCountProcessorDemo.java   | 4 +---
 .../java/org/apache/kafka/streams/processor/Processor.java   | 2 ++
 .../java/org/apache/kafka/streams/processor/StateStore.java  | 3 +++
 4 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/docs/streams.html b/docs/streams.html
index 815e1aa3bde3a..2b4c4414f6f62 100644
--- a/docs/streams.html
+++ b/docs/streams.html
@@ -355,8 +355,9 @@ <h4><a id="streams_processor_process" href="#streams_processor_process">Processo
 
     @Override
     public void close() {
-        // close the key-value store
-        this.kvStore.close();
+        // close any resources managed by this processor.
+        // Note: Do not close any StateStores as these are managed
+        // by the library
     }
 };
 </pre>
diff --git a/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountProcessorDemo.java b/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountProcessorDemo.java
index f9913cac7ed73..9d2424a9615b5 100644
--- a/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountProcessorDemo.java
+++ b/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountProcessorDemo.java
@@ -95,9 +95,7 @@ public void punctuate(long timestamp) {
                 }
 
                 @Override
-                public void close() {
-                    this.kvStore.close();
-                }
+                public void close() {}
             };
         }
     }
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/Processor.java b/streams/src/main/java/org/apache/kafka/streams/processor/Processor.java
index beaace349e085..e0eca8c90befe 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/Processor.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/Processor.java
@@ -55,6 +55,8 @@ public interface Processor<K, V> {
     /**
      * Close this processor and clean up any resources. Be aware that {@link #close()} is called after an internal cleanup.
      * Thus, it is not possible to write anything to Kafka as underlying clients are already closed.
+     * <p>
+     * Note: Do not close any streams managed resources, like {@link StateStore}s here, as they are managed by the library.
      */
     void close();
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/StateStore.java b/streams/src/main/java/org/apache/kafka/streams/processor/StateStore.java
index 9aa0932dc656e..f417a346ed763 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/StateStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/StateStore.java
@@ -49,6 +49,9 @@ public interface StateStore {
      * Close the storage engine.
      * Note that this function needs to be idempotent since it may be called
      * several times on the same state store.
+     * <p>
+     * Users only need to implement this function but should NEVER need to call this api explicitly
+     * as it will be called by the library automatically when necessary
      */
     void close();
 

From 1e4cab7616c534a0c059126eb01131351fd0078d Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Thu, 23 Mar 2017 10:04:58 -0700
Subject: [PATCH 141/177] MINOR: only log first exception in
 RecordCollectorImpl producer callback

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2726 from dguy/producer-send-exception

(cherry picked from commit f615c9e9d2c59542665edd95cd7152f17e61f026)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../streams/processor/internals/RecordCollectorImpl.java    | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/RecordCollectorImpl.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/RecordCollectorImpl.java
index f243d82568270..16365788b1210 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/RecordCollectorImpl.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/RecordCollectorImpl.java
@@ -97,8 +97,10 @@ public void onCompletion(RecordMetadata metadata, Exception exception) {
                             TopicPartition tp = new TopicPartition(metadata.topic(), metadata.partition());
                             offsets.put(tp, metadata.offset());
                         } else {
-                            sendException = exception;
-                            log.error("{} Error sending record to topic {}. No more offsets will be recorded for this task and the exception will eventually be thrown", logPrefix, topic, exception);
+                            if (sendException == null) {
+                                sendException = exception;
+                                log.error("{} Error sending record to topic {}. No more offsets will be recorded for this task and the exception will eventually be thrown", logPrefix, topic, exception);
+                            }
                         }
                     }
                 });

From 2397269c442ba9292b47843c4d275b4415d6f845 Mon Sep 17 00:00:00 2001
From: Onur Karaman <okaraman@linkedin.com>
Date: Tue, 28 Mar 2017 23:20:20 +0100
Subject: [PATCH 142/177] KAFKA-4959; Remove controller concurrent access to
 non-threadsafe NetworkClient, Selector, and SSLEngine

This brought down a cluster by causing continuous controller moves.

ZkClient's ZkEventThread and a RequestSendThread can concurrently use objects that aren't thread-safe:
* Selector
* NetworkClient
* SSLEngine (this was the big one for us. We turn on SSL for interbroker communication).

As per the "Concurrency Notes" section from https://docs.oracle.com/javase/7/docs/api/javax/net/ssl/SSLEngine.html:
> two threads must not attempt to call the same method (either wrap() or unwrap()) concurrently

SSLEngine.wrap gets called in:
* SslTransportLayer.write
* SslTransportLayer.handshake
* SslTransportLayer.close

It turns out that the ZkEventThread and RequestSendThread can concurrently call SSLEngine.wrap:
* ZkEventThread calls SslTransportLayer.close from ControllerChannelManager.removeExistingBroker
* RequestSendThread can call SslTransportLayer.write or SslTransportLayer.handshake from NetworkClient.poll

Suppose the controller moves for whatever reason. The former controller could have had a RequestSendThread who
was in the middle of sending out messages to the cluster while the ZkEventThread began executing
KafkaController.onControllerResignation, which calls ControllerChannelManager.shutdown, which sequentially cleans
up the controller-to-broker queue and connection for every broker in the cluster. This cleanup includes the call
to ControllerChannelManager.removeExistingBroker as mentioned earlier, causing the concurrent call to SSLEngine.wrap.
This concurrent call throws a BufferOverflowException which ControllerChannelManager.removeExistingBroker catches so
the ControllerChannelManager.shutdown moves onto cleaning up the next controller-to-broker queue and connection,
skipping the cleanup steps such as clearing the queue, stopping the RequestSendThread, and removing the entry from its
brokerStateInfo map.

By failing out of the Selector.close, the sensors corresponding to the broker connection has not been cleaned up. Any
later attempt at initializing an identical Selector will result in a sensor collision and therefore cause Selector
initialization to throw an exception. In other words, any later attempts by this broker to become controller again
will fail on initialization. When controller initialization fails, the controller deletes the /controller znode and
lets another broker take over.

Now suppose the controller moves enough times such that every broker hits the BufferOverflowException concurrency
issue. We're now guaranteed to fail controller initialization due to the sensor collision on every controller
transition, so the controller will move across brokers continuously.

This patch avoids the concurrent use of non-threadsafe classes in ControllerChannelManager.removeExistingBroker
by shutting down the RequestSendThread before closing the NetworkClient.

Author: Onur Karaman <okaraman@linkedin.com>

Reviewers: Joel Koshy <jjkoshy.w@gmail.com>, Ismael Juma <ismael@juma.me.uk>

Closes #2746 from onurkaraman/KAFKA-4959

(cherry picked from commit edb372dcaf34312b5c1c91c4df5e5ff87586e73b)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../scala/kafka/controller/ControllerChannelManager.scala   | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/core/src/main/scala/kafka/controller/ControllerChannelManager.scala b/core/src/main/scala/kafka/controller/ControllerChannelManager.scala
index d9280348c9422..4bb4b5992172b 100755
--- a/core/src/main/scala/kafka/controller/ControllerChannelManager.scala
+++ b/core/src/main/scala/kafka/controller/ControllerChannelManager.scala
@@ -135,9 +135,13 @@ class ControllerChannelManager(controllerContext: ControllerContext, config: Kaf
 
   private def removeExistingBroker(brokerState: ControllerBrokerStateInfo) {
     try {
+      // Shutdown the RequestSendThread before closing the NetworkClient to avoid the concurrent use of the
+      // non-threadsafe classes as described in KAFKA-4959.
+      // The call to shutdownLatch.await() in ShutdownableThread.shutdown() serves as a synchronization barrier that
+      // hands off the NetworkClient from the RequestSendThread to the ZkEventThread.
+      brokerState.requestSendThread.shutdown()
       brokerState.networkClient.close()
       brokerState.messageQueue.clear()
-      brokerState.requestSendThread.shutdown()
       brokerStateInfo.remove(brokerState.brokerNode.id)
     } catch {
       case e: Throwable => error("Error while removing broker by the controller", e)

From 4b8c73615e778c244af8394dfbd5befac005c419 Mon Sep 17 00:00:00 2001
From: Bill Bejeck <bbejeck@gmail.com>
Date: Thu, 30 Mar 2017 15:44:56 -0700
Subject: [PATCH 143/177] KAFKA-4791: unable to add state store with regex
 matched topics

Fix for adding state stores with regex defined sources

Author: bbejeck <bbejeck@gmail.com>

Reviewers: Matthias J. Sax, Damian Guy, Guozhang Wang

Closes #2618 from bbejeck/KAFKA-4791_unable_to_add_statestore_regex_topics

(cherry picked from commit 15e0234a5f4976facd4cfe61b91cfcdec6f6083c)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../streams/processor/TopologyBuilder.java    | 185 +++++++++++-------
 .../RegexSourceIntegrationTest.java           |  30 +++
 .../processor/TopologyBuilderTest.java        |  34 ++++
 3 files changed, 178 insertions(+), 71 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/TopologyBuilder.java b/streams/src/main/java/org/apache/kafka/streams/processor/TopologyBuilder.java
index 81f4302429bff..92cfda7a00777 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/TopologyBuilder.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/TopologyBuilder.java
@@ -98,6 +98,10 @@ public class TopologyBuilder {
     // are connected to these state stores
     private final Map<String, Set<String>> stateStoreNameToSourceTopics = new HashMap<>();
 
+    // map from state store names to all the regex subscribed topics from source processors that
+    // are connected to these state stores
+    private final Map<String, Set<Pattern>> stateStoreNameToSourceRegex = new HashMap<>();
+
     // map from state store names to this state store's corresponding changelog topic if possible,
     // this is used in the extended KStreamBuilder.
     private final Map<String, String> storeToChangelogTopic = new HashMap<>();
@@ -175,7 +179,7 @@ private class SourceNodeFactory extends NodeFactory {
 
         private SourceNodeFactory(String name, String[] topics, Pattern pattern, Deserializer<?> keyDeserializer, Deserializer<?> valDeserializer) {
             super(name);
-            this.topics = topics != null ? Arrays.asList(topics) : null;
+            this.topics = topics != null ? Arrays.asList(topics) : new ArrayList<String>();
             this.pattern = pattern;
             this.keyDeserializer = keyDeserializer;
             this.valDeserializer = valDeserializer;
@@ -312,7 +316,7 @@ public TopologyBuilder() {}
      * @param applicationId the streams applicationId. Should be the same as set by
      * {@link org.apache.kafka.streams.StreamsConfig#APPLICATION_ID_CONFIG}
      */
-    public synchronized final TopologyBuilder setApplicationId(String applicationId) {
+    public synchronized final TopologyBuilder setApplicationId(final String applicationId) {
         Objects.requireNonNull(applicationId, "applicationId can't be null");
         this.applicationId = applicationId;
 
@@ -330,7 +334,7 @@ public synchronized final TopologyBuilder setApplicationId(String applicationId)
      * @param topics the name of one or more Kafka topics that this source is to consume
      * @return this builder instance so methods can be chained together; never null
      */
-    public synchronized final TopologyBuilder addSource(String name, String... topics) {
+    public synchronized final TopologyBuilder addSource(final String name, final String... topics) {
         return addSource(null, name, null, null, topics);
     }
 
@@ -346,7 +350,7 @@ public synchronized final TopologyBuilder addSource(String name, String... topic
      * @param topics the name of one or more Kafka topics that this source is to consume
      * @return this builder instance so methods can be chained together; never null
      */
-    public synchronized final TopologyBuilder addSource(AutoOffsetReset offsetReset, String name,  String... topics) {
+    public synchronized final TopologyBuilder addSource(final AutoOffsetReset offsetReset, final String name,  final String... topics) {
         return addSource(offsetReset, name, null, null, topics);
     }
 
@@ -363,7 +367,7 @@ public synchronized final TopologyBuilder addSource(AutoOffsetReset offsetReset,
      * @param topicPattern regular expression pattern to match Kafka topics that this source is to consume
      * @return this builder instance so methods can be chained together; never null
      */
-    public synchronized final TopologyBuilder addSource(String name, Pattern topicPattern) {
+    public synchronized final TopologyBuilder addSource(final String name, final Pattern topicPattern) {
         return addSource(null, name, null, null, topicPattern);
     }
 
@@ -380,7 +384,7 @@ public synchronized final TopologyBuilder addSource(String name, Pattern topicPa
      * @param topicPattern regular expression pattern to match Kafka topics that this source is to consume
      * @return this builder instance so methods can be chained together; never null
      */
-    public synchronized final TopologyBuilder addSource(AutoOffsetReset offsetReset, String name,  Pattern topicPattern) {
+    public synchronized final TopologyBuilder addSource(final AutoOffsetReset offsetReset, final String name,  final Pattern topicPattern) {
         return addSource(offsetReset, name, null, null, topicPattern);
     }
 
@@ -401,7 +405,7 @@ public synchronized final TopologyBuilder addSource(AutoOffsetReset offsetReset,
      * @return this builder instance so methods can be chained together; never null
      * @throws TopologyBuilderException if processor is already added or if topics have already been registered by another source
      */
-    public synchronized final TopologyBuilder addSource(String name, Deserializer keyDeserializer, Deserializer valDeserializer, String... topics) {
+    public synchronized final TopologyBuilder addSource(final String name, final Deserializer keyDeserializer, final Deserializer valDeserializer, final String... topics) {
         return addSource(null, name, keyDeserializer, valDeserializer, topics);
 
     }
@@ -423,7 +427,7 @@ public synchronized final TopologyBuilder addSource(String name, Deserializer ke
      * @return this builder instance so methods can be chained together; never null
      * @throws TopologyBuilderException if processor is already added or if topics have already been registered by another source
      */
-    public synchronized final TopologyBuilder addSource(AutoOffsetReset offsetReset, String name, Deserializer keyDeserializer, Deserializer valDeserializer, String... topics) {
+    public synchronized final TopologyBuilder addSource(final AutoOffsetReset offsetReset, final String name, final Deserializer keyDeserializer, final Deserializer valDeserializer, final String... topics) {
         if (topics.length == 0) {
             throw new TopologyBuilderException("You must provide at least one topic");
         }
@@ -541,7 +545,7 @@ private void validateTopicNotAlreadyRegistered(final String topic) {
      * @throws TopologyBuilderException if processor is already added or if topics have already been registered by name
      */
 
-    public synchronized final TopologyBuilder addSource(String name, Deserializer keyDeserializer, Deserializer valDeserializer, Pattern topicPattern) {
+    public synchronized final TopologyBuilder addSource(final String name, final Deserializer keyDeserializer, final Deserializer valDeserializer, final Pattern topicPattern) {
         return addSource(null, name,  keyDeserializer, valDeserializer, topicPattern);
 
     }
@@ -567,7 +571,7 @@ public synchronized final TopologyBuilder addSource(String name, Deserializer ke
      * @throws TopologyBuilderException if processor is already added or if topics have already been registered by name
      */
 
-    public synchronized final TopologyBuilder addSource(AutoOffsetReset offsetReset, String name,  Deserializer keyDeserializer, Deserializer valDeserializer, Pattern topicPattern) {
+    public synchronized final TopologyBuilder addSource(final AutoOffsetReset offsetReset, final String name,  final Deserializer keyDeserializer, final Deserializer valDeserializer, final Pattern topicPattern) {
         Objects.requireNonNull(topicPattern, "topicPattern can't be null");
         Objects.requireNonNull(name, "name can't be null");
 
@@ -605,7 +609,7 @@ public synchronized final TopologyBuilder addSource(AutoOffsetReset offsetReset,
      * @see #addSink(String, String, Serializer, Serializer, String...)
      * @see #addSink(String, String, Serializer, Serializer, StreamPartitioner, String...)
      */
-    public synchronized final TopologyBuilder addSink(String name, String topic, String... parentNames) {
+    public synchronized final TopologyBuilder addSink(final String name, final String topic, final String... parentNames) {
         return addSink(name, topic, null, null, parentNames);
     }
 
@@ -632,7 +636,7 @@ public synchronized final TopologyBuilder addSink(String name, String topic, Str
      * @see #addSink(String, String, Serializer, Serializer, String...)
      * @see #addSink(String, String, Serializer, Serializer, StreamPartitioner, String...)
      */
-    public synchronized final TopologyBuilder addSink(String name, String topic, StreamPartitioner partitioner, String... parentNames) {
+    public synchronized final TopologyBuilder addSink(final String name, final String topic, final StreamPartitioner partitioner, final String... parentNames) {
         return addSink(name, topic, null, null, partitioner, parentNames);
     }
 
@@ -655,7 +659,7 @@ public synchronized final TopologyBuilder addSink(String name, String topic, Str
      * @see #addSink(String, String, StreamPartitioner, String...)
      * @see #addSink(String, String, Serializer, Serializer, StreamPartitioner, String...)
      */
-    public synchronized final TopologyBuilder addSink(String name, String topic, Serializer keySerializer, Serializer valSerializer, String... parentNames) {
+    public synchronized final TopologyBuilder addSink(final String name, final String topic, final Serializer keySerializer, final Serializer valSerializer, final String... parentNames) {
         return addSink(name, topic, keySerializer, valSerializer, null, parentNames);
     }
 
@@ -680,7 +684,7 @@ public synchronized final TopologyBuilder addSink(String name, String topic, Ser
      * @see #addSink(String, String, Serializer, Serializer, String...)
      * @throws TopologyBuilderException if parent processor is not added yet, or if this processor's name is equal to the parent's name
      */
-    public synchronized final <K, V> TopologyBuilder addSink(String name, String topic, Serializer<K> keySerializer, Serializer<V> valSerializer, StreamPartitioner<? super K, ? super V> partitioner, String... parentNames) {
+    public synchronized final <K, V> TopologyBuilder addSink(final String name, final String topic, final Serializer<K> keySerializer, final Serializer<V> valSerializer, final StreamPartitioner<? super K, ? super V> partitioner, final String... parentNames) {
         Objects.requireNonNull(name, "name must not be null");
         Objects.requireNonNull(topic, "topic must not be null");
         if (nodeFactories.containsKey(name))
@@ -714,7 +718,7 @@ public synchronized final <K, V> TopologyBuilder addSink(String name, String top
      * @return this builder instance so methods can be chained together; never null
      * @throws TopologyBuilderException if parent processor is not added yet, or if this processor's name is equal to the parent's name
      */
-    public synchronized final TopologyBuilder addProcessor(String name, ProcessorSupplier supplier, String... parentNames) {
+    public synchronized final TopologyBuilder addProcessor(final String name, final ProcessorSupplier supplier, final String... parentNames) {
         Objects.requireNonNull(name, "name must not be null");
         Objects.requireNonNull(supplier, "supplier must not be null");
         if (nodeFactories.containsKey(name))
@@ -743,7 +747,7 @@ public synchronized final TopologyBuilder addProcessor(String name, ProcessorSup
      * @return this builder instance so methods can be chained together; never null
      * @throws TopologyBuilderException if state store supplier is already added
      */
-    public synchronized final TopologyBuilder addStateStore(StateStoreSupplier supplier, String... processorNames) {
+    public synchronized final TopologyBuilder addStateStore(final StateStoreSupplier supplier, final String... processorNames) {
         Objects.requireNonNull(supplier, "supplier can't be null");
         if (stateFactories.containsKey(supplier.name())) {
             throw new TopologyBuilderException("StateStore " + supplier.name() + " is already added.");
@@ -767,7 +771,7 @@ public synchronized final TopologyBuilder addStateStore(StateStoreSupplier suppl
      * @param stateStoreNames the names of state stores that the processor uses
      * @return this builder instance so methods can be chained together; never null
      */
-    public synchronized final TopologyBuilder connectProcessorAndStateStores(String processorName, String... stateStoreNames) {
+    public synchronized final TopologyBuilder connectProcessorAndStateStores(final String processorName, final String... stateStoreNames) {
         Objects.requireNonNull(processorName, "processorName can't be null");
         if (stateStoreNames != null) {
             for (String stateStoreName : stateStoreNames) {
@@ -782,7 +786,7 @@ public synchronized final TopologyBuilder connectProcessorAndStateStores(String
      * This is used only for KStreamBuilder: when adding a KTable from a source topic,
      * we need to add the topic as the KTable's materialized state store's changelog.
      */
-    protected synchronized final TopologyBuilder connectSourceStoreAndTopic(String sourceStoreName, String topic) {
+    protected synchronized final TopologyBuilder connectSourceStoreAndTopic(final String sourceStoreName, final String topic) {
         if (storeToChangelogTopic.containsKey(sourceStoreName)) {
             throw new TopologyBuilderException("Source store " + sourceStoreName + " is already added.");
         }
@@ -800,7 +804,7 @@ protected synchronized final TopologyBuilder connectSourceStoreAndTopic(String s
      * @return this builder instance so methods can be chained together; never null
      * @throws TopologyBuilderException if less than two processors are specified, or if one of the processors is not added yet
      */
-    public synchronized final TopologyBuilder connectProcessors(String... processorNames) {
+    public synchronized final TopologyBuilder connectProcessors(final String... processorNames) {
         if (processorNames.length < 2)
             throw new TopologyBuilderException("At least two processors need to participate in the connection.");
 
@@ -823,7 +827,7 @@ public synchronized final TopologyBuilder connectProcessors(String... processorN
      * @param topicName the name of the topic
      * @return this builder instance so methods can be chained together; never null
      */
-    public synchronized final TopologyBuilder addInternalTopic(String topicName) {
+    public synchronized final TopologyBuilder addInternalTopic(final String topicName) {
         Objects.requireNonNull(topicName, "topicName can't be null");
         this.internalTopicNames.add(topicName);
 
@@ -836,69 +840,85 @@ public synchronized final TopologyBuilder addInternalTopic(String topicName) {
      * @param sourceNodes a set of source node names
      * @return this builder instance so methods can be chained together; never null
      */
-    public synchronized final TopologyBuilder copartitionSources(Collection<String> sourceNodes) {
+    public synchronized final TopologyBuilder copartitionSources(final Collection<String> sourceNodes) {
         copartitionSourceGroups.add(Collections.unmodifiableSet(new HashSet<>(sourceNodes)));
         return this;
     }
 
-    private void connectProcessorAndStateStore(String processorName, String stateStoreName) {
+    private void connectProcessorAndStateStore(final String processorName, final String stateStoreName) {
         if (!stateFactories.containsKey(stateStoreName))
             throw new TopologyBuilderException("StateStore " + stateStoreName + " is not added yet.");
         if (!nodeFactories.containsKey(processorName))
             throw new TopologyBuilderException("Processor " + processorName + " is not added yet.");
 
-        StateStoreFactory stateStoreFactory = stateFactories.get(stateStoreName);
-        Iterator<String> iter = stateStoreFactory.users.iterator();
+        final StateStoreFactory stateStoreFactory = stateFactories.get(stateStoreName);
+        final Iterator<String> iter = stateStoreFactory.users.iterator();
         if (iter.hasNext()) {
-            String user = iter.next();
+            final String user = iter.next();
             nodeGrouper.unite(user, processorName);
         }
         stateStoreFactory.users.add(processorName);
 
         NodeFactory nodeFactory = nodeFactories.get(processorName);
         if (nodeFactory instanceof ProcessorNodeFactory) {
-            ProcessorNodeFactory processorNodeFactory = (ProcessorNodeFactory) nodeFactory;
+            final ProcessorNodeFactory processorNodeFactory = (ProcessorNodeFactory) nodeFactory;
             processorNodeFactory.addStateStore(stateStoreName);
-            connectStateStoreNameToSourceTopics(stateStoreName, processorNodeFactory);
+            connectStateStoreNameToSourceTopicsOrPattern(stateStoreName, processorNodeFactory);
         } else {
             throw new TopologyBuilderException("cannot connect a state store " + stateStoreName + " to a source node or a sink node.");
         }
     }
 
-    private Set<String> findSourceTopicsForProcessorParents(String [] parents) {
-        final Set<String> sourceTopics = new HashSet<>();
+    private Set<SourceNodeFactory> findSourcesForProcessorParents(final String[] parents) {
+        final Set<SourceNodeFactory> sourceNodes = new HashSet<>();
         for (String parent : parents) {
-            NodeFactory nodeFactory = nodeFactories.get(parent);
+            final NodeFactory nodeFactory = nodeFactories.get(parent);
             if (nodeFactory instanceof SourceNodeFactory) {
-                sourceTopics.addAll(((SourceNodeFactory) nodeFactory).topics);
+                sourceNodes.add((SourceNodeFactory) nodeFactory);
             } else if (nodeFactory instanceof ProcessorNodeFactory) {
-                sourceTopics.addAll(findSourceTopicsForProcessorParents(((ProcessorNodeFactory) nodeFactory).parents));
+                sourceNodes.addAll(findSourcesForProcessorParents(((ProcessorNodeFactory) nodeFactory).parents));
             }
         }
-        return sourceTopics;
+        return sourceNodes;
     }
 
-    private void connectStateStoreNameToSourceTopics(final String stateStoreName,
-                                                     final ProcessorNodeFactory processorNodeFactory) {
+    private void connectStateStoreNameToSourceTopicsOrPattern(final String stateStoreName,
+                                                              final ProcessorNodeFactory processorNodeFactory) {
 
         // we should never update the mapping from state store names to source topics if the store name already exists
         // in the map; this scenario is possible, for example, that a state store underlying a source KTable is
         // connecting to a join operator whose source topic is not the original KTable's source topic but an internal repartition topic.
-        if (stateStoreNameToSourceTopics.containsKey(stateStoreName)) {
+
+        if (stateStoreNameToSourceTopics.containsKey(stateStoreName) || stateStoreNameToSourceRegex.containsKey(stateStoreName)) {
             return;
         }
 
-        final Set<String> sourceTopics = findSourceTopicsForProcessorParents(processorNodeFactory.parents);
-        if (sourceTopics.isEmpty()) {
-            throw new TopologyBuilderException("can't find source topic for state store " +
-                    stateStoreName);
+        final Set<String> sourceTopics = new HashSet<>();
+        final Set<Pattern> sourcePatterns = new HashSet<>();
+        final Set<SourceNodeFactory> sourceNodesForParent = findSourcesForProcessorParents(processorNodeFactory.parents);
+
+        for (SourceNodeFactory sourceNodeFactory : sourceNodesForParent) {
+            if (sourceNodeFactory.pattern != null) {
+                sourcePatterns.add(sourceNodeFactory.pattern);
+            } else {
+                sourceTopics.addAll(sourceNodeFactory.topics);
+            }
+        }
+        
+        if (!sourceTopics.isEmpty()) {
+            stateStoreNameToSourceTopics.put(stateStoreName,
+                    Collections.unmodifiableSet(sourceTopics));
+        }
+
+        if (!sourcePatterns.isEmpty()) {
+            stateStoreNameToSourceRegex.put(stateStoreName,
+                    Collections.unmodifiableSet(sourcePatterns));
         }
-        stateStoreNameToSourceTopics.put(stateStoreName,
-                Collections.unmodifiableSet(sourceTopics));
+
     }
 
 
-    private <T> void maybeAddToResetList(Collection<T> earliestResets, Collection<T> latestResets, AutoOffsetReset offsetReset, T item) {
+    private <T> void maybeAddToResetList(final Collection<T> earliestResets, final Collection<T> latestResets, final AutoOffsetReset offsetReset, final T item) {
         if (offsetReset != null) {
             switch (offsetReset) {
                 case EARLIEST:
@@ -926,8 +946,8 @@ public synchronized Map<Integer, Set<String>> nodeGroups() {
     }
 
     private Map<Integer, Set<String>> makeNodeGroups() {
-        HashMap<Integer, Set<String>> nodeGroups = new LinkedHashMap<>();
-        HashMap<String, Set<String>> rootToNodeGroup = new HashMap<>();
+        final HashMap<Integer, Set<String>> nodeGroups = new LinkedHashMap<>();
+        final HashMap<String, Set<String>> rootToNodeGroup = new HashMap<>();
 
         int nodeGroupId = 0;
 
@@ -936,7 +956,7 @@ private Map<Integer, Set<String>> makeNodeGroups() {
         allSourceNodes.addAll(nodeToSourcePatterns.keySet());
 
         for (String nodeName : Utils.sorted(allSourceNodes)) {
-            String root = nodeGrouper.root(nodeName);
+            final String root = nodeGrouper.root(nodeName);
             Set<String> nodeGroup = rootToNodeGroup.get(root);
             if (nodeGroup == null) {
                 nodeGroup = new HashSet<>();
@@ -949,7 +969,7 @@ private Map<Integer, Set<String>> makeNodeGroups() {
         // Go through non-source nodes
         for (String nodeName : Utils.sorted(nodeFactories.keySet())) {
             if (!nodeToSourceTopics.containsKey(nodeName)) {
-                String root = nodeGrouper.root(nodeName);
+                final String root = nodeGrouper.root(nodeName);
                 Set<String> nodeGroup = rootToNodeGroup.get(root);
                 if (nodeGroup == null) {
                     nodeGroup = new HashSet<>();
@@ -969,7 +989,7 @@ private Map<Integer, Set<String>> makeNodeGroups() {
      *
      * @see org.apache.kafka.streams.KafkaStreams#KafkaStreams(TopologyBuilder, org.apache.kafka.streams.StreamsConfig)
      */
-    public synchronized ProcessorTopology build(Integer topicGroupId) {
+    public synchronized ProcessorTopology build(final Integer topicGroupId) {
         Set<String> nodeGroup;
         if (topicGroupId != null) {
             nodeGroup = nodeGroups().get(topicGroupId);
@@ -1017,12 +1037,12 @@ private Set<String> globalNodeGroups() {
         return globalGroups;
     }
 
-    private ProcessorTopology build(Set<String> nodeGroup) {
-        List<ProcessorNode> processorNodes = new ArrayList<>(nodeFactories.size());
-        Map<String, ProcessorNode> processorMap = new HashMap<>();
-        Map<String, SourceNode> topicSourceMap = new HashMap<>();
-        Map<String, SinkNode> topicSinkMap = new HashMap<>();
-        Map<String, StateStore> stateStoreMap = new LinkedHashMap<>();
+    private ProcessorTopology build(final Set<String> nodeGroup) {
+        final List<ProcessorNode> processorNodes = new ArrayList<>(nodeFactories.size());
+        final Map<String, ProcessorNode> processorMap = new HashMap<>();
+        final Map<String, SourceNode> topicSourceMap = new HashMap<>();
+        final Map<String, SinkNode> topicSinkMap = new HashMap<>();
+        final Map<String, StateStore> stateStoreMap = new LinkedHashMap<>();
 
         // create processor nodes in a topological order ("nodeFactories" is already topologically sorted)
         for (NodeFactory factory : nodeFactories.values()) {
@@ -1033,7 +1053,7 @@ private ProcessorTopology build(Set<String> nodeGroup) {
 
                 if (factory instanceof ProcessorNodeFactory) {
                     for (String parent : ((ProcessorNodeFactory) factory).parents) {
-                        ProcessorNode<?, ?> parentNode = processorMap.get(parent);
+                        final ProcessorNode<?, ?> parentNode = processorMap.get(parent);
                         parentNode.addChild(node);
                     }
                     for (String stateStoreName : ((ProcessorNodeFactory) factory).stateStoreNames) {
@@ -1107,19 +1127,19 @@ public Map<String, StateStore> globalStateStores() {
      * @return groups of topic names
      */
     public synchronized Map<Integer, TopicsInfo> topicGroups() {
-        Map<Integer, TopicsInfo> topicGroups = new LinkedHashMap<>();
+        final Map<Integer, TopicsInfo> topicGroups = new LinkedHashMap<>();
 
         if (nodeGroups == null)
             nodeGroups = makeNodeGroups();
 
         for (Map.Entry<Integer, Set<String>> entry : nodeGroups.entrySet()) {
-            Set<String> sinkTopics = new HashSet<>();
-            Set<String> sourceTopics = new HashSet<>();
-            Map<String, InternalTopicConfig> internalSourceTopics = new HashMap<>();
-            Map<String, InternalTopicConfig> stateChangelogTopics = new HashMap<>();
+            final Set<String> sinkTopics = new HashSet<>();
+            final Set<String> sourceTopics = new HashSet<>();
+            final Map<String, InternalTopicConfig> internalSourceTopics = new HashMap<>();
+            final Map<String, InternalTopicConfig> stateChangelogTopics = new HashMap<>();
             for (String node : entry.getValue()) {
                 // if the node is a source node, add to the source topics
-                List<String> topics = nodeToSourceTopics.get(node);
+                final List<String> topics = nodeToSourceTopics.get(node);
                 if (topics != null) {
                     // if some of the topics are internal, add them to the internal topics
                     for (String topic : topics) {
@@ -1129,7 +1149,7 @@ public synchronized Map<Integer, TopicsInfo> topicGroups() {
                         }
                         if (this.internalTopicNames.contains(topic)) {
                             // prefix the internal topic name with the application id
-                            String internalTopic = decorateTopic(topic);
+                            final String internalTopic = decorateTopic(topic);
                             internalSourceTopics.put(internalTopic, new InternalTopicConfig(internalTopic,
                                                                                             Collections.singleton(InternalTopicConfig.CleanupPolicy.delete),
                                                                                             Collections.<String, String>emptyMap()));
@@ -1141,7 +1161,7 @@ public synchronized Map<Integer, TopicsInfo> topicGroups() {
                 }
 
                 // if the node is a sink node, add to the sink topics
-                String topic = nodeToSinkTopic.get(node);
+                final String topic = nodeToSinkTopic.get(node);
                 if (topic != null) {
                     if (internalTopicNames.contains(topic)) {
                         // prefix the change log topic name with the application id
@@ -1176,7 +1196,7 @@ public synchronized Map<Integer, TopicsInfo> topicGroups() {
     private void setRegexMatchedTopicsToSourceNodes() {
         if (subscriptionUpdates.hasUpdates()) {
             for (Map.Entry<String, Pattern> stringPatternEntry : nodeToSourcePatterns.entrySet()) {
-                SourceNodeFactory sourceNode = (SourceNodeFactory) nodeFactories.get(stringPatternEntry.getKey());
+                final SourceNodeFactory sourceNode = (SourceNodeFactory) nodeFactories.get(stringPatternEntry.getKey());
                 //need to update nodeToSourceTopics with topics matched from given regex
                 nodeToSourceTopics.put(stringPatternEntry.getKey(), sourceNode.getTopics(subscriptionUpdates.getUpdates()));
                 log.debug("nodeToSourceTopics {}", nodeToSourceTopics);
@@ -1184,6 +1204,28 @@ private void setRegexMatchedTopicsToSourceNodes() {
         }
     }
 
+    private void setRegexMatchedTopicToStateStore() {
+        if (subscriptionUpdates.hasUpdates()) {
+            for (Map.Entry<String, Set<Pattern>> storePattern : stateStoreNameToSourceRegex.entrySet()) {
+                final Set<String> updatedTopicsForStateStore = new HashSet<>();
+                for (String subscriptionUpdateTopic : subscriptionUpdates.getUpdates()) {
+                    for (Pattern pattern : storePattern.getValue()) {
+                        if (pattern.matcher(subscriptionUpdateTopic).matches()) {
+                            updatedTopicsForStateStore.add(subscriptionUpdateTopic);
+                        }
+                    }
+                }
+                if (!updatedTopicsForStateStore.isEmpty()) {
+                    Collection<String> storeTopics = stateStoreNameToSourceTopics.get(storePattern.getKey());
+                    if (storeTopics != null) {
+                        updatedTopicsForStateStore.addAll(storeTopics);
+                    }
+                    stateStoreNameToSourceTopics.put(storePattern.getKey(), Collections.unmodifiableSet(updatedTopicsForStateStore));
+                }
+            }
+        }
+    }
+    
     private InternalTopicConfig createInternalTopicConfig(final StateStoreSupplier<?> supplier, final String name) {
         if (!(supplier instanceof WindowStoreSupplier)) {
             return new InternalTopicConfig(name, Collections.singleton(InternalTopicConfig.CleanupPolicy.compact), supplier.logConfig());
@@ -1224,7 +1266,7 @@ public synchronized Pattern latestResetTopicsPattern() {
         return  latestPattern;
     }
 
-    private void ensureNoRegexOverlap(Pattern builtPattern, Set<Pattern> otherPatterns, Set<String> otherTopics) {
+    private void ensureNoRegexOverlap(final Pattern builtPattern, final Set<Pattern> otherPatterns, final Set<String> otherTopics) {
 
         for (Pattern otherPattern : otherPatterns) {
             if (builtPattern.pattern().contains(otherPattern.pattern())) {
@@ -1247,8 +1289,8 @@ private void ensureNoRegexOverlap(Pattern builtPattern, Set<Pattern> otherPatter
      * @param sourcePatterns Patterns for matching source topics to add to a composite pattern
      * @return a Pattern that is composed of the literal source topic names and any Patterns for matching source topics
      */
-    private static synchronized Pattern buildPatternForOffsetResetTopics(Collection<String> sourceTopics, Collection<Pattern> sourcePatterns) {
-        StringBuilder builder = new StringBuilder();
+    private static synchronized Pattern buildPatternForOffsetResetTopics(final Collection<String> sourceTopics, final Collection<Pattern> sourcePatterns) {
+        final StringBuilder builder = new StringBuilder();
 
         for (String topic : sourceTopics) {
             builder.append(topic).append("|");
@@ -1284,7 +1326,7 @@ public Map<String, List<String>> stateStoreNameToSourceTopics() {
      * @return groups of topic names
      */
     public synchronized Collection<Set<String>> copartitionGroups() {
-        List<Set<String>> list = new ArrayList<>(copartitionSourceGroups.size());
+        final List<Set<String>> list = new ArrayList<>(copartitionSourceGroups.size());
         for (Set<String> nodeNames : copartitionSourceGroups) {
             Set<String> copartitionGroup = new HashSet<>();
             for (String node : nodeNames) {
@@ -1309,7 +1351,7 @@ private List<String> maybeDecorateInternalSourceTopics(final Collection<String>
         return decoratedTopics;
     }
 
-    private String decorateTopic(String topic) {
+    private String decorateTopic(final String topic) {
         if (applicationId == null) {
             throw new TopologyBuilderException("there are internal topics and "
                     + "applicationId hasn't been set. Call "
@@ -1321,7 +1363,7 @@ private String decorateTopic(String topic) {
 
     public synchronized Pattern sourceTopicPattern() {
         if (this.topicPattern == null) {
-            List<String> allSourceTopics = new ArrayList<>();
+            final List<String> allSourceTopics = new ArrayList<>();
             if (!nodeToSourceTopics.isEmpty()) {
                 for (List<String> topics : nodeToSourceTopics.values()) {
                     allSourceTopics.addAll(maybeDecorateInternalSourceTopics(topics));
@@ -1335,9 +1377,10 @@ public synchronized Pattern sourceTopicPattern() {
         return this.topicPattern;
     }
 
-    public synchronized void updateSubscriptions(SubscriptionUpdates subscriptionUpdates, String threadId) {
+    public synchronized void updateSubscriptions(final SubscriptionUpdates subscriptionUpdates, final String threadId) {
         log.debug("stream-thread [{}] updating builder with {} topic(s) with possible matching regex subscription(s)", threadId, subscriptionUpdates);
         this.subscriptionUpdates = subscriptionUpdates;
         setRegexMatchedTopicsToSourceNodes();
+        setRegexMatchedTopicToStateStore();
     }
 }
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/RegexSourceIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/RegexSourceIntegrationTest.java
index 213fffe561332..0ea36ea6dd6cd 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/RegexSourceIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/RegexSourceIntegrationTest.java
@@ -32,12 +32,15 @@
 import org.apache.kafka.streams.integration.utils.IntegrationTestUtils;
 import org.apache.kafka.streams.kstream.KStream;
 import org.apache.kafka.streams.kstream.KStreamBuilder;
+import org.apache.kafka.streams.processor.ProcessorSupplier;
 import org.apache.kafka.streams.processor.TaskId;
 import org.apache.kafka.streams.processor.TopologyBuilder;
 import org.apache.kafka.streams.processor.internals.DefaultKafkaClientSupplier;
 import org.apache.kafka.streams.processor.internals.StreamTask;
 import org.apache.kafka.streams.processor.internals.StreamThread;
 import org.apache.kafka.streams.processor.internals.StreamsMetadataState;
+import org.apache.kafka.test.MockProcessorSupplier;
+import org.apache.kafka.test.MockStateStoreSupplier;
 import org.apache.kafka.test.StreamsTestUtils;
 import org.apache.kafka.test.TestCondition;
 import org.apache.kafka.test.TestUtils;
@@ -53,11 +56,13 @@
 import java.util.Collection;
 import java.util.Collections;
 import java.util.List;
+import java.util.Map;
 import java.util.Properties;
 import java.util.UUID;
 import java.util.regex.Pattern;
 
 import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.core.Is.is;
 import static org.junit.Assert.assertThat;
 import static org.junit.Assert.fail;
 
@@ -227,6 +232,31 @@ public boolean conditionMet() {
         streams.close();
     }
 
+    @Test
+    public void shouldAddStateStoreToRegexDefinedSource() throws Exception {
+
+        ProcessorSupplier<String, String> processorSupplier = new MockProcessorSupplier<>();
+        MockStateStoreSupplier stateStoreSupplier = new MockStateStoreSupplier("testStateStore", false);
+
+        TopologyBuilder builder = new TopologyBuilder()
+                .addSource("ingest", Pattern.compile("topic-\\d+"))
+                .addProcessor("my-processor", processorSupplier, "ingest")
+                .addStateStore(stateStoreSupplier, "my-processor");
+
+
+        final KafkaStreams streams = new KafkaStreams(builder, streamsConfiguration);
+        streams.start();
+
+        final Properties producerConfig = TestUtils.producerConfig(CLUSTER.bootstrapServers(), StringSerializer.class, StringSerializer.class);
+
+        IntegrationTestUtils.produceValuesSynchronously(TOPIC_1, Arrays.asList("message for test"), producerConfig, mockTime);
+        streams.close();
+
+        Map<String, List<String>> stateStoreToSourceTopic = builder.stateStoreNameToSourceTopics();
+
+        assertThat(stateStoreToSourceTopic.get("testStateStore").get(0), is("topic-1"));
+    }
+
 
     @Test
     public void testShouldReadFromRegexAndNamedTopics() throws Exception {
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/TopologyBuilderTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/TopologyBuilderTest.java
index 2f3a450f811ee..a4d94a190388f 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/TopologyBuilderTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/TopologyBuilderTest.java
@@ -50,6 +50,7 @@
 import static org.apache.kafka.common.utils.Utils.mkSet;
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertTrue;
+import static org.junit.Assert.assertFalse;
 
 public class TopologyBuilderTest {
 
@@ -610,4 +611,37 @@ public void shouldSetCorrectSourceNodesWithRegexUpdatedTopics() throws Exception
         assertTrue(topicGroups.get(2).sourceTopics.contains("topic-3"));
 
     }
+
+    @SuppressWarnings("unchecked")
+    @Test
+    public void shouldConnectRegexMatchedTopicsToStateStore() throws Exception {
+
+        final TopologyBuilder topologyBuilder = new TopologyBuilder()
+                .addSource("ingest", Pattern.compile("topic-\\d+"))
+                .addProcessor("my-processor", new MockProcessorSupplier(), "ingest")
+                .addStateStore(new MockStateStoreSupplier("testStateStore", false), "my-processor");
+
+        final StreamPartitionAssignor.SubscriptionUpdates subscriptionUpdates = new StreamPartitionAssignor.SubscriptionUpdates();
+        final Field updatedTopicsField  = subscriptionUpdates.getClass().getDeclaredField("updatedTopicSubscriptions");
+        updatedTopicsField.setAccessible(true);
+
+        final Set<String> updatedTopics = (Set<String>) updatedTopicsField.get(subscriptionUpdates);
+
+        updatedTopics.add("topic-2");
+        updatedTopics.add("topic-3");
+        updatedTopics.add("topic-A");
+
+        topologyBuilder.updateSubscriptions(subscriptionUpdates, "test-thread");
+        topologyBuilder.setApplicationId("test-app");
+
+        Map<String, List<String>> stateStoreAndTopics = topologyBuilder.stateStoreNameToSourceTopics();
+        List<String> topics = stateStoreAndTopics.get("testStateStore");
+
+        assertTrue("Expected to contain two topics", topics.size() == 2);
+
+        assertTrue(topics.contains("topic-2"));
+        assertTrue(topics.contains("topic-3"));
+        assertFalse(topics.contains("topic-A"));
+    }
+
 }

From e3c5f41229f1cd07bd5645e596348ebb14c02370 Mon Sep 17 00:00:00 2001
From: Jason Gustafson <jason@confluent.io>
Date: Thu, 30 Mar 2017 23:52:03 +0100
Subject: [PATCH 144/177] KAFKA-4689; Disable system tests for consumer hard
 failures

See the JIRA for the full details. Essentially the test assertions depend on receiving reliable events from the consumer processes, but this is not generally possible in the presence of a hard failure (i.e. `kill -9`). Until we solve this problem, the hard failure scenarios will be turned off.

Author: Jason Gustafson <jason@confluent.io>

Reviewers: Apurva Mehta <apurva@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2771 from hachikuji/KAFKA-4689

(cherry picked from commit 93d451ceeb00a150bbbdae3f0601620b902b7c87)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 tests/kafkatest/tests/client/consumer_test.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/kafkatest/tests/client/consumer_test.py b/tests/kafkatest/tests/client/consumer_test.py
index 9c55955f00734..9eb5ab6890e6b 100644
--- a/tests/kafkatest/tests/client/consumer_test.py
+++ b/tests/kafkatest/tests/client/consumer_test.py
@@ -116,7 +116,7 @@ def test_broker_rolling_bounce(self):
             "Total consumed records did not match consumed position"
 
     @cluster(num_nodes=7)
-    @matrix(clean_shutdown=[True, False], bounce_mode=["all", "rolling"])
+    @matrix(clean_shutdown=[True], bounce_mode=["all", "rolling"])
     def test_consumer_bounce(self, clean_shutdown, bounce_mode):
         """
         Verify correct consumer behavior when the consumers in the group are consecutively restarted.
@@ -159,7 +159,7 @@ def test_consumer_bounce(self, clean_shutdown, bounce_mode):
                 (consumer.current_position(partition), consumer.total_consumed())
 
     @cluster(num_nodes=7)
-    @matrix(clean_shutdown=[True, False], enable_autocommit=[True, False])
+    @matrix(clean_shutdown=[True], enable_autocommit=[True, False])
     def test_consumer_failure(self, clean_shutdown, enable_autocommit):
         partition = TopicPartition(self.TOPIC, 0)
         

From 76f8028d9d6473e6ec084e4258bf0e2d84f8a428 Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno@confluent.io>
Date: Thu, 30 Mar 2017 15:58:24 -0700
Subject: [PATCH 145/177] MINOR: Increase max.poll time for streams consumers

Author: Eno Thereska <eno@confluent.io>

Reviewers: Damian Guy, Matthias J. Sax, Guozhang Wang

Closes #2770 from enothereska/minor-increase-max-poll

(cherry picked from commit 5f88cf79fb51996e77614aafdfbb15e4989e159b)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../main/java/org/apache/kafka/streams/StreamsConfig.java  | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java b/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java
index 57db027e83ea0..3d22742a781a8 100644
--- a/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java
+++ b/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java
@@ -404,6 +404,13 @@ public class StreamsConfig extends AbstractConfig {
         tempConsumerDefaultOverrides.put(ConsumerConfig.MAX_POLL_RECORDS_CONFIG, "1000");
         tempConsumerDefaultOverrides.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
         tempConsumerDefaultOverrides.put(ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG, "false");
+        // MAX_POLL_INTERVAL_MS_CONFIG needs to be large for streams to handle cases when
+        // streams is recovering data from state stores. We may set it to Integer.MAX_VALUE since
+        // the streams code itself catches most exceptions and acts accordingly without needing
+        // this timeout. Note however that deadlocks are not detected (by definition) so we
+        // are losing the ability to detect them by setting this value to large. Hopefully
+        // deadlocks happen very rarely or never.
+        tempConsumerDefaultOverrides.put(ConsumerConfig.MAX_POLL_INTERVAL_MS_CONFIG, Integer.toString(Integer.MAX_VALUE));
 
         CONSUMER_DEFAULT_OVERRIDES = Collections.unmodifiableMap(tempConsumerDefaultOverrides);
     }

From 5b8541e5e3b61d483f03993a38942df2831d6f08 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Sat, 1 Apr 2017 14:31:27 +0100
Subject: [PATCH 146/177] MINOR: Add jenkins.sh to 0.10.2 branch

This is necessary so that the PR builder works
on PRs that target the 0.10.2 branch.

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2782 from mjsax/minor-fix-build-script
---
 jenkins.sh | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100755 jenkins.sh

diff --git a/jenkins.sh b/jenkins.sh
new file mode 100755
index 0000000000000..a21da0546874d
--- /dev/null
+++ b/jenkins.sh
@@ -0,0 +1,20 @@
+#!/bin/bash
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This script is used for verifying changes in Jenkins. In order to provide faster feedback, the tasks are ordered so
+# that faster tasks are executed in every module before slower tasks (if possible). For example, the unit tests for all
+# the modules are executed before the integration tests.
+./gradlew clean compileJava compileScala compileTestJava compileTestScala checkstyleMain checkstyleTest test --no-daemon -Dorg.gradle.project.testLoggingEvents=started,passed,skipped,failed "$@"

From d9db9ee0722369b69c7117f5ceb7a0b5ad404118 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Mon, 3 Apr 2017 13:09:10 -0700
Subject: [PATCH 147/177] KAFKA-4878: Improved Invalid Connect Config Error
 Message

Addresses for https://issues.apache.org/jira/browse/KAFKA-4878

* Adjusted the error message to explicitly state errors and their number
* Dried up the logic for generating the message between standalone and distributed

Example

messed up two config keys in the file source config:
````
namse=local-file-source
connector.class=FileStreamSource
tasks.max=1
fisle=test.txt
topic=connect-test
```

Produces:

```
[2017-03-22 08:57:11,896] ERROR Stopping after connector error (org.apache.kafka.connect.cli.ConnectStandalone:99)
java.util.concurrent.ExecutionException: org.apache.kafka.connect.runtime.rest.errors.BadRequestException: Connector configuration is invalid and contains the following 2 error(s):
Missing required configuration "file" which has no default value.
Missing required configuration "name" which has no default value.
You can also find the above list of errors at the endpoint `/{connectorType}/config/validate`
```

Author: Armin Braun <me@obrown.io>

Reviewers: Gwen Shapira, Konstantine Karantasis, Ewen Cheslack-Postava

Closes #2722 from original-brownbear/KAFKA-4878

(cherry picked from commit 040fde8ec1f94856799c6bb47fa23a73c20bda66)
Signed-off-by: Gwen Shapira <cshapi@gmail.com>
---
 .../kafka/connect/runtime/AbstractHerder.java | 36 ++++++++++++++++
 .../distributed/DistributedHerder.java        |  7 +---
 .../runtime/standalone/StandaloneHerder.java  |  8 +---
 .../standalone/StandaloneHerderTest.java      | 41 +++++++++++++++++++
 4 files changed, 80 insertions(+), 12 deletions(-)

diff --git a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/AbstractHerder.java b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/AbstractHerder.java
index cbcf14c331956..0dcb0b9b6747e 100644
--- a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/AbstractHerder.java
+++ b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/AbstractHerder.java
@@ -27,11 +27,13 @@
 import org.apache.kafka.connect.runtime.rest.entities.ConfigInfos;
 import org.apache.kafka.connect.runtime.rest.entities.ConfigKeyInfo;
 import org.apache.kafka.connect.runtime.rest.entities.ConfigValueInfo;
+import org.apache.kafka.connect.runtime.rest.entities.ConnectorInfo;
 import org.apache.kafka.connect.runtime.rest.entities.ConnectorStateInfo;
 import org.apache.kafka.connect.runtime.rest.errors.BadRequestException;
 import org.apache.kafka.connect.source.SourceConnector;
 import org.apache.kafka.connect.storage.ConfigBackingStore;
 import org.apache.kafka.connect.storage.StatusBackingStore;
+import org.apache.kafka.connect.util.Callback;
 import org.apache.kafka.connect.util.ConnectorTaskId;
 
 import java.io.ByteArrayOutputStream;
@@ -337,6 +339,40 @@ protected Connector getConnector(String connType) {
         }
     }
 
+    /**
+     * Checks a given {@link ConfigInfos} for validation error messages and adds an exception
+     * to the given {@link Callback} if any were found.
+     *
+     * @param configInfos configInfos to read Errors from
+     * @param callback callback to add config error exception to
+     * @return true if errors were found in the config
+     */
+    protected final boolean maybeAddConfigErrors(
+        ConfigInfos configInfos,
+        Callback<Created<ConnectorInfo>> callback
+    ) {
+        int errors = configInfos.errorCount();
+        boolean hasErrors = errors > 0;
+        if (hasErrors) {
+            StringBuilder messages = new StringBuilder();
+            messages.append("Connector configuration is invalid and contains the following ")
+                .append(errors).append(" error(s):");
+            for (ConfigInfo configInfo : configInfos.values()) {
+                for (String msg : configInfo.configValue().errors()) {
+                    messages.append('\n').append(msg);
+                }
+            }
+            callback.onCompletion(
+                new BadRequestException(
+                    messages.append(
+                        "\nYou can also find the above list of errors at the endpoint `/{connectorType}/config/validate`"
+                    ).toString()
+                ), null
+            );
+        }
+        return hasErrors;
+    }
+
     private String trace(Throwable t) {
         ByteArrayOutputStream output = new ByteArrayOutputStream();
         t.printStackTrace(new PrintStream(output));
diff --git a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/distributed/DistributedHerder.java b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/distributed/DistributedHerder.java
index 25dfc6bedc6b8..47bd0c4c7a76a 100644
--- a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/distributed/DistributedHerder.java
+++ b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/distributed/DistributedHerder.java
@@ -35,10 +35,8 @@
 import org.apache.kafka.connect.runtime.TargetState;
 import org.apache.kafka.connect.runtime.Worker;
 import org.apache.kafka.connect.runtime.rest.RestServer;
-import org.apache.kafka.connect.runtime.rest.entities.ConfigInfos;
 import org.apache.kafka.connect.runtime.rest.entities.ConnectorInfo;
 import org.apache.kafka.connect.runtime.rest.entities.TaskInfo;
-import org.apache.kafka.connect.runtime.rest.errors.BadRequestException;
 import org.apache.kafka.connect.sink.SinkConnector;
 import org.apache.kafka.connect.storage.ConfigBackingStore;
 import org.apache.kafka.connect.storage.StatusBackingStore;
@@ -507,10 +505,7 @@ public void putConnectorConfig(final String connName, final Map<String, String>
                 new Callable<Void>() {
                     @Override
                     public Void call() throws Exception {
-                        ConfigInfos validatedConfig = validateConnectorConfig(config);
-                        if (validatedConfig.errorCount() > 0) {
-                            callback.onCompletion(new BadRequestException("Connector configuration is invalid " +
-                                    "(use the endpoint `/{connectorType}/config/validate` to get a full list of errors)"), null);
+                        if (maybeAddConfigErrors(validateConnectorConfig(config), callback)) {
                             return null;
                         }
 
diff --git a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/standalone/StandaloneHerder.java b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/standalone/StandaloneHerder.java
index ff09c1cde16ea..6aec9c965e835 100644
--- a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/standalone/StandaloneHerder.java
+++ b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/standalone/StandaloneHerder.java
@@ -28,10 +28,8 @@
 import org.apache.kafka.connect.runtime.TargetState;
 import org.apache.kafka.connect.runtime.Worker;
 import org.apache.kafka.connect.runtime.distributed.ClusterConfigState;
-import org.apache.kafka.connect.runtime.rest.entities.ConfigInfos;
 import org.apache.kafka.connect.runtime.rest.entities.ConnectorInfo;
 import org.apache.kafka.connect.runtime.rest.entities.TaskInfo;
-import org.apache.kafka.connect.runtime.rest.errors.BadRequestException;
 import org.apache.kafka.connect.storage.ConfigBackingStore;
 import org.apache.kafka.connect.storage.MemoryConfigBackingStore;
 import org.apache.kafka.connect.storage.MemoryStatusBackingStore;
@@ -46,6 +44,7 @@
 import java.util.List;
 import java.util.Map;
 
+
 /**
  * Single process, in-memory "herder". Useful for a standalone Kafka Connect process.
  */
@@ -156,10 +155,7 @@ public synchronized void putConnectorConfig(String connName,
                                                 boolean allowReplace,
                                                 final Callback<Created<ConnectorInfo>> callback) {
         try {
-            ConfigInfos validatedConfig = validateConnectorConfig(config);
-            if (validatedConfig.errorCount() > 0) {
-                callback.onCompletion(new BadRequestException("Connector configuration is invalid " +
-                        "(use the endpoint `/{connectorType}/config/validate` to get a full list of errors)"), null);
+            if (maybeAddConfigErrors(validateConnectorConfig(config), callback)) {
                 return;
             }
 
diff --git a/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/standalone/StandaloneHerderTest.java b/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/standalone/StandaloneHerderTest.java
index e05aa41299b92..9092f523fe898 100644
--- a/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/standalone/StandaloneHerderTest.java
+++ b/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/standalone/StandaloneHerderTest.java
@@ -57,6 +57,7 @@
 import org.powermock.api.easymock.annotation.Mock;
 import org.powermock.modules.junit4.PowerMockRunner;
 
+import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collection;
 import java.util.Collections;
@@ -485,6 +486,46 @@ public void testPutTaskConfigs() {
         PowerMock.verifyAll();
     }
 
+    @Test
+    public void testCorruptConfig() {
+        Map<String, String> config = new HashMap<>();
+        config.put(ConnectorConfig.NAME_CONFIG, CONNECTOR_NAME);
+        config.put(ConnectorConfig.CONNECTOR_CLASS_CONFIG, BogusSinkConnector.class.getName());
+        Connector connectorMock = PowerMock.createMock(Connector.class);
+        String error = "This is an error in your config!";
+        List<String> errors = new ArrayList<>(singletonList(error));
+        String key = "foo.invalid.key";
+        EasyMock.expect(connectorMock.validate(config)).andReturn(
+            new Config(
+                Arrays.asList(new ConfigValue(key, null, Collections.emptyList(), errors))
+            )
+        );
+        ConfigDef configDef = new ConfigDef();
+        configDef.define(key, ConfigDef.Type.STRING, ConfigDef.Importance.HIGH, "");
+        EasyMock.expect(connectorMock.config()).andStubReturn(configDef);
+        ConnectorFactory connectorFactoryMock = PowerMock.createMock(ConnectorFactory.class);
+        EasyMock.expect(worker.getConnectorFactory()).andStubReturn(connectorFactoryMock);
+        EasyMock.expect(connectorFactoryMock.newConnector(EasyMock.anyString()))
+            .andReturn(connectorMock);
+        Callback<Herder.Created<ConnectorInfo>> callback = PowerMock.createMock(Callback.class);
+        Capture<BadRequestException> capture = Capture.newInstance();
+        callback.onCompletion(
+            EasyMock.capture(capture), EasyMock.isNull(Herder.Created.class)
+        );
+
+        PowerMock.replayAll();
+
+        herder.putConnectorConfig(CONNECTOR_NAME, config, true, callback);
+        assertEquals(
+            capture.getValue().getMessage(),
+            "Connector configuration is invalid and contains the following 1 error(s):\n" +
+                error + "\n" +
+                "You can also find the above list of errors at the endpoint `/{connectorType}/config/validate`"
+        );
+
+        PowerMock.verifyAll();
+    }
+
     private void expectAdd(SourceSink sourceSink) throws Exception {
 
         Map<String, String> connectorProps = connectorConfig(sourceSink);

From 8c0005740ab8936382559149332af9cb02391f00 Mon Sep 17 00:00:00 2001
From: Konstantine Karantasis <konstantine@confluent.io>
Date: Tue, 4 Apr 2017 15:07:32 -0700
Subject: [PATCH 148/177] KAFKA-4837: Fix class name comparison in
 connector-plugins REST endpoint

Author: Konstantine Karantasis <konstantine@confluent.io>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2798 from kkonstantine/KAFKA-4837-Config-validation-in-Connector-plugins-need-to-compare-against-both-canonical-and-simple-class-names

(cherry picked from commit 9160810072e540a3a037481505aaaa23e3b50546)
Signed-off-by: Ewen Cheslack-Postava <me@ewencp.org>
---
 .../resources/ConnectorPluginsResource.java   |  23 +-
 .../ConnectorPluginsResourceTest.java         | 215 +++++++++++++++++-
 2 files changed, 224 insertions(+), 14 deletions(-)

diff --git a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/rest/resources/ConnectorPluginsResource.java b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/rest/resources/ConnectorPluginsResource.java
index 0d208022c3cb7..4e3e8e46c5c47 100644
--- a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/rest/resources/ConnectorPluginsResource.java
+++ b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/rest/resources/ConnectorPluginsResource.java
@@ -40,6 +40,7 @@
 @Consumes(MediaType.APPLICATION_JSON)
 public class ConnectorPluginsResource {
 
+    private static final String ALIAS_SUFFIX = "Connector";
     private final Herder herder;
 
     public ConnectorPluginsResource(Herder herder) {
@@ -48,11 +49,18 @@ public ConnectorPluginsResource(Herder herder) {
 
     @PUT
     @Path("/{connectorType}/config/validate")
-    public ConfigInfos validateConfigs(final @PathParam("connectorType") String connType,
-                                       final Map<String, String> connectorConfig) throws Throwable {
+    public ConfigInfos validateConfigs(
+        final @PathParam("connectorType") String connType,
+        final Map<String, String> connectorConfig
+    ) throws Throwable {
         String includedConnType = connectorConfig.get(ConnectorConfig.CONNECTOR_CLASS_CONFIG);
-        if (includedConnType != null && !includedConnType.equals(connType))
-            throw new BadRequestException("Included connector type " + includedConnType + " does not match request type " + connType);
+        if (includedConnType != null
+            && !normalizedPluginName(includedConnType).endsWith(normalizedPluginName(connType))) {
+            throw new BadRequestException(
+                "Included connector type " + includedConnType + " does not match request type "
+                    + connType
+            );
+        }
 
         return herder.validateConnectorConfig(connectorConfig);
     }
@@ -62,4 +70,11 @@ public ConfigInfos validateConfigs(final @PathParam("connectorType") String conn
     public List<ConnectorPluginInfo> listConnectorPlugins() {
         return PluginDiscovery.connectorPlugins();
     }
+
+    private String normalizedPluginName(String pluginName) {
+        // Works for both full and simple class names. In the latter case, it generates the alias.
+        return pluginName.endsWith(ALIAS_SUFFIX) && pluginName.length() > ALIAS_SUFFIX.length()
+            ? pluginName.substring(0, pluginName.length() - ALIAS_SUFFIX.length())
+            : pluginName;
+    }
 }
diff --git a/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/rest/resources/ConnectorPluginsResourceTest.java b/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/rest/resources/ConnectorPluginsResourceTest.java
index b974559ae0499..b02b8438d9532 100644
--- a/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/rest/resources/ConnectorPluginsResourceTest.java
+++ b/connect/runtime/src/test/java/org/apache/kafka/connect/runtime/rest/resources/ConnectorPluginsResourceTest.java
@@ -65,6 +65,8 @@
 import java.util.Map;
 import java.util.Set;
 
+import javax.ws.rs.BadRequestException;
+
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertFalse;
 import static org.junit.Assert.assertTrue;
@@ -74,46 +76,61 @@
 @PowerMockIgnore("javax.management.*")
 public class ConnectorPluginsResourceTest {
 
-    private static Map<String, String> props = new HashMap<>();
+    private static Map<String, String> props;
+    private static Map<String, String> partialProps = new HashMap<>();
     static {
-        props.put("name", "test");
-        props.put("test.string.config", "testString");
-        props.put("test.int.config", "1");
-        props.put("test.list.config", "a,b");
+        partialProps.put("name", "test");
+        partialProps.put("test.string.config", "testString");
+        partialProps.put("test.int.config", "1");
+        partialProps.put("test.list.config", "a,b");
+
+        props = new HashMap<>(partialProps);
+        props.put("connector.class", ConnectorPluginsResourceTestConnector.class.getSimpleName());
     }
 
     private static final ConfigInfos CONFIG_INFOS;
-    private static final int ERROR_COUNT = 1;
+    private static final ConfigInfos PARTIAL_CONFIG_INFOS;
+    private static final int ERROR_COUNT = 0;
+    private static final int PARTIAL_CONFIG_ERROR_COUNT = 1;
 
     static {
         List<ConfigInfo> configs = new LinkedList<>();
+        List<ConfigInfo> partialConfigs = new LinkedList<>();
 
         ConfigDef connectorConfigDef = ConnectorConfig.configDef();
         List<ConfigValue> connectorConfigValues = connectorConfigDef.validate(props);
+        List<ConfigValue> partialConnectorConfigValues = connectorConfigDef.validate(partialProps);
         ConfigInfos result = AbstractHerder.generateResult(ConnectorPluginsResourceTestConnector.class.getName(), connectorConfigDef.configKeys(), connectorConfigValues, Collections.<String>emptyList());
+        ConfigInfos partialResult = AbstractHerder.generateResult(ConnectorPluginsResourceTestConnector.class.getName(), connectorConfigDef.configKeys(), partialConnectorConfigValues, Collections.<String>emptyList());
         configs.addAll(result.values());
+        partialConfigs.addAll(partialResult.values());
 
         ConfigKeyInfo configKeyInfo = new ConfigKeyInfo("test.string.config", "STRING", true, "", "HIGH", "Test configuration for string type.", null, -1, "NONE", "test.string.config", Collections.<String>emptyList());
         ConfigValueInfo configValueInfo = new ConfigValueInfo("test.string.config", "testString", Collections.<String>emptyList(), Collections.<String>emptyList(), true);
         ConfigInfo configInfo = new ConfigInfo(configKeyInfo, configValueInfo);
         configs.add(configInfo);
+        partialConfigs.add(configInfo);
 
         configKeyInfo = new ConfigKeyInfo("test.int.config", "INT", true, "", "MEDIUM", "Test configuration for integer type.", "Test", 1, "MEDIUM", "test.int.config", Collections.<String>emptyList());
         configValueInfo = new ConfigValueInfo("test.int.config", "1", Arrays.asList("1", "2", "3"), Collections.<String>emptyList(), true);
         configInfo = new ConfigInfo(configKeyInfo, configValueInfo);
         configs.add(configInfo);
+        partialConfigs.add(configInfo);
 
         configKeyInfo = new ConfigKeyInfo("test.string.config.default", "STRING", false, "", "LOW", "Test configuration with default value.", null, -1, "NONE", "test.string.config.default", Collections.<String>emptyList());
         configValueInfo = new ConfigValueInfo("test.string.config.default", "", Collections.<String>emptyList(), Collections.<String>emptyList(), true);
         configInfo = new ConfigInfo(configKeyInfo, configValueInfo);
         configs.add(configInfo);
+        partialConfigs.add(configInfo);
 
         configKeyInfo = new ConfigKeyInfo("test.list.config", "LIST", true, "", "HIGH", "Test configuration for list type.", "Test", 2, "LONG", "test.list.config", Collections.<String>emptyList());
         configValueInfo = new ConfigValueInfo("test.list.config", "a,b", Arrays.asList("a", "b", "c"), Collections.<String>emptyList(), true);
         configInfo = new ConfigInfo(configKeyInfo, configValueInfo);
         configs.add(configInfo);
+        partialConfigs.add(configInfo);
 
         CONFIG_INFOS = new ConfigInfos(ConnectorPluginsResourceTestConnector.class.getName(), ERROR_COUNT, Collections.singletonList("Test"), configs);
+        PARTIAL_CONFIG_INFOS = new ConfigInfos(ConnectorPluginsResourceTestConnector.class.getName(), PARTIAL_CONFIG_ERROR_COUNT, Collections.singletonList("Test"), partialConfigs);
     }
 
     @Mock
@@ -128,7 +145,55 @@ public void setUp() throws NoSuchMethodException {
     }
 
     @Test
-    public void testValidateConfig() throws Throwable {
+    public void testValidateConfigWithSingleErrorDueToMissingConnectorClassname() throws Throwable {
+        herder.validateConnectorConfig(EasyMock.eq(partialProps));
+
+        PowerMock.expectLastCall().andAnswer(new IAnswer<ConfigInfos>() {
+            @Override
+            public ConfigInfos answer() {
+                ConfigDef connectorConfigDef = ConnectorConfig.configDef();
+                List<ConfigValue> connectorConfigValues = connectorConfigDef.validate(partialProps);
+
+                Connector connector = new ConnectorPluginsResourceTestConnector();
+                Config config = connector.validate(partialProps);
+                ConfigDef configDef = connector.config();
+                Map<String, ConfigDef.ConfigKey> configKeys = configDef.configKeys();
+                List<ConfigValue> configValues = config.configValues();
+
+                Map<String, ConfigDef.ConfigKey> resultConfigKeys = new HashMap<>(configKeys);
+                resultConfigKeys.putAll(connectorConfigDef.configKeys());
+                configValues.addAll(connectorConfigValues);
+
+                return AbstractHerder.generateResult(
+                    ConnectorPluginsResourceTestConnector.class.getName(),
+                    resultConfigKeys,
+                    configValues,
+                    Collections.singletonList("Test")
+                );
+            }
+        });
+
+        PowerMock.replayAll();
+
+        // This call to validateConfigs does not throw a BadRequestException because we've mocked
+        // validateConnectorConfig.
+        ConfigInfos configInfos = connectorPluginsResource.validateConfigs(
+            ConnectorPluginsResourceTestConnector.class.getSimpleName(),
+            partialProps
+        );
+        assertEquals(PARTIAL_CONFIG_INFOS.name(), configInfos.name());
+        assertEquals(PARTIAL_CONFIG_INFOS.errorCount(), configInfos.errorCount());
+        assertEquals(PARTIAL_CONFIG_INFOS.groups(), configInfos.groups());
+        assertEquals(
+            new HashSet<>(PARTIAL_CONFIG_INFOS.values()),
+            new HashSet<>(configInfos.values())
+        );
+
+        PowerMock.verifyAll();
+    }
+
+    @Test
+    public void testValidateConfigWithSimpleName() throws Throwable {
         herder.validateConnectorConfig(EasyMock.eq(props));
 
         PowerMock.expectLastCall().andAnswer(new IAnswer<ConfigInfos>() {
@@ -147,20 +212,150 @@ public ConfigInfos answer() {
                 resultConfigKeys.putAll(connectorConfigDef.configKeys());
                 configValues.addAll(connectorConfigValues);
 
-                return AbstractHerder.generateResult(ConnectorPluginsResourceTestConnector.class.getName(), resultConfigKeys, configValues, Collections.singletonList("Test"));
+                return AbstractHerder.generateResult(
+                    ConnectorPluginsResourceTestConnector.class.getName(),
+                    resultConfigKeys,
+                    configValues,
+                    Collections.singletonList("Test")
+                );
             }
         });
+
         PowerMock.replayAll();
 
-        ConfigInfos configInfos = connectorPluginsResource.validateConfigs(ConnectorPluginsResourceTestConnector.class.getName(), props);
+        // make a request to connector-plugins resource using just the simple class name.
+        ConfigInfos configInfos = connectorPluginsResource.validateConfigs(
+            ConnectorPluginsResourceTestConnector.class.getSimpleName(),
+            props
+        );
         assertEquals(CONFIG_INFOS.name(), configInfos.name());
-        assertEquals(CONFIG_INFOS.errorCount(), configInfos.errorCount());
+        assertEquals(0, configInfos.errorCount());
         assertEquals(CONFIG_INFOS.groups(), configInfos.groups());
         assertEquals(new HashSet<>(CONFIG_INFOS.values()), new HashSet<>(configInfos.values()));
 
         PowerMock.verifyAll();
     }
 
+    @Test
+    public void testValidateConfigWithAlias() throws Throwable {
+        herder.validateConnectorConfig(EasyMock.eq(props));
+
+        PowerMock.expectLastCall().andAnswer(new IAnswer<ConfigInfos>() {
+            @Override
+            public ConfigInfos answer() {
+                ConfigDef connectorConfigDef = ConnectorConfig.configDef();
+                List<ConfigValue> connectorConfigValues = connectorConfigDef.validate(props);
+
+                Connector connector = new ConnectorPluginsResourceTestConnector();
+                Config config = connector.validate(props);
+                ConfigDef configDef = connector.config();
+                Map<String, ConfigDef.ConfigKey> configKeys = configDef.configKeys();
+                List<ConfigValue> configValues = config.configValues();
+
+                Map<String, ConfigDef.ConfigKey> resultConfigKeys = new HashMap<>(configKeys);
+                resultConfigKeys.putAll(connectorConfigDef.configKeys());
+                configValues.addAll(connectorConfigValues);
+
+                return AbstractHerder.generateResult(
+                    ConnectorPluginsResourceTestConnector.class.getName(),
+                    resultConfigKeys,
+                    configValues,
+                    Collections.singletonList("Test")
+                );
+            }
+        });
+
+        PowerMock.replayAll();
+
+        // make a request to connector-plugins resource using a valid alias.
+        ConfigInfos configInfos = connectorPluginsResource.validateConfigs(
+            "ConnectorPluginsResourceTest",
+            props
+        );
+        assertEquals(CONFIG_INFOS.name(), configInfos.name());
+        assertEquals(0, configInfos.errorCount());
+        assertEquals(CONFIG_INFOS.groups(), configInfos.groups());
+        assertEquals(new HashSet<>(CONFIG_INFOS.values()), new HashSet<>(configInfos.values()));
+
+        PowerMock.verifyAll();
+    }
+
+    @Test(expected = BadRequestException.class)
+    public void testValidateConfigWithNonExistentName() throws Throwable {
+        herder.validateConnectorConfig(EasyMock.eq(props));
+
+        PowerMock.expectLastCall().andAnswer(new IAnswer<ConfigInfos>() {
+            @Override
+            public ConfigInfos answer() {
+                ConfigDef connectorConfigDef = ConnectorConfig.configDef();
+                List<ConfigValue> connectorConfigValues = connectorConfigDef.validate(props);
+
+                Connector connector = new ConnectorPluginsResourceTestConnector();
+                Config config = connector.validate(props);
+                ConfigDef configDef = connector.config();
+                Map<String, ConfigDef.ConfigKey> configKeys = configDef.configKeys();
+                List<ConfigValue> configValues = config.configValues();
+
+                Map<String, ConfigDef.ConfigKey> resultConfigKeys = new HashMap<>(configKeys);
+                resultConfigKeys.putAll(connectorConfigDef.configKeys());
+                configValues.addAll(connectorConfigValues);
+
+                return AbstractHerder.generateResult(
+                    ConnectorPluginsResourceTestConnector.class.getName(),
+                    resultConfigKeys,
+                    configValues,
+                    Collections.singletonList("Test")
+                );
+            }
+        });
+
+        PowerMock.replayAll();
+
+        // make a request to connector-plugins resource using a non-loaded connector with the same
+        // simple name but different package.
+        String customClassname = "com.custom.package."
+            + ConnectorPluginsResourceTestConnector.class.getSimpleName();
+        connectorPluginsResource.validateConfigs(customClassname, props);
+
+        PowerMock.verifyAll();
+    }
+
+    @Test(expected = BadRequestException.class)
+    public void testValidateConfigWithNonExistentAlias() throws Throwable {
+        herder.validateConnectorConfig(EasyMock.eq(props));
+
+        PowerMock.expectLastCall().andAnswer(new IAnswer<ConfigInfos>() {
+            @Override
+            public ConfigInfos answer() {
+                ConfigDef connectorConfigDef = ConnectorConfig.configDef();
+                List<ConfigValue> connectorConfigValues = connectorConfigDef.validate(props);
+
+                Connector connector = new ConnectorPluginsResourceTestConnector();
+                Config config = connector.validate(props);
+                ConfigDef configDef = connector.config();
+                Map<String, ConfigDef.ConfigKey> configKeys = configDef.configKeys();
+                List<ConfigValue> configValues = config.configValues();
+
+                Map<String, ConfigDef.ConfigKey> resultConfigKeys = new HashMap<>(configKeys);
+                resultConfigKeys.putAll(connectorConfigDef.configKeys());
+                configValues.addAll(connectorConfigValues);
+
+                return AbstractHerder.generateResult(
+                    ConnectorPluginsResourceTestConnector.class.getName(),
+                    resultConfigKeys,
+                    configValues,
+                    Collections.singletonList("Test")
+                );
+            }
+        });
+
+        PowerMock.replayAll();
+
+        connectorPluginsResource.validateConfigs("ConnectorPluginsTest", props);
+
+        PowerMock.verifyAll();
+    }
+
     @Test
     public void testListConnectorPlugins() {
         Set<ConnectorPluginInfo> connectorPlugins = new HashSet<>(connectorPluginsResource.listConnectorPlugins());

From 444110eacb88a5f6cffbdb3a773f5d50eca2aea8 Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno@confluent.io>
Date: Tue, 4 Apr 2017 15:12:25 -0700
Subject: [PATCH 149/177] MINOR: don't throw CommitFailedException during
 suspendTasksAndState

Cherrypicked from trunk https://github.com/apache/kafka/pull/2535

Author: Eno Thereska <eno@confluent.io>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2804 from enothereska/CommitFailedException-0.10.2
---
 .../kafka/streams/processor/internals/StreamThread.java       | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
index 70c139241015c..d053431bd7cdb 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
@@ -478,7 +478,9 @@ private void suspendTasksAndState()  {
         firstException.compareAndSet(null, flushAllState());
         // only commit after all state has been flushed and there hasn't been an exception
         if (firstException.get() == null) {
-            firstException.set(commitOffsets());
+            // TODO: currently commit failures will not be thrown to users
+            // while suspending tasks; this need to be re-visit after KIP-98
+            commitOffsets();
         }
         // remove the changelog partitions from restore consumer
         firstException.compareAndSet(null, unAssignChangeLogPartitions());

From 5a57913d57d8b9dc061688f787a5bef9be626361 Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno@confluent.io>
Date: Tue, 4 Apr 2017 16:27:48 -0700
Subject: [PATCH 150/177] MINOR: improve MinTimestampTrackerTest and fix NPE
 when null element

Cherry picked from trunk fix https://github.com/apache/kafka/pull/2611

Author: Eno Thereska <eno@confluent.io>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2803 from enothereska/fix_NPE_0.10.2
---
 .../internals/MinTimestampTracker.java        |  20 ++--
 .../internals/MinTimestampTrackerTest.java    | 107 ++++++++----------
 2 files changed, 59 insertions(+), 68 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/MinTimestampTracker.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/MinTimestampTracker.java
index 655b8b8551dac..bfe98abff51af 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/MinTimestampTracker.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/MinTimestampTracker.java
@@ -1,10 +1,10 @@
 /**
  * Licensed to the Apache Software Foundation (ASF) under one or more
- * contributor license agreements.  See the NOTICE file distributed with
+ * contributor license agreements. See the NOTICE file distributed with
  * this work for additional information regarding copyright ownership.
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
- * the License.  You may obtain a copy of the License at
+ * the License. You may obtain a copy of the License at
  *
  *    http://www.apache.org/licenses/LICENSE-2.0
  *
@@ -14,7 +14,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-
 package org.apache.kafka.streams.processor.internals;
 
 import java.util.LinkedList;
@@ -35,7 +34,7 @@ public class MinTimestampTracker<E> implements TimestampTracker<E> {
     /**
      * @throws NullPointerException if the element is null
      */
-    public void addElement(Stamped<E> elem) {
+    public void addElement(final Stamped<E> elem) {
         if (elem == null) throw new NullPointerException();
 
         Stamped<E> minElem = descendingSubsequence.peekLast();
@@ -46,12 +45,19 @@ public void addElement(Stamped<E> elem) {
         descendingSubsequence.offerLast(elem);
     }
 
-    public void removeElement(Stamped<E> elem) {
-        if (elem != null && descendingSubsequence.peekFirst() == elem)
+    public void removeElement(final Stamped<E> elem) {
+        if (elem == null) {
+            return;
+        }
+
+        if (descendingSubsequence.peekFirst() == elem) {
             descendingSubsequence.removeFirst();
+        }
 
-        if (descendingSubsequence.isEmpty())
+        if (descendingSubsequence.isEmpty()) {
             lastKnownTime = elem.timestamp;
+        }
+
     }
 
     public int size() {
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/MinTimestampTrackerTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/MinTimestampTrackerTest.java
index 0a1f95c29e0a8..52435197240eb 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/MinTimestampTrackerTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/MinTimestampTrackerTest.java
@@ -1,10 +1,10 @@
 /**
  * Licensed to the Apache Software Foundation (ASF) under one or more
- * contributor license agreements.  See the NOTICE file distributed with
+ * contributor license agreements. See the NOTICE file distributed with
  * this work for additional information regarding copyright ownership.
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
- * the License.  You may obtain a copy of the License at
+ * the License. You may obtain a copy of the License at
  *
  *    http://www.apache.org/licenses/LICENSE-2.0
  *
@@ -14,80 +14,65 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-
 package org.apache.kafka.streams.processor.internals;
 
-import static org.junit.Assert.assertEquals;
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.MatcherAssert.assertThat;
 
 import org.junit.Test;
 
 public class MinTimestampTrackerTest {
 
-    private Stamped<String> elem(long timestamp) {
-        return new Stamped<>("", timestamp);
-    }
+    private MinTimestampTracker<String> tracker = new MinTimestampTracker<>();
 
-    @SuppressWarnings("unchecked")
     @Test
-    public void testTracking() {
-        TimestampTracker<String> tracker = new MinTimestampTracker<>();
-
-        Object[] elems = new Object[]{
-            elem(100), elem(101), elem(102), elem(98), elem(99), elem(100)
-        };
-
-        int insertionIndex = 0;
-        int removalIndex = 0;
-
-        // add 100
-        tracker.addElement((Stamped<String>) elems[insertionIndex++]);
-        assertEquals(100L, tracker.get());
-
-        // add 101
-        tracker.addElement((Stamped<String>) elems[insertionIndex++]);
-        assertEquals(100L, tracker.get());
-
-        // remove 100
-        tracker.removeElement((Stamped<String>) elems[removalIndex++]);
-        assertEquals(101L, tracker.get());
-
-        // add 102
-        tracker.addElement((Stamped<String>) elems[insertionIndex++]);
-        assertEquals(101L, tracker.get());
-
-        // add 98
-        tracker.addElement((Stamped<String>) elems[insertionIndex++]);
-        assertEquals(98L, tracker.get());
-
-        // add 99
-        tracker.addElement((Stamped<String>) elems[insertionIndex++]);
-        assertEquals(98L, tracker.get());
-
-        // add 100
-        tracker.addElement((Stamped<String>) elems[insertionIndex++]);
-        assertEquals(98L, tracker.get());
+    public void shouldReturnNotKnownTimestampWhenNoRecordsEverAdded() throws Exception {
+        assertThat(tracker.get(), equalTo(TimestampTracker.NOT_KNOWN));
+    }
 
-        // remove 101
-        tracker.removeElement((Stamped<String>) elems[removalIndex++]);
-        assertEquals(98L, tracker.get());
+    @Test
+    public void shouldReturnTimestampOfOnlyRecord() throws Exception {
+        tracker.addElement(elem(100));
+        assertThat(tracker.get(), equalTo(100L));
+    }
 
-        // remove 102
-        tracker.removeElement((Stamped<String>) elems[removalIndex++]);
-        assertEquals(98L, tracker.get());
+    @Test
+    public void shouldReturnLowestAvailableTimestampFromAllInputs() throws Exception {
+        tracker.addElement(elem(100));
+        tracker.addElement(elem(99));
+        tracker.addElement(elem(102));
+        assertThat(tracker.get(), equalTo(99L));
+    }
 
-        // remove 98
-        tracker.removeElement((Stamped<String>) elems[removalIndex++]);
-        assertEquals(99L, tracker.get());
+    @Test
+    public void shouldReturnLowestAvailableTimestampAfterPreviousLowestRemoved() throws Exception {
+        final Stamped<String> lowest = elem(88);
+        tracker.addElement(lowest);
+        tracker.addElement(elem(101));
+        tracker.addElement(elem(99));
+        tracker.removeElement(lowest);
+        assertThat(tracker.get(), equalTo(99L));
+    }
 
-        // remove 99
-        tracker.removeElement((Stamped<String>) elems[removalIndex++]);
-        assertEquals(100L, tracker.get());
+    @Test
+    public void shouldReturnLastKnownTimestampWhenAllElementsHaveBeenRemoved() throws Exception {
+        final Stamped<String> record = elem(98);
+        tracker.addElement(record);
+        tracker.removeElement(record);
+        assertThat(tracker.get(), equalTo(98L));
+    }
 
-        // remove 100
-        tracker.removeElement((Stamped<String>) elems[removalIndex++]);
-        assertEquals(100L, tracker.get());
+    @Test
+    public void shouldIgnoreNullRecordOnRemove() throws Exception {
+        tracker.removeElement(null);
+    }
 
-        assertEquals(insertionIndex, removalIndex);
+    @Test(expected = NullPointerException.class)
+    public void shouldThrowNullPointerExceptionWhenTryingToAddNullElement() throws Exception {
+        tracker.addElement(null);
     }
 
+    private Stamped<String> elem(final long timestamp) {
+        return new Stamped<>("", timestamp);
+    }
 }
\ No newline at end of file

From d640259110be5113aca65129bb10de90d2a09527 Mon Sep 17 00:00:00 2001
From: Ismael Juma <ismael@juma.me.uk>
Date: Wed, 5 Apr 2017 10:53:40 +0100
Subject: [PATCH 151/177] HOTFIX: Fix checkstyle indentation error in
 ConnectorPluginsResource

---
 .../runtime/rest/resources/ConnectorPluginsResource.java    | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/rest/resources/ConnectorPluginsResource.java b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/rest/resources/ConnectorPluginsResource.java
index 4e3e8e46c5c47..c11a4d3c025a6 100644
--- a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/rest/resources/ConnectorPluginsResource.java
+++ b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/rest/resources/ConnectorPluginsResource.java
@@ -49,10 +49,8 @@ public ConnectorPluginsResource(Herder herder) {
 
     @PUT
     @Path("/{connectorType}/config/validate")
-    public ConfigInfos validateConfigs(
-        final @PathParam("connectorType") String connType,
-        final Map<String, String> connectorConfig
-    ) throws Throwable {
+    public ConfigInfos validateConfigs(final @PathParam("connectorType") String connType,
+                                       final Map<String, String> connectorConfig) throws Throwable {
         String includedConnType = connectorConfig.get(ConnectorConfig.CONNECTOR_CLASS_CONFIG);
         if (includedConnType != null
             && !normalizedPluginName(includedConnType).endsWith(normalizedPluginName(connType))) {

From 65c8f680ee4bf0efad82843736b1c63bc89c7d61 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Wed, 5 Apr 2017 11:21:20 +0100
Subject: [PATCH 152/177] HOTFIX: WindowedStreamPartitioner does not provide
 topic name to serializer

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Eno Thereska <eno@confluent.io>, Damian Guy <damian.guy@gmail.com>, Ismael Juma <ismael@juma.me.uk>

Closes #2776 from mjsax/hotfix-window-serdes-0102
---
 .../kstream/internals/KStreamImpl.java        | 12 ++--
 .../kstream/internals/SessionKeySerde.java    | 17 +++---
 .../internals/WindowedStreamPartitioner.java  |  8 ++-
 .../kafka/streams/state/StateSerdes.java      | 61 +++++++++++--------
 .../state/internals/CachingKeyValueStore.java |  3 +-
 .../state/internals/CachingSessionStore.java  | 14 +++--
 .../state/internals/CachingWindowStore.java   |  7 ++-
 .../ChangeLoggingKeyValueBytesStore.java      |  9 ++-
 .../internals/ChangeLoggingKeyValueStore.java |  3 +-
 .../ChangeLoggingSegmentedBytesStore.java     |  9 ++-
 .../InMemoryKeyValueLoggedStore.java          | 10 +--
 .../InMemoryKeyValueStoreSupplier.java        |  8 ++-
 .../state/internals/MemoryLRUCache.java       |  8 ++-
 ...MergedSortedCacheSessionStoreIterator.java |  4 +-
 .../internals/RocksDBSegmentedBytesStore.java |  3 +
 .../state/internals/RocksDBSessionStore.java  | 14 +++--
 .../streams/state/internals/RocksDBStore.java |  8 ++-
 .../state/internals/RocksDBWindowStore.java   |  3 +-
 .../state/internals/SegmentedBytesStore.java  |  8 +++
 .../state/internals/SessionKeySchema.java     | 10 ++-
 .../state/internals/WindowStoreKeySchema.java |  7 ++-
 .../state/internals/WindowStoreUtils.java     |  5 +-
 .../internals/SessionKeySerdeTest.java        | 10 +--
 .../WindowedStreamPartitionerTest.java        |  2 +-
 .../state/KeyValueStoreTestDriver.java        |  8 +--
 .../internals/CachingSessionStoreTest.java    |  2 +-
 .../internals/CachingWindowStoreTest.java     |  2 +-
 .../CompositeReadOnlyKeyValueStoreTest.java   |  2 +-
 ...edSortedCacheSessionStoreIteratorTest.java |  2 +-
 .../RocksDBSegmentedBytesStoreTest.java       |  4 +-
 .../state/internals/StateStoreTestUtils.java  | 13 +++-
 .../internals/WrappingStoreProviderTest.java  |  4 +-
 32 files changed, 176 insertions(+), 104 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamImpl.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamImpl.java
index 0434f06c7fe76..7b9fd946805dc 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamImpl.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/KStreamImpl.java
@@ -349,16 +349,16 @@ public void to(Serde<K> keySerde, Serde<V> valSerde, String topic) {
 
     @SuppressWarnings("unchecked")
     @Override
-    public void to(Serde<K> keySerde, Serde<V> valSerde, StreamPartitioner<? super K, ? super V> partitioner, String topic) {
+    public void to(final Serde<K> keySerde, final Serde<V> valSerde, StreamPartitioner<? super K, ? super V> partitioner, final String topic) {
         Objects.requireNonNull(topic, "topic can't be null");
-        String name = topology.newName(SINK_NAME);
+        final String name = topology.newName(SINK_NAME);
 
-        Serializer<K> keySerializer = keySerde == null ? null : keySerde.serializer();
-        Serializer<V> valSerializer = valSerde == null ? null : valSerde.serializer();
+        final Serializer<K> keySerializer = keySerde == null ? null : keySerde.serializer();
+        final Serializer<V> valSerializer = valSerde == null ? null : valSerde.serializer();
 
         if (partitioner == null && keySerializer != null && keySerializer instanceof WindowedSerializer) {
-            WindowedSerializer<Object> windowedSerializer = (WindowedSerializer<Object>) keySerializer;
-            partitioner = (StreamPartitioner<K, V>) new WindowedStreamPartitioner<Object, V>(windowedSerializer);
+            final WindowedSerializer<Object> windowedSerializer = (WindowedSerializer<Object>) keySerializer;
+            partitioner = (StreamPartitioner<K, V>) new WindowedStreamPartitioner<Object, V>(topic, windowedSerializer);
         }
 
         topology.addSink(name, topic, keySerializer, valSerializer, partitioner, this.name);
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionKeySerde.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionKeySerde.java
index 249350e8b5e1a..69097730e6349 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionKeySerde.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/SessionKeySerde.java
@@ -33,7 +33,6 @@
  */
 public class SessionKeySerde<K> implements Serde<Windowed<K>> {
     private static final int TIMESTAMP_SIZE = 8;
-    private static final String SESSIONKEY = "sessionkey";
 
     private final Serde<K> keySerde;
 
@@ -77,7 +76,7 @@ public byte[] serialize(final String topic, final Windowed<K> data) {
             if (data == null) {
                 return null;
             }
-            return toBinary(data, keySerializer).get();
+            return toBinary(data, keySerializer, topic).get();
         }
 
         @Override
@@ -102,7 +101,7 @@ public Windowed<K> deserialize(final String topic, final byte[] data) {
             if (data == null || data.length == 0) {
                 return null;
             }
-            return from(data, deserializer);
+            return from(data, deserializer, topic);
         }
 
 
@@ -127,20 +126,20 @@ public static byte[] extractKeyBytes(final byte[] binaryKey) {
         return bytes;
     }
 
-    public static <K> Windowed<K> from(final byte[] binaryKey, final Deserializer<K> keyDeserializer) {
-        final K key = extractKey(binaryKey, keyDeserializer);
+    public static <K> Windowed<K> from(final byte[] binaryKey, final Deserializer<K> keyDeserializer, final String topic) {
+        final K key = extractKey(binaryKey, keyDeserializer, topic);
         final ByteBuffer buffer = ByteBuffer.wrap(binaryKey);
         final long start = buffer.getLong(binaryKey.length - TIMESTAMP_SIZE);
         final long end = buffer.getLong(binaryKey.length - 2 * TIMESTAMP_SIZE);
         return new Windowed<>(key, new SessionWindow(start, end));
     }
 
-    private static <K> K extractKey(final byte[] binaryKey, Deserializer<K> deserializer) {
-        return deserializer.deserialize(SESSIONKEY, extractKeyBytes(binaryKey));
+    private static <K> K extractKey(final byte[] binaryKey, Deserializer<K> deserializer, final String topic) {
+        return deserializer.deserialize(topic, extractKeyBytes(binaryKey));
     }
 
-    public static <K> Bytes toBinary(final Windowed<K> sessionKey, final Serializer<K> serializer) {
-        final byte[] bytes = serializer.serialize(SESSIONKEY, sessionKey.key());
+    public static <K> Bytes toBinary(final Windowed<K> sessionKey, final Serializer<K> serializer, final String topic) {
+        final byte[] bytes = serializer.serialize(topic, sessionKey.key());
         ByteBuffer buf = ByteBuffer.allocate(bytes.length + 2 * TIMESTAMP_SIZE);
         buf.put(bytes);
         buf.putLong(sessionKey.window().end());
diff --git a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/WindowedStreamPartitioner.java b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/WindowedStreamPartitioner.java
index ba9873b436371..ad54fcb479d72 100644
--- a/streams/src/main/java/org/apache/kafka/streams/kstream/internals/WindowedStreamPartitioner.java
+++ b/streams/src/main/java/org/apache/kafka/streams/kstream/internals/WindowedStreamPartitioner.java
@@ -24,9 +24,11 @@
 
 public class WindowedStreamPartitioner<K, V> implements StreamPartitioner<Windowed<K>, V> {
 
+    private final String topic;
     private final WindowedSerializer<K> serializer;
 
-    public WindowedStreamPartitioner(WindowedSerializer<K> serializer) {
+    WindowedStreamPartitioner(final String topic, final WindowedSerializer<K> serializer) {
+        this.topic = topic;
         this.serializer = serializer;
     }
 
@@ -40,8 +42,8 @@ public WindowedStreamPartitioner(WindowedSerializer<K> serializer) {
      * @param numPartitions the total number of partitions
      * @return an integer between 0 and {@code numPartitions-1}, or {@code null} if the default partitioning logic should be used
      */
-    public Integer partition(Windowed<K> windowedKey, V value, int numPartitions) {
-        byte[] keyBytes = serializer.serializeBaseKey(null, windowedKey);
+    public Integer partition(final Windowed<K> windowedKey, final V value, final int numPartitions) {
+        final byte[] keyBytes = serializer.serializeBaseKey(topic, windowedKey);
 
         // hash the keyBytes to choose a partition
         return toPositive(Utils.murmur2(keyBytes)) % numPartitions;
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/StateSerdes.java b/streams/src/main/java/org/apache/kafka/streams/state/StateSerdes.java
index b19510c0b0276..059be375917bb 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/StateSerdes.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/StateSerdes.java
@@ -32,18 +32,21 @@ public final class StateSerdes<K, V> {
     /**
      * Create a new instance of {@link StateSerdes} for the given state name and key-/value-type classes.
      *
-     * @param stateName   the name of the state
-     * @param keyClass    the class of the key type
-     * @param valueClass  the class of the value type
-     * @param <K>         the key type
-     * @param <V>         the value type
-     * @return            a new instance of {@link StateSerdes}
+     * @param topic      the topic name
+     * @param keyClass   the class of the key type
+     * @param valueClass the class of the value type
+     * @param <K>        the key type
+     * @param <V>        the value type
+     * @return           a new instance of {@link StateSerdes}
      */
-    public static <K, V> StateSerdes<K, V> withBuiltinTypes(String stateName, Class<K> keyClass, Class<V> valueClass) {
-        return new StateSerdes<>(stateName, Serdes.serdeFrom(keyClass), Serdes.serdeFrom(valueClass));
+    public static <K, V> StateSerdes<K, V> withBuiltinTypes(
+        final String topic,
+        final Class<K> keyClass,
+        final Class<V> valueClass) {
+        return new StateSerdes<>(topic, Serdes.serdeFrom(keyClass), Serdes.serdeFrom(valueClass));
     }
 
-    private final String stateName;
+    private final String topic;
     private final Serde<K> keySerde;
     private final Serde<V> valueSerde;
 
@@ -53,22 +56,26 @@ public static <K, V> StateSerdes<K, V> withBuiltinTypes(String stateName, Class<
      * is provided to bind this serde factory to, so that future calls for serialize / deserialize do not
      * need to provide the topic name any more.
      *
-     * @param stateName     the name of the state
-     * @param keySerde      the serde for keys; cannot be null
-     * @param valueSerde    the serde for values; cannot be null
+     * @param topic      the topic name
+     * @param keySerde   the serde for keys; cannot be null
+     * @param valueSerde the serde for values; cannot be null
      * @throws IllegalArgumentException if key or value serde is null
      */
     @SuppressWarnings("unchecked")
-    public StateSerdes(String stateName,
-                       Serde<K> keySerde,
-                       Serde<V> valueSerde) {
-        this.stateName = stateName;
-
-        if (keySerde == null)
+    public StateSerdes(final String topic,
+                       final Serde<K> keySerde,
+                       final Serde<V> valueSerde) {
+        if (topic == null) {
+            throw new IllegalArgumentException("topic cannot be null");
+        }
+        if (keySerde == null) {
             throw new IllegalArgumentException("key serde cannot be null");
-        if (valueSerde == null)
+        }
+        if (valueSerde == null) {
             throw new IllegalArgumentException("value serde cannot be null");
+        }
 
+        this.topic = topic;
         this.keySerde = keySerde;
         this.valueSerde = valueSerde;
     }
@@ -128,12 +135,12 @@ public Serializer<V> valueSerializer() {
     }
 
     /**
-     * Return the name of the state.
+     * Return the topic.
      *
-     * @return the name of the state
+     * @return the topic
      */
-    public String stateName() {
-        return stateName;
+    public String topic() {
+        return topic;
     }
 
     /**
@@ -143,7 +150,7 @@ public String stateName() {
      * @return        the key as typed object
      */
     public K keyFrom(byte[] rawKey) {
-        return keySerde.deserializer().deserialize(stateName, rawKey);
+        return keySerde.deserializer().deserialize(topic, rawKey);
     }
 
     /**
@@ -153,7 +160,7 @@ public K keyFrom(byte[] rawKey) {
      * @return          the value as typed object
      */
     public V valueFrom(byte[] rawValue) {
-        return valueSerde.deserializer().deserialize(stateName, rawValue);
+        return valueSerde.deserializer().deserialize(topic, rawValue);
     }
 
     /**
@@ -163,7 +170,7 @@ public V valueFrom(byte[] rawValue) {
      * @return     the serialized key
      */
     public byte[] rawKey(K key) {
-        return keySerde.serializer().serialize(stateName, key);
+        return keySerde.serializer().serialize(topic, key);
     }
 
     /**
@@ -173,6 +180,6 @@ public byte[] rawKey(K key) {
      * @return       the serialized value
      */
     public byte[] rawValue(V value) {
-        return valueSerde.serializer().serialize(stateName, value);
+        return valueSerde.serializer().serialize(topic, value);
     }
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingKeyValueStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingKeyValueStore.java
index 1e91b478d734e..f9f3077b18d34 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingKeyValueStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingKeyValueStore.java
@@ -24,6 +24,7 @@
 import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.StateStore;
 import org.apache.kafka.streams.processor.internals.InternalProcessorContext;
+import org.apache.kafka.streams.processor.internals.ProcessorStateManager;
 import org.apache.kafka.streams.processor.internals.RecordContext;
 import org.apache.kafka.streams.state.KeyValueIterator;
 import org.apache.kafka.streams.state.KeyValueStore;
@@ -69,7 +70,7 @@ public void init(final ProcessorContext context, final StateStore root) {
     @SuppressWarnings("unchecked")
     void initInternal(final ProcessorContext context) {
         this.context = (InternalProcessorContext) context;
-        this.serdes = new StateSerdes<>(underlying.name(),
+        this.serdes = new StateSerdes<>(ProcessorStateManager.storeChangelogTopic(context.applicationId(), underlying.name()),
                                         keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
                                         valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java
index 6cfbf810e4e09..ed64246b18d09 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingSessionStore.java
@@ -24,6 +24,7 @@
 import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.StateStore;
 import org.apache.kafka.streams.processor.internals.InternalProcessorContext;
+import org.apache.kafka.streams.processor.internals.ProcessorStateManager;
 import org.apache.kafka.streams.processor.internals.RecordContext;
 import org.apache.kafka.streams.state.KeyValueIterator;
 import org.apache.kafka.streams.state.SessionStore;
@@ -43,6 +44,7 @@ class CachingSessionStore<K, AGG> extends WrappedStateStore.AbstractWrappedState
     private StateSerdes<K, AGG> serdes;
     private ThreadCache cache;
     private CacheFlushListener<Windowed<K>, AGG> flushListener;
+    private String topic;
 
     CachingSessionStore(final SessionStore<Bytes, byte[]> bytesStore,
                         final Serde<K> keySerde,
@@ -58,7 +60,7 @@ public KeyValueIterator<Windowed<K>, AGG> findSessions(final K key,
                                                            final long earliestSessionEndTime,
                                                            final long latestSessionStartTime) {
         validateStoreOpen();
-        final Bytes binarySessionId = Bytes.wrap(keySerde.serializer().serialize(this.name(), key));
+        final Bytes binarySessionId = Bytes.wrap(keySerde.serializer().serialize(topic, key));
         final ThreadCache.MemoryLRUCacheBytesIterator cacheIterator = cache.range(cacheName,
                                                                                   keySchema.lowerRange(binarySessionId,
                                                                                                        earliestSessionEndTime).get(),
@@ -79,7 +81,7 @@ public void remove(final Windowed<K> sessionKey) {
 
     public void put(final Windowed<K> key, AGG value) {
         validateStoreOpen();
-        final Bytes binaryKey = SessionKeySerde.toBinary(key, keySerde.serializer());
+        final Bytes binaryKey = SessionKeySerde.toBinary(key, keySerde.serializer(), topic);
         final LRUCacheEntry entry = new LRUCacheEntry(serdes.rawValue(value), true, context.offset(),
                                                       key.window().end(), context.partition(), context.topic());
         cache.put(cacheName, binaryKey.get(), entry);
@@ -92,6 +94,7 @@ public KeyValueIterator<Windowed<K>, AGG> fetch(final K key) {
 
     @SuppressWarnings("unchecked")
     public void init(final ProcessorContext context, final StateStore root) {
+        topic = ProcessorStateManager.storeChangelogTopic(context.applicationId(), root.name());
         bytesStore.init(context, root);
         initInternal((InternalProcessorContext) context);
     }
@@ -100,7 +103,8 @@ public void init(final ProcessorContext context, final StateStore root) {
     private void initInternal(final InternalProcessorContext context) {
         this.context = context;
 
-        this.serdes = new StateSerdes<>(bytesStore.name(),
+        keySchema.init(topic);
+        this.serdes = new StateSerdes<>(topic,
                                         keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
                                         aggSerde == null ? (Serde<AGG>) context.valueSerde() : aggSerde);
 
@@ -123,12 +127,12 @@ private void putAndMaybeForward(final ThreadCache.DirtyEntry entry, final Intern
         final RecordContext current = context.recordContext();
         context.setRecordContext(entry.recordContext());
         try {
-            final Windowed<K> key = SessionKeySerde.from(binaryKey.get(), keySerde.deserializer());
+            final Windowed<K> key = SessionKeySerde.from(binaryKey.get(), keySerde.deserializer(), topic);
             if (flushListener != null) {
                 final AGG newValue = serdes.valueFrom(entry.newValue());
                 final AGG oldValue = fetchPrevious(binaryKey);
                 if (!(newValue == null && oldValue == null)) {
-                    flushListener.apply(key, newValue == null ? null : newValue, oldValue);
+                    flushListener.apply(key, newValue, oldValue);
                 }
             }
             bytesStore.put(new Windowed<>(Bytes.wrap(serdes.rawKey(key.key())), key.window()), entry.newValue());
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingWindowStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingWindowStore.java
index 33df4260824ef..37ce336f0326d 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingWindowStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/CachingWindowStore.java
@@ -25,6 +25,7 @@
 import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.StateStore;
 import org.apache.kafka.streams.processor.internals.InternalProcessorContext;
+import org.apache.kafka.streams.processor.internals.ProcessorStateManager;
 import org.apache.kafka.streams.processor.internals.RecordContext;
 import org.apache.kafka.streams.state.StateSerdes;
 import org.apache.kafka.streams.state.WindowStore;
@@ -62,12 +63,13 @@ class CachingWindowStore<K, V> extends WrappedStateStore.AbstractWrappedStateSto
     public void init(final ProcessorContext context, final StateStore root) {
         underlying.init(context, root);
         initInternal(context);
+        keySchema.init(context.applicationId());
     }
 
     @SuppressWarnings("unchecked")
     void initInternal(final ProcessorContext context) {
         this.context = (InternalProcessorContext) context;
-        this.serdes = new StateSerdes<>(underlying.name(),
+        this.serdes = new StateSerdes<>(ProcessorStateManager.storeChangelogTopic(context.applicationId(), underlying.name()),
                                         keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
                                         valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
 
@@ -157,8 +159,7 @@ public synchronized WindowStoreIterator<V> fetch(final K key, final long timeFro
 
         return new MergedSortedCacheWindowStoreIterator<>(filteredCacheIterator,
                                                           underlyingIterator,
-                                                          new StateSerdes<>(serdes.stateName(), Serdes.Long(), serdes.valueSerde()));
-
+                                                          new StateSerdes<>(serdes.topic(), Serdes.Long(), serdes.valueSerde()));
     }
 
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStore.java
index e31d04bd1f51f..9ece123df6d71 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueBytesStore.java
@@ -20,6 +20,7 @@
 import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.processor.internals.ProcessorStateManager;
 import org.apache.kafka.streams.state.KeyValueIterator;
 import org.apache.kafka.streams.state.KeyValueStore;
 
@@ -37,7 +38,13 @@ public ChangeLoggingKeyValueBytesStore(final KeyValueStore<Bytes, byte[]> inner)
     @Override
     public void init(final ProcessorContext context, final StateStore root) {
         inner.init(context, root);
-        this.changeLogger = new StoreChangeLogger<>(inner.name(), context, WindowStoreUtils.INNER_SERDES);
+        this.changeLogger = new StoreChangeLogger<>(
+            inner.name(),
+            context,
+            WindowStoreUtils.getInnerStateSerde(
+                ProcessorStateManager.storeChangelogTopic(
+                    context.applicationId(),
+                    inner.name())));
     }
 
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStore.java
index cd63d1ab30b75..d50f90764a6c6 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingKeyValueStore.java
@@ -21,6 +21,7 @@
 import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.processor.internals.ProcessorStateManager;
 import org.apache.kafka.streams.state.KeyValueIterator;
 import org.apache.kafka.streams.state.KeyValueStore;
 import org.apache.kafka.streams.state.StateSerdes;
@@ -54,7 +55,7 @@ private ChangeLoggingKeyValueStore(final ChangeLoggingKeyValueBytesStore bytesSt
     public void init(final ProcessorContext context, final StateStore root) {
         innerBytes.init(context, root);
 
-        this.serdes = new StateSerdes<>(innerBytes.name(),
+        this.serdes = new StateSerdes<>(ProcessorStateManager.storeChangelogTopic(context.applicationId(), innerBytes.name()),
                                         keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
                                         valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
     }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStore.java
index 21c28662522d5..2a5a1a19f433b 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/ChangeLoggingSegmentedBytesStore.java
@@ -19,6 +19,7 @@
 import org.apache.kafka.common.utils.Bytes;
 import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.processor.internals.ProcessorStateManager;
 import org.apache.kafka.streams.state.KeyValueIterator;
 
 /**
@@ -66,6 +67,12 @@ public byte[] get(final Bytes key) {
     @SuppressWarnings("unchecked")
     public void init(final ProcessorContext context, final StateStore root) {
         bytesStore.init(context, root);
-        changeLogger = new StoreChangeLogger<>(name(), context, WindowStoreUtils.INNER_SERDES);
+        changeLogger = new StoreChangeLogger<>(
+            name(),
+            context,
+            WindowStoreUtils.getInnerStateSerde(
+                ProcessorStateManager.storeChangelogTopic(
+                    context.applicationId(),
+                    name())));
     }
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/InMemoryKeyValueLoggedStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/InMemoryKeyValueLoggedStore.java
index d81f6fbac2409..f402390159743 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/InMemoryKeyValueLoggedStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/InMemoryKeyValueLoggedStore.java
@@ -21,6 +21,7 @@
 import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.processor.internals.ProcessorStateManager;
 import org.apache.kafka.streams.state.KeyValueIterator;
 import org.apache.kafka.streams.state.KeyValueStore;
 import org.apache.kafka.streams.state.StateSerdes;
@@ -35,7 +36,6 @@ public class InMemoryKeyValueLoggedStore<K, V> implements KeyValueStore<K, V> {
     private final String storeName;
 
     private StoreChangeLogger<K, V> changeLogger;
-    private ProcessorContext context;
 
     public InMemoryKeyValueLoggedStore(final String storeName, final KeyValueStore<K, V> inner, Serde<K> keySerde, Serde<V> valueSerde) {
         this.storeName = storeName;
@@ -52,13 +52,13 @@ public String name() {
     @Override
     @SuppressWarnings("unchecked")
     public void init(ProcessorContext context, StateStore root) {
-        this.context = context;
         inner.init(context, root);
 
         // construct the serde
-        StateSerdes<K, V>  serdes = new StateSerdes<>(storeName,
-                keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
-                valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
+        StateSerdes<K, V>  serdes = new StateSerdes<>(
+            ProcessorStateManager.storeChangelogTopic(context.applicationId(), inner.name()),
+            keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
+            valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
 
         this.changeLogger = new StoreChangeLogger<>(storeName, context, serdes);
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/InMemoryKeyValueStoreSupplier.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/InMemoryKeyValueStoreSupplier.java
index e00f8ab4f3be6..05130ef34d74a 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/InMemoryKeyValueStoreSupplier.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/InMemoryKeyValueStoreSupplier.java
@@ -23,6 +23,7 @@
 import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.StateRestoreCallback;
 import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.processor.internals.ProcessorStateManager;
 import org.apache.kafka.streams.state.KeyValueIterator;
 import org.apache.kafka.streams.state.KeyValueStore;
 import org.apache.kafka.streams.state.StateSerdes;
@@ -94,9 +95,10 @@ public String name() {
         @SuppressWarnings("unchecked")
         public void init(ProcessorContext context, StateStore root) {
             // construct the serde
-            this.serdes = new StateSerdes<>(name,
-                    keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
-                    valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
+            this.serdes = new StateSerdes<>(
+                ProcessorStateManager.storeChangelogTopic(context.applicationId(), name),
+                keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
+                valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
 
             // register the store
             context.register(root, true, new StateRestoreCallback() {
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/MemoryLRUCache.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/MemoryLRUCache.java
index 4e1f40e52dfef..4ab6fabc1912c 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/MemoryLRUCache.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/MemoryLRUCache.java
@@ -21,6 +21,7 @@
 import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.StateRestoreCallback;
 import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.processor.internals.ProcessorStateManager;
 import org.apache.kafka.streams.state.KeyValueIterator;
 import org.apache.kafka.streams.state.KeyValueStore;
 import org.apache.kafka.streams.state.StateSerdes;
@@ -103,9 +104,10 @@ public String name() {
     @SuppressWarnings("unchecked")
     public void init(ProcessorContext context, StateStore root) {
         // construct the serde
-        this.serdes = new StateSerdes<>(name,
-                keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
-                valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
+        this.serdes = new StateSerdes<>(
+            ProcessorStateManager.storeChangelogTopic(context.applicationId(), name),
+            keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
+            valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
 
         // register the store
         context.register(root, true, new StateRestoreCallback() {
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIterator.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIterator.java
index db64621340116..8ecc65468aa63 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIterator.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIterator.java
@@ -38,7 +38,7 @@ class MergedSortedCacheSessionStoreIterator<K, AGG> extends AbstractMergedSorted
     MergedSortedCacheSessionStoreIterator(final PeekingKeyValueIterator<Bytes, LRUCacheEntry> cacheIterator,
                                           final KeyValueIterator<Windowed<Bytes>, byte[]> storeIterator,
                                           final StateSerdes<K, AGG> serdes) {
-        super(cacheIterator, storeIterator, new StateSerdes<>(serdes.stateName(),
+        super(cacheIterator, storeIterator, new StateSerdes<>(serdes.topic(),
                                                               new SessionKeySerde<>(serdes.keySerde()),
                                                               serdes.valueSerde()));
 
@@ -53,7 +53,7 @@ public KeyValue<Windowed<K>, AGG> deserializeStorePair(KeyValue<Windowed<Bytes>,
 
     @Override
     Windowed<K> deserializeCacheKey(final Bytes cacheKey) {
-        return SessionKeySerde.from(cacheKey.get(), rawSerdes.keyDeserializer());
+        return SessionKeySerde.from(cacheKey.get(), rawSerdes.keyDeserializer(), rawSerdes.topic());
     }
 
     @Override
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBSegmentedBytesStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBSegmentedBytesStore.java
index 31956ba486984..ef6ea3c691bd0 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBSegmentedBytesStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBSegmentedBytesStore.java
@@ -20,6 +20,7 @@
 import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.StateRestoreCallback;
 import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.processor.internals.ProcessorStateManager;
 import org.apache.kafka.streams.state.KeyValueIterator;
 
 import java.util.List;
@@ -95,6 +96,8 @@ public String name() {
     public void init(ProcessorContext context, StateStore root) {
         this.context = context;
 
+        keySchema.init(ProcessorStateManager.storeChangelogTopic(context.applicationId(), root.name()));
+
         segments.openExisting(context);
 
         // register and possibly restore the state from the logs
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBSessionStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBSessionStore.java
index a8ddc7376f172..22f4a9d44bf3d 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBSessionStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBSessionStore.java
@@ -23,6 +23,7 @@
 import org.apache.kafka.streams.kstream.internals.SessionKeySerde;
 import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.processor.internals.ProcessorStateManager;
 import org.apache.kafka.streams.state.KeyValueIterator;
 import org.apache.kafka.streams.state.SessionStore;
 import org.apache.kafka.streams.state.StateSerdes;
@@ -34,6 +35,7 @@ class RocksDBSessionStore<K, AGG> implements SessionStore<K, AGG> {
     private final Serde<AGG> aggSerde;
     private final SegmentedBytesStore bytesStore;
     private StateSerdes<K, AGG> serdes;
+    protected String topic;
 
 
     RocksDBSessionStore(final SegmentedBytesStore bytesStore,
@@ -55,12 +57,12 @@ public KeyValueIterator<Windowed<K>, AGG> findSessions(final K key, final long e
 
     @Override
     public void remove(final Windowed<K> key) {
-        bytesStore.remove(SessionKeySerde.toBinary(key, serdes.keySerializer()));
+        bytesStore.remove(SessionKeySerde.toBinary(key, serdes.keySerializer(), topic));
     }
 
     @Override
     public void put(final Windowed<K> sessionKey, final AGG aggregate) {
-        bytesStore.put(SessionKeySerde.toBinary(sessionKey, serdes.keySerializer()), aggSerde.serializer().serialize(bytesStore.name(), aggregate));
+        bytesStore.put(SessionKeySerde.toBinary(sessionKey, serdes.keySerializer(), topic), aggSerde.serializer().serialize(bytesStore.name(), aggregate));
     }
 
     @Override
@@ -71,7 +73,9 @@ public String name() {
     @Override
     @SuppressWarnings("unchecked")
     public void init(final ProcessorContext context, final StateStore root) {
-        this.serdes = new StateSerdes<>(bytesStore.name(),
+        final String storeName = bytesStore.name();
+        topic = ProcessorStateManager.storeChangelogTopic(context.applicationId(), storeName);
+        this.serdes = new StateSerdes<>(topic,
                                         keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
                                         aggSerde == null ? (Serde<AGG>) context.valueSerde() : aggSerde);
 
@@ -121,7 +125,7 @@ public void close() {
         @Override
         public Windowed<K> peekNextKey() {
             final Bytes bytes = bytesIterator.peekNextKey();
-            return SessionKeySerde.from(bytes.get(), serdes.keyDeserializer());
+            return SessionKeySerde.from(bytes.get(), serdes.keyDeserializer(), serdes.topic());
         }
 
         @Override
@@ -132,7 +136,7 @@ public boolean hasNext() {
         @Override
         public KeyValue<Windowed<K>, AGG> next() {
             final KeyValue<Bytes, byte[]> next = bytesIterator.next();
-            return KeyValue.pair(SessionKeySerde.from(next.key.get(), serdes.keyDeserializer()), serdes.valueFrom(next.value));
+            return KeyValue.pair(SessionKeySerde.from(next.key.get(), serdes.keyDeserializer(), serdes.topic()), serdes.valueFrom(next.value));
         }
 
         @Override
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
index 6bb14ddbeaff0..acfb5b1324b25 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
@@ -27,6 +27,7 @@
 import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.StateRestoreCallback;
 import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.processor.internals.ProcessorStateManager;
 import org.apache.kafka.streams.state.KeyValueIterator;
 import org.apache.kafka.streams.state.KeyValueStore;
 import org.apache.kafka.streams.state.RocksDBConfigSetter;
@@ -141,9 +142,10 @@ public void openDB(ProcessorContext context) {
         }
         // we need to construct the serde while opening DB since
         // it is also triggered by windowed DB segments without initialization
-        this.serdes = new StateSerdes<>(name,
-                keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
-                valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
+        this.serdes = new StateSerdes<>(
+            ProcessorStateManager.storeChangelogTopic(context.applicationId(), name),
+            keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
+            valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
 
         this.dbDir = new File(new File(context.stateDir(), parentDir), this.name);
         this.db = openDB(this.dbDir, this.options, TTL_SECONDS);
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBWindowStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBWindowStore.java
index 80c4796a6cafc..ffd3061274026 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBWindowStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBWindowStore.java
@@ -25,6 +25,7 @@
 import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.processor.internals.ProcessorStateManager;
 import org.apache.kafka.streams.state.KeyValueIterator;
 import org.apache.kafka.streams.state.StateSerdes;
 import org.apache.kafka.streams.state.WindowStore;
@@ -69,7 +70,7 @@ public String name() {
     public void init(final ProcessorContext context, final StateStore root) {
         this.context = context;
         // construct the serde
-        this.serdes = new StateSerdes<>(bytesStore.name(),
+        this.serdes = new StateSerdes<>(ProcessorStateManager.storeChangelogTopic(context.applicationId(), bytesStore.name()),
                                         keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
                                         valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/SegmentedBytesStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/SegmentedBytesStore.java
index ab1099ea85e1f..b2957dae1e46b 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/SegmentedBytesStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/SegmentedBytesStore.java
@@ -67,6 +67,14 @@ public interface SegmentedBytesStore extends StateStore {
 
 
     interface KeySchema {
+
+        /**
+         * Initialized the schema with a topic.
+         *
+         * @param topic a topic name
+         */
+        void init(final String topic);
+
         /**
          * Given a record-key and a time, construct a Segmented key that represents
          * the upper range of keys to search when performing range queries.
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/SessionKeySchema.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/SessionKeySchema.java
index 3747d0faa7e90..698970a54054b 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/SessionKeySchema.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/SessionKeySchema.java
@@ -27,17 +27,23 @@
 
 
 class SessionKeySchema implements SegmentedBytesStore.KeySchema {
+    private String topic;
+
+    @Override
+    public void init(final String topic) {
+        this.topic = topic;
+    }
 
     @Override
     public Bytes upperRange(final Bytes key, final long to) {
         final Windowed<Bytes> sessionKey = new Windowed<>(key, new SessionWindow(to, Long.MAX_VALUE));
-        return SessionKeySerde.toBinary(sessionKey, Serdes.Bytes().serializer());
+        return SessionKeySerde.toBinary(sessionKey, Serdes.Bytes().serializer(), topic);
     }
 
     @Override
     public Bytes lowerRange(final Bytes key, final long from) {
         final Windowed<Bytes> sessionKey = new Windowed<>(key, new SessionWindow(0, Math.max(0, from)));
-        return SessionKeySerde.toBinary(sessionKey, Serdes.Bytes().serializer());
+        return SessionKeySerde.toBinary(sessionKey, Serdes.Bytes().serializer(), topic);
     }
 
     @Override
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreKeySchema.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreKeySchema.java
index a4d347cf9ac91..9d32592c5593d 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreKeySchema.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreKeySchema.java
@@ -24,7 +24,12 @@
 import java.util.List;
 
 class WindowStoreKeySchema implements RocksDBSegmentedBytesStore.KeySchema {
-    private final StateSerdes<Bytes, byte[]> serdes = new StateSerdes<>("window-store-key-schema", Serdes.Bytes(), Serdes.ByteArray());
+    private StateSerdes<Bytes, byte[]> serdes;
+
+    @Override
+    public void init(final String topic) {
+        serdes = new StateSerdes<>(topic, Serdes.Bytes(), Serdes.ByteArray());
+    }
 
     @Override
     public Bytes upperRange(final Bytes key, final long to) {
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreUtils.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreUtils.java
index 074cf8aef5443..0f491ac7e8bbb 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreUtils.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/WindowStoreUtils.java
@@ -34,9 +34,12 @@ public class WindowStoreUtils {
     /** Inner byte array serde used for segments */
     public static final Serde<Bytes> INNER_KEY_SERDE = Serdes.Bytes();
     public static final Serde<byte[]> INNER_VALUE_SERDE = Serdes.ByteArray();
-    public static final StateSerdes<Bytes, byte[]> INNER_SERDES = new StateSerdes<>("rocksDB-inner", INNER_KEY_SERDE, INNER_VALUE_SERDE);
 
 
+    static StateSerdes<Bytes, byte[]> getInnerStateSerde(final String topic) {
+        return new StateSerdes<>(topic, INNER_KEY_SERDE, INNER_VALUE_SERDE);
+    }
+
     public static <K> byte[] toBinaryKey(K key, final long timestamp, final int seqnum, StateSerdes<K, ?> serdes) {
         byte[] serializedKey = serdes.rawKey(key);
         return toBinaryKey(serializedKey, timestamp, seqnum);
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/SessionKeySerdeTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/SessionKeySerdeTest.java
index 3ccdc2cda9ae8..5c70c8ad32b9c 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/SessionKeySerdeTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/SessionKeySerdeTest.java
@@ -58,29 +58,29 @@ public void shouldDeSerializeNullToNull() throws Exception {
     @Test
     public void shouldConvertToBinaryAndBack() throws Exception {
         final Windowed<String> key = new Windowed<>("key", new SessionWindow(10, 20));
-        final Bytes serialized = SessionKeySerde.toBinary(key, Serdes.String().serializer());
-        final Windowed<String> result = SessionKeySerde.from(serialized.get(), Serdes.String().deserializer());
+        final Bytes serialized = SessionKeySerde.toBinary(key, Serdes.String().serializer(), "topic");
+        final Windowed<String> result = SessionKeySerde.from(serialized.get(), Serdes.String().deserializer(), "topic");
         assertEquals(key, result);
     }
 
     @Test
     public void shouldExtractEndTimeFromBinary() throws Exception {
         final Windowed<String> key = new Windowed<>("key", new SessionWindow(10, 100));
-        final Bytes serialized = SessionKeySerde.toBinary(key, Serdes.String().serializer());
+        final Bytes serialized = SessionKeySerde.toBinary(key, Serdes.String().serializer(), "topic");
         assertEquals(100, SessionKeySerde.extractEnd(serialized.get()));
     }
 
     @Test
     public void shouldExtractStartTimeFromBinary() throws Exception {
         final Windowed<String> key = new Windowed<>("key", new SessionWindow(50, 100));
-        final Bytes serialized = SessionKeySerde.toBinary(key, Serdes.String().serializer());
+        final Bytes serialized = SessionKeySerde.toBinary(key, Serdes.String().serializer(), "topic");
         assertEquals(50, SessionKeySerde.extractStart(serialized.get()));
     }
 
     @Test
     public void shouldExtractKeyBytesFromBinary() throws Exception {
         final Windowed<String> key = new Windowed<>("blah", new SessionWindow(50, 100));
-        final Bytes serialized = SessionKeySerde.toBinary(key, Serdes.String().serializer());
+        final Bytes serialized = SessionKeySerde.toBinary(key, Serdes.String().serializer(), "topic");
         assertArrayEquals("blah".getBytes(), SessionKeySerde.extractKeyBytes(serialized.get()));
     }
 
diff --git a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/WindowedStreamPartitionerTest.java b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/WindowedStreamPartitionerTest.java
index 0b6288fb4d4dd..efb3fd229d7f1 100644
--- a/streams/src/test/java/org/apache/kafka/streams/kstream/internals/WindowedStreamPartitionerTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/kstream/internals/WindowedStreamPartitionerTest.java
@@ -70,7 +70,7 @@ public void testCopartitioning() {
         DefaultPartitioner defaultPartitioner = new DefaultPartitioner();
 
         WindowedSerializer<Integer> windowedSerializer = new WindowedSerializer<>(intSerializer);
-        WindowedStreamPartitioner<Integer, String> streamPartitioner = new WindowedStreamPartitioner<>(windowedSerializer);
+        WindowedStreamPartitioner<Integer, String> streamPartitioner = new WindowedStreamPartitioner<>(topicName, windowedSerializer);
 
         for (int k = 0; k < 10; k++) {
             Integer key = rand.nextInt();
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/KeyValueStoreTestDriver.java b/streams/src/test/java/org/apache/kafka/streams/state/KeyValueStoreTestDriver.java
index 2f5b36851d27c..1f2665ac07522 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/KeyValueStoreTestDriver.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/KeyValueStoreTestDriver.java
@@ -170,10 +170,10 @@ public static <K, V> KeyValueStoreTestDriver<K, V> create(Class<K> keyClass, Cla
      * @param valueDeserializer the value deserializer for the {@link ProcessorContext}; may not be null
      * @return the test driver; never null
      */
-    public static <K, V> KeyValueStoreTestDriver<K, V> create(Serializer<K> keySerializer,
-                                                              Deserializer<K> keyDeserializer,
-                                                              Serializer<V> valueSerializer,
-                                                              Deserializer<V> valueDeserializer) {
+    public static <K, V> KeyValueStoreTestDriver<K, V> create(final Serializer<K> keySerializer,
+                                                              final Deserializer<K> keyDeserializer,
+                                                              final Serializer<V> valueSerializer,
+                                                              final Deserializer<V> valueDeserializer) {
         StateSerdes<K, V> serdes = new StateSerdes<K, V>("unexpected",
             Serdes.serdeFrom(keySerializer, keyDeserializer),
             Serdes.serdeFrom(valueSerializer, valueDeserializer));
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java
index 047503137f927..e12d69386e985 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingSessionStoreTest.java
@@ -117,7 +117,7 @@ public void shouldFlushItemsToStoreOnEviction() throws Exception {
         assertEquals(added.size() - 1, cache.size());
         final KeyValueIterator<Bytes, byte[]> iterator = underlying.fetch(Bytes.wrap(added.get(0).key.key().getBytes()), 0, 0);
         final KeyValue<Bytes, byte[]> next = iterator.next();
-        assertEquals(added.get(0).key, SessionKeySerde.from(next.key.get(), Serdes.String().deserializer()));
+        assertEquals(added.get(0).key, SessionKeySerde.from(next.key.get(), Serdes.String().deserializer(), "topic"));
         assertArrayEquals(serdes.rawValue(added.get(0).value), next.value);
     }
 
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java
index 11e605c143db8..d50b551591556 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/CachingWindowStoreTest.java
@@ -162,7 +162,7 @@ public void shouldIterateAcrossWindows() throws Exception {
     @Test
     public void shouldIterateCacheAndStore() throws Exception {
         final Bytes key = Bytes.wrap("1" .getBytes());
-        underlying.put(Bytes.wrap(WindowStoreUtils.toBinaryKey(key, DEFAULT_TIMESTAMP, 0, WindowStoreUtils.INNER_SERDES)), "a".getBytes());
+        underlying.put(Bytes.wrap(WindowStoreUtils.toBinaryKey(key, DEFAULT_TIMESTAMP, 0, WindowStoreUtils.getInnerStateSerde("topic"))), "a".getBytes());
         cachingStore.put("1", "b", DEFAULT_TIMESTAMP + WINDOW_SIZE);
         final WindowStoreIterator<String> fetch = cachingStore.fetch("1", DEFAULT_TIMESTAMP, DEFAULT_TIMESTAMP + WINDOW_SIZE);
         assertEquals(KeyValue.pair(DEFAULT_TIMESTAMP, "a"), fetch.next());
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/CompositeReadOnlyKeyValueStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/CompositeReadOnlyKeyValueStoreTest.java
index 0fd60018dd546..579f12930428c 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/CompositeReadOnlyKeyValueStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/CompositeReadOnlyKeyValueStoreTest.java
@@ -59,7 +59,7 @@ public void before() {
     }
 
     private KeyValueStore<String, String> newStoreInstance() {
-        return StateStoreTestUtils.newKeyValueStore(storeName, String.class, String.class);
+        return StateStoreTestUtils.newKeyValueStore(storeName, "app-id", String.class, String.class);
     }
 
     @Test
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIteratorTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIteratorTest.java
index e7c2eb31edff4..3cc217d2fbd7d 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIteratorTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/MergedSortedCacheSessionStoreIteratorTest.java
@@ -46,7 +46,7 @@ public class MergedSortedCacheSessionStoreIteratorTest {
     private final SessionWindow cacheWindow = new SessionWindow(10, 20);
     private final Iterator<KeyValue<Bytes, LRUCacheEntry>> cacheKvs = Collections.singleton(KeyValue.pair(
             SessionKeySerde.toBinary(
-                    new Windowed<>(cacheKey, cacheWindow), Serdes.String().serializer()), new LRUCacheEntry(cacheKey.getBytes())))
+                    new Windowed<>(cacheKey, cacheWindow), Serdes.String().serializer(), "topic"), new LRUCacheEntry(cacheKey.getBytes())))
             .iterator();
 
     @Test
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSegmentedBytesStoreTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSegmentedBytesStoreTest.java
index 3763290765e85..e9c8f890930b1 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSegmentedBytesStoreTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/RocksDBSegmentedBytesStoreTest.java
@@ -155,7 +155,7 @@ private byte[] serializeValue(final long value) {
     }
 
     private Bytes serializeKey(final Windowed<String> key) {
-        return SessionKeySerde.toBinary(key, Serdes.String().serializer());
+        return SessionKeySerde.toBinary(key, Serdes.String().serializer(), "topic");
     }
 
     private List<KeyValue<Windowed<String>, Long>> toList(final KeyValueIterator<Bytes, byte[]> iterator) {
@@ -163,7 +163,7 @@ private List<KeyValue<Windowed<String>, Long>> toList(final KeyValueIterator<Byt
         while (iterator.hasNext()) {
             final KeyValue<Bytes, byte[]> next = iterator.next();
             final KeyValue<Windowed<String>, Long> deserialized
-                    = KeyValue.pair(SessionKeySerde.from(next.key.get(), Serdes.String().deserializer()), Serdes.Long().deserializer().deserialize("", next.value));
+                    = KeyValue.pair(SessionKeySerde.from(next.key.get(), Serdes.String().deserializer(), "topic"), Serdes.Long().deserializer().deserialize("", next.value));
             results.add(deserialized);
         }
         return results;
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/StateStoreTestUtils.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/StateStoreTestUtils.java
index 5fc9e1ffed26b..bb958276ebcf4 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/StateStoreTestUtils.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/StateStoreTestUtils.java
@@ -18,6 +18,7 @@
 
 import org.apache.kafka.common.utils.MockTime;
 import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.processor.internals.ProcessorStateManager;
 import org.apache.kafka.streams.state.KeyValueStore;
 import org.apache.kafka.streams.state.StateSerdes;
 import org.apache.kafka.test.MockProcessorContext;
@@ -28,7 +29,7 @@
 @SuppressWarnings("unchecked")
 public class StateStoreTestUtils {
 
-    public static <K, V> KeyValueStore<K, V> newKeyValueStore(String name, Class<K> keyType, Class<V> valueType) {
+    public static <K, V> KeyValueStore<K, V> newKeyValueStore(String name, String applicationId, Class<K> keyType, Class<V> valueType) {
         final InMemoryKeyValueStoreSupplier<K, V> supplier = new InMemoryKeyValueStoreSupplier<>(name,
                                                                                                  null,
                                                                                                  null,
@@ -37,8 +38,14 @@ public static <K, V> KeyValueStore<K, V> newKeyValueStore(String name, Class<K>
                                                                                                  Collections.<String, String>emptyMap());
 
         final StateStore stateStore = supplier.get();
-        stateStore.init(new MockProcessorContext(StateSerdes.withBuiltinTypes(name, keyType, valueType),
-                new NoOpRecordCollector()), stateStore);
+        stateStore.init(
+            new MockProcessorContext(
+                StateSerdes.withBuiltinTypes(
+                    ProcessorStateManager.storeChangelogTopic(applicationId, name),
+                    keyType,
+                    valueType),
+                new NoOpRecordCollector()),
+            stateStore);
         return (KeyValueStore<K, V>) stateStore;
 
     }
diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/WrappingStoreProviderTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/WrappingStoreProviderTest.java
index 708e1534dcc1e..85270cef06c6f 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/WrappingStoreProviderTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/WrappingStoreProviderTest.java
@@ -42,9 +42,9 @@ public void before() {
         final StateStoreProviderStub stubProviderTwo = new StateStoreProviderStub(false);
 
 
-        stubProviderOne.addStore("kv", StateStoreTestUtils.newKeyValueStore("kv", String.class, String.class));
+        stubProviderOne.addStore("kv", StateStoreTestUtils.newKeyValueStore("kv", "app-id", String.class, String.class));
         stubProviderOne.addStore("window", new NoOpWindowStore());
-        stubProviderTwo.addStore("kv", StateStoreTestUtils.newKeyValueStore("kv", String.class, String.class));
+        stubProviderTwo.addStore("kv", StateStoreTestUtils.newKeyValueStore("kv", "app-id", String.class, String.class));
         stubProviderTwo.addStore("window", new NoOpWindowStore());
 
         wrappingStoreProvider = new WrappingStoreProvider(

From 2dfeff064a5f0a5adfb5adb29015e0fdcc85c45a Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno.thereska@gmail.com>
Date: Thu, 6 Apr 2017 12:28:40 +0100
Subject: [PATCH 153/177] MINOR: Improve log4j on stream thread and stream
 process

Cherry pick from https://github.com/apache/kafka/pull/2685

Author: Eno Thereska <eno.thereska@gmail.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2817 from enothereska/KMinor-improve-log4j-0.10.2
---
 .../apache/kafka/streams/KafkaStreams.java    | 24 +++++++----
 .../processor/internals/StreamThread.java     | 40 ++++++++-----------
 2 files changed, 32 insertions(+), 32 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java b/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
index 68157b7ee4ee2..cd0e86153103c 100644
--- a/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
+++ b/streams/src/main/java/org/apache/kafka/streams/KafkaStreams.java
@@ -132,6 +132,7 @@ public class KafkaStreams {
     // of the co-location of stream thread's consumers. It is for internal
     // usage only and should not be exposed to users at all.
     private final UUID processId;
+    private final String logPrefix;
     private final StreamsMetadataState streamsMetadataState;
 
     private final StreamsConfig config;
@@ -218,9 +219,13 @@ public void setStateListener(final StateListener listener) {
     private synchronized void setState(final State newState) {
         final State oldState = state;
         if (!state.isValidTransition(newState)) {
-            log.warn("Unexpected state transition from {} to {}.", oldState, newState);
+            log.warn("{} Unexpected state transition from {} to {}.", logPrefix, oldState, newState);
+        } else {
+            log.info("{} State transition from {} to {}.", logPrefix, oldState, newState);
         }
+
         state = newState;
+
         if (stateListener != null) {
             stateListener.onChange(state, oldState);
         }
@@ -311,6 +316,8 @@ public KafkaStreams(final TopologyBuilder builder,
         if (clientId.length() <= 0)
             clientId = applicationId + "-" + processId;
 
+        this.logPrefix = String.format("stream-client [%s]", clientId);
+
         final List<MetricsReporter> reporters = config.getConfiguredInstances(StreamsConfig.METRIC_REPORTER_CLASSES_CONFIG,
             MetricsReporter.class);
         reporters.add(new JmxReporter(JMX_PREFIX));
@@ -330,7 +337,7 @@ public KafkaStreams(final TopologyBuilder builder,
         final ProcessorTopology globalTaskTopology = builder.buildGlobalStateTopology();
 
         if (config.getLong(StreamsConfig.CACHE_MAX_BYTES_BUFFERING_CONFIG) < 0) {
-            log.warn("Negative cache size passed in. Reverting to cache size of 0 bytes.");
+            log.warn("{} Negative cache size passed in. Reverting to cache size of 0 bytes.", logPrefix);
         }
 
         final long cacheSizeBytes = Math.max(0, config.getLong(StreamsConfig.CACHE_MAX_BYTES_BUFFERING_CONFIG) /
@@ -396,7 +403,7 @@ private void checkBrokerVersionCompatibility() throws StreamsException {
         try {
             client.close();
         } catch (final IOException e) {
-            log.warn("Could not close StreamKafkaClient.", e);
+            log.warn("{} Could not close StreamKafkaClient.", logPrefix, e);
         }
 
     }
@@ -412,7 +419,7 @@ private void checkBrokerVersionCompatibility() throws StreamsException {
      * @throws StreamsException if the Kafka brokers have version 0.10.0.x
      */
     public synchronized void start() throws IllegalStateException, StreamsException {
-        log.debug("Starting Kafka Stream process.");
+        log.debug("{} Starting Kafka Stream process.", logPrefix);
 
         if (state == State.CREATED) {
             checkBrokerVersionCompatibility();
@@ -426,7 +433,7 @@ public synchronized void start() throws IllegalStateException, StreamsException
                 thread.start();
             }
 
-            log.info("Started Kafka Stream process");
+            log.info("{} Started Kafka Stream process", logPrefix);
         } else {
             throw new IllegalStateException("Cannot start again.");
         }
@@ -451,7 +458,7 @@ public void close() {
      * before all threads stopped
      */
     public synchronized boolean close(final long timeout, final TimeUnit timeUnit) {
-        log.debug("Stopping Kafka Stream process.");
+        log.debug("{} Stopping Kafka Stream process.", logPrefix);
         if (state.isCreatedOrRunning()) {
             setState(State.PENDING_SHUTDOWN);
             // save the current thread so that if it is a stream thread
@@ -487,7 +494,7 @@ public void run() {
                     }
 
                     metrics.close();
-                    log.info("Stopped Kafka Streams process.");
+                    log.info("{} Stopped Kafka Streams process.", logPrefix);
                 }
             }, "kafka-streams-close-thread");
             shutdown.setDaemon(true);
@@ -557,7 +564,8 @@ public void cleanUp() {
         final String stateDir = config.getString(StreamsConfig.STATE_DIR_CONFIG);
 
         final String localApplicationDir = stateDir + File.separator + appId;
-        log.debug("Removing local Kafka Streams application data in {} for application {}.",
+        log.debug("{} Removing local Kafka Streams application data in {} for application {}.",
+            logPrefix,
             localApplicationDir,
             appId);
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
index d053431bd7cdb..5e64515b37cb5 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
@@ -158,8 +158,11 @@ public synchronized State state() {
     private synchronized void setState(State newState) {
         State oldState = state;
         if (!state.isValidTransition(newState)) {
-            log.warn("Unexpected state transition from " + state + " to " + newState);
+            log.warn("{} Unexpected state transition from {} to {}.", logPrefix, oldState, newState);
+        } else {
+            log.info("{} State transition from {} to {}.", logPrefix, oldState, newState);
         }
+
         state = newState;
         if (stateListener != null) {
             stateListener.onChange(this, state, oldState);
@@ -222,13 +225,7 @@ private synchronized void setStateWhenNotInPendingShutdown(final State newState)
         public void onPartitionsAssigned(Collection<TopicPartition> assignment) {
 
             try {
-                if (state == State.PENDING_SHUTDOWN) {
-                    log.info("stream-thread [{}] New partitions [{}] assigned while shutting down.",
-                        StreamThread.this.getName(), assignment);
-                }
-                log.info("stream-thread [{}] New partitions [{}] assigned at the end of consumer rebalance.",
-                    StreamThread.this.getName(), assignment);
-
+                log.info("{} at state {}: new partitions {} assigned at the end of consumer rebalance.", logPrefix, state, assignment);
                 setStateWhenNotInPendingShutdown(State.ASSIGNING_PARTITIONS);
                 // do this first as we may have suspended standby tasks that
                 // will become active or vice versa
@@ -248,12 +245,7 @@ public void onPartitionsAssigned(Collection<TopicPartition> assignment) {
         @Override
         public void onPartitionsRevoked(Collection<TopicPartition> assignment) {
             try {
-                if (state == State.PENDING_SHUTDOWN) {
-                    log.info("stream-thread [{}] New partitions [{}] revoked while shutting down.",
-                             StreamThread.this.getName(), assignment);
-                }
-                log.info("stream-thread [{}] partitions [{}] revoked at the beginning of consumer rebalance.",
-                         StreamThread.this.getName(), assignment);
+                log.info("{} at state {}: partitions {} revoked at the beginning of consumer rebalance.", logPrefix, state, assignment);
                 setStateWhenNotInPendingShutdown(State.PARTITIONS_REVOKED);
                 lastCleanMs = Long.MAX_VALUE; // stop the cleaning cycle until partitions are assigned
                 // suspend active tasks
@@ -348,7 +340,7 @@ public StreamThread(TopologyBuilder builder,
         this.timerStartedMs = time.milliseconds();
         this.lastCleanMs = Long.MAX_VALUE; // the cleaning cycle won't start until partition assignment
         this.lastCommitMs = timerStartedMs;
-        setState(state.RUNNING);
+        setState(State.RUNNING);
     }
 
     public void partitionAssignor(StreamPartitionAssignor partitionAssignor) {
@@ -417,7 +409,7 @@ private void shutdown() {
         try {
             partitionAssignor.close();
         } catch (Throwable e) {
-            log.error("stream-thread [{}] Failed to close KafkaStreamClient: ", this.getName(), e);
+            log.error("{} Failed to close KafkaStreamClient: ", logPrefix, e);
         }
 
         removeStreamTasks();
@@ -444,7 +436,7 @@ private RuntimeException unAssignChangeLogPartitions() {
 
     @SuppressWarnings("ThrowableNotThrown")
     private void shutdownTasksAndState() {
-        log.debug("{} shutdownTasksAndState: shutting down all active tasks [{}] and standby tasks [{}]", logPrefix,
+        log.debug("{} shutdownTasksAndState: shutting down all active tasks {} and standby tasks {}", logPrefix,
             activeTasks.keySet(), standbyTasks.keySet());
 
         final AtomicReference<RuntimeException> firstException = new AtomicReference<>(null);
@@ -469,7 +461,7 @@ private void shutdownTasksAndState() {
      * soon the tasks will be assigned again
      */
     private void suspendTasksAndState()  {
-        log.debug("{} suspendTasksAndState: suspending all active tasks [{}] and standby tasks [{}]", logPrefix,
+        log.debug("{} suspendTasksAndState: suspending all active tasks {} and standby tasks {}", logPrefix,
             activeTasks.keySet(), standbyTasks.keySet());
         final AtomicReference<RuntimeException> firstException = new AtomicReference<>(null);
         // Close all topology nodes
@@ -762,7 +754,7 @@ protected void maybeClean() {
      * Commit the states of all its tasks
      */
     private void commitAll() {
-        log.trace("stream-thread [{}] Committing all its owned tasks", this.getName());
+        log.trace("{} Committing all its owned tasks", logPrefix);
         for (StreamTask task : activeTasks.values()) {
             commitOne(task);
         }
@@ -828,7 +820,7 @@ public Set<TaskId> cachedTasks() {
     }
 
     protected StreamTask createStreamTask(TaskId id, Collection<TopicPartition> partitions) {
-        log.info("{} Creating active task {} with assigned partitions [{}]", logPrefix, id, partitions);
+        log.info("{} Creating active task {} with assigned partitions {}", logPrefix, id, partitions);
 
         streamsMetrics.taskCreatedSensor.record();
 
@@ -941,7 +933,7 @@ private void addStreamTasks(Collection<TopicPartition> assignment) {
     }
 
     StandbyTask createStandbyTask(TaskId id, Collection<TopicPartition> partitions) {
-        log.info("{} Creating new standby task {} with assigned partitions [{}]", logPrefix, id, partitions);
+        log.info("{} Creating new standby task {} with assigned partitions {}", logPrefix, id, partitions);
 
         streamsMetrics.taskCreatedSensor.record();
 
@@ -1012,14 +1004,14 @@ private void updateStandByTaskMaps(final Map<TopicPartition, Long> checkpointedO
     }
 
     private void updateSuspendedTasks() {
-        log.info("{} Updating suspended tasks to contain active tasks [{}]", logPrefix, activeTasks.keySet());
+        log.info("{} Updating suspended tasks to contain active tasks {}", logPrefix, activeTasks.keySet());
         suspendedTasks.clear();
         suspendedTasks.putAll(activeTasks);
         suspendedStandbyTasks.putAll(standbyTasks);
     }
 
     private void removeStreamTasks() {
-        log.info("{} Removing all active tasks [{}]", logPrefix, activeTasks.keySet());
+        log.info("{} Removing all active tasks {}", logPrefix, activeTasks.keySet());
 
         try {
             prevTasks.clear();
@@ -1034,7 +1026,7 @@ private void removeStreamTasks() {
     }
 
     private void removeStandbyTasks() {
-        log.info("{} Removing all standby tasks [{}]", logPrefix, standbyTasks.keySet());
+        log.info("{} Removing all standby tasks {}", logPrefix, standbyTasks.keySet());
 
         standbyTasks.clear();
         standbyTasksByPartition.clear();

From 8e35721ce811cb0807b45d3a18c55329f2f79c4c Mon Sep 17 00:00:00 2001
From: "Michael G. Noll" <michael@confluent.io>
Date: Thu, 6 Apr 2017 12:34:19 +0100
Subject: [PATCH 154/177] MINOR: Improve topic management instructions for
 Kafka Streams examples

Author: Michael G. Noll <michael@confluent.io>

Reviewers: Matthias J. Sax <matthias@confluent.io>, Eno Thereska <eno@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2812 from miguno/trunk-streams-examples-docs

(cherry picked from commit 6ba98f6e5ad8776b7268441b5392330496565814)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../kafka/streams/examples/pageview/PageViewTypedDemo.java | 7 ++++---
 .../streams/examples/pageview/PageViewUntypedDemo.java     | 5 +++--
 .../org/apache/kafka/streams/examples/pipe/PipeDemo.java   | 5 +++--
 .../kafka/streams/examples/wordcount/WordCountDemo.java    | 5 +++--
 .../streams/examples/wordcount/WordCountProcessorDemo.java | 5 +++--
 5 files changed, 16 insertions(+), 11 deletions(-)

diff --git a/streams/examples/src/main/java/org/apache/kafka/streams/examples/pageview/PageViewTypedDemo.java b/streams/examples/src/main/java/org/apache/kafka/streams/examples/pageview/PageViewTypedDemo.java
index 47567223862e8..7a930756182d9 100644
--- a/streams/examples/src/main/java/org/apache/kafka/streams/examples/pageview/PageViewTypedDemo.java
+++ b/streams/examples/src/main/java/org/apache/kafka/streams/examples/pageview/PageViewTypedDemo.java
@@ -42,12 +42,13 @@
  * using specific data types (here: JSON POJO; but can also be Avro specific bindings, etc.) for serdes
  * in Kafka Streams.
  *
- * In this example, we join a stream of pageviews (aka clickstreams) that reads from  a topic named "streams-pageview-input"
+ * In this example, we join a stream of pageviews (aka clickstreams) that reads from a topic named "streams-pageview-input"
  * with a user profile table that reads from a topic named "streams-userprofile-input", where the data format
  * is JSON string representing a record in the stream or table, to compute the number of pageviews per user region.
  *
- * Before running this example you must create the source topic (e.g. via bin/kafka-topics.sh --create ...)
- * and write some data to it (e.g. via bin-kafka-console-producer.sh). Otherwise you won't see any data arriving in the output topic.
+ * Before running this example you must create the input topics and the output topic (e.g. via
+ * bin/kafka-topics.sh --create ...), and write some data to the input topics (e.g. via
+ * bin/kafka-console-producer.sh). Otherwise you won't see any data arriving in the output topic.
  */
 public class PageViewTypedDemo {
 
diff --git a/streams/examples/src/main/java/org/apache/kafka/streams/examples/pageview/PageViewUntypedDemo.java b/streams/examples/src/main/java/org/apache/kafka/streams/examples/pageview/PageViewUntypedDemo.java
index 67e8cc50c7dfa..68becdef0e63c 100644
--- a/streams/examples/src/main/java/org/apache/kafka/streams/examples/pageview/PageViewUntypedDemo.java
+++ b/streams/examples/src/main/java/org/apache/kafka/streams/examples/pageview/PageViewUntypedDemo.java
@@ -50,8 +50,9 @@
  * with a user profile table that reads from a topic named "streams-userprofile-input", where the data format
  * is JSON string representing a record in the stream or table, to compute the number of pageviews per user region.
  *
- * Before running this example you must create the source topic (e.g. via bin/kafka-topics.sh --create ...)
- * and write some data to it (e.g. via bin-kafka-console-producer.sh). Otherwise you won't see any data arriving in the output topic.
+ * Before running this example you must create the input topics and the output topic (e.g. via
+ * bin/kafka-topics.sh --create ...), and write some data to the input topics (e.g. via
+ * bin/kafka-console-producer.sh). Otherwise you won't see any data arriving in the output topic.
  */
 public class PageViewUntypedDemo {
 
diff --git a/streams/examples/src/main/java/org/apache/kafka/streams/examples/pipe/PipeDemo.java b/streams/examples/src/main/java/org/apache/kafka/streams/examples/pipe/PipeDemo.java
index 3c1bd8c049a67..6626f4597d2e4 100644
--- a/streams/examples/src/main/java/org/apache/kafka/streams/examples/pipe/PipeDemo.java
+++ b/streams/examples/src/main/java/org/apache/kafka/streams/examples/pipe/PipeDemo.java
@@ -32,8 +32,9 @@
  * In this example, we implement a simple "pipe" program that reads from a source topic "streams-file-input"
  * and writes the data as-is (i.e. unmodified) into a sink topic "streams-pipe-output".
  *
- * Before running this example you must create the source topic (e.g. via bin/kafka-topics.sh --create ...)
- * and write some data to it (e.g. via bin-kafka-console-producer.sh). Otherwise you won't see any data arriving in the output topic.
+ * Before running this example you must create the input topic and the output topic (e.g. via
+ * bin/kafka-topics.sh --create ...), and write some data to the input topic (e.g. via
+ * bin/kafka-console-producer.sh). Otherwise you won't see any data arriving in the output topic.
  */
 public class PipeDemo {
 
diff --git a/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountDemo.java b/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountDemo.java
index b1d3c52a0bb56..892c66cb3416f 100644
--- a/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountDemo.java
+++ b/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountDemo.java
@@ -40,8 +40,9 @@
  * represent lines of text; and the histogram output is written to topic "streams-wordcount-output" where each record
  * is an updated count of a single word.
  *
- * Before running this example you must create the source topic (e.g. via bin/kafka-topics.sh --create ...)
- * and write some data to it (e.g. via bin-kafka-console-producer.sh). Otherwise you won't see any data arriving in the output topic.
+ * Before running this example you must create the input topic and the output topic (e.g. via
+ * bin/kafka-topics.sh --create ...), and write some data to the input topic (e.g. via
+ * bin/kafka-console-producer.sh). Otherwise you won't see any data arriving in the output topic.
  */
 public class WordCountDemo {
 
diff --git a/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountProcessorDemo.java b/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountProcessorDemo.java
index 9d2424a9615b5..aefaf41e6f468 100644
--- a/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountProcessorDemo.java
+++ b/streams/examples/src/main/java/org/apache/kafka/streams/examples/wordcount/WordCountProcessorDemo.java
@@ -41,8 +41,9 @@
  * represent lines of text; and the histogram output is written to topic "streams-wordcount-processor-output" where each record
  * is an updated count of a single word.
  *
- * Before running this example you must create the source topic (e.g. via bin/kafka-topics.sh --create ...)
- * and write some data to it (e.g. via bin/kafka-console-producer.sh). Otherwise you won't see any data arriving in the output topic.
+ * Before running this example you must create the input topic and the output topic (e.g. via
+ * bin/kafka-topics.sh --create ...), and write some data to the input topic (e.g. via
+ * bin/kafka-console-producer.sh). Otherwise you won't see any data arriving in the output topic.
  */
 public class WordCountProcessorDemo {
 

From 7028384bfb4c8d761c15bc11e2156278249e721a Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Thu, 6 Apr 2017 14:44:40 +0100
Subject: [PATCH 155/177] MINOR: Clarify ReadOnlyWindowStore's time range
 behaviour

Highlight that the range in `fetch` is inclusive of both `timeFrom` and `timeTo`

Author: Damian Guy <damian.guy@gmail.com>

Reviewers: Michael G. Noll <michael@confluent.io>, Matthias J. Sax <matthias@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2811 from dguy/minor-window-fetch-java-doc

(cherry picked from commit b611cfa5c0f4941a491781424afd9b699bdb894e)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../streams/state/ReadOnlyWindowStore.java    | 21 ++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/state/ReadOnlyWindowStore.java b/streams/src/main/java/org/apache/kafka/streams/state/ReadOnlyWindowStore.java
index 80da9e8f9cfa1..4f9b78a772140 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/ReadOnlyWindowStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/ReadOnlyWindowStore.java
@@ -30,7 +30,26 @@ public interface ReadOnlyWindowStore<K, V> {
     /**
      * Get all the key-value pairs with the given key and the time range from all
      * the existing windows.
-     *
+     * <p>
+     * The time range is inclusive and applies to the starting timestamp of the window.
+     * For example, if we have the following windows:
+     * <p>
+     * <pre>
+     * +-------------------------------+
+     * |  key  | start time | end time |
+     * +-------+------------+----------+
+     * |   A   |     10     |    20    |
+     * +-------+------------+----------+
+     * |   A   |     15     |    25    |
+     * +-------+------------+----------+
+     * |   A   |     20     |    30    |
+     * +-------+------------+----------+
+     * |   A   |     25     |    35    |
+     * +--------------------------------
+     * </pre>
+     * And we call {@code store.fetch("A", 10, 20)} then the results will contain the first
+     * three windows from the table above, i.e., all those where 10 <= start time <= 20.
+     * 
      * @return an iterator over key-value pairs {@code <timestamp, value>}
      * @throws InvalidStateStoreException if the store is not initialized
      */

From 5edb09fcb86e2b06b1da233d94cc3631dc8eca03 Mon Sep 17 00:00:00 2001
From: Bruce Szalwinski <bruce.szalwinski@cdk.com>
Date: Wed, 22 Mar 2017 16:02:09 -0500
Subject: [PATCH 156/177] KAFKA-4929: Transformation Key/Value type references
 should be to class name(), not canonicalName()

Changing getCanonicalName() references to getName() so that docs update with "$" instead of ".".  Also added a connect-plugin-discovery.sh CLI to list all of the transformations available.

Author: Bruce Szalwinski <bruce.szalwinski@cdk.com>

Reviewers: Gwen Shapira

Closes #2720 from bruce-szalwinski/transforms and squashes the following commits:

ec3b5b9 [Bruce Szalwinski] remove connect-plugin-discovery.  will submit in a different PR
eba0af7 [Bruce Szalwinski] Key / Value transformations are static nested classes and so are referenced using OuterClass$Key and OuterClass$Value.

(cherry picked from commit 763ea5aad191b09ed3deefaa12ce7b9925ebe7dc)
---
 .../org/apache/kafka/connect/runtime/PluginDiscovery.java     | 2 +-
 .../org/apache/kafka/connect/transforms/ExtractField.java     | 4 ++--
 .../java/org/apache/kafka/connect/transforms/HoistField.java  | 4 ++--
 .../java/org/apache/kafka/connect/transforms/InsertField.java | 4 ++--
 .../java/org/apache/kafka/connect/transforms/MaskField.java   | 4 ++--
 .../org/apache/kafka/connect/transforms/ReplaceField.java     | 4 +++-
 .../apache/kafka/connect/transforms/SetSchemaMetadata.java    | 4 ++--
 7 files changed, 14 insertions(+), 12 deletions(-)

diff --git a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/PluginDiscovery.java b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/PluginDiscovery.java
index 847f527c43dd9..6fb843e44f88c 100644
--- a/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/PluginDiscovery.java
+++ b/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/PluginDiscovery.java
@@ -107,7 +107,7 @@ private static List<Class<? extends Transformation>> transformationPlugins(Refle
         Collections.sort(transformationPlugins, new Comparator<Class<? extends Transformation>>() {
             @Override
             public int compare(Class<? extends Transformation> a, Class<? extends Transformation> b) {
-                return a.getCanonicalName().compareTo(b.getCanonicalName());
+                return a.getName().compareTo(b.getName());
             }
         });
 
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ExtractField.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ExtractField.java
index b7063136e9df1..5e934ca39d67c 100644
--- a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ExtractField.java
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ExtractField.java
@@ -32,8 +32,8 @@ public abstract class ExtractField<R extends ConnectRecord<R>> implements Transf
 
     public static final String OVERVIEW_DOC =
             "Extract the specified field from a Struct when schema present, or a Map in the case of schemaless data."
-                    + "<p/>Use the concrete transformation type designed for the record key (<code>" + Key.class.getCanonicalName() + "</code>) "
-                    + "or value (<code>" + Value.class.getCanonicalName() + "</code>).";
+                    + "<p/>Use the concrete transformation type designed for the record key (<code>" + Key.class.getName() + "</code>) "
+                    + "or value (<code>" + Value.class.getName() + "</code>).";
 
     private static final String FIELD_CONFIG = "field";
 
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/HoistField.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/HoistField.java
index 1f2ed7c8e626f..9ae1c8115c9f5 100644
--- a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/HoistField.java
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/HoistField.java
@@ -34,8 +34,8 @@ public abstract class HoistField<R extends ConnectRecord<R>> implements Transfor
 
     public static final String OVERVIEW_DOC =
             "Wrap data using the specified field name in a Struct when schema present, or a Map in the case of schemaless data."
-                    + "<p/>Use the concrete transformation type designed for the record key (<code>" + Key.class.getCanonicalName() + "</code>) "
-                    + "or value (<code>" + Value.class.getCanonicalName() + "</code>).";
+                    + "<p/>Use the concrete transformation type designed for the record key (<code>" + Key.class.getName() + "</code>) "
+                    + "or value (<code>" + Value.class.getName() + "</code>).";
 
     private static final String FIELD_CONFIG = "field";
 
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/InsertField.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/InsertField.java
index f32d6ed2e9465..54b6c1450504e 100644
--- a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/InsertField.java
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/InsertField.java
@@ -43,8 +43,8 @@ public abstract class InsertField<R extends ConnectRecord<R>> implements Transfo
 
     public static final String OVERVIEW_DOC =
             "Insert field(s) using attributes from the record metadata or a configured static value."
-                    + "<p/>Use the concrete transformation type designed for the record key (<code>" + Key.class.getCanonicalName() + "</code>) "
-                    + "or value (<code>" + Value.class.getCanonicalName() + "</code>).";
+                    + "<p/>Use the concrete transformation type designed for the record key (<code>" + Key.class.getName() + "</code>) "
+                    + "or value (<code>" + Value.class.getName() + "</code>).";
 
     private interface ConfigName {
         String TOPIC_FIELD = "topic.field";
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/MaskField.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/MaskField.java
index d7ef2aa8429ad..ae8cf864b2f14 100644
--- a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/MaskField.java
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/MaskField.java
@@ -43,8 +43,8 @@ public abstract class MaskField<R extends ConnectRecord<R>> implements Transform
 
     public static final String OVERVIEW_DOC =
             "Mask specified fields with a valid null value for the field type (i.e. 0, false, empty string, and so on)."
-                    + "<p/>Use the concrete transformation type designed for the record key (<code>" + Key.class.getCanonicalName() + "</code>) "
-                    + "or value (<code>" + Value.class.getCanonicalName() + "</code>).";
+                    + "<p/>Use the concrete transformation type designed for the record key (<code>" + Key.class.getName() + "</code>) "
+                    + "or value (<code>" + Value.class.getName() + "</code>).";
 
     private static final String FIELDS_CONFIG = "fields";
 
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ReplaceField.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ReplaceField.java
index 6faf84250af07..ab71a69f9169c 100644
--- a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ReplaceField.java
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/ReplaceField.java
@@ -40,7 +40,9 @@
 
 public abstract class ReplaceField<R extends ConnectRecord<R>> implements Transformation<R> {
 
-    public static final String OVERVIEW_DOC = "Filter or rename fields.";
+    public static final String OVERVIEW_DOC = "Filter or rename fields."
+            + "<p/>Use the concrete transformation type designed for the record key (<code>" + Key.class.getName() + "</code>) "
+            + "or value (<code>" + Value.class.getName() + "</code>).";
 
     interface ConfigName {
         String BLACKLIST = "blacklist";
diff --git a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/SetSchemaMetadata.java b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/SetSchemaMetadata.java
index f3076b445719b..017e5d4455e04 100644
--- a/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/SetSchemaMetadata.java
+++ b/connect/transforms/src/main/java/org/apache/kafka/connect/transforms/SetSchemaMetadata.java
@@ -31,8 +31,8 @@
 public abstract class SetSchemaMetadata<R extends ConnectRecord<R>> implements Transformation<R> {
 
     public static final String OVERVIEW_DOC =
-            "Set the schema name, version or both on the record's key (<code>" + Key.class.getCanonicalName() + "</code>)"
-                    + " or value (<code>" + Value.class.getCanonicalName() + "</code>) schema.";
+            "Set the schema name, version or both on the record's key (<code>" + Key.class.getName() + "</code>)"
+                    + " or value (<code>" + Value.class.getName() + "</code>) schema.";
 
     private interface ConfigName {
         String SCHEMA_NAME = "schema.name";

From 4def30c6720b45f6a766a1fc394a75230b66ef26 Mon Sep 17 00:00:00 2001
From: Ismael Juma <ismael@juma.me.uk>
Date: Thu, 6 Apr 2017 21:58:27 +0100
Subject: [PATCH 157/177] KAFKA-4901; Make ProduceRequest thread-safe

A more conservative version of the change for the 0.10.2
branch.

Trunk commit: 1659ca1773596b.

Author: Ismael Juma <ismael@juma.me.uk>

Reviewers: Jun Rao <junrao@gmail.com>

Closes #2810 from ijuma/kafka-4901-produce-request-thread-safety-0-10-2
---
 .../kafka/common/requests/ProduceRequest.java | 52 +++++++++++++++++--
 .../common/requests/RequestResponseTest.java  | 43 +++++++++++++++
 .../main/scala/kafka/server/KafkaApis.scala   | 14 ++---
 3 files changed, 97 insertions(+), 12 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/common/requests/ProduceRequest.java b/clients/src/main/java/org/apache/kafka/common/requests/ProduceRequest.java
index bd3ae8ff3b531..e0e009007ac60 100644
--- a/clients/src/main/java/org/apache/kafka/common/requests/ProduceRequest.java
+++ b/clients/src/main/java/org/apache/kafka/common/requests/ProduceRequest.java
@@ -25,6 +25,7 @@
 
 import java.nio.ByteBuffer;
 import java.util.ArrayList;
+import java.util.Collection;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
@@ -77,7 +78,13 @@ public String toString() {
 
     private final short acks;
     private final int timeout;
-    private final Map<TopicPartition, MemoryRecords> partitionRecords;
+
+    private final Map<TopicPartition, Integer> partitionSizes;
+
+    // This is set to null by `clearPartitionRecords` to prevent unnecessary memory retention when a produce request is
+    // put in the purgatory (due to client throttling, it can take a while before the response is sent).
+    // Care should be taken in methods that use this field.
+    private volatile Map<TopicPartition, MemoryRecords> partitionRecords;
 
     private ProduceRequest(short version, short acks, int timeout, Map<TopicPartition, MemoryRecords> partitionRecords) {
         super(new Struct(ProtoUtils.requestSchema(ApiKeys.PRODUCE.id, version)), version);
@@ -103,6 +110,14 @@ private ProduceRequest(short version, short acks, int timeout, Map<TopicPartitio
         this.acks = acks;
         this.timeout = timeout;
         this.partitionRecords = partitionRecords;
+        this.partitionSizes = createPartitionSizes(partitionRecords);
+    }
+
+    private static Map<TopicPartition, Integer> createPartitionSizes(Map<TopicPartition, MemoryRecords> partitionRecords) {
+        Map<TopicPartition, Integer> result = new HashMap<>(partitionRecords.size());
+        for (Map.Entry<TopicPartition, MemoryRecords> entry : partitionRecords.entrySet())
+            result.put(entry.getKey(), entry.getValue().sizeInBytes());
+        return result;
     }
 
     public ProduceRequest(Struct struct, short version) {
@@ -118,10 +133,23 @@ public ProduceRequest(Struct struct, short version) {
                 partitionRecords.put(new TopicPartition(topic, partition), records);
             }
         }
+        partitionSizes = createPartitionSizes(partitionRecords);
         acks = struct.getShort(ACKS_KEY_NAME);
         timeout = struct.getInt(TIMEOUT_KEY_NAME);
     }
 
+    @Override
+    public String toString() {
+        // Use the same format as `Struct.toString()`
+        StringBuilder bld = new StringBuilder();
+        bld.append("{acks=").append(acks)
+                .append(",timeout=").append(timeout)
+                .append(",partitionSizes=")
+                .append(Utils.mkString(partitionSizes, "[", "]", "=", ","))
+                .append("}");
+        return bld.toString();
+    }
+
     @Override
     public AbstractResponse getErrorResponse(Throwable e) {
         /* In case the producer doesn't actually want any response */
@@ -131,8 +159,8 @@ public AbstractResponse getErrorResponse(Throwable e) {
         Map<TopicPartition, ProduceResponse.PartitionResponse> responseMap = new HashMap<>();
         ProduceResponse.PartitionResponse partitionResponse = new ProduceResponse.PartitionResponse(Errors.forException(e));
 
-        for (Map.Entry<TopicPartition, MemoryRecords> entry : partitionRecords.entrySet())
-            responseMap.put(entry.getKey(), partitionResponse);
+        for (TopicPartition tp : partitions())
+            responseMap.put(tp, partitionResponse);
 
         short versionId = version();
         switch (versionId) {
@@ -147,6 +175,10 @@ public AbstractResponse getErrorResponse(Throwable e) {
         }
     }
 
+    private Collection<TopicPartition> partitions() {
+        return partitionSizes.keySet();
+    }
+
     public short acks() {
         return acks;
     }
@@ -155,13 +187,23 @@ public int timeout() {
         return timeout;
     }
 
-    public Map<TopicPartition, MemoryRecords> partitionRecords() {
+    /**
+     * Returns the partition records or throws IllegalStateException if clearPartitionRecords() has been invoked.
+     */
+    public Map<TopicPartition, MemoryRecords> partitionRecordsOrFail() {
+        // Store it in a local variable to protect against concurrent updates
+        Map<TopicPartition, MemoryRecords> partitionRecords = this.partitionRecords;
+        if (partitionRecords == null)
+            throw new IllegalStateException("The partition records are no longer available because " +
+                    "clearPartitionRecords() has been invoked.");
         return partitionRecords;
     }
 
     public void clearPartitionRecords() {
+        partitionRecords = null;
+        // It would be better to make this null, but the change is too large for 0.10.2. In trunk, the struct field
+        // was removed
         struct.clear();
-        partitionRecords.clear();
     }
 
     public static ProduceRequest parse(ByteBuffer buffer, int versionId) {
diff --git a/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java b/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java
index 69f6276571832..47313c4c37c12 100644
--- a/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java
+++ b/clients/src/test/java/org/apache/kafka/common/requests/RequestResponseTest.java
@@ -16,6 +16,7 @@
 import org.apache.kafka.common.Node;
 import org.apache.kafka.common.TopicPartition;
 import org.apache.kafka.common.errors.NotCoordinatorForGroupException;
+import org.apache.kafka.common.errors.NotEnoughReplicasException;
 import org.apache.kafka.common.errors.UnknownServerException;
 import org.apache.kafka.common.errors.UnsupportedVersionException;
 import org.apache.kafka.common.network.ListenerName;
@@ -46,6 +47,7 @@
 import static java.util.Collections.singletonList;
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertTrue;
+import static org.junit.Assert.fail;
 
 public class RequestResponseTest {
 
@@ -180,6 +182,47 @@ private void checkSerialization(AbstractRequestResponse req, Integer version) th
                 req.hashCode(), deserialized.hashCode());
     }
 
+    @Test
+    public void produceRequestToStringTest() {
+        ProduceRequest request = createProduceRequest();
+        assertEquals(1, request.partitionRecordsOrFail().size());
+        assertTrue(request.toString().contains("partitionSizes"));
+
+        request.clearPartitionRecords();
+        try {
+            request.partitionRecordsOrFail();
+            fail("partitionRecordsOrFail should fail after clearPartitionRecords()");
+        } catch (IllegalStateException e) {
+            // OK
+        }
+
+        // `toString` should behave the same after `clearPartitionRecords`
+        assertTrue(request.toString().contains("partitionSizes"));
+    }
+
+    @Test
+    public void produceRequestGetErrorResponseTest() {
+        ProduceRequest request = createProduceRequest();
+        Set<TopicPartition> partitions = new HashSet<>(request.partitionRecordsOrFail().keySet());
+
+        ProduceResponse errorResponse = (ProduceResponse) request.getErrorResponse(new NotEnoughReplicasException());
+        assertEquals(partitions, errorResponse.responses().keySet());
+        ProduceResponse.PartitionResponse partitionResponse = errorResponse.responses().values().iterator().next();
+        assertEquals(Errors.NOT_ENOUGH_REPLICAS, partitionResponse.error);
+        assertEquals(ProduceResponse.INVALID_OFFSET, partitionResponse.baseOffset);
+        assertEquals(Record.NO_TIMESTAMP, partitionResponse.logAppendTime);
+
+        request.clearPartitionRecords();
+
+        // `getErrorResponse` should behave the same after `clearPartitionRecords`
+        errorResponse = (ProduceResponse) request.getErrorResponse(new NotEnoughReplicasException());
+        assertEquals(partitions, errorResponse.responses().keySet());
+        partitionResponse = errorResponse.responses().values().iterator().next();
+        assertEquals(Errors.NOT_ENOUGH_REPLICAS, partitionResponse.error);
+        assertEquals(ProduceResponse.INVALID_OFFSET, partitionResponse.baseOffset);
+        assertEquals(Record.NO_TIMESTAMP, partitionResponse.logAppendTime);
+    }
+
     @Test
     public void produceResponseVersionTest() {
         Map<TopicPartition, ProduceResponse.PartitionResponse> responseData = new HashMap<>();
diff --git a/core/src/main/scala/kafka/server/KafkaApis.scala b/core/src/main/scala/kafka/server/KafkaApis.scala
index 134793e95625f..68c3dce1804db 100644
--- a/core/src/main/scala/kafka/server/KafkaApis.scala
+++ b/core/src/main/scala/kafka/server/KafkaApis.scala
@@ -349,12 +349,13 @@ class KafkaApis(val requestChannel: RequestChannel,
     val produceRequest = request.body.asInstanceOf[ProduceRequest]
     val numBytesAppended = request.header.sizeOf + produceRequest.sizeOf
 
-    val (existingAndAuthorizedForDescribeTopics, nonExistingOrUnauthorizedForDescribeTopics) = produceRequest.partitionRecords.asScala.partition {
-      case (topicPartition, _) => authorize(request.session, Describe, new Resource(auth.Topic, topicPartition.topic)) && metadataCache.contains(topicPartition.topic)
-    }
+    val (existingAndAuthorizedForDescribeTopics, nonExistingOrUnauthorizedForDescribeTopics) =
+      produceRequest.partitionRecordsOrFail.asScala.partition { case (tp, _) =>
+        authorize(request.session, Describe, new Resource(auth.Topic, tp.topic)) && metadataCache.contains(tp.topic)
+      }
 
     val (authorizedRequestInfo, unauthorizedForWriteRequestInfo) = existingAndAuthorizedForDescribeTopics.partition {
-      case (topicPartition, _) => authorize(request.session, Write, new Resource(auth.Topic, topicPartition.topic))
+      case (tp, _) => authorize(request.session, Write, new Resource(auth.Topic, tp.topic))
     }
 
     // the callback for sending a produce response
@@ -431,9 +432,8 @@ class KafkaApis(val requestChannel: RequestChannel,
         authorizedRequestInfo,
         sendResponseCallback)
 
-      // if the request is put into the purgatory, it will have a held reference
-      // and hence cannot be garbage collected; hence we clear its data here in
-      // order to let GC re-claim its memory since it is already appended to log
+      // if the request is put into the purgatory, it will have a held reference and hence cannot be garbage collected;
+      // hence we clear its data here inorder to let GC re-claim its memory since it is already appended to log
       produceRequest.clearPartitionRecords()
     }
   }

From 09509949536bc309ba9ab95c7c2fba2111bac056 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Thu, 6 Apr 2017 22:36:37 +0100
Subject: [PATCH 158/177] KAFKA-5003; StreamThread should catch
 InvalidTopicException

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Eno Thereska <eno@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2774 from mjsax/minor-fix-reset-0102
---
 .../processor/internals/StreamThread.java     |  74 +++++---
 ...msFineGrainedAutoResetIntegrationTest.java | 172 +++++++++++++-----
 2 files changed, 173 insertions(+), 73 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
index 5e64515b37cb5..0bf797f5fc479 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
@@ -23,7 +23,7 @@
 import org.apache.kafka.clients.consumer.ConsumerRebalanceListener;
 import org.apache.kafka.clients.consumer.ConsumerRecord;
 import org.apache.kafka.clients.consumer.ConsumerRecords;
-import org.apache.kafka.clients.consumer.NoOffsetForPartitionException;
+import org.apache.kafka.clients.consumer.InvalidOffsetException;
 import org.apache.kafka.clients.producer.Producer;
 import org.apache.kafka.common.KafkaException;
 import org.apache.kafka.common.TopicPartition;
@@ -575,32 +575,8 @@ private void runLoop() {
 
                 try {
                     records = consumer.poll(longPoll ? this.pollTimeMs : 0);
-                } catch (NoOffsetForPartitionException ex) {
-                    TopicPartition partition = ex.partition();
-                    if (builder.earliestResetTopicsPattern().matcher(partition.topic()).matches()) {
-                        log.info(String.format("stream-thread [%s] setting topic to consume from earliest offset %s", this.getName(), partition.topic()));
-                        consumer.seekToBeginning(ex.partitions());
-                    } else if (builder.latestResetTopicsPattern().matcher(partition.topic()).matches()) {
-                        consumer.seekToEnd(ex.partitions());
-                        log.info(String.format("stream-thread [%s] setting topic to consume from latest offset %s", this.getName(), partition.topic()));
-                    } else {
-
-                        if (originalReset == null || (!originalReset.equals("earliest") && !originalReset.equals("latest"))) {
-                            setState(State.PENDING_SHUTDOWN);
-                            String errorMessage = "No valid committed offset found for input topic %s (partition %s) and no valid reset policy configured." +
-                                    " You need to set configuration parameter \"auto.offset.reset\" or specify a topic specific reset " +
-                                    "policy via KStreamBuilder#stream(StreamsConfig.AutoOffsetReset offsetReset, ...) or KStreamBuilder#table(StreamsConfig.AutoOffsetReset offsetReset, ...)";
-                            throw new StreamsException(String.format(errorMessage, partition.topic(), partition.partition()), ex);
-                        }
-
-                        if (originalReset.equals("earliest")) {
-                            consumer.seekToBeginning(ex.partitions());
-                        } else if (originalReset.equals("latest")) {
-                            consumer.seekToEnd(ex.partitions());
-                        }
-                        log.info(String.format("stream-thread [%s] no custom setting defined for topic %s using original config %s for offset reset", this.getName(), partition.topic(), originalReset));
-                    }
-
+                } catch (final InvalidOffsetException e) {
+                    resetInvalidOffsets(e);
                 }
 
                 if (rebalanceException != null)
@@ -661,6 +637,50 @@ private void runLoop() {
         log.info("{} Shutting down at user request", logPrefix);
     }
 
+    private void resetInvalidOffsets(final InvalidOffsetException e) {
+        final Set<TopicPartition> partitions = e.partitions();
+        final Set<String> loggedTopics = new HashSet<>();
+        final Set<TopicPartition> seekToBeginning = new HashSet<>();
+        final Set<TopicPartition> seekToEnd = new HashSet<>();
+
+        for (final TopicPartition partition : partitions) {
+            if (builder.earliestResetTopicsPattern().matcher(partition.topic()).matches()) {
+                addToResetList(partition, seekToBeginning, "stream-thread [%s] setting topic %s to consume from %s offset", "earliest", loggedTopics);
+            } else if (builder.latestResetTopicsPattern().matcher(partition.topic()).matches()) {
+                addToResetList(partition, seekToEnd, "stream-thread [%s] setting topic %s to consume from %s offset", "latest", loggedTopics);
+            } else {
+                if (originalReset == null || (!originalReset.equals("earliest") && !originalReset.equals("latest"))) {
+                    setState(State.PENDING_SHUTDOWN);
+                    final String errorMessage = "No valid committed offset found for input topic %s (partition %s) and no valid reset policy configured." +
+                        " You need to set configuration parameter \"auto.offset.reset\" or specify a topic specific reset " +
+                        "policy via KStreamBuilder#stream(StreamsConfig.AutoOffsetReset offsetReset, ...) or KStreamBuilder#table(StreamsConfig.AutoOffsetReset offsetReset, ...)";
+                    throw new StreamsException(String.format(errorMessage, partition.topic(), partition.partition()), e);
+                }
+
+                if (originalReset.equals("earliest")) {
+                    addToResetList(partition, seekToBeginning, "stream-thread [%s] no custom setting defined for topic %s using original config %s for offset reset", "earliest", loggedTopics);
+                } else if (originalReset.equals("latest")) {
+                    addToResetList(partition, seekToEnd, "stream-thread [%s] no custom setting defined for topic %s using original config %s for offset reset", "latest", loggedTopics);
+                }
+            }
+        }
+
+        if (!seekToBeginning.isEmpty()) {
+            consumer.seekToBeginning(seekToBeginning);
+        }
+        if (!seekToEnd.isEmpty()) {
+            consumer.seekToEnd(seekToEnd);
+        }
+    }
+
+    private void addToResetList(final TopicPartition partition, final Set<TopicPartition> partitions, final String logMessage, final String resetPolicy, final Set<String> loggedTopics) {
+        final String topic = partition.topic();
+        if (loggedTopics.add(topic)) {
+            log.info(String.format(logMessage, getName(), topic, resetPolicy));
+        }
+        partitions.add(partition);
+    }
+
     private void maybeUpdateStandbyTasks() {
         if (!standbyTasks.isEmpty()) {
             if (processStandbyRecords) {
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamsFineGrainedAutoResetIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamsFineGrainedAutoResetIntegrationTest.java
index 2171de1e1e075..fe73b73eb2275 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamsFineGrainedAutoResetIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamsFineGrainedAutoResetIntegrationTest.java
@@ -19,12 +19,16 @@
 
 import kafka.utils.MockTime;
 import org.apache.kafka.clients.consumer.ConsumerConfig;
+import org.apache.kafka.clients.consumer.KafkaConsumer;
+import org.apache.kafka.clients.consumer.OffsetAndMetadata;
+import org.apache.kafka.common.TopicPartition;
 import org.apache.kafka.common.serialization.Serde;
 import org.apache.kafka.common.serialization.Serdes;
 import org.apache.kafka.common.serialization.StringDeserializer;
 import org.apache.kafka.common.serialization.StringSerializer;
 import org.apache.kafka.streams.KafkaStreams;
 import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.StreamsConfig;
 import org.apache.kafka.streams.errors.TopologyBuilderException;
 import org.apache.kafka.streams.integration.utils.EmbeddedKafkaCluster;
 import org.apache.kafka.streams.integration.utils.IntegrationTestUtils;
@@ -41,7 +45,9 @@
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collections;
+import java.util.HashMap;
 import java.util.List;
+import java.util.Map;
 import java.util.Properties;
 import java.util.regex.Pattern;
 
@@ -53,35 +59,71 @@ public class KStreamsFineGrainedAutoResetIntegrationTest {
 
     private static final int NUM_BROKERS = 1;
     private static final String DEFAULT_OUTPUT_TOPIC = "outputTopic";
+    private static final String OUTPUT_TOPIC_0 = "outputTopic_0";
+    private static final String OUTPUT_TOPIC_1 = "outputTopic_1";
+    private static final String OUTPUT_TOPIC_2 = "outputTopic_2";
 
     @ClassRule
     public static final EmbeddedKafkaCluster CLUSTER = new EmbeddedKafkaCluster(NUM_BROKERS);
     private final MockTime mockTime = CLUSTER.time;
 
-    private static final String TOPIC_1 = "topic-1";
-    private static final String TOPIC_2 = "topic-2";
-    private static final String TOPIC_A = "topic-A";
-    private static final String TOPIC_C = "topic-C";
-    private static final String TOPIC_Y = "topic-Y";
-    private static final String TOPIC_Z = "topic-Z";
+    private static final String TOPIC_1_0 = "topic-1_0";
+    private static final String TOPIC_2_0 = "topic-2_0";
+    private static final String TOPIC_A_0 = "topic-A_0";
+    private static final String TOPIC_C_0 = "topic-C_0";
+    private static final String TOPIC_Y_0 = "topic-Y_0";
+    private static final String TOPIC_Z_0 = "topic-Z_0";
+    private static final String TOPIC_1_1 = "topic-1_1";
+    private static final String TOPIC_2_1 = "topic-2_1";
+    private static final String TOPIC_A_1 = "topic-A_1";
+    private static final String TOPIC_C_1 = "topic-C_1";
+    private static final String TOPIC_Y_1 = "topic-Y_1";
+    private static final String TOPIC_Z_1 = "topic-Z_1";
+    private static final String TOPIC_1_2 = "topic-1_2";
+    private static final String TOPIC_2_2 = "topic-2_2";
+    private static final String TOPIC_A_2 = "topic-A_2";
+    private static final String TOPIC_C_2 = "topic-C_2";
+    private static final String TOPIC_Y_2 = "topic-Y_2";
+    private static final String TOPIC_Z_2 = "topic-Z_2";
     private static final String NOOP = "noop";
     private final Serde<String> stringSerde = Serdes.String();
 
     private static final String STRING_SERDE_CLASSNAME = Serdes.String().getClass().getName();
     private Properties streamsConfiguration;
 
+    private final String topic1TestMessage = "topic-1 test";
+    private final String topic2TestMessage = "topic-2 test";
+    private final String topicATestMessage = "topic-A test";
+    private final String topicCTestMessage = "topic-C test";
+    private final String topicYTestMessage = "topic-Y test";
+    private final String topicZTestMessage = "topic-Z test";
+
 
     @BeforeClass
     public static void startKafkaCluster() throws Exception {
-        CLUSTER.createTopic(TOPIC_1);
-        CLUSTER.createTopic(TOPIC_2);
-        CLUSTER.createTopic(TOPIC_A);
-        CLUSTER.createTopic(TOPIC_C);
-        CLUSTER.createTopic(TOPIC_Y);
-        CLUSTER.createTopic(TOPIC_Z);
+        CLUSTER.createTopic(TOPIC_1_0);
+        CLUSTER.createTopic(TOPIC_2_0);
+        CLUSTER.createTopic(TOPIC_A_0);
+        CLUSTER.createTopic(TOPIC_C_0);
+        CLUSTER.createTopic(TOPIC_Y_0);
+        CLUSTER.createTopic(TOPIC_Z_0);
+        CLUSTER.createTopic(TOPIC_1_1);
+        CLUSTER.createTopic(TOPIC_2_1);
+        CLUSTER.createTopic(TOPIC_A_1);
+        CLUSTER.createTopic(TOPIC_C_1);
+        CLUSTER.createTopic(TOPIC_Y_1);
+        CLUSTER.createTopic(TOPIC_Z_1);
+        CLUSTER.createTopic(TOPIC_1_2);
+        CLUSTER.createTopic(TOPIC_2_2);
+        CLUSTER.createTopic(TOPIC_A_2);
+        CLUSTER.createTopic(TOPIC_C_2);
+        CLUSTER.createTopic(TOPIC_Y_2);
+        CLUSTER.createTopic(TOPIC_Z_2);
         CLUSTER.createTopic(NOOP);
         CLUSTER.createTopic(DEFAULT_OUTPUT_TOPIC);
-
+        CLUSTER.createTopic(OUTPUT_TOPIC_0);
+        CLUSTER.createTopic(OUTPUT_TOPIC_1);
+        CLUSTER.createTopic(OUTPUT_TOPIC_2);
     }
 
     @Before
@@ -102,41 +144,64 @@ public void setUp() throws Exception {
     }
 
     @Test
-    public void shouldOnlyReadRecordsWhereEarliestSpecified() throws  Exception {
+    public void shouldOnlyReadRecordsWhereEarliestSpecifiedWithNoCommittedOffsetsWithGlobalAutoOffsetResetLatest() throws  Exception {
+        streamsConfiguration.put(StreamsConfig.consumerPrefix(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG), "latest");
+
+        final List<String> expectedReceivedValues = Arrays.asList(topic1TestMessage, topic2TestMessage);
+        shouldOnlyReadForEarliest("_0", TOPIC_1_0, TOPIC_2_0, TOPIC_A_0, TOPIC_C_0, TOPIC_Y_0, TOPIC_Z_0, OUTPUT_TOPIC_0, expectedReceivedValues);
+    }
+
+    @Test
+    public void shouldOnlyReadRecordsWhereEarliestSpecifiedWithNoCommittedOffsetsWithDefaultGlobalAutoOffsetResetEarliest() throws  Exception {
+        final List<String> expectedReceivedValues = Arrays.asList(topic1TestMessage, topic2TestMessage, topicYTestMessage, topicZTestMessage);
+        shouldOnlyReadForEarliest("_1", TOPIC_1_1, TOPIC_2_1, TOPIC_A_1, TOPIC_C_1, TOPIC_Y_1, TOPIC_Z_1, OUTPUT_TOPIC_1, expectedReceivedValues);
+    }
+
+    @Test
+    public void shouldOnlyReadRecordsWhereEarliestSpecifiedWithInvalidCommittedOffsets() throws  Exception {
+        commitInvalidOffsets();
+
+        final List<String> expectedReceivedValues = Arrays.asList(topic1TestMessage, topic2TestMessage, topicYTestMessage, topicZTestMessage);
+        shouldOnlyReadForEarliest("_2", TOPIC_1_2, TOPIC_2_2, TOPIC_A_2, TOPIC_C_2, TOPIC_Y_2, TOPIC_Z_2, OUTPUT_TOPIC_2, expectedReceivedValues);
+    }
+
+    private void shouldOnlyReadForEarliest(
+        final String topicSuffix,
+        final String topic1,
+        final String topic2,
+        final String topicA,
+        final String topicC,
+        final String topicY,
+        final String topicZ,
+        final String outputTopic,
+        final List<String> expectedReceivedValues) throws Exception {
+
         final KStreamBuilder builder = new KStreamBuilder();
 
-        final KStream<String, String> pattern1Stream = builder.stream(KStreamBuilder.AutoOffsetReset.EARLIEST, Pattern.compile("topic-\\d"));
-        final KStream<String, String> pattern2Stream = builder.stream(KStreamBuilder.AutoOffsetReset.LATEST, Pattern.compile("topic-[A-D]"));
-        final KStream<String, String> namedTopicsStream = builder.stream(TOPIC_Y, TOPIC_Z);
+        final KStream<String, String> pattern1Stream = builder.stream(KStreamBuilder.AutoOffsetReset.EARLIEST, Pattern.compile("topic-\\d" + topicSuffix));
+        final KStream<String, String> pattern2Stream = builder.stream(KStreamBuilder.AutoOffsetReset.LATEST, Pattern.compile("topic-[A-D]" + topicSuffix));
+        final KStream<String, String> namedTopicsStream = builder.stream(topicY, topicZ);
 
-        pattern1Stream.to(stringSerde, stringSerde, DEFAULT_OUTPUT_TOPIC);
-        pattern2Stream.to(stringSerde, stringSerde, DEFAULT_OUTPUT_TOPIC);
-        namedTopicsStream.to(stringSerde, stringSerde, DEFAULT_OUTPUT_TOPIC);
+        pattern1Stream.to(stringSerde, stringSerde, outputTopic);
+        pattern2Stream.to(stringSerde, stringSerde, outputTopic);
+        namedTopicsStream.to(stringSerde, stringSerde, outputTopic);
 
         final Properties producerConfig = TestUtils.producerConfig(CLUSTER.bootstrapServers(), StringSerializer.class, StringSerializer.class);
 
-        final String topic1TestMessage = "topic-1 test";
-        final String topic2TestMessage = "topic-2 test";
-        final String topicATestMessage = "topic-A test";
-        final String topicCTestMessage = "topic-C test";
-        final String topicYTestMessage = "topic-Y test";
-        final String topicZTestMessage = "topic-Z test";
-
-        IntegrationTestUtils.produceValuesSynchronously(TOPIC_1, Collections.singletonList(topic1TestMessage), producerConfig, mockTime);
-        IntegrationTestUtils.produceValuesSynchronously(TOPIC_2, Collections.singletonList(topic2TestMessage), producerConfig, mockTime);
-        IntegrationTestUtils.produceValuesSynchronously(TOPIC_A, Collections.singletonList(topicATestMessage), producerConfig, mockTime);
-        IntegrationTestUtils.produceValuesSynchronously(TOPIC_C, Collections.singletonList(topicCTestMessage), producerConfig, mockTime);
-        IntegrationTestUtils.produceValuesSynchronously(TOPIC_Y, Collections.singletonList(topicYTestMessage), producerConfig, mockTime);
-        IntegrationTestUtils.produceValuesSynchronously(TOPIC_Z, Collections.singletonList(topicZTestMessage), producerConfig, mockTime);
+        IntegrationTestUtils.produceValuesSynchronously(topic1, Collections.singletonList(topic1TestMessage), producerConfig, mockTime);
+        IntegrationTestUtils.produceValuesSynchronously(topic2, Collections.singletonList(topic2TestMessage), producerConfig, mockTime);
+        IntegrationTestUtils.produceValuesSynchronously(topicA, Collections.singletonList(topicATestMessage), producerConfig, mockTime);
+        IntegrationTestUtils.produceValuesSynchronously(topicC, Collections.singletonList(topicCTestMessage), producerConfig, mockTime);
+        IntegrationTestUtils.produceValuesSynchronously(topicY, Collections.singletonList(topicYTestMessage), producerConfig, mockTime);
+        IntegrationTestUtils.produceValuesSynchronously(topicZ, Collections.singletonList(topicZTestMessage), producerConfig, mockTime);
 
         final Properties consumerConfig = TestUtils.consumerConfig(CLUSTER.bootstrapServers(), StringDeserializer.class, StringDeserializer.class);
 
         final KafkaStreams streams = new KafkaStreams(builder, streamsConfiguration);
         streams.start();
 
-        final List<String> expectedReceivedValues = Arrays.asList(topic1TestMessage, topic2TestMessage, topicYTestMessage, topicZTestMessage);
-        final List<KeyValue<String, String>> receivedKeyValues = IntegrationTestUtils.waitUntilMinKeyValueRecordsReceived(consumerConfig, DEFAULT_OUTPUT_TOPIC, 4);
-        final List<String> actualValues = new ArrayList<>(4);
+        final List<KeyValue<String, String>> receivedKeyValues = IntegrationTestUtils.waitUntilMinKeyValueRecordsReceived(consumerConfig, outputTopic, expectedReceivedValues.size());
+        final List<String> actualValues = new ArrayList<>(expectedReceivedValues.size());
 
         for (final KeyValue<String, String> receivedKeyValue : receivedKeyValues) {
             actualValues.add(receivedKeyValue.value);
@@ -146,35 +211,50 @@ public void shouldOnlyReadRecordsWhereEarliestSpecified() throws  Exception {
         Collections.sort(actualValues);
         Collections.sort(expectedReceivedValues);
         assertThat(actualValues, equalTo(expectedReceivedValues));
-
     }
 
+    private void commitInvalidOffsets() {
+        final KafkaConsumer consumer = new KafkaConsumer(TestUtils.consumerConfig(
+            CLUSTER.bootstrapServers(),
+            streamsConfiguration.getProperty(StreamsConfig.APPLICATION_ID_CONFIG),
+            StringDeserializer.class,
+            StringDeserializer.class));
+
+        final Map<TopicPartition, OffsetAndMetadata> invalidOffsets = new HashMap<>();
+        invalidOffsets.put(new TopicPartition(TOPIC_1_2, 0), new OffsetAndMetadata(5, null));
+        invalidOffsets.put(new TopicPartition(TOPIC_2_2, 0), new OffsetAndMetadata(5, null));
+        invalidOffsets.put(new TopicPartition(TOPIC_A_2, 0), new OffsetAndMetadata(5, null));
+        invalidOffsets.put(new TopicPartition(TOPIC_C_2, 0), new OffsetAndMetadata(5, null));
+        invalidOffsets.put(new TopicPartition(TOPIC_Y_2, 0), new OffsetAndMetadata(5, null));
+        invalidOffsets.put(new TopicPartition(TOPIC_Z_2, 0), new OffsetAndMetadata(5, null));
+
+        consumer.commitSync(invalidOffsets);
+
+        consumer.close();
+    }
 
     @Test(expected = TopologyBuilderException.class)
     public void shouldThrowExceptionOverlappingPattern() throws  Exception {
         final KStreamBuilder builder = new KStreamBuilder();
         //NOTE this would realistically get caught when building topology, the test is for completeness
-        final KStream<String, String> pattern1Stream = builder.stream(KStreamBuilder.AutoOffsetReset.EARLIEST, Pattern.compile("topic-[A-D]"));
-        final KStream<String, String> pattern2Stream = builder.stream(KStreamBuilder.AutoOffsetReset.LATEST, Pattern.compile("topic-[A-D]"));
-        final KStream<String, String> namedTopicsStream = builder.stream(TOPIC_Y, TOPIC_Z);
+        builder.stream(KStreamBuilder.AutoOffsetReset.EARLIEST, Pattern.compile("topic-[A-D]_1"));
+        builder.stream(KStreamBuilder.AutoOffsetReset.LATEST, Pattern.compile("topic-[A-D]_1"));
+        builder.stream(TOPIC_Y_1, TOPIC_Z_1);
 
         builder.earliestResetTopicsPattern();
-
     }
 
     @Test(expected = TopologyBuilderException.class)
     public void shouldThrowExceptionOverlappingTopic() throws  Exception {
         final KStreamBuilder builder = new KStreamBuilder();
         //NOTE this would realistically get caught when building topology, the test is for completeness
-        final KStream<String, String> pattern1Stream = builder.stream(KStreamBuilder.AutoOffsetReset.EARLIEST, Pattern.compile("topic-[A-D]"));
-        final KStream<String, String> pattern2Stream = builder.stream(KStreamBuilder.AutoOffsetReset.LATEST, Pattern.compile("topic-\\d]"));
-        final KStream<String, String> namedTopicsStream = builder.stream(KStreamBuilder.AutoOffsetReset.LATEST, TOPIC_A, TOPIC_Z);
+        builder.stream(KStreamBuilder.AutoOffsetReset.EARLIEST, Pattern.compile("topic-[A-D]_1"));
+        builder.stream(KStreamBuilder.AutoOffsetReset.LATEST, Pattern.compile("topic-\\d_1"));
+        builder.stream(KStreamBuilder.AutoOffsetReset.LATEST, TOPIC_A_1, TOPIC_Z_1);
 
         builder.latestResetTopicsPattern();
-
     }
 
-
     @Test
     public void shouldThrowStreamsExceptionNoResetSpecified() throws Exception {
         Properties props = new Properties();

From 51ae9c2491e90da88391467b8e25f6e98fd660dc Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno@confluent.io>
Date: Thu, 6 Apr 2017 14:51:05 -0700
Subject: [PATCH 159/177] KAFKA-4916: test streams with brokers failing

Author: Eno Thereska <eno@confluent.io>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2793 from enothereska/KAFKA-4916-0.10.2
---
 .../internals/InternalTopicManager.java       |  32 ++-
 .../internals/StreamPartitionAssignor.java    |  12 +-
 .../processor/internals/StreamThread.java     |  65 ++++--
 .../internals/StreamsKafkaClient.java         |  19 +-
 .../internals/InternalTopicManagerTest.java   |  19 +-
 .../kafka/streams/tests/SmokeTestClient.java  |  41 +++-
 .../kafka/streams/tests/SmokeTestDriver.java  |  20 +-
 .../kafka/test/MockInternalTopicManager.java  |   3 +-
 tests/kafkatest/services/streams.py           |   3 +-
 .../tests/streams/streams_bounce_test.py      |   4 +-
 .../streams/streams_broker_bounce_test.py     | 213 ++++++++++++++++++
 .../tests/streams/streams_smoke_test.py       |   4 +-
 12 files changed, 372 insertions(+), 63 deletions(-)
 create mode 100644 tests/kafkatest/tests/streams/streams_broker_bounce_test.py

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java
index 52536e11d4bf2..a0bdb9d9bdea0 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/InternalTopicManager.java
@@ -18,6 +18,7 @@
 package org.apache.kafka.streams.processor.internals;
 
 import org.apache.kafka.common.requests.MetadataResponse;
+import org.apache.kafka.common.utils.Time;
 import org.apache.kafka.streams.errors.StreamsException;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -36,16 +37,18 @@ public class InternalTopicManager {
     public static final String RETENTION_MS = "retention.ms";
     public static final Long WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT = TimeUnit.MILLISECONDS.convert(1, TimeUnit.DAYS);
     private static final int MAX_TOPIC_READY_TRY = 5;
-
+    private final Time time;
     private final long windowChangeLogAdditionalRetention;
 
     private final int replicationFactor;
     private final StreamsKafkaClient streamsKafkaClient;
 
-    public InternalTopicManager(final StreamsKafkaClient streamsKafkaClient, final int replicationFactor, final long windowChangeLogAdditionalRetention) {
+    public InternalTopicManager(final StreamsKafkaClient streamsKafkaClient, final int replicationFactor,
+                                final long windowChangeLogAdditionalRetention, final Time time) {
         this.streamsKafkaClient = streamsKafkaClient;
         this.replicationFactor = replicationFactor;
         this.windowChangeLogAdditionalRetention = windowChangeLogAdditionalRetention;
+        this.time = time;
     }
 
     /**
@@ -61,11 +64,19 @@ public void makeReady(final Map<InternalTopicConfig, Integer> topics) {
                 final MetadataResponse metadata = streamsKafkaClient.fetchMetadata();
                 final Map<String, Integer> existingTopicPartitions = fetchExistingPartitionCountByTopic(metadata);
                 final Map<InternalTopicConfig, Integer> topicsToBeCreated = validateTopicPartitions(topics, existingTopicPartitions);
+                if (metadata.brokers().size() < replicationFactor) {
+                    throw new StreamsException("Found only " + metadata.brokers().size() + " brokers, " +
+                        " but replication factor is " + replicationFactor + "." +
+                        " Decrease replication factor for internal topics via StreamsConfig parameter \"replication.factor\""  +
+                        " or add more brokers to your cluster.");
+                }
                 streamsKafkaClient.createTopics(topicsToBeCreated, replicationFactor, windowChangeLogAdditionalRetention, metadata);
                 return;
             } catch (StreamsException ex) {
                 log.warn("Could not create internal topics: " + ex.getMessage() + " Retry #" + i);
             }
+            // backoff
+            time.sleep(100L);
         }
         throw new StreamsException("Could not create internal topics.");
     }
@@ -74,11 +85,20 @@ public void makeReady(final Map<InternalTopicConfig, Integer> topics) {
      * Get the number of partitions for the given topics
      */
     public Map<String, Integer> getNumPartitions(final Set<String> topics) {
-        final MetadataResponse metadata = streamsKafkaClient.fetchMetadata();
-        final Map<String, Integer> existingTopicPartitions = fetchExistingPartitionCountByTopic(metadata);
-        existingTopicPartitions.keySet().retainAll(topics);
+        for (int i = 0; i < MAX_TOPIC_READY_TRY; i++) {
+            try {
+                final MetadataResponse metadata = streamsKafkaClient.fetchMetadata();
+                final Map<String, Integer> existingTopicPartitions = fetchExistingPartitionCountByTopic(metadata);
+                existingTopicPartitions.keySet().retainAll(topics);
 
-        return existingTopicPartitions;
+                return existingTopicPartitions;
+            } catch (StreamsException ex) {
+                log.warn("Could not get number of partitions: " + ex.getMessage() + " Retry #" + i);
+            }
+            // backoff
+            time.sleep(100L);
+        }
+        throw new StreamsException("Could not get number of partitions.");
     }
 
     public void close() {
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java
index 1ad6dbcbfb4db..a50a81914cf9b 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamPartitionAssignor.java
@@ -25,6 +25,7 @@
 import org.apache.kafka.common.PartitionInfo;
 import org.apache.kafka.common.TopicPartition;
 import org.apache.kafka.common.config.ConfigException;
+import org.apache.kafka.common.utils.Time;
 import org.apache.kafka.common.utils.Utils;
 import org.apache.kafka.streams.StreamsConfig;
 import org.apache.kafka.streams.errors.TaskAssignmentException;
@@ -58,6 +59,7 @@
 public class StreamPartitionAssignor implements PartitionAssignor, Configurable {
 
     private static final Logger log = LoggerFactory.getLogger(StreamPartitionAssignor.class);
+    private Time time = Time.SYSTEM;
 
     private final static int UNKNOWN = -1;
     public final static int NOT_AVAILABLE = -2;
@@ -162,6 +164,14 @@ public int compare(TopicPartition p1, TopicPartition p2) {
     private InternalTopicManager internalTopicManager;
     private CopartitionedTopicsValidator copartitionedTopicsValidator;
 
+    /**
+     * Package-private method to set the time. Used for tests.
+     * @param time Time to be used.
+     */
+    void time(final Time time) {
+        this.time = time;
+    }
+
     /**
      * We need to have the PartitionAssignor and its StreamThread to be mutually accessible
      * since the former needs later's cached metadata while sending subscriptions,
@@ -211,7 +221,7 @@ public void configure(Map<String, ?> configs) {
                 configs.containsKey(StreamsConfig.REPLICATION_FACTOR_CONFIG) ? (Integer) configs.get(StreamsConfig.REPLICATION_FACTOR_CONFIG) : 1,
                 configs.containsKey(StreamsConfig.WINDOW_STORE_CHANGE_LOG_ADDITIONAL_RETENTION_MS_CONFIG) ?
                         (Long) configs.get(StreamsConfig.WINDOW_STORE_CHANGE_LOG_ADDITIONAL_RETENTION_MS_CONFIG)
-                        : WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT);
+                        : WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT, time);
 
         this.copartitionedTopicsValidator = new CopartitionedTopicsValidator(streamThread.getName());
     }
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
index 0bf797f5fc479..a0ee9a898fc72 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamThread.java
@@ -436,17 +436,21 @@ private RuntimeException unAssignChangeLogPartitions() {
 
     @SuppressWarnings("ThrowableNotThrown")
     private void shutdownTasksAndState() {
-        log.debug("{} shutdownTasksAndState: shutting down all active tasks {} and standby tasks {}", logPrefix,
-            activeTasks.keySet(), standbyTasks.keySet());
+        log.debug("{} shutdownTasksAndState: shutting down" +
+                "active tasks {}, standby tasks {}, suspended tasks {}, and suspended standby tasks {}",
+            logPrefix, activeTasks.keySet(), standbyTasks.keySet(),
+            suspendedTasks.keySet(), suspendedStandbyTasks.keySet());
 
         final AtomicReference<RuntimeException> firstException = new AtomicReference<>(null);
         // Close all processors in topology order
-        firstException.compareAndSet(null, closeAllTasks());
+        firstException.compareAndSet(null, closeTasks(activeAndStandbytasks()));
+        firstException.compareAndSet(null, closeTasks(suspendedAndSuspendedStandbytasks()));
         // flush state
         firstException.compareAndSet(null, flushAllState());
         // Close all task state managers. Don't need to set exception as all
         // state would have been flushed above
-        closeAllStateManagers(firstException.get() == null);
+        closeStateManagers(activeAndStandbytasks(), firstException.get() == null);
+        closeStateManagers(suspendedAndSuspendedStandbytasks(), firstException.get() == null);
         // only commit under clean exit
         if (cleanRun && firstException.get() == null) {
             firstException.set(commitOffsets());
@@ -465,7 +469,7 @@ private void suspendTasksAndState()  {
             activeTasks.keySet(), standbyTasks.keySet());
         final AtomicReference<RuntimeException> firstException = new AtomicReference<>(null);
         // Close all topology nodes
-        firstException.compareAndSet(null, closeAllTasksTopologies());
+        firstException.compareAndSet(null, closeActiveAndStandbyTasksTopologies());
         // flush state
         firstException.compareAndSet(null, flushAllState());
         // only commit after all state has been flushed and there hasn't been an exception
@@ -488,21 +492,20 @@ interface AbstractTaskAction {
         void apply(final AbstractTask task);
     }
 
-    private RuntimeException performOnAllTasks(final AbstractTaskAction action,
-                                   final String exceptionMessage) {
+    private RuntimeException performOnTasks(final List<AbstractTask> tasks,
+                                            final AbstractTaskAction action,
+                                            final String exceptionMessage) {
         RuntimeException firstException = null;
-        final List<AbstractTask> allTasks = new ArrayList<AbstractTask>(activeTasks.values());
-        allTasks.addAll(standbyTasks.values());
-        for (final AbstractTask task : allTasks) {
+        for (final AbstractTask task : tasks) {
             try {
                 action.apply(task);
             } catch (RuntimeException t) {
                 log.error("{} Failed while executing {} {} due to {}: ",
-                        StreamThread.this.logPrefix,
-                        task.getClass().getSimpleName(),
-                        task.id(),
-                        exceptionMessage,
-                        t);
+                    StreamThread.this.logPrefix,
+                    task.getClass().getSimpleName(),
+                    task.id(),
+                    exceptionMessage,
+                    t);
                 if (firstException == null) {
                     firstException = t;
                 }
@@ -511,8 +514,20 @@ private RuntimeException performOnAllTasks(final AbstractTaskAction action,
         return firstException;
     }
 
-    private Throwable closeAllStateManagers(final boolean writeCheckpoint) {
-        return performOnAllTasks(new AbstractTaskAction() {
+    private List<AbstractTask> activeAndStandbytasks() {
+        final List<AbstractTask> tasks = new ArrayList<AbstractTask>(activeTasks.values());
+        tasks.addAll(standbyTasks.values());
+        return tasks;
+    }
+
+    private List<AbstractTask> suspendedAndSuspendedStandbytasks() {
+        final List<AbstractTask> tasks = new ArrayList<AbstractTask>(suspendedTasks.values());
+        tasks.addAll(suspendedStandbyTasks.values());
+        return tasks;
+    }
+
+    private Throwable closeStateManagers(final List<AbstractTask> tasks, final boolean writeCheckpoint) {
+        return performOnTasks(tasks, new AbstractTaskAction() {
             @Override
             public void apply(final AbstractTask task) {
                 log.info("{} Closing the state manager of task {}", StreamThread.this.logPrefix, task.id());
@@ -523,7 +538,7 @@ public void apply(final AbstractTask task) {
 
     private RuntimeException commitOffsets() {
         // Exceptions should not prevent this call from going through all shutdown steps
-        return performOnAllTasks(new AbstractTaskAction() {
+        return performOnTasks(activeAndStandbytasks(), new AbstractTaskAction() {
             @Override
             public void apply(final AbstractTask task) {
                 log.info("{} Committing consumer offsets of task {}", StreamThread.this.logPrefix, task.id());
@@ -533,7 +548,7 @@ public void apply(final AbstractTask task) {
     }
 
     private RuntimeException flushAllState() {
-        return performOnAllTasks(new AbstractTaskAction() {
+        return performOnTasks(activeAndStandbytasks(), new AbstractTaskAction() {
             @Override
             public void apply(final AbstractTask task) {
                 log.info("{} Flushing state stores of task {}", StreamThread.this.logPrefix, task.id());
@@ -1053,22 +1068,22 @@ private void removeStandbyTasks() {
         standbyRecords.clear();
     }
 
-    private RuntimeException closeAllTasks() {
-        return performOnAllTasks(new AbstractTaskAction() {
+    private RuntimeException closeTasks(final List<AbstractTask> tasks) {
+        return performOnTasks(tasks, new AbstractTaskAction() {
             @Override
             public void apply(final AbstractTask task) {
-                log.info("{} Closing a task {}", StreamThread.this.logPrefix, task.id());
+                log.info("{} Closing task {}", StreamThread.this.logPrefix, task.id());
                 task.close();
                 streamsMetrics.tasksClosedSensor.record();
             }
         }, "close");
     }
 
-    private RuntimeException closeAllTasksTopologies() {
-        return performOnAllTasks(new AbstractTaskAction() {
+    private RuntimeException closeActiveAndStandbyTasksTopologies() {
+        return performOnTasks(activeAndStandbytasks(), new AbstractTaskAction() {
             @Override
             public void apply(final AbstractTask task) {
-                log.info("{} Closing a task's topology {}", StreamThread.this.logPrefix, task.id());
+                log.info("{} Closing task's topology {}", StreamThread.this.logPrefix, task.id());
                 task.closeTopology();
                 streamsMetrics.tasksClosedSensor.record();
             }
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
index 60dd4164e6574..bb75759d9d1cb 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamsKafkaClient.java
@@ -198,7 +198,11 @@ private String ensureOneNodeIsReady(final List<Node> nodes) {
                     break;
                 }
             }
-            kafkaClient.poll(streamsConfig.getLong(StreamsConfig.POLL_MS_CONFIG), Time.SYSTEM.milliseconds());
+            try {
+                kafkaClient.poll(streamsConfig.getLong(StreamsConfig.POLL_MS_CONFIG), Time.SYSTEM.milliseconds());
+            } catch (final Exception e) {
+                throw new StreamsException("Could not poll.", e);
+            }
         }
         if (brokerId == null) {
             throw new StreamsException("Could not find any available broker.");
@@ -230,11 +234,20 @@ private String getAnyReadyBrokerId() {
     }
 
     private ClientResponse sendRequest(final ClientRequest clientRequest) {
-        kafkaClient.send(clientRequest, Time.SYSTEM.milliseconds());
+        try {
+            kafkaClient.send(clientRequest, Time.SYSTEM.milliseconds());
+        } catch (final Exception e) {
+            throw new StreamsException("Could not send request.", e);
+        }
         final long responseTimeout = Time.SYSTEM.milliseconds() + streamsConfig.getInt(StreamsConfig.REQUEST_TIMEOUT_MS_CONFIG);
         // Poll for the response.
         while (Time.SYSTEM.milliseconds() < responseTimeout) {
-            List<ClientResponse> responseList = kafkaClient.poll(streamsConfig.getLong(StreamsConfig.POLL_MS_CONFIG), Time.SYSTEM.milliseconds());
+            final List<ClientResponse> responseList;
+            try {
+                responseList = kafkaClient.poll(streamsConfig.getLong(StreamsConfig.POLL_MS_CONFIG), Time.SYSTEM.milliseconds());
+            } catch (final IllegalStateException e) {
+                throw new StreamsException("Could not poll.", e);
+            }
             if (!responseList.isEmpty()) {
                 if (responseList.size() > 1) {
                     throw new StreamsException("Sent one request but received multiple or no responses.");
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java
index 69b3c46d162bf..2169496b95607 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/InternalTopicManagerTest.java
@@ -20,6 +20,8 @@
 import org.apache.kafka.common.Node;
 import org.apache.kafka.common.protocol.Errors;
 import org.apache.kafka.common.requests.MetadataResponse;
+import org.apache.kafka.common.utils.MockTime;
+import org.apache.kafka.common.utils.Time;
 import org.apache.kafka.streams.StreamsConfig;
 import org.apache.kafka.streams.errors.StreamsException;
 import org.apache.kafka.test.MockTimestampExtractor;
@@ -41,7 +43,7 @@ public class InternalTopicManagerTest {
     private final String topic = "test_topic";
     private final String userEndPoint = "localhost:2171";
     private MockStreamKafkaClient streamsKafkaClient;
-
+    private final Time time = new MockTime();
     @Before
     public void init() {
         final StreamsConfig config = new StreamsConfig(configProps());
@@ -55,19 +57,22 @@ public void shutdown() throws IOException {
 
     @Test
     public void shouldReturnCorrectPartitionCounts() throws Exception {
-        InternalTopicManager internalTopicManager = new InternalTopicManager(streamsKafkaClient, 1, WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT);
+        InternalTopicManager internalTopicManager = new InternalTopicManager(streamsKafkaClient, 1,
+            WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT, time);
         Assert.assertEquals(Collections.singletonMap(topic, 1), internalTopicManager.getNumPartitions(Collections.singleton(topic)));
     }
 
     @Test
     public void shouldCreateRequiredTopics() throws Exception {
-        InternalTopicManager internalTopicManager = new InternalTopicManager(streamsKafkaClient, 1, WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT);
+        InternalTopicManager internalTopicManager = new InternalTopicManager(streamsKafkaClient, 1,
+            WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT, time);
         internalTopicManager.makeReady(Collections.singletonMap(new InternalTopicConfig(topic, Collections.singleton(InternalTopicConfig.CleanupPolicy.compact), null), 1));
     }
 
     @Test
     public void shouldNotCreateTopicIfExistsWithDifferentPartitions() throws Exception {
-        InternalTopicManager internalTopicManager = new InternalTopicManager(streamsKafkaClient, 1, WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT);
+        InternalTopicManager internalTopicManager = new InternalTopicManager(streamsKafkaClient, 1,
+            WINDOW_CHANGE_LOG_ADDITIONAL_RETENTION_DEFAULT, time);
         boolean exceptionWasThrown = false;
         try {
             internalTopicManager.makeReady(Collections.singletonMap(new InternalTopicConfig(topic, Collections.singleton(InternalTopicConfig.CleanupPolicy.compact), null), 2));
@@ -105,9 +110,9 @@ public MetadataResponse fetchMetadata() {
             Node node = new Node(1, "host1", 1001);
             MetadataResponse.PartitionMetadata partitionMetadata = new MetadataResponse.PartitionMetadata(Errors.NONE, 1, node, new ArrayList<Node>(), new ArrayList<Node>());
             MetadataResponse.TopicMetadata topicMetadata = new MetadataResponse.TopicMetadata(Errors.NONE, topic, true, Collections.singletonList(partitionMetadata));
-            MetadataResponse response = new MetadataResponse(Collections.<Node>emptyList(), null, MetadataResponse.NO_CONTROLLER_ID,
-                Collections.singletonList(topicMetadata), 0);
+            MetadataResponse response = new MetadataResponse(Collections.<Node>singletonList(node), null, MetadataResponse.NO_CONTROLLER_ID,
+                Collections.singletonList(topicMetadata));
             return response;
         }
     }
-}
\ No newline at end of file
+}
diff --git a/streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestClient.java b/streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestClient.java
index 35f1883b484d6..d1921261bf78b 100644
--- a/streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestClient.java
+++ b/streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestClient.java
@@ -18,6 +18,7 @@
 package org.apache.kafka.streams.tests;
 
 import org.apache.kafka.clients.consumer.ConsumerConfig;
+import org.apache.kafka.clients.producer.ProducerConfig;
 import org.apache.kafka.streams.KafkaStreams;
 import org.apache.kafka.streams.StreamsConfig;
 import org.apache.kafka.streams.kstream.Aggregator;
@@ -40,6 +41,7 @@ public class SmokeTestClient extends SmokeTestUtil {
     private final File stateDir;
     private KafkaStreams streams;
     private Thread thread;
+    private boolean uncaughtException = false;
 
     public SmokeTestClient(File stateDir, String kafka) {
         super();
@@ -52,10 +54,19 @@ public void start() {
         streams.setUncaughtExceptionHandler(new Thread.UncaughtExceptionHandler() {
             @Override
             public void uncaughtException(Thread t, Throwable e) {
+                System.out.println("SMOKE-TEST-CLIENT-EXCEPTION");
+                uncaughtException = true;
                 e.printStackTrace();
             }
         });
 
+        Runtime.getRuntime().addShutdownHook(new Thread(new Runnable() {
+            @Override
+            public void run() {
+                close();
+            }
+        }));
+
         thread = new Thread() {
             public void run() {
                 streams.start();
@@ -65,32 +76,38 @@ public void run() {
     }
 
     public void close() {
-        streams.close();
+        streams.close(5, TimeUnit.SECONDS);
+        // do not remove these printouts since they are needed for health scripts
+        if (!uncaughtException) {
+            System.out.println("SMOKE-TEST-CLIENT-CLOSED");
+        }
         try {
             thread.join();
         } catch (Exception ex) {
+            // do not remove these printouts since they are needed for health scripts
+            System.out.println("SMOKE-TEST-CLIENT-EXCEPTION");
             // ignore
         }
     }
 
     private static KafkaStreams createKafkaStreams(File stateDir, String kafka) {
-        Properties props = new Properties();
+        final Properties props = new Properties();
         props.put(StreamsConfig.APPLICATION_ID_CONFIG, "SmokeTest");
         props.put(StreamsConfig.STATE_DIR_CONFIG, stateDir.toString());
         props.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, kafka);
         props.put(StreamsConfig.NUM_STREAM_THREADS_CONFIG, 3);
         props.put(StreamsConfig.NUM_STANDBY_REPLICAS_CONFIG, 2);
         props.put(StreamsConfig.BUFFERED_RECORDS_PER_PARTITION_CONFIG, 100);
-        props.put(StreamsConfig.REPLICATION_FACTOR_CONFIG, 2);
         props.put(StreamsConfig.COMMIT_INTERVAL_MS_CONFIG, 1000);
+        props.put(StreamsConfig.REPLICATION_FACTOR_CONFIG, 3);
         props.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
+        props.put(ProducerConfig.RETRIES_CONFIG, Integer.MAX_VALUE);
+        props.put(ProducerConfig.ACKS_CONFIG, "all");
 
-        KStreamBuilder builder = new KStreamBuilder();
 
+        KStreamBuilder builder = new KStreamBuilder();
         KStream<String, Integer> source = builder.stream(stringSerde, intSerde, "data");
-
         source.to(stringSerde, intSerde, "echo");
-
         KStream<String, Integer> data = source.filter(new Predicate<String, Integer>() {
             @Override
             public boolean test(String key, Integer value) {
@@ -211,7 +228,17 @@ public Double apply(Long value1, Long value2) {
                     "cntByCnt"
         ).to(stringSerde, longSerde, "tagg");
 
-        return new KafkaStreams(builder, props);
+        final KafkaStreams streamsClient = new KafkaStreams(builder, props);
+        streamsClient.setUncaughtExceptionHandler(new Thread.UncaughtExceptionHandler() {
+            @Override
+            public void uncaughtException(Thread t, Throwable e) {
+                System.out.println("FATAL: An unexpected exception is encountered on thread " + t + ": " + e);
+                
+                streamsClient.close(30, TimeUnit.SECONDS);
+            }
+        });
+
+        return streamsClient;
     }
 
 }
diff --git a/streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestDriver.java b/streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestDriver.java
index 6f29e00895f42..c2cfd847ccd8b 100644
--- a/streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestDriver.java
+++ b/streams/src/test/java/org/apache/kafka/streams/tests/SmokeTestDriver.java
@@ -131,13 +131,17 @@ public void run() {
     }
 
     public static Map<String, Set<Integer>> generate(String kafka, final int numKeys, final int maxRecordsPerKey) throws Exception {
-        Properties props = new Properties();
-        props.put(ProducerConfig.CLIENT_ID_CONFIG, "SmokeTest");
-        props.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, kafka);
-        props.put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, ByteArraySerializer.class);
-        props.put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, ByteArraySerializer.class);
-
-        KafkaProducer<byte[], byte[]> producer = new KafkaProducer<>(props);
+        final Properties producerProps = new Properties();
+        producerProps.put(ProducerConfig.CLIENT_ID_CONFIG, "SmokeTest");
+        producerProps.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, kafka);
+        producerProps.put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, ByteArraySerializer.class);
+        producerProps.put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, ByteArraySerializer.class);
+        // the next 4 config values make sure that all records are produced with no loss and
+        // no duplicates
+        producerProps.put(ProducerConfig.RETRIES_CONFIG, Integer.MAX_VALUE);
+        producerProps.put(ProducerConfig.ACKS_CONFIG, "all");
+
+        KafkaProducer<byte[], byte[]> producer = new KafkaProducer<>(producerProps);
 
         int numRecordsProduced = 0;
 
@@ -232,7 +236,7 @@ public static void verify(String kafka, Map<String, Set<Integer>> allData, int m
         }
         int retry = 0;
         final long start = System.currentTimeMillis();
-        while (System.currentTimeMillis() - start < TimeUnit.MINUTES.toMillis(3)) {
+        while (System.currentTimeMillis() - start < TimeUnit.MINUTES.toMillis(6)) {
             ConsumerRecords<byte[], byte[]> records = consumer.poll(500);
             if (records.isEmpty() && recordsProcessed >= recordsGenerated) {
                 if (verifyMin(min, allData, false)
diff --git a/streams/src/test/java/org/apache/kafka/test/MockInternalTopicManager.java b/streams/src/test/java/org/apache/kafka/test/MockInternalTopicManager.java
index 28aca34b23bbe..0813f3992e69e 100644
--- a/streams/src/test/java/org/apache/kafka/test/MockInternalTopicManager.java
+++ b/streams/src/test/java/org/apache/kafka/test/MockInternalTopicManager.java
@@ -19,6 +19,7 @@
 
 import org.apache.kafka.clients.consumer.MockConsumer;
 import org.apache.kafka.common.PartitionInfo;
+import org.apache.kafka.common.utils.MockTime;
 import org.apache.kafka.streams.StreamsConfig;
 import org.apache.kafka.streams.processor.internals.InternalTopicConfig;
 import org.apache.kafka.streams.processor.internals.InternalTopicManager;
@@ -36,7 +37,7 @@ public class MockInternalTopicManager extends InternalTopicManager {
     private MockConsumer<byte[], byte[]> restoreConsumer;
 
     public MockInternalTopicManager(StreamsConfig streamsConfig, MockConsumer<byte[], byte[]> restoreConsumer) {
-        super(new StreamsKafkaClient(streamsConfig), 0, 0);
+        super(new StreamsKafkaClient(streamsConfig), 0, 0, new MockTime());
 
         this.restoreConsumer = restoreConsumer;
     }
diff --git a/tests/kafkatest/services/streams.py b/tests/kafkatest/services/streams.py
index a0fa412213b78..8bc4d9ed9099c 100644
--- a/tests/kafkatest/services/streams.py
+++ b/tests/kafkatest/services/streams.py
@@ -50,6 +50,7 @@ def __init__(self, test_context, kafka, streams_class_name, user_test_args):
         self.kafka = kafka
         self.args = {'streams_class_name': streams_class_name,
                      'user_test_args': user_test_args}
+        self.log_level = "DEBUG"
 
     @property
     def node(self):
@@ -94,7 +95,7 @@ def abortThenRestart(self):
             self.logger.info("Restarting Kafka Streams on " + str(node.account))
             self.start_node(node)
 
-    def wait(self, timeout_sec=360):
+    def wait(self, timeout_sec=1440):
         for node in self.nodes:
             self.wait_node(node, timeout_sec)
 
diff --git a/tests/kafkatest/tests/streams/streams_bounce_test.py b/tests/kafkatest/tests/streams/streams_bounce_test.py
index 169bbc1aa02dc..7ac79396381b0 100644
--- a/tests/kafkatest/tests/streams/streams_bounce_test.py
+++ b/tests/kafkatest/tests/streams/streams_bounce_test.py
@@ -26,7 +26,7 @@ class StreamsBounceTest(KafkaTest):
     """
 
     def __init__(self, test_context):
-        super(StreamsBounceTest, self).__init__(test_context, num_zk=1, num_brokers=2, topics={
+        super(StreamsBounceTest, self).__init__(test_context, num_zk=1, num_brokers=3, topics={
             'echo' : { 'partitions': 5, 'replication-factor': 2 },
             'data' : { 'partitions': 5, 'replication-factor': 2 },
             'min' : { 'partitions': 5, 'replication-factor': 2 },
@@ -42,7 +42,7 @@ def __init__(self, test_context):
         self.driver = StreamsSmokeTestDriverService(test_context, self.kafka)
         self.processor1 = StreamsSmokeTestJobRunnerService(test_context, self.kafka)
 
-    @cluster(num_nodes=5)
+    @cluster(num_nodes=6)
     def test_bounce(self):
         """
         Start a smoke test client, then abort (kill -9) and restart it a few times.
diff --git a/tests/kafkatest/tests/streams/streams_broker_bounce_test.py b/tests/kafkatest/tests/streams/streams_broker_bounce_test.py
new file mode 100644
index 0000000000000..86c19f9017cd5
--- /dev/null
+++ b/tests/kafkatest/tests/streams/streams_broker_bounce_test.py
@@ -0,0 +1,213 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from ducktape.tests.test import Test
+from ducktape.mark.resource import cluster
+from ducktape.mark import matrix
+from ducktape.mark import parametrize, ignore
+from kafkatest.services.kafka import KafkaService
+from kafkatest.tests.kafka_test import KafkaTest
+from kafkatest.services.zookeeper import ZookeeperService
+from kafkatest.services.streams import StreamsSmokeTestDriverService, StreamsSmokeTestJobRunnerService
+import time
+import signal
+from random import randint
+
+def broker_node(test, topic, broker_type):
+    """ Discover node of requested type. For leader type, discovers leader for our topic and partition 0
+    """
+    if broker_type == "leader":
+        node = test.kafka.leader(topic, partition=0)
+    elif broker_type == "controller":
+        node = test.kafka.controller()
+    else:
+        raise Exception("Unexpected broker type %s." % (broker_type))
+
+    return node
+
+def signal_node(test, node, sig):
+    test.kafka.signal_node(node, sig)
+    
+def clean_shutdown(test, topic, broker_type):
+    """Discover broker node of requested type and shut it down cleanly.
+    """
+    node = broker_node(test, topic, broker_type)
+    signal_node(test, node, signal.SIGTERM)
+
+def hard_shutdown(test, topic, broker_type):
+    """Discover broker node of requested type and shut it down with a hard kill."""
+    node = broker_node(test, topic, broker_type)
+    signal_node(test, node, signal.SIGKILL)
+
+    
+failures = {
+    "clean_shutdown": clean_shutdown,
+    "hard_shutdown": hard_shutdown
+}
+        
+class StreamsBrokerBounceTest(Test):
+    """
+    Simple test of Kafka Streams with brokers failing
+    """
+
+    def __init__(self, test_context):
+        super(StreamsBrokerBounceTest, self).__init__(test_context)
+        self.replication = 3
+        self.partitions = 3
+        self.topics = {
+            'echo' : { 'partitions': self.partitions, 'replication-factor': self.replication,
+                       'configs': {"min.insync.replicas": 2}},
+            'data' : { 'partitions': self.partitions, 'replication-factor': self.replication,
+                       'configs': {"min.insync.replicas": 2} },
+            'min' : { 'partitions': self.partitions, 'replication-factor': self.replication,
+                      'configs': {"min.insync.replicas": 2} },
+            'max' : { 'partitions': self.partitions, 'replication-factor': self.replication,
+                      'configs': {"min.insync.replicas": 2} },
+            'sum' : { 'partitions': self.partitions, 'replication-factor': self.replication,
+                      'configs': {"min.insync.replicas": 2} },
+            'dif' : { 'partitions': self.partitions, 'replication-factor': self.replication,
+                      'configs': {"min.insync.replicas": 2} },
+            'cnt' : { 'partitions': self.partitions, 'replication-factor': self.replication,
+                      'configs': {"min.insync.replicas": 2} },
+            'avg' : { 'partitions': self.partitions, 'replication-factor': self.replication,
+                      'configs': {"min.insync.replicas": 2} },
+            'wcnt' : { 'partitions': self.partitions, 'replication-factor': self.replication,
+                       'configs': {"min.insync.replicas": 2} },
+            'tagg' : { 'partitions': self.partitions, 'replication-factor': self.replication,
+                       'configs': {"min.insync.replicas": 2} }
+        }
+
+    def fail_broker_type(self, failure_mode, broker_type):
+        # Pick a random topic and bounce it's leader
+        topic_index = randint(0, len(self.topics.keys()) - 1)
+        topic = self.topics.keys()[topic_index]
+        failures[failure_mode](self, topic, broker_type)
+
+    def fail_many_brokers(self, failure_mode, num_failures):
+        sig = signal.SIGTERM
+        if (failure_mode == "clean_shutdown"):
+            sig = signal.SIGTERM
+        else:
+            sig = signal.SIGKILL
+            
+        for num in range(0, num_failures - 1):
+            signal_node(self, self.kafka.nodes[num], sig)
+
+        
+    def setup_system(self):
+         # Setup phase
+        self.zk = ZookeeperService(self.test_context, num_nodes=1)
+        self.zk.start()
+        
+        self.kafka = KafkaService(self.test_context, num_nodes=self.replication,
+                                  zk=self.zk, topics=self.topics)
+        self.kafka.start()
+        # Start test harness
+        self.driver = StreamsSmokeTestDriverService(self.test_context, self.kafka)
+        self.processor1 = StreamsSmokeTestJobRunnerService(self.test_context, self.kafka)
+
+        
+        self.driver.start()
+        self.processor1.start()
+
+    def collect_results(self, sleep_time_secs):
+        data = {}
+        # End test
+        self.driver.wait()
+        self.driver.stop()
+
+        self.processor1.stop()
+
+        node = self.driver.node
+        
+        # Success is declared if streams does not crash when sleep time > 0
+        # It should give an exception when sleep time is 0 since we kill the brokers immediately
+        # and the topic manager cannot create internal topics with the desired replication factor
+        if (sleep_time_secs == 0):
+            output_streams = self.processor1.node.account.ssh_capture("grep SMOKE-TEST-CLIENT-EXCEPTION %s" % self.processor1.STDOUT_FILE, allow_fail=False)
+        else:
+            output_streams = self.processor1.node.account.ssh_capture("grep SMOKE-TEST-CLIENT-CLOSED %s" % self.processor1.STDOUT_FILE, allow_fail=False)
+            
+        for line in output_streams:
+            data["Client closed"] = line
+
+        # Currently it is hard to guarantee anything about Kafka since we don't have exactly once.
+        # With exactly once in place, success will be defined as ALL-RECORDS-DELIEVERD and SUCCESS
+        output = node.account.ssh_capture("grep -E 'ALL-RECORDS-DELIVERED|PROCESSED-MORE-THAN-GENERATED|PROCESSED-LESS-THAN-GENERATED' %s" % self.driver.STDOUT_FILE, allow_fail=False)
+        for line in output:
+            data["Records Delivered"] = line
+        output = node.account.ssh_capture("grep -E 'SUCCESS|FAILURE' %s" % self.driver.STDOUT_FILE, allow_fail=False)
+        for line in output:
+            data["Logic Success/Failure"] = line
+            
+        
+        return data
+
+    @cluster(num_nodes=7)
+    @matrix(failure_mode=["clean_shutdown", "hard_shutdown"],
+            broker_type=["leader", "controller"],
+            sleep_time_secs=[120])
+    def test_broker_type_bounce(self, failure_mode, broker_type, sleep_time_secs):
+        """
+        Start a smoke test client, then kill one particular broker and ensure data is still received
+        Record if records are delivered. 
+        """
+        self.setup_system() 
+
+        # Sleep to allow test to run for a bit
+        time.sleep(sleep_time_secs)
+
+        # Fail brokers
+        self.fail_broker_type(failure_mode, broker_type);
+
+        return self.collect_results(sleep_time_secs)
+
+    @cluster(num_nodes=7)
+    @matrix(failure_mode=["clean_shutdown"],
+            broker_type=["controller"],
+            sleep_time_secs=[0])
+    def test_broker_type_bounce_at_start(self, failure_mode, broker_type, sleep_time_secs):
+        """
+        Start a smoke test client, then kill one particular broker immediately before streams stats
+        Streams should throw an exception since it cannot create topics with the desired
+        replication factor of 3
+        """
+        self.setup_system() 
+
+        # Sleep to allow test to run for a bit
+        time.sleep(sleep_time_secs)
+
+        # Fail brokers
+        self.fail_broker_type(failure_mode, broker_type);
+
+        return self.collect_results(sleep_time_secs)
+    
+    @cluster(num_nodes=7)
+    @matrix(failure_mode=["clean_shutdown", "hard_shutdown"],
+            num_failures=[2])
+    def test_many_brokers_bounce(self, failure_mode, num_failures):
+        """
+        Start a smoke test client, then kill a few brokers and ensure data is still received
+        Record if records are delivered
+        """
+        self.setup_system() 
+
+        # Sleep to allow test to run for a bit
+        time.sleep(120)
+
+        # Fail brokers
+        self.fail_many_brokers(failure_mode, num_failures);
+
+        return self.collect_results(120)
diff --git a/tests/kafkatest/tests/streams/streams_smoke_test.py b/tests/kafkatest/tests/streams/streams_smoke_test.py
index a824d92657323..496c495827551 100644
--- a/tests/kafkatest/tests/streams/streams_smoke_test.py
+++ b/tests/kafkatest/tests/streams/streams_smoke_test.py
@@ -27,7 +27,7 @@ class StreamsSmokeTest(KafkaTest):
     """
 
     def __init__(self, test_context):
-        super(StreamsSmokeTest, self).__init__(test_context, num_zk=1, num_brokers=2, topics={
+        super(StreamsSmokeTest, self).__init__(test_context, num_zk=1, num_brokers=3, topics={
             'echo' : { 'partitions': 5, 'replication-factor': 1 },
             'data' : { 'partitions': 5, 'replication-factor': 1 },
             'min' : { 'partitions': 5, 'replication-factor': 1 },
@@ -46,7 +46,7 @@ def __init__(self, test_context):
         self.processor3 = StreamsSmokeTestJobRunnerService(test_context, self.kafka)
         self.processor4 = StreamsSmokeTestJobRunnerService(test_context, self.kafka)
 
-    @cluster(num_nodes=8)
+    @cluster(num_nodes=9)
     def test_streams(self):
         """
         Start a few smoke test clients, then repeat start a new one, stop (cleanly) running one a few times.

From 47f9e8fe2cf7911e24d87ee6527362b2cc9ec306 Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno@confluent.io>
Date: Fri, 7 Apr 2017 13:39:32 +0100
Subject: [PATCH 160/177] KAFKA-5040; Increase number of retries from the
 default of 0

Author: Eno Thereska <eno@confluent.io>

Reviewers: Damian Guy <damian.guy@gmail.com>, Matthias J. Sax <matthias@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2819 from enothereska/minor-increase-retries

(cherry picked from commit e19bf3f24466cd8dcd6c11f2d7cbc5796600fb88)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../src/main/java/org/apache/kafka/streams/StreamsConfig.java    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java b/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java
index 3d22742a781a8..bc73f24af1c49 100644
--- a/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java
+++ b/streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java
@@ -393,6 +393,7 @@ public class StreamsConfig extends AbstractConfig {
     {
         final Map<String, Object> tempProducerDefaultOverrides = new HashMap<>();
         tempProducerDefaultOverrides.put(ProducerConfig.LINGER_MS_CONFIG, "100");
+        tempProducerDefaultOverrides.put(ProducerConfig.RETRIES_CONFIG, 10);
 
         PRODUCER_DEFAULT_OVERRIDES = Collections.unmodifiableMap(tempProducerDefaultOverrides);
     }

From 08a5b6421c69dec46487ff0136020dd0030fe34a Mon Sep 17 00:00:00 2001
From: Rajini Sivaram <rajinisivaram@googlemail.com>
Date: Fri, 7 Apr 2017 11:07:06 -0700
Subject: [PATCH 161/177] KAFKA-4943: Make /config/users with SCRAM credentials
 not world-readable

Author: Rajini Sivaram <rajinisivaram@googlemail.com>

Reviewers: Ismael Juma, Jun Rao

Closes #2733 from rajinisivaram/KAFKA-4943

(cherry picked from commit 67fc2a91a6e80bfda30537c7c95cd9ce396d4e7d)
Signed-off-by: Gwen Shapira <cshapi@gmail.com>
---
 .../kafka/admin/ZkSecurityMigrator.scala      |  4 +-
 core/src/main/scala/kafka/utils/ZkUtils.scala | 93 +++++++++++++------
 .../security/auth/ZkAuthorizationTest.scala   | 28 +++---
 3 files changed, 80 insertions(+), 45 deletions(-)

diff --git a/core/src/main/scala/kafka/admin/ZkSecurityMigrator.scala b/core/src/main/scala/kafka/admin/ZkSecurityMigrator.scala
index eb5c14211fc2d..172233b6c4999 100644
--- a/core/src/main/scala/kafka/admin/ZkSecurityMigrator.scala
+++ b/core/src/main/scala/kafka/admin/ZkSecurityMigrator.scala
@@ -127,7 +127,7 @@ class ZkSecurityMigrator(zkUtils: ZkUtils) extends Logging {
 
   private def setAcl(path: String, setPromise: Promise[String]) = {
     info("Setting ACL for path %s".format(path))
-    zkUtils.zkConnection.getZookeeper.setACL(path, ZkUtils.DefaultAcls(zkUtils.isSecure), -1, SetACLCallback, setPromise)
+    zkUtils.zkConnection.getZookeeper.setACL(path, zkUtils.defaultAcls(path), -1, SetACLCallback, setPromise)
   }
 
   private def getChildren(path: String, childrenPromise: Promise[String]) = {
@@ -201,7 +201,7 @@ class ZkSecurityMigrator(zkUtils: ZkUtils) extends Logging {
           info("Successfully set ACLs for %s".format(path))
           promise success "done"
         case Code.CONNECTIONLOSS =>
-            zkHandle.setACL(path, ZkUtils.DefaultAcls(zkUtils.isSecure), -1, SetACLCallback, ctx)
+            zkHandle.setACL(path, zkUtils.defaultAcls(path), -1, SetACLCallback, ctx)
         case Code.NONODE =>
           warn("Znode is gone, it could be have been legitimately deleted: %s".format(path))
           promise success "done"
diff --git a/core/src/main/scala/kafka/utils/ZkUtils.scala b/core/src/main/scala/kafka/utils/ZkUtils.scala
index e67e264b9bd69..1d77cd7ae3891 100644
--- a/core/src/main/scala/kafka/utils/ZkUtils.scala
+++ b/core/src/main/scala/kafka/utils/ZkUtils.scala
@@ -17,6 +17,7 @@
 
 package kafka.utils
 
+import java.util.Collections
 import java.util.concurrent.CountDownLatch
 
 import kafka.admin._
@@ -65,6 +66,7 @@ object ZkUtils {
   val PreferredReplicaLeaderElectionPath = s"$AdminPath/preferred_replica_election"
   val BrokerSequenceIdPath = s"$BrokersPath/seqid"
   val ConfigChangesPath = s"$ConfigPath/changes"
+  val ConfigUsersPath = s"$ConfigPath/users"
 
 
   // Important: it is necessary to add any new top level Zookeeper path to the Seq
@@ -78,6 +80,10 @@ object ZkUtils {
                               KafkaAclPath,
                               KafkaAclChangesPath)
 
+  // Important: it is necessary to add any new top level Zookeeper path that contains
+  //            sensitive information that should not be world readable to the Seq
+  val SensitiveZkRootPaths = Seq(ConfigUsersPath)
+
   def apply(zkUrl: String, sessionTimeout: Int, connectionTimeout: Int, isZkSecurityEnabled: Boolean): ZkUtils = {
     val (zkClient, zkConnection) = createZkClientAndConnection(zkUrl, sessionTimeout, connectionTimeout)
     new ZkUtils(zkClient, zkConnection, isZkSecurityEnabled)
@@ -101,13 +107,23 @@ object ZkUtils {
     (zkClient, zkConnection)
   }
 
-  def DefaultAcls(isSecure: Boolean): java.util.List[ACL] = if (isSecure) {
-    val list = new java.util.ArrayList[ACL]
-    list.addAll(ZooDefs.Ids.CREATOR_ALL_ACL)
-    list.addAll(ZooDefs.Ids.READ_ACL_UNSAFE)
-    list
-  } else {
-    ZooDefs.Ids.OPEN_ACL_UNSAFE
+  def sensitivePath(path: String): Boolean = {
+    path != null && !SensitiveZkRootPaths.forall(!path.startsWith(_))
+  }
+
+  @deprecated("This is deprecated, use defaultAcls(isSecure, path) which doesn't make sensitive data world readable", since = "0.10.2.1")
+  def DefaultAcls(isSecure: Boolean): java.util.List[ACL] = defaultAcls(isSecure, "")
+
+  def defaultAcls(isSecure: Boolean, path: String): java.util.List[ACL] = {
+    if (isSecure) {
+      val list = new java.util.ArrayList[ACL]
+      list.addAll(ZooDefs.Ids.CREATOR_ALL_ACL)
+      if (!sensitivePath(path)) {
+        list.addAll(ZooDefs.Ids.READ_ACL_UNSAFE)
+      }
+      list
+    } else
+      ZooDefs.Ids.OPEN_ACL_UNSAFE
   }
 
   def maybeDeletePath(zkUrl: String, dir: String) {
@@ -219,7 +235,11 @@ class ZkUtils(val zkClient: ZkClient,
                               BrokerSequenceIdPath,
                               IsrChangeNotificationPath)
 
-  val DefaultAcls: java.util.List[ACL] = ZkUtils.DefaultAcls(isSecure)
+  @deprecated("This is deprecated, use defaultAcls(path) which doesn't make sensitive data world readable", since = "0.10.2.1")
+  val DefaultAcls: java.util.List[ACL] = ZkUtils.defaultAcls(isSecure, "")
+
+  private val useDefaultAcl  = Collections.emptyList[ACL]
+  def defaultAcls(path: String): java.util.List[ACL] = ZkUtils.defaultAcls(isSecure, path)
 
   def getController(): Int = {
     readDataMaybeNull(ControllerPath)._1 match {
@@ -412,11 +432,15 @@ class ZkUtils(val zkClient: ZkClient,
   /**
    *  make sure a persistent path exists in ZK. Create the path if not exist.
    */
-  def makeSurePersistentPathExists(path: String, acls: java.util.List[ACL] = DefaultAcls) {
+  def makeSurePersistentPathExists(path: String, acls: java.util.List[ACL] = useDefaultAcl) {
     //Consumer path is kept open as different consumers will write under this node.
     val acl = if (path == null || path.isEmpty || path.equals(ConsumersPath)) {
       ZooDefs.Ids.OPEN_ACL_UNSAFE
-    } else acls
+    } else if (acls == useDefaultAcl) {
+      ZkUtils.defaultAcls(isSecure, path)
+    } else {
+      acls
+    }
 
     if (!zkClient.exists(path))
       ZkPath.createPersistent(zkClient, path, createParents = true, acl) //won't throw NoNodeException or NodeExistsException
@@ -425,23 +449,25 @@ class ZkUtils(val zkClient: ZkClient,
   /**
    *  create the parent path
    */
-  private def createParentPath(path: String, acls: java.util.List[ACL] = DefaultAcls): Unit = {
+  private def createParentPath(path: String, acls: java.util.List[ACL] = useDefaultAcl): Unit = {
+    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
     val parentDir = path.substring(0, path.lastIndexOf('/'))
     if (parentDir.length != 0) {
-      ZkPath.createPersistent(zkClient, parentDir, createParents = true, acls)
+      ZkPath.createPersistent(zkClient, parentDir, createParents = true, acl)
     }
   }
 
   /**
    * Create an ephemeral node with the given path and data. Create parents if necessary.
    */
-  private def createEphemeralPath(path: String, data: String, acls: java.util.List[ACL] = DefaultAcls): Unit = {
+  private def createEphemeralPath(path: String, data: String, acls: java.util.List[ACL] = useDefaultAcl): Unit = {
+    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
     try {
-      ZkPath.createEphemeral(zkClient, path, data, acls)
+      ZkPath.createEphemeral(zkClient, path, data, acl)
     } catch {
       case _: ZkNoNodeException =>
         createParentPath(path)
-        ZkPath.createEphemeral(zkClient, path, data, acls)
+        ZkPath.createEphemeral(zkClient, path, data, acl)
     }
   }
 
@@ -449,9 +475,10 @@ class ZkUtils(val zkClient: ZkClient,
    * Create an ephemeral node with the given path and data.
    * Throw NodeExistException if node already exists.
    */
-  def createEphemeralPathExpectConflict(path: String, data: String, acls: java.util.List[ACL] = DefaultAcls): Unit = {
+  def createEphemeralPathExpectConflict(path: String, data: String, acls: java.util.List[ACL] = useDefaultAcl): Unit = {
+    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
     try {
-      createEphemeralPath(path, data, acls)
+      createEphemeralPath(path, data, acl)
     } catch {
       case e: ZkNodeExistsException =>
         // this can happen when there is connection loss; make sure the data is what we intend to write
@@ -474,18 +501,20 @@ class ZkUtils(val zkClient: ZkClient,
   /**
    * Create an persistent node with the given path and data. Create parents if necessary.
    */
-  def createPersistentPath(path: String, data: String = "", acls: java.util.List[ACL] = DefaultAcls): Unit = {
+  def createPersistentPath(path: String, data: String = "", acls: java.util.List[ACL] = useDefaultAcl): Unit = {
+    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
     try {
-      ZkPath.createPersistent(zkClient, path, data, acls)
+      ZkPath.createPersistent(zkClient, path, data, acl)
     } catch {
       case _: ZkNoNodeException =>
         createParentPath(path)
-        ZkPath.createPersistent(zkClient, path, data, acls)
+        ZkPath.createPersistent(zkClient, path, data, acl)
     }
   }
 
-  def createSequentialPersistentPath(path: String, data: String = "", acls: java.util.List[ACL] = DefaultAcls): String = {
-    ZkPath.createPersistentSequential(zkClient, path, data, acls)
+  def createSequentialPersistentPath(path: String, data: String = "", acls: java.util.List[ACL] = useDefaultAcl): String = {
+    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
+    ZkPath.createPersistentSequential(zkClient, path, data, acl)
   }
 
   /**
@@ -493,14 +522,15 @@ class ZkUtils(val zkClient: ZkClient,
    * create parent directory if necessary. Never throw NodeExistException.
    * Return the updated path zkVersion
    */
-  def updatePersistentPath(path: String, data: String, acls: java.util.List[ACL] = DefaultAcls) = {
+  def updatePersistentPath(path: String, data: String, acls: java.util.List[ACL] = useDefaultAcl) = {
+    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
     try {
       zkClient.writeData(path, data)
     } catch {
       case _: ZkNoNodeException =>
         createParentPath(path)
         try {
-          ZkPath.createPersistent(zkClient, path, data, acls)
+          ZkPath.createPersistent(zkClient, path, data, acl)
         } catch {
           case _: ZkNodeExistsException =>
             zkClient.writeData(path, data)
@@ -563,13 +593,14 @@ class ZkUtils(val zkClient: ZkClient,
    * Update the value of a persistent node with the given path and data.
    * create parent directory if necessary. Never throw NodeExistException.
    */
-  def updateEphemeralPath(path: String, data: String, acls: java.util.List[ACL] = DefaultAcls): Unit = {
+  def updateEphemeralPath(path: String, data: String, acls: java.util.List[ACL] = useDefaultAcl): Unit = {
+    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
     try {
       zkClient.writeData(path, data)
     } catch {
       case _: ZkNoNodeException =>
         createParentPath(path)
-        ZkPath.createEphemeral(zkClient, path, data, acls)
+        ZkPath.createEphemeral(zkClient, path, data, acl)
     }
   }
 
@@ -818,13 +849,14 @@ class ZkUtils(val zkClient: ZkClient,
     * It uses the stat returned by the zookeeper and return the version. Every time
     * client updates the path stat.version gets incremented. Starting value of sequence number is 1.
     */
-  def getSequenceId(path: String, acls: java.util.List[ACL] = DefaultAcls): Int = {
+  def getSequenceId(path: String, acls: java.util.List[ACL] = useDefaultAcl): Int = {
+    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
     def writeToZk: Int = zkClient.writeDataReturnStat(path, "", -1).getVersion
     try {
       writeToZk
     } catch {
       case _: ZkNoNodeException =>
-        makeSurePersistentPathExists(path)
+        makeSurePersistentPathExists(path, acl)
         writeToZk
     }
   }
@@ -990,6 +1022,7 @@ class ZKCheckedEphemeral(path: String,
   private val getDataCallback = new GetDataCallback
   val latch: CountDownLatch = new CountDownLatch(1)
   var result: Code = Code.OK
+  val defaultAcls = ZkUtils.defaultAcls(isSecure, path)
 
   private class CreateCallback extends StringCallback {
     def processResult(rc: Int,
@@ -1051,7 +1084,7 @@ class ZKCheckedEphemeral(path: String,
   private def createEphemeral() {
     zkHandle.create(path,
                     ZKStringSerializer.serialize(data),
-                    DefaultAcls(isSecure),
+                    defaultAcls,
                     CreateMode.EPHEMERAL,
                     createCallback,
                     null)
@@ -1064,7 +1097,7 @@ class ZKCheckedEphemeral(path: String,
     } else {
       zkHandle.create(prefix,
                       new Array[Byte](0),
-                      DefaultAcls(isSecure),
+                      defaultAcls,
                       CreateMode.PERSISTENT,
                       new StringCallback() {
                         def processResult(rc : Int,
diff --git a/core/src/test/scala/unit/kafka/security/auth/ZkAuthorizationTest.scala b/core/src/test/scala/unit/kafka/security/auth/ZkAuthorizationTest.scala
index 3b4c48e325d70..ba1becc63fa93 100644
--- a/core/src/test/scala/unit/kafka/security/auth/ZkAuthorizationTest.scala
+++ b/core/src/test/scala/unit/kafka/security/auth/ZkAuthorizationTest.scala
@@ -83,7 +83,7 @@ class ZkAuthorizationTest extends ZooKeeperTestHarness with Logging {
         val aclList = zkUtils.zkConnection.getAcl(path).getKey
         assertTrue(aclList.size == 2)
         for (acl: ACL <- aclList.asScala) {
-          assertTrue(isAclSecure(acl))
+          assertTrue(isAclSecure(acl, false))
         }
       }
     }
@@ -158,7 +158,7 @@ class ZkAuthorizationTest extends ZooKeeperTestHarness with Logging {
       zkUtils.makeSurePersistentPathExists(path)
       zkUtils.createPersistentPath(s"$path/fpjwashere", "")
     }
-    zkUtils.zkConnection.setAcl("/", zkUtils.DefaultAcls, -1)
+    zkUtils.zkConnection.setAcl("/", zkUtils.defaultAcls("/"), -1)
     deleteAllUnsecure()
   }
   
@@ -185,7 +185,7 @@ class ZkAuthorizationTest extends ZooKeeperTestHarness with Logging {
    */
   private def testMigration(zkUrl: String, firstZk: ZkUtils, secondZk: ZkUtils) {
     info(s"zkConnect string: $zkUrl")
-    for (path <- ZkUtils.SecureZkRootPaths) {
+    for (path <- ZkUtils.SecureZkRootPaths ++ ZkUtils.SensitiveZkRootPaths) {
       info(s"Creating $path")
       firstZk.makeSurePersistentPathExists(path)
       // Create a child for each znode to exercise the recurrent
@@ -206,39 +206,41 @@ class ZkAuthorizationTest extends ZooKeeperTestHarness with Logging {
       }
     ZkSecurityMigrator.run(Array(s"--zookeeper.acl=$secureOpt", s"--zookeeper.connect=$zkUrl"))
     info("Done with migration")
-    for (path <- ZkUtils.SecureZkRootPaths) {
+    for (path <- ZkUtils.SecureZkRootPaths ++ ZkUtils.SensitiveZkRootPaths) {
+      val sensitive = ZkUtils.sensitivePath(path)
       val listParent = secondZk.zkConnection.getAcl(path).getKey
-      assertTrue(path, isAclCorrect(listParent, secondZk.isSecure))
+      assertTrue(path, isAclCorrect(listParent, secondZk.isSecure, sensitive))
 
       val childPath = path + "/fpjwashere"
       val listChild = secondZk.zkConnection.getAcl(childPath).getKey
-      assertTrue(childPath, isAclCorrect(listChild, secondZk.isSecure))
+      assertTrue(childPath, isAclCorrect(listChild, secondZk.isSecure, sensitive))
     }
     // Check consumers path.
     val consumersAcl = firstZk.zkConnection.getAcl(ZkUtils.ConsumersPath).getKey
-    assertTrue(ZkUtils.ConsumersPath, isAclCorrect(consumersAcl, false))
+    assertTrue(ZkUtils.ConsumersPath, isAclCorrect(consumersAcl, false, false))
   }
 
   /**
    * Verifies that the path has the appropriate secure ACL.
    */
   private def verify(path: String): Boolean = {
+    val sensitive = ZkUtils.sensitivePath(path)
     val list = zkUtils.zkConnection.getAcl(path).getKey
-    list.asScala.forall(isAclSecure)
+    list.asScala.forall(isAclSecure(_, sensitive))
   }
 
   /**
    * Verifies ACL.
    */
-  private def isAclCorrect(list: java.util.List[ACL], secure: Boolean): Boolean = {
+  private def isAclCorrect(list: java.util.List[ACL], secure: Boolean, sensitive: Boolean): Boolean = {
     val isListSizeCorrect =
-      if (secure)
+      if (secure && !sensitive)
         list.size == 2
       else
         list.size == 1
     isListSizeCorrect && list.asScala.forall(
       if (secure)
-        isAclSecure
+        isAclSecure(_, sensitive)
       else
         isAclUnsecure
     )
@@ -249,10 +251,10 @@ class ZkAuthorizationTest extends ZooKeeperTestHarness with Logging {
    * values are based on the constants used in the 
    * ZooKeeper code base.
    */
-  private def isAclSecure(acl: ACL): Boolean = {
+  private def isAclSecure(acl: ACL, sensitive: Boolean): Boolean = {
     info(s"ACL $acl")
     acl.getPerms match {
-      case 1 => acl.getId.getScheme.equals("world")
+      case 1 => !sensitive && acl.getId.getScheme.equals("world")
       case 31 => acl.getId.getScheme.equals("sasl")
       case _ => false
     }

From 629ee94d27d776c829d4dbb60672d947addd6a26 Mon Sep 17 00:00:00 2001
From: Ismael Juma <ismael@juma.me.uk>
Date: Mon, 10 Apr 2017 09:16:49 -0700
Subject: [PATCH 162/177] HOTFIX: Use a true sentinel for `UseDefaultAcls`

In 67fc2a91a6, we are using an empty collection and comparing via
value equality, so if a user passes an empty collection, they will
get the default ACLs instead of no ACLs. We fix that issue here.

Author: Ismael Juma <ismael@juma.me.uk>

Reviewers: Rajini Sivaram

Closes #2829 from ijuma/zk-utils-default-acls-improvement and squashes the following commits:

0846172 [Ismael Juma] Add missing import
2dc84f3 [Ismael Juma] Simplify logic in `sensitivePath`
8122f27 [Ismael Juma] Use a true sentinel instead of an empty collection for `UseDefaultAcls`

(cherry picked from commit c31958eb0d547b10a388fc63fcc3cbe00dec27f2)
Signed-off-by: Gwen Shapira <cshapi@gmail.com>
---
 core/src/main/scala/kafka/utils/ZkUtils.scala | 43 ++++++++++---------
 1 file changed, 22 insertions(+), 21 deletions(-)

diff --git a/core/src/main/scala/kafka/utils/ZkUtils.scala b/core/src/main/scala/kafka/utils/ZkUtils.scala
index 1d77cd7ae3891..648ac60b8e8b7 100644
--- a/core/src/main/scala/kafka/utils/ZkUtils.scala
+++ b/core/src/main/scala/kafka/utils/ZkUtils.scala
@@ -17,7 +17,6 @@
 
 package kafka.utils
 
-import java.util.Collections
 import java.util.concurrent.CountDownLatch
 
 import kafka.admin._
@@ -45,6 +44,7 @@ import scala.collection.JavaConverters._
 
 object ZkUtils {
 
+  private val UseDefaultAcls = new java.util.ArrayList[ACL]
 
   // Important: it is necessary to add any new top level Zookeeper path here
   val AdminPath = "/admin"
@@ -108,7 +108,7 @@ object ZkUtils {
   }
 
   def sensitivePath(path: String): Boolean = {
-    path != null && !SensitiveZkRootPaths.forall(!path.startsWith(_))
+    path != null && SensitiveZkRootPaths.exists(path.startsWith(_))
   }
 
   @deprecated("This is deprecated, use defaultAcls(isSecure, path) which doesn't make sensitive data world readable", since = "0.10.2.1")
@@ -235,10 +235,11 @@ class ZkUtils(val zkClient: ZkClient,
                               BrokerSequenceIdPath,
                               IsrChangeNotificationPath)
 
+  import ZkUtils._
+
   @deprecated("This is deprecated, use defaultAcls(path) which doesn't make sensitive data world readable", since = "0.10.2.1")
   val DefaultAcls: java.util.List[ACL] = ZkUtils.defaultAcls(isSecure, "")
 
-  private val useDefaultAcl  = Collections.emptyList[ACL]
   def defaultAcls(path: String): java.util.List[ACL] = ZkUtils.defaultAcls(isSecure, path)
 
   def getController(): Int = {
@@ -432,11 +433,11 @@ class ZkUtils(val zkClient: ZkClient,
   /**
    *  make sure a persistent path exists in ZK. Create the path if not exist.
    */
-  def makeSurePersistentPathExists(path: String, acls: java.util.List[ACL] = useDefaultAcl) {
+  def makeSurePersistentPathExists(path: String, acls: java.util.List[ACL] = UseDefaultAcls) {
     //Consumer path is kept open as different consumers will write under this node.
     val acl = if (path == null || path.isEmpty || path.equals(ConsumersPath)) {
       ZooDefs.Ids.OPEN_ACL_UNSAFE
-    } else if (acls == useDefaultAcl) {
+    } else if (acls eq UseDefaultAcls) {
       ZkUtils.defaultAcls(isSecure, path)
     } else {
       acls
@@ -449,8 +450,8 @@ class ZkUtils(val zkClient: ZkClient,
   /**
    *  create the parent path
    */
-  private def createParentPath(path: String, acls: java.util.List[ACL] = useDefaultAcl): Unit = {
-    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
+  private def createParentPath(path: String, acls: java.util.List[ACL] = UseDefaultAcls): Unit = {
+    val acl = if (acls eq UseDefaultAcls) ZkUtils.defaultAcls(isSecure, path) else acls
     val parentDir = path.substring(0, path.lastIndexOf('/'))
     if (parentDir.length != 0) {
       ZkPath.createPersistent(zkClient, parentDir, createParents = true, acl)
@@ -460,8 +461,8 @@ class ZkUtils(val zkClient: ZkClient,
   /**
    * Create an ephemeral node with the given path and data. Create parents if necessary.
    */
-  private def createEphemeralPath(path: String, data: String, acls: java.util.List[ACL] = useDefaultAcl): Unit = {
-    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
+  private def createEphemeralPath(path: String, data: String, acls: java.util.List[ACL] = UseDefaultAcls): Unit = {
+    val acl = if (acls eq UseDefaultAcls) ZkUtils.defaultAcls(isSecure, path) else acls
     try {
       ZkPath.createEphemeral(zkClient, path, data, acl)
     } catch {
@@ -475,8 +476,8 @@ class ZkUtils(val zkClient: ZkClient,
    * Create an ephemeral node with the given path and data.
    * Throw NodeExistException if node already exists.
    */
-  def createEphemeralPathExpectConflict(path: String, data: String, acls: java.util.List[ACL] = useDefaultAcl): Unit = {
-    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
+  def createEphemeralPathExpectConflict(path: String, data: String, acls: java.util.List[ACL] = UseDefaultAcls): Unit = {
+    val acl = if (acls eq UseDefaultAcls) ZkUtils.defaultAcls(isSecure, path) else acls
     try {
       createEphemeralPath(path, data, acl)
     } catch {
@@ -501,8 +502,8 @@ class ZkUtils(val zkClient: ZkClient,
   /**
    * Create an persistent node with the given path and data. Create parents if necessary.
    */
-  def createPersistentPath(path: String, data: String = "", acls: java.util.List[ACL] = useDefaultAcl): Unit = {
-    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
+  def createPersistentPath(path: String, data: String = "", acls: java.util.List[ACL] = UseDefaultAcls): Unit = {
+    val acl = if (acls eq UseDefaultAcls) ZkUtils.defaultAcls(isSecure, path) else acls
     try {
       ZkPath.createPersistent(zkClient, path, data, acl)
     } catch {
@@ -512,8 +513,8 @@ class ZkUtils(val zkClient: ZkClient,
     }
   }
 
-  def createSequentialPersistentPath(path: String, data: String = "", acls: java.util.List[ACL] = useDefaultAcl): String = {
-    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
+  def createSequentialPersistentPath(path: String, data: String = "", acls: java.util.List[ACL] = UseDefaultAcls): String = {
+    val acl = if (acls eq UseDefaultAcls) ZkUtils.defaultAcls(isSecure, path) else acls
     ZkPath.createPersistentSequential(zkClient, path, data, acl)
   }
 
@@ -522,8 +523,8 @@ class ZkUtils(val zkClient: ZkClient,
    * create parent directory if necessary. Never throw NodeExistException.
    * Return the updated path zkVersion
    */
-  def updatePersistentPath(path: String, data: String, acls: java.util.List[ACL] = useDefaultAcl) = {
-    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
+  def updatePersistentPath(path: String, data: String, acls: java.util.List[ACL] = UseDefaultAcls) = {
+    val acl = if (acls eq UseDefaultAcls) ZkUtils.defaultAcls(isSecure, path) else acls
     try {
       zkClient.writeData(path, data)
     } catch {
@@ -593,8 +594,8 @@ class ZkUtils(val zkClient: ZkClient,
    * Update the value of a persistent node with the given path and data.
    * create parent directory if necessary. Never throw NodeExistException.
    */
-  def updateEphemeralPath(path: String, data: String, acls: java.util.List[ACL] = useDefaultAcl): Unit = {
-    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
+  def updateEphemeralPath(path: String, data: String, acls: java.util.List[ACL] = UseDefaultAcls): Unit = {
+    val acl = if (acls eq UseDefaultAcls) ZkUtils.defaultAcls(isSecure, path) else acls
     try {
       zkClient.writeData(path, data)
     } catch {
@@ -849,8 +850,8 @@ class ZkUtils(val zkClient: ZkClient,
     * It uses the stat returned by the zookeeper and return the version. Every time
     * client updates the path stat.version gets incremented. Starting value of sequence number is 1.
     */
-  def getSequenceId(path: String, acls: java.util.List[ACL] = useDefaultAcl): Int = {
-    val acl = if (acls == useDefaultAcl) ZkUtils.defaultAcls(isSecure, path) else acls
+  def getSequenceId(path: String, acls: java.util.List[ACL] = UseDefaultAcls): Int = {
+    val acl = if (acls == UseDefaultAcls) ZkUtils.defaultAcls(isSecure, path) else acls
     def writeToZk: Int = zkClient.writeDataReturnStat(path, "", -1).getVersion
     try {
       writeToZk

From 2adaa50f552b38eac36ead8bd559a7581e7ff81f Mon Sep 17 00:00:00 2001
From: "Michael G. Noll" <michael@confluent.io>
Date: Tue, 11 Apr 2017 09:50:02 +0100
Subject: [PATCH 163/177] MINOR: Document ordering contract of iterator for
 window stores and session stores

Author: Michael G. Noll <michael@confluent.io>

Reviewers: Damian Guy <damian.guy@gmail.com>, Ismael Juma <ismael@juma.me.uk>

Closes #2751 from miguno/trunk-streams-window-iterator-doc-fixes

(cherry picked from commit 7c58351e9e7d109a54dfa319437ca5f891164e5b)
Signed-off-by: Ismael Juma <ismael@juma.me.uk>
---
 .../org/apache/kafka/streams/state/ReadOnlySessionStore.java | 4 ++++
 .../org/apache/kafka/streams/state/ReadOnlyWindowStore.java  | 5 ++++-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/state/ReadOnlySessionStore.java b/streams/src/main/java/org/apache/kafka/streams/state/ReadOnlySessionStore.java
index f09d357c59300..0f22b3470ecdb 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/ReadOnlySessionStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/ReadOnlySessionStore.java
@@ -33,6 +33,10 @@ public interface ReadOnlySessionStore<K, AGG> {
 
     /**
      * Retrieve all aggregated sessions for the provided key
+     *
+     * For each key, the iterator guarantees ordering of sessions, starting from the oldest/earliest
+     * available session to the newest/latest session.
+     *
      * @param    key record key to find aggregated session values for
      * @return   KeyValueIterator containing all sessions for the provided key.
      */
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/ReadOnlyWindowStore.java b/streams/src/main/java/org/apache/kafka/streams/state/ReadOnlyWindowStore.java
index 4f9b78a772140..ff65f164069e0 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/ReadOnlyWindowStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/ReadOnlyWindowStore.java
@@ -49,7 +49,10 @@ public interface ReadOnlyWindowStore<K, V> {
      * </pre>
      * And we call {@code store.fetch("A", 10, 20)} then the results will contain the first
      * three windows from the table above, i.e., all those where 10 <= start time <= 20.
-     * 
+     * <p>
+     * For each key, the iterator guarantees ordering of windows, starting from the oldest/earliest
+     * available window to the newest/latest window.
+     *
      * @return an iterator over key-value pairs {@code <timestamp, value>}
      * @throws InvalidStateStoreException if the store is not initialized
      */

From 5a68fa7e4e1315801c3128f95deedc0b2221ffaa Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno@confluent.io>
Date: Tue, 11 Apr 2017 17:07:53 -0700
Subject: [PATCH 164/177] MINOR: Added changes in 0.10.2.1

Author: Eno Thereska <eno@confluent.io>

Reviewers: Gwen Shapira

Closes #2824 from enothereska/minor-docs-0.10.2.1
---
 docs/streams.html |  7 +++++++
 docs/upgrade.html | 10 +++++++++-
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/docs/streams.html b/docs/streams.html
index 2b4c4414f6f62..fe0e84ee3b74c 100644
--- a/docs/streams.html
+++ b/docs/streams.html
@@ -813,6 +813,13 @@ <h2><a id="streams_upgrade_and_api" href="#streams_upgrade_and_api">Upgrade Guid
         See <a href="#streams_api_changes_0101">below</a> a complete list of 0.10.1 API changes that allow you to advance your application and/or simplify your code base, including the usage of new features.
         </p>
 
+         <h3><a id="streams_api_changes_01021" href="#streams_api_changes_0102">Notable changes in 0.10.2.1</a></h3>
+         <p>
+            Parameter updates in <code>StreamsConfig</code>:
+        </p>
+          <ul>
+            <li> of particular importance to improve the resiliency of a Kafka Streams application are two changes to default parameters of producer <code>retries</code> and consumer <code>max.poll.interval.ms</code> </li>
+          </ul>
         <h3><a id="streams_api_changes_0102" href="#streams_api_changes_0102">Streams API changes in 0.10.2.0</a></h3>
 
         <p>
diff --git a/docs/upgrade.html b/docs/upgrade.html
index 58754dd97aa69..12bd90ed454eb 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -61,6 +61,14 @@ <h5><a id="upgrade_1020_streams" href="#upgrade_1020_streams">Upgrading a 0.10.1
     <li> See <a href="/{{version}}/documentation/streams#streams_api_changes_0102">Streams API changes in 0.10.2</a> for more details. </li>
 </ul>
 
+<h5><a id="upgrade_10201_notable" href="#upgrade_10201_notable">Notable changes in 0.10.2.1</a></h5>
+<ul>
+  <li> The default values for two configurations of the StreamsConfig class were changed to improve the resiliency of Kafka Streams applications. The internal Kafka Streams producer <code>retries</code> default value was changed from 0 to 10. The internal Kafka Streams consumer <code>max.poll.interval.ms</code>  default value was changed from 300000 to <code>Integer.MAX_VALUE<code>.
+  </li>
+</ul>
+
+
+
 <h5><a id="upgrade_1020_notable" href="#upgrade_1020_notable">Notable changes in 0.10.2.0</a></h5>
 <ul>
     <li>The Java clients (producer and consumer) have acquired the ability to communicate with older brokers. Version 0.10.2 clients
@@ -346,4 +354,4 @@ <h4><a id="upgrade_7" href="#upgrade_7">Upgrading from 0.7</a></h4>
 
 </script>
 
-<div class="p-upgrade"></div>
\ No newline at end of file
+<div class="p-upgrade"></div>

From 5f728532aceb0132e3a312e2b427bc29f6c85f64 Mon Sep 17 00:00:00 2001
From: Gwen Shapira <cshapi@gmail.com>
Date: Wed, 12 Apr 2017 11:08:09 +0100
Subject: [PATCH 165/177] HOTFIX: HTML formatting error in upgrade docs

Introduced in PR #2824. Already fixed in the
website github.

Author: Gwen Shapira <cshapi@gmail.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2844 from gwenshap/docs-hotfix
---
 docs/upgrade.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/upgrade.html b/docs/upgrade.html
index 12bd90ed454eb..0221f63829463 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -63,7 +63,7 @@ <h5><a id="upgrade_1020_streams" href="#upgrade_1020_streams">Upgrading a 0.10.1
 
 <h5><a id="upgrade_10201_notable" href="#upgrade_10201_notable">Notable changes in 0.10.2.1</a></h5>
 <ul>
-  <li> The default values for two configurations of the StreamsConfig class were changed to improve the resiliency of Kafka Streams applications. The internal Kafka Streams producer <code>retries</code> default value was changed from 0 to 10. The internal Kafka Streams consumer <code>max.poll.interval.ms</code>  default value was changed from 300000 to <code>Integer.MAX_VALUE<code>.
+  <li> The default values for two configurations of the StreamsConfig class were changed to improve the resiliency of Kafka Streams applications. The internal Kafka Streams producer <code>retries</code> default value was changed from 0 to 10. The internal Kafka Streams consumer <code>max.poll.interval.ms</code>  default value was changed from 300000 to <code>Integer.MAX_VALUE</code>.
   </li>
 </ul>
 

From 8638675828b63c4bae6fb85de56543d7b3088546 Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno.thereska@gmail.com>
Date: Wed, 12 Apr 2017 15:26:37 +0100
Subject: [PATCH 166/177] KAFKA-5038; Throw correct exception of locking of
 state directory fails

Author: Eno Thereska <eno.thereska@gmail.com>

Reviewers: Damian Guy <damian.guy@gmail.com>, Matthias J. Sax <matthias@confluent.io>, Ismael Juma <ismael@juma.me.uk>

Closes #2841 from enothereska/KAFKA-5038
---
 .../internals/ProcessorStateManager.java       | 16 ++++++++++++----
 .../processor/internals/StateDirectory.java    |  9 ++++++++-
 .../internals/StateDirectoryTest.java          | 18 ++++++++++++++++++
 3 files changed, 38 insertions(+), 5 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java
index 65831a24d7183..2ef9634218859 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java
@@ -82,7 +82,7 @@ public ProcessorStateManager(final TaskId taskId,
                                  final Map<String, String> storeToChangelogTopic) throws LockException, IOException {
         this.taskId = taskId;
         this.stateDirectory = stateDirectory;
-        this.baseDir  = stateDirectory.directoryForTask(taskId);
+        this.logPrefix = String.format("task [%s]", taskId);
         this.partitionForTopic = new HashMap<>();
         for (TopicPartition source : sources) {
             this.partitionForTopic.put(source.topic(), source);
@@ -96,10 +96,18 @@ public ProcessorStateManager(final TaskId taskId,
         this.restoreCallbacks = isStandby ? new HashMap<String, StateRestoreCallback>() : null;
         this.storeToChangelogTopic = storeToChangelogTopic;
 
-        this.logPrefix = String.format("task [%s]", taskId);
-
         if (!stateDirectory.lock(taskId, 5)) {
-            throw new LockException(String.format("%s Failed to lock the state directory: %s", logPrefix, baseDir.getCanonicalPath()));
+            throw new LockException(String.format("%s Failed to lock the state directory for task %s",
+                logPrefix, taskId));
+        }
+        // get a handle on the parent/base directory of the task directory
+        // note that the parent directory could have been accidentally deleted here,
+        // so catch that exception if that is the case
+        try {
+            this.baseDir = stateDirectory.directoryForTask(taskId);
+        } catch (ProcessorStateException e) {
+            throw new LockException(String.format("%s Failed to get the directory for task %s. Exception %s",
+                logPrefix, taskId, e));
         }
 
         // load the checkpoint information
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StateDirectory.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StateDirectory.java
index d264b2606172c..b081e277d036a 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StateDirectory.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StateDirectory.java
@@ -95,11 +95,18 @@ public File globalStateDir() {
      * @throws IOException
      */
     public boolean lock(final TaskId taskId, int retry) throws IOException {
+        final File lockFile;
         // we already have the lock so bail out here
         if (locks.containsKey(taskId)) {
             return true;
         }
-        final File lockFile = new File(directoryForTask(taskId), LOCK_FILE_NAME);
+        try {
+            lockFile = new File(directoryForTask(taskId), LOCK_FILE_NAME);
+        } catch (ProcessorStateException e) {
+            // directoryForTask could be throwing an exception if another thread
+            // has concurrently deleted the directory
+            return false;
+        }
 
         final FileChannel channel;
 
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StateDirectoryTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StateDirectoryTest.java
index fb55796a45558..6b1d0773928af 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StateDirectoryTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StateDirectoryTest.java
@@ -18,6 +18,7 @@
 package org.apache.kafka.streams.processor.internals;
 
 import org.apache.kafka.common.utils.Utils;
+import org.apache.kafka.streams.errors.ProcessorStateException;
 import org.apache.kafka.streams.processor.TaskId;
 import org.apache.kafka.test.TestUtils;
 import org.junit.After;
@@ -32,6 +33,7 @@
 import java.util.List;
 
 import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertFalse;
 import static org.junit.Assert.assertTrue;
 import static org.junit.Assert.fail;
 
@@ -97,6 +99,22 @@ public void shouldBeTrueIfAlreadyHoldsLock() throws Exception {
         assertTrue(directory.lock(taskId, 0));
     }
 
+    @Test(expected = ProcessorStateException.class)
+    public void shouldThrowProcessorStateException() throws Exception {
+        final TaskId taskId = new TaskId(0, 0);
+
+        Utils.delete(stateDir);
+        directory.directoryForTask(taskId);
+    }
+
+    @Test
+    public void shouldNotLockDeletedDirectory() throws Exception {
+        final TaskId taskId = new TaskId(0, 0);
+
+        Utils.delete(stateDir);
+        assertFalse(directory.lock(taskId, 0));
+    }
+
 
     @Test
     public void shouldLockMulitpleTaskDirectories() throws Exception {

From a26731674815a57368ad4500a77e84a218a40e63 Mon Sep 17 00:00:00 2001
From: Dong Lin <lindong28@gmail.com>
Date: Sun, 16 Apr 2017 23:23:25 -0700
Subject: [PATCH 167/177] KAFKA-5075; Defer exception to the next pollOnce() if
 consumer's fetch position has already increased

Author: Dong Lin <lindong28@gmail.com>
Author: Dong Lin <lindong28@users.noreply.github.com>

Reviewers: Jiangjie Qin <becket.qin@gmail.com>

Closes #2859 from lindong28/KAFKA-5075

This is a backport patch for 0.10.2 after resolving the following conflict.
Conflicts:
	clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
---
 .../clients/consumer/internals/Fetcher.java   | 78 ++++++++++-----
 .../consumer/internals/FetcherTest.java       | 99 ++++++++++++++++---
 .../kafka/api/AuthorizerIntegrationTest.scala |  1 +
 3 files changed, 143 insertions(+), 35 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
index 6a13d46068650..c8bbfa3077809 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
@@ -95,6 +95,7 @@ public class Fetcher<K, V> implements SubscriptionState.Listener {
     private final Deserializer<V> valueDeserializer;
 
     private PartitionRecords<K, V> nextInLineRecords = null;
+    private ExceptionMetadata nextInLineExceptionMetadata = null;
 
     public Fetcher(ConsumerNetworkClient client,
                    int minBytes,
@@ -461,35 +462,54 @@ private Map<TopicPartition, Long> beginningOrEndOffset(Collection<TopicPartition
      *         the defaultResetPolicy is NONE
      */
     public Map<TopicPartition, List<ConsumerRecord<K, V>>> fetchedRecords() {
+        if (nextInLineExceptionMetadata != null) {
+            ExceptionMetadata exceptionMetadata = nextInLineExceptionMetadata;
+            nextInLineExceptionMetadata = null;
+            TopicPartition tp = exceptionMetadata.partition;
+            if (subscriptions.isFetchable(tp) && subscriptions.position(tp) == exceptionMetadata.fetchedOffset)
+                throw exceptionMetadata.exception;
+        }
+
         Map<TopicPartition, List<ConsumerRecord<K, V>>> drained = new HashMap<>();
         int recordsRemaining = maxPollRecords;
+        TopicPartition fetchedPartition = null;
+        long fetchedOffsets = -1L;
 
-        while (recordsRemaining > 0) {
-            if (nextInLineRecords == null || nextInLineRecords.isDrained()) {
-                CompletedFetch completedFetch = completedFetches.poll();
-                if (completedFetch == null)
-                    break;
-
-                nextInLineRecords = parseCompletedFetch(completedFetch);
-            } else {
-                TopicPartition partition = nextInLineRecords.partition;
-                List<ConsumerRecord<K, V>> records = drainRecords(nextInLineRecords, recordsRemaining);
-                if (!records.isEmpty()) {
-                    List<ConsumerRecord<K, V>> currentRecords = drained.get(partition);
-                    if (currentRecords == null) {
-                        drained.put(partition, records);
-                    } else {
-                        // this case shouldn't usually happen because we only send one fetch at a time per partition,
-                        // but it might conceivably happen in some rare cases (such as partition leader changes).
-                        // we have to copy to a new list because the old one may be immutable
-                        List<ConsumerRecord<K, V>> newRecords = new ArrayList<>(records.size() + currentRecords.size());
-                        newRecords.addAll(currentRecords);
-                        newRecords.addAll(records);
-                        drained.put(partition, newRecords);
+        try {
+            while (recordsRemaining > 0) {
+                if (nextInLineRecords == null || nextInLineRecords.isDrained()) {
+                    CompletedFetch completedFetch = completedFetches.poll();
+                    if (completedFetch == null) break;
+
+                    fetchedPartition = completedFetch.partition;
+                    fetchedOffsets = completedFetch.fetchedOffset;
+                    nextInLineRecords = parseCompletedFetch(completedFetch);
+                } else {
+                    TopicPartition partition = nextInLineRecords.partition;
+                    fetchedPartition = partition;
+                    fetchedOffsets = subscriptions.position(partition);
+                    List<ConsumerRecord<K, V>> records = drainRecords(nextInLineRecords, recordsRemaining);
+                    if (!records.isEmpty()) {
+                        List<ConsumerRecord<K, V>> currentRecords = drained.get(partition);
+                        if (currentRecords == null) {
+                            drained.put(partition, records);
+                        } else {
+                            // this case shouldn't usually happen because we only send one fetch at a time per partition,
+                            // but it might conceivably happen in some rare cases (such as partition leader changes).
+                            // we have to copy to a new list because the old one may be immutable
+                            List<ConsumerRecord<K, V>> newRecords = new ArrayList<>(records.size() + currentRecords.size());
+                            newRecords.addAll(currentRecords);
+                            newRecords.addAll(records);
+                            drained.put(partition, newRecords);
+                        }
+                        recordsRemaining -= records.size();
                     }
-                    recordsRemaining -= records.size();
                 }
             }
+        } catch (KafkaException e) {
+            if (drained.isEmpty())
+                throw e;
+            nextInLineExceptionMetadata = new ExceptionMetadata(fetchedPartition, fetchedOffsets, e);
         }
 
         return drained;
@@ -1139,4 +1159,16 @@ private static String partitionLagMetricName(TopicPartition tp) {
         }
     }
 
+    private static class ExceptionMetadata {
+        private final TopicPartition partition;
+        private final long fetchedOffset;
+        private final KafkaException exception;
+
+        private ExceptionMetadata(TopicPartition partition, long fetchedOffset, KafkaException exception) {
+            this.partition = partition;
+            this.fetchedOffset = fetchedOffset;
+            this.exception = exception;
+        }
+    }
+
 }
diff --git a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java
index 4d388e617d147..24ba434325d67 100644
--- a/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java
+++ b/clients/src/test/java/org/apache/kafka/clients/consumer/internals/FetcherTest.java
@@ -57,6 +57,7 @@
 import org.apache.kafka.common.serialization.ByteArrayDeserializer;
 import org.apache.kafka.common.serialization.Deserializer;
 import org.apache.kafka.common.utils.MockTime;
+import org.apache.kafka.common.utils.Utils;
 import org.apache.kafka.test.TestUtils;
 import org.junit.After;
 import org.junit.Before;
@@ -84,6 +85,7 @@ public class FetcherTest {
     private String groupId = "test-group";
     private final String metricGroup = "consumer" + groupId + "-fetch-manager-metrics";
     private TopicPartition tp = new TopicPartition(topicName, 0);
+    private TopicPartition tp1 = new TopicPartition(topicName, 1);
     private int minBytes = 1;
     private int maxBytes = Integer.MAX_VALUE;
     private int maxWaitMs = 0;
@@ -92,7 +94,7 @@ public class FetcherTest {
     private MockTime time = new MockTime(1);
     private Metadata metadata = new Metadata(0, Long.MAX_VALUE);
     private MockClient client = new MockClient(time, metadata);
-    private Cluster cluster = TestUtils.singletonCluster(topicName, 1);
+    private Cluster cluster = TestUtils.singletonCluster(topicName, 2);
     private Node node = cluster.nodes().get(0);
     private Metrics metrics = new Metrics(time);
     private SubscriptionState subscriptions = new SubscriptionState(OffsetResetStrategy.EARLIEST);
@@ -827,28 +829,28 @@ public void testGetOffsetsForTimes() {
     }
 
     private void testGetOffsetsForTimesWithError(Errors errorForTp0,
-                                                 Errors errorForTp1,
+                                                 Errors errorFortp,
                                                  long offsetForTp0,
-                                                 long offsetForTp1,
+                                                 long offsetFortp,
                                                  Long expectedOffsetForTp0,
-                                                 Long expectedOffsetForTp1) {
+                                                 Long expectedOffsetFortp) {
         client.reset();
         TopicPartition tp0 = tp;
-        TopicPartition tp1 = new TopicPartition(topicName, 1);
+        TopicPartition tp = new TopicPartition(topicName, 1);
         // Ensure metadata has both partition.
         Cluster cluster = TestUtils.clusterWith(2, topicName, 2);
         metadata.update(cluster, Collections.<String>emptySet(), time.milliseconds());
 
         // First try should fail due to metadata error.
         client.prepareResponseFrom(listOffsetResponse(tp0, errorForTp0, offsetForTp0, offsetForTp0), cluster.leaderFor(tp0));
-        client.prepareResponseFrom(listOffsetResponse(tp1, errorForTp1, offsetForTp1, offsetForTp1), cluster.leaderFor(tp1));
+        client.prepareResponseFrom(listOffsetResponse(tp, errorFortp, offsetFortp, offsetFortp), cluster.leaderFor(tp));
         // Second try should succeed.
         client.prepareResponseFrom(listOffsetResponse(tp0, Errors.NONE, offsetForTp0, offsetForTp0), cluster.leaderFor(tp0));
-        client.prepareResponseFrom(listOffsetResponse(tp1, Errors.NONE, offsetForTp1, offsetForTp1), cluster.leaderFor(tp1));
+        client.prepareResponseFrom(listOffsetResponse(tp, Errors.NONE, offsetFortp, offsetFortp), cluster.leaderFor(tp));
 
         Map<TopicPartition, Long> timestampToSearch = new HashMap<>();
         timestampToSearch.put(tp0, 0L);
-        timestampToSearch.put(tp1, 0L);
+        timestampToSearch.put(tp, 0L);
         Map<TopicPartition, OffsetAndTimestamp> offsetAndTimestampMap = fetcher.getOffsetsByTimes(timestampToSearch, Long.MAX_VALUE);
 
         if (expectedOffsetForTp0 == null)
@@ -858,14 +860,87 @@ private void testGetOffsetsForTimesWithError(Errors errorForTp0,
             assertEquals(expectedOffsetForTp0.longValue(), offsetAndTimestampMap.get(tp0).offset());
         }
 
-        if (expectedOffsetForTp1 == null)
-            assertNull(offsetAndTimestampMap.get(tp1));
+        if (expectedOffsetFortp == null)
+            assertNull(offsetAndTimestampMap.get(tp));
         else {
-            assertEquals(expectedOffsetForTp1.longValue(), offsetAndTimestampMap.get(tp1).timestamp());
-            assertEquals(expectedOffsetForTp1.longValue(), offsetAndTimestampMap.get(tp1).offset());
+            assertEquals(expectedOffsetFortp.longValue(), offsetAndTimestampMap.get(tp).timestamp());
+            assertEquals(expectedOffsetFortp.longValue(), offsetAndTimestampMap.get(tp).offset());
         }
     }
 
+    @Test
+    public void testFetchPositionAfterException() {
+    // verify the advancement in the next fetch offset equals the number of fetched records when
+        // some fetched partitions cause Exception. This ensures that consumer won't lose record upon exception
+        subscriptionsNoAutoReset.assignFromUser(Utils.mkSet(tp, tp1));
+        subscriptionsNoAutoReset.seek(tp, 1);
+        subscriptionsNoAutoReset.seek(tp1, 1);
+
+        assertEquals(1, fetcherNoAutoReset.sendFetches());
+
+        Map<TopicPartition, FetchResponse.PartitionData> partitions = new HashMap<>();
+        partitions.put(tp, new FetchResponse.PartitionData(Errors.OFFSET_OUT_OF_RANGE.code(), 100, MemoryRecords.EMPTY));
+        partitions.put(tp1, new FetchResponse.PartitionData(Errors.NONE.code(), 100, records));
+        client.prepareResponse(new FetchResponse(new LinkedHashMap<>(partitions), 0));
+        consumerClient.poll(0);
+
+        List<ConsumerRecord<byte[], byte[]>> fetchedRecords = new ArrayList<>();
+        List<OffsetOutOfRangeException> exceptions = new ArrayList<>();
+
+        try {
+            for (List<ConsumerRecord<byte[], byte[]>> records: fetcherNoAutoReset.fetchedRecords().values())
+                fetchedRecords.addAll(records);
+        } catch (OffsetOutOfRangeException e) {
+            exceptions.add(e);
+        }
+
+        assertEquals(fetchedRecords.size(), subscriptionsNoAutoReset.position(tp1) - 1);
+
+        try {
+            for (List<ConsumerRecord<byte[], byte[]>> records: fetcherNoAutoReset.fetchedRecords().values())
+                fetchedRecords.addAll(records);
+        } catch (OffsetOutOfRangeException e) {
+            exceptions.add(e);
+        }
+
+        assertEquals(4, subscriptionsNoAutoReset.position(tp1).longValue());
+        assertEquals(3, fetchedRecords.size());
+
+        // Should have received one OffsetOutOfRangeException for partition tp
+        assertEquals(1, exceptions.size());
+        OffsetOutOfRangeException e = exceptions.get(0);
+        assertTrue(e.offsetOutOfRangePartitions().containsKey(tp));
+        assertEquals(e.offsetOutOfRangePartitions().size(), 1);
+    }
+
+    @Test
+    public void testSeekBeforeException() {
+        Fetcher<byte[], byte[]> fetcher = createFetcher(subscriptionsNoAutoReset, new Metrics(time), 2);
+
+        subscriptionsNoAutoReset.assignFromUser(Utils.mkSet(tp));
+        subscriptionsNoAutoReset.seek(tp, 1);
+        assertEquals(1, fetcher.sendFetches());
+        Map<TopicPartition, FetchResponse.PartitionData> partitions = new HashMap<>();
+        partitions.put(tp, new FetchResponse.PartitionData(Errors.NONE.code(), 100, records));
+        client.prepareResponse(fetchResponse(this.records, Errors.NONE.code(), 100L, 0));
+        consumerClient.poll(0);
+
+        assertEquals(2, fetcher.fetchedRecords().get(tp).size());
+
+        subscriptionsNoAutoReset.assignFromUser(Utils.mkSet(tp, tp1));
+        subscriptionsNoAutoReset.seek(tp1, 1);
+        assertEquals(1, fetcher.sendFetches());
+        partitions = new HashMap<>();
+        partitions.put(tp1, new FetchResponse.PartitionData(Errors.OFFSET_OUT_OF_RANGE.code(), 100, MemoryRecords.EMPTY));
+        client.prepareResponse(new FetchResponse(new LinkedHashMap<>(partitions), 0));
+        consumerClient.poll(0);
+        assertEquals(1, fetcher.fetchedRecords().get(tp).size());
+
+        subscriptionsNoAutoReset.seek(tp1, 10);
+        // Should not throw OffsetOutOfRangeException after the seek
+        assertEquals(0, fetcher.fetchedRecords().size());
+    }
+
     private MockClient.RequestMatcher listOffsetRequestMatcher(final long timestamp) {
         // matches any list offset request with the provided timestamp
         return new MockClient.RequestMatcher() {
diff --git a/core/src/test/scala/integration/kafka/api/AuthorizerIntegrationTest.scala b/core/src/test/scala/integration/kafka/api/AuthorizerIntegrationTest.scala
index c9d35af7fb168..1ba3214de5af6 100644
--- a/core/src/test/scala/integration/kafka/api/AuthorizerIntegrationTest.scala
+++ b/core/src/test/scala/integration/kafka/api/AuthorizerIntegrationTest.scala
@@ -605,6 +605,7 @@ class AuthorizerIntegrationTest extends BaseRequestTest {
     try {
       consumer.subscribe(Pattern.compile(".*"), new NoOpConsumerRebalanceListener)
       consumeRecords(consumer)
+      consumeRecords(consumer)
       Assert.fail("Expected TopicAuthorizationException")
     } catch {
       case _: TopicAuthorizationException => //expected

From 2aa615545514cd9d2be0c998e685fad10927d208 Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno.thereska@gmail.com>
Date: Thu, 20 Apr 2017 13:10:00 -0700
Subject: [PATCH 168/177] KAFKA-5097; Fix regression in consumer caused by
 unsafe access to potentially unassigned partitions

Author: Eno Thereska <eno.thereska@gmail.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>, Jiangjie Qin <becket.qin@gmail.com>, Jason Gustafson <jason@confluent.io>

Closes #2876 from enothereska/KAFKA-4755-fetcher-only
---
 .../clients/consumer/internals/Fetcher.java   | 61 ++++++++-----------
 1 file changed, 27 insertions(+), 34 deletions(-)

diff --git a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
index c8bbfa3077809..e2631b534ce37 100644
--- a/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
+++ b/clients/src/main/java/org/apache/kafka/clients/consumer/internals/Fetcher.java
@@ -472,46 +472,39 @@ public Map<TopicPartition, List<ConsumerRecord<K, V>>> fetchedRecords() {
 
         Map<TopicPartition, List<ConsumerRecord<K, V>>> drained = new HashMap<>();
         int recordsRemaining = maxPollRecords;
-        TopicPartition fetchedPartition = null;
-        long fetchedOffsets = -1L;
-
-        try {
-            while (recordsRemaining > 0) {
-                if (nextInLineRecords == null || nextInLineRecords.isDrained()) {
-                    CompletedFetch completedFetch = completedFetches.poll();
-                    if (completedFetch == null) break;
-
-                    fetchedPartition = completedFetch.partition;
-                    fetchedOffsets = completedFetch.fetchedOffset;
+        while (recordsRemaining > 0) {
+            if (nextInLineRecords == null || nextInLineRecords.isDrained()) {
+                CompletedFetch completedFetch = completedFetches.poll();
+                if (completedFetch == null) break;
+                try {
                     nextInLineRecords = parseCompletedFetch(completedFetch);
-                } else {
-                    TopicPartition partition = nextInLineRecords.partition;
-                    fetchedPartition = partition;
-                    fetchedOffsets = subscriptions.position(partition);
-                    List<ConsumerRecord<K, V>> records = drainRecords(nextInLineRecords, recordsRemaining);
-                    if (!records.isEmpty()) {
-                        List<ConsumerRecord<K, V>> currentRecords = drained.get(partition);
-                        if (currentRecords == null) {
-                            drained.put(partition, records);
-                        } else {
-                            // this case shouldn't usually happen because we only send one fetch at a time per partition,
-                            // but it might conceivably happen in some rare cases (such as partition leader changes).
-                            // we have to copy to a new list because the old one may be immutable
-                            List<ConsumerRecord<K, V>> newRecords = new ArrayList<>(records.size() + currentRecords.size());
-                            newRecords.addAll(currentRecords);
-                            newRecords.addAll(records);
-                            drained.put(partition, newRecords);
-                        }
-                        recordsRemaining -= records.size();
+                } catch (KafkaException e) {
+                    if (drained.isEmpty())
+                        throw e;
+                    nextInLineExceptionMetadata = new ExceptionMetadata(completedFetch.partition, completedFetch.fetchedOffset, e);
+                }
+            } else {
+                TopicPartition partition = nextInLineRecords.partition;
+                List<ConsumerRecord<K, V>> records = drainRecords(nextInLineRecords, recordsRemaining);
+                if (!records.isEmpty()) {
+                    List<ConsumerRecord<K, V>> currentRecords = drained.get(partition);
+                    if (currentRecords == null) {
+                        drained.put(partition, records);
+                    } else {
+                        // this case shouldn't usually happen because we only send one fetch at a time per partition,
+                        // but it might conceivably happen in some rare cases (such as partition leader changes).
+                        // we have to copy to a new list because the old one may be immutable
+                        List<ConsumerRecord<K, V>> newRecords = new ArrayList<>(records.size() + currentRecords.size());
+                        newRecords.addAll(currentRecords);
+                        newRecords.addAll(records);
+                        drained.put(partition, newRecords);
                     }
+                    recordsRemaining -= records.size();
                 }
             }
-        } catch (KafkaException e) {
-            if (drained.isEmpty())
-                throw e;
-            nextInLineExceptionMetadata = new ExceptionMetadata(fetchedPartition, fetchedOffsets, e);
         }
 
+
         return drained;
     }
 

From b9dadae97c29341d5c008d429bb53b3fcc1b6713 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Thu, 20 Apr 2017 14:11:49 -0700
Subject: [PATCH 169/177] MINOR: reduce commit interval and cache size for
 integration test

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Damian Guy, Eno Thereska, Guozhang Wang

Closes #2789 from mjsax/minor-improve-integration-test

(cherry picked from commit 14ab3dcc6c70d5bd4b21d99e0b97332ea332ac07)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../GlobalKTableIntegrationTest.java          |  1 +
 .../InternalTopicIntegrationTest.java         |  4 +++-
 .../integration/JoinIntegrationTest.java      |  1 +
 .../KStreamAggregationIntegrationTest.java    |  2 +-
 .../KTableKTableJoinIntegrationTest.java      |  1 +
 .../QueryableStateIntegrationTest.java        | 19 +++++++++----------
 .../integration/ResetIntegrationTest.java     |  1 +
 .../apache/kafka/test/StreamsTestUtils.java   |  2 ++
 8 files changed, 19 insertions(+), 12 deletions(-)

diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/GlobalKTableIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/GlobalKTableIntegrationTest.java
index 9e59113ada28e..a844a3cba259c 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/GlobalKTableIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/GlobalKTableIntegrationTest.java
@@ -93,6 +93,7 @@ public void before() throws InterruptedException {
         streamsConfiguration.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
         streamsConfiguration.put(StreamsConfig.STATE_DIR_CONFIG, TestUtils.tempDirectory().getPath());
         streamsConfiguration.put(StreamsConfig.CACHE_MAX_BYTES_BUFFERING_CONFIG, 0);
+        streamsConfiguration.put(StreamsConfig.COMMIT_INTERVAL_MS_CONFIG, 100);
         globalTable = builder.globalTable(Serdes.Long(), Serdes.String(), globalOne, globalStore);
         stream = builder.stream(Serdes.String(), Serdes.Long(), inputStream);
         table = builder.table(Serdes.String(), Serdes.Long(), inputTable, "table");
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/InternalTopicIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/InternalTopicIntegrationTest.java
index 52bd6e7e00729..20556c4073622 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/InternalTopicIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/InternalTopicIntegrationTest.java
@@ -87,6 +87,8 @@ public void before() {
         streamsConfiguration.put(StreamsConfig.VALUE_SERDE_CLASS_CONFIG, Serdes.String().getClass().getName());
         streamsConfiguration.put(StreamsConfig.STATE_DIR_CONFIG, TestUtils.tempDirectory().getPath());
         streamsConfiguration.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
+        streamsConfiguration.put(StreamsConfig.COMMIT_INTERVAL_MS_CONFIG, 100);
+        streamsConfiguration.put(StreamsConfig.CACHE_MAX_BYTES_BUFFERING_CONFIG, 0);
     }
 
     private Properties getTopicConfigProperties(final String changelog) {
@@ -219,4 +221,4 @@ public Iterable<String> apply(String value) {
         final long retention = TimeUnit.MILLISECONDS.convert(1, TimeUnit.DAYS) + durationMs;
         assertEquals(retention, Long.parseLong(properties.getProperty(LogConfig.RetentionMsProp())));
     }
-}
\ No newline at end of file
+}
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/JoinIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/JoinIntegrationTest.java
index ac8abd45a459d..0c052f570d13c 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/JoinIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/JoinIntegrationTest.java
@@ -126,6 +126,7 @@ public static void setupConfigsAndUtils() throws Exception {
         STREAMS_CONFIG.put(StreamsConfig.KEY_SERDE_CLASS_CONFIG, Serdes.Long().getClass());
         STREAMS_CONFIG.put(StreamsConfig.VALUE_SERDE_CLASS_CONFIG, Serdes.String().getClass());
         STREAMS_CONFIG.put(StreamsConfig.CACHE_MAX_BYTES_BUFFERING_CONFIG, 0);
+        STREAMS_CONFIG.put(StreamsConfig.COMMIT_INTERVAL_MS_CONFIG, 100);
 
         zkUtils = ZkUtils.apply(CLUSTER.zKConnectString(),
             30000,
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamAggregationIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamAggregationIntegrationTest.java
index beb41ce68c610..f6708a7f02d35 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/KStreamAggregationIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/KStreamAggregationIntegrationTest.java
@@ -101,7 +101,7 @@ public void before() throws InterruptedException {
         streamsConfiguration.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
         streamsConfiguration.put(StreamsConfig.STATE_DIR_CONFIG, TestUtils.tempDirectory().getPath());
         streamsConfiguration.put(StreamsConfig.CACHE_MAX_BYTES_BUFFERING_CONFIG, 0);
-
+        streamsConfiguration.put(StreamsConfig.COMMIT_INTERVAL_MS_CONFIG, 100);
 
         final KeyValueMapper<Integer, String, String> mapper = MockKeyValueMapper.SelectValueMapper();
         stream = builder.stream(Serdes.Integer(), Serdes.String(), streamOneInput);
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/KTableKTableJoinIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/KTableKTableJoinIntegrationTest.java
index 7061507f6e688..322dd591d8efc 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/KTableKTableJoinIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/KTableKTableJoinIntegrationTest.java
@@ -138,6 +138,7 @@ public static void beforeTest() throws Exception {
         streamsConfig.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
         streamsConfig.put(StreamsConfig.STATE_DIR_CONFIG, TestUtils.tempDirectory().getPath());
         streamsConfig.put(StreamsConfig.CACHE_MAX_BYTES_BUFFERING_CONFIG, 0);
+        streamsConfig.put(StreamsConfig.COMMIT_INTERVAL_MS_CONFIG, 100);
 
         final Properties producerConfig = new Properties();
         producerConfig.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, CLUSTER.bootstrapServers());
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/QueryableStateIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/QueryableStateIntegrationTest.java
index 911c6a89cfe17..0e4cdc7ae0c8d 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/QueryableStateIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/QueryableStateIntegrationTest.java
@@ -28,6 +28,7 @@
 import org.apache.kafka.streams.KafkaStreamsTest;
 import org.apache.kafka.streams.KeyValue;
 import org.apache.kafka.streams.StreamsConfig;
+import org.apache.kafka.streams.errors.InvalidStateStoreException;
 import org.apache.kafka.streams.integration.utils.EmbeddedKafkaCluster;
 import org.apache.kafka.streams.integration.utils.IntegrationTestUtils;
 import org.apache.kafka.streams.kstream.KGroupedStream;
@@ -41,13 +42,9 @@
 import org.apache.kafka.streams.state.ReadOnlyWindowStore;
 import org.apache.kafka.streams.state.StreamsMetadata;
 import org.apache.kafka.streams.state.WindowStoreIterator;
-import org.apache.kafka.streams.errors.InvalidStateStoreException;
 import org.apache.kafka.test.MockKeyValueMapper;
 import org.apache.kafka.test.TestCondition;
 import org.apache.kafka.test.TestUtils;
-import static org.junit.Assert.fail;
-import static org.junit.Assert.assertTrue;
-import static org.junit.Assert.assertEquals;
 import org.junit.After;
 import org.junit.Before;
 import org.junit.ClassRule;
@@ -74,6 +71,9 @@
 
 import static org.hamcrest.MatcherAssert.assertThat;
 import static org.hamcrest.core.IsEqual.equalTo;
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertTrue;
+import static org.junit.Assert.fail;
 
 @RunWith(Parameterized.class)
 public class QueryableStateIntegrationTest {
@@ -136,15 +136,14 @@ public void before() throws IOException, InterruptedException {
         final String applicationId = "queryable-state-" + testNo;
 
         streamsConfiguration.put(StreamsConfig.APPLICATION_ID_CONFIG, applicationId);
-        streamsConfiguration
-            .put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, CLUSTER.bootstrapServers());
-        streamsConfiguration.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
+        streamsConfiguration.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, CLUSTER.bootstrapServers());
         streamsConfiguration.put(StreamsConfig.STATE_DIR_CONFIG, TestUtils.tempDirectory("qs-test").getPath());
         streamsConfiguration.put(StreamsConfig.KEY_SERDE_CLASS_CONFIG, Serdes.String().getClass());
-        streamsConfiguration
-            .put(StreamsConfig.VALUE_SERDE_CLASS_CONFIG, Serdes.String().getClass());
+        streamsConfiguration.put(StreamsConfig.VALUE_SERDE_CLASS_CONFIG, Serdes.String().getClass());
         streamsConfiguration.put(StreamsConfig.CACHE_MAX_BYTES_BUFFERING_CONFIG, cacheSizeBytes);
-        streamsConfiguration.put(StreamsConfig.COMMIT_INTERVAL_MS_CONFIG, 1000);
+        streamsConfiguration.put(StreamsConfig.COMMIT_INTERVAL_MS_CONFIG, 100);
+        streamsConfiguration.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
+        // override this to make the rebalances happen quickly
 
         stringComparator = new Comparator<KeyValue<String, String>>() {
 
diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java
index 39889b15eda5c..27b9ea6c529af 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java
@@ -270,6 +270,7 @@ private Properties prepareTest() throws Exception {
         streamsConfiguration.put(StreamsConfig.VALUE_SERDE_CLASS_CONFIG, Serdes.String().getClass());
         streamsConfiguration.put(StreamsConfig.NUM_STREAM_THREADS_CONFIG, 4);
         streamsConfiguration.put(StreamsConfig.CACHE_MAX_BYTES_BUFFERING_CONFIG, 0);
+        streamsConfiguration.put(StreamsConfig.COMMIT_INTERVAL_MS_CONFIG, 100);
         streamsConfiguration.put(ConsumerConfig.HEARTBEAT_INTERVAL_MS_CONFIG, 100);
         streamsConfiguration.put(ConsumerConfig.SESSION_TIMEOUT_MS_CONFIG, "" + STREAMS_CONSUMER_TIMEOUT);
         streamsConfiguration.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
diff --git a/streams/src/test/java/org/apache/kafka/test/StreamsTestUtils.java b/streams/src/test/java/org/apache/kafka/test/StreamsTestUtils.java
index 73c1b63a2a47b..7e9272a6451ff 100644
--- a/streams/src/test/java/org/apache/kafka/test/StreamsTestUtils.java
+++ b/streams/src/test/java/org/apache/kafka/test/StreamsTestUtils.java
@@ -41,6 +41,8 @@ public static Properties getStreamsConfig(final String applicationId,
         streamsConfiguration.put(StreamsConfig.VALUE_SERDE_CLASS_CONFIG, valueSerdeClassName);
         streamsConfiguration.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
         streamsConfiguration.put(StreamsConfig.STATE_DIR_CONFIG, TestUtils.tempDirectory().getPath());
+        streamsConfiguration.put(StreamsConfig.CACHE_MAX_BYTES_BUFFERING_CONFIG, 0);
+        streamsConfiguration.put(StreamsConfig.COMMIT_INTERVAL_MS_CONFIG, 100);
         streamsConfiguration.putAll(additional);
         return streamsConfiguration;
 

From 0731d35e58b2d70e91c06edcd17c5e447b2a1f75 Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno@confluent.io>
Date: Thu, 20 Apr 2017 14:55:43 -0700
Subject: [PATCH 170/177] KAFKA-5095: Adjust accepted overhead for
 ThreadCacheTest

Author: Eno Thereska <eno@confluent.io>

Reviewers: Damian Guy, Guozhang Wang

Closes #2877 from enothereska/KAFKA-5095-cacheOverheads

(cherry picked from commit f18a14af361f24851664b428b46d5789f51a80ea)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
---
 .../apache/kafka/streams/state/internals/ThreadCacheTest.java | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/streams/src/test/java/org/apache/kafka/streams/state/internals/ThreadCacheTest.java b/streams/src/test/java/org/apache/kafka/streams/state/internals/ThreadCacheTest.java
index 499d82358ee2d..a228183a37a47 100644
--- a/streams/src/test/java/org/apache/kafka/streams/state/internals/ThreadCacheTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/state/internals/ThreadCacheTest.java
@@ -105,7 +105,7 @@ private void checkOverheads(double entryFactor, double systemFactor, long desire
     public void cacheOverheadsSmallValues() {
         Runtime runtime = Runtime.getRuntime();
         double factor = 0.05;
-        double systemFactor = 2.5;
+        double systemFactor = 3; // if I ask for a cache size of 10 MB, accept an overhead of 3x, i.e., 30 MBs might be allocated
         long desiredCacheSize = Math.min(100 * 1024 * 1024L, runtime.maxMemory());
         int keySizeBytes = 8;
         int valueSizeBytes = 100;
@@ -117,7 +117,7 @@ public void cacheOverheadsSmallValues() {
     public void cacheOverheadsLargeValues() {
         Runtime runtime = Runtime.getRuntime();
         double factor = 0.05;
-        double systemFactor = 1.5;
+        double systemFactor = 2; // if I ask for a cache size of 10 MB, accept an overhead of 2x, i.e., 20 MBs might be allocated
         long desiredCacheSize = Math.min(100 * 1024 * 1024L, runtime.maxMemory());
         int keySizeBytes = 8;
         int valueSizeBytes = 1000;

From 495cdbde9e164513c8f982df80c0f29a871b62f2 Mon Sep 17 00:00:00 2001
From: "Matthias J. Sax" <matthias@confluent.io>
Date: Thu, 30 Mar 2017 13:30:10 -0700
Subject: [PATCH 171/177] KAFKA-4980: testReprocessingFromScratch unit test
 failure

We got test error `org.apache.kafka.common.errors.TopicExistsException: Topic 'inputTopic' already exists.` in some builds. Can reproduce reliably at local machine. Root cause it async "topic delete" that might not be finished before topic gets re-created.

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Ismael Juma, Damian Guy, Guozhang Wang

Closes #2757 from mjsax/minor-fix-resetintegrationtest
---
 .../integration/ResetIntegrationTest.java     | 38 ++++++++++++++++++-
 1 file changed, 36 insertions(+), 2 deletions(-)

diff --git a/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java b/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java
index 27b9ea6c529af..d653d005ef49f 100644
--- a/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/integration/ResetIntegrationTest.java
@@ -23,6 +23,7 @@
 import kafka.utils.ZkUtils;
 import org.apache.kafka.clients.consumer.ConsumerConfig;
 import org.apache.kafka.common.errors.GroupCoordinatorNotAvailableException;
+import org.apache.kafka.common.errors.TimeoutException;
 import org.apache.kafka.common.errors.UnknownTopicOrPartitionException;
 import org.apache.kafka.common.security.JaasUtils;
 import org.apache.kafka.common.serialization.LongDeserializer;
@@ -115,9 +116,11 @@ public void cleanup() throws Exception {
             try {
                 TestUtils.waitForCondition(consumerGroupInactive, TIMEOUT_MULTIPLIER * CLEANUP_CONSUMER_TIMEOUT,
                         "Test consumer group active even after waiting " + (TIMEOUT_MULTIPLIER * CLEANUP_CONSUMER_TIMEOUT) + " ms.");
-            } catch (GroupCoordinatorNotAvailableException e) {
+            } catch (final GroupCoordinatorNotAvailableException e) {
                 continue;
-            } catch (IllegalArgumentException e) {
+            } catch (final IllegalArgumentException e) {
+                continue;
+            } catch (final TimeoutException e) {
                 continue;
             }
             break;
@@ -301,6 +304,9 @@ private void prepareInputData() throws Exception {
         } catch (final UnknownTopicOrPartitionException e) {
             // ignore
         }
+
+        waitUntilUserTopicsAreDeleted();
+
         CLUSTER.createTopic(INPUT_TOPIC);
         CLUSTER.createTopic(OUTPUT_TOPIC);
         CLUSTER.createTopic(OUTPUT_TOPIC_2);
@@ -403,6 +409,34 @@ private void cleanGlobal(final String intermediateUserTopic) {
         Assert.assertEquals(0, exitCode);
     }
 
+    private void waitUntilUserTopicsAreDeleted() {
+        ZkUtils zkUtils = null;
+        try {
+            zkUtils = ZkUtils.apply(CLUSTER.zKConnectString(),
+                30000,
+                30000,
+                JaasUtils.isZkSecurityEnabled());
+
+            while (userTopicExists(new HashSet<>(scala.collection.JavaConversions.seqAsJavaList(zkUtils.getAllTopics())))) {
+                Utils.sleep(100);
+            }
+        } finally {
+            if (zkUtils != null) {
+                zkUtils.close();
+            }
+        }
+    }
+
+    private boolean userTopicExists(final Set<String> allTopics) {
+        final Set<String> expectedMissingTopics = new HashSet<>();
+        expectedMissingTopics.add(INPUT_TOPIC);
+        expectedMissingTopics.add(OUTPUT_TOPIC);
+        expectedMissingTopics.add(OUTPUT_TOPIC_2);
+        expectedMissingTopics.add(OUTPUT_TOPIC_2_RERUN);
+
+        return expectedMissingTopics.removeAll(allTopics);
+    }
+
     private void assertInternalTopicsGotDeleted(final String intermediateUserTopic) {
         final Set<String> expectedRemainingTopicsAfterCleanup = new HashSet<>();
         expectedRemainingTopicsAfterCleanup.add(INPUT_TOPIC);

From e89bffd6b2eff799713f560074c657f3f522cd85 Mon Sep 17 00:00:00 2001
From: Gwen Shapira <cshapi@gmail.com>
Date: Fri, 21 Apr 2017 09:23:03 -0700
Subject: [PATCH 172/177] Bump version to 0.10.2.1

---
 gradle.properties           | 2 +-
 tests/kafkatest/__init__.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/gradle.properties b/gradle.properties
index 5da0832a01b0e..bb92f80ab5513 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -16,7 +16,7 @@
 group=org.apache.kafka
 # NOTE: When you change this version number, you should also make sure to update
 # the version numbers in tests/kafkatest/__init__.py and kafka-merge-pr.py.
-version=0.10.2.1-SNAPSHOT
+version=0.10.2.1
 scalaVersion=2.10.6
 task=build
 org.gradle.jvmargs=-XX:MaxPermSize=512m -Xmx1024m -Xss2m
diff --git a/tests/kafkatest/__init__.py b/tests/kafkatest/__init__.py
index 06e446ef3569f..d6abd3f2a191f 100644
--- a/tests/kafkatest/__init__.py
+++ b/tests/kafkatest/__init__.py
@@ -22,4 +22,4 @@
 # Instead, in development branches, the version should have a suffix of the form ".devN"
 #
 # For example, when Kafka is at version 0.9.0.0-SNAPSHOT, this should be something like "0.9.0.0.dev0"
-__version__ = '0.10.2.1.dev0'
+__version__ = '0.10.2.1'

From 7ba26ef14eab295a0216d076741a1f3893ddfbf0 Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno.thereska@gmail.com>
Date: Mon, 24 Apr 2017 09:50:15 -0700
Subject: [PATCH 173/177] KAFKA-4755: Cherry-pick streams tests fixes from
 trunk

This addresses some tests' instabilities in 0.10.2 that have been fixed in trunk

Author: Eno Thereska <eno.thereska@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2867 from enothereska/minor-performance-cherrypick-0.10.2
---
 .../kafka/streams/perf/SimpleBenchmark.java   | 515 +++++++++++-------
 .../streams/streams_simple_benchmark_test.py  |  89 ++-
 .../performance/streams_performance.py        |  10 +-
 tests/kafkatest/services/streams.py           |  10 +-
 4 files changed, 407 insertions(+), 217 deletions(-)

diff --git a/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java b/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java
index 7a10b79c10a00..55d9c68031876 100644
--- a/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java
+++ b/streams/src/test/java/org/apache/kafka/streams/perf/SimpleBenchmark.java
@@ -14,7 +14,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-
 package org.apache.kafka.streams.perf;
 
 import org.apache.kafka.clients.consumer.ConsumerConfig;
@@ -51,18 +50,38 @@
 import java.io.File;
 import java.util.ArrayList;
 import java.util.List;
+import java.util.Locale;
 import java.util.concurrent.CountDownLatch;
 import java.util.Properties;
 import java.util.Random;
+import java.util.concurrent.TimeUnit;
 
+/**
+ * Class that provides support for a series of benchmarks. It is usually driven by
+ * tests/kafkatest/benchmarks/streams/streams_simple_benchmark_test.py.
+ * If ran manually through the main() function below, you must do the following:
+ * 1. Have ZK and a Kafka broker set up
+ * 2. Run the loading step first: SimpleBenchmark localhost:9092 /tmp/statedir numRecords true "all"
+ * 3. Run the stream processing step second: SimpleBenchmark localhost:9092 /tmp/statedir numRecords false "all"
+ * Note that what changed is the 4th parameter, from "true" indicating that is a load phase, to "false" indicating
+ * that this is a real run.
+ *
+ * Note that "all" is a convenience option when running this test locally and will not work when running the test
+ * at scale (through tests/kafkatest/benchmarks/streams/streams_simple_benchmark_test.py). That is due to exact syncronization
+ * needs for each test (e.g., you wouldn't want one instance to run "count" while another
+ * is still running "consume"
+ */
 public class SimpleBenchmark {
 
     private final String kafka;
     private final File stateDir;
-
+    private final Boolean loadPhase;
+    private final String testName;
+    private static final String ALL_TESTS = "all";
     private static final String SOURCE_TOPIC = "simpleBenchmarkSourceTopic";
     private static final String SINK_TOPIC = "simpleBenchmarkSinkTopic";
 
+    private static final String COUNT_TOPIC = "countTopic";
     private static final String JOIN_TOPIC_1_PREFIX = "joinSourceTopic1";
     private static final String JOIN_TOPIC_2_PREFIX = "joinSourceTopic2";
     private static final ValueJoiner VALUE_JOINER = new ValueJoiner<byte[], byte[], byte[]>() {
@@ -83,25 +102,90 @@ public byte[] apply(final byte[] value1, final byte[] value2) {
     };
 
     private static int numRecords;
-    private static Integer endKey;
-    private static final int KEY_SIZE = 8;
+    private static int processedRecords = 0;
+    private static long processedBytes = 0;
     private static final int VALUE_SIZE = 100;
-    private static final int RECORD_SIZE = KEY_SIZE + VALUE_SIZE;
+    private static final long POLL_MS = 500L;
+    private static final int MAX_POLL_RECORDS = 1000;
+    private static final int SOCKET_SIZE_BYTES = 1 * 1024 * 1024;
 
     private static final Serde<byte[]> BYTE_SERDE = Serdes.ByteArray();
     private static final Serde<Integer> INTEGER_SERDE = Serdes.Integer();
 
-    public SimpleBenchmark(File stateDir, String kafka) {
+    public SimpleBenchmark(final File stateDir, final String kafka, final Boolean loadPhase, final String testName) {
         super();
         this.stateDir = stateDir;
         this.kafka = kafka;
+        this.loadPhase = loadPhase;
+        this.testName = testName;
+    }
+
+    private void run() throws Exception {
+        switch (testName) {
+            case ALL_TESTS:
+                // producer performance
+                produce(SOURCE_TOPIC);
+                // consumer performance
+                consume(SOURCE_TOPIC);
+                // simple stream performance source->process
+                processStream(SOURCE_TOPIC);
+                // simple stream performance source->sink
+                processStreamWithSink(SOURCE_TOPIC);
+                // simple stream performance source->store
+                processStreamWithStateStore(SOURCE_TOPIC);
+                // simple stream performance source->cache->store
+                processStreamWithCachedStateStore(SOURCE_TOPIC);
+                // simple aggregation
+                count(COUNT_TOPIC);
+                // simple streams performance KSTREAM-KTABLE join
+                kStreamKTableJoin(JOIN_TOPIC_1_PREFIX + "KStreamKTable", JOIN_TOPIC_2_PREFIX + "KStreamKTable");
+                // simple streams performance KSTREAM-KSTREAM join
+                kStreamKStreamJoin(JOIN_TOPIC_1_PREFIX + "KStreamKStream", JOIN_TOPIC_2_PREFIX + "KStreamKStream");
+                // simple streams performance KTABLE-KTABLE join
+                kTableKTableJoin(JOIN_TOPIC_1_PREFIX + "KTableKTable", JOIN_TOPIC_2_PREFIX + "KTableKTable");
+                break;
+            case "produce":
+                produce(SOURCE_TOPIC);
+                break;
+            case "consume":
+                consume(SOURCE_TOPIC);
+                break;
+            case "count":
+                count(COUNT_TOPIC);
+                break;
+            case "processstream":
+                processStream(SOURCE_TOPIC);
+                break;
+            case "processstreamwithsink":
+                processStreamWithSink(SOURCE_TOPIC);
+                break;
+            case "processstreamwithstatestore":
+                processStreamWithStateStore(SOURCE_TOPIC);
+                break;
+            case "processstreamwithcachedstatestore":
+                processStreamWithCachedStateStore(SOURCE_TOPIC);
+                break;
+            case "kstreamktablejoin":
+                kStreamKTableJoin(JOIN_TOPIC_1_PREFIX + "KStreamKTable", JOIN_TOPIC_2_PREFIX + "KStreamKTable");
+                break;
+            case "kstreamkstreamjoin":
+                kStreamKStreamJoin(JOIN_TOPIC_1_PREFIX + "KStreamKStream", JOIN_TOPIC_2_PREFIX + "KStreamKStream");
+                break;
+            case "ktablektablejoin":
+                kTableKTableJoin(JOIN_TOPIC_1_PREFIX + "KTableKTable", JOIN_TOPIC_2_PREFIX + "KTableKTable");
+                break;
+            default:
+                throw new Exception("Unknown test name " + testName);
+
+        }
     }
 
     public static void main(String[] args) throws Exception {
         String kafka = args.length > 0 ? args[0] : "localhost:9092";
         String stateDirStr = args.length > 1 ? args[1] : TestUtils.tempDirectory().getAbsolutePath();
         numRecords = args.length > 2 ? Integer.parseInt(args[2]) : 10000000;
-        endKey = numRecords - 1;
+        boolean loadPhase = args.length > 3 ? Boolean.parseBoolean(args[3]) : false;
+        String testName = args.length > 4 ? args[4].toLowerCase(Locale.ROOT) : ALL_TESTS;
 
         final File stateDir = new File(stateDirStr);
         stateDir.mkdir();
@@ -113,60 +197,117 @@ public static void main(String[] args) throws Exception {
         System.out.println("kafka=" + kafka);
         System.out.println("stateDir=" + stateDir);
         System.out.println("numRecords=" + numRecords);
+        System.out.println("loadPhase=" + loadPhase);
+        System.out.println("testName=" + testName);
+
+        SimpleBenchmark benchmark = new SimpleBenchmark(stateDir, kafka, loadPhase, testName);
+        benchmark.run();
+    }
 
-        SimpleBenchmark benchmark = new SimpleBenchmark(stateDir, kafka);
-
-        // producer performance
-        benchmark.produce(SOURCE_TOPIC, VALUE_SIZE, "simple-benchmark-produce", numRecords, true, numRecords, true);
-        // consumer performance
-        benchmark.consume(SOURCE_TOPIC);
-        // simple stream performance source->process
-        benchmark.processStream(SOURCE_TOPIC);
-        // simple stream performance source->sink
-        benchmark.processStreamWithSink(SOURCE_TOPIC);
-        // simple stream performance source->store
-        benchmark.processStreamWithStateStore(SOURCE_TOPIC);
-        // simple stream performance source->cache->store
-        benchmark.processStreamWithCachedStateStore(SOURCE_TOPIC);
-        // simple streams performance KSTREAM-KTABLE join
-        benchmark.kStreamKTableJoin(JOIN_TOPIC_1_PREFIX + "KStreamKTable", JOIN_TOPIC_2_PREFIX + "KStreamKTable");
-        // simple streams performance KSTREAM-KSTREAM join
-        benchmark.kStreamKStreamJoin(JOIN_TOPIC_1_PREFIX + "KStreamKStream", JOIN_TOPIC_2_PREFIX + "KStreamKStream");
-        // simple streams performance KTABLE-KTABLE join
-        benchmark.kTableKTableJoin(JOIN_TOPIC_1_PREFIX + "KTableKTable", JOIN_TOPIC_2_PREFIX + "KTableKTable");
-    }
-
-    private Properties setJoinProperties(final String applicationId) {
+    private Properties setStreamProperties(final String applicationId) {
         Properties props = new Properties();
         props.put(StreamsConfig.APPLICATION_ID_CONFIG, applicationId);
         props.put(StreamsConfig.STATE_DIR_CONFIG, stateDir.toString());
         props.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, kafka);
         props.put(StreamsConfig.NUM_STREAM_THREADS_CONFIG, 1);
         props.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
+        // the socket buffer needs to be large, especially when running in AWS with
+        // high latency. if running locally the default is fine.
+        props.put(ConsumerConfig.RECEIVE_BUFFER_CONFIG, SOCKET_SIZE_BYTES);
         props.put(StreamsConfig.KEY_SERDE_CLASS_CONFIG, Serdes.Integer().getClass());
         props.put(StreamsConfig.VALUE_SERDE_CLASS_CONFIG, Serdes.ByteArray().getClass());
+        props.put(ConsumerConfig.MAX_POLL_RECORDS_CONFIG, MAX_POLL_RECORDS);
+        props.put(StreamsConfig.POLL_MS_CONFIG, POLL_MS);
         return props;
     }
 
+    private Properties setProduceConsumeProperties(final String clientId) {
+        Properties props = new Properties();
+        props.put(ProducerConfig.CLIENT_ID_CONFIG, clientId);
+        props.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, kafka);
+        props.put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, IntegerSerializer.class);
+        props.put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, ByteArraySerializer.class);
+        // the socket buffer needs to be large, especially when running in AWS with
+        // high latency. if running locally the default is fine.
+        props.put(ProducerConfig.SEND_BUFFER_CONFIG, SOCKET_SIZE_BYTES);
+        props.put(ConsumerConfig.KEY_DESERIALIZER_CLASS_CONFIG, IntegerDeserializer.class);
+        props.put(ConsumerConfig.VALUE_DESERIALIZER_CLASS_CONFIG, ByteArrayDeserializer.class);
+        props.put(ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG, "false");
+        // the socket buffer needs to be large, especially when running in AWS with
+        // high latency. if running locally the default is fine.
+        props.put(ConsumerConfig.RECEIVE_BUFFER_CONFIG, SOCKET_SIZE_BYTES);
+        props.put(ConsumerConfig.MAX_POLL_RECORDS_CONFIG, MAX_POLL_RECORDS);
+        return props;
+    }
+
+    private boolean maybeSetupPhase(final String topic, final String clientId,
+                                    final boolean skipIfAllTests) throws Exception {
+        processedRecords = 0;
+        processedBytes = 0;
+        // initialize topics
+        if (loadPhase) {
+            if (skipIfAllTests) {
+                // if we run all tests, the produce test will have already loaded the data
+                if (testName.equals(ALL_TESTS)) {
+                    // Skipping loading phase since previously loaded
+                    return true;
+                }
+            }
+            System.out.println("Initializing topic " + topic);
+            // WARNING: The keys must be sequential, i.e., unique, otherwise the logic for when this test
+            // stops will not work (in createCountStreams)
+            produce(topic, VALUE_SIZE, clientId, numRecords, true, numRecords, false);
+            return true;
+        }
+        return false;
+    }
+
+    private KafkaStreams createCountStreams(Properties streamConfig, String topic, final CountDownLatch latch) {
+        final KStreamBuilder builder = new KStreamBuilder();
+        final KStream<Integer, byte[]> input = builder.stream(topic);
+
+        input.groupByKey()
+            .count("tmpStoreName").foreach(new CountDownAction(latch));
+
+        return new KafkaStreams(builder, streamConfig);
+    }
+
+    /**
+     * Measure the performance of a simple aggregate like count.
+     * Counts the occurrence of numbers (note that normally people count words, this
+     * example counts numbers)
+     * @param countTopic Topic where numbers are stored
+     * @throws Exception
+     */
+    public void count(String countTopic) throws Exception {
+        if (maybeSetupPhase(countTopic, "simple-benchmark-produce-count", false)) {
+            return;
+        }
+
+        CountDownLatch latch = new CountDownLatch(1);
+        Properties props = setStreamProperties("simple-benchmark-count");
+        final KafkaStreams streams = createCountStreams(props, countTopic, latch);
+        runGenericBenchmark(streams, "Streams Count Performance [records/latency/rec-sec/MB-sec counted]: ", latch);
+    }
+
     /**
      * Measure the performance of a KStream-KTable left join. The setup is such that each
      * KStream record joins to exactly one element in the KTable
      */
     public void kStreamKTableJoin(String kStreamTopic, String kTableTopic) throws Exception {
-        CountDownLatch latch = new CountDownLatch(numRecords);
+        if (maybeSetupPhase(kStreamTopic, "simple-benchmark-produce-kstream", false)) {
+            maybeSetupPhase(kTableTopic, "simple-benchmark-produce-ktable", false);
+            return;
+        }
 
-        // initialize topics
-        System.out.println("Initializing kStreamTopic " + kStreamTopic);
-        produce(kStreamTopic, VALUE_SIZE, "simple-benchmark-produce-kstream", numRecords, false, numRecords, false);
-        System.out.println("Initializing kTableTopic " + kTableTopic);
-        produce(kTableTopic, VALUE_SIZE, "simple-benchmark-produce-ktable", numRecords, true, numRecords, false);
+        CountDownLatch latch = new CountDownLatch(1);
 
         // setup join
-        Properties props = setJoinProperties("simple-benchmark-kstream-ktable-join");
+        Properties props = setStreamProperties("simple-benchmark-kstream-ktable-join");
         final KafkaStreams streams = createKafkaStreamsKStreamKTableJoin(props, kStreamTopic, kTableTopic, latch);
 
         // run benchmark
-        runJoinBenchmark(streams, "Streams KStreamKTable LeftJoin Performance [MB/s joined]: ", latch);
+        runGenericBenchmark(streams, "Streams KStreamKTable LeftJoin Performance [records/latency/rec-sec/MB-sec joined]: ", latch);
     }
 
     /**
@@ -174,20 +315,19 @@ public void kStreamKTableJoin(String kStreamTopic, String kTableTopic) throws Ex
      * KStream record joins to exactly one element in the other KStream
      */
     public void kStreamKStreamJoin(String kStreamTopic1, String kStreamTopic2) throws Exception {
-        CountDownLatch latch = new CountDownLatch(numRecords);
+        if (maybeSetupPhase(kStreamTopic1, "simple-benchmark-produce-kstream-topic1", false)) {
+            maybeSetupPhase(kStreamTopic2, "simple-benchmark-produce-kstream-topic2", false);
+            return;
+        }
 
-        // initialize topics
-        System.out.println("Initializing kStreamTopic " + kStreamTopic1);
-        produce(kStreamTopic1, VALUE_SIZE, "simple-benchmark-produce-kstream-topic1", numRecords, true, numRecords, false);
-        System.out.println("Initializing kStreamTopic " + kStreamTopic2);
-        produce(kStreamTopic2, VALUE_SIZE, "simple-benchmark-produce-kstream-topic2", numRecords, true, numRecords, false);
+        CountDownLatch latch = new CountDownLatch(1);
 
         // setup join
-        Properties props = setJoinProperties("simple-benchmark-kstream-kstream-join");
+        Properties props = setStreamProperties("simple-benchmark-kstream-kstream-join");
         final KafkaStreams streams = createKafkaStreamsKStreamKStreamJoin(props, kStreamTopic1, kStreamTopic2, latch);
 
         // run benchmark
-        runJoinBenchmark(streams, "Streams KStreamKStream LeftJoin Performance [MB/s joined]: ", latch);
+        runGenericBenchmark(streams, "Streams KStreamKStream LeftJoin Performance [records/latency/rec-sec/MB-sec  joined]: ", latch);
     }
 
     /**
@@ -195,23 +335,29 @@ public void kStreamKStreamJoin(String kStreamTopic1, String kStreamTopic2) throw
      * KTable record joins to exactly one element in the other KTable
      */
     public void kTableKTableJoin(String kTableTopic1, String kTableTopic2) throws Exception {
-        CountDownLatch latch = new CountDownLatch(numRecords);
-
-        // initialize topics
-        System.out.println("Initializing kTableTopic " + kTableTopic1);
-        produce(kTableTopic1, VALUE_SIZE, "simple-benchmark-produce-ktable-topic1", numRecords, true, numRecords, false);
-        System.out.println("Initializing kTableTopic " + kTableTopic2);
-        produce(kTableTopic2, VALUE_SIZE, "simple-benchmark-produce-ktable-topic2", numRecords, true, numRecords, false);
+        if (maybeSetupPhase(kTableTopic1, "simple-benchmark-produce-ktable-topic1", false)) {
+            maybeSetupPhase(kTableTopic2, "simple-benchmark-produce-ktable-topic2", false);
+            return;
+        }
+        CountDownLatch latch = new CountDownLatch(1);
 
         // setup join
-        Properties props = setJoinProperties("simple-benchmark-ktable-ktable-join");
+        Properties props = setStreamProperties("simple-benchmark-ktable-ktable-join");
         final KafkaStreams streams = createKafkaStreamsKTableKTableJoin(props, kTableTopic1, kTableTopic2, latch);
 
         // run benchmark
-        runJoinBenchmark(streams, "Streams KTableKTable LeftJoin Performance [MB/s joined]: ", latch);
+        runGenericBenchmark(streams, "Streams KTableKTable LeftJoin Performance [records/latency/rec-sec/MB-sec joined]: ", latch);
     }
 
-    private void runJoinBenchmark(final KafkaStreams streams, final String nameOfBenchmark, final CountDownLatch latch) {
+    private void printResults(final String nameOfBenchmark, final long latency) {
+        System.out.println(nameOfBenchmark +
+            processedRecords + "/" +
+            latency + "/" +
+            recordsPerSec(latency, processedRecords) + "/" +
+            megabytesPerSec(latency, processedBytes));
+    }
+
+    private void runGenericBenchmark(final KafkaStreams streams, final String nameOfBenchmark, final CountDownLatch latch) {
         streams.start();
 
         long startTime = System.currentTimeMillis();
@@ -224,20 +370,12 @@ private void runJoinBenchmark(final KafkaStreams streams, final String nameOfBen
             }
         }
         long endTime = System.currentTimeMillis();
-
-
-        System.out.println(nameOfBenchmark + megaBytePerSec(endTime - startTime, numRecords, KEY_SIZE + VALUE_SIZE));
+        printResults(nameOfBenchmark, endTime - startTime);
 
         streams.close();
     }
 
-
-
-    public void processStream(String topic) {
-        CountDownLatch latch = new CountDownLatch(1);
-
-        final KafkaStreams streams = createKafkaStreams(topic, stateDir, kafka, latch);
-
+    private long startStreamsThread(final KafkaStreams streams, final CountDownLatch latch) throws Exception {
         Thread thread = new Thread() {
             public void run() {
                 streams.start();
@@ -257,96 +395,72 @@ public void run() {
 
         long endTime = System.currentTimeMillis();
 
-        System.out.println("Streams Performance [MB/sec read]: " + megaBytePerSec(endTime - startTime));
-
         streams.close();
         try {
             thread.join();
         } catch (Exception ex) {
             // ignore
         }
+
+        return endTime - startTime;
     }
 
-    public void processStreamWithSink(String topic) {
-        CountDownLatch latch = new CountDownLatch(1);
+    public void processStream(final String topic) throws Exception {
+        if (maybeSetupPhase(topic, "simple-benchmark-process-stream-load", true)) {
+            return;
+        }
 
-        final KafkaStreams streams = createKafkaStreamsWithSink(topic, stateDir, kafka, latch);
+        CountDownLatch latch = new CountDownLatch(1);
 
-        Thread thread = new Thread() {
-            public void run() {
-                streams.start();
-            }
-        };
-        thread.start();
+        final KafkaStreams streams = createKafkaStreams(topic, latch);
+        long latency = startStreamsThread(streams, latch);
 
-        long startTime = System.currentTimeMillis();
+        printResults("Streams Performance [records/latency/rec-sec/MB-sec source]: ", latency);
+    }
 
-        while (latch.getCount() > 0) {
-            try {
-                latch.await();
-            } catch (InterruptedException ex) {
-                Thread.interrupted();
-            }
+    public void processStreamWithSink(String topic) throws Exception {
+        if (maybeSetupPhase(topic, "simple-benchmark-process-stream-with-sink-load", true)) {
+            return;
         }
 
-        long endTime = System.currentTimeMillis();
+        CountDownLatch latch = new CountDownLatch(1);
+        final KafkaStreams streams = createKafkaStreamsWithSink(topic, latch);
+        long latency = startStreamsThread(streams, latch);
 
-        System.out.println("Streams Performance [MB/sec read+write]: " + megaBytePerSec(endTime - startTime));
+        printResults("Streams Performance [records/latency/rec-sec/MB-sec source+sink]: ", latency);
 
-        streams.close();
-        try {
-            thread.join();
-        } catch (Exception ex) {
-            // ignore
-        }
     }
 
-    private void internalProcessStreamWithStore(final KafkaStreams streams, final CountDownLatch latch,
-                                                final String message) {
-        Thread thread = new Thread() {
-            public void run() {
-                streams.start();
-            }
-        };
-        thread.start();
-
-        long startTime = System.currentTimeMillis();
-
-        while (latch.getCount() > 0) {
-            try {
-                latch.await();
-            } catch (InterruptedException ex) {
-                Thread.interrupted();
-            }
+    public void processStreamWithStateStore(String topic) throws Exception {
+        if (maybeSetupPhase(topic, "simple-benchmark-process-stream-with-state-store-load", true)) {
+            return;
         }
 
-        long endTime = System.currentTimeMillis();
-
-        System.out.println(message + megaBytePerSec(endTime - startTime));
-
-        streams.close();
-        try {
-            thread.join();
-        } catch (Exception ex) {
-            // ignore
-        }
-    }
-    public void processStreamWithStateStore(String topic) {
         CountDownLatch latch = new CountDownLatch(1);
-
-        final KafkaStreams streams = createKafkaStreamsWithStateStore(topic, stateDir, kafka, latch, false);
-        internalProcessStreamWithStore(streams, latch, "Streams Performance [MB/sec read+store]: ");
+        final KafkaStreams streams = createKafkaStreamsWithStateStore(topic, latch, false);
+        long latency = startStreamsThread(streams, latch);
+        printResults("Streams Performance [records/latency/rec-sec/MB-sec source+store]: ", latency);
 
     }
 
-    public void processStreamWithCachedStateStore(String topic) {
-        CountDownLatch latch = new CountDownLatch(1);
-
-        final KafkaStreams streams = createKafkaStreamsWithStateStore(topic, stateDir, kafka, latch, true);
+    public void processStreamWithCachedStateStore(String topic) throws Exception {
+        if (maybeSetupPhase(topic, "simple-benchmark-process-stream-with-cached-state-store-load", true)) {
+            return;
+        }
 
-        internalProcessStreamWithStore(streams, latch, "Streams Performance [MB/sec read+cache+store]: ");
+        CountDownLatch latch = new CountDownLatch(1);
+        final KafkaStreams streams = createKafkaStreamsWithStateStore(topic, latch, true);
+        long latency = startStreamsThread(streams, latch);
+        printResults("Streams Performance [records/latency/rec-sec/MB-sec source+cache+store]: ", latency);
     }
 
+    public void produce(String topic) throws Exception {
+        // loading phase does not make sense for producer
+        if (loadPhase) {
+            return;
+        }
+        produce(topic, VALUE_SIZE, "simple-benchmark-produce", numRecords, true, numRecords, true);
+    }
     /**
      * Produce values to a topic
      * @param topic Topic to produce to
@@ -358,22 +472,28 @@ public void processStreamWithCachedStateStore(String topic) {
      * @param printStats if True, print stats on how long producing took. If False, don't print stats. False can be used
      *                   when this produce step is part of another benchmark that produces its own stats
      */
-    public void produce(String topic, int valueSizeBytes, String clientId, int numRecords, boolean sequential,
-                        int upperRange, boolean printStats) throws Exception {
+    private void produce(String topic, int valueSizeBytes, String clientId, int numRecords, boolean sequential,
+                         int upperRange, boolean printStats) throws Exception {
 
+        processedRecords = 0;
+        processedBytes = 0;
         if (sequential) {
             if (upperRange < numRecords) throw new Exception("UpperRange must be >= numRecords");
         }
-        Properties props = new Properties();
-        props.put(ProducerConfig.CLIENT_ID_CONFIG, clientId);
-        props.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, kafka);
-        props.put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, IntegerSerializer.class);
-        props.put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, ByteArraySerializer.class);
+        if (!sequential) {
+            System.out.println("WARNING: You are using non-sequential keys. If your tests' exit logic expects to see a final key, random keys may not work.");
+        }
+        Properties props = setProduceConsumeProperties(clientId);
+
         int key = 0;
         Random rand = new Random();
         KafkaProducer<Integer, byte[]> producer = new KafkaProducer<>(props);
 
         byte[] value = new byte[valueSizeBytes];
+        // put some random values to increase entropy. Some devices
+        // like SSDs do compression and if the array is all zeros
+        // the performance will be too good.
+        new Random().nextBytes(value);
         long startTime = System.currentTimeMillis();
 
         if (sequential) key = 0;
@@ -382,22 +502,24 @@ public void produce(String topic, int valueSizeBytes, String clientId, int numRe
             producer.send(new ProducerRecord<>(topic, key, value));
             if (sequential) key++;
             else key = rand.nextInt(upperRange);
+            processedRecords++;
+            processedBytes += value.length + Integer.SIZE;
         }
         producer.close();
 
         long endTime = System.currentTimeMillis();
 
-        if (printStats)
-            System.out.println("Producer Performance [MB/sec write]: " + megaBytePerSec(endTime - startTime, numRecords, KEY_SIZE + valueSizeBytes));
+        if (printStats) {
+            printResults("Producer Performance [records/latency/rec-sec/MB-sec write]: ", endTime - startTime);
+        }
     }
 
-    public void consume(String topic) {
-        Properties props = new Properties();
-        props.put(ConsumerConfig.CLIENT_ID_CONFIG, "simple-benchmark-consumer");
-        props.put(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG, kafka);
-        props.put(ConsumerConfig.KEY_DESERIALIZER_CLASS_CONFIG, IntegerDeserializer.class);
-        props.put(ConsumerConfig.VALUE_DESERIALIZER_CLASS_CONFIG, ByteArrayDeserializer.class);
-        props.put(ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG, "false");
+    public void consume(String topic) throws Exception {
+        if (maybeSetupPhase(topic, "simple-benchmark-consumer-load", true)) {
+            return;
+        }
+
+        Properties props = setProduceConsumeProperties("simple-benchmark-consumer");
 
         KafkaConsumer<Integer, byte[]> consumer = new KafkaConsumer<>(props);
 
@@ -410,33 +532,33 @@ public void consume(String topic) {
         long startTime = System.currentTimeMillis();
 
         while (true) {
-            ConsumerRecords<Integer, byte[]> records = consumer.poll(500);
+            ConsumerRecords<Integer, byte[]> records = consumer.poll(POLL_MS);
             if (records.isEmpty()) {
-                if (endKey.equals(key))
+                if (processedRecords == numRecords)
                     break;
             } else {
                 for (ConsumerRecord<Integer, byte[]> record : records) {
+                    processedRecords++;
+                    processedBytes += record.value().length + Integer.SIZE;
                     Integer recKey = record.key();
-
                     if (key == null || key < recKey)
                         key = recKey;
+                    if (processedRecords == numRecords)
+                        break;
                 }
             }
+            if (processedRecords == numRecords)
+                break;
         }
 
         long endTime = System.currentTimeMillis();
 
         consumer.close();
-        System.out.println("Consumer Performance [MB/sec read]: " + megaBytePerSec(endTime - startTime));
+        printResults("Consumer Performance [records/latency/rec-sec/MB-sec read]: ", endTime - startTime);
     }
 
-    private KafkaStreams createKafkaStreams(String topic, File stateDir, String kafka, final CountDownLatch latch) {
-        Properties props = new Properties();
-        props.put(StreamsConfig.APPLICATION_ID_CONFIG, "simple-benchmark-streams");
-        props.put(StreamsConfig.STATE_DIR_CONFIG, stateDir.toString());
-        props.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, kafka);
-        props.put(StreamsConfig.NUM_STREAM_THREADS_CONFIG, 1);
-        props.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
+    private KafkaStreams createKafkaStreams(String topic, final CountDownLatch latch) {
+        Properties props = setStreamProperties("simple-benchmark-streams");
 
         KStreamBuilder builder = new KStreamBuilder();
 
@@ -453,7 +575,9 @@ public void init(ProcessorContext context) {
 
                     @Override
                     public void process(Integer key, byte[] value) {
-                        if (endKey.equals(key)) {
+                        processedRecords++;
+                        processedBytes += value.length + Integer.SIZE;
+                        if (processedRecords == numRecords) {
                             latch.countDown();
                         }
                     }
@@ -469,16 +593,11 @@ public void close() {
             }
         });
 
-        return new KafkaStreams(builder, props);
+        return createKafkaStreamsWithExceptionHandler(builder, props);
     }
 
-    private KafkaStreams createKafkaStreamsWithSink(String topic, File stateDir, String kafka, final CountDownLatch latch) {
-        Properties props = new Properties();
-        props.put(StreamsConfig.APPLICATION_ID_CONFIG, "simple-benchmark-streams-with-sink");
-        props.put(StreamsConfig.STATE_DIR_CONFIG, stateDir.toString());
-        props.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, kafka);
-        props.put(StreamsConfig.NUM_STREAM_THREADS_CONFIG, 1);
-        props.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
+    private KafkaStreams createKafkaStreamsWithSink(String topic, final CountDownLatch latch) {
+        final Properties props = setStreamProperties("simple-benchmark-streams-with-sink");
 
         KStreamBuilder builder = new KStreamBuilder();
 
@@ -495,7 +614,9 @@ public void init(ProcessorContext context) {
 
                     @Override
                     public void process(Integer key, byte[] value) {
-                        if (endKey.equals(key)) {
+                        processedRecords++;
+                        processedBytes += value.length + Integer.SIZE;
+                        if (processedRecords == numRecords) {
                             latch.countDown();
                         }
                     }
@@ -511,17 +632,27 @@ public void close() {
             }
         });
 
-        return new KafkaStreams(builder, props);
+        return createKafkaStreamsWithExceptionHandler(builder, props);
     }
 
-    private class CountDownAction<K, V> implements ForeachAction<K, V> {
+    private class CountDownAction<V> implements ForeachAction<Integer, V> {
         private CountDownLatch latch;
         CountDownAction(final CountDownLatch latch) {
             this.latch = latch;
         }
         @Override
-        public void apply(K key, V value) {
-            this.latch.countDown();
+        public void apply(Integer key, V value) {
+            processedRecords++;
+            if (value instanceof byte[]) {
+                processedBytes += ((byte[]) value).length + Integer.SIZE;
+            } else if (value instanceof Long) {
+                processedBytes += Long.SIZE + Integer.SIZE;
+            } else {
+                System.err.println("Unknown value type in CountDownAction");
+            }
+            if (processedRecords == numRecords) {
+                this.latch.countDown();
+            }
         }
     }
 
@@ -534,7 +665,7 @@ private KafkaStreams createKafkaStreamsKStreamKTableJoin(Properties streamConfig
 
         input1.leftJoin(input2, VALUE_JOINER).foreach(new CountDownAction(latch));
 
-        return new KafkaStreams(builder, streamConfig);
+        return createKafkaStreamsWithExceptionHandler(builder, streamConfig);
     }
 
     private KafkaStreams createKafkaStreamsKTableKTableJoin(Properties streamConfig, String kTableTopic1,
@@ -546,7 +677,7 @@ private KafkaStreams createKafkaStreamsKTableKTableJoin(Properties streamConfig,
 
         input1.leftJoin(input2, VALUE_JOINER).foreach(new CountDownAction(latch));
 
-        return new KafkaStreams(builder, streamConfig);
+        return createKafkaStreamsWithExceptionHandler(builder, streamConfig);
     }
 
     private KafkaStreams createKafkaStreamsKStreamKStreamJoin(Properties streamConfig, String kStreamTopic1,
@@ -559,18 +690,13 @@ private KafkaStreams createKafkaStreamsKStreamKStreamJoin(Properties streamConfi
 
         input1.leftJoin(input2, VALUE_JOINER, JoinWindows.of(timeDifferenceMs)).foreach(new CountDownAction(latch));
 
-        return new KafkaStreams(builder, streamConfig);
+        return createKafkaStreamsWithExceptionHandler(builder, streamConfig);
     }
 
-    private KafkaStreams createKafkaStreamsWithStateStore(String topic, File stateDir, String kafka,
+    private KafkaStreams createKafkaStreamsWithStateStore(String topic,
                                                           final CountDownLatch latch,
                                                           boolean enableCaching) {
-        Properties props = new Properties();
-        props.put(StreamsConfig.APPLICATION_ID_CONFIG, "simple-benchmark-streams-with-store" + enableCaching);
-        props.put(StreamsConfig.STATE_DIR_CONFIG, stateDir.toString());
-        props.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, kafka);
-        props.put(StreamsConfig.NUM_STREAM_THREADS_CONFIG, 1);
-        props.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
+        Properties props = setStreamProperties("simple-benchmark-streams-with-store" + enableCaching);
 
         KStreamBuilder builder = new KStreamBuilder();
 
@@ -596,8 +722,9 @@ public void init(ProcessorContext context) {
                     @Override
                     public void process(Integer key, byte[] value) {
                         store.put(key, value);
-
-                        if (endKey.equals(key)) {
+                        processedRecords++;
+                        processedBytes += value.length + Integer.SIZE;
+                        if (processedRecords == numRecords) {
                             latch.countDown();
                         }
                     }
@@ -613,15 +740,29 @@ public void close() {
             }
         }, "store");
 
-        return new KafkaStreams(builder, props);
+        return createKafkaStreamsWithExceptionHandler(builder, props);
     }
 
-    private double megaBytePerSec(long time) {
-        return (double) (RECORD_SIZE * numRecords / 1024 / 1024) / ((double) time / 1000);
+    private KafkaStreams createKafkaStreamsWithExceptionHandler(final KStreamBuilder builder, final Properties props) {
+        final KafkaStreams streamsClient = new KafkaStreams(builder, props);
+        streamsClient.setUncaughtExceptionHandler(new Thread.UncaughtExceptionHandler() {
+            @Override
+            public void uncaughtException(Thread t, Throwable e) {
+                System.out.println("FATAL: An unexpected exception is encountered on thread " + t + ": " + e);
+
+                streamsClient.close(30, TimeUnit.SECONDS);
+            }
+        });
+
+        return streamsClient;
+    }
+    
+    private double megabytesPerSec(long time, long processedBytes) {
+        return  (processedBytes / 1024.0 / 1024.0) / (time / 1000.0);
     }
 
-    private double megaBytePerSec(long time, int numRecords, int recordSizeBytes) {
-        return (double) (recordSizeBytes * numRecords / 1024 / 1024) / ((double) time / 1000);
+    private double recordsPerSec(long time, int numRecords) {
+        return numRecords / (time / 1000.0);
     }
 
     private List<TopicPartition> getAllPartitions(KafkaConsumer<?, ?> consumer, String... topics) {
diff --git a/tests/kafkatest/benchmarks/streams/streams_simple_benchmark_test.py b/tests/kafkatest/benchmarks/streams/streams_simple_benchmark_test.py
index ebd69a6597b49..a56def3ee49af 100644
--- a/tests/kafkatest/benchmarks/streams/streams_simple_benchmark_test.py
+++ b/tests/kafkatest/benchmarks/streams/streams_simple_benchmark_test.py
@@ -13,41 +13,86 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from ducktape.tests.test import Test
 from ducktape.mark.resource import cluster
-
+from ducktape.mark import parametrize, matrix
 from kafkatest.tests.kafka_test import KafkaTest
-from kafkatest.services.performance.streams_performance import StreamsSimpleBenchmarkService
 
+from kafkatest.services.performance.streams_performance import StreamsSimpleBenchmarkService
+from kafkatest.services.zookeeper import ZookeeperService
+from kafkatest.services.kafka import KafkaService
+from kafkatest.version import DEV_BRANCH
 
-class StreamsSimpleBenchmarkTest(KafkaTest):
+class StreamsSimpleBenchmarkTest(Test):
     """
     Simple benchmark of Kafka Streams.
     """
 
     def __init__(self, test_context):
-        super(StreamsSimpleBenchmarkTest, self).__init__(test_context, num_zk=1, num_brokers=1,topics={
-            'simpleBenchmarkSourceTopic' : { 'partitions': 1, 'replication-factor': 1 },
-            'simpleBenchmarkSinkTopic' : { 'partitions': 1, 'replication-factor': 1 },
-            'joinSourceTopic1KStreamKStream' : { 'partitions': 1, 'replication-factor': 1 },
-            'joinSourceTopic2KStreamKStream' : { 'partitions': 1, 'replication-factor': 1 },
-            'joinSourceTopic1KStreamKTable' : { 'partitions': 1, 'replication-factor': 1 },
-            'joinSourceTopic2KStreamKTable' : { 'partitions': 1, 'replication-factor': 1 },
-            'joinSourceTopic1KTableKTable' : { 'partitions': 1, 'replication-factor': 1 },
-            'joinSourceTopic2KTableKTable' : { 'partitions': 1, 'replication-factor': 1 }
-        })
+        super(StreamsSimpleBenchmarkTest, self).__init__(test_context)
+        self.num_records = 1000000L
+        self.replication = 1
 
-        self.driver = StreamsSimpleBenchmarkService(test_context, self.kafka, 1000000L)
 
-    @cluster(num_nodes=3)
-    def test_simple_benchmark(self):
+    @cluster(num_nodes=9)
+    @matrix(test=["produce", "consume", "count", "processstream", "processstreamwithsink", "processstreamwithstatestore", "processstreamwithcachedstatestore", "kstreamktablejoin", "kstreamkstreamjoin", "ktablektablejoin"], scale=[1, 3])
+    def test_simple_benchmark(self, test, scale):
         """
         Run simple Kafka Streams benchmark
         """
+        self.driver = [None] * (scale + 1)
+        node = [None] * (scale)
+        data = [None] * (scale)
+
+        #############
+        # SETUP PHASE
+        #############
+        self.zk = ZookeeperService(self.test_context, num_nodes=1)
+        self.zk.start()
+        self.kafka = KafkaService(self.test_context, num_nodes=scale, zk=self.zk, version=DEV_BRANCH, topics={
+            'simpleBenchmarkSourceTopic' : { 'partitions': scale, 'replication-factor': self.replication },
+            'countTopic' : { 'partitions': scale, 'replication-factor': self.replication },
+            'simpleBenchmarkSinkTopic' : { 'partitions': scale, 'replication-factor': self.replication },
+            'joinSourceTopic1KStreamKStream' : { 'partitions': scale, 'replication-factor': self.replication },
+            'joinSourceTopic2KStreamKStream' : { 'partitions': scale, 'replication-factor': self.replication },
+            'joinSourceTopic1KStreamKTable' : { 'partitions': scale, 'replication-factor': self.replication },
+            'joinSourceTopic2KStreamKTable' : { 'partitions': scale, 'replication-factor': self.replication },
+            'joinSourceTopic1KTableKTable' : { 'partitions': scale, 'replication-factor': self.replication },
+            'joinSourceTopic2KTableKTable' : { 'partitions': scale, 'replication-factor': self.replication }
+        })
+        self.kafka.start()
+ 
+        ################
+        # LOAD PHASE
+        ################
+        self.load_driver = StreamsSimpleBenchmarkService(self.test_context, self.kafka,
+                                                         self.num_records * scale, "true", test)
+        self.load_driver.start()
+        self.load_driver.wait()
+        self.load_driver.stop()
+
+        ################
+        # RUN PHASE
+        ################
+        for num in range(0, scale):
+            self.driver[num] = StreamsSimpleBenchmarkService(self.test_context, self.kafka,
+                                                             self.num_records/(scale), "false", test)
+            self.driver[num].start()
 
-        self.driver.start()
-        self.driver.wait()
-        self.driver.stop()
-        node = self.driver.node
-        node.account.ssh("grep Performance %s" % self.driver.STDOUT_FILE, allow_fail=False)
+        #######################
+        # STOP + COLLECT PHASE
+        #######################
+        for num in range(0, scale):    
+            self.driver[num].wait()    
+            self.driver[num].stop()
+            node[num] = self.driver[num].node
+            node[num].account.ssh("grep Performance %s" % self.driver[num].STDOUT_FILE, allow_fail=False)
+            data[num] = self.driver[num].collect_data(node[num], "" )
+                
 
-        return self.driver.collect_data(node)
+        final = {}
+        for num in range(0, scale):
+            for key in data[num]:
+                final[key + str(num)] = data[num][key]
+        
+        return final
diff --git a/tests/kafkatest/services/performance/streams_performance.py b/tests/kafkatest/services/performance/streams_performance.py
index 4ccc3b2943815..8cedb51a21892 100644
--- a/tests/kafkatest/services/performance/streams_performance.py
+++ b/tests/kafkatest/services/performance/streams_performance.py
@@ -22,17 +22,19 @@
 class StreamsSimpleBenchmarkService(StreamsTestBaseService):
     """Base class for simple Kafka Streams benchmark"""
 
-    def __init__(self, test_context, kafka, numrecs):
+    def __init__(self, test_context, kafka, numrecs, load_phase, test_name):
         super(StreamsSimpleBenchmarkService, self).__init__(test_context,
                                                             kafka,
                                                             "org.apache.kafka.streams.perf.SimpleBenchmark",
-                                                            numrecs)
+                                                            numrecs,
+                                                            load_phase,
+                                                            test_name)
 
-    def collect_data(self, node):
+    def collect_data(self, node, tag = None):
         # Collect the data and return it to the framework
         output = node.account.ssh_capture("grep Performance %s" % self.STDOUT_FILE)
         data = {}
         for line in output:
             parts = line.split(':')
-            data[parts[0]] = float(parts[1])
+            data[tag + parts[0]] = parts[1]
         return data
diff --git a/tests/kafkatest/services/streams.py b/tests/kafkatest/services/streams.py
index 8bc4d9ed9099c..e7be9475f79f8 100644
--- a/tests/kafkatest/services/streams.py
+++ b/tests/kafkatest/services/streams.py
@@ -45,11 +45,13 @@ class StreamsTestBaseService(KafkaPathResolverMixin, Service):
             "collect_default": True},
     }
 
-    def __init__(self, test_context, kafka, streams_class_name, user_test_args):
+    def __init__(self, test_context, kafka, streams_class_name, user_test_args, user_test_args1=None, user_test_args2=None):
         super(StreamsTestBaseService, self).__init__(test_context, 1)
         self.kafka = kafka
         self.args = {'streams_class_name': streams_class_name,
-                     'user_test_args': user_test_args}
+                     'user_test_args': user_test_args,
+                     'user_test_args1': user_test_args1,
+                     'user_test_args2': user_test_args2}
         self.log_level = "DEBUG"
 
     @property
@@ -75,7 +77,7 @@ def stop_node(self, node, clean_shutdown=True):
             node.account.signal(pid, sig, allow_fail=True)
         if clean_shutdown:
             for pid in pids:
-                wait_until(lambda: not node.account.alive(pid), timeout_sec=60, err_msg="Streams Test process on " + str(node.account) + " took too long to exit")
+                wait_until(lambda: not node.account.alive(pid), timeout_sec=120, err_msg="Streams Test process on " + str(node.account) + " took too long to exit")
 
         node.account.ssh("rm -f " + self.PID_FILE, allow_fail=False)
 
@@ -119,7 +121,7 @@ def start_cmd(self, node):
 
         cmd = "( export KAFKA_LOG4J_OPTS=\"-Dlog4j.configuration=file:%(log4j)s\"; " \
               "INCLUDE_TEST_JARS=true %(kafka_run_class)s %(streams_class_name)s " \
-              " %(kafka)s %(state_dir)s %(user_test_args)s" \
+              " %(kafka)s %(state_dir)s %(user_test_args)s %(user_test_args1)s %(user_test_args2)s" \
               " & echo $! >&3 ) 1>> %(stdout)s 2>> %(stderr)s 3> %(pidfile)s" % args
 
         return cmd

From d7850a400ed3d6efd3aae20515560971693f39b5 Mon Sep 17 00:00:00 2001
From: Gwen Shapira <cshapi@gmail.com>
Date: Wed, 26 Apr 2017 12:24:32 -0700
Subject: [PATCH 174/177] Post 0.10.2.1 release version bumping

---
 gradle.properties           | 2 +-
 tests/kafkatest/__init__.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/gradle.properties b/gradle.properties
index bb92f80ab5513..02f1935d7b379 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -16,7 +16,7 @@
 group=org.apache.kafka
 # NOTE: When you change this version number, you should also make sure to update
 # the version numbers in tests/kafkatest/__init__.py and kafka-merge-pr.py.
-version=0.10.2.1
+version=0.10.2.2-SNAPSHOT
 scalaVersion=2.10.6
 task=build
 org.gradle.jvmargs=-XX:MaxPermSize=512m -Xmx1024m -Xss2m
diff --git a/tests/kafkatest/__init__.py b/tests/kafkatest/__init__.py
index d6abd3f2a191f..52c820e672457 100644
--- a/tests/kafkatest/__init__.py
+++ b/tests/kafkatest/__init__.py
@@ -22,4 +22,4 @@
 # Instead, in development branches, the version should have a suffix of the form ".devN"
 #
 # For example, when Kafka is at version 0.9.0.0-SNAPSHOT, this should be something like "0.9.0.0.dev0"
-__version__ = '0.10.2.1'
+__version__ = '0.10.2.2.dev0'

From 0e8b0847749d78815c1ec3a066a82a1f5e2e4165 Mon Sep 17 00:00:00 2001
From: Eno Thereska <eno.thereska@gmail.com>
Date: Mon, 8 May 2017 09:40:57 -0700
Subject: [PATCH 175/177] KAFKA-5174: Have at least 2 threads for compaction
 and flushing in RocksDB

This fix needs to be backported to 0.10.2 as well.

Author: Eno Thereska <eno.thereska@gmail.com>

Reviewers: Damian Guy, Ismael Juma, Guozhang Wang

Closes #2982 from enothereska/KAFKA-5174-1-core
---
 .../kafka/streams/state/internals/RocksDBStore.java    | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
index acfb5b1324b25..a778cd8cea7cd 100644
--- a/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/RocksDBStore.java
@@ -124,9 +124,13 @@ public void openDB(ProcessorContext context) {
         options.setErrorIfExists(false);
         options.setInfoLogLevel(InfoLogLevel.ERROR_LEVEL);
         // this is the recommended way to increase parallelism in RocksDb
-        // note that the current implementation increases the number of compaction threads
-        // but not flush threads.
-        options.setIncreaseParallelism(Runtime.getRuntime().availableProcessors());
+        // note that the current implementation of setIncreaseParallelism affects the number
+        // of compaction threads but not flush threads (the latter remains one). Also
+        // the parallelism value needs to be at least two because of the code in
+        // https://github.com/facebook/rocksdb/blob/62ad0a9b19f0be4cefa70b6b32876e764b7f3c11/util/options.cc#L580
+        // subtracts one from the value passed to determine the number of compaction threads
+        // (this could be a bug in the RocksDB code and their devs have been contacted).
+        options.setIncreaseParallelism(Math.max(Runtime.getRuntime().availableProcessors(), 2));
 
         wOptions = new WriteOptions();
         wOptions.setDisableWAL(true);

From bce189fa451141df9f5b1c86a307a321caeaf807 Mon Sep 17 00:00:00 2001
From: Konstantine Karantasis <konstantine@confluent.io>
Date: Tue, 9 May 2017 14:20:49 -0700
Subject: [PATCH 176/177] HOTFIX: Increase kafkatest startup wait time on
 ConnectDistributed service in 0.10.2

Author: Konstantine Karantasis <konstantine@confluent.io>

Reviewers: Jason Gustafson <jason@confluent.io>

Closes #3007 from kkonstantine/HOTFIX-Align-startup-wait-time-for-ConnectDistributed-service-with-ConnectStandalone-in-kafkatests-0.10.2
---
 tests/kafkatest/services/connect.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/kafkatest/services/connect.py b/tests/kafkatest/services/connect.py
index 5a8581a86c559..a27acd7694358 100644
--- a/tests/kafkatest/services/connect.py
+++ b/tests/kafkatest/services/connect.py
@@ -272,7 +272,7 @@ def start_node(self, node):
             cmd = self.start_cmd(node)
             self.logger.debug("Connect distributed command: %s", cmd)
             node.account.ssh(cmd)
-            monitor.wait_until('Kafka Connect started', timeout_sec=15, err_msg="Never saw message indicating Kafka Connect finished startup on " + str(node.account))
+            monitor.wait_until('Kafka Connect started', timeout_sec=30, err_msg="Never saw message indicating Kafka Connect finished startup on " + str(node.account))
 
         if len(self.pids(node)) == 0:
             raise RuntimeError("No process ids recorded")

From b3440c4a1c8328c9de3447c7830b3d2e59176628 Mon Sep 17 00:00:00 2001
From: Damian Guy <damian.guy@gmail.com>
Date: Fri, 17 Feb 2017 14:41:28 -0800
Subject: [PATCH 177/177] backport from trunk

---
 .../processor/internals/AbstractTask.java     |  19 +-
 .../processor/internals/Checkpointable.java   |  27 +++
 .../internals/GlobalStateManagerImpl.java     |  16 +-
 .../internals/GlobalStateUpdateTask.java      |   3 +-
 .../internals/ProcessorStateManager.java      |  58 ++---
 .../processor/internals/StandbyTask.java      |  23 +-
 .../processor/internals/StateManager.java     |   4 +-
 .../processor/internals/StreamTask.java       |   5 +-
 .../internals/InMemoryKeyValueStore.java      | 187 +++++++++++++++++
 .../processor/internals/AbstractTaskTest.java |   1 +
 .../internals/GlobalStateManagerImplTest.java |  49 ++++-
 .../internals/GlobalStateTaskTest.java        |  16 +-
 .../internals/ProcessorStateManagerTest.java  | 198 ++++++++++++------
 .../processor/internals/StandbyTaskTest.java  |  49 ++++-
 .../processor/internals/StreamTaskTest.java   |  63 ++++++
 .../kafka/test/GlobalStateManagerStub.java    |   7 +-
 .../test/ProcessorTopologyTestDriver.java     |   3 +-
 17 files changed, 588 insertions(+), 140 deletions(-)
 create mode 100644 streams/src/main/java/org/apache/kafka/streams/processor/internals/Checkpointable.java
 create mode 100644 streams/src/main/java/org/apache/kafka/streams/state/internals/InMemoryKeyValueStore.java

diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/AbstractTask.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/AbstractTask.java
index 55418d5b4e030..8de5d2304d05a 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/AbstractTask.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/AbstractTask.java
@@ -52,14 +52,14 @@ public abstract class AbstractTask {
     /**
      * @throws ProcessorStateException if the state manager cannot be created
      */
-    protected AbstractTask(TaskId id,
-                           String applicationId,
-                           Collection<TopicPartition> partitions,
-                           ProcessorTopology topology,
-                           Consumer<byte[], byte[]> consumer,
-                           Consumer<byte[], byte[]> restoreConsumer,
-                           boolean isStandby,
-                           StateDirectory stateDirectory,
+    protected AbstractTask(final TaskId id,
+                           final String applicationId,
+                           final Collection<TopicPartition> partitions,
+                           final ProcessorTopology topology,
+                           final Consumer<byte[], byte[]> consumer,
+                           final Consumer<byte[], byte[]> restoreConsumer,
+                           final boolean isStandby,
+                           final StateDirectory stateDirectory,
                            final ThreadCache cache) {
         this.id = id;
         this.applicationId = applicationId;
@@ -70,8 +70,7 @@ protected AbstractTask(TaskId id,
 
         // create the processor state manager
         try {
-            this.stateMgr = new ProcessorStateManager(id, partitions, restoreConsumer, isStandby, stateDirectory, topology.storeToChangelogTopic());
-
+            stateMgr = new ProcessorStateManager(id, partitions, restoreConsumer, isStandby, stateDirectory, topology.storeToChangelogTopic());
         } catch (IOException e) {
             throw new ProcessorStateException(String.format("task [%s] Error while creating the state manager", id), e);
         }
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/Checkpointable.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/Checkpointable.java
new file mode 100644
index 0000000000000..7b02d5b934365
--- /dev/null
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/Checkpointable.java
@@ -0,0 +1,27 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.kafka.streams.processor.internals;
+
+import org.apache.kafka.common.TopicPartition;
+
+import java.util.Map;
+
+// Interface to indicate that an object has associated partition offsets that can be checkpointed
+interface Checkpointable {
+    void checkpoint(final Map<TopicPartition, Long> offsets);
+    Map<TopicPartition, Long> checkpointed();
+}
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/GlobalStateManagerImpl.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/GlobalStateManagerImpl.java
index 75349931aa199..3819bb5a09d70 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/GlobalStateManagerImpl.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/GlobalStateManagerImpl.java
@@ -58,11 +58,11 @@ public class GlobalStateManagerImpl implements GlobalStateManager {
     private final File baseDir;
     private final OffsetCheckpoint checkpoint;
     private final Set<String> globalStoreNames = new HashSet<>();
-    private HashMap<TopicPartition, Long> checkpointableOffsets;
+    private final Map<TopicPartition, Long> checkpointableOffsets = new HashMap<>();
 
     public GlobalStateManagerImpl(final ProcessorTopology topology,
-                           final Consumer<byte[], byte[]> consumer,
-                           final StateDirectory stateDirectory) {
+                                  final Consumer<byte[], byte[]> consumer,
+                                  final StateDirectory stateDirectory) {
         this.topology = topology;
         this.consumer = consumer;
         this.stateDirectory = stateDirectory;
@@ -81,8 +81,7 @@ public Set<String> initialize(final InternalProcessorContext processorContext) {
         }
 
         try {
-            this.checkpointableOffsets = new HashMap<>(checkpoint.read());
-            checkpoint.delete();
+            this.checkpointableOffsets.putAll(checkpoint.read());
         } catch (IOException e) {
             try {
                 stateDirectory.unlockGlobalState();
@@ -220,13 +219,14 @@ public void close(final Map<TopicPartition, Long> offsets) throws IOException {
             if (closeFailed.length() > 0) {
                 throw new ProcessorStateException("Exceptions caught during close of 1 or more global state stores\n" + closeFailed);
             }
-            writeCheckpoints(offsets);
+            checkpoint(offsets);
         } finally {
             stateDirectory.unlockGlobalState();
         }
     }
 
-    private void writeCheckpoints(final Map<TopicPartition, Long> offsets) {
+    @Override
+    public void checkpoint(final Map<TopicPartition, Long> offsets) {
         if (!offsets.isEmpty()) {
             checkpointableOffsets.putAll(offsets);
             try {
@@ -238,7 +238,7 @@ private void writeCheckpoints(final Map<TopicPartition, Long> offsets) {
     }
 
     @Override
-    public Map<TopicPartition, Long> checkpointedOffsets() {
+    public Map<TopicPartition, Long> checkpointed() {
         return Collections.unmodifiableMap(checkpointableOffsets);
     }
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/GlobalStateUpdateTask.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/GlobalStateUpdateTask.java
index 40f2a3c826aa8..6da37e4c1c003 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/GlobalStateUpdateTask.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/GlobalStateUpdateTask.java
@@ -67,7 +67,7 @@ public Map<TopicPartition, Long> initialize() {
         }
         initTopology();
         processorContext.initialized();
-        return stateMgr.checkpointedOffsets();
+        return stateMgr.checkpointed();
     }
 
 
@@ -89,6 +89,7 @@ public void update(final ConsumerRecord<byte[], byte[]> record) {
 
     public void flushState() {
         stateMgr.flush(processorContext);
+        stateMgr.checkpoint(offsets);
     }
 
     public void close() throws IOException {
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java
index 2ef9634218859..ea074da9f20d4 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/ProcessorStateManager.java
@@ -68,6 +68,7 @@ public class ProcessorStateManager implements StateManager {
     // TODO: this map does not work with customized grouper where multiple partitions
     // of the same topic can be assigned to the same topic.
     private final Map<String, TopicPartition> partitionForTopic;
+    private final OffsetCheckpoint checkpoint;
 
     /**
      * @throws LockException if the state directory cannot be locked because another thread holds the lock
@@ -111,11 +112,8 @@ public ProcessorStateManager(final TaskId taskId,
         }
 
         // load the checkpoint information
-        OffsetCheckpoint checkpoint = new OffsetCheckpoint(new File(this.baseDir, CHECKPOINT_FILE_NAME));
+        checkpoint = new OffsetCheckpoint(new File(this.baseDir, CHECKPOINT_FILE_NAME));
         this.checkpointedOffsets = new HashMap<>(checkpoint.read());
-
-        // delete the checkpoint file after finish loading its stored offsets
-        checkpoint.delete();
     }
 
 
@@ -263,7 +261,7 @@ private void restoreActiveState(String topicName, StateRestoreCallback stateRest
         }
     }
 
-    public Map<TopicPartition, Long> checkpointedOffsets() {
+    public Map<TopicPartition, Long> checkpointed() {
         Map<TopicPartition, Long> partitionsAndOffsets = new HashMap<>();
 
         for (Map.Entry<String, StateRestoreCallback> entry : restoreCallbacks.entrySet()) {
@@ -360,30 +358,7 @@ public void close(Map<TopicPartition, Long> ackedOffsets) throws IOException {
                 }
 
                 if (ackedOffsets != null) {
-                    Map<TopicPartition, Long> checkpointOffsets = new HashMap<>();
-                    for (String storeName : stores.keySet()) {
-                        // only checkpoint the offset to the offsets file if
-                        // it is persistent AND changelog enabled
-                        if (stores.get(storeName).persistent() && storeToChangelogTopic.containsKey(storeName)) {
-                            String changelogTopic = storeToChangelogTopic.get(storeName);
-                            TopicPartition topicPartition = new TopicPartition(changelogTopic, getPartition(storeName));
-
-                            Long offset = ackedOffsets.get(topicPartition);
-
-                            if (offset != null) {
-                                // store the last offset + 1 (the log position after restoration)
-                                checkpointOffsets.put(topicPartition, offset + 1);
-                            } else {
-                                // if no record was produced. we need to check the restored offset.
-                                offset = restoredOffsets.get(topicPartition);
-                                if (offset != null)
-                                    checkpointOffsets.put(topicPartition, offset);
-                            }
-                        }
-                    }
-                    // write the checkpoint file before closing, to indicate clean shutdown
-                    OffsetCheckpoint checkpoint = new OffsetCheckpoint(new File(this.baseDir, CHECKPOINT_FILE_NAME));
-                    checkpoint.write(checkpointOffsets);
+                    checkpoint(ackedOffsets);
                 }
 
             }
@@ -393,6 +368,31 @@ public void close(Map<TopicPartition, Long> ackedOffsets) throws IOException {
         }
     }
 
+    // write the checkpoint
+    @Override
+    public void checkpoint(final Map<TopicPartition, Long> ackedOffsets) {
+        for (String storeName : stores.keySet()) {
+            // only checkpoint the offset to the offsets file if
+            // it is persistent AND changelog enabled
+            if (stores.get(storeName).persistent() && storeToChangelogTopic.containsKey(storeName)) {
+                final String changelogTopic = storeToChangelogTopic.get(storeName);
+                final TopicPartition topicPartition = new TopicPartition(changelogTopic, getPartition(storeName));
+                if (ackedOffsets.containsKey(topicPartition)) {
+                    // store the last offset + 1 (the log position after restoration)
+                    checkpointedOffsets.put(topicPartition, ackedOffsets.get(topicPartition) + 1);
+                } else if (restoredOffsets.containsKey(topicPartition)) {
+                    checkpointedOffsets.put(topicPartition, restoredOffsets.get(topicPartition));
+                }
+            }
+        }
+        // write the checkpoint file before closing, to indicate clean shutdown
+        try {
+            checkpoint.write(checkpointedOffsets);
+        } catch (IOException e) {
+            log.warn("Failed to write checkpoint file to {}", new File(baseDir, CHECKPOINT_FILE_NAME), e);
+        }
+    }
+
     private int getPartition(String topic) {
         TopicPartition partition = partitionForTopic.get(topic);
 
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StandbyTask.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StandbyTask.java
index 4437a1955e700..a27098c34f22e 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StandbyTask.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StandbyTask.java
@@ -51,14 +51,15 @@ public class StandbyTask extends AbstractTask {
      * @param metrics               the {@link StreamsMetrics} created by the thread
      * @param stateDirectory        the {@link StateDirectory} created by the thread
      */
-    public StandbyTask(TaskId id,
-                       String applicationId,
-                       Collection<TopicPartition> partitions,
-                       ProcessorTopology topology,
-                       Consumer<byte[], byte[]> consumer,
-                       Consumer<byte[], byte[]> restoreConsumer,
-                       StreamsConfig config,
-                       StreamsMetrics metrics, final StateDirectory stateDirectory) {
+    public StandbyTask(final TaskId id,
+                       final String applicationId,
+                       final Collection<TopicPartition> partitions,
+                       final ProcessorTopology topology,
+                       final Consumer<byte[], byte[]> consumer,
+                       final Consumer<byte[], byte[]> restoreConsumer,
+                       final StreamsConfig config,
+                       final StreamsMetrics metrics,
+                       final StateDirectory stateDirectory) {
         super(id, applicationId, partitions, topology, consumer, restoreConsumer, true, stateDirectory, null);
 
         // initialize the topology with its own context
@@ -67,9 +68,9 @@ public StandbyTask(TaskId id,
         log.info("standby-task [{}] Initializing state stores", id());
         initializeStateStores();
 
-        ((StandbyContextImpl) this.processorContext).initialized();
+        this.processorContext.initialized();
 
-        this.checkpointedOffsets = Collections.unmodifiableMap(stateMgr.checkpointedOffsets());
+        this.checkpointedOffsets = Collections.unmodifiableMap(stateMgr.checkpointed());
     }
 
     public Map<TopicPartition, Long> checkpointedOffsets() {
@@ -92,7 +93,7 @@ public List<ConsumerRecord<byte[], byte[]>> update(TopicPartition partition, Lis
     public void commit() {
         log.debug("standby-task [{}] Committing its state", id());
         stateMgr.flush(processorContext);
-
+        stateMgr.checkpoint(Collections.<TopicPartition, Long>emptyMap());
         // reinitialize offset limits
         initializeOffsetLimits();
     }
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StateManager.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StateManager.java
index 7343c857fa68b..3102b77163086 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StateManager.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StateManager.java
@@ -24,7 +24,7 @@
 import java.io.IOException;
 import java.util.Map;
 
-interface StateManager {
+interface StateManager extends Checkpointable {
     File baseDir();
 
     void register(final StateStore store, final boolean loggingEnabled, final StateRestoreCallback stateRestoreCallback);
@@ -36,6 +36,4 @@ interface StateManager {
     StateStore getGlobalStore(final String name);
 
     StateStore getStore(final String name);
-
-    Map<TopicPartition, Long> checkpointedOffsets();
 }
diff --git a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamTask.java b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamTask.java
index 7375fb597a0e3..3270596e2dbd3 100644
--- a/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamTask.java
+++ b/streams/src/main/java/org/apache/kafka/streams/processor/internals/StreamTask.java
@@ -74,8 +74,9 @@ public void run() {
             log.trace("{} Start flushing its producer's sent records upon committing its state", logPrefix);
             // 2) flush produced records in the downstream and change logs of local states
             recordCollector.flush();
-
-            // 3) commit consumed offsets if it is dirty already
+            // 3) write checkpoints for any local state
+            stateMgr.checkpoint(recordCollectorOffsets());
+            // 4) commit consumed offsets if it is dirty already
             commitOffsets();
         }
     };
diff --git a/streams/src/main/java/org/apache/kafka/streams/state/internals/InMemoryKeyValueStore.java b/streams/src/main/java/org/apache/kafka/streams/state/internals/InMemoryKeyValueStore.java
new file mode 100644
index 0000000000000..dbcc219a80dc8
--- /dev/null
+++ b/streams/src/main/java/org/apache/kafka/streams/state/internals/InMemoryKeyValueStore.java
@@ -0,0 +1,187 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more contributor license
+ * agreements.  See the NOTICE file distributed with this work for additional information regarding
+ * copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance with the License.  You may obtain a
+ * copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package org.apache.kafka.streams.state.internals;
+
+import org.apache.kafka.common.serialization.Serde;
+import org.apache.kafka.streams.KeyValue;
+import org.apache.kafka.streams.processor.ProcessorContext;
+import org.apache.kafka.streams.processor.StateRestoreCallback;
+import org.apache.kafka.streams.processor.StateStore;
+import org.apache.kafka.streams.state.KeyValueIterator;
+import org.apache.kafka.streams.state.KeyValueStore;
+import org.apache.kafka.streams.state.StateSerdes;
+
+import java.util.Iterator;
+import java.util.List;
+import java.util.Map;
+import java.util.NavigableMap;
+import java.util.TreeMap;
+
+
+public class InMemoryKeyValueStore<K, V> implements KeyValueStore<K, V> {
+    private final String name;
+    private final Serde<K> keySerde;
+    private final Serde<V> valueSerde;
+    private final NavigableMap<K, V> map;
+    private volatile boolean open = false;
+
+    private StateSerdes<K, V> serdes;
+
+    public InMemoryKeyValueStore(final String name, final Serde<K> keySerde, final Serde<V> valueSerde) {
+        this.name = name;
+        this.keySerde = keySerde;
+        this.valueSerde = valueSerde;
+
+        // TODO: when we have serde associated with class types, we can
+        // improve this situation by passing the comparator here.
+        this.map = new TreeMap<>();
+    }
+
+    public KeyValueStore<K, V> enableLogging() {
+        return new InMemoryKeyValueLoggedStore<>(name, this, keySerde, valueSerde);
+    }
+
+    @Override
+    public String name() {
+        return this.name;
+    }
+
+    @Override
+    @SuppressWarnings("unchecked")
+    public void init(ProcessorContext context, StateStore root) {
+        // construct the serde
+        this.serdes = new StateSerdes<>(name,
+                keySerde == null ? (Serde<K>) context.keySerde() : keySerde,
+                valueSerde == null ? (Serde<V>) context.valueSerde() : valueSerde);
+
+        if (root != null) {
+            // register the store
+            context.register(root, true, new StateRestoreCallback() {
+                @Override
+                public void restore(byte[] key, byte[] value) {
+                    // check value for null, to avoid  deserialization error.
+                    if (value == null) {
+                        put(serdes.keyFrom(key), null);
+                    } else {
+                        put(serdes.keyFrom(key), serdes.valueFrom(value));
+                    }
+                }
+            });
+        }
+
+        this.open = true;
+    }
+
+    @Override
+    public boolean persistent() {
+        return false;
+    }
+
+    @Override
+    public boolean isOpen() {
+        return this.open;
+    }
+
+    @Override
+    public synchronized V get(K key) {
+        return this.map.get(key);
+    }
+
+    @Override
+    public synchronized void put(K key, V value) {
+        this.map.put(key, value);
+    }
+
+    @Override
+    public synchronized V putIfAbsent(K key, V value) {
+        V originalValue = get(key);
+        if (originalValue == null) {
+            put(key, value);
+        }
+        return originalValue;
+    }
+
+    @Override
+    public synchronized void putAll(List<KeyValue<K, V>> entries) {
+        for (KeyValue<K, V> entry : entries)
+            put(entry.key, entry.value);
+    }
+
+    @Override
+    public synchronized V delete(K key) {
+        return this.map.remove(key);
+    }
+
+    @Override
+    public synchronized KeyValueIterator<K, V> range(K from, K to) {
+        return new DelegatingPeekingKeyValueIterator<>(name, new InMemoryKeyValueIterator<>(this.map.subMap(from, true, to, true).entrySet().iterator()));
+    }
+
+    @Override
+    public synchronized KeyValueIterator<K, V> all() {
+        final TreeMap<K, V> copy = new TreeMap<>(this.map);
+        return new DelegatingPeekingKeyValueIterator<>(name, new InMemoryKeyValueIterator<>(copy.entrySet().iterator()));
+    }
+
+    @Override
+    public long approximateNumEntries() {
+        return this.map.size();
+    }
+
+    @Override
+    public void flush() {
+        // do-nothing since it is in-memory
+    }
+
+    @Override
+    public void close() {
+        this.map.clear();
+        this.open = false;
+    }
+
+    private static class InMemoryKeyValueIterator<K, V> implements KeyValueIterator<K, V> {
+        private final Iterator<Map.Entry<K, V>> iter;
+
+        private InMemoryKeyValueIterator(Iterator<Map.Entry<K, V>> iter) {
+            this.iter = iter;
+        }
+
+        @Override
+        public boolean hasNext() {
+            return iter.hasNext();
+        }
+
+        @Override
+        public KeyValue<K, V> next() {
+            Map.Entry<K, V> entry = iter.next();
+            return new KeyValue<>(entry.getKey(), entry.getValue());
+        }
+
+        @Override
+        public void remove() {
+            iter.remove();
+        }
+
+        @Override
+        public void close() {
+            // do nothing
+        }
+
+        @Override
+        public K peekNextKey() {
+            throw new UnsupportedOperationException("peekNextKey() not supported in " + getClass().getName());
+        }
+    }
+}
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/AbstractTaskTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/AbstractTaskTest.java
index 16967bcd1b0a4..a2346fc4cfa1b 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/AbstractTaskTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/AbstractTaskTest.java
@@ -71,6 +71,7 @@ private AbstractTask createTask(final Consumer consumer) {
                                 consumer,
                                 consumer,
                                 false,
+
                                 new StateDirectory("app", TestUtils.tempDirectory().getPath()),
                                 new ThreadCache("testCache", 0, new MockStreamsMetrics(new Metrics()))) {
             @Override
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/GlobalStateManagerImplTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/GlobalStateManagerImplTest.java
index db51cefabf587..8c9cf19cb93ba 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/GlobalStateManagerImplTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/GlobalStateManagerImplTest.java
@@ -49,6 +49,8 @@
 import java.util.Map;
 import java.util.Set;
 
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.MatcherAssert.assertThat;
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertFalse;
 import static org.junit.Assert.assertTrue;
@@ -122,15 +124,15 @@ public void shouldReadCheckpointOffsets() throws Exception {
         final Map<TopicPartition, Long> expected = writeCheckpoint();
 
         stateManager.initialize(context);
-        final Map<TopicPartition, Long> offsets = stateManager.checkpointedOffsets();
+        final Map<TopicPartition, Long> offsets = stateManager.checkpointed();
         assertEquals(expected, offsets);
     }
 
     @Test
-    public void shouldDeleteCheckpointFileAfteLoaded() throws Exception {
+    public void shouldNotDeleteCheckpointFileAfterLoaded() throws Exception {
         writeCheckpoint();
         stateManager.initialize(context);
-        assertFalse(checkpointFile.exists());
+        assertTrue(checkpointFile.exists());
     }
 
     @Test(expected = StreamsException.class)
@@ -168,7 +170,7 @@ public void shouldThrowIllegalArgumentIfTryingToRegisterStoreThatIsNotGlobal() t
     }
 
     @Test
-    public void shouldThrowIllegalArgumenExceptionIfAttemptingToRegisterStoreTwice() throws Exception {
+    public void shouldThrowIllegalArgumentExceptionIfAttemptingToRegisterStoreTwice() throws Exception {
         stateManager.initialize(context);
         initializeConsumer(2, 1, t1);
         stateManager.register(store1, false, new TheStateRestoreCallback());
@@ -271,9 +273,7 @@ public void shouldWriteCheckpointsOnClose() throws Exception {
         stateManager.register(store1, false, stateRestoreCallback);
         final Map<TopicPartition, Long> expected = Collections.singletonMap(t1, 25L);
         stateManager.close(expected);
-        final OffsetCheckpoint offsetCheckpoint = new OffsetCheckpoint(new File(stateManager.baseDir(),
-                                                                                ProcessorStateManager.CHECKPOINT_FILE_NAME));
-        final Map<TopicPartition, Long> result = offsetCheckpoint.read();
+        final Map<TopicPartition, Long> result = readOffsetsCheckpoint();
         assertEquals(expected, result);
     }
 
@@ -379,6 +379,41 @@ public void shouldReleaseLockIfExceptionWhenLoadingCheckpoints() throws Exceptio
         }
     }
 
+    @Test
+    public void shouldCheckpointOffsets() throws Exception {
+        final Map<TopicPartition, Long> offsets = Collections.singletonMap(t1, 25L);
+        stateManager.initialize(context);
+
+        stateManager.checkpoint(offsets);
+
+        final Map<TopicPartition, Long> result = readOffsetsCheckpoint();
+        assertThat(result, equalTo(offsets));
+        assertThat(stateManager.checkpointed(), equalTo(offsets));
+    }
+
+    @Test
+    public void shouldNotRemoveOffsetsOfUnUpdatedTablesDuringCheckpoint() throws Exception {
+        stateManager.initialize(context);
+        final TheStateRestoreCallback stateRestoreCallback = new TheStateRestoreCallback();
+        initializeConsumer(10, 1, t1);
+        stateManager.register(store1, false, stateRestoreCallback);
+        initializeConsumer(20, 1, t2);
+        stateManager.register(store2, false, stateRestoreCallback);
+
+        final Map<TopicPartition, Long> initialCheckpoint = stateManager.checkpointed();
+        stateManager.checkpoint(Collections.singletonMap(t1, 101L));
+
+        final Map<TopicPartition, Long> updatedCheckpoint = stateManager.checkpointed();
+        assertThat(updatedCheckpoint.get(t2), equalTo(initialCheckpoint.get(t2)));
+        assertThat(updatedCheckpoint.get(t1), equalTo(101L));
+    }
+
+    private Map<TopicPartition, Long> readOffsetsCheckpoint() throws IOException {
+        final OffsetCheckpoint offsetCheckpoint = new OffsetCheckpoint(new File(stateManager.baseDir(),
+                                                                                ProcessorStateManager.CHECKPOINT_FILE_NAME));
+        return offsetCheckpoint.read();
+    }
+
     private void initializeConsumer(final long numRecords, final long startOffset, final TopicPartition topicPartition) {
         final HashMap<TopicPartition, Long> startOffsets = new HashMap<>();
         startOffsets.put(topicPartition, 1L);
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/GlobalStateTaskTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/GlobalStateTaskTest.java
index df0b73ca8a4cd..66999bc8efbe1 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/GlobalStateTaskTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/GlobalStateTaskTest.java
@@ -38,6 +38,8 @@
 import java.util.Map;
 import java.util.Set;
 
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.MatcherAssert.assertThat;
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertTrue;
 
@@ -137,7 +139,19 @@ public void shouldCloseStateManagerWithOffsets() throws Exception {
         globalStateTask.initialize();
         globalStateTask.update(new ConsumerRecord<>("t1", 1, 51, "foo".getBytes(), "foo".getBytes()));
         globalStateTask.close();
-        assertEquals(expectedOffsets, stateMgr.checkpointedOffsets());
+        assertEquals(expectedOffsets, stateMgr.checkpointed());
         assertTrue(stateMgr.closed);
     }
+
+    @Test
+    public void shouldCheckpointOffsetsWhenStateIsFlushed() throws Exception {
+        final Map<TopicPartition, Long> expectedOffsets = new HashMap<>();
+        expectedOffsets.put(t1, 102L);
+        expectedOffsets.put(t2, 100L);
+        globalStateTask.initialize();
+        globalStateTask.update(new ConsumerRecord<>("t1", 1, 101, "foo".getBytes(), "foo".getBytes()));
+        globalStateTask.flushState();
+        assertThat(stateMgr.checkpointed(), equalTo(expectedOffsets));
+    }
+
 }
\ No newline at end of file
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/ProcessorStateManagerTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/ProcessorStateManagerTest.java
index 602601a17e731..a9998e6e2e189 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/ProcessorStateManagerTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/ProcessorStateManagerTest.java
@@ -26,6 +26,7 @@
 import org.apache.kafka.common.TopicPartition;
 import org.apache.kafka.common.record.TimestampType;
 import org.apache.kafka.common.serialization.IntegerSerializer;
+import org.apache.kafka.common.serialization.Serdes;
 import org.apache.kafka.common.serialization.Serializer;
 import org.apache.kafka.common.utils.Utils;
 import org.apache.kafka.streams.errors.StreamsException;
@@ -49,6 +50,8 @@
 import java.util.Map;
 import java.util.Set;
 
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.MatcherAssert.assertThat;
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertNotNull;
 import static org.junit.Assert.assertNull;
@@ -57,14 +60,10 @@
 
 public class ProcessorStateManagerTest {
 
-    private File baseDir;
-    private StateDirectory stateDirectory;
-
     public static class MockRestoreConsumer extends MockConsumer<byte[], byte[]> {
         private final Serializer<Integer> serializer = new IntegerSerializer();
 
         private TopicPartition assignedPartition = null;
-        private TopicPartition seekPartition = null;
         private long seekOffset = -1L;
         private boolean seekToBeginingCalled = false;
         private boolean seekToEndCalled = false;
@@ -155,7 +154,6 @@ public synchronized void seek(TopicPartition partition, long offset) {
             if (seekOffset >= 0)
                 throw new IllegalStateException("RestoreConsumer: offset already seeked");
 
-            seekPartition = partition;
             seekOffset = offset;
             currentOffset = offset;
             super.seek(partition, offset);
@@ -196,11 +194,32 @@ public synchronized void seekToEnd(Collection<TopicPartition> partitions) {
     private final String nonPersistentStoreName = "nonPersistentStore";
     private final String persistentStoreTopicName = ProcessorStateManager.storeChangelogTopic(applicationId, persistentStoreName);
     private final String nonPersistentStoreTopicName = ProcessorStateManager.storeChangelogTopic(applicationId, nonPersistentStoreName);
+    private final MockStateStoreSupplier.MockStateStore persistentStore = new MockStateStoreSupplier.MockStateStore(persistentStoreName, true);
+    private final MockStateStoreSupplier.MockStateStore nonPersistentStore = new MockStateStoreSupplier.MockStateStore(nonPersistentStoreName, false);
+    private final TopicPartition persistentStorePartition = new TopicPartition(persistentStoreTopicName, 1);
+    private final String storeName = "mockStateStore";
+    private final String changelogTopic = ProcessorStateManager.storeChangelogTopic(applicationId, storeName);
+    private final TopicPartition changelogTopicPartition = new TopicPartition(changelogTopic, 0);
+    private final TaskId taskId = new TaskId(0, 1);
+    private final MockRestoreConsumer restoreConsumer = new MockRestoreConsumer();
+    private final MockStateStoreSupplier.MockStateStore mockStateStore = new MockStateStoreSupplier.MockStateStore(storeName, true);
+    private File baseDir;
+    private File checkpointFile;
+    private StateDirectory stateDirectory;
+    private OffsetCheckpoint checkpoint;
 
     @Before
     public void setup() {
         baseDir = TestUtils.tempDirectory();
         stateDirectory = new StateDirectory(applicationId, baseDir.getPath());
+        checkpointFile = new File(stateDirectory.directoryForTask(taskId), ProcessorStateManager.CHECKPOINT_FILE_NAME);
+        checkpoint = new OffsetCheckpoint(checkpointFile);
+        restoreConsumer.updatePartitions(persistentStoreTopicName, Utils.mkList(
+                new PartitionInfo(persistentStoreTopicName, 1, Node.noNode(), new Node[0], new Node[0])
+        ));
+        restoreConsumer.updatePartitions(nonPersistentStoreTopicName, Utils.mkList(
+                new PartitionInfo(nonPersistentStoreTopicName, 1, Node.noNode(), new Node[0], new Node[0])
+        ));
     }
 
     @After
@@ -283,8 +302,6 @@ public void testRegisterPersistentStore() throws IOException {
     public void testRegisterNonPersistentStore() throws IOException {
         long lastCheckpointedOffset = 10L;
 
-        MockRestoreConsumer restoreConsumer = new MockRestoreConsumer();
-
         OffsetCheckpoint checkpoint = new OffsetCheckpoint(new File(baseDir, ProcessorStateManager.CHECKPOINT_FILE_NAME));
         checkpoint.write(Collections.singletonMap(new TopicPartition(persistentStoreTopicName, 2), lastCheckpointedOffset));
 
@@ -296,8 +313,6 @@ public void testRegisterNonPersistentStore() throws IOException {
         TopicPartition partition = new TopicPartition(persistentStoreTopicName, 2);
         restoreConsumer.updateEndOffsets(Collections.singletonMap(partition, 13L));
 
-        MockStateStoreSupplier.MockStateStore nonPersistentStore = new MockStateStoreSupplier.MockStateStore(nonPersistentStoreName, false); // non persistent store
-
         ProcessorStateManager stateMgr = new ProcessorStateManager(new TaskId(0, 2), noPartitions, restoreConsumer, false, stateDirectory, new HashMap<String, String>() {
             {
                 put(persistentStoreName, persistentStoreTopicName);
@@ -308,7 +323,7 @@ public void testRegisterNonPersistentStore() throws IOException {
             restoreConsumer.reset();
 
             ArrayList<Integer> expectedKeys = new ArrayList<>();
-            long offset = -1L;
+            long offset;
             for (int i = 1; i <= 3; i++) {
                 offset = (long) (i + 100);
                 int key = i;
@@ -329,12 +344,13 @@ public void testRegisterNonPersistentStore() throws IOException {
         } finally {
             stateMgr.close(Collections.<TopicPartition, Long>emptyMap());
         }
-
     }
 
     @Test
     public void testChangeLogOffsets() throws IOException {
         final TaskId taskId = new TaskId(0, 0);
+        final OffsetCheckpoint offsetCheckpoint = new OffsetCheckpoint(
+                new File(stateDirectory.directoryForTask(taskId), ProcessorStateManager.CHECKPOINT_FILE_NAME));
         long lastCheckpointedOffset = 10L;
         String storeName1 = "store1";
         String storeName2 = "store2";
@@ -349,10 +365,7 @@ public void testChangeLogOffsets() throws IOException {
         storeToChangelogTopic.put(storeName2, storeTopicName2);
         storeToChangelogTopic.put(storeName3, storeTopicName3);
 
-        OffsetCheckpoint checkpoint = new OffsetCheckpoint(new File(stateDirectory.directoryForTask(taskId), ProcessorStateManager.CHECKPOINT_FILE_NAME));
-        checkpoint.write(Collections.singletonMap(new TopicPartition(storeTopicName1, 0), lastCheckpointedOffset));
-
-        MockRestoreConsumer restoreConsumer = new MockRestoreConsumer();
+        offsetCheckpoint.write(Collections.singletonMap(new TopicPartition(storeTopicName1, 0), lastCheckpointedOffset));
 
         restoreConsumer.updatePartitions(storeTopicName1, Utils.mkList(
                 new PartitionInfo(storeTopicName1, 0, Node.noNode(), new Node[0], new Node[0])
@@ -389,7 +402,7 @@ public void testChangeLogOffsets() throws IOException {
             stateMgr.register(store2, true, store2.stateRestoreCallback);
             stateMgr.register(store3, true, store3.stateRestoreCallback);
 
-            Map<TopicPartition, Long> changeLogOffsets = stateMgr.checkpointedOffsets();
+            Map<TopicPartition, Long> changeLogOffsets = stateMgr.checkpointed();
 
             assertEquals(3, changeLogOffsets.size());
             assertTrue(changeLogOffsets.containsKey(partition1));
@@ -407,20 +420,12 @@ public void testChangeLogOffsets() throws IOException {
 
     @Test
     public void testGetStore() throws IOException {
-        MockRestoreConsumer restoreConsumer = new MockRestoreConsumer();
-
-        restoreConsumer.updatePartitions(nonPersistentStoreTopicName, Utils.mkList(
-                new PartitionInfo(nonPersistentStoreTopicName, 1, Node.noNode(), new Node[0], new Node[0])
-        ));
-
-        MockStateStoreSupplier.MockStateStore mockStateStore = new MockStateStoreSupplier.MockStateStore(nonPersistentStoreName, false);
-
-        ProcessorStateManager stateMgr = new ProcessorStateManager(new TaskId(0, 1), noPartitions, restoreConsumer, false, stateDirectory, Collections.<String, String>emptyMap());
+        final ProcessorStateManager stateMgr = new ProcessorStateManager(new TaskId(0, 1), noPartitions, restoreConsumer, false, stateDirectory, Collections.<String, String>emptyMap());
         try {
-            stateMgr.register(mockStateStore, true, mockStateStore.stateRestoreCallback);
+            stateMgr.register(nonPersistentStore, true, nonPersistentStore.stateRestoreCallback);
 
             assertNull(stateMgr.getStore("noSuchStore"));
-            assertEquals(mockStateStore, stateMgr.getStore(nonPersistentStoreName));
+            assertEquals(nonPersistentStore, stateMgr.getStore(nonPersistentStoreName));
 
         } finally {
             stateMgr.close(Collections.<TopicPartition, Long>emptyMap());
@@ -429,30 +434,15 @@ public void testGetStore() throws IOException {
 
     @Test
     public void testFlushAndClose() throws IOException {
-        final TaskId taskId = new TaskId(0, 1);
-        File checkpointFile = new File(stateDirectory.directoryForTask(taskId), ProcessorStateManager.CHECKPOINT_FILE_NAME);
         // write an empty checkpoint file
-        OffsetCheckpoint oldCheckpoint = new OffsetCheckpoint(checkpointFile);
-        oldCheckpoint.write(Collections.<TopicPartition, Long>emptyMap());
-
-        MockRestoreConsumer restoreConsumer = new MockRestoreConsumer();
-
-        restoreConsumer.updatePartitions(persistentStoreTopicName, Utils.mkList(
-                new PartitionInfo(persistentStoreTopicName, 1, Node.noNode(), new Node[0], new Node[0])
-        ));
-        restoreConsumer.updatePartitions(nonPersistentStoreTopicName, Utils.mkList(
-                new PartitionInfo(nonPersistentStoreTopicName, 1, Node.noNode(), new Node[0], new Node[0])
-        ));
+        checkpoint.write(Collections.<TopicPartition, Long>emptyMap());
 
         // set up ack'ed offsets
-        HashMap<TopicPartition, Long> ackedOffsets = new HashMap<>();
+        final HashMap<TopicPartition, Long> ackedOffsets = new HashMap<>();
         ackedOffsets.put(new TopicPartition(persistentStoreTopicName, 1), 123L);
         ackedOffsets.put(new TopicPartition(nonPersistentStoreTopicName, 1), 456L);
         ackedOffsets.put(new TopicPartition(ProcessorStateManager.storeChangelogTopic(applicationId, "otherTopic"), 1), 789L);
 
-        MockStateStoreSupplier.MockStateStore persistentStore = new MockStateStoreSupplier.MockStateStore(persistentStoreName, true);
-        MockStateStoreSupplier.MockStateStore nonPersistentStore = new MockStateStoreSupplier.MockStateStore(nonPersistentStoreName, false);
-
         ProcessorStateManager stateMgr = new ProcessorStateManager(taskId, noPartitions, restoreConsumer, false, stateDirectory, new HashMap<String, String>() {
             {
                 put(persistentStoreName, persistentStoreTopicName);
@@ -460,8 +450,8 @@ public void testFlushAndClose() throws IOException {
             }
         });
         try {
-            // make sure the checkpoint file is deleted
-            assertFalse(checkpointFile.exists());
+            // make sure the checkpoint file isn't deleted
+            assertTrue(checkpointFile.exists());
 
             restoreConsumer.reset();
             stateMgr.register(persistentStore, true, persistentStore.stateRestoreCallback);
@@ -482,42 +472,122 @@ public void testFlushAndClose() throws IOException {
         assertTrue(checkpointFile.exists());
 
         // the checkpoint file should contain an offset from the persistent store only.
-        OffsetCheckpoint newCheckpoint = new OffsetCheckpoint(checkpointFile);
-        Map<TopicPartition, Long> checkpointedOffsets = newCheckpoint.read();
+        final Map<TopicPartition, Long> checkpointedOffsets = checkpoint.read();
         assertEquals(1, checkpointedOffsets.size());
         assertEquals(new Long(123L + 1L), checkpointedOffsets.get(new TopicPartition(persistentStoreTopicName, 1)));
     }
 
     @Test
     public void shouldRegisterStoreWithoutLoggingEnabledAndNotBackedByATopic() throws Exception {
-        MockStateStoreSupplier.MockStateStore mockStateStore = new MockStateStoreSupplier.MockStateStore(nonPersistentStoreName, false);
         ProcessorStateManager stateMgr = new ProcessorStateManager(new TaskId(0, 1), noPartitions, new MockRestoreConsumer(), false, stateDirectory, Collections.<String, String>emptyMap());
-        stateMgr.register(mockStateStore, false, mockStateStore.stateRestoreCallback);
+        stateMgr.register(nonPersistentStore, false, nonPersistentStore.stateRestoreCallback);
         assertNotNull(stateMgr.getStore(nonPersistentStoreName));
     }
 
+
     @Test
-    public void shouldNotWriteCheckpointsIfAckeOffsetsIsNull() throws Exception {
-        final TaskId taskId = new TaskId(0, 1);
-        final File checkpointFile = new File(stateDirectory.directoryForTask(taskId), ProcessorStateManager.CHECKPOINT_FILE_NAME);
-        // write an empty checkpoint file
-        final OffsetCheckpoint oldCheckpoint = new OffsetCheckpoint(checkpointFile);
-        oldCheckpoint.write(Collections.<TopicPartition, Long>emptyMap());
+    public void shouldNotChangeOffsetsIfAckedOffsetsIsNull() throws Exception {
+        final Map<TopicPartition, Long> offsets = Collections.singletonMap(persistentStorePartition, 99L);
+        checkpoint.write(offsets);
 
-        final MockRestoreConsumer restoreConsumer = new MockRestoreConsumer();
+        final ProcessorStateManager stateMgr = new ProcessorStateManager(taskId,
+                                                                         noPartitions,
+                                                                         restoreConsumer,
+                                                                         false,
+                                                                         stateDirectory,
+                                                                         Collections.<String, String>emptyMap());
 
-        restoreConsumer.updatePartitions(persistentStoreTopicName, Utils.mkList(
-                new PartitionInfo(persistentStoreTopicName, 1, Node.noNode(), new Node[0], new Node[0])
-        ));
+        restoreConsumer.reset();
+        stateMgr.register(persistentStore, true, persistentStore.stateRestoreCallback);
+        stateMgr.close(null);
+        final Map<TopicPartition, Long> read = checkpoint.read();
+        assertThat(read, equalTo(offsets));
+    }
 
+    @Test
+    public void shouldWriteCheckpointForPersistentLogEnabledStore() throws Exception {
+        final ProcessorStateManager stateMgr = new ProcessorStateManager(taskId,
+                                                                         noPartitions,
+                                                                         restoreConsumer,
+                                                                         false,
+                                                                         stateDirectory,
+                                                                         Collections.singletonMap(persistentStore.name(),
+                                                                                                  persistentStoreTopicName));
+        restoreConsumer.reset();
+        stateMgr.register(persistentStore, true, persistentStore.stateRestoreCallback);
 
-        final MockStateStoreSupplier.MockStateStore persistentStore = new MockStateStoreSupplier.MockStateStore(persistentStoreName, true);
-        final ProcessorStateManager stateMgr = new ProcessorStateManager(taskId, noPartitions, restoreConsumer, false, stateDirectory, Collections.<String, String>emptyMap());
+        stateMgr.checkpoint(Collections.singletonMap(persistentStorePartition, 10L));
+        final Map<TopicPartition, Long> read = checkpoint.read();
+        assertThat(read, equalTo(Collections.singletonMap(persistentStorePartition, 11L)));
+    }
+
+    @Test
+    public void shouldWriteCheckpointForStandbyReplica() throws Exception {
+        final ProcessorStateManager stateMgr = new ProcessorStateManager(taskId,
+                                                                         noPartitions,
+                                                                         restoreConsumer,
+                                                                         true,
+                                                                         stateDirectory,
+                                                                         Collections.singletonMap(persistentStore.name(),
+                                                                                                  persistentStoreTopicName));
 
         restoreConsumer.reset();
         stateMgr.register(persistentStore, true, persistentStore.stateRestoreCallback);
-        stateMgr.close(null);
-        assertFalse(checkpointFile.exists());
+        final byte[] bytes = Serdes.Integer().serializer().serialize("", 10);
+        stateMgr.updateStandbyStates(persistentStorePartition,
+                                     Collections.singletonList(
+                                             new ConsumerRecord<>(persistentStorePartition.topic(),
+                                                                                persistentStorePartition.partition(),
+                                                                                888L,
+                                                                                bytes,
+                                                                                bytes)));
+
+        stateMgr.checkpoint(Collections.<TopicPartition, Long>emptyMap());
+
+        final Map<TopicPartition, Long> read = checkpoint.read();
+        assertThat(read, equalTo(Collections.singletonMap(persistentStorePartition, 889L)));
+
+    }
+
+    @Test
+    public void shouldNotWriteCheckpointForNonPersistent() throws Exception {
+        final TopicPartition topicPartition = new TopicPartition(nonPersistentStoreTopicName, 1);
+
+        restoreConsumer.updatePartitions(nonPersistentStoreTopicName, Utils.mkList(
+                new PartitionInfo(nonPersistentStoreTopicName, 1, Node.noNode(), new Node[0], new Node[0])
+        ));
+
+        final ProcessorStateManager stateMgr = new ProcessorStateManager(taskId,
+                                                                         noPartitions,
+                                                                         restoreConsumer,
+                                                                         true,
+                                                                         stateDirectory,
+                                                                         Collections.singletonMap(nonPersistentStoreName,
+                                                                                                  nonPersistentStoreTopicName));
+
+        restoreConsumer.reset();
+        stateMgr.register(nonPersistentStore, true, nonPersistentStore.stateRestoreCallback);
+        stateMgr.checkpoint(Collections.singletonMap(topicPartition, 876L));
+
+        final Map<TopicPartition, Long> read = checkpoint.read();
+        assertThat(read, equalTo(Collections.<TopicPartition, Long>emptyMap()));
+    }
+
+    @Test
+    public void shouldNotWriteCheckpointForStoresWithoutChangelogTopic() throws Exception {
+        final ProcessorStateManager stateMgr = new ProcessorStateManager(taskId,
+                                                                         noPartitions,
+                                                                         restoreConsumer,
+                                                                         true,
+                                                                         stateDirectory,
+                                                                         Collections.<String, String>emptyMap());
+
+        stateMgr.register(persistentStore, true, persistentStore.stateRestoreCallback);
+
+        stateMgr.checkpoint(Collections.singletonMap(persistentStorePartition, 987L));
+
+        final Map<TopicPartition, Long> read = checkpoint.read();
+        assertThat(read, equalTo(Collections.<TopicPartition, Long>emptyMap()));
     }
 
 }
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StandbyTaskTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StandbyTaskTest.java
index 2d32e780faee3..4c3356a4f89e1 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StandbyTaskTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StandbyTaskTest.java
@@ -27,6 +27,7 @@
 import org.apache.kafka.common.metrics.Metrics;
 import org.apache.kafka.common.record.TimestampType;
 import org.apache.kafka.common.serialization.IntegerSerializer;
+import org.apache.kafka.common.serialization.Serdes;
 import org.apache.kafka.common.serialization.Serializer;
 import org.apache.kafka.common.utils.Utils;
 import org.apache.kafka.streams.StreamsConfig;
@@ -53,6 +54,8 @@
 import java.util.Set;
 
 import static java.util.Collections.singleton;
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.MatcherAssert.assertThat;
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertNull;
 
@@ -315,7 +318,7 @@ public void shouldNotThrowUnsupportedOperationExceptionWhenInitializingStateStor
         final String changelogName = "test-application-my-store-changelog";
         final List<TopicPartition> partitions = Utils.mkList(new TopicPartition(changelogName, 0));
         consumer.assign(partitions);
-        Map<TopicPartition, OffsetAndMetadata> committedOffsets = new HashMap<>();
+        final Map<TopicPartition, OffsetAndMetadata> committedOffsets = new HashMap<>();
         committedOffsets.put(new TopicPartition(changelogName, 0), new OffsetAndMetadata(0L));
         consumer.commitSync(committedOffsets);
 
@@ -326,9 +329,51 @@ public void shouldNotThrowUnsupportedOperationExceptionWhenInitializingStateStor
         final ProcessorTopology topology = builder.setApplicationId(applicationId).build(0);
         StreamsConfig config = createConfig(baseDir);
         new StandbyTask(taskId, applicationId, partitions, topology, consumer, restoreStateConsumer, config,
-            new MockStreamsMetrics(new Metrics()), stateDirectory);
+                        new MockStreamsMetrics(new Metrics()), stateDirectory);
 
     }
+
+    @Test
+    public void shouldCheckpointStoreOffsetsOnCommit() throws Exception {
+        consumer.assign(Utils.mkList(ktable));
+        final Map<TopicPartition, OffsetAndMetadata> committedOffsets = new HashMap<>();
+        committedOffsets.put(new TopicPartition(ktable.topic(), ktable.partition()), new OffsetAndMetadata(100L));
+        consumer.commitSync(committedOffsets);
+
+        restoreStateConsumer.updatePartitions("ktable1", Utils.mkList(
+                new PartitionInfo("ktable1", 0, Node.noNode(), new Node[0], new Node[0])));
+
+        final TaskId taskId = new TaskId(0, 0);
+        final StreamsConfig config = createConfig(baseDir);
+        final StandbyTask task = new StandbyTask(taskId,
+                                                 applicationId,
+                                                 ktablePartitions,
+                                                 ktableTopology,
+                                                 consumer,
+                                                 restoreStateConsumer,
+                                                 config,
+                                                 null,
+                                                 stateDirectory
+        );
+
+
+        restoreStateConsumer.assign(new ArrayList<>(task.changeLogPartitions()));
+
+        final byte[] serializedValue = Serdes.Integer().serializer().serialize("", 1);
+        task.update(ktable, Collections.singletonList(new ConsumerRecord<>(ktable.topic(),
+                                                                           ktable.partition(),
+                                                                           50L,
+                                                                           serializedValue,
+                                                                           serializedValue)));
+
+        task.commit();
+
+        final Map<TopicPartition, Long> checkpoint = new OffsetCheckpoint(new File(stateDirectory.directoryForTask(taskId),
+                                                                                   ProcessorStateManager.CHECKPOINT_FILE_NAME)).read();
+        assertThat(checkpoint, equalTo(Collections.singletonMap(ktable, 51L)));
+
+    }
+
     private List<ConsumerRecord<byte[], byte[]>> records(ConsumerRecord<byte[], byte[]>... recs) {
         return Arrays.asList(recs);
     }
diff --git a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamTaskTest.java b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamTaskTest.java
index 0479b9d5e34d4..7f27fc4a46ebe 100644
--- a/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamTaskTest.java
+++ b/streams/src/test/java/org/apache/kafka/streams/processor/internals/StreamTaskTest.java
@@ -22,6 +22,8 @@
 import org.apache.kafka.clients.consumer.OffsetResetStrategy;
 import org.apache.kafka.clients.producer.MockProducer;
 import org.apache.kafka.common.KafkaException;
+import org.apache.kafka.common.Node;
+import org.apache.kafka.common.PartitionInfo;
 import org.apache.kafka.common.TopicPartition;
 import org.apache.kafka.common.metrics.Metrics;
 import org.apache.kafka.common.record.TimestampType;
@@ -39,6 +41,8 @@
 import org.apache.kafka.streams.processor.ProcessorContext;
 import org.apache.kafka.streams.processor.StateStore;
 import org.apache.kafka.streams.processor.TaskId;
+import org.apache.kafka.streams.state.internals.InMemoryKeyValueStore;
+import org.apache.kafka.streams.state.internals.OffsetCheckpoint;
 import org.apache.kafka.streams.state.internals.ThreadCache;
 import org.apache.kafka.test.MockProcessorNode;
 import org.apache.kafka.test.MockSourceNode;
@@ -59,6 +63,8 @@
 import java.util.Set;
 import java.util.concurrent.atomic.AtomicBoolean;
 
+import static org.hamcrest.MatcherAssert.assertThat;
+import static org.hamcrest.core.IsEqual.equalTo;
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertFalse;
 import static org.junit.Assert.assertNotNull;
@@ -437,6 +443,63 @@ public void flush() {
         assertTrue(flushed.get());
     }
 
+
+    @SuppressWarnings("unchecked")
+    @Test
+    public void shouldCheckpointOffsetsOnCommit() throws Exception {
+        final String storeName = "test";
+        final String changelogTopic = ProcessorStateManager.storeChangelogTopic("appId", storeName);
+        final InMemoryKeyValueStore inMemoryStore = new InMemoryKeyValueStore(storeName, null, null) {
+            @Override
+            public void init(final ProcessorContext context, final StateStore root) {
+                context.register(root, true, null);
+            }
+
+            @Override
+            public boolean persistent() {
+                return true;
+            }
+        };
+        final ProcessorTopology topology = new ProcessorTopology(Collections.<ProcessorNode>emptyList(),
+                                                                 Collections.<String, SourceNode>emptyMap(),
+                                                                 Collections.<String, SinkNode>emptyMap(),
+                                                                 Collections.<StateStore>singletonList(inMemoryStore),
+                                                                 Collections.singletonMap(storeName, changelogTopic),
+                                                                 Collections.<StateStore>emptyList());
+
+        final TopicPartition partition = new TopicPartition(changelogTopic, 0);
+        final NoOpRecordCollector recordCollector = new NoOpRecordCollector() {
+            @Override
+            public Map<TopicPartition, Long> offsets() {
+
+                return Collections.singletonMap(partition, 543L);
+            }
+        };
+
+        restoreStateConsumer.updatePartitions(changelogTopic,
+                                              Collections.singletonList(
+                                                      new PartitionInfo(changelogTopic, 0, null, new Node[0], new Node[0])));
+        restoreStateConsumer.updateEndOffsets(Collections.singletonMap(partition, 0L));
+        restoreStateConsumer.updateBeginningOffsets(Collections.singletonMap(partition, 0L));
+
+        final StreamsMetrics streamsMetrics = new MockStreamsMetrics(new Metrics());
+        final TaskId taskId = new TaskId(0, 0);
+        final MockTime time = new MockTime();
+        final StreamsConfig config = createConfig(baseDir);
+        final StreamTask streamTask = new StreamTask(taskId, "appId", partitions, topology, consumer,
+                                                     restoreStateConsumer, config, streamsMetrics,
+                                                     stateDirectory, new ThreadCache("testCache", 0, streamsMetrics),
+                                                     time, recordCollector);
+
+        time.sleep(config.getLong(StreamsConfig.COMMIT_INTERVAL_MS_CONFIG));
+
+        streamTask.commit();
+        final OffsetCheckpoint checkpoint = new OffsetCheckpoint(new File(stateDirectory.directoryForTask(taskId),
+                                                                          ProcessorStateManager.CHECKPOINT_FILE_NAME));
+
+        assertThat(checkpoint.read(), equalTo(Collections.singletonMap(partition, 544L)));
+    }
+
     private Iterable<ConsumerRecord<byte[], byte[]>> records(ConsumerRecord<byte[], byte[]>... recs) {
         return Arrays.asList(recs);
     }
diff --git a/streams/src/test/java/org/apache/kafka/test/GlobalStateManagerStub.java b/streams/src/test/java/org/apache/kafka/test/GlobalStateManagerStub.java
index 2f3ef26635ecf..612a0da47e6d4 100644
--- a/streams/src/test/java/org/apache/kafka/test/GlobalStateManagerStub.java
+++ b/streams/src/test/java/org/apache/kafka/test/GlobalStateManagerStub.java
@@ -66,6 +66,11 @@ public void close(final Map<TopicPartition, Long> offsets) throws IOException {
         closed = true;
     }
 
+    @Override
+    public void checkpoint(final Map<TopicPartition, Long> offsets) {
+        this.offsets.putAll(offsets);
+    }
+
     @Override
     public StateStore getGlobalStore(final String name) {
         return null;
@@ -77,7 +82,7 @@ public StateStore getStore(final String name) {
     }
 
     @Override
-    public Map<TopicPartition, Long> checkpointedOffsets() {
+    public Map<TopicPartition, Long> checkpointed() {
         return offsets;
     }
 }
diff --git a/streams/src/test/java/org/apache/kafka/test/ProcessorTopologyTestDriver.java b/streams/src/test/java/org/apache/kafka/test/ProcessorTopologyTestDriver.java
index 89ca0df9e584c..7ace43a7538c9 100644
--- a/streams/src/test/java/org/apache/kafka/test/ProcessorTopologyTestDriver.java
+++ b/streams/src/test/java/org/apache/kafka/test/ProcessorTopologyTestDriver.java
@@ -204,7 +204,8 @@ public List<PartitionInfo> partitionsFor(String topic) {
             final GlobalStateManagerImpl stateManager = new GlobalStateManagerImpl(globalTopology, globalConsumer, stateDirectory);
             globalStateTask = new GlobalStateUpdateTask(globalTopology,
                                                         new GlobalProcessorContextImpl(config, stateManager, streamsMetrics, cache),
-                                                        stateManager);
+                                                        stateManager
+            );
             globalStateTask.initialize();
         }