Utilice las API de Reglas personalizadas para Revisión de código COBOL y la API de Modelo
de aplicación COBOL (CAM) para analizar los elementos de lenguaje COBOL seleccionados para su regla personalizada
escrita por usuario.
Acerca de esta tarea
Las API de Reglas personalizadas para Revisión de código COBOL y las API de Modelo de
aplicación COBOL son complementarias. Se necesita algún conocimiento de ambas para implementar una regla personalizada
escrita por el usuario:
- API de reglas personalizadas para revisión de código COBOL
Esta API proporciona la clase base para
reglas escritas por usuario e incluye clases útiles para manipular los objetos en el Modelo de aplicación COBOL (CAM).
Para leer la documentación para esta API, consulte
API
de Reglas personalizadas para la Revisión de código COBOL.
- API de Modelo de aplicación COBOL (CAM)
Esta API proporciona interfaces para acceder a los elementos de un
programa de código fuente COBOL mientras el componente Revisión de código COBOL analiza el programa.
Para leer la
documentación para esta API, consulte
COBOL
API de modelo de aplicación.Nota: Para obtener una visión general de esta API, seleccione el tema
"Paquete com.ibm.etools.cobol.application.model.cobol" y desplácese al final del tema para leer la sección
"Descripción".
Procedimiento
Para implementar el análisis de código para una regla personalizada:
- Abra la perspectiva Desarrollo de plug-ins.
- En el Explorador de paquetes, pulse el botón derecho del ratón sobre el archivo fuente
Java™ generado para la regla personalizada y a continuación pulse
. La ubicación del archivo Java en el Explorador de
paquetes es
. Por ejemplo:
.
- En el editor Java, añada código Java
según sea necesario a cada uno de los métodos visit() generados para hacer el análisis de código
necesario. Se genera un método visit() para cada subinterfaz no abstracta de la interfaz del Modelo de aplicación Cobol
correspondiente al elemento de lenguaje COBOL seleccionado. Por ejemplo, supongo que ha seleccionado el elemento ACCEPT en el árbol Programa, en la tercera página del
asistente de creación:
- La interfaz CAM correspondiente a ACCEPT es la interfaz AcceptStmt.
- La información Javadoc para la interfaz AcceptStmt
muestra, bajo la cabecera Todas las subinterfaces conocidas que AcceptStmt
tiene dos subinterfaces: AcceptDataTranferStmt y AcceptSystemInfoTransferStmt.
- Se generan dos métodos visit(), uno para cada una de las dos subinterfaces.
Nota: - Los métodos visit() pertenecen a la interfaz ICOBOLVisitor, en el paquete
com.ibm.rsar.analysis.codereview.cobol.custom.model.util, en la API Reglas personalizadas para la
Revisión de código COBOL. No implemente ICOBOLVistor directamente, en su lugar, cree una subclase de
AbstractCOBOLVisitor. Los ejemplos siguientes muestran los métodos visit()
generados:
- boolean visit(com.ibm.etools.cobol.application.model.cobol.AcceptDataTransferStmt
n)
- boolean visit(com.ibm.etools.cobol.application.model.cobol.AcceptSystemInfoTransferStmt
n)
- El nodo que se pasa como entrada a un método visit() es una subinterfaz de la interfaz
ASTNode en el paquete com.ibm.etools.cobol.application.model.cobol en la API de
Modelo de aplicación COBOL (CAM).
Cuando se analiza un archivo fuente COBOL, el analizador de código inicia un método
visit() siempre que encuentra una instancia del ASTNode correspondiente.
- En cada método visit(), añada código Java para las
funciones siguientes:
- Cuando haya terminado, cierre el editor Java.