Added support for sorting on a dimension inclusions with the "break h…

…ierarchy" functionnality.

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

src/org/olap4j/query/QueryDimension.java

@@ -357,17 +357,40 @@ public Selection remove(int index) {
  }
  }
 
+ /**
+ * Defines in what order to perform the sort.
+ */
  public static enum SortOrder {
  /**
- * Ascending sort order.
+ * Ascending sort order. Members of
+ * the same hierarchy are still kept together.
  */
  ASC,
  /**
- * Descending sort order.
+ * Descending sort order. Members of
+ * the same hierarchy are still kept together.
+ */
+ DESC,
+ /**
+ * Sorts in ascending order, but does not
+ * maintain members of a same hierarchy
+ * together. This is known as a "break
+ * hierarchy ascending sort".
  */
- DESC
+ BASC,
+ /**
+ * Sorts in descending order, but does not
+ * maintain members of a same hierarchy
+ * together. This is known as a "break
+ * hierarchy descending sort".
+ */
+ BDESC
  }
 
+ /**
+ * Defines in which way the hierarchize operation
+ * should be performed.
+ */
  public static enum HierarchizeMode {
  /**
  * Parents are placed before children.