tigase.server

## Class Iq

- java.lang.Object
- - tigase.server.Packet
  - - tigase.server.Iq

-     public class Iq
      extends Packet

  Created: Dec 31, 2009 8:43:21 PM
  Version:
    $Rev$
  Author:
    Artur Hefczyc

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `static String` | `ELEM_NAME` Field description
    `static String[]` | `IQ_BIND_PATH` Field description
    `static String[]` | `IQ_BIND_RESOURCE_PATH` Field description
    `static String[]` | `IQ_CHAT_PATH` Field description
    `static String[]` | `IQ_COMMAND_PATH` Field description
    `static String[]` | `IQ_ERROR_PATH` Field description
    `static String[]` | `IQ_PUBSUB_PATH` Field description
    `static String[]` | `IQ_QUERY_PATH` Field description
    `static String` | `QUERY_NAME` Field description

    - ### Fields inherited from class tigase.server.Packet

      `CLIENT_XMLNS, elem, FROM_ATT, FULL_DEBUG, ID_ATT, PERM_ATT, PRIORITY_ATT, TO_ATT, TYPE_ATT, XMLNS_ATT`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `Iq(tigase.xml.Element elem)` Constructs ...
    `Iq(tigase.xml.Element elem, tigase.xmpp.JID stanzaFrom, tigase.xmpp.JID stanzaTo)` Constructs ...

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `Packet` | `commandResult(Command.DataType cmd_type)` Method description
    `static Packet` | `commandResultForm(Iq packet)` Method description
    `static Packet` | `commandResultResult(Iq packet)` Method description
    `static Iq` | `createRosterPacket(String iq_type, String iq_id, tigase.xmpp.JID from, tigase.xmpp.JID to, tigase.xmpp.JID item_jid, String item_name, String[] item_groups, String subscription, String item_type)` Method description creates a new `Packet` instance or `Iq` instance more specificly with a roster entry content.
    `Command` | `getCommand()` Method description
    `protected String[]` | `getElNameErrorPath()` Method description
    `String` | `getIQChildName()` Method description
    `String` | `getIQXMLNS()` Method description
    `String` | `getStrCommand()` Method description
    `boolean` | `isCommand()` Method description
    `boolean` | `isServiceDisco()` Method description

    - ### Methods inherited from class tigase.server.Packet

      `copyElementOnly, debug, elemToString, elemToStringSecure, errorResult, getAttribute, getAttribute, getAttribute, getAttributeStaticStr, getAttributeStaticStr, getElemCData, getElemCData, getElemCData, getElemCDataStaticStr, getElemChildren, getElemChildren, getElemChildrenStaticStr, getElement, getElemFrom, getElemName, getElemTo, getErrorCondition, getFrom, getPacketFrom, getPacketTo, getPermissions, getPriority, getProcessorsIds, getStanzaFrom, getStanzaId, getStanzaTo, getTo, getType, getXMLNS, initVars, initVars, isElement, isRouted, isXMLNS, isXMLNS, isXMLNSStaticStr, okResult, okResult, packetInstance, packetInstance, packetInstance, packRouted, processedBy, setPacketFrom, setPacketTo, setPermissions, setPriority, setXMLNS, swapElemFromTo, swapElemFromTo, swapFromTo, swapFromTo, swapStanzaFromTo, swapStanzaFromTo, toString, toString, toStringFull, toStringSecure, unpackRouted, wasProcessed, wasProcessedBy`

    - ### Methods inherited from class java.lang.Object

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

- - ### Field Detail

    - #### ELEM_NAME

          public static final String ELEM_NAME

      Field description
      See Also:
        Constant Field Values

    - #### QUERY_NAME

          public static final String QUERY_NAME

      Field description
      See Also:
        Constant Field Values

    - #### IQ_QUERY_PATH

          public static final String[] IQ_QUERY_PATH

      Field description

    - #### IQ_PUBSUB_PATH

          public static final String[] IQ_PUBSUB_PATH

      Field description

    - #### IQ_ERROR_PATH

          public static final String[] IQ_ERROR_PATH

      Field description

    - #### IQ_COMMAND_PATH

          public static final String[] IQ_COMMAND_PATH

      Field description

    - #### IQ_CHAT_PATH

          public static final String[] IQ_CHAT_PATH

      Field description

    - #### IQ_BIND_RESOURCE_PATH

          public static final String[] IQ_BIND_RESOURCE_PATH

      Field description

    - #### IQ_BIND_PATH

          public static final String[] IQ_BIND_PATH

      Field description

  - ### Constructor Detail

    - #### Iq

          public Iq(tigase.xml.Element elem)
             throws tigase.util.TigaseStringprepException

      Constructs ...
      Parameters:
        `elem` -
      Throws:
        `tigase.util.TigaseStringprepException`

    - #### Iq

          public Iq(tigase.xml.Element elem,
            tigase.xmpp.JID stanzaFrom,
            tigase.xmpp.JID stanzaTo)

      Constructs ...
      Parameters:
        `elem` -
        `stanzaFrom` -
        `stanzaTo` -

  - ### Method Detail

    - #### commandResultForm

          public static Packet commandResultForm(Iq packet)
                                          throws tigase.util.TigaseStringprepException

      Method description
      Parameters:
        `packet` -
      Throws:
        `tigase.util.TigaseStringprepException`

    - #### commandResultResult

          public static Packet commandResultResult(Iq packet)
                                            throws tigase.util.TigaseStringprepException

      Method description
      Parameters:
        `packet` -
      Throws:
        `tigase.util.TigaseStringprepException`

    - #### createRosterPacket

          public static Iq createRosterPacket(String iq_type,
                              String iq_id,
                              tigase.xmpp.JID from,
                              tigase.xmpp.JID to,
                              tigase.xmpp.JID item_jid,
                              String item_name,
                              String[] item_groups,
                              String subscription,
                              String item_type)

      Method description creates a new `Packet` instance or `Iq` instance more specificly with a roster entry content. TODO: Remove dependency on RosterAbstract class, possibly move the method again to more proper location but it needs to be accessible from all parts of the application.
      Parameters:
        `iq_type` - is a `String` value with the stanza type: 'set', 'get', 'result'.
        `iq_id` - is a `String` value with the stanza unique id.
        `from` - is a `JID` instance with the packet source address.
        `to` - is a `JID` instance with the packet destination address.
        `item_jid` - is a `JID` instance with the roster item JID, note in most cases the jid should not have a resource part, but this method does not cut it off. This is because there are cases when we want to have a resource part in the roster item.
        `item_name` - is a `String` vakue with the roster item name.
        `item_groups` - is a `String[]` array with all groups the item belongs to.
        `subscription` - is a `String` instance with the item subscription state.
        `item_type` - is a `String` of the user item type. This is `null` in most cases as this is not part of the XMPP RFC. Some deployments needs some extra information about the roster item type though.
      Returns:
        a new `Packet` instance or `Iq` instance more specificly with a roster entry content.

    - #### commandResult

          public Packet commandResult(Command.DataType cmd_type)

      Method description
      Parameters:
        `cmd_type` -

    - #### getCommand

          public Command getCommand()

      Method description
      Overrides:
        `getCommand` in class `Packet`
      Returns:
        the method always returns a NULL.

    - #### getIQChildName

          public String getIQChildName()

      Method description

    - #### getIQXMLNS

          public String getIQXMLNS()

      Method description

    - #### getElNameErrorPath

          protected String[] getElNameErrorPath()

      Method description
      Overrides:
        `getElNameErrorPath` in class `Packet`
      Returns:
        XML path to error element.

    - #### getStrCommand

          public String getStrCommand()

      Method description

    - #### isCommand

          public boolean isCommand()

      Method description
      Overrides:
        `isCommand` in class `Packet`
      Returns:
        a `boolean` value `true` if the stanza is an ad-hoc command and `false` otherwise.

    - #### isServiceDisco

          public boolean isServiceDisco()

      Method description
      Overrides:
        `isServiceDisco` in class `Packet`
      Returns:
        a `boolean` value `true` if the stanza is a a service discovery query and `false` otherwise.

Copyright © 2014 "Tigase, Inc.". All rights reserved.