887 lines
		
	
	
	
		
			22 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
		
		
			
		
	
	
			887 lines
		
	
	
	
		
			22 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
|  | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd"> | ||
|  | <!--NewPage--> | ||
|  | <HTML> | ||
|  | <HEAD> | ||
|  | <TITLE> | ||
|  | jala.db.RamDatabase | ||
|  | </TITLE> | ||
|  | <LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style"> | ||
|  | </HEAD> | ||
|  | <SCRIPT> | ||
|  | function asd() | ||
|  | { | ||
|  | parent.document.title="jala.db.RamDatabase"; | ||
|  | } | ||
|  | </SCRIPT> | ||
|  | <BODY BGCOLOR="white" onload="asd();"> | ||
|  | 
 | ||
|  | <!-- ========== START OF NAVBAR ========== --> | ||
|  | <A NAME="navbar_bottom"><!-- --></A> | ||
|  | <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0"> | ||
|  | <TR> | ||
|  | <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> | ||
|  | <A NAME="navbar_bottom_firstrow"><!-- --></A> | ||
|  | <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3"> | ||
|  |   <TR ALIGN="center" VALIGN="top"> | ||
|  |   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> | ||
|  |   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">  <A HREF="overview-summary-Database.js.html"><FONT CLASS="NavBarFont1"><B>File</B></FONT></A> </TD> | ||
|  |   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> | ||
|  |   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="overview-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> | ||
|  |   <!--TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"-->    <!--A HREF="deprecated-list.html"--><!--FONT CLASS="NavBarFont1">Deprecated</FONT--><!--/A--><!-- </TD--> | ||
|  |   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="index-all.html"--><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> | ||
|  |   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> | ||
|  |   </TR> | ||
|  | </TABLE> | ||
|  | </TD> | ||
|  | <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> | ||
|  | <B>Jala 1.3</B> | ||
|  | </EM> | ||
|  | </TD | ||
|  | </TR> | ||
|  | 
 | ||
|  | <TR> | ||
|  | <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> | ||
|  |  <A HREF="jala.db.FileDatabase.html"><B>PREV CLASS</B></A><!-- 
 | ||
|  |    NEXT CLASS  | ||
|  | --> | ||
|  |  <A HREF="jala.db.Server.html"><B>NEXT CLASS</B></A></FONT></TD> | ||
|  | <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> | ||
|  |   <A HREF="index.html" TARGET="_top"><B>FRAMES</B></A>    | ||
|  |  <A HREF="jala.db.RamDatabase.html" TARGET="_top"><B>NO FRAMES</B></A>    | ||
|  |   | ||
|  | <SCRIPT> | ||
|  |   <!--
 | ||
|  |   if(window==top) { | ||
|  |     document.writeln('<A HREF="allclasses-noframe.html" TARGET=""><B>All Classes</B></A>'); | ||
|  |   } | ||
|  |   //--> | ||
|  | </SCRIPT> | ||
|  | <NOSCRIPT> | ||
|  | <A HREF="allclasses-noframe.html" TARGET=""><B>All Classes</B></A> | ||
|  | </NOSCRIPT> | ||
|  | </FONT></TD> | ||
|  | </TR> | ||
|  | <TR> | ||
|  | <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> | ||
|  |   SUMMARY: <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> | ||
|  | <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> | ||
|  | DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> | ||
|  | </TR> | ||
|  | </TABLE> | ||
|  | <!-- =========== END OF NAVBAR =========== --> | ||
|  | <HR> | ||
|  | 
 | ||
|  | <!-- ======== START OF CLASS DATA ======== --> | ||
|  | <H2>Class jala.db.RamDatabase</H2> | ||
|  | <PRE>Object | ||
|  |    | | ||
|  |    +--<b>jala.db.RamDatabase</b> | ||
|  | </PRE> | ||
|  | 
 | ||
|  |    <DL> | ||
|  |    <DT> | ||
|  |       <B>Direct Known Subclasses:</B>  | ||
|  |       <DD> | ||
|  |                 <a href="jala.db.FileDatabase.html">jala.db.FileDatabase</a> | ||
|  |       </DD> | ||
|  |    </DL> | ||
|  | 
 | ||
|  | 
 | ||
|  | <HR> | ||
|  | <DL> | ||
|  |    <!-- Class definition --> | ||
|  |    <DT>class  | ||
|  |    <B>jala.db.RamDatabase</B> | ||
|  |     | ||
|  | 
 | ||
|  | </DL> | ||
|  |     | ||
|  |    <P> | ||
|  |    <BR/>Instances of this class represent an in-memory sql database. | ||
|  |  <br /><strong>Important:</strong> You need the h2.jar in directory "lib/ext" | ||
|  |  of your helma installation for this library to work, which you can get | ||
|  |  at http://www.h2database.com/. | ||
|  |  <BR/><I>Defined in <a href='overview-summary-Database.js.html'>Database.js</a></I><BR/><BR/> | ||
|  |    </P> | ||
|  |     | ||
|  |    <HR> | ||
|  | 
 | ||
|  | <!-- ======== NESTED CLASS SUMMARY ======== --> | ||
|  | 
 | ||
|  | <!-- ======== END NESTED CLASS SUMMARY ======== --> | ||
|  | 
 | ||
|  | 
 | ||
|  | <!-- =========== FIELD SUMMARY =========== --> | ||
|  | 
 | ||
|  | 
 | ||
|  |     | ||
|  | 
 | ||
|  | <!-- =========== END FIELD SUMMARY =========== --> | ||
|  | 
 | ||
|  | 
 | ||
|  | <!-- ======== CONSTRUCTOR SUMMARY ======== --> | ||
|  | 
 | ||
|  | <A NAME="constructor_summary"><!-- --></A> | ||
|  | <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"> | ||
|  | <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> | ||
|  | <TD COLSPAN=2><FONT SIZE="+2"> | ||
|  | <B>Constructor Summary</B></FONT></TD> | ||
|  | </TR> | ||
|  | <TR BGCOLOR="white" CLASS="TableRowColor"> | ||
|  |    <TD> | ||
|  |       <CODE> | ||
|  | 	 <B> | ||
|  | 	    <A HREF="jala.db.RamDatabase.html#jala.db.RamDatabase()">jala.db.RamDatabase</A>  | ||
|  | 	 </B> | ||
|  | 	 (<String> name, <String> username, <String> password) | ||
|  |       </CODE> | ||
|  |       <BR> | ||
|  |                   | ||
|  |       Returns a newly created RamDatabase instance. | ||
|  |       </TD> | ||
|  | </TR> | ||
|  | </TABLE> | ||
|  | 
 | ||
|  | <!-- ======== END CONSTRUCTOR SUMMARY ======== --> | ||
|  | 
 | ||
|  |   | ||
|  | 
 | ||
|  | <!-- ========== METHOD SUMMARY =========== --> | ||
|  | 
 | ||
|  | <A NAME="method_summary"><!-- --></A> | ||
|  | <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"> | ||
|  | <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> | ||
|  | <TD COLSPAN=2><FONT SIZE="+2"> | ||
|  | <B>Method Summary</B></FONT></TD> | ||
|  | </TR> | ||
|  | 
 | ||
|  | 
 | ||
|  |    <TR BGCOLOR="white" CLASS="TableRowColor"> | ||
|  |       <TD ALIGN="right" VALIGN="top" WIDTH="1%"> | ||
|  | 	 <FONT SIZE="-1"> | ||
|  | 	    <CODE> void</CODE> | ||
|  | 	 </FONT> | ||
|  |       </TD> | ||
|  |       <TD> | ||
|  | 	 <CODE> | ||
|  | 	    <B> | ||
|  | 	       <A HREF="#copyTables">copyTables</A></B>(<helma.Database> database, <Array> tables) | ||
|  | 	 </CODE> | ||
|  | 	 <BR> | ||
|  | 	            | ||
|  | 	 Copies all tables in the database passed as argument into this embedded database. | ||
|  |       </TD> | ||
|  |    </TR> | ||
|  | 
 | ||
|  |    <TR BGCOLOR="white" CLASS="TableRowColor"> | ||
|  |       <TD ALIGN="right" VALIGN="top" WIDTH="1%"> | ||
|  | 	 <FONT SIZE="-1"> | ||
|  | 	    <CODE> Boolean</CODE> | ||
|  | 	 </FONT> | ||
|  |       </TD> | ||
|  |       <TD> | ||
|  | 	 <CODE> | ||
|  | 	    <B> | ||
|  | 	       <A HREF="#dropTable">dropTable</A></B>(<String> tableName) | ||
|  | 	 </CODE> | ||
|  | 	 <BR> | ||
|  | 	            | ||
|  | 	 Drops the table with the given name | ||
|  |       </TD> | ||
|  |    </TR> | ||
|  | 
 | ||
|  |    <TR BGCOLOR="white" CLASS="TableRowColor"> | ||
|  |       <TD ALIGN="right" VALIGN="top" WIDTH="1%"> | ||
|  | 	 <FONT SIZE="-1"> | ||
|  | 	    <CODE> Boolean</CODE> | ||
|  | 	 </FONT> | ||
|  |       </TD> | ||
|  |       <TD> | ||
|  | 	 <CODE> | ||
|  | 	    <B> | ||
|  | 	       <A HREF="#dump">dump</A></B>(<helma.File> file, <Object> props) | ||
|  | 	 </CODE> | ||
|  | 	 <BR> | ||
|  | 	            | ||
|  | 	 Dumps the database schema and data into a file | ||
|  |       </TD> | ||
|  |    </TR> | ||
|  | 
 | ||
|  |    <TR BGCOLOR="white" CLASS="TableRowColor"> | ||
|  |       <TD ALIGN="right" VALIGN="top" WIDTH="1%"> | ||
|  | 	 <FONT SIZE="-1"> | ||
|  | 	    <CODE> helma.Database</CODE> | ||
|  | 	 </FONT> | ||
|  |       </TD> | ||
|  |       <TD> | ||
|  | 	 <CODE> | ||
|  | 	    <B> | ||
|  | 	       <A HREF="#getConnection">getConnection</A></B>(props) | ||
|  | 	 </CODE> | ||
|  | 	 <BR> | ||
|  | 	            | ||
|  | 	 Returns a connection to this database | ||
|  |       </TD> | ||
|  |    </TR> | ||
|  | 
 | ||
|  |    <TR BGCOLOR="white" CLASS="TableRowColor"> | ||
|  |       <TD ALIGN="right" VALIGN="top" WIDTH="1%"> | ||
|  | 	 <FONT SIZE="-1"> | ||
|  | 	    <CODE> String</CODE> | ||
|  | 	 </FONT> | ||
|  |       </TD> | ||
|  |       <TD> | ||
|  | 	 <CODE> | ||
|  | 	    <B> | ||
|  | 	       <A HREF="#getName">getName</A></B>() | ||
|  | 	 </CODE> | ||
|  | 	 <BR> | ||
|  | 	            | ||
|  | 	 Returns the name of the database | ||
|  |       </TD> | ||
|  |    </TR> | ||
|  | 
 | ||
|  |    <TR BGCOLOR="white" CLASS="TableRowColor"> | ||
|  |       <TD ALIGN="right" VALIGN="top" WIDTH="1%"> | ||
|  | 	 <FONT SIZE="-1"> | ||
|  | 	    <CODE> String</CODE> | ||
|  | 	 </FONT> | ||
|  |       </TD> | ||
|  |       <TD> | ||
|  | 	 <CODE> | ||
|  | 	    <B> | ||
|  | 	       <A HREF="#getPassword">getPassword</A></B>() | ||
|  | 	 </CODE> | ||
|  | 	 <BR> | ||
|  | 	            | ||
|  | 	 Returns the password of this database | ||
|  |       </TD> | ||
|  |    </TR> | ||
|  | 
 | ||
|  |    <TR BGCOLOR="white" CLASS="TableRowColor"> | ||
|  |       <TD ALIGN="right" VALIGN="top" WIDTH="1%"> | ||
|  | 	 <FONT SIZE="-1"> | ||
|  | 	    <CODE> helma.util.ResourceProperties</CODE> | ||
|  | 	 </FONT> | ||
|  |       </TD> | ||
|  |       <TD> | ||
|  | 	 <CODE> | ||
|  | 	    <B> | ||
|  | 	       <A HREF="#getProperties">getProperties</A></B>(<Object> props) | ||
|  | 	 </CODE> | ||
|  | 	 <BR> | ||
|  | 	            | ||
|  | 	 Returns a properties object containing the connection properties | ||
|  |  for this database. | ||
|  |       </TD> | ||
|  |    </TR> | ||
|  | 
 | ||
|  |    <TR BGCOLOR="white" CLASS="TableRowColor"> | ||
|  |       <TD ALIGN="right" VALIGN="top" WIDTH="1%"> | ||
|  | 	 <FONT SIZE="-1"> | ||
|  | 	    <CODE> String</CODE> | ||
|  | 	 </FONT> | ||
|  |       </TD> | ||
|  |       <TD> | ||
|  | 	 <CODE> | ||
|  | 	    <B> | ||
|  | 	       <A HREF="#getUrl">getUrl</A></B>(<Object> props) | ||
|  | 	 </CODE> | ||
|  | 	 <BR> | ||
|  | 	            | ||
|  | 	 Returns the JDBC Url to connect to this database | ||
|  |       </TD> | ||
|  |    </TR> | ||
|  | 
 | ||
|  |    <TR BGCOLOR="white" CLASS="TableRowColor"> | ||
|  |       <TD ALIGN="right" VALIGN="top" WIDTH="1%"> | ||
|  | 	 <FONT SIZE="-1"> | ||
|  | 	    <CODE> String</CODE> | ||
|  | 	 </FONT> | ||
|  |       </TD> | ||
|  |       <TD> | ||
|  | 	 <CODE> | ||
|  | 	    <B> | ||
|  | 	       <A HREF="#getUsername">getUsername</A></B>() | ||
|  | 	 </CODE> | ||
|  | 	 <BR> | ||
|  | 	            | ||
|  | 	 Returns the username of this database | ||
|  |       </TD> | ||
|  |    </TR> | ||
|  | 
 | ||
|  |    <TR BGCOLOR="white" CLASS="TableRowColor"> | ||
|  |       <TD ALIGN="right" VALIGN="top" WIDTH="1%"> | ||
|  | 	 <FONT SIZE="-1"> | ||
|  | 	    <CODE> Boolean</CODE> | ||
|  | 	 </FONT> | ||
|  |       </TD> | ||
|  |       <TD> | ||
|  | 	 <CODE> | ||
|  | 	    <B> | ||
|  | 	       <A HREF="#runScript">runScript</A></B>(<helma.File> file, <Object> props, <String> charset, <Boolean> continueOnError) | ||
|  | 	 </CODE> | ||
|  | 	 <BR> | ||
|  | 	            | ||
|  | 	 Runs the script file passed as argument in the context of this database. | ||
|  |       </TD> | ||
|  |    </TR> | ||
|  | 
 | ||
|  |    <TR BGCOLOR="white" CLASS="TableRowColor"> | ||
|  |       <TD ALIGN="right" VALIGN="top" WIDTH="1%"> | ||
|  | 	 <FONT SIZE="-1"> | ||
|  | 	    <CODE> void</CODE> | ||
|  | 	 </FONT> | ||
|  |       </TD> | ||
|  |       <TD> | ||
|  | 	 <CODE> | ||
|  | 	    <B> | ||
|  | 	       <A HREF="#shutdown">shutdown</A></B>() | ||
|  | 	 </CODE> | ||
|  | 	 <BR> | ||
|  | 	            | ||
|  | 	 Stops this in-process database by issueing a "SHUTDOWN" sql command. | ||
|  |       </TD> | ||
|  |    </TR> | ||
|  | 
 | ||
|  |    <TR BGCOLOR="white" CLASS="TableRowColor"> | ||
|  |       <TD ALIGN="right" VALIGN="top" WIDTH="1%"> | ||
|  | 	 <FONT SIZE="-1"> | ||
|  | 	    <CODE> Boolean</CODE> | ||
|  | 	 </FONT> | ||
|  |       </TD> | ||
|  |       <TD> | ||
|  | 	 <CODE> | ||
|  | 	    <B> | ||
|  | 	       <A HREF="#tableExists">tableExists</A></B>(<String> name) | ||
|  | 	 </CODE> | ||
|  | 	 <BR> | ||
|  | 	            | ||
|  | 	 Returns true if the table exists already in the database | ||
|  |       </TD> | ||
|  |    </TR> | ||
|  | 
 | ||
|  | 
 | ||
|  | </TABLE> | ||
|  | 
 | ||
|  | 
 | ||
|  | 
 | ||
|  | <P> | ||
|  | <!-- ========== END METHOD SUMMARY =========== --> | ||
|  | 
 | ||
|  | 
 | ||
|  | <!-- ============ FIELD DETAIL START =========== --> | ||
|  | 
 | ||
|  | 
 | ||
|  | <!-- ============ FIELD DETAIL END =========== --> | ||
|  | 
 | ||
|  |     <!-- ========= CONSTRUCTOR DETAIL START ======== --> | ||
|  | 
 | ||
|  | <A NAME="constructor_detail"><!-- --></A> | ||
|  | <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"> | ||
|  |    <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> | ||
|  |       <TD COLSPAN=1> | ||
|  |       <FONT SIZE="+2"><B>Constructor Detail</B></FONT> | ||
|  |       </TD> | ||
|  |    </TR> | ||
|  | </TABLE> | ||
|  | 
 | ||
|  | <A NAME="jala.db.RamDatabase()"><!-- --></A><H3> | ||
|  | jala.db.RamDatabase</H3> | ||
|  | <PRE><B>jala.db.RamDatabase</B>(<String> name, <String> username, <String> password)</PRE> | ||
|  | 
 | ||
|  | 
 | ||
|  | <UL> | ||
|  |    Returns a newly created RamDatabase instance. | ||
|  | </UL> | ||
|  | 
 | ||
|  | 
 | ||
|  | 
 | ||
|  |    <UL> | ||
|  |    <B>Parameters:</B> | ||
|  |     | ||
|  |      <UL><CODE>name</CODE> -  The name of the database. If not given a private  un-named database is created, that can only be accessed through this instance  of jala.db.RamDatabase   | ||
|  |      </UL> | ||
|  |     | ||
|  |      <UL><CODE>username</CODE> -  Optional username (defaults to "sa"). This username  is used when creating the database, so the same should be used when  creating subsequent instances of jala.db.RamDatabase pointing to a named  database.   | ||
|  |      </UL> | ||
|  |     | ||
|  |      <UL><CODE>password</CODE> -  Optional password (defaults to "").   | ||
|  |      </UL> | ||
|  |     | ||
|  |     | ||
|  |    </UL> | ||
|  | 
 | ||
|  | 
 | ||
|  | <!-- Constructor return value(s) --> | ||
|  | 
 | ||
|  |    <UL> | ||
|  |    <B>Returns:</B> | ||
|  |      <UL> | ||
|  |      A newly created instance of RamDatabase    | ||
|  |      </UL> | ||
|  |    </UL> | ||
|  | 
 | ||
|  | <!-- End constructor return value(s) --> | ||
|  | 
 | ||
|  | <!-- ADDITIONAL ATTRIBUTES --> | ||
|  | 
 | ||
|  | <HR/> | ||
|  | <!-- END ADDITIONAL ATTRIBUTES  --> | ||
|  | 
 | ||
|  | <!-- ========= CONSTRUCTOR DETAIL END ======== --> | ||
|  | 
 | ||
|  | 
 | ||
|  | <!-- ============ METHOD DETAIL START ========== --> | ||
|  | 
 | ||
|  | <A NAME="method_detail"><!-- --></A> | ||
|  | <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"> | ||
|  |    <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> | ||
|  |       <TD COLSPAN=1><FONT SIZE="+2"> | ||
|  |          <B>Method Detail</B></FONT> | ||
|  |       </TD> | ||
|  |    </TR> | ||
|  | </TABLE> | ||
|  | 
 | ||
|  | <!-- One single method detail entry --> | ||
|  | 
 | ||
|  |    <A NAME="copyTables"><!-- --></A> | ||
|  |    <H3>copyTables</H3> | ||
|  |    <PRE>void <B>copyTables</B>(<helma.Database> database, <Array> tables)</PRE> | ||
|  |     | ||
|  |       <UL>Copies all tables in the database passed as argument into this embedded database. | ||
|  |  If any of the tables already exists in this database, they will be removed before | ||
|  |  re-created. Please mind that this method ignores any indexes in the source database, | ||
|  |  but respects the primary key settings.</UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- METHOD PARAMETERS START --> | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Parameters:</B> | ||
|  |     | ||
|  |      <UL><CODE>database</CODE> -  The database to copy the tables from   | ||
|  |       </UL>  | ||
|  |     | ||
|  |      <UL><CODE>tables</CODE> -  An optional array containing the names of the tables to copy.  If not given all tables are copied     | ||
|  |       </UL>  | ||
|  |     | ||
|  |    </UL> | ||
|  |     | ||
|  |    <!-- METHOD PARAMETERS END --> | ||
|  | 
 | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- ADDITIONAL ATTRIBUTES START --> | ||
|  |     | ||
|  |    <!-- ADDITIONAL ATTRIBUTES  END --> | ||
|  | <HR> | ||
|  | 
 | ||
|  |    <A NAME="dropTable"><!-- --></A> | ||
|  |    <H3>dropTable</H3> | ||
|  |    <PRE>Boolean <B>dropTable</B>(<String> tableName)</PRE> | ||
|  |     | ||
|  |       <UL>Drops the table with the given name</UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- METHOD PARAMETERS START --> | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Parameters:</B> | ||
|  |     | ||
|  |      <UL><CODE>tableName</CODE> -  The name of the table   | ||
|  |       </UL>  | ||
|  |     | ||
|  |    </UL> | ||
|  |     | ||
|  |    <!-- METHOD PARAMETERS END --> | ||
|  | 
 | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Returns:</B> | ||
|  |         <UL> | ||
|  |         True if the table was successfully dropped, false otherwise    | ||
|  |         </UL> | ||
|  |    </UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- ADDITIONAL ATTRIBUTES START --> | ||
|  |     | ||
|  |    <!-- ADDITIONAL ATTRIBUTES  END --> | ||
|  | <HR> | ||
|  | 
 | ||
|  |    <A NAME="dump"><!-- --></A> | ||
|  |    <H3>dump</H3> | ||
|  |    <PRE>Boolean <B>dump</B>(<helma.File> file, <Object> props)</PRE> | ||
|  |     | ||
|  |       <UL>Dumps the database schema and data into a file</UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- METHOD PARAMETERS START --> | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Parameters:</B> | ||
|  |     | ||
|  |      <UL><CODE>file</CODE> -  The file where the database dump will be   | ||
|  |       </UL>  | ||
|  |     | ||
|  |      <UL><CODE>props</CODE> -  Optional object containing connection properties   | ||
|  |       </UL>  | ||
|  |     | ||
|  |    </UL> | ||
|  |     | ||
|  |    <!-- METHOD PARAMETERS END --> | ||
|  | 
 | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Returns:</B> | ||
|  |         <UL> | ||
|  |         True in case the database was successfully dumped, false otherwise    | ||
|  |         </UL> | ||
|  |    </UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- ADDITIONAL ATTRIBUTES START --> | ||
|  |     | ||
|  |    <!-- ADDITIONAL ATTRIBUTES  END --> | ||
|  | <HR> | ||
|  | 
 | ||
|  |    <A NAME="getConnection"><!-- --></A> | ||
|  |    <H3>getConnection</H3> | ||
|  |    <PRE>helma.Database <B>getConnection</B>(props)</PRE> | ||
|  |     | ||
|  |       <UL>Returns a connection to this database</UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- METHOD PARAMETERS START --> | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Parameters:</B> | ||
|  |     | ||
|  |      <UL><CODE>An</CODE> -  optional parameter object containing connection  properties to add to the connection Url.   | ||
|  |       </UL>  | ||
|  |     | ||
|  |    </UL> | ||
|  |     | ||
|  |    <!-- METHOD PARAMETERS END --> | ||
|  | 
 | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Returns:</B> | ||
|  |         <UL> | ||
|  |         A connection to this database    | ||
|  |         </UL> | ||
|  |    </UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- ADDITIONAL ATTRIBUTES START --> | ||
|  |     | ||
|  |    <!-- ADDITIONAL ATTRIBUTES  END --> | ||
|  | <HR> | ||
|  | 
 | ||
|  |    <A NAME="getName"><!-- --></A> | ||
|  |    <H3>getName</H3> | ||
|  |    <PRE>String <B>getName</B>()</PRE> | ||
|  |     | ||
|  |       <UL>Returns the name of the database</UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- METHOD PARAMETERS START --> | ||
|  |     | ||
|  |    <!-- METHOD PARAMETERS END --> | ||
|  | 
 | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Returns:</B> | ||
|  |         <UL> | ||
|  |         The name of the database    | ||
|  |         </UL> | ||
|  |    </UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- ADDITIONAL ATTRIBUTES START --> | ||
|  |     | ||
|  |    <!-- ADDITIONAL ATTRIBUTES  END --> | ||
|  | <HR> | ||
|  | 
 | ||
|  |    <A NAME="getPassword"><!-- --></A> | ||
|  |    <H3>getPassword</H3> | ||
|  |    <PRE>String <B>getPassword</B>()</PRE> | ||
|  |     | ||
|  |       <UL>Returns the password of this database</UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- METHOD PARAMETERS START --> | ||
|  |     | ||
|  |    <!-- METHOD PARAMETERS END --> | ||
|  | 
 | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Returns:</B> | ||
|  |         <UL> | ||
|  |         The password of this database    | ||
|  |         </UL> | ||
|  |    </UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- ADDITIONAL ATTRIBUTES START --> | ||
|  |     | ||
|  |    <!-- ADDITIONAL ATTRIBUTES  END --> | ||
|  | <HR> | ||
|  | 
 | ||
|  |    <A NAME="getProperties"><!-- --></A> | ||
|  |    <H3>getProperties</H3> | ||
|  |    <PRE>helma.util.ResourceProperties <B>getProperties</B>(<Object> props)</PRE> | ||
|  |     | ||
|  |       <UL>Returns a properties object containing the connection properties | ||
|  |  for this database.</UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- METHOD PARAMETERS START --> | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Parameters:</B> | ||
|  |     | ||
|  |      <UL><CODE>props</CODE> -  An optional parameter object containing  connection properties to add to the connection Url.   | ||
|  |       </UL>  | ||
|  |     | ||
|  |    </UL> | ||
|  |     | ||
|  |    <!-- METHOD PARAMETERS END --> | ||
|  | 
 | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Returns:</B> | ||
|  |         <UL> | ||
|  |         A properties object containing the connection properties    | ||
|  |         </UL> | ||
|  |    </UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- ADDITIONAL ATTRIBUTES START --> | ||
|  |     | ||
|  |    <!-- ADDITIONAL ATTRIBUTES  END --> | ||
|  | <HR> | ||
|  | 
 | ||
|  |    <A NAME="getUrl"><!-- --></A> | ||
|  |    <H3>getUrl</H3> | ||
|  |    <PRE>String <B>getUrl</B>(<Object> props)</PRE> | ||
|  |     | ||
|  |       <UL>Returns the JDBC Url to connect to this database</UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- METHOD PARAMETERS START --> | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Parameters:</B> | ||
|  |     | ||
|  |      <UL><CODE>props</CODE> -  Optional connection properties to add   | ||
|  |       </UL>  | ||
|  |     | ||
|  |    </UL> | ||
|  |     | ||
|  |    <!-- METHOD PARAMETERS END --> | ||
|  | 
 | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Returns:</B> | ||
|  |         <UL> | ||
|  |         The JDBC url to use for connecting to this database    | ||
|  |         </UL> | ||
|  |    </UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- ADDITIONAL ATTRIBUTES START --> | ||
|  |     | ||
|  |    <!-- ADDITIONAL ATTRIBUTES  END --> | ||
|  | <HR> | ||
|  | 
 | ||
|  |    <A NAME="getUsername"><!-- --></A> | ||
|  |    <H3>getUsername</H3> | ||
|  |    <PRE>String <B>getUsername</B>()</PRE> | ||
|  |     | ||
|  |       <UL>Returns the username of this database</UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- METHOD PARAMETERS START --> | ||
|  |     | ||
|  |    <!-- METHOD PARAMETERS END --> | ||
|  | 
 | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Returns:</B> | ||
|  |         <UL> | ||
|  |         The username of this database    | ||
|  |         </UL> | ||
|  |    </UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- ADDITIONAL ATTRIBUTES START --> | ||
|  |     | ||
|  |    <!-- ADDITIONAL ATTRIBUTES  END --> | ||
|  | <HR> | ||
|  | 
 | ||
|  |    <A NAME="runScript"><!-- --></A> | ||
|  |    <H3>runScript</H3> | ||
|  |    <PRE>Boolean <B>runScript</B>(<helma.File> file, <Object> props, <String> charset, <Boolean> continueOnError)</PRE> | ||
|  |     | ||
|  |       <UL>Runs the script file passed as argument in the context of this database. | ||
|  |  Use this method to eg. create and/or populate a database.</UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- METHOD PARAMETERS START --> | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Parameters:</B> | ||
|  |     | ||
|  |      <UL><CODE>file</CODE> -  The script file to run   | ||
|  |       </UL>  | ||
|  |     | ||
|  |      <UL><CODE>props</CODE> -  Optional object containing connection properties   | ||
|  |       </UL>  | ||
|  |     | ||
|  |      <UL><CODE>charset</CODE> -  Optional character set to use (defaults to "UTF-8")   | ||
|  |       </UL>  | ||
|  |     | ||
|  |      <UL><CODE>continueOnError</CODE> -  Optional flag indicating whether to continue  on error or not (defaults to false)   | ||
|  |       </UL>  | ||
|  |     | ||
|  |    </UL> | ||
|  |     | ||
|  |    <!-- METHOD PARAMETERS END --> | ||
|  | 
 | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Returns:</B> | ||
|  |         <UL> | ||
|  |         True in case the script was executed successfully, false otherwise    | ||
|  |         </UL> | ||
|  |    </UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- ADDITIONAL ATTRIBUTES START --> | ||
|  |     | ||
|  |    <!-- ADDITIONAL ATTRIBUTES  END --> | ||
|  | <HR> | ||
|  | 
 | ||
|  |    <A NAME="shutdown"><!-- --></A> | ||
|  |    <H3>shutdown</H3> | ||
|  |    <PRE>void <B>shutdown</B>()</PRE> | ||
|  |     | ||
|  |       <UL>Stops this in-process database by issueing a "SHUTDOWN" sql command.</UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- METHOD PARAMETERS START --> | ||
|  |     | ||
|  |    <!-- METHOD PARAMETERS END --> | ||
|  | 
 | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- ADDITIONAL ATTRIBUTES START --> | ||
|  |     | ||
|  |    <!-- ADDITIONAL ATTRIBUTES  END --> | ||
|  | <HR> | ||
|  | 
 | ||
|  |    <A NAME="tableExists"><!-- --></A> | ||
|  |    <H3>tableExists</H3> | ||
|  |    <PRE>Boolean <B>tableExists</B>(<String> name)</PRE> | ||
|  |     | ||
|  |       <UL>Returns true if the table exists already in the database</UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- METHOD PARAMETERS START --> | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Parameters:</B> | ||
|  |     | ||
|  |      <UL><CODE>name</CODE> -  The name of the table   | ||
|  |       </UL>  | ||
|  |     | ||
|  |    </UL> | ||
|  |     | ||
|  |    <!-- METHOD PARAMETERS END --> | ||
|  | 
 | ||
|  |     | ||
|  |    <UL> | ||
|  |    <B>Returns:</B> | ||
|  |         <UL> | ||
|  |         True if the table exists, false otherwise    | ||
|  |         </UL> | ||
|  |    </UL> | ||
|  |     | ||
|  | 
 | ||
|  |    <!-- ADDITIONAL ATTRIBUTES START --> | ||
|  |     | ||
|  |    <!-- ADDITIONAL ATTRIBUTES  END --> | ||
|  | <HR> | ||
|  | 
 | ||
|  | 
 | ||
|  | 
 | ||
|  | <!-- ============ METHOD DETAIL END ========== --> | ||
|  | 
 | ||
|  | <!-- ========= END OF CLASS DATA ========= --> | ||
|  | 
 | ||
|  | <!-- ========== START OF NAVBAR ========== --> | ||
|  | <A NAME="navbar_bottom"><!-- --></A> | ||
|  | <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0"> | ||
|  | <TR> | ||
|  | <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> | ||
|  | <A NAME="navbar_bottom_firstrow"><!-- --></A> | ||
|  | <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3"> | ||
|  |   <TR ALIGN="center" VALIGN="top"> | ||
|  |   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> | ||
|  |   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">  <A HREF="overview-summary-Database.js.html"><FONT CLASS="NavBarFont1"><B>File</B></FONT></A> </TD> | ||
|  |   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev">  <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> | ||
|  |   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="overview-tree.html"><FONT CLASS="NavBarFont1"><b>Tree</b></FONT></A> </TD> | ||
|  |   <!--TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"-->    <!--A HREF="deprecated-list.html"--><!--FONT CLASS="NavBarFont1">Deprecated</FONT--><!--/A--><!-- </TD--> | ||
|  |   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> | ||
|  |   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> | ||
|  |   </TR> | ||
|  | </TABLE> | ||
|  | </TD> | ||
|  | <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> | ||
|  | <B>Jala 1.3</B> | ||
|  | </EM> | ||
|  | </TD | ||
|  | </TR> | ||
|  | 
 | ||
|  | <TR> | ||
|  | <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> | ||
|  |  <A HREF="jala.db.FileDatabase.html"><B>PREV CLASS</B></A><!-- 
 | ||
|  |    NEXT CLASS  | ||
|  | --> | ||
|  |  <A HREF="jala.db.Server.html"><B>NEXT CLASS</B></A></FONT></TD> | ||
|  | <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> | ||
|  |   <A HREF="index.html" TARGET="_top"><B>FRAMES</B></A>    | ||
|  |  <A HREF="jala.db.RamDatabase.html" TARGET="_top"><B>NO FRAMES</B></A>    | ||
|  |   | ||
|  | <SCRIPT> | ||
|  |   <!--
 | ||
|  |   if(window==top) { | ||
|  |     document.writeln('<A HREF="allclasses-noframe.html" TARGET=""><B>All Classes</B></A>'); | ||
|  |   } | ||
|  |   //--> | ||
|  | </SCRIPT> | ||
|  | <NOSCRIPT> | ||
|  | <A HREF="allclasses-noframe.html" TARGET=""><B>All Classes</B></A> | ||
|  | </NOSCRIPT> | ||
|  | </FONT></TD> | ||
|  | </TR> | ||
|  | <TR> | ||
|  | <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> | ||
|  |   SUMMARY: <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> | ||
|  | <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> | ||
|  | DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> | ||
|  | </TR> | ||
|  | </TABLE> | ||
|  | 
 | ||
|  | <!-- =========== END OF NAVBAR =========== --> | ||
|  | 
 | ||
|  | <HR> | ||
|  | <FONT SIZE="-1"> | ||
|  | 
 | ||
|  | </FONT> | ||
|  | <div class="jsdoc_ctime">Documentation generated by <a href="http://jsdoc.sourceforge.net/" target="_parent">JSDoc</a> on Tue Jan  8 15:45:31 2008</div> | ||
|  | </BODY> | ||
|  | </HTML> |