/trunk/libraries/libGDBMS/src/main/java/com/hardcode/gdbms/engine/data/DataSourceFactory.java - Diff - | gvSIG desktop 1 - gvSIG

Revision 4186 trunk/libraries/libGDBMS/src/main/java/com/hardcode/gdbms/engine/data/DataSourceFactory.java

     import com.hardcode.driverManager.Driver;
     import com.hardcode.driverManager.DriverLoadException;
     import com.hardcode.driverManager.DriverManager;
     import com.hardcode.driverManager.WriterManager;
     import com.hardcode.gdbms.engine.data.db.DBDataSource;
     import com.hardcode.gdbms.engine.data.db.DBDataSourceFactory;
     import com.hardcode.gdbms.engine.data.db.DBQuerySourceInfo;
-...
      * createRandomDataSource. Adem?s proporciona un m?todo para ejecutar consultas
      * SQL a partir de la instrucci?n como cadena o a partir de la instrucci?n como
      * ?rbol de adaptadores
+     *
+     *
      * @author Fernando Gonz?lez Cort?s
      */
     public class DataSourceFactory {
-...
     	private File tempDir = new File(".");
     	private WriterManager wm;
     	/**
     	 * Get's a unique id in the tableSource and nameOperationDataSource key sets
+    	 *
+    	 *
     	 * @return unique id
     	 */
     	private String getUID() {
-...
     	/**
     	 * Removes the association between the name and the data sources
+    	 *
+    	 *
     	 * @param ds
     	 *            Name of the data source to remove
+    	 *
+    	 *
     	 * @throws DriverException
     	 *             If ds is a database data source it's associated view must be
     	 *             deleted. Thrown if could not be deleted.
-...
     	/**
     	 * Removes de View of the data source 'ds'
+    	 *
+    	 *
     	 * @param ds
     	 *            DataSource whose view will be deleted
+    	 *
+    	 *
     	 * @throws DriverException
     	 *             If the view could not be deleted
     	 */
-...
     	/**
     	 * Removes the views created at query delegation
+    	 *
+    	 *
     	 * @throws DriverException
     	 *             If any view could not be removed
     	 */
-...
     	 * A?ade una fuente de datos de objeto. Dado un objeto que implemente la
     	 * interfaz del driver, se toma como fuente de datos y se le asocia un
     	 * nombre
+    	 *
+    	 *
     	 * @param rd
     	 *            objeto con la informaci?n
     	 * @param name
-...
     	 * A?ade una fuente de datos de objeto. Dado un objeto que implemente la
     	 * interfaz del driver, se toma como fuente de datos y se le asocia un
     	 * nombre
+    	 *
+    	 *
     	 * @param rd
     	 *            objeto con la informaci?n
+    	 *
+    	 *
     	 * @return the name of the data source
     	 */
     	public String addDataSource(ObjectDriver rd) {
-...
     	/**
     	 * Adds a new data source to the system. If the file doesn't exists it is
     	 * created when necessary
+    	 *
+    	 *
     	 * @param driverName
     	 *            Nombre del driver asociado a la fuente de datos
     	 * @param name
-...
     	 * A?ade un origen de datos de fichero al sistema. Cuando se cree un
     	 * DataSource mediante la invocaci?n createRandomDataSource(String) se
     	 * crear? una instancia del driver cuyo nombre es driverName
+    	 *
+    	 *
     	 * @param driverName
     	 *            Nombre del driver asociado a la fuente de datos
     	 * @param name
-...
     	/**
     	 * Gets a FileSourceInfo with the values passed in the parameters
+    	 *
+    	 *
     	 * @param driverName
     	 * @param name
     	 * @param file
+    	 *
+    	 *
     	 * @return FileSourceInfo
     	 */
     	private FileSourceInfo getFileSourceInfo(FileSourceInfo info,
-...
     	/**
     	 * Adds a spatial file data source to the system.
+    	 *
+    	 *
     	 * @param driverName
     	 *            driver used to obtain the data
     	 * @param name
-...
     	/**
     	 * Adds a spatial file data source to the system.
+    	 *
+    	 *
     	 * @param driverName
     	 *            driver used to obtain the data
     	 * @param file
     	 *            file with the data
+    	 *
+    	 *
     	 * @return String Generated name of the added data source
     	 */
     	public String addSpatialFileDataSource(String driverName, String file) {
-...
     	 * A?ade un origen de datos de fichero al sistema. Cuando se cree un
     	 * DataSource mediante la invocaci?n createRandomDataSource(String) se
     	 * crear? una instancia del driver cuyo nombre es driverName
+    	 *
+    	 *
     	 * @param driverName
     	 *            Nombre del driver asociado a la fuente de datos
     	 * @param file
     	 *            Fichero con los datos
+    	 *
+    	 *
     	 * @return Nombre ?nico que se asocia a la tabla
     	 */
     	public String addFileDataSource(String driverName, String file) {
-...
     	/**
     	 * Obtiene la informaci?n de la fuente de datos cuyo nombre se pasa como
     	 * par?metro
+    	 *
+    	 *
     	 * @param dataSourceName
     	 *            Nombre de la base de datos
+    	 *
+    	 *
     	 * @return Debido a las distintas formas en las que se puede registrar un
     	 *         datasource, se devuelve un Object, que podr? ser una instancia de
     	 *         DataSourceFactory.FileDriverInfo, DataSourceFactory.DBDriverInfo
-...
     	/**
     	 * Gets the information of all data sources registered in the system
+    	 *
+    	 *
     	 * @return DriverInfo[]
     	 */
     	public SourceInfo[] getDriverInfos() {
-...
     	/**
     	 * A?ade un origen de datos de base de datos al sistema
+    	 *
+    	 *
     	 * @param name
     	 *            Nombre de la tabla con el que se har? referencia en las
     	 *            instrucciones
-...
     	/**
     	 * Fills the info struct with the values passed in the parameters
+    	 *
+    	 *
     	 * @param info
     	 *            struct to populate
     	 * @param name
-...
     	/**
     	 * Adds a spatial database data source
+    	 *
+    	 *
     	 * @param name
     	 *            Name of the data source
     	 * @param host
-...
     	/**
     	 * Adds a spatial database data source
+    	 *
+    	 *
     	 * @param host
     	 *            host where the data is
     	 * @param port
-...
     	 *            name of the field that has the geometry
     	 * @param driverInfo
     	 *            name of the driver used to access the data
+    	 *
+    	 *
     	 * @return generated name of the added data source
     	 */
     	public String addSpatialDBDataSource(String host, int port, String user,
-...
     	/**
     	 * A?ade un origen de datos de base de datos al sistema
+    	 *
+    	 *
     	 * @param host
     	 *            Cadena de conexi?n para conectar con el sgbd donde se
     	 *            encuentra la tabla
-...
     	 *            Informaci?n para saber qu? driver debe acceder a la
     	 *            informaci?n. Se escoger? el driver cuyo valor de retorno del
     	 *            m?todo getType coincida con este valor
+    	 *
+    	 *
     	 * @return Nombre de la tabla con el que se har? referencia en las
     	 *         instrucciones
     	 */
-...
     	/**
     	 * A?ade un origen de datos de base de datos al sistema
+    	 *
+    	 *
     	 * @param name
     	 *            Nombre de la tabla con el que se har? referencia en las
     	 *            instrucciones
-...
     	/**
     	 * A?ade un origen de datos de base de datos al sistema
+    	 *
+    	 *
     	 * @param host
     	 *            Cadena de conexi?n para conectar con el sgbd donde se
     	 *            encuentra la tabla
-...
     	 *            Informaci?n para saber qu? driver debe acceder a la
     	 *            informaci?n. Se escoger? el driver cuyo valor de retorno del
     	 *            m?todo getType coincida con este valor
+    	 *
+    	 *
     	 * @return Nombre de la tabla con el que se har? referencia en las
     	 *         instrucciones
     	 */
-...
     	/**
     	 * Cambia el nombre de una fuente de datos. Las consultas SQL que se
     	 * ejecuten con el nombre anterior fallar?n
+    	 *
+    	 *
     	 * @param oldName
     	 *            Nombre actual de la fuente de datos que se quiere cambiar
     	 * @param newName
     	 *            Nombre que se le quiere poner a la fuente de datos
+    	 *
+    	 *
     	 * @throws NoSuchTableException
     	 *             Si no hay ninguna fuente de datos de nombre 'oldName'
     	 */
-...
     	/**
     	 * Gets the data source passed by adding the AutomaticDataSource decorator
     	 * if factory mode is AUTOMATIC.
+    	 *
+    	 *
     	 * @param ds
     	 *            DataSource
     	 * @param mode
     	 *            opening mode
+    	 *
+    	 *
     	 * @return DataSource
     	 */
     	private DataSource getModedDataSource(DataSource ds, int mode) {
-...
     	 * Sets the minimum delay between accesses needed to close the DataSource.
     	 * If accesses are delayed more than 'delay' the DataSource MAY be closed.
     	 * Only applies when the mode is set to AUTOMATIC_MODE
+    	 *
+    	 *
     	 * @param delay
     	 *            time un milliseconds
     	 */
-...
     	 * Dado el nombre de una tabla, se busca la fuente de datos asociada a dicha
     	 * tabla y se obtiene un datasource adecuado en funcion del tipo de fuente
     	 * de datos accediendo al subsistema de drivers
+    	 *
+    	 *
     	 * @param tableName
     	 *            Nombre de la fuente de datos
+    	 *
+    	 *
     	 * @return DataSource que accede a dicha fuente
+    	 *
+    	 *
     	 * @throws DriverLoadException
     	 * @throws NoSuchTableException
     	 * @throws DriverException
-...
     	 * Dado el nombre de una tabla, se busca la fuente de datos asociada a dicha
     	 * tabla y se obtiene un datasource adecuado en funcion del tipo de fuente
     	 * de datos accediendo al subsistema de drivers
+    	 *
+    	 *
     	 * @param tableName
     	 *            Nombre de la fuente de datos
     	 * @param mode
-...
     	 *            automatically and closes after a while. It can be closed
     	 *            manually. MANUAL_OPENING -> the DataSource opens and closes
     	 *            manually
+    	 *
+    	 *
     	 * @return DataSource que accede a dicha fuente
+    	 *
+    	 *
     	 * @throws DriverLoadException
     	 * @throws NoSuchTableException
     	 * @throws DriverException
-...
     	 * tabla y se obtiene un datasource adecuado en funcion del tipo de fuente
     	 * de datos accediendo al subsistema de drivers. Se utiliza internamente
     	 * como nombre del DataSource el alias que se pasa como par?metro
+    	 *
+    	 *
     	 * @param tableName
     	 *            Nombre de la fuente de datos
     	 * @param tableAlias
     	 *            Alias que tiene el DataSource en una instrucci?n
+    	 *
+    	 *
     	 * @return DataSource que accede a dicha fuente de datos si la fuente de
     	 *         datos es alfanum?rica o SpatialDataSource si la fuente de datos
     	 *         es espacial
+    	 *
+    	 *
     	 * @throws NoSuchTableException
     	 *             Si no hay una fuente de datos registrada con ese nombre
     	 * @throws DriverLoadException
-...
     	 * tabla y se obtiene un datasource adecuado en funcion del tipo de fuente
     	 * de datos accediendo al subsistema de drivers. Se utiliza internamente
     	 * como nombre del DataSource el alias que se pasa como par?metro
+    	 *
+    	 *
     	 * @param tableName
     	 *            Nombre de la fuente de datos
     	 * @param tableAlias
     	 *            Alias que tiene el DataSource en una instrucci?n
     	 * @param mode
     	 *            openning mode
+    	 *
+    	 *
     	 * @return DataSource que accede a dicha fuente de datos si la fuente de
     	 *         datos es alfanum?rica o SpatialDataSource si la fuente de datos
     	 *         es espacial
+    	 *
+    	 *
     	 * @throws NoSuchTableException
     	 *             Si no hay una fuente de datos registrada con ese nombre
     	 * @throws DriverLoadException
-...
     	/**
     	 * Creates a DataSource from a memento object with the manual opening mode
+    	 *
+    	 *
     	 * @param m
     	 *            memento
+    	 *
+    	 *
     	 * @return DataSource
+    	 *
+    	 *
     	 * @throws RuntimeException
     	 *             If the DataSource class cannot be instatiated
     	 */
-...
     	/**
     	 * Creates a DataSource from a memento object with the specified opening
     	 * mode
+    	 *
+    	 *
     	 * @param m
     	 *            memento
     	 * @param mode
     	 *            opening mode
+    	 *
+    	 *
     	 * @return DataSource
+    	 *
+    	 *
     	 * @throws RuntimeException
     	 *             If the DataSource class cannot be instatiated
     	 */
-...
     	/**
     	 * Devuelve true si todas las tablas provienen del mismo data base
     	 * management system
+    	 *
+    	 *
     	 * @param tables
     	 *            Array de tablas
+    	 *
+    	 *
     	 * @return boolean
     	 */
     	private boolean sameDBMS(DataSource[] tables) {
-...
     	/**
     	 * A partir de una instrucci?n select se encarga de obtener el DataSource
     	 * resultado de la ejecuci?n de dicha instrucci?n
+    	 *
+    	 *
     	 * @param instr
     	 *            Instrucci?n select origen del datasource
     	 * @param mode
     	 *            opening mode
+    	 *
+    	 *
     	 * @return DataSource que accede a los datos resultado de ejecutar la select
+    	 *
+    	 *
     	 * @throws DriverLoadException
     	 * @throws DriverException
     	 *             Si fallo la lectura de la fuente de datos por parte del
-...
     	/**
     	 * Creates a view in the database management system that hosts the data
     	 * source 'dbds'. The view is defined by the sql parameter
+    	 *
+    	 *
     	 * @param dbds
     	 *            DataSource used to execute the query
     	 * @param sql
     	 *            The SQL query defining the view
+    	 *
+    	 *
     	 * @return Name of the view
+    	 *
+    	 *
     	 * @throws DriverException
     	 *             If the view cannot be created
     	 */
-...
     	/**
     	 * Gets a DataSource implementation with the sql instruction as the data
     	 * source by creating a view in the underlaying datasource management system
+    	 *
+    	 *
     	 * @param sql
     	 *            Instruction definig the data source
     	 * @param driver
     	 *            Driver used to access the data source
     	 * @param dbInfo
     	 *            data source info
+    	 *
+    	 *
     	 * @return DataSource
+    	 *
+    	 *
     	 * @throws DriverException
     	 *             If cannot create the view
     	 */
-...
     	/**
     	 * A partir de una instrucci?n select se encarga de obtener el DataSource
     	 * resultado de la ejecuci?n de dicha instrucci?n
+    	 *
+    	 *
     	 * @param instr
     	 *            Instrucci?n select origen del datasource
+    	 *
+    	 *
     	 * @return DataSource que accede a los datos resultado de ejecutar la select
+    	 *
+    	 *
     	 * @throws DriverException
     	 * @throws SemanticException
     	 * @throws IOException
-...
     	/**
     	 * Translates the table references by changind the gdbms name with the
     	 * underlaying database management system table name
+    	 *
+    	 *
     	 * @param instr
     	 *            root of the adapted tree
     	 * @param tables
     	 *            DataSources involved in the instruction
+    	 *
+    	 *
     	 * @return The translated sql query
+    	 *
+    	 *
     	 * @throws DriverException
     	 *             If driver access fails
     	 * @throws SemanticException
-...
     	/**
     	 * Gets the name of the table where the field is in
+    	 *
+    	 *
     	 * @param fieldName
     	 *            field whose table wants to be guessed
     	 * @param tables
     	 *            tables involved in the search
+    	 *
+    	 *
     	 * @return table name
+    	 *
+    	 *
     	 * @throws DriverException
     	 *             If driver access fails
     	 * @throws SemanticException
-...
     	/**
     	 * Translates the table references by changind the gdbms name with the
     	 * underlaying database management system table name
+    	 *
+    	 *
     	 * @param adapter
     	 *            adapter processed
     	 * @param instrNameDBName
-...
     	 *            as the values.
     	 * @param tables
     	 *            tables involved in the instruction
+    	 *
+    	 *
     	 * @throws DriverException
     	 *             If driver access fails
     	 * @throws SemanticException
-...
     	/**
     	 * Translates the table references by changind the gdbms name with the
     	 * underlaying database management system table name
+    	 *
+    	 *
     	 * @param adapter
     	 *            adapter processed
     	 * @param instrNameDBName
-...
     	/**
     	 * Obtiene el DataSource resultado de ejecutar la instrucci?n de union
+    	 *
+    	 *
     	 * @param instr
     	 *            instrucci?n de union
     	 * @param mode
     	 *            opening mode
+    	 *
+    	 *
     	 * @return DataSource
+    	 *
+    	 *
     	 * @throws DriverException
     	 *             Si fallo la lectura de la fuente de datos por parte del
     	 *             driver
-...
     	/**
     	 * Obtiene el DataSource resultado de ejecutar la instrucci?n de union
+    	 *
+    	 *
     	 * @param instr
     	 *            instrucci?n de union
+    	 *
+    	 *
     	 * @return DataSource
+    	 *
+    	 *
     	 * @throws DriverException
     	 *             Si fallo la lectura de la fuente de datos por parte del
     	 *             driver
-...
     	/**
     	 * Creates a DataSource as a result of a custom query
+    	 *
+    	 *
     	 * @param instr
     	 *            Root node of the adapter tree of the custom query instruction
     	 * @param mode
     	 *            opening mode
+    	 *
+    	 *
     	 * @return DataSource with the custom query result
+    	 *
+    	 *
     	 * @throws SemanticException
     	 *             if there is any semantic error in the instruction
     	 */
-...
     	/**
     	 * Creates a DataSource as a result of a custom query
+    	 *
+    	 *
     	 * @param instr
     	 *            Root node of the adapter tree of the custom query instruction
+    	 *
+    	 *
     	 * @return DataSource with the custom query result
+    	 *
+    	 *
     	 * @throws SemanticException
     	 *             if there is any semantic error in the instruction
     	 */
-...
     	/**
     	 * Ejecuta la instrucci?n SQL que se pasa como par?metro obteniendo un
     	 * DataSource con el resultado de la ejecuci?n
+    	 *
+    	 *
     	 * @param sql
     	 *            instrucci?n sql que se quiere ejecutar
     	 * @param mode
     	 *            opening mode
+    	 *
+    	 *
     	 * @return DataSource con el resultado
+    	 *
+    	 *
     	 * @throws ParseException
     	 *             Si se produce un error de parse de la instrucci?n
     	 * @throws DriverLoadException
-...
     	/**
     	 * Establece el DriverManager que se usar? para instanciar DataSource's.
     	 * Este metodo debe ser invocado antes que ning?n otro
+    	 *
+    	 *
     	 * @param dm
     	 *            El manager que se encarga de cargar los drivers
     	 */
     	public void setDriverManager(DriverManager dm) {
     		this.dm = dm;
+    	}
     	/**
     	 * Establece el WriterManager que se usar? para instanciar DataSource's.
     	 * Este metodo debe ser invocado antes que ning?n otro
+    	 *
     	 * @param dm
     	 *            El manager que se encarga de cargar los drivers
     	 */
     	public void setWriterManager(WriterManager wm) {
     		this.wm = wm;
+    	}
     	/**
     	 * Get's the module with the specified name
+    	 *
+    	 *
     	 * @param name
     	 *            name of the wanted module
+    	 *
+    	 *
     	 * @return instance of the module
     	 */
     	public Object getModule(String name) {
-...
     	/**
     	 * Registers a module in the system with the specified name
+    	 *
+    	 *
     	 * @param name
     	 *            name of the module
     	 * @param instance
-...
     	/**
     	 * Gets a driver manager reference
+    	 *
+    	 *
     	 * @return DriverManagers.
     	 */
     	public DriverManager getDriverManager() {
     		return dm;
+    	}
     	/**
     	 * Gets a writer manager reference
+    	 *
     	 * @return WriterManagers.
     	 */
     	public WriterManager getWriterManager() {
     		return wm;
+    	}
     	/**
     	 * Sets if this factory will check for delegating instructions at the server
     	 * (true) or will execute all queries internally (false). By delegating at
     	 * the server, lots of queries will be defined in the database management
     	 * system where the execution is delegated. Invoke clearViews to remove all
     	 * created views.
+    	 *
+    	 *
     	 * @param b
     	 */
     	public void setDelegating(boolean b) {
-...
     	/**
     	 * Creates a new table on the specified database
+    	 *
+    	 *
     	 * @param database
     	 *            name of the database where the table will be created
     	 * @param pkNames
-...
     	 *            names of the fields
     	 * @param types
     	 *            types of the fields. Must have the same length than names
+    	 *
+    	 *
     	 * @return the table name
+    	 *
+    	 *
     	 * @throws SQLException
     	 *             if the creation fails
     	 */
-...
     	/**
     	 * Frees all resources used during execution
+    	 *
+    	 *
     	 * @throws SQLException
     	 *             If cannot free internal resources
     	 * @throws DriverException
-...
     	/**
     	 * Initializes the system.
+    	 *
+    	 *
     	 * @throws InitializationException
     	 *             If the initialization
     	 */
-...
     	/**
     	 * Initializes the system
+    	 *
+    	 *
     	 * @param tempDir
     	 *            temporary directory to write data
+    	 *
+    	 *
     	 * @throws InitializationException
     	 *             If the initialization fails
     	 */
-...
     	/**
     	 * Gets the URL of a file in the temporary directory. Does not creates any
     	 * file
+    	 *
+    	 *
     	 * @return String
     	 */
     	public String getTempFile() {
-...
     		/**
     		 * Crea un nuevo ServerViewInfo.
+    		 *
+    		 *
     		 * @param ds
     		 *            DOCUMENT ME!
     		 * @param name

Also available in: Unified diff