com.jivesoftware.base
Interface PollManager

All Known Implementing Classes:

DbPollManager, PollManagerProxy

public interface PollManager

Provides a manager to create, retrieve and delete polls.

Polls can exist at the system (global) level or can be attached to any object.

See Also:

Poll

Method Summary

Poll	createPoll(int objectType, long objectID, User user, java.lang.String name) Create a new Poll.
void	deletePoll(Poll poll) Deletes a poll.
int	getActivePollCount() Returns a count of all active polls in the system.
int	getActivePollCount(int objectType, long objectID) Returns a count of all active polls of a given type and object ID.
java.util.Iterator	getActivePolls() Returns an iterator of active polls in the system.
java.util.Iterator	getActivePolls(int objectType, long objectID) Returns an iterator of active polls associated with the object specified by the objectType and objectID.
int	getLivePollCount() Returns a count of all live polls in the system.
int	getLivePollCount(int objectType, long objectID) Returns a count of all live polls of a given type and object ID.
java.util.Iterator	getLivePolls() Returns an iterator of live polls in the system.
java.util.Iterator	getLivePolls(int objectType, long objectID) Returns an iterator of live polls associated with the object specified by the objectType and objectID.
Poll	getPoll(long pollID) Returns the Poll specified by the poll ID.
int	getPollCount() Returns a count of all polls, both active and inactive.
int	getPollCount(int objectType, long objectID) Returns an count of polls, both active and inactive, associated with the object specified by the objectType and objectID.
java.util.Iterator	getPolls() Returns an iterator of all polls, both active and inactive.
java.util.Iterator	getPolls(int objectType, long objectID) Returns an iterator of polls, both active and inactive, associated with the object specified by the objectType and objectID.

Method Detail

createPoll

Poll createPoll(int objectType,
                long objectID,
                User user,
                java.lang.String name)
                throws UnauthorizedException

Create a new Poll. The objectType should be a valid constant from the JiveConstants class, and the objectID should be a valid ID for the given object type.

Parameters:

objectType - the object type of the object the poll is associated with.

objectID - the objectID of the object the poll is associated with.

user - the user creating the poll or null if is an anonymous user.

name - the name of the new poll.

Returns:

a new Poll object.

Throws:

UnauthorizedException - if no permissions to create a poll.

deletePoll

void deletePoll(Poll poll)
                throws UnauthorizedException,
                       PollException

Deletes a poll.

Parameters:

poll - the poll to delete

Throws:

UnauthorizedException - if no permissions to delete the poll.

PollException

getPollCount

int getPollCount()

Returns a count of all polls, both active and inactive.

Returns:

a count of all polls, both active and inactive.

getPolls

java.util.Iterator getPolls()

Returns an iterator of all polls, both active and inactive. The ordering of the polls is from active to inactive polls and then from newest to oldest in each group.

Returns:

an iterator of all polls, both active and inactive.

getPollCount

int getPollCount(int objectType,
                 long objectID)
                 throws UnauthorizedException

Returns an count of polls, both active and inactive, associated with the object specified by the objectType and objectID.

Parameters:

objectType - the object type of the object the poll is associated with.

objectID - the objectID of the object the poll is associated with.

Returns:

an count of polls, both active and inactive, associated with the object specified by the objectType and objectID.

Throws:

UnauthorizedException - if no permissions to view polls for the specified objectType and objectID.

getPolls

java.util.Iterator getPolls(int objectType,
                            long objectID)
                            throws UnauthorizedException

Returns an iterator of polls, both active and inactive, associated with the object specified by the objectType and objectID.

Parameters:

objectType - the object type of the object the poll is associated with.

objectID - the objectID of the object the poll is associated with.

Returns:

an iterator of Poll objects for polls, both active and inactive, associated with the object specified by the objectType and objectID.

Throws:

UnauthorizedException - if no permissions to view polls for the specified objectType and objectID.

getActivePolls

java.util.Iterator getActivePolls()

Returns an iterator of active polls in the system. Active polls are defined as polls where the current date is between the poll's start and expire dates.

Returns:

an iterator of active polls in the system.

getActivePollCount

int getActivePollCount()

Returns a count of all active polls in the system. Active polls are defined as polls where the current date is between the poll's start and expire dates.

Returns:

a count of all active polls in the system.

getActivePolls

java.util.Iterator getActivePolls(int objectType,
                                  long objectID)
                                  throws UnauthorizedException

Returns an iterator of active polls associated with the object specified by the objectType and objectID. Active polls are defined as polls where the current date is between the poll's start and expire dates.

Parameters:

objectType - the object type of the object the poll is associated with.

objectID - the objectID of the object the poll is associated with.

Returns:

an iterator of Poll objects for active polls associated with the object specified by the objectType and objectID.

Throws:

UnauthorizedException - if no permissions to view polls for the specified objectType and objectID.

getActivePollCount

int getActivePollCount(int objectType,
                       long objectID)

Returns a count of all active polls of a given type and object ID. Active polls are defined as polls where the current date is between the poll's start and expire dates.

Parameters:

objectType - the type of object we're looking at (defined in the JiveConstants class.

objectID - the ID of the object we're looking at.

Returns:

a count of all active polls for the given object.

getLivePolls

java.util.Iterator getLivePolls()

Returns an iterator of live polls in the system. Live polls are defined as polls where the current date is between the poll's start and end dates.

Returns:

an iterator of live polls in the system.

getLivePollCount

int getLivePollCount()

Returns a count of all live polls in the system. Live polls are defined as polls where the current date is between the poll's start and end dates.

Returns:

a count of all live polls in the system.

getLivePolls

java.util.Iterator getLivePolls(int objectType,
                                long objectID)
                                throws UnauthorizedException

Returns an iterator of live polls associated with the object specified by the objectType and objectID. Live polls are defined as polls where the current date is between the poll's start and end dates.

Parameters:

objectType - the object type of the object the poll is associated with.

objectID - the objectID of the object the poll is associated with.

Returns:

an iterator of Poll objects for live polls associated with the object specified by the objectType and objectID.

Throws:

UnauthorizedException - if no permissions to view polls for the specified objectType and objectID.

getLivePollCount

int getLivePollCount(int objectType,
                     long objectID)
                     throws UnauthorizedException

Returns a count of all live polls of a given type and object ID. Live polls are defined as polls where the current date is between the poll's start and end dates.

Parameters:

objectType - the type of object we're looking at (defined in the JiveConstants class.

objectID - the ID of the object we're looking at.

Returns:

a count of all live polls for the given object.

Throws:

UnauthorizedException

getPoll

Poll getPoll(long pollID)
             throws UnauthorizedException,
                    NotFoundException

Returns the Poll specified by the poll ID.

Parameters:

pollID - the id of the poll to return.

Returns:

the Poll specified by the pollID.

Throws:

UnauthorizedException - if no permissions to view the poll.

NotFoundException - if the poll of the given ID was not found.