Indexes Builders

Overview

In this guide, you can learn how to specify indexes using builders in the MongoDB Java driver. The Indexes builder provides helper methods for constructing the following types of indexes:

• Ascending Indexes

• Descending Indexes

• Compound Indexes

• Text Indexes

• Hashed Indexes

• Geospatial Indexes

Indexes store a subset of the collection’s data set. The index stores the value of a specific field or set of fields, ordered by the value of the field. See our guide on Indexes for examples of queries covered by indexes.

The Indexes class provides static factory methods for all the MongoDB index types. Each method returns a BSON instance, which you can pass to createIndex().

import static com.mongodb.client.model.Indexes.*;

Ascending Indexes

An ascending index enables you to sort query results by the value of the indexed fields from smallest to largest.

In order to create an ascending index, first call the ascending() builder method to create a Bson instance that represents the index document, passing the name or names of the fields you want to index. Then, call the createIndex() method on the collection, passing the Bson instance that contains the index document.

The following example specifies an ascending index on the name field:

Bson ascendingIndex = ascending("name");
collection.createIndex(ascendingIndex);

Descending Indexes

A descending index enables you to sort query results by the value of the indexed fields from largest to smallest.

In order to create a descending index, first call the descending() builder method to create a Bson instance that represents the index document, passing the name or names of the fields you want to index. Then, call the createIndex() method on the collection, passing the Bson instance that contains the index document.

The following example specifies a descending index on the capacity field:

Bson descendingIndex = descending("capacity");
collection.createIndex(descendingIndex);

Compound Indexes

In order to create a compound index, first call the compoundIndex() builder method to create a Bson instance that represents the index document, passing the names of the fields you want to index. Then, call the createIndex() method on the collection, passing the Bson instance that contains the index document.

The following example specifies a compound index composed of descending index on the capacity and year field, followed by an ascending index on the name field:

Bson compoundIndexExample = compoundIndex(descending("capacity", "year"), ascending("name"));
collection.createIndex(compoundIndexExample);

Text Indexes

A text index groups documents by the text in the indexed field.

In order to create a text index, first call the text() builder method to create a Bson instance that represents the index document, passing the name of the fields you want to index. Then, call the createIndex() method on the collection, passing the Bson instance that contains the index document.

The following example specifies a text index key on the "theaters" field:

Bson textIndex = text("theaters");
collection.createIndex(textIndex);

Hashed Indexes

A hashed index groups documents by the hash value in the indexed field.

In order to create a hashed index, first call the hashed() builder method to create a Bson instance that represents the index document, passing the name of the fields you want to index. Then, call the createIndex() method on the collection, passing the Bson instance that contains the index document.

The following example specifies a hashed index on the capacity field:

Bson hashedIndex = hashed("capacity");
collection.createIndex(hashedIndex);

Geospatial Indexes

A 2dsphere index groups documents by the coordinates in the indexed field.

In order to create a 2dsphere index, first call the geo2dsphere() builder method to create a Bson instance that represents the index document, passing the name or names of the fields you want to index. Then, call the createIndex() method on the collection, passing the Bson instance that contains the index document.

The following example specifies a 2dsphere index on the location field:

Bson geo2dsphereIndex = geo2dsphere("location");
collection.createIndex(geo2dsphereIndex);