org.eclipse.californium.scandium.dtls.pskstore

Class AsyncInMemoryPskStore

java.lang.Object

org.eclipse.californium.scandium.dtls.pskstore.AdvancedInMemoryPskStore

org.eclipse.californium.scandium.dtls.pskstore.AsyncInMemoryPskStore

All Implemented Interfaces:

AdvancedPskStore

Deprecated.

use AsyncAdvancedPskStore instead

@Deprecated
public class AsyncInMemoryPskStore
extends AdvancedInMemoryPskStore

Simple asynchronous test implementation of AdvancedPskStore. Use 0 or negative delays for test with synchronous blocking behaviour. And positive delays for test with asynchronous none-blocking behaviour.

Since:

2.3

Field Summary

Fields inherited from class org.eclipse.californium.scandium.dtls.pskstore.AdvancedInMemoryPskStore

MAC, pskStore

Constructor Summary

Constructors

Constructor and Description
AsyncInMemoryPskStore(PskStore pskStore) Deprecated. Create an advanced pskstore from PskStore.

Method Summary

Methods

Modifier and Type	Method and Description
int	getDelay() Deprecated. Get delay milliseconds.
PskSecretResult	requestPskSecretResult(ConnectionId cid, ServerNames serverNames, PskPublicInformation identity, String hmacAlgorithm, SecretKey otherSecret, byte[] seed) Deprecated. Request psk secret result.
AsyncInMemoryPskStore	setDelay(int delayMillis) Deprecated. Set delay milliseconds.
void	setResultHandler(PskSecretResultHandler resultHandler) Deprecated. Set the handler for asynchronous master secret results.
AsyncInMemoryPskStore	setSecretMode(boolean enableGenerateMasterSecret) Deprecated. Set secret mode.
void	shutdown() Deprecated. Shutdown.

Methods inherited from class org.eclipse.californium.scandium.dtls.pskstore.AdvancedInMemoryPskStore

generateMasterSecret, getIdentity, hasEcdhePskSupported

Methods inherited from class java.lang.Object

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

Constructor Detail

AsyncInMemoryPskStore

public AsyncInMemoryPskStore(PskStore pskStore)

Deprecated.

Create an advanced pskstore from PskStore. A call to shutdown() is required to cleanup the used resources (executor).

Parameters:

pskStore - psk store

Throws:

NullPointerException - if store is null

Method Detail

setSecretMode

public AsyncInMemoryPskStore setSecretMode(boolean enableGenerateMasterSecret)

Deprecated.

Set secret mode.

Parameters:

enableGenerateMasterSecret - true to return generated master secret, false for PSK secret key.

Returns:

this psk store for command chaining

setDelay

public AsyncInMemoryPskStore setDelay(int delayMillis)

Deprecated.

Set delay milliseconds.

Parameters:

delayMillis - delay in milliseconds to report result. 0 or negative delays using synchronous blocking behaviour. Positive delays using asynchronous none-blocking behaviour.

Returns:

this psk store for command chaining

getDelay

public int getDelay()

Deprecated.

Get delay milliseconds.

Returns:

delay milliseconds. 0 or negative delays using synchronous blocking behaviour. Positive delays using asynchronous none-blocking behaviour.

Since:

2.5

shutdown

public void shutdown()

Deprecated.

Shutdown. Cleanup resources.

requestPskSecretResult

public PskSecretResult requestPskSecretResult(ConnectionId cid,
                                     ServerNames serverNames,
                                     PskPublicInformation identity,
                                     String hmacAlgorithm,
                                     SecretKey otherSecret,
                                     byte[] seed)

Deprecated.

Description copied from interface: AdvancedPskStore

Request psk secret result. Either return the result, or null and process the request asynchronously. The PskSecretResult must contain the CID, the normalized identity and master secret or PSK secret key, if available. If the result is not returned, it is passed asynchronously to the result handler, provided during DTLSConnector initialization by AdvancedPskStore.setResultHandler(PskSecretResultHandler).

Specified by:

requestPskSecretResult in interface AdvancedPskStore

Overrides:

requestPskSecretResult in class AdvancedInMemoryPskStore

Parameters:

cid - connection id for stateless asynchronous implementations.

serverNames - server names. Maybe null, if SNI is not enabled or not used by the client.

identity - psk identity. Maybe normalized, if identity is available in the store.

hmacAlgorithm - HMAC algorithm name for PRF.

otherSecret - other secret from ECDHE, or null. Must be cloned for asynchronous use. See RFC 5489, other secret

seed - seed for PRF.

Returns:

psk secret result, or null, if result is provided asynchronous.

setResultHandler

public void setResultHandler(PskSecretResultHandler resultHandler)

Deprecated.

Description copied from interface: AdvancedPskStore

Set the handler for asynchronous master secret results. Called during initialization of the DTLSConnector. Synchronous implementations may just ignore this using an empty implementation. Note: the type of the handler will change to HandshakeResultHandler with 3.0.

Specified by:

setResultHandler in interface AdvancedPskStore

Overrides:

setResultHandler in class AdvancedInMemoryPskStore

Parameters:

resultHandler - handler for asynchronous master secret results. This handler MUST NOT be called from the thread calling AdvancedPskStore.requestPskSecretResult(ConnectionId, ServerNames, PskPublicInformation, String, SecretKey, byte[]), instead just return the result there.