OpenXava cuenta con un conjunto de plantillas de proyecto, o arquetipos como se llaman en el mundo Java, para que no tengas que empezar tu nuevo proyecto OpenXava desde cero. Estas plantillas no solo te ahorran tiempo, sino que contienen muchos ejemplos de código que te pueden ser útiles para aprender.
Para usar estas plantilla desde IntelliJ, al crear un nuevo proyecto desde un arquetipo Maven, selecciona Maven Central para Catalog y en el campo Archetype teclea "openxava". Se abrirá una lista desplegable con todos los arquetipos disponibles para OpenXava.
Si por ejemplo escoges openxava-project-management-archetype-spanish y pulsas en Create, en unos segundos tendrás una aplicación de gestión de proyectos en OpenXava, lista para funcionar.
Estos arquetipos también se pueden usar desde Eclipse, NetBeans, VisualStudio Code o directamente con Maven desde la línea de órdenes. Más abajo se detalla el nombre del arquetipo Maven para cada plantilla disponible, junto con la línea de órdenes que has de usar.
Es un ejemplo básico de maestro-detalle, con las entidades Maestro, Persona, Detalle e Item, que puedes renombrar según tus necesidades. Muy útil como base para una factura, orden de compra, parte de trabajo, albaran, cuenta bancaria, envío, etc.
También contiene un ejemplo de cuadro de mando, mira el código en el paquete cuadrosmando, y un ejemplo de una acción que genera un PDF personalizado usando JasperReports.
Además, incluye una base de datos inicial con datos de prueba y un conjunto de pruebas automáticas JUnit, incluyendo una prueba para el informe PDF. El código de las pruebas se encuentra en src/test/java y están listas para que las ejecutes con tu IDE.
Para usarlo desde IntelliJ o Visual Studio usa el arquetipo disponible en Maven Central llamado openxava-master-detail-archetype-spanish.
Si prefieres crear tu proyecto desde línea de órdenes hazlo así:
mvn archetype:generate -DarchetypeGroupId=org.openxava -DarchetypeArtifactId=openxava-master-detail-archetype-spanish -DarchetypeVersion=RELEASE -DgroupId=com.tuempresa -DartifactId=tumaestrodetalle -DinteractiveMode=falseDonde en lugar de tumaestrodetalle pon el nombre que quieras para tu aplicación.
Un CRM muy, muy simple.
En el siguiente video todavía usamos OpenXava Studio (ahora descatalogado), pero el resultado es el mismo que si lo creas desde IntelliJ o directamente con Maven. El video muestra la creación del proyecto, el proyecto funcionando y enseña el código fuente.
Con tan solo Prospecto con una colección de actividades (Actividad) y un estado (EstadoProspecto). La vista principal está organizada en pestañas y contiene un editor de texto rico, colecciones editables (grid) y poder subir archivos adjuntos.
Además, contiene un ejemplo de prueba automática con JUnit. El código de la prueba se encuentra en src/test/java y está lista para que la ejecutes con tu IDE.
Para usarlo desde IntelliJ o Visual Studio usa el arquetipo disponible en Maven Central llamado openxava-crm-archetype-spanish.
Si prefieres crear tu proyecto desde línea de órdenes hazlo así:
mvn archetype:generate -DarchetypeGroupId=org.openxava -DarchetypeArtifactId=openxava-crm-archetype-spanish -DarchetypeVersion=RELEASE -DgroupId=com.tuempresa -DartifactId=tucrm -DinteractiveMode=falseDonde en lugar de tucrm pon el nombre que quieras para tu aplicación.
Un gestor de proyectos bastante completo listo para usar.
En el siguiente video todavía usamos OpenXava Studio (ahora descatalogado), pero el resultado es el mismo que si lo creas desde IntelliJ o directamente con Maven. El video muestra la creación del proyecto, el proyecto funcionando y enseña el código fuente.
Aparte de lo básico como getionar incidencias, proyectos y versiones, permite crear planes por trabajador con períodos, como Enero 2025 o Semana 32, asociar el período al trabajador, y obtener el plan del trabajador al que se pueden asignar incidencias y ordenarlas. También soporta el control de clientes y tiempo que se les dedica.
Al ser una aplicación más completa podrás aprender muchas cosas, como el uso de la herencia, campos para guardar iconos, métodos de búsqueda con JPA en las entidades, campos de texto rico, hilos de discusión, listas ordenables por el usuario con arrastrar y soltar, acciones propias para las colecciones, un formateador personalizado para definir el color de ciertas fechas en la lista, un módulo de calendario personal, etc.
Además, incluye una base de datos inicial con datos de prueba y un conjunto de pruebas automáticas JUnit, incluyendo una usando Selenium. El código de las pruebas se encuentra en src/test/java y están listas para que las ejecutes con tu IDE.
Para usarlo desde IntelliJ o Visual Studio usa el arquetipo disponible en Maven Central llamado openxava-project-management-archetype-spanish.
Si prefieres crear tu proyecto desde línea de órdenes hazlo así:
mvn archetype:generate -DarchetypeGroupId=org.openxava -DarchetypeArtifactId=openxava-project-management-archetype-spanish -DarchetypeVersion=RELEASE -DgroupId=com.tuempresa -DartifactId=tugestorproyectos -DinteractiveMode=falseDonde en lugar de tugestorproyectos pon el nombre que quieras para tu aplicación.
Es el código de la aplicación acabada que se desarrolla en el curso de OpenXava. Aunque no es una aplicación de facturación lista para producción, contiene muchos ejemplos de código típicos en una aplicación empresarial de la vida real. Lo que incluye el modelado usando entidades JPA, la definición de la interfaz de usuario, el uso avanzado de la herencia, validación, Bean Validation, JAX-RS (servicios REST), refinar el comportamiendo predefinido, añadir comportamiento propio, lógica de negocio, uso avanzado de referencias y colecciones, etc.
Para usarlo desde IntelliJ o Visual Studio usa el arquetipo disponible en Maven Central llamado openxava-invoicing-archetype-spanish.
Si prefieres crear tu proyecto desde línea de órdenes hazlo así:
mvn archetype:generate -DarchetypeGroupId=org.openxava -DarchetypeArtifactId=openxava-invoicing-archetype-spanish -DarchetypeVersion=RELEASE -DgroupId=com.tuempresa -DartifactId=tufacturacion -DinteractiveMode=falseDonde en lugar de tufacturacion pon el nombre que quieras para tu aplicación.