19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 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 java.lang.reflect.Method; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.lang.reflect.InvocationTargetException; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Various utilities for debugging and logging.</p> 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class DebugUtils { 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Filters objects against the <code>ANDROID_OBJECT_FILTER</code> 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * environment variable. This environment variable can filter objects 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * based on their class name and attribute values.</p> 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Here is the syntax for <code>ANDROID_OBJECT_FILTER</code>:</p> 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p><code>ClassName@attribute1=value1@attribute2=value2...</code></p> 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Examples:</p> 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Select TextView instances: <code>TextView</code></li> 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Select TextView instances of text "Loading" and bottom offset of 22: 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>TextView@text=Loading.*@bottom=22</code></li> 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The class name and the values are regular expressions.</p> 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This class is useful for debugging and logging purpose:</p> 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <pre> 4634f1ca7b79ff678a651aea4b82e032b798506b37Dave Bort * if (DEBUG) { 4734f1ca7b79ff678a651aea4b82e032b798506b37Dave Bort * if (DebugUtils.isObjectSelected(childView) && LOGV_ENABLED) { 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Log.v(TAG, "Object " + childView + " logged!"); 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * } 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * } 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </pre> 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p><strong>NOTE</strong>: This method is very expensive as it relies 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * heavily on regular expressions and reflection. Calls to this method 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should always be stripped out of the release binaries and avoided 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as much as possible in debug mode.</p> 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param object any object to match against the ANDROID_OBJECT_FILTER 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * environement variable 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if object is selected by the ANDROID_OBJECT_FILTER 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * environment variable, false otherwise 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static boolean isObjectSelected(Object object) { 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean match = false; 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String s = System.getenv("ANDROID_OBJECT_FILTER"); 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (s != null && s.length() > 0) { 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] selectors = s.split("@"); 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // first selector == class name 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (object.getClass().getSimpleName().matches(selectors[0])) { 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // check potential attributes 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 1; i < selectors.length; i++) { 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] pair = selectors[i].split("="); 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Class<?> klass = object.getClass(); 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Method declaredMethod = null; 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Class<?> parent = klass; 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project do { 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project declaredMethod = parent.getDeclaredMethod("get" + 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pair[0].substring(0, 1).toUpperCase() + 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pair[0].substring(1), 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (Class[]) null); 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } while ((parent = klass.getSuperclass()) != null && 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project declaredMethod == null); 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (declaredMethod != null) { 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Object value = declaredMethod 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .invoke(object, (Object[])null); 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project match |= (value != null ? 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project value.toString() : "null").matches(pair[1]); 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (NoSuchMethodException e) { 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project e.printStackTrace(); 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IllegalAccessException e) { 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project e.printStackTrace(); 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (InvocationTargetException e) { 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project e.printStackTrace(); 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return match; 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 105