1 /*
 2  * Copyright (c) 1997, 2020, 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_MEMORY_OOPFACTORY_HPP
26 #define SHARE_MEMORY_OOPFACTORY_HPP
27 
28 #include "memory/referenceType.hpp"
29 #include "oops/oopsHierarchy.hpp"
30 #include "runtime/handles.hpp"
31 #include "utilities/exceptions.hpp"
32 
33 // oopFactory is a class used for creating new objects.
34 
35 class oopFactory: AllStatic {
36  public:
37   // Basic type leaf array allocation
38   static typeArrayOop    new_boolArray  (int length, TRAPS);
39   static typeArrayOop    new_charArray  (int length, TRAPS);
40   static typeArrayOop    new_floatArray (int length, TRAPS);
41   static typeArrayOop    new_doubleArray(int length, TRAPS);
42   static typeArrayOop    new_byteArray  (int length, TRAPS);
43   static typeArrayOop    new_shortArray (int length, TRAPS);
44   static typeArrayOop    new_intArray   (int length, TRAPS);
45   static typeArrayOop    new_longArray  (int length, TRAPS);
46 
47   // create java.lang.Object[]
48   static objArrayOop     new_objectArray(int length, TRAPS);
49 
50   static typeArrayOop    new_charArray(const char* utf8_str,  TRAPS);
51 
52   static typeArrayOop    new_typeArray(BasicType type, int length, TRAPS);
53   static typeArrayOop    new_typeArray_nozero(BasicType type, int length, TRAPS);
54   static typeArrayOop    new_symbolArray(int length, TRAPS);
55 
56   // Regular object arrays
57   static objArrayOop     new_objArray(Klass* klass, int length, TRAPS);
58 
59   // Value arrays...
60   // LWorld:
61   //    - Q-type signature allocation should use this path.
62   //    - L-type signature allocation should use new_objArray
63   //
64   // Method specifically null free and possibly flat if possible
65   // i.e. flatArrayOop if flattening can be done, else "null free" objArrayOop
66   static arrayOop        new_valueArray(Klass* klass, int length, TRAPS);
67 
68   // Helper conversions from value to obj array...
69   static objArrayHandle  copy_flatArray_to_objArray(flatArrayHandle array, TRAPS);
70   static objArrayHandle  ensure_objArray(oop array, TRAPS); // copy into new objArray if not already an objArray
71 
72   // Helper that returns a Handle
73   static objArrayHandle  new_objArray_handle(Klass* klass, int length, TRAPS);
74 };
75 
76 #endif // SHARE_MEMORY_OOPFACTORY_HPP