Class KeyEncapsulationExchange

java.lang.Object

net.jrodolfo.java_evolution.java21.key_encapsulation.KeyEncapsulationExchange

public class KeyEncapsulationExchange
extends Object

Demonstrates the full Java 21 Key Encapsulation Mechanism API flow.

The example models a receiver, often called Bob, that owns a public/private key pair. A sender, often called Alice, uses Bob's public key to create a shared secret and an encapsulation message. Bob then uses his private key and the encapsulation message to recover the same shared secret.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	KeyEncapsulationExchange.KeyExchangeResult	Captures the observable result of the KEM exchange for tests and readers.

Constructor Summary

Constructors

Constructor	Description
KeyEncapsulationExchange()

Method Summary

Modifier and Type	Method	Description
KeyEncapsulationExchange.KeyExchangeResult	exchange()	Runs a complete in-memory KEM exchange.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

KeyEncapsulationExchange

public KeyEncapsulationExchange()

Method Details

exchange

public KeyEncapsulationExchange.KeyExchangeResult exchange()
                                                    throws NoSuchAlgorithmException,
InvalidKeyException,
DecapsulateException

Runs a complete in-memory KEM exchange.

Returns:

the sender and receiver secrets plus the encapsulation message

Throws:

NoSuchAlgorithmException - if X25519 or DHKEM is not available

InvalidKeyException - if the generated keys cannot be used for DHKEM

DecapsulateException - if the encapsulation cannot be decoded by the receiver