repositories {
    // ...
    mavenCentral()
}
dependencies {
    // ...
    compile 'com.blacklocus.jres:jres-core:0.2.0'
}

public class Main {

    public static void main(String[] args) {

        // Setup an index with a mapping for documents of type MyText.
        String index = "readme_test_index";
        String type = "definition";
        String mapping = "{" +
                "  \"definition\": {" +
                "    \"properties\": {" +
                "      \"body\": {" +
                "        \"type\": \"string\"" +
                "      }" +
                "    }" +
                "  }" +
                "}";

        Jres jres = new Jres(host);
        jres.quest(new JresCreateIndex(index));
        jres.quest(new JresPutMapping(index, type, mapping));

        // Index two documents (definitions via Google)
        Definition cat = new Definition("cat",
                "a small domesticated carnivorous mammal " +
                        "with soft fur, a short snout, and retractile claws. It is " +
                        "widely kept as a pet or for catching mice, and many breeds " +
                        "have been developed.");
        Definition dog = new Definition("dog",
                "a domesticated carnivorous mammal that " +
                        "typically has a long snout, an acute sense of smell, and a " +
                        "barking, howling, or whining voice. It is widely kept as a pet " +
                        "or for work or field sports.");
        jres.quest(new JresIndexDocument(index, type, cat));
        jres.quest(new JresIndexDocument(index, type, dog));

        // Do some querying
        JresMatchQuery retractileQuery = new JresMatchQuery("body", "retractile");
        JresMatchQuery mammalQuery = new JresMatchQuery("body", "mammal");
        JresMatchQuery alligatorQuery = new JresMatchQuery("body", "alligator");
        JresBoolQuery retractileAndMammalQuery = new JresBoolQuery()
                .must(retractileQuery, mammalQuery);

        // We need to flush the queue in ElasticSearch otherwise our recently
        // submitted documents may not yet be indexed.
        jres.quest(new JresFlush(index));

        JresSearchReply reply;

        System.out.println("Searching 'retractile'");
        reply = jres.quest(new JresSearch(index, type, new JresSearchBody()
                .query(retractileQuery)));
        for (Hit hit : reply.getHits().getHits()) {
            Definition definition = hit.getSourceAsType(Definition.class);
            System.out.println("  Found " + definition.term);
        }

        System.out.println("Searching 'mammal'");
        reply = jres.quest(new JresSearch(index, type, new JresSearchBody()
                .query(mammalQuery)));
        for (Hit hit : reply.getHits().getHits()) {
            Definition definition = hit.getSourceAsType(Definition.class);
            System.out.println("  Found " + definition.term);
        }

        System.out.println("Searching 'alligator'");
        reply = jres.quest(new JresSearch(index, type, new JresSearchBody()
                .query(alligatorQuery)));
        if (reply.getHits().getTotal() == 0) {
            System.out.println("  Nothing found about alligators");
        }

        System.out.println("Searching 'retractile' and 'mammal'");
        reply = jres.quest(new JresSearch(index, type, new JresSearchBody()
                .query(retractileAndMammalQuery)));
        for (Hit hit : reply.getHits().getHits()) {
            Definition definition = hit.getSourceAsType(Definition.class);
            System.out.println("  Found " + definition.term);
        }
    }

    // This must be (de)serializable by Jackson. I have chosen to go with
    // public fields, and provided a non-private default constructor.
    // This is just one of many ways to enable Jackson (de)serialization.
    static class Definition {
        public String term;
        public String body;

        Definition() {
        }

        public Definition(String term, String body) {
            this.term = term;
            this.body = body;
        }

        @Override
        public String toString() {
            return term + ": " + body;
        }
    }
}

Searching 'retractile'
  Found cat
Searching 'domestic'
  Found cat
  Found dog
Searching 'alligator'
  Nothing found about alligators
Searching 'retractile' and 'mammal'
  Found cat

Jres jres = new Jres(Suppliers.ofInstance("http://elasticsearchhost:9200/"));

UserCommentPojo document = new UserCommentPojo();
document.name = "test doc";
document.uploaded = System.currentTimeMillis();
document.content = "Hi, Mom.";

String elasticSearchIndex = "primarySite";
String elasticSearchDocumentType = "userComment";

jres.quest(new JresIndexDocument(elasticSearchIndex, elasticSearchDocumentType, document))

JresIndexDocumentReply reply = jres.quest(new JresIndexDocument(elasticSearchIndex, elasticSearchDocumentType, document))

// At this time, these objects should satisfy the default configuration of the Jackson `ObjectMapper`, i.e.
// public fields or standard bean property getters/setters.
class UserCommentPojo {
    public String name;
    public Long uploaded;
    public String contents;
}