Spring Data MongoDBのクエリガイド

投稿日: 2019-10-19 2019-11-05
タグ: MongoDB, Spring Data

データ]

リンク:/tag/mongodb/[MongoDB]

1概要

この記事では、Spring Data MongoDBでさまざまな種類のクエリを作成することに焦点を当てます。

Query

クラスと

Criteria

クラス、自動生成されたクエリメソッド、JSONクエリ、およびQueryDSLを使用したドキュメントのクエリを検討します。

Mavenのセットアップについては、https://www.baeldung.com/spring-data-mongodb-tutorial[Introduction article]をご覧ください。

** 2ドキュメントクエリ

Spring DataでMongoDBを照会するためのより一般的な方法の1つは、

Query

および

Criteria

クラスを使用することです。これはネイティブ演算子に非常によく似ています。

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. __正規表現

より柔軟で強力な種類のクエリは正規表現です。このc`は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.3.

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.4.

ソート

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
    }]----

sort

を実行した後:

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

そして、これがクエリの結果です –

age

でうまくソートされています:

----[    {
        "__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.5.

ページ表示

ページネーションを使用した簡単な例を見てみましょう。

これがデータベースの状態です。

----[    {
        "__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 = PageRequest.of(0, 2);
Query query = new Query();
query.with(pageableRequest);

そしてその結果 – 予想どおり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
    }]----

3生成されたクエリメソッド

Spring Dataが通常提供する、より一般的な種類のクエリ – メソッド名からの自動生成クエリ – を探りましょう。

これらの種類のクエリを利用するために必要な唯一のことは、リポジトリインタフェースでメソッドを宣言することです。

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

および

__

endingWith.

2.2では、

regex

ベースのクエリを調べました。初めと終わりはもちろんそれほど強力ではありませんが、それでも非常に便利です。

これが、操作の概要の簡単な例です。

+

List<User> findByNameStartingWith(String regexp);

List<User> findByNameEndingWith(String regexp);

実際にこれを使用する例は、もちろん非常に簡単です。

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

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

そして結果は全く同じです。

3.3.

の間に

2.3と同様に、年齢が

ageGT

から__ageLTまでのすべてのユーザーが返されます。

List<User> findByAgeBetween(int ageGT, int ageLT);

このメソッドを呼び出すと、まったく同じ文書が見つかります。

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

3.4.

Like

と

OrderBy

今回はより高度な例を見てみましょう。生成されたクエリに2種類の修飾子を組み合わせたものです。

A

という文字を含む名前を持つすべてのユーザーを探します。また、年齢別に結果を昇順で並べます。

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

2.4で使用したデータベースの場合、結果は次のようになります。

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

4 JSONクエリメソッド

メソッド名や基準を使ってクエリを表現できない場合は、もっと低レベルの何かをすることができます。

このアノテーションで、生のクエリをMongo JSONのクエリ文字列として指定できます。

** 4.1.

FindBy

単純な方法から始めて、どのように** 検索__タイプのメソッドを最初に表すのかを見てみましょう。

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

このメソッドはユーザを名前で返す必要があります – プレースホルダ

？0

はメソッドの最初のパラメータを参照します。

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

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

では、and

gt

クエリを実装しましょう。

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

これで、メソッドに2つのパラメータがあるので、生のクエリでは

0

と

？1__の各インデックスを参照しています。

List<User> users = userRepository.findUsersByAgeBetween(20, 50);

5 QueryDSLクエリ

MongoRepository

はhttp://www.querydsl.com/[QueryDSL]プロジェクトをしっかりサポートしています – そのため、ここでも同様に、型保証された素敵なAPIを活用できます。

** 5.1. Mavenの依存関係

まず、pomに定義されているMavenの依存関係が正しいことを確認しましょう。

<dependency>
    <groupId>com.mysema.querydsl</groupId>
    <artifactId>querydsl-mongodb</artifactId>
    <version>3.6.6</version>
</dependency>
<dependency>
    <groupId>com.mysema.querydsl</groupId>
    <artifactId>querydsl-apt</artifactId>
    <version>3.6.6</version>
</dependency>

5.2.

Q

クラス

QueryDSLはクエリを作成するためにQクラスを使用しました。しかし、実際にはこれらを手作業で作成する必要はないので、** 何らかの方法で生成する必要があります。

そのためにapt-maven-pluginを使います。

<plugin>
    <groupId>com.mysema.maven</groupId>
    <artifactId>apt-maven-plugin</artifactId>
    <version>1.1.3</version>
    <executions>
        <execution>
            <goals>
                <goal>process</goal>
            </goals>
            <configuration>
                <outputDirectory>target/generated-sources/java</outputDirectory>
                <processor>
                  org.springframework.data.mongodb.repository.support.MongoAnnotationProcessor
                </processor>
            </configuration>
        </execution>
     </executions>
</plugin>

User

クラスを見てみましょう。特に

@ QueryEntity

アノテーションに注目してください。

@QueryEntity
@Document
public class User {

    @Id
    private String id;
    private String name;
    private Integer age;

   //standard getters and setters
}

Mavenライフサイクルの

process

目標（またはその後の別の目標）を実行した後 – aptプラグイン

は

target/generated-sources/java/\ {あなたのパッケージ構造}

の下に新しいクラスを

生成します

----/** **
 **  QUser is a Querydsl query type for User
 ** /@Generated("com.mysema.query.codegen.EntitySerializer")
public class QUser extends EntityPathBase<User> {

private static final long serialVersionUID = ...;

public static final QUser user = new QUser("user");

public final NumberPath<Integer> age = createNumber("age", Integer.class);

public final StringPath id = createString("id");

public final StringPath name = createString("name");

public QUser(String variable) {
    super(User.class, forVariable(variable));
}

public QUser(Path<? extends User> path) {
    super(path.getType(), path.getMetadata());
}

    public QUser(PathMetadata<?> metadata) {
        super(User.class, metadata);
    }
}

このクラスの助けを借りて、クエリを作成することはしません。

ちなみに - もしあなたがEclipseを使っているのであれば、このプラグインを導入するとpomで以下のような警告が出るでしょう。

JDKを使用してビルドを実行するか、クラスパスにtools.jarを用意する必要があります。____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________これがeclipseのビルド中に発生する場合は、必ずJDKの下でeclipseを実行してください（com.mysema.maven:apt-maven-plugin:1.1.3:process:デフォルト:generate-sources__

Mavenの__install__は正常に動作し、__QUser__クラスが生成されますが、プラグインがpomでハイライトされています。

手っ取り早い解決策は、__eclipse.ini__で手動でJDKを指定することです。

[source,text,gutter:,true]

…
-vm
{path

to

jdk}\jdk{your__version}\bin\javaw.exe

====  **  5.3.  __新しいリポジトリ__

**

これで、リポジトリでQueryDSLサポートを実際に有効にする必要があります。これは、__QueryDslPredicateExecutor__インターフェースを単純に** 拡張することによって行われます。

[source,java,gutter:,true]

public interface UserRepository extends
MongoRepository<User, String>, QuerydslPredicateExecutor<User>

====  **  5.4.  __Eq__ **

サポートを有効にした状態で、前に説明したものと同じクエリを実装しましょう。

単純な平等から始めましょう。

[source,java,gutter:,true]

QUser qUser = new QUser(“user”);
Predicate predicate = qUser.name.eq(“Eric”);
List<User> users = (List<User>) userRepository.findAll(predicate);

====  **  5.5.  __StartingWith__と__EndingWith__ **

同様に、前のクエリを実装しましょう - そして__A__で始まる名前のユーザーを見つけましょう:

[source,java,gutter:,true]

QUser qUser = new QUser(“user”);
Predicate predicate = qUser.name.startsWith(“A”);
List<User> users = (List<User>) userRepository.findAll(predicate);

そして__c__で終わる:

[source,java,gutter:,true]

QUser qUser = new QUser(“user”);
Predicate predicate = qUser.name.endsWith(“c”);
List<User> users = (List<User>) userRepository.findAll(predicate);

結果は2.2、3.2、または4.2と同じです。

====  **  5.6.  __の間に__**

次の1つのクエリは、20〜50歳の年齢のユーザーを返します。

[source,actionscript3,gutter:,true]

QUser qUser = new QUser(“user”);
Predicate predicate = qUser.age.between(20, 50);
List<User> users = (List<User>) userRepository.findAll(predicate);

===  **  6. 結論**

この記事では、Spring Data MongoDBを使用して照会できるさまざまな方法について説明しました。

一歩後退して、MongoDBにクエリを実行するための強力な方法がいくつあるかを確認するのは興味深いことです。

これらすべての例とコードスニペットの実装は**  https://github.com/eugenp/tutorials/tree/master/persistence-modules/spring-data-mongodb[**  GitHubプロジェクト** ]にあります。 Eclipseベースのプロジェクトなので、そのままインポートして実行するのは簡単なはずです。

getdocs

8684

1概要

** 2ドキュメントクエリ

2.1. Is

2.2. __正規表現

2.3. Lt と gt

2.4. ソート

2.5. ページ表示

3生成されたクエリメソッド

3.1. FindByX

3.2. StartingWith および __ endingWith.

3.3. の間に

3.4. Like と OrderBy