Figura 1: schema del modello CORBA

L'utilizzo del NOI attraverso Java è stato introdotto da Puliti in Mokabyte di Giugno 1999.
Un'applicazione Java consentirà a computer privi del Notes Client di accedere agli stessi dati semplicemente aggiungendo NCSO.JAR e NOTES.JAR al CLASSPATH.
Ovviamente questi accessi saranno regolati dalle rigorose politiche di accesso dei server Domino.
Alcune note per l'installazione dell'ambiente. Per consentire all'applet di interagire con l'ORB implementato nella R5, occorre fare tre cose, entrambe importanti: avviare l'ORB, consentire le connessioni IIOP e includere le classi CORBA nell'applet attraverso il Designer.
Avviare l'ORB è molto semplice: posso aggiungere DIIOP ai ServerTasks nel NOTES.INI (immagine notesini.gif) o scrivere il comando LOAD DIIOP nella console Domino.
 
 
 

Figura 2: file di configurazione notes.ini. Si noti la riga relativa ai task da attivaer al momenot dell'inizializzazione del server

In questo modo si attiva il demone dell'IIOP (l'ORB) e la porta 63148 si pone in attesa di connessioni. Ora non resta che stabilire chi potrà accedere a questa posta attraverso la voce IIOP nella cartella Security
 
 

Figura 3: finestra di configurazione del servizio IIOP

In questo caso ho usato * per indicare che tutti possono accedere al DIIOP esclusivamente a scopo di test: solitamente si definisce un ACL che contiene l'utente Anonymous per le richieste da Internet.
Infine per inserire le classi CORBA client all'interno dell'applet, è necessario spuntare l'opzione "Applet uses Notes CORBA Classes" nelle proprietà dell'applet .
 
 
 

Figura 4: impostazione delle proprietà del client

Torniamo al NOI. La radice dell'Object Model di Notes è rappresentato dall'oggetto Session. Instanziandolo, sono in grado di accedere ai database, da questi alle viste e così via.
 
 

Figura 5: schema della architettura di NOI

Un piccolo esempio di applicazione Java stand alone che visualizza il nome dell'utente e del database su di una macchina priva del Notes client ma dotata dei file NCSO.JAR e NOTES.JAR:
 

import java.lang.*; 
import java.util.*; 
import lotus.notes.*;
public class DatiMinimi { 
    public static void main(String argv[]) 
        {
        try {

            NotesThread.sinitThread();
            Session s = Session.newInstance();
  System.out.println("Utente corrente: " + s.getUserName());
            Database db = s.getDatabase("", "names.nsf");
System.out.println("Nome database: " + db.getTitle());
            }
        catch (Exception e) {e.printStackTrace();}
        finally 
        {
    System.out.println("Chiusura connessione...");
    NotesThread.stermThread();
    }
        }
}  // end class

Lanciando questa applicazione da riga di comando verrà visualizzato il nome dell'utente e del database dei contatti personali.
Per maggiori dettagli, è possibile scaricare il Domino Toolkit for Java versione 2.0 dal sito Lotus dedicato agli sviluppatori: www.lotus-developer.com.
Oppure è possibile fare riferimento al Domino and Java Technology Learning Center di Lotus (http://waterworks.lotus.com/wwbpp/javatlc.nsf/).
 
 
 

LiveConnect

document.esempio.sfondo = "yellow".

Combinando LiveConnect con le funzionalità CORBA, ottengo un'altra delle features particolarmente interessanti della R5: l'accesso ai dati Domino attraverso JavaScript.
In altre parole, posso visualizzare e modificare il contenuto di documenti Notes ottenendo i dati direttamente dal server senza richiedere singolarmente ogni dato così come era necessario fare nelle versioni 4.x.
Nel dettaglio le informazioni viaggiano in questo modo: viene inserita nella pagina HTML un applet che crei il ponte IIOP con il server. Per far ciò è sufficiente derivare la classe AppletBase e inserire fra gli archivi NCSO.JAR: un'operazione molto rapida all'interno del Domino Designer come già visto in precedenza. (immagine PinPointDesigner.gif)
 
 

Figura 7: Notes Designer in azione per la definizione delle funzionalità del client

Grazie a LiveConnect, invoco via JavaScript il metodo openSession() dell'applet. In questo modo ho istanziato sul browser un oggetto Session e ho aperto un canale di comunicazione con il server Domino.
Ora non mi resta che utilizzare la NOI così come avrei fatto in una normale applicazione Java: infatti, se assumo di creare una pagina HTML con un applet chiamata PinPoint, l'esempio precedente può funzionare in un browser invece che in un'applicazione Java stand alone.
Sarà sufficiente scrivere una funzione JavaScript come questa:
 

function DatiMinimi { 
var dominoAccessApplet = document.PinPoint; 
 var sessione = dominoAccessApplet.openSession();
alert("Utente corrente: " + session.getUserName());
var db = session.getDatabase("", "names.nsf");
alert("Nome database: " + db.getTitle());
alert("Chiusura connessione...");
 dominoAccessApplet.closeSession(session);
}

Associando questa funzione, ad esempio, alla pressione di un tasto, accadono diverse cose interessanti.
Per prima cosa alla variabile sessione viene associato un oggetto Session sul server con il quale comunicare tramite CORBA; l'applet ha aperto il canale di comunicazione grazie al metodo openSession.
Ora, grazie a LiveConnect, posso chiamare gli stessi metodi che abbiamo visto in precedenza come se avessi un accesso locale al NOI.
Quindi uso il metodo getUserName dell'oggetto Session per visualizzare il nome dell'utente in una finestra alert e così via.
 
 
 

Infobus

Per visualizzare i dati della nostra campagna vendite, utilizzeremo una delle applet distribuite con la eSuite ma come faremo a trasformare le informazioni giunte al browser via CORBA in parametri del grafico?
Utilizzeremo InfoBus, una serie di Java API che consentono la cooperazione fra componenti come i JavaBeans o le  applets di scambiarsi dati in modo dinamico. Senza entrare nei dettagli di questa tecnologia, per i quali vi rimandiamo all'articolo di Chiarelli nel Mokabyte di Maggio 1999, InfoBus stabilisce le regole di comunicazione fra applets e JavaBeans basandosi sul concetto di produttori e consumatori.
Ad esempio se abbiamo due applet su di una pagina HTML, una può comunicare dati all'altra pubblicandoli sull'InfoBus sotto forma di data item divenendo produttrice mentre la seconda, in ascolto sull'InfoBus, diviene consumatrice. Ogni applet contenuta nel DevPack può essere sia consumatore che produttore.
Esistono diversi tipi di data item: nel nostro caso utilizzeremo un array bidimensionale che riporti la tabella con i dati relativi alle vendite.
Occorrerà quindi un applet che sia in grado di fare da ponte fra l'InfoBus e i dati ricavati dal database Domino e una seconda applet che fungerà da consumatore prelevando il data item e graficandolo.
Per far ciò utilizzeremo la Script Helper applet e la Chart Applet.
 
 
 

Report esemplificativo

Figura 8: la vista finale

Per coloro che non hanno dimestichezza con l'ambiente Notes, una vista è una raccolta di documenti che hanno caratteristiche comuni. Una sorta di query SQL anche se il parallelo fra i database relazionali e Notes, database documentale, non è diretto.
Per altri dettagli introduttivi su Domino, vedere l'articolo di Puliti del giugno 1999.
Questa vista contiene 3 semplicissimi documenti che riportano il nome del continente in cui si sono registrate le vendite e i dati di vendita relativi ai 4 trimestri.
 
 

Figura 9: a vista in funzione

Quando apro il form con il browser, vengono caricate tre applet: l'applet PinPoint per creare il canale di comunicazione CORBA con il server, l'applet Script Helper che chiameremo bridge che avrà il compito di pubblicare il data item sull'InfoBus e infine l'applet Chart che chiameremo statistiche che dovrà visualizzare i dati delle vendite ricevuti da Domino.
 

Figura 10: consultazione della la vista tramite il browser

Inizialmente il grafico non viene mostrato in quanto non contiene dati.
Quando premo il pulsante Visualizza Statistiche, il browser avvia la funzione che consente di visualizzare i dati sull'applet statistiche.
Per prima cosa viene aperta la sessione e lo script segnala l'avvenuta connessione con il server Domino con una finestra che riporta il nome del database con il quale è avvenuta la connessione.
(immagine PulsantePremuto.gif)
A questo punto la PinPoint applet ha aperto la sessione CORBA con il server e, tramite JavaScript e LiveConnect, ho chiamato il metodo getTitle() per avere il titolo del database con il quale sta colloquiando il browser.
Poi leggo i dati contenuti in ciascun documento e li pubblico come vettore su InfoBus tramite la brigde applet.
(immagine InserimentoDataItem.gif)
Mentre la bridge applet si comporta da produttore, il Chart è in attesa del data item e agirà come consumatore del vettore che viene pubblicato sull'InfoBus.
Nel momento in cui effettuo il merge del vettore sull'InfoBus, cioè ho completato la lettura dei documenti da Domino e la pubblicazione sull'InfoBus, il Chart ottiene il data item ed è in grado di produrre il grafico.
 
 

Figura 11: l'applet in esecuzione nel browser

Conclusioni