ibbopen.java

JBother是纯Java开发的Jabber(即时消息开源软件)客户端。支持群组聊天

/**
 * $RCSfile$
 * $Revision: 2495 $
 * $Date: 2005-05-30 10:14:25 -0500 (Mon, 30 May 2005) $
 *
 * Copyright 2003-2004 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.packet;

import org.jivesoftware.smack.packet.IQ;
import org.jivesoftware.smack.util.StringUtils;

/**
 * Request for In Band Bytestreams - JEP 47
 * @author Adam Olsen
 */
public class IBBOpen extends IQ {
    private String sid;
    private int blockSize = 4096;
    
    
    /**
     *  Creates a new instance of IBBOpen and sets a random session id
     */
    public IBBOpen() {
        sid = StringUtils.randomString(20);
    }
    
    
    /**
     *  Sets the session id
     *
     *@param  sid  The new session id
     */
    public void setSid(String sid) {
        this.sid = sid;
    }
    
    
    /**
     *  Gets the session id
     *
     *@return    The session id
     */
    public String getSid() {
        return sid;
    }
    
    
    /**
     *  Sets the maximum block size of each ibb chunk
     *
     *@param  size  the maximum block size in bytes
     */
    public void setBlockSize(int size) {
        this.blockSize = size;
    }
    
    
    /**
     *  Gets the maximum block size of each ibb chunk
     *
     *@return    the maximum block size in bytes
     */
    public int getBlockSize() {
        return blockSize;
    }
    
    
    /**
     *  Helper method to create a confirmation to the IBB request
     *
     *@return    A confirmation to the request
     */
    public IBBOpen createConfirmation() {
        IBBOpen response = new IBBOpen();
        response.setType(IQ.Type.RESULT);
        response.setTo(getFrom());
        response.setPacketID(getPacketID());
        response.setFrom(getTo());
        return response;
    }
    
    
    /**
     *  Returns the xml representation of an ibb request
     */
    public String getChildElementXML() {
        if (getType() == IQ.Type.RESULT) {
            return "";
        }
        StringBuffer buff = new StringBuffer();
        
        buff.append("<open sid='")
        .append(sid)
        .append("' block-size='")
        .append(blockSize)
        .append("' ")
        .append(" xmlns='http://jabber.org/protocol/ibb' />");
        
        return buff.toString();
    }
    
}