- 原文链接 : The mysterious case of the Bundle and the Map
- 译者 : yinna317
- 校对者: chaossss
- 状态 : 翻译完成
##前言
因为往Bundle对象中放入Map实际上没有表面上看起来那么容易。
这篇博客是在Eugenio @workingkills Marletti的帮助下完成的。
警告：这是一篇篇幅较长的博客
##案例：往Bundle对象放入特殊的Map
假设有这样一个案例：你需要将一个要传递的map附加到Intent对象。这个案例虽然不常见，但是，这种情况也是很有可能发生。
如果你在Intent对象中附加的是一个Map最常见的接口实现类HashMap，而不是包含附加信息的自定义类，你是幸运的，你可以用以下方法将map附加到Intent对象:
intent.putExtra("map",myHashMap);在你接收的Activity里，你可以用以下方法毫无问题地取出之前在Intent中附加的Map:
HashMap map = (HashMap) getIntent().getSerializableExtra("map");但是，如果你在Intent对象附加另一种类型的Map，比如：一个TreeMap（或者其他的自定义Map接口实现类），你在Intent中取出之前附加的TreeMap时，你用如下方法：
TreeMap map = (TreeMap) getIntent().getSerializableExtra("map");`然后就会出现一个类转换异常:
java.lang.ClassCastException: java.util.HashMap cannot be cast to java.util.TreeMap`因为编译器认为你的Map(TreeMap)正试图转换成一个HashMap
稍后我会详细地为大家讲解我为什么用 getSerializableExtra() 这个方法来取出附加到Intent中的Map。现在我可以先给大家一个通俗易懂的解释：因为所有默认的 Map 接口实现类都是Serializable,并且 putExtra()/getExtra() 方法接受的参数几乎都是“键-值”对，而其中值的类型非常广泛，Serializable就是其中之一，因此我们能够使用 getSerializableExtra() 来取得我们传递的Map。
在我们进行下一步之前，让我们去了解调用putExtra()/get*Extra()时涉及到的一些类或方法。
提示：文章很长，如果你只是想要一个解决方案的话，请跳到文章的最后面解决方案那里。
##Parcels:
大家都知道（也许少部分人不知道），在Android 系统中所有进程间通信是基于Binder机制。但是，希望大家明白的是允许数据在进程间传递是基于Parcel。
Parcel是Android进程间通信中， 高效的专用序列化机制。
与 Serializable 相反，Parcels 决不应该被用于储存任何类型的持久性数据，因为 Parcels 并不是为“操作可更新数据”（可更新数据指的是，具有持久性的数据会由于它的长留存时间会不断更新它的值）提供的，Parcels 更多的是传递 “短暂的一次性数据”，所以，不管什么时候使用Bundle，你在底层处理的都是Parcel。比如附加数据到Intent对象，在Fragment中设参数，等等。
Parcels 能处理很多类型，包括：本地类型，字符串类型，数组类型，Map类型，sparse arrays类型，以及parcelables和serializables对象。 除非你必须使用Serializable,一般情况下推荐使用Parcelables读写数据到Parcel.
相较于Serializable，Parcelable的优势更多地体现在性能上，因为Parcelable在内存开销方面更小，而这个理由足以让我们在大多数情况下毫不犹豫地选择Parcelable而不是Serializable。
##深入底层分析
让我们来了解下是什么原因使我们得到了ClassCastException异常。 从我们的代码中可以看到，我们对Intent中putExtras()的调用实际上是传入了一个String值和一个Serializable的对象，而不是传入一个Map值。因为Map接口实现类都是Serializable的，而不是Parcelable的。
###第一步：找到第一个突破口
让我们来看看在Intent.putExtra(String, Serializable)方法中做了什么。
Intent.java
public Intent putExtra(String name, Serializable value) {
// ...
mExtras.putSerializable(name, value);
return this;
}
}在这里，mExtras是个Bundle，Intent指令所有附加信息到bundle，从而调用了Bundle的putSerializable()方法，让我们来看看在Bundle中的putSerializable()方法中做了什么：
Bundle.java
@Override
public void putSerializable(String key, Serializable value) {
super.putSerializable(key, value);
}从上面代码我们可以看出，Bundle中的putSerializable()方法中只是对父类的实现，调用了父类BaseBundle中的putSerializable（）方法。
BaseBundle.java
void putSerializable(String key, Serializable value) {
unparcel();
mMap.put(key, value);
}首先，让我们忽略其中的unparcel()这个方法。我们注意到mMap是一个ArrayMap<String, Object>类型的。这告诉我们，到了这步，我们往mMap中设入的是一个Object类型的。也就是说，不管我们之前是什么类型，在父类BaseBundle这里都转成了Obeject类型。
####这里开始出现问题了
###第二步：分析写入 map
有趣的是当把Bundle中的值写入到一个Parcel中时，如果此时我们去检查我们附加值的类型，我们发现仍然能得到正确的类型。
Intent intent = new Intent(this, ReceiverActivity.class);
intent.putExtra("map", treeMap);
Serializable map = intent.getSerializableExtra("map");
Log.i("MAP TYPE", map.getClass().getSimpleName());如我们所料，这里打印出来的是TreeMap类型的。因此，在Bundle中写成一个Parcel，与再次读这期间一定发生了类型转换。
如果我们观察下是怎样写入Parcel的，我们看到，实际上是调BaseBundle中的writeToParcelInner()方法。
BaseBundle.java
void writeToParcelInner(Parcel parcel, int flags) {
if (mParcelledData != null) {
// ...
} else {
// ...
int startPos = parcel.dataPosition();
parcel.writeArrayMapInternal(mMap);
int endPos = parcel.dataPosition();
// ...
}
}跳过所有不相干的代码，我们看到在Parcel的writeArrayMapInternal()方法中做了大量的事（mMap 是一个 ArrayMap类型）
Parcel.java
/* package */ void writeArrayMapInternal(
ArrayMap<String, Object> val) {
// ...
int startPos;
for (int i=0; i<N; i++) {
// ...
writeString(val.keyAt(i));
writeValue(val.valueAt(i));
// ...
}
}####下一步让我们更深入地分析
###第三步：分析写入Map值
那么，在Parcel中writeValue() 方法又是怎样呢？主要是一些if...else语句。
Parcel.java
public final void writeValue(Object v) {
if (v == null) {
writeInt(VAL_NULL);
} else if (v instanceof String) {
writeInt(VAL_STRING);
writeString((String) v);
} else if (v instanceof Integer) {
writeInt(VAL_INTEGER);
writeInt((Integer) v);
} else if (v instanceof Map) {
writeInt(VAL_MAP);
writeMap((Map) v);
} else if (/* you get the idea, this goes on and on */) {
// ...
} else {
Class<?> clazz = v.getClass();
if (clazz.isArray() &&
clazz.getComponentType() == Object.class) {
// Only pure Object[] are written here, Other arrays of non-primitive types are
// handled by serialization as this does not record the component type.
writeInt(VAL_OBJECTARRAY);
writeArray((Object[]) v);
} else if (v instanceof Serializable) {
// Must be last
writeInt(VAL_SERIALIZABLE);
writeSerializable((Serializable) v);
} else {
throw new RuntimeException("Parcel: unable to marshal value "+ v);
}
}
}虽然TreeMap是以Serializable的类型传入到 bundle，但是在Parcel中writeValue(）方法执行的是map这个分支的代码---“v instanceof Map”，（“v instanceof Map”在“v instanceOf Serializable”之前）
####到了这里，问题更明显了。
现在我想，他们是不是对 Map 进行了一些非常规的处理，使得 Map 将无可避免地被转换为 HashMap 类型。
###第四步：分析将Map写入到Parcel中
Parcel中的writeMap()方法并没有做什么事，只是将我们传入的Map值强转成Map<String, Object>类型，调用writeMapInternal（）方法。
Parcel.java
public final void writeMap(Map val) {
writeMapInternal((Map<String, Object>) val);
}JavaDoc文档对这个方法的解释非常清楚：即Map必须是String类型的。
尽管我们可能传入一个key值不为String的Map,类型擦除也使我们不会获得运行时错误。(这是完全非法的)
事实上，看一下Parcel中的writeMapInternal()方法，这更打击我们。
Parcel.java
/* package */ void writeMapInternal(Map<String,Object> val) {
// ...
Set<Map.Entry<String,Object>> entries = val.entrySet();
writeInt(entries.size());
for (Map.Entry<String,Object> e : entries) {
writeValue(e.getKey());
writeValue(e.getValue());
}
}类型擦除使所有的这些代码都不会出现运行时错误。
实际上，在我们遍历Map调用writeValue()方法时，依赖的是原先的类型检查。从我们之前分析writeValue() 这个方法能看出，writeValue(）能处理非String类型的key值。
也许这里的文档和代码在某些地方有些不一致（还没有同步）。 但是，如果你在一个Bundle里对TreeMap<Integer, Object>进行设值和取值，将不会出现问题。 当然也还是会出现TreeMap转换成HashMap的异常。
####黑洞启示录：
在这里已经非常清楚了，当Map写入到一个Parcel时，Map丢失了它们的类型，所以当我们再次读时是没办法来复原原来的信息。
###第五步：分析读Map
让我们来看看Parcel中readValue()这个方法，这个方法和writeValue()相对应。
Parcel.java
public final Object readValue(ClassLoader loader) {
int type = readInt();
switch (type) {
case VAL_NULL:
return null;
case VAL_STRING:
return readString();
case VAL_INTEGER:
return readInt();
case VAL_MAP:
return readHashMap(loader);
// ...
}
}parcel处理写入数据的方式是：
-
写入一个int来定义数据类型（一个VAL_*的常量）。
-
存储数据本身（包括其他一些元数据，比如String这种没有固定大小的类型的数据长度）。
-
递归调用非原始数据类型。
这里我们可以看到，readValue()方法中，首先读取一个int的数据，这个int数据是在writeValue（）中将TreeMap设成的VAL_MAP的常量，然后去匹配后面的分支,调用readHashMap()方法来取回数据。
Parcel.java
public final HashMap readHashMap(ClassLoader loader)
{
int N = readInt();
if (N < 0) {
return null;
}
HashMap m = new HashMap(N);
readMapInternal(m, N, loader);
return m;
}readMapInternal()这个方法只是将我们从Parcel中读取的map重新进行打包。
这就是为什么我们总是从Bundle中获得一个HashMap，同样的，如果你创建了一个实现了Parcelable自定义类型Map,得到的也是一个HashMap。
很难说本身设计如此，还是是一个疏忽。 这确实是一个极端例子，因为在一个Intent中传一个Map是比较少见的，你也只有很小的理由来传Serializable而不是Parcelable的。 但是文档上没有写，这让我觉得应该是个疏忽，而不是本身设计如此。
##解决方案：
好了，分析底层代码我们已经弄明白了我们的问题，现在我们定位到问题的关键位置。 我们需要明白的是在writeValue()方法中，TreeMap没有进入“v instanceOf Map”这个分支
当我和 Eugenio谈话时，我想到的第一个想法是将map包裹成一个Serializable的容器，这个想法是丑陋的但是有效的。 Eugenio迅速写了个通用的wrapper类解决了这个问题。
MapWrapper.java
public class MapWrapper<T extends Map & Serializable> implements Serializable {
private final T map;
public MapWrapper(T map) {
this.map = map;
}
public T getMap() {
return map; public static <T extends Map & Serializable> Intent
putMapExtra(Intent intent, String name, T map) {
return intent.putExtra(name, new MapWrapper<>(map));
}
public static <T extends Map & Serializable> T
getMapExtra(Intent intent, String name)
throws ClassCastException {
Serializable s = intent.getSerializableExtra(name);
return s == null ? null : ((MapWrapper<T>)s).getMap();
}
}
}##另一个可行的解决方案：
另一个解决方法是，在你将Map附加到Intent前，将Map转成byte array的。然后调用getByteArrayExtra()方法。但是这种方法你必须处理序列化与反序列化的问题。
如果你想要其他的解决方案，你可以依据Eugenio提供的代码要点来写一个。
##当你不能掌控Intent上面的代码时：
也许，有这样或那样的原因，对于Bundle中的代码你无法掌控，比如可能在第三方的library中。
这种情况，要想到， Map接口实现类有一个构造器方法，可以将map作为参数传入，比如 new TreeMap(Map)，你可以把从Bundle中取回的HashMap，用构造器的方式转成你想要的类型。
不过，要记得的是，这种用构造器的方式，map中的附加属性将会丢失，只有键值对被保存了下来。
##总结：
在Android开发中，你可能会被一些表面的事所欺骗，特别是一些小的，似乎是无关紧要的事。
当事情没有像我们期盼中那样发生时，不要死盯着JavaDoc文档，因为JavaDoc可能过时了，JavaDoc的作者也不知道你的特殊需求。这个时候去看看源码，答案可能在AOSP代码里。
AOSP代码是我们的巨大财富，这在移动开发领域几乎是独一无二的，因为我们能够准确的知道在底层都做了些什么。
当你知道了底层代码执行了什么，你也就能够成为一个更好的开发人员。
记住：凡事要嘛就是成功，要嘛就是失败
##最后：
感谢chaossss 帮我校对文章
初次翻译，Android也是刚接触，翻译不好的地方，请大家多多指教。