java.net
클래스 URI

java.lang.Object 
  |
  +--java.net.URI

모든 구현 인터페이스:

Comparable , Serializable

public final class URI

extends Object

implements Comparable , Serializable

URI (Uniform Resource Identifier) 참조를 나타냅니다.

이 클래스의 인스턴스는 「RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax」로 정의되어「RFC 2732: Format for Literal IPv6 Addresses in URLs」로 수정되어 아래와 같이로 설명하는 부분이 변경된 URI 참조를 나타냅니다. 이 클래스는 컴퍼넌트로부터 또는 캐릭터 라인 형식을 해석해 URI 인스턴스를 작성하기 위한 constructor , 인스턴스의 각종 컴퍼넌트에 액세스하기 위한 메소드, 및 URI 인스턴스를 정규화, 해결, 상대화하기 위한 메소드를 제공합니다. 이 클래스의 인스턴스는 변경할 수 없습니다.

URI 구문과 컴퍼넌트

최고정도 레벨의 캐릭터 라인 형식의 URI 참조 (이후는 단지 「URI」라고 한다)의 구문은 다음과 같습니다.

[schema:]schema 고유 부분[#fragment]

여기서, 꺽쇄묶음 [...] (은)는 옵션의 컴퍼넌트를 나타내,: 라고 # 는 그 캐릭터 자체를 나타냅니다.

「절대」URI 는 schema를 지정해, 절대가 아닌 URI 는 「상대」라고 불립니다. 또, URI 는 「불투명」일까 「계층적」일까에 의해 분류됩니다.

「불투명」URI 는 schema 고유 부분이 slash (/)로 시작되지 않는 절대 URI 입니다. 불투명 URI 는 그 이상 해석되지 않습니다. 불투명 URI 의 예를 다음에 나타냅니다.

mailto:java-net@java.sun.com
news:comp.lang.java
urn:isbn:096139210x

「계층」URI 는 schema 고유 부분이 slash로 시작되는 절대 URI, 또는 상대 URI (schema를 지정하지 않는 URI)입니다. 계층 URI 의 예를 다음에 나타냅니다.

http://java.sun.com/j2se/1. 3/
docs/guide/collections/designfaq.html#28
../../../demo/jfc/SwingSet2/src/SwingSet2.java
file:///~/calendar

계층 URI 는 구문에 따라 한층 더 해석됩니다.

[schema:][//권한][패스][? 쿠에리-][#fragment]

여기서,:,/,? , 및 # 은 그 캐릭터 자체를 나타냅니다. 계층 URI 의 schema 고유 부분은 schema와 fragment 컴퍼넌트의 사이의 캐릭터로 구성됩니다.

계층 URI 의 권한 컴퍼넌트가 지정되고 있는 경우, 그 권한 컴퍼넌트는 「서버 베이스」또는 「레지스트리 베이스」입니다. 서버 베이스 권한은 잘 알려져 있는 구문에 따라 해석됩니다.

[유저 정보@]호스트[:포토]

여기서,@ 라고 : 는 그 캐릭터 자체를 나타냅니다. 현재 사용되고 있는 URI schema의 대부분은 서버 베이스입니다. 이와 같이 해석되지 않는 권한 컴퍼넌트는 레지스트리 베이스라고 보여집니다.

계층 URI 의 파스콘포넨트는 slash (/)로 시작되는 경우는 절대로 불려 그렇지 않은 경우는 상대로 불립니다. 절대인 계층 URI 또는 권한을 지정하는 계층 URI 의 패스는 항상 절대입니다.

URI 인스턴스에는 전부 다음의 9 개의 컴퍼넌트가 있습니다.

컴퍼넌트	타입
schema	String
schema 고유 부분	String
권한	String
유저 정보	String
호스트	String
포토	int
패스	String
쿠에리-	String
fragment	String

지정된 인스턴스에서는 어느 특정의 컴퍼넌트도 「미정도리」인가 「정의가 끝난 상태」이며, 개별의 형태의 값을 가집니다. 미정도리의 캐릭터 라인 컴퍼넌트는 null 로 나타내져 정의 끝난 정수 컴퍼넌트는 -1 으로 나타내집니다. 캐릭터 라인 컴퍼넌트는 값으로 해서 하늘의 캐릭터 라인을 가지도록(듯이) 정의할 수 있습니다. 이것은 그 컴퍼넌트가 미정도리인 것으로 동등하지는 않습니다.

특정의 컴퍼넌트가 인스턴스로 정의빌려주어지지 않은가는 표현되는 URI 의 타입에 의해 다릅니다. 절대 URI 에는 schema 컴퍼넌트가 있습니다. 불투명 URI 에는 schema, schema 고유 부분, 및 아마 fragment가 있습니다만, 그 외의 컴퍼넌트는 없습니다. 계층 URI 에는 항상 패스 (다만 비었을 경우 있어) 및 schema 고유 부분 (적어도 패스를 포함한다)이 있어, 한층 더 그 외의 컴퍼넌트중 한쪽이 있는 경우가 있습니다. 권한 컴퍼넌트가 존재하고 있어 서버 베이스인 경우, 호스트 컴퍼넌트는 정의됩니다. 유저 정보와 포토 컴퍼넌트는 정의되는 경우도 있습니다.

URI 인스턴스의 조작

이 클래스에서 서포트되는 주요한 조작은 「정규화」, 「해결」, 및 「상대화」입니다.

「정규화」는 계층 URI 의 파스콘포넨트로부터 불필요한 「. 」 및 「..」세그먼트(segment)를 삭제하는 프로세스입니다. 각 「. 」세그먼트(segment)는 단지 삭제됩니다. 「..」세그먼트(segment)는 「..」이외의 세그먼트(segment)가 선행하는 경우에만 삭제됩니다. 정규화는 불투명 URI 에는 영향을 주지 않습니다.

「해결」은 어느 URI 를 다른 「베이스」URI 에 대해서 해결하는 프로세스입니다. 결과의 URI 는 RFC 2396 로 지정되고 있게, 양쪽 모두의 URI 의 컴퍼넌트로부터 구축되어 원의 URI 로 지정되어 있지 않은 컴퍼넌트를 위해서(때문에) 베이스 URI 로부터 컴퍼넌트를 수중에 넣습니다. 계층 URI 의 경우, 원의 패스는 베이스의 패스에 대해서 해결되어 정규화됩니다. 예를 들어, 다음과 같이 됩니다.

docs/guide/collections/designfaq.html#28 (1)

(을)를 베이스 URI http://java.sun.com/j2se/1. 3/ 에 대해서 해결하면(자), 결과의 URI 는 다음과 같이 됩니다.

http://java.sun.com/j2se/1. 3/docs/guide/collections/designfaq.html#28

상대 URI

../../../demo/jfc/SwingSet2/src/SwingSet2.java (2)

(을)를 이 결과에 대해서 해결하면(자), 다음과 같이 됩니다.

http://java.sun.com/j2se/1. 3/demo/jfc/SwingSet2/src/SwingSet2.java

절대와 상대의 양쪽 모두의 URI 의 해결, 및 계층 URI 의 경우는 절대와 상대의 양쪽 모두의 패스의 해결이 서포트됩니다. URI file:///~calendar 는 절대이므로, 이것을 다른 임의의 URI 에 대해서 해결하면(자), 원의 URI 가 생성될 뿐입니다. 상기의 상대 URI (2)를 상대 베이스 URI (1)에 대해서 해결하면(자), 정규화되고 있어도 상대 인 채의 URI 가 생성됩니다.

demo/jfc/SwingSet2/src/SwingSet2.java

마지막으로, 「상대화」는 해결의 역변환입니다. 임의의 2 개의 정규화된 URI,u 및 v 의 경우,

u. relativize(u. resolve(v)). equals(v) 및
u. resolve(u. relativize(v)). equals(v) 가 됩니다.

이 조작은 가능하면 어디서에서도, 문서의 베이스 URI 에 대해서 상대적이 아니면 안되는 URI 를 포함한 문서를 구축하는 경우에 편리합니다. 예를 들어, 다음의 URI

http://java.sun.com/j2se/1. 3/docs/guide/index.html

(을)를 다음의 베이스 URI 에 대해서 상대화하면(자),

http://java.sun.com/j2se/1. 3

상대 URI docs/guide/index.html 가 생성됩니다.

캐릭터 카테고리

URI 참조의 각종 컴퍼넌트로 허가되는 캐릭터는 RFC 2396 로 엄밀하게 지정되고 있습니다. 다음의 카테고리를 사용해, 이 제약에 대해 설명합니다. 이러한 카테고리의 대부분은 그 사양으로부터 놓치고 있습니다.

영문자	A 로부터 Z, 및 a 로부터 z 까지의 US-ASCII 영문자
숫자	0 로부터 9 까지의 US-ASCII 10 진수자
영숫자	모든 「영문자」 및 「숫자」캐릭터
미예약	모든 「영숫자」캐릭터, 및 캐릭터 라인 _-!.~'()* 안의 캐릭터
구두점	캐릭터 라인 ,;:$&+= 안의 캐릭터
예약	모든 「구두점」캐릭터, 및 캐릭터 라인 "? /[]@" 안의 캐릭터
이스케이프	이스케이프 octet. 즉, 퍼센트 캐릭터 (%)와 거기에 계속되는 2 자리수의 16 진수 (0 - 9,A - F, 및 a - f)로 구성되는 삼중항
그 외	US-ASCII 캐릭터 세트에 포함되지 않고 제어 캐릭터 (Character.isISOControl 멧소드에 의한다)가 아니고, 공백 캐릭터 (Character.isSpaceChar 메소드에 의한다)가 아닌 Unicode 캐릭터 (US-ASCII 로 한정되고 있는 RFC 2396 을 변경한 것)

「미예약」, 「예약」, 「이스케이프」, 및 「그 외」의 캐릭터로 구성되는 모든 유효한 URI 캐릭터세트

이스케이프 octet, 인용부호, encode, 및 복호화(decode)

RFC 2396 에서는 이스케이프 octet 를 유저 정보, 패스, 쿠에리-, 및 fragment의 각 컴퍼넌트에 표시할 수가 있습니다. 이스케이프는 다음의 2 개의 목적을 위해서(때문에) URI 로 사용됩니다.

• 「그 외」의 캐릭터를 사용하는 일 없이 URI 를 RFC 2396 에 엄밀하게 적합시킬 필요가 있는 경우에, 비 US-ASCII 캐릭터를 「encode」한다

• 그대로는 부정하게 되는 컴퍼넌트내의 캐릭터를 「인용부호로 둘러싼다」. 유저 정보, 패스, 쿠에리-, 및 fragment의 각 컴퍼넌트는 유효 또는 부정이라고 보여지는 캐릭터의 조건이 다소 다르다

이 클래스에서는 다음의 3 개의 관련하는 조작에 의해 이러한 목적이 수행됩니다.

• 캐릭터는 UTF-8 캐릭터 세트내의 그 캐릭터를 나타내는 이스케이프 octet 의 순차 순서로 옮겨놓아 「encode」된다. 예를 들어, 유로 통화 기호 ('\u20AC')는 %E2%82%AC 로서 encode 된다 (특정의 캐릭터 세트를 지정하지 않는 RFC 2396 를 변경한 것)

• 모든 부정한 캐릭터는 단지 encode 해 「인용부호로 위」. 예를 들어 공백 캐릭터는 %20 로 옮겨놓아 인용부호로 둘러싸인다. UTF-8 에는 US-ASCII 가 포함되므로, US-ASCII 캐릭터의 경우, 이 변환으로 RFC 2396 로 요구되는 효과를 정확하게 얻을 수 있다

• 이스케이프 octet 의 순차 순서는 그 순차 순서가 UTF-8 캐릭터 세트내에서 나타내는 캐릭터의 순차 순서로 옮겨놓을 수 있는 것으로, 「복호화(decode)」된다. UTF-8 에는 US-ASCII 가 포함되므로, 복호화(decode)에는 인용부호로 둘러싸인 모든 US-ASCII 캐릭터의 인용부호를 해제하는 효과와 encode 된 비 US-ASCII 캐릭터를 복호화(decode) 하는 효과가 있다. 이스케이프 octet 를 복호화(decode) 할 경우에 복호화(decode) 에러가 발생했을 경우, 부정한 octet 는 Unicode 의 치환 캐릭터 \uFFFD 로 옮겨놓을 수 있다

이러한 조작은 다음에 나타내도록(듯이), 이 클래스의 constructor 과 메소드로 공개됩니다.

• single-argument constructor 에서는 인수내의 부정한 캐릭터를 인용부호로 둘러쌀 필요가 있어, 존재하는 모든 이스케이프 octet 와 「그 외」의 캐릭터를 보존한다

• multi-argument constructors 는 부정한 캐릭터가 존재하는 컴퍼넌트의 요구에 의해 부정한 캐릭터를 인용부호로 둘러싼다. 퍼센트 캐릭터 (%)는 항상 이러한 constructor 에 의해 둘러싸인다. 「그 외」의 캐릭터는 보존된다

• getRawUserInfo ,getRawPath , getRawQuery ,getRawFragment , getRawAuthority , 및 getRawSchemeSpecificPart 메소드는 대응하는 컴퍼넌트의 값을 그대로의 형식에서 돌려주어, 이스케이프 octet 를 해석하지 않는다. 이러한 메소드로부터 돌려주어지는 캐릭터 라인에는 이스케이프 octet 와 「그 외」의 캐릭터의 양쪽 모두가 포함되어 있는 일이 있어, 부정한 캐릭터는 포함되지 않는다

• getUserInfo ,getPath ,getQuery ,getFragment ,getAuthority , 및 getSchemeSpecificPart 메소드는 대응하는 컴퍼넌트내의 모든 이스케이프 octet 를 복호화(decode) 한다. 이러한 메소드로부터 돌려주어지는 캐릭터 라인에는 「그 외」의 캐릭터와 부정한 캐릭터의 양쪽 모두가 포함되어 있는 일이 있어, 이스케이프 octet 는 포함되지 않는다

• toString 메소드는 모든 필요한 인용부호를 가지는 URI 캐릭터 라인을 돌려주지만, 「그 외」의 캐릭터가 포함되는 경우가 있다

• toASCIIString 메소드는 「그 외」의 캐릭터를 포함하지 않는 완전하게 인용부호로 둘러싸여 encode 된 URI 캐릭터 라인을 돌려준다

아이덴티티

임의의 URI u 의 경우는 항상 다음과 같이 됩니다.

new URI(u. toString()). equals(u)

하늘의 권한의 전에 2 개의 slash가 있거나 (file:///tmp/ 등), 호스트명의 후에 구두점이 있어도 포토가 지정되어 있지 않거나 (http://java.sun.com: 등) 하는 것 같은 장황 구문을 포함하지 않고 인용부호로 둘러쌀 필요가 있는 캐릭터 이외의 캐릭터를 encode 하지 않는 URI u 의 경우는 다음과 같이 됩니다.

new URI(u. getScheme(),
u. getSchemeSpecificPart(),
u. getFragment())
. equals(u)

모든 경우에 대해

new URI(u. getScheme(),
u. getUserInfo(), u. getAuthority(),
u. getPath(), u. getQuery(),
u. getFragment())
. equals(u)

u 가 계층의 경우

new URI(u. getScheme(),
u. getUserInfo(), u. getHost(), u. getPort(),
u. getPath(), u. getQuery(),
u. getFragment())
. equals(u)

u 가 계층에서, 권한 또는 서버 베이스의 권한을 가지지 않는 경우

URI, URL, 및 URN

URI 는 Uniform Resource Identifier 이며, URL 는 Uniform Resource Locator 입니다. 따라서, 추상적으로 말하면, 모든 URL 는 URI 입니다만, 모든 URI 가 URL 이다고는인가 선. 이것은 URI 의 다른 부범위인 URN (Uniform Resource Names)가 있기 (위해)때문에입니다. URN 는 리소스에 이름을 붙입니다만, 그 검색 방법은 지정하지 않습니다. 전에 나타낸 mailto,news, 및 isbn 의 각 URI 는 URN 의 예입니다.

URI 와 URL 의 개념상의 구별은 이 클래스와 URL 클래스의 사이의 상위에 반영되고 있습니다.

이 클래스의 인스턴스는 RFC 2396 로 정의되고 있는 구문적인 의미에서의 URI 참조를 나타냅니다. URI 는 절대에서도 상대에서도 괜찮습니다. URI 캐릭터 라인은 일반 구문에 따라 해석되어 지정된 schema가 있어도 고려하지 않습니다. 호스트의 참조는 있어도 실행되지 않고 schema 의존의 스트림 핸들러는 구축되지 않습니다. 동등성, 해시, 및 비교는 인스턴스의 캐릭터 내용에 의해 엄밀하게 정의됩니다. 즉, URI 인스턴스는 비교, 정규화, 해결, 및 상대화의 구문적인, schema에 의존하지 않는 조작을 서포트하는 구조화 캐릭터 라인에 지나지 않습니다.

대조적으로,URL 클래스의 인스턴스는 URL 의 구문적 컴퍼넌트, 및 URL 가 기술하는 리소스에의 액세스에 필요한 정보의 일부를 나타냅니다. URL 는 절대일 필요가 있습니다. 즉, 항상 schema를 지정할 필요가 있습니다. URL 캐릭터 라인은 그 schema에 따라 해석됩니다. 스트림 핸들러는 항상 URL 용으로 확립되어 사실, 핸들러를 사용할 수 없는 schema의 URL 인스턴스를 작성할 수 없습니다. 동등성과 해시는 만약 있으면, schema와 호스트의 인터넷 주소의 양쪽 모두에 의존합니다. 비교는 정의되지 않습니다. 즉, URL 는 해결의 구문적 조작과 호스트를 참조해, 지정된 리소스에의 접속을 여는 네트워크 입출력 조작을 서포트하는 구조화 캐릭터 라인입니다.

도입된 버젼:

1.4

관련 항목:

「RFC 2279: UTF-8, a transformation format of ISO 10646」,
「RFC 2373: IPv6 Addressing Architecture」,
「RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax」,
「RFC 2732: Format for Literal IPv6 Addresses in URLs」,
URISyntaxException , 직렬화 된 형식

생성자의 개요

URI (String str)
지정된 캐릭터 라인을 해석해 URI 를 구축합니다.

URI (String scheme, String ssp, String fragment)
지정된 컴퍼넌트로부터 URI 를 구축합니다.

URI (String scheme, String userInfo, String host, int port, String path, String query, String fragment)
지정된 컴퍼넌트로부터 계층 URI 를 구축합니다.

URI (String scheme, String host, String path, String fragment)
지정된 컴퍼넌트로부터 계층 URI 를 구축합니다.

URI (String scheme, String authority, String path, String query, String fragment)
지정된 컴퍼넌트로부터 계층 URI 를 구축합니다.

메소드의 개요

int	compareTo (Object ob) 이 URI 를 다른 오브젝트와 비교합니다.
static URI	create (String str) 지정된 캐릭터 라인을 해석해 URI 를 작성합니다.
boolean	equals (Object ob) 이 URI 가 다른 오브젝트와 동일한지 어떤지를 판정합니다.
String	getAuthority () 이 URI 의 복호화(decode) 된 권한 컴퍼넌트를 돌려줍니다.
String	getFragment () 이 URI 의 복호화(decode) 된 fragment 컴퍼넌트를 돌려줍니다.
String	getHost () 이 URI 의 호스트 컴퍼넌트를 돌려줍니다.
String	getPath () 이 URI 의 복호화(decode) 된 파스콘포넨트를 돌려줍니다.
int	getPort () 이 URI 의 포토 번호를 돌려줍니다.
String	getQuery () 이 URI 의 복호화(decode) 된 쿠에리-컴퍼넌트를 돌려줍니다.
String	getRawAuthority () 이 URI 의 그대로의 권한 컴퍼넌트를 돌려줍니다.
String	getRawFragment () 이 URI 의 그대로의 fragment 컴퍼넌트를 돌려줍니다.
String	getRawPath () 이 URI 의 그대로의 파스콘포넨트를 돌려줍니다.
String	getRawQuery () 이 URI 의 그대로의 쿠에리-컴퍼넌트를 돌려줍니다.
String	getRawSchemeSpecificPart () 이 URI 의 schema 고유 부분을 돌려줍니다.
String	getRawUserInfo () 이 URI 의 그대로의 유저 정보 컴퍼넌트를 돌려줍니다.
String	getScheme () 이 URI 의 schema 컴퍼넌트를 돌려줍니다.
String	getSchemeSpecificPart () 이 URI 의 복호화(decode) 된 schema 고유 부분을 돌려줍니다.
String	getUserInfo () 이 URI 의 복호화(decode) 된 유저 정보 컴퍼넌트를 돌려줍니다.
int	hashCode () 이 URI 의 해시 코드치를 돌려줍니다.
boolean	isAbsolute () 이 URI 가 절대인가 어떤가를 통지합니다.
boolean	isOpaque () 이 URI 가 불투명한가 어떤가를 통지합니다.
URI	normalize () 이 URI 의 패스를 정규화합니다.
URI	parseServerAuthority () 이 URI 의 권한 컴퍼넌트 (정의되고 있는 경우)로부터 유저 정보, 호스트, 및 포토의 각 컴퍼넌트에의 해석을 시도합니다.
URI	relativize (URI uri) 지정된 URI 를 이 URI 에 대해서 상대화합니다.
URI	resolve (String str) 지정된 캐릭터 라인을 해석해, 그 후 그 캐릭터 라인을 이 URI 에 대해서 해결해, 새로운 URI 를 구축합니다.
URI	resolve (URI uri) 지정된 URI 를 이 URI 에 대해서 해결합니다.
String	toASCIIString () 이 URI 의 컨텐츠를 US-ASCII 캐릭터 라인으로서 돌려줍니다.
String	toString () 이 URI 의 컨텐츠를 캐릭터 라인으로서 돌려줍니다.
URL	toURL () 이 URI 로부터 URL 를 구축합니다.

클래스 java.lang. Object 에서 상속받은 메소드

clone , finalize , getClass , notify , notifyAll , wait , wait , wait

생성자의 상세

URI

public URI(String  str)
    throws URISyntaxException 

지정된 캐릭터 라인을 해석해 URI 를 구축합니다.

이 constructor 은 「RFC 2396 , Appendix A」의 문법으로 엄밀하게 지정된 캐릭터 라인을 해석합니다. 다만, 다음의 점이 다릅니다.

• 하늘의 권한 컴퍼넌트는 그 후에 하늘이 아닌 패스, 쿠에리-컴퍼넌트, 또는 fragment 컴퍼넌트가 계속되는 한 허가됩니다. 이것에 의해,file:///foo/bar 등의 URI 를 해석할 수 있습니다. 이 URI 는 문법적으로는 허가됩니다만, RFC 2396 의 의도에 합치합니다. 권한 컴퍼넌트가 비었을 경우, 유저 정보, 호스트, 및 포토의 각 컴퍼넌트는 미정도리입니다.

• 하늘의 상대 패스는 허가됩니다. 이것은 문법적으로는 허가됩니다만, RFC 2396 의 의도에 합치합니다. 이 변경의 주된 결과는 #foo 등의 스탠드얼론의 fragment가 하늘의 패스 및 지정된 fragment를 가지는 상대 URI 로서 해석되어 베이스 URI 에 대해서 유효하게해결할 수 있는 점입니다.

• 호스트 컴퍼넌트의 IPv4 주소는 「RFC 2732」로 지정되고 있는 대로 엄밀하게 해석됩니다. 닷으로 4 개로 구분된 주소의 각 요소에는 3 자리수를 넘지 않는 10 진수가 포함되어 있을 필요가 있습니다. 게다가 각 요소의 값은 255 를 넘어서는 안 된다고 하는 제약이 있습니다.

• IPv6 주소가 호스트 컴퍼넌트로 허가됩니다. IPv6 주소는 「RFC 2732」로 지정되고 있게, 꺽쇄묶음 ([ 및 ])으로 둘러쌀 필요가 있습니다. IPv6 주소 자체는 「RFC 2373」에 따라 해석할 필요가 있습니다. 게다가 IPv6 주소에는 16 바이트를 넘지 않는 주소 정보로 기술한다고 하는 제약이 있습니다. 제약은 RFC 2373 에 은근히 나타나고 있습니다만, 문법에서는 표현할 수 없습니다.

• 「그 외」의 카테고리내의 캐릭터는 RFC 2396 로 「이스케이프」octet 를 허가하고 있는 곳(중), 즉 유저 정보, 패스, 쿠에리-, 및 fragment의 각 컴퍼넌트와 권한이 레지스트리 베이스의 경우는 권한 컴퍼넌트로 허가됩니다. 이것에 의해, URI 에 US-ASCII 캐릭터 세트 이외의 Unicode 캐릭터를 포함할 수가 있습니다.

파라미터:

str - URI 에 해석되는 캐릭터 라인

예외:

NullPointerException - str 가 null 의 경우

URISyntaxException - 상기의 변경으로 추가된 것처럼, 지정된 캐릭터 라인이 RFC 2396 에 위반하고 있는 경우

URI

public URI(String  scheme,
           String  userInfo,
           String  host,
           int port,
           String  path,
           String  query,
           String  fragment)
    throws URISyntaxException 

지정된 컴퍼넌트로부터 계층 URI 를 구축합니다.

schema가 지정되어 한층 더 패스도 지정되는 경우는 패스는 하늘이나 slash (/)로 시작될 필요가 있습니다. 그렇지 않은 경우, 새로운 URI 의 컴퍼넌트는 대응하는 파라미터에 null 를 건네주는지 port 파라미터의 경우는 -1 을 건네주어, 미정도리대로 되는 일이 있습니다.

최초로 이 constructor 은 「RFC 2396 , section 5. 2, step 7」으로 지정되고 있는 규칙에 따라, 지정된 컴퍼넌트로부터 URI 캐릭터 라인을 구축합니다.

1. 처음은 결과의 캐릭터 라인은 하늘입니다.

2. schema가 지정되는 경우, 그 schema는 결과에 추가되어 구두점 (:)이 계속됩니다.

3. 유저 정보, 호스트, 또는 포토가 지정되는 경우는 캐릭터 라인 // 이 추가됩니다.

4. 유저 정보가 지정되는 경우, 그 유저 정보가 추가되어, 단가 기호 (@)가 계속됩니다. 「미예약」, 「구두점」, 「이스케이프」, 또는 「그 외」의 카테고리에 없는 캐릭터는 모두 인용부호로 둘러싸입니다 .

5. 호스트가 지정되는 경우, 그 호스트가 추가됩니다. 그 호스트가 리터럴 IPv6 주소로, 꺽쇄묶음 ([ 및 ])으로 둘러싸이지 않은 경우, 꺽쇄묶음이 추가됩니다.

6. 포토 번호가 지정되는 경우, 구두점 (:)이 추가되어 10 진수의 포토 번호가 계속됩니다.

7. 패스가 지정되는 경우, 그 패스가 추가됩니다. 「미예약」, 「구두점」, 「이스케이프」, 또는 「그 외」의 카테고리에 없어서, slash (/) 또는 단가 기호 (@)에 동일하지 않은 캐릭터는 모두 인용부호로 둘러싸입니다.

8. 쿠에리-가 지정되는 경우, 물음표 (? )(이)가 추가되어, 쿠에리-가 계속됩니다. 유효한 URI 캐릭터가 아닌 캐릭터는 모두 인용부호로 둘러싸입니다.

9. 마지막으로, fragment가 지정되는 경우, 해시 기호 (#)가 추가되어, fragment가 계속됩니다. 유효한 URI 캐릭터가 아닌 캐릭터는 모두 인용부호로 둘러싸입니다.

결과의 URI 캐릭터 라인은 결과에 대해서 URI(String) constructor를 호출해, 다음에 parseServerAuthority() 메소드를 호출했는지와 같이 해, 해석됩니다. 이것에 의해,URISyntaxException 가 슬로우 되는 경우가 있습니다.

파라미터:

scheme - schema명

userInfo - 유저명과 인증 정보

host - 호스트명

port - 포토 번호

path - 패스

query - 쿠에리-

fragment - fragment

예외:

URISyntaxException - schema와 패스의 양쪽 모두가 지정되고 있지만 패스가 상대의 경우, 지정된 컴퍼넌트로부터 구축된 URI 캐릭터 라인이 RFC 2396 에 위반하는 경우, 또는 캐릭터 라인의 권한 컴퍼넌트가 존재하지만 서버 베이스의 권한으로서 해석할 수 없는 경우

URI

public URI(String  scheme,
           String  authority,
           String  path,
           String  query,
           String  fragment)
    throws URISyntaxException 

지정된 컴퍼넌트로부터 계층 URI 를 구축합니다.

schema가 지정되어 한층 더 패스도 지정되는 경우는 패스는 하늘이나 slash (/)로 시작될 필요가 있습니다. 그렇지 않은 경우, 새로운 URI 의 컴퍼넌트는 대응하는 파라미터에 null 를 건네주어 미정도리대로 되는 일이 있습니다.

최초로 이 constructor 은 「RFC 2396 , section 5. 2, step 7」으로 지정되고 있는 규칙에 따라, 지정된 컴퍼넌트로부터 URI 캐릭터 라인을 구축합니다.

1. 처음은 결과의 캐릭터 라인은 하늘입니다.

2. schema가 지정되는 경우, 그 schema는 결과에 추가되어 구두점 (:)이 계속됩니다.

3. 권한이 지정되는 경우, 캐릭터 라인 // 이 추가되어, 권한이 계속됩니다. 권한으로 리터럴 IPv6 주소가 포함되는 경우, 그 주소는 꺽쇄묶음 ([ 및 ])으로 둘러쌀 필요가 있습니다. 「미예약」, 「구두점」, 「이스케이프」, 또는 「그 외」의 카테고리에 없어서, 단가 기호 (@)에 동일하지 않은 캐릭터는 모두 인용부호로 둘러싸입니다 .

4. 패스가 지정되는 경우, 그 패스가 추가됩니다. 「미예약」, 「구두점」, 「이스케이프」, 또는 「그 외」의 카테고리에 없어서, slash (/) 또는 단가 기호 (@)에 동일하지 않은 캐릭터는 모두 인용부호로 둘러싸입니다.

5. 쿠에리-가 지정되는 경우, 물음표 (? )(이)가 추가되어, 쿠에리-가 계속됩니다. 유효한 URI 캐릭터가 아닌 캐릭터는 모두 인용부호로 둘러싸입니다.

6. 마지막으로, fragment가 지정되는 경우, 해시 기호 (#)가 추가되어, fragment가 계속됩니다. 유효한 URI 캐릭터가 아닌 캐릭터는 모두 인용부호로 둘러싸입니다.

결과의 URI 캐릭터 라인은 결과에 대해서 URI(String) constructor를 호출해, 다음에 parseServerAuthority() 메소드를 호출했는지와 같이 해, 해석됩니다. 이것에 의해,URISyntaxException 가 슬로우 되는 경우가 있습니다.

파라미터:

scheme - schema명

authority - 권한

path - 패스

query - 쿠에리-

fragment - fragment

예외:

URISyntaxException - schema와 패스의 양쪽 모두가 지정되고 있지만 패스가 상대의 경우, 지정된 컴퍼넌트로부터 구축된 URI 캐릭터 라인이 RFC 2396 에 위반하는 경우, 또는 캐릭터 라인의 권한 컴퍼넌트가 존재하지만 서버 베이스의 권한으로서 해석할 수 없는 경우

URI

public URI(String  scheme,
           String  host,
           String  path,
           String  fragment)
    throws URISyntaxException 

지정된 컴퍼넌트로부터 계층 URI 를 구축합니다.

컴퍼넌트는 null 를 건네주어 미정도리대로 되는 일이 있습니다.

이 간이 constructor 은 다음과 같이 7 개의 인수의 constructor를 호출하는것 같이 동작합니다.

new URI (scheme, null, host, -1, path, null, fragment);

파라미터:

scheme - schema명

host - 호스트명

path - 패스

fragment - fragment

예외:

URISyntaxException - 지정된 컴퍼넌트로부터 구축한 URI 캐릭터 라인이 RFC 2396 에 위반하는 경우

URI

public URI(String  scheme,
           String  ssp,
           String  fragment)
    throws URISyntaxException 

지정된 컴퍼넌트로부터 URI 를 구축합니다.

컴퍼넌트는 null 를 건네주어 미정도리대로 되는 일이 있습니다.

최초로 이 constructor 은 지정된 컴퍼넌트를 사용해 캐릭터 라인 형식에서 URI 를 구축합니다. 다음과 같이 됩니다.

1. 처음은 결과의 캐릭터 라인은 하늘입니다.

2. schema가 지정되는 경우, 그 schema는 결과에 추가되어 구두점 (:)이 계속됩니다.

3. schema 고유 부분이 지정되는 경우, 그 schema 고유 부분이 추가됩니다. 유효한 URI 캐릭터가 아닌 캐릭터는 모두인용부호로 둘러싸입니다 .

4. 마지막으로, fragment가 지정되는 경우, 해시 기호 (#)가 캐릭터 라인에 추가되어, fragment가 계속됩니다. 유효한 URI 캐릭터가 아닌 캐릭터는 모두 인용부호로 둘러싸입니다.

결과의 URI 캐릭터 라인은 새로운 URI 인스턴스를 작성하기 위해서,URI(String) constructor를 호출했는지와 같이 해 해석됩니다. 이것에 의해,URISyntaxException 가 슬로우 되는 경우가 있습니다.

파라미터:

scheme - schema명

ssp - schema 고유 부분

fragment - fragment

예외:

URISyntaxException - 지정된 컴퍼넌트로부터 구축한 URI 캐릭터 라인이 RFC 2396 에 위반하는 경우

메소드의 상세

create

public static URI  create(String  str)

지정된 캐릭터 라인을 해석해 URI 를 작성합니다.

이 간이 팩토리 메소드는 URI(String) constructor를 호출했는지와 같이 해 동작합니다. constructor 으로부터 슬로우 되는 URISyntaxException 는 모두 캐치 되어 새로운 IllegalArgumentException 오브젝트에 랩 되어 그 후 슬로우 됩니다.

이 메소드는 지정된 캐릭터 라인이 유효한 URI 인 것이 기존의 경우 (예를 들어, 프로그램내에서 선언되는 URI 정수)에 사용하기 위해서 제공되고 있습니다. 따라서, 캐릭터 라인이 이와 같이 해석되지 않으면 program error라고 보여집니다. URISyntaxException 를 직접 슬로우 하는 constructor 은 URI 가 유저 입력이나 에러가 발생하기 쉬운 그 외의 소스로부터 구축되는 경우에 사용합니다.

파라미터:

str - URI 에 해석되는 캐릭터 라인

반환값:

새로운 URI

예외:

NullPointerException - str 가 null 의 경우

IllegalArgumentException - 지정된 캐릭터 라인이 RFC 2396 에 위반하는 경우

parseServerAuthority

public URI  parseServerAuthority()
                         throws URISyntaxException 

이 URI 의 권한 컴퍼넌트 (정의되고 있는 경우)로부터 유저 정보, 호스트, 및 포토의 각 컴퍼넌트에의 해석을 시도합니다.

이 URI 의 권한 컴퍼넌트가 벌써 서버 베이스이다고 인식되고 있는 경우는 벌써 유저 정보, 호스트, 및 포토의 각 컴퍼넌트에 해석되고 있습니다. 이 경우, 또는 이 URI 에 권한 컴퍼넌트가 없는 경우, 이 메소드는 이 URI 를 돌려줄 뿐입니다.

그렇지 않은 경우, 이 메소드는 권한 컴퍼넌트로부터 유저 정보, 호스트, 및 포토의 각 컴퍼넌트에의 해석을 한번 더 시도해 권한 컴퍼넌트를 그처럼 해석할 수 없었던 이유를 설명하는 예외를 슬로우 합니다.

이 메소드는 「RFC 2396」으로 지정되고 있는 일반 URI 구문이 무효인 서버 베이스 권한과 유효한 레지스트리 베이스 권한을 반드시 구별할 수 없기 위해(때문에) 준비되어 있습니다. 따라서, 서버 베이스 권한의 일부의 인스턴스를 레지스트리 베이스 권한의 인스턴스로서 취급할 필요가 있습니다. 예를 들어, URI 캐릭터 라인 //foo:bar 등의 권한 컴퍼넌트는 유효한 서버 베이스 권한이 아닙니다만, 레지스트리 베이스 권한으로서는 유효합니다.

URN 또는 URL 인 것이 기존의 URI 를 사용하는 것 같은 많은 일반적인 상황에서는 사용되는 계층 URI 는 항상 서버 베이스입니다. 따라서, 그처럼 해석하는지 에러로서 취급할 필요가 있습니다. 이 경우, 다음과 같은 문장은

URI u = new URI(str). parseServerAuthority();

u 가 적절한 유저 정보, 호스트, 및 포토의 각 컴퍼넌트가 있는 서버 베이스 권한을 가지는 URI (권한 컴퍼넌트를 가지는 경우)를 항상 참조하도록(듯이) 하기 위해서 사용할 수 있습니다. 또, 이 메소드를 호출하면(자), 권한을 그처럼 해석할 수 없었던 경우에, 슬로우 되는 예외에 근거해 적절한 진단 메세지를 발행하도록 할 수 있습니다.

반환값:

권한 필드가 서버 베이스 권한으로서 해석된 URI

예외:

URISyntaxException - 이 URI 의 권한 컴퍼넌트가 지정되고 있지만, RFC 2396 에 따라 서버 베이스 권한으로서 해석할 수 없는 경우

normalize

public URI  normalize()

이 URI 의 패스를 정규화합니다.

이 URI 가 불투명한 경우, 또는 그 패스가 벌써 정규 형식인 경우는 이 URI 가 돌려주어집니다. 그렇지 않은 경우는 이 URI 와 같은 새로운 URI 가 구축됩니다. 다만, 그 패스가「RFC 2396 , section 5. 2, step 6, sub-steps c through f」에 적합하는 방법으로 이 URI 의 패스를 정규화해 구할 수 있는 경우를 제외합니다. 다음과 같이 됩니다.

1. 모든 . 세그먼트(segment)가 삭제됩니다.

2. .. 세그먼트(segment)의 전에.. (이)가 아닌 세그먼트(segment)가 있는 경우, 이러한 세그먼트(segment)는 양쪽 모두 삭제됩니다. 이 스텝은 해당하는 것이 없어질 때까지 반복해집니다.

3. 패스가 상대로, 최초의 세그먼트(segment)에 구두점 (:)이 포함되는 경우,. 세그먼트(segment)가 전에 추가됩니다. 이것에 의해,a:b/c/d 등의 패스를 가지는 상대 URI 가 나중에 a 의 schema 및 b/c/d 의 schema 고유 부분을 사용해 불투명 URI 로서 재차 해석되지 않게 합니다 (RFC 2396 를 변경한 것).

정규화된 패스는 삭제를 가능하게 한다 .. (이)가 아닌 선행의 세그먼트(segment)가 불충분했던 경우, 1 kr 이상의 .. 세그먼트(segment)로 시작됩니다. 정규화된 패스는 상기의 스텝 3 으로 삽입 통지 경우,. 세그먼트(segment)로 시작됩니다. 그렇지 않은 경우, 정규화된 패스에는 . 또는 .. 세그먼트(segment)는 포함되지 않습니다.

반환값:

이 URI 와 동등의 URI. 다만, 그 패스는 정규 형식

resolve

public URI  resolve(URI  uri)

지정된 URI 를 이 URI 에 대해서 해결합니다.

지정된 URI 가 벌써 절대인 경우, 또는 이 URI 가 불투명한 경우는 지정된 URI 가 돌려주어집니다.

지정된 URI 의 fragment 컴퍼넌트가 정의되어 그 파스콘포넨트가 하늘에서, 그 schema, 권한, 및 쿠에리-의 각 컴퍼넌트가 미정도리의 경우는 지정된 fragment를 가지지만 다른 모든 컴퍼넌트가 이 URI 의 컴퍼넌트와 동일한 URI 가 돌려주어집니다. 이것에 의해,#foo 등의 스탠드얼론 fragment 참조를 나타내는 URI 를 베이스 URI 에 대해서 유효하게 해결할 수가 있습니다.

그렇지 않은 경우, 이 메소드는 「RFC 2396 , section 5. 2」에 적합하는 방법으로 새로운 계층 URI 를 구축합니다. 다음과 같이 됩니다.

1. 이 URI 의 스킴과 지정된 URI 의 쿠에리- 및 fragment 컴퍼넌트를 사용해, 새로운 URI 가 구축됩니다.

2. 지정된 URI 에 권한 컴퍼넌트가 있는 경우, 새로운 URI 의 권한과 패스는 지정된 URI 로부터 놓칩니다.

3. 그렇지 않은 경우, 새로운 URI 의 권한 컴퍼넌트가 이 URI 로부터 카피되어 그 패스는 다음과 같이 해 구할 수 있습니다.

1. 지정된 URI 의 패스가 절대의 경우, 새로운 URI 의 패스는 지정된 URI 로부터 놓칩니다.

2. 그렇지 않은 경우, 지정된 URI 의 패스는 상대로, 새로운 URI 의 패스는 지정된 URI 의 패스를 이 URI 의 패스에 대해서 해결해 구할 수 있습니다. 이것은 이 URI 의 패스의 마지막 세그먼트(segment) 이외의 모든 세그먼트(segment) (존재하는 경우)가 지정된 URI 의 패스와 연결해, 그 결과를 normalize 메소드를 호출했는지와 같이 해 정규화하는 것에 의해 행해집니다.

이 메소드의 결과는 이 URI 가 절대의 경우, 또는 지정된 URI 가 절대의 경우에만, 절대로 됩니다.

파라미터:

uri - 이 URI 에 대해서 해결되는 URI

반환값:

결과의 URI

예외:

NullPointerException - uri 가 null 의 경우

resolve

public URI  resolve(String  str)

지정된 캐릭터 라인을 해석해, 그 후 그 캐릭터 라인을 이 URI 에 대해서 해결해, 새로운 URI 를 구축합니다.

이 간이 메소드는 이 메소드의 호출이 식 resolve (new create (str)) 의 평가와 같은가와 같이 동작합니다.

파라미터:

str - URI 에 해석되는 캐릭터 라인

반환값:

결과의 URI

예외:

NullPointerException - str 가 null 의 경우

IllegalArgumentException - 지정된 캐릭터 라인이 RFC 2396 에 위반하는 경우

relativize

public URI  relativize(URI  uri)

지정된 URI 를 이 URI 에 대해서 상대화합니다.

지정된 URI 의 이 URI 에 대한 상대화는 다음과 같이 해 구할 수 있습니다.

1. 이 URI 또는 지정된 URI 가 불투명한 경우, 2 개의 URI 의 schema와 권한 컴퍼넌트가 같지 않은 경우, 또는 이 URI 의 패스가 지정된 URI 의 패스의 접두사가 아닌 경우는 지정된 URI 가 돌려주어집니다.

2. 그렇지 않은 경우, 지정된 URI 로부터 놓친 쿠에리- 및 fragment 컴퍼넌트와 지정된 URI 의 패스의 선두로부터 이 URI 의 패스를 삭제해 요구한 파스콘포넨트를 사용해, 새로운 상대 계층 URI 가 구축됩니다.

파라미터:

uri - 이 URI 에 대해서 상대화되는 URI

반환값:

결과의 URI

예외:

NullPointerException - uri 가 null 의 경우

toURL

public URL  toURL()
          throws MalformedURLException 

이 URI 로부터 URL 를 구축합니다.

이 간이 메소드는 최초로 이 URI 가 절대인 것을 확인하고 나서, 이 메소드의 호출이 식 new URL(this.toString()) 의 평가와 같은가와 같이 동작합니다.

반환값:

이 URI 로부터 구축된 URL

예외:

IllegalArgumentException - 이 URL 가 절대가 아닌 경우

MalformedURLException - URL 의 프로토콜 핸들러를 발견할 수 없었던 경우, 또는 URL 의 구축시에 다른 에러가 발생했을 경우

getScheme

public String  getScheme()

이 URI 의 schema 컴퍼넌트를 돌려줍니다.

URI 의 schema 컴퍼넌트에는 (정의되고 있는 경우), 「영숫자」카테고리 및 캐릭터 라인 -. + 의 캐릭터만이 포함됩니다. schema는 항상 「영문자」로 시작됩니다.

URI 의 schema 컴퍼넌트에 이스케이프 octet 를 포함할 수 없기 때문에, 이 메소드는 복호화(decode)를 실행하지 않습니다.

반환값:

이 URI 의 schema 컴퍼넌트. schema가 미정도리의 경우는 null

isAbsolute

public boolean isAbsolute()

이 URI 가 절대인가 어떤가를 통지합니다.

URI 가 절대인 것은 그 URI 에 schema 컴퍼넌트가 있는 경우만입니다.

반환값:

이 URI 가 절대인 경우만 true

isOpaque

public boolean isOpaque()

이 URI 가 불투명한가 어떤가를 통지합니다.

불투명 URI 는 schema 컴퍼넌트 이외에서는 해석되지 않습니다. 불투명 URI 의 나머지의 부분은 getSchemeSpecificPart 메소드에 의해 취득할 수 있습니다. 다른 모든 컴퍼넌트는 미정도리입니다.

반환값:

이 URI 가 불투명의 경우만 true

getRawSchemeSpecificPart

public String  getRawSchemeSpecificPart()

이 URI 의 schema 고유 부분을 돌려줍니다. schema 고유 부분은 결코 미정도리가 아닙니다만, 비었을 경우가 있습니다.

URI 의 schema 고유 부분에는 유효한 URI 캐릭터만이 포함됩니다.

반환값:

이 URI 의 그대로의 schema 고유 부분 (결코 null 는 아니다)

getSchemeSpecificPart

public String  getSchemeSpecificPart()

이 URI 의 복호화(decode) 된 schema 고유 부분을 돌려줍니다.

이 메소드로부터 돌려주어진 캐릭터 라인은 getRawSchemeSpecificPart 메소드로부터 돌려주어진 캐릭터 라인과 같습니다. 다만, 이스케이프 octet 의 순차 순서가 모두복호화(decode) 되는 경우를 제외합니다.

반환값:

이 URI 의 복호화(decode) 된 schema 고유 부분 (결코 null 는 아니다)

getRawAuthority

public String  getRawAuthority()

이 URI 의 그대로의 권한 컴퍼넌트를 돌려줍니다.

URI 의 권한 컴퍼넌트에는 (정의되고 있는 경우), 단가 기호 (@)와 「미예약」, 「구두점」, 「이스케이프」, 및 「그 외」의 카테고리의 캐릭터만이 포함됩니다. 권한이 서버 베이스의 경우는 한층 더 유효한 유저 정보, 호스트, 포토의 각 컴퍼넌트가 필요합니다.

반환값:

이 URI 의 그대로의 권한 컴퍼넌트. 권한이 미정도리의 경우는 null

getAuthority

public String  getAuthority()

이 URI 의 복호화(decode) 된 권한 컴퍼넌트를 돌려줍니다.

이 메소드로부터 돌려주어진 캐릭터 라인은 getRawAuthority 메소드로부터 돌려주어진 캐릭터 라인과 같습니다. 다만, 이스케이프 octet 의 순차 순서가 모두복호화(decode) 되는 경우를 제외합니다.

반환값:

이 URI 의 복호화(decode) 된 권한 컴퍼넌트. 권한이 미정도리의 경우는 null

getRawUserInfo

public String  getRawUserInfo()

이 URI 의 그대로의 유저 정보 컴퍼넌트를 돌려줍니다.

URI 의 유저 정보 컴퍼넌트에는 (정의되고 있는 경우), 「미예약」, 「구두점」, 「이스케이프」, 및 「그 외」의 카테고리의 캐릭터만이 포함됩니다.

반환값:

이 URI 의 그대로의 유저 정보 컴퍼넌트. 유저 정보가 미정도리의 경우는 null

getUserInfo

public String  getUserInfo()

이 URI 의 복호화(decode) 된 유저 정보 컴퍼넌트를 돌려줍니다.

이 메소드로부터 돌려주어진 캐릭터 라인은 getRawUserInfo 메소드로부터 돌려주어진 캐릭터 라인과 같습니다. 다만, 이스케이프 octet 의 순차 순서가 모두복호화(decode) 되는 경우를 제외합니다.

반환값:

이 URI 의 복호화(decode) 된 유저 정보 컴퍼넌트. 유저 정보가 미정도리의 경우는 null

getHost

public String  getHost()

이 URI 의 호스트 컴퍼넌트를 돌려줍니다.

URI 의 호스트 컴퍼넌트 (정의되고 있는 경우)의 형식은 다음의 머지않아인가입니다.

• 피리어드 (. )(으)로 구분된 1 kr 이상의 「label」로 구성되는 도메인명. 임의로, 피리어드가 계속된다. 각 label는 「영숫자」캐릭터와 하이픈 (-)으로 구성됩니다. 다만, 하이픈은 label의 최초 또는 마지막 캐릭터로서는 사용할 수 없습니다. 도메인명의 마지막 label만은 「영문자」캐릭터로 시작됩니다.

• 숫자+. 숫자+. 숫자+. 숫자+ 의 형식의, 닷으로 4 개로 구분된 IPv4 주소. 여기서, 숫자는 3 캐릭터 이내에서, 그 값은 255 를 넘지 않습니다.

• IPv6 주소는 꺽쇄묶음 ([ 및 ])으로 둘러싸여 16 진수, 구두점 (:), 및 아마 파묻힌 IPv4 주소로 구성됩니다. IPv6 주소의 완전한 구문은 「RFC 2373: IPv6 Addressing Architecture」로 지정되고 있습니다.

URI 의 호스트 컴퍼넌트에 이스케이프 octet 를 포함할 수 없습니다. 따라서, 이 메소드는 복호화(decode)를 실행하지 않습니다.

반환값:

이 URI 의 호스트 컴퍼넌트. 호스트가 미정도리의 경우는 null

getPort

public int getPort()

이 URI 의 포토 번호를 돌려줍니다.

URI 의 포토 컴퍼넌트는 (정의되고 있는 경우), 부가 아닌 정수입니다.

반환값:

이 URI 의 포토 컴퍼넌트. 포토가 미정도리의 경우는 -1

getRawPath

public String  getRawPath()

이 URI 의 그대로의 파스콘포넨트를 돌려줍니다.

URI 의 파스콘포넨트에는 (정의되고 있는 경우), slash (/), 단가 기호 (@)와 「미예약」, 「구두점」, 「이스케이프」, 및 「그 외」의 카테고리의 캐릭터만이 포함됩니다.

반환값:

이 URI 의 파스콘포넨트. 패스가 미정도리의 경우는 null

getPath

public String  getPath()

이 URI 의 복호화(decode) 된 파스콘포넨트를 돌려줍니다.

이 메소드로부터 돌려주어진 캐릭터 라인은 getRawPath 메소드로부터 돌려주어진 캐릭터 라인과 같습니다. 다만, 이스케이프 octet 의 순차 순서가 모두복호화(decode) 되는 경우를 제외합니다.

반환값:

이 URI 의 복호화(decode) 된 파스콘포넨트. 패스가 미정도리의 경우는 null

getRawQuery

public String  getRawQuery()

이 URI 의 그대로의 쿠에리-컴퍼넌트를 돌려줍니다.

URI 의 쿠에리-컴퍼넌트에는 (정의되고 있는 경우), 유효한 URI 캐릭터만이 포함됩니다.

반환값:

이 URI 의 그대로의 쿠에리-컴퍼넌트. 쿠에리-가 미정도리의 경우는 null

getQuery

public String  getQuery()

이 URI 의 복호화(decode) 된 쿠에리-컴퍼넌트를 돌려줍니다.

이 메소드로부터 돌려주어진 캐릭터 라인은 getRawQuery 메소드로부터 돌려주어진 캐릭터 라인과 같습니다. 다만, 이스케이프 octet 의 순차 순서가 모두복호화(decode) 되는 경우를 제외합니다.

반환값:

이 URI 의 복호화(decode) 된 쿠에리-컴퍼넌트. 쿠에리-가 미정도리의 경우는 null

getRawFragment

public String  getRawFragment()

이 URI 의 그대로의 fragment 컴퍼넌트를 돌려줍니다.

URI 의 fragment 컴퍼넌트에는 (정의되고 있는 경우), 유효한 URI 캐릭터만이 포함됩니다.

반환값:

이 URI 의 그대로의 fragment 컴퍼넌트. fragment가 미정도리의 경우는 null

getFragment

public String  getFragment()

이 URI 의 복호화(decode) 된 fragment 컴퍼넌트를 돌려줍니다.

이 메소드로부터 돌려주어진 캐릭터 라인은 getRawFragment 메소드로부터 돌려주어진 캐릭터 라인과 같습니다. 다만, 이스케이프 octet 의 순차 순서가 모두복호화(decode) 되는 경우를 제외합니다.

반환값:

이 URI 의 복호화(decode) 된 fragment 컴퍼넌트. fragment가 미정도리의 경우는 null

equals

public boolean equals(Object  ob)

이 URI 가 다른 오브젝트와 동일한지 어떤지를 판정합니다.

지정된 오브젝트가 URI 가 아닌 경우, 이 메소드는 즉시 false 를 돌려줍니다.

동일하다고 보여지는 2 개의 URI 는 양쪽 모두 불투명한가, 양쪽 모두 계층일 필요가 있습니다. 그러한 schema는 양쪽 모두 미정도리인가, 대문자 소문자에 관계없이 동일할 필요가 있습니다. 그러한 fragment에 대해서도 같습니다.

동일하다고 보여지는 2 개의 불투명 URI 의 경우, 그러한 schema 고유 부분은 동일할 필요가 있습니다.

동일하다고 보여지는 2 개의 계층 URI 의 경우, 그러한 패스는 동일하고, 휘어지고의 쿠에리-는 양쪽 모두 미정도리인가, 동일하지 않으면 안됩니다. 그러한 권한은 양쪽 모두 미정도리인가, 양쪽 모두 레지스트리 베이스인가, 혹은 양쪽 모두 서버 베이스가 아니면 안됩니다. 그러한 권한이 정의되고 있어 레지스트리 베이스의 경우, 그러한 권한은 동일하지 않으면 안됩니다. 그러한 권한이 정의되고 있어 서버 베이스의 경우, 그러한 호스트는 대문자 소문자에 관계없이 동일하고, 그러한 포토 번호는 동일하고, 그러한 유저 정보 컴퍼넌트는 동일하지 않으면 안됩니다.

2 개의 URI 의 유저 정보, 패스, 쿠에리-, fragment, 권한, 또는 schema 고유 부분이 동일한지 어떤지 판정하는 경우, 이러한 컴퍼넌트는 encode 된 형식이 아니고 그대로의 형식에서 비교되어 이스케이프 octet 의 16 진수는 대문자 소문자에 관계없이 비교됩니다.

이 메소드는 Object.equals 메소드의 범용 규약을 채웁니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

ob - 이 오브젝트와 비교하는 오브젝트

반환값:

지정된 오브젝트가 이 URI 와 같은 URI 인 경우만 true

관련 항목:

Object.hashCode() , Hashtable

hashCode

public int hashCode()

이 URI 의 해시 코드치를 돌려줍니다. 해시 코드는 URI 의 모든 컴퍼넌트에 근거해,Object.hashCode 메소드의 범용 규약을 채웁니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 URI 의 해시 코드치

관련 항목:

Object.equals(java.lang.Object) , Hashtable

compareTo

public int compareTo(Object  ob)

이 URI 를 다른 오브젝트와 비교합니다. 그 오브젝트는 URI 가 아니면 안됩니다.

2 개의 URI 의 대응하는 컴퍼넌트를 비교하는 경우, 컴퍼넌트의 한편이 미정도리로 한편이 정의되고 있으면(자), 전자는 후자보다 작다고 보여집니다. 특히 명기되어 있지 않은 한, 캐릭터 라인 컴퍼넌트는 String.compareTo 메소드로 정의되고 있게, 본래의 대문자 소문자를 구별한 순서에 따라 순서 붙일 수 있습니다. encode 되는 캐릭터 라인 컴퍼넌트는 encode 된 형식이 아니고 그대로의 형식에서 비교됩니다.

URI 의 순서는 다음과 같이 정의됩니다.

• 다른 schema를 가지는 2 개의 URI 는 대문자 소문자에 관계없이 그러한 schema의 순서에 따라 순서 붙일 수 있습니다.

• 계층 URI 는 같은 schema를 가지는 불투명 URI 보다 작다고 보여집니다.

• 같은 schema를 가지는 2 개의 불투명 URI 는 그러한 schema 고유 부분의 순서에 따라 순서 붙일 수 있습니다.

• 같은 schema와 schema 고유 부분을 가지는 2 개의 불투명 URI 는 그러한 fragment의 순서에 따라 순서 붙일 수 있습니다.

• 같은 schema를 가지는 2 개의 계층 URI 는 그러한 권한 컴퍼넌트의 순서에 따라 순서 붙일 수 있습니다.

• 양쪽 모두의 권한 컴퍼넌트가 서버 베이스인 경우, URI 는 그러한 유저 정보 컴퍼넌트에 따라 순서 붙일 수 있습니다. 이러한 컴퍼넌트가 같은 경우, URI 는 대문자 소문자에 관계없이 그러한 호스트의 순서에 따라 순서 붙일 수 있습니다. 호스트가 같은 경우, URI 는 그러한 포토의 순서에 따라 순서 붙일 수 있습니다.

• 한편 또는 양쪽 모두의 권한 컴퍼넌트가 레지스트리 베이스인 경우, URI 는 그러한 권한 콘포넨의 순서에 따라 순서 붙일 수 있습니다.

• 마지막으로, 같은 schema와 권한 컴퍼넌트를 가지는 2 개의 계층 URI 는 그러한 패스의 순서에 따라 순서 붙일 수 있습니다. 패스가 같은 경우, 하늘등의 계층 URI 는 그러한 쿠에리-의 순서에 따라 순서 붙일 수 있습니다. 쿠에리-가 같은 경우는 그러한 fragment의 순서에 따라 순서 붙일 수 있습니다.

이 메소드는 Comparable.compareTo 메소드의 범용 규약을 채웁니다.

정의:

인터페이스 Comparable 내의 compareTo

파라미터:

ob - 이 URI 와 비교하는 오브젝트

반환값:

이 URI 가 지정된 URI 보다 작은 경우는 부의 정수, 동일한 경우는 0, 큰 경우는 정의 정수

예외:

ClassCastException - 지정된 오브젝트가 URI 가 아닌 경우

toString

public String  toString()

이 URI 의 컨텐츠를 캐릭터 라인으로서 돌려줍니다.

이 URI 가 이 클래스의 constructor 의 1 개를 호출해 작성되었을 경우는 원의 입력 캐릭터 라인에 동일한 캐릭터 라인, 또는 당초로 지정된 컴퍼넌트로부터 요구한 캐릭터 라인 (적절한 경우)에 동일한 캐릭터 라인이 돌려주어집니다. 그렇지 않은 경우, 이 URI 는 정규화, 해결, 또는 상대화에 의해 작성되고 있습니다. 따라서, 캐릭터 라인은 「RFC 2396 , section 5. 2, step 7」으로 지정되고 있는 규칙에 따라, 이 URI 의 컴퍼넌트로부터 구축됩니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 URI 의 캐릭터 라인 형식

toASCIIString

public String  toASCIIString()

이 URI 의 컨텐츠를 US-ASCII 캐릭터 라인으로서 돌려줍니다.

이 URI 에 「그 외」의 카테고리의 캐릭터가 포함되지 않은 경우는 이 메소드를 호출하면(자) toString 메소드를 호출했을 때와 같은 값이 돌려주어집니다. 그렇지 않은 경우, 이 메소드는 그 메소드를 호출해 결과를encode 하는것 같이 동작합니다.

반환값:

이 URI 의 캐릭터 라인 형식. 필요에 따라서, US-ASCII 캐릭터 세트의 캐릭터만을 포함하도록(듯이) encode 된다