URL (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.net
클래스 URL

java.lang.Object 
  java.net.URL

모든 구현된 인터페이스:: Serializable

public final class URL
extends Object
implements Serializable
extends Object
implements Serializable

URL 클래스는 World Wide Web 상의 「자원」을 가리키는 포인터인 URL (Uniform Resource Locator)를 나타냅니다. 자원은 파일이나 디렉토리와 같이 단순한 것임도, 좀 더 복잡한 객체 (데이타베이스나 검색 엔진에의 쿼리 등)에의 참조인 일도 있습니다. URL 형태와 그 형식에 대한자세한 내용은 다음의 Web 사이트에서 참조할 수 있습니다 .

http://archive.ncsa.uiuc.edu:80/SDG/Software/Mosaic/Demo/url-primer.html

일반적으로 URL는 몇개의 부분으로 나누어져 있습니다. 상기의 예의 URL는 사용하는 프로토콜이 http (HyperText Transfer Protocol)인 것으로www.ncsa.uiuc.edu 라는 이름의 호스트상에 정보가 있는 것을 나타내고 있습니다. 그리고, 호스트 머신상에 있는 정보의 이름은 /demoweb/url-primer.html 입니다. 호스트 머신상에 있는 정보의 이름의 정확한 미는 프로토콜 및 호스트의 양쪽 모두에 존하고 있습니다. 일반적으로는 정보는 파일내에 보존되고 있습니다만, 동적으로 생성되는 경우도 있습니다. URL 이러한 부분은 파스콘포넨트로 불립니다.

URL에는 옵션으로 「포트」를 지정할 수 있습니다 . 이것은 TCP 접속을 확립하는 리모트 호스트 머신상의 포트 번호를 나타냅니다. 포트 번호를 지정하지 않는 경우는 그 프로토콜의 디폴트의 포트 번호가 사용됩니다. 예를 들어, http 디폴트의 포트 번호는 80 입니다. 다른 포트를 사용하는 경우는 예를 들어 다음과 같이 지정합니다.

 http://archive.ncsa.uiuc.edu:80/SDG/Software/Mosaic/Demo/url-primer.html

URL 구문은, 「RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax」(개정판은「RFC 2732: Format for Literal IPv6 Addresses in URLs 」)에 정의되고 있습니다. IPv6 리터럴 주소 형식도 scope_ids를 지원 합니다. scope_ids 구문과 사용 방법에 대해서는 여기를 참조하십시오.

URL에는 「fragment」( 「ref」또는 「참조 (reference)」라고도 부른다)를 추가할 수 있습니다. fragment를 지정하려면, 샤프 기호 「#」의 후에 캐릭터 라인을 지정합니다. 다음에 fragment의 예를 나타냅니다.

 http://java.sun.com/index.html#chapter1

기술적으로는 이 fragment는 URL 일부에서는 없습니다. 예를 들어 위에 나타낸 fragment는 지정된 자원을 취득한뒤 그 문서 안에서 chapter1 라고 하는 태그가 붙어 있는 부분을 어플리케이션에 한 처리의 대상으로 하는 것을 나타냅니다. 태그의 미는 자원에 따라서 다릅니다.

어플리케이션은 「상대 URL」를 지정할 수도 있습니다. 상대 URL는 다른 URL를 기준으로서 상대적으로 자원을 검색하기 위한 정보만을 포함하고 있습니다. 상대 URL는 HTML 페이지내에서 자주 사용됩니다. 예를 들어 다음의 URL가 있다고 합니다.

 http://java.sun.com/index.html

이 HTML 페이지안에 다음의 상대 URL가 포함되어 있다고 합니다.

 FAQ.html

이것은 다음의 URL 단축형이라고 보여집니다.

 http://java.sun.com/FAQ.html

상대 URL가 URL 컴퍼넌트를 모두 지정할 필요는 없습니다. 프로토콜이나 호스트명, 포트 번호를 생략 했을 경우에는 모든 컴퍼넌트가 가리키는 URL 로부터 정보가 상속됩니다. 다만, 파일 컴퍼넌트의 지정은 필수입니다. 옵션지정의 fragment는 상속되지 않습니다.

URL 클래스 자체가 RFC2396에 정의되고 있는 이스케이프 도구에 따라 URL 컴퍼넌트의 encode나 디코드를 실시할 것은 없습니다. URL를 호출하기 전에 이스케이프 할 필요가 있는 필드의 encode와 URL 로부터 리턴된 이스케이프 된 필드의 디코드는 호출측이 책임을 가지고 실시합니다. URL는 URL 이스케이프의 지식을 가지고 있지 않기 때문에 같은 URL encode 된 형식과 디코드된 형식의 등가성을 인식하지 않습니다. 예를 들어 다음의 2개의 URL가 있다고 합니다.

    http://foo.com/hello world/ and http://foo.com/hello%20world

이것들은 다른 URL 라고 보여집니다.

URI 클래스는 특정의 상황으로 그 컴퍼넌트 필드의 이스케이프를 실시합니다. URL encode와 디코드의 관리에는 URI를 사용해, 이것들 2개의 클래스의 상호 변환에는 toURI() 와 URI.toURL()를 사용하는 것을 추천합니다.

URLEncoder 클래스와 URLDecoder 클래스도 사용할 수 있습니다만, 이것들은 HTML 형식의 encode (RFC2396에 정의되고 있는 encode schema와는 다르다) 전용입니다.

도입된 버전 :: JDK1. 0
관련 항목:: 직렬화 된 형식

생성자 개요
`URL (String spec)` `String` 표현으로부터 `URL` 객체를 작성합니다.
`URL (String protocol, String host, int port, String file)` 지정된 `protocol`, `host`, `port` 번호 및 `file`로 부터 `URL` 객체를 작성합니다.
`URL (String protocol, String host, int port, String file, URLStreamHandler handler)` 지정된 `protocol`, `host`, `port` 번호, `file` 및 `handler`를 사용해, `URL` 객체를 작성합니다.
`URL (String protocol, String host, String file)` 지정된 `protocol` 명, `host` 명 및 `file` 명을 사용해, URL를 작성합니다.
`URL (URL context, String spec)` 지정된 컨텍스트 내의 지정된 사양으로 구문 분석 하는 것에의해 URL를 생성합니다.
`URL (URL context, String spec, URLStreamHandler handler)` 지정된 컨텍스트 내의 지정된 핸들러로 지정된 사양을 구문 분석의해 URL를 생성합니다.

메서드 개요
`boolean`	`equals (Object obj)` 이 URL와 다른 객체가 동일한지 어떤지를 비교합니다.
`String`	`getAuthority ()` 이 `URL` 권한 부분을 취득합니다.
`Object`	`getContent ()` 이 URL 컨텐츠를 취득합니다.
`Object`	`getContent (Class [] classes)` 이 URL 컨텐츠를 취득합니다.
`int`	`getDefaultPort ()` 이 `URL`에 관련된 프로토콜의 디폴트의 포트 번호를 취득합니다.
`String`	`getFile ()` 이 `URL` 파일명을 취득합니다.
`String`	`getHost ()` 해당하는 경우, 이 `URL` 호스트명을 취득합니다.
`String`	`getPath ()` 이 `URL` 패스 부분을 취득합니다.
`int`	`getPort ()` 이 `URL` 포트 번호를 취득합니다.
`String`	`getProtocol ()` 이 `URL` 프로토콜명을 취득합니다.
`String`	`getQuery ()` 이 `URL` 쿼리부분을 취득합니다.
`String`	`getRef ()` 이 `URL` 엥커 ( 「참조」라고도 불린다)를 취득합니다.
`String`	`getUserInfo ()` 이 `URL` 사용자 정보부분을 취득합니다.
`int`	`hashCode ()` 해시 테이블의 인덱스부에 적절한 int값을 작성합니다.
`URLConnection`	`openConnection ()` `URL`가 참조하는 리모트 객체에의 접속을 나타내는 `URLConnection` 객체를 리턴합니다.
`URLConnection`	`openConnection (Proxy proxy)` 접속이 지정된 프록시를 개입시켜 행해지는 경우를 제외해, openConnection()와 같습니다.
`InputStream`	`openStream ()` 이 `URL`에 의 접속을 확립해, 그 접속으로부터 read를 행하기 위한 `InputStream`를 리턴합니다.
`boolean`	`sameFile (URL other)` fragment 컴퍼넌트 이외의 2개의 URL를 비교합니다.
`protected void`	`set (String protocol, String host, int port, String file, String ref)` URL 필드를 설정합니다.
`protected void`	`set (String protocol, String host, int port, String authority, String userInfo, String path, String query, String ref)` 지정된 URL 8 필드를 설정합니다.
`static void`	`setURLStreamHandlerFactory (URLStreamHandlerFactory fac)` 어플리케이션의 `URLStreamHandlerFactory`를 설정합니다.
`String`	`toExternalForm ()` 이 `URL` 캐릭터 라인 표현을 구축합니다.
`String`	`toString ()` 이 `URL` 캐릭터 라인 표현을 구축합니다.
`URI`	`toURI ()` 이 URL와 등가 `URI`를 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

생성자 상세

URL

public URL(String  protocol,
           String  host,
           int port,
           String  file)
    throws MalformedURLException

지정된 protocol, host, port 번호 및 file로 부터 URL 객체를 작성합니다.

host는 호스트명 또는 리터럴 IP 주소로서 표현할 수 있습니다. IPv6 리터럴 주소를 사용하는 경우는 「RFC 2732」로 지정되고 있도록, 꺽쇄묶음 ([ 및 ])으로 둘러쌀 필요가 있습니다. 다만, 「RFC 2373: IP Version 6 Addressing Architecture」로 정의되고 있는 리터럴 IPv6 주소의 형식도 사용할 수 있습니다.

port 번호 -1 지정은 URL가 프로토콜의 디폴트의 포트를 사용하는 것을 나타냅니다.

지정된 프로토콜로 최초로 URL 객체를 작성할 경우에는 그 프로토콜을 위한 스트림 프로토콜 핸들러 객체가 작성됩니다. 이 스트림 프로토콜 핸들러 객체는 URLStreamHandler 클래스의 인스턴스입니다.

이전에 어플리케이션이 URLStreamHandlerFactory 인스턴스를 스트림 핸들러 팩토리로서 설정해 있는 경우는 그 인스턴스의 createURLStreamHandler 메서드가 프로토콜 캐릭터 라인을 인수로서 불려가, 스트림 프로토콜 핸들러를 작성한다
아직 URLStreamHandlerFactory가 설정되어 있지 않은 경우, 혹은 팩토리의 createURLStreamHandler 메서드가 null을 돌려주었을 경우는 생성자가 다음의 시스템 프로퍼티의 값을 찾는다
```
 java.protocol.handler.pkgs
```
이 시스템 프로퍼티의 값이 null이 아니면, 값은 수직 slash 문자 「|」으로 단락지어진, 패키지의 리스트로서 해석된다. 생성자는 다음의 이름의 클래스를 로드하려고 한다
```
 <package>. <protocol>.Handler
```
여기서, <package>에 는 패키지의 이름이 들어가 <protocol>에 는 프로토콜의 이름이 들어간다. 이 클래스가 존재하지 않는 경우, 혹은 클래스는 존재해도 그것이 URLStreamHandler 서브 클래스가 아닌 경우에는 리스트에 있는 다음의 클래스를 시험하게 된다
이상의 순서에서도 프로토콜 핸들러가 발견되지 않았던 경우, 생성자는 시스템의 디폴트 패키지로부터 로드하려고 한다
```
 <system default package>. <protocol>.Handler
```
이 클래스가 존재하지 않는 경우, 혹은 클래스는 존재해도 그것이 URLStreamHandler 서브 클래스가 아닌 경우에는 MalformedURLException가 Throw 된다

검색 패스상에는 다음의 프로토콜의 프로토콜 핸들러가 확실히 존재하게 되어 있습니다.

 http, https, ftp, file 및 jar

그 외의 프로토콜의 프로토콜 핸들러도 사용할 수 있습니다.

이 생성자에 한 입력의 검증은 실행되지 않습니다.

파라미터:: protocol - 사용하는 프로토콜명; host - 호스트명; port - 호스트상에서의 포트 번호; file - 호스트상의 파일
예외:: MalformedURLException - 미지의 프로토콜로서 지정되었을 경우
관련 항목:: System.getProperty(java.lang.String), setURLStreamHandlerFactory( java.net.URLStreamHandlerFactory), URLStreamHandler, URLStreamHandlerFactory.createURLStreamHandler( java.lang.String)

URL

public URL(String  protocol,
           String  host,
           String  file)
    throws MalformedURLException

지정된 protocol 명, host 명 및 file 명을 사용해, URL를 작성합니다. 지정된 프로토콜의 디폴트의 포트를 사용합니다.

이 메서드의 기능은 인수에 protocol, host, -1, file를 지정해 4개의 인수를 받는 생성자를 호출하는 것과 같습니다.이 생성자에 한 입력의 검증은 실행되지 않습니다.

파라미터:: protocol - 사용하는 프로토콜명; host - 호스트명; file - 호스트상의 파일
예외:: MalformedURLException - 미지의 프로토콜로서 지정되었을 경우
관련 항목:: URL(java.lang.String, java.lang.String, int, java.lang.String)

URL

public URL(String  protocol,
           String  host,
           int port,
           String  file,
           URLStreamHandler  handler)
    throws MalformedURLException

지정된 protocol, host, port 번호, file 및 handler를 사용해, URL 객체를 작성합니다. port 번호에 -1를 지정하면, URL 에서는 프로토콜의 디폴트의 포트가 사용됩니다. handler에 null을 지정하면, URL 에서는 다음에 나타내는 프로토콜의 디폴트의 스트림 핸들러가 사용됩니다. java.net.URL#URL(java.lang.String, java.lang.String, int, java.lang.String).

핸들러가 null은 아니고, 시큐러티 매니저가 존재하는 경우, NetPermission("specifyStreamHandler") 접근 권한을 지정해 시큐러티 매니저의 checkPermission 메서드가 호출됩니다. 이 결과, SecurityException가 되는 일이 있습니다.이 생성자에 한 입력의 검증은 실행되지 않습니다.

파라미터:: protocol - 사용하는 프로토콜명; host - 호스트명; port - 호스트상에서의 포트 번호; file - 호스트상의 파일; handler - URL 스트림 핸들러
예외:: MalformedURLException - 미지의 프로토콜로서 지정되었을 경우; SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPermission 메서드가 스트림 핸들러의 명시적인 지정을 허가하지 않는 경우
관련 항목:: System.getProperty(java.lang.String), setURLStreamHandlerFactory( java.net.URLStreamHandlerFactory), URLStreamHandler, URLStreamHandlerFactory.createURLStreamHandler( java.lang.String), SecurityManager.checkPermission(java.security.Permission), NetPermission

URL

public URL(String  spec)
    throws MalformedURLException

String 표현으로부터 URL 객체를 작성합니다.

이 생성자는 1번째의 인수에 null을 지정해, 인수가 2개의 생성자를 호출하는 것과 같습니다.

파라미터:: spec - URL 로서 구문 분석 되는 String
예외:: MalformedURLException - 캐릭터 라인으로 지정된 프로토콜이 미지인 경우
관련 항목:: URL(java.net.URL, java.lang.String)

URL

public URL(URL  context,
           String  spec)
    throws MalformedURLException

지정된 컨텍스트 내의 지정된 사양으로 구문 분석 하는 것에의해 URL를 생성합니다. 지정된 URL와 RFC2396 「자원 식별자의 통일: 일반 구문」으로 진술되고 있는 사양의 인수로 새로운 URL가 생성됩니다.

 <scheme>://<authority><path>? <query>#<fragment>

참조는 schema, 권한, 패스, 쿼리 및 fragment의 각 부분에 구문 분석 됩니다. 파스콘포넨트가 비어있는 schema, 권한 및 쿼리의 각 컴퍼넌트가 미정도리의 경우, 새로운 URL가 현재의 문서에의 참조가 됩니다. 그 외의 경우는 사양의 fragment 부분과 쿼리부분이 새로운 URL에 사용됩니다.

지정된 사양으로 schema 컴퍼넌트가 정의되어 그 schema 컴퍼넌트가 컨텍스트 의 schema와 일치하지 않는 경우, 사양인 만큼 기초를 두는 절대 URL 로서 새로운 URL가 생성됩니다. 그렇지 않은 경우는 schema 컴퍼넌트는 컨텍스트 URL를 상속합니다.

권한 컴퍼넌트가 사양에 있는 경우에는 사양은 절대적인 것으로의해 다루어져 사양의 권한과 패스는 컨텍스트 의 권한과 패스를 치환합니다. 사양에 권한 컴퍼넌트가 없는 경우, 새로운 URL 권한은 컨텍스트를 상속합니다.

사양의 파스콘포넨트가 slash 문자 「/」으로 시작되는 경우, 패스는 절대적인 것으로의해 다루어져 사양의 패스가 컨텍스트 의 패스를 치환합니다.

그 외의 경우, RFC2396 로 설명되고 있도록, 패스는 상대 패스로 해서 다루어져 컨텍스트 패스에 추가됩니다. 또, 이 경우 「..」 및 「.」에 의해 행해진 디렉토리 변경을 삭제하는 것으로 패스는 표준화 됩니다.

URL 구문 분석의 상세한 설명에 대해서는 RFC2396를 참조하십시오.

파라미터:: context - 사양을 구문 분석 하는 컨텍스트; spec - URL 로서 구문 분석 되는 String
예외:: MalformedURLException - 프로토콜이 지정되어 있지 않은지, 미지의 프로토콜이 발견되었을 경우
관련 항목:: URL(java.lang.String, java.lang.String, int, java.lang.String), URLStreamHandler, URLStreamHandler.parseURL(java.net.URL, java.lang.String, int, int)

URL

public URL(URL  context,
           String  spec,
           URLStreamHandler  handler)
    throws MalformedURLException

지정된 컨텍스트 내의 지정된 핸들러로 지정된 사양을 구문 분석의해 URL를 생성합니다.

파라미터:: context - 사양을 구문 분석 하는 컨텍스트; spec - URL 로서 구문 분석 되는 String; handler - URL 스트림 핸들러
예외:: MalformedURLException - 프로토콜이 지정되어 있지 않은지, 미지의 프로토콜이 발견되었을 경우; SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPermission 메서드가 스트림 핸들러의 지정을 허가하지 않는 경우
관련 항목:: URL(java.lang.String, java.lang.String, int, java.lang.String), URLStreamHandler, URLStreamHandler.parseURL(java.net.URL, java.lang.String, int, int)

메서드의 상세

set

protected void set(String  protocol,
                   String  host,
                   int port,
                   String  file,
                   String  ref)

URL 필드를 설정합니다. 이것은 public 메서드는 아니기 때문에 URL 필드를 수정할 수 있는 것은 URLStreamHandlers 만입니다. 그 이외의 URL는 정수입니다.

파라미터:: protocol - 사용하는 프로토콜명; host - 호스트명 @param port 호스트상의 포트 번호; file - 호스트상의 파일; ref - URL 내부 참조

set

protected void set(String  protocol,
                   String  host,
                   int port,
                   String  authority,
                   String  userInfo,
                   String  path,
                   String  query,
                   String  ref)

지정된 URL 8 필드를 설정합니다. 이것은 public 메서드는 아니기 때문에 URL 필드를 수정할 수 있는 것은 URLStreamHandlers 만입니다. 그 이외의 URL는 정수입니다.

파라미터:: protocol - 사용하는 프로토콜명; host - 호스트명; port - 호스트상에서의 포트 번호; authority - URL 권한 부분; userInfo - 사용자 명 및 패스워드; path - 호스트상의 파일; ref - URL 내부 참조; query - 이 URL 쿼리부분
도입된 버전 :: 1.3

getQuery

public String  getQuery()

이 URL 쿼리부분을 취득합니다.

반환값:: 이 URL 쿼리부분. 존재하지 않는 경우는 null
도입된 버전 :: 1.3

getPath

public String  getPath()

이 URL 패스 부분을 취득합니다.

반환값:: 이 URL 패스 부분. 존재하지 않는 경우는 비어있는 캐릭터 라인
도입된 버전 :: 1.3

getUserInfo

public String  getUserInfo()

이 URL 사용자 정보부분을 취득합니다.

반환값:: 이 URL 사용자 정보부분. 존재하지 않는 경우는 null

getAuthority

public String  getAuthority()

이 URL 권한 부분을 취득합니다.

반환값:: 이 URL 권한 부분
도입된 버전 :: 1.3

getPort

public int getPort()

이 URL 포트 번호를 취득합니다.

반환값:: 포트 번호. 포트가 설정되어 있지 않은 경우는 -1

getDefaultPort

public int getDefaultPort()

이 URL에 관련된 프로토콜의 디폴트의 포트 번호를 취득합니다. URL schema 또는 URL URLStreamHandler가 디폴트의 포트 번호를 정의하지 않는 경우는 -1 이 리턴됩니다 .

반환값:: 포트 번호

getProtocol

public String  getProtocol()

이 URL 프로토콜명을 취득합니다.

반환값:: 이 URL 프로토콜

getHost

public String  getHost()

해당하는 경우, 이 URL 호스트명을 취득합니다. 호스트명의 형식은 RFC 2732에 준거합니다. 즉, 리터럴 IPv6 주소의 경우, 이 메서드는 꺽쇄묶음 ([ 및 ])으로 둘러싸인 IPv6 주소를 리턴합니다.

반환값:: 이 URL 호스트명

getFile

public String  getFile()

이 URL 파일명을 취득합니다. 리턴된 파일 부분은 getPath()와 같습니다. 이것에 getQuery()가 있는 경우는 그 값이 연결됩니다. 쿼리부분이 존재하지 않는 경우, 이 메서드 및 getPath() 반환값은 같게 됩니다.

반환값:: 이 URL 파일명. 존재하지 않는 경우는 비어있는 캐릭터 라인

getRef

public String  getRef()

이 URL 엥커 ( 「참조」라고도 불린다)를 취득합니다.

반환값:: 이 URL 엥커 ( 「참조」라고도 불린다). 존재하지 않는 경우는 null

equals

public boolean equals(Object  obj)

이 URL와 다른 객체가 동일한지 어떤지를 비교합니다.

지정된 객체가 URL가 아닌 경우, 이 메서드는 즉시 false를 리턴합니다.

2개의 URL 객체가 동일한 것은 같은 프로토콜을 가져, 같은 호스트를 참조해, 호스트상의 포트 번호가 같아, 파일과 파일의 fragment가 같은 경우입니다.

2 살의 호스트가 등가라고 보여지는 것은 양쪽 모두의 호스트명이 같은 IP 주소에 해결되는지, 어느 쪽인가의 호스트명을 해결할 수 없는 경우는 대문자나 소문자인가에 관계없이 호스트명이 동일한지, 양쪽 모두의 호스트명이 null에 동일한 경우입니다.

호스트 비교에는 이름 해석이 필요해서, 이 조작은 블록 조작입니다.

주: equals 정의된 동작은 HTTP 가상 호스트와 일치하지 않는 것이 알려져 있습니다.

오버라이드(override):: 클래스 Object 내의 equals

파라미터:: obj - 비교 대상의 URL
반환값:: 객체가 같은 경우는 true, 그렇지 않은 경우는 false
관련 항목:: Object.hashCode(), Hashtable

hashCode

public int hashCode()

해시 테이블의 인덱스부에 적절한 int값을 작성합니다.

해시 코드는 URL 비교에 관련된 모든 URL 컴퍼넌트에 근거하고 있습니다. 따라서, 이 조작은 블록 조작입니다.

오버라이드(override):: 클래스 Object 내의 hashCode

반환값:: 이 URL에 사용하는 해시 코드
관련 항목:: Object.equals(java.lang.Object), Hashtable

sameFile

public boolean sameFile(URL  other)

fragment 컴퍼넌트 이외의 2개의 URL를 비교합니다.

fragment 컴퍼넌트를 고려하지 않고, 이 URL와 other인수가 동일한 경우는 true를 리턴합니다.

파라미터:: other - 비교 대상의 URL
반환값:: 2개의 URL가 참조하는 리모트 객체가 같은 경우는 true, 그렇지 않은 경우는 false

toString

public String  toString()

이 URL 캐릭터 라인 표현을 구축합니다. 이 객체의 스트림 프로토콜 핸들러의 toExternalForm 메서드를 호출하는 것에 의해 캐릭터 라인이 작성됩니다.

오버라이드(override):: 클래스 Object 내의 toString

반환값:: 이 객체의 캐릭터 라인 표현
관련 항목:: URL(java.lang.String, java.lang.String, int, java.lang.String), URLStreamHandler.toExternalForm(java.net.URL)

toExternalForm

public String  toExternalForm()

이 URL 캐릭터 라인 표현을 구축합니다. 이 객체의 스트림 프로토콜 핸들러의 toExternalForm 메서드를 호출하는 것에 의해 캐릭터 라인이 작성됩니다.

반환값:: 이 객체의 캐릭터 라인 표현
관련 항목:: URL(java.lang.String, java.lang.String, int, java.lang.String), URLStreamHandler.toExternalForm(java.net.URL)

toURI

public URI  toURI()
          throws URISyntaxException

이 URL와 등가 URI를 리턴합니다. 이 메서드는 new URI (this.toString())와 같게 기능합니다.

RFC2396 로 컴파일 되는 모든 URL 인스턴스는 URI에 변환 가능합니다. 다만, 완전 준거가 아닌 일부의 URL는 URI 로 변환할 수 없습니다.

반환값:: 이 URL와 등가의 URI 인스턴스
예외:: URISyntaxException - 이 URL 형식이 RFC2396에 엄밀하게 따라서, URI 로 변환할 수 없는 경우
도입된 버전 :: 1.5

openConnection

public URLConnection  openConnection()
                             throws IOException

URL가 참조하는 리모트 객체에의 접속을 나타내는 URLConnection 객체를 리턴합니다.

이 URL 프로토콜 핸들러의 openConnection 메서드를 호출할 때마다, 새로운 접속이 열립니다.

HTTP 나 JAR 등의, URL 프로토콜에 대해서는 java.lang, java.io, java.util, 또는 java.net 패키지, 혹은 그 서브 패키지에 속하는 일반 또는 특수한 URLConnection 서브 클래스가 있습니다. 리턴된 접속은 그 서브 클래스의 것이 됩니다. 예를 들어 HTTP 프로토콜에 대해서는 HttpURLConnection가 돌려주고져 JAR에 대해서는 JarURLConnection가 리턴됩니다 .

반환값:: URL 에의 URLConnection
예외:: IOException - 입출력 예외가 발생했을 경우
관련 항목:: URL(java.lang.String, java.lang.String, int, java.lang.String), URLConnection, URLStreamHandler.openConnection(java.net.URL)

openConnection

public URLConnection  openConnection(Proxy  proxy)
                             throws IOException

접속이 지정된 프록시를 개입시켜 행해지는 경우를 제외해, openConnection()와 같습니다. 프록시를 지원 하지 않는 프로토콜 핸들러는 프록시 파라미터를 무시해, 보통 의 접속을 실시합니다.이 메서드를 호출하면, 시스템의 디폴트의 ProxySelector 설정이 횡령됩니다.

파라미터:: proxy - 접속에 사용하는 프록시. 직접 접속이 바람직한 경우는 Proxy.NO_PROXY를 지정할 필요가 있다
반환값:: URL 에의 URLConnection
예외:: IOException - 입출력 예외가 발생했을 경우; SecurityException - 시큐러티 매니저가 존재해, 호출측이 프록시에의 접속을 허가되어 있지 않은 경우; IllegalArgumentException - 프록시가 null인 경우, 또는 프록시의 형태가 올바르지 않은 경우에 Throw 된다; UnsupportedOperationException - 프로토콜 핸들러를 구현하는 서브 클래스가 이 메서드를 지원 하고 있지 않는 경우
도입된 버전 :: 1.5
관련 항목:: URL(java.lang.String, java.lang.String, int, java.lang.String), URLConnection, URLStreamHandler.openConnection(java.net.URL, java.net.Proxy)

openStream

public final InputStream  openStream()
                             throws IOException

이 URL에 의 접속을 확립해, 그 접속으로부터 read를 행하기 위한 InputStream를 리턴합니다. 이 메서드는 다음의 메서드의 단축형입니다.

 openConnection(). getInputStream()

반환값:: URL 접속으로부터 입력을 읽어들이기 위한 입력 스트림
예외:: IOException - 입출력 예외가 발생했을 경우
관련 항목:: openConnection(), URLConnection.getInputStream()

getContent

public final Object  getContent()
                        throws IOException

이 URL 컨텐츠를 취득합니다. 이 메서드는 다음의 메서드의 단축형입니다.

 openConnection(). getContent()

반환값:: 이 URL 컨텐츠
예외:: IOException - 입출력 예외가 발생했을 경우
관련 항목:: URLConnection.getContent()

getContent

public final Object  getContent(Class [] classes)
                        throws IOException

이 URL 컨텐츠를 취득합니다. 이 메서드는 다음의 메서드의 단축형입니다.

 openConnection(). getContent(Class[])

파라미터:: classes - Java 형의 배열
반환값:: 클래스의 배열로 지정된 형태가 최초로 일치한, 이 URL 컨텐츠 객체. 요구된 형태가 지원 되어 있지 않은 경우는 null
예외:: IOException - 입출력 예외가 발생했을 경우
도입된 버전 :: 1.3
관련 항목:: URLConnection.getContent(Class[])

setURLStreamHandlerFactory

public static void setURLStreamHandlerFactory(URLStreamHandlerFactory  fac)

어플리케이션의 URLStreamHandlerFactory를 설정합니다. 이 메서드는 사용하는 Java 가상 머신으로 1회 밖에 호출할 수 없습니다.

URLStreamHandlerFactory인스턴스는 프로토콜명으로부터 스트림 프로토콜 핸들러를 구축하는데 사용됩니다.

시큐러티 매니저가 존재하는 경우, 이 메서드는 최초로 시큐러티 매니저의 checkSetFactory 메서드를 호출하는 것으로 이 조작이 허가되고 있는 것을 확인합니다. 이 결과, SecurityException가 되는 일이 있습니다.

파라미터:: fac - 목적의 팩토리
예외:: Error - 어플리케이션으로 팩토리가 이미 설정되어 있는 경우; SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkSetFactory 메서드가 이 조작을 허가하지 않는 경우
관련 항목:: URL(java.lang.String, java.lang.String, int, java.lang.String), URLStreamHandlerFactory, SecurityManager.checkSetFactory()

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.net 클래스 URL

URL

URL

URL

URL

URL

URL

set

set

getQuery

getPath

getUserInfo

getAuthority

getPort

getDefaultPort

getProtocol

getHost

getFile

getRef

equals

hashCode

sameFile

toString

toExternalForm

toURI

openConnection

openConnection

openStream

getContent

getContent

setURLStreamHandlerFactory

java.net
클래스 URL