nl.topicus.jdbc.shaded.io.opencensus.stats.Aggregation 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.checkNotNull;
import nl.topicus.jdbc.shaded.com.google.auto.value.AutoValue;
import nl.topicus.jdbc.shaded.io.opencensus.common.Function;
import nl.topicus.jdbc.shaded.javax.annotation.concurrent.Immutable;
/**
* {@link Aggregation} is the process of combining a certain set of {@code MeasureValue}s for a
* given {@code Measure} into an {@link AggregationData}.
*
* {@link Aggregation} currently supports 4 types of basic aggregation:
*
*
* - Sum
*
- Count
*
- Mean
*
- Distribution
*
*
* When creating a {@link View}, one {@link Aggregation} needs to be specified as how to
* aggregate {@code MeasureValue}s.
*/
@Immutable
public abstract class Aggregation {
private Aggregation() {}
/** Applies the given match function to the underlying data type. */
public abstract T match(
Function p0,
Function p1,
Function p2,
Function p3,
Function defaultFunction);
/** Calculate sum on aggregated {@code MeasureValue}s. */
@Immutable
@AutoValue
public abstract static class Sum extends Aggregation {
Sum() {}
private static final Sum INSTANCE = new AutoValue_Aggregation_Sum();
/**
* Construct a {@code Sum}.
*
* @return a new {@code Sum}.
*/
public static Sum create() {
return INSTANCE;
}
@Override
public final T match(
Function p0,
Function p1,
Function p2,
Function p3,
Function defaultFunction) {
return p0.apply(this);
}
}
/** Calculate count on aggregated {@code MeasureValue}s. */
@Immutable
@AutoValue
public abstract static class Count extends Aggregation {
Count() {}
private static final Count INSTANCE = new AutoValue_Aggregation_Count();
/**
* Construct a {@code Count}.
*
* @return a new {@code Count}.
*/
public static Count create() {
return INSTANCE;
}
@Override
public final T match(
Function p0,
Function p1,
Function p2,
Function p3,
Function defaultFunction) {
return p1.apply(this);
}
}
/** Calculate mean on aggregated {@code MeasureValue}s. */
@Immutable
@AutoValue
public abstract static class Mean extends Aggregation {
Mean() {}
private static final Mean INSTANCE = new AutoValue_Aggregation_Mean();
/**
* Construct a {@code Mean}.
*
* @return a new {@code Mean}.
*/
public static Mean create() {
return INSTANCE;
}
@Override
public final T match(
Function p0,
Function p1,
Function p2,
Function p3,
Function defaultFunction) {
return p2.apply(this);
}
}
/**
* Calculate distribution stats on aggregated {@code MeasureValue}s. Distribution includes mean,
* count, histogram, min, max and sum of squared deviations.
*/
@Immutable
@AutoValue
public abstract static class Distribution extends Aggregation {
Distribution() {}
/**
* Construct a {@code Distribution}.
*
* @return a new {@code Distribution}.
*/
public static Distribution create(BucketBoundaries bucketBoundaries) {
checkNotNull(bucketBoundaries, "bucketBoundaries should not be null.");
return new AutoValue_Aggregation_Distribution(bucketBoundaries);
}
public abstract BucketBoundaries getBucketBoundaries();
@Override
public final T match(
Function p0,
Function p1,
Function p2,
Function p3,
Function defaultFunction) {
return p3.apply(this);
}
}
}