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).

Author:

Gaston Dombiak

Constructor Summary

TranscriptSearchManager(Connection connection)

Method Summary

Form	getSearchForm(java.lang.String serviceJID) Returns the Form to use for searching transcripts.
ReportedData	submitSearch(java.lang.String 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(Connection connection)

Method Detail

getSearchForm

public Form getSearchForm(java.lang.String serviceJID)
                   throws XMPPException

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 - if an error occurs while sending the request to the server.

submitSearch

public ReportedData submitSearch(java.lang.String serviceJID,
                                 Form completedForm)
                          throws XMPPException

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 - if an error occurs while submiting the search to the server.