Update faq
[mono.git] / web / ado-net
index 0f40c246db850c254411499bef27532627d6a796..cd6ea65cfe42786a88044795167c06f4ab24123f 100644 (file)
 * ADO.NET
 
-       <p>Mono's ADO.NET Developers:
-       <ul>
-       <li>rodrigo -AT- ximian.comNOSPAM - <b>Rodrigo Moya</b> - coordinator 
-       for the ADO.NET implementation and works on the OLE DB provider</li>
-       <li>danmorg -AT- sc.rr.comNOSPAM - <b>Daniel Morgan</b> - works on
-       the MySQL, PostgreSQL, and Oracle providers</li>
-       <li>tim -AT- timcoleman.comNOSPAM - <b>Tim Coleman</b> - works on
-       the Microsoft SQL Server, Sybase, and TDS providers</li>
-       <li>brianlritchie -AT- hotmail.comNOSPAM - <b>Brian Ritchie</b> - works on
-       the ODBC provider and the ProviderFactory</li>
-       <li>vladimir -AT- pobox.comNOSPAM - <b>Vladimir Vukicevic</b> - works on
-       the SQL Lite provider</li>
-       <li>cleared -AT- rogers.comNOSPAM - <b>Christopher Bockner</b> - works on
-       the IBM DB2 provider</li>
-       <li>vi64pa -AT- koti.soon.fiNOSPAM - <b>Ville Palo</b> - works on XML stuff in System.Data
-       including DataSet, XmlDataDocument, and has done lots of testing</li>
-       </ul>
+<p>Mono's ADO.NET Developers:
+
+<table border=1>
+
+<tr>
+       <td><b>Developer</b></td>
+       <td><b>Email</b></td>
+       <td><b>Contribution</b></td>
+</tr>
+
+<tr>
+       <td>Rodrigo Moya</td>
+       <td>rodrigo -AT-<br> ximian.comNOSPAM</td>
+       <td>ADO.NET coordinator,<br> OLE DB provider,<br> and tests</td>
+</tr>
+
+<tr>
+       <td>Daniel Morgan</td>
+    <td>danmorg -AT-<br> sc.rr.comNOSPAM</td>
+    <td>MySQL, PostgreSQL, <br>Oracle providers,<br> and tests</td>
+</tr>
+
+<tr>
+       <td>Tim Coleman</td>
+       <td>tim -AT- <br>timcoleman.comNOSPAM</td>
+       <td>Microsoft SQL Server, <br>Sybase, <br>TDS providers,<br> Oracle, 
+               <br>and tests.<br>
+               He has
+           contributed <br>to other parts <br>of Mono too, <br>such as, 
+           <br>EnterpriseServices,
+           XML, <br>and WebServices.</td>
+</tr>
+
+<tr>
+       <td>Brian Ritchie</td>
+       <td>brianlritchie -AT-<br> hotmail.comNOSPAM</td>
+       <td>ODBC provider <br>and the ProviderFactory <br>in Mono.Data</td>
+</tr>
+
+<tr>
+       <td>Vladimir Vukicevic</td> 
+       <td>vladimir -AT-<br> pobox.comNOSPAM</td>
+       <td>SQL Lite provider. <br> He has contributed to GTK# <br>and mPhoto too.</td>
+</tr>
+
+<tr>
+       <td>Christopher Bockner</td>
+       <td>cleared -AT-<br> rogers.comNOSPAM</td>
+       <td>IBM DB2 Universal <br>Database provider</td>
+</tr>
+
+<tr>
+       <td>Ville Palo</td>
+       <td>vi64pa -AT-<br> koti.soon.fiNOSPAM</td>
+       <td>XML stuff <br>in System.Data <br>including DataSet <br>
+          and XmlDataDocument, <br>and tests</td>
+</tr>
+
+<tr>
+       <td>Gonzalo Paniagua Javier</td>
+       <td>gonzalo -AT-<br> ximian.comNOSPAM</td>
+       <td>Integration between <br>System.Web and <br>System.Data</td>
+</tr>
+
+<tr>
+       <td>Gaurav Vaish</td>
+       <td>gvaish -AT-<br> iitk.ac.inNOSPAM</td>
+       <td>Web controls</td>
+</tr>
+
+<tr>
+       <td>Phillip Jerkins</td>
+       <td>Phillip.Jerkins -AT-<br> morgankeegan.comNOSPAM</td>
+       <td>Named Instance support <br>in System.Data.SqlClient</td>
+</tr>
+
+</table>
+
+** Bugs and Feature Requests
+
+<ul>
+
+       <li>Bugs with Mono or any data provider in Mono should be reported 
+           in Mono's Bugzilla <a href="http://bugzilla.ximian.com/">here</a>.  If you
+           do not have a Bugzilla user account, it is free 
+           and easy to create 
+           one <a href="http://bugzilla.ximian.com/createaccount.cgi">here</a>.</li>
+       
+       <li>Any RFE (Request For Enhancement) for features missing or new functionality
+           should be entered as a bug in Bugzilla too</li>
+
+</ul>
+       
+** ADO.NET Data Providers
        
-* Action plan
+<p>List of ADO.NET Data Providers working in Mono:
+                       
+<ul>
+       <li><a href="http://www.go-mono.com/ibmdb2.html">IBM DB2 Universal Database</a></li>
+       <li><a href="http://www.go-mono.com/mysql.html">MySQL</a></li>
+       <li><a href="http://www.go-mono.com/odbc.html">ODBC</a></li>
+       <li><a href="http://www.go-mono.com/oracle.html">Oracle</a></li>
+       <li><a href="http://www.go-mono.com/oledb.html">OLE DB</a></li>
+       <li><a href="http://www.go-mono.com/postgresql.html">PostgreSQL</a></li>
+       <li><a href="http://www.go-mono.com/sqlclient.html">Microsoft SQL Server</a></li>
+       <li><a href="http://www.go-mono.com/sqlite.html">SQL Lite</a></li>
+       <li><a href="http://www.go-mono.com/sybase.html">Sybase</a></li>
+       <li><a href="http://www.go-mono.com/tdsclient.html">TDS Generic</a></li>
+</ul>
 
-       <p>The current plan to implement ADO.NET is as follows:
+<p>Providers which we do not have, but we would like to have.  Currently,
+       some of these databases are supported via the ODBC or OLE DB providers.
 
-       <ul>
-               <li>Either create ADO.NET providers or modify pre-exiting ADO.NET providers to
-               work with Mono</li>
-               
-               <ul>
-                       <li>Create ADO.NET Providers
+<ul>
+       <li><a href="http://msdn.microsoft.com/library/en-us/dnsql2k/html/sqlxml_intromanagedclasses.asp?frame=true">Managed Classes for SqlXml</a> which is
+               a .NET data provider for retrieving XML data from a Microsoft SQL Server 2000 database.  The System.Data.SqlClient provider
+               in Mono can be used as a starting point at mcs/class/System.Data/System.Data.SqlClient.</li>
+       <li><a href="http://www.hughes.com.au/">miniSQL</a></li>
+       <li><a href="http://www.sleepycat.com/">BerkeleyDB (Sleepycat)</a></li>
+       <li><a href="http://www.sapdb.org/">SapDB</a></li>
+       <li><a href="http://www-3.ibm.com/software/data/informix/">Informix</a></li>    
+       <li><a href="http://msdn.microsoft.com/vfoxpro/">Foxpro</a></li>        
+       <li>Microsoft Access - could be done by creating C# bindings to <a href="http://mdbtools.sourceforge.net">MDB Tools</a></li>
+       <li>dbase or xbase type database files</li>
+       <li>Others are welcome</li>
+</ul>
+
+<p>External Projects that have created ADO.NET Providers that work on Mono:
+
+<ul>
+
+       <li><a href="http://www.go-mono.com/firebird.html">Firebird Interbase</a></li> is a
+          Firebird SQL Managed data provider. It can be used with Interbase databases too.  It
+          is written in 100%C# and does not require a client library. Works on .NET and Mono.</a>
+       <li><a href="http://gborg.postgresql.org/project/npgsql/projdisplay.php">Npgsql</a> is a 
+          PostgreSQL Managed data provider written 
+          in 100% C#, does not require a client library, and works on .NET and Mono</li>
+       <li><a href="http://sourceforge.net/projects/mysqlnet/">MySQLNet</a> is a 
+          MySQL Managed data provider written in 100% C#, does not
+          require a client library, and works on .NET and Mono</li>
+</ul>
+
+** Tools
+
+<p>Some tools that can be used for ADO.NET and other technologies (ASP.NET, XML, etc).
+
+<ul>   
+               <li><b>SQL# CLI</b> - a SQL query tool with a command-line interface.
+                   It can be used to enter and execute SQL statements or 
+                   execute a batch of SQL commands from a file.   It can
+                 be used to test connection strings, connect to various ADO.NET
+                 providers, save output to text, html, or xml.  It is a work-in-progress.
+                 The SQL# CLI is distributed with the
+                 Mono runtime and class libraries as an executable assembly sqlsharp.exe.
+                 The source to SQL# CLI can be found in the mcs source at
+                 mcs/tools/SqlSharp/SqlSharpCli.cs
+                 </li>
+                 
+               <li><p><b>SQL# GUI - a graphical SQL query tool</b> allows a user
+                 to enter SQL commands in a top panel which is a text editor.  It
+                 has a toolbar and menu for various tasks, such as, executing
+                 SQL commands one-at-a-time or in a batch.  The results would appear
+                 in a bottom panel in a grid or could be saved to a file (xml, html, csv).
+                 Also, the bottom panel would allow logging of SQL command executed.
+                 Currently, there is a <a href="http://go-mono.com/images/sqlsharp.png">SQL# For GTK#</a> which
+                 provides a GUI interface using the <a href="http://gtk-sharp.sourceforge.net">Gtk#</a> toolkit.  SQL# For GTK#
+                 is a work-in-progress and can be found in the mcs source at 
+                 mcs/tools/SqlSharp/gui/gtk-sharp</li>  
+</ul>
+
+<p>Tools we would like to have, but they have not been created yet:
+
+<ul>
+               <li><b>XML Schema Definition tool</b> <a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cptools/html/cpconxmlschemadefinitiontoolxsdexe.asp">xsd.exe</a> needs 
+                       to be created.  Maybe this TODO item should be at the System.XML web page instead.
                        
                        <ul>
-                                       <li><a href="http://www.go-mono.com/ibmdb2.html">IBM DB2 Universal Database</a></li>
-                                       <li><a href="http://www.go-mono.com/mysql.html">MySQL</a></li>
-                                       <li><a href="http://www.go-mono.com/odbc.html">ODBC</a></li>
-                                       <li><a href="http://www.go-mono.com/oracle.html">Oracle</a></li>
-                                       <li><a href="http://www.go-mono.com/oledb.html">OLE DB</a></li>
-                                       <li><a href="http://www.go-mono.com/postgresql.html">PostgreSQL</a></li>
-                                       <li><a href="http://www.go-mono.com/sqlclient.html">Microsoft SQL Server</a></li>
-                                       <li><a href="http://www.go-mono.com/sqlite.html">SQL Lite</a></li>
-                                       <li><a href="http://www.go-mono.com/sybase.html">Sybase</a></li>
-                                       <li><a href="http://www.go-mono.com/tdsclient.html">TDS Generic</a></li>
-                                       <li>Providers which we do not have, but we would like to have.  Currently,
-                                       some of these databases are supported via the ODBC or OLEDB providers.</li>
-                                       <ul>
-                                               <li><a href="http://msdn.microsoft.com/library/en-us/dnsql2k/html/sqlxml_intromanagedclasses.asp?frame=true">Managed Classes for SqlXml</a> which is
-                                               a .NET data provider for retrieving XML data from a Microsoft SQL Server 2000 database.  The System.Data.SqlClient provider
-                                               in Mono can be used as a starting point at mcs/class/System.Data/System.Data.SqlClient.</li>
-                                               <li><a href="http://www.hughes.com.au/">miniSQL</a></li>
-                                               <li><a href="http://www.sleepycat.com/">BerkeleyDB (Sleepycat)</a></li>
-                                               <li><a href="http://www.sapdb.org/">SapDB</a></li>
-                                               <li>Microsoft Access - could be done by creating C# bindings to <a href="http://mdbtools.sourceforge.net">MDB Tools</a></li>
-                                               <li>dbase or xbase type database files</li>
-                                               <li>Others are welcome</li>
-                                       </ul>
-                               </ul></li>
-                               <br>
-                       <li>Modify Pre-existing ADO.NET Providers to work with Mono.  This may
-                       require fixing or implementing areas of Mono too.
-                               <ul>
-                                       <li><a href="http://www.go-mono.com/firebird.html">Firebird Interbase</a></li>
-                                       <li><a href="http://gborg.postgresql.org/project/npgsql/projdisplay.php">Npgsql</a> is a 
-                                          PostgreSQL Managed data provider written 
-                                          in 100% C#, does not require a client library, and works on Mono</li>
-                                       <li><a href="http://sourceforge.net/projects/mysqlnet/">MySQLNet</a> is a 
-                                          MySQL Manager data provider written in 100% C#, does not
-                                          require a client library, and works on Mono</li>
-                               </ul>
+                               <li>This tool
+                                       would work like the xsd.exe tool included with 
+                                       the .NET Framework.  The Xsd.exe tools has the\r
+                                       following uses:\r
+                                       <ul>\r
+                                       <li><b>XDR to XSD</b> - used to generate an XML schema from an XDR (XML Data Reduced schema) file. \r
+                                               XDR was used by Microsoft prior to XSD becoming a W3C recommendation.  So, this needs\r
+                                               to be supported for legacy reasons</li>\r
+                                       <li><b>XML to XSD</b> - used to generate an XML schema from an XML file</li> \r
+                                       <li><b>XSD to DataSet</b> - used to generate DataSet classes from an XSD schema file.  The\r
+                                               DataSet classes created can then be used with XML data</li>\r
+                                       <li><b>XSD to Classes</b> - used to generate classes from an XSD schema file. The \r
+                                           classes created can be used with System.XML.Serialization.XMLSerializer \r
+                                           to read and write XML code that follows the schema</li>\r
+                                       <li><b>Classes to XSD</b> - used to generate an XML schema \r
+                                               from type(s) in a assembly file. The \r
+                                               XML schema created by the tool defines the XML format used \r
+                                               by System.XML.Serialization.XMLSerializer</li>\r
+                                       </ul>\r
+                               <li>Xsd.exe is used to manipulate XML schemas that \r
+                                       follow the http://www.w3.org/XML/Schema">XML Schema Definition (XSD)</a> language \r
+                                       recommended     by the <a href="http://w3.org/">World Wide Web Consortium (W3C)</a></li>\r
+                                       \r
+                               <li>How this tool could be created:\r
+                                       <ul>\r
+                                               <li>Write xsd.exe in C# and run on Mono</li>\r
+                                               <li>Make sure we have XML Schema support in System.Xml.Schema.  Currently,\r
+                                               it is wrapped around libxlst</li>\r
+                                               <li>XML serialization support in System.Data classes</li>\r
+                                               <li>Create the TypedDataSetGenerator class in System.Data</li>\r
+                                               <li>Using CodeDOM or Reflection.Emit to create code</li>\r
+                                               <li>Make sure DataSet, XmlDataDocument, and related classes \r
+                                               are implemented fully</li>\r
+                                       </ul>\r
+                               </li>   \r
+                               
                        </li>
-               </ul>
-       <br>
-       <li>Create Tools for Configuration, Testing, and Entering SQL Queries  
-       <ul>
-               <li><b>SQL# CLI - a command-line tool</b> written in C# to 
-                 execute SQL commands,
-                 test connection strings, and connect to various ADO.NET
-                 providers in Mono.  The SQL# CLI can be found in
-                 mcs/tools/SqlSharp/SqlSharpCli.cs</li>
-                 
-               <li><p><b>SQL# GUI - a GUI tool</b> written in C# to 
-                 execute SQL commands. 
-                 Currently, there is SQL# For GTK# which
-                 can be found at 
-                 mcs/tools/SqlSharp/gui/gtk-sharp  
-                 It has a SQL editor with 
-                 syntax hi lighting of SQL keywords.  This will be
-                 moving to its own cvs modeul sqlsharpgtk.</li>
-                 
+                       </ul>
+               </li>
+               
+               <li><b>Application XML Configuration File Editor</b> - a tool
+               to create and edit an application configuration file, such as,
+               we have a .net application named Accouting.exe, the tool could edit
+               the application configuration file Accounting.exe.config so a user could
+               connect to the database used by the program.  This tool has not
+               been created.</li>
+               
                <li><b>Configuration Command-Line and GUI Tools for ADO.NET</b>.  
                  These tools have not been started.  The tools would be written in
                  C# and run on Mono. The
                  configuration tool can be used to do the following:
                  <ul> 
+                       <li>bebased on the Application XML Configuration File Editor</li>
                        <li>setup DSNs for the ODBC and OLE-DB
                                providers and configurations for 
                                their underlying libraries (unixODBC and libgda)</li>
                                freetds.conf for Microsoft SQL Server and Sybase</li>
                  </ul>
                </li>
-       </ul>
+
 </ul>
+
+** Extra Classes in Mono ADO.NET
+
+ <p>An ADO.NET <a href="http://www.go-mono.com/provider-factory.html">Provider Factory</a> 
+    was created by Brian Ritchie.  The 
+       Provider Factory is a way to dynamically create
+       connections, commands, parameters, and data adapters based on configuration 
+       information.
        
-* Current Status
+** Current Status
 
-       <p>Variouls ADO.NET Providers have been created: PostgreSQL, MySQL, Sybase, SQL Lite,
-       Microsoft SQL Server, OLE DB, ODBC, and TDS Generic.  See their respective web page for
-       more information.
+       <p>Various ADO.NET Providers have been created at various stages of 
+       development including: 
+       Firebird/Interbase, IBM DB2 Universal Database, MySQL, ODBC, OLE DB, Oracle,
+       PostgreSQL, SQL Lite, Sybase, Microsoft SQL Server, and TDS Generic.  
+       See their respective web page for more information.
+       
+       <p><b>Data Relations</b> via DataRelation, DataRelationCollection, and
+       other classes have not been implemented
+       
+       <p><b>Constraints</b> need lots of work
        
-       <p>Constraints need lots of work
+       <p><b>XML Schema Definition tool</b> xsd.exe that is included
+       in the .NET Framework has not been created for Mono
        
-       <p>TypeDataSetGenerator needs to be stubbed and implemented.
+       <p><b>TypeDataSetGenerator</b> needs to be stubbed and implemented.
                
        <p><b>DataSet, DataAdaptor, DataTable, DataRelation, DataRow, DataColumn,
        DataColumnCollection, DataRowCollection, and others</b> need more work.  There are
-       many classes that are just stubs and need to be implemented.  
+       many classes that are just stubs and need to be implemented.  Ville Palo has been
+       doing much testing here.
 
        <p><b>XML support in System.Data</b> needs work.  This involves working on
        the classes: DataSet, XmlDataDocument, and the method ExecuteXmlReader() that
        Stuart Caborn has started the XML support in a DataSet.  Tim Coleman started
        XML support in the ExecuteXmlReader() in a SqlCommand.  Ville Palo has been
        heavily modifying DataSet, XmlDataDocument, and other classes for reading
-       and writing XML.
-       
-       <p><b>ADO.NET Provider Factory</b> has been started by Brian Ritchie.  The 
-       Provider Factory is way to dynamically create
-       connections, commands, parameters, and data adapters based on configuration information.  The
-       provider factory also provides utility functions needed by a lot of 
-       providers but are not exposed via the provider.  The ProviderFactory
-       is found at mcs/class/Mono.Data and includes a test named test.cs for it in
-       mcs/class/Mono.Data/Test.  Also, take a look at the sample .config file for the
-       test.exe application named test.exe.config.  The .config file is automatically
-       read when you use the Mono.Data.ProviderFactory or Mono.Data.DataTools.
+       and writing XML.  XML Serialization support in DataSet needs to be implemented.
                
-       <p><b>Integration with ASP.NET</b> has not been started, such as, data binding
-       to a System.Web.UI.WebControls.DataGrid.  This may involve implementing many classes
-       in System.Web and System.Data. If you want to help, 
-       contact Gonzalo Paniagua Javier. Here is information about using ADO.NET in ASP.NET:
+       <p><b>Integration with ASP.NET</b> has been created.  Data binding of
+       a DataTable in a DataSet to a System.Web.UI.WebControls.DataGrid works.  Data binding
+       of other types works too.
+       
+       <p><b>Database Access from ASP.NET</b>:
        <ul>
                <li>Take a look at xsp in cvs and look at the examples in test: dbpage1.aspx
                and dbpage2.aspx:
        has not been started, such as, data binding
        to a GtkTreeView.  This may involve creating new classes
        to go between the glist data model and the ADO.NET data model.
-       Mike Kestner would be the best person to ask for help on GTK#.
+       Mike Kestner or Rachel Hestilov would be the best people to ask for help on GTK#.
        
        <p><b>Integration with QT#</b> has not been started.  Any information on 
        how this can be done is appreciated.  Adam Treat would be the best 
 </pre>
        </ul>
 
-* Testing
+** Testing
 
 <ul>
-       <li>Testing connection-oriented classes are done via the provider specific tests
+       <li>Testing connection-oriented classes are done 
+       via the provider specific tests
+       found in the mcs source at mcs/class</br>
+               <table border=1>        
+                       <tr>
+                               <td><b>Name</b></td>
+                               <td><b>Assembly /</br> Namespace</b></td>
+                               <td><b>Test</b></td>    
+                       </tr>           
+                       
+                       <tr>
+                               <td>Microsoft</br> SQL</br> Server</br></td>
+                               <td>System.Data /</br> System.Data.SqlClient</td>
+                               <td>SqlTest.cs at</br> System.Data/Test</td>
+                       </tr>
+                       
+                       <tr>
+                               <td>PostgreSQL</br> (Mono)</td>
+                               <td>Mono.Data.PostgreSqlClient /</br> Mono.Data.PostgreSqlClient</td>
+                               <td>PostgresTest.cs at</br> System.Data/Test</td>
+                       </tr>
 
-       <li><a href="http://www.go-mono.com/testing.html">Testing non-connection classes</a> are 
-       done via mono's modified version of NUnit.</li>
+                       <tr>
+                               <td>MySQL</br> (Mono)</td>
+                               <td>Mono.Data.MySql /</br> Mono.Data.MySql</td>
+                               <td>MySqlTest.cs at</br> Mono.Data.MySql/Test</td>
+                       </tr>
 
+                       <tr>
+                               <td>Oracle</br> (Mono)</td>
+                               <td>System.Data.OracleClient /</br> System.Data.OracleClient</td>
+                               <td>TestOracleClient.cs at</br> System.Data.OracleClient</td>
+                       </tr>
+
+                       <tr>
+                               <td>ODBC</br> (Mono)</td>
+                               <td>System.Data.OracleClient /</br> System.Data.OracleClient</td>
+                               <td>TestOracleClient.cs at</br> System.Data.OracleClient</td>
+                       </tr>
+                       
+               </table>
+       
+
+       <li><a href="http://www.go-mono.com/testing.html">Testing non-connection classes</a> are 
+       done via mono's modified version of NUnit.
+               <ul>
+                       <li>To run all the NUnit tests for Mono, you need the mcs source.  cd to the root
+                       of the mcs source.  To run it:
+                               <ul>
+                                       <li>On Linux: make -f makefile test</li>
+                                       <li>On Windows: make test</li>
+                               </ul>
+                       </li>
+                       <li>If you just want to run the NUnit tests for System.Data, you would cd into
+                       the mcs source at class/System.Data/Test and run it:
+                               <ul>
+                                       <li>On Linux: make -f makefile test</li>
+                                       <li>On Windows: make test</li>
+                               </ul>
+                       </li>
+               </ul>
+       </li>
+               
 </ul>  
+