Enum Constant Detail

• NONE

  public static final Context.UriPart NONE

  Not in a URI.

• START

  public static final Context.UriPart START

  At the absolute beginning of a URI.

  At ^ in ^http://host/path?k=v#frag or ^foo/bar?a=1.

• MAYBE_VARIABLE_SCHEME

  public static final Context.UriPart MAYBE_VARIABLE_SCHEME

  After a print statement in the beginning of a URI, where it's still possible to be in the scheme.

  For example, after href="{$x}, it's hard to know what will happen. For example, if $x is "java" (a perfectly valid relative URI on its own), then "script:alert(1)" would execute as Javascript. But if $x is "java" followed by "/test.html", it's a relative URI.

  This state is kept until we see anything that's hard-coded that makes it clear that we've left the scheme context; while remaining in this state, print statements and colons are forbidden, since we don't want what looks like a relative URI to set the scheme.

• MAYBE_SCHEME

  public static final Context.UriPart MAYBE_SCHEME

  Still possibly in the scheme, though it could also be a relative path, but no print statements have been seen yet.

  For example, between carets in h^ttp^://host/path or f^oo^/bar.html.

  This is similar to MAYBE_VARIABLE_SCHEME in that print statements are forbidden; however, colons are allowed and transition to AUTHORITY_OR_PATH.

• AUTHORITY_OR_PATH

  public static final Context.UriPart AUTHORITY_OR_PATH

  In the scheme, authority, or path. Between ^s in h^ttp://host/path^?k=v#frag.

• QUERY

  public static final Context.UriPart QUERY

  In the query portion. Between ^s in http://host/path?^k=v^#frag

• FRAGMENT

  public static final Context.UriPart FRAGMENT

  In the fragment. After ^ in http://host/path?k=v#^frag

• UNKNOWN_PRE_FRAGMENT

  public static final Context.UriPart UNKNOWN_PRE_FRAGMENT

  Not NONE or FRAGMENT, but unknown. Used to join different contexts.

• UNKNOWN

  public static final Context.UriPart UNKNOWN

  Not NONE, but unknown. Used to join different contexts.

• DANGEROUS_SCHEME

  public static final Context.UriPart DANGEROUS_SCHEME

  A known-dangerous scheme where dynamic content is forbidden.

Method Detail

• values

  public static Context.UriPart[] values()

  Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

  for (Context.UriPart c : Context.UriPart.values())
      System.out.println(c);
  

  Returns:

  an array containing the constants of this enum type, in the order they are declared

• valueOf

  public static Context.UriPart valueOf(String name)

  Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

  Parameters:

  name - the name of the enum constant to be returned.

  Returns:

  the enum constant with the specified name

  Throws:

  IllegalArgumentException - if this enum type has no constant with the specified name

  NullPointerException - if the argument is null