Used for serialization

This ctor is never public, used with __ctor__injectID

Initializes a new instance of the Parcel TPayload  class

Initializes a new instance of the Parcel TPayload  class

Internal framework method, developers: never call

Duplicates this parcel by doing a complete deep-clone of its state via serialization. This method is useful for making copies of the same parcel for different threads as it is thread-safe while no other thread mutates the instance, however Parcel instances are NOT THREAD-SAFE for parallel changes. The existing parcel MUST be SEALED (otherwise it can not be serialized). This method is also used before a call to Open() if parcel needs to be "un-opened" the cloned instance may be reverted to

Override this method to do actual destructor work

Deterministically disposes object. DO NOT OVERRIDE this method, override Destructor() instead

Override to merge other parcels into this one. Return true if merge changed the payload. See Merge(). This implementation throws an exception

Override to perform actions when parcel is unsealed (opened) for modification

Override to seal the parcel instance, i.e. generate some calculated fields. The version information is already generated by the time this method is called

Override to perform parcel/payload validation after modification. Add validation exceptions into m_ValidationExceptions field. Use bank for cross-checks (i.e. may run queries to check consistency)

Checks to see whether object dispose started or has already been disposed and throws an exception if Dispose() was called

Tests for parcel equality based on the same type and GDID value

Generates hash code based on parcel type and GDID value

Gets the Type of the current instance.

Creates a shallow copy of the current Object.

Merges other parcel instances into this one. A parcel type may support merging (when DataParcel attribute SupportsMerge is set to true) of data from other parcels/versions into this instance. This parcel must not be sealed as merge may change the payload in which case TRUE is returned. The parcel needs to be sealed again after the change. If a call to this method returns false, then nothing was changed as this instance already contains the latest data/could not be merged. Merging is used for version conflict resolution: servers check if the type of the updated parcel instance SupportsMerge, then if it does, Opens parcel and calls this method passing other versions in question to this method. The framework does not impose a limit on the supplied parcel types, however most of the parcel types support merge only with the same-typed parcel instances. IMPORTANT: The ordering of parcel versions is not guaranteed.

Opens parcel for modification. Parcel must be in the Sealed state for this call and must not be ReadOnly. Once open for modification, a parcel can not be "UnOpened", only Seal()-ed. This is because there is no way to track whether some part of payload object has changed by the calling code. Use DeepClone() before calling Open to retain a copy of Sealed parcel to revert to the cloned instance instead

Seal parcel after modification May call this method on parcels in either Creating or Modifying states. Bank is used to create the ReplicationVersionInfo which is depends on store/bank implementation. Parcels can replicate only within stores/technologies that have sealed them

Performs validation of the data. Does not throw but populates validation exceptions if data is not valid. Bank context may be used to run sub-queries during consistency/crosschecks May call this method on parcels in either Creating or Modifying states

Try to convert .NET native object type to corresponding Erlang term. Throw exception if conversion is not possible

Try to convert .NET native object type to corresponding Erlang term of given type. Throw exception if conversion is not possible

Serializes object into JSON string

Serializes object into JSON format using provided TextWriter

Serializes object into JSON format using provided stream and optional encoding

Implements IParcelCachePolicy contract. The default implementation returns null. Override to supply a different absolute cache expiration UTC timestamp for this parcel that may depend on particular parcel payload state (i.e. field values).

Implements IParcelCachePolicy contract. The default implementation returns null. Override to supply a relative cache priority of this parcel that may depend on particular parcel payload state (i.e. field values).

Implements IParcelCachePolicy contract. The default implementation returns null. Override to supply a value for maximum validity span of cached parcel that may depend on particular parcel payload state (i.e. field values). This property may be used to obtain a value before parcel is re-read from the store

Implements IParcelCachePolicy contract. The default implementation returns null. Override to supply a value for maximum length of this isntance stay in cache that may depend on particular parcel payload state (i.e. field values)

Indicates whether this object was already disposed - the Dispose() has finished

Indicates whether this object Dispose() has been called and dispose started but not finished yet

Returns effective cache policy the one that is calculated from attribute and overidden by the instance

Returns GDID for data that this parcel represents

Returns DataParcelAttribute that describes this parcel. Every parcel MUST be decorated by the DataParcel attribute

Returns true when parcel was just sealed after a call to Open or .ctor/create. Datastore may check this flag and disallow saving of parcel instances that have not changed

Returns payload of this parcel. May be null for deleted parcels (VersionDeleted)

Indicates whether the data may be altered. ReadOnly parcels can not be Opened after that have been Sealed by their creator

Returns replication priority, override to make replication priority dependent on instance, i.e. a user profile data for a celebrity user may need to have higher replication rate. The lower value indicates the higher priority

Implements IReplicatable interface

Returns the ShardingID used for sharding, default implementation returns this parcel type and GDID. Override to return another sharding key, i.e. a social comment msg may use parent item (that the msg relates to) ID as the shard key so msgs are co-located with related items. Use CompositeShardingID to return multiple values. IMPORTANT!!! ShardingID must return an immutable value, the one that CAN NOT be changed during parcel payload life

Returns the ShardingPointer(type:ID) used for sharding, default implementation returns this parcel type and GDID. Override ShardingID property to return another sharding key, i.e. a social comment msg may use parent item (that the msg relates to) ID as the shard key so msgs are co-located with related items. Use CompositeShardingID to return multiple values. IMPORTANT!!! ShardingPointer must return an immutable value, the one that CAN NOT be changed during parcel payload life

Returns the state of the parcel: Creating|Modifying|Sealed

Returns validation exceptions - populated by a call to Validate

Implements IParcelCachePolicy contract. The implementation returns null for parcel.