MongoDB 入门教程系列之三:使用 Restful API 操作 MongoDB

本文涉及的产品
云数据库 MongoDB,独享型 2核8GB
推荐场景:
构建全方位客户视图
简介: MongoDB 入门教程系列之三:使用 Restful API 操作 MongoDB

本教程的前两篇文章,分别介绍了如何使用 Node.js,普通的 Java 应用以及 SpringBoot 应用对 MongoDB 进行读写访问。

本文介绍另一种采取 Restful API 的方式来操纵 MongoDB.

使用 SpringBoot 开发 Restful API 对 MongoDB 进行读写访问

通过 Spring Boot 构造出 Restful API,这样可以直接在浏览器里通过调用 Restful API,对 MongoDB 进行增删查改了。

先看按照本教程介绍的步骤,实现的最终效果。

假设我本地 MongoDB 的数据库里有一张表 book,只有一条记录,id 为 1.

通过浏览器里的这个 url 根据 id 读取该记录:http://localhost:8089/bookmanage/read?id=1

采取如下 url 进行记录的创建:

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

记录搜索操作的 url:http://localhost:8089/bookmanage/search?name=*

记录的删除:删除 id 为 2 的记录

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

下面是上述功能的实现细节。

  1. 创建一个新的 controller,位于文件夹 src/main/java 下。

这个 controller 加上注解 @RestController.


@RestController 注解相当于 @ResponseBody 和 @Controller 这两个注解提供的功能的并集。


这里有一个知识点就是,如果用注解 @RestController 定义一个 Controller,那么这个 Controller 里的方法无法返回 jsp 页面或者 html 页面,因为 @ResponseBody 注解在起作用。所以即使配置了视图解析器 InternalResourceViewResolver 也不会生效,此时返回的内容就是 @RestController 定义的控制器方法里返回的内容。


  1. 以读操作为例,通过注解 @GetMapping 定义了读操作 Restful API 的 url 为bookmanage/read.

@RequestParam 定义了 url:bookmanage/read 后面的参数为 id 或者 name.

读操作最终将会使用我们之前介绍过的 Java 访问 MongoDB 的方法,即通过@Autowired 注入的 BookRepository 实例完成对 MongoDB 的操作。

  1. 创建操作的源代码:
@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;
}

  1. 删除操作的源代码:
@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;
}

如何在 SAP 云平台上使用 MongoDB

我想在 SAP 云平台的 Cloud Foundry 环境下使用 MongoDB 服务,但是在 Service Marketplace 上找不到这个服务。

命令行 cf marketplace 返回的结果也没有 MongoDB 相关的服务:

解决方案

退回到 SAP 云平台的 Global Account,点击 Entitlement,发现没有给 Subaccount 分配 MongoDB:

Quota 分配成 1,保存即可。

再回到 organization 的 space 下面,发现现在 MongoDB 服务已经处于可用状态了。

命令行 cf marketplace 现在能够看到 MongoDB 服务的版本了:

下面是在 SAP 云平台 CloudFoundry 环境使用 MongoDB 服务的详细步骤。

  1. 使用命令行 cf marketplace 查看当前 SAP 云平台的 MongoDB 服务的版本号:在我使用的 SAP 云平台上是 v3.0-dev:

使用如下命令行创建一个服务实例:

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

  1. 到 Java 项目根目录下,使用命令行 mvn package:

能看到如下的输出:

该命令会生成一个 hcp-cf-mongodb-tutorial-1.0-SNAPSHOT.jar

  1. 编辑 manifest.yml,指定部署到 SAP 云平台上的程序名称:

  1. 使用命令行 cf push进行部署。

部署成功后,在 Cockpit 里能看到该应用处于 Started 状态:

浏览器访问该应用,能看到如下输出:

该输出是 Java 项目里的 RootController 生成的:

最后我们对 SAP UI5 Repository 和 MongoDB Repository 进行比较,作为本系列的结尾。

UI5 Repository

从本地通过 Eclipse team provider 上传到 ABAP gateway system 的 UI5 应用,都会自动生成一个 UI5RepositoryPathMapping.xml 文件,里面记录的是 debug version 的脚本文件名称和路径的映射关系。如下图所示:

控制这个映射文件的访问工具类 manipulation utility 的名称:

UI5/CL_UI5_REP_PATH_MAPPER

SpringBoot 应用里的 MongoDB Repository

和 ADBC 与 JDBC 不同,通过 MongoDB Repository 访问 MongoDB 数据库,并不会在代码中出现用字符串拼接的 SQL 语句:

例如我们查看 findByName 的定义:

findByName 的实现:第 20 行代码构造一个 Query 实例,然后将其传入 21 行 mongoTemplatefind 方法:

总结

本文首先介绍了如何使用 SpringBoot 应用开发 Restful API,从而能够在浏览器里就能对 MongoDB 的读写操作进行测试,接着介绍了如何在通用的云平台 CloudFoundry 环境里消费 MongoDB 服务。

本教程前两篇文章:

相关实践学习
MongoDB数据库入门
MongoDB数据库入门实验。
快速掌握 MongoDB 数据库
本课程主要讲解MongoDB数据库的基本知识,包括MongoDB数据库的安装、配置、服务的启动、数据的CRUD操作函数使用、MongoDB索引的使用(唯一索引、地理索引、过期索引、全文索引等)、MapReduce操作实现、用户管理、Java对MongoDB的操作支持(基于2.x驱动与3.x驱动的完全讲解)。 通过学习此课程,读者将具备MongoDB数据库的开发能力,并且能够使用MongoDB进行项目开发。   相关的阿里云产品:云数据库 MongoDB版 云数据库MongoDB版支持ReplicaSet和Sharding两种部署架构,具备安全审计,时间点备份等多项企业能力。在互联网、物联网、游戏、金融等领域被广泛采用。 云数据库MongoDB版(ApsaraDB for MongoDB)完全兼容MongoDB协议,基于飞天分布式系统和高可靠存储引擎,提供多节点高可用架构、弹性扩容、容灾、备份回滚、性能优化等解决方案。 产品详情: https://www.aliyun.com/product/mongodb
相关文章
|
1天前
|
缓存 Java API
从零到一:构建一个高效的 RESTful API 服务
本文将详细介绍如何从头开始设计和实现一个高效的 RESTful API 服务。我们将探讨 API 设计的最佳实践、选择合适的技术栈、实现常见功能(如认证、数据验证、错误处理)以及优化性能的策略。通过实例代码和实际应用场景的分析,读者将能够掌握构建高效且易于维护的 API 服务的关键步骤和技巧。
|
2天前
|
XML JSON API
RESTful API设计最佳实践:构建高效、可扩展的接口
【8月更文挑战第17天】RESTful API设计是一个涉及多方面因素的复杂过程。通过遵循上述最佳实践,开发者可以构建出更加高效、可扩展、易于维护的API。然而,值得注意的是,最佳实践并非一成不变,随着技术的发展和业务需求的变化,可能需要不断调整和优化API设计。因此,保持对新技术和最佳实践的关注,是成为一名优秀API设计师的关键。
|
7天前
|
Java API 数据库
【神操作!】Spring Boot打造RESTful API:从零到英雄,只需这几步,让你的Web应用瞬间飞起来!
【8月更文挑战第12天】构建RESTful API是现代Web开发的关键技术之一。Spring Boot因其实现简便且功能强大而深受开发者喜爱。本文以在线图书管理系统为例,展示了如何利用Spring Boot快速构建RESTful API。从项目初始化、实体定义到业务逻辑处理和服务接口实现,一步步引导读者完成API的搭建。通过集成JPA进行数据库操作,以及使用控制器类暴露HTTP端点,最终实现了书籍信息的增删查改功能。此过程不仅高效直观,而且易于维护和扩展。
19 1
|
8天前
|
缓存 测试技术 API
从零到一:构建高效的 RESTful API 服务器
在当今的软件开发环境中,RESTful API 是实现系统间数据交互的关键组件。本文探讨了如何从头开始构建一个高效的 RESTful API 服务器,包括技术选型、架构设计、性能优化等方面的内容。我们将以 Python 的 Flask 框架为例,展示如何设计一个可扩展且高性能的 API 服务器,并提供实际代码示例来说明最佳实践。
|
3天前
|
存储 缓存 API
深入理解RESTful API设计原则与实践
【7月更文挑战第47天】在当今互联网应用的构建中,后端系统通常需要通过API与前端或其他服务进行通信。本文将探讨RESTful API的设计原则,并通过实例展示如何在实践中有效地应用这些原则来创建易于维护、可扩展且用户友好的后端服务接口。我们将分析RESTful架构风格的核心概念,包括资源、统一接口、无状态性和分层系统,并讨论如何在真实世界中实现这些理论。
|
NoSQL API 网络架构
MongoDB REST Api介绍
MongoDB默认会开启一个HTTP协议的端口提供REST的服务,这个端口是你Server端口加上1000,比如你的Server端口为27017,那么这个HTTP端口就是28017,默认的HTTP端口功能是有限的,你可以通过添加–rest参数启动更多功能。
1905 0
|
5天前
|
机器人 API Python
智能对话机器人(通义版)会话接口API使用Quick Start
本文主要演示了如何使用python脚本快速调用智能对话机器人API接口,在参数获取的部分给出了具体的获取位置截图,这部分容易出错,第一次使用务必仔细参考接入参数获取的位置。
|
3天前
|
监控 API 数据安全/隐私保护
​邮件API触发式接口分析?邮件API接口好评榜
邮件API在企业通信和营销中至关重要,通过自动化邮件发送流程提升效率与客户满意度。本文解析邮件API触发式接口,即基于特定事件(如用户注册、购买产品)自动发送邮件的技术,能显著加快企业响应速度并增强用户体验。推荐市场上的优秀邮件API产品,包括SendGrid、Mailgun、Amazon SES、Postmark及新兴的AOKSend,它们各具特色,如高发送率、详细分析工具、灵活配置、强大的日志功能及用户友好的API接口,帮助企业根据不同需求选择最合适的邮件API解决方案。
|
11天前
|
存储 算法 Oracle
19 Java8概述(Java8概述+lambda表达式+函数式接口+方法引用+Stream+新时间API)
19 Java8概述(Java8概述+lambda表达式+函数式接口+方法引用+Stream+新时间API)
39 8
|
20天前
|
开发框架 前端开发 JavaScript
循序渐进VUE+Element 前端应用开发(13)--- 前端API接口的封装处理
循序渐进VUE+Element 前端应用开发(13)--- 前端API接口的封装处理

热门文章

最新文章