NameResolver

java.lang.Object
- net.cds.CDSParser
- - net.cds.NameResolver

public class NameResolver
extends CDSParser

This class uses the name-resolving capabilities of the VizeR/Simbad/NED databases via a network-access to the AXIS services provides by CDS. For this class to run, one needs the AXIS-jar extensions, at least the axis.jar, jaxrpc.jar, saaj.jar, commons-logging.jar, commons-discovery.jar, wsdl4j.jar. Additionally, an access package must be created, in this case by issuing the command: java org.apache.axis.wsdl.WSDL2Java http://cdsws.u-strasbg.fr/axis/services/Sesame?wsdl. Additional info is available at CDS.

A typicla output looks like this:

 
    
      
      PW And
      
        from cache
        RSCVn
        00:18:20.89 +30:57:22.0
        4.5870708
        +30.9561194
        1988A&AS...74..449R
        137133
        V* PW And
        V* PW And
        HD 1405
        AG+30 25
        BD+30 34
        EUVE J0018+30.9
        [FS2003] 0007
        GC 365
        LTT 10110
        PPM 65186
        RBS 39
        2RE J001820+305712
        2RE J0018+305
        RX J0018.3+3057
        1RXS J001821.2+305723
        SAO 53799
        TYC 2261- 1518-1
        uvby98 100001405
        YZ 30 120
        30

The appropriate tags can be queried in accordingly named methods.

This software uses source code created at the Centre de Donn�es astronomiques de Strasbourg, France.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`NameResolver.Client` Titre : Sesame Description : Resolves names in Simbad, VizieR and/or NED Copyright : Copyright (c) 2002-2003 Soci\x{00E9}t\x{00E9} : Centre de Donn\x{00E9}es Astronomique de Strasbourg
`static class`	`NameResolver.Query` A test class for resolving names through the simbad service.

Field Summary

Fields
Modifier and Type	Field and Description
`private static SesameService`	`locate` The AXIS-enhanced sesame service object.
`private static NameResolver`	`resolve` The reference to the only living name-resolver object.
`private static String`	`SESAMEFORMAT` The query format for sesame.
`private static Sesame`	`sesamequery` The access object created from the sesam service provider.

Constructor Summary

Constructors
Modifier Constructor and Description

private NameResolver()
Constructs a new name resolver.

Constructors
Modifier	Constructor and Description
`private`	`NameResolver()` Constructs a new name resolver.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`private boolean`	`checkString(String target)` Convenience method that transforms the single query string into a one-element list of strings and passes this list to the parent method.
`static List<String>`	`getAliases(String ask)` Returns a string-list of other names of the target.
`static String`	`getCommonName(String ask)` Returns the main name of the object.
`static double`	`getDeclination(String ask)` Returns the declination of the object in degrees.
`static double`	`getDeclinationError(String ask)` Returns the error in declination in milli arcseconds.
`static String`	`getError(String ask)` Returns the error message or null if no error was encountered.
`static String`	`getInfo(String ask)` Returns the info message or null if no info was encountered.
`static String`	`getObjectType(String ask)` Returns the object type.
`static String`	`getPositionReference(String ask)` Returns the reference to the position of the object.
`static int`	`getReferenceCount(String ask)` Returns the number of references to this object.
`static String`	`getResolver(String ask)` Get the resolver name.
`static double`	`getRightAscension(String ask)` Returns the right ascension of the object in degrees.
`static double`	`getRightAscensionError(String ask)` Returns the error of the right ascension in milli arcseconds.
`static String`	`getSexagesimalPosition(String ask)` Returns right ascension and declination of the target as a single string in the so-called sexagesimal notation.
`static boolean`	`inService()` Returns true, if the sesame service could be located.
`protected boolean`	`isRetrievable()` Returns true if the web-service is available.
`protected String`	`query(List arg)` This method is called if the cache needs to be updated.
`private static double`	`tryDouble(String parse)` Tries to convert a string into a double.

Methods inherited from class net.cds.CDSParser
checkCache, getParsed

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - locate
```
private static SesameService locate
```
    The AXIS-enhanced sesame service object.
  - sesamequery
```
private static Sesame sesamequery
```
    The access object created from the sesam service provider.
  - SESAMEFORMAT
```
private static final String SESAMEFORMAT
```
    The query format for sesame.
    
    See Also:
    
    Constant Field Values
  - resolve
```
private static NameResolver resolve
```
    The reference to the only living name-resolver object.
- Constructor Detail
  - NameResolver
```
private NameResolver()
```
    Constructs a new name resolver. The only living instance of a name resolver should be constructed at class load.
- Method Detail
  - inService
```
public static boolean inService()
```
    Returns true, if the sesame service could be located.
  - getResolver
```
public static String getResolver(String ask)
```
    Get the resolver name.
    
    Parameters:
    
    ask - The object description to be queried.
    
    Returns:
    
    The resolver name
  - getError
```
public static String getError(String ask)
```
    Returns the error message or null if no error was encountered.
    
    Parameters:
    
    ask - The object description to be queried.
    
    Returns:
    
    The error message or null if no error occured.
  - getInfo
```
public static String getInfo(String ask)
```
    Returns the info message or null if no info was encountered.
    
    Parameters:
    
    ask - The object description to be queried.
    
    Returns:
    
    The info message or null if no info was transferred.
  - getObjectType
```
public static String getObjectType(String ask)
```
    Returns the object type. See object type documentation.
    
    Parameters:
    
    ask - The object description to be queried.
    
    Returns:
    
    The object type as a string.
  - getSexagesimalPosition
```
public static String getSexagesimalPosition(String ask)
```
    Returns right ascension and declination of the target as a single string in the so-called sexagesimal notation.
    
    Parameters:
    
    ask - The object description to be queried.
    
    Returns:
    
    The position in the format HH:MM:SS.S (-)DD:MM:SS.S
  - getRightAscension
```
public static double getRightAscension(String ask)
```
    Returns the right ascension of the object in degrees.
    
    Parameters:
    
    ask - The object description to be queried.
    
    Returns:
    
    The right ascension in degrees.
  - getDeclination
```
public static double getDeclination(String ask)
```
    Returns the declination of the object in degrees.
    
    Parameters:
    
    ask - The object description to be queried.
    
    Returns:
    
    The declination in degrees.
  - getRightAscensionError
```
public static double getRightAscensionError(String ask)
```
    Returns the error of the right ascension in milli arcseconds.
    
    Parameters:
    
    ask - The object description to be queried.
    
    Returns:
    
    The error in the right ascension possition, mas.
  - getDeclinationError
```
public static double getDeclinationError(String ask)
```
    Returns the error in declination in milli arcseconds.
    
    Parameters:
    
    ask - The object description to be queried.
    
    Returns:
    
    The error in the declination possition, mas.
  - getPositionReference
```
public static String getPositionReference(String ask)
```
    Returns the reference to the position of the object.
    
    Parameters:
    
    ask - The object description to be queried.
    
    Returns:
    
    The bibliographic refernce to the position
  - tryDouble
```
private static double tryDouble(String parse)
```
    Tries to convert a string into a double. Returns NaN if a number format exception was thrown.
  - getCommonName
```
public static String getCommonName(String ask)
```
    Returns the main name of the object. The main name is the most commonly used identifier, as defined in Simbad.
    
    Parameters:
    
    ask - The object description to be queried.
    
    Returns:
    
    The Simbad main name of the object.
  - getAliases
```
public static List<String> getAliases(String ask)
```
    Returns a string-list of other names of the target.
    
    Parameters:
    
    ask - The object description to be queried.
    
    Returns:
    
    A list of strings.
  - getReferenceCount
```
public static int getReferenceCount(String ask)
```
    Returns the number of references to this object. If retrieval fails, -1 is returned
    
    Parameters:
    
    ask - The object description to be queried.
    
    Returns:
    
    The number of references to this object.
  - isRetrievable
```
protected boolean isRetrievable()
```
    Returns true if the web-service is available. Checks if the static reference to sesamequery is alive.
    
    Specified by:
    
    isRetrievable in class CDSParser
  - query
```
protected String query(List arg)
```
    This method is called if the cache needs to be updated. The list is a string-list with a single element.
    
    Specified by:
    
    query in class CDSParser
  - checkString
```
private boolean checkString(String target)
```
    Convenience method that transforms the single query string into a one-element list of strings and passes this list to the parent method.

Class NameResolver

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class net.cds.CDSParser

Methods inherited from class java.lang.Object

Field Detail

locate

sesamequery

SESAMEFORMAT

resolve

Constructor Detail

NameResolver

Method Detail

inService

getResolver

getError

getInfo

getObjectType

getSexagesimalPosition

getRightAscension

getDeclination

getRightAscensionError

getDeclinationError

getPositionReference

tryDouble

getCommonName

getAliases

getReferenceCount

isRetrievable

query

checkString