Method Detail

• buffered

   final static Readable buffered(Readable $self, Long contentLength, Integer bufferSize)

  Wraps this resource into a buffer to improve reading performances.

  Expensive interaction with the underlying resource is minimized, since most (smaller) requests can be satisfied by accessing the buffer alone. The drawback is that some extra space is required to hold the buffer and that copying takes place when filling that buffer, but this is usually outweighed by the performance benefits.

  Note that this implementation is pretty limited and the benefits are only apparent when reading forward and consecutively – e.g. when downloading the resource by chunks. The buffer is ignored when reading backward or far ahead.

  Parameters:

  contentLength - The total length of the resource, when known.

  bufferSize - Size of the buffer chunks to read.