DJ Java Decompilar:

Manual de usuario

Fecha: 28/09/2007

Referencia:

EJIE S.A. Mediterrneo, 3 Tel. 945 01 73 00* Fax. 945 01 73 01 01010 Vitoria-Gasteiz Posta-kutxatila / Apartado: 809 01080 Vitoria-Gasteiz www.ejie.es

Este documento es propiedad de EJIE, S.A. y su contenido es confidencial. Este documento no puede ser reproducido, en su totalidad o parcialmente, ni mostrado a otros, ni utilizado para otros propsitos que los que han originado su entrega, sin el previo permiso escrito de EJIE, S.A.. En el caso de ser entregado en virtud de un contrato, su utilizacin estar limitada a lo expresamente autorizado en dicho contrato. EJIE, S.A. no podr ser considerada responsable de eventuales errores u omisiones en la edicin del documento.

Control de documentacin
Ttulo de documento: DJ JAVA DECOMPILER

Histrico de versiones
Cdigo: Versin: 1.0

Fecha: 28/09/2007 Resumen de cambios:

Cambios producidos desde la ltima versin

Primera versin.

Control de difusin
Responsable: Ander Martnez Aprobado por: Ander Martnez Firma: Distribucin: Fecha:

Referencias de archivo
Autor: Consultora de reas de conocimiento Nombre archivo: Localizacin: DJ Java Decompiler. Manual de usuario v1.0.doc

DJ Java Decompiler. Manual de usuario

2/19

Contenido
Captulo/seccin Pgina

1 2 3 3.1 3.2 4 4.1 4.2 5 6

Introduccin Conceptos bsicos Funciones elementales Inicio de la aplicacin Operativa bsica Funciones avanzadas Barras de herramientas Barra de mens Utilidad practica Anexo 1: Decompilar un archivo .class

4 4 4 4 4 6 6 6 15 15

DJ Java Decompiler. Manual de usuario

3/19

Introduccin

El presente documento describe cules son las tareas bsicas que se pueden ejecutar en la explotacin de la herramienta DJ Java Decompiler.

Conceptos bsicos

La aplicacin DJ Java Decompiler es un decompilador para clases compiladas en Java, esto es, dado un fichero compilado binario .class es capaz de obtener el cdigo fuente que lo gener. DJ Java Decompiler es una herramienta freeware que se instala como una aplicacin Windows standalone: no requiere una mquina virtual Java instalada. Para obtener informacin adicional sobre el producto acceder a su pgina web: http://members.fortunecity.com/neshkov/dj.html#

3
3.1

Funciones elementales
Inicio de la aplicacin

La aplicacin puede iniciarse de dos formas distintas: 1. Ejecutando el acceso directo existente en el escritorio (Inicio DJ Java Decompiler 3.7) 2. Haciendo doble clic sobre el fichero a descompilar (.class), se nos mostrar el programa con el fichero descompilado directamente, puesto que el instalador habr realizado la asignacin correspondiente. 3.2 Operativa bsica

Dada su sencillez no resultar en ningn momento complicado su uso ya que posee una interfaz con botones de acceso directo a las diferentes funcionalidades que se ofrecen. Al tratarse de un editor de texto, puede utilizarse para abrir otros tipos de ficheros cuyo contenido sea texto plano, resultando una herramienta multidisciplinar. Para descompilar un archivo compilado binario .class tan solo debemos dirigirnos a el men File Open, y elegir el .class que queramos descompilar; la aplicacin lo procesar y nos devolver por pantalla el cdigo fuente correspondiente a lo compilado. Hay que tener en cuenta que si a la hora de decompilar un fichero, a ste se le ofusc el cdigo fuente o se le aplicaron tcnicas anti-decompilacion es posible que el cdigo fuente que obtengamos sea prcticamente ilegible.

DJ Java Decompiler. Manual de usuario

4/19

Una vez con el cdigo fuente generado cargado en el editor, la aplicacin funciona como un editor de texto, con todas las capacidades ms comunes de este tipo de aplicaciones, con algunos aadidos en relacin con los archivos de cdigo fuente Java que se pueden encontrar en el men View. En el men Settings se pueden configurar ciertos aspectos del programa, as como del motor de decompilacin, para que nos genere ms o menos informacin al descompilar. Ya por ultimo en el men Tools disponemos de utilidades para compilar el archivo de cdigo fuente cargado en el editor, gestionar paquetes JAR, Applets, etc.; en este men se incluye una capacidad de gran utilidad, como es la posibilidad de descompilar varios ficheros .class de java a la vez, para cuando deseemos descompilar un proyecto entero con cientos de ficheros de una sola vez.

DJ Java Decompiler. Manual de usuario

5/19

4
4.1

Funciones avanzadas
Barras de herramientas

La barra de herramientas horizontal nos dar la posibilidad de realizar las instrucciones bsicas como la gran mayora de programas. En la imagen podremos apreciar las funciones a realizar.

Desde esta barra podremos crear un archivo nuevo, abrir uno existente, guardarlo e imprimirlo. Despus se encuentran las opciones de copiar, pegar y eliminar texto. A continuacin, se encuentra el icono de bsqueda, para encontrar la palabra deseada en el cdigo fuente. Seguido encontramos todas las opciones de fuente disponibles, pero para poder modificarlas debemos desactivar la opcin Syntax Colorizing, ltimo elemento de la barra. Una vez desactivada esta opcin podremos cambiar la fuente y el color, pero el programa no nos ayudar coloreando las letras de diferentes categoras. La barra de herramientas vertical dispone de opciones ms especficas de la aplicacin. Compile: Nos abrir otra ventana con la que nos dar las opciones pertinentes para compilar un archivo .class. Run: Lanzar el archivo .class seleccionado. Habr que aadirle las opciones necesarias. Appletviewer: Un applet es un cdigo JAVA que carece de un mtodo main, por eso se utiliza principalmente para el trabajo de pginas Web, ya que es un pequeo programa que es utilizado en una pgina HTML y representado por una pequea pantalla grfica dentro de sta. Permite su visualizacin. JAR: Generara un archivo .JAR basndose en el cdigo fuente seleccionado. Native-to-ASCII Converter: Permitir convertir un archivo con cdigo nativo a cdigo unicode. Applet Tag Editor: Permitir crear applets rpidamente y podr corregir archivos HTML desde esta herramienta. Find target: Nos enviara a la carpeta contenedora del archivo .class. Find files or folders: Nos enviara directamente a la pgina de bsqueda de archivos de Windows. Toggle to Bytecode View: Aparecer el bytecode del archivo .class. Refresh: Actualizara la pgina mostrada. 4.2 Barra de mens

La barra de mens presenta el siguiente aspecto:

La primera seccin que encontraremos ser el men File. En ella encontraremos todas las opciones ms

DJ Java Decompiler. Manual de usuario

6/19

comunes de un programa, como son: Nuevo, abrir, guardar, imprimir e incluso podremos ver las propiedades del archivo .class que est abierto en ese momento. Esta ultima opcin la activaremos presionando sobre File Properties y presionando sobre Directory Properties. Aparecern las propiedades de la carpeta donde se encuentre el archivo .class que estemos utilizando. En la imagen podremos observar todas las opciones.

El men Edit mostrar todas las opciones de edicin como pueden ser: Deshacer, cortar, pegar y cambiar las opciones de la fuente. Tambin podremos aadirle o restarle una sangra para organizar el documento a gusto del usuario. Y desde este mismo men podremos programar la aplicacin para que todas las letras las escriba, o bien, todas en maysculas o todas en minsculas, incluso solo la primera letra de cada palabra.

DJ Java Decompiler. Manual de usuario

7/19

El men Search nos dar todas las facilidades posibles para encontrar una palabra o una orden en concreto y poder incluso reemplazarla, tambin podremos buscar una lista expresamente o encontrar el cierre y la apertura de la llave.

El men View nos mostrar opciones tales como actualizar el archivo, verlo en bytecode, tendremos la opcin de visualizar todos los archivos .class abiertos hasta el momento. Podremos ver una lista con los paquetes y clases diferentes. Visualizaremos los modificadores de acceso que se usan en la clase y cules estn activados, incluso podremos ver los diferentes campos del documento.

DJ Java Decompiler. Manual de usuario

8/19

El men Settings nos mostrar las propiedades de nuestro propio equipo. Tambin podremos ocultar y mostrar el reloj y desactivar o activar la opcin de colorear la fuente. Tambin se podr cambiar la configuracin de los dos mens (superior y derecho) aadiendo o quitando las opciones deseadas.

Cuando presionemos sobre Configuration, nos aparecer la siguiente ventana con todas las opciones disponibles en el programa, separadas en 3 pestaas.

DJ Java Decompiler. Manual de usuario

9/19

Esta primera pestaa nos mostrar todas las opciones que podremos seleccionar al iniciar y finalizar la aplicacin. Podremos insertar incluso un directorio que se abrir cuando se inicie la aplicacin. La segunda pestaa muestra las opciones de coloreado de la fuente, con diferentes opciones que se podrn modificar a gusto del usuario.

DJ Java Decompiler. Manual de usuario

10/19

En esta ltima pestaa configuraremos palabras concretas para que cojan el color elegido.

DJ Java Decompiler. Manual de usuario

11/19

En el men Settings, aparece la opcin Decompiler Settings. Una vez se haga clic en esta opcin, aparecer la siguiente ventana en nuestra aplicacin.

DJ Java Decompiler. Manual de usuario

12/19

Esta ventana nos dar a elegir el modo en que queremos que actu la aplicacin, pudiendo elegir entre Decompilador (fuente) o Desensamblador (bytecode) . Ahora proseguiremos con la lista mostrada en esta ventana, observando todas las posibilidades. Genera instrucciones de la maquina virtual de Java como si fueran comentarios. Genera los nombres completamente cualificados (Nombre completo). Campos de salida antes de los mtodos. Har salir los iniciadores por defecto asignados a los campos. Pestaas en vez de espacios. Intentar decompilar las partes muertas de cdigo. Convertir una secuencia Unicote en secuencia ANSI. Desactivar la ayuda en las clases internas. Desactivar la comprobacin de las clases en modo DOS. No insertar una nueva lnea antes de abrir el apoyo. Espacio de salida entre las palabras clave. Poner el nmero de lneas de salida como comentarios. Genera moldes adicionales para quitar ambigedades de los mtodos o en los campos. Modo de eliminacin de errores. Mostrara los nmeros enteros usando la raz especificada. Mostrara los nmeros usando la raz especificada.

DJ Java Decompiler. Manual de usuario

13/19

El men Language nos permitir cambiar el idioma.

La siguiente opcin llamada Tools muestra todas las opciones expuestas en el men derecho e incluye alguna ms, pero para ello, deberamos registrarnos.

El men Help incluir todas las ayudas proporcionadas por la propia aplicacin.

DJ Java Decompiler. Manual de usuario

14/19

Por ultimo comentar en la pantalla principal, en la parte inferior, una vez abierto un archivo .class, aparecer un ndice con todas las ordenes escritas. En la imagen podremos apreciarlo mejor.

Utilidad practica

DJ Java Decompiler es til para la recuperacin del cdigo fuente perdido o destruido accidentalmente. Decompilar Java es una manera excelente de aprender Java y saber cmo trabaja la maquina virtual. Podremos ver las diferentes clases de Java y aprender del cdigo fuente. Tiene un manejo muy sencillo y un intuitivo interfaz grafico que ayudara mucho a los usuarios que comiencen a utilizar Java. Corrige y Debuggea los archivos .class. Podremos utilizar DJ Java Decompiler cuando los desarrolladores tarden demasiado en responder una pregunta que necesita respuesta inmediata. DJ Java Decompiler es muy til para explorar el cdigo fuente de las clases Java que se podrn ejecutar. Podremos comprobar los resultados de la ofuscacin.

Anexo 1: Decompilar un archivo .class

Procederemos a realizar un ejercicio muy sencillo, que consiste en decompilar un archivo. Teniendo en cuenta la utilidad que tendr esta aplicacin ser el proceso mas utilizado.

DJ Java Decompiler. Manual de usuario

15/19

Comenzamos abriendo DJ Java Decompiler, aparecer la pantalla blanco, nos situamos encima de File y desplegaremos su men:

Presionaremos sobre Open y nos aparecer la siguiente ventana, que nos dar la posibilidad de elegir un archivo .class alojado en el disco local.

DJ Java Decompiler. Manual de usuario

16/19

En la foto se puede apreciar la forma que tendrn los archivos .class, en este caso abriremos el archivo llamado Entities. Aparecer el siguiente mensaje, preguntando si deseamos aadirle la ayuda de sintaxis que incorpora el programa. Para ello el programa necesitara unos segundos.

Y nos aparecer de la siguiente manera en la pantalla principal en la aplicacin, decompilado y listo para observar lo que necesitemos.

DJ Java Decompiler. Manual de usuario

17/19

Como hemos explicado anteriormente en la parte superior aparecer el cdigo fuente del archivo abierto y en la zona inferior podremos ver un ndice del archivo ejecutado, para mejor acceso.

DJ Java Decompiler. Manual de usuario

18/19