com.whitestein.lsps.lang

Interface HolderFactory

All Known Subinterfaces:

Namespace

All Known Implementing Classes:

AbstractContextNamespace, AbstractMockNamespace, ContextNamespace, MockHolderFactory, MockNamespace, MockNamespacePart, MockRecordNamespace, NoBaseContextNamespace, RecordNamespace, RecordProxySetNamespace

public interface HolderFactory

This factory provides means to create complex language structures, i.e. lists, sets, maps, records, references and closures.

Author:

rba

Method Summary

Modifier and Type	Method and Description
BinaryHolder	createBinaryHolder(byte[] data) Creates binary data holder.
BinaryHolder	createBinaryHolder(java.lang.String datasourceJndi, java.lang.String recordType, java.lang.String primaryKeyString, java.lang.String propertyName, java.sql.Blob data) Creates binary data holder.
ClosureHolder	createClosure(ClosureType closureType, ClosureExpression closureExpression, ClosureOrigin origin) Creates new closure corresponding to given closure expression.
ClosureHolder	createClosure(ClosureType closureType, FunctionExpression operationExpression, ClosureOrigin origin) Creates new closure corresponding to given operation expression.
ClosureHolder	createClosure(ClosureType closureType, MethodExpression operationExpression, ClosureOrigin origin) Creates new closure corresponding to given operation expression.
ClosureHolder	createClosureFromExpression(ClosureType closureType, Expression expression, ClosureOrigin origin) Creates new closure from a given expression.
RecordHolder	createExternalRecordProxy(RecordType type, RecordHolder proxySet) Creates a proxy without proxied record.
ListHolder	createList(java.util.Collection<?> values) Creates new list with given values (ListHolders are immutable).
MapHolder	createMap(java.util.List<?> keys, java.util.List<?> values) Creates new map with given values (MapHolders are immutable).
default MapHolder	createMap(java.util.Map<?,?> map) Creates new map with given values (MapHolders are immutable).
RecordHolder	createNonSharedRecord(RecordType type, java.util.Map<java.lang.String,?> values) Creates new record of given type.
ListHolder	createRange(long first, long last) Creates a range (list) defined by endpoints (both inclusive).
default RecordHolder	createRecord(RecordType type) Creates new record with given type.
RecordHolder	createRecord(RecordType type, java.util.Map<java.lang.String,?> values) Creates new record with given type.
default RecordHolder	createRecord(java.lang.String type) Creates new record with given type.
RecordHolder	createRecord(java.lang.String type, java.util.Map<java.lang.String,?> values) Creates new record with given type.
ReferenceHolder	createReference(ReferenceType referenceType, ReferenceExpression referenceExpression, java.util.List<Property> properties, ClosureOrigin origin) Returns new reference corresponding to given reference expression.
SetHolder	createSet(java.util.Collection<?> values) Creates new set with given values (SetHolders are immutable).

Method Detail

createRecord

default RecordHolder createRecord(RecordType type)

Creates new record with given type. The record fields are not initialized.

Parameters:

type -

Returns:

new record with given type

Throws:

java.lang.NullPointerException - if type is null

createExternalRecordProxy

RecordHolder createExternalRecordProxy(RecordType type,
                                       RecordHolder proxySet)

Creates a proxy without proxied record. It can be used only for shared records. When merged a shared record is created. If proxySet is null it creates proxy on level 1. If a proxy set is specified, it creates proxy on the level of the proxy set and adds it to the proxy set.

Parameters:

type -

proxySet -

Returns:

proxy without proxied record

createRecord

RecordHolder createRecord(RecordType type,
                          java.util.Map<java.lang.String,?> values)

Creates new record with given type.

Parameters:

type -

values - initial record field values

Returns:

new record with given type

Throws:

java.lang.NullPointerException - if type or values is null

java.lang.IllegalArgumentException - if values are not assignable to the record field types

createNonSharedRecord

RecordHolder createNonSharedRecord(RecordType type,
                                   java.util.Map<java.lang.String,?> values)

Creates new record of given type. The record is always created non persistent, even if the record type is shared. Use this carefully, since this may result in many non shared instances of shared record types swarming in the model context and may cause a lot of exceptional behavior, e.g. when trying to assign not persistent object as a member of association of some other shared instance.

Parameters:

type -

values - initial record field values

Returns:

new record with given type

Throws:

java.lang.NullPointerException - if type or values is null

java.lang.IllegalArgumentException - if values are not assignable to the record field types

createRecord

default RecordHolder createRecord(java.lang.String type)

Creates new record with given type. The type must be a fully qualified name. The record fields are not initialized.

Parameters:

type -

Returns:

new record with given type

Throws:

java.lang.NullPointerException - if type is null

java.lang.IllegalArgumentException - if no such type exists

See Also:

RecordType

createRecord

RecordHolder createRecord(java.lang.String type,
                          java.util.Map<java.lang.String,?> values)

Creates new record with given type. The type must be a fully qualified name.

Parameters:

type -

values - initial record field values

Returns:

new record with given type

Throws:

java.lang.NullPointerException - if type is null

java.lang.IllegalArgumentException - if no such type exists or if values are not assignable to the record field types

See Also:

RecordType

createList

ListHolder createList(java.util.Collection<?> values)

Creates new list with given values (ListHolders are immutable). The type is inferred from the types of the values.

Parameters:

values -

Returns:

new list

Throws:

java.lang.NullPointerException - if values is null

java.lang.IllegalArgumentException - if values are not of a valid type

createRange

ListHolder createRange(long first,
                       long last)

Creates a range (list) defined by endpoints (both inclusive).

If first <= last, the range contains elements first, first + 1, ..., last.

If first > last, the range contains elements first, first - 1, ..., last.

The memory footprint of range in constant (only endpoints and size is stored, not all elements).

Parameters:

first -

last -

Returns:

the created list

Throws:

java.lang.NullPointerException - if values is null

java.lang.IllegalArgumentException - if values are not of a valid type

createSet

SetHolder createSet(java.util.Collection<?> values)

Creates new set with given values (SetHolders are immutable). The type is inferred from the types of the values.

Parameters:

values -

Returns:

new list

Throws:

java.lang.NullPointerException - if values is null

java.lang.IllegalArgumentException - if values are not of a valid type

createMap

MapHolder createMap(java.util.List<?> keys,
                    java.util.List<?> values)

Creates new map with given values (MapHolders are immutable). The type is inferred from the types of the values.

Parameters:

keys - a list of keys

values - a list of values

Returns:

new map

Throws:

java.lang.NullPointerException - if keys or values is null

createMap

default MapHolder createMap(java.util.Map<?,?> map)

Creates new map with given values (MapHolders are immutable). The type is inferred from the types of the values.

Parameters:

map -

Returns:

new map

Throws:

java.lang.NullPointerException - if map is null

createClosure

ClosureHolder createClosure(ClosureType closureType,
                            ClosureExpression closureExpression,
                            ClosureOrigin origin)

Creates new closure corresponding to given closure expression.

Parameters:

closureType -

closureExpression -

origin -

Returns:

new closure

Throws:

java.lang.NullPointerException - if closureType or closureExpression is null

createClosureFromExpression

ClosureHolder createClosureFromExpression(ClosureType closureType,
                                          Expression expression,
                                          ClosureOrigin origin)

Creates new closure from a given expression. The expression is treated as a closure without arguments.

Parameters:

closureType -

expression -

origin -

Returns:

new closure from a given expression

Throws:

java.lang.NullPointerException - if closureType or expression is null

createClosure

ClosureHolder createClosure(ClosureType closureType,
                            FunctionExpression operationExpression,
                            ClosureOrigin origin)

Creates new closure corresponding to given operation expression.

Parameters:

closureType -

operationExpression -

origin -

Returns:

new closure

Throws:

java.lang.NullPointerException - if closureType or operationExpression is null

createClosure

ClosureHolder createClosure(ClosureType closureType,
                            MethodExpression operationExpression,
                            ClosureOrigin origin)

Creates new closure corresponding to given operation expression.

Parameters:

closureType -

operationExpression -

origin -

Returns:

new closure

Throws:

java.lang.NullPointerException - if closureType or operationExpression is null

createReference

ReferenceHolder createReference(ReferenceType referenceType,
                                ReferenceExpression referenceExpression,
                                java.util.List<Property> properties,
                                ClosureOrigin origin)

Returns new reference corresponding to given reference expression.

Parameters:

referenceType -

referenceExpression -

properties -

origin -

Returns:

new reference

Throws:

java.lang.NullPointerException - if referenceType or referenceExpression is null

createBinaryHolder

BinaryHolder createBinaryHolder(byte[] data)

Creates binary data holder.

Parameters:

data -

Returns:

binary data holder

createBinaryHolder

BinaryHolder createBinaryHolder(java.lang.String datasourceJndi,
                                java.lang.String recordType,
                                java.lang.String primaryKeyString,
                                java.lang.String propertyName,
                                java.sql.Blob data)

Creates binary data holder.

Parameters:

datasourceJndi -

recordType -

primaryKeyString -

propertyName -

data -

Returns:

binary data holder