public interface DescriptorParser
Unlike most of the other descriptor sources this descriptor source does not operate in a batch-processing mode. It takes the raw descriptor contents of one or more descriptors, parses them, and returns a list of descriptors.
This descriptor source is internally used by other descriptor sources but can also be used directly by applications that obtain raw descriptor contents via other means than one of the existing descriptor sources.
Modifier and Type | Method and Description |
---|---|
java.util.List<Descriptor> |
parseDescriptors(byte[] rawDescriptorBytes,
java.lang.String fileName)
Parse descriptors in the given byte array, possibly parsing the
publication time from the file name, depending on the descriptor
type.
|
void |
setFailUnrecognizedDescriptorLines(boolean failUnrecognizedDescriptorLines)
Fail descriptor parsing when encountering an unrecognized line.
|
void setFailUnrecognizedDescriptorLines(boolean failUnrecognizedDescriptorLines)
This option is not set by default, because the Tor specifications allow for new lines to be added that shall be ignored by older Tor versions. But some applications may want to handle unrecognized descriptor lines explicitly.
java.util.List<Descriptor> parseDescriptors(byte[] rawDescriptorBytes, java.lang.String fileName) throws DescriptorParseException
DescriptorParseException