JSF - Plusieurs fichiers de config

Avec JSF, les fichiers de configuration peuvent être relativement costauds. Il n'est pas rare de voir des fichiers avec plusieurs centaines de beans, autant de règles de navigation, sans compter les converters, les validators, les bundles de messages... Il est donc parfois utile de pouvoir exploser le fichier faces-config.xml en plusieurs. C'est en fait extrêmement simple, il suffit de rajouter les fichiers séparés par des virgules dans la propriété "javax.faces.CONFIG_FILES" du fichier web.xml.

    <context-param>
        <param-name>javax.faces.CONFIG_FILES</param-name>
        <param-value>/WEB-INF/faces-application.xml,/WEB-INF/faces-beans.xml,/WEB-INF/faces-navigation.xml</param-value>
    </context-param>

C'est tout simple, mais ça simplifie la gestion des règles.

Maven - native2ascii

native2ascii est un outil fourni avec le jdk permettant de convertir des fichiers contenant des caractères natifs vers un fichier "unicode" (les caractères non ascii du nouveau fichier seront sous la forme "\udddd").
Il existe un plugin maven permettant d'effectuer cette conversion. Malheureusement, il n'est pas très pratique. Par défaut, il ne convertit que les fichiers issus du répertoire "src/main/native2ascii" et curieusement les fichiers convertis ne sont pas inclus dans le jar. De plus, il n'y a pas de "token replacement" ce qui peut poser problème. Il faut donc régler ça de façon à ce que d'une part nous puissions convertir nos fichiers de ressources après le remplacement des tokens, et d'autre part pouvoir inclure le fichier converti dans le jar (ou le war).
La première étape est de paramétrer le plugin au niveau du pom parent. Nous allons avoir besoin du plugin antrun.
Dans le pom parent :

    <properties>
        <native2ascii.includes>**/*.properties</native2ascii.includes>
        <native2ascii.encoding>UTF-8</native2ascii.encoding>
    </properties>

    <build>
        <pluginManagement>
            <plugins>
                <plugin>
                    <artifactId>maven-antrun-plugin</artifactId>
                    <inherited>true</inherited>
                    <dependencies>
                        <dependency>
                            <groupId>sun</groupId>
                            <artifactId>tools</artifactId>
                            <version>1.5.0</version>
                            <scope>system</scope>
                            <systemPath>${java.home}/../lib/tools.jar</systemPath>
                        </dependency>
                    </dependencies>
                </plugin>
                <plugin>
                    <groupId>org.codehaus.mojo</groupId>
                    <artifactId>native2ascii-maven-plugin</artifactId>
                    <inherited>true</inherited>
                    <dependencies>
                        <dependency>
                            <groupId>sun</groupId>
                            <artifactId>tools</artifactId>
                            <version>1.5.0</version>
                            <scope>system</scope>
                            <systemPath>${java.home}/../lib/tools.jar</systemPath>
                        </dependency>
                    </dependencies>
                </plugin>
            </plugins>
        </pluginManagement>
    </build>

La propriété "native2ascii.encoding" indique l'encoding des fichiers sources, l'autre propriété nous permet d'indiquer les fichiers à convertir. Notez qu'il faut inclure rt.jar dans le path.
Dans le pom ou la conversion doit avoir lieu :

    <build>
        <plugins>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>native2ascii-maven-plugin</artifactId>
                <inherited>true</inherited>
                <executions>
                    <execution>
                        <phase>process-resources</phase>
                        <goals>
                            <goal>native2ascii</goal>
                        </goals>
                        <configuration>
                            <encoding>${native2ascii.encoding}</encoding>
                            <dest>/target/native2ascii</dest>
                            <src>/target/classes</src>
                            <includes>${native2ascii.includes}</includes>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <artifactId>maven-antrun-plugin</artifactId>
                <inherited>true</inherited>
                <executions>
                    <execution>
                        <id>native2ascii</id>
                        <phase>process-resources</phase>
                        <goals>
                            <goal>run</goal>
                        </goals>
                        <configuration>
                            <tasks>
                                <copy
                                    todir="${basedir}/target/classes"
                                    overwrite="true">
                                    <fileset
                                        dir="${basedir}/target/native2ascii" />
                                </copy>
                                <delete
                                    dir="${basedir}/target/native2ascii" />
                            </tasks>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

L'idée est de convertir les fichiers de target/classes, qui auront été copiés par maven et où le "token replacement" aura eu lieu. Ensuite, nous récupérons les fichiers convertis pour remplacer les fichiers existants dans la tâche ant. Ainsi les fichiers seront correctement inclus dans le jar/war.

JSF - Téléchargement de fichier

Un petit bout de code tout simple, permettant de lancer le téléchargement d'un fichier sur le poste du client suite à une action.

public final void exportData(final String _fileName, final byte[] _data) throws IOException {
        final HttpServletResponse response = FacesContext.getCurrentInstance().getExternalContext().getResponse();
        response.setContentType("application/pdf");
        response.setHeader("Content-Disposition", "attachment;filename=" + _fileName + ".pdf");

        response.setContentLength(_data.length);

        response.getOutputStream().write(_data);
        FacesContext.getCurrentInstance().renderResponse();
        FacesContext.getCurrentInstance().responseComplete();
    }

L'idée est de modifier le contenu et le type de la response. En spécifiant un "attachement;filename=Y" on va demander au navigateur de télécharger le fichier de nom Y. Le content type doit être celui du fichier.