diff options
Diffstat (limited to 'api/src/main/java/io/opencensus/stats/StatsComponent.java')
-rw-r--r-- | api/src/main/java/io/opencensus/stats/StatsComponent.java | 74 |
1 files changed, 74 insertions, 0 deletions
diff --git a/api/src/main/java/io/opencensus/stats/StatsComponent.java b/api/src/main/java/io/opencensus/stats/StatsComponent.java new file mode 100644 index 00000000..9764fce5 --- /dev/null +++ b/api/src/main/java/io/opencensus/stats/StatsComponent.java @@ -0,0 +1,74 @@ +/* + * 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 io.opencensus.stats; + +/** + * Class that holds the implementations for {@link ViewManager} and {@link StatsRecorder}. + * + * <p>All objects returned by methods on {@code StatsComponent} are cacheable. + * + * @since 0.8 + */ +public abstract class StatsComponent { + + /** + * Returns the default {@link ViewManager}. + * + * @since 0.8 + */ + public abstract ViewManager getViewManager(); + + /** + * Returns the default {@link StatsRecorder}. + * + * @since 0.8 + */ + public abstract StatsRecorder getStatsRecorder(); + + /** + * Returns the current {@code StatsCollectionState}. + * + * <p>When no implementation is available, {@code getState} always returns {@link + * StatsCollectionState#DISABLED}. + * + * <p>Once {@link #getState()} is called, subsequent calls to {@link + * #setState(StatsCollectionState)} will throw an {@code IllegalStateException}. + * + * @return the current {@code StatsCollectionState}. + * @since 0.8 + */ + public abstract StatsCollectionState getState(); + + /** + * Sets the current {@code StatsCollectionState}. + * + * <p>When no implementation is available, {@code setState} does not change the state. + * + * <p>If state is set to {@link StatsCollectionState#DISABLED}, all stats that are previously + * recorded will be cleared. + * + * @param state the new {@code StatsCollectionState}. + * @throws IllegalStateException if {@link #getState()} was previously called. + * @deprecated This method is deprecated because other libraries could cache the result of {@link + * #getState()}, use a stale value, and behave incorrectly. It is only safe to call early in + * initialization. This method throws {@link IllegalStateException} after {@code getState()} + * has been called, in order to limit changes to the result of {@code getState()}. + * @since 0.8 + */ + @Deprecated + public abstract void setState(StatsCollectionState state); +} |