BookmarkManager (Smack 4.3.1 API)

java.lang.Object
- org.jivesoftware.smackx.bookmarks.BookmarkManager

```
public final 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

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addBookmarkedConference(String name, EntityBareJid jid, boolean isAutoJoin, Resourcepart 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.
`boolean`	`isSupported()` Check if the service supports bookmarks using private data.
`void`	`removeBookmarkedConference(EntityBareJid 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)
```
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:

IllegalArgumentException - when the connection is null.

getBookmarkedConferences

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

Returns all currently bookmarked conferences.

Returns:: returns all currently bookmarked conferences
Throws:: XMPPException.XMPPErrorException; SmackException.NoResponseException; SmackException.NotConnectedException; InterruptedException
See Also:: BookmarkedConference

addBookmarkedConference

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

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; InterruptedException

removeBookmarkedConference
```
public void removeBookmarkedConference(EntityBareJid jid)
                                throws SmackException.NoResponseException,
                                       XMPPException.XMPPErrorException,
                                       SmackException.NotConnectedException,
                                       InterruptedException
```
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

InterruptedException

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

getBookmarkedURLs

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

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; InterruptedException

addBookmarkedURL

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

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; InterruptedException

removeBookmarkedURL

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

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; InterruptedException

isSupported

public boolean isSupported()
                    throws SmackException.NoResponseException,
                           SmackException.NotConnectedException,
                           XMPPException.XMPPErrorException,
                           InterruptedException

Check if the service supports bookmarks using private data.

Returns:: true if the service supports private data, false otherwise.
Throws:: SmackException.NoResponseException; SmackException.NotConnectedException; InterruptedException; XMPPException.XMPPErrorException
Since:: 4.2
See Also:: PrivateDataManager.isSupported()

Class BookmarkManager