Mapのputメソッドの戻り値

    return map.put(key, value); // putが戻り値を返すなんて。

今まで気づいてませんでした。

追記：
誤解を招くコードだったので修正しました。
＃キャッシュの用途としては間違っていました、すみません。
putメソッドの戻り値は以前の値なので注意しよう。

指定されたキーに関連した以前の値。key にマッピングがなかった場合は null。
Javadocより。