KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > jbet > CPInterface


1 /*
2  * JBET - Java Binary Enhancement Tool
3  * Copyright (c) 2003 Networks Associates Technology, Inc.
4  *
5  * This software was developed under DARPA/SPAWAR contract
6  * N66001-00-C-8602 "SPMA" as part of the
7  * DARPA OASIS research program.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  * 1. Redistributions of source code must retain the above copyright
13  * notice, this list of conditions and the following disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  * notice, this list of conditions and the following disclaimer in the
16  * documentation and/or other materials provided with the distribution.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
19  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
22  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28  * SUCH DAMAGE.
29  */
30
31 package jbet;
32 import java.io.*;
33 import java.util.*;
34
35 /**
36  * The public interface of the ConstantPool.
37  *
38  * $Id: CPInterface.java,v 1.7 2003/09/09 17:31:53 areisse Exp $
39  *
40  * @author Larry D'Anna
41  * @author Lee Badger
42  * @version 0.1
43  * @since JDK 1.1.8
44  */
45 abstract class CPInterface {
46     static final String JavaDoc [] mnemonic = { "", "Utf8", "", "Integer", "Float",
47                     "Long", "Double", "Class", "String",
48                     "Fieldref", "Methodref",
49                     "InterfaceMethodref", "NameAndType" };
50     final static int CONSTANT_Utf8 = 1;
51     final static int CONSTANT_Integer = 3;
52     final static int CONSTANT_Float = 4;
53     final static int CONSTANT_Long = 5;
54     final static int CONSTANT_Double = 6;
55     final static int CONSTANT_Class = 7;
56     final static int CONSTANT_String = 8;
57     final static int CONSTANT_Fieldref = 9;
58     final static int CONSTANT_Methodref = 10;
59     final static int CONSTANT_InterfaceMethodref = 11;
60     final static int CONSTANT_NameAndType = 12;
61
62     /* Miscellaneous functions. */
63     abstract void printout (LineWriter out);
64     abstract int tagAt (int i);
65     abstract int poolCount();
66     abstract CpEntry elementAt (int i);
67
68     /**
69      * Each of the following functions finds a record, of a specific
70      * type at a specified index in the ConstantPool. If a record of
71      * the expected type is not present in the ConstantPool at the
72      * specified index, the ClassFileException is thrown.
73      */
74     abstract int integerAt (int index) throws ClassFileException ;
75     abstract float floatAt (int index) throws ClassFileException ;
76     abstract long longAt (int index) throws ClassFileException ;
77     abstract double doubleAt (int index) throws ClassFileException ;
78     abstract String JavaDoc utf8At (int index) throws ClassFileException ;
79     abstract String JavaDoc stringAt (int index) throws ClassFileException ;
80     abstract CpNameAndType cpNameAndTypeAt (int index) throws ClassFileException;
81     abstract CpInteger cpIntegerAt (int index) throws ClassFileException ;
82     abstract CpFloat cpFloatAt (int index) throws ClassFileException ;
83     abstract CpLong cpLongAt (int index) throws ClassFileException ;
84     abstract CpDouble cpDoubleAt (int index) throws ClassFileException ;
85     abstract CpUtf8 cpUtf8At (int index) throws ClassFileException ;
86     abstract CpClass cpClassAt (int index) throws ClassFileException ;
87     abstract CpString cpStringAt (int index) throws ClassFileException ;
88     abstract CpMethodRef cpMethodRefAt (int index) throws ClassFileException ;
89     abstract CpFieldRef cpFieldRefAt (int index) throws ClassFileException ;
90
91     /**
92      * Each of the following functions finds a record, of a specific
93      * type and having a specific value, in the ConstantPool, if it
94      * exists in the ConstantPool. If the requested record does not
95      * exist, these functions create the record and then return a
96      * reference to it.
97      */
98     abstract int internUtf8 (String JavaDoc s) ;
99     abstract int internClass (String JavaDoc s) ;
100     abstract int internString (String JavaDoc s) ;
101     abstract int internMethodRef (String JavaDoc cname, String JavaDoc mname,
102                       Descriptor type) ;
103     abstract int internFieldRef (String JavaDoc cname, String JavaDoc mname,
104                     Type type) ;
105     abstract int internInterfaceMethodRef (String JavaDoc cname, String JavaDoc mname,
106                            Descriptor type);
107     abstract int internInteger (int i) ;
108     abstract int internFloat (float i) ;
109     abstract int internLong (long i) ;
110     abstract int internDouble (double i) ;
111
112 }
113
Popular Tags