dods.servers.sql
Class drds

java.lang.Object
  extended by HttpServlet
      extended by dods.servlet.DODSServlet
          extended by dods.servers.sql.dodsSQLServlet
              extended by dods.servers.sql.drds

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.3 $
Author:
Nathan David Potter

Constructor Summary
drds()
           
 
Method Summary
 String getServerVersion()
          This method returns a String containing the DODS Server Version...
protected  GuardedSQLDataset getSQLDataset(requestState 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
connect2DB, 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 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

drds

public drds()
Method Detail

getServerVersion

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

Specified by:
getServerVersion in class dodsSQLServlet

getSQLDataset

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

Specified by:
getSQLDataset in class dodsSQLServlet
Parameters:
dataSet - The name of the data set requested.
Throws:
DODSException
IOException
ParseException
See Also:
ServerDDS, sqlServerFactory, test_ServerFactory