La Bible du développeur Alfresco : guide du développeur Alfresco (1re édition)

X. FRONT-END WEB D'ALFRESCO: DÉVELOPPEMENTS JSF▲

X-A. Généralités sur le Front-end JSF Alfresco▲

La couche présentation d'Alfresco est bâtie sur une technologie JSF avec l'implémentation standard Apache MyFaces.

La couche présentation d'Alfresco est développée dans les règles de l'art et sa compréhension demande un certain niveau de maîtrise du développement d'application web JSF.

La couche présentation fournit plusieurs mécanismes et frameworks facilitant sa customisation, le développement de nouveaux composants et l'implémentation d'interfaces d'interaction avec le Back-end. Nous allons dans ce chapitre présenter les différentes briques internes du Front-end en commençant par faire une description brève des différents backed-beans.

X-B. Les principaux beans managés du Front-End▲

X-B-1. LoginBean▲

C'est le backed-bean de la vue « login.jsp ». Cette vue fournit le formulaire à utiliser pour saisir les données de login de l'utilisateur. LoginBean contient des méthodes pour valider les données du formulaire, ainsi que des méthodes qui agissent en tant que « listener » sur l'évènement déclenché (ici c'est actionEvent) quand le bouton de login est pressé. L'action exécutée lorsque le bouton est pressé est la méthode login(). Cette méthode procède à l'authentification de l'utilisateur grâce au service AuthentificationService du Backend.

Sélectionnez

<tr>
     <td colspan=2 align=right>
         <h:commandButton id="submit" 
                          action="#{LoginBean.login}" 
                          value="#{msg.login}" />
     </td>
</tr>

Il est possible de customiser ce Bean afin d'ajouter des traitements dans le processus de login. Un excellent exemple utilisant ce Bean est l'exemple CustomLogin disponible dans le SDK Alfresco.

X-B-2. BrowseBean▲

Ce backed-Bean fournit les propriétés et comportements utiles pour la vue de navigation dans les dossiers et fichiers et dans les vues de recherche. Parmi les vues de navigation, c'est-à-dire celles qui permettent de visualiser l'arborescence des dossiers et fichiers, nous pouvons citer : « browse.jsp », « category-browse.jsp » et « dashboard.jsp ». Les vues de recherches sont : « advanced-search.jsp », « edit-search.jsp », « save-search.jsp ».

Les propriétés fournies pas le backed-Bean sont :
- Le document courant : il s'agit du document en cours de traitement ou de consultation ;
- Des propriétés utilisées pour la disposition des composants sur la vue ;
- Les nœuds parents du nœud courant ;
- Les nœuds en cours de traitement ;

Comme traitement, on peut citer :
- Faire une recherche simple ;
- Mettre à jour l'apparence de la vue d'affichage ;
- Exécuter des actions et des actions de suppression ;

En général il n'est pas nécessaire de customiser ce Bean.

X-B-3. NavigationBean▲

Les habitués de JSF savent que le flow des requêtes est orchestré par un composant de navigation de base JSF. Il est possible de customiser ce composant afin d'implémenter une logique de navigation entre les vues conforme à son problème.

Le NavigationBean fournit l'accès et le management de la navigation entre les vues. Entre autres, il permet d'indiquer le nœud courant sur lequel la navigation est réalisée, il permet d'obtenir la localisation de l'exploration (path de la localisation), il permet d'obtenir un pointeur vers des nœuds principaux comme les nœuds représentants l'espace de l'entreprise, l'espace invité. Il fournit l'ensemble des OUTCOME de navigation usuelle.

En général il n'est pas nécessaire de customiser ce Bean.