Enregistrer des paramètres de rendu publics prédéfinis dans portlet.xml

Pour utiliser ces paramètres de rendu publics prédéfinis dans votre portlet, déclarez chacun d'eux dans le descripteur de déploiement de portlet (portlet.xml) comme indiqué dans la spécification de portlet Java.

L'exemple suivant montre comment enregistrer les paramètres qui contiennent les informations de sélection de page du portail et de l'environnement local. Dans ce cas, le mappage de préfixe pour l'espace de nom du portail est défini sur l'élément portlet-app racine du descripteur de déploiement.

Remarque : Le portlet lui-même n'a pas besoin de traiter les noms qualifiés de ces paramètres de rendu dans son implémentation. Il peut utiliser des identificateurs locaux qui sont définies dans le cadre de l'élément de paramètre de rendu public respectif à la fin du descripteur. Dans ce cas, le paramètre de sélection de page est mappé sur l'identificateur local pageID alors que le paramètre d'environnement local est mappé sur l'identificateur local locale.

Exemple de code :

<?xml version="1.0" encoding="UTF-8"?>
<portlet-app id="my.sample.portlet"
     xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd"
     xmlns:portal="http://www.ibm.com/xmlns/prod/websphere/portal/publicparams"
     version="2.0">
     <portlet>
          <portlet-name>My sample portlet</portlet-name>
          ...
          <supported-public-render-parameter>pageID</supported-public-render-parameter>
          <supported-public-render-parameter>locale</supported-public-render-parameter>
     </portlet>
     <public-render-parameter>
          <identifier>pageID</identifier>
          <qname>portal:selection</qname>
     </public-render-parameter>
     <public-render-parameter>
          <identifier>locale</identifier>
          <qname>portal:locale</qname>
     </public-render-parameter>
</portlet-app>