BookmarkDao.java

package org.ovirt.engine.core.dao;

import java.util.List;

import org.ovirt.engine.core.common.businessentities.Bookmark;
import org.ovirt.engine.core.compat.Guid;

/**
 * {@code BookmarkDao} defines a type for performing CRUD operations on instances of {@link Bookmark}.
 */
public interface BookmarkDao extends Dao {
    /**
     * Retrieves the specified bookmark with the supplied id.
     *
     * @return the bookmark
     */
    Bookmark get(Guid id);

    /**
     * Retrieves the bookmark with the supplied name.
     *
     * @param name
     *            the bookmark name
     * @return the bookmark, or {@code null} if no such bookmark is present
     */
    Bookmark getByName(String name);

    /**
     * Returns all defined bookmarks.
     *
     * @return the collection of bookmarks
     */
    List<Bookmark> getAll();

    /**
     * Saves the bookmark.
     */
    void save(Bookmark bookmark);

    /**
     * Updates the bookmark with changes.
     */
    void update(Bookmark bookmark);

    /**
     * Removes the specified bookmark.
     *
     * @param id
     *            the bookmark id
     */
    void remove(Guid id);
}