Session: How to Use MoreLikeThis

MoreLikeThis is available through query methods and will return similar documents according to the provided criteria and options.

Syntax

IDocumentQuery<T> moreLikeThis(MoreLikeThisBase moreLikeThis);

IDocumentQuery<T> moreLikeThis(Consumer<IMoreLikeThisBuilderForDocumentQuery<T>> builder);

Builder

IMoreLikeThisOperations<T> usingAnyDocument();

IMoreLikeThisOperations<T> usingDocument(String documentJson);

IMoreLikeThisOperations<T> usingDocument(Consumer<IFilterDocumentQueryBase<T, IDocumentQuery<T>>> builder);

IMoreLikeThisOperations<T> withOptions(MoreLikeThisOptions options);

Options

private Integer minimumTermFrequency = 2;
private Integer maximumQueryTerms = 25;
private Integer maximumNumberOfTokensParsed = 5000;
private Integer minimumWordLength = 0;
private Integer maximumWordLength = 0;
private Integer minimumDocumentFrequency = 5;
private Integer maximumDocumentFrequency = Integer.MAX_VALUE;
private Integer maximumDocumentFrequencyPercentage;
private Boolean boost = false;
private Float boostFactor = 1f;
private String stopWordsDocumentId;
private String[] fields;

// getters and setters

Example I

// Search for similar articles to 'articles/1'
// using 'Articles/MoreLikeThis' index and search only field 'body'
MoreLikeThisOptions options = new MoreLikeThisOptions();
options.setFields(new String[]{ "body" });

List<Article> articles = session
    .query(Article.class, Query.index("Articles/MoreLikeThis"))
    .moreLikeThis(builder -> builder
        .usingDocument(x -> x.whereEquals("id()", "articles/1"))
        .withOptions(options))
    .toList();

from index 'Articles/MoreLikeThis' 
where morelikethis(id() = 'articles/1', '{ "Fields" : [ "body" ] }')

Example II

// Search for similar articles to 'articles/1'
// using 'Articles/MoreLikeThis' index and search only field 'body'
// where article category is 'IT'
MoreLikeThisOptions options = new MoreLikeThisOptions();
options.setFields(new String[]{ "body" });
List<Article> articles = session
    .query(Article.class, Query.index("Articles/MoreLikeThis"))
    .moreLikeThis(builder -> builder
        .usingDocument(x -> x.whereEquals("id()", "articles/1"))
        .withOptions(options))
    .whereEquals("category", "IT")
    .toList();

from index 'Articles/MoreLikeThis' 
where morelikethis(id() = 'articles/1', '{ "Fields" : [ "body" ] }') and category == 'IT'