Set Up and Connect the Couchbase Java SDK

xml
ViewCopy
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>couchbase-java</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>16</maven.compiler.source>
        <maven.compiler.target>16</maven.compiler.target>
        <encoding>UTF-8</encoding>
        <project.build.sourceEncoding>${encoding}</project.build.sourceEncoding>
        <project.reporting.outputEncoding>${encoding}</project.reporting.outputEncoding>
        <project.resources.sourceEncoding>${encoding}</project.resources.sourceEncoding>
        <archetype.encoding>${encoding}</archetype.encoding>
    </properties>

    <!-- The `<dependencies>` section of the code block lists all the libraries required to build your application. In the case of the student record tutorial, you only need the Couchbase client SDK and Log4J. -->
    <dependencies>   
        <dependency>
            <groupId>com.couchbase.client</groupId>
            <artifactId>java-client</artifactId>
            <version>3.7.9</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>2.0.9</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-simple</artifactId>
            <version>2.0.9</version>
        </dependency>
    </dependencies>

</project>

java
ViewCopy
import com.couchbase.client.java.Bucket;
import com.couchbase.client.java.Cluster;
import com.couchbase.client.java.Collection;
import com.couchbase.client.java.Scope;
import com.couchbase.client.java.ClusterOptions;
import java.time.Duration;

public class ConnectStudent {

    public static void main(String[] args) {

        String connectionString = "<<connection-string>>"; // Replace this with Connection String
        String username = "<<username>>"; // Replace this with username from cluster access credentials
        String password = "<<password>>"; // Replace this with password from cluster access credentials
        
        //Connecting to the cluster
        Cluster cluster = Cluster.connect(connectionString, ClusterOptions.clusterOptions(username, password)
        // Use the pre-configured profile below to avoid latency issues with your connection.
                    .environment(env -> env.applyProfile("wan-development"))
        );

        // The `cluster.bucket` retrieves the bucket you set up for the student cluster.
        Bucket bucket = cluster.bucket("student-bucket");  

        // Most of the Couchbase APIs are non-blocking. 
        // When you call one of them, your application carries on and continues to perform other actions while the function you called executes. 
        // When the function has finished executing, it sends a notification to the caller and the output of the call is processed.
        // While this usually works, in this code sample the application carries on without waiting for the bucket retrieval to complete after you make the call to `cluster.bucket`. 
        // This means that you now have to try to retrieve the scope from a bucket object that has not been fully initialized yet. 
        // To fix this, you can use the `waitUntilReady` call. 
        // This call forces the application to wait until the bucket object is ready.
        bucket.waitUntilReady(Duration.ofSeconds(10));  

        // The `bucket.scope` retrieves the `art-school-scope` from the bucket.
        Scope scope = bucket.scope("art-school-scope");   

        // The `scope.collection` retrieves the student collection from the scope.
        Collection student_records = scope.collection("student-record-collection"); 

        // A check to make sure the collection is connected and retrieved when you run the application. 
        // You can see the output using maven.
        System.out.println("The name of this collection is " + student_records.name()); 

        // Like with all database systems, it's good practice to disconnect from the Couchbase cluster after you have finished working with it.
        cluster.disconnect();
    }
}

sh
Copy
mvn exec:java -Dexec.mainClass="ConnectStudent" -Dexec.cleanupDaemonThreads=false