You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ibatis.apache.org by ro...@apache.org on 2005/05/25 04:29:21 UTC
svn commit: r178348 -
/incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/dotnet.xml
/incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/index.xml
/incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/introduction.xml
/incubator/ibatis/trunk/cs/docs/doc.build
Author: roberto
Date: Tue May 24 19:29:20 2005
New Revision: 178348
URL: http://svn.apache.org/viewcvs?rev=178348&view=rev
Log:
~Updated C# DataMapper Guide: edited text; added new loggers to .NET section; updated build file for version #; doc date.
Still need to add more examples in .NET section...
Modified:
incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/dotnet.xml
incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/index.xml
incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/introduction.xml
incubator/ibatis/trunk/cs/docs/doc.build
Modified: incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/dotnet.xml
URL: http://svn.apache.org/viewcvs/incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/dotnet.xml?rev=178348&r1=178347&r2=178348&view=diff
==============================================================================
--- incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/dotnet.xml (original)
+++ incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/dotnet.xml Tue May 24 19:29:20 2005
@@ -150,23 +150,23 @@
references. You will need to add one or two references to your project:
<orderedlist>
<listitem>
- IBatisNet.DataMapper.dll
+ IBatisNet.DataMapper.dll
</listitem>
<listitem>
- IBatisNet.DataAccess.dll (optional)
+ IBatisNet.DataAccess.dll (optional)
</listitem>
<listitem>
- IBatisNet.Common.dll (implied)
+ IBatisNet.Common.dll (implied)
</listitem>
<listitem>
- Castle.DynamicProxy.dll (implied)
+ Castle.DynamicProxy.dll (implied)
</listitem>
<listitem>
- <para>log4net.dll (implied) </para>
+ <para>log4net.dll (implied)</para>
</listitem>
</orderedlist></para>
@@ -743,11 +743,11 @@
</listitem>
<listitem>
- Firebird1.7 - Firebird SQL .NET provider V1.7.0.33200
+ Firebird1.7 - Firebird SQL .NET provider V1.7.0.33200
</listitem>
<listitem>
- PostgreSql0.7 - Npgsql provider V0.7.0.0
+ PostgreSql0.7 - Npgsql provider V0.7.0.0
</listitem>
</itemizedlist></para>
@@ -990,13 +990,14 @@
<para>The first time <methodname>Mapper.Instance()</methodname> is
called, it will read the default configuration file,
- <filename>SqlMap.config</filename>. On subsequent calls, it will reuse
- the cached <varname>mapper</varname> instance. The
+ <filename>SqlMap.config</filename>, through the
+ <methodname>ConfigureAndWatch</methodname> method. On subsequent calls,
+ it will reuse the cached <varname>mapper</varname> instance. The
<methodname>ConfigureAndWatch</methodname> method monitors changes to
the configuration files. If the configuration or definitions files
change, the <classname>SqlMapper</classname> will be safely reloaded.
This is particularly useful in development, when you might make a change
- to a Data Map definition and want to see it take effect without
+ to a data map definition and want to see it take effect without
restarting a debugging session. Likewise, in production, it can allow
you to make changes to the definitions without reloading the rest of the
application.</para>
@@ -1007,10 +1008,16 @@
again. NUnit will reload the configuration automatically.</para>
</note>
+ <note>
+ <para>The ConfigureAndWatch method requires that your SqlMap.config
+ file and data map files are accessible through the application's file
+ system to be able to track file changes.</para>
+ </note>
+
<para>If for some reason you do not want to monitor changes to the
- configuration, you can create your own <classname>Mapper</classname>
- class, and use the <methodname>Configure</methodname> method
- instead:</para>
+ configuration or you want to load your data map files as embedded
+ resources, you can create your own <classname>Mapper</classname> class,
+ and use the <methodname>Configure</methodname> method instead:</para>
<para><programlisting>[C#]
mapper = SqlMapper.Configure("file.name");</programlisting></para>
@@ -1312,8 +1319,7 @@
<para>In the iBATIS DataMapper framework, a session is a container for
an ADO connection and transaction.</para>
- <para>The iBATIS.NET DataMapper session
- <classname>IDalSession</classname> implement
+ <para>The DataMapper's <classname>IDalSession</classname> implements the
<classname>IDisposable</classname> interface. So you can use it with the
<methodname>using</methodname> syntax.</para>
@@ -1517,11 +1523,11 @@
<para>It is important to make sure that each instance of this class
gets <methodname>Close()</methodname>'d. The easiest way to ensure
that each instance is closed is with the <literal>using</literal>
- statement in C#. When <literal>using</literal> calls
- <methodname>Dispose</methodname> on the transaction scope at the end
- of the <literal>using</literal> code block, the
- <emphasis>ambient</emphasis> transaction will be commited only if the
- <methodname>Complete()</methodname> method has been called.</para>
+ statement in C#. When <methodname>Dispose</methodname> is called on
+ the transaction scope at the end of the <literal>using</literal> code
+ block, the <emphasis>ambient</emphasis> transaction will be commited
+ only if the <methodname>Complete()</methodname> method has been
+ called.</para>
</example>
<para><note>
@@ -1630,10 +1636,12 @@
<title>A sample Log4Net configuration block
(IBatisNet.Test.dll.Config)</title>
- <programlisting><configuration>
+ <programlisting>
+
+<configuration>
<emphasis role="comment"><!-- Register a section handler for the log4net section --></emphasis>
<configSections>
- <section name="log4net" type="System.Configuration.IgnoreSectionHandler" />
+ <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" />
</configSections>
<appSettings>
<emphasis role="comment"><!-- To enable internal log4net logging specify the following appSettings key --></emphasis>
@@ -1662,6 +1670,7 @@
</layout>
</appender>
+ <!-- OFF, FATAL, ERROR, WARN, INFO, DEBUG, ALL -->
<emphasis role="comment"><!-- Set root logger level to ERROR and its appenders --></emphasis>
<root>
<level value="ERROR" />
@@ -1670,25 +1679,45 @@
</root>
<emphasis role="comment"> <!-- Print only messages of level DEBUG or above in the packages --></emphasis>
- <logger name="IBatisNet.DataMapper.Configuration.Cache.CacheModel">
+ <logger name="IBatisNet.DataMapper.Commands.DefaultPreparedCommand">
<level value="DEBUG" />
</logger>
- <logger name="IBatisNet.DataMapper.Configuration.Statements.PreparedStatementFactory">
+ <logger name="IBatisNet.DataMapper.Configuration.Cache.CacheModel">
<level value="DEBUG" />
</logger>
<logger name="IBatisNet.DataMapper.LazyLoadList">
<level value="DEBUG" />
</logger>
+ <logger name="IBatisNet.DataMapper.SqlMapSession">
+ <level value="DEBUG" />
+ </logger>
+ <logger name="IBatisNet.Common.Transaction.TransactionScope">
+ <level value="DEBUG" />
+ </logger>
+ <logger name="IBatisNet.DataAccess.DaoSession">
+ <level value="DEBUG" />
+ </logger>
+ <logger name="IBatisNet.DataAccess.Configuration.DaoProxy">
+ <level value="DEBUG" />
+ </logger>
+ <logger name="IBatisNet.DataMapper.Configuration.Statements.PreparedStatementFactory">
+ <level value="OFF" />
+ </logger>
+ <logger name="IBatisNet.DataMapper.Commands.IPreparedCommand">
+ <level value="OFF" />
+ </logger>
</log4net>
</configuration></programlisting>
</example>
<para>To log all Prepared SQL command text, enable the logger for
- <classname>IBatisNet.DataMapper.Configuration.Statements.PreparedStatementFactory</classname>.
+ <classname>IBatisNet.DataMapper.Configuration.Statements.DefaultPreparedCommand</classname>.
To log cache usage, enable the logger for
<classname>IBatisNet.DataMapper.Configuration.Cache.CacheModel</classname>.
To log lazyload usage, enable the logger for
- <classname>IBatisNet.DataMapper.LazyLoadList</classname>.</para>
+ <classname>IBatisNet.DataMapper.LazyLoadList</classname>. To log
+ DataMapper session information, enable the logger for
+ <classname>IBatisNet.DataMapper.SqlMapSession</classname>.</para>
</sect2>
</sect1>
</chapter>
Modified: incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/index.xml
URL: http://svn.apache.org/viewcvs/incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/index.xml?rev=178348&r1=178347&r2=178348&view=diff
==============================================================================
--- incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/index.xml (original)
+++ incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/index.xml Tue May 24 19:29:20 2005
@@ -1,53 +1,53 @@
-<?xml version='1.0' encoding="UTF-8"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
- "../../../docbook/docbook-dtd/docbookx.dtd"
-[
-<!ENTITY introduction SYSTEM "introduction.xml">
-<!ENTITY architecture SYSTEM "architecture.xml">
-<!ENTITY working SYSTEM "working.xml">
-<!ENTITY dotnet SYSTEM "dotnet.xml">
-<!ENTITY xsdConfig SYSTEM "xsd-config.xml">
-<!ENTITY xsdSqlMap SYSTEM "xsd-sqlMap.xml">
-
-]>
-<book>
-<bookinfo>
- <title>iBATIS.NET - .NET Application Framework</title>
- <subtitle>Data Mapper Developer Guide</subtitle>
- <releaseinfo>Version 1.2</releaseinfo>
- <pubdate>1 June 2004</pubdate>
- <authorgroup>
- <author>
- <firstname>Ted</firstname>
- <surname>Husted</surname>
- </author>
- <author>
- <firstname>Gilles</firstname>
- <surname>Bayon</surname>
- </author>
- <author>
- <firstname>Clinton</firstname>
- <surname>Begin</surname>
- </author>
- <author>
- <firstname>Roberto</firstname>
- <surname>Rabe</surname>
- </author>
- </authorgroup>
- <legalnotice>
- <para>
- Copies of this document may be made for your own use and for
- distribution to others, provided that you do not charge any fee for such
- copies and further provided that each copy contains this Copyright
- Notice, whether distributed in print or electronically.
- </para>
- </legalnotice>
- </bookinfo>
- <toc/>
- &introduction;
- &architecture;
- &working;
- &dotnet;
- &xsdConfig;
- &xsdSqlMap;
-</book>
+<?xml version='1.0' encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+ "../../../docbook/docbook-dtd/docbookx.dtd"
+[
+<!ENTITY introduction SYSTEM "introduction.xml">
+<!ENTITY architecture SYSTEM "architecture.xml">
+<!ENTITY working SYSTEM "working.xml">
+<!ENTITY dotnet SYSTEM "dotnet.xml">
+<!ENTITY xsdConfig SYSTEM "xsd-config.xml">
+<!ENTITY xsdSqlMap SYSTEM "xsd-sqlMap.xml">
+
+]>
+<book>
+<bookinfo>
+ <title>iBATIS.NET - .NET Application Framework</title>
+ <subtitle>Data Mapper Developer Guide</subtitle>
+ <releaseinfo>Version 1.2</releaseinfo>
+ <pubdate>1 June 2005</pubdate>
+ <authorgroup>
+ <author>
+ <firstname>Ted</firstname>
+ <surname>Husted</surname>
+ </author>
+ <author>
+ <firstname>Gilles</firstname>
+ <surname>Bayon</surname>
+ </author>
+ <author>
+ <firstname>Clinton</firstname>
+ <surname>Begin</surname>
+ </author>
+ <author>
+ <firstname>Roberto</firstname>
+ <surname>Rabe</surname>
+ </author>
+ </authorgroup>
+ <legalnotice>
+ <para>
+ Copies of this document may be made for your own use and for
+ distribution to others, provided that you do not charge any fee for such
+ copies and further provided that each copy contains this Copyright
+ Notice, whether distributed in print or electronically.
+ </para>
+ </legalnotice>
+ </bookinfo>
+ <toc/>
+ &introduction;
+ &architecture;
+ &working;
+ &dotnet;
+ &xsdConfig;
+ &xsdSqlMap;
+</book>
Modified: incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/introduction.xml
URL: http://svn.apache.org/viewcvs/incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/introduction.xml?rev=178348&r1=178347&r2=178348&view=diff
==============================================================================
--- incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/introduction.xml (original)
+++ incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/introduction.xml Tue May 24 19:29:20 2005
@@ -60,7 +60,7 @@
<para>Mailing lists and bug trackers are available (courtesy of Apache
Software Foundation) at iBATISâs Apache project page. Just direct your
browser to <ulink
- url="http://incubator.apache.org/ibatis/site">http://incubator.apache.org/ibatis/site</ulink>.</para>
+ url="http://incubator.apache.org/ibatis/">http://incubator.apache.org/ibatis/</ulink>.</para>
</sect1>
<sect1>
Modified: incubator/ibatis/trunk/cs/docs/doc.build
URL: http://svn.apache.org/viewcvs/incubator/ibatis/trunk/cs/docs/doc.build?rev=178348&r1=178347&r2=178348&view=diff
==============================================================================
--- incubator/ibatis/trunk/cs/docs/doc.build (original)
+++ incubator/ibatis/trunk/cs/docs/doc.build Tue May 24 19:29:20 2005
@@ -2,7 +2,7 @@
<project name="iBATIS.NET reference" default="refDoc" >
<property name="project.dao.version" value="1.5" unless="${property::exists('project.dao.version')}" />
- <property name="project.sqlMap.version" value="1.1" unless="${property::exists('project.sqlMap.version')}" />
+ <property name="project.sqlMap.version" value="1.2" unless="${property::exists('project.sqlMap.version')}" />
<property name="project.name" value="Data Access Guide" />