Gracias a un compañero he descubierto como agregar formatos a la lista del asistente.
En el directorio <JDEVELOPER_HOME>\jdev\system\oracle.BC4J.xx.xx.xx.xx.xx hay un fichero llamado formatinfo.xml. Ese fichero lleva por cada dominio de datos una serie de formatos que son los que sacará el asistente. Por ejemplo, en el caso de oracle.jbo.domain.Date que es lo que suelo usar para las fechas viene esto:

   <DOMAIN CLASS="oracle.jbo.domain.Date">
      <FORMATTER name="Simple Date" class="oracle.jbo.format.DefaultDateFormatter">
         <FORMAT text="yyyy-MM-dd" />
         <FORMAT text="yyyy-MM-dd G 'at' hh:mm:ss"  />
         <FORMAT text="EEE, MMM d, ''yy"  />
      </FORMATTER>
   </DOMAIN>

Dentro de la etiqueta FORMATTER está la lista de formatos que ofrecerá el asistente. Agregando mi formato preferido en la zona superior queda así:

   <DOMAIN CLASS="oracle.jbo.domain.Date">
      <FORMATTER name="Simple Date" class="oracle.jbo.format.DefaultDateFormatter">
         <FORMAT text="dd/MM/yyyy" />
         <FORMAT text="yyyy-MM-dd" />
         <FORMAT text="yyyy-MM-dd G 'at' hh:mm:ss"  />
         <FORMAT text="EEE, MMM d, ''yy"  />
      </FORMATTER>
   </DOMAIN>

Y de esta manera el asistente muestra el formato preferido el primero de la lista.

Importante: rearrancar el JDeveloper para que los cambios tengan efecto.
La documentación oficial puede leerse aquí: Defining a Formatter and Format Masks for ADF Business Components Clients.

• a) Encerrar el include dentro de la etiqueta de jsf <f:subview>.
• b) Encerrar los grupos de etiquetas de html puro y duro dentro de la etiqueta de jsf <f:verbatim>.

Bueno, todo esto está mejor explicado en el artículo de JavaWorld Getting around JSF: The role of JSP y en el propio tutorial de Sun Setting Up a Page.
Lamentablemente, aún no he descubierto por qué se renderizan mal los includes que hago que contienen etiquetas ADF Faces.

Al final debería haber un árbol de objetos de modelo como éste:

Ahora crearemos una clase de utilidad con el método de ejemplo que he tomado y retocado de iAdvise:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

package com.tsoracle.util;
 
import java.io.IOException;
import java.io.PrintWriter;
 
import java.util.Date;
 
import javax.faces.context.FacesContext;
 
import javax.servlet.http.HttpServletResponseWrapper;
 
import oracle.adf.model.binding.DCIteratorBinding;
 
import oracle.jbo.Row;
import oracle.jbo.RowSetIterator;
 
 
/**
 * tsoracle.com
 * Clase de utilidades de transformación
 */
public class TransformUtil {
 
    public TransformUtil() {
    }
 
    /**
     * Método tomado y adaptado de iAdvise, de su artículo 
     * "Export ADF Table To Excel" del 11 de Abril de 2007. http://iadvise.blogspot.com/2007/04/export-adf-table-to-excel.html
     * Este método coge una tabla ADF cualquiera y devuelve al usuario su contenido
     * en una hoja excel
     * 
     * @param tableContent Tabla con el contenido
     * @throws IOException 
     */
    public static void exportHtmlTableToExcel(DCIteratorBinding tableContent) throws IOException {
 
        //Set the filename DateTime dt = new
        Date ahora = new Date();
 
        // El nombre habría que tratar de hacerlo pseudoúnico de una mara más fina
        String filename = ahora.toString() + ".csv";
 
 
        //Setup the output 
        String contentType = "application/vnd.ms-excel";
        FacesContext fc = FacesContext.getCurrentInstance();
        HttpServletResponseWrapper response = 
            (HttpServletResponseWrapper)fc.getExternalContext().getResponse();
        response.setHeader("Content-disposition", 
                           "attachment; filename=" + filename);
 
        response.setContentType(contentType);
        PrintWriter out = response.getWriter();
 
        // Obtengo el iterador de la tabla
        RowSetIterator rsi = tableContent.getRowSetIterator();
 
        String[] attNames = rsi.getRowAtRangeIndex(0).getAttributeNames();
 
        // Pinta el título de las columnas
        for (int i = 0; i < attNames.length; i++) {
 
            out.print(attNames[i] + ";");
 
        }
 
        out.println();
 
        // Obtengo el índice del registro actual
        Row filaSeleccionada = rsi.getCurrentRow();
 
        // Me posiciono en el primer registro
        rsi.first();
 
        Row currentRow;
        // Itero por todas las filas
        while ((currentRow = rsi.getCurrentRow()) != null) {
            Object[] attValues = currentRow.getAttributeValues();
 
            // Recorro cada columna y escribo su valor
            for (int j = 0; j < attValues.length; j++) {
 
                out.print(attValues[j] + ";");
 
            }
 
            out.println();
 
            // Muevo el iterador hacia delante
            rsi.next();
        }
        out.close();
 
        // Finaliza el fichero
        fc.responseComplete();
 
        // Vuelvo a dejar al iterador posicionado donde lo encontré, para evitar errores
        // de "cambio de divisa"
        rsi.setCurrentRow( filaSeleccionada );
 
    }
 
}

El siguiente paso es crear una nueva página y arrastrar sobre ella el objeto de vista como una ADF Read Only Table:

Ahora creamos un nuevo CommandButton en el footer de la tabla:

Lo siguiente es colocarse sobre el inspector de propiedades del botón y pinchar sobre los puntos suspensivos del ActionListener:

Entonces aparece un asistente preguntándonos bean y método. Creamos un nuevo bean (AdfTable2ExcelPageBean) y dentro de él un nuevo método (exportToExcel). Al final en la propiedad ActionListener tendremos el valor #{AdfTable2ExcelPageBean.exportToExcel}:

Antes de seguir hay que agregar la propiedad bindings al código de la clase del bean:

1
2
3
4
5
6
7
8
9
10
11
12

/**
 * Variable que contiene los bindings
 */
protected BindingContainer bindings;
 
public void setBindings(BindingContainer bindings) {
    this.bindings = bindings;
}
 
public BindingContainer getBindings() {
    return bindings;
}

Y tampoco podemos olvidarnos de inicializar la variable en el fichero faces-config.xml:

1
2
3
4
5
6
7
8
9

  <managed-bean>
    <managed-bean-name>AdfTable2ExcelPageBean</managed-bean-name>
    <managed-bean-class>com.tsoracle.adftable2excel.view.backing.AdfTable2Excel</managed-bean-class>
    <managed-bean-scope>request</managed-bean-scope>
    <managed-property>
      <property-name>bindings</property-name>
      <value>#{bindings}</value>
    </managed-property>
  </managed-bean>

O si lo preferimos, podemos hacerlo con los asistentes que nos proporciona el entorno. Primero creamos un nuevo managed value:

Y luego, pinchando sobre el botón Edit, el valor:

Ahora queremos que el método que hemos creado en el ActionListener obtenga el iterador de la tabla y se lo pase a la función estática. Tenemos que ver en primer lugar cómo se llama el iterador. Para ello pulsamos con el botón derecho sobre una zona vacía de la página y le damos a Go to Page Definition:

Luego buscamos el iterador:

Y nos quedamos con su nombre:

Ahora ya podemos rellenar el código del método exportToExcel, tal como se explica en iAdvise:

1
2
3
4
5
6

/**
 * Método que transforma los datos de la tabla a excel.
 */
public void exportToExcel(ActionEvent actionEvent) throws IOException {
    TransformUtil.exportHtmlTableToExcel((DCIteratorBinding)bindings.get("EmployeesView1Iterator"));
}

Finalmente ejecutamos y probamos el botón:

Por si a alguien le interesa he subido el ejemplo. Después de descomprimirlo es necesario copiar las librerías adf-faces-impl.jar, jsf-impl.jar a WEB-INF/lib: AdfTable2Excel.zip.

JAVA_OPTS="-XX:+PrintGCDetails -XX:MaxPermSize=500m"

Lo de PrintGCDetails agrega información sobre el estado de la memoria a los logs del tomcat.
Todo esto lo hice (como siempre) sin tener mucha idea de qué significa cada cosa. Ahora he pasado a la fase dos: “Exception in thread “TP-Processor2″ java.lang.OutOfMemoryError: Heap space”. Así que me puse a buscar la mejor manera de optimizar la memoria y encontré un artículo muy interesante donde explica los conceptos de manera secilla y clara. Será más útil para aquellos que gocen del privilegio de tener un OC4J: Java & Memory in an iAS environment. Leyéndolo fue como descubrí que con el MaxPermSize sólo estoy aumentando el máximo de memoria “permanent generation”. Intenté aumentar también el tamaño del Heap con los parámetros -Xms y -Xmx, que entiendo que se refiere al total (joven + vieja + permanente).

-XX:+PrintGCDetails -XX:PermSize=64m -XX:MaxPermSiz
e=500m -Xms256m -Xmx512m -server

El parámetro -server hace que la máquina virtual se comporte de manera optimizada para servidor. Tarda más en arrancar al principio pero se supone que luego va mejor.
Un compañero me pasó la url de la documentación oficial de Sun Tuning the Java Runtime System. Gracias a ella ahora comprendo los mensajes de log del recolector de basura que quedan como consecuencia del parámetro PrintGCDetails. Explica también otro problema que me surgió después. Cuando el recolector se llena al máximo el servidor tiene que vaciarlo. En mi caso tardaba algo más de cinco segundos, lo que provocaba fallos en las aplicaciones. Así que he agregado a la lista de parámetros estos dos:

-XX:+UseConcMarkSweepGC -XX:SoftRefLRUPolicyMSPerMB=1

Se supone que esto cambia el algoritmo de recolección de basurilla haciendo que se limpie más a menudo y con un menor coste de tiempo.
El parámetro SoftRefLRUPolicyMSPerMB indica el ratio de segundos de vida por mega libre en el heap. Al poner el parámetro -server la JVM ajusta este ratio para retardar lo máximo posible la recolección. De ahí que no me hubiera pasado antes. Encontré unas FAQs que explicaban la función de este parámetro en Sun Developer Network. Si he comprendido bien el concepto, un valor de 1000 en este parámetro indica que si mi heap es de 500M y me quedan libres 250M los objetos del recolector tendrán 250 segundos de vida.
El parámetro UseConcMarkSweepGC parece que pone a trabajar u tipo específico de recolector de basura denominado concurrent low pause collector. He encontrado los distintos tipos de recolector descritos en www.javafaq.nu.