• Home
• org.glowroot
• glowroot-agent-it-harness
• 0.10.10
• source code
• Pointcut.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

org.glowroot.agent.plugin.api.weaving.Pointcut Maven / Gradle / Ivy

/*
 * Copyright 2012-2018 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.glowroot.agent.plugin.api.weaving;

import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import static java.lang.annotation.ElementType.TYPE;
import static java.lang.annotation.RetentionPolicy.RUNTIME;

// pointcuts on constructors (methodName = "") are unusual
// because you cannot have a try catch handler than covers the call to the super constructor
// see https://bugs.openjdk.java.net/browse/JDK-8172282
// because of this, @IsEnabled is invoked prior to calling the super constructor
// and @OnBefore is invoked after calling the super constructor
// NOTE @IsEnabled could be invoked after calling the super constructor, but this causes stack frame
// headaches if some other bytecode manipulation added local variable prior to the super constructor
// call (which is not possible via straight Java code, but is legal in bytecode,
// see WeaverTest.shouldExecuteAdviceOnHackedConstructorBytecode())

@Target(TYPE)
@Retention(RUNTIME)
public @interface Pointcut {

    /**
     * Restrict the pointcut to methods that are declared in a classes (or interfaces) matching the
     * given name.
     * 
     * | and * can be used for limited regular expressions. Full regular expressions can be used by
     * starting and ending className with /
     */
    String className() default "";

    /**
     * Optionally (in addition to className or instead of className) restrict the pointcut to
     * methods that are declared in a classes (or interfaces) matching the given annotation.
     * 
     * | and * can be used for limited regular expressions. Full regular expressions can be used by
     * starting and ending classAnnotation with /
     */
    String classAnnotation() default "";

    /**
     * E.g. pointcut on className="java.util.concurrent.Future", methodName="get",
     * methodParameterTypes={}, but only for classes with
     * subTypeRestriction="com.ning.http.client.ListenableFuture"
     * 
     * | and * can be used for limited regular expressions. Full regular expressions can be used by
     * starting and ending subTypeRestriction with /
     */
    String subTypeRestriction() default "";

    /**
     * E.g. pointcut on className="com.yourcompany.*", methodName="run", methodParameterTypes={},
     * but only for classes with superTypeRestriction="java.lang.Runnable"
     * 
     * | and * can be used for limited regular expressions. Full regular expressions can be used by
     * starting and ending superTypeRestriction with /
     */
    String superTypeRestriction() default "";

    /**
     * | and * can be used for limited regular expressions. Full regular expressions can be used by
     * starting and ending methodName with /.
     */
    // use "" to weave constructors
    // patterns never match constructors
    // static initializers ("") are not supported
    String methodName() default "";
    // optionally (in addition to methodName or instead of methodName) restrict pointcut to methods
    // with the given annotation
    String methodAnnotation() default "";
    // methodParameterTypes has no default since it's not obvious if default should be {} or {".."}
    String[] methodParameterTypes();
    String methodReturnType() default "";
    MethodModifier[] methodModifiers() default {};
    String nestingGroup() default "";
    String timerName() default "";
    // order is used to order two pointcuts on the same method
    // it is used to nest pointcut inside another, e.g. creating a pointcut on HttpServlet.service()
    // to override transaction type, in which case the pointcut's @OnBefore needs to occur after the
    // servlet plugin's @OnBefore which starts the transaction
    //
    // orders can be negative if an ordering before the default 0 is needed
    //
    // given a pointcut A with order 0 and a pointcut B with order 10:
    // * A's @OnBefore will be called before B's @OnBefore
    // * A's @OnReturn will be called after B's @OnReturn
    // * A's @OnThrow will be called after B's @OnThrow
    // * A's @OnAfter will be called after B's @OnAfter
    int order() default 0;

    // advanced feature:

    String suppressibleUsingKey() default "";
    // will suppress nested even if pointcut is not enabled, and even if suppressed pointcut is on
    // same method but with lower order
    String suppressionKey() default "";
}