org.teasoft.bee.osql

Interface Suid

All Superinterfaces:

CommOperate

All Known Subinterfaces:

ObjSQLRichService, ObjSQLService, SuidRich

All Known Implementing Classes:

ObjSQLAbstractServiceImpl, ObjSQLRichAbstractServiceImpl

public interface Suid
extends CommOperate

Database operation: Suid (select,update,insert,delete), the null and empty string are not handled by default.

Since:

1.0

Author:

Kingstar Create on 2013-6-30 22:03:15

Method Summary

Modifier and Type	Method and Description
void	beginSameConnection() declare begin Same Connection for some ORM operation.
<T> int	delete(T entity) According to entity object delete record.
<T> int	delete(T entity, Condition condition) Delete the records according to entity and condition.
void	endSameConnection() declare end Same Connection for some ORM operation.
<T> int	insert(T entity) According to entity object insert record.
<T> long	insertAndReturnId(T entity) According to entity object insert record and return id value.
<T> List<T>	select(T entity) According to entity object select records from database.
<T> List<T>	select(T entity, Condition condition) Select the records according to entity and condition.
Suid	setDynamicParameter(String param, String value) set dynamic parameter for dynamic table & entity name This method is called earlier than the select, update, insert, delete methods.
<T> int	update(T entity) According to entity object update record.This method just has id field to SQL where expression.

Methods inherited from interface org.teasoft.bee.osql.CommOperate

getDataSourceName, getInterceptorChain, setDataSourceName, setNameTranslateOneTime

Method Detail

select

<T> List<T> select(T entity)

According to entity object select records from database.

Parameters:

entity - table's entity(do not allow null).
Entity corresponding to table and can not be null.
If the field value is not null and not empty field as filter condition,
the operator is equal sign.eg:field=value

Returns:

list which contains more than one entity.

update

<T> int update(T entity)

According to entity object update record.This method just has id field to SQL where expression. table's entity(do not allow null);id is where condition,do not allow null.
The entity corresponding to table and can not be null.
The ID field of entity cannot be null and as filter condition.
The not null and not empty field will update to database except ID.

Returns:

the numbers of update records successfully, if fails,return integer less than 0.

See Also:

SuidRich#update(Object,java.lang.String)

insert

<T> int insert(T entity)

According to entity object insert record.

Parameters:

entity - table's entity(do not allow null).
The entity corresponding to table and can not be null.
The not null and not empty field will insert to database.

Returns:

the numbers of insert records successfully, if fails,return integer less than 0.

insertAndReturnId

<T> long insertAndReturnId(T entity)

According to entity object insert record and return id value.

Parameters:

entity - table's entity(do not allow null).
The entity corresponding to table and can not be null.
The not null and not empty field will insert to database.

Returns:

If successful, return the id value of the inserted record; if fails, return number less than 0.

Since:

1.9

delete

<T> int delete(T entity)

According to entity object delete record.

Parameters:

entity - table's entity(do not allow null).
The entity corresponding to table and can not be null.
If the field value is not null and not empty field as filter condition,
the operator is equal sign.eg:field=value

Returns:

the numbers of delete records successfully, if fails,return integer less than 0.

select

<T> List<T> select(T entity,
                   Condition condition)

Select the records according to entity and condition.

Parameters:

entity - table's entity(do not allow null).

condition - If the field of entity is not null or empty, it will be translate to field=value.Other can define with condition.

Returns:

list which contains more than one entity.

Since:

1.6

delete

<T> int delete(T entity,
               Condition condition)

Delete the records according to entity and condition.

Parameters:

entity - table's entity(do not allow null).

condition - If the field of entity is not null or empty, it will be translate to field=value.Other can define with condition.

Returns:

the number of deleted record(s) successfully, if fails,return integer less than 0.

Since:

1.7.2

setDynamicParameter

Suid setDynamicParameter(String param,
                         String value)

set dynamic parameter for dynamic table & entity name
This method is called earlier than the select, update, insert, delete methods.

Parameters:

param - parameter name

value - parameter value

Returns:

Suid

Since:

1.8

beginSameConnection

void beginSameConnection()

declare begin Same Connection for some ORM operation.

Since:

1.9

endSameConnection

void endSameConnection()

declare end Same Connection for some ORM operation.

Since:

1.9