| /* |
| * Copyright (c) 2016, 2017, Oracle and/or its affiliates. All rights reserved. |
| * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
| * |
| * This code is free software; you can redistribute it and/or modify it |
| * under the terms of the GNU General Public License version 2 only, as |
| * published by the Free Software Foundation. |
| * |
| * This code is distributed in the hope that it will be useful, but WITHOUT |
| * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
| * version 2 for more details (a copy is included in the LICENSE file that |
| * accompanied this code). |
| * |
| * You should have received a copy of the GNU General Public License version |
| * 2 along with this work; if not, write to the Free Software Foundation, |
| * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
| * |
| * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
| * or visit www.oracle.com if you need additional information or have any |
| * questions. |
| * |
| */ |
| |
| #ifndef SHARE_VM_CLASSFILE_MODULES_HPP |
| #define SHARE_VM_CLASSFILE_MODULES_HPP |
| |
| #include "memory/allocation.hpp" |
| #include "runtime/handles.hpp" |
| |
| class Symbol; |
| |
| class Modules : AllStatic { |
| |
| public: |
| // define_module defines a module containing the specified packages. It binds the |
| // module to its class loader by creating the ModuleEntry record in the |
| // ClassLoader's ModuleEntry table, and creates PackageEntry records in the class |
| // loader's PackageEntry table. As in JVM_DefineClass the jstring format for all |
| // package names must use "/" and not "." |
| // |
| // IllegalArgumentExceptions are thrown for the following : |
| // * Module's Class loader is not a subclass of java.lang.ClassLoader |
| // * Module's Class loader already has a module with that name |
| // * Module's Class loader has already defined types for any of the module's packages |
| // * Module_name is syntactically bad |
| // * Packages contains an illegal package name |
| // * A package already exists in another module for this class loader |
| // * Module is an unnamed module |
| // * num_packages is negative |
| // * num_packages is non-zero when packages is null |
| // NullPointerExceptions are thrown if module is null. |
| static void define_module(jobject module, jboolean is_open, jstring version, |
| jstring location, const char* const* packages, |
| jsize num_packages, TRAPS); |
| |
| // Provides the java.lang.Module for the unnamed module defined |
| // to the boot loader. |
| // |
| // IllegalArgumentExceptions are thrown for the following : |
| // * Module has a name |
| // * Module is not a subclass of java.lang.Module |
| // * Module's class loader is not the boot loader |
| // NullPointerExceptions are thrown if module is null. |
| static void set_bootloader_unnamed_module(jobject module, TRAPS); |
| |
| // This either does a qualified export of package in module from_module to module |
| // to_module or, if to_module is null, does an unqualified export of package. |
| // The format for the package name must use "/' not ".". |
| // |
| // Error conditions causing IlegalArgumentException to be throw : |
| // * Module from_module does not exist |
| // * Module to_module is not null and does not exist |
| // * Package is not syntactically correct |
| // * Package is not defined for from_module's class loader |
| // * Package is not in module from_module. |
| static void add_module_exports(jobject from_module, const char* package, jobject to_module, TRAPS); |
| |
| // This does a qualified export of package in module from_module to module |
| // to_module. The format for the package name must use "/' not ".". |
| // |
| // Error conditions causing IlegalArgumentException to be throw : |
| // * Module from_module does not exist |
| // * Module to_module does not exist |
| // * Package is not syntactically correct |
| // * Package is not defined for from_module's class loader |
| // * Package is not in module from_module. |
| static void add_module_exports_qualified(jobject from_module, const char* package, jobject to_module, TRAPS); |
| |
| // add_reads_module adds module to_module to the list of modules that from_module |
| // can read. If from_module is the same as to_module then this is a no-op. |
| // If to_module is null then from_module is marked as a loose module (meaning that |
| // from_module can read all current and future unnamed modules). |
| // An IllegalArgumentException is thrown if from_module is null or either (non-null) |
| // module does not exist. |
| static void add_reads_module(jobject from_module, jobject to_module, TRAPS); |
| |
| // Return the java.lang.Module object for this class object. |
| static jobject get_module(jclass clazz, TRAPS); |
| |
| // Return the java.lang.Module object for this class loader and package. |
| // Returns NULL if the class loader has not loaded any classes in the package. |
| // The package should contain /'s, not .'s, as in java/lang, not java.lang. |
| // NullPointerException is thrown if package is null. |
| // IllegalArgumentException is thrown if loader is neither null nor a subtype of |
| // java/lang/ClassLoader. |
| static jobject get_named_module(Handle h_loader, const char* package, TRAPS); |
| |
| // If package is defined by loader, return the |
| // java.lang.Module object for the module in which the package is defined. |
| // Returns NULL if package is invalid or not defined by loader. |
| static jobject get_module(Symbol* package_name, Handle h_loader, TRAPS); |
| |
| // Marks the specified package as exported to all unnamed modules. |
| // If either module or package is null then NullPointerException is thrown. |
| // If module or package is bad, or module is unnamed, or package is not in |
| // module then IllegalArgumentException is thrown. |
| static void add_module_exports_to_all_unnamed(jobject module, const char* package, TRAPS); |
| |
| // Return TRUE if package_name is syntactically valid, false otherwise. |
| static bool verify_package_name(const char *package_name); |
| |
| // Return TRUE iff package is defined by loader |
| static bool is_package_defined(Symbol* package_name, Handle h_loader, TRAPS); |
| }; |
| |
| #endif // SHARE_VM_CLASSFILE_MODULES_HPP |