Jest Start

Jest is a Java HTTP Rest client for Elasticsearch.It is actively developed and tested by Searchly.

A sample Java application using Jest can be found on GitHub https://github.com/searchly/searchly-java-sample.

Installation

Ensure you have added Sonatype repository to your pom.xml

1

2

3

4

5

6

7

8

9

10

11

12

<repositories>

.

.

   <repository>

     <id>sonatype</id>

     <name>Sonatype Groups</name>

     <url>https://oss.sonatype.org/content/groups/public/</url>

   </repository>

.

.

</repositories>

 

With Maven add Jest dependency to your pom.xml

1

2

3

4

5

<dependency>

  <groupId>io.searchbox</groupId>

  <artifactId>jest</artifactId>

  <version>0.1.2</version>

</dependency>

Install Jest via Maven

1

$ mvn clean install

Configuration

Create a Jest Client (Change apiKey with your api key):

1

2

3

4

5

6

7

8

9

10

// Construct a new Jest client according to configuration via factory

StringconnectionUrl="http://site:[e-mail]";

JestClientFactoryfactory=newJestClientFactory();

factory.setHttpClientConfig(newHttpClientConfig

      .Builder(connectionUrl)

      .multiThreaded(true)

      .build());

JestClientclient=factory.getObject();

 

Indexing

Create an index via Jest with ease;

1

client.execute(new CreateIndex.Builder("articles").build());

Create new document.

1

2

3

Articlesource=newArticle();

source.setAuthor("John Ronald Reuel Tolkien");

source.setContent("The Lord of the Rings is an epic high fantasy novel");

Index article to “articles” index with “article” type.

1

2

Index index = new Index.Builder(source).index("articles").type("article").build();

client.execute(index);

Searching

Search queries can be either JSON String or ElasticSearch SearchSourceBuilder object.

With Json string;

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

Stringquery="{\n"+

            "    \"query\": {\n"+

            "        \"filtered\" : {\n"+

            "            \"query\" : {\n"+

            "                \"query_string\" : {\n"+

            "                    \"query\" : \"Lord\"\n"+

            "                }\n"+

            "            }\n"+

            "        }\n"+

            "    }\n"+

            "}";

 

Searchsearch=(Search)newSearch.Builder(query)

                // multiple index or types can be added.

                .addIndex("articles")

                .addType("article")

                .build();

 

JestResultresult=client.execute(search);

 

With SearchSourceBuilder; (Add ElasticSearch as dependency if you want to use SearchSourceBuilder).

1

2

3

4

5

6

7

8

9

10

SearchSourceBuildersearchSourceBuilder=newSearchSourceBuilder();

searchSourceBuilder.query(QueryBuilders.queryString("Lord"));

 

Searchsearch=(Search)newSearch.Builder(searchSourceBuilder.toString())

                                // multiple index or types can be added.

                                .addIndex("articles")

                                .addType("article")

                                .build();

 

JestResultresult=client.execute(search);

Useful Resources

• Check out documentation of Jest here.