|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.hibernate.cfg.Configuration
An instance of Configuration allows the application
to specify properties and mapping documents to be used when
creating a SessionFactory. Usually an application will create
a single Configuration, build a single instance of
SessionFactory and then instantiate Sessions in
threads servicing client requests. The Configuration is meant
only as an initialization-time object. SessionFactorys are
immutable and do not retain any association back to the
Configuration.
A new Configuration will use the properties specified in
hibernate.properties by default.
SessionFactory
,
Serialized FormField Summary | |
protected List |
auxiliaryDatabaseObjects
|
protected Map |
classes
|
protected Map |
collections
|
protected Map |
columnNameBindingPerTable
|
protected Map |
extendsQueue
|
protected Map |
filterDefinitions
|
protected Map |
imports
|
protected Map |
namedQueries
|
protected Map |
namedSqlQueries
|
protected NamingStrategy |
namingStrategy
|
protected List |
propertyReferences
|
protected List |
secondPasses
|
protected SettingsFactory |
settingsFactory
|
protected Map |
sqlResultSetMappings
Map |
protected Map |
tableNameBinding
|
protected Map |
tables
|
protected Map |
typeDefs
|
Constructor Summary | |
|
Configuration()
|
protected |
Configuration(SettingsFactory settingsFactory)
|
Method Summary | |
protected void |
add(org.dom4j.Document doc)
|
void |
addAuxiliaryDatabaseObject(AuxiliaryDatabaseObject object)
|
Configuration |
addCacheableFile(File xmlFile)
If a cached xmlFile + ".bin" exists and is newer than xmlFile the ".bin" file will be read directly. |
Configuration |
addCacheableFile(String xmlFile)
|
Configuration |
addClass(Class persistentClass)
Read a mapping from an application resource, using a convention. |
Configuration |
addDirectory(File dir)
Read all mapping documents from a directory tree. |
Configuration |
addDocument(org.w3c.dom.Document doc)
Read mappings from a DOM Document |
Configuration |
addFile(File xmlFile)
Read mappings from a particular XML file |
Configuration |
addFile(String xmlFile)
Read mappings from a particular XML file |
void |
addFilterDefinition(FilterDefinition definition)
|
Configuration |
addInputStream(InputStream xmlInputStream)
Read mappings from an InputStream |
Configuration |
addJar(File jar)
Read all mappings from a jar file |
Configuration |
addProperties(Properties extraProperties)
Set the given properties |
Configuration |
addResource(String path)
Read mappings from an application resource trying different classloaders. |
Configuration |
addResource(String path,
ClassLoader classLoader)
Read mappings from an application resource |
Configuration |
addURL(URL url)
Read mappings from a URL |
Configuration |
addXML(String xml)
Read mappings from a String |
void |
buildMappings()
Call this to ensure the mappings are fully compiled/built. |
SessionFactory |
buildSessionFactory()
Instantiate a new SessionFactory, using the properties and mappings in this configuration. |
Settings |
buildSettings()
Create an object-oriented view of the configuration properties |
Settings |
buildSettings(Properties props)
|
Configuration |
configure()
Use the mappings and properties specified in an application resource named hibernate.cfg.xml. |
Configuration |
configure(org.w3c.dom.Document document)
Use the mappings and properties specified in the given XML document. |
Configuration |
configure(File configFile)
Use the mappings and properties specified in the given application file. |
Configuration |
configure(String resource)
Use the mappings and properties specified in the given application resource. |
Configuration |
configure(URL url)
Use the mappings and properties specified in the given document. |
Mappings |
createMappings()
Create a new Mappings to add class and collection mappings to. |
protected Configuration |
doConfigure(org.dom4j.Document doc)
|
protected Configuration |
doConfigure(InputStream stream,
String resourceName)
Use the mappings and properties specified in the given application resource. |
protected org.dom4j.Document |
findPossibleExtends()
Find the first possible element in the queue of extends. |
String[] |
generateDropSchemaScript(Dialect dialect)
Generate DDL for dropping tables |
String[] |
generateSchemaCreationScript(Dialect dialect)
Generate DDL for creating tables |
String[] |
generateSchemaUpdateScript(Dialect dialect,
DatabaseMetadata databaseMetadata)
Generate DDL for altering tables |
PersistentClass |
getClassMapping(String persistentClass)
Get the mapping for a particular class |
Iterator |
getClassMappings()
Iterate the class mappings |
Collection |
getCollectionMapping(String role)
Get the mapping for a particular collection role |
Iterator |
getCollectionMappings()
Iterate the collection mappings |
protected InputStream |
getConfigurationInputStream(String resource)
Get the configuration file as an InputStream. |
EventListeners |
getEventListeners()
|
Map |
getFilterDefinitions()
|
Map |
getImports()
Get the query language imports |
Interceptor |
getInterceptor()
Return the configured Interceptor |
Map |
getNamedQueries()
Get the named queries |
Map |
getNamedSQLQueries()
|
NamingStrategy |
getNamingStrategy()
|
Properties |
getProperties()
Get all properties |
String |
getProperty(String propertyName)
Get a property |
Map |
getSqlResultSetMappings()
|
Iterator |
getTableMappings()
Iterate the table mappings |
Configuration |
mergeProperties(Properties properties)
Adds the incoming properties to the internap properties structure, as long as the internal structure does not already contain an entry for the given key. |
protected void |
parseMappingElement(org.dom4j.Element subelement,
String name)
|
protected void |
reset()
|
protected void |
secondPassCompile()
|
protected void |
secondPassCompileForeignKeys(Table table,
Set done)
|
Configuration |
setCacheConcurrencyStrategy(String clazz,
String concurrencyStrategy)
Set up a cache for an entity class |
void |
setCacheConcurrencyStrategy(String clazz,
String concurrencyStrategy,
String region)
|
Configuration |
setCollectionCacheConcurrencyStrategy(String collectionRole,
String concurrencyStrategy)
Set up a cache for a collection role |
void |
setCollectionCacheConcurrencyStrategy(String collectionRole,
String concurrencyStrategy,
String region)
|
void |
setEntityResolver(org.xml.sax.EntityResolver entityResolver)
Set a custom entity resolver. |
Configuration |
setInterceptor(Interceptor interceptor)
Configure an Interceptor |
void |
setListener(String type,
Object listener)
|
void |
setListeners(String type,
Object[] listeners)
|
void |
setListeners(String type,
String[] listenerClasses)
|
Configuration |
setNamingStrategy(NamingStrategy namingStrategy)
Set a custom naming strategy |
Configuration |
setProperties(Properties properties)
Specify a completely new set of properties |
Configuration |
setProperty(String propertyName,
String value)
Set a property |
void |
validateSchema(Dialect dialect,
DatabaseMetadata databaseMetadata)
|
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
protected Map classes
protected Map imports
protected Map collections
protected Map tables
protected List auxiliaryDatabaseObjects
protected Map namedQueries
protected Map namedSqlQueries
protected Map sqlResultSetMappings
protected Map filterDefinitions
protected List secondPasses
protected List propertyReferences
protected Map extendsQueue
protected Map tableNameBinding
protected Map columnNameBindingPerTable
protected transient Map typeDefs
protected NamingStrategy namingStrategy
protected final SettingsFactory settingsFactory
Constructor Detail |
protected Configuration(SettingsFactory settingsFactory)
public Configuration()
Method Detail |
protected void reset()
public Iterator getClassMappings()
public Iterator getCollectionMappings()
public Iterator getTableMappings()
public PersistentClass getClassMapping(String persistentClass)
public Collection getCollectionMapping(String role)
role
- a collection role
public void setEntityResolver(org.xml.sax.EntityResolver entityResolver)
DTDEntityResolver
entityResolver
- entity resolver to usepublic Configuration addFile(String xmlFile) throws MappingException
xmlFile
- a path to a file
MappingException
public Configuration addFile(File xmlFile) throws MappingException
xmlFile
- a path to a file
MappingException
public Configuration addCacheableFile(File xmlFile) throws MappingException
MappingException
public Configuration addCacheableFile(String xmlFile) throws MappingException
MappingException
public Configuration addXML(String xml) throws MappingException
xml
- an XML string
MappingException
public Configuration addURL(URL url) throws MappingException
url
-
MappingException
public Configuration addDocument(org.w3c.dom.Document doc) throws MappingException
doc
- a DOM document
MappingException
protected void add(org.dom4j.Document doc) throws MappingException
MappingException
public Mappings createMappings()
public Configuration addInputStream(InputStream xmlInputStream) throws MappingException
xmlInputStream
- an InputStream containing XML
MappingException
public Configuration addResource(String path, ClassLoader classLoader) throws MappingException
path
- a resourceclassLoader
- a ClassLoader to use
MappingException
public Configuration addResource(String path) throws MappingException
MappingException
public Configuration addClass(Class persistentClass) throws MappingException
persistentClass
- the mapped class
MappingException
public Configuration addJar(File jar) throws MappingException
jar
- a jar file
MappingException
public Configuration addDirectory(File dir) throws MappingException
dir
- a directory
MappingException
public String[] generateDropSchemaScript(Dialect dialect) throws HibernateException
HibernateException
SchemaExport
public String[] generateSchemaCreationScript(Dialect dialect) throws HibernateException
HibernateException
SchemaExport
public String[] generateSchemaUpdateScript(Dialect dialect, DatabaseMetadata databaseMetadata) throws HibernateException
HibernateException
SchemaUpdate
public void validateSchema(Dialect dialect, DatabaseMetadata databaseMetadata) throws HibernateException
HibernateException
public void buildMappings()
protected void secondPassCompile() throws MappingException
MappingException
protected org.dom4j.Document findPossibleExtends()
protected void secondPassCompileForeignKeys(Table table, Set done) throws MappingException
MappingException
public Map getNamedQueries()
public SessionFactory buildSessionFactory() throws HibernateException
HibernateException
SessionFactory
public Interceptor getInterceptor()
public Properties getProperties()
public Configuration setInterceptor(Interceptor interceptor)
public Configuration setProperties(Properties properties)
public Configuration addProperties(Properties extraProperties)
public Configuration mergeProperties(Properties properties)
properties
-
public Configuration setProperty(String propertyName, String value)
public String getProperty(String propertyName)
protected InputStream getConfigurationInputStream(String resource) throws HibernateException
HibernateException
public Configuration configure() throws HibernateException
HibernateException
public Configuration configure(String resource) throws HibernateException
HibernateException
public Configuration configure(URL url) throws HibernateException
url
- URL from which you wish to load the configuration
HibernateException
public Configuration configure(File configFile) throws HibernateException
configFile
- File from which you wish to load the configuration
HibernateException
protected Configuration doConfigure(InputStream stream, String resourceName) throws HibernateException
stream
- Inputstream to be read fromresourceName
- The name to use in warning/error messages
HibernateException
public Configuration configure(org.w3c.dom.Document document) throws HibernateException
document
- an XML document from which you wish to load the configuration
HibernateException
- if there is problem in accessing the file.protected Configuration doConfigure(org.dom4j.Document doc) throws HibernateException
HibernateException
protected void parseMappingElement(org.dom4j.Element subelement, String name)
public void setListeners(String type, String[] listenerClasses)
public void setListener(String type, Object listener)
public void setListeners(String type, Object[] listeners)
public EventListeners getEventListeners()
public Configuration setCacheConcurrencyStrategy(String clazz, String concurrencyStrategy) throws MappingException
clazz
- concurrencyStrategy
-
MappingException
public void setCacheConcurrencyStrategy(String clazz, String concurrencyStrategy, String region) throws MappingException
MappingException
public Configuration setCollectionCacheConcurrencyStrategy(String collectionRole, String concurrencyStrategy) throws MappingException
collectionRole
- concurrencyStrategy
-
MappingException
public void setCollectionCacheConcurrencyStrategy(String collectionRole, String concurrencyStrategy, String region) throws MappingException
MappingException
public Map getImports()
public Settings buildSettings() throws HibernateException
HibernateException
public Settings buildSettings(Properties props) throws HibernateException
HibernateException
public Map getNamedSQLQueries()
public Map getSqlResultSetMappings()
public NamingStrategy getNamingStrategy()
public Configuration setNamingStrategy(NamingStrategy namingStrategy)
namingStrategy
- the NamingStrategy to setpublic Map getFilterDefinitions()
public void addFilterDefinition(FilterDefinition definition)
public void addAuxiliaryDatabaseObject(AuxiliaryDatabaseObject object)
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |