openxava / documentación / Migración a v6.x

assertValue("date", "5/25/21");

assertValue("date", "5/25/2021");

setConditionValues("1");
execute("List.filter"); // Esto no graba "Código = 1" automáticamente

// Aquí haces más cosas

selectListConfiguration("Código = 1"); // FALLA EN v6.5

setConditionValues("1");
execute("List.filter"); 

execute("List.saveConfiguration"); // AÑADE ESTAS LÍNEAS PARA GRABAR...
execute("SaveListConfiguration.save"); // ...LA CONSULTA EXPLÍCITAMENTE

// Aquí haces más cosas

selectListConfiguration("Código = 1"); // Ahora funciona

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

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");

execute("CRUD.search"); // Muestra un diálogo
setValue("codigo", "1");
execute("Search.search"); // Hace la búsqueda y cierra el diálogo
assertValue("descripcion", "Número uno");

setValue("numero", "1");
execute("CRUD.refresh"); // En lugar de CRUD.search
assertValue("descripcion", "Número uno");

Para migrar de OpenXava 4m2 a OpenXava 4m3

MapFacade.getValues() incluye el nombre del modelo en el resultado

Map valores = MapFacace.getValues("Persona", clave, miembros);
valores.remove(MapFacade.MODEL_NAME); // Puede que necesites esta línea

Método Classes.getSimpleName() eliminado

Classes.getSimpleName(laClase);

laClase.getSimpleName();

Para migrar de OpenXava 4m1 a OpenXava 4m2

Atributos mostrar-dialogo y ocultar-dialogo quitados de <accion/>

Las colecciones usan diálogos para editar, ver y añadir detalles - Cambios en acciones

public class MiAccionDetalleParaColeccion extends ViewBaseAction  {
 
    public void execute() throws Exception {
        ...
        getView().setValue("nombre", "Pepe"); // Ahora getView() es la vista del diálogo
        getPreviousView().setValue("nombre", "Pepe"); // getPreviousView() es la vista
                                                      // que ha abierto el diálogo
        closeDialog();
    }
}
 

Las colecciones usan diálogos para editar, ver y añadir detalles - Cambios en jUnit

// lineas es el nombre de la colección
setValue("lineas.cantidad", "6");  // Ahora ¡INCORRECTO! Has de quitar 'lineas'
setValue("cantidad", "6"); // ¡CORRECTO! Sin nombre de colección

execute("Collection.save", "viewObject=xava_view_section1_lineas"); // ¡INCORRECTO!
execute("Collection.save"); // ¡CORRECTO!

execute("Factura.editarLinea", "row=1,viewObject=xava_view_section1_details");
assertValue("cantidad", "234");
closeDialog(); // Necesario antes de ejecutar CRUD.save
execute("CRUD.save");

execute("Collection.save"); // Esto cierra el diálogo
execute("Collection.new", // Es necesario llamar a 'new' de nuevo, para abrir el diálogo
  "viewObject=xava_view_section1_lineas");

execute("Collection.new",
  "viewObject=xava_view_lugaresEntrega_recepcionistas"); // ¡INCORRECTO!
execute("Collection.new",
  "viewObject=xava_view_recepcionistas"); // ¡CORRECTO! Solo el nombre de la
                                          // última colección anidada

// ¡INCORRECTO!: Usando "lugaresEntrega.recepcionistas", el nombre calificado
setConditionValues("lugaresEntrega.recepcionistas", new String[] { "J" } );
execute("List.filter", "collection=lugaresEntrega.recepcionistas");
assertCollectionRowCount("lugaresEntrega.recepcionistas", 1);
assertValueInCollection("lugaresEntrega.recepcionistas", 0, 0, "JUAN");
 
// ¡CORRECTO!: Usando "recepcionistas", el nombre simple
setConditionValues("recepcionistas", new String[] { "J"} );
execute("List.filter", "collection=recepcionistas");
assertCollectionRowCount("recepcionistas", 1);
assertValueInCollection("recepcionistas", 0, 0, "JUAN");

Acción de fila para las colecciones de entidades es por defecto view y no edit

// Solo para colecciones de entidades sin @AsEmbedded
execute("Collection.edit",
  "row=0,viewObject=xava_view_clientes"); // ¡INCORRECTO! 'edit' ya no se usa
execute("Collection.view",
  "row=0,viewObject=xava_view_clientes"); // ¡CORRECTO! Ahora es la acción
                                          // 'view' la que se usa

// Dentro de un diálogo que visualiza el elemento de colección
assertEditable("numero"); // ¡INCORRECTO! Los campos clave no son editable
execute("Collection.remove"); // ¡INCORRECTO! 'remove' no está disponible

Para migrar de OpenXava 3.1.4 a OpenXava 4m1

BaseAction implementa IModuleContextAction

public class MiAccion extends BaseAction implements IModuleContextAction {
    public void setContext(ModuleContext context) {
        super.setContext(context);  // Tienes que añadir esta línea
        this.context = context;
    }
}

Objeto de sesión xava_currentReferenceLabel eliminado

<controlador nombre="MiReferencia">
    <accion nombre="buscar" oculta="true"
        mostrar-dialogo="true"
        clase="org.openxava.test.acciones.BuscarMiReferencia"
        imagen="images/search.gif">
        <usa-objeto nombre="xava_view"/>
        <usa-objeto nombre="xava_referenceSubview"/>
        <!-- Esta línea se tiene que quitar
        <usa-objeto nombre="xava_currentReferenceLabel"/>
        -->
        <usa-objeto nombre="xava_tab"/>
    </accion>
</controlador>

Para migrar de OpenXava 3.1.3 a OpenXava 3.1.4

Esquema de tabla de AccessTracking cambiado

• USER ahora es USER_NAME

Para migrar de OpenXava 3.1.1 a OpenXava 3.1.2/3.1.3

Para migrar de OpenXava 3.1 a OpenXava 3.1.1

La generación de ids para elementos HTML ha cambiado para soportar multimódulo por página

execute("Albaran.generarNumero", "xava.keyProperty=xava.Albaran.numero");

execute("Albaran.generarNumero", "xava.keyProperty=numero");

HtmlImage imagen = (HtmlImage)
  page.getHtmlElementsByName("xava.Formula.ingredientes.imagen").get(0);

HtmlImage imagen = (HtmlImage)
  page.getHtmlElementsByName(decorateId("ingredientes.imagen")).get(0);

Para migrar de OpenXava 3.0.3 a OpenXava 3.1

El código JavaScript de los editores tiene que moverse desde los JSPs a custom-editors.js

<script>
function muestraMapa(v) {
  ...
}
</script>
 
<!-- Aquí código JSP -->

if (openxava == null) var openxava = {};
if (openxava.editors == null) openxava.editors = {};
 
// mapaGoogleEditor
if (openxava.editors.mapaGoogle== null) openxava.editors.mapaGoogle= {};
openxava.editors.mapaGoogle.muestraMapa = function(v){
  ...
}
 

<input ... onclick="muestraMapa(valor)"/>

<input ... onclick="openxava.editors.mapaGoogle.muestraMapa(valor)"/>

Llamar al método View.refreshCollections() cuando se modifiquen los datos de una colección

// No es una acción de una colección
public class TraducirTodosNombresTransportistas extends ViewBaseAction {
 
    public void execute() throws Exception {
        for (Iterator it=Transportista.findAll().iterator(); it.hasNext(); ) {
            Transportista t = (Transportista) it.next();
            t.traducir(); // El transportista se modifica,
                // estos datos se muestran en una colección de la vista
        }
        getView().refreshCollections(); // Para refrescar los datos de
            // las colecciones visualizadas
    }
 
}

Más librerías necesarias en MANIFEST.MF (solo para EJB2)

Para migrar de OpenXava 3.0.2 a OpenXava 3.0.3

HttpUnit reemplazado por HtmlUnit para las pruebas junit usando ModuleTestBase

Es obligado usar argumentos exactos para execute()

execute("Reference.search", "keyProperty=xava.Transportista.almacen.codigoZona");

Los métodos allowDuplicateSubmit() y click() han sido eliminados

allowDuplicateSubmit();
click("MiControlador.miAccion");

execute("MiControlador.miAccion");

El método getForm() devuelve un HtmlForm

El método getConversation() reemplazado por getWebClient()

Uso más fácil de setConditionValue

String [] condicion= { " ", "", "", "V" };
setConditionValues(condicion);

String [] totalCondition = { "", "", "", "V" };
setConditionValues(totalCondition);

Para migrar de OpenXava 3.0.1 a OpenXava 3.0.2

Mensaje de objeto no encontrado incluye valores de la clave de búsqueda (para pruebas junit)

assertError("No encontrado el objeto de tipo Factura con es clave");

assertError("No encontrado el objeto de tipo Factura con clave Año:2008, Número:1");

Ya no se usa Hibernate para las preferencias de usuario

Para migrar de OpenXava 3.0 a OpenXava 3.0.1

Las anotaciones de validación ahora son restricciones de Hibernate Validator

@Entity
public class Cliente {
 
    @Required
    private int codigo;
 
    @Required
    private String nombre;
 
    @Required
    private String observaciones;
 
    ...
 }

Cliente c = new Cliente();
c.setCodigo(1);
c.setNombre("JUANITO");
// Dejamos la propiedad observaciones vacía
XPersistence.getManager().save(c);
XPersistence.commit();

Ligera mejora en la acción 'new' de CRUD

execute("Sections.change", "activeSection=2");
...
execute("CRUD.new");
setValue("propiedadEnSeccion2", "el valor"); // Esta propiedad está en la sección 2

execute("Sections.change", "activeSection=2");
...
execute("CRUD.new");
// Tenemos que añadir la siguiente línea, porque después de 'new' estamos en la sección 0
execute("Sections.change", "activeSection=2");
setValue("propiedadEnSeccion2", "el valor"); // Esta propiedad está en la sección 2
 

Para migrar de OpenXava 2.2.5 a OpenXava 3.0

El proveedor de persistencia por defecto es JPA

persistenceProviderClass=org.openxava.model.impl.HibernatePersistenceProvider

MapFacade ya no lanza RemoteException

try {
    MapFacade.validate("Factura", valores);
}
catch (RemoteException ex) {
    ...
}

try {
    MapFacade.validate("Factura", valores);
}
catch (SystemException ex) {
    ...
}

Para migrar de OpenXava 2.2.4 a OpenXava 2.2.5

MapFacade no es autocommit a partir de ahora

MapFacade.create("Cliente", valoresCliente);
MapFacade.create("Factura", valoresFactura);

mapFacadeAutoCommit=true

MapFacade.create("Cliente", valoresCliente);
MapFacade.commit();
MapFacade.create("Factura", valoresFactura);
MapFacade.commit();

Para migrar de OpenXava 2.2.3 a OpenXava 2.2.4

El esquema para table de imagenes del estereotipo GALERIA_IMAGENES

images.table=XAVATEST.IMAGES

images.schema=XAVATEST
images.table=IMAGES

Para migrar de OpenXava 2.2.2 a OpenXava 2.2.3

Las etiquetas del modo lista y colecciones son calificadas (para las pruebas junit)

assertLabelInList(2, "Nombre"); // de cliente.nombre

assertLabelInList(2, "Nombre de Cliente"); de cliente.nombre

Esquema de tabla de AccessTracking cambiado

• TABLE ahora es TABLE_NAME
• DATE ahora es ACCESS_DATE
• TIME ahora es ACCESS_TIME

Para migrar de OpenXava 2.2.1 a OpenXava 2.2.2

Para migrar de OpenXava 2.2 a OpenXava 2.2.1

MoneyFormatter (para pruebas junit)

assertValue("importe", "20");

assertValue("importe", "20.00");

Acción 'Mode.list" no está disponible cuando el usuario navega a otra vista (para pruebas junit)

execute("Reference.createNew", "model=Family2,keyProperty=xava.Product2.family.number");
assertAction("Mode.list"); // Desde 2.2.1 falla

Para migrar de OpenXava 2.1.5 a OpenXava 2.2

El comportamiento por defecto para las colecciones de entidades cambia

execute("Collection.new", "viewObject=xava_view_customers");
setValue("customers.number", getCustomerNumber2());
assertValueIgnoringCase("customers.name", getCustomer2().getName());
assertCollectionRowCount("customers",0);
execute("Collection.save", "viewObject=xava_view_customers");
assertCollectionRowCount("customers",1);

assertCollectionRowCount("customers",0);
execute("Collection.add", "viewObject=xava_view_customers");
assertValueInList(5, 0, getCustomer2().getName());
execute("AddToCollection.add", "row=5");
assertMessage("1 element(s) added to Customers of Seller");
assertCollectionRowCount("customers",1);

execute("Collection.new", "viewObject=xava_view_customers");
setValue("customers.number", getCustomerNumber1());
assertValueIgnoringCase("customers.name", getCustomer1().getName());
assertCollectionRowCount("customers", 0);
execute("Collection.save", "viewObject=xava_view_customers");
assertMessage("Customer associated to Seller");
 
assertCollectionRowCount("customers", 1);
setValue("customers.number", getCustomerNumber2());
assertValueIgnoringCase("customers.name", getCustomer2().getName());
execute("Collection.save", "viewObject=xava_view_customers");
assertCollectionRowCount("customers",2);

execute("Collection.add", "viewObject=xava_view_customers");
assertValueInList(4, 0, getCustomer1().getName());
assertValueInList(5, 0, getCustomer2().getName());
checkRow(4);
checkRow(5);
execute("AddToCollection.add");
assertMessage("2 element(s) added to Customers of Seller");
assertCollectionRowCount("customers",2);

El comportamiento por defecto para las colecciones de agregados cambia

execute("Collection.save", "viewObject=xava_view_section1_details");
execute("Collection.new", "viewObject=xava_view_section1_details"); // A borrar

execute("Collection.save", "viewObject=xava_view_section1_details");

Para migrar de OpenXava 2.1.4 a OpenXava 2.1.5

Para migrar de OpenXava 2.1.3 a OpenXava 2.1.4

Nuevas acciones en colecciones (para pruebas junit)

        String [] acciones = {
            "Navigation.previous",
            "Navigation.first",
            "Navigation.next",
            "CRUD.new",
            "CRUD.save",
            "CRUD.delete",
            "CRUD.search",
            "Collection.new",
            "Collection.removeSelected"
        };
        assertActions(acciones);

    String [] acciones = {
            "Navigation.previous",
            "Navigation.first",
            "Navigation.next",
            "CRUD.new",
            "CRUD.save",
            "CRUD.delete",
            "CRUD.search",
            "Collection.new",
            "Collection.removeSelected",
            "List.filter",        // Nuevo
            "List.orderBy",       // Nuevo
            "List.customize",     // Nuevo
            "List.hideRows",      // Nuevo
            "Print.generatePdf",  // Nuevo
            "Print.generateExcel" // Nuevo
        };
        assertActions(acciones);

Tarea Ant generarPortlets eliminada

<target name="generarPortlets">
    <ant antfile="../OpenXava/build.xml" target="generarPortlets"/>
</target>

<target name="generarPortlets">
    <ant antfile="../OpenXava/build.xml" target="generatePortlets"/>
</target>

Para migrar de OpenXava 2.1 a OpenXava 2.1.3

Pruebas JUnit y claves sin valor interpretadas como cero

public void testAlgo() throws Exception {
  assertValue("codigo", "");
  execute("MiControlador.miAccion"); // Esto no cambia el valor de 'codigo'
  assertValue("codigo", "0"); // porque OX interpreta una cadena vacía como un 0 (hasta 2.1.2)
  ...
}

public void testAlgo() throws Exception {
  assertValue("codigo", "");
  execute("MiControlador.miAccion"); // Esto no cambia el valor de 'codigo'
  assertValue("codigo", ""); // porque ahora (desde 2.1.3) OX interpreta cadena vacía como nulo
  ...
}

Para migrar de OpenXava 2.0.4 a OpenXava 2.1

Proyectos WebSphere

<session-factory>
  <property
    name="hibernate.connection.datasource">@datasource.prefix@/@datasource@</property>
  <property name="hibernate.dialect">@hibernate.dialect@</property>
  <property name="hibernate.jdbc.use_get_generated_keys">false</property>
  <property name="hibernate.show_sql">false</property>
  @hibernate.properties@
  ...
</session-factory>

hibernate.properties=<property name="hibernate.transaction.manager_lookup_class">\n\
\t\t\torg.hibernate.transaction.WebSphereTransactionManagerLookup\n\
\t\t</property>\n\
\t\t<property name="transaction.factory_class">\n\
\t\t\torg.hibernate.transaction.JTATransactionFactory\n\
\t\t</property>

Otros cambios que requieren migración

• La tarea ant wtpBuild ha sido quitada de OX; podemos usar la tarea 'reconstuir' en su lugar. Llamar automáticamente a una tarea ant desde el Builder de Eclipse es lento, por tanto puede ser preferible llamar manualmente a la tarea ant 'reconstruir' bajo demanda (cuando el código XML de nuestra aplicación cambie).

Para migrar de OpenXava 2.0.3 a OpenXava 2.0.4

Parse de valores numéricos

• La interfaz gráfica de la aplicación visualizar campos vacíos en vez de 0, cuando el formulario se reinicie.
• En el test junit puede ser que recibas un blanco donde antes recibías un 0
• Si usas View.getValue() para un Number puede valer null

Cambios en las API

• Dates.clonWithoutTime() se ha renombrado a Dates.cloneWithoutTime()

Para migrar de OpenXava 2.0.2 a OpenXava 2.0.3

No se lanzan eventos al-cambiar cuando se busca

Establece valor para referencías (en combos) con clave múltiple en las pruebas JUnit

Para migrar de OpenXava 2.0.1 a OpenXava 2.0.2

Para migrar de OpenXava 2.0 a OpenXava 2.0.1

Para migrar de OpenXava 1.2.1 a OpenXava 2.0

Establece valor para referencías (en combos) con clave múltiple en las pruebas JUnit

PermisoConduccionKey clave = new PermisoConduccionKey();
clave.setType("C ");
clave.setLevel(1);
setValue("drivingLicence.KEY", clave.toString());

PermisoConduccion clave = new PermisoConduccion();
clave.setType("C ");
clave.setLevel(1);
setValue("drivingLicence.KEY", clave.toString());

Hibernate: Referencias con columnas no nula como clave foránea

Cambiar la sección activa

IAggragetOidCalculator

Para migrar de OpenXava 1.2 a OpenXava 1.2.1

Generación Hibernate

• Crea la carpeta hibernate en tu proyecto.
• Crea el archivo hibernate.cfg.xml dentro de la carpeta hibernate.

<!DOCTYPE hibernate-configuration PUBLIC
  "-//Hibernate/Hibernate Configuration DTD//EN"
  "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
 <hibernate-configuration>
  <session-factory>
   <property
    name="hibernate.connection.datasource">@datasource.prefix@/@datasource@</property>
   <property name="hibernate.dialect">@hibernate.dialect@</property>
   <property name="hibernate.show_sql">false</property>
  </session-factory>
</hibernate-configuration>

hibernate.dialect=org.hibernate.dialect.HSQLDialect

Sintaxis XML de OpenXava

• En español PEQUEÑA pasa a ser PEQUENA. Para evitar problemas con ISO-8859-1 y UTF-8.

Para migrar de OpenXava 1.1 a OpenXava 1.2

Código generado

• Borrar todo el código generado
• Regenerar el código EJB
• Compilar
• Buscar y corregir los errores de sintaxis

Cliente cliente = ClienteUtil.getHome().findByNombre("PEPE");
String nombre = cliente.getNombre();

ICliente cliente = ClienteUtil.getHome().findByNombre("PEPE");
String nombre = cliente.getNombre();

Cliente cliente = ClienteUtil.getHome().findByNombre("PEPE");
ClienteKey key = cliente.getPrimaryKey();

ClienteRemote cliente = ClienteUtil.getHome().findByNombre("PEPE");
[[controllers_es#toc15|mostrar un diálogo]]ClienteKey key = cliente.getPrimaryKey();

Pruebas JUnit

• Al borrar un objeto en a mantenimiento ahora OpenXava muestra una ventana javascript para confirmar, en vez de cambiar a otro controlador. Por lo tanto en tus pruebas para borrar un objeto en un módulo de mantenimiento solo necesitas usar execute("CRUD.delete"). En este caso 'Sí' como respuesta de confirmación.

Otros

• Cambia el nombre packages-ejb.properties en gen-src-xava a packages.properties (o simplemente borrar packages-ejb.properties y regenera código).

Para migrar de OpenXava 1.0 a OpenXava 1.1

APIs

• MetaView.getMetaViewCollection pasa a llamarse MetaView.getMetaCollectionView
• MetaView.getMetaViewReference pasa a llamarse MetaView.getMetaReferenceView

Pruebas junit

• Se cambia el mensaje 'Objeto borrado satisfactoriamente' por '{0} borrado satisfactoriamente'. Así es necesario cambiar los asserts de este mensaje.