Spring Data MongoDB方法使用总结

1.概述


Spring Data MongoDB 是Spring框架访问mongodb的神器,借助它可以非常方便的读写mongo库。本文介绍使用Spring Data MongoDB来访问mongodb数据库的几种方法:

  • 使用Query和Criteria类
  • JPA自动生成的查询方法
  • 使用@Query 注解基于JSON查询

1.1 添加maven依赖


<dependency>
    <groupId>org.springframework.data</groupId>
    <artifactId>spring-data-mongodb</artifactId>
    <version>2.2.2.RELEASE</version>
  </dependency>

2.使用Query和Criteria类查询DB

对于这一种方式,我将分一下几点来详细给大家具体的使用方法。

  • is查询
  • in查询
  • 正则查询(模糊匹配)
  • LT和GT
  • Criteria类方法总结
  • 排序
  • 分页
  • 特殊场景一:Criteria.orOperator
  • 特殊场景二:Query.fields().exclude(“messageText”)
  • MongoTemplate.find()与MongoTemplate.count()

2.1 is查询


在以下示例中 - 我们正在寻找名为Eric的用户。

我们来看看我们的数据库:

[
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581907"),
        "_class" : "org.baeldung.model.User",
        "name" : "Eric",
        "age" : 45
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581908"),
        "_class" : "org.baeldung.model.User",
        "name" : "Antony",
        "age" : 55
    }
}]

让我们看看查询代码:

Query query = new Query();
query.addCriteria(Criteria.where("name").is("Eric"));
List<User> users = mongoTemplate.find(query, User.class);

如预期的那样,这个逻辑返回:

{
    "_id" : ObjectId("55c0e5e5511f0a164a581907"),
    "_class" : "org.baeldung.model.User",
    "name" : "Eric",
    "age" : 45
}

2.2 in查询

当我们需要查询name为“Eric”和“Antony”的User时,需要使用到in查询。
首先我们来看看我们的数据库:

[
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581907"),
        "_class" : "org.baeldung.model.User",
        "name" : "Eric",
        "age" : 45
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581908"),
        "_class" : "org.baeldung.model.User",
        "name" : "Antony",
        "age" : 33
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581909"),
        "_class" : "org.baeldung.model.User",
        "name" : "Alice",
        "age" : 35
    }
]

我们来创建查询:

Query query = new Query();
List<String> names = Arrays.asList("Eric","Antony");
query.addCriteria(Criteria.where("name").in(names));
List<User> users = mongoTemplate.find(query,User.class);

这运行并返回2条记录:

[
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581907"),
        "_class" : "org.baeldung.model.User",
        "name" : "Eric",
        "age" : 45
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581908"),
        "_class" : "org.baeldung.model.User",
        "name" : "Antony",
        "age" : 33
    }
]

2.3 正则查询(模糊匹配)

正则表达式是一个更灵活和强大的查询类型。这使用了一个使用MongoDB $ regex的标准,该标准返回适用于这个字段的这个正则表达式的所有记录。

它的作用类似于startingWith,endingWith操作 - 让我们来看一个例子。

寻找名称以A开头的所有用户,这是数据库的状态:

[
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581907"),
        "_class" : "org.baeldung.model.User",
        "name" : "Eric",
        "age" : 45
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581908"),
        "_class" : "org.baeldung.model.User",
        "name" : "Antony",
        "age" : 33
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581909"),
        "_class" : "org.baeldung.model.User",
        "name" : "Alice",
        "age" : 35
    }
]

我们来创建查询:

Query query = new Query();
query.addCriteria(Criteria.where("name").regex("^A"));
List<User> users = mongoTemplate.find(query,User.class);

这运行并返回2条记录:

[
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581908"),
        "_class" : "org.baeldung.model.User",
        "name" : "Antony",
        "age" : 33
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581909"),
        "_class" : "org.baeldung.model.User",
        "name" : "Alice",
        "age" : 35
    }
]

下面是另一个简单的例子,这次查找名称以c结尾的所有用户:

Query query = new Query();
query.addCriteria(Criteria.where("name").regex("c$"));
List<User> users = mongoTemplate.find(query, User.class);

所以结果是:

{
    "_id" : ObjectId("55c0e5e5511f0a164a581907"),
    "_class" : "org.baeldung.model.User",
    "name" : "Eric",
    "age" : 45
}

2.4 LT和GT

$ lt(小于)运算符和$ gt(大于)。

让我们快速看一个例子 - 我们正在寻找年龄在20岁到50岁之间的所有用户。

数据库是

[
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581907"),
        "_class" : "org.baeldung.model.User",
        "name" : "Eric",
        "age" : 45
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581908"),
        "_class" : "org.baeldung.model.User",
        "name" : "Antony",
        "age" : 55
    }
}

构造查询:

Query query = new Query();
query.addCriteria(Criteria.where("age").lt(50).gt(20));
List<User> users = mongoTemplate.find(query,User.class);

结果 - 年龄大于20且小于50的所有用户:

{
    "_id" : ObjectId("55c0e5e5511f0a164a581907"),
    "_class" : "org.baeldung.model.User",
    "name" : "Eric",
    "age" : 45
}

2.5 Criteria类方法总结

通过查看Criteria类的源码,发现它还有很多类似的方法,这里我把常用的几种以表格形式总结如下:

Criteria类方法对应字符串
Criteria.ne()$ne ----> 不等于
Criteria.lte()$lte ----> 小于等于
Criteria.gte()$ne ----> 大于等于
Criteria.exists()$exists ----> 是否存在

2.6 排序

Sort用于指定结果的排序顺序。

首先 - 这里是现有的数据:

[
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581907"),
        "_class" : "org.baeldung.model.User",
        "name" : "Eric",
        "age" : 45
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581908"),
        "_class" : "org.baeldung.model.User",
        "name" : "Antony",
        "age" : 33
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581909"),
        "_class" : "org.baeldung.model.User",
        "name" : "Alice",
        "age" : 35
    }
]

执行排序后:

Query query = new Query();
query.with(new Sort(Sort.Direction.ASC, "age"));
List<User> users = mongoTemplate.find(query,User.class);

这是查询的结果 - 很好地按年龄排序:

[
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581908"),
        "_class" : "org.baeldung.model.User",
        "name" : "Antony",
        "age" : 33
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581909"),
        "_class" : "org.baeldung.model.User",
        "name" : "Alice",
        "age" : 35
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581907"),
        "_class" : "org.baeldung.model.User",
        "name" : "Eric",
        "age" : 45
    }
]

2.7 分页

我们来看一个使用分页的简单例子。

这是数据库的状态:

[
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581907"),
        "_class" : "org.baeldung.model.User",
        "name" : "Eric",
        "age" : 45
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581908"),
        "_class" : "org.baeldung.model.User",
        "name" : "Antony",
        "age" : 33
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581909"),
        "_class" : "org.baeldung.model.User",
        "name" : "Alice",
        "age" : 35
    }
]

现在,查询逻辑,只需要一个大小为2的页面:

final Pageable pageableRequest = new PageRequest(0, 2);
Query query = new Query();
query.with(pageableRequest);

结果 :

[
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581907"),
        "_class" : "org.baeldung.model.User",
        "name" : "Eric",
        "age" : 45
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581908"),
        "_class" : "org.baeldung.model.User",
        "name" : "Antony",
        "age" : 33
    }
]

2.8 特殊场景一:Criteria.orOperator

假设这样一个场景:有一个Student类,这个类里面有一个字段Score,这个Score本身又是一个类,里面包含languageScore、mathScore, englishScore三个字段。现在需要查询任何一科分数等于90的Student,这时就需要用到Criteria.orOperator。具体的写法如下:

Criteria criteria = new Criteria();
criteria.orOperator(Criteria.where("Score.languageScore").is(90),
                    Criteria.where("Score.mathScore").is(90),
                    Criteria.where("Score.englishScore").is(90));
Query query = new Query(criteria );
List<Student> students = mongoTemplate.find(query,Student.class);

2.9 特殊场景二:Query.fields().exclude(“field”)

假设这样一个场景:有一个Student类,它里面有name、age、describle、height等字段,其中describle字段代表对这个学生的描述,一般内容比较长。于是,当我们在查询Student时,我并不是很关注describle信息,这时为了提高提高前台查询显示的效率,我们可以使用Query.fields().exclude(“dexcrible”),去忽略这个字段。这样最后返回的Student集合中将不会包含这一个字段信息。具体代码如下:

Criteria criteria = new Criteria();
criteria.orOperator(Criteria.where("Score.languageScore").is(90),
                    Criteria.where("Score.mathScore").is(90),
                    Criteria.where("Score.englishScore").is(90));
Query query = new Query(criteria );
query.fields().exclude("dexcrible");
List<Student> students = mongoTemplate.find(query,Student.class);

2.10 MongoTemplate.count()

当我们只关注查询的记录数目时,可以使用MongoTemplate.count()这一个方法,十分方便,而不用等查询出来在去统计个数。

更多关于MongoTemplate的方法可以查看MongoTemplate类的源码,一般可以通过方法的命名就知道所实现的功能。

3. JPA自动生成的查询方法


生成查询方法是JPA的一个特性,在Spring Data Mongodb里也可以使用。

要做到2里功能,只需要在接口上声明方法即可,

public interface UserRepository 
  extends MongoRepository<User, String>, QueryDslPredicateExecutor<User> {
    ...
}

3.1 FindByX

我们将通过探索findBy类型的查询来简单地开始 - 在这种情况下,通过名称查找:

List<User> findByName(String name);

与上一节相同 2.1 - 查询将具有相同的结果,查找具有给定名称的所有用户:

List<User> users = userRepository.findByName("Eric");

3.2 StartingWith and endingWith

下面是操作过程的一个简单例子:

List<User> findByNameStartingWith(String regexp);

List<User> findByNameEndingWith(String regexp);

实际使用这个例子当然会非常简单:

List<User> users = userRepository.findByNameStartingWith("A");
List<User> users = userRepository.findByNameEndingWith("c");

结果是完全一样的。

3.3 Between

类似于2.3,这将返回年龄在ageGT和ageLT之间的所有用户:

List<User> findByAgeBetween(int ageGT, int ageLT);
List<User> users = userRepository.findByAgeBetween(20, 50);

3.4 Like和OrderBy

让我们来看看这个更高级的示例 - 为生成的查询组合两种类型的修饰符。

我们将要查找名称中包含字母A的所有用户,我们也将按年龄顺序排列结果:

List<User> users = userRepository.findByNameLikeOrderByAgeAsc("A");

结果:

[
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581908"),
        "_class" : "org.baeldung.model.User",
        "name" : "Antony",
        "age" : 33
    },
    {
        "_id" : ObjectId("55c0e5e5511f0a164a581909"),
        "_class" : "org.baeldung.model.User",
        "name" : "Alice",
        "age" : 35
    }
]

3.5 总结

关于这一类,比较麻烦的地方就是不知道有哪些方法是JPA自动生成的。除了通过idea的提示可以做一部分判断,另一个方法还是要通过查看源码来判断。通过查看代码,发现每个类的Repository类都会继承MongoRepository,而MongoRepository继承了PagingAndSortingRepository,PagingAndSortingRepository继承CrudRepository,CrudRepository继承Repository。所以这几个Repository中已经有的方法都是JPA可以自动生成的。使用某一具体方法时可以在这几个Repository中查找是否有对应方法

3.6 注意

在这里我们需要区分两种情况:一种是;本身的Repository类继承的那一些Repository提供的基本的数据操作方法,包含基本的增删改查、分页查询、排序查询等,对于这一种,在创建的Repository类中是不需要再申明方法的。另一种是我们可以自己写一些简单的方法,这些方法只需要符合Spring Data制定的那一类规范就能被其识别出来,对于这一种就需要在Repository类中声明方法。
在前面这两种方法都不能满足你的需要时,就需要用到下面这种@Query方式了。

4. 使用@Query 注解基于JSON查询

如果我们无法用方法名称或条件来表示查询,那么我们可以做更低层次的事情 - 使用@Query注解。

通过这个注解,我们可以指定一个原始查询 - 作为一个Mongo JSON查询字符串。

4.1 FindBy

让我们先从简单的,看看我们是如何将是一个通过查找类型的方法第一:

@Query("{ 'name' : ?0 }")
List<User> findUsersByName(String name);

这个方法应该按名称返回用户 - 占位符?0引用方法的第一个参数。

4.2 $regex

让我们来看一个正则表达式驱动的查询 - 这当然会产生与2.2和3.2相同的结果:

@Query("{ 'name' : { $regex: ?0 } }")
List<User> findUsersByRegexpName(String regexp);

用法也完全一样:

List<User> users = userRepository.findUsersByRegexpName("^A");
List<User> users = userRepository.findUsersByRegexpName("c$");

4.3 $ lt和$ gt

现在我们来实现lt和gt查询:

@Query("{ 'age' : { $gt: ?0, $lt: ?1 } }")
List<User> findUsersByAgeBetween(int ageGT, int ageLT);

4.3 其他

  • 排序
    一下语句代表按照updatedDate字段正序排序。
@Query(value = "{'exceptionStatus':'UNPROCESSED','forceReprocess':true}", sort = "{'updatedDate':1}")

当为sort = "{‘updatedDate’:-1}时,代表逆序

  • 表中含有类的字段时
@Query(value = "{?#{'Score.'+[0]}:?1 ,'status': ?2 }",sort = "{'age':1}")

上面的[0]代表Score类里面的某个字段属性(可能为languageScore、mathScore, englishScore,[1]代表具体的查询分数

以上就是Spring Data MongoDB方法的几种情况总结。本文有参考如下链接:

https://www.cnblogs.com/xiaoqi/p/queries-in-spring-data-mongodb.html
https://docs.spring.io/spring-data/mongodb/docs/2.2.2.RELEASE/reference/html/#reference

  • 0
    点赞
  • 9
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值