Skip to content
This repository was archived by the owner on May 28, 2018. It is now read-only.

Commit a5c735d

Browse files
author
Michal Gajdos
committed
Added Release Highlights to Migration Guide.
Change-Id: Ib031ada0e02781c43850ad1efd3e42c94ac59d5e Signed-off-by: Michal Gajdos <michal.gajdos@oracle.com>
1 parent 28f5c1d commit a5c735d

File tree

1 file changed

+59
-0
lines changed

1 file changed

+59
-0
lines changed

docs/src/main/docbook/migration.xml

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,65 @@
5555
<section xml:id="mig-2.9">
5656
<title>Migrating from Jersey 2.8 to 2.9</title>
5757

58+
<section xml:id="mig-2.9-highlights">
59+
<title>Release 2.9 Highlights</title>
60+
61+
<section>
62+
<title>Declarative Linking</title>
63+
64+
<para>
65+
Gerard updated the Declarative Linking extension module which has been ported to Jersey 2 in version 2.6. You
66+
can read more about what Declarative Linking does and what it's capable of in the following blog posts:
67+
68+
<itemizedlist>
69+
<listitem>
70+
<para>
71+
<link xlink:href='http://kingsfleet.blogspot.co.uk/2014/05/declarative-linking-in-jersey-29.html'>Declarative Linking in Jersey 2.9 and up</link>
72+
</para>
73+
</listitem>
74+
<listitem>
75+
<para>
76+
<link xlink:href='http://kingsfleet.blogspot.co.uk/2014/05/reading-and-writing-jax-rs-link-objects.html'>Reading and writing JAX-RS Link objects</link>
77+
</para>
78+
</listitem>
79+
</itemizedlist>
80+
</para>
81+
</section>
82+
<section>
83+
<title>Jackson 2</title>
84+
85+
<para>
86+
Our media module that supports working with JSON via Jackson library has been updated to use Jackson 2.x (2.3.2).
87+
All samples and tests have been rewritten to use Jackson 2 as well. In order to use Jackson 2 in your application
88+
you need to add jersey-media-json-jackson (+ it's Jackson dependencies) to your class-path and register
89+
<literal>JacksonFeature</literal> in your application.
90+
</para>
91+
</section>
92+
<section>
93+
<title>META-INF/services</title>
94+
95+
<para>
96+
We dropped automatic registration of message body providers (MessageBodyWriter, MessageBodyReader) and exception
97+
mappers via META-INF/services mechanism. This functionality can be restored by adding <literal>jersey-metainf-services</literal>
98+
module to the class-path of your application.
99+
</para>
100+
<para>
101+
Note: This change may affect 3rd party libraries (e.g. Jackson 2.x) in a way their provider would not be
102+
registered in an JAX-RS app. You need to either register them manually or use mentioned
103+
<literal>jersey-metainf-services</literal> module.
104+
</para>
105+
</section>
106+
<section>
107+
<title>Jersey Test Framework</title>
108+
109+
<para>
110+
Jersey Test Framework now supports TestNG to run the tests (in addition to the JUnit, which is supported by default).
111+
You can now run the tests in parallel using either JUnit or TestNG. See chapters dedicated to TestNG and parallel
112+
testing for more information: <xref linkend="testng"/> and <xref linkend="parallel"/>.
113+
</para>
114+
</section>
115+
</section>
116+
58117
<section xml:id="mig-2.9-breaking-changes">
59118
<title>Changes</title>
60119
<para>

0 commit comments

Comments
 (0)