net.named_data.jndn.security.v2

Class DynamicTrustAnchorGroup

java.lang.Object

net.named_data.jndn.security.v2.TrustAnchorGroup

net.named_data.jndn.security.v2.DynamicTrustAnchorGroup

public class DynamicTrustAnchorGroup
extends TrustAnchorGroup

The DynamicTrustAnchorGroup class extends TrustAnchorGroup to implement a dynamic trust anchor group.

Field Summary

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

anchorNames_, certificates_

Constructor Summary

Constructors

Constructor and Description
DynamicTrustAnchorGroup(CertificateContainerInterface certificateContainer, String id, String path, double refreshPeriod, boolean isDirectory) Create a dynamic trust anchor group.

Method Summary

Modifier and Type	Method and Description
void	refresh() Request a certificate refresh.

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

getId, readCertificate, size

Methods inherited from class java.lang.Object

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

Constructor Detail

DynamicTrustAnchorGroup

public DynamicTrustAnchorGroup(CertificateContainerInterface certificateContainer,
                               String id,
                               String path,
                               double refreshPeriod,
                               boolean isDirectory)

Create a dynamic trust anchor group. This loads all the certificates from the path and will refresh certificates every refreshPeriod milliseconds. Note that refresh is not scheduled, but is performed upon each "find" operations. When isDirectory is false and the path doesn't point to a valid certificate (the file doesn't exist or the content is not a valid certificate), then the dynamic anchor group will be empty until the file gets created. If the file disappears or gets corrupted, the anchor group becomes empty. When isDirectory is true and the path doesn't point to a valid folder, the folder is empty, or it doesn't contain valid certificates, then the group will be empty until certificate files are placed in the folder. If the folder is removed, becomes empty, or no longer contains valid certificates, then the anchor group becomes empty. Upon refresh, the existing certificates are not changed.

Parameters:

certificateContainer - A certificate container into which trust anchors from the group will be added.

id - The group id.

path - The file path for trust anchor(s), which could be a directory or a file. If it is a directory, all the certificates in the directory will be loaded.

refreshPeriod - The refresh time in milliseconds for the anchors under path. This must be positive.

isDirectory - If true, then path is a directory. If false, it is a single file.

Throws:

IllegalArgumentException - If refreshPeriod is not positive.

Method Detail

refresh

public void refresh()

Request a certificate refresh.

Overrides:

refresh in class TrustAnchorGroup