uk.ac.starlink.topcat.vizier

Class VizierTableLoadDialog

java.lang.Object

uk.ac.starlink.table.gui.AbstractTableLoadDialog

uk.ac.starlink.topcat.vizier.VizierTableLoadDialog

All Implemented Interfaces:

uk.ac.starlink.table.gui.TableLoadDialog

public class VizierTableLoadDialog
extends uk.ac.starlink.table.gui.AbstractTableLoadDialog

TableLoadDialogue which directly interrogtes the VizieR catalogue service.

Since:

19 Oct 2009

Author:

Mark Taylor, Thomas Boch

Field Summary

Fields

Modifier and Type	Field and Description
static String[]	SERVER_URLS URLs known to host a standard VizieR service.

Constructor Summary

Constructors

Constructor and Description
VizierTableLoadDialog() Constructor.

Method Summary

Modifier and Type	Method and Description
void	addTargetActionListener(ActionListener listener) Adds a listener which will be notified when the user-selected target may change.
void	addTargetCaretListener(CaretListener listener) Adds a listener which will be notified when the text entered in the user-selected target boxes may change.
protected Component	createQueryComponent()
uk.ac.starlink.table.gui.TableLoader	createTableLoader()
static String	encodeArg(String txt) Turns a text string into a string which can be appended to a URL to specify a value-less query argument.
static String	encodeArg(String name, String value) Turns a name, value pair into a string which can be appended to a URL to specify a query argument and its value.
String	getRadius() Returns the radius string in degrees.
String	getTarget() Returns the search target, as presented to the VizieR server's -c parameter.
boolean	hasTarget() Indicates whether enough information has been filled in by the user to specify a search on a given catalogue.
boolean	isAvailable()
boolean	isReady()
void	removeTargetActionListener(ActionListener listener) Removes a listener previously added by addTargetActionListener(java.awt.event.ActionListener).
void	removeTargetCaretListener(CaretListener listener) Removes a listener previously added by addTargetCaretListener(javax.swing.event.CaretListener).

Methods inherited from class uk.ac.starlink.table.gui.AbstractTableLoadDialog

addToolbarAction, asIOException, configure, createFormatSelector, getDescription, getIcon, getMenus, getName, getQueryComponent, getSelectedFormat, getSubmitAction, getToolbarActions, isComponentShowing, setIcon, setIconUrl, setMenus, setToolbarActions, submit, updateReady

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SERVER_URLS

public static final String[] SERVER_URLS

URLs known to host a standard VizieR service. This list is subject to change, but not very often. The definitive list is available from http://vizier.u-strasbg.fr/vizier/mirrors.gml.

Constructor Detail

VizierTableLoadDialog

public VizierTableLoadDialog()

Constructor.

Method Detail

createQueryComponent

protected Component createQueryComponent()

Specified by:

createQueryComponent in class uk.ac.starlink.table.gui.AbstractTableLoadDialog

isAvailable

public boolean isAvailable()

Specified by:

isAvailable in interface uk.ac.starlink.table.gui.TableLoadDialog

Overrides:

isAvailable in class uk.ac.starlink.table.gui.AbstractTableLoadDialog

getTarget

public String getTarget()

Returns the search target, as presented to the VizieR server's -c parameter.

Returns:

formatted target string; empty string for all rows

getRadius

public String getRadius()

Returns the radius string in degrees.

Returns:

formatted radius string; empty string for all rows

createTableLoader

public uk.ac.starlink.table.gui.TableLoader createTableLoader()

isReady

public boolean isReady()

Overrides:

isReady in class uk.ac.starlink.table.gui.AbstractTableLoadDialog

hasTarget

public boolean hasTarget()

Indicates whether enough information has been filled in by the user to specify a search on a given catalogue.

Returns:

true if a queryable query can take place; false if more info needs to be entered

addTargetActionListener

public void addTargetActionListener(ActionListener listener)

Adds a listener which will be notified when the user-selected target may change.

Parameters:

listener - listener to add

removeTargetActionListener

public void removeTargetActionListener(ActionListener listener)

Removes a listener previously added by addTargetActionListener(java.awt.event.ActionListener).

Parameters:

listener - listener to remove

addTargetCaretListener

public void addTargetCaretListener(CaretListener listener)

Adds a listener which will be notified when the text entered in the user-selected target boxes may change.

Parameters:

listener - the listener to add

removeTargetCaretListener

public void removeTargetCaretListener(CaretListener listener)

Removes a listener previously added by addTargetCaretListener(javax.swing.event.CaretListener).

Parameters:

listener - listener to remove

encodeArg

public static String encodeArg(String name,
                               String value)

Turns a name, value pair into a string which can be appended to a URL to specify a query argument and its value. An ampersand is prepended.

Parameters:

name - arg name

value - arg value

Returns:

&name=value (properly encoded)

encodeArg

public static String encodeArg(String txt)

Turns a text string into a string which can be appended to a URL to specify a value-less query argument. An ampersand is prepended.

Parameters:

txt - arg text

Returns:

&txt (properly encoded)