Manual de Usuario Drarch - Discover and Recover Architecture
Contents
1. Suggest Template El componente P se materializa en la cu X Facts Description Facts Templates Description Facts Templates association P P X responsibility gt P hasResponsibility P P mapping P P 2X Overview Raw XML propertiesTabName Figura 3 Editor de Reglas 3 Seleccionar las variables de la consulta que se desean obtener 4 Generar un template que describa una sugerencia utilizando las variables seleccionadas en el punto anterior 5 Crear nuevos hechos que se tendr an que incorporar a la base de conocimien to Ejemplo Para poder ver este proceso un poco mas claro se muestra el siguiente ejemplo en el cu l se intenta crear una regla que sugiera la creaci n de un componente por cada paquete del proyecto seleccionado 1 La descripci n de la regla podr a ser Un componente por paquete 2 La consulta ser a PACKAGE P 3 La variable que se debe seleccionar es P 4 El template es Crear el componenten P 5 El hecho que se agrega es COMPONENT P 5 Generaci n de log s Para poder generar los archivos log se debe utilizar el plugin FLABOT Dentro del wizard para las configuraciones del Run se debe crear un nuevo FLABOT COLLECTING SESSION como se muestra en la figura 4 B sicamente se debe especificar cu l es el LAUNCH a analizar el archivo en cual se va a crear el log y el archivo flabot con los diagramas de componentes generados por el Dr2. 4 Seleccionar las sugerencias 5 Ir al paso 3 a menos de que no se encuentren mas etapas 6 Utilizar el FLABOT para generar archivos logs 7 Generar UCMs con los archivos logs generados en el paso anterior 3 Vista de Sugerencia Para abrir la vista de sugerencias se debe seleccionar la vista Suggest Viewe de la categor a Drarch En la figural se muestra la vista de sugerencias Import Rule XML permite importar un archivo XML con las reglas que se van a utilizar en el proceso de reconstrucci n de la arquitectura En caso de no importar ninguna regla la herramienta utiliza reglas por defecto Select workingset permite seleccionar el proyecto a ser analizado se deben seleccionar solo los java Next Step Ejecuta cada regla una por etapa y una vez seleccionada la sugerencia crea diagramas en el archivos flabot ubicado en la carpeta Drarch del proyecto seleccionado Select a wizard Wizards G Plug in Project ES Product Configuration gt Aspect gt cvs Eclipse Modeling Framework Example EMF Model Creation Wizards FLABot Java gt Javacc Java Emitter Templates 2 Other 5 Plug in Development Simple gt SYN Tl a Figura 2 Selecci n de wizard Rules4Java analize LogTrace Esta opci n permite realizar un an lisis del archivo de log generado durante la ejecuci n del sistema a analizar Esta acci n genera diagramas de UCMs 4 Editor de Reglas El
3. accesses field F at location L inheritedMethod Type Callable Type inheritedMethod T C SUP means Type T inherits C from SUP overrides Callable Callable overrides C1 C2 means Callable C1 overrides callable 2C2 creator Class Block SourceLocation creator C1 Ctor L means Class C1 is created by block Ctor at location L 12 implements Class Interface implements C I means Interface I is implemented by C or an ancestor of C outerType Type outerType T means T is an outer type nestedType RefType nestedType T means T is a nested type memberType RefType memberType T means T is a member type staticNested Type RefType nestedType T means T is a static nested type localType RefType localType T means T is a local type anonymous Type RefType anonymousType T means T is an anonymous type viewFromHere Element Element viewFromHere X ViewStructure means ViewStructure is a tree representation of all child relationships below parent element X re_ match RegExp String re_match RE S means String S matches Regular Expression RE re_name Element RegExp re_name E RE means E has a name that matches RE 6 2 Predicados Drarch Los predicados que se agregaron a la base de conocimiento KnoledgeBase representan concepto
4. drarch toma por defecto un conjunto de reglas sin embargo es posible crear un archivo de reglas y reemplazarlas para que sean usadas en vez de las reglas por defecto Para crear un archivo de reglas se debe seleccionar el wizard de la figura 2 por medio de File gt New gt Other Luego para poder agregar eliminar y editar las reglas se debe hacer doble click en el archivo creado por el wizard y de esta forma se abre el editor de la figura 3 4 1 Creaci n de una ragla Una vez que se tiene el editor de reglas los siguientes pasos describen la creaci n de una regla en particular 1 Descripci n breve de lo que hace la regla 2 Agregar una consulta al estilo prolog Overview General Information This section describes general information about this Rules file File Name rules drarch Rules count 8 Rules Information This section describes general information about this Rules file Rules Available Rule 0 Un componente por paquete Materializaci n de componentes con CU Rule Rule Rule Rule Rule Relaci n por argumentos Rule 7 Relaci n por fields A H E E Selected Rule content The content is made up of three sections Query Description Represent the query that will be executed Query Text package P name P Packagellame component Query Yars Yars from query Choosen Yars p Suggest Description Suggest Template Description
5. instalar todo Install All y aceptamos que reinicie Eclipse GEF El proceso es similar al EMF Lo que varia es el update site y el componente a seleccionar Update Site nombre GEF Update Site url http update eclipse org updates 3 0 El componente a seleccionar es GEF 3 1 1 Drarch Se deben descomprimir los archivos Drarch rar Flabot rar y JQuery rar Luego copiar el contenido de cada archivo en el directorio donde se encuentra el eclipse Los plugins se pueden bajar del sitio http sourceforge net projects drarch 2 Proceso Para iniciar el proceso de reconstrucci n de la arquitectura se debe tener un uno o m s proyectos dentro del workspace de esta manera el desarrollador va a poder seleccionar el c digo a analizar Luego por medio de la vista de sugerencias se selecciona el c digo fuente a analizar archivos java y se comienza con la primer etapa la cual muestra una lista de sugerencias Estas sugerencias pueden ser aceptadas o rechazadas Una vez que se termin con la selecci n de sugerencias se debe pasar a la pr xima etapa El paso de una etapa a la otra hace que se genere un nuevo diagrama de componentes si es que en la etapa anterior se seleccionaron sugerencias Este proceso se repite hasta que no se encuentren m s reglas Luego de la ltima regla se debe realizar el an lisis del c digo en ejecuci n Para esto se debe utilizar el FLABOT para generar el log El log generado debe represent
6. Drarch Engine Plug in 3 1 e Drarch JqueryImpl Plug in 3 1 e Drarch Ui Plug in 3 1 e Drarch Util Plug in 3 1 1 3 Instalaci n de Eclipse Sitios de descarga JDK de Sun http java sun com javase downloads index jsp a Eclipse http download eclipse org eclipse downloads La instalaci n de eclipse deber a hacerse preferentemente en una ruta de direc torios que no contenga espacios simplemente descomprimiendo el archivo zip o tar gz Si al tratar de ejecutar el Eclipse se queja por no encontrar la m quina virtual de java es necesario agregar ya sea en un shortcut o desde linea de comandos los argumentos vm path a java siendo path a java la ruta al ejecutable javaw exe o su equivalente en linux 1 4 Instalaci n de Plugins Tanto el EMF como el GEF se pueden instalar desde el propio Eclipse utilizando el Update Manager Para activarlo vamos al men Help gt Software Updates gt Find and Install Ah seleccionamos Search for new features to install EMF En la vista de los sitios de instalaci n seleccionamos New Remote Site ponemos EMF Update Site y http download eclipse org tools emf updates respectiva mente y seleccionamos Finish Seleccionamos el mirror por defecto o sea pre sionamos OK Destildamos la opci n Show the latests version of a feature only y seleccionamos del rbol EMF SDK 2 1 2 Le damos Next aceptamos la li cencia Next otra vez y luego Finish Luego confirmamos que queremos
7. Manual de Usuario Drarch Discover and Recover Architecture FRONTINI FMALDONA QEXA UNICEN EDU AR 12 de octubre de 2006 Indice 1 Instalaci n 1 1 1 Requerimientos a o e e e ee 1 1 2 Plugins del Drarch e e 2 1 3 Instalaci n de Eclipse o o a e 2 1 4 Instalaci n de Plugins o o e 2 2 Proceso 3 3 Vista de Sugerencia 4 4 Editor de Reglas 5 4 1 Creaci n de una ragla o 5 5 Generaci n de log s 7 6 Ap ndice 7 6 1 Predicados JQuery o e e 7 6 1 1 Predicados unarios o e o 9 6 1 2 Predicados binarios o a o 10 6 1 3 Predicados ternarios o e e 10 6 1 4 Predicados derivados a o e o 11 6 2 Predicados Drarch 2 o e o 13 1 Instalaci n 1 1 Requerimientos Como la aplicaci n se desarroll como un Plugin para Eclipse es necesario tener el Eclipse 3 1 2 con los siguientes plugins instalados a EMF 2 1 a GEF 3 1 Flabot provisto por el Drarch ya que se realizaron modificaciones se exportaron paquetes JQuery provisto por el Drarch ya que se realizaron modificaciones se optimiz para aumentar la performance 1 2 Plugins del Drarch Los siguientes plugins corresponden a la herramienta Drarch Estos deben ser copiados en la carpeta ECLIPSE PLUGINS Drarch 3 1 e Drarch Plug in 3 1 e Drarch Diagram Plug in 3 1 e
8. ans X is a field bookmark Bookmark bookmark X means X is a bookmark warning Warning warning X means X is a compiler warning error Error error X means X is a compiler error task Task task X means X is a task 6 1 2 Predicados binarios Predicate Name Argument Types Description priority Task String priority T P means Task T has priority P name Element String name E S means Element E has name S child Element Element child Sup Sub means Element Sup has a child Sub extends RefType RefType extends C1 C2 means Class or Interface C1 extends Class or Interface C2 implements RefType RefType implements C I means Class C implements Interface 1 throws Callable RefType throws C T means Callable C throws T type Field Type type F T means Field F is of type T modifier Element String modifier E S means Element E has modifier i e public private static etc S arg Callable Type arg C T means Callable C has an argument of type T returns Callable Type returns C T means Callable C returns Type T signature Callable String signature C S means Callable C has signature S 6 1 3 Predicados ternarios Predicate Name Argument Types Description methodCall Block Method SourceLocation methodCall B M L means Block B calls Method M at loc
9. ar un caso de uso del sistema y debe ser lo suficientemente concreto para que se refleje en diagramas de UCMs De esta forma se deben hacer tantos logs como casos de uso existentes A medida que se van generando los log s se pueden ir creando diagramas de UCMs Para realizar esto se debe utilizar el Drarch e indicarle cual es el archivo que se quiere analizar para que genere el UCM correspondiente En resume el proceso deber a seguir los siguientes pasos 1 Seleccionar archivos java s to Oe Call Hierarchy Problems Javadoc Declaration SETS Te Select WorkingSet Stage 1 Y Crear el componente org design rules Java engine ruleModel util Crear el componente org design rules4Java engine engine Crear el componente org design rules Java engine analize LogTrace Crear el componente org design rules4Java engine ruleModel Crear el componente org design rules4Java engine parser Crear el componente org design rules Java engine ruleModel impl Crear el componente org design rules4Java engine engine engineModel Y Crear el componente org design rules4Java engine engine engineModel impl Stage 2 Stage 3 Stage 4 Stage 5 Stage 7 O Next Steps NNN DROCRCA CECEN ONKNOKNO A iv Figura 1 Vista de Sugerencias 2 Seleccionar el archivo de reglas este punto se puede omitir si se desea utilizar las reglas por defecto 3 Comenzar con la siguiente etapa
10. arch Luego se ejecuta el FLABOT COLLECTING SESSION que se configur sto hace que se ejecute la aplicaci n que se est analizando para extraer la arqui tectura Se debe realizar un caso de uso espec fico sobre la aplicaci n Una vez finalizado el caso de uso se cierra la aplicaci n y se termina de loggear Este proceso se repite variando los casos de uso 6 Ap ndice 6 1 Predicados JQuery Los predicados de JQuery respetan la siguiente jerarqu a Element e Package e CU Create manage and run configurations Run Flabot Local Java Application Flabot Instrumentation for Eclipse Workbench JE Init Plug in Test fhe SWT Application Figura 4 Flabot Collecting Session Field e Type o Primitive o RefType interface or class e Block o Initializer o Callable o Method o Constructor Marker o Bookmark e o Error o Task Warning 6 1 1 Predicados unarios Predicate Name Argument Type Description cu CU cu X means X is a Compilation Unit class or java file package Package package X means X is a package class RefType class X means X is a class interface RefType interface X means X is an interface method Method method X means X is a method constructor Constructor constructor X means X is a constructor initializer Initializer initializer X means X is an initializer field Field field X me
11. ation L thisCall Constructor Constructor SourceLocation methodCall C1 C2 L means Constructor C1 makes a this call to Constructor C2 at location L 10 superCall Callable Callable SourceLocation superCall C1 C2 L means Callable C1 makes a super call to Callable C2 at location L constructorCall Block Constructor SourceLocation constructorCall B C L means Block B calls Constructor C at location L instanceOf Block RefType SourceLocation instanceOf B T L means Block B performs an instanceof test for type T at location L reads Block Field SourceLocation reads B F L means Block B reads field F at location L writes Block Field SourceLocation writes B F L means Block B writes to field F at location L param Callable Type Integer param C T N means Callable C has an argument of type T as its Nth argument tag Element String String tag E N V means Element E has javadoc tag N with value V 6 1 4 Predicados derivados Predicate Name Argument Types Description type Type type T means T is a type a class interface or primitive element Element element E means T is an element likeThis Element Element likeThis E1 E2 means E1 and E2 have the same name but are not the same object strongLik
12. eThis Callable Callable strongLikeThis C1 C1 means C1 and C2 have the same signature child Element Element child E1 E1 means E2 has E1 as one of its ancestors 11 package Element Package package E P means Element E is in package P constructor Class Constructor constructor CL CON means Class CL declares constructor CON method Type Method method T M means Type T declares method M subtype Type Type subtype T1 T2 means T2 is a direct subtype of T1 subtype Type Type subtype T1 T2 means T2 is in T1 s type hierarchy subtype Type Type subtype T1 T2 means T2 is in T1 s type hierarchy T2 can equal T1 field Type Field field T F means Type T declares field F inheritedField Type Field Type inheritedField T F InhT means Type T inherites field F from type InhT calls Block Callable SourceLocation calls B C L means Block 7B calls C at location L staticCall Block Callable SourceLocation staticCall B C L means Block B statically calls C at location L dynamicCall Block Callable SourceLocation dynamicCall B C L means Block B dynamically calls C at location L polyCalls Block Callable SourceLocation polyCalls B C L means Block B calls polymorphic callable C at location L accesses Block Field SourceLocation accesses B F L means Block B
13. s de diagramas de componentes para representar arquitec turas Predicate Name Argument Type Description component String component X means X is a Component interfaceLink String String intefaceLink X Y means InterfaceModel X is linked with InterfaceModel Y interfaceModel String interfaceModel X means X is a Interface port String port X means X is a Port hasPort String String hasPort X 7Y means Component X has Port Y 13 hasProvidedInterface String String hasProvidedInterface X Y means Port X has a provided interfaceModel Y hasRequiredInterface String String hasRequiredInterface X Y means Port X has a required interfaceModel Y association String String String association X Y Z means JavaFile Z is associated by the Component X in the package Y mapping String String String mapping X Y Z means JavaFile Z is mapped by the Component X in the package Y relationship String String String relationship X Y Z means Component X has a relationchip with Component Y with the Prototype Z responsibility String responsibility X means X is a Responsability hasResponsibility String String hasResponsibility X Y means Component X has a Responsibility Y 14
Download Pdf Manuals
Related Search