[jboss-svn-commits] JBL Code SVN: r28960 - labs/jbossrules/trunk/drools-docs/drools-docs-solver/src/main/docbook/en-US/Chapter-Solver.

[jboss-svn-commits at lists.jboss.org]

Author: ge0ffrey
Date: 2009-08-17 09:54:38 -0400 (Mon, 17 Aug 2009)
New Revision: 28960

Modified:
   labs/jbossrules/trunk/drools-docs/drools-docs-solver/src/main/docbook/en-US/Chapter-Solver/Section-Solver_configuration.xml
Log:
JBRULES-1977

Modified: labs/jbossrules/trunk/drools-docs/drools-docs-solver/src/main/docbook/en-US/Chapter-Solver/Section-Solver_configuration.xml
===================================================================
--- labs/jbossrules/trunk/drools-docs/drools-docs-solver/src/main/docbook/en-US/Chapter-Solver/Section-Solver_configuration.xml	2009-08-17 13:32:37 UTC (rev 28959)
+++ labs/jbossrules/trunk/drools-docs/drools-docs-solver/src/main/docbook/en-US/Chapter-Solver/Section-Solver_configuration.xml	2009-08-17 13:54:38 UTC (rev 28960)
@@ -199,7 +199,6 @@
 
     void setStartingSolution(Solution solution);
 
-    Score getBestScore();
     Solution getBestSolution();
     
     void solve();
@@ -289,6 +288,9 @@
 
     <programlisting>public interface Solution {
 
+    Score getScore();
+    void setScore(Score score);
+
     Collection&lt;? extends Object&gt; getFacts();
 
     Solution cloneSolution();
@@ -306,6 +308,25 @@
 }</programlisting>
 
     <section>
+      <title>The getScore and setScore methods</title>
+
+      <para>A <literal>Solution</literal> requires a score property. The score property is null if the
+      <literal>Solution</literal> is unitialized or if the score has not yet been (re)calculated.The score property is
+      ussually typed to the specific <literal>Score</literal> implementation you use. For example, NQueens uses a
+      <literal>SimpleScore</literal>:</para>
+
+      <programlisting>    private SimpleScore score;
+
+    public SimpleScore getScore() {
+        return score;
+    }
+
+    public void setScore(Score score) {
+        this.score = (SimpleScore) score;
+    }</programlisting>
+    </section>
+
+    <section>
       <title>The getFacts method</title>
 
       <para>All Objects returned by the <literal>getFacts()</literal> method will be asserted into the drools working
@@ -331,6 +352,7 @@
             clonedQueenList.add(queen.clone());
         }
         clone.queenList = clonedQueenList;
+        clone.score = score;
         return clone;
     }</programlisting>
 
@@ -352,6 +374,7 @@
             clonedLessonList.add(lesson.clone());
         }
         clone.lessonList = clonedLessonList;
+        clone.score = score;
         return clone;
     }</programlisting>
     </section>