Asistente Patrones de Utilización de API

Este asistente le ayuda a crear patrones de expresiones regulares para controlar un análisis de utilización de API.

Para activar el asistente, siga estos pasos:

  1. Al crear una configuración de lanzamiento de Informe de utilización de API, pase a la pestaña DPatrones.
  2. En la pestaña, pulse el botón Añadir...

Opción

Descripción

Valor predeterminado

Tipos de patrón Esta lista muestra todos los patrones que se pueden crear con el asistente. Primer elemento de la lista
Descripción Muestra la descripción legible de la especie de patrón seleccionada en la lista Tipos de patrón.  

La primera página del asistente permite seleccionar que especie de patrón desea crear. Para ayudarle a elegir, se proporcionan descripciones de cada patrón: simplemente seleccione el patrón y la descripción se visualiza en el campo Descripción.

Asistente Patrón de utilización de API: página de selección de patrones

Patrones de archivador

Cuando se realiza el análisis de utilización de API, se exploran todos los archivadores y las carpetas dentro de un paquete, lo que permite asegurar que se analizan todos los archivos de clase. En algunos casos, un paquete puede contener un archivador con versiones antiguas de archivos de clase (por ejemplo) que no desee analizar. En este caso, se puede utilizar un patrón de archivador para ignorar completamente un archivador específico o todos los archivadores que coincidan con una expresión regular dada.

Opción

Descripción

Valor predeterminado

Nombre de paquete compuesto El nombre simbólico completo del paquete al que se desea aplicar este patrón. Por ejemplo: org.eclipse.pde.api.tools. vacío
Nombre de archivador El nombre completo o la expresión regular de los archivadores a los que se desea aplicar el patrón. Por ejemplo: *.jar: que ignorará cualquier archivo jar anidado. vacío

Asistente Patrón de utilización de API: crear patrones de archivador

Patrones de paquete

Al extraer referencias para el análisis, el motor de búsqueda de Utilización de la API utiliza metadatos del paquete para determinar si una referencia es interna o no. En algunos casos, no se ha configurado un paquete para describir adecuadamente qué clases son internas y qué clases no lo son. Un Patrón de paquete permite aumentar estos paquetes mal formados (sólo desde el punto de vista del motor de búsqueda, el paquete real no se cambia en absoluto) para describir lo que es o no interno.

Opción

Descripción

Valor predeterminado

Patrón El patrón de expresión regular con el que hacer coincidir los paquetes. Por ejemplo: .*\.internal\..*. vacío
Patrón de API Si el patrón debe hacer que los paquetes coincidentes se consideren como API o no. seleccionado

Asistente Patrón de utilización de API: crear patrones de paquete

Patrones de conversión de informe

Una vez realizado el análisis de utilización de la API, puede haber una cantidad inmensa de información que mirar. Sin embargo, con un patrón de conversión de informe puede rebajar la información de referencia presentada en los informes HTML y ver sólo aquello en lo que está interesado. Para hacerlo, puede crear patrones de exclusión utilizados para podar las referencias incluidas en el informe.

Opción

Descripción

Valor predeterminado

Filtrar referencias a este patrón Permite evitar la inclusión en el informe de las referencias al patrón. Por ejemplo, si el patrón era org\.eclipse\.jdt\..*, al seleccionar esta opción no se informaría de referencias hechas a JDT. seleccionado
Filtrar referencias de este patrón Permite evitar la inclusión en el informe de las referencias al patrón. Por ejemplo, si el patrón era org\.eclipse\.jdt\..*, al seleccionar esta opción no se informaría de referencias hechas desde JDT.  
Patrón El patrón de expresión regular. vacío

Asistente Patrón de utilización de API: crear patrones de conversión de informes

Tareas relacionadas

Configurar Herramientas de API

Consulta relacionada

Acción de configuración de Herramientas de API
Menú Herramientas de PDE
Informes de Utilización de API