com.goldencode.p2j.util

Interface Dereferenceable

All Known Subinterfaces:

Buffer, EmptyBuffer, HandleCommon, TempTable, TempTableBuffer

All Known Implementing Classes:

AbstractTempTable, BufferImpl, DataSet, StaticDataSet, StaticTempTable, TempTableBuilder

public interface Dereferenceable

This interface declares only one method, dereference() which is the correspondent of the Progress 10.x :: punctuation. In the left-hand side it has a handle to a container object of some kind (buffer, table or ProDataSet) and the right-hand side is not an attribute or method, but instead is a named member of the left-hand side.

Method Summary

Modifier and Type	Method and Description
<T extends BaseDataType> T	dereference(java.lang.Class<T> type, java.lang.String memberName) Dereference a named member from this collection.
default BaseDataType	dereference(long index, java.lang.String memberName) Dereference a named member from this collection.
default void	dereference(long index, java.lang.String memberName, java.lang.Object value) This overloaded method is used when the dereference is the left-side of an assignment.
default BaseDataType	dereference(NumberType index, java.lang.String memberName) Dereference a named member from this collection.
default void	dereference(NumberType index, java.lang.String memberName, java.lang.Object value) This overloaded method is used when the dereference is the left-side of an assignment.
BaseDataType	dereference(java.lang.String memberName) Dereference a named member from this collection.
void	dereference(java.lang.String memberName, java.lang.Object value) This overloaded method is used when the dereference is the left-side of an assignment.
java.lang.Object	derefPoly(java.lang.String memberName) Emitted for :: operator used as r-value in a dynamic extent assignment, as the conversion rules doesn't know if the target field is extent or scalar.

Method Detail

dereference

BaseDataType dereference(java.lang.String memberName)

Dereference a named member from this collection. If this collection is a ProDataSet then the returned value is a handle to a named buffer, if the collection is a buffer the returned value is the field value with the respective name. In the case that this collection does not have a named member with the name specified memberName the unknown value is returned.

Parameters:

memberName - The name of the member to be extracted.

Returns:

The value of the member or unknown (?) if there is no such member.

dereference

<T extends BaseDataType> T dereference(java.lang.Class<T> type,
                                       java.lang.String memberName)

Dereference a named member from this collection. If this collection is a ProDataSet then the returned value is a handle to a named buffer, if the collection is a buffer the returned value is the field value with the respective name. In the case that this collection does not have a named member with the name specified memberName the unknown value is returned.

Parameters:

type - The expected type of the returned value.

memberName - The name of the member to be extracted.

Returns:

The value of the member or unknown (?) if there is no such member.

dereference

void dereference(java.lang.String memberName,
                 java.lang.Object value)

This overloaded method is used when the dereference is the left-side of an assignment. The implementation will extract the member from the collection and assign it the new value.

Parameters:

memberName - The name of the member to be extracted.

value - The new value that will be assigned to the extracted field.

dereference

default BaseDataType dereference(long index,
                                 java.lang.String memberName)

Dereference a named member from this collection. If this collection is a ProDataSet then the returned value is a handle to a named buffer, if the collection is a buffer the returned value is the field value with the respective name. In the case that this collection does not have a named member with the name specified memberName the unknown value is returned.

Parameters:

index - The subscript to be applied to an extent field.

memberName - The name of the member to be extracted.

Returns:

The value of the member or unknown (?) if there is no such member.

dereference

default void dereference(long index,
                         java.lang.String memberName,
                         java.lang.Object value)

This overloaded method is used when the dereference is the left-side of an assignment. The implementation will extract the member from the collection and assign it the new value.

Parameters:

index - The subscript to be applied to an extent field.

memberName - The name of the member to be extracted.

value - The new value that will be assigned to the extracted field.

dereference

default BaseDataType dereference(NumberType index,
                                 java.lang.String memberName)

Dereference a named member from this collection. If this collection is a ProDataSet then the returned value is a handle to a named buffer, if the collection is a buffer the returned value is the field value with the respective name. In the case that this collection does not have a named member with the name specified memberName the unknown value is returned.

Parameters:

index - The subscript to be applied to an extent field.

memberName - The name of the member to be extracted.

Returns:

The value of the member or unknown (?) if there is no such member.

dereference

default void dereference(NumberType index,
                         java.lang.String memberName,
                         java.lang.Object value)

This overloaded method is used when the dereference is the left-side of an assignment. The implementation will extract the member from the collection and assign it the new value.

Parameters:

index - The subscript to be applied to an extent field.

memberName - The name of the member to be extracted.

value - The new value that will be assigned to the extracted field.

derefPoly

java.lang.Object derefPoly(java.lang.String memberName)

Emitted for :: operator used as r-value in a dynamic extent assignment, as the conversion rules doesn't know if the target field is extent or scalar.

Parameters:

memberName - The name of the member to be extracted.

Returns:

The value of the member (scalar or extent) or unknown (?) if there is no such member.