/branches/v2_0_0_prep/libraries/libFMap_dal/src/org/gvsig/fmap/dal/DataManager.java - Diff - | gvSIG desktop 1 - gvSIG

Revision 27723 branches/v2_0_0_prep/libraries/libFMap_dal/src/org/gvsig/fmap/dal/DataManager.java

     import org.gvsig.fmap.dal.exception.InitializeException;
     import org.gvsig.fmap.dal.exception.ProviderNotRegisteredException;
     import org.gvsig.fmap.dal.exception.ValidateDataParametersException;
     import org.gvsig.fmap.dal.feature.FeatureIndex;
     import org.gvsig.fmap.dal.feature.spi.index.FeatureIndexProvider;
     import org.gvsig.fmap.dal.resource.ResourceManager;
-...
     /**
      * There are two top level management roles within DAL: data access and resource management.
+     *
+     *
      * This class is responsible of the data access management role. It provides ways
      * for registering and instantiating {@link DataServerExplorer}(s), {@link DataStore}(s),
      * for registering and instantiating {@link DataServerExplorer}(s), {@link DataStore}(s),
      * {@link Evaluator}(s) and {@link FeatureIndex}(es).
+     *
      * @see ResourceManager
+     *
+     *
      * @see ResourceManager
+     *
      */
     public interface DataManager {
     	/**
     	 * Returns the default DAL's temporary directory
+    	 *
+    	 *
     	 * @return Temporary directory name
     	 */
     	public String getTemporaryDirectory();
-...
     	/**
     	 * Creates, initializes and returns an instance of DataStoreParameters given
     	 * the name with which their provider is registered.
+    	 *
+    	 *
     	 * @param name
     	 *            provider name
+    	 *
+    	 *
     	 * @throws InitializeException
+    	 *
+    	 *
     	 * @throws ProviderNotRegisteredException
     	 **/
     	public DataStoreParameters createStoreParameters(String name)
     			throws InitializeException, ProviderNotRegisteredException;
     	/**
+    	 *
+    	 *
     	 * Creates, initializes and returns an instance of DataStore given the
     	 * DataStoreParameters.
+    	 *
+    	 *
     	 * @param parameters
     	 *            parameters used to instantiate and initialize the DataStore
+    	 *
+    	 *
     	 * @throws InitializeException
+    	 *
+    	 *
     	 * @throws ProviderNotRegisteredException
     	 * @throws ValidateDataParametersException
     	 **/
     	public DataStore createStore(DataStoreParameters parameters)
     			throws InitializeException, ProviderNotRegisteredException;
     			throws InitializeException, ProviderNotRegisteredException,
     			ValidateDataParametersException;
     	/**
     	 * Returns a list of Strings containing the names of all available DataStore
     	 * providers.
+    	 *
+    	 *
     	 * @return list of String containing available DataStore provider names
     	 */
     	public List getStoreProviders();
-...
     	 * Explorer related services
     	 */
     	/**
     	 * Returns an instance of {@link DataServerExplorerParameters} corresponding to
     	 * Returns an instance of {@link DataServerExplorerParameters} corresponding to
     	 * the given name.
+    	 *
     	 * @param name
     	 *            name of a registered server explorer provider
+    	 *
+    	 *
     	 * @throws InitializeException
     	 * 			if parameter initialization causes an error.
+    	 *
+    	 *
     	 * @throws ProviderNotRegisteredException
     	 * 			if could not find a provider by the given name.
+    	 *
+    	 *
     	 **/
     	public DataServerExplorerParameters createServerExplorerParameters(
     			String name)
-...
     	/**
     	 * Returns an instance of {@link DataServerExplorer} given its parameters.
+    	 *
+    	 *
     	 * @param parameters
     	 * 			parameters used to instantiate and initialize the {@link DataServerExplorer}.
     	 *            parameters used to instantiate and initialize the
     	 *            {@link DataServerExplorer}.
+    	 *
     	 * @return an instance of {@link DataServerExplorer}.
+    	 *
     	 * @throws InitializeException
+    	 *
     	 * @return
     	 * 		an instance of {@link DataServerExplorer}.
+    	 *
     	 * @throws InitializeException
+    	 *
     	 * @throws ProviderNotRegisteredException
     	 * @throws ValidateDataParametersException
     	 */
     	public DataServerExplorer createServerExplorer(
     			DataServerExplorerParameters parameters)
     			throws InitializeException, ProviderNotRegisteredException;
     			throws InitializeException, ProviderNotRegisteredException,
     			ValidateDataParametersException;
     	/**
     	 * Returns a list of String containing the names of the available
     	 * DataServerExplorer providers.
+    	 *
+    	 *
     	 * @return list of String containing the names of the available
     	 *         DataServerExplorer providers.
     	 */
-...
     	/*
     	 * ====================================================================
+    	 *
+    	 *
     	 * Expression evaluation related services
     	 */
     	/**
     	 * Registers the default expression evaluator. It is used by DAL to evaluate
     	 * and resolve query filters and expressions.
+    	 *
+    	 *
     	 * @param evaluator
     	 *            Class that will be called to evaluate the expression. It must
     	 *            implement {@link Evaluator}.
-...
     	/**
     	 * Creates an instance of Evaluator that represents the given expression.
+    	 *
+    	 *
     	 * @param expression
     	 *            String containing a CQL expression.
     	 * @return instance of Evaluator representing the given expression.
-...
     	/*
     	 * ====================================================================
+    	 *
+    	 *
     	 * Index related services
     	 */
-...
     	/**
     	 * Returns a list of String containing the names of the available index providers.
+    	 *
     	 * @return
     	 * @return
     	 * 		list of strings with the names of the available index providers
     	 */
     	public List getFeatureIndexProviders();
     	/**
     	 * Sets the default DataIndexProvider for the given data type.
+    	 *
     	 * @param dataType
+    	 *
     	 * @param dataType
     	 * 				one of the data types defined in {@link DataTypes}.
     	 * @param name
     	 * @param name
     	 * 			Provider's name
     	 */
         public void setDefaultFeatureIndexProviderName(int dataType, String name);
-...
     	/**
     	 * Returns the default DataIndexProvider name, given a data type. Data types
     	 * are defined in {@link DataTypes}.
+    	 *
+    	 *
     	 * @param dataType
     	 *            one of the constants in {@link DataTypes}.
+    	 *
+    	 *
     	 * @return
     	 * 		the name of the default {@link FeatureIndexProvider} if there is
     	 * 		the name of the default {@link FeatureIndexProvider} if there is
     	 * 		anyone available for the given data type.
     	 */
         public String getDefaultFeatureIndexProviderName(int dataType);

Also available in: Unified diff