Release 0.9.2.

git-svn-id: https://olap4j.svn.sourceforge.net/svnroot/olap4j/trunk@49 c6a108a4-781c-0410-a6c6-c2d559e19af0

CHANGES.txt

@@ -0,0 +1,224 @@
+# $Id$
+# Changes to olap4j since olap4j-0.5.
+
+------------------------------------------------------------------------
+r48 | jhyde | 2007-12-02 02:42:19 -0800 (Sun, 02 Dec 2007) | 1 line
+
+Fix release issues noted by John Sichi.
+------------------------------------------------------------------------
+r47 | jhyde | 2007-11-27 20:03:57 -0800 (Tue, 27 Nov 2007) | 1 line
+
+Website re-design.
+------------------------------------------------------------------------
+r46 | jhyde | 2007-11-21 19:41:45 -0800 (Wed, 21 Nov 2007) | 1 line
+
+Fix build for JDK 1.6; check in mondrian jars built under JDK 1.5 (not
+JDK 1.6); add script to recursively switch to JDK 1.6 and invoke ant
+to build a couple of classes.
+------------------------------------------------------------------------
+r45 | jhyde | 2007-11-21 19:31:13 -0800 (Wed, 21 Nov 2007) | 1 line
+
+Latest spec in PDF format. Obsolete SpringSample.
+------------------------------------------------------------------------
+r44 | jhyde | 2007-11-21 04:09:46 -0800 (Wed, 21 Nov 2007) | 1 line
+
+Check in necessary libraries. Mondrian as of change 10210. Remove
+dependency on spring. Revise README and up version number.
+------------------------------------------------------------------------
+r43 | jhyde | 2007-11-20 17:57:47 -0800 (Tue, 20 Nov 2007) | 1 line
+
+Enable keyword expansion.
+------------------------------------------------------------------------
+r42 | jhyde | 2007-11-20 17:39:37 -0800 (Tue, 20 Nov 2007) | 1 line
+
+Move test parameters out of source code and into a
+file. 'test.properties' should be the only file you need to
+edit. Provided 'test.properties.example'. First cut README.txt.
+------------------------------------------------------------------------
+r41 | jhyde | 2007-11-17 17:33:12 -0800 (Sat, 17 Nov 2007) | 1 line
+
+Trip down which packages/classes appear in public API javadoc.
+------------------------------------------------------------------------
+r40 | jhyde | 2007-11-17 17:13:26 -0800 (Sat, 17 Nov 2007) | 1 line
+
+Specify thread-safety, timeout, statement cancel; Specify compliance
+levels; Specify access control; Specify internationalization; add
+OlapConnection.get/setLocale. Add diagram of object model to spec;
+Ensure that every public class and method has a full javadoc
+description. Implement timeout and cancel in mondrian driver; and
+test. Implement drill-through in mondrian driver; and test. Make
+CellSetAxis implement Iterable<Position>. Remove some unneeded methods
+from org.olap4j.type package. Rename SLICER to FILTER.
+------------------------------------------------------------------------
+r39 | jhyde | 2007-11-13 01:46:46 -0800 (Tue, 13 Nov 2007) | 1 line
+
+Oops, fix for JDK 1.5.
+------------------------------------------------------------------------
+r38 | jhyde | 2007-11-13 01:37:16 -0800 (Tue, 13 Nov 2007) | 4 lines
+
+Lots of tests for metadata classes, and implement corresponding
+functionality in mondrian driver. Review org.olap4j.type package, and
+remove/hide several methods. Add API for creating validator and
+validating an MDX parse tree. Test that non-unique axis names cause a
+validation error.
+------------------------------------------------------------------------
+r37 | jhyde | 2007-11-11 20:14:39 -0800 (Sun, 11 Nov 2007) | 1 line
+
+Javadoc fixes. One javadoc target documents the public API, another to
+check all javadoc including against private methods and test classes.
+------------------------------------------------------------------------
+r36 | perfecthash | 2007-11-05 01:06:12 -0800 (Mon, 05 Nov 2007) | 3
+lines
+
+Add unit test for construction of an MDX statement via language object model.
+
+
+------------------------------------------------------------------------
+r35 | jhyde | 2007-10-23 14:42:48 -0700 (Tue, 23 Oct 2007) | 1 line
+
+Document and revise OlapDatabaseMetaData methods; write unit tests for
+all methods; implement methods in mondrian's olap4j driver.
+------------------------------------------------------------------------
+r34 | perfecthash | 2007-10-06 20:06:58 -0700 (Sat, 06 Oct 2007) | 4
+lines
+
+Delete "ant test" task, add one for removing site-specifics from
+unit test code.
+
+
+------------------------------------------------------------------------
+r33 | perfecthash | 2007-09-26 22:11:22 -0700 (Wed, 26 Sep 2007) | 3 lines
+
+Implement ant "test" target.
+
+
+------------------------------------------------------------------------
+r32 | perfecthash | 2007-09-26 17:54:27 -0700 (Wed, 26 Sep 2007) | 3 lines
+
+Just testing commit privileges.
+
+
+------------------------------------------------------------------------
+r31 | jhyde | 2007-09-21 19:29:21 -0700 (Fri, 21 Sep 2007) | 1 line
+
+Correct typos in spec; eliminate QueryAxis.xxxDimension and
+QueryDimension.xxxSelection methods; property methods now take a
+Property, not the property name
+------------------------------------------------------------------------
+r30 | jhyde | 2007-09-21 02:14:34 -0700 (Fri, 21 Sep 2007) | 1 line
+
+A few more parameters to OlapDatabaseMetaData.getXxx methods
+------------------------------------------------------------------------
+r29 | jhyde | 2007-09-21 00:13:14 -0700 (Fri, 21 Sep 2007) | 1 line
+
+Add parameters to OlapDatabaseMetaData.getXxx methods
+------------------------------------------------------------------------
+r28 | jhyde | 2007-09-20 03:46:43 -0700 (Thu, 20 Sep 2007) | 1 line
+
+Javadoc and spec tasks, mostly adding descriptions of metadata elements.
+------------------------------------------------------------------------
+r27 | jhyde | 2007-09-18 00:34:57 -0700 (Tue, 18 Sep 2007) | 1 line
+
+Add task list, and minor spec/javadoc edits
+------------------------------------------------------------------------
+r26 | jhyde | 2007-08-14 23:55:30 -0700 (Tue, 14 Aug 2007) | 1 line
+
+Fix build under JDK 1.5
+------------------------------------------------------------------------
+r25 | jhyde | 2007-08-09 00:50:03 -0700 (Thu, 09 Aug 2007) | 1 line
+
+Add skeleton olap4j driver for XMLA
+------------------------------------------------------------------------
+r24 | jhyde | 2007-07-24 22:56:33 -0700 (Tue, 24 Jul 2007) | 1 line
+
+Add junit.jar
+------------------------------------------------------------------------
+r23 | jhyde | 2007-06-14 20:53:14 -0700 (Thu, 14 Jun 2007) | 1 line
+
+Add notion of ParseRegion to parser and parse tree nodes.
+------------------------------------------------------------------------
+r22 | jhyde | 2007-06-14 19:23:07 -0700 (Thu, 14 Jun 2007) | 1 line
+
+In mondrian driver, create dual implementations of key JDBC objects to
+allow running against both JDBC 3.0 (JDK 1.5) and JDBC 4.0 (JDK 1.6);
+add OlapWrapper for JDBC 3.0 users, who have no access to
+java.sql.Wrapper methods; implement OlapPreparedStatement in mondrian
+driver.
+------------------------------------------------------------------------
+r21 | jhyde | 2007-06-14 13:37:17 -0700 (Thu, 14 Jun 2007) | 1 line
+
+Get mondrian classes from parallel source directory, not log file (for now); fix 'ant clean' mayhem; add 'javadoc-with-ydoc' ant target.
+------------------------------------------------------------------------
+r20 | jhyde | 2007-06-10 16:09:28 -0700 (Sun, 10 Jun 2007) | 1 line
+
+Enable keyword substitution
+------------------------------------------------------------------------
+r19 | jhyde | 2007-06-10 15:53:45 -0700 (Sun, 10 Jun 2007) | 1 line
+
+Obsolete Database and Olap4j; update spec with parse tree model
+changes; enable keyword substitutions
+------------------------------------------------------------------------
+r18 | jhyde | 2007-06-10 11:31:17 -0700 (Sun, 10 Jun 2007) | 1 line
+
+Add query model (from James Dixon), parser and parser object model.
+------------------------------------------------------------------------
+r17 | jhyde | 2007-05-25 15:34:38 -0700 (Fri, 25 May 2007) | 1 line
+
+Rename OlapResultSet to CellSet, OlapResultSetMetaData to
+CellSetMetaData, OlapResultAxis to CellSetAxis, ResultCell to Cell,
+ResultSetPosition to Position; add implementation of olap4j against
+mondrian, and a unit test
+------------------------------------------------------------------------
+r16 | jhyde | 2006-10-24 15:48:56 -0700 (Tue, 24 Oct 2006) | 1 line
+
+Add NamedSet and Database; clean up schema result set defns in spec;
+switch some uses of SQLException to OlapException
+------------------------------------------------------------------------
+r15 | jhyde | 2006-10-24 01:41:02 -0700 (Tue, 24 Oct 2006) | 1 line
+
+Changes to org.olap4j package regarding result sets, and
+org.olap4j.metadata package regarding Database, Catalog, Schema
+------------------------------------------------------------------------
+r14 | jhyde | 2006-10-20 17:35:30 -0700 (Fri, 20 Oct 2006) | 1 line
+
+Add items from 2006/10/20 progress meeting to spec.
+------------------------------------------------------------------------
+r13 | jhyde | 2006-10-19 13:06:48 -0700 (Thu, 19 Oct 2006) | 1 line
+
+Barry Klawans's changes to Transform component of olap4j specification
+------------------------------------------------------------------------
+r12 | jhyde | 2006-10-17 17:32:56 -0700 (Tue, 17 Oct 2006) | 1 line
+
+Move JDK topic from 'open issues' to body of spec; clean up some links.
+------------------------------------------------------------------------
+r11 | jhyde | 2006-10-17 17:31:42 -0700 (Tue, 17 Oct 2006) | 1 line
+
+Include PNG images in doczip.
+------------------------------------------------------------------------
+r10 | jhyde | 2006-10-15 22:37:08 -0700 (Sun, 15 Oct 2006) | 1 line
+
+Update specification and java code, especially metadata
+(org.olap4j.metadata) and type (org.olap4j.type) sections, and
+description of how to interoperate with connection pools.
+------------------------------------------------------------------------
+r9 | jhyde | 2006-10-12 03:07:40 -0700 (Thu, 12 Oct 2006) | 1 line
+
+Add table of contents functional spec, and some content regarding
+drivers, connections and statements; Add ant target to generate
+javadoc in PDF format; Rename OlapResult to OlapResultSet.
+------------------------------------------------------------------------
+r8 | jhyde | 2006-09-03 18:57:41 -0700 (Sun, 03 Sep 2006) | 1 line
+
+Tweak stylesheet.
+------------------------------------------------------------------------
+r7 | jhyde | 2006-09-03 02:23:08 -0700 (Sun, 03 Sep 2006) | 1 line
+
+Release 0.5 (continued).
+------------------------------------------------------------------------
+r6 | jhyde | 2006-09-03 01:57:45 -0700 (Sun, 03 Sep 2006) | 1 line
+
+Release 0.5.
+------------------------------------------------------------------------
+
+# End CHANGES.txt
+

README.txt

@@ -36,7 +36,7 @@ The mondrian driver requires the following additional files at run time:
 
 Note that mondrian.jar is built from a development version of mondrian, not
 an official release. The source code was p4:perforce.eigenbase.org:1666 (a
-point between mondrian-2.4.2 and mondrian-3.0), change 10210.
+point between mondrian-2.4.2 and mondrian-3.0), change 10247.
 
 Building olap4j from source
 ---------------------------
@@ -75,7 +75,8 @@ Running the test suite
 Follow the instructions for 'Building olap4j from source'. Then:
 
 1. Download the latest mondrian release (mondrian-2.4.2) and use the
- MondrianFoodMartLoader utility to load the sample database.
+ MondrianFoodMartLoader utility to load the sample database into the DBMS of
+ your choice.
 2. In the root of the source tree, create a file called "test.properties"
  describing your environment. The easiest way to this is to copy
  "test.properties.example" and customize it. Note that you will need to

build.xml

@@ -15,7 +15,7 @@
  <property file="${project.location}/test.properties"/>
  <property name="project.build.debug" value="on"/>
  <property name="name" value="olap4j"/>
- <property name="version" value="0.9.0"/>
+ <property name="version" value="0.9.2"/>
  <property name="dist.name" value="${name}-${version}" />
 
  <!-- properties related to paths -->
@@ -171,7 +171,7 @@ ${jar-jdk14.file}"/>
  </target>
 
  <target name="version">
- <echo message="olap4j ${version}" file="VERSION.txt"/>
+ <echo message="olap4j ${version}${line.separator}" file="VERSION.txt"/>
  </target>
 
  <target name="parser">
@@ -225,7 +225,7 @@ buildJdk16.sh" />
  <target name="release" depends="clean-deep, binzip"/>
 
  <target name="binzip"
- depends="clean,jar,version,srczip,retroweave,jar-jdk14,javadoc,javadoc-pdf">
+ depends="clean,version,jar,srczip,retroweave,jar-jdk14,javadoc,javadoc-pdf">
  <mkdir dir="${dist.dir}" />
  <delete file="${dist.bin.file}"/>
  <zip zipfile="${dist.bin.file}">

doc/deployDoc.sh

@@ -3,7 +3,7 @@
 # This software is subject to the terms of the Common Public License
 # Agreement, available at the following URL:
 # http://www.opensource.org/licenses/cpl.html.
-# Copyright (C) 2005-2005 Julian Hyde
+# Copyright (C) 2005-2007 Julian Hyde
 # All Rights Reserved.
 # You must accept the terms of that agreement to use this software.
 #
@@ -24,8 +24,8 @@ prefix="$1"
 # Directory at sf.net
 docdir=
 case "$prefix" in
-0.5) export docdir=htdocs;;
-head) export docdir=head;;
+release) export docdir=olap4j;;
+head) export docdir=olap4j.head;;
 *) echo "Bad prefix '$prefix'"; exit 1;;
 esac
 
@@ -68,11 +68,15 @@ set -v
 cd /home/jhyde
 tar xzf doc.tar.gz
 rm -rf olap4j.old
-if [ -d olap4j ]; then mv olap4j olap4j.old; fi
-mv doc olap4j
-rm -rf olap4j.old
+if [ -d $docdir ]; then mv $docdir $docdir.old; fi
+mv doc $docdir
+rm -rf $docdir.old
 rm -f doc.tar.gz
-./makeLinks
+case $docdir in
+olap4j) (cd olap4j; rm -rf head; ln -s . head) ;;
+olap4j.head) (cd olap4j; rm -rf head; mv ../olap4j.head ./head) ;;
+esac
+./makeLinks $docdir
 EOF
 
 fi

doc/index.html

@@ -150,7 +150,7 @@
  <p class="box_header">
  Think of it like 
  <span style="font-variant: small-caps">JDBC</span>, 
- except for accessing multi-dimensional data.</p>
+ but for accessing multi-dimensional data.</p>
  <br />
  <p class="box_subheader">
  olap4j is designed to be 
@@ -173,19 +173,22 @@
 
  <tr>
  <td width="100%" valign="top" style="padding-bottom: 10px;"><h4>Status</h4>
- The olap4j specification will go beta in early December 2007. The first release candidate, olap4j-0.9.1, is available for download now. The olap4j release includes the specification, a reference implementation of the API in the form of a olap4j driver for mondrian, and a Test Compatibility Kit (TCK) consisting of a suite of JUnit tests. In the 0.9 beta release, the API includes full support for managing connections, statements, multidmensional result sets, parsing and validating MDX, and managing metadata.
+ <p>The olap4j specification will go beta in early December 2007. The second release candidate, olap4j-0.9.2, is available for download now.</p><br/>
+ <p>The olap4j release includes the specification, a reference implementation of the API in the form of a olap4j driver for mondrian, and a Test Compatibility Kit (TCK) consisting of a suite of JUnit tests. In the 0.9 beta release, the API includes full support for managing connections, statements, multidimensional result sets, parsing and validating MDX, and managing metadata.</p>
 <h4>Resources</h4>
 <ul>
  <li><a href="http://sourceforge.net/projects/olap4j">olap4j project at SourceForge</a></font></li>
- <li><a href="http://sourceforge.net/project/showfiles.php?group_id=168953">Download 0.9 specification and release</a></li>
+ <li>Download 0.9 <a href="http://sourceforge.net/project/showfiles.php?group_id=168953">release</a>
+ and specification (<a href="http://sourceforge.net/project/showfiles.php?group_id=168953">PDF</a> or <a href="olap4j_fs.html">HTML</a>)</li>
  <li><a href="api/index.html">API javadoc</a></li>
  <li>For project committers: latest <a href="head/api/index.html">API</a>
  and <a href="http://olap4j.svn.sourceforge.net/viewvc/*checkout*/olap4j/trunk/doc/olap4j_fs.html">specification (HTML)</a>.</li>
  </ul>
 
  <h4>Get involved!</h4> 
- Join the <a href="http://sourceforge.net/forum/forum.php?forum_id=577988">forum</a>, download the specification, and give us your feedback. If you are developing an OLAP server, component or 
- application, let's work together to make&nbsp;your project olap4j-compliant.</td>
+ <p>Join the <a href="http://sourceforge.net/forum/forum.php?forum_id=577988">forum</a>, download the specification, and give us your feedback. If you are developing an OLAP server, component or 
+ application, let's work together to make your project olap4j-compliant.</p><br/>
+ <p>Drivers for mondrian and XML/A are under development; we're looking for committers to work on these drivers and drivers for other servers.</p></td>
  <td rowspan="5" class="col_spacer" style="padding-bottom: 10px;"><img src="images/spacer.png" class="col_spacer"/></td>
  <td rowspan="4" valign="top" style="padding-bottom: 10px;"><div class="participation_bg"><h4 style="margin: 0px;">Participation</h4>
  olap4j is an open specification, being developed by a consortium of companies and open source projects, including:

doc/olap4j_fs.html

@@ -79,10 +79,10 @@
 <h1>olap4j Specification</h1>
 
 <p>Authors: Julian Hyde, Barry Klawans<br>
-Version: 0.89.3-dev (draft)<br>
+Version: 0.9 (beta)<br>
 Revision: $Id$
 (<a href="http://olap4j.svn.sourceforge.net/viewvc/olap4j/trunk/doc/olap4j_fs.html?view=log">log</a>)<br>
-Last modified: November 18<sup>th</sup>, 2007.</p>
+Last modified: December 2<sup>nd</sup>, 2007.</p>
 <hr noshade="noshade">
 
 <h2><a name="Contents">Contents</a></h2>
@@ -2406,7 +2406,6 @@ <h5>2.7.3.7. <a name="getHierarchies">getHierarchies</a></h5>
  <li><b>MD_INSTANCE_SELECTION_FILTEREDLIST</b></li>
  <li><b>MD_INSTANCE_SELECTION_MANDATORYFILTER</b></li>
  </ul>
- <p>[todo: find the ordinals corresponding to these values]</td>
 </tr>
 </tbody></table>