kafka-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From guozh...@apache.org
Subject [kafka] branch 2.0 updated: KAFKA-7741: streams-scala - document dependency workaround (#6125)
Date Sat, 12 Jan 2019 01:16:53 GMT
This is an automated email from the ASF dual-hosted git repository.

guozhang pushed a commit to branch 2.0
in repository https://gitbox.apache.org/repos/asf/kafka.git


The following commit(s) were added to refs/heads/2.0 by this push:
     new c5ed908  KAFKA-7741: streams-scala - document dependency workaround (#6125)
c5ed908 is described below

commit c5ed908476901e2513c342b3a2b8829b951b7f5c
Author: John Roesler <vvcephei@users.noreply.github.com>
AuthorDate: Fri Jan 11 19:16:43 2019 -0600

    KAFKA-7741: streams-scala - document dependency workaround (#6125)
    
    Reviewers: Guozhang Wang <wangguoz@gmail.com>
---
 docs/streams/developer-guide/dsl-api.html | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/docs/streams/developer-guide/dsl-api.html b/docs/streams/developer-guide/dsl-api.html
index aa44dea..a348c0a 100644
--- a/docs/streams/developer-guide/dsl-api.html
+++ b/docs/streams/developer-guide/dsl-api.html
@@ -3290,6 +3290,32 @@ t=5 (blue), which lead to a merge of sessions and an extension of a
session, res
             <pre class="brush: scala;">
               libraryDependencies += "org.apache.kafka" %% "kafka-streams-scala" % "{{fullDotVersion}}"
             </pre>
+            <p>
+              <strong>Notes</strong>:
+              <ul>
+                <li>
+                  The bugfix version <code>2.0.1</code> fixed several important
flaws in  <code class="docutils literal"><span class="pre">kafka-streams-scala</span></code>.
+                  It's strongly recommended to use the latest bugfix release in general and
to avoid <code>kafka-streams-scala 2.0.0</code> specifically.
+                </li>
+                <li>
+                  <p>
+                    There is an upstream dependency that causes trouble in SBT builds. This
problem is fixed in <code>2.0.2</code>, <code>2.1.1</code>, and <code>2.2.0</code>.
+                    Please consider using one of those versions or higher.
+                  </p>
+                  <p>
+                    If you must use an earlier version, you may add an explicit dependency
on the problematic library as a workaround:
+                    <dl>
+                      <dt><code>2.0.0</code></dt>
+                      <dd><pre class="brush: scala;">libraryDependencies += "javax.ws.rs"
% "javax.ws.rs-api" % "2.1" artifacts(Artifact("javax.ws.rs-api", "jar", "jar"))</pre></dd>
+                      <dt><code>2.0.1</code></dt>
+                      <dd><pre class="brush: scala;">libraryDependencies += "javax.ws.rs"
% "javax.ws.rs-api" % "2.1" artifacts(Artifact("javax.ws.rs-api", "jar", "jar"))</pre></dd>
+                      <dt><code>2.1.0</code></dt>
+                      <dd><pre class="brush: scala;">libraryDependencies += "javax.ws.rs"
% "javax.ws.rs-api" % "2.1.1" artifacts(Artifact("javax.ws.rs-api", "jar", "jar"))</pre></dd>
+                    </dl>
+                  </p>
+                </li>
+              </ul>
+            </p>
             <div class="section" id="scala-dsl-sample-usage">
               <span id="streams-developer-guide-dsl-sample-usage"></span><h3><a
class="toc-backref" href="#id28">Sample Usage</a><a class="headerlink" href="#scala-dsl-sample-usage"
title="Permalink to this headline"></a></h3>
               <p>The library works by wrapping the original Java abstractions of Kafka
Streams within a Scala wrapper object and then using implicit conversions between them. All
the Scala abstractions are named identically as the corresponding Java abstraction, but they
reside in a different package of the library e.g. the Scala class <code class="docutils
literal"><span class="pre">org.apache.kafka.streams.scala.StreamsBuilder</span></code>
is a wrapper around <code class="docutils lit [...]


Mime
View raw message