001/** 002 * 003 * Copyright 2003-2007 Jive Software. 004 * 005 * Licensed under the Apache License, Version 2.0 (the "License"); 006 * you may not use this file except in compliance with the License. 007 * You may obtain a copy of the License at 008 * 009 * http://www.apache.org/licenses/LICENSE-2.0 010 * 011 * Unless required by applicable law or agreed to in writing, software 012 * distributed under the License is distributed on an "AS IS" BASIS, 013 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 014 * See the License for the specific language governing permissions and 015 * limitations under the License. 016 */ 017 018package org.jivesoftware.smackx.workgroup.packet; 019 020import java.io.IOException; 021 022import org.jivesoftware.smack.packet.ExtensionElement; 023import org.jivesoftware.smack.packet.IQ; 024import org.jivesoftware.smack.packet.IQ.IQChildElementXmlStringBuilder; 025import org.jivesoftware.smack.packet.XmlEnvironment; 026import org.jivesoftware.smack.provider.ExtensionElementProvider; 027import org.jivesoftware.smack.util.XmlStringBuilder; 028import org.jivesoftware.smack.xml.XmlPullParser; 029import org.jivesoftware.smack.xml.XmlPullParserException; 030 031/** 032 * Stanza extension for {@link org.jivesoftware.smackx.workgroup.agent.TransferRequest}. 033 * 034 * @author Gaston Dombiak 035 */ 036public class RoomTransfer implements ExtensionElement { 037 038 /** 039 * Element name of the stanza extension. 040 */ 041 public static final String ELEMENT_NAME = "transfer"; 042 043 /** 044 * Namespace of the stanza extension. 045 */ 046 public static final String NAMESPACE = "http://jabber.org/protocol/workgroup"; 047 048 /** 049 * Type of entity being invited to a groupchat support session. 050 */ 051 private RoomTransfer.Type type; 052 /** 053 * JID of the entity being invited. The entity could be another agent, user , a queue or a workgroup. In 054 * the case of a queue or a workgroup the server will select the best agent to invite. 055 */ 056 private String invitee; 057 /** 058 * Full JID of the user that sent the invitation. 059 */ 060 private String inviter; 061 /** 062 * ID of the session that originated the initial user request. 063 */ 064 private String sessionID; 065 /** 066 * JID of the room to join if offer is accepted. 067 */ 068 private String room; 069 /** 070 * Text provided by the inviter explaining the reason why the invitee is invited. 071 */ 072 private String reason; 073 074 public RoomTransfer(RoomTransfer.Type type, String invitee, String sessionID, String reason) { 075 this.type = type; 076 this.invitee = invitee; 077 this.sessionID = sessionID; 078 this.reason = reason; 079 } 080 081 private RoomTransfer() { 082 } 083 084 @Override 085 public String getElementName() { 086 return ELEMENT_NAME; 087 } 088 089 @Override 090 public String getNamespace() { 091 return NAMESPACE; 092 } 093 094 public String getInviter() { 095 return inviter; 096 } 097 098 public String getRoom() { 099 return room; 100 } 101 102 public String getReason() { 103 return reason; 104 } 105 106 public String getSessionID() { 107 return sessionID; 108 } 109 110 @Override 111 public XmlStringBuilder toXML(org.jivesoftware.smack.packet.XmlEnvironment enclosingNamespace) { 112 XmlStringBuilder xml = getIQChildElementBuilder(new IQChildElementXmlStringBuilder(this)); 113 xml.closeElement(this); 114 return xml; 115 } 116 117 public IQ.IQChildElementXmlStringBuilder getIQChildElementBuilder(IQChildElementXmlStringBuilder buf) { 118 buf.append(" type=\"").append(type.name()).append("\">"); 119 buf.append("<session xmlns=\"http://jivesoftware.com/protocol/workgroup\" id=\"").append(sessionID).append("\"></session>"); 120 if (invitee != null) { 121 buf.append("<invitee>").append(invitee).append("</invitee>"); 122 } 123 if (inviter != null) { 124 buf.append("<inviter>").append(inviter).append("</inviter>"); 125 } 126 if (reason != null) { 127 buf.append("<reason>").append(reason).append("</reason>"); 128 } 129 130 return buf; 131 } 132 133 /** 134 * Type of entity being invited to a groupchat support session. 135 */ 136 public enum Type { 137 /** 138 * A user is being invited to a groupchat support session. The user could be another agent 139 * or just a regular XMPP user. 140 */ 141 user, 142 /** 143 * Some agent of the specified queue will be invited to the groupchat support session. 144 */ 145 queue, 146 /** 147 * Some agent of the specified workgroup will be invited to the groupchat support session. 148 */ 149 workgroup 150 } 151 152 public static class RoomTransferIQ extends IQ { 153 private final RoomTransfer roomTransfer; 154 public RoomTransferIQ(RoomTransfer roomTransfer) { 155 super(ELEMENT_NAME, NAMESPACE); 156 this.roomTransfer = roomTransfer; 157 } 158 @Override 159 protected IQChildElementXmlStringBuilder getIQChildElementBuilder(IQChildElementXmlStringBuilder xml) { 160 return roomTransfer.getIQChildElementBuilder(xml); 161 } 162 } 163 164 public static class Provider extends ExtensionElementProvider<RoomTransfer> { 165 166 @Override 167 public RoomTransfer parse(XmlPullParser parser, 168 int initialDepth, XmlEnvironment xmlEnvironment) throws XmlPullParserException, 169 IOException { 170 final RoomTransfer invitation = new RoomTransfer(); 171 invitation.type = RoomTransfer.Type.valueOf(parser.getAttributeValue("", "type")); 172 173 boolean done = false; 174 while (!done) { 175 parser.next(); 176 String elementName = parser.getName(); 177 if (parser.getEventType() == XmlPullParser.Event.START_ELEMENT) { 178 if ("session".equals(elementName)) { 179 invitation.sessionID = parser.getAttributeValue("", "id"); 180 } 181 else if ("invitee".equals(elementName)) { 182 invitation.invitee = parser.nextText(); 183 } 184 else if ("inviter".equals(elementName)) { 185 invitation.inviter = parser.nextText(); 186 } 187 else if ("reason".equals(elementName)) { 188 invitation.reason = parser.nextText(); 189 } 190 else if ("room".equals(elementName)) { 191 invitation.room = parser.nextText(); 192 } 193 } 194 else if (parser.getEventType() == XmlPullParser.Event.END_ELEMENT && ELEMENT_NAME.equals(elementName)) { 195 done = true; 196 } 197 } 198 return invitation; 199 } 200 } 201}