org.spincast.website.repositories.INewsRepository Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of spincast-website Show documentation

Source code for the https://www.spincast.org website.

The newest version!

package org.spincast.website.repositories;

import java.util.List;

import org.spincast.website.models.INewsEntriesAndTotalNbr;
import org.spincast.website.models.INewsEntry;

/**
 * Repository for Spincast's news entry / blog entries.
 */
public interface INewsRepository {

    /**
     * Gets news entries number.
     */
    public int getNewsEntriesTotalNumber();

    /**
     * Gets all the news entries.
     * 
     * @param ascOrder If true, returns the entries by their
     * publication date in ascending order. Otherwise, in descending
     * order.
     */
    public List getNewsEntries(boolean ascOrder);

    /**
     * Gets news entries.
     * 
     * @param startPos The position of the first entry to return. The first element
     * is "1", not "0".
     * 
     * @param endPos The position of the last entry to return (inclusive).
     * 
     * @param ascOrder If true, returns the entries by their
     * publication date in ascending order. Otherwise, in descending
     * order.
     */
    public List getNewsEntries(int startPos, int endPos, boolean ascOrder);

    /**
     * Gets news entries and the number total of entries in the data source.
     * 
     * @param startPos The position of the first entry to return. The first element
     * is "1", not "0".
     * @param endPos The position of the last entry to return (inclusive).
     * 
     * @param ascOrder If true, returns the entries by their
     * publication date in ascending order. Otherwise, in descending
     * order.
     */
    public INewsEntriesAndTotalNbr getNewsEntriesAndTotalNbr(int startPos, int endPos, boolean ascOrder);

    /**
     * Gets a specific news entry.
     * 
     * @return the news entry or null if not found.
     */
    public INewsEntry getNewsEntry(long newsId);

}