Migration de JSF 1.2 vers JSF 2.0


136

Je travaille avec une application assez volumineuse écrite en JSF 1.2 . JSF 1.2 a environ 6 ans maintenant. J'ai besoin de passer à JSF 2.0. À quel point ce sera douloureux? J'ai remarqué que certains attributs des balises personnalisées ont été modifiés, etc.

Réponses:


245

Douleur

La difficulté de la mise à niveau de JSF 1.2 vers 2.0 dépend de la technologie d'affichage que vous utilisez actuellement et que vous souhaitez utiliser.

  • JSP 2.x à JSP 2.x = Presque aucun effort.
  • Facelets 1.x à Facelets 2.0 = Peu d'effort.
  • JSP 2.x à Facelets 2.0 = Beaucoup d'efforts. Doublez-le si vous avez également des composants personnalisés.

Modifications de base

Quel que soit le changement de technologie d'affichage, au moins les étapes suivantes doivent être effectuées:

  • Retirez les fichiers JAR JSF 1.2 de /WEB-INF/lib(le cas échéant).
  • Déposez les fichiers JAR JSF 2.0 dans /WEB-INF/lib(si JSF 1.2 était fourni par servletcontainer, vous souhaiterez peut-être modifier la politique de chargement de classes pour charger les bibliothèques d'applications Web avant les bibliothèques servletcontainer, voir également Problèmes de chargement de classes JSF2 dans les serveurs d'applications ).
  • Mettez à jour la déclaration racine de faces-config.xmlpour se conformer aux spécifications JSF 2.0.

    <faces-config
        xmlns="http://java.sun.com/xml/ns/javaee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd"
        version="2.0">
    

    Remarque: lorsque vous utilisez JSF 2.2 ou plus récent, utilisez le http://xmlns.jcp.orgdomaine d'espace de noms au lieu de http://java.sun.comtout le fragment XML ci-dessus.

  • Assurez-vous que la déclaration racine de web.xmlest déjà conforme au moins à Servlet 2.5. JSF 2.0 ne fonctionnera pas sur 2.4 ou version antérieure ( bien qu'il soit piratable ).

    <web-app 
        xmlns="http://java.sun.com/xml/ns/javaee"
        xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
        id="YourWebappID"
        version="2.5">
    

    Remarque: lorsque vous utilisez Servlet 3.0 ou une version plus récente, utilisez le http://xmlns.jcp.orgdomaine de l' espace de noms au lieu de http://java.sun.comtout l'extrait de code XML ci-dessus.


JSP 2.x à JSP 2.x

Si vous utilisez JSP 2.x et que vous souhaitez continuer à l' utiliser, vous n'avez fondamentalement pas besoin de changer quoi que ce soit d'autre.

Mise à niveau progressive

Si vous utilisez déjà un suffixe url-patternpour le FacesServlet, comme *.jsf, alors il est bon de savoir que le FacesServletrecherchera d'abord le *.xhtmlfichier et s'il n'est pas présent, le recherchera ensuite *.jsp. Cela vous permet de convertir progressivement de JSP en Facelets en coulisses sans changer les URL.

Mais si vous utilisez un préfixe url-pattern, comme /faces/*et que vous souhaitez progressivement passer de JSP à Facelets, vous devez vraiment le changer en *.jsfet éventuellement aussi tous les liens dans les pages JSP existantes.

Il vous suffit de garder à l'esprit que la nouvelle navigation implicite fournie par JSF 2.0 ne recherche pas la présence du fichier, elle ira de outcome.xhtmltoute façon. Donc, si vous voulez venir ou aller vers *.jsp, vous devez toujours l'inclure dans le viewid de la manière JSF 1.x.


Facelets 1.x à Facelets 2.0

Si vous utilisez Facelets 1.x comme technologie d'affichage et que vous souhaitez utiliser les Facelets 2.0 fournis par JSF 2.0 , vous devez suivre les étapes supplémentaires suivantes:

  • Supprimer Facelets 1.x JAR de /WEB-INF/lib.
  • Supprimer Facelets 1.x FaceletViewHandlerde faces-config.xml.
  • Toute FaceletViewHandlerimplémentation personnalisée doit être mise à jour pour être étendue à la ViewHandlerWrapperplace.
  • Pas nécessaire, mais juste pour le nettoyage, supprimez toutes les <context-param>valeurs liées à Facelets 1.x web.xmlqui sont déjà par défaut dans Facelets 2.0, comme la javax.faces.DEFAULT_SUFFIXvaleur with de *.xhtml.
  • Mettre à jour la déclaration racine des XML de taglib Facelet existants pour se conformer à Facelets 2.0.

    <facelet-taglib 
        xmlns="http://java.sun.com/xml/ns/javaee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facelettaglibrary_2_0.xsd"
        version="2.0">
    

    Remarque: lorsque vous utilisez JSF 2.2 ou plus récent, utilisez le http://xmlns.jcp.orgdomaine d'espace de noms au lieu de http://java.sun.comtout le fragment XML ci-dessus.

Cela devrait être essentiellement cela.


JSP 2.x vers Facelets 2.0

Si vous utilisez JSP 2.x comme technologie de visualisation et que vous souhaitez passer immédiatement à Facelets 2.0 , vous devez effectuer de nombreux changements avant que le site ne puisse être mis en ligne. Vous changez fondamentalement la technologie d'affichage ici.

Modifications de la page maître

Sur chaque page maître, vous devez modifier le modèle JSP de base suivant.

<%@page contentType="text/html" pageEncoding="UTF-8"%>
<%@taglib prefix="f" uri="http://java.sun.com/jsf/core"%>
<%@taglib prefix="h" uri="http://java.sun.com/jsf/html"%>
<!DOCTYPE html>
<f:view>
    <html lang="en">
        <head>
            <title>JSP page</title>
        </head>
        <body>
            <h:outputText value="JSF components here." />
        </body>
    </html>
</f:view>

..au modèle de base de Facelets suivant:

<!DOCTYPE html>
<html lang="en"
    xmlns="http://www.w3.org/1999/xhtml"
    xmlns:f="http://java.sun.com/jsf/core"
    xmlns:h="http://java.sun.com/jsf/html"
    xmlns:ui="http://java.sun.com/jsf/facelets">
    <h:head>
        <title>XHTML page</title>
    </h:head>
    <h:body>
        <h:outputText value="JSF components here." />
    </h:body>  
</html>

Remarque: lorsque vous utilisez JSF 2.2 ou plus récent, utilisez le http://xmlns.jcp.orgdomaine de l' espace de noms au lieu de l' http://java.sun.comensemble des extraits XHTML ci-dessus.

Inclure les modifications de page

Si vos pages JSP existantes sont bien conçues, vous ne devriez avoir aucune ligne de code de scriptlet et vous ne devriez également avoir que <jsp:include>la seule balise spécifique à JSP. Chacun de ceux-ci doit être changé de:

<jsp:include page="include.jsp" />

à

<ui:include src="include.xhtml" />

Le JSP de base inclut un modèle de page de ..

<%@page contentType="text/html" pageEncoding="UTF-8"%>
<%@taglib prefix="f" uri="http://java.sun.com/jsf/core"%>
<%@taglib prefix="h" uri="http://java.sun.com/jsf/html"%>
<f:subview id="include">
    <h:outputText value="JSF components here." />
</f:subview>

..doit être remplacé par le modèle de page d'inclusion de Facelets de base suivant:

<ui:composition
    xmlns="http://www.w3.org/1999/xhtml"
    xmlns:f="http://java.sun.com/jsf/core"
    xmlns:h="http://java.sun.com/jsf/html"
    xmlns:ui="http://java.sun.com/jsf/facelets">
    <h:outputText value="JSF components here." />
</ui:composition>

Remarque: lorsque vous utilisez JSF 2.2 ou plus récent, utilisez le http://xmlns.jcp.orgdomaine de l' espace de noms au lieu de l' http://java.sun.comensemble des extraits XHTML ci-dessus.

Modifications des composants personnalisés

Vous devez changer les fichiers JSP TLD en fichiers Facelets TLD comme décrit dans ce guide de migration Mojarra .


Conséquences

Quelle que soit l'approche de migration, vous pouvez progressivement éliminer le faces-config.xmlpar les nouvelles annotations JSF 2.0 ou même CDI . Tout <managed-bean>peut être annoté par @ManagedBean:

@ManagedBean(name="managedBeanName")
@RequestScoped
public class SomeBean {}

À côté @RequestScoped, il y a aussi @ViewScoped, @SessionScopedet @ApplicationScopeddisponibles. Si vous omettez l' nameattribut de @ManagedBean, il sera par défaut classname avec le premier caractère en minuscule.

@ManagedBean
@RequestScoped
public class SomeBean {}

Dans cet exemple particulier, ce sera le cas #{someBean}.

Tout <managed-property>peut être annoté en utilisant @ManagedProperty:

@ManagedProperty("#{otherBean}")
private OtherBean otherBean;

Tout <validator>peut être annoté en utilisant @FacesValidator:

@FacesValidator("someValidator")
public class SomeValidator implements Validator {}

Tout <converter>peut être annoté à l'aide de@FacesConverter

@FacesConverter("someConverter")
public class SomeConverter implements Converter {}

Tout <renderer>peut être annoté à l'aide de@FacesRenderer

@FacesRenderer(componentFamily="someComponentFamily", rendererType="someRendererType")
public class SomeRenderer extends Renderer {}

Tout <navigation-case>ce qui utilise le nom de fichier de la page XHTML comme les deux <from-outcome>et <to-view-id>peut être supprimé car cela sera fait implicitement . Cela peut être fait progressivement en modifiant toutes les valeurs de résultat pour qu'elles correspondent au nom de fichier de la vue cible.

Enfin, tout bean à portée de session qui a été placé dans la session avec la seule raison de conserver les données du bean dans les demandes suivantes dans le même onglet / fenêtre peut mieux être marqué @ViewScoped, car de cette façon le bean ne sera pas affecté lorsque l'utilisateur final s'ouvre la même page dans différents onglets / fenêtres.


Bibliothèques de composants

Notez que je ne prends pas en compte les bibliothèques de composants tiers comme PrimeFaces / RichFaces / IceFaces dans cette réponse, il serait alors impossible d'écrire une réponse fiable car elle se résume essentiellement à "ça dépend". En général, il suffit de simplement mettre à niveau la bibliothèque de composants vers une version compatible JSF 2.0, vérifiée par eux-mêmes, conformément à leurs instructions. Le mieux est de simplement écrire des tests unitaires, de les exécuter avant et après la mise à niveau et de résoudre les problèmes individuellement.

Voici au moins quelques liens utiles concernant la migration de la bibliothèque de composants spécifiques:

PrimeFaces n'a pas de guide de migration pour PrimeFaces 1.x à 2.x car PrimeFaces 1.x nécessite déjà Facelets 1.x, il vous suffit donc de suivre les étapes de migration de Facelets 1.x à 2.x. Cependant, il existe un guide de migration PrimeFaces 2.x vers 3.x (et supérieur) qui peut également s'appliquer lors de la migration de PrimeFaces 1.x vers 3.x (ou supérieur). Tomahawk n'a pas non plus de guide de migration. Fondamentalement, les seuls que vous devez modifier sont les JAR et si nécessaire, supprimez toutes les <t:saveState>références sur un bean à portée de requête en rendant la vue de bean étendue.


@ManagedBean (name = "managedBeanName") @RequestScoped It is :)
Daniel Szalay

super message, m'a beaucoup aidé. Quelque chose à noter: lorsque vous passez de jsf 1.2 à jsf 2, vous pouvez être presque certain que les gens ont utilisé a4j de richfaces 3.3.x. J'ai décidé d'utiliser richfaces 3.3.3 avec jsf 2 car cela semblait être un changement médiocre à effectuer pour mettre à niveau vers richfaces 4.x. J'ai donc fait votre guide (annulé toutes les choses liées aux facettes dans faces-config (le gestionnaire de vue activé a supprimé l'annotation taglig), puis j'ai suivi community.jboss.org/wiki/RichFaces333AndJSF20 et j'ai finalement dû faire ce stackoverflow.com/questions/85532/…
Toskan

Très bonne réponse. Dans mon cas, j'ai également dû définir le javax.faces.VALIDATE_EMPTY_FIELDSparamètre sur falsepour obtenir la validation triée. Voir aussi: stackoverflow.com/questions/6113935/…
Jasper de Vries

2
Je peux également recommander à tout le monde de lire balusc.blogspot.nl/2011/09/communication-in-jsf-20.html
Jasper de Vries

1
@Cfold: J'ai corrigé le lien.
BalusC


6

JSF 2.0 a de nombreuses nouvelles fonctionnalités et composants et je ne pense pas que la migration sera pénible. Le seul domaine que vous trouverez difficile est d'utiliser des bibliothèques de tiers. Si votre application dépend fortement de bibliothèques telles que Richfaces, vous serez confronté à un problème. Tous les composants de Richfaces 3 ne sont pas portés vers Richfaces 4.

Cela peut également aider la migration de l'application JSF 1.2 vers JSF 2.0

Vérifiez également ceci. Quoi de neuf dans JSF 2?


Cela aurait été la même chose lorsque vous utilisiez Richfaces avec JSF 1.x - vous passiez par toutes les «difficultés» pour savoir comment intégrer des composants tiers avec JSF. L'approche de JSF 2.x ne fait aucune différence. C'est la "joie" de la programmation, n'est-ce pas? :)
ChuongPham

4

Web.xml

 Add the jars
    1. jsf-api-2.0.jar 
    2. jsf-impl.2.0.2.jar

Étape 1: Changez web.xml

<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
            xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
            id="WebApp_ID" version="2.5">


    <servlet>
            <servlet-name>facesServlet</servlet-name>
            <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
            <load-on-startup>1</load-on-startup>
        </servlet>

        <servlet-mapping>
            <servlet-name>facesServlet</servlet-name>
            <url-pattern>/faces/*</url-pattern>
        </servlet-mapping>
        <servlet-mapping>

            <servlet-name>facesServlet</servlet-name>
            <url-pattern>*.jsf</url-pattern>
        </servlet-mapping>

        <servlet-mapping>
            <servlet-name>facesServlet</servlet-name>
            <url-pattern>*.faces</url-pattern>
        </servlet-mapping>

        <servlet-mapping>
            <servlet-name>facesServlet</servlet-name>
        <url-pattern>*.xhtml</url-pattern>
        </servlet-mapping>

Étape 2: webmvc-config.xml

<!-- Handles requests mapped to the Spring Web Flow system -->
    <bean id="flowController" class="org.springframework.webflow.mvc.servlet.FlowController">
        <property name="flowExecutor" ref="flowExecutor" />
        <property name="ajaxHandler">
            <bean class="org.springframework.faces.webflow.JsfAjaxHandler" />
        </property>
</bean>

Étape 3: facess-config.xml

<faces-config xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd" version="2.0">

0

Si vous utilisez Apache Trinidad, vous devrez également le mettre à niveau vers la version 2.0 afin qu'il prenne en charge JSF 2.0. Il y a plus d'informations sur Hacker's Valhalla .

En utilisant notre site, vous reconnaissez avoir lu et compris notre politique liée aux cookies et notre politique de confidentialité.
Licensed under cc by-sa 3.0 with attribution required.