author | briangoetz |
Wed, 18 Dec 2013 16:05:18 -0500 | |
changeset 22163 | 3651128c74eb |
parent 14541 | 36f9d11fc9aa |
permissions | -rw-r--r-- |
1258 | 1 |
/* |
14541
36f9d11fc9aa
7021614: extend com.sun.source API to support parsing javadoc comments
jjg
parents:
11055
diff
changeset
|
2 |
* Copyright (c) 1999, 2012, Oracle and/or its affiliates. All rights reserved. |
1258 | 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 |
|
5520 | 7 |
* published by the Free Software Foundation. Oracle designates this |
1258 | 8 |
* particular file as subject to the "Classpath" exception as provided |
5520 | 9 |
* by Oracle in the LICENSE file that accompanied this code. |
1258 | 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 |
* |
|
5520 | 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. |
|
1258 | 24 |
*/ |
25 |
||
26 |
package com.sun.tools.javac.parser; |
|
27 |
||
14541
36f9d11fc9aa
7021614: extend com.sun.source API to support parsing javadoc comments
jjg
parents:
11055
diff
changeset
|
28 |
import java.util.Locale; |
36f9d11fc9aa
7021614: extend com.sun.source API to support parsing javadoc comments
jjg
parents:
11055
diff
changeset
|
29 |
|
1258 | 30 |
import com.sun.tools.javac.code.Source; |
14541
36f9d11fc9aa
7021614: extend com.sun.source API to support parsing javadoc comments
jjg
parents:
11055
diff
changeset
|
31 |
import com.sun.tools.javac.tree.DocTreeMaker; |
1258 | 32 |
import com.sun.tools.javac.tree.TreeMaker; |
33 |
import com.sun.tools.javac.util.Context; |
|
34 |
import com.sun.tools.javac.util.Log; |
|
1260
a772ba9ba43d
6574134: Allow for alternative implementation of Name Table with garbage collection of name bytes
jjg
parents:
1258
diff
changeset
|
35 |
import com.sun.tools.javac.util.Names; |
1258 | 36 |
import com.sun.tools.javac.util.Options; |
37 |
||
38 |
/** |
|
39 |
* A factory for creating parsers. |
|
3380
a6c2bcab0fec
6865399: some javac files are missing Sun internal API comment
jjg
parents:
1260
diff
changeset
|
40 |
* |
5847
1908176fd6e3
6944312: Potential rebranding issues in openjdk/langtools repository sources
jjg
parents:
5520
diff
changeset
|
41 |
* <p><b>This is NOT part of any supported API. |
3380
a6c2bcab0fec
6865399: some javac files are missing Sun internal API comment
jjg
parents:
1260
diff
changeset
|
42 |
* If you write code that depends on this, you do so at your own risk. |
a6c2bcab0fec
6865399: some javac files are missing Sun internal API comment
jjg
parents:
1260
diff
changeset
|
43 |
* This code and its internal interfaces are subject to change or |
a6c2bcab0fec
6865399: some javac files are missing Sun internal API comment
jjg
parents:
1260
diff
changeset
|
44 |
* deletion without notice.</b> |
1258 | 45 |
*/ |
46 |
public class ParserFactory { |
|
47 |
||
48 |
/** The context key for the parser factory. */ |
|
22163 | 49 |
protected static final Context.Key<ParserFactory> parserFactoryKey = new Context.Key<>(); |
1258 | 50 |
|
51 |
public static ParserFactory instance(Context context) { |
|
52 |
ParserFactory instance = context.get(parserFactoryKey); |
|
53 |
if (instance == null) { |
|
54 |
instance = new ParserFactory(context); |
|
55 |
} |
|
56 |
return instance; |
|
57 |
} |
|
58 |
||
59 |
final TreeMaker F; |
|
14541
36f9d11fc9aa
7021614: extend com.sun.source API to support parsing javadoc comments
jjg
parents:
11055
diff
changeset
|
60 |
final DocTreeMaker docTreeMaker; |
1258 | 61 |
final Log log; |
10815 | 62 |
final Tokens tokens; |
1258 | 63 |
final Source source; |
1260
a772ba9ba43d
6574134: Allow for alternative implementation of Name Table with garbage collection of name bytes
jjg
parents:
1258
diff
changeset
|
64 |
final Names names; |
1258 | 65 |
final Options options; |
6716
71df48777dd1
6877202: Elements.getDocComment() is not getting JavaDocComments
jjg
parents:
5847
diff
changeset
|
66 |
final ScannerFactory scannerFactory; |
14541
36f9d11fc9aa
7021614: extend com.sun.source API to support parsing javadoc comments
jjg
parents:
11055
diff
changeset
|
67 |
final Locale locale; |
1258 | 68 |
|
69 |
protected ParserFactory(Context context) { |
|
70 |
super(); |
|
71 |
context.put(parserFactoryKey, this); |
|
72 |
this.F = TreeMaker.instance(context); |
|
14541
36f9d11fc9aa
7021614: extend com.sun.source API to support parsing javadoc comments
jjg
parents:
11055
diff
changeset
|
73 |
this.docTreeMaker = DocTreeMaker.instance(context); |
1258 | 74 |
this.log = Log.instance(context); |
1260
a772ba9ba43d
6574134: Allow for alternative implementation of Name Table with garbage collection of name bytes
jjg
parents:
1258
diff
changeset
|
75 |
this.names = Names.instance(context); |
10815 | 76 |
this.tokens = Tokens.instance(context); |
1258 | 77 |
this.source = Source.instance(context); |
78 |
this.options = Options.instance(context); |
|
6716
71df48777dd1
6877202: Elements.getDocComment() is not getting JavaDocComments
jjg
parents:
5847
diff
changeset
|
79 |
this.scannerFactory = ScannerFactory.instance(context); |
14541
36f9d11fc9aa
7021614: extend com.sun.source API to support parsing javadoc comments
jjg
parents:
11055
diff
changeset
|
80 |
this.locale = context.get(Locale.class); |
1258 | 81 |
} |
82 |
||
14541
36f9d11fc9aa
7021614: extend com.sun.source API to support parsing javadoc comments
jjg
parents:
11055
diff
changeset
|
83 |
public JavacParser newParser(CharSequence input, boolean keepDocComments, boolean keepEndPos, boolean keepLineMap) { |
6716
71df48777dd1
6877202: Elements.getDocComment() is not getting JavaDocComments
jjg
parents:
5847
diff
changeset
|
84 |
Lexer lexer = scannerFactory.newScanner(input, keepDocComments); |
11055 | 85 |
return new JavacParser(this, lexer, keepDocComments, keepLineMap, keepEndPos); |
1258 | 86 |
} |
87 |
} |