帶你領略 Google Collections 2

原貼地址：

http://jubin2002.javaeye.com/blog/471698

 

上篇講到google collections的幾個比較主要的點，今天我們來看看其提供的幾個小的但是相當有用的東西。

 

1，Preconditions

 

Preconditions 提供了狀態校驗的方法。

 

Before:

public
 Delivery createDelivery(Order order, User deliveryPerson) {

    if
(order.getAddress() == 
null
) {
        throw
 
new
 NullPointerException(
"order address"
);
    }

    if
(!workSchedule.isOnDuty(deliveryPerson, order.getArrivalTime())) {
        throw
 
new
 IllegalArgumentException(
            String.format("%s is not on duty for %s"
, deliveryPerson, order));
    }

    return
 
new
 RealDelivery(order, deliveryPerson);
}

public Delivery createDelivery(Order order, User deliveryPerson) {
    
    if(order.getAddress() == null) {
        throw new NullPointerException("order address");
    }
    
    if(!workSchedule.isOnDuty(deliveryPerson, order.getArrivalTime())) {
        throw new IllegalArgumentException(
            String.format("%s is not on duty for %s", deliveryPerson, order));
    }

    return new RealDelivery(order, deliveryPerson);
}

 After:

public
 Delivery createDelivery(Order order, User deliveryPerson) {
    Preconditions.checkNotNull(order.getAddress(), "order address"
);
    Preconditions.checkArgument(
        workSchedule.isOnDuty(deliveryPerson, order.getArrivalTime()),
            "%s is not on duty for %s"
, deliveryPerson, order);

    return
 
new
 RealDelivery(order, deliveryPerson);
}

public Delivery createDelivery(Order order, User deliveryPerson) {
    Preconditions.checkNotNull(order.getAddress(), "order address");
    Preconditions.checkArgument(
        workSchedule.isOnDuty(deliveryPerson, order.getArrivalTime()),
            "%s is not on duty for %s", deliveryPerson, order);

    return new RealDelivery(order, deliveryPerson);
}

 

2,Iterables.getOnlyElement

 

Iterables.getOnlyElement 確保你的集合或者迭代器包含了剛好一個元素並且返回該元素。如果他包含0和2+元素，它會拋出RuntimeException。一般在單元測試中使用。

 

Before：

public
 
void
 testWorkSchedule() {
    workSchedule.scheduleUserOnDuty(jesse, mondayAt430pm, mondayAt1130pm);

    Set<User> usersOnDuty = workSchedule.getUsersOnDuty(mondayAt800pm);
    assertEquals(1
, usersOnDuty.size());
    assertEquals(jesse, usersOnDuty.iterator().next());
}

public void testWorkSchedule() {
    workSchedule.scheduleUserOnDuty(jesse, mondayAt430pm, mondayAt1130pm);

    Set<User> usersOnDuty = workSchedule.getUsersOnDuty(mondayAt800pm);
    assertEquals(1, usersOnDuty.size());
    assertEquals(jesse, usersOnDuty.iterator().next());
}

 After：

public
 
void
 testWorkSchedule() {
    workSchedule.scheduleUserOnDuty(jesse, mondayAt430pm, mondayAt1130pm);

    Set<User> usersOnDuty = workSchedule.getUsersOnDuty(mondayAt800pm);
    assertEquals(jesse, Iterables.getOnlyElement(usersOnDuty));
}

public void testWorkSchedule() {
    workSchedule.scheduleUserOnDuty(jesse, mondayAt430pm, mondayAt1130pm);

    Set<User> usersOnDuty = workSchedule.getUsersOnDuty(mondayAt800pm);
    assertEquals(jesse, Iterables.getOnlyElement(usersOnDuty));
}

 Iterables.getOnlyElement比Set.iterator().getNext()和List.get(0)描述的更爲直接。

3，Objects.equal

 

Objects.equal(Object,Object) and Objects.hashCode(Object...)提供了內建的null處理，能使你實現equals() 和hashCode()更加簡單。

 

Before：

public
 
boolean
 equals(Object o) {
    if
 (o 
instanceof
 Order) {
      Order that = (Order)o;

      return
 (address != 
null
              ? address.equals(that.address)
              : that.address == null
)
          && (targetArrivalDate != null
              ? targetArrivalDate.equals(that.targetArrivalDate)
              : that.targetArrivalDate == null
)
          && lineItems.equals(that.lineItems);
    } else
 {
      return
 
false
;
    }
}

public
 
int
 hashCode() {
    int
 result = 
0
;
    result = 31
 * result + (address != 
null
 ? address.hashCode() : 
0
);
    result = 31
 * result + (targetArrivalDate != 
null
 ? targetArrivalDate.hashCode() : 
0
);
    result = 31
 * result + lineItems.hashCode();
    return
 result;
}

public boolean equals(Object o) {
    if (o instanceof Order) {
      Order that = (Order)o;

      return (address != null 
              ? address.equals(that.address) 
              : that.address == null) 
          && (targetArrivalDate != null 
              ? targetArrivalDate.equals(that.targetArrivalDate) 
              : that.targetArrivalDate == null)
          && lineItems.equals(that.lineItems);
    } else {
      return false;
    }
}

public int hashCode() {
    int result = 0;
    result = 31 * result + (address != null ? address.hashCode() : 0);
    result = 31 * result + (targetArrivalDate != null ? targetArrivalDate.hashCode() : 0);
    result = 31 * result + lineItems.hashCode();
    return result;
}

 After：

public
 
boolean
 equals(Object o) {
    if
 (o 
instanceof
 Order) {
      Order that = (Order)o;

      return
 Objects.equal(address, that.address)
          && Objects.equal(targetArrivalDate, that.targetArrivalDate)
          && Objects.equal(lineItems, that.lineItems);
    } else
 {
      return
 
false
;
    }
}

public
 
int
 hashCode() {
    return
 Objects.hashCode(address, targetArrivalDate, lineItems);
}

public boolean equals(Object o) {
    if (o instanceof Order) {
      Order that = (Order)o;

      return Objects.equal(address, that.address)
          && Objects.equal(targetArrivalDate, that.targetArrivalDate)
          && Objects.equal(lineItems, that.lineItems);
    } else {
      return false;
    }
}

public int hashCode() {
    return Objects.hashCode(address, targetArrivalDate, lineItems);
}

 

4，Iterables.concat()

 

Iterables.concat() 連結多種集合 (比如ArrayList和HashSet) 以至於你能在一行代碼裏遍歷他們:

 

Before：

public
 
boolean
 orderContains(Product product) {
    List<LineItem> allLineItems = new
 ArrayList<LineItem>();
    allLineItems.addAll(getPurchasedItems());
    allLineItems.addAll(getFreeItems());

    for
 (LineItem lineItem : allLineItems) {
      if
 (lineItem.getProduct() == product) {
        return
 
true
;
      }
    }

    return
 
false
;
}

public boolean orderContains(Product product) {
    List<LineItem> allLineItems = new ArrayList<LineItem>();
    allLineItems.addAll(getPurchasedItems());
    allLineItems.addAll(getFreeItems());

    for (LineItem lineItem : allLineItems) {
      if (lineItem.getProduct() == product) {
        return true;
      }
    }

    return false;
}

 After：

public
 
boolean
 orderContains(Product product) {
    for
 (LineItem lineItem : Iterables.concat(getPurchasedItems(), getFreeItems())) {
      if
 (lineItem.getProduct() == product) {
        return
 
true
;
      }
    }

    return
 
false
;
}

public boolean orderContains(Product product) {
    for (LineItem lineItem : Iterables.concat(getPurchasedItems(), getFreeItems())) {
      if (lineItem.getProduct() == product) {
        return true;
      }
    }

    return false;
}

 

5，Join

 

Join 是用分隔符分割字符串變得非常容易。

 

Before:

public
 
class
 ShoppingList {
  private
 List<Item> items = ...;

  ...

  public
 String toString() {
    StringBuilder stringBuilder = new
 StringBuilder();
    for
 (Iterator<Item> s = items.iterator(); s.hasNext(); ) {
      stringBuilder.append(s.next());
      if
 (s.hasNext()) {
        stringBuilder.append(" and "
);
      }
    }
    return
 stringBuilder.toString();
  }
}

public class ShoppingList {
  private List<Item> items = ...;

  ...

  public String toString() {
    StringBuilder stringBuilder = new StringBuilder();
    for (Iterator<Item> s = items.iterator(); s.hasNext(); ) {
      stringBuilder.append(s.next());
      if (s.hasNext()) {
        stringBuilder.append(" and ");
      }
    }
    return stringBuilder.toString();
  }
}

 

After:

public
 
class
 ShoppingList {
  private
 List<Item> items = ...;

  ...

  public
 String toString() {
    return
 Joiner.on(
" and "
).join(items);
  }
}

public class ShoppingList {
  private List<Item> items = ...;

  ...

  public String toString() {
    return Joiner.on(" and ").join(items);
  }
}

 

6,Maps, Sets and Lists

 

泛型是好的，不過他們有些過於羅嗦。

 

Before：

Map<CustomerId, BillingOrderHistory> customerOrderHistoryMap
    = new
 HashMap<CustomerId, BillingOrderHistory>();

Map<CustomerId, BillingOrderHistory> customerOrderHistoryMap 
    = new HashMap<CustomerId, BillingOrderHistory>();

 After：

Map<CustomerId, BillingOrderHistory> customerOrderHistoryMap
    = Maps.newHashMap();

Map<CustomerId, BillingOrderHistory> customerOrderHistoryMap 
    = Maps.newHashMap();

 

Maps, Sets and Lists 包含了工廠方法來創建集合對象。

 

另一個例子，Before：

Set<String> workdays = 
new
 LinkedHashSet<String>();
workdays.add("Monday"
);
workdays.add("Tuesday"
);
workdays.add("Wednesday"
);
workdays.add("Thursday"
);
workdays.add("Friday"
);

Set<String> workdays = new LinkedHashSet<String>();
workdays.add("Monday");
workdays.add("Tuesday");
workdays.add("Wednesday");
workdays.add("Thursday");
workdays.add("Friday");

 OR：

Set<String> workdays = 
new
 LinkedHashSet<String>(
  Arrays.asList("Monday"
, 
"Tuesday"
, 
"Wednesday"
, 
"Thursday"
, 
"Friday"
));

Set<String> workdays = new LinkedHashSet<String>(
  Arrays.asList("Monday", "Tuesday", "Wednesday", "Thursday", "Friday"));

 After：

Set<String> workdays = Sets.newLinkedHashSet(
  "Monday"
, 
"Tuesday"
, 
"Wednesday"
, 
"Thursday"
, 
"Friday"
);

Set<String> workdays = Sets.newLinkedHashSet(
  "Monday", "Tuesday", "Wednesday", "Thursday", "Friday");

 

Google Collections 對於Maps, Sets, Lists, Multimaps, Multisets 都提供了工廠方法 。