Cómo monté mi primer proyecto en Java y lo que me hubiera gustado saber antes
Java lleva décadas siendo el pilar de medio mundo: apps móviles, servidores bancarios, sistemas de comercio electrónico, videojuegos... Da igual lo que quieras construir, si eliges Java, alguien ya resolvió la mayoría de problemas antes que tú. Y el primer obstáculo, siempre, es el mismo: ¿cómo demonios creo un proyecto nuevo que no se caiga a los diez minutos?
Yo recuerdo la primera vez que tuve que montar una arquitectura de software completa para una plataforma de ventas online. No era un HelloWorld en un fichero suelto, era decenas de módulos, librerías de terceros, ficheros de configuración y equipos trabajando sobre el mismo repo. En aquel momento entendí que un proyecto Java no es una carpeta con código, es un contenedor vivo que agrupa fuentes, paquetes, librerías, recursos y configuración todo junto. Sin esa estructura, todo se desmorona.
Así que antes de tocar el teclado, conviene tener claro qué lleva dentro un proyecto Java bien plantado:
- Ficheros fuente (.java): el código en sí, organizado en paquetes.
- Librerías y dependencias: todo lo externo que la app necesita para funcionar (log4j, drivers JDBC, frameworks web...).
- Ficheros de configuración: pom.xml, build.gradle, application.properties... definen cómo se compila, se empaqueta y se despliega.
- Recursos: imágenes, XML, ficheros de propiedades, templates. Cosas que no son código pero la app consume.
La estructura de carpetas que vas a ver en el 95 % de los proyectos profesionales es bastante estándar: src/main/java para las fuentes, lib para dependencias externas (aunque hoy casi todo se gestiona vía Maven o Gradle), target o bin como directorio de salida con las clases compiladas, y el fichero de configuración raíz. No te inventes una estructura propia el primer día, sigue la convención y luego ya personalizarás.
¿Y por qué no compilar un .java suelto con javac y tirar pa'lante? Porque en cuanto crezcas un mínimo, esa comodidad se convierte en pesadilla. Los proyectos te dan modularidad para separar responsabilidades, reutilización porque añades una librería y listo, colaboración porque varios devs tocan el mismo repo sin pisarse, y compilación y despliegue automatizados con Maven o Gradle. Para una demo de cinco líneas, vale un javac. Para cualquier cosa que tengas que mantener más de una semana, necesitas un proyecto.
Dicho esto, hay dos caminos principales: usar un IDE con interfaz gráfica (IntelliJ IDEA, Eclipse, NetBeans) o lanzarte por línea de comandos con Maven o Gradle. Yo, que llevo más de treinta años tocando sistemas, siempre prefiero el IDE para arrancar porque me ahorra una barbaridad de errores de configuración. Luego, cuando ya domino la estructura, puedo generar un esqueleto en dos segundos desde terminal.
Vayamos con IntelliJ IDEA, que es donde más cómodamente trabajo. Abres el IDE y desde la pantalla de inicio pulsas New | Project. Si ya tienes algo abierto, es File | New Project. En el asistente seleccionas Java como tipo de proyecto, le pones nombre (por ejemplo HelloWorld), cambias la ruta si te apetece y desactivas Create Git repository si no vas a usar control de versiones aún. En Build system, deja IntelliJ seleccionado.
Aquí viene el punto que me ha traído de cabeza más veces: el Java SDK. IntelliJ te pide un JDK para compilar y ejecutar. Si ya tienes uno registrado, lo eliges de la lista. Si lo tienes instalado en disco pero el IDE no lo conoce, usas Add JDK from Disk y le señalas la carpeta home del JDK. Y si no tienes ninguno, el propio IntelliJ ofrece Download JDK eligiendo versión y ruta de instalación, que es comodísimo. Deja desactivada la casilla Add sample code si quieres construir todo desde cero.
Con el proyecto cargado, abre la ventana Project con Alt+1 o desde View | Tool Windows | Project. Ahí ves toda la estructura en un árbol. Seleccionas la carpeta src, pulsas Alt+Insert, eliges el tipo de fichero y le das nombre. Listo, ya tienes tu primer archivo .java dentro del proyecto.
Un detalle moderno que me encanta: las versiones recientes de Java traen los compact source files. Son ficheros fuente que no necesitan la declaración public class ni el boilerplate de siempre. Perfectos para demos rápidas o tutoriales, el IDE genera la plantilla con el método main automáticamente.
Para escribir la lógica, apóyate en el autocompletado sin vergüenza. Tecleas IO y pulsas Ctrl+. para insertar la selección con punto final; de la lista eliges println. Al escribir la primera comilla, IntelliJ pone la segunda y te deja el cursor entre ambas. Y si quieres ir aún más rápido, escribe iop, Enter, y ya tienes la línea de impresión lista.
Compilar y ejecutar es un clic: la flecha verde del gutter, Run 'HelloWorld.main()'. El IDE compila con javac, coloca el bytecode en out y la JVM lo ejecuta. En la herramienta Run de abajo ves el comando, la salida y el código de salida 0 (todo bien). Si hay error de sintaxis, aparece ahí mismo.
“El error más silencioso al crear un proyecto nuevo está en la incoherencia entre el JDK del IDE, la versión de source/target del pom.xml y el runtime de destino.”
Dato clave