Smack

org.jivesoftware.smackx.packet
Class StreamInitiation.File

java.lang.Object
  extended by org.jivesoftware.smackx.packet.StreamInitiation.File
All Implemented Interfaces:
PacketExtension
Enclosing class:
StreamInitiation

public static class StreamInitiation.File
extends Object
implements PacketExtension

<desc> is used to provide a sender-generated description of the file so the receiver can better understand what is being sent. It MUST NOT be sent in the result.

When <range> is sent in the offer, it should have no attributes. This signifies that the sender can do ranged transfers. When a Stream Initiation result is sent with the element, it uses these attributes:

Both attributes are OPTIONAL on the <range> element. Sending no attributes is synonymous with not sending the <range> element. When no <range> element is sent in the Stream Initiation result, the Sender MUST send the complete file starting at offset 0. More generally, data is sent over the stream byte for byte starting at the offset position for the length specified.

Author:
Alexander Wenckus

Constructor Summary
StreamInitiation.File(String name, long size)
          Constructor providing the name of the file and its size.
 
Method Summary
 Date getDate()
          Returns the date that the file was last modified.
 String getDesc()
          Returns the description of the file.
 String getElementName()
          Returns the root element name.
 String getHash()
          Returns the MD5 sum of the file's contents
 String getName()
          Returns the file's name.
 String getNamespace()
          Returns the root element XML namespace.
 long getSize()
          Returns the file's size.
 boolean isRanged()
          Returns whether or not the initiator can support a range for the file tranfer.
 void setDate(Date date)
          Sets the date that the file was last modified.
 void setDesc(String desc)
          Sets the description of the file.
 void setHash(String hash)
          Sets the MD5 sum of the file's contents
 void setRanged(boolean isRanged)
          True if a range can be provided and false if it cannot.
 String toXML()
          Returns the XML reppresentation of the PacketExtension.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

StreamInitiation.File

public StreamInitiation.File(String name,
                             long size)
Constructor providing the name of the file and its size.

Parameters:
name - The name of the file.
size - The size of the file in bytes.
Method Detail

getName

public String getName()
Returns the file's name.

Returns:
Returns the file's name.

getSize

public long getSize()
Returns the file's size.

Returns:
Returns the file's size.

setHash

public void setHash(String hash)
Sets the MD5 sum of the file's contents

Parameters:
hash - The MD5 sum of the file's contents.

getHash

public String getHash()
Returns the MD5 sum of the file's contents

Returns:
Returns the MD5 sum of the file's contents

setDate

public void setDate(Date date)
Sets the date that the file was last modified.

Parameters:
date - The date that the file was last modified.

getDate

public Date getDate()
Returns the date that the file was last modified.

Returns:
Returns the date that the file was last modified.

setDesc

public void setDesc(String desc)
Sets the description of the file.

Parameters:
desc - The description of the file so that the file reciever can know what file it is.

getDesc

public String getDesc()
Returns the description of the file.

Returns:
Returns the description of the file.

setRanged

public void setRanged(boolean isRanged)
True if a range can be provided and false if it cannot.

Parameters:
isRanged - True if a range can be provided and false if it cannot.

isRanged

public boolean isRanged()
Returns whether or not the initiator can support a range for the file tranfer.

Returns:
Returns whether or not the initiator can support a range for the file tranfer.

getElementName

public String getElementName()
Description copied from interface: PacketExtension
Returns the root element name.

Specified by:
getElementName in interface PacketExtension
Returns:
the element name.

getNamespace

public String getNamespace()
Description copied from interface: PacketExtension
Returns the root element XML namespace.

Specified by:
getNamespace in interface PacketExtension
Returns:
the namespace.

toXML

public String toXML()
Description copied from interface: PacketExtension
Returns the XML reppresentation of the PacketExtension.

Specified by:
toXML in interface PacketExtension
Returns:
the packet extension as XML.

Smack

Copyright © 2003-2007 Jive Software.