[Springnet-commits] Spring.Net/doc/reference/src objects.xml, 1.124, 1.125 xsd-configuration.xml, 1.2, 1.3

[Mark P. <mar...@us...>]

Update of /cvsroot/springnet/Spring.Net/doc/reference/src
In directory sc8-pr-cvs8.sourceforge.net:/tmp/cvs-serv4022

Modified Files:
	objects.xml xsd-configuration.xml 
Log Message:
misc updates.

Index: objects.xml
===================================================================
RCS file: /cvsroot/springnet/Spring.Net/doc/reference/src/objects.xml,v
retrieving revision 1.124
retrieving revision 1.125
diff -C2 -d -r1.124 -r1.125
*** objects.xml	2 May 2008 16:43:30 -0000	1.124
--- objects.xml	6 May 2008 03:14:43 -0000	1.125
***************
*** 3718,3722 ****
      class...</para>
  
!     <para><programlisting>&lt;object id="inheritedTestObjectWithoutClass"&gt;
    &lt;property name="name" value="parent"/&gt;
    &lt;property name="age" value="1"/&gt;
--- 3718,3722 ----
      class...</para>
  
!     <para><programlisting>&lt;object id="inheritedTestObjectWithoutClass" abstract="true"&gt;
    &lt;property name="name" value="parent"/&gt;
    &lt;property name="age" value="1"/&gt;
***************
*** 3728,3744 ****
  &lt;/object&gt;</programlisting></para>
  
!     <para>... the parent object cannot be instantiated on its own since the
!     definition is incomplete. The definition is also implicitly considered to
!     be abstract. An object definition can also be explicitly declared as
!     abstract using the abstract attribute. Valid values of the attribute are
!     true and false. An abstract definition like this is usable just as a pure
!     template or abstract object definition that will serve as a parent
!     definition for child definitions. Trying to use such parent objects on
!     their own (by referring to it as a ref property of another object, or
      doing an explicit <methodname>GetObject()</methodname> with the parent
!     object id), will result in an error. Declaring the object as abstract will
!     prevent it being instantiated and any attempt to instantiate the object
!     will result in an <classname>ObjectDefinitionIsAbstract</classname>
!     exception being thrown. The container's internal
      <methodname>PreInstantiateSingletons</methodname> method will completely
      ignore object definitions that are considered abstract.</para>
--- 3728,3739 ----
  &lt;/object&gt;</programlisting></para>
  
!     <para>... the parent object cannot be instantiated on its own since it
!     incomplete, and it is also explicitly marked as abstract.
!     When a definition is defined to be abstract like this, it is usable only
!     as a pure template object definition that will serve as a parent
!     definition for child definitions.  Trying to use such an abstract parent
!     object on its own (by referring to it as a ref property of another object, or
      doing an explicit <methodname>GetObject()</methodname> with the parent
!     object id), will result in an error. The container's internal
      <methodname>PreInstantiateSingletons</methodname> method will completely
      ignore object definitions that are considered abstract.</para>
***************
*** 3753,3772 ****
        <emphasis>true</emphasis>
  
!        , otherwise the application context will actually attempt to pre-instantiate it. 
      </note>
  
-     <para><programlisting>&lt;object id="abstractObject" abstract="true"
-   type="Spring.Objects.DerivedTestObject, Spring.Core.Tests"&gt;
-   &lt;property name="name" value="parent"/&gt;
-   &lt;property name="age" value="1"/&gt;
- &lt;/object&gt;
- &lt;object id="inheritsFromAbstract" type="Spring.Objects.DerivedTestObject, Spring.Core.Tests"
-   parent="abstractObject" init-method="Initialize"&gt;
-   &lt;property name="name" value="override"/&gt;
-   &lt;!-- age will inherit value of 1 from parent --&gt;
- &lt;/object&gt;</programlisting></para>
    </sect1>
  
!   <sect1 id="objects-factory-client">
      <title>Interacting with the container</title>
  
--- 3748,3757 ----
        <emphasis>true</emphasis>
  
!        , otherwise the application context will actually (attempt to) pre-instantiate the abstract object.
      </note>
  
    </sect1>
  
!   <sect1 id="objects-factory-extension">
      <title>Interacting with the container</title>
  

Index: xsd-configuration.xml
===================================================================
RCS file: /cvsroot/springnet/Spring.Net/doc/reference/src/xsd-configuration.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** xsd-configuration.xml	5 May 2008 20:04:55 -0000	1.2
--- xsd-configuration.xml	6 May 2008 03:14:43 -0000	1.3
***************
*** 132,136 ****
      </section>
  
!     <section id="xsd-config-body-schemas-context">
        <title>The <literal>db</literal> schema</title>
  
--- 132,136 ----
      </section>
  
!     <section id="xsd-config-body-schemas-db">
        <title>The <literal>db</literal> schema</title>
  
***************
*** 152,156 ****
      </section>
  
!     <section id="xsd-config-body-schemas-tool">
        <title>The <literal>remoting</literal> schema</title>
  
--- 152,156 ----
      </section>
  
!     <section id="xsd-config-body-schemas-remoting">
        <title>The <literal>remoting</literal> schema</title>
  
***************
*** 170,174 ****
      </section>
  
!     <section id="xsd-config-body-schemas-tool">
        <title>The <literal>validation</literal> schema</title>
  
--- 170,174 ----
      </section>
  
!     <section id="xsd-config-body-schemas-validation">
        <title>The <literal>validation</literal> schema</title>
  
***************
*** 188,192 ****
      </section>
  
!     <section id="xsd-config-body-schemas-beans">
        <title>The <literal>objects</literal> schema</title>
  
--- 188,192 ----
      </section>
  
!     <section id="xsd-config-body-schemas-objects">
        <title>The <literal>objects</literal> schema</title>