O objeto Target da probe é uma especificação das classes e métodos aos quais a probe deve ser aplicada.
O objeto Target é opcional. Quando nenhum Target for especificado, a probe será aplicada a todas as classes processadas pelo mecanismo de instrumentação.
O objeto Target permite criar regras de filtragem para incluir ou excluir métodos da instrumentação com base em padrões que são correspondidos em relação ao nome do pacote, classe e método, além da assinatura do método. Os padrões podem conter curingas, em que "*" corresponderá a zero ou mais caracteres.
Se os padrões de curinga de um Target corresponderem ao pacote, classe, nome e assinatura de um método, a propriedade type determina se o método é instrumentado (include) ou não (exclude). Se os padrões não corresponderem ao pacote, classe, nome e assinatura de um método, por padrão, o método é instrumentado.
Propriedade | Descrição |
---|---|
type | Obrigatório. A propriedade type determina se uma probe é aplicada ou não a um método de destino. Especifique include para aplicar a probe a classes e métodos que correspondem aos padrões curinga ou exclude para excluí-los. |
package | Opcional. Especifique um padrão curinga para ser correspondido com relação à porção do pacote dos nomes de classe. Por exemplo: java.util* corresponderá a todas as classes no pacote java.util e seus subpacotes. Se não for especificado, o valor padrão é *. |
className | Opcional. Especifique um padrão curinga para ser correspondido com relação aos nomes de classes. Se não for especificado, o valor padrão é *. |
method | Opcional. Especifique um padrão curinga para ser correspondido com relação aos nomes de métodos. Se não for especificado, o valor padrão é *. |
signature | Opcional. Especifique um padrão curinga para ser correspondido com relação à assinatura de um método - isto é, a cadeia que representa os argumentos do método e o tipo de retorno. Isso está no formato interno do Java para assinaturas de métodos. Por exemplo: (Ljava/lang/Object;)D é a assinatura de um método que obtém um Object como um parâmetro e retorna um double. Esse padrão curinga pode ser utilizado para distinguir entre métodos sobrecarregados. Se não for especificado, o valor padrão é *. |
Notas:
<target type="include" package="com.example" className="*Proxy" method="Get*" />
Contido por
O Objeto Probe
Tópico Pai: Referência de Elemento de Probekit