A Neo4j node collection using a sequential identification scheme.

The local IDs are sequential numbers (integers) starting at 1.

Note: When loading nodes, the local IDs should forms a mostly contiguous range starting at 1. Else, this collection will consume a lot of memory. Futhermore, the local IDs must be positive.

var nodes = new SequentialNodeCollection("id")
var a = nodes.create_node
var b = new NeoNode
var c = new NeoNode

nodes.register b
c["id"] = 4
nodes.add c
assert a["id"] == 1
assert b["id"] == 2
assert c["id"] == 4
assert nodes.to_a == [a, b, c]
assert nodes.length == 3

nodes.compact
assert a["id"] == 1
assert b["id"] == 2
assert c["id"] == 3
assert nodes.to_a == [a, b, c]
assert nodes.length == 3

Introduced properties

private var _nodes: Array[nullable NeoNode]

neo4j :: SequentialNodeCollection :: _nodes

protected fun length=(length: Int)

neo4j :: SequentialNodeCollection :: length=

private fun nodes: Array[nullable NeoNode]

neo4j :: SequentialNodeCollection :: nodes

private fun nodes=(nodes: Array[nullable NeoNode])

neo4j :: SequentialNodeCollection :: nodes=

Redefined properties

redef type ID_TYPE: Int

neo4j $ SequentialNodeCollection :: ID_TYPE

The type of the local IDs.
redef type SELF: SequentialNodeCollection

neo4j $ SequentialNodeCollection :: SELF

Type of this instance, automatically specialized in every class
redef fun [](id: ID_TYPE): NeoNode

neo4j $ SequentialNodeCollection :: []

Retrieve the node that has the specified local id.
redef fun add(node: NeoNode)

neo4j $ SequentialNodeCollection :: add

Add item to this collection.
redef fun clear

neo4j $ SequentialNodeCollection :: clear

Remove all items
redef fun compact

neo4j $ SequentialNodeCollection :: compact

Optimize the collection, possibly by rewritting it.
redef fun enlarge(cap: Int)

neo4j $ SequentialNodeCollection :: enlarge

Enlarge the collection to have at least the specified capacity.
redef fun get_or_null(id: ID_TYPE): nullable NeoNode

neo4j $ SequentialNodeCollection :: get_or_null

Retrieve the node that has the specified local id, or return null.
redef fun has_id(id: ID_TYPE): Bool

neo4j $ SequentialNodeCollection :: has_id

There is a node that has the specified local id?
redef fun iterator: Iterator[NeoNode]

neo4j $ SequentialNodeCollection :: iterator

Get a new iterator on the collection.
redef fun length: Int

neo4j $ SequentialNodeCollection :: length

Number of items in the collection.
redef fun register(node: NeoNode)

neo4j $ SequentialNodeCollection :: register

Add the specified node to the graph and set its local ID.
redef fun remove_at(id: ID_TYPE)

neo4j $ SequentialNodeCollection :: remove_at

Remove the node with the specified local ID.

All properties

fun !=(other: nullable Object): Bool

core :: Object :: !=

Have self and other different values?
fun ==(other: nullable Object): Bool

core :: Object :: ==

Have self and other the same value?
type CLASS: Class[SELF]

core :: Object :: CLASS

The type of the class of self.
type CONCURRENT: ConcurrentCollection[E]

core :: Collection :: CONCURRENT

Type of the concurrent variant of this collection
type ID_TYPE: Serializable

neo4j :: NeoNodeCollection :: ID_TYPE

The type of the local IDs.
type SELF: Object

core :: Object :: SELF

Type of this instance, automatically specialized in every class
fun [](id: ID_TYPE): NeoNode

neo4j :: NeoNodeCollection :: []

Retrieve the node that has the specified local id.
private var _id_property: String

neo4j :: NeoNodeCollection :: _id_property

The property of the nodes that hold the local ID.
private var _nodes: Array[nullable NeoNode]

neo4j :: SequentialNodeCollection :: _nodes

protected fun accept_json_serializer(v: JsonSerializer)

serialization :: Serializable :: accept_json_serializer

Refinable service to customize the serialization of this class to JSON
protected fun accept_msgpack_attribute_counter(v: AttributeCounter)

serialization :: Serializable :: accept_msgpack_attribute_counter

Hook to customize the behavior of the AttributeCounter
protected fun accept_msgpack_serializer(v: MsgPackSerializer)

serialization :: Serializable :: accept_msgpack_serializer

Hook to customize the serialization of this class to MessagePack
abstract fun add(item: E)

core :: SimpleCollection :: add

Add item to this collection.
fun add_all(coll: Collection[E])

core :: SimpleCollection :: add_all

Add each item of coll.
protected fun add_to_bundle(bundle: NativeBundle, key: JavaString)

serialization :: Serializable :: add_to_bundle

Called by []= to dynamically choose the appropriate method according
fun as_random: Queue[E]

core :: SimpleCollection :: as_random

Return a random proxy queue where result.take is random.
protected fun class_factory(name: String): CLASS

core :: Object :: class_factory

Implementation used by get_class to create the specific class.
fun class_name: String

core :: Object :: class_name

The class name of the object.
abstract fun clear

core :: RemovableCollection :: clear

Remove all items
fun combinations(r: Int): Collection[SequenceRead[E]]

core :: Collection :: combinations

All r-length combinations on self (in same order) without repeated elements.
fun combinations_with_replacement(r: Int): Collection[SequenceRead[E]]

core :: Collection :: combinations_with_replacement

All r-length combination on self (in same order) with repeated elements.
fun compact

neo4j :: NeoNodeCollection :: compact

Optimize the collection, possibly by rewritting it.
fun core_serialize_to(serializer: Serializer)

serialization :: Serializable :: core_serialize_to

Actual serialization of self to serializer
fun count(item: nullable Object): Int

core :: Collection :: count

How many occurrences of item are in the collection?
fun create_node: NeoNode

neo4j :: NeoNodeCollection :: create_node

Add a new node to the graph and return it.
fun enlarge(cap: Int)

neo4j :: NeoNodeCollection :: enlarge

Enlarge the collection to have at least the specified capacity.
fun first: E

core :: Collection :: first

Return the first item of the collection
init from_deserializer(deserializer: Deserializer)

serialization :: Serializable :: from_deserializer

Create an instance of this class from the deserializer
fun get_class: CLASS

core :: Object :: get_class

The meta-object representing the dynamic type of self.
fun get_or_null(id: ID_TYPE): nullable NeoNode

neo4j :: NeoNodeCollection :: get_or_null

Retrieve the node that has the specified local id, or return null.
fun has(item: nullable Object): Bool

core :: Collection :: has

Is item in the collection ?
fun has_all(other: Collection[nullable Object]): Bool

core :: Collection :: has_all

Does the collection contain at least each element of other?
fun has_any(other: Collection[nullable Object]): Bool

core :: Collection :: has_any

Does the collection contain at least one element of other?
fun has_exactly(other: Collection[nullable Object]): Bool

core :: Collection :: has_exactly

Does the collection contain exactly all the elements of other?
fun has_id(id: ID_TYPE): Bool

neo4j :: NeoNodeCollection :: has_id

There is a node that has the specified local id?
fun has_only(item: nullable Object): Bool

core :: Collection :: has_only

Is the collection contain only item?
fun hash: Int

core :: Object :: hash

The hash code of the object.
fun id_from_jsonable(id: nullable Serializable): ID_TYPE

neo4j :: NeoNodeCollection :: id_from_jsonable

Convert the specified JSON value into a local ID.
fun id_of(node: NeoNode): ID_TYPE

neo4j :: NeoNodeCollection :: id_of

Return the local ID of the node.
protected fun id_of=(node: NeoNode, id: ID_TYPE)

neo4j :: NeoNodeCollection :: id_of=

Set the local ID of the specified node.
fun id_property: String

neo4j :: NeoNodeCollection :: id_property

The property of the nodes that hold the local ID.
protected fun id_property=(id_property: String)

neo4j :: NeoNodeCollection :: id_property=

The property of the nodes that hold the local ID.
init init

core :: Object :: init

fun inspect: String

core :: Object :: inspect

Developer readable representation of self.
protected fun inspect_head: String

core :: Object :: inspect_head

Return "CLASSNAME:#OBJECTID".
fun is_empty: Bool

core :: Collection :: is_empty

Is there no item in the collection?
intern fun is_same_instance(other: nullable Object): Bool

core :: Object :: is_same_instance

Return true if self and other are the same instance (i.e. same identity).
fun is_same_serialized(other: nullable Object): Bool

core :: Object :: is_same_serialized

Is self the same as other in a serialization context?
intern fun is_same_type(other: Object): Bool

core :: Object :: is_same_type

Return true if self and other have the same dynamic type.
abstract fun iterator: Iterator[E]

core :: Collection :: iterator

Get a new iterator on the collection.
fun join(separator: nullable Text, last_separator: nullable Text): String

core :: Collection :: join

Concatenate and separate each elements with separator.
fun length: Int

core :: Collection :: length

Number of items in the collection.
protected fun length=(length: Int)

neo4j :: SequentialNodeCollection :: length=

protected fun msgpack_extra_array_items: Int

serialization :: Serializable :: msgpack_extra_array_items

Hook to request a larger than usual metadata array
private intern fun native_class_name: CString

core :: Object :: native_class_name

The class name of the object in CString format.
private fun nodes: Array[nullable NeoNode]

neo4j :: SequentialNodeCollection :: nodes

private fun nodes=(nodes: Array[nullable NeoNode])

neo4j :: SequentialNodeCollection :: nodes=

fun not_empty: Bool

core :: Collection :: not_empty

Alias for not is_empty.
intern fun object_id: Int

core :: Object :: object_id

An internal hash code for the object based on its identity.
fun output

core :: Object :: output

Display self on stdout (debug only).
intern fun output_class_name

core :: Object :: output_class_name

Display class name on stdout (debug only).
fun permutations(r: Int): Collection[SequenceRead[E]]

core :: Collection :: permutations

All r-length permutations on self (all possible ordering) without repeated elements.
fun plain_to_s: String

core :: Collection :: plain_to_s

Concatenate elements without separators
fun product(r: Int): Collection[SequenceRead[E]]

core :: Collection :: product

Cartesian product, over r times self.
fun rand: E

core :: Collection :: rand

Return a random element form the collection
abstract fun register(node: NeoNode)

neo4j :: NeoNodeCollection :: register

Add the specified node to the graph and set its local ID.
abstract fun remove(item: nullable Object)

core :: RemovableCollection :: remove

Remove an occurrence of item
fun remove_all(item: nullable Object)

core :: RemovableCollection :: remove_all

Remove all occurrences of item
abstract fun remove_at(id: ID_TYPE)

neo4j :: NeoNodeCollection :: remove_at

Remove the node with the specified local ID.
fun remove_node(node: NeoNode)

neo4j :: NeoNodeCollection :: remove_node

Remove the specified node.
fun sample(length: Int): Array[E]

core :: Collection :: sample

Return a new array made of (at most) length elements randomly chosen.
fun serialization_hash: Int

core :: Object :: serialization_hash

Hash value use for serialization
fun serialize_msgpack(plain: nullable Bool): Bytes

serialization :: Serializable :: serialize_msgpack

Serialize self to MessagePack bytes
fun serialize_to(serializer: Serializer)

serialization :: Serializable :: serialize_to

Serialize self to serializer
fun serialize_to_json(plain: nullable Bool, pretty: nullable Bool): String

serialization :: Serializable :: serialize_to_json

Serialize self to JSON
private fun serialize_to_or_delay(v: Serializer)

serialization :: Serializable :: serialize_to_or_delay

Accept references or force direct serialization (using serialize_to)
private fun serialize_to_pure_json(v: JsonSerializer)

core :: Collection :: serialize_to_pure_json

Utility to serialize a normal Json array
intern fun sys: Sys

core :: Object :: sys

Return the global sys object, the only instance of the Sys class.
fun to_a: Array[E]

core :: Collection :: to_a

Build a new array from a collection
abstract fun to_concurrent: CONCURRENT

core :: Collection :: to_concurrent

Wraps self in a thread-safe collection
fun to_counter: Counter[E]

core :: Collection :: to_counter

Create and fill up a counter with the elements of `self.
fun to_curlslist: CURLSList

core :: Collection :: to_curlslist

Convert Collection[String] to CURLSList
fun to_json: String

serialization :: Serializable :: to_json

Serialize self to plain JSON
abstract fun to_jvalue(env: JniEnv): JValue

core :: Object :: to_jvalue

fun to_pretty_json: String

serialization :: Serializable :: to_pretty_json

Serialize self to plain pretty JSON
fun to_s: String

core :: Object :: to_s

User readable representation of self.
fun to_shuffle: Array[E]

core :: Collection :: to_shuffle

Return a new array made of elements in a random order.
package_diagram neo4j::SequentialNodeCollection SequentialNodeCollection neo4j::NeoNodeCollection NeoNodeCollection neo4j::SequentialNodeCollection->neo4j::NeoNodeCollection core::SimpleCollection SimpleCollection neo4j::NeoNodeCollection->core::SimpleCollection ...core::SimpleCollection ... ...core::SimpleCollection->core::SimpleCollection

Ancestors

interface Collection[E: nullable Object]

core :: Collection

The root of the collection hierarchy.
interface Object

core :: Object

The root of the class hierarchy.
interface RemovableCollection[E: nullable Object]

core :: RemovableCollection

Items can be removed from this collection
interface Serializable

serialization :: Serializable

Instances of this class can be passed to Serializer::serialize
interface SimpleCollection[E: nullable Object]

core :: SimpleCollection

Items can be added to these collections.

Parents

abstract class NeoNodeCollection

neo4j :: NeoNodeCollection

All the nodes in a NeoGraph.

Class definitions

neo4j $ SequentialNodeCollection
# A Neo4j node collection using a sequential identification scheme.
#
# The local IDs are sequential numbers (integers) starting at `1`.
#
# Note: When loading nodes, the local IDs should forms a mostly contiguous
# range starting at `1`. Else, this collection will consume a lot of memory.
# Futhermore, the local IDs **must** be positive.
#
# ~~~nit
# var nodes = new SequentialNodeCollection("id")
# var a = nodes.create_node
# var b = new NeoNode
# var c = new NeoNode
#
# nodes.register b
# c["id"] = 4
# nodes.add c
# assert a["id"] == 1
# assert b["id"] == 2
# assert c["id"] == 4
# assert nodes.to_a == [a, b, c]
# assert nodes.length == 3
#
# nodes.compact
# assert a["id"] == 1
# assert b["id"] == 2
# assert c["id"] == 3
# assert nodes.to_a == [a, b, c]
# assert nodes.length == 3
# ~~~
class SequentialNodeCollection
	super NeoNodeCollection

	redef type ID_TYPE: Int

	private var nodes = new Array[nullable NeoNode]

	redef var length = 0

	redef fun iterator do return new NullSkipper[NeoNode](self.nodes.iterator)

	redef fun [](id) do return nodes[id].as(NeoNode)

	redef fun get_or_null(id) do
		if id < 0 or id > nodes.length then return null
		return nodes[id]
	end

	redef fun has_id(id) do
		return id >= 0 and id < nodes.length and nodes[id] isa NeoNode
	end

	redef fun enlarge(cap) do nodes.enlarge(cap)

	redef fun register(node) do
		nodes.add node
		id_of(node) = nodes.length
		length += 1
	end

	redef fun add(node) do
		var id = node[id_property]
		assert id isa Int else
			sys.stderr.write "The local ID must be an `Int`.\n"
		end
		assert id >= 0 else
			sys.stderr.write "The local ID must be greater or equal to 0. Got {id}.\n"
		end
		# Pad with nulls.
		nodes.enlarge(id)
		var delta = id - nodes.length
		while delta > 0 do
			nodes.add null
			delta -= 1
		end
		nodes[id] = node
		length += 1
	end

	redef fun remove_at(id) do
		nodes[id] = null
		length -= 1
	end

	redef fun clear do
		nodes.clear
		length = 0
	end

	redef fun compact do
		var i = iterator

		nodes = new Array[nullable NeoNode]
		for n in i do
			nodes.add n
			id_of(n) = nodes.length
		end
	end
end
lib/neo4j/graph/sequential_id.nit:18,1--116,3