Class Invoke

A PatternElement to match a method invocation. Currently, we don't allow variables in this element (for arguments and return value). This would be a good thing to add. We also don't distinguish between invokevirtual, invokeinterface, and invokespecial.

Invoke objects match by class name, method name, method signature, and mode.

Names and signatures may be matched in several ways:

1. By an exact match. This is the default behavior.
2. By a regular expression. If the string provided to the Invoke constructor begins with a "/" character, the rest of the string is treated as a regular expression.
3. As a subclass match. This only applies to class name matches. If the first character of a class name string is "+", then the rest of the string is treated as the name of a base class. Any subclass or subinterface of the named type will be accepted.

The mode specifies what kind of invocations in the Invoke element matches. It is specified as the bitwise combination of the following values:

1. INSTANCE, which matches ordinary instance method invocations
2. STATIC, which matches static method invocations
3. CONSTRUCTOR, which matches object constructor invocations

The special mode ORDINARY_METHOD is equivalent to INSTANCE|STATIC. The special mode ANY is equivalent to INSTANCE|STATIC|CONSTRUCTOR.

Author: David Hovemeyer

See Also: PatternElement