diff -r 000000000000 -r 6474c204b198 security/manager/boot/src/nsSecurityHeaderParser.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/security/manager/boot/src/nsSecurityHeaderParser.h Wed Dec 31 06:09:35 2014 +0100 @@ -0,0 +1,74 @@ +/* This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ + +#ifndef nsSecurityHeaderParser_h__ +#define nsSecurityHeaderParser_h__ + +#include "nsString.h" +#include "mozilla/LinkedList.h" +#include "nsCOMPtr.h" + +// Utility class for handing back parsed directives and (optional) values +class nsSecurityHeaderDirective : public mozilla::LinkedListElement { +public: + nsAutoCString mName; + nsAutoCString mValue; +}; + +// This class parses security-related HTTP headers like +// Strict-Transport-Security. The Augmented Backus-Naur Form syntax for this +// header is reproduced below, for reference: +// +// Strict-Transport-Security = "Strict-Transport-Security" ":" +// [ directive ] *( ";" [ directive ] ) +// +// directive = directive-name [ "=" directive-value ] +// directive-name = token +// directive-value = token | quoted-string +// +// where: +// +// token = +// quoted-string = / +// +// For further reference, see [RFC6797], Section 6.1 + +class nsSecurityHeaderParser { +public: + explicit nsSecurityHeaderParser(const char *aHeader); + ~nsSecurityHeaderParser(); + + // Only call Parse once. + nsresult Parse(); + // The caller does not take ownership of the memory returned here. + mozilla::LinkedList *GetDirectives(); + +private: + bool Accept(char aChr); + bool Accept(bool (*aClassifier) (signed char)); + void Expect(char aChr); + void Advance(); + void Header(); // header = [ directive ] *( ";" [ directive ] ) + void Directive(); // directive = directive-name [ "=" directive-value ] + void DirectiveName(); // directive-name = token + void DirectiveValue(); // directive-value = token | quoted-string + void Token(); // token = 1* + void QuotedString(); // quoted-string = (<"> *( qdtext | quoted-pair ) <">) + void QuotedText(); // qdtext = and "\"> + void QuotedPair(); // quoted-pair = "\" CHAR + + // LWS = [CRLF] 1*( SP | HT ) + void LWSMultiple(); // Handles *( LWS ) + void LWSCRLF(); // Handles the [CRLF] part of LWS + void LWS(); // Handles the 1*( SP | HT ) part of LWS + + mozilla::LinkedList mDirectives; + const char *mCursor; + nsSecurityHeaderDirective *mDirective; + + nsAutoCString mOutput; + bool mError; +}; + +#endif /* nsSecurityHeaderParser_h__ */