SPI pristupnik
SPI pristupnik osigurava klasificirani pristup modelu dokumenta stanja. On dozvoljava programeru da postavlja upite i mijenja informacije o navigacijskom stanju. SPI pristupnik je dio paketa com.ibm.portal.state.accessors.*.
SPI pristupnik je apstraktni sloj koji okružuje pristup određenim čvorovima u modelu hijerarhijskog dokumenta. Za više informacija o modelu hijerarhijskog dokumenta, pogledajte Model objekta. Za svaki aspekt stanja, ali ne i nužno limitirano, kao što je izbor stranice, stanja proširivanja i stanja portleta, SPI nudi tvornicu pristupnika. Tvornica pristupnika osigurava kontrole pristupnika koje su samo za čitanje i za čitanje i pisanje i koje su oblikovane za određeni aspekt stanja na koji se odnose. Pristupnici čitaju iz ili pišu na odgovarajuće pozicije u modelu dokumenta stanja i obavljaju potrebne tipove konverzija.
Informacije o navigacijskom stanju su u modelu dokumenta stanja i dostupne su kada se koristi tvornica pristupnika. Nakon što se pronađe čvor, tvornica pristupnika predaje uputu o čvoru pristupniku ili kontroleru pristupnika. Pristupnik i kontroler pristupnika su neovisni o strukturi modela dokumenta stanja; možete ponovno koristiti pristupnike čak ako se informacija premjestila na drugi čvor dokumenta stanja.
- SelectionAccessor getSelectionAccessor(StateHolder)
- Ova metoda vraća sučelje SelectionAccessor, koje dozvoljava čitanje informacija o izboru stranice iz StateHolder.
- SelectionAccessorController getSelectionAccessorController(StateHolderController)
- Ova metoda vraća SelectionAccessorController sučelje, koje dozvoljava programerima da mijenjaju informacije o izboru stranice. Shodno tome, kontroler koristi StateHolderController sučelje za promjenu navigacijskog stanja.
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();
}
Upotreba SelectionAccessorController za kreiranje veze na stranicu
Osnovno sučelje Pristupnika se izvodi iz com.ibm.portal.Disposable sučelja. Pokrenite metodu dispose() da biste naznačili kada pristupnik više nije potreban. Upotreba metode dispose() dozvoljava tvornici pristupnika da pohranjuje pristupnike i kontrolere pristupnika u spremišta objekata da bi se postigle bolje performanse ( uslijed manje inicijalizacije i opterećenja skupljanjem otpada).
- SelectionAccessorFactory
- SelectionAccessorFactory sadrži pristupnike za čitanje i pisanje informacija o izboru stranice portala. Za kreiranje URL-a koji ukazuje na drugu stranicu, SelectionAccessorController treba biti zatražen od strane tvornice, da bi se novi izbor uključio u stanje kojem je pridružen kreiran EngineURL .
- PortletAccessorFactory
- PortletAccessorFactory sadrži pristupnike za čitanje i pisanje informacija o navigacijskom stanju portleta, što uključuje način portleta, stanje prozora i parametre prikaza. Posebno, PortletAccessorController može se koristiti za promjenu navigacijskog stanja portleta (na primjer, način rada portleta).
- PortletTargetAccessorFactory
- PortletTargetAccessorFactory sadrži pristupnike za čitanje i pisanje informacija vezanih uz akcije portleta. Posebno, PortletAccessorController se može koristiti za deklariranje portleta kao cilja akcije. Ova akcija dozvoljava programeru kreiranje URL-ova koji pokreću akcije portleta.
- SoloAccessorFactory
- SoloAccessorFactory sadrži pristupnike za čitanje i pisanje takozvanog Solo stanja. Ako je portal u Solo stanju, on prikazuje samo određeni portlet trenutne stranice; sve navigacijske kontrole i trake s alatima su skrivene. SoloAccessorController se može koristiti za kreiranje URL-ova koji aktiviraju/deaktiviraju Solo stanje određenog portleta.
- ThemeTemplateAccessorFactory
- ThemeTemplateAccessorFactory podržava čitanje i pisanje informacija o temi predloška. Posebno, ThemeTemplateAccessorController se može koristiti za kreiranje URL-ova za prijelaz na određeni predložak po temi.
- LocaleAccessorFactory
- LocaleAccessorFactory sadrži pristupnike
za čitanje i pisanje informacija o lokalizaciji. LocaleAccessorController može se
koristiti za postavku specijalnih lokalizacija u navigacijsko stanje pa tako i
u URL.Bilješka: Lokalizacija dohvaćena iz takvog URL-a ima prednost nad korisnički preferiranim lokalizacijama ili lokalizacijama koje su definirane na pretražitelju.
- ExpansionStatesAccessorFactory
- ExpansionStatesAccessorFactory sadrži pristupnike za čitanje i pisanje informacija o stanju proširenja; na primjer, za određivanje da li je navigacijski čvor u kontroli navigacijskog stabla proširen ili srušen. ExpansionStatesAccessorController se obično koristi za generiranje URL-a koji mijenjaju stanje proširenja navigacijskog čvora.
- ShowToolsAccessorFactory
- ShowToolsAccessorFactory sadrži pristupnike za čitanje i pisanje informacija vezanih uz alate. ShowToolsAccessorController se obično koristi za kreiranje URL-a koji se spaja s ikonama alata za prozore portleta nudeći funkcije kao što su premještanje/ brisanje odnosnog portleta.
- StatePartitionAccessorFactory
- StatePartitionAccessorFactory sadrži pristupnike za čitanje i pisanje identifikatora raspodjele stanja. StatePartitionAccessorController se mogu koristiti za uključivanje identifikatora raspodjele stanja u navigacijsko stanje. Novi particioniranje raspodjele stanja uključuje se u URL-ove koji otvaraju prozore pretražitelja ili iFrameove.
- EngineActionAccessorFactory
- EngineActionAccessorFactory sadrži kontrolere koji se
koriste za kreiranje strojnih akcija URL-ova. EngineActionAccessorController,
posebno, dozvoljava postavku parametara akcija.Bilješka: EngineActionAccessorFactory ne nudi pristupnika koji je samo za čitanje jer portal upravlja akcijama stroja.