/* Copyright (C) 2004 - 2008  db4objects Inc.  http://www.db4o.com

This file is part of the db4o open source object database.

db4o is free software; you can redistribute it and/or modify it under
the terms of version 2 of the GNU General Public License as published
by the Free Software Foundation and as clarified by db4objects' GPL 
interpretation policy, available at
http://www.db4o.com/about/company/legalpolicies/gplinterpretation/
Alternatively you can write to db4objects, Inc., 1900 S Norfolk Street,
Suite 350, San Mateo, CA 94403, USA.

db4o is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
59 Temple Place - Suite 330, Boston, MA  02111-1307, USA. */
package com.db4o.cluster;

import com.db4o.*;
import com.db4o.internal.cluster.*;
import com.db4o.query.*;

/**
 * allows running Queries against multiple ObjectContainers.
 * @exclude   
 */
public class Cluster {
    
    public final ObjectContainer[] _objectContainers;
    
    /**
     * use this constructor to create a Cluster and call
     * add() to add ObjectContainers
     */
    public Cluster(ObjectContainer[] objectContainers){
        if(objectContainers == null){
            throw new NullPointerException();
        }
        if(objectContainers.length < 1){
            throw new IllegalArgumentException();
        }
        for (int i = 0; i < objectContainers.length; i++) {
            if(objectContainers[i] == null){
                throw new IllegalArgumentException();
            }
        }
        _objectContainers = objectContainers;
    }
    
    /**
     * starts a query against all ObjectContainers in 
     * this Cluster.
     * @return the Query
     */
    public Query query(){
        synchronized(this){
            Query[] queries = new Query[_objectContainers.length];
            for (int i = 0; i < _objectContainers.length; i++) {
                queries[i] = _objectContainers[i].query(); 
            }
            return new ClusterQuery(this, queries);
        }
    }
    
    /**
     * returns the ObjectContainer in this cluster where the passed object
     * is stored or null, if the object is not stored to any ObjectContainer
     * in this cluster
     * @param obj the object
     * @return the ObjectContainer
     */
    public ObjectContainer objectContainerFor(Object obj){
        synchronized(this){
            for (int i = 0; i < _objectContainers.length; i++) {
                if(_objectContainers[i].ext().isStored(obj)){
                    return _objectContainers[i];
                }
            }
        }
        return null;
    }
    
}
