1d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen/** 2d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * $RCSfile$ 3d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * $Revision$ 4d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * $Date$ 5d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * 6d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * Copyright 2003-2007 Jive Software. 7d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * 8d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * All rights reserved. Licensed under the Apache License, Version 2.0 (the "License"); 9d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * you may not use this file except in compliance with the License. 10d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * You may obtain a copy of the License at 11d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * 12d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * http://www.apache.org/licenses/LICENSE-2.0 13d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * 14d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * Unless required by applicable law or agreed to in writing, software 15d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * distributed under the License is distributed on an "AS IS" BASIS, 16d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 17d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * See the License for the specific language governing permissions and 18d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * limitations under the License. 19d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen */ 20d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen 21d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chenpackage org.jivesoftware.smack.packet; 22d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen 23d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen/** 24d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * IQ packet used by Smack to bind a resource and to obtain the jid assigned by the server. 25d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * There are two ways to bind a resource. One is simply sending an empty Bind packet where the 26d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * server will assign a new resource for this connection. The other option is to set a desired 27d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * resource but the server may return a modified version of the sent resource.<p> 28d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * 29d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * For more information refer to the following 30d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * <a href=http://www.xmpp.org/specs/rfc3920.html#bind>link</a>. 31d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * 32d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * @author Gaston Dombiak 33d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen */ 34d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chenpublic class Bind extends IQ { 35d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen 36d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen private String resource = null; 37d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen private String jid = null; 38d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen 39d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen public Bind() { 40d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen setType(IQ.Type.SET); 41d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen } 42d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen 43d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen public String getResource() { 44d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen return resource; 45d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen } 46d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen 47d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen public void setResource(String resource) { 48d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen this.resource = resource; 49d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen } 50d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen 51d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen public String getJid() { 52d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen return jid; 53d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen } 54d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen 55d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen public void setJid(String jid) { 56d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen this.jid = jid; 57d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen } 58d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen 59d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen public String getChildElementXML() { 60d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen StringBuilder buf = new StringBuilder(); 61d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen buf.append("<bind xmlns=\"urn:ietf:params:xml:ns:xmpp-bind\">"); 62d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen if (resource != null) { 63d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen buf.append("<resource>").append(resource).append("</resource>"); 64d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen } 65d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen if (jid != null) { 66d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen buf.append("<jid>").append(jid).append("</jid>"); 67d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen } 68d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen buf.append("</bind>"); 69d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen return buf.toString(); 70d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen } 71d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen} 72