原文链接:Gson — Mapping of Maps
作者:Norman Peitek
翻译:签到钱就到
在发布了多篇关于如何处理不同数据类型的文章之后,我们会在这篇文章中处理Java的Map类型。你会学习如何使用Gson库去序列化(反序列化)Java的Map。
当然,这不是我们Gson系列里唯一的一篇文章,如果你对其他的主题感兴趣,可以看一下我们的大纲:
Gson系列概览
- 用java-JSON实现序列化合反序列化
- 嵌套对象的映射
- 数组和列表对象的映射
- Map的映射
- Mapping of Sets
- Mapping of Null Values
- Gson Model Annotations — How to Ignore Fields with @Expose
- Gson Model Annotations — How to Change the Naming of Fields with @SerializedName
- Gson Builder — Basics & Naming Policies
- Gson Builder — Force Serialization of null Values
- Gson Builder — Exclusion Strategies
- Gson Builder — Relax Gson with Lenient
- Gson Builder — Special Values of Floats & Doubles
- Gson Builder — Model Versioning
- Gson Builder — Formatting of Dates & Custom Date/Time Mapping
- Gson Builder — Pretty Printing
- Gson Builder — HTML Escaping
Java中Map的序列化
Java的Map是一个非常灵活的数据类型,可以被用在各种各样的场景中。它允许我们开发者用Java语言去物化许多真实世界的情况。由于Java的Map使用非常广泛,我们可能不会覆盖到你正在用的案例,但将会覆盖到所有的方法。
让我们用一个场景来开始,你的应用有员工姓名的列表,你被要求去实现一个以某个特定字母开头的所有员工展示界面。例如,用户可以选择字母A
,此时,你的应用会返回三个匹配的员工名字:Andreas
、Aden
和Arnold
。第一次迭代只是列出了所有名字的列表,但是性能往往是不够的。因此,转去使用HashMap
实现,第一个字母作为键(Key)(如:A
),值将是一个名字的列表。
如果我们创建我们的HashMap
,我们的Java代码将会是这样:
HashMap> employees = new HashMap<>();
employees.put("A", Arrays.asList("Andreas", "Arnold", "Aden"));
employees.put("C", Arrays.asList("Christian", "Carter"));
employees.put("M", Arrays.asList("Marcus", "Mary"));
Map的序列化与其他类型是一样的,你可以将其直接传给Gson,Gson会正确地处理:
Gson gson = new Gson();
String employeeJson = gson.toJson(employees);
返回的JSON数据:
{
"M": [
"Marcus",
"Mary"
],
"C": [
"Christian",
"Carter"
],
"A": [
"Andreas",
"Arnold",
"Aden"
]
}
每个键(A
,C
和M
)都有自己的名字列表,这正是我们想要的。
Java中Map的反序列化
如果你看了前面一节的JSON数据,或者下面的JSON数据。你会问你自己:如何才能区分一个集合和多个对象呢?答案很简单:你不能。这是为数不多的几个特性之一,JSON数据表示是模棱两可的。看看下面的列子:
{
"1$": {
"amount": 1,
"currency": "Dollar"
},
"2$": {
"amount": 2,
"currency": "Dollar"
},
"3€": {
"amount": 3,
"currency": "Euro"
}
}
在JSON中,读者可以假设有名字分别是1$
、2$
和3€
的3个对象,每个对象都有自己的值。但另一方面也能被看作是一个简单的Map,1$
、2$
和3€
是键(Key)。
没有可靠的方法评估一个JSON数据类型是什么。这里提供一些关键点来帮助你:
- 第一且最重要的:上下文知识!如果你有文档或已经知道所描述的对象应该是怎样的,你应该能够区分单独的对象和Map数据。
- 值的数据类型是一致的吗?一致的就可能是Map
- 对象名称/键是动态的和广泛的吗?这也是Map类型的提示。
我们可以使用在列表对象文章中展示的TypeToken
方法。你用我们期望的数据类型通过创建一个新的TypeToken
得到一个Type方法:
public class AmountWithCurrency {
String currency;
int amount;
}
String dollarJson = "{ '1$': { 'amount': 1, 'currency': 'Dollar'}, '2$': { 'amount': 2, 'currency': 'Dollar'}, '3€': { 'amount': 3, 'currency': 'Euro'} }";
Gson gson = new Gson();
Type amountCurrencyType =
new TypeToken>(){}.getType();
HashMap amountCurrency =
gson.fromJson(dollarJson, amountCurrencyType);
amountCurrency
变量实际上持有了整个正确的键、值集合:
嵌套的Map
Map数据结构不会成为模型/JSON的根元素。它只能是一个对象的属性。你得用像处理列表一样的方式序列化和反序列化它。我们也在这里发布了为嵌套行为的指导方式。
展望
本文中,你学习了如何在JSON数据和Java的Map之间序列化和反序列化。你也学习了可能遇见的问题,以及如何克服的方法。下篇博客,我们会研究与Map非常相似的数据类型Set
。请继续关注!
如果你需要反馈或有疑问,在评论中让我们知道或twitter @futurestud_io。