javax.management
클래스 MBeanPermission

java.lang.Object 
  java.security.Permission 
      javax.management.MBeanPermission

모든 구현된 인터페이스:

Serializable, Guard

public class MBeanPermission
extends Permission 

MBeanServer 오퍼레이션의 액세스를 제어하는 접근 권한입니다. System.setSecurityManager(java.lang.SecurityManager) 로 시큐러티 매니저가 설정되어 있는 경우, MBean 서버상에서 어떠한 오퍼레이션을 실행하기 위해서는 보통, 그 오퍼레이션에 적절한 MBeanPermission가 호출해 원의 접근 권한으로서 포함되지 않으면 안됩니다. 상세한 것에 대하여는 MBeanServer 인터페이스의 메뉴얼을 참조하십시오.

그 외 Permission 객체의 경우와 같게, MBeanPermission는 사용자에 게 부여되고 있는 접근 권한, 또는 사용자가 필요로 하는 접근 권한을 나타냅니다. 중요한 오퍼레이션을 실행하려면 접근 권한의 체크를 합니다만, 이 때, 필요한 접근 권한을 나타내는 MBeanPermission가 구축됩니다. 사용자에 게 부여되고 있는 접근 권한에 사용자가 필요로 하는 접근 권한이포함되어 있는 경우에 한해, 오퍼레이션은 허가됩니다.

MBeanPermission 에는 다음의 4 항목의 정보가 포함됩니다.

• 액션

  사용자가 필요로 하는 접근 권한의 경우, 아래와 같은 리스트의 몇개의 액션. 사용자에 게 부여되고 있는 접근 권한의 경우, 콤마로 단락지어진 형식의 액션 리스트 또는 * (모든 액션)

  액션은 getActions() 에 의해 리턴된다

• 클래스명

  사용자가 필요로 하는 접근 권한의 경우, 사용자가 액세스 하려고 하고 있는 MBean 클래스명. 이것은, MBeanServer.getMBeanInfo(name) . getClassName() 에 의해 리턴된다. 클래스명을 참조하지 않는 오퍼레이션의 경우, 클래스명은 null

  사용자에 게 부여되고 있는 접근 권한의 경우, 공백 또는 클래스명 패턴. 클래스명 패턴은 닷 단락 형식의 클래스명의 Java 규약에 따른 캐릭터 라인. 말미에 「. *」를 지정하는 것으로써, 「. *」의 전의 캐릭터 라인으로 시작되는 모든 클래스에 액세스가 부여된다. 예를 들어 「javax.management. *」의 경우, javax.management.MBeanServerDelegate 클래스와 javax.management.timer.Timer 클래스에 액세스가 부여된다

  클래스명 패턴으로서 공문자열 또는 「*」을 지정할 수도 있다. 어느 쪽의 경우도, 모든 클래스에 액세스가 부여된다

• 멤버

  사용자가 필요로 하는 접근 권한의 경우, 사용자가 액세스 하려고 하고 있는 속성 또는 오퍼레이션의 이름. 속성이나 오퍼레이션을 참조하지 않는 오퍼레이션의 경우, 멤버는 null

  사용자에 게 부여되고 있는 접근 권한의 경우, 사용자가 액세스 할 수 있는 속성 또는 오퍼레이션의 이름. 공문자열 또는 「*」이 지정되었을 경우, 모든 멤버에 액세스가 부여된다

• 객체명

  사용자가 필요로 하는 접근 권한의 경우, 사용자가 액세스 하려고 하고 있는 MBean ObjectName . 단일의 MBean를 참조하지 않는 오퍼레이션의 경우, null. 객체명 패턴에는 들어맞지 않는다

  사용자에 게 부여되고 있는 접근 권한의 경우, 사용자가 액세스 할 수 있는 MBean (복수가능) ObjectName . 객체명 패턴을 지정했을 경우, 패턴에 일치하는 이름을 가지는 모든 MBean에 액세스가 부여된다. 공문자열을 지정했을 경우, 이름에는 관계없이 모든 MBean에 액세스가 부여된다

MBeanPermission가 부여되고 있는 경우는 이 4 항목 모든 것이 채워졌을 경우에게만 오퍼레이션이 허가됩니다.

클래스명, 멤버, 객체명은 단일의 캐릭터 라인으로서 동시에 출력할 수 있습니다. 이 캐릭터 라인이, 이 접근 권한의 이름이 됩니다. 접근 권한의 이름은, getName() 에 의해 리턴된 캐릭터 라인입니다. 캐릭터 라인의 형식은 다음과 같습니다.

className#member[objectName]

객체명은, ObjectName 보통 구문에 의해 출력해집니다. 객체명에는 ]을 포함한 유효한 문자를 포함할 수 있습니다 . 캐릭터 라인의 말미의 문자는 ] 입니다.

className, member, objectName는 생략 가능합니다. member가 생략 되었을 경우, #도 생략 됩니다 (다만 반드시 생략 된다고는 할 수는 없다). objectName가 생략 되었을 경우, []도 생략 됩니다 (다만 반드시 생략 된다고는 할 수는 없다). 이것들 3개의 항목 전부를 생략 할 수 없습니다. 즉, name를 공문자열로 할 수 없습니다.

className, member, objectName에는 null 치를 나타내는 문자 「-」을 지정할 수 있습니다. null 치는 모든 값 (다른 null 치를 포함한다)에 포함됩니다만, 그 외의 값을 포함할 것은 없습니다.

아래의 액션을 선택할 수 있습니다.

• addNotificationListener
• getAttribute
• getClassLoader
• getClassLoaderFor
• getClassLoaderRepository
• getDomains
• getMBeanInfo
• getObjectInstance
• instantiate
• invoke
• isInstanceOf
• queryMBeans
• queryNames
• registerMBean
• removeNotificationListener
• setAttribute
• unregisterMBean

콤마로 단락지어진 형식의 액션 리스트에서는 각 액션의 전후에 스페이스를 삽입할 수 있습니다.

도입된 버전 :

1.5

관련 항목:

직렬화 된 형식

생성자 개요

MBeanPermission (String name, String actions)
지정된 타겟명 및 액션을 가지는 새로운 MBeanPermission 객체를 작성합니다.

MBeanPermission (String className, String member, ObjectName objectName, String actions)
지정된 타겟명 (클래스명, 멤버, 객체명) 및 액션을 가지는 새로운 MBeanPermission 객체를 작성합니다.

메서드 개요

boolean	equals (Object obj) 2개의 MBeanPermission 객체가 같은지 어떤지를 판정합니다.
String	getActions () 액션의 「표준적인 캐릭터 라인 표현」을 리턴합니다.
int	hashCode () 이 객체의 해시 코드값을 리턴합니다.
boolean	implies (Permission p) 이 MBeanPermission 객체에 지정된 접근 권한이 포함되어 있는지를 판정합니다.

클래스 java.security. Permission 로부터 상속된 메서드

checkGuard, getName, newPermissionCollection, toString

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

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

생성자 상세

MBeanPermission

public MBeanPermission(String  name,
                       String  actions)

지정된 타겟명 및 액션을 가지는 새로운 MBeanPermission 객체를 작성합니다.

타겟명은, className#member[objectName] 형식이 됩니다. 각 부분은 임의입니다만, 공문자열이나 null은 지정할 수 없습니다.

액션 파라미터에는 타겟명에 대해서 부여된 필요한 액션의 리스트 (콤마 단락 형식)가 포함됩니다. 공문자열이나 null은 지정할 수 없습니다.

파라미터:

name - 셋잇단음표 className#member[objectName]

actions - 액션의 캐릭터 라인

예외:

IllegalArgumentException - name 또는 actions가 무효인 경우

MBeanPermission

public MBeanPermission(String  className,
                       String  member,
                       ObjectName  objectName,
                       String  actions)

지정된 타겟명 (클래스명, 멤버, 객체명) 및 액션을 가지는 새로운 MBeanPermission 객체를 작성합니다.

클래스명, 멤버 및 객체명의 파라미터에의해 className#member[objectName] 형식의 타겟명이 정의됩니다 (각 부분은 임의). 작성된 MBeanPermission 상에서 Permission.getName()를 실행하면, 이 이름이 출력됩니다.

액션 파라미터에는 타겟명에 대해서 부여된 필요한 액션의 리스트 (콤마 단락 형식)가 포함됩니다. 공문자열이나 null은 지정할 수 없습니다.

파라미터:

className - 이 접근 권한이 적용되는 클래스명. null 또는 "-"인 경우도 있어, 임의의 클래스명에 포함되는 클래스명을 나타내지만, 그 외의 클래스명을 포함할 것은 없는

member - 이 접근 권한이 적용되는 멤버. null 또는 "-"인 경우도 있어, 임의의 멤버에 포함되는 멤버를 나타내지만, 그 외의 멤버를 포함할 것은 없는

objectName - 이 접근 권한이 적용되는 객체명. null인 경우도 있어, 임의의 객체명에 포함되는 객체명을 나타내지만, 그 외의 객체명을 포함할 것은 없는

actions - 액션의 캐릭터 라인

메서드의 상세

getActions

public String  getActions()

액션의 「표준적인 캐릭터 라인 표현」을 리턴합니다. 즉, 이 메서드는 항상, 알파벳순서로 현재의 액션을 리턴합니다.

정의:

클래스 Permission 내의 getActions

반환값:

액션의 표준적인 캐릭터 라인 표현

hashCode

public int hashCode()

이 객체의 해시 코드값을 리턴합니다.

정의:

클래스 Permission 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

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

implies

public boolean implies(Permission  p)

이 MBeanPermission 객체에 지정된 접근 권한이 포함되어 있는지를 판정합니다.

즉, 이 메서드는 다음의 경우에 true를 리턴합니다.

• p가 MBeanPermission 인스턴스이며, 한편
• p가 null className를 가지는지, p className가 이 객체의 className에 일치하고 있어, 한편
• p가 null 멤버를 가지는지, p 멤버가 이 객체의 멤버에 일치하고 있어, 한편
• p가 null 객체명을 가지는지, p 객체명이 이 객체의 객체명에 일치하고 있어, 한편
• p 액션이 이 객체의 액션의 부분집합이다

이 객체의 className가 *인 경우, p className는 항상 이것에 일치합니다. a. *인 경우, p className가 a. 그리고 시작된다면, 이것에 일치합니다.

이 객체의 멤버가 *인 경우, p 멤버는 항상 이것에 일치합니다.

이 객체의 objectName n1가 객체명 패턴인 경우, n1. equals(n2) 또는 n1. apply(n2) 라면, p objectName n2는 이것에 일치합니다.

queryMBeans 액션을 포함한 접근 권한은, queryNames도 포함하는 것이라고 보여집니다.

정의:

클래스 Permission 내의 implies

파라미터:

p - 체크 대상의 접근 권한

반환값:

지정된 접근 권한이 이 객체에 포함되는 경우는 true, 그렇지 않은 경우는 false

equals

public boolean equals(Object  obj)

2개의 MBeanPermission 객체가 같은지 어떤지를 판정합니다. obj가 MBeanPermission 이며, 객체와 같은 이름과 액션을 가지고 있을지 어떨지를 판정합니다.

정의:

클래스 Permission 내의 equals

파라미터:

obj - 이 객체와 동일한지 어떤지를 판정하는 객체

반환값:

obj가 MBeanPermission 이며, MBeanPermission 객체와 같은 이름과 액션을 가지고 있는 경우는 true

관련 항목:

Object.hashCode(), Hashtable