Primero de todo diremos que todo esto se puede definir en dos sitios:
- De una manera específica en una clase de dominio
(static mapping = { ... })
-De forma general definiendolo en el Config.groovy con
grails.gorm.default.mapping = { ... }
1) AUTOIMPORT
Permite importar o no la clase de dominio en las queries HQL. Por defecto está a true, es decir las clases de dominio por defecto son auto-importadas en las queries HQL, así que sólo con poner el nombre ya es suficiente. Si ponemos esta característica a false, para formar una query habrá que incluir su paquete también para poder identificar la clase de dominio. Esto es una buena solución para cuando tienes dos clases de dominio con el mismo nombre en distintos paquetes y te da un org.hibernate.DuplicateMappingException.
static mapping = {
autoImport false
}
2) AUTO TIMESTAMP
Habilitar o no el auto Timestamping, es decir, cuando queremos guardar su dateCreated y su lastUpdated de una clase de dominio automáticamente deberemos tenerlo a true. Si lo quieres deshabilitado para guardar tus propias fechas ponerlo a false.
static mapping = {
autoTimestamp false
}
3) BATCH SIZE
Customizar cuántos resultados queremos cuando capturamos datos de la BBDD en una carga lazy.
static mapping = {
batchSize 10
}
4) CACHE
Habilitar la cache de segundo nivel de Hibernate.
static mapping = {
cache true
}
5) CACHE
Configurar el comportamiento en cascada de la asociación.
static hasMany = [books: Book]
static mapping = { books cascade: 'all-delete-orphan' }
Aquí podemos definir uno o varios comportamientos separados por coma. Hay varios tipos: all, merge, save-update, delete, lock, refresh, evict, replicate or all-delete-orphan (sólo para relaciones one-to-many)
GORM por defecto configura la política de cascada save-update.
6) COLUMN
Customiza la definición de una columna.
static mapping = {
currency column: "currency", sqlType: "char", length: 3
}
Primero se define el nombre del atributo seguido de los siguientes parámetros a cambiar:
- column - nombre de la columna como String
- sqlType (optional) - tipo SQL
- enumType (optional) - tipo de enumerado para las propiedades Enum. (ordinal o string)
- index (optional) - nombre del índice
- unique (optional) - si es único
- length (optional) - longitud de la columna
- precision (optional) - nº de posiciones de la parte entera de la columna
- scale (optional) - nº de decimales de la columna
7) DATASOURCE
Configura qué datasource está relacionada la clase de dominio.
static mapping = {
datasource 'lookup'
}
environments {
development {
dataSource {
dbCreate = "create-drop"
url = "jdbc:h2:mem:devDb"
}
dataSource_lookup {
dialect = org.hibernate.dialect.MySQLInnoDBDialect
driverClassName = 'com.mysql.jdbc.Driver'
username = 'lookup'
password = 'secret'
url = 'jdbc:mysql://localhost/lookup'
dbCreate = 'update'
}
}
}
Si una clase de dominio no tiene una configuración de DataSource, tirará por defecto del DataSource configurado en el Config.groovy.
8) DISCRIMINATOR
Customiza el discriminador de columna cuando se mapea una herencia tipo "table-per-subclass".
class PodCast extends Content {
…
static mapping = {
discriminator "audio"
}
}
9) DYNAMIC INSERT
Para construir dinamicamente queries INSERT.
static mapping = {
dynamicInsert true
}
Por defecto Hibernate genera todas las queries al principio y las cachea. Esto ayuda a que el rendimiento para los insert, update y delete queries no tengan que ser generadas dinámicamente en tiempo de ejecución. Sin embargo, hay ciertas circunstancias donde las queries dinámicas son útiles.
10) DYNAMIC UPDATE
Para construir dinamicamente queries UPDATE.
static mapping = {
dynamicUpdate true
}
11) FETCH
Configura el comportamiento de carga de datos de una asociación.
static hasMany = [books: Book]
static mapping = { books fetch: 'select' }
Se define con el nombre de las asociación seguida del parámetro:
- fetch - Estrategia a usar. (join o select)
Por defecto GORM asume que la carga de asociaciones está hecha con una SELECT cuando se accede a la asociación. Si prefieres que la asociación sea cargada de modo eager, puedes cambiarlo sobreescribiendo:
static hasMany = [books: Book]
static mapping = { books fetch: 'join' }
12) ID
Customizar la forma en que el identificador es generado para un dominio.
static mapping = {
id generator: 'hilo',
params: [table: 'hi_value', column: 'next_value', max_lo: 100]
}
Se define poniendo el id seguido de los siguientes parámetros:
- generator (optional) - nombre del generador a usar. Puede ser increment, identity, sequence, hilo, seqhilo, uuid, guid, native, assigned, select, foreign o sequence-identity.
- composite (optional) - coge una lista de propiedades a usar para formar la clave compuesta.
- name (optional) - nombre de la propiedad a usar como identificador.
- params (optional) - algún parámetro para pasar a un generador de identificadores definido.
- column (optional) - nombre de la columna para mapear el identificador. El resto de propiedades también está disponible.
13) IGNORE NOT FOUND
Especifica cómo las FKs que referencian a filas no encontradas son manejadas en las relaciones many-to-one.
String title
Thumbnail thumbnail
static mapping = { thumbnail ignoreNotFound: true }
Por defecto el valor es false, es decir si no encuentra la fila Hibernate lanzará una excepción "org.hibernate.ObjectNotFoundException". Si lo tienes a true, aunque no lo encuentre, lo ignorará. Esto viene bien cuando tienes BBDD corruptas que le van a faltar datos.
14) INDEX COLUMN
Customiza el índice de una colección de tipo Lista o un Mapa.
static hasMany = [matrix: Integer]
static mapping = { matrix indexColumn: [name: "the_matrix", type: Integer] }
Esto se define con el nombre de la asociación seguido de los siguientes parámetros:
- name - nombre de columna como un String
- type (optional) - tipo Hibernate
- sqlType (optional) - tipo SQL
- enumType (optional) - tipo de enumerado para las propiedades Enum. (ordinal o string)
- index (optional) - nombre del índice
- unique (optional) - si es único
- length (optional) - longitud de la columna
- precision (optional) - nº de posiciones de la parte entera de la columna
- scale (optional) - nº de decimales de la columna
15) INSERTABLE / UPDATEABLE
Determina si una propiedad de la BBDD está configurada como insertable/updateable cuando una instancia es persistida.
String title
static belongsTo = [author: Author]
static mapping = {
author insertable: false
author updateable: false
}
Se define con el nombre del atributo seguido de insertable/updateable: boolean. Por defecto están a true.
16) JOIN TABLE
Customiza el tipo de join table que se usa para las relaciones unidireccionales de tipo one-to-many, many-to-many y tipos de colección primitivos.
static hasMany = [projects: Project]
static mapping = {
projects joinTable: [name: 'EMP_PROJ', column: 'PROJECT_ID', key: 'EMPLOYEE_ID']
}
Se define con el nombre de la asociación seguido de joinTable y de los siguientes parámetros:
- name - nombre de table
- key (optional) - clave foránea
- column (optional) - columna inversa
17) LAZY
Configura si se usa proxies y carga de datos lazy para las relaciones one-to-one y many-to-one.
static belongsTo = [author: Author]
static mapping = { author lazy: false }
Por defecto, en GORM las asociaciones single-ended son lazy: true es decir cuando se carga una instancia de un dominio, la asociación de ese dominio no es cargada hasta que se accede a ella.
Hibernate crea un proxy dinámico para subclasificar la clase de dominio y sus métodos y propiedades.
18) ORDER
Customizar el orden por defecto de los resultado de las queries.
static mapping = {
order "desc"
}
19) SORT
Customizar el atributo de la clase dominio para ordenar los resultados de las queries.
static mapping = {
sort "releaseDate"
}
20) TABLE
Customizar el nombre de la BBDD asociada de la clase de dominio.
class Book {
static mapping = {
table "book_catalog"
}
}
También se le puede especificar el schema y el catálogo definiéndolo así,
static mapping = {
table name: "book_catalog", schema: "dbo", catalog: "CRM"
}
21) TYPE
Para configurar el tipo de Hibernate para una propiedad particular.
String title
static mapping = { title type: "text" }
Esta propiedad viene bien para definir tipos CLOB o TEXT dependiendo del dialecto de la BBDD.
22) VERSION
Se usa para deshabilitar el bloqueo optimista o cambiar la columna que mapea la versión.
static mapping = {
version false
}
static mapping = {
version 'revision_number'
}
No hay comentarios:
Publicar un comentario