Uniform Resource Identifier

Source: Wikipedia, the free encyclopedia.
(Redirected from
URI scheme
)
Uniform Resource Identifier
AbbreviationURI
Native name
RFC 3986
StatusActive
Year started2005
First publishedJanuary 2005 (2005-01)
OrganizationRFC
Authors
Roy Thomas Fielding; Larry Masinter
DomainWorld Wide Web
Websitehttps://datatracker.ietf.org/doc/html/rfc3986#section-1.1

A Uniform Resource Identifier (URI) is a unique sequence of characters that identifies an abstract or physical resource,

Friend of a Friend vocabulary
would each have an individual URI.

URIs which provide a means of locating and retrieving information resources on a network (either on the Internet or on another private network, such as a computer filesystem or an

Uniform Resource Locators (URLs). By that, URL is referred to the subset of URIs.[2] Other URIs provide only a unique name, without a means of locating or retrieving the resource or information about it; these are Uniform Resource Names
(URNs). The web technologies that use URIs are not limited to web browsers.

History

Conception

URIs and URLs have a shared history. In 1990, Tim Berners-Lee's proposals for hypertext implicitly introduced the idea of a URL as a short string representing a resource that is the target of a hyperlink.[4] At the time, people referred to it as a "hypertext name"[5] or "document name".

Over the next three and a half years, as the World Wide Web's core technologies of HTML, HTTP, and web browsers developed, a need to distinguish a string that provided an address for a resource from a string that merely named a resource emerged. Although not yet formally defined, the term Uniform Resource Locator came to represent the former, and the more contentious Uniform Resource Name came to represent the latter. In July 1992 Berners-Lee's report on the

BOF" mentions URLs (as Uniform Resource Locators), URNs (originally, as Unique Resource Numbers), and the need to charter a new working group.[6] In November 1992 the IETF "URI Working Group" met for the first time.[7]

During the debate over defining URLs and URNs, it became evident that the concepts embodied by the two terms were merely aspects of the fundamental, overarching, notion of resource identification. In June 1994, the

RFC 1630 attempted to summarize the syntaxes of URL schemes in use at the time. It acknowledged -- but did not standardize—the existence of relative URLs and fragment identifiers.[8]

Refinement

In December 1994,

RFC 1738 formally defined relative and absolute URLs, refined the general URL syntax, defined how to resolve relative URLs to absolute form, and better enumerated the URL schemes then in use.[9] The agreed definition and syntax of URNs had to wait until the publication of IETF RFC 2141[10]
in May 1997.

The publication of IETF RFC 2396

IETF
. The new RFC changed the meaning of "U" in "URI" to "Uniform" from "Universal".

In December 1999,

RFC 2732[13] provided a minor update to RFC 2396, allowing URIs to accommodate IPv6 addresses. A number of shortcomings discovered in the two specifications led to a community effort, coordinated by RFC 2396 co-author Roy Fielding, that culminated in the publication of IETF RFC 3986[14] in January 2005. While obsoleting the prior standard, it did not render the details of existing URL schemes obsolete; RFC 1738 continues to govern such schemes except where otherwise superseded. IETF RFC 2616[15]
for example, refines the http scheme. Simultaneously, the IETF published the content of RFC 3986 as the full standard STD 66, reflecting the establishment of the URI generic syntax as an official Internet protocol.

In 2001, the W3C's Technical Architecture Group (TAG) published a guide to

best practices and canonical URIs for publishing multiple versions of a given resource.[16]
For example, content might differ by language or by size to adjust for capacity or settings of the device used to access that content.

In August 2002, IETF

RFC 3305[17] pointed out that the term "URL" had, despite widespread public use, faded into near obsolescence, and serves only as a reminder that some URIs act as addresses by having schemes implying network accessibility, regardless of any such actual use. As URI-based standards such as Resource Description Framework
make evident, resource identification need not suggest the retrieval of resource representations over the Internet, nor need they imply network-based resources at all.

The Semantic Web uses the HTTP URI scheme to identify both documents and concepts for practical uses, a distinction which has caused confusion as to how to distinguish the two. The TAG published an e-mail in 2005 with a solution of the problem, which became known as the httpRange-14 resolution.[18] The W3C subsequently published an Interest Group Note titled Cool URIs for the Semantic Web, which explained the use of content negotiation and the HTTP 303 response code for redirections in more detail.[19]

Design

URLs and URNs

A

International Standard Book Number (ISBN) system, ISBN 0-486-27557-4 identifies a specific edition of Shakespeare's play Romeo and Juliet
. The URN for that edition would be urn:isbn:0-486-27557-4. However, it gives no information as to where to find a copy of that book.

A

Hypertext Transfer Protocol (http:) from a network host whose domain name is example.org. (In this case, HTTP usually implies it to be in the form of HTML
and related code. In practice, that is not necessarily the case, as HTTP allows specifying arbitrary formats in its header.)

A URN is analogous to a person's name, while a URL is analogous to their street address. In other words, a URN identifies an item and a URL provides a method for finding it.

Technical publications, especially standards produced by the

W3C Recommendation of 30 July 2001, which acknowledges the precedence of the term URI rather than endorsing any formal subdivision into URL and URN.

URL is a useful but informal concept: a URL is a type of URI that identifies a resource via a representation of its primary access mechanism (e.g., its network "location"), rather than by some other attributes it may have.[20]

As such, a URL is simply a URI that happens to point to a resource over a network.[a][21] However, in non-technical contexts and in software for the World Wide Web, the term "URL" remains widely used. Additionally, the term "web address" (which has no formal definition) often occurs in non-technical publications as a synonym for a URI that uses the http or https schemes. Such assumptions can lead to confusion, for example, in the case of XML namespaces that have a visual similarity to resolvable URIs.

Specifications produced by the WHATWG prefer URL over URI, and so newer HTML5 APIs use URL over URI.[22]

Standardize on the term URL. URI and IRI [Internationalized Resource Identifier] are just confusing. In practice a single algorithm is used for both so keeping them distinct is not helping anyone. URL also easily wins the search result popularity contest.[23]

While most URI schemes were originally designed to be used with a particular

protocol, and often have the same name, they are semantically different from protocols. For example, the scheme http is generally used for interacting with web resources using HTTP, but the scheme file
has no protocol.

Syntax

A URI has a scheme that refers to a specification for assigning identifiers within that scheme. As such, the URI syntax is a federated and extensible naming system wherein each scheme's specification may further restrict the syntax and semantics of identifiers using that scheme. The URI generic syntax is a superset of the syntax of all URI schemes. It was first defined in

RFC 3986, published in January 2005.[24]

A URI is composed from an allowed set of ASCII characters consisting of reserved characters (gen-delims: :, /, ?, #, [, ], and @; sub-delims: !, $, &, ', (, ), *, +, ,, ;, and =),[25] unreserved characters (uppercase and lowercase letters, decimal digits, -, ., _, and ~),[25] and the character %.[26] Syntax components and subcomponents are separated by delimiters from the reserved characters (only from generic reserved characters for components) and define identifying data represented as unreserved characters, reserved characters that do not act as delimiters in the component and subcomponent respectively,[27] and percent-encodings when the corresponding character is outside the allowed set or is being used as a delimiter of, or within, the component. A percent-encoding of an identifying data octet is a sequence of three characters, consisting of the character % followed by the two hexadecimal digits representing that octet's numeric value.[28]


The URI generic syntax consists of five components organized hierarchically in order of decreasing significance from left to right:[29]

URI = scheme ":" ["//" authority] path ["?" query] ["#" fragment]

A component is undefined if it has an associated delimiter and the delimiter does not appear in the URI; the scheme and path components are always defined.[30] A component is empty if it has no characters; the scheme component is always non-empty.[29]

The authority component consists of subcomponents:

authority = [userinfo "@"] host [":" port]

This is represented in a syntax diagram as:

URI syntax diagram

The URI comprises:

By convention, in http and https URIs, the last part of a path is named pathinfo and it is optional. It is composed by zero or more path segments that do not refer to an existing physical resource name (e.g. a file, an internal module program or an executable program) but to a logical part (e.g. a command or a qualifier part) that has to be passed separately to the first part of the path that identifies an executable module or program managed by a web server; this is often used to select dynamic content (a document, etc.) or to tailor it as requested (see also: CGI and PATH_INFO, etc.).
Example:
URI: "http://www.example.com/questions/3456/my-document"
where: "/questions" is the first part of the path (an executable module or program) and "/3456/my-document" is the second part of the path named pathinfo, which is passed to the executable module or program named "/questions" to select the requested document.
An http or https URI containing a pathinfo part without a query part may also be referred to as a 'clean URL' whose last part may be a 'slug'.
Query delimiter Example
Ampersand (&) key1=value1&key2=value2
Semicolon (;)[d] key1=value1;key2=value2

The scheme- or implementation-specific reserved character + may be used in the scheme, userinfo, host, path, query, and fragment, and the scheme- or implementation-specific reserved characters !, $, &, ', (, ), *, ,, ;, and = may be used in the userinfo, host, path, query, and fragment. Additionally, the generic reserved character : may be used in the userinfo, path, query and fragment, the generic reserved characters @ and / may be used in the path, query and fragment, and the generic reserved character ? may be used in the query and fragment.[36]

Example URIs

The following figure displays example URIs and their component parts.

          userinfo       host      port
          ┌──┴───┐ ┌──────┴──────┐ ┌┴┐
  https://[email protected]:123/forum/questions/?tag=networking&order=newest#top
  └─┬─┘   └─────────────┬────────────┘└───────┬───────┘ └────────────┬────────────┘ └┬┘
  scheme          authority                  path                  query           fragment

  ldap://[2001:db8::7]/c=GB?objectClass?one
  └┬─┘   └─────┬─────┘└─┬─┘ └──────┬──────┘
  scheme   authority   path      query

  mailto:[email protected]
  └─┬──┘ └────┬─────────────┘
  scheme     path

  news:comp.infosystems.www.servers.unix
  └┬─┘ └─────────────┬─────────────────┘
  scheme            path

  tel:+1-816-555-1212
  └┬┘ └──────┬──────┘
  scheme    path

  telnet://192.0.2.16:80/
  └─┬──┘   └─────┬─────┘
  scheme     authority  path

  urn:oasis:names:specification:docbook:dtd:xml:4.1.2
  └┬┘ └──────────────────────┬──────────────────────┘
  scheme                    path

DOIs (digital object identifiers) fit within the Handle System and fit within the URI system, as facilitated by appropriate syntax.

URI references

A URI reference is either a URI or a relative reference when it does not begin with a scheme component followed by a colon (:).[37] A path segment that contains a colon character (e.g., foo:bar) cannot be used as the first path segment of a relative reference if its path component does not begin with a slash (/), as it would be mistaken for a scheme component. Such a path segment must be preceded by a dot path segment (e.g., ./foo:bar).[38]

Web document markup languages frequently use URI references to point to other resources, such as external documents or specific portions of the same logical document:[39]

  • in HTML, the value of the src attribute of the img element provides a URI reference, as does the value of the href attribute of the a or link element;
  • in
    DTD
    is a fragmentless URI reference;
  • in XSLT, the value of the href attribute of the xsl:import element/instruction is a URI reference; likewise the first argument to the document() function.
https://example.com/path/resource.txt#fragment
//example.com/path/resource.txt
/path/resource.txt
path/resource.txt
../resource.txt
./resource.txt
resource.txt
#fragment

Resolution

Resolving a URI reference against a base URI results in a target URI. This implies that the base URI exists and is an absolute URI (a URI with no fragment component). The base URI can be obtained, in order of precedence, from:[40]

  • the reference URI itself if it is a URI;
  • the content of the representation;
  • the entity encapsulating the representation;
  • the URI used for the actual retrieval of the representation;
  • the context of the application.

Within a representation with a well defined base URI of

http://a/b/c/d;p?q

a relative reference is resolved to its target URI as follows:[41]

"g:h"     -> "g:h"
"g"       -> "http://a/b/c/g"
"./g"     -> "http://a/b/c/g"
"g/"      -> "http://a/b/c/g/"
"/g"      -> "http://a/g"
"//g"     -> "http://g"
"?y"      -> "http://a/b/c/d;p?y"
"g?y"     -> "http://a/b/c/g?y"
"#s"      -> "http://a/b/c/d;p?q#s"
"g#s"     -> "http://a/b/c/g#s"
"g?y#s"   -> "http://a/b/c/g?y#s"
";x"      -> "http://a/b/c/;x"
"g;x"     -> "http://a/b/c/g;x"
"g;x?y#s" -> "http://a/b/c/g;x?y#s"
""        -> "http://a/b/c/d;p?q"
"."       -> "http://a/b/c/"
"./"      -> "http://a/b/c/"
".."      -> "http://a/b/"
"../"     -> "http://a/b/"
"../g"    -> "http://a/b/g"
"../.."   -> "http://a/"
"../../"  -> "http://a/"
"../../g" -> "http://a/g"

URL munging

URL munging is a technique by which a command is appended to a URL, usually at the end, after a "?" token. It is commonly used in WebDAV as a mechanism of adding functionality to HTTP. In a versioning system, for example, to add a "checkout" command to a URL, it is written as http://editing.com/resource/file.php?command=checkout. It has the advantage of both being easy for CGI parsers and also acts as an intermediary between HTTP and underlying resource, in this case.[42]

Relation to XML namespaces

In XML, a namespace is an abstract domain to which a collection of element and attribute names can be assigned. The namespace name is a character string which must adhere to the generic URI syntax.[43] However, the name is generally not considered to be a URI,[44] because the URI specification bases the decision not only on lexical components, but also on their intended use. A namespace name does not necessarily imply any of the semantics of URI schemes; for example, a namespace name beginning with http: may have no connotation to the use of the HTTP.

Originally, the namespace name could match the syntax of any non-empty URI reference, but the use of relative URI references was deprecated by the W3C.[45] A separate W3C specification for namespaces in XML 1.1 permits Internationalized Resource Identifier (IRI) references to serve as the basis for namespace names in addition to URI references.[46]

See also

Notes

  1. ^ A report published in 2002 by a joint W3C/IETF working group aimed to normalize the divergent views held within the IETF and W3C over the relationship between the various 'UR*' terms and standards. While not published as a full standard by either organization, it has become the basis for the above common understanding and has informed many standards since then.
  2. RFC 2717, and are now defined by RFC 7595, published in June 2015.[31]
  3. ^ For URIs relating to resources on the World Wide Web, some web browsers allow .0 portions of dot-decimal notation to be dropped or raw integer IP addresses to be used.[33]
  4. RFC 1866 (obsoleted by RFC 2854) encourages CGI authors to support ';' in addition to '&'.[35]

References

  1. ^ Berners-Lee, Tim; Fielding, Roy T.; Masinter, Larry 2005, p. 1, "Abstract"
  2. ^ a b Berners-Lee, Tim; Fielding, Roy T.; Masinter, Larry 2005, p. 7; "1.1.2. Examples", "1.1.3. URI, URL, and URN"
  3. ^ Berners-Lee, Tim; Fielding, Roy T.; Masinter, Larry 2005, p. 5, "Resource: the term "resource" is used in a general sense for whatever might be identified by a URI"
  4. ^ Palmer, Sean. "The Early History of HTML". infomesh.net. Retrieved 2020-12-06.
  5. ^ "W3 Naming Schemes". www.w3.org. 1992. Retrieved 2020-12-06.
  6. ^ "Proceedings of the Twenty-Fourth Internet Engineering Task Force" (PDF). p. 193. Retrieved 2021-07-27.
  7. ^ "Proceedings of the Twenty-Fifth Internet Engineering Task Force" (PDF). p. 501. Retrieved 2021-07-27.
  8. doi:10.17487/RFC1630. Retrieved 2020-12-06. {{cite journal}}: Cite journal requires |journal= (help
    )
  9. . Retrieved 2020-12-06.
  10. . Retrieved 2020-12-06.
  11. . Retrieved 2020-12-06.
  12. ^ a b RFC 2396 (1998).
  13. . Retrieved 2020-12-06.
  14. . Retrieved 2020-12-06.
  15. . Retrieved 2020-12-06.
  16. ^ Raman, T.V. (2006-11-01). "On Linking Alternative Representations To Enable Discovery And Publishing". www.w3.org. Retrieved 2020-12-06.
  17. S2CID 45585271
    . Retrieved 2020-12-06.
  18. ^ Fielding, Roy (2005-06-18). "[httpRange-14] Resolved". lists.w3.org. Retrieved 2020-12-06.
  19. ^ Sauermann, Leo (December 2008). "Cool URIs for the Semantic Web". www.w3.org. Retrieved 2020-12-06.
  20. ^ URI Planning Interest Group, W3C/IETF (September 2001). "URIs, URLs, and URNs: Clarifications and Recommendations 1.0". www.w3.org. W3C/IETF. Retrieved 2020-12-08.{{cite web}}: CS1 maint: numeric names: authors list (link)
  21. ^ Joint W3C/IETF URI Planning Interest Group (2002).
  22. ^ "URL Standard: 6.3. URL APIs elsewhere".
  23. ^ "URL Standard: Goals".
  24. ^ Berners-Lee, Tim; Fielding, Roy T.; Masinter, Larry 2005, p. 46; "9. Acknowledgements"
  25. ^ a b Berners-Lee, Tim; Fielding, Roy T.; Masinter, Larry 2005, pp. 13–14; "2.2. Reserved Characters", "2.3. Unreserved Characters"
  26. ^ Berners-Lee, Tim; Fielding, Roy T.; Masinter, Larry 2005, pp. 12; "2.1. Percent-Encoding"
  27. ^ RFC 3986 (2005), §2.
  28. ^ RFC 3986 (2005), §2.1.
  29. ^ a b RFC 3986 (2005), §3.
  30. ^ RFC 3986 (2005), §5.2.1.
  31. ^ IETF (2015).
  32. ^ RFC 3986 (2005), §3.2.2.
  33. ^ Lawrence (2014).
  34. ^ RFC 2396 (1998), §3.3.
  35. ^ RFC 1866 (1995), §8.2.1.
  36. ^ RFC 3986 (2005), §A.
  37. ^ RFC 3986 (2005), §4.1.
  38. ^ RFC 3986 (2005), §4.2.
  39. ^ RFC 3986 (2005), §4.4.
  40. ^ RFC 3986 (2005), §5.1.
  41. ^ RFC 3986 (2005), §5.4.
  42. ^ Whitehead 1998, p. 38.
  43. ^ Morrison (2006).
  44. ^ Harold (2004).
  45. ^ W3C (2009).
  46. ^ W3C (2006).

Works cited

Further reading

External links