org.apache.commons.io.input

Class ThrottledInputStream.Builder

java.lang.Object

org.apache.commons.io.build.AbstractSupplier<T,B>

org.apache.commons.io.build.AbstractOriginSupplier<T,B>

org.apache.commons.io.build.AbstractStreamBuilder<ThrottledInputStream,ThrottledInputStream.Builder>

org.apache.commons.io.input.ThrottledInputStream.Builder

All Implemented Interfaces:

IOSupplier<ThrottledInputStream>

Enclosing class:

ThrottledInputStream

public static class ThrottledInputStream.Builder
extends AbstractStreamBuilder<ThrottledInputStream,ThrottledInputStream.Builder>

Builds a new ThrottledInputStream.

Using NIO

 ThrottledInputStream in = ThrottledInputStream.builder()
   .setPath(Paths.get("MyFile.xml"))
   .setMaxBytesPerSecond(100_000)
   .get();
 
 

Using IO

 ThrottledInputStream in = ThrottledInputStream.builder()
   .setFile(new File("MyFile.xml"))
   .setMaxBytesPerSecond(100_000)
   .get();
 
 

 ThrottledInputStream in = ThrottledInputStream.builder()
   .setInputStream(inputStream)
   .setMaxBytesPerSecond(100_000)
   .get();
 
 

See Also:

get()

Field Summary

Fields

Modifier and Type	Field and Description
private long	maxBytesPerSecond Effectively not throttled.

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
ThrottledInputStream	get() Builds a new ThrottledInputStream.
void	setMaxBytesPerSecond(long maxBytesPerSecond) Sets the maximum bytes per second.

Methods inherited from class org.apache.commons.io.build.AbstractStreamBuilder

getBufferSize, getBufferSizeDefault, getCharSequence, getCharset, getCharsetDefault, getInputStream, getOpenOptions, getOutputStream, getPath, getReader, getWriter, setBufferSize, setBufferSize, setBufferSizeChecker, setBufferSizeDefault, setBufferSizeMax, setCharset, setCharset, setCharsetDefault, setOpenOptions

Methods inherited from class org.apache.commons.io.build.AbstractOriginSupplier

checkOrigin, getOrigin, hasOrigin, newByteArrayOrigin, newCharSequenceOrigin, newFileOrigin, newFileOrigin, newInputStreamOrigin, newOutputStreamOrigin, newPathOrigin, newPathOrigin, newReaderOrigin, newURIOrigin, newWriterOrigin, setByteArray, setCharSequence, setFile, setFile, setInputStream, setOrigin, setOutputStream, setPath, setPath, setReader, setURI, setWriter

Methods inherited from class org.apache.commons.io.build.AbstractSupplier

asThis

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.commons.io.function.IOSupplier

asSupplier

Field Detail

maxBytesPerSecond

private long maxBytesPerSecond

Effectively not throttled.

Constructor Detail

Builder

public Builder()

Method Detail

get

public ThrottledInputStream get()
                         throws java.io.IOException

Builds a new ThrottledInputStream.

You must set input that supports AbstractStreamBuilder.getInputStream(), otherwise, this method throws an exception.

This builder use the following aspects:

• AbstractStreamBuilder.getInputStream()
• maxBytesPerSecond

Returns:

a new instance.

Throws:

java.lang.IllegalStateException - if the origin is null.

java.lang.UnsupportedOperationException - if the origin cannot be converted to an InputStream.

java.io.IOException - if an I/O error occurs.

See Also:

AbstractStreamBuilder.getInputStream()

setMaxBytesPerSecond

public void setMaxBytesPerSecond(long maxBytesPerSecond)

Sets the maximum bytes per second.

Parameters:

maxBytesPerSecond - the maximum bytes per second.