PROSAGA码农传奇-google guava-Guava ForwardingList用法示例

<div class =“post-text”itemprop =“text”>
  <P>
    <a href="http://guava-libraries.googlecode.com/svn/trunk/javadoc/com/google/common/collect/ForwardingList.html" rel="noreferrer">
       <code>
        ForwardingList
      </code>
    </A>
     （哪一个
    <a href="http://guava-libraries.googlecode.com/svn/trunk/javadoc/com/google/common/collect/ForwardingCollection.html" rel="noreferrer">
       <code>
        extends ForwardingCollection
      </code>
    </A>
    ，反过来
    <a href="http://guava-libraries.googlecode.com/svn/trunk/javadoc/com/google/common/collect/ForwardingObject.html" rel="noreferrer">
       <code>
        extends ForwardingObject
      </code>
    </A>
    实现
    <a href="http://en.wikipedia.org/wiki/Decorator_pattern" rel="noreferrer">
      装饰图案
    </A>
    。
  </p>
  <P>
    要使用，您只需要做两件事：
  </p>
  <UL>
    <LI>
       <code>
        @Override delegate()
      </code>
       返回方法转发到的支持委托实例
    </LI>
    <LI>
       <code>
        @Override
      </code>
       随你
       <code>
        List
      </code>
       你想要/需要装饰的方法
    </LI>
  </UL>
  <P>
    装饰器模式允许您使用组合而不是继承（
    <EM>
      有效的Java第二版，支持组合而不是继承
    </EM>
    ），和
     <code>
      ForwardingList
    </code>
     来自Guava提供了一个方便的模板，您可以从中编写自己的模板
     <code>
      List
    </code>
     实现，为您提供所有的管道机制。
  </p>
  <P>
    请注意，如果您打算装饰一个
     <code>
      ArrayList
    </code>
    ，你可能想要你的
     <code>
      ForwardingList
    </code>
     子类也要实现
    <a href="http://java.sun.com/javase/6/docs/api/java/util/RandomAccess.html" rel="noreferrer">
       <code>
        RandomAccess
      </code>
    </A>
    。
  </p>
  <HR />
  <H3>
    例：
     <code>
      ListWithDefault
    </code>
  </H3>
  <P>
    这是一个（不完整！）的例子
     <code>
      ForwardingList
    </code>
     替代品
     <code>
      null
    </code>
     具有给定默认值的委托中的值。
  </p>
   <pre>
    <code>
      import java.util.*;
import com.google.common.collect.*;

public class ListWithDefault<E> extends ForwardingList<E> {
    final E defaultValue;
    final List<E> delegate;

ListWithDefault(List<E> delegate, E defaultValue) {
        this.delegate = delegate;
        this.defaultValue = defaultValue;
    }
    @Override protected List delegate() {
        return delegate;
    }
    @Override public E get(int index) {
        E v = super.get(index);
        return (v == null ? defaultValue : v);
    }
    @Override public Iterator<E> iterator() {
        final Iterator<E> iter = super.iterator();
        return new ForwardingIterator<E>() {
            @Override protected Iterator<E> delegate() {
                return iter;
            }
            @Override public E next() {
                E v = super.next();
                return (v == null ? defaultValue : v); 
            }
        };
    }
}

</code>
  </pre>
  <P>
    然后我们可以测试它如下：
  </p>
   <pre>
    <code>
          public static void main(String[] args) {
        List<String> names = new ListWithDefault<String>(
            Arrays.asList("Alice", null, "Bob", "Carol", null),
            "UNKNOWN"
        );

for (String name : names) {
            System.out.println(name);
        }
        // Alice
        // UNKNOWN
        // Bob
        // Carol
        // UNKNOWN

System.out.println(names);
        // [Alice, null, Bob, Carol, null]
}

</code>
  </pre>
  <P>
    请注意，这是一个
    <EM>
      残缺
    </EM>
     实现。该
     <code>
      toString()
    </code>
     方法仍然返回委托的
     <code>
      toString()
    </code>
    ，它不知道默认值。必须采取其他一些方法
     <code>
      @Override
    </code>
     以及更完整的实施。
  </p>
</DIV>