cds.simbad
Interface SimbadInterface

All Superinterfaces:
java.rmi.Remote
All Known Implementing Classes:
SimbadUpdate

public interface SimbadInterface
extends java.rmi.Remote

RMI Interface describing the methods implemented in the Simbad class and its subclasses (SimbadQuery and SimbadUpdate) on the server side

Version:
1.0 Dec 2002
Author:
Sylvaine Jaehn (Stage UTBM)

Method Summary
 java.lang.Object alink(long oid)
          Recherche de tous les objets associes a un objet (lien associatif)
 java.lang.Object autPosRef(java.lang.String author, int pos)
          Recuperation de la reference bibliographique a partir d'un auteur et de sa position
 java.lang.Object bibcode(java.lang.String bibcode)
          Interrogation par reference bibliographique
 Reference bibcodeRef(java.lang.String bibcode)
          Recuperation de la reference bibliographique associee a un bibcode
 java.lang.Object cat(java.lang.String catName)
          Interrogation par catalogue
 void close()
          Fermeture de la connexion a la base de donnees
 AstrobjectList coord(java.lang.String coord, java.lang.Double radius)
          Interrogation par coordonnees (centre et rayon)
 java.lang.Object coordParam(java.lang.String coord, double radius, java.lang.String data, float limitInf, float limitSup)
          Interrogation par coordonnees (centre, rayon) et critere
 java.lang.Object criteriaQuery(java.lang.String criteriaList)
          Interrogation par criteres
 java.util.ArrayList getMetadata()
          Recuperation des metadonnees (tables et colonnes) pour les interrogations par requete SQL libre
 java.lang.String getParameterFile()
          Acces a l'URL du fichier de parametres principal
 java.lang.Object hlink(long oid)
          Recherche des fils d'un objet (lien hierarchique)
 java.lang.Object ident(java.lang.String ident, int type)
          Interrogation par identificateur
 java.lang.Object oid(long oid)
          Interrogation par oid
 AstrobjectList oidList(java.util.ArrayList oidlist)
          Retourne les objets astronomiques correspondants aux oids contenus dans une liste
 boolean open()
          Etablissement de la connexion avec l'utilisateur par defaut
 boolean open(java.lang.String user, java.lang.String passwd)
          Etablissement de la connexion avec l'utilisateur specifie
 java.lang.Object sqlQuery(java.lang.String sqlQuery, java.lang.String strSelect)
          Interrogation de la base par une requete SQL formulee par l'utilisateur
 java.lang.Object titleRef(java.util.ArrayList titleWords, java.lang.String op)
          Recuperation de la reference bibliographique a partir des mots du titre
 int updateALink(byte type, java.lang.String identFather, java.lang.String identSon)
          MOD-BB 04/12/03 modification du type du paraùètre "type" char->byte (A cause d'axis !)
 int updateHLink(byte type, java.lang.String identFather, java.lang.String identSon)
          MOD-BB 04/12/03 modification du type du parametre "type" char->byte (A cause d'axis !)
 

Method Detail

open

public boolean open()
             throws java.rmi.RemoteException
Etablissement de la connexion avec l'utilisateur par defaut

Returns:
true si la connexion est etablie, false sinon
Throws:
java.rmi.RemoteException - if RMI problem

open

public boolean open(java.lang.String user,
                    java.lang.String passwd)
             throws java.rmi.RemoteException
Etablissement de la connexion avec l'utilisateur specifie

Parameters:
user - utilisateur de la base
passwd - mot de passe d'acces a la base
Returns:
true si la connexion est etablie, false sinon
Throws:
java.rmi.RemoteException - if RMI problem

getParameterFile

public java.lang.String getParameterFile()
                                  throws java.rmi.RemoteException
Acces a l'URL du fichier de parametres principal

Returns:
chaine de caracteres representant l'URL
Throws:
java.rmi.RemoteException - if RMI problem

close

public void close()
           throws java.rmi.RemoteException
Fermeture de la connexion a la base de donnees

Throws:
java.rmi.RemoteException - if RMI problem

getMetadata

public java.util.ArrayList getMetadata()
                                throws java.rmi.RemoteException
Recuperation des metadonnees (tables et colonnes) pour les interrogations par requete SQL libre

Returns:
liste des tables et de leurs colonnes sous la forme "table|colonne|ucd|description"
Throws:
java.rmi.RemoteException - if RMI problem

oid

public java.lang.Object oid(long oid)
                     throws java.rmi.RemoteException,
                            SimbadException
Interrogation par oid

Parameters:
oid - oid de l'objet astronomique
Returns:
liste d'objets astronomiques (contenant 1 seul objet) ou declanche une exception si aucun objet trouve
Throws:
java.rmi.RemoteException - if RMI problem
SimbadException - if Simbad error

ident

public java.lang.Object ident(java.lang.String ident,
                              int type)
                       throws java.rmi.RemoteException,
                              SimbadException
Interrogation par identificateur

Parameters:
ident - identificateur de l'objet astronomique
type - type d'interrogation (0 : ident complet, 1 : expr reguliere, 2 : like)
Returns:
liste d'objet astronomique contenant un objet unique ou une liste d'oid si plusieurs objets trouves, ou lance une exception si aucun objet trouve
Throws:
java.rmi.RemoteException - if RMI problem
SimbadException - if Simbad error

cat

public java.lang.Object cat(java.lang.String catName)
                     throws java.rmi.RemoteException,
                            SimbadException
Interrogation par catalogue

Parameters:
catName - nom du catalogue
Returns:
une liste d'objets astronomiques contenant un objet, une liste d'oid ou declanche une exception
Throws:
java.rmi.RemoteException - if RMI problem
SimbadException - if Simbad error

oidList

public AstrobjectList oidList(java.util.ArrayList oidlist)
                       throws java.rmi.RemoteException
Retourne les objets astronomiques correspondants aux oids contenus dans une liste

Parameters:
oidlist - liste d'oid
Returns:
liste d'objets astronomiques ou null si la liste ne contient aucun oid
Throws:
java.rmi.RemoteException - if RMI problem

coord

public AstrobjectList coord(java.lang.String coord,
                            java.lang.Double radius)
                     throws java.rmi.RemoteException,
                            SimbadException
Interrogation par coordonnees (centre et rayon)

Parameters:
coord - coordonnees du centre sous forme de chaine de caracteres
radius - rayon en degres
Returns:
liste d'objets astronomiques contenant un objet unique ou une liste d'oid si plusieurs objets trouves, ou declanche une exception si aucun objet trouve
Throws:
java.rmi.RemoteException - if RMI problem
SimbadException - if Simbad error

coordParam

public java.lang.Object coordParam(java.lang.String coord,
                                   double radius,
                                   java.lang.String data,
                                   float limitInf,
                                   float limitSup)
                            throws java.rmi.RemoteException,
                                   SimbadException
Interrogation par coordonnees (centre, rayon) et critere

Parameters:
coord - coordonnees du centre sous forme de chaine de caracteres
radius - rayon en degres
data - critere
limitInf - valeur minimale du critere
limitSup - valeur maximale du critere
Returns:
liste d'objet astronomique contenant un objet unique ou une liste d'oid si plusieurs objets trouves, ou declanche une exception si aucun objet trouve
Throws:
java.rmi.RemoteException - if RMI problem
SimbadException - if Simbad error

bibcode

public java.lang.Object bibcode(java.lang.String bibcode)
                         throws java.rmi.RemoteException,
                                SimbadException
Interrogation par reference bibliographique

Parameters:
bibcode - reference bibliographique dans laquelle apparaissent les objets astronomiques recherches
Returns:
null si aucun objet astronomique n'est trouve, un objet astronomique contenu dans une liste d'obj astro ou une liste d'oids correspondants aux resultats de la requete
Throws:
java.rmi.RemoteException - if RMI problem
SimbadException - if Simbad error

bibcodeRef

public Reference bibcodeRef(java.lang.String bibcode)
                     throws java.rmi.RemoteException,
                            SimbadException
Recuperation de la reference bibliographique associee a un bibcode

Parameters:
bibcode - bibcode dont on veut la reference bibliographique entiere
Returns:
reference bibliographique associee au bibcode
Throws:
java.rmi.RemoteException - if RMI problem
SimbadException - if Simbad error

autPosRef

public java.lang.Object autPosRef(java.lang.String author,
                                  int pos)
                           throws java.rmi.RemoteException,
                                  SimbadException
Recuperation de la reference bibliographique a partir d'un auteur et de sa position

Parameters:
author - auteur d'une reference bibliographique
pos - position dans laquelle l'auteur apparaît dans la reference bibliographique
Returns:
reference bibliographique dont on connait un auteur et sa position, ou liste de bibcodes (BibcodeList) ou une exception si aucun resultat trouve
Throws:
java.rmi.RemoteException - if RMI problem
SimbadException - if Simbad error

titleRef

public java.lang.Object titleRef(java.util.ArrayList titleWords,
                                 java.lang.String op)
                          throws java.rmi.RemoteException,
                                 SimbadException
Recuperation de la reference bibliographique a partir des mots du titre

Parameters:
titleWords - liste des mots du titre
op - operateur de liaison : ou / et / "" (si pas de liaison)
Returns:
reference bibliographique dont le titre contient un ou plusieurs mots, ou liste de bibcodes (BibcodeList) ou declanche une exception si aucun resultat trouve
Throws:
java.rmi.RemoteException - if RMI problem
SimbadException - if Simbad error

hlink

public java.lang.Object hlink(long oid)
                       throws java.rmi.RemoteException,
                              SimbadException
Recherche des fils d'un objet (lien hierarchique)

Parameters:
oid - oid de l'objet dont on recherche les fils
Returns:
une liste d'objet astronomique avec un element, ou liste d'oid correspondants aux fils ou declanche une exception si aucun objet trouve
Throws:
java.rmi.RemoteException - if RMI problem
SimbadException - if Simbad error

alink

public java.lang.Object alink(long oid)
                       throws java.rmi.RemoteException,
                              SimbadException
Recherche de tous les objets associes a un objet (lien associatif)

Parameters:
oid - oid de l'objet dont on recherche les objets associes
Returns:
une liste d'objets astronomiques avec un element, ou liste d'oid trouves ou declanche une exception si aucun objet trouve
Throws:
java.rmi.RemoteException - if RMI problem
SimbadException - if Simbad error

sqlQuery

public java.lang.Object sqlQuery(java.lang.String sqlQuery,
                                 java.lang.String strSelect)
                          throws java.rmi.RemoteException,
                                 SimbadException
Interrogation de la base par une requete SQL formulee par l'utilisateur

Parameters:
sqlQuery - requete SQL
strSelect - cha}ps fag5rants de la partie "select" de la requête
Returns:
resultat de la requete ou declanche une exception si aucun resultat ou erreur de syntaxe sql
Throws:
java.rmi.RemoteException - if RMI problem
SimbadException - if Simbad error

criteriaQuery

public java.lang.Object criteriaQuery(java.lang.String criteriaList)
                               throws java.rmi.RemoteException,
                                      SimbadException
Interrogation par criteres

Parameters:
criteriaList - liste de criteres (criteres de la forme critere=valeur separes par un point virgule)
Returns:
the result of the query
Throws:
java.rmi.RemoteException - if RMI problem
SimbadException - if Simbad error

updateHLink

public int updateHLink(byte type,
                       java.lang.String identFather,
                       java.lang.String identSon)
                throws java.rmi.RemoteException,
                       SimbadException
MOD-BB 04/12/03 modification du type du parametre "type" char->byte (A cause d'axis !) Gestion des liens associatifs

Parameters:
type - type de mise à jour (A : add, D : delete, U : update)
identFather - identificateur du 1er objet
identSon - identificateur du 2e objet
Returns:
-1 si echec, un nombre positif ou declanche une exception
Throws:
java.rmi.RemoteException - if RMI problem
SimbadException - if Simbad error

updateALink

public int updateALink(byte type,
                       java.lang.String identFather,
                       java.lang.String identSon)
                throws java.rmi.RemoteException,
                       SimbadException
MOD-BB 04/12/03 modification du type du paraùètre "type" char->byte (A cause d'axis !) Gestion des liens hierarchiques

Parameters:
type - type de mise à jour (A : add, D : delete, U : update)
identFather - identificateur de l'objet pere
identSon - identificateur de l'objet fils
Returns:
-1 si echec, un nombre positif ou declanche une exception
Throws:
java.rmi.RemoteException - if RMI problem
SimbadException - if Simbad error