From commits-return-10997-archive-asf-public=cust-asf.ponee.io@kafka.apache.org Sat Jan 12 02:14:16 2019 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by mx-eu-01.ponee.io (Postfix) with SMTP id 16541180648 for ; Sat, 12 Jan 2019 02:14:15 +0100 (CET) Received: (qmail 12073 invoked by uid 500); 12 Jan 2019 01:14:15 -0000 Mailing-List: contact commits-help@kafka.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@kafka.apache.org Delivered-To: mailing list commits@kafka.apache.org Received: (qmail 12064 invoked by uid 99); 12 Jan 2019 01:14:15 -0000 Received: from ec2-52-202-80-70.compute-1.amazonaws.com (HELO gitbox.apache.org) (52.202.80.70) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 12 Jan 2019 01:14:15 +0000 Received: by gitbox.apache.org (ASF Mail Server at gitbox.apache.org, from userid 33) id 7D7E78706D; Sat, 12 Jan 2019 01:14:14 +0000 (UTC) Date: Sat, 12 Jan 2019 01:14:14 +0000 To: "commits@kafka.apache.org" Subject: [kafka-site] branch asf-site updated: KAFKA-7741: streams-scala - document dependency workaround (#180) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Message-ID: <154725565443.4017.3280586871758658160@gitbox.apache.org> From: guozhang@apache.org X-Git-Host: gitbox.apache.org X-Git-Repo: kafka-site X-Git-Refname: refs/heads/asf-site X-Git-Reftype: branch X-Git-Oldrev: b480383139bac2f139fef2ae87c6dd153cf7ecf4 X-Git-Newrev: a140802b0433b830a949ab502e5a2faeccfb166f X-Git-Rev: a140802b0433b830a949ab502e5a2faeccfb166f X-Git-NotificationType: ref_changed_plus_diff X-Git-Multimail-Version: 1.5.dev Auto-Submitted: auto-generated This is an automated email from the ASF dual-hosted git repository. guozhang pushed a commit to branch asf-site in repository https://gitbox.apache.org/repos/asf/kafka-site.git The following commit(s) were added to refs/heads/asf-site by this push: new a140802 KAFKA-7741: streams-scala - document dependency workaround (#180) a140802 is described below commit a140802b0433b830a949ab502e5a2faeccfb166f Author: John Roesler AuthorDate: Fri Jan 11 19:14:10 2019 -0600 KAFKA-7741: streams-scala - document dependency workaround (#180) Reviewers: Bill Bejeck , Guozhang Wang --- 20/streams/developer-guide/dsl-api.html | 26 ++++++++++++++++++++++++++ 21/streams/developer-guide/dsl-api.html | 11 +++++++++++ 2 files changed, 37 insertions(+) diff --git a/20/streams/developer-guide/dsl-api.html b/20/streams/developer-guide/dsl-api.html index aa44dea..a348c0a 100644 --- a/20/streams/developer-guide/dsl-api.html +++ b/20/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 
               libraryDependencies += "org.apache.kafka" %% "kafka-streams-scala" % "{{fullDotVersion}}"
+

+ Notes: +

    +
  • + The bugfix version 2.0.1 fixed several important flaws in kafka-streams-scala. + It's strongly recommended to use the latest bugfix release in general and to avoid kafka-streams-scala 2.0.0 specifically. +
    • +
  • +

    + There is an upstream dependency that causes trouble in SBT builds. This problem is fixed in 2.0.2, 2.1.1, and 2.2.0. + Please consider using one of those versions or higher. +

    +

    + If you must use an earlier version, you may add an explicit dependency on the problematic library as a workaround: +

    +
    2.0.0
    + 
    libraryDependencies += "javax.ws.rs" % "javax.ws.rs-api" % "2.1" artifacts(Artifact("javax.ws.rs-api", "jar", "jar"))
    +
    2.0.1
    + 
    libraryDependencies += "javax.ws.rs" % "javax.ws.rs-api" % "2.1" artifacts(Artifact("javax.ws.rs-api", "jar", "jar"))
    +
    2.1.0
    + 
    libraryDependencies += "javax.ws.rs" % "javax.ws.rs-api" % "2.1.1" artifacts(Artifact("javax.ws.rs-api", "jar", "jar"))
    +
    +

    +
    • +
+

Sample Usage

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 org.apache.kafka.streams.scala.StreamsBuilder is a wrapper around libraryDependencies += "org.apache.kafka" %% "kafka-streams-scala" % "{{fullDotVersion}}" +

+ Note: +

+ There is an upstream dependency that causes trouble in SBT builds. This problem is fixed in 2.1.1, and 2.2.0. + Please consider using one of those versions or higher. +

+

+ If you must use an earlier version, you may add an explicit dependency on the problematic library as a workaround: + 

libraryDependencies += "javax.ws.rs" % "javax.ws.rs-api" % "2.1.1" artifacts(Artifact("javax.ws.rs-api", "jar", "jar"))
+

+

Sample Usage

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 org.apache.kafka.streams.scala.StreamsBuilder is a wrapper around