Package io.github.classgraph
Class ModuleReaderProxy
java.lang.Object
io.github.classgraph.ModuleReaderProxy
- All Implemented Interfaces:
Closeable
,AutoCloseable
A ModuleReader proxy, written using reflection to preserve backwards compatibility with JDK 7 and 8.
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate static Class
<?> ClasscollectorClass = Class.forName("java.util.stream.Collector"); private static Object
Collectorinvalid input: '<'Object, ?, Listprivate final AutoCloseable
The module reader.private ReflectionUtils
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
Calls ModuleReader#close().Use the proxied ModuleReader to find the named resource as a URI.list()
Get the list of resources accessible to a ModuleReader.Use the proxied ModuleReader to open the named resource as an InputStream.Use the proxied ModuleReader to open the named resource as a ByteBuffer.void
release
(ByteBuffer byteBuffer) Release aByteBuffer
allocated by callingread(String)
.
-
Field Details
-
moduleReader
The module reader. -
collectorClass
ClasscollectorClass = Class.forName("java.util.stream.Collector"); -
collectorsToList
Collectorinvalid input: '<'Object, ?, List -
reflectionUtils
-
-
Constructor Details
-
ModuleReaderProxy
ModuleReaderProxy(ModuleRef moduleRef) throws IOException Constructor.- Parameters:
moduleRef
- the module ref- Throws:
IOException
- If an I/O exception occurs.
-
-
Method Details
-
close
public void close()Calls ModuleReader#close().- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
-
list
Get the list of resources accessible to a ModuleReader. From the documentation for ModuleReader#list(): "Whether the stream of elements includes names corresponding to directories in the module is module reader specific. In lazy implementations then an IOException may be thrown when using the stream to list the module contents. If this occurs then the IOException will be wrapped in an java.io.UncheckedIOException and thrown from the method that caused the access to be attempted. SecurityException may also be thrown when using the stream to list the module contents and access is denied by the security manager."- Returns:
- A list of the paths of resources in the module.
- Throws:
SecurityException
- If the module cannot be accessed.
-
open
Use the proxied ModuleReader to open the named resource as an InputStream.- Parameters:
path
- The path to the resource to open.- Returns:
- An
InputStream
for the content of the resource. - Throws:
SecurityException
- If the module cannot be accessed.IllegalArgumentException
- If the module cannot be accessed.
-
read
Use the proxied ModuleReader to open the named resource as a ByteBuffer. Callrelease(ByteBuffer)
when you have finished with the ByteBuffer.- Parameters:
path
- The path to the resource to open.- Returns:
- A
ByteBuffer
for the content of the resource. - Throws:
SecurityException
- If the module cannot be accessed.OutOfMemoryError
- if the resource is larger than 2GB, the maximum capacity of a byte buffer.
-
release
Release aByteBuffer
allocated by callingread(String)
.- Parameters:
byteBuffer
- TheByteBuffer
to release.
-
find
Use the proxied ModuleReader to find the named resource as a URI.- Parameters:
path
- The path to the resource to open.- Returns:
- A
URI
for the resource. - Throws:
SecurityException
- If the module cannot be accessed.
-