[Git][java-team/jackson-dataformat-xml][upstream] New upstream version 2.9.7

[Markus Koschany]

Markus Koschany pushed to branch upstream at Debian Java Maintainers / jackson-dataformat-xml


Commits:
c0860ced by Markus Koschany at 2018-10-02T16:52:47Z
New upstream version 2.9.7
- - - - -


3 changed files:

- README.md
- pom.xml
- release-notes/VERSION-2.x


Changes:

=====================================
README.md
=====================================
@@ -34,7 +34,7 @@ To use Jackson 2.x compatible version of this extension on Maven-based projects,
 <dependency>
   <groupId>com.fasterxml.jackson.dataformat</groupId>
   <artifactId>jackson-dataformat-xml</artifactId>
-  <version>2.9.0</version>
+  <version>2.9.6</version>
 </dependency>
 ```
 
@@ -53,6 +53,8 @@ You can do this by adding this in your `pom.xml`:
 
 # Usage
 
+## Constructing Mapper
+
 Although module implements low-level (`JsonFactory` / `JsonParser` / `JsonGenerator`) abstractions,
 most usage is through data-binding level. This because a small number of work-arounds have been added
 at data-binding level, to work around XML peculiarities: that is, stream of `JsonToken`s that parser
@@ -77,6 +79,24 @@ XmlMapper xmlMapper = new XmlMapper(module);
 as many features that `XmlMapper` needs are provided by `JacksonXmlModule`; default
 `XmlMapper` simply constructs module with default settings.
 
+Alternatively, sometimes you may want/need to configure low-level XML processing details
+controlled by underlying Stax library (Woodstox, Aalto or JDK-default Oracle implementation).
+If so, you will need to construct `XmlMapper` with properly configured underlying factories.
+This usually looks something like:
+
+```java
+XMLInputFactory ifactory = new WstxInputFactory(); // Woodstox XMLInputFactory impl
+ifactory.setProperty(WstxInputProperties.P_MAX_ATTRIBUTE_SIZE, 32000);
+// configure
+XMLOutputFactory ofactory = new WstxOutputFactory(); // Woodstox XMLOutputfactory impl
+ofactory.setProperty(WstxOutputProperties.P_OUTPUT_CDATA_AS_TEXT, true);
+XmlFactory xf = new XmlFactory(ifactory, ofactory);
+XmlMapper mapper = new XmlMapper(xf); // there are other overloads too
+```
+
+For configurable properties, you may want to check out
+[Configuring Woodstox XML parser](https://medium.com/@cowtowncoder/configuring-woodstox-xml-parser-woodstox-specific-properties-1ce5030a5173)
+
 ## Android quirks
 
 While usage on Android is the same as on standard JDKs, there is one thing that may cause issues:
@@ -213,7 +233,14 @@ Currently, following limitations exist beyond basic Jackson (JSON) limitations:
     * `JacksonXmlModule.setDefaultUseWrapper()` can be used to specify whether "wrapped" or "unwrapped" setting is the default
 * Tree Model is only supported in limited fashion: specifically, Java arrays and `Collection`s can be written, but can not be read, since it is not possible to distinguish Arrays and Objects without additional information.
 
-# See Also
+# Documentation
 
 * XML module [wiki page](https://github.com/FasterXML/jackson-dataformat-xml/wiki) for more information
+* Various Blog posts on Woodstox:
+    * [Standard Stax 1.x config properties](https://medium.com/@cowtowncoder/configuring-woodstox-xml-parser-basic-stax-properties-39bdf88c18ec)
+    * [Stax2 extension config properties](https://medium.com/@cowtowncoder/configuring-woodstox-xml-parser-stax2-properties-c80ef5a32ef1)
+    * [Woodstox-specific config properties](https://medium.com/@cowtowncoder/configuring-woodstox-xml-parser-woodstox-specific-properties-1ce5030a5173)
+
+# See Also
+
 * Using XML with [DropWizard](https://github.com/dropwizard/dropwizard)? Check out [this extension](https://github.com/yunspace/dropwizard-xml)!


=====================================
pom.xml
=====================================
@@ -4,11 +4,11 @@
   <parent>
     <groupId>com.fasterxml.jackson</groupId>
     <artifactId>jackson-base</artifactId>
-    <version>2.9.6</version>
+    <version>2.9.7</version>
   </parent>
   <groupId>com.fasterxml.jackson.dataformat</groupId>
   <artifactId>jackson-dataformat-xml</artifactId>
-  <version>2.9.6</version>
+  <version>2.9.7</version>
   <name>Jackson-dataformat-XML</name>
   <packaging>bundle</packaging>
   <description>Data format extension for Jackson (http://jackson.codehaus.org) to offer
@@ -21,7 +21,7 @@ Some data-binding types overridden as well (ObjectMapper sub-classed as XmlMappe
     <connection>scm:git:git at github.com:FasterXML/jackson-dataformat-xml.git</connection>
     <developerConnection>scm:git:git at github.com:FasterXML/jackson-dataformat-xml.git</developerConnection>
     <url>http://github.com/FasterXML/jackson-dataformat-xml</url>    
-    <tag>jackson-dataformat-xml-2.9.6</tag>
+    <tag>jackson-dataformat-xml-2.9.7</tag>
   </scm>
   <properties>
     <packageVersion.dir>com/fasterxml/jackson/dataformat/xml</packageVersion.dir>


=====================================
release-notes/VERSION-2.x
=====================================
@@ -4,7 +4,16 @@ Project: jackson-dataformat-xml
 = Releases
 ------------------------------------------------------------------------
 
+2.9.7 (19-Sep-2018)
+
+No changes since 2.9.6
+
 2.9.6 (12-Jun-2018)
+
+#282: `@JacksonXmlRootElement` malfunction when using it with multiple `XmlMapper`s
+  and disabling annotations
+ (reported by benej60 at github)
+
 2.9.5 (26-Mar-2018)
 
 No changes since 2.9.4



View it on GitLab: https://salsa.debian.org/java-team/jackson-dataformat-xml/commit/c0860cedae942c7a5b532801df30ecf59a682b8f

-- 
View it on GitLab: https://salsa.debian.org/java-team/jackson-dataformat-xml/commit/c0860cedae942c7a5b532801df30ecf59a682b8f
You're receiving this email because of your account on salsa.debian.org.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://alioth-lists.debian.net/pipermail/pkg-java-commits/attachments/20181002/9fcc1ceb/attachment.html>