nl.topicus.jdbc.shaded.io.opencensus.stats.AggregationData Maven / Gradle / Ivy
Show all versions of spanner-jdbc Show documentation
/*
* Copyright 2017, OpenCensus Authors
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package nl.topicus.jdbc.shaded.io.opencensus.stats;
import static nl.topicus.jdbc.shaded.com.google.common.base.Preconditions.checkArgument;
import static nl.topicus.jdbc.shaded.com.google.common.base.Preconditions.checkNotNull;
import nl.topicus.jdbc.shaded.com.google.auto.value.AutoValue;
import nl.topicus.jdbc.shaded.com.google.common.collect.Lists;
import nl.topicus.jdbc.shaded.io.opencensus.common.Function;
import java.util.Collections;
import java.util.List;
import nl.topicus.jdbc.shaded.javax.annotation.concurrent.Immutable;
/**
* {@link AggregationData} is the result of applying a given {@link Aggregation} to a set of {@code
* MeasureValue}s.
*
* {@link AggregationData} currently supports 5 types of basic aggregation values:
*
*
* - SumDataDouble
*
- SumDataLong
*
- CountData
*
- MeanData
*
- DistributionData
*
*
* {@link ViewData} will contain one {@link AggregationData}, corresponding to its {@link
* Aggregation} definition in {@link View}.
*/
@Immutable
public abstract class AggregationData {
private AggregationData() {}
/** Applies the given match function to the underlying data type. */
public abstract T match(
Function p0,
Function p1,
Function p2,
Function p3,
Function p4,
Function defaultFunction);
/** The sum value of aggregated {@code MeasureValueDouble}s. */
@Immutable
@AutoValue
public abstract static class SumDataDouble extends AggregationData {
SumDataDouble() {}
/**
* Creates a {@code SumDataDouble}.
*
* @param sum the aggregated sum.
* @return a {@code SumDataDouble}.
*/
public static SumDataDouble create(double sum) {
return new AutoValue_AggregationData_SumDataDouble(sum);
}
/**
* Returns the aggregated sum.
*
* @return the aggregated sum.
*/
public abstract double getSum();
@Override
public final T match(
Function p0,
Function p1,
Function p2,
Function p3,
Function p4,
Function defaultFunction) {
return p0.apply(this);
}
}
/** The sum value of aggregated {@code MeasureValueLong}s. */
@Immutable
@AutoValue
public abstract static class SumDataLong extends AggregationData {
SumDataLong() {}
/**
* Creates a {@code SumDataLong}.
*
* @param sum the aggregated sum.
* @return a {@code SumDataLong}.
*/
public static SumDataLong create(long sum) {
return new AutoValue_AggregationData_SumDataLong(sum);
}
/**
* Returns the aggregated sum.
*
* @return the aggregated sum.
*/
public abstract long getSum();
@Override
public final T match(
Function p0,
Function p1,
Function p2,
Function p3,
Function p4,
Function defaultFunction) {
return p1.apply(this);
}
}
/** The count value of aggregated {@code MeasureValue}s. */
@Immutable
@AutoValue
public abstract static class CountData extends AggregationData {
CountData() {}
/**
* Creates a {@code CountData}.
*
* @param count the aggregated count.
* @return a {@code CountData}.
*/
public static CountData create(long count) {
return new AutoValue_AggregationData_CountData(count);
}
/**
* Returns the aggregated count.
*
* @return the aggregated count.
*/
public abstract long getCount();
@Override
public final T match(
Function p0,
Function p1,
Function p2,
Function p3,
Function p4,
Function defaultFunction) {
return p2.apply(this);
}
}
/** The mean value of aggregated {@code MeasureValue}s. */
@Immutable
@AutoValue
public abstract static class MeanData extends AggregationData {
MeanData() {}
/**
* Creates a {@code MeanData}.
*
* @param mean the aggregated mean.
* @param count the aggregated count.
* @return a {@code MeanData}.
*/
public static MeanData create(double mean, long count) {
return new AutoValue_AggregationData_MeanData(mean, count);
}
/**
* Returns the aggregated mean.
*
* @return the aggregated mean.
*/
public abstract double getMean();
/**
* Returns the aggregated count.
*
* @return the aggregated count.
*/
public abstract long getCount();
@Override
public final T match(
Function p0,
Function p1,
Function p2,
Function p3,
Function p4,
Function defaultFunction) {
return p3.apply(this);
}
}
/**
* The distribution stats of aggregated {@code MeasureValue}s. Distribution stats include mean,
* count, histogram, min, max and sum of squared deviations.
*/
@Immutable
@AutoValue
public abstract static class DistributionData extends AggregationData {
DistributionData() {}
/**
* Creates a {@code DistributionData}.
*
* @param mean mean value.
* @param count count value.
* @param min min value.
* @param max max value.
* @param sumOfSquaredDeviations sum of squared deviations.
* @param bucketCounts histogram bucket counts.
* @return a {@code DistributionData}.
*/
public static DistributionData create(
double mean,
long count,
double min,
double max,
double sumOfSquaredDeviations,
List bucketCounts) {
if (min != Double.POSITIVE_INFINITY || max != Double.NEGATIVE_INFINITY) {
checkArgument(min <= max, "max should be greater or equal to min.");
}
checkNotNull(bucketCounts, "bucket counts should not be null.");
List bucketCountsCopy = Collections.unmodifiableList(Lists.newArrayList(bucketCounts));
for (Long bucket : bucketCountsCopy) {
checkNotNull(bucket, "bucket should not be null.");
}
return new AutoValue_AggregationData_DistributionData(
mean, count, min, max, sumOfSquaredDeviations, bucketCountsCopy);
}
/**
* Returns the aggregated mean.
*
* @return the aggregated mean.
*/
public abstract double getMean();
/**
* Returns the aggregated count.
*
* @return the aggregated count.
*/
public abstract long getCount();
/**
* Returns the minimum of the population values.
*
* @return the minimum of the population values.
*/
public abstract double getMin();
/**
* Returns the maximum of the population values.
*
* @return the maximum of the population values.
*/
public abstract double getMax();
/**
* Returns the aggregated sum of squared deviations.
*
* @return the aggregated sum of squared deviations.
*/
public abstract double getSumOfSquaredDeviations();
/**
* Returns the aggregated bucket counts. The returned list is immutable, trying to update it
* will throw an {@code UnsupportedOperationException}.
*
* @return the aggregated bucket counts.
*/
public abstract List getBucketCounts();
@Override
public final T match(
Function p0,
Function p1,
Function p2,
Function p3,
Function p4,
Function defaultFunction) {
return p4.apply(this);
}
}
}