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 <vvcep...@users.noreply.github.com>
AuthorDate: Fri Jan 11 19:16:43 2019 -0600
KAFKA-7741: streams-scala - document dependency workaround (#6125)
Reviewers: Guozhang Wang <wangg...@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 [...]
