JavaTM Platform
Standard Ed. 6

javax.management.remote
클래스 JMXServiceURL

java.lang.Object 
  상위를 확장 javax.management.remote.JMXServiceURL
모든 구현된 인터페이스:
Serializable


public class JMXServiceURL
extends Object
implements Serializable

JMX API 연결기 서버의 주소입니다. 이 클래스의 인스턴스는 불변입니다.

RFC 2609 의 정의 및 RFC 3111 에서의 수정에 따라, 이 주소가 SLP 의 「추상 서비스 URL」가 됩니다. 다음과 같은 형식이 됩니다.

service:jmx:protocol:sap

protocol 는, 연결기 서버에 접속할 때 사용하는 전송 프로토콜입니다. 1 문자 이상의 ASCII 문자로부터 완성되는 캐릭터 라인입니다. 사용 가능한 문자는, 영문자와 숫자외,+ 라고 - 의 어느쪽이든 1 개(살)입니다. 최초의 문자는 영문자가 아니면 안됩니다. 영문자의 대문자는 소문자에 변환됩니다.

sap 는, 연결기 서버가 검출된 주소입니다. 이 주소는, IP 베이스의 프로토콜에 대해 정의하는 RFC 2609 의 구문의 부분집합을 사용합니다. 부분집합을 사용하는 이유는,user@host 구문이 지원되어 있지 않기 때문입니다.

이 클래스는, 현재, RFC 2609 에 정의되고 있는 그 외의 구문은 지원하지 않습니다.

지원되고 있는 구문은 다음과 같습니다.

//[host[:port]][url-path]

꺽쇄묶음 [] 은, 주소의 옵션 부분을 나타냅니다. 프로토콜에 의해, 옵션 부분이 인식되지 않는 경우도 있습니다.

host 는, 호스트명, IPv4 수치 호스트 주소, IPv6 수치 주소의 머지않아인가입니다. 모두 꺽쇄묶음으로 둘러싸인 형식이 됩니다.

port 는 10 진포트 번호입니다. 프로토콜에 의해, 0 은 디폴트 또는 익명 포트를 나타냅니다.

hostport 는 생략 가능합니다. port 는 반드시 host 와 함께 지정합니다.

url-path 는, slash (/) 또는 세미콜론 (;)으로 시작되는 주소입니다. RFC 2609 로 지정된 세미콜론 구문을 사용해, 속성을 포함할 수가 있습니다. 이 클래스는, 이러한 속성을 해석하지 않습니다. 따라서, 속성 구문이 부정한 경우도 검출되지 않습니다.

RFC 2609 에 의하면, 세미콜론으로 시작되는 url-path 는 정당한 주소입니다만, SLP 의 구현안에는, 이것을 허가하지 않는 것도 있습니다. 따라서, 이 구문의 사용은 피해야 합니다.

초기 service:jmx:protocol 캐릭터 라인이나, 주소의 호스트 부분에서는, 영문자는 대문자에서도 소문자에서도 괜찮습니다. 다만, 프로토콜에 따라서는,url-path 내의 영문자의 대문자와 소문자가 구별됩니다.

도입된 버젼:
1.5
관련 항목:
RFC 2609, "Service Templates and Service:Schemes" , RFC 3111, "Service Location Protocol Modifications for IPv6" , 직렬화 된 형식

생성자 의 개요
JMXServiceURL (String  serviceURL)
          서비스 URL 캐릭터 라인을 해석해 JMXServiceURL 를 작성합니다.
JMXServiceURL (String  protocol, String  host, int port)
          지정된 프로토콜, 호스트, 및 포트로 JMXServiceURL 를 작성합니다.
JMXServiceURL (String  protocol, String  host, int port, String  urlPath)
          지정된 부분에서,JMXServiceURL 를 작성합니다.
 
메소드의 개요
 boolean equals (Object  obj)
          이 객체와 동등의 객체가 있을지 어떨지를 나타냅니다.
 String getHost ()
          서비스 URL 의 호스트 부분입니다.
 int getPort ()
          서비스 URL 의 포트입니다.
 String getProtocol ()
          서비스 URL 의 프로토콜 부분입니다.
 String getURLPath ()
          서비스 URL 의 URL 패스 부분입니다.
 int hashCode ()
          객체의 해시 코드값를 돌려줍니다.
 String toString ()
          이 서비스 URL 의 캐릭터 라인 표현입니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , finalize , getClass , notify , notifyAll , wait , wait , wait
 

생성자 의 상세

JMXServiceURL

public JMXServiceURL(String  serviceURL)
              throws MalformedURLException 

서비스 URL 캐릭터 라인을 해석해 JMXServiceURL 를 작성합니다.

파라미터:
serviceURL - 구문 분석 되는 URL 캐릭터 라인
예외:
NullPointerException - serviceURL 가 null 의 경우
MalformedURLException - serviceURL 가 하지만 추상 서비스 URL 의 구문에 준거하고 있지 않는 경우, 또는 JMX 원격 API 서비스를 나타내는 유효한 이름이 아닌 경우. JMXServiceURL 의 선두 캐릭터 라인은 "service:jmx:"(대문자와 소문자의 구별 없음)로, 프린트 가능 ASCII 문자 이외의 문자를 포함할 수 없다

JMXServiceURL

public JMXServiceURL(String  protocol,
                     String  host,
                     int port)
              throws MalformedURLException 

지정된 프로토콜, 호스트, 및 포트로 JMXServiceURL 를 작성합니다. 이 생성자 은,JMXServiceURL(protocol, host, port, null) 와 동등합니다.

파라미터:
protocol - URL 의 프로토콜 부분. null 의 경우, 디폴트의 jmxmp 가 되는
host - URL 의 호스트 부분. null 의 경우, InetAddress.getLocalHost(). getHostName() 로 확인되었다 로컬 호스트명 (디폴트)이 된다. IPv6 수치 주소의 경우, 옵션으로서 꺽쇄묶음 [] 으로 둘러쌀 수가 있는
port - URL 의 포트 부분
예외:
MalformedURLException - 구문이 올바르지 않은 부분이 존재하는 경우, host 가 null 로 로컬 호스트명을 검출할 수 없는 경우, 또는 port 가 0 보다 작은 값의 경우

JMXServiceURL

public JMXServiceURL(String  protocol,
                     String  host,
                     int port,
                     String  urlPath)
              throws MalformedURLException 

지정된 부분에서,JMXServiceURL 를 작성합니다.

파라미터:
protocol - URL 의 프로토콜 부분. null 의 경우, 디폴트의 jmxmp 가 되는
host - URL 의 호스트 부분. null 의 경우, InetAddress.getLocalHost(). getHostName() 로 확인되었다 로컬 호스트명 (디폴트)이 된다. IPv6 수치 주소의 경우, 옵션으로서 꺽쇄묶음 [] 으로 둘러쌀 수가 있는
port - URL 의 포트 부분
urlPath - URL 의 URL 패스 부분. null 의 경우, 공문자열이 된다
예외:
MalformedURLException - 구문이 올바르지 않은 부분이 존재하는 경우, host 가 null 로 로컬 호스트명을 검출할 수 없는 경우, 또는 port 가 0 보다 작은 값의 경우
메소드의 상세

getProtocol

public String  getProtocol()

서비스 URL 의 프로토콜 부분입니다.

반환값:
서비스 URL 의 프로토콜 부분. null 는 불가

getHost

public String  getHost()

서비스 URL 의 호스트 부분입니다. 이 서비스 URL 가, URL 캐릭터 라인 파라미터를 취하는 생성자 으로 작성된 것인 경우, 결과는, 이 URL 내의 호스트를 지정하는 서브 캐릭터 라인에 일치합니다. 이 서비스 URL 가, 개별의 호스트 파라미터를 취하는 생성자 으로 작성된 것인 경우, 결과는, 지정된 캐릭터 라인에 일치합니다. 이 캐릭터 라인이 null 였을 경우, 결과는,InetAddress.getLocalHost(). getHostName() 가 됩니다.

어느 경우도, 호스트가 IPv6 수치 주소의 [...] 구문으로 지정되고 있는 경우, 여기서의 반환값에 꺽쇄묶음은 포함되지 않습니다.

반환값:
서비스 URL 의 호스트 부분. null 는 불가

getPort

public int getPort()

서비스 URL 의 포트입니다. 포트가 지정되지 않았던 경우, 반환값은 0 입니다.

반환값:
서비스 URL 의 포트. 존재하지 않는 경우는 0

getURLPath

public String  getURLPath()

서비스 URL 의 URL 패스 부분입니다. 이것은, 공문자열, slash (/)로 시작되는 캐릭터 라인, 또는 세미콜론 (;)으로 시작되는 캐릭터 라인입니다.

반환값:
서비스 URL 의 URL 패스 부분. null 는 불가

toString

public String  toString()

이 서비스 URL 의 캐릭터 라인 표현입니다. 이 메소드에 의해 반환되는 값이 JMXServiceURL 생성자 에게 건네지는 경우, 결과적으로, 이 캐릭터 라인 표현과 동등의 객체가 생성됩니다.

반환되는 캐릭터 라인의 host 부분은,getHost() 의 반환값에 일치합니다. 이 값이 IPv6 수치 주소를 지정하는 경우, 꺽쇄묶음 [] 으로 둘러싸인 형식이 됩니다.

반환되는 캐릭터 라인의 port 부분은,getPort() 에 의해 반환되는 제일 짧은 10 진형식의 값입니다. 값이 0 의 경우는 생략 됩니다.

오버라이드(override):
클래스 Object 내의 toString
반환값:
이 서비스 URL 의 캐릭터 라인 표현

equals

public boolean equals(Object  obj)

이 객체와 동등의 객체가 있을지 어떨지를 나타냅니다. 이 메소드는,obj 가, 이 객체와 같은 값을 돌려주는 getProtocol() ,getHost() ,getPort() , 및 getURLPath() 메소드를 가지는 JMXServiceURL 의 인스턴스인 경우에 한해, true 를 돌려줍니다. getProtocol()getHost() 의 값의 대문자와 소문자는 구별되지 않습니다. 비교 대상의 참조 객체

오버라이드(override):
클래스 Object 내의 equals
파라미터:
obj - 비교 대상의 참조 객체
반환값:
이 객체가 obj 인수로 지정한 객체와 동일한 경우는 true, 그렇지 않은 경우는 false
관련 항목:
Object.hashCode() , Hashtable

hashCode

public int hashCode()
클래스 Object 의 기술:
객체의 해시 코드값를 돌려줍니다. 이 메소드는,java.util.Hashtable 에 의해 제공되는 것 같은 해시 테이블로 사용하기 위해서 준비되어 있습니다.  

hashCode 메소드의 일반적인 규칙을 다음에 나타냅니다.

  • Java 어플리케이션의 실행중에 같은 객체상에서 여러 차례 불려 가는 경우는 반드시, 이 객체에 대한 equals 에 의한 비교로 사용된 정보가 변경되어 있지 않으면,hashCode 메소드는 같은 정수를 일관해 돌려주지 않으면 안 된다. 다만, 이 정수는 같은 어플리케이션의 실행 마다 같은 필요는 없다
  • equals(Object) 메소드로 2 개의 객체가 등가로 여겨졌을 경우, 어느 쪽의 객체로 hashCode 메소드를 호출해도 결과는 같은 정수치가 되어야 하다
  • Object.equals(java.lang.Object) 메소드로 2 개의 객체가 등가가 아니다고 여겨졌을 경우는, 이러한 객체에 대해서 hashCode 메소드를 호출했을 때에, 결과가 다른 정수치가 되지 않아도 상관없다. 그러나, 동일하지 않은 객체에 대해서는 다른 정수치가 생성되도록 하면, 해시 테이블의 퍼포먼스를 올릴 수가 있다

할 수 있는 한,Object 클래스에서 정의되는 hashCode 메소드는, 다른 객체에 대해서는 다른 정수치를 돌려줍니다. 일반적으로, 이것은 객체의 내부 주소를 정수치로 변환하는 형태로 구현됩니다만, 그러한 구현 테크닉은 JavaTM 프로그램 언어에서는 불필요합니다.

오버라이드(override):
클래스 Object 내의 hashCode
반환값:
이 객체의 해시 코드값
관련 항목:
Object.equals(java.lang.Object) , Hashtable

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.