org.jivesoftware.smackx.bookmarks

Class BookmarkManager

java.lang.Object

org.jivesoftware.smackx.bookmarks.BookmarkManager

public class BookmarkManager
extends Object

Provides methods to manage bookmarks in accordance with XEP-0048. Methods for managing URLs and Conferences are provided.

It should be noted that some extensions have been made to the XEP. There is an attribute on URLs that marks a url as a news feed and also a sub-element can be added to either a URL or conference indicated that it is shared amongst all users on a server.

Method Summary

Modifier and Type	Method and Description
void	addBookmarkedConference(String name, String jid, boolean isAutoJoin, String nickname, String password) Adds or updates a conference in the bookmarks.
void	addBookmarkedURL(String URL, String name, boolean isRSS) Adds a new url or updates an already existing url in the bookmarks.
List<BookmarkedConference>	getBookmarkedConferences() Returns all currently bookmarked conferences.
List<BookmarkedURL>	getBookmarkedURLs() Returns an unmodifiable collection of all bookmarked urls.
static BookmarkManager	getBookmarkManager(XMPPConnection connection) Returns the BookmarkManager for a connection, if it doesn't exist it is created.
void	removeBookmarkedConference(String jid) Removes a conference from the bookmarks.
void	removeBookmarkedURL(String bookmarkURL) Removes a url from the bookmarks.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getBookmarkManager

public static BookmarkManager getBookmarkManager(XMPPConnection connection)
                                          throws XMPPException,
                                                 SmackException

Returns the BookmarkManager for a connection, if it doesn't exist it is created.

Parameters:

connection - the connection for which the manager is desired.

Returns:

Returns the BookmarkManager for a connection, if it doesn't exist it is created.

Throws:

XMPPException

SmackException - thrown has not been authenticated.

IllegalArgumentException - when the connection is null.

getBookmarkedConferences

public List<BookmarkedConference> getBookmarkedConferences()
                                                    throws SmackException.NoResponseException,
                                                           XMPPException.XMPPErrorException,
                                                           SmackException.NotConnectedException

Returns all currently bookmarked conferences.

Returns:

returns all currently bookmarked conferences

Throws:

XMPPException.XMPPErrorException

SmackException.NoResponseException

SmackException.NotConnectedException

See Also:

BookmarkedConference

addBookmarkedConference

public void addBookmarkedConference(String name,
                                    String jid,
                                    boolean isAutoJoin,
                                    String nickname,
                                    String password)
                             throws SmackException.NoResponseException,
                                    XMPPException.XMPPErrorException,
                                    SmackException.NotConnectedException

Adds or updates a conference in the bookmarks.

Parameters:

name - the name of the conference

jid - the jid of the conference

isAutoJoin - whether or not to join this conference automatically on login

nickname - the nickname to use for the user when joining the conference

password - the password to use for the user when joining the conference

Throws:

XMPPException.XMPPErrorException - thrown when there is an issue retrieving the current bookmarks from the server.

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException

removeBookmarkedConference

public void removeBookmarkedConference(String jid)
                                throws SmackException.NoResponseException,
                                       XMPPException.XMPPErrorException,
                                       SmackException.NotConnectedException

Removes a conference from the bookmarks.

Parameters:

jid - the jid of the conference to be removed.

Throws:

XMPPException.XMPPErrorException - thrown when there is a problem with the connection attempting to retrieve the bookmarks or persist the bookmarks.

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException

IllegalArgumentException - thrown when the conference being removed is a shared conference

getBookmarkedURLs

public List<BookmarkedURL> getBookmarkedURLs()
                                      throws SmackException.NoResponseException,
                                             XMPPException.XMPPErrorException,
                                             SmackException.NotConnectedException

Returns an unmodifiable collection of all bookmarked urls.

Returns:

returns an unmodifiable collection of all bookmarked urls.

Throws:

XMPPException.XMPPErrorException - thrown when there is a problem retriving bookmarks from the server.

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException

addBookmarkedURL

public void addBookmarkedURL(String URL,
                             String name,
                             boolean isRSS)
                      throws SmackException.NoResponseException,
                             XMPPException.XMPPErrorException,
                             SmackException.NotConnectedException

Adds a new url or updates an already existing url in the bookmarks.

Parameters:

URL - the url of the bookmark

name - the name of the bookmark

isRSS - whether or not the url is an rss feed

Throws:

XMPPException.XMPPErrorException - thrown when there is an error retriving or saving bookmarks from or to the server

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException

removeBookmarkedURL

public void removeBookmarkedURL(String bookmarkURL)
                         throws SmackException.NoResponseException,
                                XMPPException.XMPPErrorException,
                                SmackException.NotConnectedException

Removes a url from the bookmarks.

Parameters:

bookmarkURL - the url of the bookmark to remove

Throws:

XMPPException.XMPPErrorException - thrown if there is an error retriving or saving bookmarks from or to the server.

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException