com.newrelic.agent.instrumentation

Class ClassNameFilter

java.lang.Object

com.newrelic.agent.instrumentation.ClassNameFilter

public class ClassNameFilter
extends java.lang.Object

This filter is used to skip certain classes during the classloading transform callback based on the class name.

Constructor Summary

Constructors

Constructor and Description
ClassNameFilter(IAgentLogger logger)

Method Summary

Modifier and Type	Method and Description
void	addClassMatcherIncludes(java.util.Collection<ClassMatcher> classMatchers)
void	addConfigClassFilters(AgentConfig config) Add include/exclude classes in the configuration file.
void	addExclude(java.lang.String exclude) Exclude matching classes.
void	addExcludeClass(java.lang.String className) Exclude the given class.
void	addExcludeFileClassFilters() Add excluded classes in the META-INF/excludes file.
void	addExcludeRegex(java.lang.String regex) Exclude classes matching the regular expression.
void	addInclude(java.lang.String include) Include matching classes.
void	addIncludeClass(java.lang.String className) Include the given class.
void	addIncludeRegex(java.lang.String regex) Include classes matching the regular expression.
boolean	isExcluded(java.lang.String className) Check if a class should be excluded from class transformation based on an excludes rule.
boolean	isIncluded(java.lang.String className) Is the class included.

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassNameFilter

public ClassNameFilter(IAgentLogger logger)

Method Detail

isExcluded

public boolean isExcluded(java.lang.String className)

Check if a class should be excluded from class transformation based on an excludes rule.

excludePatterns is a list of exclude rules merged together from user config and the default META-INF/excludes file. Exclude rules are evaluated when determining whether to transform weaved classes in the InstrumentationContextManager or pointcuts in the PointCutClassTransformer.

Parameters:

className - name of the class to check exclusion rule for

Returns:

true if this is an excluded class, false if not

isIncluded

public boolean isIncluded(java.lang.String className)

Is the class included.

Returns:

true if this is an included class, false if not

addConfigClassFilters

public void addConfigClassFilters(AgentConfig config)

Add include/exclude classes in the configuration file.

addExcludeFileClassFilters

public void addExcludeFileClassFilters()

Add excluded classes in the META-INF/excludes file.

addInclude

public void addInclude(java.lang.String include)

Include matching classes.

Parameters:

include - either a class name or a regular expression

addIncludeClass

public void addIncludeClass(java.lang.String className)

Include the given class.

Parameters:

className - the name of the class to include

addIncludeRegex

public void addIncludeRegex(java.lang.String regex)

Include classes matching the regular expression.

Parameters:

regex - a regular expression matching classes to include

addExclude

public void addExclude(java.lang.String exclude)

Exclude matching classes.

Parameters:

exclude - either a class name or a regular expression

addExcludeClass

public void addExcludeClass(java.lang.String className)

Exclude the given class.

Parameters:

className - the name of the class to exclude

addExcludeRegex

public void addExcludeRegex(java.lang.String regex)

Exclude classes matching the regular expression.

Parameters:

regex - a regular expression matching classes to include

addClassMatcherIncludes

public void addClassMatcherIncludes(java.util.Collection<ClassMatcher> classMatchers)