-

注释弱参考对象。

此类提供了使用弱引用注释字段的方法。此类字段可由 RC / GC 回收。回收这些字段后,读取它们时将返回 null。这允许字段由代码逻辑正确处理。

以 HashMap 的 entrySet 为例。内部类和外部类对象形成循环引用。因此,您不能使用 UnownedOuter 来注释内部类,因为 entrySet 可以作为 Set 传递给 HashMap 的外部。在这种情况下,您可以将 entrySet 注释为弱引用。如果 entrySet 被回收,则可以使用 entrySet()方法返回无状态 entrySet 对象。

请参考以下示例代码:

   public class HashMap<K,V> extends AbstractMap<K,V>
       implements Map<K,V>, Cloneable, Serializable {
       ...;
       @Weak
       transient Set<Map.Entry<K,V>> entrySet;
       ...;
       public Set<Map.Entry<K,V>> entrySet() {
           Set<Map.Entry<K,V>> es;
           return (es = entrySet) == null ? (entrySet = new EntrySet()) : es;
       }
   }