net.named_data.jndn.security.v2

Class DataValidationState

java.lang.Object

net.named_data.jndn.security.v2.ValidationState

net.named_data.jndn.security.v2.DataValidationState

public class DataValidationState
extends ValidationState

The DataValidationState class extends ValidationState to hold the validation state for a Data packet.

Constructor Summary

Constructors

Constructor and Description
DataValidationState(Data data, DataValidationSuccessCallback successCallback, DataValidationFailureCallback failureCallback) Create a DataValidationState for the Data packet.

Method Summary

Modifier and Type	Method and Description
void	bypassValidation_() Call the success callback of the original packet without signature validation.
void	fail(ValidationError error) Call the failure callback.
Data	getOriginalData() Get the original Data packet being validated which was given to the constructor.
void	verifyOriginalPacket_(CertificateV2 trustedCertificate) Verify the signature of the original packet.

Methods inherited from class net.named_data.jndn.security.v2.ValidationState

addCertificate, getCertificateChain_, getDepth, hasOutcome, hasSeenCertificateName, isOutcomeFailed, isOutcomeSuccess, setOutcome, verifyCertificateChain_

Methods inherited from class java.lang.Object

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

Constructor Detail

DataValidationState

public DataValidationState(Data data,
                           DataValidationSuccessCallback successCallback,
                           DataValidationFailureCallback failureCallback)

Create a DataValidationState for the Data packet. The caller must ensure that the state instance is valid until the validation finishes (i.e., until validateCertificateChain() and validateOriginalPacket() have been called).

Parameters:

data - The Data packet being validated, which is copied.

successCallback - This calls successCallback.successCallback(data) to report a successful Data validation.

failureCallback - This calls failureCallback.failureCallback(data, error) to report a failed Data validation, where error is a ValidationError.

Method Detail

fail

public void fail(ValidationError error)

Description copied from class: ValidationState

Call the failure callback.

Specified by:

fail in class ValidationState

getOriginalData

public final Data getOriginalData()

Get the original Data packet being validated which was given to the constructor.

Returns:

The original Data packet.

verifyOriginalPacket_

public void verifyOriginalPacket_(CertificateV2 trustedCertificate)

Description copied from class: ValidationState

Verify the signature of the original packet. This is only called by the Validator class.

Specified by:

verifyOriginalPacket_ in class ValidationState

Parameters:

trustedCertificate - The certificate that signs the original packet.

bypassValidation_

public void bypassValidation_()

Description copied from class: ValidationState

Call the success callback of the original packet without signature validation. This is only called by the Validator class.

Specified by:

bypassValidation_ in class ValidationState