dods.servers.sql
Class drds
java.lang.Object
javax.servlet.GenericServlet
javax.servlet.http.HttpServlet
dods.servlet.DODSServlet
dods.servers.sql.dodsSQLServlet
dods.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.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 |
drds
public drds()
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:
- Makes a newsqlServerFactory (aka BaseTypeFactory) for the
dataset requested.
- Instantiates a sqlDDS using the sqlServerFactory and populates
it (this is accomplished by opening a locally cached DDS from a file
and parsing it)
- Returns this freshly minted sqlDDS object (to the servlet code
where it is used.)
- 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