org.jivesoftware.smackx.workgroup.agent

Class TranscriptSearchManager

java.lang.Object

org.jivesoftware.smackx.workgroup.agent.TranscriptSearchManager

public class TranscriptSearchManager
extends java.lang.Object

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

Constructor Summary

Constructors

Constructor and Description
TranscriptSearchManager(org.jivesoftware.smack.XMPPConnection connection)

Method Summary

Modifier and Type	Method and Description
org.jivesoftware.smackx.xdata.Form	getSearchForm(java.lang.String serviceJID) Returns the Form to use for searching transcripts.
org.jivesoftware.smackx.search.ReportedData	submitSearch(java.lang.String serviceJID, org.jivesoftware.smackx.xdata.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(org.jivesoftware.smack.XMPPConnection connection)

Method Detail

getSearchForm

public org.jivesoftware.smackx.xdata.Form getSearchForm(java.lang.String serviceJID)
                                                 throws org.jivesoftware.smack.SmackException.NoResponseException,
                                                        org.jivesoftware.smack.XMPPException.XMPPErrorException,
                                                        org.jivesoftware.smack.SmackException.NotConnectedException

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:

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.SmackException.NotConnectedException

submitSearch

public org.jivesoftware.smackx.search.ReportedData submitSearch(java.lang.String serviceJID,
                                                                org.jivesoftware.smackx.xdata.Form completedForm)
                                                         throws org.jivesoftware.smack.SmackException.NoResponseException,
                                                                org.jivesoftware.smack.XMPPException.XMPPErrorException,
                                                                org.jivesoftware.smack.SmackException.NotConnectedException

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:

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.SmackException.NotConnectedException