ibatis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From gba...@apache.org
Subject svn commit: r498310 - in /ibatis/trunk/cs/docs/dataMapperGuide/src/en: dotnet.xml introduction.xml
Date Sun, 21 Jan 2007 13:25:52 GMT
Author: gbayon
Date: Sun Jan 21 05:25:52 2007
New Revision: 498310

URL: http://svn.apache.org/viewvc?view=rev&rev=498310
Log:
- Updated doc for advanced usage

Modified:
    ibatis/trunk/cs/docs/dataMapperGuide/src/en/dotnet.xml
    ibatis/trunk/cs/docs/dataMapperGuide/src/en/introduction.xml

Modified: ibatis/trunk/cs/docs/dataMapperGuide/src/en/dotnet.xml
URL: http://svn.apache.org/viewvc/ibatis/trunk/cs/docs/dataMapperGuide/src/en/dotnet.xml?view=diff&rev=498310&r1=498309&r2=498310
==============================================================================
--- ibatis/trunk/cs/docs/dataMapperGuide/src/en/dotnet.xml (original)
+++ ibatis/trunk/cs/docs/dataMapperGuide/src/en/dotnet.xml Sun Jan 21 05:25:52 2007
@@ -1580,18 +1580,23 @@
 			  <row>
                 <entry>GetAccessorFactory</entry>
 
-                <entry>Allow to set a custom get accessor factory before configuration,
see IGetAccessorFactory interface which defines the contract for the factory responsible to
build set accessor for a member object in iBATIS.
+                <entry>Allows to set a custom get accessor factory before configuration,
see IGetAccessorFactory interface which defines the contract for the factory responsible to
build set accessor for a member object in iBATIS.
 				</entry>
               </row>
 			  <row>
                 <entry>SetAccessorFactory</entry>
 
-                <entry>Allow to set a custom set accessor factory before configuration,
see ISetAccessorFactory interface which defines the contract for the factory responsible to
build get accessor for a member object in iBATIS.
+                <entry>Allows to set a custom set accessor factory before configuration,
see ISetAccessorFactory interface which defines the contract for the factory responsible to
build get accessor for a member object in iBATIS.
 				</entry>
               </row>
 			  <row>
                 <entry>ObjectFactory</entry>
-                <entry>Allow to set a custom object factory before configuration, see
IObjectFactory interface which defines the contract for the factory responsible for object
creation in iBATIS.
+                <entry>Allows to set a custom object factory before configuration,
see IObjectFactory interface which defines the contract for the factory responsible for object
creation in iBATIS.
+				</entry>
+              </row>
+			   <row>
+                <entry>SqlMapper</entry>
+                <entry>Allows to set a custom SqlMapper before configuration, see ISqlMapper
interface.
 				</entry>
               </row>
 			  <row>
@@ -1609,7 +1614,7 @@
     <sect2>
       <title>Exploring the DataMapper API through the SqlMapper</title>
 
-      <para>The <classname>SqlMapper</classname> instance acts as a facade
to
+      <para>The <classname>ISqlMapper</classname> instance acts as a facade
to
       provide access the rest of the DataMapper framework. The DataMapper API
       methods are shown in Example 4.11.</para>
 
@@ -1687,6 +1692,26 @@
         sections describe how the API methods work.</para>
       </example>
 
+	  <note> <para>The DatatMapper component store his working ISqlMapSession on
different session store. 
+	   <para>On Web environnement, the session is stored Http.Request.Items.</para>
+	   <para>On windows environnement on the current thread. </para>
+	   <para>You can configure the session storage by specifing the property ISessionStore
on ISqlMapper.</para>
+	  This will allow to set a custom session store like the <emphasis role="blue">HybridWebThreadSessionStore</emphasis>
+	  This is used for scenarios where most of the you need per request session, but you also
does some work outside a 
+	  request (in a thread pool thread, for instance).</para>
+
+	   <para>Set it after the configuration and before use of the ISqlMapper.</para>
+	  <example>
+        <title>Custom ISessionStore</title>
+
+        <programlisting>
+sqlMapper.SessionStore = new HybridWebThreadSessionStore( sqlMapper.Id );
+...
+sqlMapper.QueryOject(...)
+		</programlisting>
+		</example>
+</note>
+
       <sect3>
         <title>Insert, Update, Delete</title>
 
@@ -1958,7 +1983,6 @@
 
       <para>In the iBATIS DataMapper framework, a session is a container for
       an ADO connection and transaction.</para>
-
       <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>
@@ -2030,11 +2054,11 @@
 
         <para><programlisting>[C#]
 Item item = (Item) sqlMap.executeQueryForObject ("GetItem", itemId);
-item.Description = “TX1”;
+item.Description = "test";
 <emphasis role="comment">// No session demarcated, so open/close connection will be
automatic (implied)</emphasis>
 sqlMap.Update("UpdateItem", item);
 item.Description = newDescription;
-item.Description = “TX2”;
+item.Description = "test2";
 <emphasis role="comment">// No transaction demarcated, so open/close connection will
be automatic (implied)</emphasis>
 sqlMap.Update("UpdateItem", item);</programlisting></para>
       </example>

Modified: ibatis/trunk/cs/docs/dataMapperGuide/src/en/introduction.xml
URL: http://svn.apache.org/viewvc/ibatis/trunk/cs/docs/dataMapperGuide/src/en/introduction.xml?view=diff&rev=498310&r1=498309&r2=498310
==============================================================================
--- ibatis/trunk/cs/docs/dataMapperGuide/src/en/introduction.xml (original)
+++ ibatis/trunk/cs/docs/dataMapperGuide/src/en/introduction.xml Sun Jan 21 05:25:52 2007
@@ -51,7 +51,7 @@
              Resolution of N+1 select problem using groupBy attribute
           </listitem>
 		  <listitem>
-            Added support ot reuse SQL fragement via &lt;include/&gt; tag
+            Added support of reuse SQL fragement via &lt;include/&gt; tag
           </listitem>
 		   <listitem>
             Added lazy load support for single class 
@@ -65,6 +65,19 @@
 		    <listitem>
 		  Allowed procedure statement without parameterMap
 		   </listitem>
+		   <listitem>
+		   Removed obsoletes methods on SqlMapper : 
+		   <para>Configure(XmlDocument document), Configure(),</para> 
+		   <para>Configure(string resource),</para> 
+		   <para>ConfigureAndWatch(ConfigureHandler configureDelegate),</para>  
+		   <para>ConfigureAndWatch(string resource, ConfigureHandler configureDelegate)</para>

+		</listitem>
+		<listitem>
+		   Extended use of ISqlMapper in DataMapper + allowed use of a custom ISqlMapper.
+		</listitem>
+		<listitem>
+		   Allowed custom ISessionStore.
+		</listitem>
 		</itemizedlist>
       </sidebar>
   </sect1>



Mime
View raw message