1 /*
2 * Copyright (c) 1999, 2024, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26 package com.sun.tools.javac.util;
27
28 /**
29 * Access to the compiler's name table. Standard names are defined,
30 * as well as methods to create new names.
31 *
32 * <p><b>This is NOT part of any supported API.
33 * If you write code that depends on this, you do so at your own risk.
34 * This code and its internal interfaces are subject to change or
35 * deletion without notice.</b>
36 */
37 public class Names {
38
39 public static final Context.Key<Names> namesKey = new Context.Key<>();
40
41 public static Names instance(Context context) {
42 Names instance = context.get(namesKey);
43 if (instance == null) {
44 instance = new Names(context);
45 context.put(namesKey, instance);
46 }
47 return instance;
48 }
49
50 // operators and punctuation
51 public final Name asterisk;
52 public final Name comma;
53 public final Name empty;
54 public final Name hyphen;
55 public final Name one;
56 public final Name slash;
57
58 // keywords
59 public final Name _class;
60 public final Name _super;
61 public final Name _this;
62 public final Name var;
63 public final Name exports;
64 public final Name opens;
65 public final Name module;
66 public final Name provides;
67 public final Name requires;
68 public final Name to;
69 public final Name transitive;
70 public final Name uses;
71 public final Name open;
72 public final Name underscore;
73 public final Name when;
74 public final Name with;
75 public final Name yield;
76
77 // field and method names
78 public final Name _name;
79 public final Name addSuppressed;
80 public final Name any;
81 public final Name append;
82 public final Name clinit;
83 public final Name clone;
84 public final Name close;
85 public final Name deserializeLambda;
86 public final Name desiredAssertionStatus;
87 public final Name equals;
88 public final Name error;
89 public final Name finalize;
90 public final Name forRemoval;
91 public final Name reflective;
92 public final Name getClass;
93 public final Name hasNext;
94 public final Name hashCode;
95 public final Name init;
96 public final Name invoke;
97 public final Name iterator;
98 public final Name length;
99 public final Name next;
100 public final Name of;
101 public final Name ordinal;
102 public final Name provider;
103 public final Name serialVersionUID;
104 public final Name toString;
105 public final Name value;
106 public final Name valueOf;
107 public final Name values;
108 public final Name readResolve;
109 public final Name readObject;
110
111 // class names
112 public final Name java_io_Serializable;
113 public final Name java_lang_Class;
114 public final Name java_lang_Cloneable;
115 public final Name java_lang_Enum;
116 public final Name java_lang_Object;
117 public final Name java_lang_System;
118
119 // names of builtin classes
120 public final Name Array;
121 public final Name Bound;
122 public final Name Method;
123
124 // package names
125 public final Name java;
126 public final Name java_lang;
127 public final Name jdk_internal_javac;
128
129 // module names
130 public final Name java_base;
131 public final Name java_se;
132 public final Name jdk_unsupported;
133
134 // attribute names
135 public final Name Annotation;
136 public final Name AnnotationDefault;
137 public final Name BootstrapMethods;
138 public final Name Bridge;
139 public final Name CharacterRangeTable;
140 public final Name Code;
141 public final Name CompilationID;
142 public final Name ConstantValue;
143 public final Name Deprecated;
144 public final Name EnclosingMethod;
145 public final Name Enum;
146 public final Name Exceptions;
147 public final Name InnerClasses;
148 public final Name LineNumberTable;
149 public final Name LocalVariableTable;
150 public final Name LocalVariableTypeTable;
151 public final Name MethodParameters;
152 public final Name Module;
153 public final Name ModuleResolution;
154 public final Name NestHost;
155 public final Name NestMembers;
156 public final Name LoadableDescriptors;
157 public final Name Record;
158 public final Name RuntimeInvisibleAnnotations;
159 public final Name RuntimeInvisibleParameterAnnotations;
160 public final Name RuntimeInvisibleTypeAnnotations;
161 public final Name RuntimeVisibleAnnotations;
162 public final Name RuntimeVisibleParameterAnnotations;
163 public final Name RuntimeVisibleTypeAnnotations;
164 public final Name Signature;
165 public final Name SourceFile;
166 public final Name SourceID;
167 public final Name StackMap;
168 public final Name StackMapTable;
169 public final Name Synthetic;
170 public final Name Value;
171 public final Name Varargs;
172 public final Name PermittedSubclasses;
173
174 // members of java.lang.annotation.ElementType
175 public final Name ANNOTATION_TYPE;
176 public final Name CONSTRUCTOR;
177 public final Name FIELD;
178 public final Name LOCAL_VARIABLE;
179 public final Name METHOD;
180 public final Name MODULE;
181 public final Name PACKAGE;
182 public final Name PARAMETER;
183 public final Name TYPE;
184 public final Name TYPE_PARAMETER;
185 public final Name TYPE_USE;
186 public final Name RECORD_COMPONENT;
187
188 // members of java.lang.annotation.RetentionPolicy
189 public final Name CLASS;
190 public final Name RUNTIME;
191 public final Name SOURCE;
192
193 // other identifiers
194 public final Name T;
195 public final Name ex;
196 public final Name module_info;
197 public final Name package_info;
198 public final Name requireNonNull;
199 public final Name main;
200
201 // lambda-related
202 public final Name lambda;
203 public final Name metafactory;
204 public final Name altMetafactory;
205 public final Name dollarThis;
206
207 // string concat
208 public final Name makeConcat;
209 public final Name makeConcatWithConstants;
210
211 // values
212 public final Name dollarValue;
213
214
215 // record related
216 // members of java.lang.runtime.ObjectMethods
217 public final Name bootstrap;
218
219 public final Name record;
220 public final Name non;
221
222 // serialization members, used by records too
223 public final Name serialPersistentFields;
224 public final Name writeObject;
225 public final Name writeReplace;
226 public final Name readObjectNoData;
227
228 // sealed types
229 public final Name permits;
230 public final Name sealed;
231
232 // pattern switches
233 public final Name typeSwitch;
234 public final Name enumSwitch;
235 public final Name enumConstant;
236
237 // code reflection
238 public final Name jdk_incubator_code;
239
240 // special annotation names
241 public final Name requiresIdentityInternal;
242
243 public final Name.Table table;
244
245 @SuppressWarnings("this-escape")
246 public Names(Context context) {
247 Options options = Options.instance(context);
248 table = createTable(options);
249
250 // operators and punctuation
251 asterisk = fromString("*");
252 comma = fromString(",");
253 empty = fromString("");
254 hyphen = fromString("-");
255 one = fromString("1");
256 slash = fromString("/");
257
258 // keywords
259 _class = fromString("class");
260 _super = fromString("super");
261 _this = fromString("this");
262 var = fromString("var");
263 exports = fromString("exports");
264 opens = fromString("opens");
265 module = fromString("module");
266 provides = fromString("provides");
267 requires = fromString("requires");
268 to = fromString("to");
269 transitive = fromString("transitive");
270 uses = fromString("uses");
271 open = fromString("open");
272 underscore = fromString("_");
273 when = fromString("when");
274 with = fromString("with");
275 yield = fromString("yield");
276
277 // field and method names
278 _name = fromString("name");
279 addSuppressed = fromString("addSuppressed");
280 any = fromString("<any>");
281 append = fromString("append");
282 clinit = fromString("<clinit>");
283 clone = fromString("clone");
284 close = fromString("close");
285 deserializeLambda = fromString("$deserializeLambda$");
286 desiredAssertionStatus = fromString("desiredAssertionStatus");
287 equals = fromString("equals");
288 error = fromString("<error>");
289 finalize = fromString("finalize");
290 forRemoval = fromString("forRemoval");
291 reflective = fromString("reflective");
292 getClass = fromString("getClass");
293 hasNext = fromString("hasNext");
294 hashCode = fromString("hashCode");
295 init = fromString("<init>");
296 invoke = fromString("invoke");
297 iterator = fromString("iterator");
298 length = fromString("length");
299 next = fromString("next");
300 of = fromString("of");
301 ordinal = fromString("ordinal");
302 provider = fromString("provider");
303 serialVersionUID = fromString("serialVersionUID");
304 toString = fromString("toString");
305 value = fromString("value");
306 valueOf = fromString("valueOf");
307 values = fromString("values");
308 readResolve = fromString("readResolve");
309 readObject = fromString("readObject");
310 dollarThis = fromString("$this");
311
312 // class names
313 java_io_Serializable = fromString("java.io.Serializable");
314 java_lang_Class = fromString("java.lang.Class");
315 java_lang_Cloneable = fromString("java.lang.Cloneable");
316 java_lang_Enum = fromString("java.lang.Enum");
317 java_lang_Object = fromString("java.lang.Object");
318 java_lang_System = fromString("java.lang.System");
319
320 // names of builtin classes
321 Array = fromString("Array");
322 Bound = fromString("Bound");
323 Method = fromString("Method");
324
325 // package names
326 java = fromString("java");
327 java_lang = fromString("java.lang");
328 jdk_internal_javac = fromString("jdk.internal.javac");
329
330 // module names
331 java_base = fromString("java.base");
332 java_se = fromString("java.se");
333 jdk_unsupported = fromString("jdk.unsupported");
334
335 // attribute names
336 Annotation = fromString("Annotation");
337 AnnotationDefault = fromString("AnnotationDefault");
338 BootstrapMethods = fromString("BootstrapMethods");
339 Bridge = fromString("Bridge");
340 CharacterRangeTable = fromString("CharacterRangeTable");
341 Code = fromString("Code");
342 CompilationID = fromString("CompilationID");
343 ConstantValue = fromString("ConstantValue");
344 Deprecated = fromString("Deprecated");
345 EnclosingMethod = fromString("EnclosingMethod");
346 Enum = fromString("Enum");
347 Exceptions = fromString("Exceptions");
348 InnerClasses = fromString("InnerClasses");
349 LineNumberTable = fromString("LineNumberTable");
350 LocalVariableTable = fromString("LocalVariableTable");
351 LocalVariableTypeTable = fromString("LocalVariableTypeTable");
352 MethodParameters = fromString("MethodParameters");
353 Module = fromString("Module");
354 ModuleResolution = fromString("ModuleResolution");
355 NestHost = fromString("NestHost");
356 NestMembers = fromString("NestMembers");
357 LoadableDescriptors = fromString("LoadableDescriptors");
358 Record = fromString("Record");
359 RuntimeInvisibleAnnotations = fromString("RuntimeInvisibleAnnotations");
360 RuntimeInvisibleParameterAnnotations = fromString("RuntimeInvisibleParameterAnnotations");
361 RuntimeInvisibleTypeAnnotations = fromString("RuntimeInvisibleTypeAnnotations");
362 RuntimeVisibleAnnotations = fromString("RuntimeVisibleAnnotations");
363 RuntimeVisibleParameterAnnotations = fromString("RuntimeVisibleParameterAnnotations");
364 RuntimeVisibleTypeAnnotations = fromString("RuntimeVisibleTypeAnnotations");
365 Signature = fromString("Signature");
366 SourceFile = fromString("SourceFile");
367 SourceID = fromString("SourceID");
368 StackMap = fromString("StackMap");
369 StackMapTable = fromString("StackMapTable");
370 Synthetic = fromString("Synthetic");
371 Value = fromString("Value");
372 Varargs = fromString("Varargs");
373 PermittedSubclasses = fromString("PermittedSubclasses");
374
375 // members of java.lang.annotation.ElementType
376 ANNOTATION_TYPE = fromString("ANNOTATION_TYPE");
377 CONSTRUCTOR = fromString("CONSTRUCTOR");
378 FIELD = fromString("FIELD");
379 LOCAL_VARIABLE = fromString("LOCAL_VARIABLE");
380 METHOD = fromString("METHOD");
381 MODULE = fromString("MODULE");
382 PACKAGE = fromString("PACKAGE");
383 PARAMETER = fromString("PARAMETER");
384 TYPE = fromString("TYPE");
385 TYPE_PARAMETER = fromString("TYPE_PARAMETER");
386 TYPE_USE = fromString("TYPE_USE");
387 RECORD_COMPONENT = fromString("RECORD_COMPONENT");
388
389 // members of java.lang.annotation.RetentionPolicy
390 CLASS = fromString("CLASS");
391 RUNTIME = fromString("RUNTIME");
392 SOURCE = fromString("SOURCE");
393
394 // other identifiers
395 T = fromString("T");
396 ex = fromString("ex");
397 module_info = fromString("module-info");
398 package_info = fromString("package-info");
399 requireNonNull = fromString("requireNonNull");
400 main = fromString("main");
401
402 //lambda-related
403 lambda = fromString("lambda$");
404 metafactory = fromString("metafactory");
405 altMetafactory = fromString("altMetafactory");
406
407 // string concat
408 makeConcat = fromString("makeConcat");
409 makeConcatWithConstants = fromString("makeConcatWithConstants");
410
411 dollarValue = fromString("$value");
412
413 bootstrap = fromString("bootstrap");
414 record = fromString("record");
415 non = fromString("non");
416
417 serialPersistentFields = fromString("serialPersistentFields");
418 writeObject = fromString("writeObject");
419 writeReplace = fromString("writeReplace");
420 readObjectNoData = fromString("readObjectNoData");
421
422 // sealed types
423 permits = fromString("permits");
424 sealed = fromString("sealed");
425
426
427 // pattern switches
428 typeSwitch = fromString("typeSwitch");
429 enumSwitch = fromString("enumSwitch");
430 enumConstant = fromString("enumConstant");
431
432 // code reflection
433 jdk_incubator_code = fromString("jdk.incubator.code");
434
435 // special annotations:
436 requiresIdentityInternal = fromString("jdk.internal.RequiresIdentity+Annotation");
437 }
438
439 protected Name.Table createTable(Options options) {
440 boolean useUnsharedTable = options.isSet("useUnsharedTable");
441 if (useUnsharedTable)
442 return newUnsharedNameTable();
443 boolean useSharedTable = options.isSet("useSharedTable");
444 if (useSharedTable)
445 return newSharedNameTable();
446 boolean internStringTable = options.isSet("internStringTable");
447 return newStringNameTable(internStringTable);
448 }
449
450 public StringNameTable newStringNameTable(boolean intern) {
451 return StringNameTable.create(this, intern);
452 }
453
454 public SharedNameTable newSharedNameTable() {
455 return SharedNameTable.create(this);
456 }
457
458 public UnsharedNameTable newUnsharedNameTable() {
459 return UnsharedNameTable.create(this);
460 }
461
462 public boolean isInit(Name name) {
463 return name == init;
464 }
465
466 public void dispose() {
467 table.dispose();
468 }
469
470 public Name fromChars(char[] cs, int start, int len) {
471 return table.fromChars(cs, start, len);
472 }
473
474 public Name fromString(String s) {
475 return table.fromString(s);
476 }
477
478 public Name fromUtf(byte[] cs) throws InvalidUtfException {
479 return table.fromUtf(cs);
480 }
481
482 public Name fromUtf(byte[] cs, int start, int len, Convert.Validation validation) throws InvalidUtfException {
483 return table.fromUtf(cs, start, len, validation);
484 }
485
486 public Name fromUtfLax(byte[] cs, int start, int len) {
487 try {
488 return table.fromUtf(cs, start, len, Convert.Validation.NONE);
489 } catch (InvalidUtfException e) {
490 throw new AssertionError(e);
491 }
492 }
493 }