Package com.mongodb.client.model.search

Interface SearchPath

All Superinterfaces:

Bson

All Known Subinterfaces:

FieldSearchPath, WildcardSearchPath

@Evolving
@Beta(CLIENT)
public interface SearchPath
extends Bson

A specification of fields to be searched.

Depending on the context, one of the following methods may be used to get a representation of a SearchPath with the correct syntax: Bson.toBsonDocument(), toBsonValue(), FieldSearchPath.toValue().

Since:

4.7

MongoDB Atlas documentation

Path

Field Summary

Fields inherited from interface org.bson.conversions.Bson

DEFAULT_CODEC_REGISTRY

Method Summary

Modifier and Type	Method	Description
static FieldSearchPath	fieldPath(String path)	Returns a SearchPath for the given path.
default BsonValue	toBsonValue()	Converts this object to BsonValue.
static WildcardSearchPath	wildcardPath(String wildcardPath)	Returns a SearchPath for the given wildcardPath.

Methods inherited from interface org.bson.conversions.Bson

toBsonDocument, toBsonDocument

Method Details

fieldPath

static FieldSearchPath fieldPath(String path)

Returns a SearchPath for the given path.

Parameters:

path - The name of the field. Must not contain wildcard characters.

Returns:

The requested SearchPath.

MongoDB documentation

Dot notation

wildcardPath

static WildcardSearchPath wildcardPath(String wildcardPath)

Returns a SearchPath for the given wildcardPath.

Parameters:

wildcardPath - The specification of the fields that contains wildcard ('*') characters. Must not contain '**'.

Returns:

The requested SearchPath.

MongoDB documentation

Dot notation

toBsonValue

default BsonValue toBsonValue()

Converts this object to BsonValue. If Bson.toBsonDocument() contains only the "value" key, then returns BsonString representing the value of this key, otherwise returns Bson.toBsonDocument().

This method may be useful when using the of methods, e.g., SearchHighlight.of(Bson). Depending on the syntax of the document being constructed, it may be required to use the method FieldSearchPath.toValue() instead.

Returns:

A BsonValue representing this SearchPath.

See Also:

• FieldSearchPath.toValue()