public final class RandomAccessSourceFactory extends Object
RandomAccessSource
objects based on various types of sourcesConstructor and Description |
---|
RandomAccessSourceFactory()
Creates a factory that will give preference to accessing the underling data source using memory mapped files
|
public RandomAccessSourceFactory()
public RandomAccessSourceFactory setForceRead(boolean forceRead)
forceRead
- true if the full content will be read, false otherwisepublic RandomAccessSourceFactory setUsePlainRandomAccess(boolean usePlainRandomAccess)
RandomAccessFile
should be used as the primary data access mechanismusePlainRandomAccess
- whether RandomAccessFile
should be used as the primary data access mechanismpublic RandomAccessSourceFactory setExclusivelyLockFile(boolean exclusivelyLockFile)
public RandomAccessSource createSource(byte[] data)
RandomAccessSource
based on a byte arraydata
- the byte arrayRandomAccessSource
public RandomAccessSource createSource(RandomAccessFile raf) throws IOException
IOException
public RandomAccessSource createSource(URL url) throws IOException
RandomAccessSource
based on a URL. The data available at the URL is read into memory and used
as the source for the RandomAccessSource
url
- the url to read fromRandomAccessSource
IOException
public RandomAccessSource createSource(InputStream is) throws IOException
RandomAccessSource
based on an InputStream
. The full content of the InputStream is read into memory and used
as the source for the RandomAccessSource
is
- the stream to read fromRandomAccessSource
IOException
public RandomAccessSource createBestSource(String filename) throws IOException
RandomAccessSource
based on a filename string.
If the filename describes a URL, a URL based source is created
If the filename describes a file on disk, the contents may be read into memory (if forceRead is true), opened using memory mapped file channel (if usePlainRandomAccess is false), or opened using RandomAccessFile
access (if usePlainRandomAccess is true)
This call will automatically failover to using RandomAccessFile
if the memory map operation failsfilename
- the name of the file or resource to create the RandomAccessSource
forRandomAccessSource
IOException
public RandomAccessSource createBestSource(RandomAccessFile raf) throws IOException
RandomAccessSource
based on a RandomAccessFile.
The source will be opened using memory mapped file channel (if usePlainRandomAccess is false), or opened using RandomAccessFile
access (if usePlainRandomAccess is true)
This call will automatically failover to using RandomAccessFile
if the memory map operation fails
If the source couldn't be opened, the RandomAccessFile will be closedraf
- the RandomAccessFile to create a RandomAccessSource
forRandomAccessSource
IOException
public RandomAccessSource createBestSource(FileChannel channel) throws IOException
RandomAccessSource
based on memory mapping a file channel.
Unless you are explicitly working with a FileChannel already, it is better to use
createBestSource(String)
.
If the file is large, it will be opened using a paging strategy.filename
- the name of the file or resource to create the RandomAccessSource
forRandomAccessSource
IOException
public RandomAccessSource createRanged(RandomAccessSource source, long[] ranges) throws IOException
IOException
Copyright © 2019. All rights reserved.