< prev index next >

src/share/vm/classfile/modules.hpp

Print this page
rev 12479 : 8171855: Move package name transformations during module bootstrap into native code
Reviewed-by: alanb, acorn, lfoltan, mchung


  33 class Modules : AllStatic {
  34 
  35 public:
  36   // define_module defines a module containing the specified packages. It binds the
  37   // module to its class loader by creating the ModuleEntry record in the
  38   // ClassLoader's ModuleEntry table, and creates PackageEntry records in the class
  39   // loader's PackageEntry table.  As in JVM_DefineClass the jstring format for all
  40   // package names must use "/" and not "."
  41   //
  42   //  IllegalArgumentExceptions are thrown for the following :
  43   // * Module's Class loader is not a subclass of java.lang.ClassLoader
  44   // * Module's Class loader already has a module with that name
  45   // * Module's Class loader has already defined types for any of the module's packages
  46   // * Module_name is syntactically bad
  47   // * Packages contains an illegal package name
  48   // * Packages contains a duplicate package name
  49   // * A package already exists in another module for this class loader
  50   // * Module is an unnamed module
  51   //  NullPointerExceptions are thrown if module is null.
  52   static void define_module(jobject module, jstring version,
  53                             jstring location, jobjectArray packages, TRAPS);

  54 
  55   // Provides the java.lang.reflect.Module for the unnamed module defined
  56   // to the boot loader.
  57   //
  58   //  IllegalArgumentExceptions are thrown for the following :
  59   //  * Module has a name
  60   //  * Module is not a subclass of java.lang.reflect.Module
  61   //  * Module's class loader is not the boot loader
  62   //  NullPointerExceptions are thrown if module is null.
  63   static void set_bootloader_unnamed_module(jobject module, TRAPS);
  64 
  65   // This either does a qualified export of package in module from_module to module
  66   // to_module or, if to_module is null, does an unqualified export of package.
  67   // The format for the package name must use "/' not ".".
  68   //
  69   // Error conditions causing IlegalArgumentException to be throw :
  70   // * Module from_module does not exist
  71   // * Module to_module is not null and does not exist
  72   // * Package is not syntactically correct
  73   // * Package is not defined for from_module's class loader
  74   // * Package is not in module from_module.
  75   static void add_module_exports(jobject from_module, jstring package, jobject to_module, TRAPS);
  76 
  77   // This does a qualified export of package in module from_module to module
  78   // to_module.  The format for the package name must use "/' not ".".
  79   //
  80   // Error conditions causing IlegalArgumentException to be throw :
  81   // * Module from_module does not exist
  82   // * Module to_module does not exist
  83   // * Package is not syntactically correct
  84   // * Package is not defined for from_module's class loader
  85   // * Package is not in module from_module.
  86   static void add_module_exports_qualified(jobject from_module, jstring package, jobject to_module, TRAPS);
  87 
  88   // add_reads_module adds module to_module to the list of modules that from_module
  89   // can read.  If from_module is the same as to_module then this is a no-op.
  90   // If to_module is null then from_module is marked as a loose module (meaning that
  91   // from_module can read all current and future unnamed  modules).
  92   // An IllegalArgumentException is thrown if from_module is null or either (non-null)
  93   // module does not exist.
  94   static void add_reads_module(jobject from_module, jobject to_module, TRAPS);
  95 
  96   // Return the java.lang.reflect.Module object for this class object.
  97   static jobject get_module(jclass clazz, TRAPS);
  98 
  99   // Return the java.lang.reflect.Module object for this class loader and package.
 100   // Returns NULL if the class loader has not loaded any classes in the package.
 101   // The package should contain /'s, not .'s, as in java/lang, not java.lang.
 102   // NullPointerException is thrown if package is null.
 103   // IllegalArgumentException is thrown if loader is neither null nor a subtype of
 104   // java/lang/ClassLoader.
 105   static jobject get_module_by_package_name(jobject loader, jstring package, TRAPS);
 106   static jobject get_named_module(Handle h_loader, const char* package, TRAPS);
 107 
 108   // If package is defined by loader, return the
 109   // java.lang.reflect.Module object for the module in which the package is defined.
 110   // Returns NULL if package is invalid or not defined by loader.
 111   static jobject get_module(Symbol* package_name, Handle h_loader, TRAPS);
 112 
 113   // This adds package to module.
 114   // It throws IllegalArgumentException if:
 115   // * Module is bad
 116   // * Module is unnamed
 117   // * Package is not syntactically correct
 118   // * Package is already defined for module's class loader.
 119   static void add_module_package(jobject module, jstring package, TRAPS);
 120 
 121   // Marks the specified package as exported to all unnamed modules.
 122   // If either module or package is null then NullPointerException is thrown.
 123   // If module or package is bad, or module is unnamed, or package is not in
 124   // module then IllegalArgumentException is thrown.
 125   static void add_module_exports_to_all_unnamed(jobject module, jstring package, TRAPS);
 126 
 127   // Return TRUE if package_name is syntactically valid, false otherwise.
 128   static bool verify_package_name(char *package_name);
 129 
 130   // Return TRUE iff package is defined by loader
 131   static bool is_package_defined(Symbol* package_name, Handle h_loader, TRAPS);
 132 };
 133 
 134 #endif // SHARE_VM_CLASSFILE_MODULES_HPP


  33 class Modules : AllStatic {
  34 
  35 public:
  36   // define_module defines a module containing the specified packages. It binds the
  37   // module to its class loader by creating the ModuleEntry record in the
  38   // ClassLoader's ModuleEntry table, and creates PackageEntry records in the class
  39   // loader's PackageEntry table.  As in JVM_DefineClass the jstring format for all
  40   // package names must use "/" and not "."
  41   //
  42   //  IllegalArgumentExceptions are thrown for the following :
  43   // * Module's Class loader is not a subclass of java.lang.ClassLoader
  44   // * Module's Class loader already has a module with that name
  45   // * Module's Class loader has already defined types for any of the module's packages
  46   // * Module_name is syntactically bad
  47   // * Packages contains an illegal package name
  48   // * Packages contains a duplicate package name
  49   // * A package already exists in another module for this class loader
  50   // * Module is an unnamed module
  51   //  NullPointerExceptions are thrown if module is null.
  52   static void define_module(jobject module, jstring version,
  53                             jstring location, const char* const* packages,
  54                             jsize num_packages, TRAPS);
  55 
  56   // Provides the java.lang.reflect.Module for the unnamed module defined
  57   // to the boot loader.
  58   //
  59   //  IllegalArgumentExceptions are thrown for the following :
  60   //  * Module has a name
  61   //  * Module is not a subclass of java.lang.reflect.Module
  62   //  * Module's class loader is not the boot loader
  63   //  NullPointerExceptions are thrown if module is null.
  64   static void set_bootloader_unnamed_module(jobject module, TRAPS);
  65 
  66   // This either does a qualified export of package in module from_module to module
  67   // to_module or, if to_module is null, does an unqualified export of package.
  68   // The format for the package name must use "/' not ".".
  69   //
  70   // Error conditions causing IlegalArgumentException to be throw :
  71   // * Module from_module does not exist
  72   // * Module to_module is not null and does not exist
  73   // * Package is not syntactically correct
  74   // * Package is not defined for from_module's class loader
  75   // * Package is not in module from_module.
  76   static void add_module_exports(jobject from_module, const char* package, jobject to_module, TRAPS);
  77 
  78   // This does a qualified export of package in module from_module to module
  79   // to_module.  The format for the package name must use "/' not ".".
  80   //
  81   // Error conditions causing IlegalArgumentException to be throw :
  82   // * Module from_module does not exist
  83   // * Module to_module does not exist
  84   // * Package is not syntactically correct
  85   // * Package is not defined for from_module's class loader
  86   // * Package is not in module from_module.
  87   static void add_module_exports_qualified(jobject from_module, const char* package, jobject to_module, TRAPS);
  88 
  89   // add_reads_module adds module to_module to the list of modules that from_module
  90   // can read.  If from_module is the same as to_module then this is a no-op.
  91   // If to_module is null then from_module is marked as a loose module (meaning that
  92   // from_module can read all current and future unnamed  modules).
  93   // An IllegalArgumentException is thrown if from_module is null or either (non-null)
  94   // module does not exist.
  95   static void add_reads_module(jobject from_module, jobject to_module, TRAPS);
  96 
  97   // Return the java.lang.reflect.Module object for this class object.
  98   static jobject get_module(jclass clazz, TRAPS);
  99 
 100   // Return the java.lang.reflect.Module object for this class loader and package.
 101   // Returns NULL if the class loader has not loaded any classes in the package.
 102   // The package should contain /'s, not .'s, as in java/lang, not java.lang.
 103   // NullPointerException is thrown if package is null.
 104   // IllegalArgumentException is thrown if loader is neither null nor a subtype of
 105   // java/lang/ClassLoader.
 106   static jobject get_module_by_package_name(jobject loader, const char* package, TRAPS);
 107   static jobject get_named_module(Handle h_loader, const char* package, TRAPS);
 108 
 109   // If package is defined by loader, return the
 110   // java.lang.reflect.Module object for the module in which the package is defined.
 111   // Returns NULL if package is invalid or not defined by loader.
 112   static jobject get_module(Symbol* package_name, Handle h_loader, TRAPS);
 113 
 114   // This adds package to module.
 115   // It throws IllegalArgumentException if:
 116   // * Module is bad
 117   // * Module is unnamed
 118   // * Package is not syntactically correct
 119   // * Package is already defined for module's class loader.
 120   static void add_module_package(jobject module, const char* package, TRAPS);
 121 
 122   // Marks the specified package as exported to all unnamed modules.
 123   // If either module or package is null then NullPointerException is thrown.
 124   // If module or package is bad, or module is unnamed, or package is not in
 125   // module then IllegalArgumentException is thrown.
 126   static void add_module_exports_to_all_unnamed(jobject module, const char* package, TRAPS);
 127 
 128   // Return TRUE if package_name is syntactically valid, false otherwise.
 129   static bool verify_package_name(const char *package_name);
 130 
 131   // Return TRUE iff package is defined by loader
 132   static bool is_package_defined(Symbol* package_name, Handle h_loader, TRAPS);
 133 };
 134 
 135 #endif // SHARE_VM_CLASSFILE_MODULES_HPP
< prev index next >