86 lines
2.4 KiB
Java
86 lines
2.4 KiB
Java
/*
|
|
* Copyright (C) 2018 The Android Open Source Project
|
|
*
|
|
* 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 com.google.android.setupcompat.logging;
|
|
|
|
import android.util.Log;
|
|
import com.google.android.setupcompat.internal.ClockProvider;
|
|
import com.google.android.setupcompat.internal.Preconditions;
|
|
|
|
/** Convenience utility to log duration events. Please note that this class is not thread-safe. */
|
|
public final class Timer {
|
|
/** Creates a new instance of timer for the given {@code metricKey}. */
|
|
public Timer(MetricKey metricKey) {
|
|
this.metricKey = metricKey;
|
|
}
|
|
|
|
/**
|
|
* Starts the timer and notes the current clock time.
|
|
*
|
|
* @throws IllegalStateException if the timer was stopped.
|
|
*/
|
|
public void start() {
|
|
Preconditions.checkState(!isStopped(), "Timer cannot be started once stopped.");
|
|
if (isStarted()) {
|
|
Log.wtf(
|
|
TAG,
|
|
String.format(
|
|
"Timer instance was already started for: %s at [%s].", metricKey, startInNanos));
|
|
return;
|
|
}
|
|
startInNanos = ClockProvider.timeInNanos();
|
|
}
|
|
|
|
/**
|
|
* Stops the watch and the current clock time is noted.
|
|
*
|
|
* @throws IllegalStateException if the watch was not started.
|
|
*/
|
|
public void stop() {
|
|
Preconditions.checkState(isStarted(), "Timer must be started before it can be stopped.");
|
|
if (isStopped()) {
|
|
Log.wtf(
|
|
TAG,
|
|
String.format(
|
|
"Timer instance was already stopped for: %s at [%s]", metricKey, stopInNanos));
|
|
return;
|
|
}
|
|
stopInNanos = ClockProvider.timeInNanos();
|
|
}
|
|
|
|
boolean isStopped() {
|
|
return stopInNanos != 0;
|
|
}
|
|
|
|
private boolean isStarted() {
|
|
return startInNanos != 0;
|
|
}
|
|
|
|
long getDurationInNanos() {
|
|
return stopInNanos - startInNanos;
|
|
}
|
|
|
|
MetricKey getMetricKey() {
|
|
return metricKey;
|
|
}
|
|
|
|
private long startInNanos;
|
|
private long stopInNanos;
|
|
private final MetricKey metricKey;
|
|
|
|
private static final String TAG = "SetupCompat.Timer";
|
|
}
|