1 /*

     2 * Copyright (c) 2015, 2017, Oracle and/or its affiliates. All rights reserved.

     3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

     4 *

     5 * This code is free software; you can redistribute it and/or modify it

     6 * under the terms of the GNU General Public License version 2 only, as

     7 * published by the Free Software Foundation.

     8 *

     9 * This code is distributed in the hope that it will be useful, but WITHOUT

    10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

    11 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

    12 * version 2 for more details (a copy is included in the LICENSE file that

    13 * accompanied this code).

    14 *

    15 * You should have received a copy of the GNU General Public License version

    16 * 2 along with this work; if not, write to the Free Software Foundation,

    17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

    18 *

    19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

    20 * or visit www.oracle.com if you need additional information or have any

    21 * questions.

    22 *

    23 */

    24 

    25 #ifndef SHARE_VM_CLASSFILE_KLASSFACTORY_HPP

    26 #define SHARE_VM_CLASSFILE_KLASSFACTORY_HPP

    27 

    28 #include "memory/allocation.inline.hpp"

    29 #include "runtime/handles.hpp"

    30 

    31 class ClassFileStream;

    32 class ClassLoaderData;

    33 template <typename>

    34 class GrowableArray;

    35 class Klass;

    36 class Symbol;

    37 class TempNewSymbol;

    38 

    39 /*

    40  * KlassFactory is an interface to implementations of the following mapping/function:

    41  *

    42  * Summary: create a VM internal runtime representation ("Klass")

    43             from a bytestream (classfile).

    44  *

    45  * Input:  a named bytestream in the Java class file format (see JVMS, chapter 4).

    46  * Output: a VM runtime representation of a Java class

    47  *

    48  * Pre-conditions:

    49  *   a non-NULL ClassFileStream* // the classfile bytestream

    50  *   a non-NULL Symbol*          // the name of the class

    51  *   a non-NULL ClassLoaderData* // the metaspace allocator

    52  *   (no pending exceptions)

    53  *

    54  * Returns:

    55  *   if the returned value is non-NULL, that value is an indirection (pointer/handle)

    56  *   to a Klass. The caller will not have a pending exception.

    57  *

    58  *   On broken invariants and/or runtime errors the returned value will be

    59  *   NULL (or a NULL handle) and the caller *might* now have a pending exception.

    60  *

    61  */

    62 

    63 class KlassFactory : AllStatic {

    64 

    65   // approved clients

    66   friend class ClassLoader;

    67   friend class ClassLoaderExt;

    68   friend class SystemDictionary;

    69 

    70  private:

    71   static InstanceKlass* create_from_stream(ClassFileStream* stream,

    72                                            Symbol* name,

    73                                            ClassLoaderData* loader_data,

    74                                            Handle protection_domain,

    75                                            const InstanceKlass* host_klass,

    76                                            GrowableArray<Handle>* cp_patches,

    77                                            TRAPS);

    78  public:

    79   static InstanceKlass* check_shared_class_file_load_hook(

    80                                           InstanceKlass* ik,

    81                                           Symbol* class_name,

    82                                           Handle class_loader,

    83                                           Handle protection_domain, TRAPS);

    84 };

    85 

    86 #endif // SHARE_VM_CLASSFILE_KLASSFACTORY_HPP