io.vertx.ext.mongo.IndexOptions Maven / Gradle / Ivy
package io.vertx.ext.mongo;
import io.vertx.codegen.annotations.DataObject;
import io.vertx.core.json.JsonObject;
import org.bson.BsonDocument;
import org.bson.conversions.Bson;
import java.util.concurrent.TimeUnit;
/**
* Options used to configure index.
*
* @author Ruslan Sennov
*/
@DataObject
public class IndexOptions {
public static final boolean DEFAULT_BACKGROUD = false;
public static final boolean DEFAULT_UNIQUE = false;
public static final boolean DEFAULT_SPARSE = false;
private boolean background;
private boolean unique;
private String name;
private boolean sparse;
private Long expireAfterSeconds;
private Integer version;
private JsonObject weights;
private String defaultLanguage;
private String languageOverride;
private Integer textVersion;
private Integer sphereVersion;
private Integer bits;
private Double min;
private Double max;
private Double bucketSize;
private JsonObject storageEngine;
private JsonObject partialFilterExpression;
/**
* Default constructor
*/
public IndexOptions() {
background = DEFAULT_BACKGROUD;
unique = DEFAULT_UNIQUE;
sparse = DEFAULT_SPARSE;
}
/**
* Copy constructor
*
* @param options the one to copy
*/
public IndexOptions(IndexOptions options) {
background = options.background;
unique = options.unique;
name = options.name;
sparse = options.sparse;
expireAfterSeconds = options.expireAfterSeconds;
version = options.version;
weights = options.weights;
defaultLanguage = options.defaultLanguage;
languageOverride = options.languageOverride;
textVersion = options.textVersion;
sphereVersion = options.sphereVersion;
bits = options.bits;
min = options.min;
max = options.max;
bucketSize = options.bucketSize;
storageEngine = options.storageEngine;
partialFilterExpression = options.partialFilterExpression;
}
/**
* Constructor from JSON
*
* @param options the JSON
*/
public IndexOptions(JsonObject options) {
background = options.getBoolean("background", DEFAULT_BACKGROUD);
unique = options.getBoolean("unique", DEFAULT_UNIQUE);
name = options.getString("name");
sparse = options.getBoolean("sparse", DEFAULT_SPARSE);
expireAfterSeconds = options.getLong("expireAfterSeconds");
version = options.getInteger("version");
weights = options.getJsonObject("weights");
defaultLanguage = options.getString("defaultLanguage");
languageOverride = options.getString("languageOverride");
textVersion = options.getInteger("textVersion");
sphereVersion = options.getInteger("sphereVersion");
bits = options.getInteger("bits");
min = options.getDouble("min");
max = options.getDouble("max");
bucketSize = options.getDouble("bucketSize");
storageEngine = options.getJsonObject("storageEngine");
partialFilterExpression = options.getJsonObject("partialFilterExpression");
}
/**
* Convert to JSON
* @return the JSON
*/
public JsonObject toJson() {
JsonObject json = new JsonObject();
json.put("background", background);
json.put("unique", unique);
json.put("sparse", sparse);
if (name != null) {
json.put("name", name);
}
if (expireAfterSeconds != null) {
json.put("expireAfterSeconds", expireAfterSeconds);
}
if (version != null) {
json.put("version", version);
}
if (weights != null) {
json.put("weights", weights);
}
if (defaultLanguage != null) {
json.put("defaultLanguage", defaultLanguage);
}
if (languageOverride != null) {
json.put("languageOverride", languageOverride);
}
if (textVersion != null) {
json.put("textVersion", textVersion);
}
if (sphereVersion != null) {
json.put("sphereVersion", sphereVersion);
}
if (bits != null) {
json.put("bits", bits);
}
if (min != null) {
json.put("min", min);
}
if (max != null) {
json.put("max", max);
}
if (bucketSize != null) {
json.put("bucketSize", bucketSize);
}
if (storageEngine != null) {
json.put("storageEngine", storageEngine);
}
if (partialFilterExpression != null) {
json.put("partialFilterExpression", partialFilterExpression);
}
return json;
}
/**
* Create the index in the background
*
* @return true if should create the index in the background
*/
public boolean isBackground() {
return background;
}
/**
* Should the index should be created in the background
*
* @param background true if should create the index in the background
* @return reference to this, for fluency
*/
public IndexOptions background(boolean background) {
this.background = background;
return this;
}
/**
* Gets if the index should be unique.
*
* @return true if the index should be unique
*/
public boolean isUnique() {
return unique;
}
/**
* Should the index should be unique.
*
* @param unique if the index should be unique
* @return reference to this, for fluency
*/
public IndexOptions unique(boolean unique) {
this.unique = unique;
return this;
}
/**
* Gets the name of the index.
*
* @return the name of the index
*/
public String getName() {
return name;
}
/**
* Sets the name of the index.
*
* @param name of the index
* @return reference to this, for fluency
*/
public IndexOptions name(String name) {
this.name = name;
return this;
}
/**
* If true, the index only references documents with the specified field
*
* @return if the index should only reference documents with the specified field
*/
public boolean isSparse() {
return sparse;
}
/**
* Should the index only references documents with the specified field
*
* @param sparse if true, the index only references documents with the specified field
* @return reference to this, for fluency
*/
public IndexOptions sparse(boolean sparse) {
this.sparse = sparse;
return this;
}
/**
* Gets the time to live for documents in the collection
*
* @return the time to live for documents in the collection
* @param timeUnit the time unit
*/
public Long getExpireAfter(TimeUnit timeUnit) {
if (expireAfterSeconds == null) {
return null;
}
return timeUnit.convert(expireAfterSeconds, TimeUnit.SECONDS);
}
/**
* Sets the time to live for documents in the collection
*
* @param expireAfter the time to live for documents in the collection
* @param timeUnit the time unit for expireAfter
* @return reference to this, for fluency
*/
public IndexOptions expireAfter(Long expireAfter, TimeUnit timeUnit) {
if (expireAfter == null) {
this.expireAfterSeconds = null;
} else {
this.expireAfterSeconds = TimeUnit.SECONDS.convert(expireAfter, timeUnit);
}
return this;
}
/**
* Gets the index version number.
*
* @return the index version number
*/
public Integer getVersion() {
return this.version;
}
/**
* Sets the index version number.
*
* @param version the index version number
* @return reference to this, for fluency
*/
public IndexOptions version(Integer version) {
this.version = version;
return this;
}
/**
* Gets the weighting object for use with a text index
*
* A document that represents field and weight pairs. The weight is an integer ranging from 1 to 99,999 and denotes the significance
* of the field relative to the other indexed fields in terms of the score.
*
* @return the weighting object
*/
public JsonObject getWeights() {
return weights;
}
/**
* Sets the weighting object for use with a text index.
*
* An document that represents field and weight pairs. The weight is an integer ranging from 1 to 99,999 and denotes the significance
* of the field relative to the other indexed fields in terms of the score.
*
* @param weights the weighting object
* @return reference to this, for fluency
*/
public IndexOptions weights(JsonObject weights) {
this.weights = weights;
return this;
}
/**
* Gets the language for a text index.
*
* The language that determines the list of stop words and the rules for the stemmer and tokenizer.
*
* @return the language for a text index.
*/
public String getDefaultLanguage() {
return defaultLanguage;
}
/**
* Sets the language for the text index.
*
* The language that determines the list of stop words and the rules for the stemmer and tokenizer.
*
* @param defaultLanguage the language for the text index.
* @return reference to this, for fluency
*/
public IndexOptions defaultLanguage(String defaultLanguage) {
this.defaultLanguage = defaultLanguage;
return this;
}
/**
* Gets the name of the field that contains the language string.
*
* For text indexes, the name of the field, in the collection's documents, that contains the override language for the document.
*
* @return the name of the field that contains the language string.
*/
public String getLanguageOverride() {
return languageOverride;
}
/**
* Sets the name of the field that contains the language string.
*
* For text indexes, the name of the field, in the collection's documents, that contains the override language for the document.
*
* @param languageOverride the name of the field that contains the language string.
* @return reference to this, for fluency
*/
public IndexOptions languageOverride(String languageOverride) {
this.languageOverride = languageOverride;
return this;
}
/**
* The text index version number.
*
* @return the text index version number.
*/
public Integer getTextVersion() {
return textVersion;
}
/**
* Set the text index version number.
*
* @param textVersion the text index version number.
* @return reference to this, for fluency
*/
public IndexOptions textVersion(Integer textVersion) {
this.textVersion = textVersion;
return this;
}
/**
* Gets the 2dsphere index version number.
*
* @return the 2dsphere index version number
*/
public Integer getSphereVersion() {
return sphereVersion;
}
/**
* Sets the 2dsphere index version number.
*
* @param sphereVersion the 2dsphere index version number.
* @return reference to this, for fluency
*/
public IndexOptions sphereVersion(Integer sphereVersion) {
this.sphereVersion = sphereVersion;
return this;
}
/**
* Gets the number of precision of the stored geohash value of the location data in 2d indexes.
*
* @return the number of precision of the stored geohash value
*/
public Integer getBits() {
return bits;
}
/**
* Sets the number of precision of the stored geohash value of the location data in 2d indexes.
*
* @param bits the number of precision of the stored geohash value
* @return reference to this, for fluency
*/
public IndexOptions bits(Integer bits) {
this.bits = bits;
return this;
}
/**
* Gets the lower inclusive boundary for the longitude and latitude values for 2d indexes..
*
* @return the lower inclusive boundary for the longitude and latitude values.
*/
public Double getMin() {
return min;
}
/**
* Sets the lower inclusive boundary for the longitude and latitude values for 2d indexes..
*
* @param min the lower inclusive boundary for the longitude and latitude values
* @return reference to this, for fluency
*/
public IndexOptions min(Double min) {
this.min = min;
return this;
}
/**
* Gets the upper inclusive boundary for the longitude and latitude values for 2d indexes..
*
* @return the upper inclusive boundary for the longitude and latitude values.
*/
public Double getMax() {
return max;
}
/**
* Sets the upper inclusive boundary for the longitude and latitude values for 2d indexes..
*
* @param max the upper inclusive boundary for the longitude and latitude values
* @return reference to this, for fluency
*/
public IndexOptions max(Double max) {
this.max = max;
return this;
}
/**
* Gets the specified the number of units within which to group the location values for geoHaystack Indexes
*
* @return the specified the number of units within which to group the location values for geoHaystack Indexes
*/
public Double getBucketSize() {
return bucketSize;
}
/**
* Sets the specified the number of units within which to group the location values for geoHaystack Indexes
*
* @param bucketSize the specified the number of units within which to group the location values for geoHaystack Indexes
* @return reference to this, for fluency
*/
public IndexOptions bucketSize(Double bucketSize) {
this.bucketSize = bucketSize;
return this;
}
/**
* Gets the storage engine options document for this index.
*
* @return the storage engine options
*/
public JsonObject getStorageEngine() {
return storageEngine;
}
/**
* Sets the storage engine options document for this index.
*
* @param storageEngine the storage engine options
* @return reference to this, for fluency
*/
public IndexOptions storageEngine(JsonObject storageEngine) {
this.storageEngine = storageEngine;
return this;
}
/**
* Get the filter expression for the documents to be included in the index or null if not set
*
* @return the filter expression for the documents to be included in the index or null if not set
*/
public JsonObject getPartialFilterExpression() {
return partialFilterExpression;
}
/**
* Sets the filter expression for the documents to be included in the index
*
* @param partialFilterExpression the filter expression for the documents to be included in the index
* @return reference to this, for fluency
*/
public IndexOptions partialFilterExpression(JsonObject partialFilterExpression) {
this.partialFilterExpression = partialFilterExpression;
return this;
}
}