/usr/share/doc/libserp-java/api/src-html/serp/bytecode/Attribute.html is in libserp-java-doc 1.15.1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en">
<head>
<title>Source code</title>
<link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
</head>
<body>
<div class="sourceContainer">
<pre><span class="sourceLineNo">001</span>package serp.bytecode;<a name="line.1"></a>
<span class="sourceLineNo">002</span><a name="line.2"></a>
<span class="sourceLineNo">003</span>import java.io.*;<a name="line.3"></a>
<span class="sourceLineNo">004</span>import java.lang.reflect.*;<a name="line.4"></a>
<span class="sourceLineNo">005</span>import java.util.*;<a name="line.5"></a>
<span class="sourceLineNo">006</span><a name="line.6"></a>
<span class="sourceLineNo">007</span>import serp.bytecode.lowlevel.*;<a name="line.7"></a>
<span class="sourceLineNo">008</span>import serp.bytecode.visitor.*;<a name="line.8"></a>
<span class="sourceLineNo">009</span>import serp.util.*;<a name="line.9"></a>
<span class="sourceLineNo">010</span><a name="line.10"></a>
<span class="sourceLineNo">011</span>/**<a name="line.11"></a>
<span class="sourceLineNo">012</span> * In bytecode attributes are used to represent anything that is not<a name="line.12"></a>
<span class="sourceLineNo">013</span> * part of the class structure. This includes the source file name, code of<a name="line.13"></a>
<span class="sourceLineNo">014</span> * methods, the line number table, etc. All attributes contain at a minimum<a name="line.14"></a>
<span class="sourceLineNo">015</span> * an immutable name that also determines the attribute's type.<a name="line.15"></a>
<span class="sourceLineNo">016</span> *<a name="line.16"></a>
<span class="sourceLineNo">017</span> * @author Abe White<a name="line.17"></a>
<span class="sourceLineNo">018</span> */<a name="line.18"></a>
<span class="sourceLineNo">019</span>public abstract class Attribute extends Attributes implements VisitAcceptor {<a name="line.19"></a>
<span class="sourceLineNo">020</span> private int _nameIndex = 0;<a name="line.20"></a>
<span class="sourceLineNo">021</span> private Attributes _owner = null;<a name="line.21"></a>
<span class="sourceLineNo">022</span><a name="line.22"></a>
<span class="sourceLineNo">023</span> Attribute(int nameIndex, Attributes owner) {<a name="line.23"></a>
<span class="sourceLineNo">024</span> _owner = owner;<a name="line.24"></a>
<span class="sourceLineNo">025</span> _nameIndex = nameIndex;<a name="line.25"></a>
<span class="sourceLineNo">026</span> }<a name="line.26"></a>
<span class="sourceLineNo">027</span><a name="line.27"></a>
<span class="sourceLineNo">028</span> /**<a name="line.28"></a>
<span class="sourceLineNo">029</span> * Create an attribute of the appropriate type based on the<a name="line.29"></a>
<span class="sourceLineNo">030</span> * the attribute name.<a name="line.30"></a>
<span class="sourceLineNo">031</span> */<a name="line.31"></a>
<span class="sourceLineNo">032</span> static Attribute create(String name, Attributes owner) {<a name="line.32"></a>
<span class="sourceLineNo">033</span> // special case for annotations<a name="line.33"></a>
<span class="sourceLineNo">034</span> int nameIndex = owner.getPool().findUTF8Entry(name, true);<a name="line.34"></a>
<span class="sourceLineNo">035</span> if ("RuntimeVisibleAnnotations".equals(name)<a name="line.35"></a>
<span class="sourceLineNo">036</span> || "RuntimeInvisibleAnnotations".equals(name))<a name="line.36"></a>
<span class="sourceLineNo">037</span> return new Annotations(nameIndex, owner);<a name="line.37"></a>
<span class="sourceLineNo">038</span><a name="line.38"></a>
<span class="sourceLineNo">039</span> try {<a name="line.39"></a>
<span class="sourceLineNo">040</span> Class type = Class.forName("serp.bytecode." + name);<a name="line.40"></a>
<span class="sourceLineNo">041</span> Constructor cons = type.getDeclaredConstructor(new Class[] {<a name="line.41"></a>
<span class="sourceLineNo">042</span> int.class, Attributes.class<a name="line.42"></a>
<span class="sourceLineNo">043</span> });<a name="line.43"></a>
<span class="sourceLineNo">044</span> return (Attribute) cons.newInstance(new Object[] {<a name="line.44"></a>
<span class="sourceLineNo">045</span> Numbers.valueOf(nameIndex), owner<a name="line.45"></a>
<span class="sourceLineNo">046</span> });<a name="line.46"></a>
<span class="sourceLineNo">047</span> } catch (Throwable t) {<a name="line.47"></a>
<span class="sourceLineNo">048</span> return new UnknownAttribute(nameIndex, owner);<a name="line.48"></a>
<span class="sourceLineNo">049</span> }<a name="line.49"></a>
<span class="sourceLineNo">050</span> }<a name="line.50"></a>
<span class="sourceLineNo">051</span><a name="line.51"></a>
<span class="sourceLineNo">052</span> /**<a name="line.52"></a>
<span class="sourceLineNo">053</span> * Return the {@link Attributes} that owns this attribute. The entity<a name="line.53"></a>
<span class="sourceLineNo">054</span> * might be a {@link BCClass}, {@link BCField}, {@link BCMethod}, or other<a name="line.54"></a>
<span class="sourceLineNo">055</span> * attribute.<a name="line.55"></a>
<span class="sourceLineNo">056</span> */<a name="line.56"></a>
<span class="sourceLineNo">057</span> public Attributes getOwner() {<a name="line.57"></a>
<span class="sourceLineNo">058</span> return _owner;<a name="line.58"></a>
<span class="sourceLineNo">059</span> }<a name="line.59"></a>
<span class="sourceLineNo">060</span><a name="line.60"></a>
<span class="sourceLineNo">061</span> /**<a name="line.61"></a>
<span class="sourceLineNo">062</span> * Return the index in the {@link ConstantPool} of the {@link UTF8Entry}<a name="line.62"></a>
<span class="sourceLineNo">063</span> * holding the name of this attribute.<a name="line.63"></a>
<span class="sourceLineNo">064</span> */<a name="line.64"></a>
<span class="sourceLineNo">065</span> public int getNameIndex() {<a name="line.65"></a>
<span class="sourceLineNo">066</span> return _nameIndex;<a name="line.66"></a>
<span class="sourceLineNo">067</span> }<a name="line.67"></a>
<span class="sourceLineNo">068</span><a name="line.68"></a>
<span class="sourceLineNo">069</span> /**<a name="line.69"></a>
<span class="sourceLineNo">070</span> * Return the name of this attribute.<a name="line.70"></a>
<span class="sourceLineNo">071</span> */<a name="line.71"></a>
<span class="sourceLineNo">072</span> public String getName() {<a name="line.72"></a>
<span class="sourceLineNo">073</span> return ((UTF8Entry) getPool().getEntry(_nameIndex)).getValue();<a name="line.73"></a>
<span class="sourceLineNo">074</span> }<a name="line.74"></a>
<span class="sourceLineNo">075</span><a name="line.75"></a>
<span class="sourceLineNo">076</span> public Project getProject() {<a name="line.76"></a>
<span class="sourceLineNo">077</span> return _owner.getProject();<a name="line.77"></a>
<span class="sourceLineNo">078</span> }<a name="line.78"></a>
<span class="sourceLineNo">079</span><a name="line.79"></a>
<span class="sourceLineNo">080</span> public ConstantPool getPool() {<a name="line.80"></a>
<span class="sourceLineNo">081</span> return _owner.getPool();<a name="line.81"></a>
<span class="sourceLineNo">082</span> }<a name="line.82"></a>
<span class="sourceLineNo">083</span><a name="line.83"></a>
<span class="sourceLineNo">084</span> public ClassLoader getClassLoader() {<a name="line.84"></a>
<span class="sourceLineNo">085</span> return _owner.getClassLoader();<a name="line.85"></a>
<span class="sourceLineNo">086</span> }<a name="line.86"></a>
<span class="sourceLineNo">087</span><a name="line.87"></a>
<span class="sourceLineNo">088</span> public boolean isValid() {<a name="line.88"></a>
<span class="sourceLineNo">089</span> return _owner != null;<a name="line.89"></a>
<span class="sourceLineNo">090</span> }<a name="line.90"></a>
<span class="sourceLineNo">091</span><a name="line.91"></a>
<span class="sourceLineNo">092</span> Collection getAttributesHolder() {<a name="line.92"></a>
<span class="sourceLineNo">093</span> return Collections.EMPTY_LIST;<a name="line.93"></a>
<span class="sourceLineNo">094</span> }<a name="line.94"></a>
<span class="sourceLineNo">095</span><a name="line.95"></a>
<span class="sourceLineNo">096</span> /**<a name="line.96"></a>
<span class="sourceLineNo">097</span> * Invalidate this attribute.<a name="line.97"></a>
<span class="sourceLineNo">098</span> */<a name="line.98"></a>
<span class="sourceLineNo">099</span> void invalidate() {<a name="line.99"></a>
<span class="sourceLineNo">100</span> _owner = null;<a name="line.100"></a>
<span class="sourceLineNo">101</span> }<a name="line.101"></a>
<span class="sourceLineNo">102</span><a name="line.102"></a>
<span class="sourceLineNo">103</span> /**<a name="line.103"></a>
<span class="sourceLineNo">104</span> * Return the length of the bytecode representation of this attribute<a name="line.104"></a>
<span class="sourceLineNo">105</span> * in bytes, excluding the name index.<a name="line.105"></a>
<span class="sourceLineNo">106</span> */<a name="line.106"></a>
<span class="sourceLineNo">107</span> int getLength() {<a name="line.107"></a>
<span class="sourceLineNo">108</span> return 0;<a name="line.108"></a>
<span class="sourceLineNo">109</span> }<a name="line.109"></a>
<span class="sourceLineNo">110</span><a name="line.110"></a>
<span class="sourceLineNo">111</span> /**<a name="line.111"></a>
<span class="sourceLineNo">112</span> * Copy the information from the given attribute to this one. Does<a name="line.112"></a>
<span class="sourceLineNo">113</span> * nothing by default.<a name="line.113"></a>
<span class="sourceLineNo">114</span> */<a name="line.114"></a>
<span class="sourceLineNo">115</span> void read(Attribute other) {<a name="line.115"></a>
<span class="sourceLineNo">116</span> }<a name="line.116"></a>
<span class="sourceLineNo">117</span><a name="line.117"></a>
<span class="sourceLineNo">118</span> /**<a name="line.118"></a>
<span class="sourceLineNo">119</span> * Read the attribute bytecode from the given stream, up to length<a name="line.119"></a>
<span class="sourceLineNo">120</span> * bytes, excluding the name index. Does nothing by default.<a name="line.120"></a>
<span class="sourceLineNo">121</span> */<a name="line.121"></a>
<span class="sourceLineNo">122</span> void read(DataInput in, int length) throws IOException {<a name="line.122"></a>
<span class="sourceLineNo">123</span> }<a name="line.123"></a>
<span class="sourceLineNo">124</span><a name="line.124"></a>
<span class="sourceLineNo">125</span> /**<a name="line.125"></a>
<span class="sourceLineNo">126</span> * Write the attribute bytecode to the given stream, up to length bytes,<a name="line.126"></a>
<span class="sourceLineNo">127</span> * excluding the name index. Does nothing by default.<a name="line.127"></a>
<span class="sourceLineNo">128</span> */<a name="line.128"></a>
<span class="sourceLineNo">129</span> void write(DataOutput out, int length) throws IOException {<a name="line.129"></a>
<span class="sourceLineNo">130</span> }<a name="line.130"></a>
<span class="sourceLineNo">131</span>}<a name="line.131"></a>
</pre>
</div>
</body>
</html>
|