com.ibm.dtfj.java
Interface JavaRuntime
All Superinterfaces:
- public interface JavaRuntime
- extends ManagedRuntime
Method Summary
Modifier and Type | Method and Description |
---|---|
|
equals(java.lang.Object obj)
|
|
getCompiledMethods()
This is short cut method.
|
|
getHeapRoots()
Get the set of object and class roots known to the VM.
|
|
getHeaps()
Get the set of heaps known by the VM
|
|
getJavaClassLoaders()
Get the set of class loaders active in this VM
|
getJavaVM()
Get the object that represents the virtual machine
|
|
getJavaVMInitArgs()
Fetch the JavaVMInitArgs which were used to create this VM.
|
|
|
getMemoryCategories()
Returns iterator of the top-level memory categories used by this
Java runtime.
|
|
getMemorySections(boolean includeFreed)
Returns an iterator of JavaRuntimeMemorySection objects corresponding to the blocks of memory allocated by the JavaRuntime.
|
|
getMonitors()
Provides access to the collection of monitors used in the JavaVM.
|
getObjectAtAddress(ImagePointer address)
Gets the object located at address
address in the heap.
|
|
|
getThreads()
Get the set of Java threads known by the VM
|
|
getTraceBuffer(java.lang.String bufferName,boolean formatted)
Fetches implementation specific trace buffers, like the verbose GC buffer
or the Universal Trace Engine (UTE) buffer
|
|
hashCode()
|
Methods inherited from interface com.ibm.dtfj.runtime.ManagedRuntime |
---|
getFullVersion, getVersion |
Method Detail
getJavaVM
- ImagePointer getJavaVM()
- throws CorruptDataException
Get the object that represents the virtual machine
Returns:
the address of the JavaVM structure which represents this JVM instance in JNI
Throws:
getJavaVMInitArgs
- JavaVMInitArgs getJavaVMInitArgs( )
- throws DataUnavailable
- CorruptDataException
Fetch the JavaVMInitArgs which were used to create this VM.
See JNI_CreateJavaVM in the JNI Specification for more details.
Returns:
the JavaVMInitArgs which were used to create this VM.
Throws:
DataUnavailable
- if the arguments are not available getJavaClassLoaders
- java.util.Iterator getJavaClassLoaders( )
Get the set of class loaders active in this VM
Returns:
an iterator of all of the class loaders within this JavaVM
See Also:
getThreads
- java.util.Iterator getThreads()
Get the set of Java threads known by the VM
getCompiledMethods
- java.util.Iterator getCompiledMethods( )
This is short cut method. The same result can be found by iterating over all
methods in all class loaders in all classes.
Returns:
an iterator over all of the JavaMethods in the JavaRuntime which
have been compiled
See Also:
getMonitors
- java.util.Iterator getMonitors( )
Provides access to the collection of monitors used in the JavaVM. This
collection includes both monitors associated with managed objects (e.g. object
monitors) and monitors associated with internal control structures (e.g.
raw monitors)
getHeaps
- java.util.Iterator getHeaps()
Get the set of heaps known by the VM
Returns:
an iterator for all of the Java heaps within this runtime. Heaps
may be specific to this JavaVM instance, or may be shared between multiple
JavaVM instances
See Also:
getHeapRoots
- java.util.Iterator getHeapRoots( )
Get the set of object and class roots known to the VM.
Stack frame roots are not included in the set, they can be retrieved using JavaStackFrame.getHeapRoots().
Returns:
an iterator over the collection of JavaReferences representing the known global heap roots within this runtime.
See Also:
getTraceBuffer
- java.lang.Object getTraceBuffer( java.lang.String bufferName,
- boolean formatted)
- throws CorruptDataException
Fetches implementation specific trace buffers, like the verbose GC buffer
or the Universal Trace Engine (UTE) buffer
Parameters:
bufferName
- a String naming the buffer to be fetched formatted
- true if formatting should be performed on the buffer, or
false if the raw buffer contents should be returned Returns:
an implementation specific result, depending on the parameters
Throws:
getObjectAtAddress
- JavaObject getObjectAtAddress(ImagePointer address)
- throws CorruptDataException
- java.lang.IllegalArgumentException
- MemoryAccessException
- DataUnavailable
Gets the object located at address
address
in the heap.
Parameters:
address
- the ImagePointer
instance representing the start address of object in the heap; Returns:
the
JavaObject
instance representing the located object. Throws:
java.lang.IllegalArgumentException
- if address
is outside the heap's boundaries, or if it doesn't point to the start location of an object; MemoryAccessException
- if address
is is in the heap but it's not accessible from the dump; CorruptDataException
- if any data needed to build the returned instance of JavaObject
is corrupt. DataUnavailable
- if any data needed to build the returned instance of JavaObject
is not available. See Also:
getMemoryCategories
- java.util.Iterator getMemoryCategories( )
- throws DataUnavailable
Returns iterator of the top-level memory categories used by this
Java runtime.
getMemorySections
- java.util.Iterator getMemorySections( boolean includeFreed)
- throws DataUnavailable
Returns an iterator of JavaRuntimeMemorySection objects corresponding to the blocks of memory allocated by the JavaRuntime.
Parameters:
includeFreed
- If true, iterator will iterate over blocks of memory that have been freed, but haven't been re-used yet. Returns:
Iterator of memory sections.
Throws:
Since:
1.5
See Also:
equals
- boolean equals(java.lang.Object obj)
Overrides:
equals
in class java.lang.Object
Parameters:
obj
- Returns:
True if the given object refers to the same Java Runtime in the image
hashCode
- int hashCode()
Overrides:
hashCode
in class java.lang.Object