Update NEWS to reflect Netty upgrade
[odlparent.git] / docs / NEWS.rst
1 ========================
2 ODL Parent release notes
3 ========================
4
5 Version 6.0.4
6 -------------
7 This is a bug-fix upgrade from version 6.0.3.
8
9 Bug fixes
10 ~~~~~~~~~
11 * ``single-feature-test`` was using outdated repositories, including Maven Central,
12   which `broke on Jan 15, 2020 <https://support.sonatype.com/hc/en-us/articles/360041287334-Central-501-HTTPS-Required>`__.
13   This has been corrected.
14
15 Third-party dependencies
16 ~~~~~~~~~~~~~~~~~~~~~~~~
17
18 * JUnit 4.11 → 4.113, release notes:
19   * `4.12 <https://github.com/junit-team/junit4/blob/master/doc/ReleaseNotes4.12.md>`__
20   * `4.13 <https://github.com/junit-team/junit4/blob/master/doc/ReleaseNotes4.13.md>`__
21
22 * log4j2 2.11.2 → 2.13.0, release notes:
23   * `2.12.0 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.13.0>`__
24   * `2.12.1 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.12.1>`__
25   * `2.13.0 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.13.0>`__
26
27 * netty 4.1.42 → 4.1.45, release notes:
28   * `4.1.43 <https://netty.io/news/2019/10/24/4-1-43-Final.html>`__
29   * `4.1.44 <https://netty.io/news/2019/12/18/4-1-44-Final.html>`__
30   * `4.1.45 <https://netty.io/news/2020/01/13/4-1-45-Final.html>`__
31
32 Plugin upgrades
33 ~~~~~~~~~~~~~~~
34 * maven-assembly-plugin 2.2-beta5 → 3.2.0
35
36 * maven-archetype-plugin `3.1.1 → 3.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12345957>`__
37
38 Version 6.0.3
39 -------------
40 This is a bug-fix upgrade from version 6.0.2.
41
42 Bug fixes
43 ~~~~~~~~~
44 * The fix for `ODLPARENT-216 <https://jira.opendaylight.org/browse/ODLPARENT-216>`__ ended up
45   breaking ``org.kohsuke.metainf-services`` integration. While this could be fixed in downstreams
46   by adding proper </annotationProcessorPaths> entry, it is a regression from 6.0.1.
47
48 Version 6.0.2
49 -------------
50 This is a security/bug-fix upgrade from version 6.0.1.
51
52 Bug fixes
53 ~~~~~~~~~
54 * ``single-feature-parent`` was setting up Karaf repositories incorrectly, leading to
55   the test using unpatched Karaf resources. This has now been fixed and the test run
56   is using environment equivalent to the contents of the distribution. See
57   `ODLPARENT-209 <https://jira.opendaylight.org/browse/ODLPARENT-209>`__ for details.
58
59 * ``immutables.org`` integration relied on pre-JDK9 way of integration, where the annotation processor
60   was just dropped as a dependency. This does not work with JDK9+ artifacts which are also explicit
61   JMPS modules. Note that users are advised to switch to depending on the ``annotations``-classified
62   artifact. See `ODLPARENT-216 <https://jira.opendaylight.org/browse/ODLPARENT-216>`__ for details.
63
64 * Assembled Karaf distribution did not perform proper JDK checks and allowed launching with JDK8,
65   leading to a failure to install OpenDaylight components with an error stack, which confuses users
66   not familiar with OSGi. The distribution now refuses to start with anything other than JDK11. See
67   `ODLPARENT-218 <https://jira.opendaylight.org/browse/ODLPARENT-218>`__ for details.
68
69 Third-party dependencies
70 ~~~~~~~~~~~~~~~~~~~~~~~~
71
72 * Akka `2.5.25 → 2.5.26 <https://akka.io/blog/news/2019/10/17/akka-2.5.26-released>`__
73
74 * Checkstyle 8.20 → 8.26, release notes:
75   * `8.21 <https://checkstyle.org/releasenotes.html#Release_8.21>`__
76   * `8.22 <https://checkstyle.org/releasenotes.html#Release_8.22>`__
77   * `8.23 <https://checkstyle.org/releasenotes.html#Release_8.23>`__
78   * `8.24 <https://checkstyle.org/releasenotes.html#Release_8.24>`__
79   * `8.25 <https://checkstyle.org/releasenotes.html#Release_8.25>`__
80   * `8.26 <https://checkstyle.org/releasenotes.html#Release_8.26>`__
81
82 * H2 database `1.4.199 → 1.4.200 <http://www.h2database.com/html/changelog.html>`__
83
84 * Hamcrest `2.1 → 2.2 <https://github.com/hamcrest/JavaHamcrest/releases/tag/v2.2>`__
85
86 * JaCoCo `0.8.4 → 0.8.5 <https://github.com/jacoco/jacoco/releases/tag/v0.8.5>`__
87
88 * Karaf 4.2.2 → 4.2.6, release notes:
89   * `4.2.3 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12344587>`__
90   * `4.2.4 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12344856>`__
91   * `4.2.5 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12345153>`__
92   * `4.2.6 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12345365>`__
93
94 * Powermock `2.0.2 → 2.0.4 <https://github.com/powermock/powermock/blob/release/2.x/docs/release-notes/official.md#204>`__
95
96 * Sevntu `1.35.0 → 1.36.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.36.0>`__
97
98 Plugin upgrades
99 ~~~~~~~~~~~~~~~
100
101 * maven-bundle-plugin `4.1.0 → 4.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12345491>`__
102
103 * maven-jar-plugin `3.1.2 → 3.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317526&version=12345503>`__
104
105 * maven-source-plugin `3.1.0 → 3.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317924&version=12345522>`__
106
107 * modernizer-maven-plugin `1.9.0 → 2.0.0 <https://github.com/gaul/modernizer-maven-plugin/releases/tag/modernizer-maven-plugin-2.0.0>`__
108
109 Version 6.0.1
110 -------------
111 This is a security/bug-fix upgrade from version 6.0.0.
112
113 Bug fixes
114 ~~~~~~~~~
115 * ``karaf-plugin`` ignored exceptions coming from its failure to resolve ${karaf.etc} variable. This
116   has now been fixed and the URL handling has been revised to fix build on Windows. See
117   `ODLPARENT-214 <https://jira.opendaylight.org/browse/ODLPARENT-214>`__ for details.
118
119 * ``leveldb-jni`` jar, which has been seeded to nexus.opendaylight.org long time ago is not published
120   in Maven Central. This has been resolved by repackaging this jar and publishing it from odlparent.
121   See `ODLPARENT-210 <https://jira.opendaylight.org/browse/ODLPARENT-210>`__ for details.
122
123 Third-party dependencies
124 ~~~~~~~~~~~~~~~~~~~~~~~~
125
126 * Bouncy Castle `1.63 → 1.64 <http://www.bouncycastle.org/releasenotes.html>`__
127
128 * Jackson `2.9.9 → 2.9.10 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.10>`__
129
130 * Javassist 3.24.1-GA → 3.26.0-GA
131
132 * Guice 4.1.0 → 4.2.2, release notes:
133   * `4.2.0 <https://github.com/google/guice/wiki/Guice42>`__
134   * `4.2.1 <https://github.com/google/guice/wiki/Guice421>`__
135   * `4.2.2 <https://github.com/google/guice/wiki/Guice422>`__
136
137 * Mockito 2.25.1 → 2.28.2, release notes:
138   * `2.25.2 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2252>`__
139   * `2.25.3 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2253>`__
140   * `2.25.4 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2254>`__
141   * `2.25.5 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2255>`__
142   * `2.25.6 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2256>`__
143   * `2.25.7 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2257>`__
144   * `2.26.1 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2261>`__
145   * `2.26.2 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2262>`__
146   * `2.27.1 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2271>`__
147   * `2.27.2 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2272>`__
148   * `2.27.3 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2273>`__
149   * `2.27.4 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2274>`__
150   * `2.27.5 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2275>`__
151   * `2.28.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2280>`__
152
153 * Netty 4.1.39 → 4.1.42, release notes:
154   * `4.1.41 <https://netty.io/news/2019/09/12/4-1-41-Final.html>`__
155   * `4.1.42 <https://netty.io/news/2019/09/25/4-1-42-Final.html>`__
156
157 * pt-triemap `1.0.6 → 1.1.0 <https://github.com/PantheonTechnologies/triemap/releases/tag/triemap-1.1.0>`__
158
159 * reactive-streams `1.0.2 → 1.0.3 <http://www.reactive-streams.org/announce-1.0.3>`__
160
161 * stax2-api `3.1.4 → 4.2 <https://github.com/FasterXML/stax2-api/blob/master/release-notes/VERSION>`__
162
163 * woodstox-core 5.0.3 → 5.3.0, release notes:
164   * `5.1.0 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-5.1>`__
165   * `5.2.0 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-5.2>`__
166   * `5.3.0 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-5.3>`__
167
168 Version 6.0.0
169 -------------
170 This is a major upgrade from version 5, with breaking changes; projects will
171 need to make changes to upgrade to this version.
172
173 Java 11 is required
174 ~~~~~~~~~~~~~~~~~~~
175 This release sets ``maven.compiler.release=11`` and enforces that the JDK used to build
176 is Java 11+. As there may be issues with various maven plugins when faced with JDK9+
177 constructs and JDK11+ classes, target release can be controlled on a per-artifact
178 basis (i.e. target Java 10 with ``maven.compiler.release=10`` property).
179
180 This release has been validated with ``openjdk-11.0.4`` and is not supported on any lower
181 version. As usual, we recommend using latest available JDK/JRE for Java 11 during development
182 and deployment.
183
184 Checkstyle/SpotBugs/Modernizer run by default
185 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
186 With this release code artifacts always run ``maven-checkstyle-plugin``, ``spotbugs-maven-plugin``
187 and ``modernizer-maven-plugin``. Checkstyle and SpotBugs run in enforcing mode, i.e. will fail
188 build if any violations are found. Modernizer is configured to report Java 8-compatible constructs
189 and will not fail the build unless instructed to do so.
190
191 Behavior of each of these is controlled via a maven property on a per-artifact basis:
192
193 * ``odlparent.checkstyle.enforce`` controls checkstyle enforcement: defaults to ``true``, but can be set to ``false``
194 * ``odlparent.checkstyle.skip`` controls checkstyle invocation: defaults to ``false``, but can be set to ``true``
195 * ``odlparent.spotbugs.enforce`` controls SpotBugs enforcement: defaults to ``true``, but can be set to ``false``
196 * ``odlparent.spotbugs.skip`` controls SpotBugs invocation: defaults to ``false``, but can be set to ``true``
197 * ``odlparent.modernizer.enforce`` controls modernizer enforcement: defaults to ``false``, but can be set to ``true``
198 * ``odlparent.modernizer.skip`` controls modernizer invocation: defaults to ``false``, but can be set to ``true``
199 * ``odlparent.modernizer.target`` controls modernizer Java version: defaults to ``1.8``, but can be set to ``1.11`` or similar
200
201 Bug fixes
202 ~~~~~~~~~
203
204 * ``blueprint container`` had ``org.apache.aries.blueprint.preemptiveShutdown`` set to false
205   to enable it to work with Config Subsystem. As that component is long gone, this property has
206   been removed as part of `ODLPARENT-34 <https://jira.opendaylight.org/browse/ODLPARENT-34>`__.
207   Furthermore, system properties related to Config Subsystem/NETCONF integration have been removed
208   as well.
209
210 Upstream version removals
211 ~~~~~~~~~~~~~~~~~~~~~~~~~
212
213 The following upstream dependencies have been removed from dependency management:
214
215 * com.google.code.findbugs/jsr305
216
217 Third-party dependencies
218 ~~~~~~~~~~~~~~~~~~~~~~~~
219
220 The dependency on `xmlunit-assertj` and `modernizer-maven-annotations` has been added and the following
221 dependencies have been upgraded:
222
223 * Akka 2.5.23 → 2.5.25, release notes:
224   * `2.5.24 <https://akka.io/blog/news/2019/08/09/akka-2.5.24-released>`__
225   * `2.5.25 <https://akka.io/blog/news/2019/08/20/akka-2.5.25-released>`__
226
227 * apache-sshd `2.2.0 → 2.3.0 <https://github.com/apache/mina-sshd/blob/master/docs/changes/2.3.0.md>`__
228
229 * Bouncy Castle `1.62 → 1.63 <https://www.bouncycastle.org/releasenotes.html>`__
230
231 * commons-beanutils `1.9.3 → 1.9.4 <https://www.apache.org/dist/commons/beanutils/RELEASE-NOTES.txt>`__
232
233 * commons-codec `1.12 → 1.13 <http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt>`__
234
235 * commons-text 1.6 → 1.8, release notes:
236   * `1.7 <https://commons.apache.org/proper/commons-text/changes-report.html#a1.7>`__
237   * `1.8 <https://commons.apache.org/proper/commons-text/changes-report.html#a1.8>`__
238
239 * Checkstyle 8.18 → 8.20, release notes:
240   * `8.19 <https://checkstyle.org/releasenotes.html#Release_8.19>`__
241   * `8.20 <https://checkstyle.org/releasenotes.html#Release_8.20>`__
242
243 * jackson-databind `2.9.9 → 2.9.9.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9#micro-patches>`__
244
245 * jaxb-api 2.2.8 → 2.3.0, aligning it with Karaf-provided version
246
247 * Netty 4.1.36 → 4.1.39, release notes:
248   * `4.1.37 <https://netty.io/news/2019/06/28/4-1-37-Final.html>`__
249   * `4.1.38 <https://netty.io/news/2019/07/24/4-1-38-Final.html>`__
250   * `4.1.39 <https://netty.io/news/2019/08/13/4-1-39-Final.html>`__
251
252 * Sevntu 1.32.0 → 1.35.0, release notes:
253   * `1.33.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.33.0>`__
254   * `1.34.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.34.0>`__
255   * `1.34.1 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.34.1>`__
256   * `1.35.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.35.0>`__
257
258 * Scala 2.12.8 → 2.12.9, release notes:
259   * `2.12.9 <https://github.com/scala/scala/releases/tag/v2.12.9>`__
260   * `2.12.10 <https://github.com/scala/scala/releases/tag/v2.12.10>`__
261
262 * slf4j `1.7.25 → 1.7.28 <https://www.slf4j.org/news.html>`__
263
264 * triemap `1.0.5 → 1.0.6 <https://github.com/PantheonTechnologies/triemap/releases/tag/triemap-1.0.6>`__
265
266 * typesafe/ssl-config `0.3.7 → 0.3.8 <https://github.com/lightbend/ssl-config/compare/v0.3.7...v0.3.8>`__
267
268 * Xtend 1.17.1 → 1.19.0, release notes:
269   * `1.18.0 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/06/04/version-2-18-0>`__
270   * `1.19.0 <https://www.eclipse.org/Xtext/releasenotes.html#/releasenotes/2019/09/03/version-2-19-0>`__
271
272 Plugin upgrades
273 ~~~~~~~~~~~~~~~
274
275 * git-commit-id-plugin 2.2.6 → 3.0.1, release notes:
276   * `3.0.0 <https://github.com/git-commit-id/maven-git-commit-id-plugin/releases/tag/v3.0.0>`__
277   * `3.0.1 <https://github.com/git-commit-id/maven-git-commit-id-plugin/releases/tag/v3.0.1>`__
278
279 * maven-javadoc-plugin `3.1.0 → 3.1.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12345060>`__
280
281 * pmd-maven-plugin `3.11.0 → 3.12.0 <https://blogs.apache.org/maven/entry/apache-maven-pmd-plugin-version1>`__
282
283 * spotbugs-maven-plugin 3.1.11  → 3.1.12.2, release notes:
284   * `3.1.12 <https://github.com/spotbugs/spotbugs-maven-plugin/compare/spotbugs-maven-plugin-3.1.11...spotbugs-maven-plugin-3.1.12>`__
285   * `3.1.12.1 <https://github.com/spotbugs/spotbugs-maven-plugin/releases/tag/spotbugs-maven-plugin-3.1.12.1>`__
286   * `3.1.12.2 <https://github.com/spotbugs/spotbugs-maven-plugin/releases/tag/spotbugs-maven-plugin-3.1.12.2>`__
287
288 Version 5.0.1
289 -------------
290
291 This is a bug-fix upgrade from version 5.0.0.
292
293 Third-party dependencies
294 ~~~~~~~~~~~~~~~~~~~~~~~~
295
296 The following dependencies have been upgraded:
297
298 * Akka 2.5.21 → 2.5.23, release notes:
299   * `2.5.22 <https://akka.io/blog/news/2019/04/03/akka-2.5.22-released>`__
300   * `2.5.23 <https://akka.io/blog/news/2019/05/21/akka-2.5.23-released>`__
301
302 * asciidoctorj-diagram 1.5.12 → 1.5.16
303
304 * Bouncy Castle `1.61 → 1.62 <http://www.bouncycastle.org/releasenotes.html>`__
305
306 * commons-lang3 `3.8.1 → 3.9 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__
307
308 * JaCoCo `0.8.3 → 0.8.4 <https://github.com/jacoco/jacoco/releases/tag/v0.8.4>`__
309
310 * Jackson `2.9.8 → 2.9.9 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.9>`__
311
312 * Jolokia 1.6.0 → 1.6.2, release notes:
313   * `1.6.1 <https://jolokia.org/changes-report.html#a1.6.1>`__
314   * `1.6.2 <https://jolokia.org/changes-report.html#a1.6.2>`__
315
316 * Mockito `2.25.0 → 2.25.1 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2251>`__
317
318 * Netty 4.1.34 → 4.1.36, release notes:
319   * `4.1.35 <https://netty.io/news/2019/04/17/4-1-35-Final.html>`__
320   * `4.1.36 <https://netty.io/news/2019/04/30/4-1-36-Final.html>`__
321
322 * PowerMock 2.0.0 → 2.0.2, release notes:
323   * `2.0.1 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.1>`__
324   * `2.0.2 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.2>`__
325
326 * Reactive Streams `1.0.1 → 1.0.2 <https://www.lightbend.com/blog/update-reactive-streams-102-released>`__
327
328 * scala-parser-combinators `1.1.1 → 1.1.2 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.2>`__
329
330 * Sevntu `1.32.0 → 1.33.0 <http://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.33.0>`__
331
332 * Typesafe Config `1.3.2 → 1.3.3 <https://github.com/lightbend/config/releases/tag/v1.3.3>`__
333
334 * triemap `1.0.4 → 1.0.5 <https://github.com/PantheonTechnologies/triemap/releases/tag/triemap-1.0.5>`__
335
336 * XBean finder 4.12 → 4.14, release notes:
337   * `4.13 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12344253&projectId=12310312>`__
338   * `4.14 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12345220>`__
339
340 * xmlunit `2.6.2 → 2.6.3 <https://github.com/xmlunit/xmlunit/releases/tag/v2.6.3>`__
341
342 * Xtend `2.17.0 → 2.17.1 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/04/03/version-2-17-1>`__
343
344 Plugin upgrades
345 ~~~~~~~~~~~~~~~
346
347 * maven-archetype-plugin 3.0.1 → 3.1.1, release notes:
348   * `3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12340346>`__
349   * `3.1.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12345450>`__
350
351 * maven-bundle-plugin `4.1.0 → 4.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12345047>`__
352
353 * maven-checkstyle-plugin `3.1.0 → 3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317223&version=12342397>`__
354
355 * maven-compiler-plugin `3.8.0 → 3.8.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317225&version=12343484>`__
356
357 * maven-help-plugin `3.1.1 → 3.2.0 <https://blog.soebes.de/blog/2019/04/22/apache-maven-help-plugin-version-3-dot-2-0-released/>`__
358
359 * maven-jar-plugin `3.1.1 → 3.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317526&version=12344629>`__
360
361 * maven-plugin-plugin `3.5.2 → 3.6.0 <https://blogs.apache.org/maven/entry/apache-maven-plugin-tools-version1>`__
362
363 * maven-source-plugin `3.0.1 → 3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317924&version=12336941>`__
364
365 * maven-surefire-plugin 2.22.1 → 2.22.2
366
367 New plugins
368 ~~~~~~~~~~~
369
370 * ``modernizer-maven-plugin`` declared, allowing downstreams to more easily activate it,
371   and so detect code which should be updated to more modern equivalent.
372
373 New features
374 ~~~~~~~~~~~~
375
376 * ``odl-caffeine-2`` provides a pre-packaged feature for the Caffeine caching framework,
377   along with the Guava compabitility layer.
378
379 Version 5.0.0
380 -------------
381
382 This is a major upgrade from version 4, with breaking changes; projects will
383 need to make changes to upgrade to this version.
384
385 The most significant change is `ODLPARENT-198 <https://jira.opendaylight.org/browse/ODLPARENT-198>`__,
386 which removes JSR305 from default dependencies and does not present it at class path by default.
387
388 Deleted artifacts
389 ~~~~~~~~~~~~~~~~~
390
391 ``findbugs`` has been removed, as its only purpose was to provide FindBugs
392 rule definitions. Equivalent definitions are available in ``spotbugs``.
393
394 Bug fixes
395 ~~~~~~~~~
396
397 * ``blueprint-maven-plugin`` used to scan the entire classpath, resulting in potential conflicts
398   across projects. Scanning is now limited to ``${project.groupId}``, limiting conflict domain
399   to single project. See `ODLPARENT-109 <https://jira.opendaylight.org/browse/ODLPARENT-109>`__.
400
401 * ``bundle-maven-plugin`` configuration ignored generated ServiceLoader service entries,
402   which has now been fixed. See `ODLPARENT-197 <https://jira.opendaylight.org/browse/ODLPARENT-197>`__.
403
404 * Bundle tests are now enabled by default. See `ODLPARENT-158 <https://jira.opendaylight.org/browse/ODLPARENT-158>`__
405   and `ODLPARENT-80 <https://jira.opendaylight.org/browse/ODLPARENT-80>`__ for details.
406
407 * Karaf log file rollover was not explictly set up, leading to inability to easily override
408   the defaults. See `ODLPARENT-153 <https://jira.opendaylight.org/browse/ODLPARENT-153>`__ for details.
409
410 * Karaf log file used to use default maximum 16MiB file size, this has now been increased to 64MiB.
411   See `ODLPARENT-154 <https://jira.opendaylight.org/browse/ODLPARENT-154>`__.
412
413 * ``features-test`` excluded opendaylight-karaf-empty's transitive dependencies, leading
414   to the need to re-declare them in single-feature-parent. This re-declaration was forgotten
415   in for ``bcpkix-framework-ext`` and ``bcprov-framework-ext`` bundles, which lead to them
416   not being present in the local repository. See `ODLPARENT-130 <https://jira.opendaylight.org/browse/ODLPARENT-130>`__.
417
418 Upstream version removals
419 ~~~~~~~~~~~~~~~~~~~~~~~~~
420
421 The following upstream dependencies have been removed from dependency management:
422
423 * cassandra-driver-core
424
425 * org.codehaus.enunciate/enunciate-core-annotations
426
427 * org.jboss.resteasy/jaxrs-api
428
429 * org.json/json
430
431 * org.osgi/org.osgi.compendium
432
433 Removed features
434 ~~~~~~~~~~~~~~~~
435
436 * odl-jersey-1
437
438 * ``features-akka`` feature repository has been integrated into ``features-odlparent``
439
440 Third-party dependencies
441 ~~~~~~~~~~~~~~~~~~~~~~~~
442
443 The following dependencies have been upgraded:
444
445 * apache-sshd `2.0.0 → 2.2.0 <https://github.com/apache/mina-sshd/compare/sshd-2.0.0...sshd-2.2.0>`__
446
447 * Aeron 1.12.0 → 1.15.3, release notes:
448   * `1.13.0 <https://github.com/real-logic/aeron/releases/tag/1.13.0>`__
449   * `1.14.0 <https://github.com/real-logic/aeron/releases/tag/1.14.0>`__
450   * `1.15.0 <https://github.com/real-logic/aeron/releases/tag/1.15.0>`__
451   * `1.15.1 <https://github.com/real-logic/aeron/releases/tag/1.15.1>`__
452   * `1.15.2 <https://github.com/real-logic/aeron/releases/tag/1.15.2>`__
453   * `1.15.3 <https://github.com/real-logic/aeron/releases/tag/1.15.3>`__
454
455 * Agrona 0.9.27 → 0.9.33, release notes:
456   * `0.9.28 <https://github.com/real-logic/agrona/releases/tag/0.9.28>`__
457   * `0.9.29 <https://github.com/real-logic/agrona/releases/tag/0.9.29>`__
458   * `0.9.30 <https://github.com/real-logic/agrona/releases/tag/0.9.30>`__
459   * `0.9.31 <https://github.com/real-logic/agrona/releases/tag/0.9.31>`__
460   * `0.9.32 <https://github.com/real-logic/agrona/releases/tag/0.9.32>`__
461   * `0.9.33 <https://github.com/real-logic/agrona/releases/tag/0.9.33>`__
462
463 * Akka 2.5.19 → 2.5.21, release notes:
464   * `2.5.20 <https://akka.io/blog/news/2019/01/29/akka-2.5.20-released>`__
465   * `2.5.21 <https://akka.io/blog/news/2019/02/13/akka-2.5.21-released>`__
466
467 * antl4r `4.7.1 → 4.7.2 <https://github.com/antlr/antlr4/releases/tag/4.7.2>`__
468
469 * asciidoctorj-diagram 1.5.11 → 1.5.12
470
471 * Bouncy Castle `1.60 → 1.61 <http://www.bouncycastle.org/releasenotes.html>`__
472
473 * checkstyle 8.16 → 8.18, release notes:
474   * `8.17 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.17>`__
475   * `8.18 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.18>`__
476
477 * commons-codec `1.11 → 1.12 <http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt>`__
478
479 * Google Error Prone 2.3.2 → 2.3.3
480
481 * Google Guava 25.1 → 27.1, release notes:
482   * `26.0 <https://github.com/google/guava/releases/tag/v26.0>`__
483   * `27.0 <https://github.com/google/guava/releases/tag/v27.0>`__
484   * `27.0.1 <https://github.com/google/guava/releases/tag/v27.0.1>`__
485   * `27.1 <https://github.com/google/guava/releases/tag/v27.1>`__
486
487 * Google Truth `0.42 → 0.43 <https://github.com/google/truth/releases/tag/release_0_43>`__
488
489 * h2 database `1.4.196 → 1.4.199 <http://www.h2database.com/html/changelog.html>`__
490
491 * Immutables `2.7.3 → 2.7.5 <https://github.com/immutables/immutables/#changelog>`__
492
493 * Javassist `3.24.0-GA → 3.24.1-GA <https://github.com/jboss-javassist/javassist/releases/tag/rel_3_24_1_ga>`__
494
495 * log4j2 `2.11.1 → 2.11.2 <https://github.com/apache/logging-log4j2/blob/log4j-2.11.2/RELEASE-NOTES.md>`__
496
497 * Mockito 2.23.4 → 2.25.0, release notes:
498   * `2.24.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2240>`__
499   * `2.25.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2250>`__
500
501 * Netty 4.1.32 → 4.1.34, release notes:
502   * `4.1.32 <https://netty.io/news/2018/11/29/4-1-32-Final.html>`__
503   * `4.1.33 <https://netty.io/news/2019/01/21/4-1-33-Final.html>`__
504   * `4.1.34 <https://netty.io/news/2019/03/08/4-1-34-Final.html>`__
505
506 * OSGi 5.0.0 → 6.0.0
507
508 * Powermockito 1.7.4 → 2.0.0, release notes:
509   * `2.0.0-beta.5 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0-beta.5>`__
510   * `2.0.0-RC.1 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0-RC.1>`__
511   * `2.0.0 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0>`__
512
513 * SpotBugs `3.1.9 → 3.1.12 <https://github.com/spotbugs/spotbugs/blob/3.1.12/CHANGELOG.md>`__
514
515 * ThreeTen `1.4.0 → 1.5.0 <https://www.threeten.org/threeten-extra/changes-report.html#a1.5.0>`__
516
517 * Xtend `2.16.0 → 2.17.0 <http://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/03/05/version-2-17-0>`__
518
519 Plugin removals
520 ~~~~~~~~~~~~~~~
521
522 * gmaven-plugin
523
524 * maven-findbugs-plugin
525
526 Plugin upgrades
527 ~~~~~~~~~~~~~~~
528
529 * jacoco-maven-plugin `0.8.2 → 0.8.3 <https://github.com/jacoco/jacoco/releases/tag/v0.8.3>`__
530
531 * maven-invoker-plugin `3.1.0 → 3.2.0 <https://mail-archives.apache.org/mod_mbox/maven-announce/201901.mbox/%3Cop.zvzdg9tbkdkhrr@desktop-2khsk44%3E>`__
532
533 * maven-javadoc-plugin `3.0.1 → 3.1.0 <https://mail-archives.apache.org/mod_mbox/maven-announce/201903.mbox/%3C6064d830-474c-4b43-afef-99502c3a305a%40getmailbird.com%3E>`__
534
535 * spotbugs-maven-plugin 3.1.8 → 3.1.11
536
537 Version 4.0.9
538 -------------
539
540 This is a bug-fix upgrade from version 4.0.8.
541
542 Bug fixes
543 ~~~~~~~~~
544
545 * ``karaf-plugin`` invocation in ``karaf4-parent`` caused previously
546   patched features to be overwritten with their stock versions, referencing
547   bundles which were not populated in the local repository. (See
548   `ODLPARENT-194 <https://jira.opendaylight.org/browse/ODLPARENT-194>`__.)
549
550 * ``karaf-plugin`` version in ``karaf4-parent`` is now provided through
551   plugin management so downstreams can override it without needing
552   to repeat its configuration.
553
554 * ``karaf-plugin`` no longer reads features twice when running discovery,
555   speeding up the process a bit.
556
557 * Recent versions of the SpotBugs Maven plugin use SLF4J 1.8 beta 2, which
558   can’t use the 1.7.25 implementation we provide; we therefore provide an
559   implementation of 1.8 beta 2 when SpotBugs is used. (See
560   `ODLPARENT-184 <https://jira.opendaylight.org/browse/ODLPARENT-184>`__.)
561
562 New features
563 ~~~~~~~~~~~~
564
565 * ``odl-woodstox`` wraps the Woodstox StAX implementation which is imposed on
566   us by Karaf.
567
568 Version 4.0.8
569 -------------
570
571 This is a bug-fix and minor upstream bump upgrade from version 4.0.7.
572
573 Bug fixes
574 ~~~~~~~~~
575
576 * ``bcprov-ext-jdk15on`` is a superset of ``bcprov-jdk15on``, so there’s no
577   need to ship both; we now only ship the former. In addition, we install the
578   Bouncy Castle JARs in ``lib/boot`` so that they continue to be available on
579   the boot classpath (JDK 9 removes the extension mechanism which was used
580   previously), and provide the corresponding bundles from the boot classpath
581   instead of using separate JARs in the system repository. (See
582   `ODLPARENT-183 <https://jira.opendaylight.org/browse/ODLPARENT-183>`__ and
583   `ODLPARENT-185 <https://jira.opendaylight.org/browse/ODLPARENT-185>`__.)
584
585 * A dependency check has been added to ensure that we don’t run into the
586   TrieMap dependency bug in 4.0.6 again.
587
588 * Dependencies pulled in by features are now checked for convergence, and
589   ``karaf-plugin`` warns when it finds diverging dependencies (the same
590   artifact with two different versions). Upstream-provided features are
591   patched to avoid the following divergences (and upgrade some dependencies in
592   the process):
593
594   * Aries utilities 1.1.0/1.1.3 (upgraded to 1.1.3).
595   * Commons Beanutils 1.8.3/1.9.3 (upgraded to 1.9.3).
596   * Commons Codec 1.8/1.10 (upgraded to 1.11).
597   * ``javax.mail`` 1.4.4/1.4.7 (upgraded to 1.4.7).
598
599   (See `ODLPARENT-189 <https://jira.opendaylight.org/browse/ODLPARENT-189>`__.)
600
601 New features
602 ~~~~~~~~~~~~
603
604 * ``odl-dropwizard-metrics`` provides Dropwizard Metrics (which are also
605   available in dependency management).
606
607 * ``enunciate-maven-plugin`` is added as the replacement for
608   ``maven-enunciate-plugin``.
609
610 Third-party dependencies
611 ~~~~~~~~~~~~~~~~~~~~~~~~
612
613 The following dependencies are no longer provided by the JVM, starting with
614 version 11, but we make them available via dependency management for projects
615 which need them:
616
617 * ``javax.annotation-api``.
618
619 * JAXB (``jaxb-core``, ``jaxb-impl``).
620
621 The following dependencies have been upgraded:
622
623 * Checkstyle `8.15 → 8.16 <https://checkstyle.org/releasenotes.html#Release_8.16>`__.
624
625 * Dependency Check `4.0.0 → 4.0.2 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
626
627 * ``git-commit-id`` `2.2.5 → 2.2.6 <https://github.com/ktoso/maven-git-commit-id-plugin/releases>`__.
628
629 * Immutables 2.7.1 → 2.7.3:
630
631   * `2.7.2 <https://github.com/immutables/immutables#272-2018-11-05>`__.
632   * `2.7.3 <https://github.com/immutables/immutables#273-2018-11-10>`__.
633
634   (2.7.4 breaks our Javadocs.)
635
636 * Jackson `2.9.7 → 2.9.8 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.8>`__.
637
638 Version 4.0.7
639 -------------
640
641 This is a bug-fix release, correcting the ``triemap`` import declaration.
642
643 Version 4.0.6
644 -------------
645
646 This is a bug-fix and minor upstream packaging upgrade from version 4.0.5.
647
648 Bug fixes
649 ~~~~~~~~~
650
651 Single-feature-test was broken with JDK 9 and later and Karaf 4.2.2; this
652 release adds the additional JVM configuration needed.
653
654 Third-party dependencies
655 ~~~~~~~~~~~~~~~~~~~~~~~~
656
657 This release adds the ``triemap`` BOM to dependency management.
658
659 Version 4.0.5
660 -------------
661
662 This is a bug-fix release: the Karaf Maven plugin, in version 4.2.2, is
663 `broken <https://issues.apache.org/jira/browse/KARAF-6057>`__ in some cases we
664 need in OpenDaylight; we revert to 4.2.1 in ``karaf4-parent`` to avoid this.
665
666 Version 4.0.4
667 -------------
668
669 This is a bug-fix release, reverting the change made in 4.0.3 to handle
670 building with either ``zip`` or ``tar.gz`` Karaf archives (which breaks
671 builds in our infrastructure, without the empty Karaf archive).
672
673 Version 4.0.3
674 -------------
675
676 This is a bug-fix and minor upstream bump upgrade from version 4.0.2.
677
678 Bug fixes
679 ~~~~~~~~~
680
681 * Our FindBugs configuration for JDK 9 and later caused the plugin to run
682   everywhere; instead, this version defines the ``findbugs.skip`` property to
683   disable the plugin in modules where it would be used otherwise.
684
685 * The PowerMock declarations in dependency management missed
686   ``powermock-api-mockito2``, which is necessary for modules using PowerMock
687   with Mockito 2.
688
689 * The “quick” profile (``-Pq``) now skips SpotBugs.
690
691 * JSR-305 annotations are now optional, which fixes a number of issues when
692   building with newer JDKs.
693
694 * We provide JAXB with JDK 11 and later (where it is no longer provided by the
695   base platform).
696
697 * ``odlparent-artifacts`` has been updated to accurately represent the
698   artifacts provided.
699
700 * ``javax.activation`` is now excluded from generated features (it’s provided
701   on Karaf’s boot classpath).
702
703 * When the build is configured to build Karaf distributions in ``tar.gz``
704   archives, but not ``zip`` archives, ``features-test`` used to fail; it will
705   now used whichever is available
706   (`ODLPARENT-174 <https://jira.opendaylight.org/browse/ODLPARENT-174>`__).
707
708 * Explicit GCs are disabled by default, so that calls to ``System.gc()`` are
709   ignored
710   (`ODLPARENT-175 <https://jira.opendaylight.org/browse/ODLPARENT-175>`__).
711
712 * Null checks are disabled in SpotBugs because of bad interactions with newer
713   annotations and the bytecode produces by JDK 11 and later for
714   ``try``-with-resources.
715
716 * Akka Persistence expects LevelDB 0.10, so we now pull in that version
717   instead of 0.7.
718
719 Dependency convergence
720 ~~~~~~~~~~~~~~~~~~~~~~
721
722 A number of dependencies have been added or constrained so that projects using
723 this parent can enforce dependency convergence:
724
725 * Karaf’s ``framework`` feature is used as an import POM, so that we converge
726   by default on the versions used in Karaf.
727
728 * The following dependencies have been added to dependency management:
729
730   * ``commons-beanutils``
731   * the Checker Framework
732   * Error Prone annotations
733   * ``javax.activation``
734   * ``xml-apis``
735
736 New features
737 ~~~~~~~~~~~~
738
739 The following Karaf features have been added:
740
741 * ``odl-antlr4`` (providing ``antlr4-runtime``);
742
743 * ``odl-gson`` (providing ``gson``);
744
745 * ``odl-jersey-2`` (providing Jersey client, server, and container servlet,
746   along with the necessary feature dependencies);
747
748 * ``odl-servlet-api`` (providing ``javax.servlet-api``);
749
750 * ``odl-stax2-api`` (providing ``stax2-api``);
751
752 * ``odl-ws-rs-api`` (providing ``javax.ws.rs-api``);
753
754 A new ``sonar-jacoco-aggregate`` profile can be used to produce Sonar reports
755 with aggregated JaCoCo reports. Additionally, Sonar builds (run with
756 ``-Dsonar``) are detected and run with a number of irrelevant plugins disabled.
757
758 Upstream version upgrades
759 ~~~~~~~~~~~~~~~~~~~~~~~~~
760
761 * Akka 2.5.14 → 2.5.19 (and related ``ssl-config``, Aeron and Agrona upgrades):
762
763   * `2.5.15 <https://akka.io/blog/news/2018/08/24/akka-2.5.15-released>`__.
764   * `2.5.16 <https://akka.io/blog/news/2018/08/29/akka-2.5.16-security-fix-released>`__.
765   * `2.5.17 <https://akka.io/blog/news/2018/09/27/akka-2.5.17-released>`__.
766   * `2.5.18 <https://akka.io/blog/news/2018/10/07/akka-2.5.18-released>`__.
767   * `2.5.19 <https://akka.io/blog/news/2018/12/07/akka-2.5.19-released>`__.
768
769 * Commons Text `1.4 → 1.6 <http://www.apache.org/dist/commons/text/RELEASE-NOTES.txt>`__.
770
771 * Eclipse JDT annotations 2.2.0 → 2.2.100.
772
773 * Javassist 3.23.1 → 3.24.0.
774
775 * Karaf 4.2.1 → 4.2.2, with related upgrades.
776
777 * LMAX Disruptor `3.4.1 → 3.4.2 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.2>`__.
778
779 * Mockito `2.20.1 → 2.23.4 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md>`__.
780
781 * Netty 4.1.29 → 4.1.31:
782
783   * `4.1.30 <https://netty.io/news/2018/09/28/4-1-30-Final.html>`__.
784   * `4.1.31 <https://netty.io/news/2018/10/30/4-1-31-Final.html>`__.
785
786 * Pax Exam 4.12.0 → 4.13.1.
787
788 * Scala 2.12.6 → 2.12.8:
789
790   * `2.12.7 <https://github.com/scala/scala/releases/tag/v2.12.7>`__.
791   * `2.12.8 <https://github.com/scala/scala/releases/tag/v2.12.8>`__.
792
793 * Wagon HTTP 3.1.0 → 3.2.0.
794
795 * Xtend `2.14.0 → 2.16.0 <https://www.eclipse.org/xtend/releasenotes.html>`__.
796
797 Plugin version upgrades
798 ~~~~~~~~~~~~~~~~~~~~~~~
799
800 * Asciidoctor `1.5.6 → 1.5.7.1 <https://github.com/asciidoctor/asciidoctor-maven-plugin/releases>`__
801   (with related AsciidoctorJ upgrades).
802
803 * Bundle 4.0.0 → 4.1.0.
804
805 * Checkstyle `8.12 → 8.15 <https://checkstyle.org/releasenotes.html#Release_8.13>`__.
806
807 * DependencyCheck `3.3.2 → 4.0.0 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
808
809 * Failsafe / Surefire `2.22.0 → 2.22.1 <https://blogs.apache.org/maven/entry/apache-maven-surefire-plugin-version1>`__.
810
811 * Help 3.1.0 → 3.1.1.
812
813 * JAR 3.1.0 → 3.1.1.
814
815 * PMD `3.10.0 → 3.11.0 <https://blogs.apache.org/maven/entry/apache-maven-pmd-plugin-3>`__.
816
817 * Remote Resources `1.5 → 1.6.0 <https://blogs.apache.org/maven/entry/apache-maven-remote-resources-plugin>`__.
818
819 * Shade
820   `3.2.0 → 3.2.1 <https://blog.soebes.de/blog/2018/11/12/apache-maven-shade-plugin-version-3-dot-2-1-released/>`__.
821
822 * SpotBugs `3.1.6 → 3.1.9 <https://github.com/spotbugs/spotbugs/blob/release-3.1/CHANGELOG.md>`__.
823
824 * XBean finder 4.9 → 4.12.
825
826 * XTend 2.14.0 → 2.16.0.
827
828 Version 4.0.2
829 -------------
830
831 This is a bug-fix and minor upstream bump upgrade from version 4.0.1.
832
833 Bug fixes
834 ~~~~~~~~~
835
836 Previous releases overrode Karaf’s ``jre.properties``; this is no longer
837 necessary, and was causing failures with Java 9 and later (our version of
838 ``jre.properties`` didn’t have the appropriate settings for anything after
839 Java 8). This release drops that override. See
840 `ODLPARENT-168 <https://jira.opendaylight.org/browse/ODLPARENT-168>`__ for
841 details.
842
843 Upstream version upgrades
844 ~~~~~~~~~~~~~~~~~~~~~~~~~
845
846 * Commons Lang `3.8 → 3.8.1 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__.
847
848 * Jackson `2.9.6 → 2.9.7 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.7>`__.
849
850 * Netty `4.1.28 → 4.1.29 <http://netty.io/news/2018/08/24/4-1-29-Final.html>`__.
851
852 Plugin version upgrades
853 ~~~~~~~~~~~~~~~~~~~~~~~
854
855 * JAR `3.0.2 → 3.1.0 <https://blog.soebes.de/blog/2018/04/10/apache-maven-jar-plugin-version-3-dot-1-dot-0-released>`__.
856
857 * Javadoc `3.0.0 → 3.0.1 <https://blogs.apache.org/maven/entry/apache-maven-javadoc-plugin-version>`__.
858
859 * Jersey `2.22.2 → 2.25.1 <https://jersey.github.io/release-notes/2.25.html>`__,
860   along with Glassfish JSON 1.0.4 → 1.1.2.
861
862 * Plugin 3.5 → 3.5.2:
863
864   * `3.5.1 <https://blog.soebes.de/blog/2018/01/22/apache-maven-plugin-tools-version-3-dot-5-1-released/>`__.
865   * `3.5.2 <https://blog.soebes.de/blog/2018/05/26/apache-mave-plugin-tools-version-3-dot-5-2-released/>`__.
866
867 * Resources `3.0.1 → 3.1.0 <https://blogs.apache.org/maven/entry/apache-maven-resources-plugin-version>`__.
868
869 Version 4.0.1
870 -------------
871
872 This is a bug-fix and minor upstream bump upgrade from version 4.0.0.
873
874 Bug fixes
875 ~~~~~~~~~
876
877 The JaCoCo execution profile was incorrect, breaking Sonar; the report is now
878 written correctly, so that Sonar can find it.
879
880 The Blueprint Maven plugin fails when it encounters Java 9 classes; this is
881 fixed by forcefully upgrading its dependency on xbean-finder. See
882 `ODLPARENT-167 <https://jira.opendaylight.org/browse/ODLPARENT-167>`__ for
883 details.
884
885 Upstream version upgrades
886 ~~~~~~~~~~~~~~~~~~~~~~~~~
887
888 * SpotBugs `3.1.6 → 3.1.7 <https://github.com/spotbugs/spotbugs/blob/release-3.1/CHANGELOG.md>`__.
889
890 Upstream version additions
891 ~~~~~~~~~~~~~~~~~~~~~~~~~~
892
893 * Mockito Inline is added alongside Mockito Core, to ensure that the versions
894   are kept in sync.
895
896 Plugin version upgrades
897 ~~~~~~~~~~~~~~~~~~~~~~~
898
899 * Clean `3.0.0 → 3.1.0 <https://blog.soebes.de/blog/2018/04/14/apache-maven-clean-plugin-version-3-dot-1-0-released/>`__.
900
901 * Compiler `3.7.0 → 3.8.0 <https://blog.soebes.de/blog/2018/07/30/apache-maven-compiler-plugin-version-3-dot-8-0-released/>`__.
902
903 * Dependency 3.0.2 → 3.1.1:
904
905   * `3.1.0 <https://blog.soebes.de/blog/2018/04/06/apache-maven-dependency-plugin-version-3-dot-1-0-released/>`__.
906   * `3.1.1 <https://blog.soebes.de/blog/2018/05/24/apache-maven-dependency-plugin-version-3-dot-1-1-released/>`__.
907
908 * Dependency Check `3.3.1 → 3.3.2 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
909
910 * Enforcer `3.0.0-M1 → 3.0.0-M2 <https://mail-archives.apache.org/mod_mbox/maven-announce/201806.mbox/%3Cop.zko9b2vhkdkhrr%40desktop-2khsk44.dynamic.ziggo.nl%3E>`__.
911
912 * Failsafe 2.20.1 → 2.22:
913
914   * `2.21 <https://blog.soebes.de/blog/2018/03/06/apache-maven-surefire-plugin-version-2-dot-21-released/>`__.
915   * `2.22 <https://blog.soebes.de/blog/2018/06/16/apache-maven-surefire-plugin-version-2-dot-22-released/>`__.
916
917 * Help 2.2 → 3.1.0:
918
919   * `3.0.0 <https://blog.soebes.de/blog/2018/03/18/apache-maven-help-plugin-version-3-dot-0-0-released/>`__.
920   * `3.0.1 <https://blog.soebes.de/blog/2018/03/28/apache-maven-help-plugin-version-3-dot-0-1-released/>`__.
921   * `3.1.0 <https://blog.soebes.de/blog/2018/06/09/apache-maven-help-plugin-version-3-dot-1-0-released/>`__.
922
923 * Invoker 2.0.0 → 3.1.0:
924
925   * `3.0.0 <https://blog.soebes.de/blog/2017/05/24/apache-maven-invoker-plugin-version-3-dot-0-0-released/>`__.
926   * `3.1.0 <https://blog.soebes.de/blog/2018/05/31/apache-maven-invoker-plugin-version-3-dot-1-0-released/>`__.
927
928 * JAR `3.0.2 → 3.1.0 <https://blog.soebes.de/blog/2018/04/10/apache-maven-jar-plugin-version-3-dot-1-dot-0-released/>`__.
929
930 * Project Info Reports `2.9 → 3.0.0 <https://blog.soebes.de/blog/2018/06/27/apache-maven-project-info-reports-plugin-3-dot-0-0-released/>`__.
931
932 * Resources `3.0.1 → 3.1.0 <https://blog.soebes.de/blog/2018/05/01/apache-maven-resources-plugin-version-3-dot-1-0-released/>`__.
933
934 * Shade `3.1.0 → 3.2.0 <https://blog.soebes.de/blog/2018/09/13/apache-maven-shade-plugin-version-3-dot-2-0-released/>`__.
935
936 * Site `3.7 → 3.7.1 <https://blog.soebes.de/blog/2018/04/29/apache-maven-site-plugin-version-3-dot-7-1-released/>`__.
937
938 * Surefire 2.18.1 → 2.22.0:
939
940   * `2.19 <https://blog.soebes.de/blog/2015/10/19/apache-maven-surefire-plugin-version-2-dot-19-released/>`__.
941   * `2.19.1 <https://blog.soebes.de/blog/2016/01/03/apache-maven-surefire-plugin-version-2-dot-19-dot-1-released/>`__.
942   * `2.20 <https://blog.soebes.de/blog/2017/04/12/apache-maven-surefire-plugin-version-2-dot-20-released/>`__.
943   * `2.21 <https://blog.soebes.de/blog/2018/03/06/apache-maven-surefire-plugin-version-2-dot-21-released/>`__.
944   * `2.22 <https://blog.soebes.de/blog/2018/06/16/apache-maven-surefire-plugin-version-2-dot-22-released/>`__.
945
946
947 Version 4.0.0
948 -------------
949
950 This is a major upgrade from version 3, with breaking changes; projects will
951 need to make changes to upgrade to this version.
952
953 `This Wiki page <https://wiki.opendaylight.org/view/Neon_platform_upgrade>`__
954 has detailed step-by-step migration instructions.
955
956 ODL Parent 4 requires Maven 3.5.3 or later; this is needed in particular to
957 enable SpotBugs support with current versions of the SpotBugs plugin.
958
959 Known issues
960 ~~~~~~~~~~~~
961
962 This release’s SpotBugs support doesn’t handle Guava 25.1 correctly, resulting
963 in false-positives regarding null handling; see
964 `ODLPARENT-161 <https://jira.opendaylight.org/browse/ODLPARENT-161>`__ for
965 details. Until this is fixed, the corresponding warnings are disabled, which
966 matches our existing FindBugs configuration (which suffers from the a variant
967 of this, with the same consequences).
968
969 We are planning on upgrading Akka during the 4.x cycle, even if it results in
970 a technically breaking upgrade. This is currently blocked on an OSGi bug in
971 Akka; see `Akka issue 25579 <https://github.com/akka/akka/issues/25579>`__ for
972 details.
973
974 Blueprint and OSGi service handling
975 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
976
977 Previous releases used an OpenDaylight-specific directory for Blueprint XML
978 files, ``org/opendaylight/blueprint``. It turned out this wasn’t useful, so
979 version 4 uses the default directory, ``OSGI-INF/blueprint``.
980
981 The Maven bundle plugin is now configured to omit the ``Import-Service`` and
982 ``Export-Service`` headers, since they are deprecated, unnecessary in
983 OpenDaylight, and liable to cause issues.
984
985 With previous releases of OpenDaylight, projects were encouraged to use Pax
986 CDI API annotations to describe their Blueprint beans, services and injections;
987 with version 4, Blueprint annotations should be used instead:
988
989 * modules should depend on
990   ``org.apache.aries.blueprint:blueprint-maven-plugin-annotation``, with the
991   ``<optional>true</optional>`` flag, instead of
992   ``org.ops4j.pax.cdi:pax-cdi-api``;
993
994 * ``@OsgiServiceProvider`` on bean definitions is replaced by ``@Service``;
995
996 * ``@OsgiService`` at injection points is replaced by ``@Reference``;
997
998 * ``@OsgiService`` on bean definitions, while technically wrong, can be seen in
999   the OpenDaylight codebase; this is replaced by ``@Service``;
1000
1001 * service lists can be injected using ``@ReferenceList``.
1002
1003 See `this Gerrit patch <https://git.opendaylight.org/gerrit/75699>`__ for an
1004 example.
1005
1006 Compiler settings
1007 ~~~~~~~~~~~~~~~~~
1008
1009 Builds now warn about unchecked type uses (such as raw types where generics
1010 are available).
1011
1012 JUnit and Mockito are always available as test dependencies and no longer need
1013 to be declared in POMs.
1014
1015 New build profiles
1016 ~~~~~~~~~~~~~~~~~~
1017
1018 An OWASP profile is now available to run OWASP’s dependency checker; this will
1019 check all third-party dependencies against the NVD vulnerability database. To
1020 enable this, run Maven with ``-Powasp``.
1021
1022 Build profile changes
1023 ~~~~~~~~~~~~~~~~~~~~~
1024
1025 ``-Pq`` now skips Modernizer.
1026
1027 New features
1028 ~~~~~~~~~~~~
1029
1030 ``odl-akka-leveldb-0.10`` wraps LevelDB 0.10 for Akka.
1031
1032 ``odl-apache-commons-codec`` wraps Apache Commons Codec.
1033
1034 ``odl-apache-commons-lang3`` wraps Apache Commons Lang 3.
1035
1036 ``odl-apache-commons-net`` wraps Apache Commons Net.
1037
1038 ``odl-apache-commons-text`` wraps Apache Commons Text.
1039
1040 ``odl-apache-sshd`` wraps Apache SSHD.
1041
1042 ``odl-guava`` provides the default ODL version of Guava; it should be used
1043 instead of ``odl-guava-23`` or the new ``odl-guava-25``.
1044
1045 ``odl-jackson-2.9`` wraps Jackson 2.9.
1046
1047 New FindBugs and SpotBugs settings
1048 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1049
1050 FindBugs and SpotBugs are configured with
1051 `the SLF4J extension <http://kengotoda.github.io/findbugs-slf4j/>`__ (version
1052 1.4.0 for FindBugs, 1.4.1 for SpotBugs). This will flag misused SLF4J calls, in
1053 particular message templates which don’t match the arguments, and invalid
1054 placeholders (*e.g.* ``%s`` instead of ``{}``).
1055
1056 Deleted artifacts
1057 ~~~~~~~~~~~~~~~~~
1058
1059 ``aggregator-parent`` was unusable outside ``odlparent`` and has been removed.
1060 Instead, the ``maven.deploy.skip`` and ``maven.install.skip`` properties are
1061 available to disable deploying and installing artifacts.
1062
1063 Upstream version upgrades
1064 ~~~~~~~~~~~~~~~~~~~~~~~~~
1065
1066 This version upgrades the following third-party dependencies:
1067
1068 * Aeron 1.7.0 → 1.9.3:
1069
1070   * `1.8.0 <https://github.com/real-logic/aeron/releases/tag/1.8.0>`__.
1071   * `1.8.1 <https://github.com/real-logic/aeron/releases/tag/1.8.1>`__.
1072   * `1.8.2 <https://github.com/real-logic/aeron/releases/tag/1.8.2>`__.
1073   * `1.9.0 <https://github.com/real-logic/aeron/releases/tag/1.9.0>`__.
1074   * `1.9.1 <https://github.com/real-logic/aeron/releases/tag/1.9.1>`__.
1075   * `1.9.2 <https://github.com/real-logic/aeron/releases/tag/1.9.2>`__.
1076   * `1.9.3 <https://github.com/real-logic/aeron/releases/tag/1.9.3>`__.
1077
1078 * Agrona 0.9.12 → 0.9.21:
1079
1080   * `0.9.13 <https://github.com/real-logic/agrona/releases/tag/0.9.13>`__.
1081   * `0.9.14 <https://github.com/real-logic/agrona/releases/tag/0.9.14>`__.
1082   * `0.9.15 <https://github.com/real-logic/agrona/releases/tag/0.9.15>`__.
1083   * `0.9.16 <https://github.com/real-logic/agrona/releases/tag/0.9.16>`__.
1084   * `0.9.17 <https://github.com/real-logic/agrona/releases/tag/0.9.17>`__.
1085   * `0.9.18 <https://github.com/real-logic/agrona/releases/tag/0.9.18>`__.
1086   * `0.9.19 <https://github.com/real-logic/agrona/releases/tag/0.9.19>`__.
1087   * `0.9.20 <https://github.com/real-logic/agrona/releases/tag/0.9.20>`__.
1088   * `0.9.21 <https://github.com/real-logic/agrona/releases/tag/0.9.21>`__.
1089
1090 * Akka 2.5.11 → 2.5.14:
1091
1092   * `2.5.12 <https://akka.io/blog/news/2018/04/13/akka-2.5.12-released>`__.
1093   * `2.5.13 <https://akka.io/blog/news/2018/06/08/akka-2.5.13-released>`__.
1094   * `2.5.14 <https://akka.io/blog/news/2018/07/13/akka-2.5.14-released>`__.
1095
1096 * ASM 5.1 → 6.2.1 (synchronised with Karaf).
1097
1098 * Bouncy Castle `1.59 → 1.60 <https://www.bouncycastle.org/releasenotes.html>`__.
1099
1100 * Checkstyle `8.4 → 8.12 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.12>`__.
1101
1102 * Commons Lang `3.7 → 3.8 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__.
1103
1104 * Commons Text 1.1 → 1.4:
1105
1106   * `1.2 <https://commons.apache.org/proper/commons-text/release-notes/RELEASE-NOTES-1.2.txt>`__.
1107   * `1.3 <https://commons.apache.org/proper/commons-text/release-notes/RELEASE-NOTES-1.3.txt>`__.
1108   * `1.4 <https://commons.apache.org/proper/commons-text/release-notes/RELEASE-NOTES-1.4.txt>`__.
1109
1110 * Eclipse JDT annotations 2.1.150 → 2.2.0.
1111
1112 * EclipseLink Moxy JAXB `2.7.1 → 2.7.3 <https://www.eclipse.org/eclipselink/releases/2.7.php>`__.
1113
1114 * Enunciate core annotations
1115   `2.10.1 → 2.11.1 <https://github.com/stoicflame/enunciate/releases>`__.
1116
1117 * Felix Metatype 1.1.6 → 1.2.0 (synchronised with Karaf).
1118
1119 * Google Truth `0.40 → 0.42 <https://github.com/google/truth/releases>`__.
1120
1121 * Guava 23.6.1 → 25.1:
1122
1123   * `23.4 <https://github.com/google/guava/releases/tag/v23.4>`__.
1124   * `23.5 <https://github.com/google/guava/releases/tag/v23.5>`__.
1125   * `23.6 <https://github.com/google/guava/releases/tag/v23.6>`__.
1126   * `24.0 <https://github.com/google/guava/releases/tag/v24.0>`__.
1127   * `24.1 <https://github.com/google/guava/releases/tag/v24.1>`__.
1128   * `25.0 <https://github.com/google/guava/releases/tag/v25.0>`__.
1129   * `25.1 <https://github.com/google/guava/releases/tag/v25.1>`__.
1130
1131 * Immutables `2.5.6 → 2.7.1 <https://github.com/immutables/immutables/blob/master/README.md#changelog>`__.
1132
1133 * Jackson 2.8.9 → 2.9.6:
1134
1135   * `2.9 feature overview <https://medium.com/@cowtowncoder/jackson-2-9-features-b2a19029e9ff>`__.
1136   * `2.9 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9>`__.
1137   * `2.9.1 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.1>`__.
1138   * `2.9.2 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.2>`__.
1139   * `2.9.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.3>`__.
1140   * `2.9.4 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.4>`__.
1141   * `2.9.5 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.5>`__.
1142   * `2.9.6 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.6>`__.
1143
1144 * JaCoCo `0.8.1 → 0.8.2 <https://github.com/jacoco/jacoco/releases/tag/v0.8.2>`__.
1145
1146 * Javassist 3.22.0 → 3.23.1. This provides compatibility with Java 9 and later,
1147   and `fixes a file handle leak <https://github.com/jboss-javassist/javassist/issues/165>`__.
1148
1149 * Jettison 1.3.8 → 1.4.0.
1150
1151 * Jetty 9.3.21 → 9.4.11 (synchronised with Karaf):
1152
1153   * `9.4.0 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00097.html>`__.
1154   * `9.4.1 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00100.html>`__.
1155   * `9.4.2 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00101.html>`__.
1156   * `9.4.3 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00102.html>`__.
1157   * `9.4.4 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00105.html>`__.
1158   * `9.4.5 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00107.html>`__.
1159   * `9.4.6 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00109.html>`__.
1160   * `9.4.7 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00111.html>`__.
1161   * `9.4.8 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00114.html>`__.
1162   * `9.4.9 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00117.html>`__.
1163   * `9.4.10 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00119.html>`__.
1164   * `9.4.11 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00122.html>`__.
1165
1166 * Jolokia OSGi `1.5.0 → 1.6.0 <https://jolokia.org/changes-report.html#a1.6.0>`__.
1167
1168 * Karaf 4.1.5 → 4.2.1:
1169
1170   * `4.1.6 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12342748>`__.
1171   * `4.2.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12342945>`__.
1172
1173 * LMAX Disruptor 3.3.10 → 3.4.1:
1174
1175   * `3.4.0 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.0>`__.
1176   * `3.4.1 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.1>`__.
1177
1178 * META-INF services 1.7 → 1.8.
1179
1180 * Mockito 1.10.19 → 2.20.1; see
1181   `What’s new in Mockito 2 <https://github.com/mockito/mockito/wiki/What%27s-new-in-Mockito-2>`__
1182   for upgrade instructions and
1183   `the list of issues you might run into <https://asolntsev.github.io/en/2016/10/11/mockito-2.1/>`__.
1184
1185 * Netty 4.1.22 → 4.1.28:
1186
1187   * `4.1.17 <http://netty.io/news/2017/11/08/4-0-53-Final-4-1-17-Final.html>`__.
1188   * `4.1.18 <http://netty.io/news/2017/12/11/4-0-54-Final-4-1-18-Final.html>`__.
1189   * `4.1.19 <http://netty.io/news/2017/12/18/4-1-19-Final.html>`__.
1190   * `4.1.20 <http://netty.io/news/2018/01/22/4-0-55-Final-4-1-20-Final.html>`__.
1191   * `4.1.21 <http://netty.io/news/2018/02/05/4-0-56-Final-4-1-21-Final.html>`__.
1192   * `4.1.22 <http://netty.io/news/2018/02/21/4-1-22-Final.html>`__.
1193   * `4.1.23 <http://netty.io/news/2018/04/04/4-1-23-Final.html>`__.
1194   * `4.1.24 <http://netty.io/news/2018/04/19/4-1-24-Final.html>`__.
1195   * `4.1.25 <http://netty.io/news/2018/05/14/4-1-25-Final.html>`__.
1196   * `4.1.26 <http://netty.io/news/2018/07/10/4-1-26-Final.html>`__.
1197   * `4.1.27 <http://netty.io/news/2018/07/11/4-1-27-Final.html>`__.
1198   * `4.1.28 <http://netty.io/news/2018/07/27/4-1-28-Final.html>`__.
1199
1200 * Pax Exam 4.11.0 → 4.12.0.
1201
1202 * Pax URL 2.5.3 → 2.5.4, which only fixes
1203   `a potential NullPointerException <https://ops4j1.jira.com/browse/PAXURL-346>`__.
1204
1205 * PowerMock 1.6.4 → 1.7.4:
1206
1207   * `1.6.5 <https://github.com/powermock/powermock/releases/tag/powermock-1.6.5>`__.
1208   * `1.6.6 <https://github.com/powermock/powermock/releases/tag/powermock-1.6.6>`__.
1209   * `1.7.0 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.0>`__.
1210   * `1.7.1 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.1>`__.
1211   * `1.7.2 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.2>`__.
1212   * `1.7.3 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.3>`__.
1213   * `1.7.4 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.4>`__.
1214
1215 * Scala parser combinators 1.0.7 → 1.1.1:
1216
1217   * `1.1.0 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.0>`__.
1218   * `1.1.1 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.1>`__.
1219
1220 * SpotBugs `3.1.0 → 3.1.6 <https://github.com/spotbugs/spotbugs/blob/3.1.6/CHANGELOG.md>`__.
1221
1222 * Threeten Extra `1.3.2 → 1.4 <https://github.com/ThreeTen/threeten-extra/releases>`__.
1223
1224 * Typesafe SSL config 0.2.2 → 0.2.4:
1225
1226   * `0.2.3 <https://github.com/lightbend/ssl-config/releases/tag/v0.2.3>`__.
1227   * `0.2.4 <https://github.com/lightbend/ssl-config/releases/tag/v0.2.4>`__.
1228
1229 * Wagon HTTP
1230   `2.10 → 3.1.0 <https://lists.apache.org/thread.html/96024c54db7680697cb066e22a37b0ed5b4498386714a8a9ae1ec9cd@%3Cannounce.maven.apache.org%3E>`__.
1231
1232 * XMLUnit `1.6 → 2.6.2 <https://github.com/xmlunit/xmlunit/blob/master/RELEASE_NOTES.md>`__.
1233
1234 Upstream version additions
1235 ~~~~~~~~~~~~~~~~~~~~~~~~~~
1236
1237 The following upstream dependencies have been added to dependency management:
1238
1239 * Apache SSHD 2.0.0, with EdDSA and Netty support (EdDSA is provided by ``net.i2p.crypto:eddsa``).
1240
1241 * Blueprint annotations (``org.apache.aries.blueprint:blueprint-maven-plugin-annotation``).
1242
1243 * Log4J2.
1244
1245 * Pax Web 7.2.3 (synchronised with Karaf).
1246
1247 Upstream version removals
1248 ~~~~~~~~~~~~~~~~~~~~~~~~~
1249
1250 The following upstream dependencies have been removed from dependency management:
1251
1252 * Google Protobuf.
1253
1254 * Our repackaging of Jersey Servlet.
1255
1256 * JUnit’s ``junit-dep``, which has long been obsolete.
1257
1258 * LevelDB (which is still available as features).
1259
1260 * Pax CDI API — Blueprint annotations should be used instead.
1261
1262 Plugin version upgrades
1263 ~~~~~~~~~~~~~~~~~~~~~~~
1264
1265 The following plugins have been upgraded:
1266
1267 * Blueprint 1.4.0 → 1.10.0.
1268
1269 * Build helper 1.12 → 3.0.0.
1270
1271 * Bundle plugin 3.5.0 → 4.0.0.
1272
1273 * Checkstyle
1274   `2.17 → 3.0.0 <https://mail-archives.apache.org/mod_mbox/maven-announce/201801.mbox/%3Cop.zchs68akkdkhrr%40desktop-2khsk44.mshome.net%3E>`__.
1275
1276 * Duplicate finder
1277   `1.2.1 → 1.3.0 <https://github.com/basepom/duplicate-finder-maven-plugin/blob/master/CHANGES.md>`__.
1278
1279 * Git commit id `2.2.4 → 2.2.5 <https://github.com/ktoso/maven-git-commit-id-plugin/releases/tag/v2.2.5>`__.
1280
1281 * Jacoco Maven plugin `0.8.1 → 0.8.2 <https://github.com/jacoco/jacoco/releases/tag/v0.8.2>`__.
1282
1283 * Javadoc `3.0.0 → 3.0.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12342283>`__.
1284
1285 * PMD 3.8 → 3.10.0:
1286
1287   * `3.10.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12342689&styleName=Text&projectId=12317621>`__.
1288
1289 * Sevntu `1.29.0 → 1.32.0 <http://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.32.0>`__.
1290
1291 * SpotBugs 3.1.0-RC6 → 3.1.6 (see the SpotBugs changes above).
1292
1293 Version 3.1.3
1294 -------------
1295
1296 This version fixes the following issues:
1297
1298 * `ODLPARENT-156 <https://jira.opendaylight.org/browse/ODLPARENT-156>`_:
1299   ``xtend-maven-plugin``’s dependencies end up pulling in conflicting
1300   dependencies. ODL Parent now constrains part of its dependency tree to avoid
1301   this.
1302
1303 This version adds ``odl-jackson-2.8`` to ``odlparent-artifacts``.
1304
1305 Version 3.1.2
1306 -------------
1307
1308 This version fixes the following issues:
1309
1310 * `INFRAUTILS-41 <https://jira.opendaylight.org/browse/INFRAUTILS-41>`_:
1311   ``jre.properties`` includes ``com.sun.management`` so that it can be
1312   enabled if necessary. (This doesn’t add a dependency on
1313   ``com.sun.management``, it allows bundles to use it if it is present.)
1314
1315 * `ODLPARENT-136 <https://jira.opendaylight.org/browse/ODLPARENT-136>`_:
1316   ``SingleFeatureTest`` pulls in ``org.osgi.compendium``.
1317
1318 * `ODLPARENT-144 <https://jira.opendaylight.org/browse/ODLPARENT-144>`_:
1319   ``org.apache.karaf.scr.management`` is whitelisted so that it no longer
1320   affects ``SingleFeatureTest``.
1321
1322 * `ODLPARENT-146 <https://jira.opendaylight.org/browse/ODLPARENT-146>`_:
1323   null-related FindBugs checks which produce false-positives with Guava 23.6
1324   and later are disabled, so that this really is fully backwards-compatible
1325   with 3.0 and later.
1326
1327 * `ODLPARENT-148 <https://jira.opendaylight.org/browse/ODLPARENT-148>`_:
1328   ``SingleFeatureTest`` preserves ``target/SFT/karaf.log``.
1329
1330 This version includes the following improvements:
1331
1332 * ``custom.properties`` no longer includes OVSDB-specific configuration.
1333
1334 * The ``odl-jersey-1`` feature includes the Jersey client.
1335
1336 * Redundant bundle dependency declarations in ``SingleFeatureTest`` have been
1337   removed (these are declarations which are also present in our base Karaf
1338   distribution).
1339
1340 * Build errors involving invalid feature or bundle URLs now indicate which
1341   feature is at fault.
1342
1343 * Obsolete Log4J overrides have been removed from ``SingleFeatureTest``.
1344
1345 When building using JDK 9 or 10, the default settings have been changed as
1346 follows to avoid errors or extraneous warnings:
1347
1348 * SFT is disabled (it needs Karaf 4.2 or later);
1349
1350 * Javadocs are generated as HTML 4;
1351
1352 * SpotBugs is disabled on JDK 10 or later;
1353
1354 * FindBugs is disabled on JDK 9 or later.
1355
1356 The following third-party dependencies have been upgraded:
1357
1358 * `EclipseLink Moxy JAXB 2.6.2 → 2.7.1 <https://www.eclipse.org/eclipselink/releases/2.7.php>`_.
1359
1360 * `Google Truth 0.36 → 0.40 <https://github.com/google/truth/releases>`_.
1361
1362 * `Gson 2.8.2 → 2.8.5 <https://github.com/google/gson/blob/master/CHANGELOG.md>`_.
1363
1364 * `Guava 23.6 → 23.6.1 <https://github.com/google/guava/compare/v23.6...v23.6.1>`_.
1365   This addresses CVE-2018-10237 (that’s the only change in this release).
1366
1367 * `Jacoco Maven plugin 0.8.0 → 0.8.1 <https://github.com/jacoco/jacoco/releases/tag/v0.8.1>`_.
1368
1369 * JDT annotations 2.1.0 → 2.1.150.
1370
1371 * `Scala 2.12.5 → 2.12.6 <https://github.com/scala/scala/releases/tag/v2.12.6>`_.
1372
1373 * `Scala Parser Combinators 1.0.6 → 1.0.7 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.0.7>`_.
1374
1375 * `Sevntu 1.24.2 → 1.29.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.29.0>`_.
1376
1377 * `Xtext and Xtend 2.13.0 → 2.14.0 <https://github.com/eclipse/xtext/blob/website-master/xtend-website/_posts/releasenotes/2018-05-23-version-2-14-0.md>`_.
1378
1379 The following Maven plugin has been upgraded:
1380
1381 * `Javadoc 3.0.0 → 3.0.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12342283>`_.
1382
1383 Version 3.1.1
1384 -------------
1385
1386 This version fixes the following issues:
1387
1388 * `ODLPARENT-137 <https://jira.opendaylight.org/browse/ODLPARENT-137>`_:
1389   restore the OpenDaylight prompt.
1390
1391 * `ODLPARENT-146 <https://jira.opendaylight.org/browse/ODLPARENT-146>`_:
1392   Guava 23.6 switched from @Nullable to @NullableDecl, which causes false
1393   positives in FindBugs’ ``NP_NONNULL_PARAM_VIOLATION`` rule; we’re
1394   disabling the rule for now.
1395
1396 Version 3.1.0
1397 -------------
1398
1399 This version fixes the following issues:
1400
1401 * Mycila dependencies are now “compile” scoped rather than “test”; this allows
1402   child projects to use Guice with Mycila more easily.
1403
1404 * The duplicate finder now ignores ``web.xml`` and BluePrint XML files.
1405
1406 This version includes the following improvements:
1407
1408 * The ``-Pq`` profile skips Maven Modernizer, in preparation for its future
1409   integration (and its use in child projects).
1410
1411 * An OWASP profile, ``-Powasp`` is available for vulnerability checking.
1412
1413 * A new ``odl-jackson-2.8`` feature provides Jackson 2.8 to child projects.
1414
1415 The following third-party dependencies have been added to dependency management:
1416
1417 * `ThreeTen-Extra <http://www.threeten.org/threeten-extra/>`_
1418
1419 The following third-party dependencies have been upgraded:
1420
1421 * Aeron 1.2.5 → 1.7.0; release notes:
1422
1423   * `1.3.0 <https://github.com/real-logic/aeron/releases/tag/1.3.0>`_
1424   * `1.4.0 <https://github.com/real-logic/aeron/releases/tag/1.4.0>`_
1425   * `1.5.0 <https://github.com/real-logic/aeron/releases/tag/1.5.0>`_
1426   * `1.5.1 <https://github.com/real-logic/aeron/releases/tag/1.5.1>`_
1427   * `1.5.2 <https://github.com/real-logic/aeron/releases/tag/1.5.2>`_
1428   * `1.6.0 <https://github.com/real-logic/aeron/releases/tag/1.6.0>`_
1429   * `1.7.0 <https://github.com/real-logic/aeron/releases/tag/1.7.0>`_
1430
1431 * Agrona 0.9.5 → 0.9.12; release notes:
1432
1433   * `0.9.6 <https://github.com/real-logic/Agrona/releases/tag/0.9.6>`_
1434   * `0.9.7 <https://github.com/real-logic/Agrona/releases/tag/0.9.7>`_
1435   * `0.9.8 <https://github.com/real-logic/Agrona/releases/tag/0.9.8>`_
1436   * `0.9.9 <https://github.com/real-logic/Agrona/releases/tag/0.9.9>`_
1437   * `0.9.10 <https://github.com/real-logic/Agrona/releases/tag/0.9.10>`_
1438   * `0.9.11 <https://github.com/real-logic/Agrona/releases/tag/0.9.11>`_
1439   * `0.9.12 <https://github.com/real-logic/Agrona/releases/tag/0.9.12>`_
1440
1441 * Akka 2.5.5 → 2.5.11; release notes:
1442
1443   * `2.5.6 <https://akka.io/blog/news/2017/09/28/akka-2.5.6-released>`_
1444   * `2.5.7 <https://akka.io/blog/news/2017/11/17/akka-2.5.7-released>`_
1445   * `2.5.8 <https://akka.io/blog/news/2017/12/08/akka-2.5.8-released>`_
1446   * `2.5.9 <https://akka.io/blog/news/2018/01/11/akka-2.5.9-released-2.4.x-end-of-life>`_
1447   * `2.5.10 <https://akka.io/blog/news/2018/02/23/akka-2.5.10-released>`_
1448   * `2.5.11 <https://akka.io/blog/news/2018/02/28/akka-2.5.11-released>`_
1449
1450 * Commons Lang 3 `3.6 → 3.7 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`_
1451
1452 * Guava 23.3 → 23.6; release notes:
1453
1454   * `23.4 <https://github.com/google/guava/releases/tag/v23.4>`_
1455   * `23.5 <https://github.com/google/guava/releases/tag/v23.5>`_
1456   * `23.6 <https://github.com/google/guava/releases/tag/v23.6>`_
1457
1458 * H2 database `1.4.193 → 1.4.196 <http://www.h2database.com/html/changelog.html>`_
1459
1460 * Jacoco `0.7.9 → 0.8.0 <https://github.com/jacoco/jacoco/releases/tag/v0.8.0>`_
1461
1462 * Javassist `3.21.0 → 3.22.0 <https://github.com/jboss-javassist/javassist/compare/rel_3_21_0_ga...rel_3_22_0_ga>`_
1463
1464 * lmax-disruptor 3.3.7 → 3.3.10; release notes:
1465
1466   * `3.3.8 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.8>`_
1467   * `3.3.9 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.9>`_
1468   * `3.3.10 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.10>`_
1469
1470 * Netty 4.1.16 → 4.1.22; release notes:
1471
1472   * `4.1.17 <http://netty.io/news/2017/11/08/4-0-53-Final-4-1-17-Final.html>`_
1473   * `4.1.18 <http://netty.io/news/2017/12/11/4-0-54-Final-4-1-18-Final.html>`_
1474   * `4.1.19 <http://netty.io/news/2017/12/18/4-1-19-Final.html>`_
1475   * `4.1.20 <http://netty.io/news/2018/01/22/4-0-55-Final-4-1-20-Final.html>`_
1476   * `4.1.21 <http://netty.io/news/2018/02/05/4-0-56-Final-4-1-21-Final.html>`_
1477   * `4.1.22 <http://netty.io/news/2018/02/21/4-1-22-Final.html>`_
1478
1479 * Scala `2.12.4 → 2.12.5 <http://www.scala-lang.org/news/2.12.5>`_
1480
1481 * Typesafe Config `0.2.1 → 0.2.2 <https://github.com/typesafehub/config/blob/master/NEWS.md>`_
1482
1483 The following Maven plugins have been upgraded:
1484
1485 * FindBugs 3.0.4 → 3.0.5
1486
1487 * Git commit id 2.2.2 → 2.2.4; release notes:
1488
1489   * `2.2.3 <https://github.com/ktoso/maven-git-commit-id-plugin/releases/tag/v2.2.3>`_
1490   * `2.2.4 <https://github.com/ktoso/maven-git-commit-id-plugin/releases/tag/v2.2.4>`_
1491
1492 Version 3.0.3
1493 -------------
1494
1495 This version fixes the following issues:
1496
1497 * `ODLPARENT-136`_: ``features-test`` needs ``org.osgi.compendium``.
1498
1499 * Jackson dependencies are declared using ``jackson-bom`` to ensure all they
1500   remain consistent.
1501
1502 * ``find-duplicate-classpath-entries`` is run in the “verify” phase rather than
1503   the “validate” phase, which is too early.
1504
1505 * The version of Jetty we pull in is now aligned with that declared in Karaf,
1506   resolving a number of restart and dependency issues.
1507
1508 * Pulling in the ``wrap`` feature unconditionally is no longer necessary, so
1509   ``karaf4-parent`` no longer does so.
1510
1511 * ``metainf-services`` are declared with scope “provided” to avoid their being
1512   included in downstream features (it’s a build-time dependency only).
1513
1514 * ``leveldb-api`` is excluded from ``odl-akka-leveldb-0.7``, and ``jsr250-api``
1515   from ``enunciate-core-annotations``, to avoid duplicate having classes on the
1516   classpath.
1517
1518 * Since the ``ssh`` feature is excluded from generated features, our Karaf
1519   need to enable it at boot in all cases.
1520
1521 * ``bundle-test-lib`` is now a bundle.
1522
1523 * Since we use static SLF4J loggers, the ``SLF4J_LOGGER_SHOULD_BE_NON_STATIC``
1524   rule needs to be disabled in our FindBugs configuration (this allows
1525   downstream projects to enable ``findbugs-slf4j`` without having to deal with
1526   all the resulting false-positives).
1527
1528 * ``org.apache.karaf.scr.management`` is white-listed in SFT to avoid failures
1529   apparently related to that component (which we don’t care about).
1530
1531 .. _ODLPARENT-136: https://jira.opendaylight.org/browse/ODLPARENT-136
1532
1533 This version upgrades the following third-party dependencies:
1534
1535 * `Antlr 4.7 → 4.7.1`_
1536
1537 * `BouncyCastle 1.58 → 1.59`_
1538
1539 * Jersey 1.17 → 1.19.4 (additionally available as the ``odl-jersey-1`` feature)
1540
1541 * Jolokia 1.3.7 → 1.5.0
1542
1543 * Karaf 4.1.3 → 4.1.5; release notes:
1544
1545   * `Karaf 4.1.4`_
1546   * `Karaf 4.1.5`_
1547
1548 .. _Antlr 4.7 → 4.7.1: https://github.com/antlr/antlr4/releases/tag/4.7.1
1549 .. _BouncyCastle 1.58 → 1.59: https://www.bouncycastle.org/releasenotes.html
1550 .. _Karaf 4.1.4: https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12341702
1551 .. _Karaf 4.1.5: https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12342294
1552
1553 Version 3.0.2
1554 -------------
1555
1556 This version fixes the following issues:
1557
1558 * SingleFeatureTest uses the configured local Maven repository for Pax Exam.
1559
1560 * JavaDoc links are disabled for now to `speed up builds`_. A new
1561   ``javadoc-links`` profile enables the links.
1562
1563 * Conditional feature dependencies are processed, ensuring our
1564   `distribution is complete`_.
1565
1566 * Startup features are `adjusted for Karaf 4.1`_, avoiding unnecessary
1567   refreshes.
1568
1569 * The ``hiddenField`` Checkstyle check is disabled for abstract methods.
1570
1571 * The default logging configuration uses Log4J2, which is the new default in
1572   Karaf 4.1.
1573
1574 .. _speed up builds: https://jira.opendaylight.org/browse/ODLPARENT-121
1575 .. _distribution is complete: https://jira.opendaylight.org/browse/ODLPARENT-133
1576 .. _adjusted for Karaf 4.1: https://jira.opendaylight.org/browse/ODLPARENT-134
1577
1578 This version upgrades the following dependencies or plugins:
1579
1580 * ``maven-enforcer-plugin`` 1.4.1 → 3.0.0-M1
1581
1582 * ``maven-javadoc-plugin`` 3.0.0-M1 → 3.0.0
1583
1584 Version 3.0.1
1585 -------------
1586
1587 This version fixes the following issues:
1588
1589 * Karaf pulls in an invalid Hibernate feature repository, breaking downstream
1590   dependencies pulling in the “war” feature. ``populate-local-repo`` corrects
1591   the repository dependency.
1592
1593
1594 Version 3.0.0
1595 -------------
1596
1597 Compiler settings
1598 ~~~~~~~~~~~~~~~~~
1599
1600 Build now show compiler warnings and deprecation warnings. This doesn't affect
1601 the result or require any changes currently, it just makes the issues more
1602 visible.
1603
1604 New Checkstyle rules
1605 ~~~~~~~~~~~~~~~~~~~~
1606
1607 Checkstyle has been upgraded from 7.6 to 8.4 (see the
1608 `Checkstyle release notes`_ for details), and Sevntu from 1.21.0 to 1.24.2
1609 (note that the latter's group identifier changed from
1610 ``com.github.sevntu.checkstyle`` to ``com.github.sevntu-checkstyle``; you
1611 might need to update your IDE's configuration).
1612
1613 The following Checkstyle rules are enabled; this might require changes in
1614 projects which enforce Checkstyle validation:
1615
1616 * `AvoidHidingCauseExceptionCheck`_
1617 * `FinalClass`_: utility classes must be declared ``final``
1618 * `HiddenField`_: fields must not be shadowed
1619 * `HideUtilityClassConstructor`_: utility classes must hide their constructor
1620
1621 .. _Checkstyle release notes: http://checkstyle.sourceforge.net/releasenotes.html
1622
1623 .. _AvoidHidingCauseExceptionCheck: http://sevntu-checkstyle.github.io/sevntu.checkstyle/apidocs/com/github/sevntu/checkstyle/checks/coding/AvoidHidingCauseExceptionCheck.html
1624 .. _FinalClass: http://checkstyle.sourceforge.net/config_design.html#FinalClass
1625 .. _HiddenField: http://checkstyle.sourceforge.net/config_coding.html#HiddenField
1626 .. _HideUtilityClassConstructor: http://checkstyle.sourceforge.net/config_design.html#HideUtilityClassConstructor
1627
1628 Karaf
1629 ~~~~~
1630
1631 Karaf has been upgraded to 4.1.3. This should be transparent for dependent
1632 projects.
1633
1634 Karaf distributions
1635 ~~~~~~~~~~~~~~~~~~~
1636
1637 * When building a Karaf distribution using ``karaf4-parent``, projects can
1638   specify which archives to build: the ``karaf.archiveZip`` property will
1639   enable ZIP files if true, and ``karaf.archiveTarGz`` will enable
1640   gzip-compressed tarballs if true. By default both are enabled.
1641
1642 * Our Karaf distribution provides Bouncy Castle at startup. Auto-generated
1643   feature descriptors take this into account (they won't embed a Bouncy
1644   Castle dependency).
1645
1646 Feature removals
1647 ~~~~~~~~~~~~~~~~
1648
1649 * The ``odl-triemap-0.2`` feature wrapping
1650   ``com.github.romix:java-concurrent-hash-trie-map`` was rendered obsolete by
1651   YANG Tools' implementation and has been removed.
1652
1653 Feature additions
1654 ~~~~~~~~~~~~~~~~~
1655
1656 * ``odl-javassist-3`` provides Javassist in a feature.
1657
1658 * ``odl-jung-2.1`` provides `JUNG`_ in a feature.
1659
1660 .. _JUNG: http://jung.sourceforge.net/
1661
1662 Upstream version upgrades
1663 ~~~~~~~~~~~~~~~~~~~~~~~~~
1664
1665 The following upstream dependencies have been upgraded:
1666
1667 * Akka 2.4.18 → 2.5.4; release notes:
1668
1669   * `Akka 2.5.0`_
1670   * `Akka 2.5.1`_
1671   * `Akka 2.5.2`_
1672   * `Akka 2.5.3`_
1673   * `Akka 2.5.4`_
1674
1675 * `Awaitility 2 → 3`_
1676
1677 * `Bouncy Castle 1.57 → 1.58`_
1678
1679 * `Commons Codec 1.10 → 1.11`_
1680
1681 * `Commons File Upload 1.3.2 → 1.3.3`_
1682
1683 * `Commons IO 2.5 → 2.6`_
1684
1685 * Eclipse JDT annotations 2.0.0 → 2.1.0
1686
1687 * Felix Dependency Manager 4.3.0 → 4.4.1
1688 * Felix Dependency Manager Shell 4.0.4 → 4.0.6
1689 * Felix Metatype 1.1.2 → 1.1.6
1690
1691 * `Google Truth 0.28 → 0.36`_ (with the Java 8 extensions)
1692
1693 * `Gson 2.7 → 2.8.2`_
1694
1695 * Guava 22 → 23.3 along with the associated feature name change from
1696   ``odl-guava-22`` to ``odl-guava-23`` (dependent packages *must* change their
1697   dependency); release notes:
1698
1699   * `Guava 23`_
1700   * `Guava 23.1`_
1701   * `Guava 23.2`_
1702   * `Guava 23.3`_
1703
1704 * Immutables 2.4.2 → 2.5.6
1705
1706 * Jackson 2.3.2 → 2.8.9
1707
1708 * Jacoco 0.7.7 → 0.7.9; release notes:
1709
1710   * `Jacoco 0.7.8`_
1711   * `Jacoco 0.7.9`_
1712
1713 * Jacoco Listeners 2.4 → 3.8
1714
1715 * `Javassist 3.20.0 → 3.21.0`_
1716
1717 * `Jettison 1.3.7 → 1.3.8`_
1718
1719 * `Jolokia 1.3.6 → 1.3.7`_
1720
1721 * `JSONassert 1.3.0 → 1.5.0`_
1722
1723 * `logback 1.2.2 → 1.2.3`_
1724
1725 * `LMAX Disruptor 3.3.6 → 3.3.7`_
1726
1727 * Netty 4.1.8 → 4.1.16; release notes:
1728
1729   * `Netty 4.1.9`_
1730   * `Netty 4.1.10`_
1731   * `Netty 4.1.11`_
1732   * `Netty 4.1.12`_
1733   * `Netty 4.1.13`_
1734   * `Netty 4.1.14`_
1735   * `Netty 4.1.15`_
1736   * `Netty 4.1.16`_
1737
1738 * `Pax URL 2.5.2 → 2.5.3`_
1739
1740 * Scala 2.11.11 → 2.12.4; release notes:
1741
1742   * `Scala 2.12.0`_
1743   * `Scala 2.12.1`_
1744   * `Scala 2.12.2`_
1745   * `Scala 2.12.3`_
1746   * `Scala 2.12.4`_
1747
1748 * Servlet API 3.0.1 → 3.1.0
1749
1750 * `SLF4J 1.7.21 → 1.7.25`_
1751
1752 * `webcohesion enunciate 2.6.0 → 2.10.1`_
1753
1754 * `Xtend 2.12 → 2.13`_
1755
1756 .. _Akka 2.5.0: http://akka.io/blog/news/2017/04/13/akka-2.5.0-released
1757 .. _Akka 2.5.1: http://akka.io/blog/news/2017/05/02/akka-2.5.1-released
1758 .. _Akka 2.5.2: http://akka.io/blog/news/2017/05/24/akka-2.5.2-released
1759 .. _Akka 2.5.3: http://akka.io/blog/news/2017/06/19/akka-2.5.3-released
1760 .. _Akka 2.5.4: http://akka.io/blog/news/2017/08/10/akka-2.5.4-released
1761
1762 .. _Awaitility 2 → 3: https://github.com/awaitility/awaitility/wiki/ReleaseNotes30
1763
1764 .. _Bouncy Castle 1.57 → 1.58: https://www.bouncycastle.org/releasenotes.html
1765
1766 .. _Commons Codec 1.10 → 1.11: http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt
1767
1768 .. _Commons File Upload 1.3.2 → 1.3.3: http://www.apache.org/dist/commons/fileupload/RELEASE-NOTES.txt
1769
1770 .. _Commons IO 2.5 → 2.6: http://www.apache.org/dist/commons/io/RELEASE-NOTES.txt
1771
1772 .. _Google Truth 0.28 → 0.36: https://github.com/google/truth/releases
1773
1774 .. _Gson 2.7 → 2.8.2: https://github.com/google/gson/blob/master/CHANGELOG.md
1775
1776 .. _Guava 23: https://github.com/google/guava/wiki/Release23
1777 .. _Guava 23.1: https://github.com/google/guava/releases/tag/v23.1
1778 .. _Guava 23.2: https://github.com/google/guava/releases/tag/v23.2
1779 .. _Guava 23.3: https://github.com/google/guava/releases/tag/v23.3
1780
1781 .. _Jacoco 0.7.8: https://github.com/jacoco/jacoco/releases/tag/v0.7.8
1782 .. _Jacoco 0.7.9: https://github.com/jacoco/jacoco/releases/tag/v0.7.9
1783
1784 .. _Javassist 3.20.0 → 3.21.0: https://github.com/jboss-javassist/javassist/compare/rel_3_20_0_ga...rel_3_21_0_ga
1785
1786 .. _Jettison 1.3.7 → 1.3.8: https://github.com/jettison-json/jettison/compare/jettison-1.3.7...jettison-1.3.8
1787
1788 .. _Jolokia 1.3.6 → 1.3.7: https://github.com/rhuss/jolokia/releases/tag/v1.3.7
1789
1790 .. _JSONassert 1.3.0 → 1.5.0: https://github.com/skyscreamer/JSONassert/releases
1791
1792 .. _logback 1.2.2 → 1.2.3: https://logback.qos.ch/news.html
1793
1794 .. _LMAX Disruptor 3.3.6 → 3.3.7: https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.7
1795
1796 .. _Netty 4.1.9: http://netty.io/news/2017/03/10/4-0-45-Final-4-1-9-Final.html
1797 .. _Netty 4.1.10: http://netty.io/news/2017/04/30/4-0-46-Final-4-1-10-Final.html
1798 .. _Netty 4.1.11: http://netty.io/news/2017/05/12/4-0-47-Final-4-1-11-Final.html
1799 .. _Netty 4.1.12: http://netty.io/news/2017/06/09/4-0-48-Final-4-1-12-Final.html
1800 .. _Netty 4.1.13: http://netty.io/news/2017/07/06/4-0-49-Final-4-1-13-Final.html
1801 .. _Netty 4.1.14: http://netty.io/news/2017/08/03/4-0-50-Final-4-1-14-Final.html
1802 .. _Netty 4.1.15: http://netty.io/news/2017/08/25/4-0-51-Final-4-1-15-Final.html
1803 .. _Netty 4.1.16: http://netty.io/news/2017/09/25/4-0-52-Final-4-1-16-Final.html
1804
1805 .. _Pax URL 2.5.2 → 2.5.3: https://ops4j1.jira.com/browse/PAXURL-345?jql=project%20%3D%20PAXURL%20AND%20fixVersion%20%3D%202.5.3
1806
1807 .. _Scala 2.12.0: https://github.com/scala/scala/releases/tag/v2.12.0
1808 .. _Scala 2.12.1: https://github.com/scala/scala/releases/tag/v2.12.1
1809 .. _Scala 2.12.2: https://github.com/scala/scala/releases/tag/v2.12.2
1810 .. _Scala 2.12.3: https://github.com/scala/scala/releases/tag/v2.12.3
1811 .. _Scala 2.12.4: https://github.com/scala/scala/releases/tag/v2.12.4
1812
1813 .. _SLF4J 1.7.21 → 1.7.25: https://www.slf4j.org/news.html
1814
1815 .. _webcohesion enunciate 2.6.0 → 2.10.1: https://github.com/stoicflame/enunciate/releases
1816
1817 .. _Xtend 2.12 → 2.13: https://www.eclipse.org/xtend/releasenotes.html
1818
1819 Upstream version additions
1820 ~~~~~~~~~~~~~~~~~~~~~~~~~~
1821
1822 The following upstream dependencies have been added to dependency management:
1823
1824 * Commons Text, ``org.apache.commons:commons-text`` (this will allow downstreams
1825   to migrate from ``commons-lang3``\’s ``WordUtils``, which is deprecated)
1826
1827 Upstream version removals
1828 ~~~~~~~~~~~~~~~~~~~~~~~~~
1829
1830 The following upstream dependencies have been removed from dependency
1831 management (they are obsolete and unused):
1832
1833 * Chameleon MBeans
1834 * Eclipse Link
1835 * Equinox HTTP service bridge
1836 * ``equinoxSDK381`` artifacts
1837 * Coda Hale Metrics, which are mostly unused and should eventually be wrapped
1838   by InfraUtils
1839 * ``com.google.code.findbugs:jsr305`` (which *must not* be used; this is
1840   enforced — ``annotations`` should be used instead)
1841 * Felix File Install and Web Console
1842 * Gemini Web
1843 * Orbit
1844 * ``org.mockito:mockito-all`` (which *must not* be used; this is enforced —
1845   ``mockito-core`` should be used instead)
1846 * Spring Framework
1847 * ``txw2``
1848 * Xerces
1849 * ``xml-apis``
1850
1851 Plugin version upgrades
1852 ~~~~~~~~~~~~~~~~~~~~~~~
1853
1854 The following plugins have been upgraded:
1855
1856 * ``org.apache.servicemix.tooling:depends-maven-plugin`` 1.3.1 → 1.4.0
1857 * ``org.apache.felix:maven-bundle-plugin`` 2.4.0 → 3.3.0
1858 * ``maven-compiler-plugin`` 3.6.1 → 3.7.0
1859 * ``maven-dependency-plugin`` 3.0.1 → 3.0.2
1860 * ``maven-enforcer-plugin`` 1.4.1 → 3.0.0-M1
1861 * ``maven-failsafe-plugin`` 2.18.1 → 2.20.1
1862 * ``maven-javadoc-plugin`` 2.10.4 → 3.0.0-M1
1863 * ``maven-shade-plugin`` 2.4.3 → 3.1.0
1864
1865 New plugins
1866 ~~~~~~~~~~~
1867
1868 * The `Maven Find Duplicates`_ plugin can be enabled by setting the
1869   ``duplicate-finder.skip`` property to ``false``.
1870
1871 * The SpotBugs_ Maven plugin can now be used instead of the FindBugs plugin
1872   (both are available, so no change is required). To use SpotBugs, replace
1873   ``org.codehaus.mojo:findbugs-maven-plugin`` with
1874   ``com.github.spotbugs:spotbugs-maven-plugin``.
1875
1876 .. _Maven Find Duplicates: https://github.com/basepom/duplicate-finder-maven-plugin/
1877
1878 .. _SpotBugs: https://spotbugs.github.io/