public abstract class AbstractDatabaseBackedRepository extends DatabaseBacked implements Repository
This abstract implementation handles the super.getLog(), the id and null operations for connections.
Repository.ConfigurationNode
Modifier and Type | Field and Description |
---|---|
protected boolean |
isDefault
True if this is a default repository for an application.
|
_database, CLASS_NAME_SUFFIX, DATABASE_DIR_NAME, databaseConf, dbLocation, dbPath, DEFAULT_DATABASE_TYPE
_configuration, _context, _description, _encoding, _id, _locale, _logger, _manager, _xmlizable_objects, _xmlLang, isToSaxInitialized
CLASS_NAME_SUFFIX, PACKAGE_QUALNAME
DEFAULT_ENCODING
ALL_SAVE_ATTRIB, PATH_ATTRIB, SAVE_DIRECTORY_PARAM
Constructor and Description |
---|
AbstractDatabaseBackedRepository() |
Modifier and Type | Method and Description |
---|---|
void |
add(Document doc,
RepositoryConnection c)
Does param checks for subclasses
|
void |
backup(SaveParameters save_config)
Save the repository
|
void |
checkConnection(RepositoryConnection c) |
protected java.lang.String |
checkEncoding(java.lang.String encoding)
Verifies an encoding string,
if not supported by JVM default is used, UTF-8.
|
void |
delete(Document doc,
RepositoryConnection c)
Does param checks for subclasses
|
boolean |
exists(java.lang.String id,
RepositoryConnection conn) |
void |
get(Document doc,
java.io.OutputStream os,
RepositoryConnection c)
Does param checks for subclasses
|
protected java.lang.String |
getClassNameSuffix()
Sub classes should element this method to return their class name suffix for SAX output
|
protected boolean |
initToSax()
Init the LinkedHashMap _xmlizable_objects with the objects in order to describ them in XML
|
protected void |
initVolatileObjectsToSax()
Init the LinkedHashMap _xmlizable_volatile_objects with the objects in order to describ them in XML
Some objects need to be refresh each time a toSAX is called
|
boolean |
isDefault()
Returns whether it is a default repository for an application.
|
protected void |
loadBaseConfiguration(org.apache.avalon.framework.configuration.Configuration configuration)
Loads base configuration common to all repositories.
|
java.io.InputStream |
openStream(Document doc,
java.lang.String encoding,
RepositoryConnection c)
Does param checks for subclasses
|
void |
optimize()
Utility method for repository maintenance,
normally used to optimize indices of Lucene based repositories
It is the responsibility of the Repository to ensure that
unnecessary optimizations are not performed when this method
is called.
|
void |
releaseConnection(RepositoryConnection c)
Releases a previously opened connection.
|
void |
restore(SaveParameters save_config)
Restore the repository
|
void |
setIsDefault(boolean b)
Sets the isDefault flag for the repository
|
void |
toSAX(ParsableDocument doc,
org.apache.cocoon.xml.XMLConsumer consumer,
RepositoryConnection c)
Does param checks for subclasses
|
configure, configure, getDatabase, init
configureDescription, contextualize, enableLogging, getBaseAttributes, getConfiguration, getContext, getDescription, getEncoding, getId, getLocale, getLog, getServiceManager, getXmlLang, service, setDescription, setEncoding, setId, setLocale, setUpSdxObject, setUpSdxObject, setXmlLang, toSAX, verifyConfigurationResources
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
empty, getConnection, init, lists, size
getId, setId
getDescription, setDescription
getEncoding, setEncoding
getLocale, getXmlLang, setLocale, setXmlLang
protected boolean isDefault
protected void loadBaseConfiguration(org.apache.avalon.framework.configuration.Configuration configuration) throws org.apache.avalon.framework.configuration.ConfigurationException
configuration
- The configuration object
The parameter required are an id for the repository, an optional attribute
indicating if the repository is the default within a document base is also handled
but the default if not specified will be false.configuration
- The configuration for this repository (based on a xml file).
Sample configuration entry:
<sdx:repository sdx:type = "FS" sdx:id = "myRepoId" baseDirectory = "baseDirName" depth = "2" extent = "50"/>
org.apache.avalon.framework.configuration.ConfigurationException
we should link to this in the future when we have better documentation capabilities
public void releaseConnection(RepositoryConnection c) throws SDXException
releaseConnection
in interface Repository
c
- The connection to release.SDXException
public boolean isDefault()
Repository
isDefault
in interface Repository
public void delete(Document doc, RepositoryConnection c) throws SDXException
delete
in interface Repository
doc
- The document to delete.SDXException
public void add(Document doc, RepositoryConnection c) throws SDXException
add
in interface Repository
doc
- The document to add.c
- A connection to the repository.SDXException
public java.io.InputStream openStream(Document doc, java.lang.String encoding, RepositoryConnection c) throws SDXException
openStream
in interface Repository
doc
- The document to read.encoding
- Should be null
as not verified here, but in subClasses with checkEncoding() method.c
- A connection to the repository.SDXException
public void get(Document doc, java.io.OutputStream os, RepositoryConnection c) throws SDXException
get
in interface Repository
doc
- The document to read.os
- The output stream where to write.c
- A connection to the repository.SDXException
public void toSAX(ParsableDocument doc, org.apache.cocoon.xml.XMLConsumer consumer, RepositoryConnection c) throws SDXException
toSAX
in interface Repository
doc
- The document.consumer
- A SAX content handler to feed with events.
The wrapped contentHandler for including events within an XSP page contentHandler should be created using IncludeXMLConsumer stripper = new IncludeXMLConsumer(xspContentHandler);
c
- A connection to the repository.SDXException
public void setIsDefault(boolean b)
setIsDefault
in interface Repository
protected java.lang.String checkEncoding(java.lang.String encoding) throws SDXException
encoding
- SDXException
public void checkConnection(RepositoryConnection c) throws SDXException
SDXException
public void optimize() throws SDXException
Repository
optimize
in interface Repository
SDXException
public boolean exists(java.lang.String id, RepositoryConnection conn)
exists
in interface Repository
protected java.lang.String getClassNameSuffix()
AbstractSdxObject
getClassNameSuffix
in class DatabaseBacked
protected boolean initToSax()
AbstractSdxObject
initToSax
in class DatabaseBacked
protected void initVolatileObjectsToSax()
initVolatileObjectsToSax
in class DatabaseBacked
public void backup(SaveParameters save_config) throws SDXException
backup
in interface Saveable
SDXException
Saveable.backup(fr.gouv.culture.sdx.utils.save.SaveParameters)
public void restore(SaveParameters save_config) throws SDXException
restore
in interface Saveable
SDXException
Saveable.restore(fr.gouv.culture.sdx.utils.save.SaveParameters)
Copyright © 2000-2010 Ministere de la culture et de la communication / AJLSM. All Rights Reserved.