openxava / documentación / Migración

¿Cómo actualizar tu proyecto a la última versión de OpenXava?

• Descarga la última distribución de OpenXava y descomprímela en un lugar nuevo.
• Si tu versión de OpenXava actual es anterior a la 5.0 crea un proyecto Java nuevo llamado Addons en tu workspace usando OpenXava Studio (o Eclipse o IntelliJ).
• Para OpenXava (o tu Eclipse o IntelliJ).
• Borra los proyectos Addons (a partir de v5.0) y OpenXava de tu workspace.
• Copia los proyectos Addons y OpenXava desde el workspace del nuevo OpenXava al tuyo.
• Arranca OpenXava Studio (o tu Eclipse o IntelliJ).
• Haz un Build All (Ctrl-B)
• Ejecuta la tarea ant actualizarOX de tu proyecto.
• Refresca (con F5) tu proyecto.
• Revisa las intrucciones que siguen.
• Si tu aplicación falla en Tomcat quita tu aplicación del Tomcat y vuélvela a añadir.

Para migrar de OpenXava 6.4.1 a OpenXava 6.4.2

Para migrar de OpenXava 6.4 a OpenXava 6.4.1

Para migrar de OpenXava 6.3.2 a OpenXava 6.4

Modificar el Deployment Assembly para ejecutar Tomcat dentro de Eclipse

Etiqueta automática para miembro de referencia en lista mejorada (para pruebas JUnit)

assertLabelInList(0, "Year of Invoice");

assertLabelInList(0, "Year of invoice");

Para migrar de OpenXava 6.3.1 a OpenXava 6.3.2

Para migrar de OpenXava 6.3 a OpenXava 6.3.1

Al cerrar el diálogo no se pierde la paginación de la colección (para pruebas JUnit)

execute("List.goNextPage", "collection=miColeccion");
execute("Collection.edit", "row=10,viewObject=xava_view_miColeccion");
setValue("nombre", "Nombre modificado");
execute("Collection.save");
// execute("List.goNextPage", "collection=miColeccion"); // QUITA ESTA LÍNEA
assertValueInCollection("miColeccion", 0, 0, "Nombre modificado");

Para migrar de OpenXava 6.2.2 a OpenXava 6.3

Página de bienvenida para Internet Explorer

<% if (org.openxava.web.Browsers.isIE(request)) { %>
<script type='text/javascript' src="<%=request.getContextPath()%>/xava/js/css-vars-ponyfill.js?ox=<%=oxVersion%>"></script>
<script type='text/javascript'>cssVars({ }); </script>	
<% } %>

Página de bienvenida para el contexto raíz

String applicationName = request.getContextPath().substring(1);
MetaApplication metaApplication = MetaApplications.getMetaApplication(applicationName);

MetaApplication metaApplication = MetaApplications.getMainMetaApplication();

Para migrar de OpenXava 6.2.1 a OpenXava 6.2.2

Para migrar de OpenXava 6.2 a OpenXava 6.2.1

Para migrar de OpenXava 6.1.2 a OpenXava 6.2

Definición de fuentes de datos en web/META-INF/context.xml del proyecto

Nuevo editor para los estereotipos FOTO, IMAGEN, GALERIA_IMAGENES, ARCHIVO y ARCHIVOS (para pruebas JUnit)

execute("ImageEditor.changeImage", "newImageProperty=imagen"); 
String urlImagen = System.getProperty("user.dir") + "/imagenes-pruebas/pastel.gif";
setFileValue("newImage", urlImagen);
execute("LoadImage.loadImage");

uploadFile("imagen", "imagenes-pruebas/pastel.gif");

execute("Gallery.edit", "galleryProperty=fotos");
execute("Gallery.addImage");
String urlImagen = System.getProperty("user.dir") + "/imagenes-pruebas/foto-javi.png";
setFileValue("newImage", urlImagen);
execute("LoadImageIntoGallery.loadImage");
execute("Gallery.close");

uploadFile("fotos", "imagenes-pruebas/foto-javi.png");

@View(members="numero, descripcion, pantallazos, fecha")

@View(members="numero, descripcion; pantallazos; fecha")

@View(members="numero, descripcion, adjuntos, fecha")

@View(members="numero, descripcion; adjuntos; fecha")

@View(members=
    "datos [ #titulo;" +	
    "   fechaEstreno, director;"   +
    "   guionistas, elenco;"    +
    "   guiones;" + // ARCHIVOS
    "]"
)

@View(members=
    "datos [ #titulo;" +	
    "   fechaEstreno, director;"   +
    "   guionistas, elenco;"    +
    "]" +
    "guiones [ guiones ]"
)

Para migrar de OpenXava 6.1.1 a OpenXava 6.1.2

Para migrar de OpenXava 6.1 a OpenXava 6.1.1

Primera carga de página del módulo vía AJAX (sólo si usas el API de HtmlUnit)

HtmlPage page = (HtmlPage) getWebClient().getCurrentWindow().getEnclosedPage();
waitAJAX(); // AÑADE ESTA LÍNEA ANTES DE USAR page

Si tus pruebas usan métodos de ModuleTestBase exclusivamente no has de hacer ningún cambio.

Para migrar de OpenXava 6.0.2 a OpenXava 6.1

Bean Validation actualizado de 1.1 a 2.0

Bean Validation 2.0 es compatible con 1.1, por lo que la mayoría de tu código seguirá funcionando como siempre. Sin embargo, Bean Validation 2.0 incluye algunas anotaciones nuevas que antes estaban en Hibernate Validator, por eso si importabas los dos, Hibernate Validator y Bean Validation, puede que tu código no compile. Por ejemplo:

import javax.validation.constraints.*;
import org.hibernate.validator.constraints.*; 

public class MiClase {

    // @NotBlank // AHORA COMPILA CON ERROR
    @javax.validation.constraints.NotBlank // CALIFICA LA ANOTACIÓN
    private String callePrincipal;

Ahora @NotBlank está tanto en javax.validation.constraints como en org.hibernate.validator.constraints. Simplemente quita el import de org.hibernate.validator.constraints o, si todavía necesitas Hibernate Validator, califica la anotación @NotBlank (es decir usa @javax.validation.constraints.NotBlank).

Actualización de librerias EL para Tomcat 7 u otro servidor de aplicaciones antiguo

HtmlUnit actualizado de 2.15 a 2.32

Si usas directamente el API de HtmlUnit, vía getWebClient() o getHtmlPage() de ModuleTestBase, tienes que adaptar tu código al nuevo HtmlUnit. Hemos recolectado aquí algunos cambios que hemos notado.

Por ejemplo, los métodos que empiezan por getHtmlElement... ahora son getElement..., sólo has de quitar el Html. Por tanto, deberías cambiar:

HtmlElement i = chartsLink.getHtmlElementsByTagName("i").get(0);

Por:

HtmlElement i = chartsLink.getElementsByTagName("i").get(0);

El método click() ya no lanza el evento onclick. Por lo que has de cambiar:

boton.click();

Por:

getHtmlPage().executeJavaScript(boton.getOnClickAttribute());

Cambiar el valor de un HtmlInput ya no lanza el evento onchange, por lo que has de cambiar:

input.setValueAttribute(valor);

input.setValueAttribute(valor);
if (!Is.emptyString(input.getOnChangeAttribute())) {
    input.fireEvent(Event.TYPE_CHANGE);
}

Y posiblemente más cosas, consulta la documentación de HtmlUnit.

ModuleTestBase.setLocale() reinicia el módulo

Por causa del nuevo HtmlUnit ya no tenemos manera de cambiar el lenguaje sin reiniciar el módulo. Por tanto, puede que necesites adaptar algunas de tus pruebas. Por ejemplo:

execute("CRUD.new");
...
setLocale("es"); // Aquí el módulo se reinicia
execute("CRUD.new"); // AÑADE ESTA LÍNEA
...

En este caso el setLocale() reinicia el módulo empezando en modo lista, por eso llamamos a CRUD.new, para que la prueba continue funcionando como siempre.

Hibernate actualizado de 4.3 a 5.3

Dado que usamos el API de JPA en nuestras aplicaciones la mayoría de nuestro código debería funciona sin ningún cambio. Sin embargo, puede que encuentres algún detalle que funcione ligeramente diferente. Por ejemplo, para esta definición de entidad:

public class Cliente {
    @OneToMany
    private Collection<Vendedor> vendedores;

El siguiente código ha dejado de funcionar:

cliente.setVendedores(Collections.emptySet());

cliente.setVendedores(new ArrayList<>());

Quizás encuentres alguna que otra cosa que tengas que ajustar, consulta la documentación de Hibernate. De todos modos, en los puntos que siguen explicamos los cambios más importantes relacionados con Hibernate 5.3.

Claves foráneas duplicadas si se usa generación automática de esquema

Hibernate 5.3 tiene un bug que duplica las claves foráneas si usas hibernate.hbm2ddl.auto=update contra la base de datos que estabas usando con Hibernate 4.3. Si tu base de datos es tolerante con las claves duplicadas no hay problema, en caso contrario puede que tengas algunas advertencias e incluso errores. De momento, la única solución a esto es quitar todas las claves foráneas de tu base de dato manualmente, de tal forma que Hibernate las cree correctamente al arrancar.

Actualizar esquema automáticamente al arrancar requiere un esquema por defecto

En Hibernate 5.3 la siguiente configuración para persistence.xml no funciona:

<properties>
    <property name="hibernate.hbm2ddl.auto" value="update"/>
</properties>

Has de definir un hibernate.default_schema para que vaya. Si no usas un esquema simplemente define el esquema por defecto para tu base de datos, por ejemplo PUBLIC para HSQLDB, así:

<properties>
    <property name="hibernate.hbm2ddl.auto" value="update"/>
    <property name="hibernate.default_schema" value="PUBLIC"/>
</properties>

MySQL ya no reconoce el esquema por defecto

Con Hibernate 5.3 hibernate.default_schema ya no tiene efecto en MySQL, ahora has de usar hibernate.default_catalog en su lugar. A partir de OpenXava 6.1.2 hemos modificado la API de OpenXava para que funcione como siempre, reconociendo hibernate.default_schema incluso para MySQL. Sin embargo, la generación automática de esquema al iniciar la aplicación (es decir hibernate.hbm2dll.auto=update o javax.persistence.schema-generation.database.action=update) es asunto de Hibernate, por lo que no podemos arreglarlo. Si usas esta funcionalidad, deberías cambiar hibernate.default_schema por hibernate.default_catalog.

Resumiendo, si usas MySQL cambia en persistence.xml:

<properties>
    <property name="hibernate.hbm2ddl.auto" value="update"/>
    <property name="hibernate.default_schema" value="EMPRESAB"/>
</properties>

Por:

<properties>
    <property name="hibernate.hbm2ddl.auto" value="update"/>
    <property name="hibernate.default_catalog" value="EMPRESAB"/>
</properties>

Fíjate, hibernate.default_catalog en vez de hibernate.default_schema. Sólo para MySQL.

@GeneratedValue(strategy=GenerationType.AUTO) ya no es IDENTITY por defecto

En Hibernate 5.3 @GeneratedValue(strategy=GenerationType.AUTO) ya no es IDENTITY por defecto, al menos para HSQLDB. Por tanto, si usas HSQLDB y no quieres cambiar tu estructura de tablas has de cambiar:

@Id 
@GeneratedValue(strategy=GenerationType.AUTO) // O @GeneratedValue a secas
private int id;

Por esto:

@Id 
@GeneratedValue(strategy=GenerationType.IDENTITY) 
private int id;

En tus propiedades id con GenerationType.AUTO.

Definición de métodos cambiada para UserType y CompositeUser de Hibernate

En Hibernate 5.3 han cambiado la definición de los métodos para los conversores de tipo, los que se usan en la anotación @Type. Si has creado tu propio conversor de tipo Hibernate has de hacer algunas ligeras modificaciones en la definición de tus métodos, concretamente has de cambiar SessionImplementer por SharedSessionContractImplementor como parámetro. Por ejemplo, deberías cambiar esta línea:

public Object nullSafeGet(ResultSet resultSet, String[] names, SessionImplementor sessionImplementor, Object owner) 
    throws HibernateException, SQLException {

Por esta otra:

public Object nullSafeGet(ResultSet resultSet, String[] names, SharedSessionContractImplementor sessionImplementor, Object owner)
    throws HibernateException, SQLException {

Lo mismo para todos los métodos que usen SessionImplementer en cualquier implementación de UserType o CompositeUser.

Configuración para Liferay

Para que el nuevo Hibernate 5.3 funcione con Liferay has de crear un archivo portal-ext.properties en la carpeta webapps/ROOT/WEB-INF/classes del Tomcat en tu Liferay, con la siguiente entrada:

portal.security.manager.strategy=none           

Para migrar de OpenXava 6.0.1 a OpenXava 6.0.2

Para migrar de OpenXava 6.0 a OpenXava 6.0.1

Para migrar de OpenXava 5.9.1 a OpenXava 6.0

Nuevas páginas de bienvenida y de primeros pasos

Si no has modificado tus página de bienvenida y primeros pasos has de borrar web/naviox/welcome.jsp y web/naviox/firstSteps.jsp de tu proyecto antes de hacer el actualizarOX. Si tienes tus propias páginas de bienvenida o primeros pasos las tienes que editar para cambiar las referencias a naviox.css (como se explica abajo) y quitar todas las referencias a la clase Java NaviOXStyle que ya no existe.

naviox.css renombrado como light.css

Además, se ha movido de Addons a OpenXava. Por tanto, si lo usas en algún JSP personalizado, como welcome.jsp, has de cambiar:

<link href="<%=request.getContextPath()%>/naviox/style/naviox.css?ox=<%=oxVersion%>" 
    rel="stylesheet" type="text/css">

<link href="<%=request.getContextPath()%>/xava/style/light.css?ox=<%=oxVersion%>"
    rel="stylesheet" type="text/css">

<link href="<%=request.getContextPath()%>/xava/style/<%=XavaPreferences.getInstance().getStyleCSS()%>?ox=<%=oxVersion%>"
    rel="stylesheet" type="text/css">

View.findObject() devuelve true si no encuentra el objeto en lugar de lanzar una excepción

getView().findObject();

if (!getView().findObject()) {
    addError("object_with_key_not_found")
}

execute("Mode.detailAndFirst"); -- Cambiar por --> execute("List.viewDetail", "row=0");

execute("DetailList.detailAndFirst"); -- Cambiar por --> execute("List.viewDetail", "row=0"); 
execute("DetailList.list");           -- Cambiar por --> execute("Mode.list");

execute("Mode.split"); // Quita esta línea de tus pruebas, quizás tengas que adaptar tu prueba

private String [] acciones = {
    "Print.generatePdf",
    "Print.generateExcel",
    "ImportData.importData", 
    "CRUD.new",
    "CRUD.deleteSelected",
    "CRUD.deleteRow",
    // "Mode.detailAndFirst",     // QUITA ESTA LÍNEA
    // "Mode.split",              // QUITA ESTA LÍNEA
    "List.filter",
    "List.orderBy",
    "List.viewDetail",
    "List.hideRows",
    "List.sumColumn",
    "List.changeConfiguration",
    "List.changeColumnName", 
    "ListFormat.select" 
}; 
assertActions(acciones);

execute("CRUD.new"); 
execute("Collection.new", "viewObject=xava_view_edificios");

execute("CRUD.new");
setValue("nombre", "ALGO"); // AÑADE ESTO
execute("Collection.new", "viewObject=xava_view_edificios");

execute("List.viewDetail", "row=0"); // En lugar de: execute("CRUD.new");
execute("Collection.new", "viewObject=xava_view_edificios");

Para migrar de OpenXava 5.9 a OpenXava 5.9.1

Para migrar de OpenXava 5.8.1 a OpenXava 5.9

Nuevas acciones en colecciones (para pruebas JUnit)

String [] acciones = {
    "Navigation.previous",
    "Navigation.first",
    "Navigation.next",
    "CRUD.new",
    "CRUD.save",
    "CRUD.delete",
    "CRUD.refresh",
    "Mode.list",
    "Mode.split",
    "Collection.new",
    "Collection.removeSelected",
    "CollectionCopyPaste.cut", // AÑADE ESTA ENTRADA
    "Print.generatePdf",
    "Print.generateExcel",
    "List.filter",
    "List.orderBy",
    "List.sumColumn", // SIEMPRE PRESENTE, INCLUSO CON LA COLECCIÓN VACÍA
    "List.changeColumnName"
};
assertActions(acciones);

Los booleanos muestran su etiqueta en vez de un icono en las listas

assertValueInList(2, 4, "Yes");

assertValueInList(2, 4, "Pagado");

assertValueInList(2, 4, "No");

assertValueInList(2, 4, "");

<editor url="booleanEditor.jsp">
  <formateador clase="org.openxava.formatters.BooleanFormatter" >
    <poner propiedad="nullAsFalse" valor="true"/>
  </formateador>
  <formateador-lista clase="org.openxava.formatters.BooleanIconListFormatter" />
  <para-tipo tipo="boolean" />
  <para-tipo tipo="java.lang.Boolean" />
</editor>

Las páginas de bienvenida y la de inicio de sesión están separadas

Para migrar de OpenXava 5.8 a OpenXava 5.8.1

Para migrar de OpenXava 5.7.1 a OpenXava 5.8

Nueva acciones en modo lista (para pruebas JUnit)

private String [] accionesLista = {
    "Print.generatePdf",
    "Print.generateExcel",
    "ExtendedPrint.myReports",
    "CRUD.new",
    "CRUD.deleteSelected",
    "CRUD.deleteRow",
    "Mode.detailAndFirst",
    "Mode.split",
    "List.filter",
    "List.orderBy",
    "List.viewDetail",
    "List.hideRows",
    "List.sumColumn",
    "List.changeConfiguration",
    "ListFormat.select",
    "List.changeColumnName", // AÑADE ESTA ENTRADA
    "ImportData.importData"  // AÑADE ESTA ENTRADA
};
assertActions(accionesLista);

La acción de borrar no está disponible mientra se está creando un nuevo elemento (para pruebas JUnit)

String [] accionesDespuesNuevo = {
 "Navigation.previous",
 "Navigation.first",
 "Navigation.next",
 "CRUD.new",
 "CRUD.save",
 // "CRUD.delete", // QUITA ESTA LÍNEA
 "CRUD.refresh",
 "Mode.list",
 "Mode.split",
 "List.filter",
 "List.orderBy",
 "Print.generatePdf",
 "Print.generateExcel"
};
assertActions(accionesDespuesNuevo);

Acción de buscar ya no está disponible en modo detalle (para pruebas JUnit)

String [] acciones = {
 "Navigation.previous",
 "Navigation.first",
 "Navigation.next",
 "CRUD.new",
 "CRUD.save",
 "CRUD.delete",
 // "CRUD.search", // QUITA ESTA LÍNEA
 "CRUD.refresh",
 "Mode.list",
 "Mode.split",
};
assertActions(acciones);

execute("CRUD.search");
setValue("numero", "123");
execute("Search.search");

setValue("numero", "123");
execute("CRUD.refresh");

<modulo nombre="Albaran">
    <modelo nombre="Albaran"/>
    <controlador nombre="Typical"/>
    <controlador nombre="SearchForCRUD"/> <!-- AÑADE ESTA LÍNEA -->
</modulo>

<controlador nombre="Autor">
    <hereda-de controlador="Typical"/>
    <hereda-de controlador="SearchForCRUD"/> <!-- AÑADE ESTA LÍNEA  -->
    <accion nombre="hazAlgo"
        clase="com.miempresa.prueba.acciones.HazAlgo" />
</controlador>

execute("CRUD.search");

execute("SearchForCRUD.search");

<modulo-defecto>
    <controlador nombre="TypicalWithSearch"/>
</modulo-defecto>

Módulos sin filas empiezan ejecutando la acción nuevo (para pruebas JUnit)

public void testCrearExamenConAlMenosUnaPregunta() throws Exception {
  assertListRowCount(0); // AHORA ESTA LÍNEA FALLA
  execute("CRUD.new");
  setValue("nombre", "ADMISIÓN");
  execute("CRUD.save");
  ...
}

public void testCrearExamenConAlMenosUnaPregunta() throws Exception {
  execute("Mode.list"); // AÑADE ESTA LÍNEA
  assertListRowCount(0);
  execute("CRUD.new");
  setValue("nombre", "ADMISIÓN");
  execute("CRUD.save");
  ...
}

public void testCrearExamenConAlMenosUnaPregunta() throws Exception {
  // assertListRowCount(0); // QUITA ESTA LÍNEA
  // execute("CRUD.new"); // QUITA ESTA LÍNEA
  setValue("nombre", "ADMISIÓN");
  execute("CRUD.save");
  ...
}

Para migrar de OpenXava 5.7 a OpenXava 5.7.1

Para migrar de OpenXava 5.6.1 a OpenXava 5.7

Acción List.changeConfigurationName renombrada como List.changeConfiguration (para pruebas JUnit)

private String [] accionesLista = {
  "Mode.detailAndFirst",
  "Mode.split",
  "List.filter",
  "List.orderBy",
  "List.viewDetail",
  "List.hideRows",
  "List.sumColumn",
  // "List.changeConfigurationName" // QUITA ESTA ENTRADA
  "List.changeConfiguration" // AÑADE ESTA ENTRADA
};
assertActions(accionesLista);

Propiedades por defecto mejoradas para lista y colecciones (para pruebas JUnit)

@Entity
public class Factura {
 private int ano;
 private int numero;
 private Date fecha;
 @ManyToOne
 private Cliente cliente;
 
 @Stereotype("ARCHIVOS") @Column(length=32)
 private String archivos;
 
 ...
}

@NewAction ya no sirve para definir la acción de añadir en las colecciones @OneToMany convencionales

@NewAction("Factura.anadirAlbaranes")
@OneToMany(mappedBy="factura")
private Collection<Albaran> albaranes;

@AddAction("Factura.anadirAlbaranes")
@OneToMany(mappedBy="factura")
private Collection<Albaran> albaranes;

Colecciones de entidades sin REMOVE cascade permiten editar los elementos (para pruebas JUnit)

execute("Collection.view", "row=1,viewObject=xava_view_customers");

execute("Collection.edit", "row=1,viewObject=xava_view_customers");

Optimizadas las etiquetas automáticas para las referencias en la lista (para pruebas JUnit)

assertLabelInList(4, "Nombre de Cliente");

assertLabelInList(4, "Cliente");

Para migrar de OpenXava 5.6 a OpenXava 5.6.1

Para migrar de OpenXava 5.5.1 a OpenXava 5.6

La acción ExtendedPrint.myReports ya no está disponible por defecto (para pruebas JUnit)

private String [] accionesLista = {
    "Print.generatePdf",
    "Print.generateExcel",
    // ELIMINA ESTA LÍNEA "ExtendedPrint.myReports",
    "CRUD.new",
    "CRUD.deleteSelected",
    ...
};
assertActions(accionesLista);

Nueva acción en lista (para pruebas junit)

private String [] accionesLista = {
  "Mode.detailAndFirst",
  "Mode.split",
  "List.filter",
  "List.orderBy",
  "List.viewDetail",
  "List.hideRows",
  "List.sumColumn",
  "List.changeConfigurationName" // AÑADE ESTA ENTRADA
};
assertActions(accionesLista);

Para migrar de OpenXava 5.5 a OpenXava 5.5.1

Necesario llamar a super dentro de setUp() de las pruebas antes de usar JPA

protected void setUp() throws Exception {
    crearEntidadesUsandoJPA(); // Ahora falla, porque JPA todavía no está inicializado
    super.setUp();
}

protected void setUp() throws Exception {
    super.setUp(); // JPA se incializa aquí
    crearEntidadesUsandoJPA();
}

Para migrar de OpenXava 5.4.1 a OpenXava 5.5

Los combos para @DescriptionsList ya no son selects de HTML (sólo si usas el API de HtmlUnit)

form.getSelectByName("ox_MiAp_MiModulo__miReferencia___id").setSelectedAttribute("ElValor", true);

HtmlInput comboInput = form.getInputByName("ox_MiAp_MiModulo__miReferencia___id");
comboInput.setValueAttribute("ElValor");
((HtmlInput) comboInput.getPreviousElementSibling()).setValueAttribute("Algo"); // Un truco para evitar que JavaScript borre el valor real
((HtmlInput) comboInput.getNextElementSibling()).setValueAttribute("Algo"); // Un truco para evitar que JavaScript borre el valor real

Para migrar de OpenXava 5.4 a OpenXava 5.4.1

Para migrar de OpenXava 5.3.2 a OpenXava 5.4

Iconos en lugar de imágenes para las acciones

<accion nombre="borrar" modo="detalle" confirmar="true"
    clase="com.miempresa.miaplicacion.acciones.MiBorrar"
    imagen="delete.gif"
    atajo-de-teclado="Control D"/>

<accion nombre="borrar" mode="detalle" confirmar="true"
    clase="com.miempresa.miaplicacion.acciones.MiBorrar"
    icono="delete"
    atajo-de-teclado="Control D"/>

useIconsInsteadOfImages=false

Para migrar de OpenXava 5.3.1 a OpenXava 5.3.2

Para migrar de OpenXava 5.3 a OpenXava 5.3.1

El jar de HSQLDB se ha movido desde OpenXavaTest a OpenXava

<property name="schema.path" value="../OpenXavaTest/lib/hsqldb.jar"/>

<property name="schema.path" value="../OpenXava/lib/hsqldb.jar"/>

Para migrar de OpenXava 5.2.1 a OpenXava 5.3

Hibernate actualizado a 4.3

public Object nullSafeGet(ResultSet resultSet, String[] names, Object owner) throws HibernateException, SQLException {

public Object nullSafeGet(ResultSet resultSet, String[] names, SessionImplementor sessionImplementor, Object owner) throws HibernateException, SQLException {

public void nullSafeSet(PreparedStatement ps, Object value, int index) throws HibernateException, SQLException {

public void nullSafeSet(PreparedStatement ps, Object value, int index, SessionImplementor sessionImplementor) throws HibernateException, SQLException {

((UserType) hibernateType).nullSafeSet(ps, o, 1);

((UserType) hibernateType).nullSafeSet(ps, o, 1, null);

<persistence-unit name="default" transaction-type="RESOURCE_LOCAL">
    <provider>org.hibernate.ejb.HibernatePersistence</provider>
 
    <properties>
        <property name="hibernate.ejb.cfgfile" value="/hibernate-jpa.cfg.xml"/>
        <!-- ELIMINA LAS SIGUIENTES LÍNEAS
        <property name="hibernate.ejb.event.pre-insert" value="org.openxava.hibernate.impl.CalculatorsListener, org.openxava.hibernate.impl.ReferenceConverterToDBListener, org.openxava.hibernate.impl.DefaultValueCalculatorsListener"/>
        <property name="hibernate.ejb.event.pre-update" value="org.openxava.hibernate.impl.CalculatorsListener, org.openxava.hibernate.impl.ReferenceConverterToDBListener"/>
        <property name="hibernate.ejb.event.pre-delete" value="org.openxava.hibernate.impl.CalculatorsListener"/>
        <property name="hibernate.ejb.event.post-load" value="org.openxava.hibernate.impl.CalculatorsListener"/>
        -->
    </properties>
</persistence-unit>

<persistence-unit name="default">
    ...
    <properties>
        ...
        <!-- Añade la siguiente línea -->
        <property name="hibernate.connection.release_mode" value="after_transaction"/>
 
    </properties>
 
</persistence-unit>

Hibernate Validator 3 quitado de la distribución

import org.hibernate.validator.*;

import javax.validation.constraints.*;
import org.hibernate.validator.constraints.*;

@Digits(integerDigits=10, fractionalDigits=6)

@Digits(integer=10, fraction=6)

@PreRemove
public void validarAlBorrar() {
    if (numero == 1) {
        throw new InvalidStateException(
            new InvalidValue [] {
                new InvalidValue(
                    "uno_no_se_puede_borrar", getClass(), "numero",
                    getNumero(), this)
            }
        );
    }
}

@PreRemove
public void validarAlBorrar() {
    if (numero == 1) {
        throw new javax.validation.ValidationException("uno_no_se_puede_borrar");
    }
}

@Constraint(validatedBy = MyValidator.class) // En lugar de @ValidatorClass(PropertyValidatorValidator.class)
public @interface MyAnnotation {
 
    ...
 
    // Añade el siguiente código
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
 
}

public class RequiredValidator implements Validator<Required> {

public class RequiredValidator implements ConstraintValidator<Required, Object> {

public boolean isValid(Object value) {

public boolean isValid(Object value, ConstraintValidatorContext context) {

@Required, @PropertyValidator y @EntityValidator son restricciones de Bean Validation

try {
    XPersistence.commit();
}
catch (RollbackException ex) {
    if (ex.getCause() instanceof InvalidStateException) {
        InvalidStateException iex = (InvalidStateException) ex.getCause();
        int cantidadValoresInvalidos = iex.getInvalidValues().length;
        String propiedad = iex.getInvalidValues()[0].getPropertyName();
        String mensaje = iex.getInvalidValues()[0].getMessage();
        ...
    }
}

try {
    XPersistence.commit();
}
catch (RollbackException ex) {
    if (ex.getCause() instanceof ConstraintViolationException) {
        ConstraintViolationException cex = (ConstraintViolationException) ex.getCause();
        int cantidadValoresValidos = cex.getConstraintViolations().size();
        ConstraintViolation v = cex.getConstraintViolations().iterator().next();
        String propiedad = v.getPropertyPath().toString());
        String mensaje = v.getMessage());
        ...
    }
}

Prefijo para JNDI en Tomcats antiguos

<non-jta-data-source>java:comp/env/jdbc/TuAplicacionDS</non-jta-data-source>

<non-jta-data-source>java://comp/env/jdbc/TuAplicacionDS</non-jta-data-source>

<property name="hibernate.connection.datasource">java:comp/env/jdbc/TuAplicacionDS</property>

<property name="hibernate.connection.datasource">java://comp/env/jdbc/TuAplicacionDS</property>

Actualización de librerias EL para Tomcat 6

Librería Automated Business Logic (ABL) quitada de la distribución

public class PedidoLogic {
 
    @Formula("precioProducto * cantidad")
    public void deriveImporte() { }
 
}

@Entity
public class Pedido {
 
    ...
 
    @PrePersist @PreUpdate
    private void deriveImporte() {
        importe = new BigDecimal(cantidad).multiply(precioProducto);
    }
}

<property name="hibernate.current_session_context_class"
    value="com.autobizlogic.abl.session.LogicThreadLocalSessionContext"/>

schema.path necesario en tarea ant generarEsquema

<!-- Genera el esquema desde cero. Lo muestra en consola, pero no lo ejecuta -->
<target name="generarSchema">
 
    <ant antfile="../OpenXava/build.xml" target="generateSchemaJPA">
        <property name="persistence.unit" value="junit"/>
        <!-- AÑADE LA SIGUIENTE LÍNEA PARA v5.3 -->
        <property name="schema.path" value="../OpenXavaTest/lib/hsqldb.jar"/>
    </ant>
 
</target>

Para migrar de OpenXava 5.2 a OpenXava 5.2.1

Entidad obtenida de la vista tiene nulos para referencias inexistentes

Factura factura = (Factura) getView().getEntity();
if (factura.getCliente().getCodigo() == 0) { // En v5.2 si cliente está vacío se devuelve un cliente vacío

Factura factura = (Factura) getView().getEntity();
if (factura.getCliente() == null) { // En v5.2.1 si cliente está vacío se devuelve nulo

Para migrar de OpenXava 5.1.x a OpenXava 5.2

HtmlUnit actualizado a 2.15

getWebClient().setCssEnabled(true);

getWebClient().getOptions().setCssEnabled(true);

HtmlElement consola = getHtmlPage().getElementById("xava_console");

HtmlElement consola = getHtmlPage().getHtmlElementById("xava_console");

Para migrar de OpenXava 5.0.x a OpenXava 5.1

@DefaultValueCalculator dependiente de otras propiedades cambia su comportamiento

@DefaultValueCalculator(
    value=CalculadorPrecioUnitario.class,
    properties=@PropertyValue(
        name="numeroProducto",
        from="producto.numero")
)
private BigDecimal precioUnitario;

@OnChange(RecalcularPreciOUnitarioAlCambiarProducto.class)
private Producto producto;
 
private BigDecimal precioUnitario;

Para migrar de OpenXava 4.9.1 a OpenXava 5.0

La identifación de usuarios afecta a tus pruebas jUnit

autologinUser=admin
autologinPassword=admin

public void testMiPrueba() throws Exception {
    login("admin", "admin");
    ...
}

Ejecutar los módulos en solitario ya no está disponible por defecto

<filter>
    <filter-name>naviox</filter-name>
    <filter-class>com.openxava.naviox.web.NaviOXFilter</filter-class>
</filter>
 
<filter-mapping>
    <filter-name>naviox</filter-name>
    <url-pattern>*.jsp</url-pattern>
</filter-mapping>
 
<filter-mapping>
    <filter-name>naviox</filter-name>
    <servlet-name>naviox</servlet-name>
</filter-mapping>
 
<filter-mapping>
    <filter-name>naviox</filter-name>
    <servlet-name>module</servlet-name>
</filter-mapping>

<servlet>
    <servlet-name>naviox</servlet-name>
    <servlet-class>com.openxava.naviox.web.NaviOXServlet</servlet-class>
</servlet>

<servlet>
    <servlet-name>modules</servlet-name>
    <servlet-class>org.openxava.web.servlets.ModuleServlet</servlet-class>
</servlet>

<servlet-mapping>
    <servlet-name>naviox</servlet-name>
    <url-pattern>/modules/*</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>modules</servlet-name>
    <url-pattern>/modules/*</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>naviox</servlet-name>
    <url-pattern>/m/*</url-pattern>
</servlet-mapping>

styleClass=org.openxava.web.style.Liferay51Style
styleCSS=liferay51/css/everything_unpacked.css

El estilo nativo de iPad no se usa por defecto

Las clases transitorias requieren un declaración expicita de módulo

<modulo nombre="FiltroPorMes">
    <modelo nombre="FiltroPorMes"/>
    <controlador nombre="FiltroPorMes"/>
</modulo>

Nivel de log FINEST genera un montón de traza

javaLoggingLevel=FINEST

javaLoggingLevel=FINE

Eliminada clase Objects de org.openxava.util

Objects.execute(miObjeto, "hacerAlgo");

XObjects.execute(miObjeto, "hacerAlgo");

AccessTracking quitado de la distribución

La URL usada por ModuleTestBase incluye un parámetro por defecto

public class MiModuloTest extends ModuleTestBase {
 
    ...
 
    @Override
    protected String getModuleURL() {
        // return super.getModuleURL() + "?miParametro=5"; // Con ? en v4.x.x
        return super.getModuleURL() + "&miParametro=5"; // Con & en v5.0
    }
}

@Digits anula la escala por defecto

@Digits(integer=10)
private BigDecimal importe;

@Digits(integer=10, fraction=2)
private BigDecimal importe;

Formateo de BigDecimal arreglado (para pruebas jUnit)

assertValue("miNumeroBigDecimal", "20");

assertValue("miNumeroBigDecimal", "20.00");

Para migrar de OpenXava 4.9 a OpenXava 4.9.1

Modificador de acceso del método getFrame() cambiado

Para migrar de OpenXava 4.8.1 a OpenXava 4.9

Cabeceras de informes PDF pueden ocupar varias líneas

assertPopupPDFLinesCount(5); // Quizás ahora hay 6 líneas, porque la cabecera usa 2 líneas

Controlador CustomReport renombrado a MyReport

Para migrar de OpenXava 4.8 a OpenXava 4.8.1

Ocultar un miembro cuyo nombre es el mismo que la sección que lo contiene

@View(members=
  ...
  "observaciones { consejo, atajo; observaciones }"
  ...
)

getView().setHidden("observaciones", true);

@View(members=
   ...
   "comentarios { consejo, atajo; observaciones }"
   ...
)

Para migrar de OpenXava 4.7.1 a OpenXava 4.8

Para migrar de OpenXava 4.7 a OpenXava 4.7.1

La acción Gallery.return ha sido renombrada como Gallery.close

Para migrar de OpenXava 4.6.1 a OpenXava 4.7

La acción ExtendedPrint.customReport ha sido renombrada como ExtendedPrint.myReports

El método getSelected() de Tab y TabBaseAction obsoleto, ahora usamos getSelectedKeys()

int[] selected = tab.getSelected();
for (int i = 0; i < selected.length; i++){
     Map clave = (Map) tab.getTableModel().getObjectAt(selected[i]);
     ....
}

Map[] selected = tab.getSelectedKeys();
for (int i = 0; i < selected.length; i++){
     Map clave = selected[i];
     ....
}

Suprimido método deselectVisualizedRows de la clase Tab

Para migrar de OpenXava 4.6 a OpenXava 4.6.1

Mensajes en archivos i18n sin argumentos ahora son formateados de manera estándar

mi_mensaje=T'ha dit que no

mi_mensaje=T''ha dit que no

Para migrar de OpenXava 4.5.1 a OpenXava 4.6

Para migrar de OpenXava 4.5 a OpenXava 4.5.1

Los editores personalizados han de especificar el atributo tabindex

<input id="<%=propertyKey%>"
    name="<%=propertyKey%>" class="<%=style.getEditor()%> <%=numericClass%>"
    type="<%=inputType%>"
    tabindex="1" <!-- Ahora hay que poner esto -->
    ...
/>

Para migrar de OpenXava 4.4.x a OpenXava 4.5

Select íntegro en baseCondition de @Tab ahora tiene que usar sintaxis JPQL y no SQL

baseCondition =
    "select CODIGO, DESCRIPCION, FAMILIA.DESCRIPCION " +
    "from   XAVATEST.SUBFAMILIA, XAVATEST.FAMILIA " +
    "where  SUBFAMILIA.FAMILIA = FAMILIA.CODIGO"

baseCondition =
    "select e.codigo, e.descripcion, f.descripcion " +
    "from Subfamilia e, Familia f " +
    "where e.codigoFamilia = f.codigo"

El atributo condition de @DescriptionsList ahora usa sintaxis JPQL y no SQL

@DescriptionsList(
    // No funciona porque IDCOSA es un nombre de columna, por eso JPA no lo reconoce
    condition="${cosa.codigo} = (SELECT IDCOSA FROM ${Cosa} WHERE nombre = 'COCHE')"
)

@DescriptionsList(
    // Funciona porque usamos el nombre de propiedad, codigo, en vez de IDCOSA
    condition="${cosa.codigo} = (SELECT codigo FROM ${Cosa} WHERE nombre = 'COCHE')"
)

@DescriptionsList(
    // Podemos usar JPQL puro sin ${nombrePropiedad}
    condition="e.cosa.codigo = (SELECT c.codigo FROM Cosa c WHERE c.nombre = 'COCHE')"
)

@OnSelectElementAction no refresca por defecto su colección

public class MiOnSelectElementAction extends OnSelectElementBaseAction {
 
    public void execute() throws Exception {
        hacerAlgoQueModificaLaColeccion();
        getView().refreshCollections(); // A partir de v4.5 has de añadir esta linea
    }
 
}

Para migrar de OpenXava 4.3.x a OpenXava 4.4

HtmlUnit actualizado de 2.5 a 2.9

Para migrar de OpenXava 4.2.x a OpenXava 4.3

Para migrar de OpenXava 4.1.x a OpenXava 4.2

Para migrar de OpenXava 4.0.1 a OpenXava 4.1

Nueva acción en lista y colecciones (para pruebas junit)

private String [] accionesLista = {
  "Mode.detailAndFirst",
  "Mode.split",
  "List.filter",
  "List.customize",
  "List.orderBy",
  "List.viewDetail",
  "List.hideRows",
  "List.sumColumn" // AÑADE ESTA ENTRADA
};
assertActions(accionesLista);

Para migrar de OpenXava 4.0 a OpenXava 4.0.1

Ya no hay conversor por defecto para boolean

<para-tipo tipo="boolean"
  clase-conversor="org.openxava.converters.Boolean01Converter"
  tipo-cmp="java.lang.Integer"/>
 
<para-tipo tipo="java.lang.Boolean"
  clase-conversor="org.openxava.converters.Boolean01Converter"
  tipo-cmp="java.lang.Integer"/>

Para migrar de OpenXava 4m6 a OpenXava 4.0

Para migrar de OpenXava 4m5 a OpenXava 4m6

Hibernate actualizado a Hibernate 3.6

Referencias @ManyToOne inexistentes usadas como @Id ya no están soportadas (Hibernate 3.6)

public class Albaran {
 
  @Id @Column(length=5)
  private int numero;
 
  @Id @ManyToOne(fetch=FetchType.LAZY)
  private TipoAlbaran tipo;  // El tipo ha de existir en la base de datos
  ...
}

• Crea una fila en la tabla referenciada con 0 como clave.
• Usa una propiedad plana en vez de una referencia. En este caso puedes usar un editor especial para la propiedad.
• Permite nulos para la columna usada como pseudo-clave-foranea y cambia todos los ceros por nulos en esa columna.

Para poder asignar una entidad ya existente ésta ha de ser 'manejada' (Hibernate 3.6)

Albaran albaran = new Albaran();
TipoAlbaran tipoAlbaran = new TipoAlbaran(); // Creamos un nuevo TipoAlbaran
                                             // en lugar de buscarlo
tipoAlbaran.setNumero(66); // El TipoAlbaran 66 ya existe en la base de datos
albaran.setTipo(tipoAlbaran);
...
XPersistence.getManager().persist(albaran);

Albaran albaran = new Albaran();
TipoAlbaran tipoAlbaran = XPersistence.getManager()
  .find(TipoAlbaran.class, 66); // Lo buscamos
albaran.setTipo(tipoAlbaran);
XPersistence.getManager().persist(albaran);

Entidad con solo una referencia @ManyToOne como clave (Hibernate 3.6)

@Entity
@IdClass(PersonaContactoClienteKey.class)
public class PersonaContactoCliente {
 
  @Id @ManyToOne(fetch=FetchType.LAZY)
  private Cliente cliente;
 
  // No más campos @Id
 
  ...
 
}

@ManyToOne(fetch=FetchType.LAZY)
@JoinColumn(name="CUSTOMERCONTACT") // Sin el atributo referencedColumnName
private PersonaContactoCliente personaContactoCliente;

@Entity // @IdClass ya no se usa
public class PersonaContactoCliente
  implements java.io.Serializable { // Tiene que implementar Serializable
 
  @Id @ManyToOne(fetch=FetchType.LAZY)
  private Cliente cliente;
 
  // No más campos @Id
 
  ...
 
}

@ManyToOne(fetch=FetchType.LAZY)
@JoinColumns({
  @JoinColumn(name="CUSTOMERCONTACT",
    referencedColumnName="CUSTOMER_NUMBER") // referencedColumnName es obligatorio
})
private PersonaContactoCliente personaContactoCliente;

Type de Hibernate CharBooleanType no funciona (Hibernate 3.6)

Entidades con @DiscriminatorColumn arroja errores (Hibernate 3.6)

@Entity
@Table(name = "`TABLAS`")
@DiscriminatorColumn(name="ID",
        discriminatorType=DiscriminatorType.STRING,
        length=20)
 

@Entity
@Table(name = "`TABLES`")
@DiscriminatorColumn(name="ID",
        discriminatorType=DiscriminatorType.STRING,
        length=20)
@DiscriminatorOptions(insert = false) // Anotacion dependiente de Hibernate
 

Método getProperty() renombrado en ModuleTestBase

String host = getProperty("host"); // Hasta v4m5
// Tiene que cambiarse por
String host = getXavaJUnitProperty("host"); // A partir de v4m6

Para migrar de OpenXava 4m4 a OpenXava 4m5

El controlador Navigation no se añade automáticamente

<modulo nombre="CambiarPrecioProducto">
  <modelo nombre="Producto"/>
  <controlador nombre="Navigation"/>  <!-- Has de añadir esto -->
  <controlador nombre="CambiarPrecioProducto"/>
</modulo>

Nuevo modo split (partido) - Cambios en jUnit

String [] listActions = {
  "Print.generatePdf",
  "Print.generateExcel",
  "CRUD.new",
  "CRUD.deleteSelected",
  "Mode.detailAndFirst",
  "Mode.split", // HAS DE AÑADIR ESTO
  "List.filter",
  "List.customize",
  "List.orderBy",
  "List.viewDetail",
  "List.hideRows",
};
assertActions(listActions);

defaultModeController=DetailList

// execute("Mode.list"); // NO si defaultModeController=DetailList en xava.properties
execute("DetailList.list"); // SÍ si defaultModeController=DetailList en xava.properties

Nueva acción CRUD.deleteRow - Cambios en jUnit

// execute("CRUD.deleteSelected", "row=2"); // NO, desde 4m5
execute("CRUD.deleteRow", "row=2"); // SI

La vista (View) no es editable por defecto

public class MiAccionBuscar extends ViewBaseAction {
 
  public void execute() throws Exception {
    ...
    getView().setKeyEditable(false);  // Has de llamar a setKeyEditable()
    getView().setEditable(true);      // y setEditalbe() explicitamente
    ...
  }
 
}

Para migrar de OpenXava 4m3 a OpenXava 4m4

CRUD.search ahora usa un diálogo - Cambios en jUnit

setValue("codigo", "1");
execute("CRUD.search");
assertValue("descripcion", "Número uno");