Java Filters

Seleccione la ficha Java Filters para:

• Incluir o excluir filtros de Java

• Crear filtros nuevos

• Borrar filtros existentes

• Restaurar los filtros predeterminados

Los filtros de Java se suministran en patrones de métodos y se expresan mediante patrones que incluyen o excluyen aplicando un nombre de método canónico. Un nombre de método canónico es:

nombre-clase-completamente-calificado.nombre-método( tipo-parámetro-1, tipo-parámetro-2, ... )

En los constructores, nombre-método es <init>.

He aquí algunos ejemplos:

• Para excluir todos los constructores, active la casilla Exclude y añada el filtro siguiente:

  *.<init>(*)

• Para excluir todos los constructores con un solo parámetro org.w3c.dom.Element, active la casilla Exclude y añada el filtro siguiente:

  *.<init>(org.w3c.dom.Element)

• Para excluir todas las clases de Identity Manager, active la casilla Exclude y añada los filtros siguientes:

  "com.waveset.*"
  "com.sun.idm.*"

• Para instrumentar sólo el código personalizado, desactive la casilla Exclude, suprima el filtro * include inicial y añada luego el filtro siguiente:

  "com.yourcompany.*"

Los dos últimos ejemplos son equivalentes porque los filtros se aplican sólo a las clases personalizadas y a las de Identity Manager.

Si es preciso, puede instrumentar otros jar modificando como interese las líneas siguientes en build.xml. Por ejemplo:

<instrument todir="${lighthouse-dir-profiler}/WEB-INF" 
verbose="${instrumentor.verbose}" includeMethods="${profiler.includes}" 
excludeMethods="${profiler.excludes}">
           <fileset dir="${lighthouse-dir}/WEB-INF">
               <include name="lib/idm*.jar"/>
               <include name="classes/**/*.class"/>
           </fileset>
</instrument>

De forma predeterminada, la configuración incluye todas las clases personalizadas y la mayoría de las clases de Identity Manager. Se excluyen forzosamente diversas clases de Identity Manager, ya que su habilitación interrumpiría el analizador.

Por ejemplo, se excluyen las clases de los motores de flujo de trabajo, formularios y XPRESS porque, de lo contrario, el analizador generaría una instantánea ininteligible al analizar objetos de Java e Identity Manager:

Los filtros de Java ofrecen mucha más granularidad de filtrado que los de objeto de IDM. La instrumentación de Java sobrecarga significativamente el tiempo de ejecución, lo que puede sesgar radicalmente los resultados del análisis. Como los objetos de Identity Manager se interpretan en lugar de compilarse, apenas hay sobrecarga de instrumentación. De ahí que, por ejemplo, no haya razones básicas para excluir el flujo de trabajo A e incluir el flujo de trabajo B, etc.

No es posible modificar los filtros de Java mientras se ejecuta el analizador. Antes debe detener el analizador.