net.named_data.jndn.security.v2

Class InterestValidationState

java.lang.Object

net.named_data.jndn.security.v2.ValidationState

net.named_data.jndn.security.v2.InterestValidationState

public class InterestValidationState
extends ValidationState

The InterestValidationState class extends ValidationState to hold the validation state for an Interest packet.

Constructor Summary

Constructors

Constructor and Description
InterestValidationState(Interest interest, InterestValidationSuccessCallback successCallback, InterestValidationFailureCallback failureCallback) Create an InterestValidationState for the Data packet.

Method Summary

Modifier and Type	Method and Description
void	addSuccessCallback(InterestValidationSuccessCallback successCallback)
void	bypassValidation_() Call the success callback of the original packet without signature validation.
void	fail(ValidationError error) Call the failure callback.
Interest	getOriginalInterest() Get the original Interest 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

InterestValidationState

public InterestValidationState(Interest interest,
                               InterestValidationSuccessCallback successCallback,
                               InterestValidationFailureCallback failureCallback)

Create an InterestValidationState 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:

interest - The Interest packet being validated, which is copied.

successCallback - This calls successCallback.successCallback(interest) to report a successful Interest validation.

failureCallback - This calls failureCallback.failureCallback(interest, error) to report a failed Interest 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

getOriginalInterest

public final Interest getOriginalInterest()

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

Returns:

The original Interest packet.

addSuccessCallback

public final void addSuccessCallback(InterestValidationSuccessCallback successCallback)

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