de.robv.android.xposed

Class XC_MethodHook

java.lang.Object

de.robv.android.xposed.callbacks.XCallback

de.robv.android.xposed.XC_MethodHook

Direct Known Subclasses:

XC_MethodReplacement

public abstract class XC_MethodHook
extends XCallback

Callback class for method hooks.

Usually, anonymous subclasses of this class are created which override beforeHookedMethod(de.robv.android.xposed.XC_MethodHook.MethodHookParam<?>) and/or afterHookedMethod(de.robv.android.xposed.XC_MethodHook.MethodHookParam<?>).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	XC_MethodHook.MethodHookParam<T extends java.lang.reflect.Executable> Wraps information about the method call and allows to influence it.
class	XC_MethodHook.Unhook An object with which the method/constructor can be unhooked.

Nested classes/interfaces inherited from class de.robv.android.xposed.callbacks.XCallback

XCallback.Param

Field Summary

Fields inherited from class de.robv.android.xposed.callbacks.XCallback

priority, PRIORITY_DEFAULT, PRIORITY_HIGHEST, PRIORITY_LOWEST

Constructor Summary

Constructors

Constructor and Description
XC_MethodHook() Creates a new callback with default priority.
XC_MethodHook(int priority) Creates a new callback with a specific priority.

Method Summary

Modifier and Type	Method and Description
protected void	afterHookedMethod(XC_MethodHook.MethodHookParam<?> param) Called after the invocation of the method.
protected void	beforeHookedMethod(XC_MethodHook.MethodHookParam<?> param) Called before the invocation of the method.
void	callAfterHookedMethod(XC_MethodHook.MethodHookParam<?> param)
void	callBeforeHookedMethod(XC_MethodHook.MethodHookParam<?> param)

Methods inherited from class de.robv.android.xposed.callbacks.XCallback

call, callAll

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

XC_MethodHook

public XC_MethodHook()

Creates a new callback with default priority.

XC_MethodHook

public XC_MethodHook(int priority)

Creates a new callback with a specific priority.

Note that afterHookedMethod(de.robv.android.xposed.XC_MethodHook.MethodHookParam<?>) will be called in reversed order, i.e. the callback with the highest priority will be called last. This way, the callback has the final control over the return value. beforeHookedMethod(de.robv.android.xposed.XC_MethodHook.MethodHookParam<?>) is called as usual, i.e. highest priority first.

Parameters:

priority - See XCallback.priority.

Method Detail

beforeHookedMethod

protected void beforeHookedMethod(XC_MethodHook.MethodHookParam<?> param)
                           throws java.lang.Throwable

Called before the invocation of the method.

You can use XC_MethodHook.MethodHookParam.setResult(java.lang.Object) and XC_MethodHook.MethodHookParam.setThrowable(java.lang.Throwable) to prevent the original method from being called.

Note that implementations shouldn't call super(param), it's not necessary.

Parameters:

param - Information about the method call.

Throws:

java.lang.Throwable - Everything the callback throws is caught and logged.

callBeforeHookedMethod

public void callBeforeHookedMethod(XC_MethodHook.MethodHookParam<?> param)
                            throws java.lang.Throwable

Throws:

java.lang.Throwable

afterHookedMethod

protected void afterHookedMethod(XC_MethodHook.MethodHookParam<?> param)
                          throws java.lang.Throwable

Called after the invocation of the method.

You can use XC_MethodHook.MethodHookParam.setResult(java.lang.Object) and XC_MethodHook.MethodHookParam.setThrowable(java.lang.Throwable) to modify the return value of the original method.

Note that implementations shouldn't call super(param), it's not necessary.

Parameters:

param - Information about the method call.

Throws:

java.lang.Throwable - Everything the callback throws is caught and logged.

callAfterHookedMethod

public void callAfterHookedMethod(XC_MethodHook.MethodHookParam<?> param)
                           throws java.lang.Throwable

Throws:

java.lang.Throwable