org.postgresql.pljava.internal
Class Relation

java.lang.Object
  org.postgresql.pljava.internal.JavaWrapper
      org.postgresql.pljava.internal.Relation

public class Relation
extends JavaWrapper

The Relation correspons to the internal PostgreSQL Relation.

Author:

Thomas Hallgren

Method Summary

protected void	_free(long pointer) Calls the C function pfree() with the given pointer as an argument.
String	getName() Returns the name of this Relation.
String	getSchema() Returns the schema name of this Relation.
TupleDesc	getTupleDesc() Returns a descriptor that describes tuples in this Relation.
Tuple	modifyTuple(Tuple original, int[] fieldNumbers, Object[] values) Creates a new Tuple by substituting new values for selected columns copying the columns of the original Tuple at other positions.

Methods inherited from class org.postgresql.pljava.internal.JavaWrapper

finalize, getNativePointer

Methods inherited from class java.lang.Object

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

Method Detail

getName

public String getName()
               throws SQLException

Returns the name of this Relation.

Throws:

SQLException

getSchema

public String getSchema()
                 throws SQLException

Returns the schema name of this Relation.

Throws:

SQLException

getTupleDesc

public TupleDesc getTupleDesc()
                       throws SQLException

Returns a descriptor that describes tuples in this Relation.

Throws:

SQLException

modifyTuple

public Tuple modifyTuple(Tuple original,
                         int[] fieldNumbers,
                         Object[] values)
                  throws SQLException

Creates a new Tuple by substituting new values for selected columns copying the columns of the original Tuple at other positions. The original Tuple is not modified.

Parameters:

original - The tuple that serves as the source.

fieldNumbers - An array of one based indexes denoting the positions that are to receive modified values.

values - The array of new values. Each value in this array corresponds to an index in the fieldNumbers array.

Returns:

A copy of the original with modifications.

Throws:

SQLException - if indexes are out of range or the values illegal.

_free

protected void _free(long pointer)

Description copied from class: JavaWrapper

Calls the C function pfree() with the given pointer as an argument. Subclasses may override this method if special handling is needed when freeing up the object.

Overrides:

_free in class JavaWrapper

Parameters:

pointer - The pointer to free.