921 - marca editoriale antica. la citazione in repertori $c
viene gestita come relazione con elemento di authority di tipo
'repertorio' (con elemento ArrivoLegame)
BaseSessionInfoMessage è una classe creata per fornire un oggetto
serializzato in grado di contenere tutte le informazioni scambiabili
tra la servlet e i componenti lato EJB server.
200 - titolo e responsabilita': il sottocampo z (titolo
parallelo) non e' presente, il titolo parallelo viene gestito
come legame,
il sottocampo v (designazione di volume) viene gestito con la
sequenza in ArrivoLegame.
CERCA ELEMENTI DI AUTHORITY: la ricerca puo' essere attivata per
id, per nome troncato (cles)
le parole sono previste solo per Autori, soggetti, marche,
classi e repertori
CERCA TITOLI canali di ricerca: T001 = SbnID, NumSTD = tipo e
numero standard
titoloCerca= stringa o chiavi titolo. i canali possono non
essere presente se si usa un canale specifico sul tipo
materiale.
Metodo doGet - Reagisce all'invio di informazioni -
Verifica il contenuto della comunicazione ed attiva l'apposita API di interfaccia
Tutte le api di interfaccia estendono la superclasse astratta denominata SbnmarcConnector
La classe SbnmarcConnector implementa a sua volta l'interfaccia SbnmarcCommunicationLayer
Prima di verificare il contenuto della variabile CONNECTION_TYPE il metodo di doGet
realizza una variabile di tipo SbnmarcCommunicationLayer opportumente istanziata come segue:
- oggetto SbnmarcHTTPConnector se CONNECTION_TYPE = HTTP
- oggetto SbnmarcJMSConnector se CONNECTION_TYPE = JMS
(Eventualmente) - oggetto SbnmarcSOAPConnector se CONNECTION_TYPE = SOAP
Verifica inoltre se la richiesta è di tipo Sbnmarc
o si tratta di un semplice "ping" (SBNMARC_REQUEST = KEEP_ALIVE)
verso il server SBNMarc centrale.
Metodo di inizialize
La sample servlet si preoccupare di ricavare in fase di initizialize
da un parametro di sistema
(o in alternativa da un file di riferimento o da un albero JNDI)
la URL del Server SBNMarc a cui inviare le informazioni pervenute
legami a elementi di authority ATTRIBUTI:
tipoAuthority=tipologia di authority a cui appartiene idArrivo
tipoLegame=codice legame relatorCode=codice di ruolo: per
legami titoli-autori
incerto=Se S l'attribuzione del legame e' incerta (per legame
titoli-autore)
superfluo=Se S il legame titolo-autore non e' obbligatorio
secondo le regole
legami a titoli di accesso. sequenzaMusica e' specifico per i
legami con titolo D per materiale musicale manoscritto,
contiene indicazioni su volume, fascicolo, pagina, carte
struttura per output degli oggetti trovati o creati
Attributi: tipoRisultato=indica se il titolo 柳tato creato,
trovato uguale o trovato simile per quale confronto
struttura per output degli oggetti da allineare
Attributi: tipoModifica=viene prodotto per il servizio di
allineamento per flag, specifica il tipo di variazione subita
dall'ogggetto
tipologia di authority: AU = autore, TU = Titolo Uniforme,
UM = Titolo Uniforme Musica, SO = Soggetto, DE = Descrittore,
LU = Luogo,
CL = Classe, MA = Marca, RE = Repertorio
Localizza=inserimento nuova localizzazione
Delocalizza=cancellazione localizzazione, Correggi=modifica dati
con esclusione dati della biblioteca, Allineato=azzeramento flag
di allineamento Esame=visualizzazione localizzazioni
legami verso elementi di authority.
4XX = legame vedi tra elementi di authority, 5XX = legame vedi
anche tra elementi di authority,
500 = legame a titolo uniforme 09A,
606 = legame a soggetto, 620 = legame a luogo , 676 = legame a
classe dewey
686 = legame a classe diversa da dewey, 700 = legame con autore
pers. responsabilita 1
701 = legame con autore personale resp. 2, 702 = legame con
autore personale resp. 3,
710 = legame con ente resp. 1, 711 = legame con ente resp. 2,
712 = legame ente resp. 3,
810 = legame con repertorio trovato , 815 = legame con
repertorio per non trovato,
921 = legame a marca editoriale , 931 = legame
soggetto-descrittore
legami tra descrittori: USE=vedi UF=usato al posto di RT=vedi
anche BT=ha come termine piu' esteso NT=ha come termine
piu'ristretto
legami tra documenti; tutti e' ammesso solo in ricerca
410=01C 422=02M,02S 430=04M,04C,04S 431=43S 434=41S 440=05M,05S
447=42S
451=07M,07C,07S 461=01M,01S,C01C 463=51M,51W,51N 464=51N
INTERFACCIA DI RIFERIMENTO PER GLI OGGETTI GESTIONE (LAYER) PROTOCOLLI DI COMUNICAZIONE
Si tratta di un'API (application program interface) utile a formalizzare
metodi e comportamenti per il colloquio polo-indice
Indica la struttura (ovvero la "signature") dei due metodi fondamentali per
il colloquio con il server SBNMarc.
SUPERCLASSE ABSTRACT PROTOCOLLI DI CONNESSIONE
Questa classe generalizza attributi e metodi comuni per le classi
che implementano i metodi di send verso il server SBNMarc
Implementa l'interfaccia di tipo SbnmarcCommunicationLayer imponendo così
a tutte le classi di connessione una signature sui metodi di colloquio
con il server SBNMarc
INTERFACCIA DI RIFERIMENTO PER LA COMUNICAZIONE TRAMITE HTTP
API di interfaccia utilizzata dal connector su protocollo HTTP
definisce la signature dei metodi pubblici presenti nell'oggetto SbnmarcHTTPConnector
Specializza l'interfaccia con le signature di send denominata SbnmarcCommunicationLayer
Classe gestione comunicazione server SBNMarc tramite protocollo HTTP
La classe gestisce una richiesta proveniente dall'esterno e la invia
al Server SBNMarc tramite HTTP Protocol
Estende la superclasse astratta SbnmarcConnector
implementa tramite la superclasse astratta l'interfaccia SbnmarcCommunicationLayer
per i metodi di send
implementa in modo diretto l'interfaccia SbnmarcHTTPConnectionAPI per i propri metodi pubblici
INTERFACCIA DI RIFERIMENTO PER LA COMUNICAZIONE TRAMITE JMS
API di interfaccia utilizzata dal connector su protocollo JMS
definisce la signature dei metodi pubblici presenti nell'oggetto SbnmarcJMSConnector
Specializza l'interfaccia con le signature di send denominata SbnmarcCommunicationLayer
IL server SBNMarc permette, a seguito abilitazione, di poter trasferire
richieste in formato SBNMarc direttamente alle JMS Queue (code di gestione)
evitando il colloquio con la/le servlet di interfaccia del server stesso
Simile=creazione con ricerca preventiva, Conferma=creazione
senza richiesta preventiva
SimileImport=ricerca preventiva senza creazione per attivita'
import
specializzazione del legame per materiali speciali: musica e
grafica
per musica: P=titolo di opera parafrasata, I=incipit
letterario, L=titolo di opera relativa al libretto,
A= titolo di opera in cui e' inserita l'aria,E=tit. dell'opera
letteraria,
T=tit. alternativo
tipo attivita' autorizzata per importazioni:
CONTROLLO ELEMENTI LEGATI= elaborazione di verifica degli
elementi correlati (titoli/autori/soggetti/classi) ai documenti
CONTROLLO COLLANE= elaborazioni di verifica delle collane
collegate ai documenti da importare
SOLO LOCALIZZA= esecuzione confronti e localizzazioni per
possesso documenti individuati
CREA SOLO DOCUMENTI = esecuzione confronti, creazione di
documenti solo se legati a elementi di authority presenti in
Indice, localizzazione
COMPLETA = esecuzione confronti e importazione completa:
documenti, elementi di authority
tipologie di note: codice del blocco 3XX da verificare con il
tipo materiale
300=nota informativa 323=nota al cast 327=nota di contenuto
330=abstract
336=tipo di risorsa elettronica 337=note tecniche risorsa
elettronica FILI=filigrana
CAST=note al cast per musica
tipo di ordinamento richiesto dal client per liste sintetiche:
1=identificativo+stringa+data1, 2=stringa+data1, 3=autore
resp.1+stringa+data1,4=sequenza,5=data1+stringa
(data1 si applica solo alle liste titoli, i tipi 3,4,5 sono
specifici per i titoli, 4 e' accettato solo su liste a partire
da un titolo individuato
Metodo - sendSbnMarcRequest
Questo metodo consente di spedire al server SBNMarc per l'elaborazione,
una stringa contenente il testo xml della richiesta di input.