1 /* 2 * This file belongs to the XQuark distribution. 3 * Copyright (C) 2003 Universite de Versailles Saint-Quentin. 4 * 5 * This program is free software; you can redistribute it and/or 6 * modify it under the terms of the GNU Lesser General Public 7 * License as published by the Free Software Foundation; either 8 * version 2.1 of the License, or (at your option) any later version. 9 * 10 * This program is distributed in the hope that it will be useful, 11 * but WITHOUT ANY WARRANTY; without even the implied warranty of 12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 13 * Lesser General Public License for more details. 14 * 15 * You should have received a copy of the GNU Lesser General Public 16 * License along with this program; if not, write to the Free Software 17 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307. 18 * You can also get it at http://www.gnu.org/licenses/lgpl.html 19 * 20 * For more information on this software, see http://www.xquark.org. 21 */ 22 23 package org.xquark.mapper.dbms; 24 25 import org.xquark.mapper.RepositoryConnection; 26 import org.xquark.mapper.metadata._Repository; 27 import org.xquark.mapper.storage.RepositoryReader; 28 import org.xquark.schema.SchemaLocator; 29 import org.xquark.schema.SchemaManager; 30 import org.xquark.xml.xdbc.XMLDBCException; 31 32 /** 33 * Provides functions for manipulating repositories. 34 * <B>This is the internal version of the Repository interface (with methods 35 * that don't belong to API)</B> 36 */ 37 public interface _RepositoryConnection 38 extends RepositoryConnection, SchemaLocator 39 { 40 /** 41 * Accessor to the underlying JDBC connection (in fact an interface 42 * encapsulating the connection managing DBMS specificities). 43 * @return the "portable" RDBMS connection 44 */ 45 AbstractConnection getConnection(); 46 47 /** 48 * Accessor to the repository metadata object. 49 * @return a readonly interface to repository metadata object. 50 */ 51 _Repository getMetadata(); 52 53 /** 54 * Accessor to the XML schema manager used by this connection to repository. 55 * @return the repository memory instance schema manager 56 */ 57 SchemaManager getSchemaManager(); 58 59 /** 60 * Creates a SAX XMLReader on mapping system collection 61 * @return a Repository specific implementation of XMLReader 62 * @throws XMLDBCException application exception 63 */ 64 RepositoryReader getMappingReader() throws XMLDBCException; 65 } 66 67 68