/* ********************************************************************** **
** Copyright notice **
** **
** (c) 2005-2009 RSSOwl Development Team **
** http://www.rssowl.org/ **
** **
** All rights reserved **
** **
** This program and the accompanying materials are made available under **
** the terms of the Eclipse Public License v1.0 which accompanies this **
** distribution, and is available at: **
** http://www.rssowl.org/legal/epl-v10.html **
** **
** A copy is found in the file epl-v10.html and important notices to the **
** license from the team is found in the textfile LICENSE.txt distributed **
** in this package. **
** **
** This copyright notice MUST APPEAR in all copies of the file! **
** **
** Contributors: **
** RSSOwl Development Team - initial API and implementation **
** **
** ********************************************************************** */
package org.rssowl.core.persist.service;
/**
* Generates unique ids.
* <p>
* Contributed via <code>org.rssowl.core.IDGenerator</code> Extension Point.
* </p>
*/
public interface IDGenerator {
/**
* Performs any maintenance operations before a shutdown. Many generators
* batch operations to the persistence layer to improve performance. A typical
* operation for that type of generator is to return any unused ids to the
* pool.
*/
void shutdown();
/**
* @return an id that has not been returned from this method before as long as
* the persistence layer used by the generator has not been cleared. The
* number returned should be >= 1.
*/
long getNext();
}