Jive Forums API (5.5.20.2-oracle) Developer Javadocs

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.

Jive Forums Project Page

Copyright © 1999-2006 Jive Software.