Class PutTask

    • Field Summary

      Fields 
      Modifier and Type Field Description
      private byte[] dataBytes  
      private java.io.File dataFile  
    • Constructor Summary

      Constructors 
      Constructor Description
      PutTask​(java.net.URI location)
      Creates a new task for the specified remote resource.
    • Field Detail

      • dataFile

        private java.io.File dataFile
      • dataBytes

        private byte[] dataBytes
    • Constructor Detail

      • PutTask

        public PutTask​(java.net.URI location)
        Creates a new task for the specified remote resource.
        Parameters:
        location - The relative location of the resource in the remote repository, must not be null.
    • Method Detail

      • newInputStream

        public java.io.InputStream newInputStream()
                                           throws java.io.IOException
        Opens an input stream for the data to be uploaded. The length of the stream can be queried via getDataLength(). It's the responsibility of the caller to close the provided stream.
        Returns:
        The input stream for the data, never null. The stream is unbuffered.
        Throws:
        java.io.IOException - If the stream could not be opened.
      • getDataLength

        public long getDataLength()
        Gets the total number of bytes to be uploaded.
        Returns:
        The total number of bytes to be uploaded.
      • getDataFile

        public java.io.File getDataFile()
        Gets the file (if any) with the data to be uploaded.
        Returns:
        The data file or null if the data resides in memory.
      • setDataFile

        public PutTask setDataFile​(java.io.File dataFile)
        Sets the file with the data to be uploaded. To upload some data residing already in memory, use setDataString(String) or setDataBytes(byte[]).
        Parameters:
        dataFile - The data file, may be null if the resource data is provided directly from memory.
        Returns:
        This task for chaining, never null.
      • setDataBytes

        public PutTask setDataBytes​(byte[] bytes)
        Sets the binary data to be uploaded.
        Parameters:
        bytes - The binary data, may be null.
        Returns:
        This task for chaining, never null.
      • setDataString

        public PutTask setDataString​(java.lang.String str)
        Sets the textual data to be uploaded. The text is encoded using UTF-8 before transmission.
        Parameters:
        str - The textual data, may be null.
        Returns:
        This task for chaining, never null.
      • setListener

        public PutTask setListener​(TransportListener listener)
        Sets the listener that is to be notified during the transfer.
        Overrides:
        setListener in class TransportTask
        Parameters:
        listener - The listener to notify of progress, may be null.
        Returns:
        This task for chaining, never null.
      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object