package io.dropwizard.hibernate;

import org.hibernate.CacheMode;
import org.hibernate.FlushMode;

import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.RetentionPolicy.RUNTIME;

When annotating a Jersey resource method, wraps the method in a Hibernate session.
To be used outside Jersey, one need to create a proxy of the component with the
annotated method.
See Also:
UnitOfWorkApplicationListener
UnitOfWorkAwareProxyFactory/**
 * When annotating a Jersey resource method, wraps the method in a Hibernate session.
 * <p>To be used outside Jersey, one need to create a proxy of the component with the
 * annotated method.</p>
 *
 * @see UnitOfWorkApplicationListener
 * @see UnitOfWorkAwareProxyFactory
 */
@Target(METHOD)
@Retention(RUNTIME)
@Documented
public @interface UnitOfWork {
    
If true, the Hibernate session will default to loading read-only entities. 
See Also:
Session.setDefaultReadOnly(boolean)/**
     * If {@code true}, the Hibernate session will default to loading read-only entities.
     *
     * @see org.hibernate.Session#setDefaultReadOnly(boolean)
     */
    boolean readOnly() default false;

    
If true, a transaction will be automatically started before the resource method is invoked, committed if the method returned, and rolled back if an exception was thrown. /**
     * If {@code true}, a transaction will be automatically started before the resource method is
     * invoked, committed if the method returned, and rolled back if an exception was thrown.
     */
    boolean transactional() default true;

    
The CacheMode for the session. 
See Also:
CacheMode
Session.setCacheMode(CacheMode)/**
     * The {@link CacheMode} for the session.
     *
     * @see CacheMode
     * @see org.hibernate.Session#setCacheMode(CacheMode)
     */
    CacheMode cacheMode() default CacheMode.NORMAL;

    
The FlushMode for the session. 
See Also:
FlushMode
Session.setFlushMode(FlushMode)/**
     * The {@link FlushMode} for the session.
     *
     * @see FlushMode
     * @see org.hibernate.Session#setFlushMode(org.hibernate.FlushMode)
     */
    FlushMode flushMode() default FlushMode.AUTO;

    
The name of a hibernate bundle (session factory) that specifies
a datasource against which a transaction will be opened.
/**
     * The name of a hibernate bundle (session factory) that specifies
     * a datasource against which a transaction will be opened.
     */
    String value() default HibernateBundle.DEFAULT_NAME;
}