Package-level declarations

Types

Link copied to clipboard

Allows CorDapps to provide custom serializers for classes that do not serialize successfully during a checkpoint. In this case, a proxy serializer can be written that implements this interface whose purpose is to move between unserializable types and an intermediate representation.

Link copied to clipboard
interface ClassWhitelist
Link copied to clipboard

Annotation indicating a constructor to be used to reconstruct instances of a class during deserialization.

Link copied to clipboard

Set of well known properties that may be set on a serialization context. This doesn't preclude others being set that aren't keyed on this enumeration, but for general use properties adding a well known key here is preferred.

Link copied to clipboard
annotation class CordaSerializable

This annotation is a marker to indicate that a class is permitted and intended to be serialized as part of Node messaging.

Link copied to clipboard
@Target(allowedTargets = [AnnotationTarget.CLASS])
annotation class CordaSerializationTransformEnumDefault(val new: String, val old: String)

This annotation is used to mark an enumerated type as having had a new constant appended to it. For each additional constant added a new annotation should be appended to the class. If more than one is required the wrapper annotation CordaSerializationTransformEnumDefaults should be used to encapsulate them

Link copied to clipboard

This annotation is used to mark an enumerated type as having had multiple members added, It acts as a container annotation for instances of CordaSerializationTransformEnumDefault, each of which details individual additions.

Link copied to clipboard
@Target(allowedTargets = [AnnotationTarget.CLASS])
annotation class CordaSerializationTransformRename(val to: String, val from: String)

This annotation is used to mark a class has having had a property element. It is used by the AMQP deserializer to allow instances with different versions of the class on their Class Path to successfully deserialize the object.

Link copied to clipboard

This annotation is used to mark a class as having had multiple elements renamed as a container annotation for instances of CordaSerializationTransformRename, each of which details an individual rename.

Link copied to clipboard

Implement this interface to add your own Serialization Scheme. This is an experimental feature. All methods in this class MUST be thread safe i.e. methods from the same instance of this class can be called in different threads simultaneously.

Link copied to clipboard
annotation class DeprecatedConstructorForDeserialization(val version: Int)

This annotation is a marker to indicate which secondary constructors should be considered, and in which order, for evolving objects during their deserialization.

Link copied to clipboard
Link copied to clipboard

Thrown during deserialization to indicate that an attachment needed to construct the WireTransaction is not found.

Link copied to clipboard
data class ObjectWithCompatibleContext<out T : Any>(val obj: T, val context: SerializationContext)
Link copied to clipboard

Used to annotate methods which expose calculated values that we want to be serialized for use by the class carpenter.

Link copied to clipboard

Parameters to serialization and deserialization.

Link copied to clipboard

Allows CorDapps to provide custom serializers for third party libraries where those libraries cannot be recompiled with the -parameters flag rendering their classes natively serializable by Corda. In this case a proxy serializer can be written that extends this type whose purpose is to move between those an unserializable types and an intermediate representation.

Link copied to clipboard

Global singletons to be used as defaults that are injected elsewhere (generally, in the node or in RPC client).

Link copied to clipboard
Link copied to clipboard
abstract class SerializationFactory

An abstraction for serializing and deserializing objects, with support for versioning of the wire format via a header / prefix in the bytes.

Link copied to clipboard
Link copied to clipboard

This is used to pass information into CustomSerializationScheme about how the object should be (de)serialized. This context can change depending on the specific circumstances in the node when (de)serialization occurs.

Link copied to clipboard

This represents a token in the serialized stream for an instance of a type that implements SerializeAsToken.

Link copied to clipboard

Provide a subclass of this via the java.util.ServiceLoader mechanism to be able to whitelist types for serialisation that you cannot otherwise annotate. The name of the class must appear in a text file on the classpath under the path META-INF/services/net.corda.core.serialization.SerializationWhitelist

Link copied to clipboard

This interface should be implemented by classes that want to substitute a token representation of themselves if they are serialized because they have a lot of internal state that does not serialize (well).

Link copied to clipboard

A context for mapping SerializationTokens to/from SerializeAsTokens.

Link copied to clipboard

A type safe wrapper around a byte array that contains a serialised object. You can call SerializedBytes.deserialize to get the original object back.

Link copied to clipboard

A class representing a SerializationToken for some object that is not serializable but can be looked up (when deserialized) via just the class name.

Link copied to clipboard

A base class for implementing large objects / components / services that need to serialize themselves to a string token to indicate which instance the token is a serialized form of.

Functions

Link copied to clipboard
inline fun <T : Any> Blob.deserialize(serializationFactory: SerializationFactory = SerializationFactory.defaultFactory, context: SerializationContext = serializationFactory.defaultContext): T

Convenience extension method for deserializing a JDBC Blob, utilising the defaults.

inline fun <T : Any> ByteArray.deserialize(serializationFactory: SerializationFactory = SerializationFactory.defaultFactory, context: SerializationContext = serializationFactory.defaultContext): T

Convenience extension method for deserializing a ByteArray, utilising the defaults.

inline fun <T : Any> SerializedBytes<T>.deserialize(serializationFactory: SerializationFactory = SerializationFactory.defaultFactory, context: SerializationContext = serializationFactory.defaultContext): T

Convenience extension method for deserializing SerializedBytes with type matching, utilising the defaults.

inline fun <T : Any> ByteSequence.deserialize(serializationFactory: SerializationFactory = SerializationFactory.defaultFactory, context: SerializationContext = serializationFactory.defaultContext): T

Convenience extension method for deserializing a ByteSequence, utilising the defaults.

Link copied to clipboard
inline fun <T : Any> ByteSequence.deserializeWithCompatibleContext(serializationFactory: SerializationFactory = SerializationFactory.defaultFactory, context: SerializationContext = serializationFactory.defaultContext): ObjectWithCompatibleContext<T>

Additionally returns SerializationContext which was used for encoding. It might be helpful to know SerializationContext to use the same encoding in the reply.

Link copied to clipboard
fun <T : Any> T.serialize(serializationFactory: SerializationFactory = SerializationFactory.defaultFactory, context: SerializationContext = serializationFactory.defaultContext): SerializedBytes<T>

Convenience extension method for serializing an object of type T, utilising the defaults.

Link copied to clipboard

Helper method to return a new context based on this context with the given list of classes specifically whitelisted.