Module org.apache.jena.core
Package org.apache.jena.util

Class URIref

java.lang.Object
org.apache.jena.util.URIref
public class URIref extends Object
This class provides methods to encode and decode URI References in accordance with http://www.w3.org/TR/charmod/#sec-URIs . The details of how the algorithms handle '%' are captured in http://lists.w3.org/Archives/Public/uri/2001Sep/0009.html

  • Constructor Summary

    Constructors
    Constructor
    Description
    URIref()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    static String
    decode(String uri)
    Convert a URI, in US-ASCII, with escaped characters taken from UTF-8, to the corresponding Unicode string.
    static String
    encode(String unicode)
    Convert a Unicode string, first to UTF-8 and then to an RFC 2396 compliant URI with optional fragment identifier using %NN escape mechanism as appropriate.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • URIref

      public URIref()

  • Method Details

    • encode

      public static String encode(String unicode)
      Convert a Unicode string, first to UTF-8 and then to an RFC 2396 compliant URI with optional fragment identifier using %NN escape mechanism as appropriate. The '%' character is assumed to already indicated an escape byte. The '%' character must be followed by two hexadecimal digits.
      Parameters:
      unicode - The uri, in characters specified by RFC 2396 + '#'
      Returns:
      The corresponding Unicode String

    • decode

      public static String decode(String uri)
      Convert a URI, in US-ASCII, with escaped characters taken from UTF-8, to the corresponding Unicode string. On ill-formed input the results are undefined, specifically if the unescaped version is not a UTF-8 String, some String will be returned. Escaped '%' characters (i.e. "%25") are left unchanged.
      Parameters:
      uri - The uri, in characters specified by RFC 2396 + '#'.
      Returns:
      The corresponding Unicode String.
      Throws:
      IllegalArgumentException - If a % hex sequence is ill-formed.