<?php

namespace Herzult\Bundle\ForumBundle\Model;

interface TopicRepositoryInterface extends RepositoryInterface

{

/**

* Finds one topic by its category and its slug

*

* @param Category $category

* @paral string $slug

* @return Topic or NULL

**/

function findOneByCategoryAndSlug($category, $slug);

/**

* Finds one topic by its id

*

* @param integer $id

* @return Topic or NULL whether the specified id does not match any topic

*/

function findOneById($id);

/**

* Finds all topics ordered by their last pull date

*

* @param boolean $asPaginator Will return a Paginator instance if true

* @return array|Paginator

*/

function findAll($asPaginator);

/**

* Finds all topics matching to the specified Category ordered by their

* last pull date

*

* @param integer|Category $category

* @param boolean $asPaginator Will return a Paginator instance if true

* @return array|Paginator

*/

function findAllByCategory($category, $asPaginator);

/**

* Get topics which have the more recent last post

*

* @param int $number

* @return array of Topics

*/

function findLatestPosted($number);

/**

* Finds all topics matching the specified query ordered by their

* last pulled date

*

* @param string $query

* @param boolean $asPaginator Will return a Paginator instance if true

* @return array|Paginator

*/

function search($query, $asPaginator);

/**

* Increment the number of views of a topic

*

* @param Topic $topic

* @return void

*/

function incrementTopicNumViews($topic);

/**

* Creates a new post instance

*

* @return Topic

*/

function createNewTopic();

}