JavaTM 2 Platform
Standard Ed. 5.0

javax.management.relation
ÀÎÅÍÆäÀ̽º Relation

±âÁ¸ÀÇ ¼­ºê ÀÎÅÍÆäÀ̽ºÀÇ À϶÷:
RelationSupportMBean
±âÁ¸ÀÇ ±¸Çö Ŭ·¡½ºÀÇ À϶÷:
RelationSupport

public interface Relation

°ü°è ¼­ºñ½º¿¡ ÇØ °ü¸®µÇ´Â °ü°è¸¦ ³ªÅ¸³»´Â MBean Ŭ·¡½º´Â ÀÌ ÀÎÅÍÆäÀ̽º¸¦ ±¸ÇöÇÒ Çʿ䰡 ÀÖ½À´Ï´Ù.

ÇÁ·ÎÆÛƼ³ª ¸Þ¼­µå¸¦ °¡ÁöÁö ¾Ê°í, ·Ñ¸¸ °¡Áö´Â ´Ü¼øÇÑ °ü°è´Â °ü°è ¼­ºñ½º·Î Á÷Á¢ ÀÛ¼ºÇÒ ¼ö ÀÖ½À´Ï´Ù. ÀÌ·¯ÇÑ °ü°è´Â RelationSupport ¿ÀºêÁ§Æ®·Î¼­ °ü°è ¼­ºñ½º¿¡ ÇØ ³»ºÎ¿¡¼­ 󸮵˴ϴÙ.

º¹¼öÀÇ ÇÁ·ÎÆÛƼ³ª ¸Þ¼­µå¸¦ °¡Áö´Â º¸´Ù º¹ÀâÇÑ °ü°è¸¦ Ç¥ÇöÇÏ°í ½ÍÀº °æ¿ì´Â Relation ÀÎÅÍÆäÀ̽º¸¦ ±¸ÇöÇÏ´Â µ¶ÀÚÀûÀΠŬ·¡½º¸¦ ÁغñÇÒ Çʿ䰡 ÀÖ½À´Ï´Ù. ÀÌ Å¬·¡½º´Â RelationSupport Ŭ·¡½º·ÎºÎÅÍ »ó¼ÓÇÏ´ÂÁö, ÀÎÅÍÆäÀ̽º (RelationSupport ¿ÀºêÁ§Æ® ¸â¹ö, ¶Ç´Â ±× À§¾ç)¸¦ ±¸ÇöÇÏ´Â °Í¿¡ ÇØ ÃëµæÇÒ ¼ö ÀÖ½À´Ï´Ù.

ÀÌ·¯ÇÑ À¯Àú °ü°è Ŭ·¡½º¸¦ ÁöÁ¤ÇÏ´Â °ÍÀ¸·Î½á, ÇÁ·ÎÆÛƼ³ª ¸Þ¼­µå¸¦ µµÀÔÇÒ ¼ö ÀÖ½À´Ï´Ù. ÀÌ·¯ÇÑ ÇÁ·ÎÆÛƼ³ª ¸Þ¼­µå´Â remote administration¿ëÀ¸·Î °ø°³ÇÒ Çʿ䰡 ÀÖ½À´Ï´Ù. Áï, ¸ðµç À¯Àú °ü°è Ŭ·¡½º´Â MBean Ŭ·¡½º°¡ ¾Æ´Ï¸é ¾ÈµË´Ï´Ù.

µµÀÔµÈ ¹öÁ¯:
1.5

¸Þ¼­µå °³¿ä
 RoleResult getAllRoles ()
          °ü°è¿¡ Æ÷ÇԵǴ ¸ðµç ·ÑÀ» µ¹·ÁÁÝ´Ï´Ù.
 Map getReferencedMBeans ()
          °ü°èÀÇ ´Ù¾çÇÑ ·Ñ·Î ÂüÁ¶µÇ´Â MBean¸¦ ÃëµæÇÕ´Ï´Ù.
 String getRelationId ()
          °ü°è ¼­ºñ½º³»ÀÇ °ü°è¸¦ ÀÏÀÇ¿¡ ½Äº°Çϱâ À§Çؼ­ »ç¿ëµÇ´Â °ü°è ½Äº°ÀÚ¸¦ µ¹·ÁÁÝ´Ï´Ù.
 ObjectName getRelationServiceName ()
          °ü°è¸¦ ó¸®ÇÏ´Â °ü°è ¼­ºñ½ºÀÇ ObjectName¸¦ µ¹·ÁÁÝ´Ï´Ù.
 String getRelationTypeName ()
          °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø °ü°èÇüÀÇ À̸§À» µ¹·ÁÁÝ´Ï´Ù.
 List getRole (String  theRoleName)
          ÁöÁ¤µÈ ·Ñ¸íÀÇ ·ÑÄ¡¸¦ ÃëµæÇÕ´Ï´Ù.
 Integer getRoleCardinality (String  theRoleName)
          ÁöÁ¤µÈ ·Ñ³»¿¡¼­ ÇöÀç ÂüÁ¶µÇ°í ÀÖ´Â MBean ¼ö¸¦ µ¹·ÁÁÝ´Ï´Ù.
 RoleResult getRoles (String [] theRoleNameArray)
          ÁöÁ¤µÈ À̸§ÀÇ ·ÑÀÇ °ªÀ» ÃëµæÇÕ´Ï´Ù.
 void handleMBeanUnregistration (ObjectName  theObjName, String  theRoleName)
          ·Ñ¿¡ Æ÷ÇԵǴ ÂüÁ¶ ´ë»óÀÇ MBean µî·ÏÀÌ ÇØÁ¦µÇ¾úÀ» °æ¿ì¿¡ °ü°è ¼­ºñ½º¿¡ ÇØ »ç¿ëµÇ´Â ÄݹéÀÔ´Ï´Ù.
 RoleList retrieveAllRoles ()
          µ¶ÇØ ¸ðµå¸¦ üũÇÏÁö ¾Ê°í, °ü°è¿¡ Æ÷ÇԵǴ ¸ðµç ·ÑÀ» µ¹·ÁÁÝ´Ï´Ù.
 void setRole (Role  theRole)
          ÁöÁ¤µÈ ·ÑÀ» ¼³Á¤ÇÕ´Ï´Ù.
 RoleResult setRoles (RoleList  theRoleList)
          ÁöÁ¤µÈ ·ÑÀ» ¼³Á¤ÇÕ´Ï´Ù.
 

¸Þ¼­µåÀÇ »ó¼¼

getRole

List  getRole(String  theRoleName)
             throws IllegalArgumentException,

                    RoleNotFoundException,

                    RelationServiceNotRegisteredException 
ÁöÁ¤µÈ ·Ñ¸íÀÇ ·ÑÄ¡¸¦ ÃëµæÇÕ´Ï´Ù.

·ÑÀÌ Á¸ÀçÇØ, °ü°èÇü¿¡ µû¶ó Àо °¡´ÉÇѰ¡ ¾î¶²°¡¸¦ üũÇÕ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRoleName - ·Ñ¸í
¹Ýȯ°ª:
·ÑÄ¡°¡ µÇ´Â ObjectName ¿ÀºêÁ§Æ®ÀÇ ArrayList
¿¹¿Ü:
IllegalArgumentException - ·Ñ¸íÀÌ null °æ¿ì
RoleNotFoundException - ´ÙÀ½ÀÇ Á¶°ÇÀÌ ¼º¸³ÇÏ´Â °æ¿ì:

- ÁöÁ¤µÈ À̸§ÀÇ ·ÑÀÌ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì

- ·ÑÀÌ Àо ºÒ°¡ÀÎ °æ¿ì

RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ MBean Server ¿¡ µî·ÏµÇÁö ¾ÊÀº °æ¿ì
°ü·Ã Ç׸ñ:
setRole(javax.management.relation.Role)

getRoles

RoleResult  getRoles(String [] theRoleNameArray)
                    throws IllegalArgumentException,

                           RelationServiceNotRegisteredException 
ÁöÁ¤µÈ À̸§ÀÇ ·ÑÀÇ °ªÀ» ÃëµæÇÕ´Ï´Ù.

°¢ ·ÑÀÌ Á¸ÀçÇØ, °ü°èÇü¿¡ µû¶ó Àо °¡´ÉÇѰ¡ ¾î¶²°¡¸¦ üũÇÕ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRoleNameArray - ÃëµæµÇ´Â ·ÑÀÇ À̸§¿¡¼­ ¿Ï¼ºµÇ´Â ¹è¿­
¹Ýȯ°ª:
RoleResult ¿ÀºêÁ§Æ®. Ãëµæ¿¡ ¼º°øÇÑ ·ÑÀÇ RoleList ¿Í ÃëµæµÇÁö ¾Ê¾Ò´ø ·ÑÀÇ RoleUnresolvedList¸¦ Æ÷ÇÔÇÑ´Ù
¿¹¿Ü:
IllegalArgumentException - ·Ñ¸íÀÌ null °æ¿ì
RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ MBean Server ¿¡ µî·ÏµÇÁö ¾ÊÀº °æ¿ì
°ü·Ã Ç׸ñ:
setRoles(javax.management.relation.RoleList)

getRoleCardinality

Integer  getRoleCardinality(String  theRoleName)
                           throws IllegalArgumentException,

                                  RoleNotFoundException 
ÁöÁ¤µÈ ·Ñ³»¿¡¼­ ÇöÀç ÂüÁ¶µÇ°í ÀÖ´Â MBean ¼ö¸¦ µ¹·ÁÁÝ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRoleName - ·Ñ¸í
¹Ýȯ°ª:
·Ñ³»ÀÇ ÇöÀç ÂüÁ¶µÇ°í ÀÖ´Â MBean ¼ö
¿¹¿Ü:
IllegalArgumentException - ·Ñ¸íÀÌ null °æ¿ì
RoleNotFoundException - ÁöÁ¤µÈ À̸§ÀÇ ·ÑÀÌ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì

getAllRoles

RoleResult  getAllRoles()
                       throws RelationServiceNotRegisteredException 
°ü°è¿¡ Æ÷ÇԵǴ ¸ðµç ·ÑÀ» µ¹·ÁÁÝ´Ï´Ù.

¹Ýȯ°ª:
RoleResult ¿ÀºêÁ§Æ®. Ãëµæ¿¡ ¼º°øÇÑ ·ÑÀÇ RoleList ¿Í Àо ¼ö ¾ø¾ú´ø ·ÑÀÇ RoleUnresolvedList¸¦ Æ÷ÇÔÇÑ´Ù
¿¹¿Ü:
RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ MBean Server ¿¡ µî·ÏµÇÁö ¾ÊÀº °æ¿ì

retrieveAllRoles

RoleList  retrieveAllRoles()
µ¶ÇØ ¸ðµå¸¦ üũÇÏÁö ¾Ê°í, °ü°è¿¡ Æ÷ÇԵǴ ¸ðµç ·ÑÀ» µ¹·ÁÁÝ´Ï´Ù.

¹Ýȯ°ª:
RoleList

setRole

void setRole(Role  theRole)
             throws IllegalArgumentException,

                    RoleNotFoundException,

                    RelationTypeNotFoundException,

                    InvalidRoleValueException,

                    RelationServiceNotRegisteredException,

                    RelationNotFoundException 
ÁöÁ¤µÈ ·ÑÀ» ¼³Á¤ÇÕ´Ï´Ù.

°ü°èÀÇ °ü°èÇü¿¡ Æ÷ÇԵǾî ÀÖ´Â ´ëÀÀÇÏ´Â ·Ñ Á¤ÀÇ¿¡ µû¶ó, ·ÑÀ» üũÇÕ´Ï´Ù.

ÅëÁö¸¦ ¼Û½ÅÇÕ´Ï´Ù. °ü°è°¡ MBean ÀÏÁö ¾î¶³Áö¿¡ ÇØ, RelationNotification ÇüÅ´ RELATION_BASIC_UPDATE ¶Ç´Â RELATION_MBEAN_UPDATE °¡ µË´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRole - ¼³Á¤µÇ´Â ·Ñ (À̸§°ú »õ·Î¿î °ª)
¿¹¿Ü:
IllegalArgumentException - ·ÑÀÌ null °æ¿ì
RoleNotFoundException - ·ÑÀÌ ±âÀÔÇØ °¡´ÉÇÏÁö ¾ÊÀº °æ¿ì (·ÑÀÇ ÃʱâÈ­½Ã¿¡´Â ±âÀÔ ¾×¼¼½º ¸ðµåÀÇ Ã¼Å©´Â ÇàÇØÁöÁö ¾Ê´Â´Ù)
InvalidRoleValueException - ·Ñ¿¡ ´ëÇØ¼­ Á¦°øµÈ °ªÀÌ ¹«È¿ÀÎ °æ¿ì:

- ÁöÁ¤µÈ °ª¿¡ Æ÷ÇԵǴ ÂüÁ¶ ´ë»óÀÇ MBean ¼ö°¡ ¿¹»ó ÃÖ¼ÒÄ¡º¸´Ù ÀÛÀº °æ¿ì

- ÁöÁ¤µÈ °ª¿¡ Æ÷ÇԵǴ ÂüÁ¶ ´ë»óÀÇ MBean ¼ö°¡ ¿¹»ó ÃÖ´ëÄ¡¸¦ ³Ñ°í ÀÖ´Â °æ¿ì

- Ä¡¿¡ Æ÷ÇԵǴ ÂüÁ¶ ´ë»óÀÇ MBean Áß 1 °³ÀÌ, ±× ·ÑÀÇ MBean Ŭ·¡½ºÀÇ ¿ÀºêÁ§Æ®°¡ ¾Æ´Ñ °æ¿ì

- ±× ·ÑÀÇ MBean °¡ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì

RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ MBean Server ¿¡ µî·ÏµÇÁö ¾ÊÀº °æ¿ì
RelationTypeNotFoundException - °ü°è ¼­ºñ½º¿¡ °ü°èÇüÀÌ ¼±¾ðµÇ¾î ÀÖÁö ¾ÊÀº °æ¿ì
RelationNotFoundException - °ü°è ¼­ºñ½º¿¡ °ü°è°¡ Ãß°¡µÇ¾î ÀÖÁö ¾ÊÀº °æ¿ì
°ü·Ã Ç׸ñ:
getRole(java.lang.String)

setRoles

RoleResult  setRoles(RoleList  theRoleList)
                    throws IllegalArgumentException,

                           RelationServiceNotRegisteredException,

                           RelationTypeNotFoundException,

                           RelationNotFoundException 
ÁöÁ¤µÈ ·ÑÀ» ¼³Á¤ÇÕ´Ï´Ù.

°ü°èÀÇ °ü°èÇü¿¡ Æ÷ÇԵǾî ÀÖ´Â ´ëÀÀÇÏ´Â ·Ñ Á¤ÀÇ¿¡ µû¶ó, ·ÑÀ» üũÇÕ´Ï´Ù.

·ÑÀÌ °»½ÅµÉ ¶§¸¶´Ù ÅëÁö¸¦ ¼Û½ÅÇÕ´Ï´Ù. °ü°è°¡ MBean ÀÏÁö ¾î¶³Áö¿¡ ÇØ, RelationNotification ÇüÅ´ RELATION_BASIC_UPDATE ¶Ç´Â RELATION_MBEAN_UPDATE °¡ µË´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRoleList - ¼³Á¤µÇ´Â ·ÑÀÇ ¸®½ºÆ®
¹Ýȯ°ª:
RoleResult ¿ÀºêÁ§Æ®. ¼³Á¤¿¡ ¼º°øÇÑ ·ÑÀÇ RoleList ¿Í ¼³Á¤µÇÁö ¾Ê¾Ò´ø ·ÑÀÇ RoleUnresolvedList¸¦ Æ÷ÇÔÇÑ´Ù
¿¹¿Ü:
IllegalArgumentException - ·Ñ¸íÀÌ null °æ¿ì
RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ MBean Server ¿¡ µî·ÏµÇÁö ¾ÊÀº °æ¿ì
RelationTypeNotFoundException - °ü°è ¼­ºñ½º¿¡ °ü°èÇüÀÌ ¼±¾ðµÇ¾î ÀÖÁö ¾ÊÀº °æ¿ì
RelationNotFoundException - °ü°è ¼­ºñ½º¿¡ °ü°è MBean °¡ Ãß°¡µÇ¾î ÀÖÁö ¾ÊÀº °æ¿ì
°ü·Ã Ç׸ñ:
getRoles(java.lang.String[])

handleMBeanUnregistration

void handleMBeanUnregistration(ObjectName  theObjName,
                               String  theRoleName)
                               throws IllegalArgumentException,

                                      RoleNotFoundException,

                                      InvalidRoleValueException,

                                      RelationServiceNotRegisteredException,

                                      RelationTypeNotFoundException,

                                      RelationNotFoundException 
·Ñ¿¡ Æ÷ÇԵǴ ÂüÁ¶ ´ë»óÀÇ MBean µî·ÏÀÌ ÇØÁ¦µÇ¾úÀ» °æ¿ì¿¡ °ü°è ¼­ºñ½º¿¡ ÇØ »ç¿ëµÇ´Â ÄݹéÀÔ´Ï´Ù.

°ü°è ¼­ºñ½º´Â ÀÌ ¸Þ¼­µå¸¦ È£ÃâÇØ, °ü°è¿¡ µî·Ï ÇØÁ¦ÀÇ ¿µÇâÀ» ¹Ý¿µÇϱâ À§ÇÑ ¾×¼ÇÀ» ¹Þ°Ô ÇÕ´Ï´Ù.

ÀÌ ¸Þ¼­µå´Â À¯Àú·ÎºÎÅÍ´Â ºÒ·Á °¡Áö ¾Ê½À´Ï´Ù.

ÇöÀçÀÇ ±¸ÇöÀº, ÇöÀçÀÇ °ª (ÂüÁ¶ ´ë»óÀÇ MBean ObjectName ¸®½ºÆ®)À» »ç¿ëÇØ ·ÑÀ» ¼³Á¤ÇÕ´Ï´Ù. µî·Ï ÇØÁ¦µÇ°í ÀÖ´Â °ÍÀº »ç¿ëÇÏÁö ¾Ê½À´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theObjName - µî·Ï ÇØÁ¦µÈ MBean ObjectName
theRoleName - MBean ÂüÁ¶¿¡ »ç¿ëµÇ´Â ·Ñ¸í
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RoleNotFoundException - °ü°è³»¿¡ ·ÑÀÌ Á¸ÀçÇÏÁö ¾Ê´ÂÁö, ±âÀÔ ºÒ°¡ÀÎ °æ¿ì
InvalidRoleValueException - ·ÑÀÌ ·Ñ Á¤º¸¿¡ ÁذÅÇϰí ÀÖÁö ¾Ê´Â °æ¿ì (°ü°è ¼­ºñ½º·ÎºÎÅÍ ºÒ·Á °¬À» °æ¿ì´Â ÀϾ ¼ö ¾ø´Â Á¶°Ç)
RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ MBean Server ¿¡ µî·ÏµÇÁö ¾ÊÀº °æ¿ì
RelationTypeNotFoundException - °ü°è ¼­ºñ½º¿¡ °ü°èÇüÀÌ ¼±¾ðµÇ¾î ÀÖÁö ¾ÊÀº °æ¿ì
RelationNotFoundException - ÀÌ ¸Þ¼­µå°¡, °ü°è ¼­ºñ½º¿¡ Ãß°¡µÇ¾î ÀÖÁö ¾ÊÀº °ü°è MBean ¿¡ ´ëÇØ¼­ ºÒ·Á °¬À» °æ¿ì

getReferencedMBeans

Map  getReferencedMBeans()
°ü°èÀÇ ´Ù¾çÇÑ ·Ñ·Î ÂüÁ¶µÇ´Â MBean¸¦ ÃëµæÇÕ´Ï´Ù.

¹Ýȯ°ª:
HashMap ¸ÅÇÎ:

ObjectName ¡æ String (·Ñ¸í)·ÎºÎÅÍ ¿Ï¼ºµÇ´Â ArrayList


getRelationTypeName

String  getRelationTypeName()
°ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø °ü°èÇüÀÇ À̸§À» µ¹·ÁÁÝ´Ï´Ù.

¹Ýȯ°ª:
°ü°èÇüÀÇ À̸§

getRelationServiceName

ObjectName  getRelationServiceName()
°ü°è¸¦ ó¸®ÇÏ´Â °ü°è ¼­ºñ½ºÀÇ ObjectName¸¦ µ¹·ÁÁÝ´Ï´Ù.

¹Ýȯ°ª:
°ü°è ¼­ºñ½ºÀÇ ObjectName

getRelationId

String  getRelationId()
°ü°è ¼­ºñ½º³»ÀÇ °ü°è¸¦ ÀÏÀÇ¿¡ ½Äº°Çϱâ À§Çؼ­ »ç¿ëµÇ´Â °ü°è ½Äº°ÀÚ¸¦ µ¹·ÁÁÝ´Ï´Ù.

¹Ýȯ°ª:
°ü°è ID

JavaTM 2 Platform
Standard Ed. 5.0

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy µµ ÂüÁ¶ÇϽʽÿÀ.