net.named_data.jndn.security.v2

Class ValidationPolicyCommandInterest

java.lang.Object

net.named_data.jndn.security.v2.ValidationPolicy

net.named_data.jndn.security.v2.ValidationPolicyCommandInterest

public class ValidationPolicyCommandInterest
extends ValidationPolicy

ValidationPolicyCommandInterest extends ValidationPolicy as a policy for stop-and-wait command Interests. See: https://redmine.named-data.net/projects/ndn-cxx/wiki/CommandInterest This policy checks the timestamp field of a stop-and-wait command Interest. Signed Interest validation and Data validation requests are delegated to an inner policy.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ValidationPolicyCommandInterest.Options

Nested classes/interfaces inherited from class net.named_data.jndn.security.v2.ValidationPolicy

ValidationPolicy.ValidationContinuation

Field Summary

Fields inherited from class net.named_data.jndn.security.v2.ValidationPolicy

innerPolicy_, validator_

Constructor Summary

Constructors

Constructor and Description
ValidationPolicyCommandInterest(ValidationPolicy innerPolicy) Create a ValidationPolicyCommandInterest with default Options.
ValidationPolicyCommandInterest(ValidationPolicy innerPolicy, ValidationPolicyCommandInterest.Options options) Create a ValidationPolicyCommandInterest.

Method Summary

Modifier and Type	Method and Description
void	checkPolicy(Data data, ValidationState state, ValidationPolicy.ValidationContinuation continueValidation) Check the Data packet against the policy.
void	checkPolicy(Interest interest, ValidationState state, ValidationPolicy.ValidationContinuation continueValidation) Check the Interest against the policy.
void	setNowOffsetMilliseconds_(double nowOffsetMilliseconds) Set the offset when insertNewRecord() and cleanUp() get the current time, which should only be used for testing.

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

checkCertificatePolicy, getInnerPolicy, getKeyLocatorName, getKeyLocatorName, getValidator_, hasInnerPolicy, setInnerPolicy, setValidator

Methods inherited from class java.lang.Object

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

Constructor Detail

ValidationPolicyCommandInterest

public ValidationPolicyCommandInterest(ValidationPolicy innerPolicy,
                                       ValidationPolicyCommandInterest.Options options)

Create a ValidationPolicyCommandInterest.

Parameters:

innerPolicy - a ValidationPolicy for signed Interest signature validation and Data validation. This must not be null.

options - The stop-and-wait command Interest validation options.

Throws:

AssertionError - if innerPolicy is null.

ValidationPolicyCommandInterest

public ValidationPolicyCommandInterest(ValidationPolicy innerPolicy)

Create a ValidationPolicyCommandInterest with default Options.

Parameters:

innerPolicy - a ValidationPolicy for signed Interest signature validation and Data validation. This must not be null.

Throws:

AssertionError - if innerPolicy is null.

Method Detail

checkPolicy

public void checkPolicy(Data data,
                        ValidationState state,
                        ValidationPolicy.ValidationContinuation continueValidation)
                 throws CertificateV2.Error,
                        ValidatorConfigError

Description copied from class: ValidationPolicy

Check the Data packet against the policy. Your derived class must implement this. Depending on the implementation of the policy, this check can be done synchronously or asynchronously. The semantics of checkPolicy are as follows: If the packet violates the policy, then the policy should call state.fail() with an appropriate error code and error description. If the packet conforms to the policy and no further key retrievals are necessary, then the policy should call continueValidation.continueValidation(null, state). If the packet conforms to the policy and a key needs to be fetched, then the policy should call continueValidation.continueValidation({appropriate-key-request-instance}, state).

Specified by:

checkPolicy in class ValidationPolicy

Parameters:

data - The Data packet to check.

state - The ValidationState of this validation.

continueValidation - The policy should call continueValidation.continueValidation() as described above.

Throws:

CertificateV2.Error

ValidatorConfigError

checkPolicy

public void checkPolicy(Interest interest,
                        ValidationState state,
                        ValidationPolicy.ValidationContinuation continueValidation)
                 throws CertificateV2.Error,
                        ValidatorConfigError

Description copied from class: ValidationPolicy

Check the Interest against the policy. Your derived class must implement this. Depending on implementation of the policy, this check can be done synchronously or asynchronously. See the checkPolicy(Data) documentation for the semantics.

Specified by:

checkPolicy in class ValidationPolicy

Parameters:

interest - The Interest packet to check.

state - The ValidationState of this validation.

continueValidation - The policy should call continueValidation.continueValidation() as described above.

Throws:

CertificateV2.Error

ValidatorConfigError

setNowOffsetMilliseconds_

public final void setNowOffsetMilliseconds_(double nowOffsetMilliseconds)

Set the offset when insertNewRecord() and cleanUp() get the current time, which should only be used for testing.

Parameters:

nowOffsetMilliseconds - The offset in milliseconds.