nl.topicus.jdbc.shaded.io.opencensus.stats.Aggregation Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of spanner-jdbc Show documentation
JDBC Driver for Google Cloud Spanner
There is a newer version: 1.1.6
/*
 * 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.io.opencensus.internal.CheckerFrameworkUtils;
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
  // Suppress Checker Framework warning about missing @Nullable in generated equals method.
  @AutoValue.CopyAnnotations
  @SuppressWarnings("nullness")
  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 CheckerFrameworkUtils.removeSuperFromFunctionParameterType(p0).apply(this);
    }
  }

  /** Calculate count on aggregated {@code MeasureValue}s. */
  @Immutable
  @AutoValue
  // Suppress Checker Framework warning about missing @Nullable in generated equals method.
  @AutoValue.CopyAnnotations
  @SuppressWarnings("nullness")
  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 CheckerFrameworkUtils.removeSuperFromFunctionParameterType(p1).apply(this);
    }
  }

  /** Calculate mean on aggregated {@code MeasureValue}s. */
  @Immutable
  @AutoValue
  // Suppress Checker Framework warning about missing @Nullable in generated equals method.
  @AutoValue.CopyAnnotations
  @SuppressWarnings("nullness")
  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 CheckerFrameworkUtils.removeSuperFromFunctionParameterType(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
  // Suppress Checker Framework warning about missing @Nullable in generated equals method.
  @AutoValue.CopyAnnotations
  @SuppressWarnings("nullness")
  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 CheckerFrameworkUtils.removeSuperFromFunctionParameterType(p3)
          .apply(this);
    }
  }
}