Class CollectionExtractionUtils


  • public class CollectionExtractionUtils
    extends java.lang.Object
    Utility class providing helpers simplifying the extraction of data from objects in the heap which represent collections
    Since:
    1.5
    • Constructor Detail

      • CollectionExtractionUtils

        public CollectionExtractionUtils()
    • Method Detail

      • findCollectionExtractor

        public static ICollectionExtractor findCollectionExtractor​(IObject collection)
                                                            throws SnapshotException
        Finds a proper ICollectionExtractor for the object passed as parameter
        Parameters:
        collection - An IObject representing a collection
        Returns:
        ICollectionExtractor an extractor object for the collection
        Throws:
        SnapshotException
      • findCollectionExtractor

        public static ICollectionExtractor findCollectionExtractor​(java.lang.String className)
                                                            throws SnapshotException
        Finds a proper ICollectionExtractor for the object passed as parameter
        Parameters:
        className - the name of a collection class
        Returns:
        ICollectionExtractor an extractor object for the collection
        Throws:
        SnapshotException
      • extractCollection

        public static AbstractExtractedCollection<?,​?> extractCollection​(IObject collection)
                                                                        throws SnapshotException
        Extracts from the heap the content of objects which represent a collection. The proper extractor is determined internally
        Parameters:
        collection - an IObject representing a collection for which to extract the contents
        Returns:
        AbstractExtractedCollection the extracted contents
        Throws:
        SnapshotException
      • extractCollection

        public static AbstractExtractedCollection<?,​?> extractCollection​(IObject collection,
                                                                               java.lang.String specificClass,
                                                                               ICollectionExtractor preferredExtractor)
                                                                        throws SnapshotException
        Extracts from the heap the content of objects which represent a collection. For objects of class specifiedClass the preferredExtractor will be used, otherwise the extractor is selected internally
        Parameters:
        collection - an IObject representing a collection for which to extract the contents
        specificClass - a class name for which the preferred extractor should be used
        preferredExtractor - an extractor object to be used to extract the contents
        Returns:
        the extracted contents
        Throws:
        SnapshotException
      • extractList

        public static ExtractedCollection extractList​(IObject collection)
                                               throws SnapshotException
        Extracts from the heap the content of objects which represent a collection. The proper extractor is determined internally
        Parameters:
        collection - an IObject representing a List for which to extract the contents
        Returns:
        ExtractedCollection the extracted contents
        Throws:
        SnapshotException
      • extractMap

        public static ExtractedMap extractMap​(IObject collection)
                                       throws SnapshotException
        Extracts from the heap the content of objects which represent a Map. The proper extractor is determined internally
        Parameters:
        collection - an IObject representing a Map for which to extract the contents
        Returns:
        ExtractedMap the extracted contents
        Throws:
        SnapshotException
      • extractMap

        public static ExtractedMap extractMap​(IObject collection,
                                              java.lang.String specificClass,
                                              IMapExtractor preferredExtractor)
                                       throws SnapshotException
        Extracts from the heap the content of objects which represent a Map. For objects of class specifiedClass the preferredExtractor will be used, otherwise the extractor is selected internally
        Parameters:
        collection - an IObject representing a Map for which to extract the contents
        specificClass - a class name for which the preferred extractor should be used
        preferredExtractor - an extractor object to be used to extract the contents
        Returns:
        ExtractedMap the extracted contents
        Throws:
        SnapshotException