blob: 8bf90e82aa3801723e850cb52bea5a0a896df035 [file] [log] [blame] [view]
Danny van Bruggen23d54772017-02-05 16:21:16 +01001Version 3.1.0-beta.1
Danny van Bruggen70f343e2017-01-28 14:07:25 +01002------------------
Danny van Bruggen23d54772017-02-05 16:21:16 +01003This version is a beta because there are a lot of new features that may still change.
4
5This version needs a minor version increase because of a backwards compatability issue:
6* 719 `getJavadoc`, `getJavadocComment` and `getComment` could return null. Our promise was to return `Optional`, so that is what they do now.
Danny van Bruggen70f343e2017-01-28 14:07:25 +01007
8New:
Danny van Bruggen23d54772017-02-05 16:21:16 +01009* 658 718 we have created a metamodel.
10It gives information about the structure of the various AST nodes, as if you are introspecting them.
11You can find it in `javaparser-metamodel`, the main class is `JavaParserMetaModel`
Danny van Bruggen70f343e2017-01-28 14:07:25 +010012* 353 visitors are no longer hand made, they are now generated from the metamodel. This should make them 100% reliable.
Danny van Bruggen23d54772017-02-05 16:21:16 +010013Affected visitors are: `GenericVisitorAdapter`, `EqualsVisitor`, `VoidVisitorAdapter`, `VoidVisitor`, `GenericVisitor`, `HashCodeVisitor`, `CloneVisitor`.
14
15If you want to generate your own visitors, you can use the `VisitorGenerator` class from `javaparser-core-generators`
16
17If you want to reuse the code generation utilities, look at module `javaparser-generator-utils` - there is a very useful `SourceRoot` class in there that takes away a lot of file management troubles.
Danny van Bruggenef4d7482017-02-05 16:22:13 +010018* 220 733 717 749 745 750 743 748 smaller improvements and fixes
Danny van Bruggen70f343e2017-01-28 14:07:25 +010019
Danny van Bruggenc5f6e9b2017-01-15 20:58:52 +010020Version 3.0.1
21------------------
22* 699 433 325 Javadoc can now be parsed
23* 703 696 added NodeWithOptionalScope
24* 702 FieldAccessExpr now implements NodeWithSimpleName, *which means that "field" has been renamed to "name"*
25* 707 706 improve range of array types and levels
26* 709 smaller improvements and fixes
27
Danny van Bruggen1804ea22017-01-07 23:06:22 +010028Version 3.0.0
29------------------
30* 695 697 689 680 693 691 682 690 677 679 688 684 683 smaller improvements and fixes
31
Danny van Bruggene11ed222016-12-24 22:25:49 +010032Version 3.0.0-RC.4
33------------------
34* 668 669 TypeDeclarationStmt became LocalClassDeclarationStmt
35* 347 665 every node now has some documentation
36* 660 670 673 four types of import declaration have been merged back into the old ImportDeclaration
37* 659 The pretty printer can now take customized visitors
38* 650 671 672 674 524 smaller improvements and fixes
39
Danny van Bruggenfc9c4a92016-12-18 23:13:10 +010040Version 3.0.0-RC.3
41------------------
42* 639 622 632 657 656 652 653 647 648 645 194 643 630 624 628 627 626 625 623 cleanups, small fixes, and general housekeeping
43
Danny van Bruggendd5d4d02016-12-09 16:40:59 +010044Version 3.0.0-RC.2
45------------------
46* 593 EmptyImportDeclaration and NonEmptyImportDeclaration have been removed
47* 612 VariableDeclaratorId has been removed. It has been substituted by "SimpleName name"
48* 614 617 the list of tokens has been linearized and simplified
49* 615 support for arrays has once more been changed. See [the issue](https://github.com/javaparser/javaparser/issues/592)
50* 580 453 380 618 580 611 610 424 608 smaller improvements and fixes
51
Danny van Bruggen61aaeaf2016-12-01 18:37:11 +010052Version 3.0.0-RC.1
53------------------
54* 499 601 renames many fields to be more consistent
55* 596 605 602 604 smaller improvements and fixes
56
Danny van Bruggen47379542016-11-27 16:54:33 +010057Version 3.0.0-alpha.11
58------------------
59* 547 595 Node.range is now using Optional instead of Range.UNKNOWN
Danny van Bruggen6738e1c2016-11-28 19:46:45 +010060* 584 588 548 585 bug fixes and improvements
Danny van Bruggen47379542016-11-27 16:54:33 +010061
matozoidf52d1ad2016-11-20 16:36:22 +010062Version 3.0.0-alpha.10
63------------------
64* 578 579 577 575 290 570 568 567 562 564 551 bug fixes and improvements
65
Danny van Bruggen02b3c5e2016-11-10 10:33:44 +010066Version 3.0.0-alpha.9
67------------------
68* 403 358 549 Make all names nodes: either SimpleName or Name. This makes every name in the AST visitable. NameExpr is now a wrapper to use SimpleName in an expression.
matozoidd2c9f432016-11-13 17:29:38 +010069* 516 536 use Optional<> for return values.
matozoid789ddfe2016-11-13 17:33:43 +010070* 556 557 558 550 small improvements and fixes.
71* 560 559 make nodes observable.
Danny van Bruggen02b3c5e2016-11-10 10:33:44 +010072
matozoidaa79a622016-11-06 14:13:37 +010073Version 3.0.0-alpha.8
74------------------
75* 344 529 turn DumpVisitor into an official PrettyPrinter
76* 532 508 427 530 531 513 528 cleanups
77
matozoidde10e892016-10-26 19:48:54 +020078Version 3.0.0-alpha.7
79------------------
matozoid57a10942016-10-30 21:14:28 +010080* 515 roll back attempt at using Optional
81* 522 504 make NodeList not a Node (restores parent/children behaviour to before alpha.4)
82* 527 526 rename getChildrenNodes to getChildNodes
83* 525 495 520 bug fix
matozoidde10e892016-10-26 19:48:54 +020084
85Version 3.0.0-alpha.6
86------------------
87* 503 modified ImportDeclaration hierarchy to have getters for static and "asterisk" again
88* 506 bug fix
89
matozoid9ac80482016-10-16 22:08:51 +020090Version 3.0.0-alpha.5
91------------------
92* 451 null is no longer allowed in the AST. [See last post in issue](https://github.com/javaparser/javaparser/issues/451)
93* 501 421 420 316 use a special type of list for nodes: NodeList. [See last post in issue](https://github.com/javaparser/javaparser/issues/421)
94
matozoid93c5ac12016-10-09 22:03:29 +020095Version 3.0.0-alpha.4
96------------------
97* 463 471 nodes can now be removed easily
98* 491 import handling changed. Instead of "ImportDeclaration", we now have the four types of import as described in the JLS. [See issue](https://github.com/javaparser/javaparser/pull/491)
99* 452 355 474 494 various improvements
100* 493 492 485 Simplify the JavaParser interface
101
matozoid6ea2c522016-09-30 18:55:44 +0200102Version 3.0.0-alpha.3
103------------------
matozoid93c5ac12016-10-09 22:03:29 +0200104* 112 237 466 465 461 460 458 457 fundamentally changes how we deal with arrays. [It is explained in the last post here](https://github.com/javaparser/javaparser/issues/237)
matozoid6ea2c522016-09-30 18:55:44 +0200105* 472 456 makes the "data" field on every node more structured.
106* 477 468 refactor TypeArguments. You will find that TypeArguments is no longer a type, it is just a list in some nodes.
107* 482 adds the "nodeTypes" packages to the osgi export.
108* 479 476 makes all setters on nodes return this so they become chainable.
109* 473 437 clean up CloneVisitor.
matozoid53d288a2016-07-18 13:32:44 +0200110
matozoid6ea2c522016-09-30 18:55:44 +0200111Version 3.0.0-alpha.2
112------------------
113* 157 a new parser frontend, check https://github.com/javaparser/javaparser/pull/447 for explanations
114* 435 more builder methods like 400 and 405
115* 111 440 443 444 445 446 bugs & cleanups
matozoid53d288a2016-07-18 13:32:44 +0200116
matozoid6ea2c522016-09-30 18:55:44 +0200117Version 3.0.0-alpha.1
118------------------
119* 400 405 introduce many "builder" style methods for constructing code. Thanks DeepSnowNeeL!
120* 409 remove ASTHelper (methods are now on specific Node subclasses)
121* 414 JavaParser can now be instantiated and reused. InstanceJavaParser removed
122* 418 417 411 408 bugs
123* 367 420 407 402 various cleanups
124
125Version 2.5.1
matozoid53d288a2016-07-18 13:32:44 +0200126-------------
matozoid6ea2c522016-09-30 18:55:44 +0200127* 394 OSGi manifest added
128* 391 fix ModifierVisitor NullPointerException bug
129* 385 a few new parse methods
130* 386 fix dumping an empty import (a single ; after the package declaration)
matozoid53d288a2016-07-18 13:32:44 +0200131
132Version 2.5.0
133-------------
134API breaking changes:
135
136* 191: moved TreeVisitor to visitor package
137* 368, 162, 303, 302, 360: use correct type in some places.
138* 371: code is now compiled with Java 8
139* 342, 331: ModifierVisitorAdapter detects and removes broken nodes
140* 328, 270: upgrade JavaCC (use TokenMgrException now)
141Other changes:
142
143* 297: enable access to tokens.
144* 341, 361: node positions are now OO
145* 211, 373: escaping of \n \r for string literals
146* 336, 276, 141: JavaDoc support now works
147* 337, 281: reorganize the stream reading code
148* 343, 309, 332, 57: take advantage of common interfaces
149* 329, 326, 327: deal with platform issues
150* 163, 236, 252, 296, 269, 339, 321, 322, 252, 253, 293, 295: various fixes
151* 310, 311, 313, 301, 294: some code clean-ups
Danny van Bruggen5f5c6cc2016-07-20 13:40:30 +0200152
matozoid6ea2c522016-09-30 18:55:44 +0200153Version 2.4.0
Danny van Bruggen5f5c6cc2016-07-20 13:40:30 +0200154-------------
matozoid6ea2c522016-09-30 18:55:44 +0200155* several fixes in DumpVisitor for bugs due to lazy initialization
156* make TypeDeclaration implements DocumentableNode directly
157* TypedNode interface introduced
158* introduce MultiBoundType
159* refactored IntersectionType and UnionType
160* refactored CatchClause
161* parsing annotations in throws declarations
162* parse orphan semicolons in import statements
163* added PackageDeclaration.getPackageName
164* solved issue with newlines in string literals
165* fixed handling of UnknownType in EqualsVisitor
166* improvements to CommentsParser
167* removing old grammar
matozoid13818472016-08-23 22:03:06 +0200168
matozoid6ea2c522016-09-30 18:55:44 +0200169Version 2.3.0
170-------------
171* ClassOrInterfaceType implements NamedNode
172* DumpVisitor can now be extended
173* Improved documentation
174* AST: lists are now lazy initialized
matozoid8669cf42016-09-30 18:39:12 +0200175
matozoideae61572016-09-30 18:57:34 +0200176Version 2.1.0-SNAPSHOT
177-------------
178* Features
179 * [#75 performance improvement for `PositionUtils.sortByBeginPosition`](https://github.com/javaparser/javaparser/issues/75)
180 * [#64 In getDeclarationAsString parameter names should be optional](https://github.com/javaparser/javaparser/issues/64)
181* Bugfixes
182 * [#79 Fix NPE in `ConstructorDeclaration.getDeclarationAsString`](https://github.com/javaparser/javaparser/pull/79)
183 * [#86 Add missing functions to ModifierVisitorAdapter](https://github.com/javaparser/javaparser/pull/86)
184 * [#82 set LambdaExpr as parent of its child nodes](https://github.com/javaparser/javaparser/issues/82)
185 * [#87 implement `setJavadoc` and `getJavadoc` at various classes](https://github.com/javaparser/javaparser/issues/87)
186 * [#96 Fixed encoding issue in `Javaparser.parse`](https://github.com/javaparser/javaparser/pull/96)
187 * [#85 Casting a lambda expression causes a parsing failure](https://github.com/javaparser/javaparser/issues/85)
188 * [#88 `MethodReferenceExpr` and `TypeExpr` don't set themselves as parents](https://github.com/javaparser/javaparser/issues/88)
189* Internal
190 * [#89 CommentsParser.State contains unused fields](https://github.com/javaparser/javaparser/issues/89)
191 * Switched from drone.io to [Travis](https://travis-ci.org/javaparser/javaparser)
192 * [#105 Enforce compiling the library for a certain Java version](https://github.com/javaparser/javaparser/pull/105)
193
194[Code changes](https://github.com/javaparser/javaparser/compare/javaparser-parent-2.0.0...master)
195
196Version 2.0.0
197-------------
198* support Java 8