Package org.ldaptive.asn1
Class DERParser
- java.lang.Object
-
- org.ldaptive.asn1.DERParser
-
public class DERParser extends java.lang.Object
This class provides a SAX-like parsing facility for DER-encoded data where elements of interest in the parse tree may be registered to handlers via theregisterHandler(org.ldaptive.asn1.DERPath, org.ldaptive.asn1.ParseHandler)
methods.DERPath
strings are used to map handlers to elements of interest.- Author:
- Middleware Services
- See Also:
DERPath
-
-
Field Summary
Fields Modifier and Type Field Description protected org.slf4j.Logger
logger
Logger for this class.
-
Constructor Summary
Constructors Constructor Description DERParser()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
parse(DERBuffer encoded)
Parse a DER-encoded data structure by calling registered handlers when points of interest are encountered in the parse tree.int
readLength(DERBuffer encoded)
Reads the length of a DER-encoded value from the given byte buffer.DERTag
readTag(DERBuffer encoded)
Reads a DER tag from a single byte at the current position of the given buffer.void
registerHandler(DERPath path, ParseHandler handler)
Registers the supplied handler to fire when the supplied path is encountered.
-
-
-
Method Detail
-
registerHandler
public void registerHandler(DERPath path, ParseHandler handler)
Registers the supplied handler to fire when the supplied path is encountered.- Parameters:
path
- to registerhandler
- to associate with the path
-
parse
public void parse(DERBuffer encoded)
Parse a DER-encoded data structure by calling registered handlers when points of interest are encountered in the parse tree.- Parameters:
encoded
- DER-encoded bytes.
-
readTag
public DERTag readTag(DERBuffer encoded)
Reads a DER tag from a single byte at the current position of the given buffer. The buffer position is naturally advanced one byte in this operation.- Parameters:
encoded
- Buffer containing DER-encoded bytes positioned at tag.- Returns:
- Tag or null if no universal tag or application-specific tag is known that matches the byte read in.
-
readLength
public int readLength(DERBuffer encoded)
Reads the length of a DER-encoded value from the given byte buffer. The buffer is expected to be positioned at the byte immediately following the tag byte, which is where the length byte(s) begin(s). Invocation of this method has two generally beneficial side effects:- Buffer is positioned at start of value bytes.
- Buffer limit is set to the end of value bytes.
- Parameters:
encoded
- buffer containing DER-encoded bytes positioned at start of length byte(s).- Returns:
- number of bytes occupied by tag value.
-
-