dods.servers.sql
Class drds

java.lang.Object
  extended byjavax.servlet.GenericServlet
      extended byjavax.servlet.http.HttpServlet
          extended bydods.servlet.DODSServlet
              extended bydods.servers.sql.dodsSQLServlet
                  extended bydods.servers.sql.drds
All Implemented Interfaces:
java.io.Serializable, javax.servlet.Servlet, javax.servlet.ServletConfig

public class drds
extends dodsSQLServlet

This servlet, the DODS Relational Database Server (drds), uses the generic implementation of the DODS SQL server types. This implementation allows this servlet to deliver all JDBC data types with the exception of the BLOB (Binary Large Object) types such as BINARY, VARBINARY and LONGVARBINARY. This implies that when serving data from a DBMS containing tables that use the cooresponding types for that DBMS (such as the IMAGE type in Microsofts SQL Server 7.0 product) this servlet will NOT be delivering that information. If the owner of the DODS server installation wishes to server these types of data they will have to extend the implementations of the DODS Server types found in the dods.dap.Server.sql package to do so. Have Fun :)

Configuration:
The DODSServlet relies on the javax.servlet.ServletConfig interface (in particular the getInitParameter() method) to retrieve configuration information used by the servlet. InitParameters:

Here is an example entry from the web.xml file (for tomcat3.3a) associated with a DRDS servlet:
        <servlet>
            <servlet-name>
                drds
            </servlet-name>

            <servlet-class>
                dods.servers.sql.drds
            </servlet-class>

            <init-param>
                <param-name>JDBCdriver</param-name>
                <param-value> com.merant.sequelink.jdbc.SequeLinkDriver</param-value>
            </init-param>

            <init-param>
                <param-name>JDBCconnectionURL</param-name>
                <param-value>jdbc:sequelink://sugar:19996</param-value>
            </init-param>

            <init-param>
                <param-name>JDBCusername</param-name>
                <param-value>guest</param-value>
            </init-param>

            <init-param>
                <param-name>JDBCpassword</param-name>
                <param-value></param-value>
            </init-param>

            <init-param>
                <param-name>JDBCMaxResponseLength</param-name>
                <param-value>300</param-value>
            </init-param>

            <init-param>
                <param-name>UseDatasetName</param-name>
                <param-value></param-value>
            </init-param>

            <init-param>
                <param-name>INFOcache</param-name>
                <param-value>/usr/Java-DODS/sdds-testsuite/info/</param-value>
            </init-param>

            <init-param>
                <param-name>DDScache</param-name>
                <param-value>/usr/Java-DODS/sdds-testsuite/dds/</param-value>
            </init-param>

            <init-param>
                <param-name>DAScache</param-name>
                <param-value>/usr/Java-DODS/sdds-testsuite/das/</param-value>
            </init-param>

            <init-param>
                <param-name>DebugOn</param-name>
                <param-value>showRequest showResponse JDBC</param-value>
            </init-param>

        </servlet>

Version:
$Revision: 1.7.2.3 $
Author:
Nathan David Potter
See Also:
Serialized Form

Constructor Summary
drds()
           
 
Method Summary
 java.lang.String getServerVersion()
          This method returns a String containing the DODS Server Version...
protected  GuardedSQLDataset getSQLDataset(ReqState rs)
          For the DODS SQL server this method does the following: Makes a newsqlServerFactory (aka BaseTypeFactory) for the dataset requested.
 
Methods inherited from class dods.servers.sql.dodsSQLServlet
doGetDODS, getDataset, init, printColumnNames, processResult
 
Methods inherited from class dods.servlet.DODSServlet
anyExceptionHandler, badURL, dodsExceptionHandler, doGet, doGetASC, doGetCatalog, doGetDAS, doGetDDS, doGetDIR, doGetHELP, doGetHTML, doGetINFO, doGetStatus, doGetVER, getDAS, getServerName, isTheClientCompressed, openCachedDAS, openCachedDDS, parseExceptionHandler, printCatalog, printStatus, probeRequest, processDodsURL, sendDODSError
 
Methods inherited from class javax.servlet.http.HttpServlet
doDelete, doHead, doOptions, doPost, doPut, doTrace, getLastModified, service, service
 
Methods inherited from class javax.servlet.GenericServlet
destroy, getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, init, log, log
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

drds

public drds()
Method Detail

getServerVersion

public java.lang.String getServerVersion()
This method returns a String containing the DODS Server Version...

Specified by:
getServerVersion in class dodsSQLServlet

getSQLDataset

protected GuardedSQLDataset getSQLDataset(ReqState rs)
                                   throws DODSException,
                                          java.io.IOException,
                                          ParseException
For the DODS SQL server this method does the following:

Specified by:
getSQLDataset in class dodsSQLServlet
Parameters:
rs - The ReqState object containing the particulars of this client request..
Throws:
DODSException
java.io.IOException
ParseException
See Also:
ServerDDS, sqlServerFactory, test_ServerFactory