com.gemstone.gemfire.internal.cache.persistence.query.ResultBag Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of gemfire-core Show documentation
Show all versions of gemfire-core Show documentation
SnappyData store based off Pivotal GemFireXD
The newest version!
/*
* Copyright (c) 2010-2015 Pivotal Software, Inc. All rights reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"); you
* may not use this file except in compliance with the License. You
* may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
* implied. See the License for the specific language governing
* permissions and limitations under the License. See accompanying
* LICENSE file.
*/
package com.gemstone.gemfire.internal.cache.persistence.query;
import com.gemstone.gemfire.internal.cache.CachedDeserializable;
/**
* The contract for a sorted bag of temporary results for a query.
* This bag may be persisted on disk.
*
* This class is threadsafe. Iterators will reflect all entries added to
* the set up until the time that the iterator was obtained. After that they
* may or may not reflect modifications to the set while the iteration is in progress.
* They will guarantee that entries will be returned in the correct order.
*
* The element is allowed to be an object, or a CachedDeserializable.
*
* If multiple instances of the same element are required, use SortedResultBag
* instead.
*
* The result set should be closed using the close method to free up resources
* when it is no longer in use.
*
* @author dsmith
* @since 7.5
*/
public interface ResultBag {
/**
* Add an element to the bag. Multiple copies of the same
* entry may be inserted into the bag.
* @param e the element. e may be NULL.
*/
void add(Object e);
/**
* Return all of the elements in the set.
*/
CloseableIterator iterator();
/**
* Close the result set and free up any resources on disk
* associated with the result set.
*/
public void close();
}