Log.java revision 00bb93823d082c31d757bd7b75a8615afbd2c1a5
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.util; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport com.android.internal.os.RuntimeInit; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.PrintWriter; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.StringWriter; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * API for sending log output. 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Generally, use the Log.v() Log.d() Log.i() Log.w() and Log.e() 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * methods. 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The order in terms of verbosity, from least to most is 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ERROR, WARN, INFO, DEBUG, VERBOSE. Verbose should never be compiled 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * into an application except during development. Debug logs are compiled 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in but stripped at runtime. Error, warning and info logs are always kept. 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p><b>Tip:</b> A good convention is to declare a <code>TAG</code> constant 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in your class: 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <pre>private static final String TAG = "MyActivity";</pre> 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and use that in subsequent calls to the log methods. 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </p> 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p><b>Tip:</b> Don't forget that when you make a call like 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <pre>Log.v(TAG, "index=" + i);</pre> 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that when you're building the string to pass into Log.d, the compiler uses a 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * StringBuilder and at least three allocations occur: the StringBuilder 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * itself, the buffer, and the String object. Realistically, there is also 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * another buffer allocation and copy, and even more pressure on the gc. 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * That means that if your log message is filtered out, you might be doing 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * significant work and incurring significant overhead. 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic final class Log { 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Priority constant for the println method; use Log.v. 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VERBOSE = 2; 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Priority constant for the println method; use Log.d. 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int DEBUG = 3; 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Priority constant for the println method; use Log.i. 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int INFO = 4; 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Priority constant for the println method; use Log.w. 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WARN = 5; 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Priority constant for the println method; use Log.e. 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR = 6; 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Priority constant for the println method. 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ASSERT = 7; 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8460d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor /** 8560d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * Exception class used to capture a stack trace in {@link #wtf()}. 8660d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor */ 8760d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor private static class TerribleFailure extends Exception { 8860d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor TerribleFailure(String msg, Throwable cause) { super(msg, cause); } 8960d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor } 9060d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Log() { 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #VERBOSE} log message. 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int v(String tag, String msg) { 10100bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, VERBOSE, tag, msg); 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #VERBOSE} log message and log the exception. 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tr An exception to log 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int v(String tag, String msg, Throwable tr) { 11200bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, VERBOSE, tag, msg + '\n' + getStackTraceString(tr)); 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #DEBUG} log message. 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int d(String tag, String msg) { 12200bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, DEBUG, tag, msg); 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #DEBUG} log message and log the exception. 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tr An exception to log 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int d(String tag, String msg, Throwable tr) { 13300bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, DEBUG, tag, msg + '\n' + getStackTraceString(tr)); 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send an {@link #INFO} log message. 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int i(String tag, String msg) { 14300bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, INFO, tag, msg); 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #INFO} log message and log the exception. 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tr An exception to log 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int i(String tag, String msg, Throwable tr) { 15400bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, INFO, tag, msg + '\n' + getStackTraceString(tr)); 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #WARN} log message. 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int w(String tag, String msg) { 16400bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, WARN, tag, msg); 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #WARN} log message and log the exception. 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tr An exception to log 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int w(String tag, String msg, Throwable tr) { 17500bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, WARN, tag, msg + '\n' + getStackTraceString(tr)); 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks to see whether or not a log for the specified tag is loggable at the specified level. 18060d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The default level of any tag is set to INFO. This means that any level above and including 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * INFO will be logged. Before you make any calls to a logging method you should check to see 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if your tag should be logged. You can change the default level by setting a system property: 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 'setprop log.tag.<YOUR_LOG_TAG> <LEVEL>' 18560d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * Where level is either VERBOSE, DEBUG, INFO, WARN, ERROR, ASSERT, or SUPPRESS. SUPPRESS will 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * turn off all logging for your tag. You can also create a local.prop file that with the 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * following in it: 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 'log.tag.<YOUR_LOG_TAG>=<LEVEL>' 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and place that in /data/local.prop. 19060d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag The tag to check. 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param level The level to check. 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Whether or not that this is allowed to be logged. 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException is thrown if the tag.length() > 23. 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static native boolean isLoggable(String tag, int level); 19760d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #WARN} log message and log the exception. 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tr An exception to log 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int w(String tag, Throwable tr) { 20500bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, WARN, tag, getStackTraceString(tr)); 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send an {@link #ERROR} log message. 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int e(String tag, String msg) { 21500bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, ERROR, tag, msg); 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #ERROR} log message and log the exception. 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tr An exception to log 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int e(String tag, String msg, Throwable tr) { 22600bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, ERROR, tag, msg + '\n' + getStackTraceString(tr)); 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 23060d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * What a Terrible Failure: Report a condition that should never happen. 23160d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * The error will always be logged at level ASSERT with the call stack. 23260d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * Depending on system configuration, a report may be added to the 23360d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * {@link android.os.DropBoxManager} and/or the process may be terminated 23460d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * immediately with an error dialog. 23560d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * @param tag Used to identify the source of a log message. 23660d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * @param msg The message you would like logged. 23760d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor */ 23860d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor public static int wtf(String tag, String msg) { 23960d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor return wtf(tag, msg, null); 24060d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor } 24160d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor 24260d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor /** 24360d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * What a Terrible Failure: Report an exception that should never happen. 24460d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * Similar to {@link #wtf(String, String)}, with an exception to log. 24560d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * @param tag Used to identify the source of a log message. 24660d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * @param tr An exception to log. 24760d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor */ 24860d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor public static int wtf(String tag, Throwable tr) { 24960d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor return wtf(tag, tr.getMessage(), tr); 25060d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor } 25160d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor 25260d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor /** 25360d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * What a Terrible Failure: Report an exception that should never happen. 25460d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * Similar to {@link #wtf(String, Throwable)}, with a message as well. 25560d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * @param tag Used to identify the source of a log message. 25660d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * @param msg The message you would like logged. 25760d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * @param tr An exception to log. May be null. 25860d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor */ 25960d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor public static int wtf(String tag, String msg, Throwable tr) { 26060d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor tr = new TerribleFailure(msg, tr); 26100bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato int bytes = println_native(LOG_ID_MAIN, ASSERT, tag, getStackTraceString(tr)); 26260d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor RuntimeInit.wtf(tag, tr); 26360d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor return bytes; 26460d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor } 26560d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor 26660d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor /** 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Handy function to get a loggable stack trace from a Throwable 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tr An exception to log 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String getStackTraceString(Throwable tr) { 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (tr == null) { 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ""; 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringWriter sw = new StringWriter(); 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PrintWriter pw = new PrintWriter(sw); 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project tr.printStackTrace(pw); 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sw.toString(); 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Low-level logging call. 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param priority The priority/type of this log message 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The number of bytes written. 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 28800bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato public static int println(int priority, String tag, String msg) { 28900bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, priority, tag, msg); 29000bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato } 29100bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato 29200bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato static final int LOG_ID_MAIN = 0; 29300bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato static final int LOG_ID_RADIO = 1; 29400bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato static final int LOG_ID_EVENTS = 2; 29500bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato static final int LOG_ID_SYSTEM = 3; 29600bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato 29700bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato static native int println_native(int bufID, int priority, String tag, String msg); 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 299