|
| 1 | += Platform Introduction |
| 2 | +:description: pass:q[A simple Java orientation intro for _non-Java_ folk who are evaluating the Couchbase Scala SDK.] |
| 3 | +:page-toclevels: 2 |
| 4 | + |
| 5 | +// https://couchbasecloud.atlassian.net/wiki/spaces/SWD/pages/2137194599/Scala |
| 6 | + |
| 7 | + |
| 8 | +[abstract] |
| 9 | +{description} |
| 10 | + |
| 11 | + |
| 12 | +[IMPORTANT] |
| 13 | +.Is This Page for You? |
| 14 | +==== |
| 15 | +This page is to help evaluate the Couchbase Java SDK, if Java is not where you spend the majority of your working day. |
| 16 | +It is aimed at Software Architects, QE folk, managers, and anyone else who needs to run through using the Java SDK without necessarily being comfortable with the Java environment. |
| 17 | +If this is not you, head back to the xref:overview.adoc[rest of the Couchbase Java SDK documentation]. |
| 18 | +==== |
| 19 | + |
| 20 | + |
| 21 | +// It may be that you are a Java developer trying out our Scala SDK, or someone else who has a JDK installed, in which case feel free to skip ahead a section, but note that we will be installing `sdkman` in the next section, and using that to manage Scala installation. |
| 22 | + |
| 23 | + |
| 24 | +== JVM Installation |
| 25 | + |
| 26 | +Java is a JVM language - like Scala, Kotlin, and Clojure, it runs on a Java Virtual Machine. |
| 27 | +Running JVM programs necessitates a Java Runtime Environment (JRE), but to develop a Scala (say) or Java app you need a Java Development Kit (JDK). |
| 28 | +The Couchbase Java SDK can run on any LTS (long-term support) JDK -- |
| 29 | +see the xref:project-docs:compatibility.adoc[compatibility page] for full information. |
| 30 | + |
| 31 | +To install the JDK we are going to use a JVM-management tool called `sdkman`. |
| 32 | + |
| 33 | + |
| 34 | + |
| 35 | +=== SDKMAN! |
| 36 | + |
| 37 | +SDKMAN! -- the Software Development Kit Manager -- enables multiple Java versions and runtimes to be installed and managed, without intefering with your system's default JVM. |
| 38 | + |
| 39 | +This third party tool is unnecessary in most production environments, but ideal for development machines. |
| 40 | +Installation instructions can be found on the https://sdkman.io/install[SDKMAN! website]. |
| 41 | + |
| 42 | +Once SDKMAN! is installed, use it to install the latest version of Scala 2.13: |
| 43 | + |
| 44 | +[source,console] |
| 45 | +---- |
| 46 | +$ sdk install java 23.0.2-oracle |
| 47 | +---- |
| 48 | + |
| 49 | +You may be prompted to set that version as a default -- say yes (by pressing *<Enter>*). |
| 50 | +More details of SDKMAN! use can be found on the https://sdkman.io/install[SDKMAN! website]. |
| 51 | + |
0 commit comments