Add to README

Author: Oracle Public Cloud User

MongoExamples/SpringBoot/README.md

@@ -73,11 +73,72 @@ admin> db.station.find({_id:120});
 
 # Building the service
 
-[todo]
+Install Java, maven, and git:
+```
+ sudo yum install maven java-17-openjdk git
+ export JAVA_HOME=/usr/lib/jvm/jre-17/
+ export PATH=$JAVA_HOME/bin:$PATH
+```
+
+Clone this repository:
+
+```
+git clone https://github.com/oracle/json-in-db.git
+```
+
+Build the service:
+
+```
+cd json-in-db/MongoExamples/SpringBoot/
+mvn clean package
+```
 
 # Running the service
 
-[todo]
+To start the service, run the following command:
+
+```
+java -jar ./target/bikes-0.0.1.jar \
+   --spring.data.mongodb.uri='mongodb://ADMIN:<password>@XXXYYYZZZ-DEMODB.adb.us-ashburn-1.oraclecloudapps.com:27017/admin?authMechanism=PLAIN&authSource=$external&ssl=true&retryWrites=false&loadBalanced=true' \
+   --spring.data.mongodb.database=admin 
+```
+
+But substitute the value of `uri` with your actual connection string.  These properties can alternatively be set from [application.properties](src/main/resources/application.properties).
+
+# Testing the service
+
+By running the previous command in the background or by starting a 
+new shell process, you can test the service using cURL:
+
+```
+# get station with id 120
+curl http://localhost:8080/station/120
+{
+  "name" : "Lexington Ave & Classon Ave",
+  "region_id" : "71",
+  "lon" : -73.95928168,
+  "lat" : 40.68676793,
+  ...
+
+# get the status data for station 120
+curl  http://localhost:8080/status/search/findByStationId/?id=120 
+"_embedded" : {
+  "status" : [ {
+    "station_id" : "120",
+    "num_bikes_available" : 2,
+   ..
+
+# atomically delete station 120 and all associated status documents using a transaction
+curl -i -X DELETE http://localhost:8080/station/120
+ HTTP/1.1 200 
+ ...
+
+# station 120 is no longer found 
+curl -i http://localhost:8080/station/120
+ HTTP/1.1 404 
+ ...
+```
+
 
 
 

MongoExamples/SpringBoot/pom.xml

@@ -7,11 +7,9 @@
     <relativePath />
   </parent>
   <groupId>com.oracle.database.mongo.example</groupId>
-  <artifactId>SpringBoot</artifactId>
+  <artifactId>bikes</artifactId>
+  <name>bikes</name>
   <version>0.0.1</version>
-  <properties>
-    <java.version>16</java.version>
-  </properties>
   <dependencies>
     <dependency>
       <groupId>org.springframework.boot</groupId>

MongoExamples/SpringBoot/src/main/java/example/AppConfig.java

@@ -4,20 +4,10 @@
 import org.springframework.context.annotation.Configuration;
 import org.springframework.data.mongodb.MongoDatabaseFactory;
 import org.springframework.data.mongodb.MongoTransactionManager;
-import org.springframework.data.mongodb.core.SimpleMongoClientDatabaseFactory;
-
-import com.mongodb.client.MongoClient;
-import com.mongodb.client.MongoClients;
 
 @Configuration
 public class AppConfig {
 
-  public @Bean MongoDatabaseFactory mongoClient() {
-      String uri = "<connection string>";
-      MongoClient client = MongoClients.create(uri);
-      return new SimpleMongoClientDatabaseFactory(client, "admin");
-  }
-  
   @Bean
   MongoTransactionManager transactionManager(MongoDatabaseFactory dbFactory) {
       return new MongoTransactionManager(dbFactory);

MongoExamples/SpringBoot/src/main/java/example/model/Station.java

@@ -4,14 +4,12 @@
 import java.util.Map;
 
 import org.springframework.data.annotation.Id;
-import org.springframework.data.mongodb.core.mapping.Document;
 
 /**
  * Bike station
  * 
  * @see https://github.com/NABSA/gbfs/blob/master/gbfs.md#station_information
  */
-@Document("station")
 public class Station {
 
     @Id

MongoExamples/SpringBoot/src/main/java/example/model/Status.java

@@ -1,14 +1,12 @@
 package example.model;
 
 import org.springframework.data.annotation.Id;
-import org.springframework.data.mongodb.core.mapping.Document;
 
 /**
  * Bike station status
  * 
  * @see https://github.com/NABSA/gbfs/blob/master/gbfs.md#station_statusjson
  */
-@Document("status")
 public class Status {
 
     @Id

MongoExamples/SpringBoot/src/main/java/example/repository/StatusRepository.java

@@ -1,5 +1,8 @@
 package example.repository;
 
+import java.util.List;
+
+import org.springframework.boot.autoconfigure.web.WebProperties.Resources;
 import org.springframework.data.mongodb.repository.MongoRepository;
 import org.springframework.data.mongodb.repository.Query;
 import org.springframework.data.rest.core.annotation.RepositoryRestResource;
@@ -12,4 +15,6 @@ public interface StatusRepository extends MongoRepository<Status, String> {
     @Query(value="{'station_id' : ?0}", delete = true)
     public void deleteAllByStationId (String id);
 
+    @Query(value="{'station_id' : ?0}")
+    public List<Status> findByStationId (String id);
 }

MongoExamples/SpringBoot/src/main/resources/application.properties

@@ -1,2 +1,4 @@
 server.port = 8080
-logging.level.root=INFO
+logging.level.root=INFO
+spring.data.mongodb.uri=mongodb://XXXYYYZZZ-DEMODB.adb.us-ashburn-1.oraclecloudapps.com:27017/admin?authMechanism=PLAIN&authSource=$external&ssl=true&retryWrites=false&loadBalanced=true
+spring.data.mongodb.database=admin