Revision 25785 branches/v2_0_0_prep/libraries/libFMap_dal/src/org/gvsig/fmap/dal/DataStore.java

View differences:

DataStore.java
3 3 
import java.util.Iterator;
4 4 

  		




  5
  5
  
    
import org.gvsig.fmap.dal.exception.DataException;


  		




  6
  
  
    
import org.gvsig.metadata.Metadatable;


  		




  
  6
  
    
import org.gvsig.metadata.Metadata;


  		




  7
  7
  
    
import org.gvsig.tools.observer.ComplexWeakReferencingObservable;


  		




  8
  8
  
    
import org.gvsig.tools.observer.Observer;


  		




  9
  
  
    
import org.gvsig.tools.operations.Operations;


  		




  10
  9
  
    
import org.gvsig.tools.persistence.Persistent;


  		




  11
  10
  
    

  		




  12
  11
  
    
/**


  		




  13
  
  
    
 * <p>This is the basic interface for all data stores. Depending on the context, 


  		




  14
  
  
    
 * it can represent a geographic layer, an alphanumeric database table or any data file. 


  		




  15
  
  
    
 * DataStore offers generic services like:


  		




  16
  
  
    
 *   <ul>


  		




  17
  
  
    
 *     <li>Open, close and reject data stores</li>


  		




  18
  
  
    
 *     <li>Access to data sets, with the possibility of loading data 


  		




  19
  
  
    
 *     	in background.</li>


  		




  20
  
  
    
 *     <li>Use of selection and locks, as well as data sets</li>


  		




  21
  
  
    
 *     <li>Editing</li>


  		




  22
  
  
    
 *     <li>Register of event observers through the Observable interface</li>


  		




  23
  
  
    
 *     <li>Access to data stores embedded into itself (like GML)</li>


  		




  24
  
  
    
 *     <li>Information about the Spatial Reference Systems used by the data store</li>


  		




  25
  
  
    
 *   </ul>


  		




  
  12
  
    
 * <p>


  		




  
  13
  
    
 * This is the basic interface for all data stores. Depending on the context, it


  		




  
  14
  
    
 * can represent a geographic layer, an alphanumeric database table or any data


  		




  
  15
  
    
 * file. DataStore offers generic services like:


  		




  
  16
  
    
 * <ul>


  		




  
  17
  
    
 * <li>Open, close and reject data stores</li>


  		




  
  18
  
    
 * <li>Access to data sets, with the possibility of loading data in background.</li>


  		




  
  19
  
    
 * <li>Use of selection and locks, as well as data sets</li>


  		




  
  20
  
    
 * <li>Editing</li>


  		




  
  21
  
    
 * <li>Register of event observers through the Observable interface</li>


  		




  
  22
  
    
 * <li>Access to data stores embedded into itself (like GML)</li>


  		




  
  23
  
    
 * <li>Information about the Spatial Reference Systems used by the data store</li>


  		




  
  24
  
    
 * </ul>


  		




  26
  25
  
    
 * </p>


  		




  27
  26
  
    
 * <br>


  		




  28
  
  
    
 *


  		




  
  27
  
    
 * 


  		




  29
  28
  
    
 */


  		




  30
  29
  
    
public interface DataStore extends ComplexWeakReferencingObservable, Persistent,


  		




  31
  
  
    
		Operations { // , Metadatable {


  		




  
  30
  
    
		Metadata {


  		




  32
  31
  
    

  		




  
  32
  
    
	public static final String DYNCLASS_NAME = "DataStore";


  		




  
  33
  
    

  		




  33
  34
  
    
	/**


  		




  34
  35
  
    
	 * Returns this store's name.


  		




  35
  36
  
    
	 * 


  		




  ......




  44
  45
  
    
	 */


  		




  45
  46
  
    
	public DataStoreParameters getParameters();


  		




  46
  47
  
    

  		




  47
  
  
    

  		




  48
  48
  
    
	/**


  		




  49
  49
  
    
	 * Refreshes this store state.


  		




  50
  50
  
    
	 * 


  		




  ......




  94
  94
  
    
	 * Loads a subset of data taking into account the properties and


  		




  95
  95
  
    
	 * restrictions of the DataQuery. Data loading is performed by calling the


  		




  96
  96
  
    
	 * Observer, once each data block is loaded.


  		




  97
  
  
    
	 *


  		




  
  97
  
    
	 * 


  		




  98
  98
  
    
	 * @param dataQuery


  		




  99
  
  
    
	 *            defines the properties of the requested data	 


  		




  
  99
  
    
	 *            defines the properties of the requested data


  		




  100
  100
  
    
	 * @param observer


  		




  101
  101
  
    
	 *            to be notified for each block of data loaded


  		




  102
  102
  
    
	 * @throws DataException


  		




  ......




  123
  123
  
    

  		




  124
  124
  
    
	/**


  		




  125
  125
  
    
	 * Creates a new selection.


  		




  126
  
  
    
	 *


  		




  
  126
  
    
	 * 


  		




  127
  127
  
    
	 * @return DataSet that contains the selection


  		




  128
  128
  
    
	 * 


  		




  129
  129
  
    
	 * @throws DataException


  		




  ......




  138
  138
  
    
	public Iterator getChildren();


  		




  139
  139
  
    

  		




  140
  140
  
    
	/**


  		




  141
  
  
    
	 * Returns the DataServerExplorer to which this DataStore belongs, if there is any.


  		




  
  141
  
    
	 * Returns the DataServerExplorer to which this DataStore belongs, if there


  		




  
  142
  
    
	 * is any.


  		




  142
  143
  
    
	 * 


  		




  143
  
  
    
	 * @return DataServerExplorer to which this DataStore belongs, or <code>null</code> if 


  		




  144
  
  
    
	 * 		   this was not accessed through any DataServerExplorer.


  		




  
  144
  
    
	 * @return DataServerExplorer to which this DataStore belongs, or


  		




  
  145
  
    
	 *         <code>null</code> if this was not accessed through any


  		




  
  146
  
    
	 *         DataServerExplorer.


  		




  145
  147
  
    
	 * 


  		




  146
  148
  
    
	 * @throws DataException


  		




  147
  149
  
    
	 */


  		












Also available in:  Unified diff