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
|
/*
* Copyright (C) 2017 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.proto;
import android.util.AggStats;
import android.util.Duration;
import java.io.IOException;
import java.util.Arrays;
/**
* This class contains a list of helper functions to write common proto in
* //frameworks/base/core/proto/android/base directory
* @hide
*/
public class ProtoUtils {
/**
* Dump AggStats to ProtoOutputStream
*/
public static void toAggStatsProto(ProtoOutputStream proto, long fieldId,
long min, long average, long max, int meanKb, int maxKb) {
final long aggStatsToken = proto.start(fieldId);
proto.write(AggStats.MIN, min);
proto.write(AggStats.AVERAGE, average);
proto.write(AggStats.MAX, max);
proto.write(AggStats.MEAN_KB, meanKb);
proto.write(AggStats.MAX_KB, maxKb);
proto.end(aggStatsToken);
}
/**
* Dump AggStats to ProtoOutputStream
*/
public static void toAggStatsProto(ProtoOutputStream proto, long fieldId,
long min, long average, long max) {
toAggStatsProto(proto, fieldId, min, average, max, 0, 0);
}
/**
* Dump Duration to ProtoOutputStream
*/
public static void toDuration(ProtoOutputStream proto, long fieldId, long startMs, long endMs) {
final long token = proto.start(fieldId);
proto.write(Duration.START_MS, startMs);
proto.write(Duration.END_MS, endMs);
proto.end(token);
}
/**
* Helper function to write bit-wise flags to proto as repeated enums
*/
public static void writeBitWiseFlagsToProtoEnum(ProtoOutputStream proto, long fieldId,
int flags, int[] origEnums, int[] protoEnums) {
if (protoEnums.length != origEnums.length) {
throw new IllegalArgumentException("The length of origEnums must match protoEnums");
}
int len = origEnums.length;
for (int i = 0; i < len; i++) {
// handle zero flag case.
if (origEnums[i] == 0 && flags == 0) {
proto.write(fieldId, protoEnums[i]);
return;
}
if ((flags & origEnums[i]) != 0) {
proto.write(fieldId, protoEnums[i]);
}
}
}
/**
* Provide debug data about the current field as a string
*/
public static String currentFieldToString(ProtoInputStream proto) throws IOException {
StringBuilder sb = new StringBuilder();
final int fieldNumber = proto.getFieldNumber();
final int wireType = proto.getWireType();
long fieldConstant;
sb.append("Offset : 0x").append(Integer.toHexString(proto.getOffset()));
sb.append("\nField Number : 0x").append(Integer.toHexString(proto.getFieldNumber()));
sb.append("\nWire Type : ");
switch (wireType) {
case ProtoStream.WIRE_TYPE_VARINT:
fieldConstant = ProtoStream.makeFieldId(fieldNumber,
ProtoStream.FIELD_COUNT_SINGLE | ProtoStream.FIELD_TYPE_INT64);
sb.append("varint\nField Value : 0x");
sb.append(Long.toHexString(proto.readLong(fieldConstant)));
break;
case ProtoStream.WIRE_TYPE_FIXED64:
fieldConstant = ProtoStream.makeFieldId(fieldNumber,
ProtoStream.FIELD_COUNT_SINGLE | ProtoStream.FIELD_TYPE_FIXED64);
sb.append("fixed64\nField Value : 0x");
sb.append(Long.toHexString(proto.readLong(fieldConstant)));
break;
case ProtoStream.WIRE_TYPE_LENGTH_DELIMITED:
fieldConstant = ProtoStream.makeFieldId(fieldNumber,
ProtoStream.FIELD_COUNT_SINGLE | ProtoStream.FIELD_TYPE_BYTES);
sb.append("length delimited\nField Bytes : ");
sb.append(Arrays.toString(proto.readBytes(fieldConstant)));
break;
case ProtoStream.WIRE_TYPE_START_GROUP:
sb.append("start group");
break;
case ProtoStream.WIRE_TYPE_END_GROUP:
sb.append("end group");
break;
case ProtoStream.WIRE_TYPE_FIXED32:
fieldConstant = ProtoStream.makeFieldId(fieldNumber,
ProtoStream.FIELD_COUNT_SINGLE | ProtoStream.FIELD_TYPE_FIXED32);
sb.append("fixed32\nField Value : 0x");
sb.append(Integer.toHexString(proto.readInt(fieldConstant)));
break;
default:
sb.append("unknown(").append(proto.getWireType()).append(")");
}
return sb.toString();
}
}
|
