[Javamatch-cvs] javamatch/docs/website javamatch.xml,1.3,1.4

[Walter v. I. <it...@us...>]

Update of /cvsroot/javamatch/javamatch/docs/website
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv20888

Modified Files:
	javamatch.xml 
Log Message:
Add chapter "integration with Prevayler"

Index: javamatch.xml
===================================================================
RCS file: /cvsroot/javamatch/javamatch/docs/website/javamatch.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** javamatch.xml	3 Sep 2004 13:48:07 -0000	1.3
--- javamatch.xml	6 Sep 2004 09:13:04 -0000	1.4
***************
*** 42,48 ****
  MatchResult matchResult = matchEngine.executeQuery(query, campSites);
  </p>
! <p><i><b>
  Note: the syntax for retrieval of data members (such as "size") will change in version 0.2
! </b></i></p>
  <p>
      Class MatchResult contains a list of ResultItem's. A ResultItem consists of a
--- 42,48 ----
  MatchResult matchResult = matchEngine.executeQuery(query, campSites);
  </p>
! <p><b><i>
  Note: the syntax for retrieval of data members (such as "size") will change in version 0.2
! </i></b></p>
  <p>
      Class MatchResult contains a list of ResultItem's. A ResultItem consists of a
***************
*** 104,108 ****
  <h2>Download</h2>
  <p>
! JavaMatch can be downloaded from <a href="http://sourceforge.net/projects/javamatch">sourceforge</a>.
  </p>
  <h2>Installation</h2>
--- 104,109 ----
  <h2>Download</h2>
  <p>
! JavaMatch can be downloaded from <a href="http://sourceforge.net/project/showfiles.php?group_id=116811">
! sourceforge</a>.
  </p>
  <h2>Installation</h2>
***************
*** 213,221 ****
  the database, which leads to a lot less data retrieval.</li>
  </ul>
! <h3>Object relational mapping</h3>
  <ul>
! <li>OR-tools</li>
! <li><a href="http://www.jdocentral.com">Java Data Objects</a></li>
! <li><a href="http://www.hibernate.org/">Hibernate</a></li>
  </ul>
  <h3>Object data retrieval</h3>
--- 214,222 ----
  the database, which leads to a lot less data retrieval.</li>
  </ul>
! <h3>Persistent storage</h3>
  <ul>
! <li><a href="http://www.prevayler.org">Prevayler</a> (Persistence without database)</li>
! <li><a href="http://www.jdocentral.com">Java Data Objects</a> (standard for object-relational mapping)</li>
! <li><a href="http://www.hibernate.org/">Hibernate</a> (Object-relational mapping tool)</li>
  </ul>
  <h3>Object data retrieval</h3>
***************
*** 228,231 ****
--- 229,283 ----
  </ul>
  </page>
+ <page title="Integration" filebase="integration">
+ <p class="intro">
+ JavaMatch does not stand on its own. Data structures are typically not only kept
+ in memory, but also stored in a file system or database. This page describes how
+ JavaMatch works in combination with such storage mechanisms.
+ </p>
+ <a name="prevayler"/><h2>Prevayler</h2>
+ <p class="intro">
+ <a href="http://www.prevayler.org">Prevayler</a> does not use a database. It keeps the entire 
+ data structure in memory. Therefore, matching the data that is persisted in Prevayler is 
+ exactly the same as matching data that is not persisted.
+ </p>
+ <h3>Example</h3>
+ <p>
+ Prevayler has an example bank application, that is used to handle accounts. This can be 
+ found in directory src\org\prevayler\demos\demo2\gui in the Prevayler source distribution.
+ The program maintains a list of accounts, each with a balance, where you can desposit,
+ withdraw and transfer money.
+ </p>
+ <p>
+ With JavaMatch, this program can be extended to show a list of "most interesting accounts": 
+ The accounts that have the highest balance, or that are the most active (had the most 
+ deposits, withdrawals and transfers). The business logic doesn't need any changes, it's 
+ just another view on the same data.
+ </p>
+ <p>
+ To run this demo, put the file <a href="prevayler/MatchFrame.java">MatchFrame.java</a>
+ in directory src/org/prevayler/demos/demo2/gui. Then edit file 
+ src/org/prevayler/demos/demo2/gui/BankFrame.java: Where the frames are created (near line 27 
+ in the current version), add the line
+ </p>
+ <p class="source">new MatchFrame(prevayler, desktop);
+ </p>
+ <p>
+ This adds another frame to the user interface, one that shows the results of the matching.
+ </p>
+ <p>
+ Before compiling the demo, add <a href="javamatch.jar">javamatch.jar</a> to the lib
+ directory, and add this to the classpath when compiling / running the application.
+ </p>
+ <p><b><i>
+ Note: This will not work with release 0.1, as the syntax for retrieving class members has 
+ changed since release 0.1 Please use the <a href="javamatch.jar">snapshot version</a> instead. 
+ </i></b></p>
+ <p>If you have <a href="http://ant.apache.org">ant</a>, you might want to use 
+ <a href="prevayler/build.xml">build.xml</a>. Put it in the prevayler-X.YY.ZZZ directory,
+ run ant in that same directory, and you'll see the demo:
+ <img src="prevayler/screenshot.png" alt="Prevayler screenshot"/>
+ </p>
+ 
+ </page>
  <page title="Project" filebase="project">
  <h2>Releases</h2>
***************
*** 275,278 ****
--- 327,334 ----
      </tr>
      <tr>
+         <td>20040906</td>
+         <td>Added Prevayler demo</td>
+     </tr>
+     <tr>
          <td>20040903</td>
          <td>Made mailing lists, cvs archive, updates to web site<br/>