org.jivesoftware.smackx.workgroup.agent

Class TranscriptSearchManager

java.lang.Object

org.jivesoftware.smackx.workgroup.agent.TranscriptSearchManager

public class TranscriptSearchManager
extends Object

A TranscriptSearchManager helps to retrieve the form to use for searching transcripts getSearchForm(DomainBareJid) or to submit a search form and return the results of the search submitSearch(DomainBareJid, Form).

Constructor Summary

Constructors

Constructor and Description
TranscriptSearchManager(XMPPConnection connection)

Method Summary

Modifier and Type	Method and Description
Form	getSearchForm(DomainBareJid serviceJID) Returns the Form to use for searching transcripts.
ReportedData	submitSearch(DomainBareJid serviceJID, Form completedForm) Submits the completed form and returns the result of the transcript search.

Methods inherited from class java.lang.Object

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

Constructor Detail

TranscriptSearchManager

public TranscriptSearchManager(XMPPConnection connection)

Method Detail

getSearchForm

public Form getSearchForm(DomainBareJid serviceJID)
                   throws SmackException.NoResponseException,
                          XMPPException.XMPPErrorException,
                          SmackException.NotConnectedException,
                          InterruptedException

Returns the Form to use for searching transcripts. It is unlikely that the server will change the form (without a restart) so it is safe to keep the returned form for future submissions.

Parameters:

serviceJID - the address of the workgroup service.

Returns:

the Form to use for searching transcripts.

Throws:

XMPPException.XMPPErrorException

SmackException.NoResponseException

SmackException.NotConnectedException

InterruptedException

submitSearch

public ReportedData submitSearch(DomainBareJid serviceJID,
                                 Form completedForm)
                          throws SmackException.NoResponseException,
                                 XMPPException.XMPPErrorException,
                                 SmackException.NotConnectedException,
                                 InterruptedException

Submits the completed form and returns the result of the transcript search. The result will include all the data returned from the server so be careful with the amount of data that the search may return.

Parameters:

serviceJID - the address of the workgroup service.

completedForm - the filled out search form.

Returns:

the result of the transcript search.

Throws:

XMPPException.XMPPErrorException

SmackException.NoResponseException

SmackException.NotConnectedException

InterruptedException