/** * $Revision$ * $Date$ * * Copyright 2003-2007 Jive Software. * * All rights reserved. Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package org.jivesoftware.smackx.workgroup.packet; import org.jivesoftware.smack.packet.PacketExtension; import org.jivesoftware.smack.provider.PacketExtensionProvider; import org.xmlpull.v1.XmlPullParser; /** * Packet extension for {@link org.jivesoftware.smackx.workgroup.agent.InvitationRequest}. * * @author Gaston Dombiak */ public class RoomInvitation implements PacketExtension { /** * Element name of the packet extension. */ public static final String ELEMENT_NAME = "invite"; /** * Namespace of the packet extension. */ public static final String NAMESPACE = "http://jabber.org/protocol/workgroup"; /** * Type of entity being invited to a groupchat support session. */ private Type type; /** * JID of the entity being invited. The entity could be another agent, user , a queue or a workgroup. In * the case of a queue or a workgroup the server will select the best agent to invite. */ private String invitee; /** * Full JID of the user that sent the invitation. */ private String inviter; /** * ID of the session that originated the initial user request. */ private String sessionID; /** * JID of the room to join if offer is accepted. */ private String room; /** * Text provided by the inviter explaining the reason why the invitee is invited. */ private String reason; public RoomInvitation(Type type, String invitee, String sessionID, String reason) { this.type = type; this.invitee = invitee; this.sessionID = sessionID; this.reason = reason; } private RoomInvitation() { } public String getElementName() { return ELEMENT_NAME; } public String getNamespace() { return NAMESPACE; } public String getInviter() { return inviter; } public String getRoom() { return room; } public String getReason() { return reason; } public String getSessionID() { return sessionID; } public String toXML() { StringBuilder buf = new StringBuilder(); buf.append("<").append(ELEMENT_NAME).append(" xmlns=\"").append(NAMESPACE); buf.append("\" type=\"").append(type).append("\">"); buf.append(""); if (invitee != null) { buf.append("").append(invitee).append(""); } if (inviter != null) { buf.append("").append(inviter).append(""); } if (reason != null) { buf.append("").append(reason).append(""); } // Add packet extensions, if any are defined. buf.append(" "); return buf.toString(); } /** * Type of entity being invited to a groupchat support session. */ public static enum Type { /** * A user is being invited to a groupchat support session. The user could be another agent * or just a regular XMPP user. */ user, /** * Some agent of the specified queue will be invited to the groupchat support session. */ queue, /** * Some agent of the specified workgroup will be invited to the groupchat support session. */ workgroup } public static class Provider implements PacketExtensionProvider { public PacketExtension parseExtension(XmlPullParser parser) throws Exception { final RoomInvitation invitation = new RoomInvitation(); invitation.type = Type.valueOf(parser.getAttributeValue("", "type")); boolean done = false; while (!done) { parser.next(); String elementName = parser.getName(); if (parser.getEventType() == XmlPullParser.START_TAG) { if ("session".equals(elementName)) { invitation.sessionID = parser.getAttributeValue("", "id"); } else if ("invitee".equals(elementName)) { invitation.invitee = parser.nextText(); } else if ("inviter".equals(elementName)) { invitation.inviter = parser.nextText(); } else if ("reason".equals(elementName)) { invitation.reason = parser.nextText(); } else if ("room".equals(elementName)) { invitation.room = parser.nextText(); } } else if (parser.getEventType() == XmlPullParser.END_TAG && ELEMENT_NAME.equals(elementName)) { done = true; } } return invitation; } } }