javax.management
클래스 ObjectName

java.lang.Object 
  javax.management.ObjectName

모든 구현된 인터페이스:

Serializable , Comparable <ObjectName >, QueryExp

public class ObjectName
extends Object 
implements Comparable <ObjectName >, QueryExp 

MBean 의 객체명, 또는 복수의 MBean 명에 일치하는 패턴을 나타냅니다. 이 클래스의 인스턴스는 불변입니다.

이 클래스의 인스턴스를 사용해, 다음의 항목을 표현할 수가 있습니다.

• 객체명
• 쿼리의 문맥내의 객체명 패턴

객체명은, 도메인의 부분과 키의 프로퍼티의 부분으로부터 완성됩니다.

「도메인」은, 구두점 (:)을 포함하지 않는 캐릭터 라인입니다. 캐릭터 라인 「//」은 향후 사용하기 위해서 예약되고 있기 (위해)때문에, 이 캐릭터 라인은 포함하지 않게 해 주세요.

도메인에 와일드 카드 문자의 asterisk (*)나 물음표 (? )(이)가 포함되어 있는 경우, 객체명은 패턴입니다. asterisk는, 0 개 이상의 캐릭터 라인을 나타냅니다. 물음표는 단일의 문자를 나타냅니다.

도메인이 빈 상태(empty)의 경우, 이 부분은, ObjectName 를 사용하는 MBean 서버의 「디폴트 도메인」으로 옮겨놓을 수 있는 경우가 있습니다.

「키의 프로퍼티」은, 키와 그 값세트입니다. 이러한 줄 순서는 뿔뿔이 흩어집니다.

개개의 「키」는, 공문자열 이외의 캐릭터 라인으로, 콤마 (,), 등호 (=), 구두점, asterisk, 물음표등을 포함할 수 없습니다. 또, 특정의 ObjectName 내에 같은 키를 중복 해 포함할 수 없습니다.

키 1 개에 대해, 「값」이 1 개씩 할당할 수 있습니다. 이 값은, 인용부호로 둘러싸인 캐릭터 라인인가, 인용부호로 둘러싸이지 않은 캐릭터 라인입니다.

「인용부호로 둘러싸이지 않은 값」은, 공문자열의 가능성이 있습니다. 이 캐릭터 라인에는, 콤마, 등호, 구두점, 인용부호를 포함할 수 없습니다.

「인용부호로 둘러싸이지 않은 값」에 와일드 카드 문자의 asterisk나 물음표가 포함되어 있는 경우, 객체명은 「프로퍼티치 패턴」이 됩니다. asterisk는, 0 개 이상의 캐릭터 라인을 나타냅니다. 물음표는 단일의 문자를 나타냅니다.

「인용부호로 둘러싸인 값」은, 이중 인용부호 (")로 둘러싸인 공문자열의 가능성이 있습니다. 캐릭터 라인내의 backslash (\)에는 특별한 의미가 있습니다. backslash의 뒤에는, 다음의 몇개의 문자가 계속됩니다.

• backslash. 2 번째의 backslash에는 특별한 의미는 없습니다. 2 번째의 backslash는 단일의 backslash를 나타냅니다.
• 「n」. 전치 된 backslash와 1 조로, 단일의 복귀 개행 (Java 에 있어서의 '\n')을 나타냅니다.
• 인용부호. 전치 된 backslash와 1 조로, 단일의 인용부호를 나타냅니다. 이 인용부호는 「닫는다」인용부호라고는 보여지지 않습니다. 인용부호로 둘러싸인 값을 유효하게 하려면 , 이것과는 별도로 「닫는다」인용부호를 지정할 필요가 있습니다.
• 물음표 (? ) 또는 asterisk (*). backslash와 1 조로, 단일의 물음표 또는 asterisk를 나타냅니다.

인용부호로 둘러싸인 값의 안쪽에, 인용부호를 삽입할 수 없습니다. 다만, 홀수개의 backslash의 직후로는 삽입 가능합니다.

인용부호로 둘러싸인 값의 인용부호 부분과 그 값의 안쪽의 backslash는, 값의 일부라고 보여집니다.

「인용부호로 둘러싸인 값」에 asterisk나 물음표가 포함되어 있어 그 전에 backslash가 없는 경우, 이러한 문자는 와일드 카드 문자라고 보여져 객체명은 「프로퍼티치 패턴」이 됩니다. asterisk는, 0 개 이상의 캐릭터 라인을 나타냅니다. 물음표는 단일의 문자를 나타냅니다.

ObjectName 는, 0 개 이상의 키와 값의 편성을 가지는 경우, 「프로퍼티 리스트 패턴」이 됩니다. 도메인이 일치해, 동일한 키와 값의 편성을 가지는 (그 외의 키와 값이 존재하고 있어도 괜찮다), 패턴이 아닌 ObjectName 에 일치합니다.

ObjectName 가 「프로퍼티치 패턴」이 되는 것은, 전술과 같이, 1 개(살) 이상의 「인용부호로 둘러싸였다」또는 「인용부호로 둘러싸이지 않았다」키프로파티치에 와일드 카드 문자의 asterisk 또는 물음표가 포함되어 있는 경우입니다. 이 경우는 1 개 이상의 키와 값을 가져, 1 개(살) 이상의 값에 와일드 카드 문자가 포함되어 있습니다. 이것은, 도메인이 일치해, 값의 일치하는 동일한 키를 가지는, 패턴이 아닌 ObjectName 에 일치합니다. 프로퍼티치 패턴이 프로퍼티 리스트 패턴이기도 한 경우, 패턴이 아닌 ObjectName 에 그 외의 키 및 값을 포함할 수가 있습니다.

ObjectName 는, 「프로퍼티 리스트 패턴」또는 「프로퍼티치 패턴」혹은 그 양쪽 모두인 경우에, 「프로퍼티 패턴」이 됩니다.

ObjectName 는, 도메인에 와일드 카드가 포함되는지, ObjectName 가 프로퍼티 패턴의 경우, 패턴이 됩니다.

ObjectName 가 패턴이 아닌 경우, 키의 값의 편성을 1 개 이상 가지고 있을 필요가 있습니다.

ObjectName 패턴의 예를, 다음에 나타냅니다.

• *:type=Foo, name=Bar 는, 정확한 키 세트가 type=Foo, name=Bar 인 모든 도메인내의 이름에 일치합니다.
• d:type=Foo, name=Bar,* 는, 키 type=Foo, name=Bar 및 그 외의 제로 이상의 키를 포함한 도메인 d 내의 이름에 일치합니다.
• *:type=Foo, name=Bar,* 는, 키 type=Foo, name=Bar 및 그 외의 제로 이상의 키를 포함한 모든 도메인내의 이름에 일치합니다.
• d:type=F? o, name=Bar 는,d:type=Foo, name=Bar 나 d:type=Fro, name=Bar 등에 일치합니다.
• d:type=F*o, name=Bar 는,d:type=Fo, name=Bar 나 d:type=Frodo, name=Bar 등에 일치합니다.
• d:type=Foo, name="B*" 는,d:type=Foo, name="Bling" 등에 일치합니다. 와일드 카드는, 인용부호의 내부에서도 인식되어 그 외의 특수 문자와 같게 \ 를 사용해 이스케이프 할 수 있습니다.

ObjectName 는, 순서에, 다음의 요소를 가지는 String 로서 기입해 가능합니다.

• 도메인
• 구두점 (:)
• 키의 프로퍼티 리스트 (정의는 아래와 같이)

String 로서 기입해진 키의 프로퍼티 리스트는, 콤마 단락 형식의 요소 리스트가 됩니다. 각 요소는, asterisk나 키의 프로퍼티입니다. 키의 프로퍼티은, 키, 등호 (=), 값으로부터 완성됩니다.

키의 프로퍼티 리스트의 요소로서 최대 1 개의 asterisk를 포함할 수가 있습니다. 키의 프로퍼티 리스트에 asterisk 요소가 포함되는 경우, ObjectName 는 프로퍼티 리스트 패턴이 됩니다.

ObjectName 를 나타내는 String 내의 공백 문자에, 특별한 의미는 없습니다. 예를 들어, 다음의 String 에 대해 생각해 봅시다.

 domain:key1 = value1 , key2 = value2
 

이 String 는, 2 개의 키를 가지는 ObjectName 를 나타냅니다. 키의 이름은, 각각 6 문자 (최초와 마지막 문자는 공백 문자)입니다. 키의 값 " key1 " 의 전후에도 공백 문자가 들어가 있습니다.

상기의 문자 제약외, 인용부호로 둘러싸여 있는지 어떤지를 불문하고, ObjectName 목의 부분 (도메인 부분, 키 부분, 값부분)에도, 복귀 개행 문자 ('\n')를 포함할 수 없다고 하는 제약이 있습니다. 다만,\n 첨부의 인용부호로 둘러싸인 값에는, 복귀 개행 문자를 포함할 수가 있습니다.

특수 문자와 인용부호의 사용 방법에 관한 규칙은, ObjectName 의 작성에 사용하는 생성자 의 종류를 불문하고 적용됩니다.

다른 복수의 벤더로부터 제공된 MBean 의 충돌을 피하기 위해서(때문에)는, MBean 를 지정하는 조직의 역 DNS 명, 피리어드, 그 조직에 의해 해석이 결정되는 캐릭터 라인으로부터 완성되는 도메인명을 붙이면(자) 좋을 것입니다. 예를 들어, Sun Microsystems Inc. 지정의 MBean 의 경우, DNS 명 sun.com 의 도메인은 com.sun.MyDomain 와 같이 됩니다. 이것은, Java 언어 패키지명의 규칙과 기본적으로 같습니다.

이 클래스의 serialVersionUID 은 1081892073854801359L 입니다.

도입된 버젼:

1.5

관련 항목:

직렬화 된 형식

필드의 개요

static ObjectName

WILDCARD 와일드 카드 「*:*」 ObjectName 를 정의합니다.

생성자 의 개요

ObjectName (String name)
캐릭터 라인을 지정해 객체명을 작성합니다.

ObjectName (String domain, Hashtable <String ,String > table)
Hashtable 로부터, 키의 프로퍼티을 복수 가지는 객체명을 작성합니다.

ObjectName (String domain, String key, String value)
키의 프로퍼티을 1 개만 가지는 객체명을 작성합니다.

메소드의 개요

boolean	apply (ObjectName name) 이 ObjectName (패턴의 가능성이 있다)이 다른 ObjectName 와 일치할지 어떨지를 테스트합니다.
int	compareTo (ObjectName name) ObjectName 의 2 개의 인스턴스를 비교합니다.
boolean	equals (Object object) 현재의 객체명과 다른 객체명을 비교합니다.
String	getCanonicalKeyPropertyListString () 자구순서에 늘어놓을 수 있었던 키의 프로퍼티 리스트의 캐릭터 라인 표현을 돌려줍니다.
String	getCanonicalName () 정규 형식의 이름, 즉 프로퍼티을 자구순서 (lexical order)에 늘어놓은 캐릭터 라인 표현을 돌려줍니다.
String	getDomain () 도메인 부분을 돌려줍니다.
static ObjectName	getInstance (ObjectName name) 지정된 객체를 사용할 수 있는 임의의 장소에서 사용 가능한 ObjectName 의 인스턴스를 돌려줍니다.
static ObjectName	getInstance (String name) 새로운 ObjectName(name) 로 취득된 객체를 사용할 수 있는 임의의 장소에서 사용 가능한 ObjectName 의 인스턴스를 돌려줍니다.
static ObjectName	getInstance (String domain, Hashtable <String ,String > table) 새로운 ObjectName(domain, table) 로 취득된 객체를 사용할 수 있는 임의의 장소에서 사용 가능한 ObjectName 의 인스턴스를 돌려줍니다.
static ObjectName	getInstance (String domain, String key, String value) 새로운 ObjectName(domain, key, value) 로 취득된 객체를 사용할 수 있는 임의의 장소에서 사용 가능한 ObjectName 의 인스턴스를 돌려줍니다.
String	getKeyProperty (String property) 키의 프로퍼티의 키 부분에 관련지을 수 있었던 값을 가져옵니다.
Hashtable <String ,String >	getKeyPropertyList () 키의 프로퍼티을 Hashtable 로서 돌려줍니다.
String	getKeyPropertyListString () 작성시로 지정한, 키의 프로퍼티의 리스트의 캐릭터 라인 표현을 돌려줍니다.
int	hashCode () 이 객체명의 해시 코드를 돌려줍니다.
boolean	isDomainPattern () 객체명이 도메인 부분의 패턴일지 어떨지를 체크합니다.
boolean	isPattern () 객체명이 패턴인가 어떤가를 체크합니다.
boolean	isPropertyListPattern () 객체명이 키의 프로퍼티 리스트상의 패턴일지 어떨지를 체크합니다.
boolean	isPropertyPattern () 객체명이 키의 프로퍼티의 패턴일지 어떨지를 체크합니다.
boolean	isPropertyValuePattern () 객체명이 1 개 이상의 키프로파티의 값부분의 패턴일지 어떨지를 체크합니다.
boolean	isPropertyValuePattern (String property) 키의 프로퍼티내의 키에 관련지을 수 있었던 값이 패턴일지 어떨지를 체크합니다.
static String	quote (String s) 지정된 String 를, ObjectName 에 포함하기 쉽게 인용부호로 둘러싼 값을 돌려줍니다.
void	setMBeanServer (MBeanServer mbs) 쿼리가 실행되는 MBean 서버를 설정합니다.
String	toString () 객체명의 캐릭터 라인 표현을 돌려줍니다.
static String	unquote (String q) 지정된 String 를 인용부호로 둘러싸지 않는 형식에서 돌려줍니다.

클래스 java.lang. Object 로부터 상속된 메소드

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

필드의 상세

WILDCARD

public static final ObjectName  WILDCARD

와일드 카드 「*:*」 ObjectName 를 정의합니다.

도입된 버젼:

1.6

생성자 의 상세

ObjectName

public ObjectName(String  name)
           throws MalformedObjectNameException ,
                  NullPointerException 

캐릭터 라인을 지정해 객체명을 작성합니다.

파라미터:

name - 객체명의 캐릭터 라인 표현

예외:

MalformedObjectNameException - 파라미터로서 건네받은 캐릭터 라인의 형식이 올바르지 않은 경우

NullPointerException - name 파라미터가 null 의 경우

ObjectName

public ObjectName(String  domain,
                  String  key,
                  String  value)
           throws MalformedObjectNameException ,
                  NullPointerException 

키의 프로퍼티을 1 개만 가지는 객체명을 작성합니다.

파라미터:

domain - 객체명의 도메인 부분

key - 객체명의 키의 프로퍼티에 포함되는 속성

value - 객체명의 키의 프로퍼티에 포함되는 값

예외:

MalformedObjectNameException - domain, key, 또는 value 에 부정한 문자가 포함되는 경우, 또는 value 가 인용부호의 사용 규칙에 따르지 않은 경우

NullPointerException - 몇개의 파라미터가 null 의 경우

ObjectName

public ObjectName(String  domain,
                  Hashtable <String ,String > table)
           throws MalformedObjectNameException ,
                  NullPointerException 

Hashtable 로부터, 키의 프로퍼티을 복수 가지는 객체명을 작성합니다.

파라미터:

domain - 객체명의 도메인 부분

table - 키의 프로퍼티을 1 개 이상 포함한다 해시 테이블. 테이블내의 각 엔트리의 키는, 객체명의 키의 프로퍼티의 키 부분. 테이블내의 관련하는 값은, 객체명의 관련하는 값

예외:

MalformedObjectNameException - domain 에 부정한 문자가 포함되는 경우, table 내의 키 또는 값에 부정한 문자가 포함되는 경우, 또는 table 내에 인용부호의 사용 규칙에 따르지 않은 값이 1 개 이상 있는 경우

NullPointerException - 몇개의 파라미터가 null 의 경우

메소드의 상세

getInstance

public static ObjectName  getInstance(String  name)
                              throws MalformedObjectNameException ,
                                     NullPointerException 

새로운 ObjectName(name) 로 취득된 객체를 사용할 수 있는 임의의 장소에서 사용 가능한 ObjectName 의 인스턴스를 돌려줍니다. 반환되는 객체는, ObjectName 의 서브 클래스의 가능성이 있습니다. 같은 파라미터를 지정해 이 메소드를 2 회 호출했을 경우, 같은 객체가 반환되는지, 2 개의 동등의 (동일하지 않다) 객체가 돌려주어질 가능성이 있습니다.

파라미터:

name - 객체명의 캐릭터 라인 표현

반환값:

지정된 String 에 대응하는 ObjectName

예외:

MalformedObjectNameException - 파라미터로서 건네받은 캐릭터 라인의 형식이 올바르지 않은 경우

NullPointerException - name 파라미터가 null 의 경우

getInstance

public static ObjectName  getInstance(String  domain,
                                     String  key,
                                     String  value)
                              throws MalformedObjectNameException ,
                                     NullPointerException 

새로운 ObjectName(domain, key, value) 로 취득된 객체를 사용할 수 있는 임의의 장소에서 사용 가능한 ObjectName 의 인스턴스를 돌려줍니다. 반환되는 객체는, ObjectName 의 서브 클래스의 가능성이 있습니다. 같은 파라미터를 지정해 이 메소드를 2 회 호출했을 경우, 같은 객체가 반환되는지, 2 개의 동등의 (동일하지 않다) 객체가 돌려주어질 가능성이 있습니다.

파라미터:

domain - 객체명의 도메인 부분

key - 객체명의 키의 프로퍼티에 포함되는 속성

value - 객체명의 키의 프로퍼티에 포함되는 값

반환값:

지정된 도메인, 키, 및 값에 대응하는 ObjectName

예외:

MalformedObjectNameException - domain, key, 또는 value 에 부정한 문자가 포함되는 경우, 또는 value 가 인용부호의 사용 규칙에 따르지 않은 경우

NullPointerException - 몇개의 파라미터가 null 의 경우

getInstance

public static ObjectName  getInstance(String  domain,
                                     Hashtable <String ,String > table)
                              throws MalformedObjectNameException ,
                                     NullPointerException 

새로운 ObjectName(domain, table) 로 취득된 객체를 사용할 수 있는 임의의 장소에서 사용 가능한 ObjectName 의 인스턴스를 돌려줍니다. 반환되는 객체는, ObjectName 의 서브 클래스의 가능성이 있습니다. 같은 파라미터를 지정해 이 메소드를 2 회 호출했을 경우, 같은 객체가 반환되는지, 2 개의 동등의 (동일하지 않다) 객체가 돌려주어질 가능성이 있습니다.

파라미터:

domain - 객체명의 도메인 부분

table - 키의 프로퍼티을 1 개 이상 포함한다 해시 테이블. 테이블내의 각 엔트리의 키는, 객체명의 키의 프로퍼티의 키 부분. 테이블내의 관련하는 값은, 객체명의 관련하는 값

반환값:

지정된 도메인 및 키 매핑에 대응하는 ObjectName

예외:

MalformedObjectNameException - domain 에 부정한 문자가 포함되는 경우, table 내의 키 또는 값에 부정한 문자가 포함되는 경우, 또는 table 내에 인용부호의 사용 규칙에 따르지 않은 값이 1 개 이상 있는 경우

NullPointerException - 몇개의 파라미터가 null 의 경우

getInstance

public static ObjectName  getInstance(ObjectName  name)
                              throws NullPointerException 

지정된 객체를 사용할 수 있는 임의의 장소에서 사용 가능한 ObjectName 의 인스턴스를 돌려줍니다. 반환되는 객체는, ObjectName 의 서브 클래스의 가능성이 있습니다. name 가 ObjectName 의 서브 클래스인 경우, 같은 클래스의 객체가 반환된다고는 할 수 없습니다.

반환값은 name 와 동일하다고는 할 수 없습니다. 같은 파라미터를 지정해 이 메소드를 2 회 호출했을 경우, 같은 객체가 반환되는지, 2 개의 동등의 (동일하지 않다) 객체가 돌려주어질 가능성이 있습니다.

ObjectName 은 불변이므로, ObjectName 의 카피의 작성에 적절하지 않은 경우도 있습니다. 이 메소드는 주로, 악의를 가진 호출을 방지하기 위해서 사용됩니다. 예를 들어, 중요한 코드에 예상외의 동작을 하는 서브 클래스의 인스턴스를 건네주려고 하는 호출은, 회피되지 않으면 안됩니다. 중요한 코드는, 이 메소드를 호출하는 것으로, 올바르게 동작하는 것을 알 수 있고 있는 ObjectName 를 취득할 수 있습니다.

파라미터:

name - ObjectName 클래스의 인스턴스 또는 서브 클래스의 인스턴스

반환값:

공통의 시멘틱스를 가지는 것을 알 수 있고 있는 ObjectName 또는 서브 클래스의 인스턴스. name 가 ObjectName 의 시멘틱스에 따르는 경우, name 와 동등의 (다만 동일하다라고는 한정되지 않는다) 객체가 반환된다

예외:

NullPointerException - name 가 null 의 경우

isPattern

public boolean isPattern()

객체명이 패턴인가 어떤가를 체크합니다.

도메인에 와일드 카드가 포함되는 경우나, 객체명이 프로퍼티 패턴의 경우, 이 객체명은 패턴입니다.

반환값:

이름이 패턴인 경우는 true, 그렇지 않은 경우는 false

isDomainPattern

public boolean isDomainPattern()

객체명이 도메인 부분의 패턴일지 어떨지를 체크합니다.

반환값:

이름이 도메인 패턴인 경우는 true, 그렇지 않은 경우는 false

isPropertyPattern

public boolean isPropertyPattern()

객체명이 키의 프로퍼티의 패턴일지 어떨지를 체크합니다.

객체명이 키의 프로퍼티 리스트 ( 「d:k=v,*」 등) 또는 프로퍼티치 ( 「d:k=*」 등) 혹은 그 양쪽 모두 ( 「d:k=*,*」 등)의 패턴인 경우, 객체명은 키의 프로퍼티상의 패턴이 됩니다.

반환값:

이름이 프로퍼티 패턴인 경우는 true, 그렇지 않은 경우는 false

isPropertyListPattern

public boolean isPropertyListPattern()

객체명이 키의 프로퍼티 리스트상의 패턴일지 어떨지를 체크합니다.

예를 들어, 「d:k=v,*」와「d:k=*,*」는 키의 프로퍼티 리스트의 패턴입니다만, 「d:k=*」는 그렇지는 않습니다.

반환값:

이름이 프로퍼티 리스트 패턴인 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.6

isPropertyValuePattern

public boolean isPropertyValuePattern()

객체명이 1 개 이상의 키프로파티의 값부분의 패턴일지 어떨지를 체크합니다.

예를 들어, 「d:k=*」(와)과「d:k=*,*」는 프로퍼티치의 패턴입니다만, 「d:k=v,*」는 그렇지는 않습니다.

반환값:

이름이 프로퍼티치 패턴인 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.6

isPropertyValuePattern

public boolean isPropertyValuePattern(String  property)
                               throws NullPointerException ,
                                      IllegalArgumentException 

키의 프로퍼티내의 키에 관련지을 수 있었던 값이 패턴일지 어떨지를 체크합니다.

파라미터:

property - 프로퍼티. 이 프로퍼티의 값이 체크된다

반환값:

지정한 키의 프로퍼티에 관련지을 수 있었던 값이 패턴인 경우는 true, 그렇지 않은 경우는 false

예외:

NullPointerException - property 가 null 의 경우

IllegalArgumentException - property 가 이 ObjectName 의 유효한 키의 프로퍼티이 아닌 경우

도입된 버젼:

1.6

getCanonicalName

public String  getCanonicalName()

정규 형식의 이름, 즉 프로퍼티을 자구순서 (lexical order)에 늘어놓은 캐릭터 라인 표현을 돌려줍니다.

정확하게는, 도메인 부분, 구두점 (:), 자구순서의 키의 프로퍼티 리스트, 패턴 표시로부터 완성되는 String 를 「정규 형식의 이름」이라고 부릅니다.

키의 프로퍼티의 정규 리스트는,getCanonicalKeyPropertyListString() 의 설명과 같은 캐릭터 라인입니다.

패턴 표시는, 다음의 어느 쪽인가에 됩니다.

• ObjectName 가 프로퍼티 리스트 패턴이 아닌 경우, 빈 상태(empty)
• ObjectName 가 키를 가지지 않는 프로퍼티 리스트 패턴인 경우, asterisk
• ObjectName 가 1 개 이상 키를 가지는 프로퍼티 리스트 패턴인 경우, 콤마와 asterisk (,*)

반환값:

정규 형식의 이름

getDomain

public String  getDomain()

도메인 부분을 돌려줍니다.

반환값:

도메인

getKeyProperty

public String  getKeyProperty(String  property)
                      throws NullPointerException 

키의 프로퍼티의 키 부분에 관련지을 수 있었던 값을 가져옵니다.

파라미터:

property - 프로퍼티. 이 프로퍼티의 값이 취득된다

반환값:

프로퍼티의 값. 이 ObjectName 내에 해당하는 프로퍼티이 없는 경우는 null

예외:

NullPointerException - property 가 null 의 경우

getKeyPropertyList

public Hashtable <String ,String > getKeyPropertyList()

키의 프로퍼티을 Hashtable 로서 돌려줍니다. 반환값은 Hashtable 입니다. 이 테이블내의 개개의 키는, ObjectName 의 키의 프로퍼티 리스트의 키에 일치하고 있습니다. 또, 테이블내의 값은, 키에 관련지을 수 있었던 값에 일치하고 있습니다.

반환값은 변경할 수 없습니다. 변경을 더해도, 이 ObjectName 에 영향은 없습니다.

반환값:

키의 프로퍼티 테이블

getKeyPropertyListString

public String  getKeyPropertyListString()

작성시로 지정한, 키의 프로퍼티의 리스트의 캐릭터 라인 표현을 돌려줍니다. 이 ObjectName 가 생성자 ObjectName(String) 로 작성되었을 경우, 반환되는 String 내의 키의 프로퍼티은, 생성자 의 인수와 지정순서로 늘어놓을 수 있습니다.

반환값:

키의 프로퍼티 리스트의 캐릭터 라인. 이 캐릭터 라인은, ObjectName 가 패턴일지 어떨지에 의존하지 않는다

getCanonicalKeyPropertyListString

public String  getCanonicalKeyPropertyListString()

자구순서에 늘어놓을 수 있었던 키의 프로퍼티 리스트의 캐릭터 라인 표현을 돌려줍니다. 이것은, MBean 를 키의 프로퍼티 리스트로부터 선택할 때의 자구 비교에 사용됩니다. 「자구순서」란,String.compareTo(String) 에 의해 나타나는 순서입니다.

반환값:

키의 프로퍼티 리스트의 정규 캐릭터 라인. 이 캐릭터 라인은, ObjectName 가 패턴일지 어떨지에 의존하지 않는다

toString

public String  toString()

객체명의 캐릭터 라인 표현을 돌려줍니다. 이 캐릭터 라인의 형식은 지정되고 있지 않습니다만, 2 개의 ObjectName 가 동일한 경우에게만, 동일한 캐릭터 라인이 돌려주어집니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 객체명의 캐릭터 라인 표현

equals

public boolean equals(Object  object)

현재의 객체명과 다른 객체명을 비교합니다. 2 개의 ObjectName 인스턴스는, 이러한 정규 형식이 동일한 경우에게만 등가가 됩니다. 정규 형식은,getCanonicalName() 에 설명된 캐릭터 라인입니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

object - 현재의 객체명과 비교한다 객체명

반환값:

object 가 ObjectName 로, 그 정규 형식이 이 ObjectName 의 정규 형식에 동일한 경우는 true

관련 항목:

Object.hashCode() , Hashtable

hashCode

public int hashCode()

이 객체명의 해시 코드를 돌려줍니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

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

quote

public static String  quote(String  s)
                    throws NullPointerException 

지정된 String 를, ObjectName 에 포함하기 쉽게 인용부호로 둘러싼 값을 돌려줍니다. 반환값은, ObjectNmae 내의 키의 값으로 해서 사용할 수 있습니다. String s 에는 임의의 문자를 포함할 수가 있습니다. 인용부호의 사용 방법이 적절하면, 반환값은 ObjectName 내의 정당한 값입니다.

반환값은,s 의 문자에 대응하는 문자의 순서를 인용부호 ("")로 둘러싼 형식이 됩니다. 반환값에 포함되는 s 내의 문자는, 이하의 점으로써 변경됩니다.

• 인용부호 ("")를 backslash＋인용부호 (\")로 옮겨놓는다.
• asterisk (*)를 backslash＋asterisk (\*)로 옮겨놓는다.
• 물음표 (? )(을)를 backslash＋물음표 (\? )(으)로 옮겨놓는다.
• backslash 1 개를 backslash 2 개로 옮겨놓는다.
• 복귀 개행 문자 (Java 에 있어서의 '\n')를 backslash＋ '\n'로 옮겨놓는다.

파라미터:

s - 인용부호로 둘러싸이는 String

반환값:

인용부호로 둘러싸인 String

예외:

NullPointerException - s 가 null 의 경우

unquote

public static String  unquote(String  q)
                      throws IllegalArgumentException ,
                             NullPointerException 

지정된 String 를 인용부호로 둘러싸지 않는 형식에서 돌려줍니다. q 가 quote(s) 에 의해 반환되는 String 인 경우,unquote(q). equals(s) 입니다. quote(s). equals(q) 의 String s 가 존재하지 않는 경우, unquote(q)는 IllegalArgumentException 를 throw 합니다.

이러한 규칙은, 인용부호로 둘러싸인 형식과 둘러싸이지 않은 형식이 1 대 1 으로 대응하고 있는 것을 의미하고 있습니다.

파라미터:

q - 인용부호로 둘러싸이지 않는 String

반환값:

인용부호로 둘러싸이지 않은 String

예외:

IllegalArgumentException - 인용부호 (")로 둘러싸이지 않은 경우 등,quote(java.lang.String) 메소드가 q 를 돌려주지 않는다 경우

NullPointerException - q 가 null 의 경우

apply

public boolean apply(ObjectName  name)
              throws NullPointerException 

이 ObjectName (패턴의 가능성이 있다)이 다른 ObjectName 와 일치할지 어떨지를 테스트합니다. name 가 패턴의 경우, 결과는 false 입니다. 이 ObjectName 가 패턴으로,name 가 이 패턴과 일치하고 있는 경우, 결과는 true 입니다. 이 ObjectName 도 name 도 패턴은 아니고, 2 개의 ObjectNames 가 equals(Object) 메소드의 설명 대로 등가인 경우, 결과는 true 입니다.

정의:

인터페이스 QueryExp 내의 apply

파라미터:

name - 비교 대상의 MBean 의 이름

반환값:

name 가 이 ObjectName 와 일치하는 경우는 true

예외:

NullPointerException - name 가 null 의 경우

setMBeanServer

public void setMBeanServer(MBeanServer  mbs)

인터페이스 QueryExp 의 기술:

쿼리가 실행되는 MBean 서버를 설정합니다.

정의:

인터페이스 QueryExp 내의 setMBeanServer

파라미터:

mbs - 쿼리가 실행되는 MBean 서버

compareTo

public int compareTo(ObjectName  name)

ObjectName 의 2 개의 인스턴스를 비교합니다. ObjectName 간의 순서 릴레이션은, 스펙이 완전하게 정해진 것이 아닙니다만, 소트 된 ObjectNames 의 리스트는 사용자가 읽기 쉬운 순서로 표시되도록(듯이) 의도되고 있습니다.

특히, 2 개의 ObjectName 인스턴스의 도메인이 다른 경우, 그 순서는 도메인의 사전 규칙에 따릅니다. 키의 프로퍼티 리스트의 순서는, 무지정대로 됩니다.

예를 들어, 다음과 같은 ObjectName 에 대해 생각합시다.

• Shapes:type=Square, name=3
• Colors:type=Red, name=2
• Shapes:type=Triangle, side=isosceles, name=2
• Colors:type=Red, name=1
• Shapes:type=Square, name=1
• Colors:type=Blue, name=1
• Shapes:type=Square, name=2
• JMImplementation:type=MBeanServerDelegate
• Shapes:type=Triangle, side=scalene, name=1

이것들은, 다음과 같은 순서로 할 수 있습니다.

• Colors:type=Blue, name=1
• Colors:type=Red, name=1
• Colors:type=Red, name=2
• JMImplementation:type=MBeanServerDelegate
• Shapes:type=Square, name=1
• Shapes:type=Square, name=2
• Shapes:type=Square, name=3
• Shapes:type=Triangle, side=scalene, name=1
• Shapes:type=Triangle, side=isosceles, name=2

정의:

인터페이스 Comparable <ObjectName > 내의 compareTo

파라미터:

name - 비교 대상의 ObjectName

반환값:

이 ObjectName 이 지정된 ObjectName 보다 작은 경우는 부의 정수, 동일한 경우는 제로, 큰 경우는 정의 정수

도입된 버젼:

1.6