0c3541be65
We now truncate Session method paths and IDs based on the Logging level to improve Session Logging readability in logcat. If another external session is started off of an existing external Session, the preceding histories are replaced with "..." so that the Session information is not overwhelming. Bug: 26571395 Test: Unit Tests and manual tests pass Change-Id: I9ffda3d64f1072fa6228a82a86116a5e47d18c96
99 lines
3.1 KiB
Java
99 lines
3.1 KiB
Java
/*
|
|
* Copyright (C) 2016 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 android.telecom.Logging;
|
|
|
|
import android.telecom.Log;
|
|
|
|
/**
|
|
* Encapsulates session logging in a Runnable to reduce code duplication when continuing subsessions
|
|
* in a handler/thread.
|
|
* @hide
|
|
*/
|
|
public abstract class Runnable {
|
|
|
|
private Session mSubsession;
|
|
private final String mSubsessionName;
|
|
private final Object mLock;
|
|
private final java.lang.Runnable mRunnable = new java.lang.Runnable() {
|
|
@Override
|
|
public void run() {
|
|
synchronized (mLock) {
|
|
try {
|
|
Log.continueSession(mSubsession, mSubsessionName);
|
|
loggedRun();
|
|
} finally {
|
|
if (mSubsession != null) {
|
|
Log.endSession();
|
|
mSubsession = null;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Creates a new Telecom Runnable that incorporates Session Logging into it. Useful for carrying
|
|
* Logging Sessions through different threads as well as through handlers.
|
|
* @param subsessionName The name that will be used in the Logs to mark this Session
|
|
* @param lock The synchronization lock that will be used to lock loggedRun().
|
|
*/
|
|
public Runnable(String subsessionName, Object lock) {
|
|
if (lock == null) {
|
|
mLock = new Object();
|
|
} else {
|
|
mLock = lock;
|
|
}
|
|
mSubsessionName = subsessionName;
|
|
}
|
|
|
|
/**
|
|
* Return the runnable that will be canceled in the handler queue.
|
|
* @return Runnable object to cancel.
|
|
*/
|
|
public final java.lang.Runnable getRunnableToCancel() {
|
|
return mRunnable;
|
|
}
|
|
|
|
/**
|
|
* Creates a Runnable and a logging subsession that can be used in a handler/thread. Be sure to
|
|
* call cancel() if this session is never going to be run (removed from a handler queue, for
|
|
* for example).
|
|
* @return A Java Runnable that can be used in a handler queue or thread.
|
|
*/
|
|
public java.lang.Runnable prepare() {
|
|
cancel();
|
|
mSubsession = Log.createSubsession();
|
|
return mRunnable;
|
|
}
|
|
|
|
/**
|
|
* This method is used to clean up the active session if the Runnable gets removed from a
|
|
* handler and is never run.
|
|
*/
|
|
public void cancel() {
|
|
synchronized (mLock) {
|
|
Log.cancelSubsession(mSubsession);
|
|
mSubsession = null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* The method that will be run in the handler/thread.
|
|
*/
|
|
abstract public void loggedRun();
|
|
|
|
} |