org.apache.metamodel.insert

Interface RowInsertable

All Known Subinterfaces:

UpdateCallback

All Known Implementing Classes:

AbstractUpdateCallback

public interface RowInsertable

An interface for objects that support inserting rows into tables.

Method Summary

Modifier and Type	Method and Description
RowInsertionBuilder	insertInto(String tableName) Initiates the building of a row insertion operation.
RowInsertionBuilder	insertInto(String schemaName, String tableName) Initiates the building of a row insertion operation.
RowInsertionBuilder	insertInto(Table table) Initiates the building of a row insertion operation.
boolean	isInsertSupported() Determines whether row insertion is supported

Method Detail

isInsertSupported

boolean isInsertSupported()

Determines whether row insertion is supported

Returns:

true if row insertion is supported

insertInto

RowInsertionBuilder insertInto(Table table)
                        throws IllegalArgumentException,
                               IllegalStateException,
                               UnsupportedOperationException

Initiates the building of a row insertion operation.

Parameters:

table - the table to insert a row into

Returns:

a builder object on which values can be added and the statement can be committed.

Throws:

IllegalArgumentException - if the table argument is null or invalid.

IllegalStateException - if the connection to the DataContext is read-only or another access restriction is preventing the operation.

UnsupportedOperationException - in case isInsertSupported() is false

insertInto

RowInsertionBuilder insertInto(String tableName)
                        throws IllegalArgumentException,
                               IllegalStateException,
                               UnsupportedOperationException

Initiates the building of a row insertion operation.

Parameters:

tableName - the name of the table to insert a row into

Returns:

a builder object on which values can be added and the statement can be committed.

Throws:

IllegalArgumentException - if the tableName argument is null or invalid.

IllegalStateException - if the connection to the DataContext is read-only or another access restriction is preventing the operation.

UnsupportedOperationException - in case isInsertSupported() is false

insertInto

RowInsertionBuilder insertInto(String schemaName,
                               String tableName)
                        throws IllegalArgumentException,
                               IllegalStateException,
                               UnsupportedOperationException

Initiates the building of a row insertion operation.

Parameters:

schemaName - the name of the schema

tableName - the name of the table to insert a row into

Returns:

a builder object on which values can be added and the statement can be committed.

Throws:

IllegalArgumentException - if the tableName argument is null or invalid.

IllegalStateException - if the connection to the DataContext is read-only or another access restriction is preventing the operation.

UnsupportedOperationException - in case isInsertSupported() is false