< prev index next >

src/hotspot/share/classfile/stringTable.hpp

Print this page
rev 50281 : 8195097: Make it possible to process StringTable outside safepoint
Reviewed-by:


   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_STRINGTABLE_HPP
  26 #define SHARE_VM_CLASSFILE_STRINGTABLE_HPP
  27 
  28 #include "utilities/hashtable.hpp"






  29 
  30 template <class T, class N> class CompactHashtable;
  31 class CompactStringTableWriter;
  32 class FileMapInfo;
  33 class SerializeClosure;
  34 
  35 class StringTable : public RehashableHashtable<oop, mtSymbol> {







  36   friend class VMStructs;
  37   friend class Symbol;


  38 
  39 private:



  40   // The string table
  41   static StringTable* _the_table;
  42 
  43   // Shared string table
  44   static CompactHashtable<oop, char> _shared_table;
  45   static bool _shared_string_mapped;


  46 
  47   // Set if one bucket is out of balance due to hash algorithm deficiency
  48   static bool _needs_rehashing;













  49 
  50   // Claimed high water mark for parallel chunked scanning
  51   static volatile int _parallel_claimed_idx;
  52 
  53   static oop intern(Handle string_or_null, jchar* chars, int length, TRAPS);
  54   oop basic_add(int index, Handle string_or_null, jchar* name, int len,
  55                 unsigned int hashValue, TRAPS);
  56 
  57   oop lookup_in_main_table(int index, jchar* chars, int length, unsigned int hashValue);
  58   static oop lookup_shared(jchar* name, int len, unsigned int hash);
  59 
  60   // Apply the give oop closure to the entries to the buckets
  61   // in the range [start_idx, end_idx).
  62   static void buckets_oops_do(OopClosure* f, int start_idx, int end_idx);
  63 
  64   typedef StringTable::BucketUnlinkContext BucketUnlinkContext;
  65   // Unlink or apply the give oop closure to the entries to the buckets
  66   // in the range [start_idx, end_idx). Unlinked bucket entries are collected in the given
  67   // context to be freed later.
  68   // This allows multiple threads to work on the table at once.
  69   static void buckets_unlink_or_oops_do(BoolObjectClosure* is_alive, OopClosure* f, int start_idx, int end_idx, BucketUnlinkContext* context);
  70 
  71   // Hashing algorithm, used as the hash value used by the
  72   //     StringTable for bucket selection and comparison (stored in the
  73   //     HashtableEntry structures).  This is used in the String.intern() method.
  74   static unsigned int hash_string(const jchar* s, int len);
  75   static unsigned int hash_string(oop string);
  76   static unsigned int alt_hash_string(const jchar* s, int len);
  77 
  78   // Accessors for the string roots in the hashtable entries.
  79   // Use string_object_no_keepalive() only when the value is not returned
  80   // outside of a scope where a thread transition is possible.
  81   static oop string_object(HashtableEntry<oop, mtSymbol>* entry);
  82   static oop string_object_no_keepalive(HashtableEntry<oop, mtSymbol>* entry);
  83   static void set_string_object(HashtableEntry<oop, mtSymbol>* entry, oop string);
  84 
  85   StringTable() : RehashableHashtable<oop, mtSymbol>((int)StringTableSize,
  86                               sizeof (HashtableEntry<oop, mtSymbol>)) {}
  87 
  88   StringTable(HashtableBucket<mtSymbol>* t, int number_of_entries)
  89     : RehashableHashtable<oop, mtSymbol>((int)StringTableSize, sizeof (HashtableEntry<oop, mtSymbol>), t,
  90                      number_of_entries) {}
  91 public:
  92   // The string table
  93   static StringTable* the_table() { return _the_table; }

  94 
  95   // Size of one bucket in the string table.  Used when checking for rollover.
  96   static uint bucket_size() { return sizeof(HashtableBucket<mtSymbol>); }
  97 
  98   static void create_table() {
  99     assert(_the_table == NULL, "One string table allowed.");
 100     _the_table = new StringTable();
 101   }
 102 



 103   // GC support
 104   //   Delete pointers to otherwise-unreachable objects.
 105   static void unlink_or_oops_do(BoolObjectClosure* cl, OopClosure* f) {
 106     int processed = 0;
 107     int removed = 0;
 108     unlink_or_oops_do(cl, f, &processed, &removed);
 109   }
 110   static void unlink(BoolObjectClosure* cl) {
 111     int processed = 0;
 112     int removed = 0;
 113     unlink_or_oops_do(cl, NULL, &processed, &removed);
 114   }
 115   static void unlink_or_oops_do(BoolObjectClosure* cl, OopClosure* f, int* processed, int* removed);
 116   static void unlink(BoolObjectClosure* cl, int* processed, int* removed) {
 117     unlink_or_oops_do(cl, NULL, processed, removed);
 118   }




 119   // Serially invoke "f->do_oop" on the locations of all oops in the table.
 120   static void oops_do(OopClosure* f);
 121 
 122   // Possibly parallel versions of the above
 123   static void possibly_parallel_unlink_or_oops_do(BoolObjectClosure* cl, OopClosure* f, int* processed, int* removed);
 124   static void possibly_parallel_unlink(BoolObjectClosure* cl, int* processed, int* removed) {
 125     possibly_parallel_unlink_or_oops_do(cl, NULL, processed, removed);
 126   }
 127   static void possibly_parallel_oops_do(OopClosure* f);

 128 
 129   // Internal test.
 130   static void test_alt_hash() PRODUCT_RETURN;
 131 
 132   // Probing
 133   static oop lookup(Symbol* symbol);
 134   static oop lookup(jchar* chars, int length);
 135 
 136   // Interning
 137   static oop intern(Symbol* symbol, TRAPS);
 138   static oop intern(oop string, TRAPS);
 139   static oop intern(const char *utf8_string, TRAPS);
 140 
 141   // Debugging
 142   static void verify();
 143   static void dump(outputStream* st, bool verbose=false);
 144 
 145   enum VerifyMesgModes {
 146     _verify_quietly    = 0,
 147     _verify_with_mesgs = 1
 148   };
 149 
 150   enum VerifyRetTypes {
 151     _verify_pass          = 0,
 152     _verify_fail_continue = 1,
 153     _verify_fail_done     = 2
 154   };
 155 
 156   static VerifyRetTypes compare_entries(int bkt1, int e_cnt1,
 157                                         HashtableEntry<oop, mtSymbol>* e_ptr1,
 158                                         int bkt2, int e_cnt2,
 159                                         HashtableEntry<oop, mtSymbol>* e_ptr2);
 160   static VerifyRetTypes verify_entry(int bkt, int e_cnt,
 161                                      HashtableEntry<oop, mtSymbol>* e_ptr,
 162                                      VerifyMesgModes mesg_mode);
 163   static int verify_and_compare_entries();
 164 
 165   // Sharing


 166   static void set_shared_string_mapped() { _shared_string_mapped = true; }
 167   static bool shared_string_mapped()       { return _shared_string_mapped; }
 168   static void shared_oops_do(OopClosure* f) NOT_CDS_JAVA_HEAP_RETURN;
 169   static bool copy_shared_string(GrowableArray<MemRegion> *string_space,
 170                                  CompactStringTableWriter* ch_table) NOT_CDS_JAVA_HEAP_RETURN_(false);
 171   static oop  create_archived_string(oop s, Thread* THREAD) NOT_CDS_JAVA_HEAP_RETURN_(NULL);
 172   static void write_to_archive(GrowableArray<MemRegion> *string_space) NOT_CDS_JAVA_HEAP_RETURN;
 173   static void serialize(SerializeClosure* soc) NOT_CDS_JAVA_HEAP_RETURN;
 174 
 175   // Rehash the symbol table if it gets out of balance
 176   static void rehash_table();
 177   static bool needs_rehashing() { return _needs_rehashing; }
 178 
 179   // Parallel chunked scanning
 180   static void clear_parallel_claimed_index() { _parallel_claimed_idx = 0; }
 181   static int parallel_claimed_index() { return _parallel_claimed_idx; }
 182 };

 183 #endif // SHARE_VM_CLASSFILE_STRINGTABLE_HPP


   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_STRINGTABLE_HPP
  26 #define SHARE_VM_CLASSFILE_STRINGTABLE_HPP
  27 
  28 #include "gc/shared/oopStorage.hpp"
  29 #include "gc/shared/oopStorageParState.hpp"
  30 #include "memory/allocation.hpp"
  31 #include "memory/padded.hpp"
  32 #include "oops/oop.hpp"
  33 #include "oops/weakHandle.hpp"
  34 #include "utilities/concurrentHashTable.hpp"
  35 
  36 template <class T, class N> class CompactHashtable;
  37 class CompactStringTableWriter;

  38 class SerializeClosure;
  39 
  40 class StringTable;
  41 class StringTableConfig;
  42 typedef ConcurrentHashTable<WeakHandle<vm_string_table_data>,
  43                             StringTableConfig, mtSymbol> StringTableHash;
  44 
  45 class StringTableCreateEntry;
  46 
  47 class StringTable : public CHeapObj<mtSymbol>{
  48   friend class VMStructs;
  49   friend class Symbol;
  50   friend class StringTableConfig;
  51   friend class StringTableCreateEntry;
  52 
  53 private:
  54   void grow(JavaThread* jt);
  55   void clean_dead_entries(JavaThread* jt);
  56 
  57   // The string table
  58   static StringTable* _the_table;

  59   // Shared string table
  60   static CompactHashtable<oop, char> _shared_table;
  61   static bool _shared_string_mapped;
  62   static bool _alt_hash;
  63 private:
  64 
  65    // Set if one bucket is out of balance due to hash algorithm deficiency
  66   StringTableHash* _local_table;
  67   size_t _current_size;
  68   volatile bool _has_work;
  69   volatile bool _needs_rehashing;
  70 
  71   OopStorage* _weak_handles;
  72 
  73   volatile size_t _items;
  74   DEFINE_PAD_MINUS_SIZE(1, 64, sizeof(volatile size_t));
  75   volatile size_t _uncleaned_items;
  76   DEFINE_PAD_MINUS_SIZE(2, 64, sizeof(volatile size_t));
  77 
  78   double get_load_factor();
  79   double get_dead_factor();
  80 
  81   void check_concurrent_work();
  82   void trigger_concurrent_work();
  83 
  84   static uintx item_added();
  85   static void item_removed();
  86   static size_t items_to_clean(size_t ncl);
  87 
  88   StringTable();
  89 
  90   static oop intern(Handle string_or_null_h, jchar* name, int len, TRAPS);
  91   oop do_intern(Handle string_or_null, jchar* name, int len, uintx hash, TRAPS);
  92   oop do_lookup(jchar* name, int len, uintx hash);
  93 
  94   void concurrent_work(JavaThread* jt);
  95   void print_table_statistics(outputStream* st, const char* table_name);
  96 
  97   void try_rehash_table();
  98   bool do_rehash();
  99 
 100  public:






















 101   // The string table
 102   static StringTable* the_table() { return _the_table; }
 103   size_t table_size(Thread* thread = NULL);
 104 
 105   static OopStorage* weak_storage() { return the_table()->_weak_handles; }

 106 
 107   static void create_table() {
 108     assert(_the_table == NULL, "One string table allowed.");
 109     _the_table = new StringTable();
 110   }
 111 
 112   static void do_concurrent_work(JavaThread* jt);
 113   static bool has_work() { return the_table()->_has_work; }
 114 
 115   // GC support
 116   //   Delete pointers to otherwise-unreachable objects.





 117   static void unlink(BoolObjectClosure* cl) {
 118     unlink_or_oops_do(cl);






 119   }
 120   static void unlink_or_oops_do(BoolObjectClosure* is_alive,
 121                                 OopClosure* f = NULL, int* processed = NULL,
 122                                 int* removed = NULL);
 123 
 124   // Serially invoke "f->do_oop" on the locations of all oops in the table.
 125   static void oops_do(OopClosure* f);
 126 
 127   // Possibly parallel versions of the above
 128   static void possibly_parallel_unlink(
 129      OopStorage::ParState<false /* concurrent */, false /* const*/>*
 130      _par_state_string, BoolObjectClosure* cl, int* processed, int* removed);
 131   static void possibly_parallel_oops_do(
 132      OopStorage::ParState<false /* concurrent */, false /* const*/>*
 133      _par_state_string,OopClosure* f);
 134 
 135   static void weak_oops_do(BoolObjectClosure* is_alive, OopClosure* f);
 136   static void weak_oops_do(OopClosure* f);
 137 
 138   // Probing
 139   static oop lookup(Symbol* symbol);
 140   static oop lookup(jchar* chars, int length);
 141 
 142   // Interning
 143   static oop intern(Symbol* symbol, TRAPS);
 144   static oop intern(oop string, TRAPS);
 145   static oop intern(const char *utf8_string, TRAPS);
 146 
 147   // Rehash the string table if it gets out of balance
 148   static void rehash_table();
 149   static bool needs_rehashing()
 150   { return StringTable::the_table()->_needs_rehashing; }



















 151 
 152   // Sharing
 153   oop lookup_shared(jchar* name, int len, unsigned int hash);
 154   static oop create_archived_string(oop s, Thread* THREAD);
 155   static void set_shared_string_mapped() { _shared_string_mapped = true; }
 156   static bool shared_string_mapped()       { return _shared_string_mapped; }
 157   static void shared_oops_do(OopClosure* f) NOT_CDS_JAVA_HEAP_RETURN;
 158   static void copy_shared_string(CompactStringTableWriter* ch_table)
 159     NOT_CDS_JAVA_HEAP_RETURN;
 160   static void write_to_archive() NOT_CDS_JAVA_HEAP_RETURN;

 161   static void serialize(SerializeClosure* soc) NOT_CDS_JAVA_HEAP_RETURN;
 162 
 163   // Jcmd
 164   static void dump(outputStream* st, bool verbose=false);
 165   // Debugging
 166   static void verify();



 167 };
 168 
 169 #endif // SHARE_VM_CLASSFILE_STRINGTABLE_HPP
< prev index next >