A modern XML library for Android and Java
- Simple modern api similar to gson and moshi.
- Based on kxml which is fast and memory efficient on Android.
- More performant than SimpleXML while requiring less annotations in the common case.
compile 'me.tatarka.parsnip:parsnip:0.3'
<dependency>
<groupId>me.tatarka.parsnip</groupId>
<artifactId>parsnip</artifactId>
<version>0.2</version>
</dependency>
There is also a retrofit converter
compile 'me.tatarka.parsnip:parsnip-retrofit-converter:0.3'
<dependency>
<groupId>me.tatarka.parsnip</groupId>
<artifactId>parsnip-retrofit-converter</artifactId>
<version>0.2</version>
</dependency>
String xml = ...;
Xml xml = new Xml.Builder().build();
XmlAdapter<BlackjackHand> xmlAdapter = xml.adapter(BlackjackHand.class);
BlackjackHand blackjackHand = xmlAdapter.fromXml(xml);
BlackjackHand blackjackHand = new BlackjackHand(
new Card('6', SPADES),
Arrays.asList(new Card('4', CLUBS), new Card('A', HEARTS)));
Xml xml = new Xml.Builder().build();
XmlAdapter<BlackjackHand> xmlAdapter = xml.adapter(BlackjackHand.class);
String xml = xmlAdapter.toXml(blackjackHand);
Parsnip has built-in support for reading and writing
- primitive types
- arrays, collections and lists
- Strings
- enums
It supports classes by writing them out field-by-field. Primitives will be written out as attributes by default, classes will be written out as tags.
If you have these classes:
class BlackjackHand {
public final Card hiddenCard;
public final List<Card> visibleCard;
...
}
class Card {
public final char rank;
public final Suit suit;
...
}
enum Suit {
CLUBS, DIAMONDS, HEARTS, SPADES;
}
Parsnip will read and write this xml:
<BlackjackHand>
<hiddenCard rank="6" suit="SPADES"/>
<visibleCard rank="4" suit="CLUBS"/>
<visibleCard rank="A" suit="HEARTS"/>
</BlackjackHand>
You can customize the names of tags and attributes with @SerializedName()
. The above example will look a little better as such:
class BlackjackHand {
@SerializedName("HiddenCard")
public final Card hiddenCard;
@SerializedName("VisibleCard")
public final List<Card> visibleCards;
...
}
class Card {
public final char rank;
public final Suit suit;
...
}
enum Suit {
CLUBS, DIAMONDS, HEARTS, SPADES;
}
<BlackjackHand>
<HiddenCard rank="6" suit="SPADES"/>
<VisibleCard rank="4" suit="CLUBS"/>
<VisibleCard rank="A" suit="HEARTS"/>
</BlackjackHand>
You can use the @Text
annotation to read/write the text of a tag.
class Card {
@Text
public final char rank;
public final Suit suit;
}
<Card suit="SPADES">6</Card>
Often times you only care about the contents of a tag, not any of it's attributes. You can save some nesting in your hiarchy with the @Tag
annotation.
class Card {
@Tag
public final char rank;
@Tag
public final Suit suit;
}
<Card>
<rank>6</rank>
<suit>SPADES</suid>
</Card>
By default, any namespace on an element will be ignored. If you want to enforce a namespace, you can use the @Namespace
annotation.
class Card {
@Namespace("http://example.com", alias="ns")
public final char rank;
}
will read
<Card xmlns:ns="http://example.com" rank="ignored" ns:rank="6"/>
as 6
.
When writing xml, the given alias will be used.
Copyright 2015 Evan Tatarka
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.