java.net
클래스 URI

java.lang.Object 
  java.net.URI

모든 구현된 인터페이스:

Serializable, Comparable <URI >

public final class URI
extends Object 
implements Comparable <URI >, Serializable 

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

다음에 나타내는 소규모의 변경은 따로 해, 이 클래스의 인스턴스는 「RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax」로 정의되어「RFC 2732: Format for Literal IPv6 Addresses in URLs」로 수정된 URI 참조를 나타냅니다. 리터럴 IPv6 주소 형식에서도, scope_ids가 지원 됩니다. scope_ids 구문과 사용 방법은여기서 설명하고 있습니다. 이 클래스는 컴퍼넌트로부터, 또는 캐릭터 라인 형식을 해석해 URI 인스턴스를 작성하기 위한 생성자, 인스턴스의 각종 컴퍼넌트에 액세스하기 위한 메서드 및 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
//~/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 //~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 진수자
영숫자	모든 「영문자」 및 「숫자」문자
미예약	모든 「영숫자」문자 및 캐릭터 라인 「_-!.~'()*」 안의 문자
구두점	캐릭터 라인 「,;:$&+=」 안의 문자
예약	모든 「구두점」문자 및 캐릭터 라인 「"? /[]@"」 안의 문자
이스케이프	이스케이프 8중창. 즉, 퍼센트 문자 ( 「%」)와 거기에 계속되는 2 자리수의 16 진수 ( 「0」~ 「9」, 「A」~ 「F」 및 「a」~ 「f」)로 구성되는 삼중항
그 외	US-ASCII 캐릭터셋에 포함되지 않고, 제어 문자 (Character.isISOControl 메서드에 한다)가 아니고, 공백 문자 (Character.isSpaceChar 메서드에 한다)가 아닌 Unicode 문자 (US-ASCII 로 한정되고 있는 RFC 2396을 변경한 것)

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

이스케이프 8중창, 인용부호, encode 및 복호화

RFC 2396 에서는 이스케이프 8중창을 사용자 정보, 패스, 쿼리 및 fragment의 각 컴퍼넌트에 표시할 수 있습니다 . 이스케이프는 다음의 2개의 목적을 위해서 URI 로 사용됩니다.

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

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

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

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

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

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

이러한 조작은 다음에 나타내도록, 이 클래스의 생성자과 메서드로 공개됩니다.

• single-argument constructor 에서는 인수내의 부정한 문자를 인용부호로 둘러쌀 필요가 있어, 존재하는 모든 이스케이프 8중창과 「그 외」의 문자를 보존한다

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

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

• getUserInfo, getPath, getQuery, getFragment, getAuthority 및 getSchemeSpecificPart 메서드는 대응하는 컴퍼넌트의 이스케이프 8중창을 복호화 한다. 이러한 메서드로부터 리턴된 캐릭터 라인에는 부정한 문자와 「그 외」의 문자의 양쪽 모두가 포함되어 있는 일이 있어, 이스케이프 8중창은 포함되지 않는다

• 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 (URI that) 이 URI를 다른 객체와 비교합니다.
static URI	create (String str) 지정된 캐릭터 라인을 해석해 URI를 작성합니다.
boolean	equals (Object ob) 이 URI가 다른 객체와 동일한지 어떤지를 판정합니다.
String	getAuthority () 이 URI 복호화 된 권한 컴퍼넌트를 리턴합니다.
String	getFragment () 이 URI 복호화 된 fragment 컴퍼넌트를 리턴합니다.
String	getHost () 이 URI 호스트 컴퍼넌트를 리턴합니다.
String	getPath () 이 URI 복호화 된 파스콘포넨트를 리턴합니다.
int	getPort () 이 URI 포트 번호를 리턴합니다.
String	getQuery () 이 URI 복호화 된 쿼리컴퍼넌트를 리턴합니다.
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 복호화 된 schema 고유 부분을 리턴합니다.
String	getUserInfo () 이 URI 복호화 된 사용자 정보 컴퍼넌트를 리턴합니다.
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를 구축합니다.

이 생성자는 「RFC 2396」부록 A 문법으로 엄밀하게 지정된 캐릭터 라인을 해석합니다. 다만, 다음의 점이 다릅니다.

• 비어있는 권한 컴퍼넌트는 그 후에 비어있지 않은 패스, 쿼리컴퍼넌트, 또는 fragment 컴퍼넌트가 계속되는 한 허가된다. 이것에 의해 「file:///foo/bar」등의 URI를 해석할 수 있다. 이 URI는 문법적으로는 허가되지 않지만, RFC 2396 도에 합치한다. 권한 컴퍼넌트가 비어있는 경우, 사용자 정보, 호스트 및 포트의 각 컴퍼넌트는 미정도리이다

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

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

• 1개의 도메인 라벨만을 허가하는 호스트 컴퍼넌트내의 호스트명은 「영숫자」로 시작될 수가 있다. 이것은 문법적으로는 허가되지 않지만, RFC 2396 섹션 3. 2.2 도에 합치한다. 이 변경의 주된 결과적으로s://123와 같은 계층 URL 권한 컴퍼넌트가 서버 베이스의 권한으로서 해석된다

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

• 「그 외」의 카테고리내의 문자는 RFC 2396 로 「이스케이프」8중창을 허가하고 있는 곳(중), 즉 사용자 정보, 패스, 쿼리 및 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을 건네주어, 미정도리대로 되는 일이 있습니다.

최초로 이 생성자는 「RFC 2396」섹션 5. 2, 스텝 7 로 가리키는 규칙에 따라 지정된 컴퍼넌트로부터 URI 캐릭터 라인을 구축합니다.

1. 처음은 결과의 캐릭터 라인은 공백이다

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

3. 사용자 정보, 호스트, 또는 포트가 지정되는 경우는 캐릭터 라인 「//」이 추가된다

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

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

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

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

8. 쿼리가 지정되는 경우, 물음표 ( 「? 」)이 추가되어, 쿼리가 계속된다. 유효한 URI 문자가 아닌 문자는 모두 인용부호로 둘러싸인다

9. 마지막으로 fragment가 지정되는 경우, 해시 기호 ( 「#」)가 추가되어, fragment가 계속된다. 유효한 URI 문자가 아닌 문자는 모두 인용부호로 둘러싸인다

결과의 URI 캐릭터 라인은 결과에 대해서 URI(String) 생성자를 호출해, 다음에 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을 건네주어 미정도리대로 되는 일이 있습니다.

최초로 이 생성자는 「RFC 2396」섹션 5. 2, 스텝 7 로 가리키는 규칙에 따라 지정된 컴퍼넌트로부터 URI 캐릭터 라인을 구축합니다.

1. 처음은 결과의 캐릭터 라인은 공백이다

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

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

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

5. 쿼리가 지정되는 경우, 물음표 ( 「? 」)이 추가되어, 쿼리가 계속된다. 유효한 URI 문자가 아닌 문자는 모두 인용부호로 둘러싸인다

6. 마지막으로 fragment가 지정되는 경우, 해시 기호 ( 「#」)가 추가되어, fragment가 계속된다. 유효한 URI 문자가 아닌 문자는 모두 인용부호로 둘러싸인다

결과의 URI 캐릭터 라인은 결과에 대해서 URI(String) 생성자를 호출해, 다음에 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을 건네주어 미정도리대로 되는 일이 있습니다.

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

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을 건네주어 미정도리대로 되는 일이 있습니다.

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

1. 처음은 결과의 캐릭터 라인은 공백3이다

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

3. schema 고유 부분이 지정되는 경우, 그 schema 고유 부분이 추가된다. 유효한 URI 문자가 아닌 문자는 모두인용부호로 둘러싸인다

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

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

파라미터:

scheme - schema명

ssp - schema 고유 부분

fragment - fragment

예외:

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

메서드의 상세

create

public static URI  create(String  str)

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

이 간이 팩토리 메서드는 URI(String) 생성자를 호출했는지와 같이의해 동작합니다. 생성자로부터 발생되는 URISyntaxException 는 모두 캐치 되어 새로운 IllegalArgumentException 객체에 랩 되어 그 후 발생 됩니다.

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

파라미터:

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

반환값:

새로운 URI

예외:

NullPointerException - str가 null인 경우

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

parseServerAuthority

public URI  parseServerAuthority()
                         throws URISyntaxException 

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

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

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

이 메서드는 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」섹션 5. 2, 스텝 6, 서브 스텝 c ~ 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개 이상의 「..」세그먼트(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」섹션 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 (URI. 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 스킴 컴퍼넌트에 이스케이프 8중창을 포함할 수 없습니다. 따라서, 이 메서드는 복호화를 실행하지 않습니다.

반환값:

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

isAbsolute

public boolean isAbsolute()

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

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

반환값:

이 URI가 절대인 경우만 true

isOpaque

public boolean isOpaque()

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

URI가 불투명한 것은 그 URL가 절대로 schema 고유 부분이 slash 문자 ( 「/」)로 시작되지 않는 경우 뿐입니다. 불투명한 URI는 schema, schema 고유 부분 및 (경우에 따라서는) fragment를 가집니다. 그 외의 모든 컴퍼넌트는 미정도리입니다.

반환값:

이 URI가 불투명의 경우만 true

getRawSchemeSpecificPart

public String  getRawSchemeSpecificPart()

이 URI schema 고유 부분을 리턴합니다. schema 고유 부분은 결코 미정도리가 아닙니다만, 비어있는 경우가 있습니다.

URI schema 고유 부분에는 유효한 URI 문자만이 포함됩니다.

반환값:

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

getSchemeSpecificPart

public String  getSchemeSpecificPart()

이 URI 복호화 된 schema 고유 부분을 리턴합니다.

이 메서드로부터 리턴된 캐릭터 라인은, getRawSchemeSpecificPart 메서드로부터 리턴된 캐릭터 라인과 같습니다. 다만, 이스케이프 8중창의 순서가 모두복호화 되는 경우를 제외합니다.

반환값:

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

getRawAuthority

public String  getRawAuthority()

이 URI 그대로의 권한 컴퍼넌트를 리턴합니다.

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

반환값:

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

getAuthority

public String  getAuthority()

이 URI 복호화 된 권한 컴퍼넌트를 리턴합니다.

이 메서드로부터 리턴된 캐릭터 라인은, getRawAuthority 메서드로부터 리턴된 캐릭터 라인과 같습니다. 다만, 이스케이프 8중창의 순서가 모두복호화 되는 경우를 제외합니다.

반환값:

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

getRawUserInfo

public String  getRawUserInfo()

이 URI 그대로의 사용자 정보 컴퍼넌트를 리턴합니다.

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

반환값:

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

getUserInfo

public String  getUserInfo()

이 URI 복호화 된 사용자 정보 컴퍼넌트를 리턴합니다.

이 메서드로부터 리턴된 캐릭터 라인은, getRawUserInfo 메서드로부터 리턴된 캐릭터 라인과 같습니다. 다만, 이스케이프 8중창의 순서가 모두복호화 되는 경우를 제외합니다.

반환값:

이 URI 복호화 된 사용자 정보 컴퍼넌트. 사용자 정보가 미정도리의 경우는 null

getHost

public String  getHost()

이 URI 호스트 컴퍼넌트를 리턴합니다.

URI 호스트 컴퍼넌트 (정의되고 있는 경우)의 형식은 다음의 어떤 것인가입니다.

• 피리어드 ( 「. 」)로 구분된 1개 이상의 「라벨」로 구성되는 도메인명. 임의로 피리어드가 계속된다. 각 라벨은 「영숫자」문자와 하이픈 ( 「-」)으로 구성된다. 다만, 하이픈은 라벨의 최초 또는 마지막 문자로서는 사용할 수 없다. 2개 이상의 라벨로 구성되는 도메인명의 가장 오른쪽의 라벨은 「영문자」문자로 시작된다

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

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

URI 호스트 컴퍼넌트에 이스케이프 8중창을 포함할 수 없습니다. 따라서, 이 메서드는 복호화를 실행하지 않습니다.

반환값:

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

getPort

public int getPort()

이 URI 포트 번호를 리턴합니다.

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

반환값:

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

getRawPath

public String  getRawPath()

이 URI 그대로의 파스콘포넨트를 리턴합니다.

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

반환값:

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

getPath

public String  getPath()

이 URI 복호화 된 파스콘포넨트를 리턴합니다.

이 메서드로부터 리턴된 캐릭터 라인은, getRawPath 메서드로부터 리턴된 캐릭터 라인과 같습니다. 다만, 이스케이프 8중창의 순서가 모두복호화 되는 경우를 제외합니다.

반환값:

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

getRawQuery

public String  getRawQuery()

이 URI 그대로의 쿼리컴퍼넌트를 리턴합니다.

URI 쿼리컴퍼넌트에는 (정의되고 있는 경우), 유효한 URI 문자만이 포함됩니다.

반환값:

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

getQuery

public String  getQuery()

이 URI 복호화 된 쿼리컴퍼넌트를 리턴합니다.

이 메서드로부터 리턴된 캐릭터 라인은, getRawQuery 메서드로부터 리턴된 캐릭터 라인과 같습니다. 다만, 이스케이프 8중창의 순서가 모두복호화 되는 경우를 제외합니다.

반환값:

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

getRawFragment

public String  getRawFragment()

이 URI 그대로의 fragment 컴퍼넌트를 리턴합니다.

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

반환값:

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

getFragment

public String  getFragment()

이 URI 복호화 된 fragment 컴퍼넌트를 리턴합니다.

이 메서드로부터 리턴된 캐릭터 라인은, getRawFragment 메서드로부터 리턴된 캐릭터 라인과 같습니다. 다만, 이스케이프 8중창의 순서가 모두복호화 되는 경우를 제외합니다.

반환값:

이 URI 복호화 된 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 된 형식이 아니고 그대로의 형식에서 비교되어 이스케이프 8중창의 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(URI  that)

이 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 <URI > 내의 compareTo

파라미터:

that - 이 URI와 비교하는 객체

반환값:

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

예외:

ClassCastException - 지정된 객체가 URI가 아닌 경우

toString

public String  toString()

이 URI 컨텐츠를 캐릭터 라인으로서 리턴합니다.

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

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 URI 캐릭터 라인 형식

toASCIIString

public String  toASCIIString()

이 URI 컨텐츠를 US-ASCII 캐릭터 라인으로서 리턴합니다.

이 URI에 「그 외」의 카테고리의 문자가 포함되지 않은 경우는 이 메서드를 호출하면 toString 메서드를 호출했을 때와 같은 값이 리턴됩니다 . 그렇지 않은 경우, 이 메서드는 그 메서드를 호출해 결과를encode 하는것 같이 동작합니다.

반환값:

이 URI 캐릭터 라인 형식. 필요에 따라서, US-ASCII 캐릭터셋의 문자만을 포함하도록 encode 된다