Method Detail

• attemptFailed

  void attemptFailed(String url,
                     long bytesTransferred,
                     long bytesRemaining,
                     int currentAttempt,
                     int numRetries,
                     Exception cause)

  Attempt failed notification.

  Parameters:

  url - the URL

  bytesTransferred - total transferred

  bytesRemaining - remaining

  currentAttempt - attempt index

  numRetries - retry limit

  cause - failure cause

  See Also:

  bytesTransferred(long, int, long, long, java.lang.String)

• attempting

  void attempting(String url)

  Called when a new attempt to fetch the URL is starting.

  Parameters:

  url - the URL being attempted

• bytesTransferred

  void bytesTransferred(long alreadyTransferred,
                        int currentWrite,
                        long bytesTransferred,
                        long bytesRemaining,
                        String url)

  Total length should be == alreadyTransferred + currentWrite + bytesRemaining for all calls.

  Parameters:

  alreadyTransferred - total of all attempts, not including currentWrite If nonzero on the first call, a partial file of that length was found, _and_ the server supports resume. If zero on a subsequent call after some bytes are transferred (and presumably after an attemptFailed), the server does _not_ support resume and we had to start over. To track _actual_ transfer if the output file could already exist, the listener should keep its own counter, or subtract the initial alreadyTransferred value. And watch out for alreadyTransferred resetting if a resume failed...

  currentWrite - since last call to the listener

  bytesTransferred - includes headers, retries, redirects, discarded partial downloads, ...

  bytesRemaining - on this attempt only, currentWrite already subtracted - or -1 if chunked encoding or server does not return a length

  url - the URL being fetched

• headerReceived

  void headerReceived(String url,
                      int currentAttempt,
                      String key,
                      String val)

  Note: Headers are not processed, and this is not called, for most error response codes, unless setWriteErrorToOutput() is called before fetch(). To be changed?

  Parameters:

  url - the URL

  currentAttempt - attempt index

  key - header key

  val - header value

• transferComplete

  void transferComplete(long alreadyTransferred,
                        long bytesTransferred,
                        long bytesRemaining,
                        String url,
                        String outputFile,
                        boolean notModified)

  Transfer complete notification.

  Parameters:

  alreadyTransferred - total bytes transferred

  bytesTransferred - total incl headers

  bytesRemaining - remaining bytes

  url - the URL

  outputFile - null if unknown (output stream constructor)

  notModified - whether 304

  See Also:

  bytesTransferred(long, int, long, long, java.lang.String)

• transferFailed

  void transferFailed(String url,
                      long bytesTransferred,
                      long bytesRemaining,
                      int currentAttempt)

  Transfer failed notification.

  Parameters:

  url - the URL

  bytesTransferred - total transferred

  bytesRemaining - remaining

  currentAttempt - attempt index

  See Also:

  bytesTransferred(long, int, long, long, java.lang.String)