本教程的前兩篇文章，分別介紹瞭如何使用 Node.js，普通的 Java 應用以及 SpringBoot 應用對 MongoDB 進行讀寫訪問。

- [MongoDB 入門教程系列之一：開發環境搭建以及 Node.js 和 Java 的讀寫訪問](https://xie.infoq.cn/article/f856e958a19fd951b818e107f)
- [MongoDB 入門教程系列之二：使用 Spring Boot 操作 MongoDB](https://xie.infoq.cn/article/0aebc24371a523f58cce5619b)

本文介紹另一種採取 Restful API 的方式來操縱 MongoDB.

# 使用 SpringBoot 開發 Restful API 對 MongoDB 進行讀寫訪問

透過 Spring Boot 構造出 Restful API，這樣可以直接在瀏覽器裡透過呼叫 Restful API，對 MongoDB 進行增刪查改了。

![](https://img-blog.csdnimg.cn/img_convert/361d8bf9032a28ee21e2d3b1318359e1.png)

先看按照本教程介紹的步驟，實現的最終效果。

假設我本地 MongoDB 的資料庫裡有一張表 book，只有一條記錄，id 為 1.

![](https://img-blog.csdnimg.cn/img_convert/5a561e14a14ab6ab237a8fffa0430377.png)

透過瀏覽器裡的這個 url 根據 id 讀取該記錄：http://localhost:8089/bookmanage/read?id=1

![](https://img-blog.csdnimg.cn/img_convert/5efbd07f0c922278caa9ec5cbd22f021.png)

採取如下 url 進行記錄的建立：

http://localhost:8089/bookmanage/create?id=2&name=Spring&author=Jerry

![](https://img-blog.csdnimg.cn/img_convert/8e54da10f4f6fd3383930a49db863878.png)
![](https://img-blog.csdnimg.cn/img_convert/f9e4a7041c2503579c5fc73fe47d2179.png)

記錄搜尋操作的 url：http://localhost:8089/bookmanage/search?name=*

![](https://img-blog.csdnimg.cn/img_convert/d20c06841090d419ee9d101873e3c2f7.png)

記錄的刪除：刪除 id 為 2 的記錄

http://localhost:8089/bookmanage/delete?id=2

![](https://img-blog.csdnimg.cn/img_convert/91ed264652169e3b6b7f4738500b08ba.png)

下面是上述功能的實現細節。

1. 建立一個新的 controller，位於資料夾 src/main/java 下。

![](https://img-blog.csdnimg.cn/img_convert/4c61f406b2e5847e69f055456ca241bc.png)

這個 controller 加上註解 `@RestController`.

@RestController 註解相當於 `@ResponseBody` 和 `@Controller` 這兩個註解提供的功能的並集。

這裡有一個知識點就是，如果用註解 @RestController 定義一個 Controller，那麼這個 Controller 裡的方法無法返回 jsp 頁面或者 html 頁面，因為 @ResponseBody 註解在起作用。所以即使配置了檢視解析器 InternalResourceViewResolver 也不會生效，此時返回的內容就是 @RestController 定義的控制器方法裡返回的內容。

![](https://img-blog.csdnimg.cn/img_convert/6c53f815e12d93a1e4719b48af3d1351.png)

2. 以讀操作為例，透過註解 `@GetMapping` 定義了讀操作 Restful API 的 url 為bookmanage/read.

@RequestParam 定義了 url：bookmanage/read 後面的引數為 id 或者 name.

讀操作最終將會使用我們之前介紹過的 Java 訪問 MongoDB 的方法，即透過`@Autowired` 注入的 BookRepository 例項完成對 MongoDB 的操作。

![](https://img-blog.csdnimg.cn/img_convert/eafe8ca5f7e5de4f976edf7475c2c61f.png)

3. 建立操作的原始碼：

```java
@GetMapping("/bookmanage/create")
public Book create(
@RequestParam(value="id", defaultValue="") String id,
@RequestParam(value="name", defaultValue="noname") String name,
@RequestParam(value="author", defaultValue="noauthor") String author
){
     Book book = repository.save(new Book(id,name,author));
     return book;
}
```

![](https://img-blog.csdnimg.cn/img_convert/94c9db9b370b6be2205a64f3d44ac5b3.png)

4. 刪除操作的原始碼：

```java
@GetMapping("/bookmanage/delete")
public boolean delete(
@RequestParam(value="id", defaultValue="") String id
){
    //if no record
     if(repository.findById(id)==null)
           return false;
     // do database delete
     repository.deleteById(id);
    return true;
}
```

![](https://img-blog.csdnimg.cn/img_convert/88d00d66059ad8a23a3ecba7e2746356.png)

# 如何在 SAP 雲平臺上使用 MongoDB

我想在 SAP 雲平臺的 Cloud Foundry 環境下使用 MongoDB 服務，但是在 Service Marketplace 上找不到這個服務。

![](https://img-blog.csdnimg.cn/img_convert/dd40ab83f0228a8711c67f63410cbfd7.png)

命令列 `cf marketplace` 返回的結果也沒有 MongoDB 相關的服務：

![](https://img-blog.csdnimg.cn/img_convert/25cfa48c41c79844d8d34147c26bf3f4.png)

## 解決方案

退回到 SAP 雲平臺的 Global Account，點選 Entitlement，發現沒有給 Subaccount 分配 MongoDB：

![](https://img-blog.csdnimg.cn/img_convert/f496d1c01ec3bc2fc12fff8dec7479ba.png)

Quota 分配成 1，儲存即可。

![](https://img-blog.csdnimg.cn/img_convert/9c1e922a030d5df1ddd258f7435a1b23.png)

再回到 organization 的 space 下面，發現現在 MongoDB 服務已經處於可用狀態了。

![](https://img-blog.csdnimg.cn/img_convert/9a1f8634b7bbf5787f154bb300b27b8b.png)

命令列 `cf marketplace` 現在能夠看到 MongoDB 服務的版本了：

![](https://img-blog.csdnimg.cn/img_convert/543bfedd48b1c4384143b2ed7a0da380.png)

下面是在 SAP 雲平臺 CloudFoundry 環境使用 MongoDB 服務的詳細步驟。

1. 使用命令列 `cf marketplace` 檢視當前 SAP 雲平臺的 MongoDB 服務的版本號：在我使用的 SAP 雲平臺上是 `v3.0-dev`:

![](https://img-blog.csdnimg.cn/img_convert/3f525eb559d7dda58e6d1d29c76a2928.png)

使用如下命令列建立一個服務例項：

> cf create-service mongodb v3.0-dev mongo-service

![](https://img-blog.csdnimg.cn/img_convert/e2bd3941f70ca041b05f87367704db6c.png)

2. 到 Java 專案根目錄下，使用命令列 `mvn package`:

![](https://img-blog.csdnimg.cn/img_convert/7d9c96081e8b4e17031adfd40cd7c891.png)

能看到如下的輸出：

![](https://img-blog.csdnimg.cn/img_convert/795486066071497c8f2223764d4a5b5e.png)
![](https://img-blog.csdnimg.cn/img_convert/c37e25353449f8a5d56bdbf64e982c6a.png)

該命令會生成一個 `hcp-cf-mongodb-tutorial-1.0-SNAPSHOT.jar`：

![](https://img-blog.csdnimg.cn/img_convert/a36abd6e2d3a0d64ac6c0b6afdb2899e.png)

3. 編輯 `manifest.yml`，指定部署到 SAP 雲平臺上的程式名稱：

![](https://img-blog.csdnimg.cn/img_convert/20bbba8e230bae2828341d6d2073c719.png)

4. 使用命令列 `cf push`進行部署。

部署成功後，在 Cockpit 裡能看到該應用處於 Started 狀態：

![](https://img-blog.csdnimg.cn/img_convert/206c491e2817a9145cbda9c329bc9a2a.png)
![](https://img-blog.csdnimg.cn/img_convert/012c054463e7769179fb846ecfa249e4.png)
![](https://img-blog.csdnimg.cn/img_convert/2cf6610df9723a5f51bfdf05a425a45f.png)

瀏覽器訪問該應用，能看到如下輸出：

![](https://img-blog.csdnimg.cn/img_convert/aaecdcadb51b6edc242d4cebe5ce9fa9.png)

該輸出是 Java 專案裡的 RootController 生成的：

![](https://img-blog.csdnimg.cn/img_convert/4cd29ba2ba5a198a83fd53e7fafdac1a.png)

最後我們對 SAP UI5 Repository 和 MongoDB Repository 進行比較，作為本系列的結尾。

## UI5 Repository
從本地透過 Eclipse team provider 上傳到 ABAP gateway system 的 UI5 應用，都會自動生成一個 `UI5RepositoryPathMapping.xml` 檔案，裡面記錄的是 debug version 的指令碼檔名稱和路徑的對映關係。如下圖所示：

![](https://img-blog.csdnimg.cn/img_convert/b8c1713cd9ef243ec006ee34ec82e894.png)

控制這個對映檔案的訪問工具類 manipulation utility 的名稱：

UI5/CL_UI5_REP_PATH_MAPPER

## SpringBoot 應用裡的 MongoDB Repository

和 ADBC 與 JDBC 不同，透過 MongoDB Repository 訪問 MongoDB 資料庫，並不會在程式碼中出現用字串拼接的 SQL 語句：

![](https://img-blog.csdnimg.cn/img_convert/8b2a6671036ff553ec3a8775d1a7f2b1.png)

例如我們檢視 `findByName` 的定義:

![](https://img-blog.csdnimg.cn/img_convert/3570c1b8946f7e7e33450f4fc3eb047d.png)

findByName 的實現：第 20 行程式碼構造一個 Query 例項，然後將其傳入 21 行 `mongoTemplate` 的 `find` 方法：

![](https://img-blog.csdnimg.cn/img_convert/7affa042b773c2d4f67b058e98613a01.png)

# 總結

本文首先介紹瞭如何使用 SpringBoot 應用開發 Restful API，從而能夠在瀏覽器裡就能對 MongoDB 的讀寫操作進行測試，接著介紹瞭如何在通用的雲平臺 CloudFoundry 環境裡消費 MongoDB 服務。

本教程前兩篇文章：

- [MongoDB 入門教程系列之一：開發環境搭建以及 Node.js 和 Java 的讀寫訪問](https://xie.infoq.cn/article/f856e958a19fd951b818e107f)
- [MongoDB 入門教程系列之二：使用 Spring Boot 操作 MongoDB](https://xie.infoq.cn/article/0aebc24371a523f58cce5619b)

MongoDB 入門教程系列之三：使用 Restful API 操作 MongoDB

相關文章