Class SegmentConstantPool
- java.lang.Object
-
- org.apache.commons.compress.harmony.unpack200.SegmentConstantPool
-
public class SegmentConstantPool extends java.lang.Object
SegmentConstantPool manages the constant pool used for re-creating class files.
-
-
Field Summary
Fields Modifier and Type Field Description static int
ALL
static int
CP_CLASS
static int
CP_DESCR
static int
CP_DOUBLE
static int
CP_FIELD
static int
CP_FLOAT
static int
CP_IMETHOD
static int
CP_INT
static int
CP_LONG
static int
CP_METHOD
static int
CP_STRING
protected static java.lang.String
INITSTRING
protected static java.lang.String
REGEX_MATCH_ALL
protected static java.lang.String
REGEX_MATCH_INIT
static int
SIGNATURE
static int
UTF_8
-
Constructor Summary
Constructors Constructor Description SegmentConstantPool(CpBands bands)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description ConstantPoolEntry
getClassPoolEntry(java.lang.String name)
Given the name of a class, answer the CPClass associated with that class.ConstantPoolEntry
getClassSpecificPoolEntry(int cp, long desiredIndex, java.lang.String desiredClassName)
Subset the constant pool of the specified type to be just that which has the specified class name.ConstantPoolEntry
getConstantPoolEntry(int cp, long value)
ConstantPoolEntry
getInitMethodPoolEntry(int cp, long value, java.lang.String desiredClassName)
Answer the init method for the specified class.ClassFileEntry
getValue(int cp, long value)
protected int
matchSpecificPoolEntryIndex(java.lang.String[] primaryArray, java.lang.String[] secondaryArray, java.lang.String primaryCompareString, java.lang.String secondaryCompareRegex, int desiredIndex)
This method's function is to look through pairs of arrays.protected int
matchSpecificPoolEntryIndex(java.lang.String[] nameArray, java.lang.String compareString, int desiredIndex)
A number of things make use of subsets of structures.protected static boolean
regexMatches(java.lang.String regexString, java.lang.String compareString)
We don't want a dependency on regex in Pack200.
-
-
-
Field Detail
-
ALL
public static final int ALL
- See Also:
- Constant Field Values
-
UTF_8
public static final int UTF_8
- See Also:
- Constant Field Values
-
CP_INT
public static final int CP_INT
- See Also:
- Constant Field Values
-
CP_FLOAT
public static final int CP_FLOAT
- See Also:
- Constant Field Values
-
CP_LONG
public static final int CP_LONG
- See Also:
- Constant Field Values
-
CP_DOUBLE
public static final int CP_DOUBLE
- See Also:
- Constant Field Values
-
CP_STRING
public static final int CP_STRING
- See Also:
- Constant Field Values
-
CP_CLASS
public static final int CP_CLASS
- See Also:
- Constant Field Values
-
SIGNATURE
public static final int SIGNATURE
- See Also:
- Constant Field Values
-
CP_DESCR
public static final int CP_DESCR
- See Also:
- Constant Field Values
-
CP_FIELD
public static final int CP_FIELD
- See Also:
- Constant Field Values
-
CP_METHOD
public static final int CP_METHOD
- See Also:
- Constant Field Values
-
CP_IMETHOD
public static final int CP_IMETHOD
- See Also:
- Constant Field Values
-
REGEX_MATCH_ALL
protected static final java.lang.String REGEX_MATCH_ALL
- See Also:
- Constant Field Values
-
INITSTRING
protected static final java.lang.String INITSTRING
- See Also:
- Constant Field Values
-
REGEX_MATCH_INIT
protected static final java.lang.String REGEX_MATCH_INIT
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
SegmentConstantPool
public SegmentConstantPool(CpBands bands)
- Parameters:
bands
- TODO
-
-
Method Detail
-
getValue
public ClassFileEntry getValue(int cp, long value) throws Pack200Exception
- Throws:
Pack200Exception
-
getClassSpecificPoolEntry
public ConstantPoolEntry getClassSpecificPoolEntry(int cp, long desiredIndex, java.lang.String desiredClassName) throws Pack200Exception
Subset the constant pool of the specified type to be just that which has the specified class name. Answer the ConstantPoolEntry at the desiredIndex of the subsetted pool.- Parameters:
cp
- type of constant pool array to searchdesiredIndex
- index of the constant pooldesiredClassName
- class to use to generate a subset of the pool- Returns:
- ConstantPoolEntry
- Throws:
Pack200Exception
- TODO
-
getClassPoolEntry
public ConstantPoolEntry getClassPoolEntry(java.lang.String name)
Given the name of a class, answer the CPClass associated with that class. Answer null if the class doesn't exist.- Parameters:
name
- Class name to look for (form: java/lang/Object)- Returns:
- CPClass for that class name, or null if not found.
-
getInitMethodPoolEntry
public ConstantPoolEntry getInitMethodPoolEntry(int cp, long value, java.lang.String desiredClassName) throws Pack200Exception
Answer the init method for the specified class.- Parameters:
cp
- constant pool to search (must be CP_METHOD)value
- index of init methoddesiredClassName
- String class name of the init method- Returns:
- CPMethod init method
- Throws:
Pack200Exception
- TODO
-
matchSpecificPoolEntryIndex
protected int matchSpecificPoolEntryIndex(java.lang.String[] nameArray, java.lang.String compareString, int desiredIndex)
A number of things make use of subsets of structures. In one particular example, _super bytecodes will use a subset of method or field classes which have just those methods / fields defined in the superclass. Similarly, _this bytecodes use just those methods/fields defined in this class, and _init bytecodes use just those methods that start with<init>
. This method takes an array of names, a String to match for, an index and a boolean as parameters, and answers the array position in the array of the indexth element which matches (or equals) the String (depending on the state of the boolean) In other words, if the class array consists of: Object [position 0, 0th instance of Object] String [position 1, 0th instance of String] String [position 2, 1st instance of String] Object [position 3, 1st instance of Object] Object [position 4, 2nd instance of Object] then matchSpecificPoolEntryIndex(..., "Object", 2, false) will answer 4. matchSpecificPoolEntryIndex(..., "String", 0, false) will answer 1.- Parameters:
nameArray
- Array of Strings against which the compareString is testedcompareString
- String for which to searchdesiredIndex
- nth element with that match (counting from 0)- Returns:
- int index into nameArray, or -1 if not found.
-
matchSpecificPoolEntryIndex
protected int matchSpecificPoolEntryIndex(java.lang.String[] primaryArray, java.lang.String[] secondaryArray, java.lang.String primaryCompareString, java.lang.String secondaryCompareRegex, int desiredIndex)
This method's function is to look through pairs of arrays. It keeps track of the number of hits it finds using the following basis of comparison for a hit: - the primaryArray[index] must be .equals() to the primaryCompareString - the secondaryArray[index] .matches() the secondaryCompareString. When the desiredIndex number of hits has been reached, the index into the original two arrays of the element hit is returned.- Parameters:
primaryArray
- The first array to searchsecondaryArray
- The second array (must be same .length as primaryArray)primaryCompareString
- The String to compare against primaryArray using .equals()secondaryCompareRegex
- The String to compare against secondaryArray using .matches()desiredIndex
- The nth hit whose position we're seeking- Returns:
- int index that represents the position of the nth hit in primaryArray and secondaryArray
-
regexMatches
protected static boolean regexMatches(java.lang.String regexString, java.lang.String compareString)
We don't want a dependency on regex in Pack200. The only place one exists is in matchSpecificPoolEntryIndex(). To eliminate this dependency, we've implemented the world's stupidest regexMatch. It knows about the two forms we care about: .* (aka REGEX_MATCH_ALL)^<init>;.*
(aka REGEX_MATCH_INIT) and will answer correctly if those are passed as the regexString.- Parameters:
regexString
- String against which the compareString will be matchedcompareString
- String to match against the regexString- Returns:
- boolean true if the compareString matches the regexString; otherwise false.
-
getConstantPoolEntry
public ConstantPoolEntry getConstantPoolEntry(int cp, long value) throws Pack200Exception
- Throws:
Pack200Exception
-
-