Smack

org.jivesoftware.smackx.bookmark
Class Bookmarks

java.lang.Object
  extended by org.jivesoftware.smackx.bookmark.Bookmarks
All Implemented Interfaces:
PrivateData

public class Bookmarks
extends Object
implements PrivateData

Bookmarks is used for storing and retrieving URLS and Conference rooms. Bookmark Storage (JEP-0048) defined a protocol for the storage of bookmarks to conference rooms and other entities in a Jabber user's account. See the following code sample for saving Bookmarks:

 Connection con = new XMPPConnection("jabber.org");
 con.login("john", "doe");
 Bookmarks bookmarks = new Bookmarks();
 

// Bookmark a URL BookmarkedURL url = new BookmarkedURL(); url.setName("Google"); url.setURL("http://www.jivesoftware.com"); bookmarks.addURL(url); // Bookmark a Conference room. BookmarkedConference conference = new BookmarkedConference(); conference.setName("My Favorite Room"); conference.setAutoJoin("true"); conference.setJID("dev@conference.jivesoftware.com"); bookmarks.addConference(conference); // Save Bookmarks using PrivateDataManager. PrivateDataManager manager = new PrivateDataManager(con); manager.setPrivateData(bookmarks);

LastActivity activity = LastActivity.getLastActivity(con, "xray@jabber.org");

Author:
Derek DeMoro

Nested Class Summary
static class Bookmarks.Provider
          The IQ Provider for BookmarkStorage.
 
Constructor Summary
Bookmarks()
          Required Empty Constructor to use Bookmarks.
 
Method Summary
 void addBookmarkedConference(BookmarkedConference bookmarkedConference)
          Add a BookmarkedConference to bookmarks.
 void addBookmarkedURL(BookmarkedURL bookmarkedURL)
          Adds a BookmarkedURL.
 void clearBookmarkedConferences()
          Removes all BookmarkedConferences from Bookmarks.
 void clearBookmarkedURLS()
          Removes all BookmarkedURLs from user's bookmarks.
 List<BookmarkedConference> getBookmarkedConferences()
          Returns a Collection of all Bookmarked Conference for this user.
 List<BookmarkedURL> getBookmarkedURLS()
          Returns a Collection of all Bookmarked URLs for this user.
 String getElementName()
          Returns the root element name.
 String getNamespace()
          Returns the root element XML namespace.
 void removeBookmarkedConference(BookmarkedConference bookmarkedConference)
          Removes a BookmarkedConference.
 void removeBookmarkedURL(BookmarkedURL bookmarkedURL)
          Removes a bookmarked bookmarkedURL.
 String toXML()
          Returns the XML reppresentation of the PrivateData.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Bookmarks

public Bookmarks()
Required Empty Constructor to use Bookmarks.

Method Detail

addBookmarkedURL

public void addBookmarkedURL(BookmarkedURL bookmarkedURL)
Adds a BookmarkedURL.

Parameters:
bookmarkedURL - the bookmarked bookmarkedURL.

removeBookmarkedURL

public void removeBookmarkedURL(BookmarkedURL bookmarkedURL)
Removes a bookmarked bookmarkedURL.

Parameters:
bookmarkedURL - the bookmarked bookmarkedURL to remove.

clearBookmarkedURLS

public void clearBookmarkedURLS()
Removes all BookmarkedURLs from user's bookmarks.


addBookmarkedConference

public void addBookmarkedConference(BookmarkedConference bookmarkedConference)
Add a BookmarkedConference to bookmarks.

Parameters:
bookmarkedConference - the conference to remove.

removeBookmarkedConference

public void removeBookmarkedConference(BookmarkedConference bookmarkedConference)
Removes a BookmarkedConference.

Parameters:
bookmarkedConference - the BookmarkedConference to remove.

clearBookmarkedConferences

public void clearBookmarkedConferences()
Removes all BookmarkedConferences from Bookmarks.


getBookmarkedURLS

public List<BookmarkedURL> getBookmarkedURLS()
Returns a Collection of all Bookmarked URLs for this user.

Returns:
a collection of all Bookmarked URLs.

getBookmarkedConferences

public List<BookmarkedConference> getBookmarkedConferences()
Returns a Collection of all Bookmarked Conference for this user.

Returns:
a collection of all Bookmarked Conferences.

getElementName

public String getElementName()
Returns the root element name.

Specified by:
getElementName in interface PrivateData
Returns:
the element name.

getNamespace

public String getNamespace()
Returns the root element XML namespace.

Specified by:
getNamespace in interface PrivateData
Returns:
the namespace.

toXML

public String toXML()
Returns the XML reppresentation of the PrivateData.

Specified by:
toXML in interface PrivateData
Returns:
the private data as XML.

Smack

Copyright © 2003-2007 Jive Software.