Jcde 1.0
Martelli Edoardo, martelli@cilta.unibo.it
Bologna, 4 settembre 1998

Documentazione tecnica del software Jcde

A grandi linee Jcue ha questo funzionamento:

  1. Lettura delle impostazioni grafiche e della locazione del server dal file jcde.ini.
  2. Connessione al server e autenticazione del client tramite l'invio di una stringa  di identificazione
  3. Autenticazione dell'utente
  4. Visualizzazione frame di lavoro.
La sequenza delle operazioni che in seguito  un'utente deve normalmente compiere e':
  1. Caricamento di un documento (il numero deve essere conosciuto)
  2. Eventuale trattamento del testo (Vericalize, apostrophize)
  3. Salvataggio su file locale
Descrizione dei file sorgenti

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.