be.SIRAPRISE.client.jsba

Class Tuple

java.lang.Object

be.SIRAPRISE.typeimplementations.Tuple

be.SIRAPRISE.client.jsba.Tuple

Deprecated.

- the Tuple class and its methods have been moved to the typeimplementations package. This class is left as extending those new classes for purposes of backward compatibility.

@Deprecated
public class Tuple
extends Tuple

Tuple provides method implementations for the Tuple interface

Author:

Erwin Smout

Constructor Summary

Constructors

Constructor and Description
Tuple(Heading heading, java.util.Map<java.lang.String,ValueBuffer> attributeValueMap) Deprecated. - replace with Tuple(Map, Heading)
Tuple(Heading heading, TupleBuffer tupleBuffer) Deprecated. Creates the Tuple object
Tuple(java.util.Map<NameIdentifier,ValueBuffer> attributeValueMap, Heading heading) Deprecated. Creates the tuple

Method Summary

Modifier and Type	Method and Description
<C> C	toObject(java.lang.Class<C> objectClass) Deprecated. - replace by be.SIRAPRISE.client.jsba.DBObjectFactory.getObject(...) - e.g. by inlining the calls to this method
java.util.Map<java.lang.Class<?>,java.lang.Object>	toObjects(java.lang.Class<?>[] objectClass) Deprecated. - replace by be.SIRAPRISE.client.jsba.DBObjectFactory.getObjects(...) - e.g. by inlining the calls to this method

Methods inherited from class be.SIRAPRISE.typeimplementations.Tuple

equals, equalsTuple, escapedValueText, escapedValueText, getHeading, getPropositionText, getTupleBuffer, hashCode, identifierValueMap, printBodyValueWithoutTypeNames, printBodyValueXML, printEscapedBodyValueWithoutTypeNames, printEscapedBodyValueWithTypeNames, printEscapedValueWithoutTypeNames, printEscapedValueWithTypeNames, printValueWithoutTypeNames, printValueWithTypeNames, printValueXML, rvaValue, rvaValue, toString, tvaValue, tvaValue, valueBuffer, valueBuffer, valueMap, valueText, valueText

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Tuple

@Deprecated
public Tuple(Heading heading,
                         java.util.Map<java.lang.String,ValueBuffer> attributeValueMap)

Deprecated. - replace with Tuple(Map, Heading)

Creates the tuple

Parameters:

heading - the heading that the Tuple conforms to

attributeValueMap - the map holding the tuple's attribute values

Tuple

public Tuple(java.util.Map<NameIdentifier,ValueBuffer> attributeValueMap,
             Heading heading)

Deprecated.

Creates the tuple

Parameters:

heading - the heading that the Tuple conforms to

attributeValueMap - the map holding the tuple's attribute values

Tuple

public Tuple(Heading heading,
             TupleBuffer tupleBuffer)

Deprecated.

Creates the Tuple object

Parameters:

heading - the heading that the Tuple conforms to

tupleBuffer - the buffer holding the tuple value

Method Detail

toObject

@Deprecated
public final <C> C toObject(java.lang.Class<C> objectClass)
                                 throws SettersMissingException,
                                        ConstructorMissingException,
                                        ClassDoesNotImplementDBObjectException

Deprecated. - replace by be.SIRAPRISE.client.jsba.DBObjectFactory.getObject(...) - e.g. by inlining the calls to this method

Get an objects holding the same information as that which is held in this tuple.

Type Parameters:

C - -

Parameters:

objectClass - A Class object denoting the class of the objects to be returned. objectClass must denote a public, non-abstract class that has a public no-arg constructor, and that has a unique setter method for each attribute in the heading. The name of this unique method must be the concatenation of the word "set" (all lowercase), the attribute name (capitalized), and the suffix "FromDB". The argument list of this setter method must consist of excatly one java.lang.String argument.

Returns:

An array of objects of the given object Class.

Throws:

SettersMissingException - if a needed setter is missing in the class denoted by objectClass

ConstructorMissingException - if objectClass does not denote a public class, or it denotes an abstract class, or the class does not have a public no-arg constructor

ClassDoesNotImplementDBObjectException - if objectClass does not implement the required DBObject interface

toObjects

@Deprecated
public final java.util.Map<java.lang.Class<?>,java.lang.Object> toObjects(java.lang.Class<?>[] objectClass)
                                                                               throws SettersMissingException,
                                                                                      ConstructorMissingException,
                                                                                      ClassDoesNotImplementDBObjectException

Deprecated. - replace by be.SIRAPRISE.client.jsba.DBObjectFactory.getObjects(...) - e.g. by inlining the calls to this method

Get a Map of objects holding the same information as that which is held in this Tuple. The entries in the map have one of the objectClass[] objects as their key, and an object of that class as their value. The object of that class holds the attribute values of the tuple for which a corresponding setter method was found in the class.

Parameters:

objectClass - An array of Class objects denoting the classes of the objects to be returned for each tuple. Each objectClass must denote a public, non-abstract class that has a public no-arg constructor, and that has a unique setter method for some attribute in the heading. The name of this unique method must be the concatenation of the word "set" (all lowercase), the attribute name (capitalized), and the suffix "FromDB". The argument list of this setter method must consist of excatly one java.lang.String argument.

Returns:

A map of objects holding the same information as this tuple. The key in each map entry is one of the objectClass objects given as an argument, the corresponding value in the map entry is the created object of that class.

Throws:

SettersMissingException - if some attribute in the heading exists for which no corresponding setter could be found in any of the classes denoted by objectClass[]

ConstructorMissingException - if objectClass[] contains any class that does not denote a public class, or denotes an abstract class, or does not have a public no-arg constructor

ClassDoesNotImplementDBObjectException - if objectClass[] contains any class that does not implement the required DBObject interface