Interface SPI de l'accesseur

L'interface SPI de l'accesseur permet un accès par saisie au modèle de document d'état. Elle permet au programmeur d'interroger et de modifier les informations d'état de navigation. L'interface SPI de l'accesseur fait partie du module com.ibm.portal.state.accessors.*

L'interface SPI de l'accesseur est une couche abstraite entourant l'accès à certains noeuds du modèle de document hiérarchisé. Pour plus de détails sur le modèle de document hiérarchique, voir Modèle d'objet. Pour chaque aspect d'un état comme par exemple, l'état de sélection de page, l'état d'expansion et l'état de portlet, l'interface SPI propose une classe d'ID d'accès. Cette classe fournit des contrôles d'accesseur en lecture seule ou en lecture-écriture conçus pour l'aspect d'état correspondant. Les accesseurs lisent à partir des positions respectives du modèle de document d'état, ou y écrivent, et exécutent les conversions de type requises.

Les informations d'état de navigation se trouvent dans le modèle de document d'état et sont disponibles lorsque la classe d'ID d'accès est utilisée. Une fois que le noeud est localisé, la classe d'ID d'accès transmet sa référence à l'accesseur ou au contrôleur d'accesseur. Ces derniers sont indépendants de la structure du modèle de document ; vous pouvez réutiliser des accesseurs même si les informations sont déplacées sur un autre noeud du document d'état.

final EngineURL url = ...;
final SelectionAccessorFactory selectionFct = ...;

final SelectionAccessorController selectionCtrl = 
    selectionFct.getSelectionAccessorController(url.getState());

try {
    selectionCtrl.setSelection("wps.StockMarket");
} catch (StateException e) {
    // include error handling here
} finally {
    selectionCtrl.dispose();
}