19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2008 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 com.android.tools.layoutlib.create; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Interface to allow a method invocation to be listened upon. 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p/> 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is used by {@link OverrideMethod} to register a listener for methods that 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * have been stubbed by the {@link AsmGenerator}. At runtime the stub will call either a 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * default global listener or a specific listener based on the method signature. 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic interface MethodListener { 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A stub method is being invoked. 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p/> 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Known limitation: caller arguments are not available. 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param signature The signature of the method being invoked, composed of the 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * binary class name followed by the method descriptor (aka argument 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * types). Example: "com/foo/MyClass/InnerClass/printInt(I)V". 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param isNative True if the method was a native method. 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param caller The calling object. Null for static methods, "this" for instance methods. 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onInvokeV(String signature, boolean isNative, Object caller); 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Same as {@link #onInvokeV(String, boolean, Object)} but returns an integer or similar. 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #onInvokeV(String, boolean, Object) 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return an integer, or a boolean, or a short or a byte. 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int onInvokeI(String signature, boolean isNative, Object caller); 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Same as {@link #onInvokeV(String, boolean, Object)} but returns a long. 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #onInvokeV(String, boolean, Object) 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a long. 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public long onInvokeL(String signature, boolean isNative, Object caller); 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Same as {@link #onInvokeV(String, boolean, Object)} but returns a float. 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #onInvokeV(String, boolean, Object) 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a float. 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float onInvokeF(String signature, boolean isNative, Object caller); 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Same as {@link #onInvokeV(String, boolean, Object)} but returns a double. 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #onInvokeV(String, boolean, Object) 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a double. 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public double onInvokeD(String signature, boolean isNative, Object caller); 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Same as {@link #onInvokeV(String, boolean, Object)} but returns an object. 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #onInvokeV(String, boolean, Object) 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return an object. 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Object onInvokeA(String signature, boolean isNative, Object caller); 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 77