/*- * See the file LICENSE for redistribution information. * * Copyright (c) 2000,2008 Oracle. All rights reserved. * * $Id: StoredSortedKeySet.java,v 12.8 2008/01/08 20:58:36 bostic Exp $ */ package com.sleepycat.collections; import java.util.Comparator; import java.util.SortedSet; import com.sleepycat.bind.EntryBinding; import com.sleepycat.db.Database; /** * The SortedSet returned by Map.keySet() and which can also be constructed * directly if a Map is not needed. * Since this collection is a set it only contains one element for each key, * even when duplicates are allowed. Key set iterators are therefore * particularly useful for enumerating the unique keys of a store or index that * allows duplicates. * *
In addition to the standard SortedSet methods, this class provides the * following methods for stored sorted sets only. Note that the use of these * methods is not compatible with the standard Java collections interface.
*Note that the return value is a StoredCollection and must be treated * as such; for example, its iterators must be explicitly closed.
* * @param toKey is the upper bound. * * @return the subset. * * @throws RuntimeExceptionWrapper if a {@link * com.sleepycat.db.DatabaseException} is thrown. */ public SortedSet headSet(Object toKey) { return subSet(null, false, toKey, false); } /** * Returns a view of the portion of this sorted set whose elements are * strictly less than toKey, optionally including toKey. * This method does not exist in the standard {@link SortedSet} interface. * *Note that the return value is a StoredCollection and must be treated * as such; for example, its iterators must be explicitly closed.
* * @param toKey is the upper bound. * * @param toInclusive is true to include toKey. * * @return the subset. * * @throws RuntimeExceptionWrapper if a {@link * com.sleepycat.db.DatabaseException} is thrown. */ public SortedSet headSet(Object toKey, boolean toInclusive) { return subSet(null, false, toKey, toInclusive); } /** * Returns a view of the portion of this sorted set whose elements are * greater than or equal to fromKey. * This method conforms to the {@link SortedSet#tailSet} interface. * *Note that the return value is a StoredCollection and must be treated * as such; for example, its iterators must be explicitly closed.
* * @param fromKey is the lower bound. * * @return the subset. * * @throws RuntimeExceptionWrapper if a {@link * com.sleepycat.db.DatabaseException} is thrown. */ public SortedSet tailSet(Object fromKey) { return subSet(fromKey, true, null, false); } /** * Returns a view of the portion of this sorted set whose elements are * strictly greater than fromKey, optionally including fromKey. * This method does not exist in the standard {@link SortedSet} interface. * *Note that the return value is a StoredCollection and must be treated * as such; for example, its iterators must be explicitly closed.
* * @param fromKey is the lower bound. * * @param fromInclusive is true to include fromKey. * * @return the subset. * * @throws RuntimeExceptionWrapper if a {@link * com.sleepycat.db.DatabaseException} is thrown. */ public SortedSet tailSet(Object fromKey, boolean fromInclusive) { return subSet(fromKey, fromInclusive, null, false); } /** * Returns a view of the portion of this sorted set whose elements range * from fromKey, inclusive, to toKey, exclusive. * This method conforms to the {@link SortedSet#subSet} interface. * *Note that the return value is a StoredCollection and must be treated * as such; for example, its iterators must be explicitly closed.
* * @param fromKey is the lower bound. * * @param toKey is the upper bound. * * @return the subset. * * @throws RuntimeExceptionWrapper if a {@link * com.sleepycat.db.DatabaseException} is thrown. */ public SortedSet subSet(Object fromKey, Object toKey) { return subSet(fromKey, true, toKey, false); } /** * Returns a view of the portion of this sorted set whose elements are * strictly greater than fromKey and strictly less than toKey, * optionally including fromKey and toKey. * This method does not exist in the standard {@link SortedSet} interface. * *Note that the return value is a StoredCollection and must be treated * as such; for example, its iterators must be explicitly closed.
* * @param fromKey is the lower bound. * * @param fromInclusive is true to include fromKey. * * @param toKey is the upper bound. * * @param toInclusive is true to include toKey. * * @return the subset. * * @throws RuntimeExceptionWrapper if a {@link * com.sleepycat.db.DatabaseException} is thrown. */ public SortedSet subSet(Object fromKey, boolean fromInclusive, Object toKey, boolean toInclusive) { try { return new StoredSortedKeySet( view.subView(fromKey, fromInclusive, toKey, toInclusive, null)); } catch (Exception e) { throw StoredContainer.convertException(e); } } }