Elasticsearch java api reference

Hi,

Where do I find a 'real' elasticsearch java api reference? Not just some
examples of a few classes like here:
http://www.elasticsearch.org/guide/reference/java-api/

Thanks in advance
Ulli

--
You received this message because you are subscribed to the Google Groups "elasticsearch" group.
To unsubscribe from this group and stop receiving emails from it, send an email to elasticsearch+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

Um, is there really no api reference?

Am Montag, 18. Februar 2013 14:30:31 UTC+1 schrieb Ulli:

Hi,

Where do I find a 'real' elasticsearch java api reference? Not just some
examples of a few classes like here:
http://www.elasticsearch.org/guide/reference/java-api/

Thanks in advance
Ulli

--
You received this message because you are subscribed to the Google Groups "elasticsearch" group.
To unsubscribe from this group and stop receiving emails from it, send an email to elasticsearch+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

No, looks like there isnt (and believe me, I searched for it ;-)) Until
several versions ago there were at least javadocs available for download,
but this disappeared somehow. Solution is the classical do it yourself
approach: download source and generate javadoc. What helped me in the past
was: 1. searching this mailing list and 2. read the the source code,
usually you can figure out pretty good what is going on when looking at how
rest requests are transformed into java api calls or what is covered in the
test cases.

Am Dienstag, 19. Februar 2013 09:49:21 UTC+1 schrieb Ulli:

Um, is there really no api reference?

Am Montag, 18. Februar 2013 14:30:31 UTC+1 schrieb Ulli:

Hi,

Where do I find a 'real' elasticsearch java api reference? Not just some
examples of a few classes like here:
http://www.elasticsearch.org/guide/reference/java-api/

Thanks in advance
Ulli

--
You received this message because you are subscribed to the Google Groups "elasticsearch" group.
To unsubscribe from this group and stop receiving emails from it, send an email to elasticsearch+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

There is not much in the way of Java API reference, but the Java API
closely mirrors the JSON API. In practice, I usually figure out what I want
to do in the JSON API, and then find the corresponding Java API helper
methods in the Elasticsearch source code. It’s not ideal, but it also isn’t
too time consuming.

Would Elasticsearch be open to accepting documentation patches for the
query API that included examples in Java?

-Jon

--
You received this message because you are subscribed to the Google Groups "elasticsearch" group.
To unsubscribe from this group and stop receiving emails from it, send an email to elasticsearch+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

The JSON API does indeed closely resemble the Java API. The elastic.js
library takes advantage of that fact and provides
comprehensive documentation of the query DSL.

http://docs.fullscale.co/elasticjs/

On Tuesday, February 19, 2013 10:57:40 AM UTC-5, Jon Shea wrote:

There is not much in the way of Java API reference, but the Java API
closely mirrors the JSON API. In practice, I usually figure out what I want
to do in the JSON API, and then find the corresponding Java API helper
methods in the Elasticsearch source code. It’s not ideal, but it also isn’t
too time consuming.

Would Elasticsearch be open to accepting documentation patches for the
query API that included examples in Java?

-Jon

--
You received this message because you are subscribed to the Google Groups "elasticsearch" group.
To unsubscribe from this group and stop receiving emails from it, send an email to elasticsearch+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

Heya,

We pushed already some recent updates in the Java documentation.
We described Queries [1] , Filters [2] and Facets [3] in Java.

Can you describe what you would like to have in addition of that?

[1] http://www.elasticsearch.org/guide/reference/java-api/query-dsl-queries.html
[2] http://www.elasticsearch.org/guide/reference/java-api/query-dsl-filters.html
[3] http://www.elasticsearch.org/guide/reference/java-api/facets.html

--
David Pilato | Technical Advocate | Elasticsearch.com
@dadoonet | @elasticsearchfr | @scrutmydocs

Le 19 févr. 2013 à 16:57, Jon Shea jonshea@foursquare.com a écrit :

There is not much in the way of Java API reference, but the Java API closely mirrors the JSON API. In practice, I usually figure out what I want to do in the JSON API, and then find the corresponding Java API helper methods in the Elasticsearch source code. It’s not ideal, but it also isn’t too time consuming.

Would Elasticsearch be open to accepting documentation patches for the query API that included examples in Java?

-Jon

--
You received this message because you are subscribed to the Google Groups "elasticsearch" group.
To unsubscribe from this group and stop receiving emails from it, send an email to elasticsearch+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

--
You received this message because you are subscribed to the Google Groups "elasticsearch" group.
To unsubscribe from this group and stop receiving emails from it, send an email to elasticsearch+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

On Tuesday, February 19, 2013 at 11:07 AM, David Pilato wrote:

Can you describe what you would like to have in addition of that?

Hi David,

Wow, those are really great improvements. I noticed someone was committing new Java documentation, but I hadn’t realized how far along it had come. Thanks, it looks really great. I was imagining that in the query-dsl section of the documentation (http://www.elasticsearch.org/guide/reference/query-dsl/) each JSON example could have a corresponding Java example, either beneath it or linked from it. But I think the way things are set up now could work too, if I get in the habit of looking at the java-api documentation rather than just skipping sight to the Elasticsearch source.

-Jon

--
You received this message because you are subscribed to the Google Groups "elasticsearch" group.
To unsubscribe from this group and stop receiving emails from it, send an email to elasticsearch+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

Those updates are for sure an improvement, thanks once again! What comes to
my mind what would be still interesting:. 1. ready to use/download javadocs
(with maybe a little bit more docs inside) :wink: 2. maybe a short tutorial
like guide how to make use of metadata (what is included, how to resolving
aliases, getting mapping information, etc.). I believe new users would
benefit, this is not really straight forward or at least it took me quite
some time to puzzle it out.

Thanks!
Andrej

Am Dienstag, 19. Februar 2013 17:07:05 UTC+1 schrieb David Pilato:

Heya,

We pushed already some recent updates in the Java documentation.
We described Queries [1] , Filters [2] and Facets [3] in Java.

Can you describe what you would like to have in addition of that?

[1]
http://www.elasticsearch.org/guide/reference/java-api/query-dsl-queries.html
[2]
http://www.elasticsearch.org/guide/reference/java-api/query-dsl-filters.html
[3] http://www.elasticsearch.org/guide/reference/java-api/facets.html

--
David Pilato | Technical Advocate | Elasticsearch.com
@dadoonet https://twitter.com/dadoonet | @elasticsearchfrhttps://twitter.com/elasticsearchfr
| @scrutmydocs https://twitter.com/scrutmydocs

Le 19 févr. 2013 à 16:57, Jon Shea <jon...@foursquare.com <javascript:>>
a écrit :

There is not much in the way of Java API reference, but the Java API
closely mirrors the JSON API. In practice, I usually figure out what I want
to do in the JSON API, and then find the corresponding Java API helper
methods in the Elasticsearch source code. It’s not ideal, but it also isn’t
too time consuming.

Would Elasticsearch be open to accepting documentation patches for the
query API that included examples in Java?

-Jon

--
You received this message because you are subscribed to the Google Groups
"elasticsearch" group.
To unsubscribe from this group and stop receiving emails from it, send an
email to elasticsearc...@googlegroups.com <javascript:>.
For more options, visit https://groups.google.com/groups/opt_out.

--
You received this message because you are subscribed to the Google Groups "elasticsearch" group.
To unsubscribe from this group and stop receiving emails from it, send an email to elasticsearch+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

+1 for all admin commands in Java. I add it to my ToDo list.

For Javadocs, you can attach source code to your project.
https://oss.sonatype.org/content/repositories/releases/org/elasticsearch/elasticsearch/0.20.5/

It's not direct Javadoc for sure but should help at least.

--
David Pilato | Technical Advocate | Elasticsearch.com
@dadoonet | @elasticsearchfr | @scrutmydocs

Le 19 févr. 2013 à 17:38, Andrej Rosenheinrich andrej.rosenheinrich@unister.de a écrit :

Those updates are for sure an improvement, thanks once again! What comes to my mind what would be still interesting:. 1. ready to use/download javadocs (with maybe a little bit more docs inside) :wink: 2. maybe a short tutorial like guide how to make use of metadata (what is included, how to resolving aliases, getting mapping information, etc.). I believe new users would benefit, this is not really straight forward or at least it took me quite some time to puzzle it out.

Thanks!
Andrej

Am Dienstag, 19. Februar 2013 17:07:05 UTC+1 schrieb David Pilato:
Heya,

We pushed already some recent updates in the Java documentation.
We described Queries [1] , Filters [2] and Facets [3] in Java.

Can you describe what you would like to have in addition of that?

[1] http://www.elasticsearch.org/guide/reference/java-api/query-dsl-queries.html
[2] http://www.elasticsearch.org/guide/reference/java-api/query-dsl-filters.html
[3] http://www.elasticsearch.org/guide/reference/java-api/facets.html

--
David Pilato | Technical Advocate | Elasticsearch.com
@dadoonet | @elasticsearchfr | @scrutmydocs

Le 19 févr. 2013 à 16:57, Jon Shea jon...@foursquare.com a écrit :

There is not much in the way of Java API reference, but the Java API closely mirrors the JSON API. In practice, I usually figure out what I want to do in the JSON API, and then find the corresponding Java API helper methods in the Elasticsearch source code. It’s not ideal, but it also isn’t too time consuming.

Would Elasticsearch be open to accepting documentation patches for the query API that included examples in Java?

-Jon

--
You received this message because you are subscribed to the Google Groups "elasticsearch" group.
To unsubscribe from this group and stop receiving emails from it, send an email to elasticsearc...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

--
You received this message because you are subscribed to the Google Groups "elasticsearch" group.
To unsubscribe from this group and stop receiving emails from it, send an email to elasticsearch+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

--
You received this message because you are subscribed to the Google Groups "elasticsearch" group.
To unsubscribe from this group and stop receiving emails from it, send an email to elasticsearch+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.