org.seasar.doma

Annotation Type Update

@Target(value=METHOD)
 @Retention(value=RUNTIME)
public @interface Update

Indicates an update.

The annotated method must be a member of a Dao annotated interface.

 @Entity
 public class Employee {
     ...
 }

 @Dao
 public interface EmployeeDao {

     @Update
     int update(Employee employee);
 }
 

The method may throw following exceptions:

• DomaNullPointerException if any of the method parameters are null
• OptimisticLockException if optimistic locking is enabled and an update count is 0 for each entity
• UniqueConstraintException if an unique constraint is violated
• SqlFileNotFoundException if sqlFile is true and the SQL file is not found
• JdbcException if a JDBC related error occurs

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
java.lang.String[]	exclude The properties whose mapped columns are excluded from SQL UPDATE statements.
boolean	excludeNull Whether SQL NULL columns are excluded from SQL INSERT statements.
boolean	ignoreVersion Whether the version property is ignored.
java.lang.String[]	include The properties whose mapped columns are included in SQL UPDATE statements.
boolean	includeUnchanged Whether columns mapped to unchanged properties are included in SQL UPDATE statements.
int	queryTimeout The query timeout in seconds.
boolean	sqlFile
SqlLogType	sqlLog
boolean	suppressOptimisticLockException Whether OptimisticLockException is suppressed.

Element Detail

sqlFile

public abstract boolean sqlFile

Returns:

whether the annotated method is mapped to an SQL file.

Default:

false

queryTimeout

public abstract int queryTimeout

The query timeout in seconds.

If not specified, Config.getQueryTimeout() is used.

Returns:

the query timeout

See Also:

Statement.setQueryTimeout(int)

Default:

-1

excludeNull

public abstract boolean excludeNull

Whether SQL NULL columns are excluded from SQL INSERT statements.

Only if sqlFile() is false, this element value is used.

Returns:

whether SQL NULL columns are excluded

Default:

false

ignoreVersion

public abstract boolean ignoreVersion

Whether the version property is ignored.

If true, the column that mapped to the version property is excluded from SQL UPDATE statements.

Returns:

whether the version property is ignored

Default:

false

includeUnchanged

public abstract boolean includeUnchanged

Whether columns mapped to unchanged properties are included in SQL UPDATE statements.

Only if the method parameter type is entity class that has a OriginalStates annotated filed, this element value is used.

Returns:

whether columns mapped to unchanged properties are included

Default:

false

include

public abstract java.lang.String[] include

The properties whose mapped columns are included in SQL UPDATE statements.

Only if sqlFile() is false, this value is used.

Returns:

the included properties

Default:

{}

exclude

public abstract java.lang.String[] exclude

The properties whose mapped columns are excluded from SQL UPDATE statements.

Only if sqlFile() is false, this value is used.

Returns:

the excluded properties

Default:

{}

suppressOptimisticLockException

public abstract boolean suppressOptimisticLockException

Whether OptimisticLockException is suppressed.

Only if sqlFile() is false, this element value is used.

Returns:

whether OptimisticLockException is suppressed

Default:

false

sqlLog

public abstract SqlLogType sqlLog

Returns:

the output format of SQL logs.

Default:

org.seasar.doma.jdbc.SqlLogType.FORMATTED