Package anbxj

Class Crypto_SealedObject

java.lang.Object

anbxj.Crypto_SealedObject

All Implemented Interfaces:

Serializable

public class Crypto_SealedObject
extends Object
implements Serializable

Universal sealed (encrypted) container that replaces Crypto_SealedPair in generated code.

Internally the encrypted key, encrypted message and cipher scheme are stored as raw byte arrays - the natural format for Protocol Buffers. Custom Java serialisation guarantees that the wire format is identical to Crypto_SealedPair, making the class compatible with older AnBxJ versions.

See Also:

• Crypto_SealedPair
• AnBx_WireFormats.SealedMessage
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
Crypto_SealedObject(byte[] encryptedKey, byte[] encryptedMessage, String cipherScheme)	Constructs a new Crypto_SealedObject from raw fields.
Crypto_SealedObject(Crypto_SealedPair pair)	Constructs a new Crypto_SealedObject from an existing Crypto_SealedPair (JavaSer compatibility).

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)
static Crypto_SealedObject	fromProtobufSealed(AnBx_WireFormats.SealedMessage msg)	Reconstructs a Crypto_SealedObject from a Protobuf AnBx_WireFormats.SealedMessage.
String	getCipherScheme()	Returns the cipher scheme string.
byte[]	getEncryptedKey()	Returns a copy of the encrypted key bytes, or null if no key was transported.
byte[]	getEncryptedMessage()	Returns a copy of the encrypted message bytes.
int	hashCode()
byte[]	toByteArray()	Produces a deterministic byte array that can be parsed by AnBx_WireFormats.SealedMessage.parseFrom(byte[]).
static AnBx_WireFormats.SealedMessage	toProtobufSealed(Crypto_SealedObject obj)	Converts a Crypto_SealedObject to its Protobuf AnBx_WireFormats.SealedMessage representation.
AnBx_WireFormats.SealedMessage	toSealedMessage()	Converts this container into a Protobuf-compatible AnBx_WireFormats.SealedMessage.
Crypto_SealedPair	toSealedPair()	Reconstructs an old-style Crypto_SealedPair from the raw fields stored in this object.
String	toString()

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

Crypto_SealedObject

public Crypto_SealedObject(Crypto_SealedPair pair)

Constructs a new Crypto_SealedObject from an existing Crypto_SealedPair (JavaSer compatibility).

The sealed key and sealed message inside the pair are serialised to byte arrays so that the object can be stored in a mode-independent way. The original pair is not retained; instead its fields are extracted into the raw byte representation that all serialisers can work with.

Parameters:

pair - the old-style sealed pair (must not be null)

Throws:

AnBx_LibraryException - if serialisation of the pair's fields fails

Crypto_SealedObject

public Crypto_SealedObject(byte[] encryptedKey,
 byte[] encryptedMessage,
 String cipherScheme)

Constructs a new Crypto_SealedObject from raw fields. This constructor is used when the object is created directly from protobuf fields (e.g. in ProtoBufNew or the new ProtoBuf serialiser).

Parameters:

encryptedKey - the encrypted symmetric key (may be null if no key transport is used)

encryptedMessage - the encrypted message payload

cipherScheme - the cipher scheme used (e.g. "AES/GCM/NoPadding")

Method Details

getEncryptedKey

public byte[] getEncryptedKey()

Returns a copy of the encrypted key bytes, or null if no key was transported.

Returns:

the encrypted key, or null

getEncryptedMessage

public byte[] getEncryptedMessage()

Returns a copy of the encrypted message bytes.

Returns:

the encrypted message

getCipherScheme

public String getCipherScheme()

Returns the cipher scheme string.

Returns:

the cipher scheme (never null)

toSealedPair

public Crypto_SealedPair toSealedPair()

Reconstructs an old-style Crypto_SealedPair from the raw fields stored in this object. This is used by the runtime when the serialiser is JavaSer and the engine expects a Crypto_SealedPair.

Returns:

the reconstructed Crypto_SealedPair

Throws:

AnBx_LibraryException - if deserialisation fails

toByteArray

public byte[] toByteArray()

Produces a deterministic byte array that can be parsed by AnBx_WireFormats.SealedMessage.parseFrom(byte[]).

The binary layout is identical to AnBx_WireFormats.SealedMessage.toByteArray().

Returns:

the serialised bytes (never null)

toSealedMessage

public AnBx_WireFormats.SealedMessage toSealedMessage()

Converts this container into a Protobuf-compatible AnBx_WireFormats.SealedMessage.

The returned message holds the same encrypted key, encrypted message and cipher scheme as this object. It can be used directly by the typed Protobuf serialiser.

Returns:

a new SealedMessage (never null)

toProtobufSealed

public static AnBx_WireFormats.SealedMessage toProtobufSealed(Crypto_SealedObject obj)

Converts a Crypto_SealedObject to its Protobuf AnBx_WireFormats.SealedMessage representation.

Parameters:

obj - the sealed object to convert

Returns:

the corresponding SealedMessage

fromProtobufSealed

public static Crypto_SealedObject fromProtobufSealed(AnBx_WireFormats.SealedMessage msg)

Reconstructs a Crypto_SealedObject from a Protobuf AnBx_WireFormats.SealedMessage.

Parameters:

msg - the Protobuf message

Returns:

the reconstructed container

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object