thredds.server.catalogservice

Class RemoteCatalogServiceController

java.lang.Object

thredds.server.catalogservice.RemoteCatalogServiceController

@Component
 @RequestMapping(value={"/remoteCatalogService","/remoteCatalogValidation.html"})
public class RemoteCatalogServiceController
extends java.lang.Object

Handle all requests for catalog services on remote catalogs. Supported services are:

1. catalog validation,
2. catalog subsetting, and
3. HTML views of catalogs (full or subset) and datasets.

Currently, handles the following TDS requests:

• Mapping="/remoteCatalogService"

NOTE: Only supported if CatalogServices/allowRemote is set to "true" in threddsConfig.xml.

Uses the following information from an HTTP request:

• The "catalog" parameter gives the URI of a remote catalog.
• The "command" parameter must either be empty or have one of the following values: "SHOW", "SUBSET", or "VALIDATE", see Command.
• The "dataset" parameter identifies a dataset contained by the local catalog. [Used only in "SUBSET" requests.]
• The "htmlView" parameter indicates if an HTML or XML view is desired. [Used only in "SUBSET" requests.]
• The "verbose" parameter indicates if the output of a "VALIDATE" request should be verbose ("true") or not ("false" or not given).

Constraints on the above information:

• The catalog URI must be absolute and is expected to reference a THREDDS catalog XML document.
• The "dataset" parameter must either be empty or contain the value of a dataset ID contained in the catalog.
• If the "command" parameter is empty, it will default to "SHOW" if the "dataset" parameter is empty, otherwise it will default to "SUBSET".

The above information is contained in a RemoteCatalogRequest command object, default values are set during binding by RemoteCatalogRequestDataBinder, and constraints are enforced by RemoteCatalogRequestValidator.

Since:

4.0

See Also:

TdsPathUtils.extractPath(HttpServletRequest req, String removePrefix), Command, RemoteCatalogRequest, RemoteCatalogRequestDataBinder, RemoteCatalogRequestValidator

Constructor Summary

Constructors

Constructor and Description
RemoteCatalogServiceController()

Method Summary

Modifier and Type	Method and Description
protected org.springframework.web.servlet.ModelAndView	handleAll(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)

Methods inherited from class java.lang.Object

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

Constructor Detail

RemoteCatalogServiceController

public RemoteCatalogServiceController()

Method Detail

handleAll

@RequestMapping(value="**")
protected org.springframework.web.servlet.ModelAndView handleAll(javax.servlet.http.HttpServletRequest request,
                                                                                             javax.servlet.http.HttpServletResponse response)
                                                                                      throws java.lang.Exception

Throws:

java.lang.Exception