Documentazione tecnica del software Jcde
A grandi linee Jcue ha questo funzionamento:
Jcde.java: legge il file jcde.ini, apre la connessione con il server, autentica il client, crea il frame per l'autenticazione dell'utente.
IniFIle.java: classe per la gestione di file di inizializzazione (.ini) simili a quelli di Windows
CommSrv.java: classe che realizza la comunicazione con il server
e tutte le funzioni di interrogazione.
Le comunicazione avvengono aprendo un socket con il server alla porta
indicata nel file .ini.
Ogni funzione comunica con il server con questo protocollo:
Invio del numero identificativo della funzione
Invio degli eventuali parametri (separati da \n)
Invio della stringa di fine trasmissione (EOT)
Ricezione dei risultati (separati da \n)
Attesa della stringa di fine trasmissione (EOT)
Le comunicazioni avvengono tramite stringhe, per cui eventuali numeri
da inviare devono essere convertiti in stringhe e viceversa.
LoginFrame.java: frame che richiede nome utente e password all'utente, le invia al server e, in caso di autenticazione corretta, apre il frame principale di jcue. La password viene inviata in chiaro.
JcdeFrame.java: frame principale per l'utilizzo del client.
Contiene la definizione e gestione del menu a tendina. La classe definisce
anche i font e i colori di tutte le finestre del programma.
Realizza anche la funzione di export diversa per i tre sistemi operativi
in quanto il fine riga e' sempre diverso (Win: \r\n, Unix \n, Mac \r).
LoadDialog.java: gestisce la finestra di richiesta del documento.
In una Choice visualizza i corpus disponibili.
I documenti piu lunghi di JcdeFrame.docMaxSize non vengono visualizzati
ma solo salvati su disco perche' le textfield di libreria hanno una capienza
massima limitata.
HelpFrame.java: visualizza pagine di help. La classe non e' terminata in quanto non sono disponibili informazioni di aiuto per l'utente. Comunque, la classe conosce in quale punto del programma e' stata invocata in base ad un identificatore che vienne passato al costruttore.
AboutDialog.java: gestione della finestra di informazioni sul programma. Il logo visualizzata deve essere contenuto nel file logo.gif.
ErrorDialog.java: visualizza un messaggio di errore. I messaggi usati in Jcue sono defini in questa classe come stringhe costanti (final)
ImageDisplayer.java: funzione di visualizzazione di immagini (per la dialog about)
QuickPanel.java: classe per la visualizzazione dei panel con
bordini tridimensionali
Descrizione file jcde.ini
Alcune impostazioni di jcue avvengono tramite il file di configurazione
jcue.ini. Le voci da impostare sono le seguenti:
server: nome o indirizzo IP della macchina che esegue il server CUE
port: numero di porta del socket del server
sizex: dimensione x della finestra princiaple di jcue
sizey: dimensione y della finestra principale di jcue
viewwidth: numero di caratteri che compongono ogni riga di visualizzazione
viewheight: numero di righe visualizzate in ogni schermata
platform: sistema operativo del computer dove viene eseguito il client
platform puo' assumere i valori unix, win32 oppure mac. E' necessario
impostare questo valore correttamente per sopperire alle differenze
delle diverse macchine virtuali e per memorizzare sul disco locale i file
di testo in modo corretto.