com.oracle.graal.debug

Class MethodFilter

java.lang.Object

com.oracle.graal.debug.MethodFilter

public class MethodFilter
extends Object

This class implements a method filter that can filter based on class name, method name and parameters. The syntax for the source pattern that is passed to the constructor is as follows:

 SourcePatterns = SourcePattern ["," SourcePatterns] .
 SourcePattern = [ Class "." ] method [ "(" [ Parameter { ";" Parameter } ] ")" ] .
 Parameter = Class | "int" | "long" | "float" | "double" | "short" | "char" | "boolean" .
 Class = { package "." } class .
 

Glob pattern matching (*, ?) is allowed in all parts of the source pattern. Examples for valid filters are:

•  visit(Argument;BlockScope)
   

  Matches all methods named "visit", with the first parameter of type "Argument", and the second parameter of type "BlockScope". The packages of the parameter types are irrelevant.

•  arraycopy(Object;;;;)
   

  Matches all methods named "arraycopy", with the first parameter of type "Object", and four more parameters of any type. The packages of the parameter types are irrelevant.

•  com.oracle.graal.compiler.graph.PostOrderNodeIterator.*
   

  Matches all methods in the class "com.oracle.graal.compiler.graph.PostOrderNodeIterator".

•  *
   

  Matches all methods in all classes

•  com.oracle.graal.compiler.graph.*.visit
   

  Matches all methods named "visit" in classes in the package "com.oracle.graal.compiler.graph".

•  arraycopy,toString
   

  Matches all methods named "arraycopy" or "toString", meaning that ',' acts as an or operator.

Field Summary

Fields

Modifier and Type	Field and Description
private Pattern	clazz
private Pattern	methodName
private Pattern[]	signature

Constructor Summary

Constructors

Constructor and Description
MethodFilter(String sourcePattern)

Method Summary

Modifier and Type	Method and Description
private static Pattern	createClassGlobPattern(String pattern)
static String	createGlobString(String pattern)
boolean	matches(JavaMethod o)
static boolean	matches(MethodFilter[] filters, JavaMethod method) Determines if a given method is matched by a given array of filters.
static boolean	matchesClassName(MethodFilter[] filters, String className) Determines if a given class name is matched by a given array of filters.
boolean	matchesClassName(String className) Determines if the class part of this filter matches a given class name.
static MethodFilter[]	parse(String commaSeparatedPatterns) Parses a string containing list of comma separated filter patterns into an array of MethodFilters.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

clazz

private final Pattern clazz

methodName

private final Pattern methodName

signature

private final Pattern[] signature

Constructor Detail

MethodFilter

public MethodFilter(String sourcePattern)

Method Detail

parse

public static MethodFilter[] parse(String commaSeparatedPatterns)

Parses a string containing list of comma separated filter patterns into an array of MethodFilters.

matches

public static boolean matches(MethodFilter[] filters,
                              JavaMethod method)

Determines if a given method is matched by a given array of filters.

matchesClassName

public static boolean matchesClassName(MethodFilter[] filters,
                                       String className)

Determines if a given class name is matched by a given array of filters.

createGlobString

public static String createGlobString(String pattern)

createClassGlobPattern

private static Pattern createClassGlobPattern(String pattern)

matchesClassName

public boolean matchesClassName(String className)

Determines if the class part of this filter matches a given class name.

matches

public boolean matches(JavaMethod o)

toString

public String toString()

Overrides:

toString in class Object