OpenLiberty · dmuelle · May 10, 2024 · Feb 12, 2024 · Feb 12, 2024 · Feb 13, 2024
diff --git a/img/blog/arangodb.png b/img/blog/arangodb.png
diff --git a/img/blog/column-nosql.png b/img/blog/column-nosql.png
diff --git a/img/blog/couchbase-01.png b/img/blog/couchbase-01.png
diff --git a/img/blog/couchbase-02.png b/img/blog/couchbase-02.png
diff --git a/img/blog/couchbase-03.png b/img/blog/couchbase-03.png
diff --git a/img/blog/couchbase-04.png b/img/blog/couchbase-04.png
diff --git a/img/blog/couchbase-05.png b/img/blog/couchbase-05.png
diff --git a/img/blog/couchbase-06.png b/img/blog/couchbase-06.png
diff --git a/img/blog/couchbase-verification-01.png b/img/blog/couchbase-verification-01.png
diff --git a/img/blog/couchbase-verification-02.png b/img/blog/couchbase-verification-02.png
diff --git a/img/blog/couchbase.png b/img/blog/couchbase.png
diff --git a/img/blog/db-engine-ranking-2024-02.png b/img/blog/db-engine-ranking-2024-02.png
diff --git a/img/blog/document-nosql.png b/img/blog/document-nosql.png
diff --git a/img/blog/graph-nosql.png b/img/blog/graph-nosql.png
diff --git a/img/blog/jnopo-architecture-without-persistence.png b/img/blog/jnopo-architecture-without-persistence.png
diff --git a/img/blog/jnopo-sequence-diagram-without-persistence.gif b/img/blog/jnopo-sequence-diagram-without-persistence.gif
diff --git a/img/blog/jnopo-sequence-diagram-without-persistence.png b/img/blog/jnopo-sequence-diagram-without-persistence.png
diff --git a/img/blog/jnosql.png b/img/blog/jnosql.png
diff --git a/img/blog/key-value-nosql.png b/img/blog/key-value-nosql.png
diff --git a/img/blog/mongo-express-01.png b/img/blog/mongo-express-01.png
diff --git a/img/blog/mongo-express-02.png b/img/blog/mongo-express-02.png
diff --git a/img/blog/mongo-express-03.png b/img/blog/mongo-express-03.png
diff --git a/img/blog/mongo-express-04.png b/img/blog/mongo-express-04.png
diff --git a/img/blog/mongo-express.png b/img/blog/mongo-express.png
diff --git a/img/blog/mongodb.png b/img/blog/mongodb.png
diff --git a/img/blog/orientdb.png b/img/blog/orientdb.png
diff --git a/img/blog/swagger-ui-01.png b/img/blog/swagger-ui-01.png
diff --git a/img/blog/swagger-ui-02.png b/img/blog/swagger-ui-02.png
diff --git a/posts/2024-05-11-simplifying-nosql-database-integration-with-jakarta-nosql.adoc b/posts/2024-05-11-simplifying-nosql-database-integration-with-jakarta-nosql.adoc
diff --git a/posts/2024-05-13-jakarta-nosql-in-action-meet-jnopo-game.adoc b/posts/2024-05-13-jakarta-nosql-in-action-meet-jnopo-game.adoc
diff --git a/posts/2024-05-14-jakarta-nosql-challenge-switching-nosql-easily.adoc b/posts/2024-05-14-jakarta-nosql-challenge-switching-nosql-easily.adoc
@@ -0,0 +1,222 @@
+---
+layout: post
+title: "Jakarta NoSQL in Action: Switching NoSQL Databases with Ease"
+# Do NOT change the categories section
+categories: blog
+author_picture: https://avatars3.githubusercontent.com/dearrudam
+author_github: https://github.com/dearrudam
+seo-title: TITLE - OpenLiberty.io
+seo-description: In this cloud era, switching between NoSQL solutions could be a great way to save resources and costs, but it could be a nightmare, especially if we're highly coupled to a particular vendor. See how the flexibility of Jakarta NoSQL with an implementation like Eclipse JNoSQL could help to solve this issue.
+
+blog_description: "In this cloud era, switching between NoSQL solutions could be a great way to save resources and costs, but it could be a nightmare, especially if we're highly coupled to a particular vendor. See how the flexibility of Jakarta NoSQL with an implementation like Eclipse JNoSQL could help to solve this issue."
+open-graph-image: https://openliberty.io/img/twitter_card.jpg
+open-graph-image-alt: Open Liberty Logo
+---
+= Jakarta NoSQL in Action: Switching NoSQL Databases with Ease
+Maximillian Arruda <https://github.com/dearrudam>
+:imagesdir: /
+:url-prefix:
+:url-about: /
+:toc: preamble
+
+In the cloud era, switching between NoSQL solutions could be an interesting way to save resources and costs. It could also be a nightmare, especially if we're highly coupled to a particular vendor. Certain changes could make this approach very expensive, e.g.: time spent on the change, the learning curve of a new API to use with this database, the code that will be lost, the persistence layer that needs to be replaced, etc.
+
+This is where the flexibility of Jakarta NoSQL, with an implementation like link:https://www.jnosql.org[Eclipse JNoSQL], shines.
+
+NOTE: As of March 2024, Eclipse JNoSQL supports about https://www.jnosql.org/docs/supported_dbs.html[30 NoSQL databases].
+
+To explore this capability, let's use the link:{url-prefix}/blog/2024/05/13/jakarta-nosql-in-action-meet-jnopo-game.html[*JNopo* game] introduced in blog 2 of this series.
+
+In our scenario, let's suppose that we need to change the JNopo's Document NoSQL database from MongoDB, to another Document NoSQL database (Couchbase) to save money. The good thing is that because we've already used the Jakarta NoSQL specification to connect to our NoSQL solutions in this application, with just a few small changes we'll be able to achieve this goal easily. Let's take a look at the steps we need to take for this.
+
+
+== Configuring Eclipse JNoSQL dependencies for Couchbase
+
+The first step we need to take is to add the Couchbase dependency to our the `pom.xml` file:
+
+[source, xml]
+----
+<dependency>
+  <groupId>org.eclipse.jnosql.databases</groupId>
+  <artifactId>jnosql-couchbase</artifactId>
+  <version>1.1.0</version>
+</dependency>
+----
+
+== Configuring a local Couchbase cluster
+
+To successfully configure our new Couchbase cluster, we'll first need to add the following content to the `docker-compose.yml` file:
+
+[source, yaml]
+----
+  couchbase-db:
+    image: couchbase
+    container_name: couchbase-db
+    ports:
+      - "8091-8097:8091-8097"
+      - "9123:9123"
+      - "11207:11207"
+      - "11210:11210"
+      - "11280:11280"
+      - "18091-18097:18091-18097"
+----
+
+After we apply these changes, we then need to initialize the container by executing the following command:
+
+[source, bash]
+----
+docker-compose up -d
+----
+
+Now, let's configure the Couchbase cluster for this example scenario:
+
+. With the Couchbase container started, go to: http://localhost:8091/ui/index.html.
+. Select the *Setup New Cluster* option.
++
+[.img_border_light]
+image::/img/blog/couchbase-01.png[Couchbase 01, align="center" width=80%]
+. Define a name for the cluster.
+. Set `root` as the Admin Username.
+. Set `123456` as the Password.
++
+[.img_border_light]
+image::/img/blog/couchbase-02.png[Couchbase 02, align="center" width=80%]
+. Check *I accept the terms and conditions* and click the *Finish With Defaults* button.
++
+[.img_border_light]
+image::/img/blog/couchbase-03.png[Couchbase 03, align="center" width=80%]
+. Go to the *Buckets* section.
+. Create a `jnopo` Bucket by clicking on the *Add Bucket* option
++
+[.img_border_light]
+image::/img/blog/couchbase-04.png[Couchbase 04, align="center" width=80%]
+. Click *Scopes & Collections* and then click *Add Collection*.
+. Enter `GameMatch` as the collection name and click the *Save* button to complete your creation.
++
+[.img_border_light]
+image::/img/blog/couchbase-05.png[Couchbase 05, align="center" width=80%]
+. Now, in the *Query Editor* section, run the command link:https://www.couchbase.com/products/n1ql/[N1QL] command to create the primary index for the `GameMatch` collection:
++
+[source, n1ql]
+----
+CREATE PRIMARY INDEX primaryGameMatch ON jnopo._default.GameMatch
+----
++
+[.img_border_light]
+image::/img/blog/couchbase-06.png[Couchbase 06, align="center" width=80%]
+
+With a Couchbase cluster running, we just need to set up Eclipse JNoSQL to connect to it.
+
+Apply the following changes into the `resources/META-INF/microprofile-config.properties` file:
+
+[source, properties]
+----
+## Couchbase
+jnosql.couchbase.host=couchbase://localhost
+jnosql.couchbase.user=root
+jnosql.couchbase.password=123456
+jnosql.document.provider=org.eclipse.jnosql.databases.couchbase.communication.CouchbaseDocumentConfiguration
+----
+
+The `jnosql.document.provider` property is required in this context because we have more than one Eclipse JNoSQL Database API for Document NoSQL implementations. You can learn more about the configurations available for Eclipse JNoSQL Database API for Couchbase in this https://github.com/eclipse/jnosql-databases/tree/main?tab=readme-ov-file#configuration-2[Git repository].
+
+That's all! Let's restart the https://openliberty.io/[Open Liberty] runtime to make sure that everything is running smoothly:
+
+* On Linux/Mac machines, run the following command:
++
+[source, bash]
+----
+./mvnw liberty:dev
+----
+
+* On Windows machines, run the following command:
++
+[source, powershell]
+----
+mvnw.cmd liberty:dev
+----
+
+After some game matches, you should see something similar to the following images to prove that this data is now being stored in our new Couchbase database.
+
+[.img_border_light]
+image::/img/blog/couchbase-verification-01.png[Couchbase Verification 01, align="center" width=80%]
+[.img_border_light]
+image::/img/blog/couchbase-verification-02.png[Couchbase Verification 02, align="center" width=80%]
+
+If you're interesting to take a look on the finished project code developed during this challenge, clone this https://github.com/OpenLiberty/sample-jakartaNoSQL-game[Git repository] and navigate to the `database-switching-challenge` directory.
+
+[source, bash]
+----
+git clone https://github.com/OpenLiberty/sample-jakartaNoSQL-game.git
+cd sample-jakartaNoSQL-game
+cd database-switching-challenge
+----
+
+== Key takeaways
+
+This blog has shown just how easy it can be to switch between NoSQL solutions by using Jakarta NoSQL, bringing one more item to your utility belt that could be useful in helping you save resources and costs.
+
+By reading this blog, you should now be familiar with:
+
+* How to set up the Couchbase database cluster for development purposes;
+
+* How to switch between NoSQL database from different vendors, in our example: switching from MongoDB to Couchbase;
+
+== Next steps: continuing the journey
+
+Congratulations on getting this far!
+
+This blog post is the 3rd part of a set of blog posts:
+
+* link:{url-prefix}/blog/2024/05/11/simplifying-nosql-database-integration-with-jakarta-nosql.html[Simplifying NoSQL Database Integration with Jakarta NoSQL, window="_blank"];
+* link:{url-prefix}/blog/2024/05/13/jakarta-nosql-in-action-meet-jnopo-game.html[Jakarta NoSQL in Action: JNopo Game, window="_blank"];
+
+To see more sample projects, take a look at the official Eclipse JNoSQL samples repositories:
+
+- https://github.com/jnosql/demos-se
+- https://github.com/JNOSQL/demos-ee
+
+To learn more about Eclipse JNoSQL, take a look at these official repositories:
+
+- https://github.com/eclipse/jnosql
+- https://github.com/eclipse/jnosql-databases
+- https://github.com/eclipse/jnosql-extensions
+
+if you're an expert on some NoSQL database that Eclipse JNoSQL doesn't support, feel free to open an issue or a PR on the project repositories mentioned above. Except for the NoSQL solutions mentioned like MongoDB and Couchbase, all the technology used in this blog post are open-source, so, what do you think about contributing to these projects? If you don't know how to get started to contribute, take a look at this https://www.youtube.com/live/7qhHOOoZEBU?feature=share[Coffee.withJava("Contribute to JNoSQL") Youtube Series], or if you prefer, feel free to contact me! Contributing to these projects is not just with codes, you could help a lot by promoting and speaking about them wherever you go! Contributing to open-source is a great way to boost your career, and improve your skills to become an effective developer and relevant in the market! Think about that!
+
+== Special thanks
+
+I'm bursting with gratitude and would love to give a big shout-out to my incredible Java community friends for their unwavering support throughout my journey. A special round of applause for:
+
+- Otavio Santana, you're not just a mentor but a guiding star in my open-source journey. Your mentorship has opened doors for me to become an active open-source contributor and a proud Eclipse Foundation committer. Thank you for being such a monumental part of my journey. Also, thanks for your insightful reviews of the codes featured in this blog post.
+
+- Karina Varela, your keen eye for detail and your generosity in sharing your knowledge have enriched this content beyond measure. Your thoughtful reviews have made this content not just better, but truly curated and relevant. I'm so grateful for your contribution.
+
+- Fabio Franco, you were the catalyst for this wonderful opportunity, connecting me with the fantastic OpenLiberty team and offering your support throughout the publishing process of this blog post. Your belief in me and your encouragement have been invaluable. Thank you for making this possible.
+
+- And to the OpenLiberty team, thank you for opening your doors and allowing me the privilege to share and post this content that I've thoroughly enjoyed working on. Thanks for this opportunity.
+
+To each of you, your support means a lot to me, and I'm deeply thankful.
+
+== References and Further Reading
+
+* Official documentation:
+** https://jnosql.org[Eclipse JNoSQL website]
+** https://jakarta.ee/specifications/[Jakarta EE Specifications]
+
+* Articles:
+** https://dzone.com/articles/jakarta-nosql-100-b5-how-to-make-your-life-easier[Jakarta NoSQL 1.0.0-b5: How To Make Your Life Easier Around Enterprise Java and NoSQL Databases by Otavio Santana]
+** https://dzone.com/articles/eclipse-jnosql-100-streamlining-java-and-nosql-int[Eclipse JNoSQL 1.0.0: Streamlining Java and NoSQL Integration With New Features and Bug Fixes by Otavio Santana]
+** https://dzone.com/articles/mastering-java-persistence-best-practices-for-clou[Mastering Java Persistence: Best Practices for Cloud-Native Applications and Modernization by Otavio Santana]
+** https://dzone.com/articles/eclipse-jnosql-102-empowering-java-with-nosql-data[Eclipse JNoSQL 1.0.2: Empowering Java With NoSQL Database Flexibility by Otavio Santana]
+** https://blogs.oracle.com/nosql/post/getting-started-accessing-oracle-nosql-database-using-jakarta-nosql[Getting Started - Accessing Oracle NoSQL Database using Jakarta NoSQL by Dario VEGA]
+** https://dzone.com/articles/exploring-the-new-eclipse-jnosql-version-110-a-div[Exploring the New Eclipse JNoSQL Version 1.1.0: A Dive Into Oracle NoSQL by Otavio Santana]
+** https://eldermoraes.com/how-to-create-cdi-events/[How to create CDI Events by Elder Moraes]
+** https://blogs.oracle.com/javamagazine/post/jakarta-data-mysql[Simplifying data access with MySQL and Jakarta Data by Ivar Grimstad]
+** https://dzone.com/articles/introduction-to-nosql-database-1[Introduction to NoSQL Database by Rama Krishna Panguluri];
+
+* Books:
+** https://www.amazon.com/Persistence-Best-Practices-Java-Applications/dp/1837631271/[Persistence Best Practices for Java Applications by Otavio Santana and Karina Varela]
+** https://bpbonline.com/products/java-persistence-with-nosql[Java Persistence with NoSQL by Otavio Santana]
+** https://a.co/d/4dlvHQj[NoSQL Distilled: A Brief Guide to the Emerging World of Polyglot Persistence by Pramod Sadalage and Martin Fowler]
+