jforum example source code file (PostDAO.java)

This example jforum source code file (PostDAO.java) is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" ^TM.

Java - jforum tags/keywords

list, list, post, post, postdao, postdao, util

The jforum PostDAO.java source code

/*
 * Copyright (c) JForum Team
 * All rights reserved.
 * 
 * Redistribution and use in source and binary forms, 
 * with or without modification, are permitted provided 
 * that the following conditions are met:
 * 
 * 1) Redistributions of source code must retain the above 
 * copyright notice, this list of conditions and the 
 * following  disclaimer.
 * 2)  Redistributions in binary form must reproduce the 
 * above copyright notice, this list of conditions and 
 * the following disclaimer in the documentation and/or 
 * other materials provided with the distribution.
 * 3) Neither the name of "Rafael Steil" nor 
 * the names of its contributors may be used to endorse 
 * or promote products derived from this software without 
 * specific prior written permission.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT 
 * HOLDERS AND CONTRIBUTORS "AS IS" AND ANY 
 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, 
 * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL 
 * THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE 
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, 
 * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 
 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 
 * IN CONTRACT, STRICT LIABILITY, OR TORT 
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 
 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE
 * 
 * This file creating date: Feb 23, 2003 / 2:49:48 PM
 * The JForum Project
 * http://www.jforum.net
 */
package net.jforum.dao;

import java.util.List;

import net.jforum.entities.Post;

/**
  * Model interface for {@link net.jforum.entities.Post}.
 * This interface defines methods which are expected to be
 * implementd by a specific data access driver. The intention is
 * to provide all functionality needed to update, insert, delete and
 * select some specific data.
 * 
 * @author Rafael Steil
 * @version $Id: PostDAO.java,v 1.12 2007/08/20 19:35:52 rafaelsteil Exp $
 */
public interface PostDAO 
{
	/**
	 * Gets a specific <code>Post.
	 * 
	 * @param postId The Post ID to search
	 * @return <code>Postobject containing all the information
	 */
	public Post selectById(int postId) ;
		
	/**
	 * Delete a Post.
	 * 
	 * @param post Post The Post to delete
	 */
	public void delete(Post post) ;
	
	/**
	 * Updates a Post.
	 * 
	 * @param post Reference to a <code>Post object to update
	 */
	public void update(Post post) ;
	
	/**
	 * Adds a new Post.
	 * 
	 * @param post Post Reference to a valid and configured <code>Post object
	 * @return The new ID
	 */
	public int addNew(Post post) ;
	
	/**
	 * Selects all messages relacted to a specific topic. 
	 * 
	 * @param topicId The topic ID 
	 * @param startFrom The count position to start fetching
	 * @param count The total number of records to retrieve
	 * @return <code>ArrayList containing all records found. Each entry of the ArrayList is a {@link net.jforum.entities.Post} object
	 */
	public List selectAllByTopicByLimit(int topicId, int startFrom, int count) ;


       /**
	 * Selects all posts associated to a specific user and belonging to 
	 * given forums
	 * @param userId int User ID.
	 * @param startFrom int
	 * @param count int
	 * @return  List
	 */
	public List selectByUserByLimit(int userId,int startFrom, int count) ;

    /**
     * Count user posts.
     * @param userId int
     * @return int
     */
	public int countUserPosts(int userId) ;

	/**
	 * Selects all messages relacted to a specific topic. 
	 * 
	 * @param topicId The topic ID 
	 * @return <code>ArrayList containing all records found. Each entry of the ArrayList is a {@link net.jforum.entities.Post} object
	 */
	public List selectAllByTopic(int topicId) ;
	
	/**
	 * Delete all posts related to the given topic
	 * 
	 * @param topicId int
	 */
	public void deleteByTopic(int topicId) ;

	/**
	 * Count how many previous posts there are before the given post id
	 * @param postId int
	 * @return int
	 */
	public int countPreviousPosts(int postId) ;
	
	public List selectLatestByForumForRSS(int forumId, int limit);
	
	public List selectHotForRSS(int limit);
}