simpledb

Class Insert

java.lang.Object

simpledb.Operator

simpledb.Insert

All Implemented Interfaces:

java.io.Serializable, DbIterator

public class Insert
extends Operator

Inserts tuples read from the child operator into the tableid specified in the constructor

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	calledOnce
private DbIterator	iterator
private static long	serialVersionUID
private int	tableId
private TransactionId	tid

Constructor Summary

Constructors

Constructor and Description
Insert(TransactionId t, DbIterator child, int tableid) Constructor.

Method Summary

Modifier and Type	Method and Description
void	close() Closes this iterator.
protected Tuple	fetchNext() Inserts tuples read from child into the tableid specified by the constructor.
DbIterator[]	getChildren()
TupleDesc	getTupleDesc() Returns the TupleDesc associated with this DbIterator.
void	open() Opens the iterator.
void	rewind() Resets the iterator to the start.
void	setChildren(DbIterator[] children) Set the children(child) of this operator.

Methods inherited from class simpledb.Operator

getEstimatedCardinality, hasNext, next, setEstimatedCardinality

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

tid

private TransactionId tid

iterator

private DbIterator iterator

tableId

private int tableId

calledOnce

private boolean calledOnce

Constructor Detail

Insert

public Insert(TransactionId t,
              DbIterator child,
              int tableid)
       throws DbException

Constructor.

Parameters:

t - The transaction running the insert.

child - The child operator from which to read tuples to be inserted.

tableid - The table in which to insert tuples.

Throws:

DbException - if TupleDesc of child differs from table into which we are to insert.

Method Detail

getTupleDesc

public TupleDesc getTupleDesc()

Description copied from interface: DbIterator

Returns the TupleDesc associated with this DbIterator.

Specified by:

getTupleDesc in interface DbIterator

Specified by:

getTupleDesc in class Operator

Returns:

return the TupleDesc of the output tuples of this operator

open

public void open()
          throws DbException,
                 TransactionAbortedException

Description copied from interface: DbIterator

Opens the iterator. This must be called before any of the other methods.

Specified by:

open in interface DbIterator

Overrides:

open in class Operator

Throws:

DbException - when there are problems opening/accessing the database.

TransactionAbortedException

close

public void close()

Description copied from class: Operator

Closes this iterator. If overridden by a subclass, they should call super.close() in order for Operator's internal state to be consistent.

Specified by:

close in interface DbIterator

Overrides:

close in class Operator

rewind

public void rewind()
            throws DbException,
                   TransactionAbortedException

Description copied from interface: DbIterator

Resets the iterator to the start.

Throws:

DbException - when rewind is unsupported.

TransactionAbortedException

fetchNext

protected Tuple fetchNext()
                   throws TransactionAbortedException,
                          DbException

Inserts tuples read from child into the tableid specified by the constructor. It returns a one field tuple containing the number of inserted records. Inserts should be passed through BufferPool. An instances of BufferPool is available via Database.getBufferPool(). Note that insert DOES NOT need check to see if a particular tuple is a duplicate before inserting it.

Specified by:

fetchNext in class Operator

Returns:

A 1-field tuple containing the number of inserted records, or null if called more than once.

Throws:

TransactionAbortedException

DbException

See Also:

Database.getBufferPool(), BufferPool.insertTuple(simpledb.TransactionId, int, simpledb.Tuple)

getChildren

public DbIterator[] getChildren()

Specified by:

getChildren in class Operator

Returns:

return the children DbIterators of this operator. If there is only one child, return an array of only one element. For join operators, the order of the children is not important. But they should be consistent among multiple calls.

setChildren

public void setChildren(DbIterator[] children)

Description copied from class: Operator

Set the children(child) of this operator. If the operator has only one child, children[0] should be used. If the operator is a join, children[0] and children[1] should be used.

Specified by:

setChildren in class Operator

Parameters:

children - the DbIterators which are to be set as the children(child) of this operator