grails-documentation-mongodb/src/docs/ref/Domain Classes/withDatabase.gdoc

h1. withDatabase

h2. Purpose

Allows switching which database to use to persist for the domain class for the scope of the given closure.

h2. Examples

{code:java}
Book.withDatabase("non-fiction") {
    // code here
}
{code}

h2. Description

The @withDatabase@ method allows switching, at runtime, the database used persist and retrieve domain classes. The @DB@ property will return the current database being used. Note that the method switches the database used for the scope of the given closure (ie. it is not permanent). If you wish to permanently change the database used then you need to configure the mapping of the domain class.