[Doc] Update "Java API Administration >> Indices Administration" page

[lockwobr]

This example in the Java API Administration docs does not work correctly and is very miss leading.

Example reads:

client.admin().indices().prepareCreate("twitter")   
        .addMapping("\"tweet\": {\n" +              
                "  \"properties\": {\n" +
                "    \"message\": {\n" +
                "      \"type\": \"text\"\n" +
                "    }\n" +
                "  }\n" +
                "}")
        .get();

This example works, but it does not create the index correctly it seems, the example should read

client.admin.indices().prepareCreate("twitter")
         .addMapping("tweet", "message", "type=text").get();

[elasticmachine]

Pinging @elastic/es-core-infra

[cbuescher]

it does not create the index correctly it seems

Hi @lockwobr, what seems to be the problem with the created index? I just tried it and it works fine. What version of Elasticsearch are you using?

[lockwobr]

The problem is with the mapping it creates, does not seem right and if you try a more complicated example it will error out.

Example from the docs creates this mapping:

curl -X GET "localhost:9200/twitter/_mapping/"
{
  "twitter": {
    "mappings": {
      "\"tweet\": {\n  \"properties\": {\n    \"message\": {\n      \"type\": \"text\"\n    }\n  }\n}": {}
    }
  }
}

The I think how the function should be called produces this:

curl -X GET "localhost:9200/twitter/_mapping/"
{
  "twitter": {
    "mappings": {
      "tweet": {
        "properties": {
          "message": {
            "type": "text"
          }
        }
      }
    }
  }
}

What lead me down this path is if you try this it errors out all together, so I started to read the code an noticed that you need to call the function way differently.

client.admin().indices().prepareCreate("twitter").addMapping(
      "\"tweet\": {\n" +
        "  \"properties\": {\n" +
        "    \"location\": {\n" +
        "      \"type\": \"geo_shape\", \n" +
        "      \"tree\": \"quadtree\", \n" +
        "      \"precision\": \"10m\"\n" +
        "    }\n" +
        "  }\n" +
        "}").get();

Errors:

org.elasticsearch.indices.InvalidTypeNameException: mapping type name ["tweet": {
  "properties": {
    "location": {
      "type": "geo_shape",
      "tree": "quadtree",
      "precision": "10m"
    }
  }
}] should not include ',' in it
  at org.elasticsearch.index.mapper.MapperService.validateTypeName(MapperService.java:370)
  at org.elasticsearch.index.mapper.MapperService.internalMerge(MapperService.java:401)
  at org.elasticsearch.index.mapper.MapperService.internalMerge(MapperService.java:353)
  at org.elasticsearch.index.mapper.MapperService.merge(MapperService.java:277)
  at org.elasticsearch.cluster.metadata.MetaDataCreateIndexService$IndexCreationTask.execute(MetaDataCreateIndexService.java:444)
  at org.elasticsearch.cluster.ClusterStateUpdateTask.execute(ClusterStateUpdateTask.java:45)
  at org.elasticsearch.cluster.service.MasterService.executeTasks(MasterService.java:643)
  at org.elasticsearch.cluster.service.MasterService.calculateTaskOutputs(MasterService.java:273)
  at org.elasticsearch.cluster.service.MasterService.runTasks(MasterService.java:198)
  at org.elasticsearch.cluster.service.MasterService$Batcher.run(MasterService.java:133)
  at org.elasticsearch.cluster.service.TaskBatcher.runIfNotProcessed(TaskBatcher.java:150)
  at org.elasticsearch.cluster.service.TaskBatcher$BatchedTask.run(TaskBatcher.java:188)
  at org.elasticsearch.common.util.concurrent.ThreadContext$ContextPreservingRunnable.run(ThreadContext.java:573)
  at org.elasticsearch.common.util.concurrent.PrioritizedEsThreadPoolExecutor$TieBreakingPrioritizedRunnable.runAndClean(PrioritizedEsThreadPoolExecutor.java:244)
  at org.elasticsearch.common.util.concurrent.PrioritizedEsThreadPoolExecutor$TieBreakingPrioritizedRunnable.run(PrioritizedEsThreadPoolExecutor.java:207)
  at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
  at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
  at java.lang.Thread.run(Thread.java:748)

After looking at the code figured out if you change the above to it works.

client.admin.indices().prepareCreate("twitter").addMapping("tweet", "location", "type=geo_shape,tree=quadtree,precision=10m").get()

Version

"version": {
"number": "6.2.2",
"build_hash": "10b1edd",
"build_date": "2018-02-16T19:01:30.685723Z",
"build_snapshot": false,
"lucene_version": "7.2.1",
"minimum_wire_compatibility_version": "5.6.0",
"minimum_index_compatibility_version": "5.0.0"
}

[cbuescher]

@lockwobr wow, great catch. I stand corrected. Thanks for letting us know, this is certainly an error in the documentation in this case and should be corrected.

[lockwobr]

Your welcome. I kind of think it should be a bug in the client code too, because I feel it shouldn't really let you call it the way it is in the document. There is a check for it in the code, but its not working it seems. It wants pairs of params, and some how it is if you have one it seems to let pass the check.