SerializationContext

UseCase

The use case that we are serializing for, since it influences the implementations chosen.

carpenterDisabled

If true, deserialization calls using this context will not fallback to using the Class Carpenter to attempt to construct classes present in the schema but not on the current classpath.

customSerializers

Additional custom serializers that will be made available during (de)serialization.

deserializationClassLoader

The class loader to use for deserialization.

encoding

If non-null, apply this encoding (typically compression) when serializing.

encodingWhitelist

A whitelist that determines (mostly for security purposes) whether a particular encoding may be used when deserializing.

lenientCarpenterEnabled

If true the carpenter will happily synthesis classes that implement interfaces containing methods that are not getters for any AMQP fields. Invoking these methods will throw an AbstractMethodError. If false then an exception will be thrown during deserialization instead.

objectReferencesEnabled

Duplicate references to the same object preserved in the wire format and when deserialized when this is true, otherwise they appear as new copies of the object.

preferredSerializationVersion

When serializing, use the format this header sequence represents.

preventDataLoss

If true the serialization evolver will fail if the binary to be deserialized contains more fields then the current object from the classpath.

properties

A map of any additional properties specific to the particular use case.

useCase

The use case we are serializing or deserializing for. See UseCase.

whitelist

A whitelist that contains (mostly for security purposes) which classes can be serialized and deserialized.

withAttachmentsClassLoader

Does not do anything.

withClassLoader

Helper method to return a new context based on this context with the deserialization class loader changed.

withCustomSerializers

Helper method to return a new context based on this context with the given serializers added.

withEncoding

A shallow copy of this context but with the given (possibly null) encoding.

withEncodingWhitelist

A shallow copy of this context but with the given encoding whitelist.

withLenientCarpenter

Return a new context based on this one but with a lenient carpenter.

withoutCarpenter

Returns a copy of the current context with carpentry of unknown classes disabled. On encountering such a class during deserialization the Serialization framework will throw a NotSerializableException.

withoutReferences

Helper method to return a new context based on this context with object references disabled.

withPreferredSerializationVersion

Helper method to return a new context based on this context but with serialization using the format this header sequence represents.

withPreventDataLoss

Return a new context based on this one but with a strict evolution.

withProperties

Helper method to return a new context based on this context with the extra properties added.

withProperty

Helper method to return a new context based on this context with the property added.

withWhitelisted

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

withWhitelist

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