Sous-modules de la SPI du modèle

Sous-module com.ibm.portal.admin

WebSphere Portal fournit plusieurs modèles de liste contenant des informations sur les ressources installées, telles que les langues, les marquages, les habillages et les thèmes pris en charge. Pour chacune de ces ressources une interface ListModel fournit des informations sur ces ressources. Ce module définit plusieurs modèles de liste :

• Modèle de liste Langue
• Modèle de liste Marquage
• Modèle de liste Habillage
• Modèle de liste Thème
• Modèle de classe d'unités

Chaque modèle de liste contient des éléments qui implémentent des interfaces correspondant à leur nom : le modèle de liste langue renferme des éléments de langue. Le modèle de liste de marquage comporte des éléments de marquage. Le modèle de liste d'habillage comporte des éléments d'habillage. Le modèle de liste de thème comporte des éléments de thème et le modèle de classe d'unité des éléments de classe d'unité.

La liste de langues contient toutes les langues prises en charge par le portail. MarkupList contient tous les marquages que le portail prend généralement en charge. A partir de ces modèles de liste il se peut qu'une ressource prenne en charge uniquement une sélection. SkinList et ThemeList contiennent les thèmes et les habillages installés pour le portail. DeviceClassModel contient les classes d'appareil que le portail prend généralement en charge.

Sous-module com.ibm.portal.content

Actuellement, les élémens du modèle de contenu peuvent être des pages, des libellés ou des URL. Il existe une interface ContentNode spécifique pour chaque type : ContentPage, ContentLabel et ContentURL. Différentes informations sont associées à chaque noeud de contenu.

Chaque noeud de contenu peut fournir le type de noeud de contenu qu'il représente ; si ce type est ContentNodeType.PAGE, il existe un modèle représentant la disposition de cette page. Il peut être obtenu à l'aide de la méthode getLayoutModel du modèle de contenu. Le modèle de présentation contient des éléments LayoutNode qui décrivent la disposition et le contenu de la page. Chaque noeud de mise en page peut renvoyer des unités de mesure dans l'interface de LayoutMetrics. Il peut décrire des attributs du noeud tels que la largeur ou l'orientation (horizontale/verticale).

Les éléments du modèle de mise en page sont des éléments LayoutContainers qui définissent des lignes ou des colonnes, ou des éléments LayoutControls, qui représentent des portlets. Ces informations sont utilisées lorsqu'une page est affichée.

L'illustration suivante indique comment des informations sur la disposition d'une page et le contenu d'une page sont représentés. Elle représente une page avec trois portlets. Les conteneurs verticaux et horizontaux environnants définissent la mise en page, alors que les contrôles contiennent les portlets qui fournissent le contenu réel présenté à l'utilisateur.

Les noeuds de contenu peuvent fournir des métadonnées via l'interface com.ibm.portal.MetaDataProvider. Ces métadonnées peuvent être utilisées pour associer des informations arbitraires à un noeud de contenu. Le modèle de métadonnées de contenu fournit une vue sur les métadonnées des noeuds dans le modèle de contenu. Les métadonnées des noeuds individuels sont agrégées dans un objet métadonnées à l'aide de la hiérarchie de noeuds, comme décrit dans le modèle de contenu.

La figure ci-dessous montre la relation entre les métadonnées affichées par noeud de contenu et la vue agrégée fournie par le modèle de métadonnées de contenu :

Les métadonnées des différents noeuds de contenu apparaissent dans les scripts XML Access à l'aide de la balise <parameter>.

Sous-module com.ibm.portal.identification

Ce module contient l'interface Identification qui permet la conversion entre les objets ObjectID et leur représentation sous forme de chaîne. Cette interface Identification est requise lorsqu'un ID objet doit être transmis comme paramètre uniquement sous forme de chaîne (pour l'inclusion dans des URL, par exemple). Vous pouvez récupérer une implémentation de cette interface à l'aide d'une recherche JNDI, comme indiqué dans l'exemple suivant.

try
{
   Context ctx = new InitialContext();
   Name ctxName = new CompositeName("portal:services/Identification");    
   Identification identification = (Identification) ctx.lookup(ctxName);    
   String serializedOID = identification.serialize(aOID);
 
      ...

   ObjectID anotherOID = identification.deserialize(serializedOID);
}
catch (SerializationException sx)
{
   // some error handling code here
}
catch (NamingException nx)
{
   // some error handling code here
}

Sous-module com.ibm.portal.navigation

Ce module définit le modèle de navigation (NavigationModel) qui représente une vue du modèle de contenu utilisé pour la navigation. Comme décrit dans la section Sous-module com.ibm.portal.content, la topologie du modèle de navigation correspond au modèle de contenu. Chaque noeud du modèle de contenu a un noeud de navigation équivalent au même niveau hiérarchique.

Les éléments du modèle de navigation sont NavigationNodes. Chacun de ces noeuds peut référencer un ContentNode. Les noeuds de navigation ont un titre fourni par l'interface Localized. L'illustration suivante montre la connexion entre le modèle de navigation et le modèle de contenu.

La figure montre comment les noeuds du modèle de navigation peuvent référencer un noeud dans le modèle de contenu.

Lorsqu'un utilisateur navigue dans le portail, le noeud de navigation sélectionné est important pour l'affichage de la page en cours. Le modèle NavigationSelectionModel affiche la sélection en cours et présente une liste définissant un chemin à travers le modèle de navigation.

La figure montre comment le modèle de sélection de navigation définit un chemin à travers le modèle de navigation.

Le dernier noeud de ce chemin est toujours le noeud de navigation sélectionné. Son noeud de contenu référencé représente les éléments agrégés visibles par l'utilisateur (généralement un page représentée via un objet ContentPage).

Sous-module com.ibm.portal.portletmodel

Sous-module com.ibm.portal.wire