How to use

org.elasticsearch.search.aggregations.bucket.nested.NestedAggregationBuilder

constructor

/**
 * Create a new {@link Nested} aggregation with the given name.
 */
public static NestedAggregationBuilder nested(String name, String path) {
  return new NestedAggregationBuilder(name, path);
}

@Override
protected AggregationBuilder shallowCopy(Builder factoriesBuilder, Map<String, Object> metaData) {
  return new NestedAggregationBuilder(this, factoriesBuilder, metaData);
}

/**
 * Create a new {@link Nested} aggregation with the given name.
 */
public static NestedAggregationBuilder nested(String name, String path) {
  return new NestedAggregationBuilder(name, path);
}

/**
 * Create a new {@link Nested} aggregation with the given name.
 */
public static NestedAggregationBuilder nested(String name, String path) {
  return new NestedAggregationBuilder(name, path);
}

@Override
protected AggregationBuilder shallowCopy(Builder factoriesBuilder, Map<String, Object> metaData) {
  return new NestedAggregationBuilder(this, factoriesBuilder, metaData);
}

/**
 * Create a new {@link Nested} aggregation with the given name.
 */
public static NestedAggregationBuilder nested(String name, String path) {
  return new NestedAggregationBuilder(name, path);
}

@Override
protected AggregationBuilder shallowCopy(Builder factoriesBuilder, Map<String, Object> metaData) {
  return new NestedAggregationBuilder(this, factoriesBuilder, metaData);
}

public static NestedAggregationBuilder parse(String aggregationName, XContentParser parser) throws IOException {
  String path = null;
  XContentParser.Token token;
  String currentFieldName = null;
  while ((token = parser.nextToken()) != XContentParser.Token.END_OBJECT) {
    if (token == XContentParser.Token.FIELD_NAME) {
      currentFieldName = parser.currentName();
    } else if (token == XContentParser.Token.VALUE_STRING) {
      if (NestedAggregator.PATH_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
        path = parser.text();
      } else {
        throw new ParsingException(parser.getTokenLocation(),
            "Unknown key for a " + token + " in [" + aggregationName + "]: [" + currentFieldName + "].");
      }
    } else {
      throw new ParsingException(parser.getTokenLocation(), "Unexpected token " + token + " in [" + aggregationName + "].");
    }
  }
  if (path == null) {
    // "field" doesn't exist, so we fall back to the context of the ancestors
    throw new ParsingException(parser.getTokenLocation(), "Missing [path] field for nested aggregation [" + aggregationName + "]");
  }
  return new NestedAggregationBuilder(aggregationName, path);
}

public static NestedAggregationBuilder parse(String aggregationName, QueryParseContext context) throws IOException {
  String path = null;
  XContentParser.Token token;
  String currentFieldName = null;
  XContentParser parser = context.parser();
  while ((token = parser.nextToken()) != XContentParser.Token.END_OBJECT) {
    if (token == XContentParser.Token.FIELD_NAME) {
      currentFieldName = parser.currentName();
    } else if (token == XContentParser.Token.VALUE_STRING) {
      if (NestedAggregator.PATH_FIELD.match(currentFieldName)) {
        path = parser.text();
      } else {
        throw new ParsingException(parser.getTokenLocation(),
            "Unknown key for a " + token + " in [" + aggregationName + "]: [" + currentFieldName + "].");
      }
    } else {
      throw new ParsingException(parser.getTokenLocation(), "Unexpected token " + token + " in [" + aggregationName + "].");
    }
  }
  if (path == null) {
    // "field" doesn't exist, so we fall back to the context of the ancestors
    throw new ParsingException(parser.getTokenLocation(), "Missing [path] field for nested aggregation [" + aggregationName + "]");
  }
  return new NestedAggregationBuilder(aggregationName, path);
}

public static NestedAggregationBuilder parse(String aggregationName, XContentParser parser) throws IOException {
  String path = null;
  XContentParser.Token token;
  String currentFieldName = null;
  while ((token = parser.nextToken()) != XContentParser.Token.END_OBJECT) {
    if (token == XContentParser.Token.FIELD_NAME) {
      currentFieldName = parser.currentName();
    } else if (token == XContentParser.Token.VALUE_STRING) {
      if (NestedAggregator.PATH_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
        path = parser.text();
      } else {
        throw new ParsingException(parser.getTokenLocation(),
            "Unknown key for a " + token + " in [" + aggregationName + "]: [" + currentFieldName + "].");
      }
    } else {
      throw new ParsingException(parser.getTokenLocation(), "Unexpected token " + token + " in [" + aggregationName + "].");
    }
  }
  if (path == null) {
    // "field" doesn't exist, so we fall back to the context of the ancestors
    throw new ParsingException(parser.getTokenLocation(), "Missing [path] field for nested aggregation [" + aggregationName + "]");
  }
  return new NestedAggregationBuilder(aggregationName, path);
}

public static NestedAggregationBuilder parse(String aggregationName, XContentParser parser) throws IOException {
  String path = null;
  XContentParser.Token token;
  String currentFieldName = null;
  while ((token = parser.nextToken()) != XContentParser.Token.END_OBJECT) {
    if (token == XContentParser.Token.FIELD_NAME) {
      currentFieldName = parser.currentName();
    } else if (token == XContentParser.Token.VALUE_STRING) {
      if (NestedAggregator.PATH_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
        path = parser.text();
      } else {
        throw new ParsingException(parser.getTokenLocation(),
            "Unknown key for a " + token + " in [" + aggregationName + "]: [" + currentFieldName + "].");
      }
    } else {
      throw new ParsingException(parser.getTokenLocation(), "Unexpected token " + token + " in [" + aggregationName + "].");
    }
  }
  if (path == null) {
    // "field" doesn't exist, so we fall back to the context of the ancestors
    throw new ParsingException(parser.getTokenLocation(), "Missing [path] field for nested aggregation [" + aggregationName + "]");
  }
  return new NestedAggregationBuilder(aggregationName, path);
}