Class AdHocCommandHandler
- All Implemented Interfaces:
ChannelHandler<org.xmpp.packet.IQ>
,Module
,DiscoInfoProvider
,DiscoItemsProvider
,ServerFeaturesProvider
Ad-hoc commands that require user interaction will have one or more stages. For each stage the
user will complete a data form and send it back to the server. The data entered by the user is
kept in a SessionData. Instances of AdHocCommand
are stateless. In order to prevent
"bad" users from consuming all system memory there exists a limit of simultaneous commands that
a user might perform. Configure the system property "xmpp.command.limit"
to control
this limit. User sessions will also timeout and their data destroyed if they have not been
executed within a time limit since the session was created. The default timeout value is 10
minutes. The timeout value can be modified by setting the system property
"xmpp.command.timeout"
.
New commands can be added dynamically by sending the message addCommand(AdHocCommand)
.
The command will immediately appear in the disco#items list and might be executed by those
users with enough execution permissions.
- Author:
- Gaston Dombiak
-
Field Summary
Fields inherited from class org.jivesoftware.openfire.handler.IQHandler
deliverer, sessionManager
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
addCommand
(AdHocCommand command) Adds a new command to the list of supported ad-hoc commands by this server.Set<org.xmpp.forms.DataForm>
getExtendedInfos
(String name, String node, org.xmpp.packet.JID senderJID) Returns a collection of XDataForm with the extended information about the entity or an empty collection if none.Returns an Iterator (of String) with the supported features by the server.getFeatures
(String name, String node, org.xmpp.packet.JID senderJID) Returns an Iterator (of String) with the supported features.Iterator<org.dom4j.Element>
getIdentities
(String name, String node, org.xmpp.packet.JID senderJID) Returns an Iterator (of Element) with the target entity's identities.getInfo()
Returns the handler information to help generically handle IQ packets.Returns an Iterator (of DiscoItem) with the target entity's items or null if none.org.xmpp.packet.IQ
handleIQ
(org.xmpp.packet.IQ packet) Handles the received IQ packet.boolean
Returns true if we can provide information related to the requested name and node.void
initialize
(XMPPServer server) Initializes the basic module.void
removeCommand
(AdHocCommand command) Removes the command from the list of ad-hoc commands supported by this server.void
start()
Starts the basic module.void
stop()
Stops the basic module.Methods inherited from class org.jivesoftware.openfire.handler.IQHandler
performNoSuchUserCheck, process, processNoSuchUserCheck
Methods inherited from class org.jivesoftware.openfire.container.BasicModule
destroy, getName
-
Constructor Details
-
AdHocCommandHandler
public AdHocCommandHandler()
-
-
Method Details
-
handleIQ
Description copied from class:IQHandler
Handles the received IQ packet.- Specified by:
handleIQ
in classIQHandler
- Parameters:
packet
- the IQ packet to handle.- Returns:
- the response to send back.
- Throws:
UnauthorizedException
- if the user that sent the packet is not authorized to request the given operation.
-
getInfo
Description copied from class:IQHandler
Returns the handler information to help generically handle IQ packets. IQHandlers that aren't local server iq handlers (e.g. chatbots, transports, etc) returnnull
. -
getFeatures
Description copied from interface:ServerFeaturesProvider
Returns an Iterator (of String) with the supported features by the server. The features to include are the features offered and supported protocols by the SERVER. The idea is that different modules may provide their features that will ultimately be part of the features offered by the server.- Specified by:
getFeatures
in interfaceServerFeaturesProvider
- Returns:
- an Iterator (of String) with the supported features by the server.
-
getIdentities
public Iterator<org.dom4j.Element> getIdentities(String name, String node, org.xmpp.packet.JID senderJID) Description copied from interface:DiscoInfoProvider
Returns an Iterator (of Element) with the target entity's identities. Each Element must include the category, type and name attributes of the entity.- Specified by:
getIdentities
in interfaceDiscoInfoProvider
- Parameters:
name
- the recipient JID's name.node
- the requested disco node.senderJID
- the XMPPAddress of user that sent the disco info request.- Returns:
- an Iterator (of Element) with the target entity's identities.
-
getFeatures
Description copied from interface:DiscoInfoProvider
Returns an Iterator (of String) with the supported features. The features to include are the features offered and supported protocols by the target entity identified by the requested name and node.- Specified by:
getFeatures
in interfaceDiscoInfoProvider
- Parameters:
name
- the recipient JID's name.node
- the requested disco node.senderJID
- the XMPPAddress of user that sent the disco info request.- Returns:
- an Iterator (of String) with the supported features.
-
getExtendedInfos
public Set<org.xmpp.forms.DataForm> getExtendedInfos(String name, String node, org.xmpp.packet.JID senderJID) Description copied from interface:DiscoInfoProvider
Returns a collection of XDataForm with the extended information about the entity or an empty collection if none. Each bit of information about the entity must be included as a value of a field of the form.- Specified by:
getExtendedInfos
in interfaceDiscoInfoProvider
- Parameters:
name
- the recipient JID's name.node
- the requested disco node.senderJID
- the XMPPAddress of user that sent the disco info request.- Returns:
- A collection of XDataForms with the extended information about the entity or an empty collection if none.
-
hasInfo
Description copied from interface:DiscoInfoProvider
Returns true if we can provide information related to the requested name and node. For example, if the requested name refers to a non-existent MUC room then the answer will be false. In case that the sender of the disco request is not authorized to discover this information an UnauthorizedException will be thrown.- Specified by:
hasInfo
in interfaceDiscoInfoProvider
- Parameters:
name
- the recipient JID's name.node
- the requested disco node.senderJID
- the XMPPAddress of user that sent the disco info request.- Returns:
- true if we can provide information related to the requested name and node.
-
getItems
Description copied from interface:DiscoItemsProvider
Returns an Iterator (of DiscoItem) with the target entity's items or null if none. Each DiscoItem must include a JID attribute and may include the name and node attributes of the entity. In case that the sender of the disco request is not authorized to discover items an UnauthorizedException will be thrown.- Specified by:
getItems
in interfaceDiscoItemsProvider
- Parameters:
name
- the recipient JID's name.node
- the requested disco node.senderJID
- the XMPPAddress of user that sent the disco items request.- Returns:
- an Iterator (of DiscoItem) with the target entity's items or null if none.
-
initialize
Description copied from class:BasicModule
Initializes the basic module.
Inheriting classes that choose to override this method MUST call this initialize() method before accessing BasicModule resources.
- Specified by:
initialize
in interfaceModule
- Overrides:
initialize
in classIQHandler
- Parameters:
server
- the server hosting this module.
-
start
Description copied from class:BasicModule
Starts the basic module.
Inheriting classes that choose to override this method MUST call this start() method before accessing BasicModule resources.
- Specified by:
start
in interfaceModule
- Overrides:
start
in classBasicModule
- Throws:
IllegalStateException
- If start is called before initialize successfully returns
-
stop
public void stop()Description copied from class:BasicModule
Stops the basic module.
Inheriting classes that choose to override this method MUST call this stop() method before accessing BasicModule resources.
- Specified by:
stop
in interfaceModule
- Overrides:
stop
in classBasicModule
-
addCommand
Adds a new command to the list of supported ad-hoc commands by this server. The new command will appear in the discoverable items list and will be executed for those users with enough permission.- Parameters:
command
- the new ad-hoc command to add.
-
removeCommand
Removes the command from the list of ad-hoc commands supported by this server. The command will no longer appear in the discoverable items list.- Parameters:
command
- the ad-hoc command to remove.
-