java.lang.Object
java.lang.ModuleLayer.Controller
- Enclosing class:
ModuleLayer
Controls a module layer. The static methods defined by
ModuleLayer to create module layers return aController that can be used to control modules in the layer. Unless otherwise specified, passing anull argument to a method in this class causes aNullPointerException to be thrown.
- API Note:
- Care should be taken with
Controllerobjects, they should never be shared with untrusted code. - Since:
- 9
Method Summary
Modifier and TypeMethodDescriptionaddExports(Module source,String pn,Module target) Updates modulesourcein the layer to export a package to moduletarget.Updates modulesourcein the layer to open a package to moduletarget.Updates modulesourcein the layer to read moduletarget.enableNativeAccess(Module target) Restricted.Enables native access for a module in the layer if the caller's module has native access.layer()Returns the layer that this object controls.
Method Details
layer
addReads
Updates modulesourcein the layer to read moduletarget. This method is a no-op ifsourcealready readstarget.- Implementation Note:
- Read edges added by this method areweak and do not prevent
targetfrom being GC'ed whensourceis strongly reachable. - Parameters:
source- The source moduletarget- The target module to read- Returns:
- This controller
- Throws:
IllegalArgumentException- Ifsourceis not in the module layer- See Also:
addExports
Updates modulesourcein the layer to export a package to moduletarget. This method is a no-op ifsourcealready exports the package to at leasttarget.- Parameters:
source- The source modulepn- The package nametarget- The target module- Returns:
- This controller
- Throws:
IllegalArgumentException- Ifsourceis not in the module layer or the package is not in the source module- See Also:
addOpens
Updates modulesourcein the layer to open a package to moduletarget. This method is a no-op ifsourcealready opens the package to at leasttarget.- Parameters:
source- The source modulepn- The package nametarget- The target module- Returns:
- This controller
- Throws:
IllegalArgumentException- Ifsourceis not in the module layer or the package is not in the source module- See Also:
enableNativeAccess
enableNativeAccessis a restricted method of the Java platform.Programs can only useenableNativeAccesswhen access to restricted methods is enabled.Restricted methods are unsafe, and, if used incorrectly, might crash the JVM or result in memory corruption.Enables native access for a module in the layer if the caller's module has native access.- Parameters:
target- The module to update- Returns:
- This controller
- Throws:
IllegalArgumentException- Iftargetis not in the module layerIllegalCallerException- If the caller is in a module that does not have native access enabled- Since:
- 22