tap.resource

Class Capabilities

java.lang.Object

tap.resource.Capabilities

All Implemented Interfaces:

TAPResource, VOSIResource

public class Capabilities
extends java.lang.Object
implements TAPResource, VOSIResource

TAP resource describing the capabilities of a TAP service.

This resource just return an XML document giving a description of the TAP service and list all its VOSI resources.

Version:

2.1 (07/2016)

Author:

Grégory Mantelet (CDS;ARI)

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	accessURL URL toward this TAP resource.
static java.lang.String	RESOURCE_NAME Name of this TAP resource.
protected java.lang.String	xsltPath The path of the XSLT style-sheet to apply.

Constructor Summary

Constructors

Constructor and Description
Capabilities(TAP tap) Build a "/capabilities" resource.

Method Summary

Modifier and Type	Method and Description
void	destroy() Let free properly all system/file/DB resources kept opened by this TAP resource.
boolean	executeResource(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Interpret the given request, execute the appropriate action and finally return a result or display information to the user.
java.lang.String	getAccessURL() Get the URL which lets access this resource.
java.lang.String	getCapability() Get the capabilities of this resource.
static java.lang.String	getDefaultCapability(VOSIResource res) Write the XML description of the given VOSI resource.
java.lang.String	getName() Get the name of this TAP resource.
java.lang.String	getStandardID() Get the standardID of this endpoint of the VOSI interface.
java.lang.String	getXSLTPath() Gets the path/URL of the XSLT style-sheet to use.
void	init(javax.servlet.ServletConfig config) Let initialize this TAP resource.
void	setTAPBaseURL(java.lang.String baseURL) Let diffuse the base URL of the TAP service to all its TAP resources.
void	setXSLTPath(java.lang.String path) Sets the path/URL of the XSLT style-sheet to use.

Methods inherited from class java.lang.Object

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

Field Detail

RESOURCE_NAME

public static final java.lang.String RESOURCE_NAME

Name of this TAP resource.

See Also:

Constant Field Values

accessURL

protected java.lang.String accessURL

URL toward this TAP resource. This URL is particularly important for its declaration in the capabilities of the TAP service.

Note: By default, it is just the name of this resource. It is updated after initialization of the service when the TAP service base URL is communicated to its resources. Then, it is: baseTAPURL + "/" + RESOURCE_NAME.

xsltPath

protected java.lang.String xsltPath

The path of the XSLT style-sheet to apply.

Since:

2.1

Constructor Detail

Capabilities

public Capabilities(TAP tap)

Build a "/capabilities" resource.

Parameters:

tap - Object representation of the whole TAP service.

Method Detail

getXSLTPath

public final java.lang.String getXSLTPath()

Gets the path/URL of the XSLT style-sheet to use.

Returns:

XSLT path/url.

Since:

2.1

setXSLTPath

public final void setXSLTPath(java.lang.String path)

Sets the path/URL of the XSLT style-sheet to use.

Parameters:

path - The new XSLT path/URL.

Since:

2.1

setTAPBaseURL

public final void setTAPBaseURL(java.lang.String baseURL)

Description copied from interface: TAPResource

Let diffuse the base URL of the TAP service to all its TAP resources.

Important note: This function should be called just once: either at the creation of the service or when the first request is sent to the TAP service (in this case, the request is also used to finish the initialization of the TAP service, and of all its resources).

Specified by:

setTAPBaseURL in interface TAPResource

Parameters:

baseURL - Common URL/URI used in all requests sent by any user to the TAP service.

getName

public final java.lang.String getName()

Description copied from interface: TAPResource

Get the name of this TAP resource.

Important note: This name MUST NOT be NULL and SHOULD NEVER change.

Specified by:

getName in interface TAPResource

Returns:

Name of this TAP resource.

getStandardID

public final java.lang.String getStandardID()

Description copied from interface: VOSIResource

Get the standardID of this endpoint of the VOSI interface.

The standard IDs of the VOSI endpoints are the following:

• Capabilities: ivo://ivoa.net/std/VOSI#capabilities
• Availability: ivo://ivoa.net/std/VOSI#availability
• Tables: ivo://ivoa.net/std/VOSI#tables

Specified by:

getStandardID in interface VOSIResource

Returns:

Standard ID of this VOSI endpoint.

getAccessURL

public final java.lang.String getAccessURL()

Description copied from interface: VOSIResource

Get the URL which lets access this resource.

Specified by:

getAccessURL in interface VOSIResource

Returns:

Access URL.

getCapability

public java.lang.String getCapability()

Description copied from interface: VOSIResource

Get the capabilities of this resource.

Specified by:

getCapability in interface VOSIResource

Returns:

Resource capabilities.

init

public void init(javax.servlet.ServletConfig config)
          throws javax.servlet.ServletException

Description copied from interface: TAPResource

Let initialize this TAP resource.

Specified by:

init in interface TAPResource

Parameters:

config - Servlet configuration. (may be useful for the configuration of this resource)

Throws:

javax.servlet.ServletException - If any error prevent the initialization of this TAP resource. In case a such exception is thrown, the service should stop immediately.

destroy

public void destroy()

Description copied from interface: TAPResource

Let free properly all system/file/DB resources kept opened by this TAP resource.

Specified by:

destroy in interface TAPResource

executeResource

public boolean executeResource(javax.servlet.http.HttpServletRequest request,
                               javax.servlet.http.HttpServletResponse response)
                        throws java.io.IOException,
                               TAPException

Description copied from interface: TAPResource

Interpret the given request, execute the appropriate action and finally return a result or display information to the user.

IMPORTANT: "TAP resources can not take the law in their own hands!" :-) Errors that could occur inside this function should not be written directly in the given HttpServletResponse. They should be thrown to the resources executor: an instance of TAP, which will fill the HttpServletResponse with the error in the format described by the IVOA standard - VOTable. Besides, TAP may also add more information and may log the error (in function of this type).

Specified by:

executeResource in interface TAPResource

Parameters:

request - Request sent by the user and which should be interpreted/executed here.

response - Response in which the result of the request must be written.

Returns:

true if the request has been successfully executed, false otherwise (but generally an exception will be sent if the request can't be executed).

Throws:

java.io.IOException - If any error occurs while writing the result of the given request.

TAPException - If any other error occurs while interpreting and executing the request or by formating and writing its result.

getDefaultCapability

public static final java.lang.String getDefaultCapability(VOSIResource res)

Write the XML description of the given VOSI resource.

Parameters:

res - Resource to describe in XML.

Returns:

XML description of the given VOSI resource.