/*

 * Copyright (c) 2012, 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.

 *

 */

// A ClassLoaderData identifies the full set of class types that a class

// loader's name resolution strategy produces for a given configuration of the

// class loader.

// Class types in the ClassLoaderData may be defined by from class file binaries

// provided by the class loader, or from other class loader it interacts with

// according to its name resolution strategy.

//

// Class loaders that implement a deterministic name resolution strategy

// (including with respect to their delegation behavior), such as the boot, the

// extension, and the system loaders of the JDK's built-in class loader

// hierarchy, always produce the same linkset for a given configuration.

//

// ClassLoaderData carries information related to a linkset (e.g.,

// metaspace holding its klass definitions).

// The System Dictionary and related data structures (e.g., placeholder table,

// loader constraints table) as well as the runtime representation of classes

// only reference ClassLoaderData.

//

// Instances of java.lang.ClassLoader holds a pointer to a ClassLoaderData that

// that represent the loader's "linking domain" in the JVM.

//

// The bootstrap loader (represented by NULL) also has a ClassLoaderData,

// the singleton class the_null_class_loader_data().

#include "precompiled.hpp"

#include "classfile/classLoaderData.hpp"

#include "classfile/classLoaderData.inline.hpp"

#include "classfile/javaClasses.hpp"

#include "classfile/systemDictionary.hpp"

#include "code/codeCache.hpp"

#include "memory/metadataFactory.hpp"

#include "memory/metaspaceShared.hpp"

#include "prims/jvmtiRedefineClasses.hpp"

#include "runtime/jniHandles.hpp"

#include "runtime/mutex.hpp"

#include "runtime/safepoint.hpp"

#include "runtime/synchronizer.hpp"

#include "utilities/growableArray.hpp"

#include "utilities/ostream.hpp"

ClassLoaderData * ClassLoaderData::_the_null_class_loader_data = NULL;

ClassLoaderData::ClassLoaderData(Handle h_class_loader) : _class_loader(h_class_loader()),

  _metaspace_lock(new Mutex(Monitor::leaf+1, "Metaspace allocation lock", true)) {

    // empty

}

bool ClassLoaderData::claim() {

  if (_claimed == 1) {

    return false;

  }

  return (int) Atomic::cmpxchg(1, &_claimed, 0) == 0;

}

void ClassLoaderData::oops_do(OopClosure* f, KlassClosure* klass_closure, bool must_claim) {

  if (must_claim && !claim()) {

    return;

  }

  f->do_oop(&_class_loader);

  _handles->oops_do(f);

  if (klass_closure != NULL) {

    classes_do(klass_closure);

  }

}

void ClassLoaderData::classes_do(KlassClosure* klass_closure) {

  for (Klass* k = _klasses; k != NULL; k = k->next_link()) {

    klass_closure->do_klass(k);

  }

}

void ClassLoaderData::classes_do(void f(InstanceKlass*)) {

  for (Klass* k = _klasses; k != NULL; k = k->next_link()) {

    if (k->oop_is_instance()) {

      f(InstanceKlass::cast(k));

    }

  }

}

void ClassLoaderData::record_dependency(Klass* k, TRAPS) {

  ClassLoaderData * const from_cld = this;

  ClassLoaderData * const to_cld = k->class_loader_data();

    return;

  }

    }

  }

  // It's a dependency we won't find through GC, add it. This is relatively rare

}

  while (ok != NULL) {

    }

    ok = (objArrayOop)ok->obj_at(1);

  }

}

    }

  }

}

void ClassLoaderDataGraph::clear_claimed_marks() {

  for (ClassLoaderData* cld = _head; cld != NULL; cld = cld->next()) {

    cld->clear_claimed();

  }

}

void ClassLoaderData::add_class(Klass* k) {

  MutexLockerEx ml(metaspace_lock(),  Mutex::_no_safepoint_check_flag);

  Klass* old_value = _klasses;

  k->set_next_link(old_value);

  // link the new item into the list

  _klasses = k;

    ResourceMark rm;

    tty->print_cr("[TraceClassLoaderData] Adding k: " PTR_FORMAT " %s to CLD: "

                  PTR_FORMAT " loader: " PTR_FORMAT " %s",

                  k,

                  k->external_name(),

                  k->class_loader_data(),

                  k->class_loader(),

  }

}

// This is called by InstanceKlass::deallocate_contents() to remove the

// scratch_class for redefine classes.  We need a lock because there it may not

// be called at a safepoint if there's an error.

void ClassLoaderData::remove_class(Klass* scratch_class) {

  MutexLockerEx ml(metaspace_lock(),  Mutex::_no_safepoint_check_flag);

  Klass* prev = NULL;

  for (Klass* k = _klasses; k != NULL; k = k->next_link()) {

    if (k == scratch_class) {

      if (prev == NULL) {

        _klasses = k->next_link();

      } else {

        Klass* next = k->next_link();

        prev->set_next_link(next);

      }

      return;

    }

    prev = k;

  }

  ShouldNotReachHere();   // should have found this class!!

}

ClassLoaderData::~ClassLoaderData() {

  Metaspace *m = _metaspace;

  if (m != NULL) {

    _metaspace = NULL;

    // release the metaspace

    delete m;

    // release the handles

    if (_handles != NULL) {

      JNIHandleBlock::release_block(_handles);

      _handles = NULL;

    }

  }

  // Clear all the JNI handles for methods

  // These aren't deallocated and are going to look like a leak, but that's

  // needed because we can't really get rid of jmethodIDs because we don't

  // know when native code is going to stop using them.  The spec says that

  // they're "invalid" but existing programs likely rely on their being

  // NULL after class unloading.

  if (_jmethod_ids != NULL) {

    Method::clear_jmethod_ids(this);

  }

  // Delete lock

  delete _metaspace_lock;

  // Delete free list

  if (_deallocate_list != NULL) {

    delete _deallocate_list;

  }

}

Metaspace* ClassLoaderData::metaspace_non_null() {

  // If the metaspace has not been allocated, create a new one.  Might want

  // to create smaller arena for Reflection class loaders also.

  // The reason for the delayed allocation is because some class loaders are

  // simply for delegating with no metadata of their own.

  if (_metaspace == NULL) {

    MutexLockerEx ml(metaspace_lock(),  Mutex::_no_safepoint_check_flag);

    // Check again if metaspace has been allocated while we were getting this lock.

    if (_metaspace != NULL) {

      return _metaspace;

    }

      size_t word_size = Metaspace::first_chunk_word_size();

      set_metaspace(new Metaspace(_metaspace_lock, word_size));

    } else {

      set_metaspace(new Metaspace(_metaspace_lock));  // default size for now.

    }

  }

  return _metaspace;

}

JNIHandleBlock* ClassLoaderData::handles() const           { return _handles; }

void ClassLoaderData::set_handles(JNIHandleBlock* handles) { _handles = handles; }

jobject ClassLoaderData::add_handle(Handle h) {

  MutexLockerEx ml(metaspace_lock(),  Mutex::_no_safepoint_check_flag);

  if (handles() == NULL) {

    set_handles(JNIHandleBlock::allocate_block());

  }

  return handles()->allocate_handle(h());

}

// Add this metadata pointer to be freed when it's safe.  This is only during

// class unloading because Handles might point to this metadata field.

void ClassLoaderData::add_to_deallocate_list(Metadata* m) {

  // Metadata in shared region isn't deleted.

  if (!m->is_shared()) {

    MutexLockerEx ml(metaspace_lock(),  Mutex::_no_safepoint_check_flag);

    if (_deallocate_list == NULL) {

      _deallocate_list = new (ResourceObj::C_HEAP, mtClass) GrowableArray<Metadata*>(100, true);

    }

    _deallocate_list->append_if_missing(m);

  }

}

// Deallocate free metadata on the free list.  How useful the PermGen was!

void ClassLoaderData::free_deallocate_list() {

  // Don't need lock, at safepoint

  assert(SafepointSynchronize::is_at_safepoint(), "only called at safepoint");

  if (_deallocate_list == NULL) {

    return;

  }

  // Go backwards because this removes entries that are freed.

  for (int i = _deallocate_list->length() - 1; i >= 0; i--) {

    Metadata* m = _deallocate_list->at(i);

    if (!m->on_stack()) {

      _deallocate_list->remove_at(i);

      // There are only three types of metadata that we deallocate directly.

      // Cast them so they can be used by the template function.

      if (m->is_method()) {

        MetadataFactory::free_metadata(this, (Method*)m);

      } else if (m->is_constantPool()) {

        MetadataFactory::free_metadata(this, (ConstantPool*)m);

      } else if (m->is_klass()) {

        MetadataFactory::free_metadata(this, (InstanceKlass*)m);

      } else {

        ShouldNotReachHere();

      }

    }

  }

}

}

// Define to dump klasses

#undef CLD_DUMP_KLASSES

void ClassLoaderData::dump(outputStream * const out) {

  ResourceMark rm;

  out->print("ClassLoaderData CLD: "PTR_FORMAT", loader: "PTR_FORMAT", loader_klass: "PTR_FORMAT" %s {",

      this, class_loader(),

  if (claimed()) out->print(" claimed ");

  if (is_unloading()) out->print(" unloading ");

  out->print(" handles " INTPTR_FORMAT, handles());

  out->cr();

  if (metaspace_or_null() != NULL) {

    out->print_cr("metaspace: " PTR_FORMAT, metaspace_or_null());

    metaspace_or_null()->dump(out);

  } else {

    out->print_cr("metaspace: NULL");

  }

#ifdef CLD_DUMP_KLASSES

  if (Verbose) {

    ResourceMark rm;

    Klass* k = _klasses;

    while (k != NULL) {

      out->print_cr("klass "PTR_FORMAT", %s, CT: %d, MUT: %d", k, k->name()->as_C_string(),

          k->has_modified_oops(), k->has_accumulated_modified_oops());

      k = k->next_link();

    }

  }

#endif  // CLD_DUMP_KLASSES

#undef CLD_DUMP_KLASSES

  if (_jmethod_ids != NULL) {

    Method::print_jmethod_ids(this, out);

  }

  out->print_cr("}");

}

#endif // PRODUCT

void ClassLoaderData::verify() {

  oop cl = class_loader();

  // Verify the integrity of the allocated space.

  if (metaspace_or_null() != NULL) {

    metaspace_or_null()->verify();

  }

  for (Klass* k = _klasses; k != NULL; k = k->next_link()) {

    guarantee(k->class_loader_data() == this, "Must be the same");

    k->verify();

  }

}

// GC root of class loader data created.

ClassLoaderData* ClassLoaderDataGraph::_head = NULL;

ClassLoaderData* ClassLoaderDataGraph::_unloading = NULL;

ClassLoaderData* ClassLoaderDataGraph::_saved_head = NULL;

// Add a new class loader data node to the list.  Assign the newly created

// ClassLoaderData into the java/lang/ClassLoader object as a hidden field

  // Not assigned a class loader data yet.

  // Create one.

  ClassLoaderData* *list_head = &_head;

  ClassLoaderData* next = _head;

  }

  // We won the race, and therefore the task of adding the data to the list of

  // class loader data

  do {

    cld->set_next(next);

    ClassLoaderData* exchanged = (ClassLoaderData*)Atomic::cmpxchg_ptr(cld, list_head, next);

    if (exchanged == next) {

      if (TraceClassLoaderData) {

        tty->print("[ClassLoaderData: ");

        tty->print("create class loader data "PTR_FORMAT, cld);

        tty->print_cr("]");

      }

      return cld;

    }

    next = exchanged;