You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ibatis.apache.org by gb...@apache.org on 2005/03/06 11:06:28 UTC

svn commit: r156301 - incubator/ibatis/trunk/cs/docs/dataAccessGuide/src/en/configuration.xml incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/working.xml incubator/ibatis/trunk/cs/docs/doc.build

Author: gbayon
Date: Sun Mar  6 02:06:27 2005
New Revision: 156301

URL: http://svn.apache.org/viewcvs?view=rev&rev=156301
Log:
- updated build doc to reflect the nes SVN structure direectory
- Added doc for resultMaping attribut
- Improved doc to type attribut

Modified:
    incubator/ibatis/trunk/cs/docs/dataAccessGuide/src/en/configuration.xml
    incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/working.xml
    incubator/ibatis/trunk/cs/docs/doc.build

Modified: incubator/ibatis/trunk/cs/docs/dataAccessGuide/src/en/configuration.xml
URL: http://svn.apache.org/viewcvs/incubator/ibatis/trunk/cs/docs/dataAccessGuide/src/en/configuration.xml?view=diff&r1=156300&r2=156301
==============================================================================
--- incubator/ibatis/trunk/cs/docs/dataAccessGuide/src/en/configuration.xml (original)
+++ incubator/ibatis/trunk/cs/docs/dataAccessGuide/src/en/configuration.xml Sun Mar  6 02:06:27 2005
@@ -239,10 +239,7 @@
 
     <example>
       Example dao.config file
-
-      <title></title>
-
-       
+      
 
       <programlisting>&lt;?xml version="1.0" encoding="utf-8"?&gt;
 &lt;daoConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -354,6 +351,29 @@
     can be validated by the <filename>DaoConfig.xsd</filename> schema provided
     with the distribution.</para>
 
+    <sect2>
+      <title>type Attribut</title>
+      When specifying a type attribut within configuration, the type attribut value must be a fully qualified
+type name following the format:
+
+       <programlisting>
+      type="[namespace.class], [assembly name],
+            Version=[version], Culture=[culture],
+            PublicKeyToken=[public token]"
+	 </programlisting>
+
+For example:
+ <programlisting>
+      type="MyProject.Domain.LineItem, MyProject.Domain,
+            Version=1.2.3300.0, Culture=neutral,
+            PublicKeyToken=b03f455f11d50a3a"
+ </programlisting>
+The strongly typed name is desired, however, it is also legitimate to
+use the shorter style assembly type name:
+<programlisting>
+      type="MyProject.Domain.LineItem, MyProject.Domain"
+</programlisting>
+	</sect2>
     <sect2>
       <title>The &lt;context&gt; Element</title>
 

Modified: incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/working.xml
URL: http://svn.apache.org/viewcvs/incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/working.xml?view=diff&r1=156300&r2=156301
==============================================================================
--- incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/working.xml (original)
+++ incubator/ibatis/trunk/cs/docs/dataMapperGuide/src/en/working.xml Sun Mar  6 02:06:27 2005
@@ -27,6 +27,33 @@
   </sect1>
 
   <sect1>
+     
+
+    <title>type Attribut</title>
+
+     When specifying a type attribut within configuration, the type attribut value must be a fully qualified type name following the format: 
+
+    <programlisting>type="[namespace.class], [assembly name],
+        Version=[version], Culture=[culture],
+        PublicKeyToken=[public token]"
+</programlisting>
+
+     For example: 
+
+    <programlisting>type="MyProject.Domain.LineItem, MyProject.Domain,
+        Version=1.2.3300.0, Culture=neutral,
+        PublicKeyToken=b03f455f11d50a3a"
+</programlisting>
+
+     The strongly typed name is desired, however, it is also legitimate to use the shorter style assembly type name: 
+
+    <programlisting>type="MyProject.Domain.LineItem, MyProject.Domain"
+</programlisting>
+
+     
+  </sect1>
+
+  <sect1>
     <title>What's in a Data Map definition file, anyway?</title>
 
     <para>If you read the Tutorial, you've already seen some simple Data Map
@@ -836,12 +863,13 @@
             role="blue">class.name|typeAlias</emphasis>"]&gt;
   &lt;parameter 
     property ="<emphasis role="blue">property.name</emphasis>" 
+    [column="<emphasis role="blue">column.name</emphasis>"]
     [dbType="<emphasis role="blue">database.type</emphasis>"] 
+    [extends="<emphasis role="blue">parent.parameterMap</emphasis>"]
     [nullValue="<emphasis role="blue">null.value.replacement</emphasis>"] 
-    [type="<emphasis role="blue">property.CLR.type</emphasis>"] 
-    [column="<emphasis role="blue">column.name</emphasis>"]
+    [resultMapping="<emphasis role="blue">[sqlMap.namespace.]parameterMap.Id</emphasis>"]/&gt;
     [size="<emphasis role="blue">column.size</emphasis>"] 
-    [extends="<emphasis role="blue">parent.parameterMap</emphasis>"]/&gt;
+    [type="<emphasis role="blue">property.CLR.type</emphasis>"] 
   &lt;parameter ... ... /&gt;
   &lt;parameter ... ... /&gt; 
 &lt;/parameterMap&gt;</programlisting>
@@ -1065,6 +1093,21 @@
         used more than once depending on the number of times it is needed in
         the statement. (In an update, you might set a column that is also part
         of the where clause.)</para>
+      </sect3>
+
+      <sect3>
+        <title>resultMapping</title>
+
+        <para>The <parameter>resultMapping</parameter> attribute can be set to
+        the name of another parameterMap used to fill the property. If the
+        parameterMap is in an other mapping file, you must specified the fully
+        qualified name as : <programlisting>
+resultMapping="[namespace.sqlMap.]resultMapping.id"
+
+resultMapping="Newspaper"
+<emphasis role="comment">&lt;!--resultMapping with a fully qualified name.--&gt;</emphasis>
+resultMapping="LineItem.LineItem"
+</programlisting></para>
       </sect3>
 
       <sect3>

Modified: incubator/ibatis/trunk/cs/docs/doc.build
URL: http://svn.apache.org/viewcvs/incubator/ibatis/trunk/cs/docs/doc.build?view=diff&r1=156300&r2=156301
==============================================================================
--- incubator/ibatis/trunk/cs/docs/doc.build (original)
+++ incubator/ibatis/trunk/cs/docs/doc.build Sun Mar  6 02:06:27 2005
@@ -31,7 +31,7 @@
 	<property name="doc.ref.output.dir" value="${doc.output.dir}" />
 
 	<!-- the main source code directory for the iBATIS.NET codebase  -->	
-	<property name="src.dir" value="../source" />
+	<property name="src.dir" value="../mapper" />
 
 	<target name="clean" description="Delete output and temporary directories.">
 		<delete dir="${doc.output.dir}" failonerror="false"/>