El objeto de sonda Target es una especificación de las clases y métodos a los que debe aplicarse la sonda.
El objeto Target es opcional. Cuando no se especifica ningún objeto Target, la sonda se aplicará a todas las clases que procesa el motor de instrumentación.
El objeto Target le permite crear reglas de filtrado para incluir o excluir métodos de la instrumentación en función de patrones que se comparan respecto al paquete, clase y nombre de método, además de la signatura del método. Los patrones pueden contener comodines, donde "*" coincidirá con cero o más caracteres.
Si los patrones comodín de un objeto Target coinciden con el paquete, clase, nombre y signatura de un método, la propiedad type determina si el método se instrumenta (include) o no (exclude). Si los patrones no coinciden con el paquete, clase, nombre y signatura de un método, por omisión, el método se instrumenta.
Propiedad | Descripción |
---|---|
type | Obligatoria. La propiedad type determina si una sonda se aplica o no a un método de destino. Especifique include para aplicar la sonda a las clases y métodos que coinciden con los patrones comodín y exclude para excluirlos. |
package | Opcional. Especifique un patrón comodín para compararlo respecto de la parte de paquete de los nombres de clase. Por ejemplo: java.util* coincidirá con cada clase del paquete java.util y sus subpaquetes. Si no se especifica, el valor por omisión es *. |
className | Opcional. Especifique un patrón comodín para compararlo respecto de los nombres de clase. Si no se especifica, el valor por omisión es *. |
method | Opcional. Especifique un patrón comodín para compararlo respecto de los nombres de método. Si no se especifica, el valor por omisión es *. |
signature | Opcional. Especifique un patrón comodín para compararlo con la signatura de un método; es decir, la cadena de caracteres que representa los argumentos y el tipo de retorno del método. Es el formato interno Java para las signaturas de método. Por ejemplo: (Ljava/lang/Object;)D es la signatura de un método que acepta un Object como parámetro y devuelve un doble. Este patrón comodín puede utilizarse para distinguir entre métodos sobrecargados. Si no se especifica, el valor por omisión es *. |
Notas:
<target type="include" package="com.example" className="*Proxy" method="Get*" />
Contenido por
El objeto Probe
Tema principal: Consulta de elemento de ProbeKit