1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
/*
* Copyright (C) 2006 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.util;
import android.compat.annotation.UnsupportedAppUsage;
import android.os.Build;
import android.os.SystemClock;
import java.io.FileDescriptor;
import java.io.PrintWriter;
import java.time.Duration;
import java.time.Instant;
import java.time.LocalDateTime;
import java.util.ArrayDeque;
import java.util.Deque;
import java.util.Iterator;
/**
* @hide
*/
public final class LocalLog {
private final Deque<String> mLog;
private final int mMaxLines;
/**
* {@code true} to use log timestamps expressed in local date/time, {@code false} to use log
* timestamped expressed with the elapsed realtime clock and UTC system clock. {@code false} is
* useful when logging behavior that modifies device time zone or system clock.
*/
private final boolean mUseLocalTimestamps;
@UnsupportedAppUsage
public LocalLog(int maxLines) {
this(maxLines, true /* useLocalTimestamps */);
}
public LocalLog(int maxLines, boolean useLocalTimestamps) {
mMaxLines = Math.max(0, maxLines);
mLog = new ArrayDeque<>(mMaxLines);
mUseLocalTimestamps = useLocalTimestamps;
}
@UnsupportedAppUsage
public void log(String msg) {
if (mMaxLines <= 0) {
return;
}
final String logLine;
if (mUseLocalTimestamps) {
logLine = LocalDateTime.now() + " - " + msg;
} else {
logLine = Duration.ofMillis(SystemClock.elapsedRealtime())
+ " / " + Instant.now() + " - " + msg;
}
append(logLine);
}
private synchronized void append(String logLine) {
while (mLog.size() >= mMaxLines) {
mLog.remove();
}
mLog.add(logLine);
}
@UnsupportedAppUsage
public synchronized void dump(FileDescriptor fd, PrintWriter pw, String[] args) {
dump(pw);
}
public synchronized void dump(PrintWriter pw) {
dump("", pw);
}
/**
* Dumps the content of local log to print writer with each log entry predeced with indent
*
* @param indent indent that precedes each log entry
* @param pw printer writer to write into
*/
public synchronized void dump(String indent, PrintWriter pw) {
Iterator<String> itr = mLog.iterator();
while (itr.hasNext()) {
pw.printf("%s%s\n", indent, itr.next());
}
}
public synchronized void reverseDump(FileDescriptor fd, PrintWriter pw, String[] args) {
reverseDump(pw);
}
public synchronized void reverseDump(PrintWriter pw) {
Iterator<String> itr = mLog.descendingIterator();
while (itr.hasNext()) {
pw.println(itr.next());
}
}
public static class ReadOnlyLocalLog {
private final LocalLog mLog;
ReadOnlyLocalLog(LocalLog log) {
mLog = log;
}
@UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
public void dump(FileDescriptor fd, PrintWriter pw, String[] args) {
mLog.dump(pw);
}
public void dump(PrintWriter pw) {
mLog.dump(pw);
}
public void reverseDump(FileDescriptor fd, PrintWriter pw, String[] args) {
mLog.reverseDump(pw);
}
public void reverseDump(PrintWriter pw) {
mLog.reverseDump(pw);
}
}
@UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
public ReadOnlyLocalLog readOnlyLocalLog() {
return new ReadOnlyLocalLog(this);
}
}
|
