[[java-aggs-bucket-global]]
==== Global Aggregation

Here is how you can use
{ref}/search-aggregations-bucket-global-aggregation.html[Global Aggregation]
with Java API.


===== Prepare aggregation request

Here is an example on how to create the aggregation request:

[source,java]
--------------------------------------------------
AggregationBuilders
    .global("agg")
    .subAggregation(AggregationBuilders.terms("genders").field("gender"));
--------------------------------------------------


===== Use aggregation response

Import Aggregation definition classes:

[source,java]
--------------------------------------------------
import org.elasticsearch.search.aggregations.bucket.global.Global;
--------------------------------------------------

[source,java]
--------------------------------------------------
// sr is here your SearchResponse object
Global agg = sr.getAggregations().get("agg");
agg.getDocCount(); // Doc count
--------------------------------------------------
