Cache of sent objects

Used by Serializer to avoid duplicating objects, by serializing them once, then using a reference.

Introduced properties

fun has_object(object: Serializable): Bool

serialization :: SerializerCache :: has_object

Is object known?
fun id_for(object: Serializable): Int

serialization :: SerializerCache :: id_for

Get the id for object
fun new_id_for(object: Serializable): Int

serialization :: SerializerCache :: new_id_for

Get a new id for object and store it
protected fun next_available_id: Int

serialization :: SerializerCache :: next_available_id

Get a free id to associate to an object in the cache
protected fun sent: Map[Serializable, Int]

serialization :: SerializerCache :: sent

Map of already serialized objects to the reference id
protected fun sent=(sent: Map[Serializable, Int])

serialization :: SerializerCache :: sent=

Map of already serialized objects to the reference id

Redefined properties

redef type SELF: SerializerCache

serialization $ SerializerCache :: SELF

Type of this instance, automatically specialized in every class

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 SELF: Object

core :: Object :: SELF

Type of this instance, automatically specialized in every class
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.
fun get_class: CLASS

core :: Object :: get_class

The meta-object representing the dynamic type of self.
fun has_object(object: Serializable): Bool

serialization :: SerializerCache :: has_object

Is object known?
fun hash: Int

core :: Object :: hash

The hash code of the object.
fun id_for(object: Serializable): Int

serialization :: SerializerCache :: id_for

Get the id for object
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".
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.
fun new_id_for(object: Serializable): Int

serialization :: SerializerCache :: new_id_for

Get a new id for object and store it
protected fun next_available_id: Int

serialization :: SerializerCache :: next_available_id

Get a free id to associate to an object in the cache
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).
protected fun sent: Map[Serializable, Int]

serialization :: SerializerCache :: sent

Map of already serialized objects to the reference id
protected fun sent=(sent: Map[Serializable, Int])

serialization :: SerializerCache :: sent=

Map of already serialized objects to the reference id
fun serialization_hash: Int

core :: Object :: serialization_hash

Hash value use for serialization
intern fun sys: Sys

core :: Object :: sys

Return the global sys object, the only instance of the Sys class.
abstract fun to_jvalue(env: JniEnv): JValue

core :: Object :: to_jvalue

fun to_s: String

core :: Object :: to_s

User readable representation of self.
package_diagram serialization::SerializerCache SerializerCache core::Object Object serialization::SerializerCache->core::Object serialization::DuplexCache DuplexCache serialization::DuplexCache->serialization::SerializerCache serialization::AsyncCache AsyncCache serialization::AsyncCache->serialization::DuplexCache serialization::AsyncCache... ... serialization::AsyncCache...->serialization::AsyncCache

Parents

interface Object

core :: Object

The root of the class hierarchy.

Children

class DuplexCache

serialization :: DuplexCache

A shared cache for serialization and deserialization

Descendants

class AsyncCache

serialization :: AsyncCache

A shared cache where 2 clients serialize objects at the same types, prevents references collision

Class definitions

serialization $ SerializerCache
# Cache of sent objects
#
# Used by `Serializer` to avoid duplicating objects, by serializing them once,
# then using a reference.
class SerializerCache
	# Map of already serialized objects to the reference id
	protected var sent: Map[Serializable, Int] = new StrictHashMap[Serializable, Int]

	# Is `object` known?
	fun has_object(object: Serializable): Bool do return sent.keys.has(object)

	# Get the id for `object`
	#
	# Require: `has_object(object)`
	fun id_for(object: Serializable): Int
	do
		assert sent.keys.has(object)
		return sent[object]
	end

	# Get a new id for `object` and store it
	#
	# Require: `not has_object(object)`
	fun new_id_for(object: Serializable): Int
	do
		var id = next_available_id
		sent[object] = id
		return id
	end

	# Get a free id to associate to an object in the cache
	protected fun next_available_id: Int do return sent.length
end
lib/serialization/caching.nit:52,1--84,3