Top Description Fields Constructors Methods
nonapi.io.github.classgraph.fileslice

public Class FileSlice

extends Slice
Class Inheritance
Imports
java.io.File, .IOException, .InputStream, .RandomAccessFile, java.nio.Buffer, .ByteBuffer, .MappedByteBuffer, java.nio.channels.FileChannel, .FileChannel.MapMode, java.util.concurrent.atomic.AtomicBoolean, io.github.classgraph.ClassGraph, nonapi.io.github.classgraph.fastzipfilereader.NestedJarHandler, nonapi.io.github.classgraph.fileslice.reader.RandomAccessByteBufferReader, .RandomAccessFileChannelReader, .RandomAccessReader, nonapi.io.github.classgraph.utils.FileUtils, .LogNode

A File slice.

Field Summary

Modifier and TypeField and Description
private ByteBuffer
backingByteBuffer

The backing byte buffer, if any.

public final File
file

The File.

private FileChannel
fileChannel

The file channel.

private final long
fileLength

The file length.

private final AtomicBoolean
isClosed

True if close has been called.

private final boolean
isTopLevelFileSlice

True if this is a top level file slice.

public RandomAccessFile
raf

The RandomAccessFile opened on the File.

Inherited from nonapi.io.github.classgraph.fileslice.Slice:
inflatedLengthHintisDeflatedZipEntrynestedJarHandlerparentSlicesliceLengthsliceStartPos

Constructor Summary

AccessConstructor and Description
private
FileSlice(final FileSlice
the parent slice
parentSlice
,
final long
the offset of the sub-slice within the parent slice
offset
,
final long
the length of the sub-slice
length
,
final boolean
true if this is a deflated zip entry
isDeflatedZipEntry
,
final long
the uncompressed size of a deflated zip entry, or -1 if unknown, or 0 of this is not a deflated zip entry.
inflatedLengthHint
,
final NestedJarHandler
the nested jar handler
nestedJarHandler
)

Constructor for treating a range of a file as a slice.

public
FileSlice(final File
the file
file
,
final boolean
true if this is a deflated zip entry
isDeflatedZipEntry
,
final long
the uncompressed size of a deflated zip entry, or -1 if unknown, or 0 of this is not a deflated zip entry.
inflatedLengthHint
,
final NestedJarHandler
the nested jar handler
nestedJarHandler
,
final LogNode
the log
log
)

Constructor for toplevel file slice.

public
FileSlice(final File
the file
file
,
final NestedJarHandler
the nested jar handler
nestedJarHandler
,
final LogNode
the log
log
)

Constructor for toplevel file slice.

Method Summary

Modifier and TypeMethod and Description
public void
public boolean
equals(final Object
the reference object with which to compare.
o
)

Overrides nonapi.io.github.classgraph.fileslice.Slice.equals.

Indicates whether some other object is "equal to" this one.

public int
hashCode()

Overrides nonapi.io.github.classgraph.fileslice.Slice.hashCode.

Returns a hash code value for this object.

public byte[]

Returns:

the byte[]
load
()

Implements abstract nonapi.io.github.classgraph.fileslice.Slice.load.

Load the slice as a byte array.

public RandomAccessReader

Returns:

the random access reader
randomAccessReader
()

Implements abstract nonapi.io.github.classgraph.fileslice.Slice.randomAccessReader.

Read directly from FileChannel (slow path, but handles >2GB).

public ByteBuffer

Returns:

the byte buffer
read
()

Overrides nonapi.io.github.classgraph.fileslice.Slice.read.

Read the slice into a ByteBuffer (or memory-map the slice to a MappedByteBuffer, if ClassGraph#enableMemoryMapping() was called.)

public Slice

Returns:

the slice
slice
(final long
the offset of the sub-slice within the parent slice
offset
,
final long
the length of the sub-slice
length
,
final boolean
true if this is a deflated zip entry
isDeflatedZipEntry
,
final long
the uncompressed size of a deflated zip entry, or -1 if unknown, or 0 of this is not a deflated zip entry.
inflatedLengthHint
)

Implements abstract nonapi.io.github.classgraph.fileslice.Slice.slice.

Slice the file.

Inherited from nonapi.io.github.classgraph.fileslice.Slice:
loadAsStringopenopen

Field Detail

backingByteBufferback to summary
private ByteBuffer backingByteBuffer

The backing byte buffer, if any.

fileback to summary
public final File file

The File.

fileChannelback to summary
private FileChannel fileChannel

The file channel.

fileLengthback to summary
private final long fileLength

The file length.

isClosedback to summary
private final AtomicBoolean isClosed

True if close has been called.

isTopLevelFileSliceback to summary
private final boolean isTopLevelFileSlice

True if this is a top level file slice.

rafback to summary
public RandomAccessFile raf

The RandomAccessFile opened on the File.

Constructor Detail

FileSliceback to summary
private FileSlice(final FileSlice parentSlice, final long offset, final long length, final boolean isDeflatedZipEntry, final long inflatedLengthHint, final NestedJarHandler nestedJarHandler)

Constructor for treating a range of a file as a slice.

Parameters
parentSlice:FileSlice

the parent slice

offset:long

the offset of the sub-slice within the parent slice

length:long

the length of the sub-slice

isDeflatedZipEntry:boolean

true if this is a deflated zip entry

inflatedLengthHint:long

the uncompressed size of a deflated zip entry, or -1 if unknown, or 0 of this is not a deflated zip entry.

nestedJarHandler:NestedJarHandler

the nested jar handler

FileSliceback to summary
public FileSlice(final File file, final boolean isDeflatedZipEntry, final long inflatedLengthHint, final NestedJarHandler nestedJarHandler, final LogNode log) throws IOException

Constructor for toplevel file slice.

Parameters
file:File

the file

isDeflatedZipEntry:boolean

true if this is a deflated zip entry

inflatedLengthHint:long

the uncompressed size of a deflated zip entry, or -1 if unknown, or 0 of this is not a deflated zip entry.

nestedJarHandler:NestedJarHandler

the nested jar handler

log:LogNode

the log

Exceptions
IOException:
if the file cannot be opened.
FileSliceback to summary
public FileSlice(final File file, final NestedJarHandler nestedJarHandler, final LogNode log) throws IOException

Constructor for toplevel file slice.

Parameters
file:File

the file

nestedJarHandler:NestedJarHandler

the nested jar handler

log:LogNode

the log

Exceptions
IOException:
if the file cannot be opened.

Method Detail

closeback to summary
public void close()

Overrides nonapi.io.github.classgraph.fileslice.Slice.close.

Implements java.io.Closeable.close.

Close the slice. Unmaps any backing MappedByteBuffer.

Annotations
@Override
equalsback to summary
public boolean equals(final Object o)

Overrides nonapi.io.github.classgraph.fileslice.Slice.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

  • It is reflexive: for any non-null reference value x, x.equals(x) should return true.
  • It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
  • It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
  • It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
  • For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Parameters
o:Object

the reference object with which to compare.

Returns:boolean

true if this object is the same as the obj argument; false otherwise.

Annotations
@Override
hashCodeback to summary
public int hashCode()

Overrides nonapi.io.github.classgraph.fileslice.Slice.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

  • Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
  • If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
  • It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.
Returns:int

a hash code value for this object

Annotations
@Override
loadback to summary
public byte[] load() throws IOException

Implements abstract nonapi.io.github.classgraph.fileslice.Slice.load.

Load the slice as a byte array.

Returns:byte[]

the byte[]

Annotations
@Override
Exceptions
IOException:
Signals that an I/O exception has occurred.
randomAccessReaderback to summary
public RandomAccessReader randomAccessReader()

Implements abstract nonapi.io.github.classgraph.fileslice.Slice.randomAccessReader.

Read directly from FileChannel (slow path, but handles >2GB).

Returns:RandomAccessReader

the random access reader

Annotations
@Override
readback to summary
public ByteBuffer read() throws IOException

Overrides nonapi.io.github.classgraph.fileslice.Slice.read.

Read the slice into a ByteBuffer (or memory-map the slice to a MappedByteBuffer, if ClassGraph#enableMemoryMapping() was called.)

Returns:ByteBuffer

the byte buffer

Annotations
@Override
Exceptions
IOException:
Signals that an I/O exception has occurred.
sliceback to summary
public Slice slice(final long offset, final long length, final boolean isDeflatedZipEntry, final long inflatedLengthHint)

Implements abstract nonapi.io.github.classgraph.fileslice.Slice.slice.

Slice the file.

Parameters
offset:long

the offset of the sub-slice within the parent slice

length:long

the length of the sub-slice

isDeflatedZipEntry:boolean

true if this is a deflated zip entry

inflatedLengthHint:long

the uncompressed size of a deflated zip entry, or -1 if unknown, or 0 of this is not a deflated zip entry.

Returns:Slice

the slice

Annotations
@Override