Modifier and Type	Class and Description
private static class	ModulePatcher.ExplodedResourceFinder A ResourceFinder that finds resources on the file system.
private static class	ModulePatcher.JarResourceFinder A ResourceFinder that finds resources in a JAR file.
public static class	ModulePatcher.PatchedModuleReader A ModuleReader that reads resources from a patched module.
private static interface	ModulePatcher.ResourceFinder A resource finder that find resources in a patch location.

Modifier and Type	Field and Description
private static final JavaLangModuleAccess	JLMA
private final Map<String, List<Path>>	map

Access	Constructor and Description
public	ModulePatcher(Map<String, List<String>> input) Initialize the module patcher with the given map.

Modifier and Type	Method and Description
public boolean	hasPatches() Returns true is this module patcher has patches.
private boolean	isHidden(Path file) Returns true if the given file exists and is a hidden file
pack-priv Set<String>	patchedModules()
public ModuleReference	patchIfNeeded(ModuleReference mref) Returns a module reference that interposes on the given module if needed.
private static String	toPackageName(Path top, Path file) Derives a package name from the file path of an entry in an exploded patch
private static String	toPackageName(Path file, JarEntry entry) Derives a package name from the name of an entry in a JAR file.
private static String	warnIfModuleInfo(Path file, String e)

JLMA	back to summary
private static final JavaLangModuleAccess JLMA

map	back to summary
private final Map<String, List<Path>> map

ModulePatcher	back to summary
public ModulePatcher(Map<String, List<String>> input) Initialize the module patcher with the given map. The map key is the module name, the value is a list of path strings.

hasPatches	back to summary
public boolean hasPatches() Returns true is this module patcher has patches.

isHidden	back to summary
private boolean isHidden(Path file) Returns true if the given file exists and is a hidden file

patchedModules	back to summary
pack-priv Set<String> patchedModules()

patchIfNeeded	back to summary
public ModuleReference patchIfNeeded(ModuleReference mref) Returns a module reference that interposes on the given module if needed. If there are no patches for the given module then the module reference is simply returned. Otherwise the patches for the module are scanned (to find any new packages) and a new module reference is returned. Exceptions UncheckedIOException: if an I/O error is detected

toPackageName	back to summary
private static String toPackageName(Path top, Path file) Derives a package name from the file path of an entry in an exploded patch

toPackageName	back to summary
private static String toPackageName(Path file, JarEntry entry) Derives a package name from the name of an entry in a JAR file.

warnIfModuleInfo	back to summary
private static String warnIfModuleInfo(Path file, String e)

private Class ModulePatcher.ExplodedResourceFinder

Class Inheritance

extends Object
implements ResourceFinder

java.lang.Object
jdk.internal.module.ModulePatcher.ExplodedResourceFinder

All Implemented Interfaces

jdk.internal.module.ModulePatcher.ResourceFinder, java.io.Closeable, java.lang.AutoCloseable

A ResourceFinder that finds resources on the file system.

Field Summary

Modifier and Type	Field and Description
private final Path	dir

Constructor Summary

Access	Constructor and Description
pack-priv	ExplodedResourceFinder(Path dir)

Method Summary

Modifier and Type	Method and Description
public void	close() Implements java.io.Closeable.close. Closes this stream and releases any system resources associated with it.
public Resource	find(String name) Implements jdk.internal.module.ModulePatcher.ResourceFinder.find.
public Stream<String>	list() Implements jdk.internal.module.ModulePatcher.ResourceFinder.list.
private Resource	newResource(String name, Path top, Path file)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

dir	back to summary
private final Path dir

Constructor Detail

ExplodedResourceFinder	back to summary
pack-priv ExplodedResourceFinder(Path dir)

Method Detail

close back to summary

close	back to summary
public void close() Implements java.io.Closeable.close. Doc from java.io.Closeable.close. Closes this stream and releases any system resources associated with it. If the stream is already closed then invoking this method has no effect. As noted in `AutoCloseable#close()`, cases where the close may fail require careful attention. It is strongly advised to relinquish the underlying resources and to internally mark the `Closeable` as closed, prior to throwing the `IOException`. Annotations @Override

public void close()

Implements java.io.Closeable.close.

Doc from java.io.Closeable.close.

Closes this stream and releases any system resources associated with it. If the stream is already closed then invoking this method has no effect.

As noted in AutoCloseable#close(), cases where the close may fail require careful attention. It is strongly advised to relinquish the underlying resources and to internally mark the Closeable as closed, prior to throwing the IOException.

Annotations

@Override

find	back to summary
public Resource find(String name) throws IOException Implements jdk.internal.module.ModulePatcher.ResourceFinder.find. Annotations @Override

find

back to summary

public Resource find(String name) throws IOException

Implements jdk.internal.module.ModulePatcher.ResourceFinder.find.

Annotations

@Override

list	back to summary
public Stream<String> list() throws IOException Implements jdk.internal.module.ModulePatcher.ResourceFinder.list. Annotations @Override

list

back to summary

public Stream<String> list() throws IOException

Implements jdk.internal.module.ModulePatcher.ResourceFinder.list.

Annotations

@Override

newResource	back to summary
private Resource newResource(String name, Path top, Path file)

jdk.internal.module back to summary

private Class ModulePatcher.JarResourceFinder

Class Inheritance

extends Object
implements ResourceFinder

java.lang.Object
jdk.internal.module.ModulePatcher.JarResourceFinder

All Implemented Interfaces

jdk.internal.module.ModulePatcher.ResourceFinder, java.io.Closeable, java.lang.AutoCloseable

A ResourceFinder that finds resources in a JAR file.

Field Summary

Modifier and Type	Field and Description
private final URL	csURL
private final JarFile	jf

Constructor Summary

Access	Constructor and Description
pack-priv	JarResourceFinder(Path path)

Method Summary

Modifier and Type	Method and Description
public void	close() Implements java.io.Closeable.close. Closes this stream and releases any system resources associated with it.
public Resource	find(String name) Implements jdk.internal.module.ModulePatcher.ResourceFinder.find.
public Stream<String>	list() Implements jdk.internal.module.ModulePatcher.ResourceFinder.list.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

csURL	back to summary
private final URL csURL

jf	back to summary
private final JarFile jf

Constructor Detail

JarResourceFinder	back to summary
pack-priv JarResourceFinder(Path path) throws IOException

Method Detail

close back to summary

close	back to summary
public void close() throws IOException Implements java.io.Closeable.close. Doc from java.io.Closeable.close. Closes this stream and releases any system resources associated with it. If the stream is already closed then invoking this method has no effect. As noted in `AutoCloseable#close()`, cases where the close may fail require careful attention. It is strongly advised to relinquish the underlying resources and to internally mark the `Closeable` as closed, prior to throwing the `IOException`. Annotations @Override Exceptions IOException: if an I/O error occurs

public void close() throws IOException

Implements java.io.Closeable.close.

Doc from java.io.Closeable.close.

Closes this stream and releases any system resources associated with it. If the stream is already closed then invoking this method has no effect.

Annotations

@Override

Exceptions

IOException:: if an I/O error occurs

find	back to summary
public Resource find(String name) throws IOException Implements jdk.internal.module.ModulePatcher.ResourceFinder.find. Annotations @Override

find

back to summary

public Resource find(String name) throws IOException

Implements jdk.internal.module.ModulePatcher.ResourceFinder.find.

Annotations

@Override

list	back to summary
public Stream<String> list() throws IOException Implements jdk.internal.module.ModulePatcher.ResourceFinder.list. Annotations @Override

list

back to summary

public Stream<String> list() throws IOException

Implements jdk.internal.module.ModulePatcher.ResourceFinder.list.

Annotations

@Override

jdk.internal.module back to summary

public Class ModulePatcher.PatchedModuleReader

Class Inheritance

extends Object
implements ModuleReader

java.lang.Object
jdk.internal.module.ModulePatcher.PatchedModuleReader

All Implemented Interfaces

java.lang.module.ModuleReader, java.io.Closeable, java.lang.AutoCloseable

A ModuleReader that reads resources from a patched module. This class is public so as to expose the findResource method to the built-in class loaders and avoid locating the resource twice during class loading (once to locate the resource, the second to gets the URL for the CodeSource).

Field Summary

Modifier and Type	Field and Description
private volatile ModuleReader	delegate
private final URL	delegateCodeSourceURL
private final List<ModulePatcher.ResourceFinder>	finders
private final ModuleReference	mref

Constructor Summary

Access	Constructor and Description
pack-priv	PatchedModuleReader(List<Path> patches, ModuleReference mref) Creates the ModuleReader to reads resources in a patched module.

Method Summary

Modifier and Type	Method and Description
public void	close() Implements java.lang.module.ModuleReader.close. Closes the module reader.
private static void	closeAll(List<ModulePatcher.ResourceFinder> finders) Closes all resource finders.
private static URL	codeSourceURL(ModuleReference mref) Returns the code source URL for the given module.
private ModuleReader	delegate() Returns the ModuleReader to delegate to when the resource is not found in a patch location.
public Optional<URI>	find(String The name of the resource to open for reading name) Implements java.lang.module.ModuleReader.find. Finds a resource, returning a URI to the resource in the module.
public Resource	findResource(String name) Finds a resource of the given name in the patched module.
private Resource	findResourceInPatch(String name) Finds a resources in the patch locations.
public Stream<String>	list() Implements java.lang.module.ModuleReader.list. Lists the contents of the module, returning a stream of elements that are the names of all resources in the module.
public Optional<InputStream>	open(String The name of the resource to open for reading name) Overrides default java.lang.module.ModuleReader.open. Opens a resource, returning an input stream to read the resource in the module.
public Optional<ByteBuffer>	read(String The name of the resource to read name) Overrides default java.lang.module.ModuleReader.read. Reads a resource, returning a byte buffer with the contents of the resource.
public void	release(ByteBuffer The byte buffer to release bb) Overrides default java.lang.module.ModuleReader.release. Releases a byte buffer.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

delegate	back to summary
private volatile ModuleReader delegate

delegateCodeSourceURL	back to summary
private final URL delegateCodeSourceURL

finders	back to summary
private final List<ModulePatcher.ResourceFinder> finders

mref	back to summary
private final ModuleReference mref

Constructor Detail

PatchedModuleReader	back to summary
pack-priv PatchedModuleReader(List<Path> patches, ModuleReference mref) Creates the ModuleReader to reads resources in a patched module.

Method Detail

close back to summary

close	back to summary
public void close() throws IOException Implements java.lang.module.ModuleReader.close. Doc from java.lang.module.ModuleReader.close. Closes the module reader. Once closed then subsequent calls to locate or read a resource will fail by throwing `IOException`. A module reader is not required to be asynchronously closeable. If a thread is reading a resource and another thread invokes the close method, then the second thread may block until the read operation is complete. Annotations @Override Exceptions IOException: Doc from java.io.Closeable.close. if an I/O error occurs

public void close() throws IOException

Implements java.lang.module.ModuleReader.close.

Doc from java.lang.module.ModuleReader.close.

Closes the module reader. Once closed then subsequent calls to locate or read a resource will fail by throwing IOException.

A module reader is not required to be asynchronously closeable. If a thread is reading a resource and another thread invokes the close method, then the second thread may block until the read operation is complete.

Annotations

@Override

Exceptions

IOException:

Doc from java.io.Closeable.close.

if an I/O error occurs

closeAll	back to summary
private static void closeAll(List<ModulePatcher.ResourceFinder> finders) Closes all resource finders.

codeSourceURL	back to summary
private static URL codeSourceURL(ModuleReference mref) Returns the code source URL for the given module.

delegate	back to summary
private ModuleReader delegate() throws IOException Returns the ModuleReader to delegate to when the resource is not found in a patch location.

find back to summary

find	back to summary
public Optional<URI> find(String name) throws IOException Implements java.lang.module.ModuleReader.find. Doc from java.lang.module.ModuleReader.find. Finds a resource, returning a URI to the resource in the module. If the module reader can determine that the name locates a directory then the resulting URI will end with a slash ('/'). Parameters name:String The name of the resource to open for reading Returns:Optional<URI> A URI to the resource; an empty `Optional` if the resource is not found or a URI cannot be constructed to locate the resource Annotations @Override Exceptions IOException: If an I/O error occurs or the module reader is closed

public Optional<URI> find(String name) throws IOException

Implements java.lang.module.ModuleReader.find.

Doc from java.lang.module.ModuleReader.find.

Finds a resource, returning a URI to the resource in the module.

If the module reader can determine that the name locates a directory then the resulting URI will end with a slash ('/').

Parameters

name:String: The name of the resource to open for reading

Returns:Optional<URI>

A URI to the resource; an empty Optional if the resource is not found or a URI cannot be constructed to locate the resource

Annotations

@Override

Exceptions

IOException:: If an I/O error occurs or the module reader is closed

findResource	back to summary
public Resource findResource(String name) throws IOException Finds a resource of the given name in the patched module.

findResourceInPatch	back to summary
private Resource findResourceInPatch(String name) throws IOException Finds a resources in the patch locations. Returns null if not found or the name is "module-info.class" as that cannot be overridden.

list back to summary

list	back to summary
public Stream<String> list() throws IOException Implements java.lang.module.ModuleReader.list. Doc from java.lang.module.ModuleReader.list. Lists the contents of the module, returning a stream of elements that are the names of all resources in the module. 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. The returned stream may contain references to one or more open directories in the module. The directories are closed by closing the stream. The behavior of the stream when used after the module reader is closed is implementation specific and therefore not specified. Returns:Stream<String> A stream of elements that are the names of all resources in the module Annotations @Override Exceptions IOException: If an I/O error occurs or the module reader is closed

public Stream<String> list() throws IOException

Implements java.lang.module.ModuleReader.list.

Doc from java.lang.module.ModuleReader.list.

Lists the contents of the module, returning a stream of elements that are the names of all resources in the module. 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.

The returned stream may contain references to one or more open directories in the module. The directories are closed by closing the stream.

The behavior of the stream when used after the module reader is closed is implementation specific and therefore not specified.

Returns:Stream<String>

A stream of elements that are the names of all resources in the module

Annotations

@Override

Exceptions

IOException:: If an I/O error occurs or the module reader is closed

open back to summary

open	back to summary
public Optional<InputStream> open(String name) throws IOException Overrides default java.lang.module.ModuleReader.open. Doc from java.lang.module.ModuleReader.open. Opens a resource, returning an input stream to read the resource in the module. The behavior of the input stream when used after the module reader is closed is implementation specific and therefore not specified. Parameters name:String The name of the resource to open for reading Returns:Optional<InputStream> An input stream to read the resource or an empty `Optional` if not found Annotations @Override Exceptions IOException: If an I/O error occurs or the module reader is closed

public Optional<InputStream> open(String name) throws IOException

Overrides default java.lang.module.ModuleReader.open.

Doc from java.lang.module.ModuleReader.open.

Opens a resource, returning an input stream to read the resource in the module.

The behavior of the input stream when used after the module reader is closed is implementation specific and therefore not specified.

Parameters

name:String: The name of the resource to open for reading

Returns:Optional<InputStream>

An input stream to read the resource or an empty Optional if not found

Annotations

@Override

Exceptions

IOException:: If an I/O error occurs or the module reader is closed

read back to summary

read	back to summary
public Optional<ByteBuffer> read(String name) throws IOException Overrides default java.lang.module.ModuleReader.read. Doc from java.lang.module.ModuleReader.read. Reads a resource, returning a byte buffer with the contents of the resource. The element at the returned buffer's position is the first byte of the resource, the element at the buffer's limit is the last byte of the resource. Once consumed, the `release` method must be invoked. Failure to invoke the `release` method may result in a resource leak. Parameters name:String The name of the resource to read Returns:Optional<ByteBuffer> A byte buffer containing the contents of the resource or an empty `Optional` if not found Annotations @Override Exceptions IOException: If an I/O error occurs or the module reader is closed

public Optional<ByteBuffer> read(String name) throws IOException

Overrides default java.lang.module.ModuleReader.read.

Doc from java.lang.module.ModuleReader.read.

Reads a resource, returning a byte buffer with the contents of the resource. The element at the returned buffer's position is the first byte of the resource, the element at the buffer's limit is the last byte of the resource. Once consumed, the release method must be invoked. Failure to invoke the release method may result in a resource leak.

Parameters

name:String: The name of the resource to read

Returns:Optional<ByteBuffer>

A byte buffer containing the contents of the resource or an empty Optional if not found

Annotations

@Override

Exceptions

IOException:: If an I/O error occurs or the module reader is closed

release back to summary

public void release(ByteBuffer bb)

Overrides default java.lang.module.ModuleReader.release.

Doc from java.lang.module.ModuleReader.release.

Releases a byte buffer. This method should be invoked after consuming the contents of the buffer returned by the read method. The behavior of this method when invoked to release a buffer that has already been released, or the behavior when invoked to release a buffer after a ModuleReader is closed is implementation specific and therefore not specified.

Parameters

bb:ByteBuffer: The byte buffer to release

Annotations

@Override

public final Class ModulePatcher

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class ModulePatcher.ExplodedResourceFinder

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class ModulePatcher.JarResourceFinder

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class ModulePatcher.PatchedModuleReader

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Interface ModulePatcher.ResourceFinder

Method Summary

Method Detail