code: public static Collection map(Mapper mapper, Iterator i, boolean includeNull) {
          ArrayList l = new ArrayList();
          while (i.hasNext()) {
              Object o = mapper.map(i.next());
              if (includeNull || o != null) {
                  l.add(o);
              }
          }
          return l;
      }
docs: Return the results of mapping all objects with the mapper.
  
  @param mapper an Mapper
  @param i an     Iterator
  @param includeNull specify whether nulls are included
  
  @return a Collection of the results.