FileDocCategorySizeDatePackage
MethodDescriptor.javaAPI DocAndroid 1.5 API10774Wed May 06 22:41:16 BST 2009com.vladium.emma.data

MethodDescriptor

public final class MethodDescriptor extends Object implements com.vladium.util.IConstants, Serializable, IMetadataConstants
author
Vlad Roubtsov, (C) 2003

Fields Summary
private final String
m_name
private final String
m_descriptor
private final int
m_status
private final int[]
m_blockSizes
private final int[]
m_blockMap
private final int
m_firstLine
private com.vladium.util.IntObjectMap
m_lineMap
Constructors Summary
public MethodDescriptor(String name, String descriptor, int status, int[] blockSizes, int[] blockMap, int firstLine)

        if (name == null)
            throw new IllegalArgumentException ("null input: name");
        if (descriptor == null)
            throw new IllegalArgumentException ("null input: descriptor");
        
        if ((status & METHOD_NO_BLOCK_DATA) == 0)
        {
            // block metadata is available: blockCount must be positive
            
            final int blockCount = blockSizes.length;
            
            if ($assert.ENABLED) $assert.ASSERT (blockCount > 0, "blockCount must be positive: " + blockCount);
            m_blockSizes = blockSizes;
            
            if ((status & METHOD_NO_LINE_DATA) == 0)
            {
                // line metadata is available: blockMap must not be null or empty
                
                if ($assert.ENABLED) $assert.ASSERT (firstLine > 0, "firstLine must be positive: " + firstLine);
                
                if ((blockMap == null) || (blockMap.length == 0))
                    throw new IllegalArgumentException ("null or empty input: blockMap");
            
                if ($assert.ENABLED)
                {
                    $assert.ASSERT (blockCount == blockMap.length, "blockCount " + blockCount + " != blockMap.length " + blockMap.length);
                    
                    for (int i = 0; i < blockMap.length; ++ i)
                    {
                        $assert.ASSERT (blockMap [i] != null, "blockMap[" + i + "] is null");
                        // note: it is legal for blockMap [i] to be empty
                    }
                }
                
                m_blockMap = blockMap;
                m_firstLine = firstLine;
            }
            else
            {
                m_blockMap = null;
                m_firstLine = 0;
            }
        }
        else
        {
            m_blockSizes = null;
            m_blockMap = null;
            m_firstLine = 0;
        }
        
        m_name = name;
        m_descriptor = descriptor;
        m_status = status;
    
Methods Summary
public intgetBlockCount()

        return m_blockSizes.length;
    
public int[][]getBlockMap()

        return m_blockMap;
    
public int[]getBlockSizes()

        return m_blockSizes;
    
public java.lang.StringgetDescriptor()

        return m_descriptor;
    
public intgetFirstLine()

        return m_firstLine;
    
public com.vladium.util.IntObjectMapgetLineMap()

        IntObjectMap lineMap = m_lineMap;
        if (lineMap != null)
            return lineMap;
        else if ((m_status & METHOD_NO_LINE_DATA) == 0)
        {
            // construct reverse line->block ID mapping:
            
            lineMap = new IntObjectMap ();
            final int [][] blockMap = m_blockMap;
            
            for (int bl = 0, blCount = blockMap.length; bl < blCount; ++ bl)
            {
                final int [] lines = blockMap [bl];
                if (lines != null)
                {
                    final int lineCount = lines.length;
                    
                    for (int l = 0; l < lineCount; ++ l)
                    {
                        final int line = lines [l];
                        IntSet blockIDs = (IntSet) lineMap.get (line);
                        
                        if (blockIDs == null)
                        {
                            blockIDs = new IntSet ();
                            lineMap.put (line, blockIDs);
                        }
                        
                        blockIDs.add (bl);
                    }
                }
            }
            
            final int [] lines = lineMap.keys ();
            for (int l = 0, lineCount = lines.length; l < lineCount; ++ l)
            {
                final int line = lines [l];
                final int [] blockIDs = ((IntSet) lineMap.get (line)).values ();
                if ($assert.ENABLED) $assert.ASSERT (blockIDs != null && blockIDs.length > 0, "wrong line mapping for line #" + line);
                
                lineMap.put (line, blockIDs); // overwrite IntSet as the value
            }
            
            m_lineMap = lineMap;
            
            return lineMap;
        }
        
        return null;
    
public java.lang.StringgetName()

        return m_name;
    
public intgetStatus()

        return m_status;
    
public booleanhasLineNumberInfo()

        return (m_status & METHOD_NO_LINE_DATA) == 0;
    
static com.vladium.emma.data.MethodDescriptorreadExternal(java.io.DataInput in)

        final String name = in.readUTF ();
        final String descriptor = in.readUTF ();
        
        final int status = in.readInt ();
        
        int [] blockSizes = null;
        int [][] blockMap = null;
        int firstLine = 0;
        
        if ((status & METHOD_NO_BLOCK_DATA) == 0)
        {
            // blockSizes must be set:
            
            blockSizes = DataFactory.readIntArray (in);
            
            if ((status & METHOD_NO_LINE_DATA) == 0)
            {
                // blockMap, lineMap, firstLine must be set:
                
                final int length = in.readInt ();
                blockMap = new int [length][];
                
                for (int i = 0; i < length; ++ i) 
                {
                    blockMap [i] = DataFactory.readIntArray (in);
                }
                
                firstLine = in.readInt ();
                
                // [lineMap is transient data]
            }
        }
        
        return new MethodDescriptor (name, descriptor, status, blockSizes, blockMap, firstLine);
    
public java.lang.StringtoString()

        return toString ("");
    
public java.lang.StringtoString(java.lang.String indent)

        StringBuffer s = new StringBuffer (indent + "method [" + m_name + "] descriptor:");
        
        if ((m_status & METHOD_NO_LINE_DATA) == 0)
        {
            for (int bl = 0; bl < m_blockMap.length; ++ bl)
            {
                s.append (EOL);
                s.append (indent + INDENT_INCREMENT + "block " + bl + " (" + m_blockSizes [bl] + " instrs) : ");
                
                final int [] lines = m_blockMap [bl];
                for (int l = 0; l < lines.length; ++ l)
                {
                    if (l != 0) s.append (", ");
                    s.append (lines [l]);
                }
            }
            s.append (EOL);
            s.append (indent + INDENT_INCREMENT + "---");
            
            final int [] lines = m_lineMap.keys ();
            for (int l = 0; l < lines.length; ++ l)
            {
                s.append (EOL);
                s.append (indent + INDENT_INCREMENT + "line " + lines [l] + ": ");
                
                final int [] blocks = (int []) m_lineMap.get (lines [l]);
                for (int bl = 0; bl < blocks.length; ++ bl)
                {
                    if (bl != 0) s.append (", ");
                    s.append (blocks [bl]);
                }
            }
        }
        else
        {
            s.append (" <no line info>");
        }
        
        return s.toString ();
    
static voidwriteExternal(com.vladium.emma.data.MethodDescriptor method, java.io.DataOutput out)

        out.writeUTF (method.m_name);
        out.writeUTF (method.m_descriptor);
        
        final int status = method.m_status;
        out.writeInt (status);
        
        if ((status & METHOD_NO_BLOCK_DATA) == 0)
        {
            // blockSizes must be set:
            
            DataFactory.writeIntArray (method.m_blockSizes, out);
            
            if ((status & METHOD_NO_LINE_DATA) == 0)
            {
                // blockMap, lineMap, firstLine must be set:
                
                final int [][] blockMap = method.m_blockMap;
                final int length = blockMap.length;
                out.writeInt (length);

                for (int i = 0; i < length; ++ i) 
                {
                    DataFactory.writeIntArray (blockMap [i], out);
                }
                
                out.writeInt (method.m_firstLine);
                
                // [lineMap is transient data]
            }
        }