Bag集合工具类（apache-commons-collections3.2工具包）在java中的使用



Bag 是在 org.apache.commons.collections 包中定义的接口 ，也是集合的一种扩充工具类，当然结合用JDK中的map类进行相应的逻辑处理，也能实现Bag类的功能，但apache推出来肯定有它的原因和用处，知道有这么一个类了解它大概的用法，开发的时候真遇到这种情况，知道有这么个工具在你身边等着你用呢。

此接口定义源码：

public interface Bag extends Collection {

    /**
     * Returns the number of occurrences (cardinality) of the given
     * object currently in the bag. If the object does not exist in the
     * bag, return 0.
     * 
     * @param object  the object to search for
     * @return the number of occurrences of the object, zero if not found
     */
    int getCount(Object object);

}

它 继承了 java.util.Collection ， 而它的实现类都被放在下面的bag 包中:

 Bag,"袋"的意思，肯定是装“东西”的，之所以有这样一组类型 ， 是因为我们有时候需要在Collection 中存放多个相同对象的拷贝 ， 并且需要很方便的取得该对象拷贝的个数 。 需要注意的一点是它虽然继承JDK中的Collection ，但是如果真把它完全当作java.util.Collection 来用会遇到语义上的问题，HashBag 是 Bag 接口的一个标准实现。而BagUtils 提供一组static 的方法让调用者获取经过不同装饰后的 Bag 实例。

看一下具体用法就一目了然了：

定义一个简单辅助类：

package apache_commons_collections;

public class Person {
	public String name;
	public int year;
	
	public Person(){
		
	}
	
	public Person(String name,int year){
		this.name=name;
		this.year=year;
	}
	
	public String getName(){
		return this.name;
	}
	
	public int getYear(){
		return this.year;
	}
}

测试：

package apache_commons_collections;

import org.apache.commons.collections.Bag;
import org.apache.commons.collections.BagUtils;
import org.apache.commons.collections.bag.HashBag;


public class BagTest {
	
	public static void main(String args[]){
		Person p1=new Person("chen",23);
		Person p2=new Person("chen",21);
		Person p3=new Person("chen",11);
		Bag myBag=BagUtils.typedBag(new HashBag(),Person.class);	//实例化一个Bag
		myBag.add(p1,11);	
		myBag.add(p2,143);	
		myBag.add(p3,67);	
		
		System.out.println(myBag.getCount(p1));
		System.out.println(myBag.getCount(p2));
		System.out.println(myBag.getCount(p3));
	}
}

结果：

11
143
67

更加详细的用法和说明，大家可以 http://commons.apache.org/proper/commons-collections/下载源码和相应的API文档仔细研究研究。

注意:这组接口违反了 Collection contract。这些方法中指定的行为不一样所指定的行为集合。不合规的方法显然是标有“(违反)”。使用这个Bag保持谨慎。
这违反了从原始规范的接口。在一个理想世界中,接口将改变解决此问题,但是已经决定维持向后兼容性。