JavaTM 2 Platform
Standard Ed. 5.0

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

±âÁ¸ÀÇ ±¸Çö Ŭ·¡½ºÀÇ À϶÷:
RelationService

public interface RelationServiceMBean

°ü°è ¼­ºñ½º¿¡´Â °ü°èÇü°ú °ü°èÀÇ ÀÛ¼º ¹× »èÁ¦, Á¤ÇÕ¼ºÀÇ Ã³¸® ¹× Äõ¸®µµ±¸ ÀÇ Á¦°øÀÇ ±â´ÉÀÌ ÀÖ½À´Ï´Ù.

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

¸Þ¼­µå °³¿ä
 void addRelation (ObjectName  theRelObjectName)
          À¯Àú¿¡ ÇØ ÀÛ¼ºµÇ¾î MBean Server ¿¡ µî·ÏµÇ´Â MBean¸¦ , °ü°è·Î¼­ °ü°è ¼­ºñ½º¿¡ Ãß°¡ÇÕ´Ï´Ù.
 void addRelationType (RelationType  theRelTypeObj)
          ÁöÁ¤µÈ ¿ÀºêÁ§Æ®¸¦ °ü°èÇüÀ¸·Î¼­ Ãß°¡ÇÕ´Ï´Ù.
 Integer checkRoleReading (String  theRoleName, String  theRelTypeName)
          ÁöÁ¤µÈ ÇüÅÂÀÇ °ü°è·Î ÁöÁ¤µÈ Role µ¶Çذ¡ °¡´ÉÇѰ¡ ¾î¶²°¡¸¦ üũÇÕ´Ï´Ù.
 Integer checkRoleWriting (Role  theRole, String  theRelTypeName, Boolean  theInitFlg)
          ÁöÁ¤µÈ ÇüÅÂÀÇ °ü°è·Î ÁöÁ¤µÈ Role ¼³Á¤ÀÌ °¡´ÉÇѰ¡ ¾î¶²°¡¸¦ üũÇÕ´Ï´Ù.
 void createRelation (String  theRelId, String  theRelTypeName, RoleList  theRoleList)
          ÁöÁ¤µÈ °ü°èÇüÀÇ ´Ü¼øÇÑ °ü°è (RelationSupport ¿ÀºêÁ§Æ®)¸¦ ÀÛ¼ºÇØ, À̰ÍÀ» °ü°è ¼­ºñ½º¿¡ Ãß°¡ÇÕ´Ï´Ù.
 void createRelationType (String  theRelTypeName, RoleInfo [] theRoleInfoArray)
          RoleInfo ¿ÀºêÁ§Æ®·ÎºÎÅÍ Á¦°øµÈ ·Ñ Á¤º¸¸¦ »ç¿ëÇØ, °ü°èÇü (RelationTypeSupport ¿ÀºêÁ§Æ®)À» ÀÛ¼ºÇØ, °ü°è ¼­ºñ½º¿¡ Ãß°¡ÇÕ´Ï´Ù.
 Map findAssociatedMBeans (ObjectName  theMBeanName, String  theRelTypeName, String  theRoleName)
          °ü°è³»ÀÇ ÁöÁ¤µÈ MBean ¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø MBean¸¦ ÃëµæÇÕ´Ï´Ù.
 Map findReferencingRelations (ObjectName  theMBeanName, String  theRelTypeName, String  theRoleName)
          ÁöÁ¤µÈ MBean °¡ ÂüÁ¶µÇ´Â °ü°è¸¦ ÃëµæÇÕ´Ï´Ù.
 List findRelationsOfType (String  theRelTypeName)
          ÁöÁ¤µÈ ÇüÅÂÀÇ °ü°èÀÇ °ü°è ID¸¦ µ¹·ÁÁÝ´Ï´Ù.
 List getAllRelationIds ()
          °ü°è ¼­ºñ½º¿¡ ÇØ 󸮵Ǵ ¸ðµç °ü°èÀÇ ¸ðµç °ü°è ID¸¦ µ¹·ÁÁÝ´Ï´Ù.
 List getAllRelationTypeNames ()
          ±âÁ¸ÀÇ ¸ðµç °ü°èÇüÀÇ À̸§À» ÃëµæÇÕ´Ï´Ù.
 RoleResult getAllRoles (String  theRelId)
          °ü°è¿¡ Æ÷ÇԵǴ ¸ðµç ·ÑÀ» µ¹·ÁÁÝ´Ï´Ù.
 boolean getPurgeFlag ()
          °ü°è³»ÀÇ ÂüÁ¶ ´ë»óÀÇ MBean µî·Ï ÇØÁ¦ÀÇ ÅëÁö¸¦ ¾ðÁ¦ ¼ö½ÅÇß´ÂÁö, °ü°è¸¦ Áï½Ã ¡¸ÆÛÁö¡¹ (À¯È¿ÇÏÁö ¾Ê°Ô µÈ °ü°è¸¦ °Ë»ö) ÇÒ Çʿ䰡 ÀÖÀ»Áö ¾î¶³Áö, ¶Ç´Â purgeRelations ¸Þ¼­µå°¡ ¸í½ÃÀûÀ¸·Î ºÒ·Á °¡´Â °æ¿ì¿¡°Ô¸¸ ÆÛÁö°¡ ½ÇÇàµÉÁö ¾î¶³Áö¸¦ ³ªÅ¸³»´Â Ç÷¡±×¸¦ µ¹·ÁÁÝ´Ï´Ù.
 Map getReferencedMBeans (String  theRelId)
          °ü°èÀÇ ´Ù¾çÇÑ ·Ñ·Î ÂüÁ¶µÇ´Â MBean¸¦ ÃëµæÇÕ´Ï´Ù.
 String getRelationTypeName (String  theRelId)
          ÁöÁ¤µÈ °ü°èÀÇ °ü°èÇüÀÇ À̸§À» µ¹·ÁÁÝ´Ï´Ù.
 List getRole (String  theRelId, String  theRoleName)
          ÁöÁ¤µÈ °ü°è¿¡ Æ÷ÇԵǴ ÁöÁ¤µÈ ·Ñ¸íÀÇ ·ÑÄ¡¸¦ ÃëµæÇÕ´Ï´Ù.
 Integer getRoleCardinality (String  theRelId, String  theRoleName)
          ÁöÁ¤µÈ ·Ñ³»¿¡¼­ ÇöÀç ÂüÁ¶µÇ°í ÀÖ´Â MBean ¼ö¸¦ ÃëµæÇÕ´Ï´Ù.
 RoleInfo getRoleInfo (String  theRelTypeName, String  theRoleInfoName)
          ÁöÁ¤µÈ °ü°èÇüÀÇ ÁöÁ¤µÈ ·ÑÀÇ Á¤º¸¸¦ ÃëµæÇÕ´Ï´Ù.
 List getRoleInfos (String  theRelTypeName)
          ÁöÁ¤µÈ °ü°èÇüÀÇ ·Ñ Á¤º¸ (RoleInfo ¿ÀºêÁ§Æ®)ÀÇ ¸®½ºÆ®¸¦ ÃëµæÇÕ´Ï´Ù.
 RoleResult getRoles (String  theRelId, String [] theRoleNameArray)
          ÁöÁ¤µÈ °ü°è¿¡ Æ÷ÇԵǴ ÁöÁ¤µÈ À̸§ÀÇ ·ÑÀÇ °ªÀ» ÃëµæÇÕ´Ï´Ù.
 Boolean hasRelation (String  theRelId)
          °ü°è ¼­ºñ½º³»·Î ÁöÁ¤µÈ °ü°è ID ·Î ½Äº°µÇ´Â °ü°è°¡ ÀÖÀ»Áö ¾î¶³Áö¸¦ üũÇÕ´Ï´Ù.
 void isActive ()
          °ü°è ¼­ºñ½º°¡ ¾×ƼºêÇѰ¡ ¾î¶²°¡¸¦ üũÇÕ´Ï´Ù.
 String isRelation (ObjectName  theObjName)
          MBean °¡ °ü°è·Î¼­ °ü°è ¼­ºñ½º¿¡ Ãß°¡µÇ°í ÀÖ´Â °æ¿ì, ÁöÁ¤µÈ ObjectName ¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ´Â °ü°è ID¸¦ µ¹·ÁÁÝ´Ï´Ù.
 ObjectName isRelationMBean (String  theRelId)
          À¯Àú¿¡ ÇØ ÀÛ¼ºµÇ¾î °ü°è·Î¼­ °ü°è ¼­ºñ½º¿¡ Ãß°¡µÈ MBean °¡ °ü°è¸¦ ³ªÅ¸³»´Â °æ¿ì, ÀÌ MBean ObjectName¸¦ µ¹·ÁÁÝ´Ï´Ù.
 void purgeRelations ()
          °ü°è¸¦ ÆÛÁö ÇÕ´Ï´Ù.
 void removeRelation (String  theRelId)
          ÁöÁ¤µÈ °ü°èÇüÀ» °ü°è ¼­ºñ½º·ÎºÎÅÍ »èÁ¦ÇÕ´Ï´Ù.
 void removeRelationType (String  theRelTypeName)
          ÁöÁ¤µÈ °ü°èÇüÀ» °ü°è ¼­ºñ½º·ÎºÎÅÍ »èÁ¦ÇÕ´Ï´Ù.
 void sendRelationCreationNotification (String  theRelId)
          °ü°è ÀÛ¼ºÀÇ ÅëÁö (RelationNotification)¸¦ ¼Û½ÅÇÕ´Ï´Ù.
 void sendRelationRemovalNotification (String  theRelId, List  theUnregMBeanList)
          °ü°è »èÁ¦ÀÇ ÅëÁö (RelationNotification)¸¦ ¼Û½ÅÇÕ´Ï´Ù.
 void sendRoleUpdateNotification (String  theRelId, Role  theNewRole, List  theOldRoleValue)
          ÁöÁ¤µÈ °ü°è³»ÀÇ ·Ñ °»½ÅÀÇ ÅëÁö (RelationNotification)¸¦ ¼Û½ÅÇÕ´Ï´Ù.
 void setPurgeFlag (boolean thePurgeFlg)
          °ü°è³»ÀÇ ÂüÁ¶ ´ë»óÀÇ MBean µî·Ï ÇØÁ¦ÀÇ ÅëÁö¸¦ ¾ðÁ¦ ¼ö½ÅÇß´ÂÁö, °ü°è¸¦ Áï½Ã ¡¸ÆÛÁö¡¹ (À¯È¿ÇÏÁö ¾Ê°Ô µÈ °ü°è¸¦ °Ë»ö) ÇÒ Çʿ䰡 ÀÖÀ»Áö ¾î¶³Áö, ¶Ç´Â purgeRelations ¸Þ¼­µå°¡ ¸í½ÃÀûÀ¸·Î ºÒ·Á °¡´Â °æ¿ì¿¡°Ô¸¸ ÆÛÁö°¡ ½ÇÇàµÉÁö ¾î¶³Áö¸¦ ³ªÅ¸³»´Â Ç÷¡±×¸¦ ¼³Á¤ÇÕ´Ï´Ù.
 void setRole (String  theRelId, Role  theRole)
          ÁöÁ¤µÈ °ü°è³»ÀÇ ÁöÁ¤µÈ ·ÑÀ» ¼³Á¤ÇÕ´Ï´Ù.
 RoleResult setRoles (String  theRelId, RoleList  theRoleList)
          ÁöÁ¤µÈ °ü°è³»ÀÇ ÁöÁ¤µÈ ·ÑÀ» ¼³Á¤ÇÕ´Ï´Ù.
 void updateRoleMap (String  theRelId, Role  theNewRole, List  theOldRoleValue)
          ÁöÁ¤µÈ °ü°è³»ÀÇ ÁöÁ¤µÈ ·ÑÀ» °»½ÅÇϱâ À§ÇØ, °ü°è ¼­ºñ½º ·Ñ ¸ÊÀÇ °»½ÅÀ» ó¸®ÇÕ´Ï´Ù.
 

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

isActive

void isActive()
              throws RelationServiceNotRegisteredException 
°ü°è ¼­ºñ½º°¡ ¾×ƼºêÇѰ¡ ¾î¶²°¡¸¦ üũÇÕ´Ï´Ù. ÇöÀç, °ü°è ¼­ºñ½º¸¦ MBean Server ¿¡ µî·ÏÇÒ Çʿ䰡 ÀÖ½À´Ï´Ù.

¿¹¿Ü:
RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ ¹Ìµî·ÏÀÇ °æ¿ì

getPurgeFlag

boolean getPurgeFlag()
°ü°è³»ÀÇ ÂüÁ¶ ´ë»óÀÇ MBean µî·Ï ÇØÁ¦ÀÇ ÅëÁö¸¦ ¾ðÁ¦ ¼ö½ÅÇß´ÂÁö, °ü°è¸¦ Áï½Ã ¡¸ÆÛÁö¡¹ (À¯È¿ÇÏÁö ¾Ê°Ô µÈ °ü°è¸¦ °Ë»ö) ÇÒ Çʿ䰡 ÀÖÀ»Áö ¾î¶³Áö, ¶Ç´Â purgeRelations ¸Þ¼­µå°¡ ¸í½ÃÀûÀ¸·Î ºÒ·Á °¡´Â °æ¿ì¿¡°Ô¸¸ ÆÛÁö°¡ ½ÇÇàµÉÁö ¾î¶³Áö¸¦ ³ªÅ¸³»´Â Ç÷¡±×¸¦ µ¹·ÁÁÝ´Ï´Ù.

true °æ¿ì, Áï½Ã ÆÛÁö¸¦ ½Ç½ÃÇÒ Çʿ䰡 ÀÖ½À´Ï´Ù.

¹Ýȯ°ª:
Áï½Ã ÆÛÁö¸¦ ÇÏ´Â °æ¿ì´Â true
°ü·Ã Ç׸ñ:
setPurgeFlag(boolean)

setPurgeFlag

void setPurgeFlag(boolean thePurgeFlg)
°ü°è³»ÀÇ ÂüÁ¶ ´ë»óÀÇ MBean µî·Ï ÇØÁ¦ÀÇ ÅëÁö¸¦ ¾ðÁ¦ ¼ö½ÅÇß´ÂÁö, °ü°è¸¦ Áï½Ã ¡¸ÆÛÁö¡¹ (À¯È¿ÇÏÁö ¾Ê°Ô µÈ °ü°è¸¦ °Ë»ö) ÇÒ Çʿ䰡 ÀÖÀ»Áö ¾î¶³Áö, ¶Ç´Â purgeRelations ¸Þ¼­µå°¡ ¸í½ÃÀûÀ¸·Î ºÒ·Á °¡´Â °æ¿ì¿¡°Ô¸¸ ÆÛÁö°¡ ½ÇÇàµÉÁö ¾î¶³Áö¸¦ ³ªÅ¸³»´Â Ç÷¡±×¸¦ ¼³Á¤ÇÕ´Ï´Ù.

true °æ¿ì, Áï½Ã ÆÛÁö¸¦ ½Ç½ÃÇÒ Çʿ䰡 ÀÖ½À´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
thePurgeFlg - Ç÷¡±×
°ü·Ã Ç׸ñ:
getPurgeFlag()

createRelationType

void createRelationType(String  theRelTypeName,
                        RoleInfo [] theRoleInfoArray)
                        throws IllegalArgumentException,

                               InvalidRelationTypeException 
RoleInfo ¿ÀºêÁ§Æ®·ÎºÎÅÍ Á¦°øµÈ ·Ñ Á¤º¸¸¦ »ç¿ëÇØ, °ü°èÇü (RelationTypeSupport ¿ÀºêÁ§Æ®)À» ÀÛ¼ºÇØ, °ü°è ¼­ºñ½º¿¡ Ãß°¡ÇÕ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelTypeName - °ü°èÇüÀÇ À̸§
theRoleInfoArray - ·Ñ Á¤º¸ÀÇ ¹è¿­
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
InvalidRelationTypeException - ´ÙÀ½ÀÇ Á¶°ÇÀÌ ¼º¸³ÇÏ´Â °æ¿ì:

- °°Àº À̸§ÀÇ °ü°èÇüÀÌ ¹ú½á Á¸ÀçÇÏ´Â °æ¿ì

- °°Àº À̸§ÀÌ 2 °³°¡ ´Ù¸¥ ·Ñ Á¤º¸·Î »ç¿ëµÇ°í ÀÖ´Â °æ¿ì

- ·Ñ Á¤º¸°¡ Á¦°øµÇÁö ¾Ê¾Ò´ø °æ¿ì

- ·Ñ Á¤º¸·Î¼­ null °¡ Á¦°øµÇ¾úÀ» °æ¿ì


addRelationType

void addRelationType(RelationType  theRelTypeObj)
                     throws IllegalArgumentException,

                            InvalidRelationTypeException 
ÁöÁ¤µÈ ¿ÀºêÁ§Æ®¸¦ °ü°èÇüÀ¸·Î¼­ Ãß°¡ÇÕ´Ï´Ù. ÀÌ ¿ÀºêÁ§Æ®´Â RelationType ÀÎÅÍÆäÀ̽º¸¦ ±¸ÇöÇÒ Çʿ䰡 ÀÖ½À´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelTypeObj - °ü°èÇü ¿ÀºêÁ§Æ® (RelationType ÀÎÅÍÆäÀ̽º¸¦ ±¸Çö)
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
InvalidRelationTypeException - °°Àº À̸§ÀÇ °ü°èÇüÀÌ ¹ú½á Á¸ÀçÇÏ´Â °æ¿ì

getAllRelationTypeNames

List  getAllRelationTypeNames()
±âÁ¸ÀÇ ¸ðµç °ü°èÇüÀÇ À̸§À» ÃëµæÇÕ´Ï´Ù.

¹Ýȯ°ª:
°ü°èÇüÀÇ À̸§ (String)ÀÇ ArrayList

getRoleInfos

List  getRoleInfos(String  theRelTypeName)
                  throws IllegalArgumentException,

                         RelationTypeNotFoundException 
ÁöÁ¤µÈ °ü°èÇüÀÇ ·Ñ Á¤º¸ (RoleInfo ¿ÀºêÁ§Æ®)ÀÇ ¸®½ºÆ®¸¦ ÃëµæÇÕ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelTypeName - °ü°èÇüÀÇ À̸§
¹Ýȯ°ª:
RoleInfo ArrayList
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationTypeNotFoundException - ±× À̸§ÀÇ °ü°èÇüÀÌ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì

getRoleInfo

RoleInfo  getRoleInfo(String  theRelTypeName,
                     String  theRoleInfoName)
                     throws IllegalArgumentException,

                            RelationTypeNotFoundException,

                            RoleInfoNotFoundException 
ÁöÁ¤µÈ °ü°èÇüÀÇ ÁöÁ¤µÈ ·ÑÀÇ Á¤º¸¸¦ ÃëµæÇÕ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelTypeName - °ü°èÇüÀÇ À̸§
theRoleInfoName - ·Ñ¸í
¹Ýȯ°ª:
RoleInfo ¿ÀºêÁ§Æ®
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationTypeNotFoundException - °ü°è ¼­ºñ½º¿¡ ÀÖ¾î ¹ÌÁöÀÇ °ü°èÇüÀÎ °æ¿ì
RoleInfoNotFoundException - °ü°èÇü¿¡ ·ÑÀÌ Æ÷ÇÔµÇÁö ¾ÊÀº °æ¿ì

removeRelationType

void removeRelationType(String  theRelTypeName)
                        throws RelationServiceNotRegisteredException,

                               IllegalArgumentException,

                               RelationTypeNotFoundException 
ÁöÁ¤µÈ °ü°èÇüÀ» °ü°è ¼­ºñ½º·ÎºÎÅÍ »èÁ¦ÇÕ´Ï´Ù.

±× ÇüÅÂÀÇ °ü°è ¿ÀºêÁ§Æ®°¡ °ü°è ¼­ºñ½º·ÎºÎÅÍ »èÁ¦µË´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelTypeName - »èÁ¦µÇ´Â °ü°èÇüÀÇ À̸§
¿¹¿Ü:
RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ MBean Server ¿¡ µî·ÏµÇÁö ¾ÊÀº °æ¿ì
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationTypeNotFoundException - ±× À̸§ÀÇ °ü°èÇüÀÌ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì

createRelation

void createRelation(String  theRelId,
                    String  theRelTypeName,
                    RoleList  theRoleList)
                    throws RelationServiceNotRegisteredException,

                           IllegalArgumentException,

                           RoleNotFoundException,

                           InvalidRelationIdException,

                           RelationTypeNotFoundException,

                           InvalidRoleValueException 
ÁöÁ¤µÈ °ü°èÇüÀÇ ´Ü¼øÇÑ °ü°è (RelationSupport ¿ÀºêÁ§Æ®)¸¦ ÀÛ¼ºÇØ, À̰ÍÀ» °ü°è ¼­ºñ½º¿¡ Ãß°¡ÇÕ´Ï´Ù.

·ÑÀº ÆÄ¶ó¹ÌÅÍ·Î ÁöÁ¤µÈ ·Ñ ¸®½ºÆ®¿¡ µû¶ó ÃʱâÈ­µË´Ï´Ù. ÀÌ ¹æ¹ýÀ¸·Î ÃʱâÈ­µÇÁö ¾Ê´Â ·ÑÀº, ObjectName ÇÏ´ÃÀÇ ArrayList ·Î ¼³Á¤µË´Ï´Ù.

RELATION_BASIC_CREATION ÇüÀÇ RelationNotification °¡ ¼Û½ÅµË´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelId - °ü°è ¼­ºñ½º³»ÀÇ °ü°è¸¦ ÀÏÀÇ¿¡ ½Äº°Çϱâ À§Çؼ­ »ç¿ëµÇ´Â °ü°è ½Äº°ÀÚ
theRelTypeName - °ü°è ¼­ºñ½º³»¿¡ ÀÛ¼ºÇÒ Çʿ䰡 ÀÖ´Â °ü°èÇüÀÇ À̸§
theRoleList - °ü°èÀÇ ·ÑÀ» ÃʱâÈ­Çϱâ À§ÇÑ ·Ñ ¸®½ºÆ® (null µµ °¡´É)
¿¹¿Ü:
RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ MBean Server ¿¡ µî·ÏµÇÁö ¾ÊÀº °æ¿ì
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RoleNotFoundException - °ü°èÇü³»¿¡ Á¸ÀçÇÏÁö ¾Ê´Â ·Ñ¿¡ °ªÀÌ Á¦°øµÇ¾úÀ» °æ¿ì
InvalidRelationIdException - °ü°è ID °¡ ¹ú½á »ç¿ëµÇ°í ÀÖ´Â °æ¿ì
RelationTypeNotFoundException - °ü°è ¼­ºñ½º¿¡ ÀÖ¾î ¹ÌÁöÀÇ °ü°èÇüÀÎ °æ¿ì
InvalidRoleValueException - ´ÙÀ½ÀÇ Á¶°ÇÀÌ ¼º¸³ÇÏ´Â °æ¿ì:

- °°Àº À̸§ÀÌ 2 °³°¡ ´Ù¸¥ ·Ñ·Î »ç¿ëµÇ°í ÀÖ´Â °æ¿ì

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

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

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

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


addRelation

void addRelation(ObjectName  theRelObjectName)
                 throws IllegalArgumentException,

                        RelationServiceNotRegisteredException,

                        NoSuchMethodException,

                        InvalidRelationIdException,

                        InstanceNotFoundException,

                        InvalidRelationServiceException,

                        RelationTypeNotFoundException,

                        RoleNotFoundException,

                        InvalidRoleValueException 
À¯Àú¿¡ ÇØ ÀÛ¼ºµÇ¾î MBean Server ¿¡ µî·ÏµÇ´Â MBean¸¦ , °ü°è·Î¼­ °ü°è ¼­ºñ½º¿¡ Ãß°¡ÇÕ´Ï´Ù.

MBean¸¦ °ü°è·Î¼­ Ãß°¡Çϱâ À§Çؼ­´Â ´ÙÀ½ÀÇ Á¶°ÇÀÌ Ã¤¿öÁö°í ÀÖÀ» Çʿ䰡 ÀÖ½À´Ï´Ù.

- MBean °¡ Relation ÀÎÅÍÆäÀ̽º¸¦ ±¸ÇöÇϰí ÀÖ´Ù

- MBean °¡ RelationService ObjectName ¿ëÀ¸·Î¼­ ÇöÀçÀÇ °ü°è ¼­ºñ½ºÀÇ ObjectName¸¦ °¡Áö°í ÀÖ´Ù

- MBean °¡ ÇöÀçÀÇ °ü°è ¼­ºñ½º³»¿¡¼­ ÀÏÀÇ ¶ÇÇÑ ¹Ì»ç¿ëÀÇ °ü°è ID¸¦ °¡Áö°í ÀÖ´Ù

- MBean °¡ °ü°èÇü¿ëÀ¸·Î¼­ °ü°è ¼­ºñ½º³»¿¡¼­ ÀÛ¼ºµÈ °ü°èÇüÀ» °¡Áö°í ÀÖ´Ù

- MBean °¡ °ü°èÇü³»¿¡¼­ Á¦°øµÈ ·Ñ Á¤º¸¿¡ ÀûÇÕÇÏ´Â ·ÑÀ» °¡Áö°í ÀÖ´Ù

ÆÄ¶ó¹ÌÅÍ:
theRelObjectName - Ãß°¡µÇ´Â °ü°è MBean ObjectName
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ MBean Server ¿¡ µî·ÏµÇÁö ¾ÊÀº °æ¿ì
NoSuchMethodException - MBean °¡ Relation ÀÎÅÍÆäÀ̽º¸¦ ±¸ÇöÇϰí ÀÖÁö ¾Ê´Â °æ¿ì
InvalidRelationIdException - ´ÙÀ½ÀÇ Á¶°ÇÀÌ ¼º¸³ÇÏ´Â °æ¿ì:

- MBean ³»¿¡ °ü°è ½Äº°ÀÚ°¡ Á¸ÀçÇÏÁö ¾Ê´Â

- °ü°è ½Äº°ÀÚ°¡ °ü°è ¼­ºñ½º·Î ¹ú½á »ç¿ëµÇ°í ÀÖ´Â °æ¿ì

InstanceNotFoundException - ÁöÁ¤µÈ ObjectName MBean °¡ µî·ÏµÇÁö ¾ÊÀº °æ¿ì
InvalidRelationServiceException - ´ÙÀ½ÀÇ Á¶°ÇÀÌ ¼º¸³ÇÏ´Â °æ¿ì:

- MBean ³»¿¡ °ü°è ¼­ºñ½º¸íÀÌ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì

- MBean ³»ÀÇ °ü°è ¼­ºñ½º¸íÀÌ ÇöÀçÀÇ °ü°è ¼­ºñ½ºÀÇ °ü°è ¼­ºñ½º¸íÀÌ ¾Æ´Ñ °æ¿ì

RelationTypeNotFoundException - ´ÙÀ½ÀÇ Á¶°ÇÀÌ ¼º¸³ÇÏ´Â °æ¿ì:

- MBean ³»¿¡ °ü°èÇü¸íÀÌ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì

- MBean ³»ÀÇ °ü°èÇü¸íÀÌ °ü°è ¼­ºñ½º³»¿¡ ÀÛ¼ºµÈ °ü°èÇü¿¡ ´ëÀÀÇϰí ÀÖÁö ¾Ê´Â °æ¿ì

InvalidRoleValueException - ´ÙÀ½ÀÇ Á¶°ÇÀÌ ¼º¸³ÇÏ´Â °æ¿ì:

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

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

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

- ·Ñ¿¡ Á¦°øµÈ MBean °¡ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì

RoleNotFoundException - °ü°èÇü³»¿¡ Á¸ÀçÇÏÁö ¾Ê´Â ·Ñ¿¡ °ªÀÌ Á¦°øµÇ¾úÀ» °æ¿ì

isRelationMBean

ObjectName  isRelationMBean(String  theRelId)
                           throws IllegalArgumentException,

                                  RelationNotFoundException 
À¯Àú¿¡ ÇØ ÀÛ¼ºµÇ¾î °ü°è·Î¼­ °ü°è ¼­ºñ½º¿¡ Ãß°¡µÈ MBean °¡ °ü°è¸¦ ³ªÅ¸³»´Â °æ¿ì, ÀÌ MBean ObjectName¸¦ µ¹·ÁÁÝ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelId - °ü°è¸¦ ½Äº°ÇÏ´Â °ü°è ID
¹Ýȯ°ª:
´ëÀÀÇÏ´Â °ü°è MBean ObjectName. °ü°è°¡ MBean °¡ ¾Æ´Ñ °æ¿ì´Â null
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationNotFoundException - ÀÌ ID ¿¡ °ü°è¸¦ °ü·ÃÁöÀ» ¼ö ÀÖÁö ¾ÊÀº °æ¿ì

isRelation

String  isRelation(ObjectName  theObjName)
                  throws IllegalArgumentException 
MBean °¡ °ü°è·Î¼­ °ü°è ¼­ºñ½º¿¡ Ãß°¡µÇ°í ÀÖ´Â °æ¿ì, ÁöÁ¤µÈ ObjectName ¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ´Â °ü°è ID¸¦ µ¹·ÁÁÝ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theObjName - °¡Á¤µÈ °ü°èÀÇ ObjectName
¹Ýȯ°ª:
°ü°è ID (String). ObjectName °¡ °ü°è ¼­ºñ½º¿¡ ÇØ 󸮵Ǵ °ü°è°¡ ¾Æ´Ñ °æ¿ì´Â null
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì

hasRelation

Boolean  hasRelation(String  theRelId)
                    throws IllegalArgumentException 
°ü°è ¼­ºñ½º³»·Î ÁöÁ¤µÈ °ü°è ID ·Î ½Äº°µÇ´Â °ü°è°¡ ÀÖÀ»Áö ¾î¶³Áö¸¦ üũÇÕ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelId - °ü°è¸¦ ½Äº°ÇÏ´Â °ü°è ID
¹Ýȯ°ª:
boolean Çü. °ü°è°¡ Á¸ÀçÇÏ´Â °æ¿ì´Â true, Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì´Â false
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì

getAllRelationIds

List  getAllRelationIds()
°ü°è ¼­ºñ½º¿¡ ÇØ 󸮵Ǵ ¸ðµç °ü°èÀÇ ¸ðµç °ü°è ID¸¦ µ¹·ÁÁÝ´Ï´Ù.

¹Ýȯ°ª:
String ArrayList

checkRoleReading

Integer  checkRoleReading(String  theRoleName,
                         String  theRelTypeName)
                         throws IllegalArgumentException,

                                RelationTypeNotFoundException 
ÁöÁ¤µÈ ÇüÅÂÀÇ °ü°è·Î ÁöÁ¤µÈ Role µ¶Çذ¡ °¡´ÉÇѰ¡ ¾î¶²°¡¸¦ üũÇÕ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRoleName - üũµÇ´Â ·ÑÀÇ À̸§
theRelTypeName - °ü°èÇüÀÇ À̸§
¹Ýȯ°ª:
¹ß»ýÀÇ °¡´É¼ºÀÌ ÀÖ´Â ¹®Á¦¿¡ ´ëÀÀÇÏ´Â Á¤¼öÇü (RoleUnresolved ³»ÀÇ Á¤¼ö·Î ³ªÅ¸³»Áø´Ù)À»°¨½Î´Â Integer

- ·ÑÀÇ µ¶Çذ¡ °¡´ÉÇÑ °æ¿ì´Â 0

- RoleStatus.NO_ROLE_WITH_NAME ¿¡ ´ëÀÀÇÏ´Â Á¤¼öÇü

- RoleStatus.ROLE_NOT_READABLE ¿¡ ´ëÀÀÇÏ´Â Á¤¼öÇü

¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationTypeNotFoundException - °ü°è ¼­ºñ½º¿¡ ÀÖ¾î ¹ÌÁöÀÇ °ü°èÇüÀÎ °æ¿ì

checkRoleWriting

Integer  checkRoleWriting(Role  theRole,
                         String  theRelTypeName,
                         Boolean  theInitFlg)
                         throws IllegalArgumentException,

                                RelationTypeNotFoundException 
ÁöÁ¤µÈ ÇüÅÂÀÇ °ü°è·Î ÁöÁ¤µÈ Role ¼³Á¤ÀÌ °¡´ÉÇѰ¡ ¾î¶²°¡¸¦ üũÇÕ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRole - üũµÇ´Â ·Ñ
theRelTypeName - °ü°èÇüÀÇ À̸§
theInitFlg - ·ÑÀÇ ÃʱâÈ­¸¦ À§Çؼ­ üũ¸¦ ÇÑ °ÍÀ» ³ªÅ¸³»´Â Ç÷¡±×. ±âÀÔ ¾×¼¼½ºÀÇ °ËÁõÀº ÇàÇØÁöÁö ¾Ê´Â´Ù
¹Ýȯ°ª:
¹ß»ýÀÇ °¡´É¼ºÀÌ ÀÖ´Â ¹®Á¦¿¡ ´ëÀÀÇÏ´Â Á¤¼öÇü (RoleUnresolved ³»ÀÇ Á¤¼ö·Î ³ªÅ¸³»Áø´Ù)À»°¨½Î´Â Integer

- ·ÑÀÇ ¼³Á¤ÀÌ °¡´ÉÇÑ °æ¿ì´Â 0

- RoleStatus.NO_ROLE_WITH_NAME ¿¡ ´ëÀÀÇÏ´Â Á¤¼öÇü

- RoleStatus.ROLE_NOT_WRITABLE Á¤¼öÇü

- RoleStatus.LESS_THAN_MIN_ROLE_DEGREE Á¤¼öÇü

- RoleStatus.MORE_THAN_MAX_ROLE_DEGREE Á¤¼öÇü

- RoleStatus.REF_MBEAN_OF_INCORRECT_CLASS Á¤¼öÇü

- RoleStatus.REF_MBEAN_NOT_REGISTERED Á¤¼öÇü

¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationTypeNotFoundException - ¹ÌÁöÀÇ °ü°èÇüÀÇ °æ¿ì

sendRelationCreationNotification

void sendRelationCreationNotification(String  theRelId)
                                      throws IllegalArgumentException,

                                             RelationNotFoundException 
°ü°è ÀÛ¼ºÀÇ ÅëÁö (RelationNotification)¸¦ ¼Û½ÅÇÕ´Ï´Ù. ÅëÁöÇüÀº ´ÙÀ½°ú °°½À´Ï´Ù.

- RelationNotification.RELATION_BASIC_CREATION. °ü°è°¡ °ü°è ¼­ºñ½ºÀÇ ³»ºÎ ¿ÀºêÁ§Æ®ÀÎ °æ¿ì

- RelationNotification.RELATION_MBEAN_CREATION. °ü°è°¡ °ü°è·Î¼­ Ãß°¡µÈ MBean ÀÎ °æ¿ì

¼Ò½º ¿ÀºêÁ§Æ®´Â °ü°è ¼­ºñ½º ÀÚüÀÔ´Ï´Ù.

°ü°è ¼­ºñ½ºÀÇ createRelation() ¸Þ¼­µå ¹× addRelation() ¸Þ¼­µå·Î ºÒ·Á °©´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelId - °»½ÅµÈ °ü°èÀÇ °ü°è ½Äº°ÀÚ
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationNotFoundException - ÁöÁ¤µÈ °ü°è ID °ü°è°¡ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì

sendRoleUpdateNotification

void sendRoleUpdateNotification(String  theRelId,
                                Role  theNewRole,
                                List  theOldRoleValue)
                                throws IllegalArgumentException,

                                       RelationNotFoundException 
ÁöÁ¤µÈ °ü°è³»ÀÇ ·Ñ °»½ÅÀÇ ÅëÁö (RelationNotification)¸¦ ¼Û½ÅÇÕ´Ï´Ù. ÅëÁöÇüÀº ´ÙÀ½°ú °°½À´Ï´Ù.

- RelationNotification.RELATION_BASIC_UPDATE. °ü°è°¡ °ü°è ¼­ºñ½ºÀÇ ³»ºÎ ¿ÀºêÁ§Æ®ÀÎ °æ¿ì

- RelationNotification.RELATION_MBEAN_UPDATE. °ü°è°¡ °ü°è·Î¼­ Ãß°¡µÈ MBean ÀÎ °æ¿ì

¼Ò½º ¿ÀºêÁ§Æ®´Â °ü°è ¼­ºñ½º ÀÚüÀÔ´Ï´Ù.

°ü°è MBean setRole() ¸Þ¼­µå (ÁöÁ¤µÈ ·Ñ¿ë) ¹× setRoles() ¸Þ¼­µå ( °¢ ·Ñ¿ë)·Î ºÒ·Á °©´Ï´Ù. ÀÌ ±¸ÇöÀº RelationSupport Ŭ·¡½º¿¡¼­ Á¦°øµË´Ï´Ù.

°ü°è ¼­ºñ½ºÀÇ setRole() ¸Þ¼­µå (ÁöÁ¤µÈ ·Ñ¿ë) ¹× setRoles() ¸Þ¼­µå ( °¢ ·Ñ¿ë)¿¡¼­µµ È£ÃâÇÒ ¼ö ÀÖ½À´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelId - °»½ÅµÈ °ü°èÀÇ °ü°è ½Äº°ÀÚ
theNewRole - »õ·Î¿î ·Ñ (À̸§°ú »õ·Î¿î °ª)
theOldRoleValue - ³°Àº ·ÑÄ¡ (ObjectName ¿ÀºêÁ§Æ®ÀÇ List)
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationNotFoundException - ÁöÁ¤µÈ °ü°è ID °ü°è°¡ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì

sendRelationRemovalNotification

void sendRelationRemovalNotification(String  theRelId,
                                     List  theUnregMBeanList)
                                     throws IllegalArgumentException,

                                            RelationNotFoundException 
°ü°è »èÁ¦ÀÇ ÅëÁö (RelationNotification)¸¦ ¼Û½ÅÇÕ´Ï´Ù. ÅëÁöÇüÀº ´ÙÀ½°ú °°½À´Ï´Ù.

- RelationNotification.RELATION_BASIC_REMOVAL. °ü°è°¡ °ü°è ¼­ºñ½ºÀÇ ³»ºÎ ¿ÀºêÁ§Æ®ÀÎ °æ¿ì

- RelationNotification.RELATION_MBEAN_REMOVAL. °ü°è°¡ °ü°è·Î¼­ Ãß°¡µÈ MBean ÀÎ °æ¿ì

¼Ò½º ¿ÀºêÁ§Æ®´Â °ü°è ¼­ºñ½º ÀÚüÀÔ´Ï´Ù.

°ü°è ¼­ºñ½ºÀÇ removeRelation() ¸Þ¼­µå·Î ºÒ·Á °©´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelId - °»½ÅµÈ °ü°èÀÇ °ü°è ½Äº°ÀÚ
theUnregMBeanList - °ü°èÀÇ »èÁ¦ÀÇ °á°ú, µî·Ï ÇØÁ¦µÇ´Â MBean ObjectName ¸®½ºÆ® (null µµ °¡´É)
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationNotFoundException - ÁöÁ¤µÈ °ü°è ID °ü°è°¡ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì

updateRoleMap

void updateRoleMap(String  theRelId,
                   Role  theNewRole,
                   List  theOldRoleValue)
                   throws IllegalArgumentException,

                          RelationServiceNotRegisteredException,

                          RelationNotFoundException 
ÁöÁ¤µÈ °ü°è³»ÀÇ ÁöÁ¤µÈ ·ÑÀ» °»½ÅÇϱâ À§ÇØ, °ü°è ¼­ºñ½º ·Ñ ¸ÊÀÇ °»½ÅÀ» ó¸®ÇÕ´Ï´Ù.

°ü°è MBean setRole() ¸Þ¼­µå (ÁöÁ¤µÈ ·Ñ¿ë) ¹× setRoles() ¸Þ¼­µå ( °¢ ·Ñ¿ë)·Î ºÒ·Á °©´Ï´Ù. ÀÌ ±¸ÇöÀº RelationSupport Ŭ·¡½º¿¡¼­ Á¦°øµË´Ï´Ù.

°ü°è ¼­ºñ½ºÀÇ setRole() ¸Þ¼­µå (ÁöÁ¤µÈ ·Ñ¿ë) ¹× setRoles() ¸Þ¼­µå ( °¢ ·Ñ¿ë)¿¡¼­µµ È£ÃâÇÒ ¼ö ÀÖ½À´Ï´Ù.

°ü°è ¼­ºñ½º°¡ MBean µî·Ï ÇØÁ¦½Ãµµ Á¤ÇÕ¼ºÀ» È®º¸ÇØ, Äõ¸®¸¦ ½ÇÇàÇÒ ¼ö ÀÖµµ·Ï ÇÏ·Á¸é, ·ÑÀÇ °»½Å½Ã¿¡ ÀÌ ¸Þ¼­µå¸¦ È£ÃâÇÒ Çʿ䰡 ÀÖ½À´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelId - °»½ÅµÈ °ü°èÀÇ °ü°è ½Äº°ÀÚ
theNewRole - »õ·Î¿î ·Ñ (À̸§°ú »õ·Î¿î °ª)
theOldRoleValue - ³°Àº ·ÑÄ¡ (ObjectName ¿ÀºêÁ§Æ®ÀÇ List)
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ MBean Server ¿¡ µî·ÏµÇÁö ¾ÊÀº °æ¿ì
RelationNotFoundException - ÁöÁ¤µÈ ID ¿¡ ´ëÀÀÇÏ´Â °ü°è°¡ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì

removeRelation

void removeRelation(String  theRelId)
                    throws RelationServiceNotRegisteredException,

                           IllegalArgumentException,

                           RelationNotFoundException 
ÁöÁ¤µÈ °ü°èÇüÀ» °ü°è ¼­ºñ½º·ÎºÎÅÍ »èÁ¦ÇÕ´Ï´Ù.

RelationNotification ÅëÁö°¡ ¼Û½ÅµË´Ï´Ù. ±× ÇüÅ´ ´ÙÀ½°ú °°½À´Ï´Ù.

- RelationNotification.RELATION_BASIC_REMOVAL. °ü°è ¼­ºñ½º³» Àü¿ëÀÇ °ü°èÀÎ °æ¿ì

- RelationNotification.RELATION_MBEAN_REMOVAL. °ü°è°¡ MBean ·Î¼­ µî·ÏµÇ¾î ÀÖ´Â °æ¿ì

ÀÌ·¯ÇÑ °ü°è·Î ÂüÁ¶µÇ´Â MBean °æ¿ì, ¾Æ¹«°Íµµ ÇàÇØÁöÁö ¾Ê½À´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelId - »èÁ¦µÇ´Â °ü°èÀÇ °ü°è ID
¿¹¿Ü:
RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ MBean Server ¿¡ µî·ÏµÇÁö ¾ÊÀº °æ¿ì
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationNotFoundException - ÁöÁ¤µÈ °ü°è ID ¿¡ ´ëÀÀÇÏ´Â °ü°è°¡ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì

purgeRelations

void purgeRelations()
                    throws RelationServiceNotRegisteredException 
°ü°è¸¦ ÆÛÁö ÇÕ´Ï´Ù.

ÀÌ ¸Þ¼­µå´Â purgeFlag Ä¡¿¡ Á¸ÇÕ´Ï´Ù. Ç÷¡±×°¡ true ·Î ¼³Á¤µÇ¾î ÀÖ´Â °æ¿ì´Â °ü°è³»ÀÇ ÂüÁ¶ ´ë»óÀÇ MBean µî·Ï ÇØÁ¦¸¦ ¾Ë¸®´Â ÅëÁö¸¦ ¼ö½ÅÇßÀ» ¶§ ÀÚµ¿ÀûÀ¸·Î ºÒ·Á °©´Ï´Ù. Ç÷¡±×°¡ false ·Î ¼³Á¤µÇ¾î ÀÖ´Â °æ¿ì´Â ºÒ·Á °¡Áö ¾Ê½À´Ï´Ù.

Ç÷¡±×°¡ false ·Î ¼³Á¤µÇ¾î ÀÖ´Â °æ¿ì, °ü°èÀÇ Á¤ÇÕ¼ºÀ» È®º¸Çϱâ À§Çؼ­ ÀÌ ¸Þ¼­µå¸¦ È£ÃâÇÒÁö ¾î¶³Áö´Â À¯Àú°¡ °áÁ¤ÇÕ´Ï´Ù. MBean µî·ÏÀÌ ÇØÁ¦µÈ µÚ Áï½Ã ÆÛÁö¸¦ ÇÏÁö ¾Ê´Â °æ¿ì, ObjectName °¡ ÀçÀÌ¿ëµÇ¾î °ü°è³»ÀÇ ÂüÁ¶ ´ë»óÀÇ ´Ù¸¥ MBean ¿¡ ÇÒ´çÇÒ ¼ö ÀÖÀ» ¶§ ÀÌ purgeRelations() ¸Þ¼­µå¸¦ ¼öµ¿À¸·Î È£ÃâÇϸé, ¹®Á¦°¡ ¹ß»ýÇÕ´Ï´Ù. À̰ÍÀº, »õ·Î¿î MBean °¡ ÀνĵÇÁö ¾Ê°í, ObjectName °¡ µî·Ï ÇØÁ¦µÈ MBean ¿¡ ´ëÀÀÇÑ´Ù°í º¸¿©Áö±â ¶§¹®ÀÔ´Ï´Ù.

µ¿ÀÛÀº, µî·Ï ÇØÁ¦µÈ MBean °¡ ÂüÁ¶µÇ´Â ·ÑÀÇ Ä«µð³ª¸®Æ¼¿¡ °áÁ¤µË´Ï´Ù.

- ·Ñ³»ÀÇ MBean ÂüÁ¶¸¦ 1 °³ »èÁ¦ÇßÀ» ¶§ ÂüÁ¶ÀÇ ¼ö°¡ ÃÖ¼ÒÄ¡º¸´Ù Àû°Ô µÇ´Â °æ¿ì´Â °ü°è¸¦ »èÁ¦ÇÒ Çʿ䰡 ÀÖ´Ù

- MBean ÂüÁ¶¸¦ »èÁ¦ÇÑ µÚ ³²Àº ÂüÁ¶ÀÇ ¼ö°¡ Ä«µð³ª¸®Æ¼ ¹üÀ§³»ÀÎ °æ¿ì´Â °ü°è¸¦ º¸°ü À¯ÁöÇØ, handleMBeanUnregistration() ÄݹéÀ» È£ÃâÇØ °»½ÅÇÑ´Ù

¿¹¿Ü:
RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ MBean Server ¿¡ µî·ÏµÇÁö ¾ÊÀº °æ¿ì

findReferencingRelations

Map  findReferencingRelations(ObjectName  theMBeanName,
                             String  theRelTypeName,
                             String  theRoleName)
                             throws IllegalArgumentException 
ÁöÁ¤µÈ MBean °¡ ÂüÁ¶µÇ´Â °ü°è¸¦ ÃëµæÇÕ´Ï´Ù.

À̰ÍÀº, CIM ¡¸Reference¡¹ ¹× ¡¸ReferenceName¡¹¿ÀÆÛ·¹À̼ǿ¡ ´ëÀÀÇÕ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theMBeanName - MBean ObjectName
theRelTypeName - null µµ °¡´É. ÁöÁ¤ÇßÀ» °æ¿ì, °Ë»ö¿¡¼­´Â ±× ÇüÅÂÀÇ °ü°è¸¸ÀÌ °í·ÁµÈ´Ù. ±× ¿ÜÀÇ °æ¿ì, ¸ðµç °ü°èÇüÀÌ °í·ÁµÇ´Â
theRoleName - null µµ °¡´É. ÁöÁ¤ÇßÀ» °æ¿ì, ±× ·Ñ³»ÀÇ MBean °¡ ÂüÁ¶µÇ´Â °ü°è¸¸ÀÌ µ¹·ÁÁÖ°íÁø´Ù. ±× ¿ÜÀÇ °æ¿ì, ¸ðµç ·ÑÀÌ °í·ÁµÈ´Ù
¹Ýȯ°ª:
HashMap. Ű´Â MBean °¡ ÂüÁ¶µÇ´Â °ü°èÀÇ °ü°è ID. °¢ ŰÀÇ °ªÀº ·Ñ¸íÀÇ ArrayList (MBean´Â °°Àº °ü°èÀÇ º¹¼öÀÇ ·Ñ³»¿¡¼­ ÂüÁ¶ °¡´É)
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì

findAssociatedMBeans

Map  findAssociatedMBeans(ObjectName  theMBeanName,
                         String  theRelTypeName,
                         String  theRoleName)
                         throws IllegalArgumentException 
°ü°è³»ÀÇ ÁöÁ¤µÈ MBean ¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø MBean¸¦ ÃëµæÇÕ´Ï´Ù.

À̰ÍÀº, CIM Associator ¹× AssociatorName ¿ÀÆÛ·¹À̼ǿ¡ ´ëÀÀÇÕ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theMBeanName - MBean ObjectName
theRelTypeName - null µµ °¡´É. ÁöÁ¤ÇßÀ» °æ¿ì, °Ë»ö¿¡¼­´Â ±× ÇüÅÂÀÇ °ü°è¸¸ÀÌ °í·ÁµÈ´Ù. ±× ¿ÜÀÇ °æ¿ì, ¸ðµç °ü°èÇüÀÌ °í·ÁµÇ´Â
theRoleName - null µµ °¡´É. ÁöÁ¤ÇßÀ» °æ¿ì, ±× ·Ñ³»ÀÇ MBean °¡ ÂüÁ¶µÇ´Â °ü°è¸¸ÀÌ °í·ÁµÈ´Ù. ±× ¿ÜÀÇ °æ¿ì, ¸ðµç ·ÑÀÌ °í·ÁµÈ´Ù
¹Ýȯ°ª:
HashMap. Ű´Â ÁöÁ¤µÈ MBean ¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø MBean ObjectName. °¢ ŰÀÇ °ªÀº, Ű MBean °¡ ÁöÁ¤µÈ MBean ¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ°í ÀÖ´Â °ü°èÀÇ °ü°è ID ·ÎºÎÅÍ ¿Ï¼ºµÇ´Â ArrayList (À̰͵éÀº º¹¼ö°¡ ´Ù¸¥ °ü°è¿¡ °ü·ÃÁþ°í °¡´É)
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì

findRelationsOfType

List  findRelationsOfType(String  theRelTypeName)
                         throws IllegalArgumentException,

                                RelationTypeNotFoundException 
ÁöÁ¤µÈ ÇüÅÂÀÇ °ü°èÀÇ °ü°è ID¸¦ µ¹·ÁÁÝ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelTypeName - °ü°èÇü¸í
¹Ýȯ°ª:
°ü°è ID ArrayList
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationTypeNotFoundException - ±× À̸§ÀÇ °ü°èÇüÀÌ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì

getRole

List  getRole(String  theRelId,
             String  theRoleName)
             throws RelationServiceNotRegisteredException,

                    IllegalArgumentException,

                    RelationNotFoundException,

                    RoleNotFoundException 
ÁöÁ¤µÈ °ü°è¿¡ Æ÷ÇԵǴ ÁöÁ¤µÈ ·Ñ¸íÀÇ ·ÑÄ¡¸¦ ÃëµæÇÕ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelId - °ü°è ID
theRoleName - ·Ñ¸í
¹Ýȯ°ª:
·ÑÄ¡°¡ µÇ´Â ObjectName ¿ÀºêÁ§Æ®ÀÇ ArrayList
¿¹¿Ü:
RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ ¹Ìµî·ÏÀÇ °æ¿ì
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationNotFoundException - ÁöÁ¤µÈ ID ¿¡ ´ëÀÀÇÏ´Â °ü°è°¡ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì
RoleNotFoundException - ´ÙÀ½ÀÇ Á¶°ÇÀÌ ¼º¸³ÇÏ´Â °æ¿ì:

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

¶Ç´Â

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

°ü·Ã Ç׸ñ:
setRole(java.lang.String, javax.management.relation.Role)

getRoles

RoleResult  getRoles(String  theRelId,
                    String [] theRoleNameArray)
                    throws RelationServiceNotRegisteredException,

                           IllegalArgumentException,

                           RelationNotFoundException 
ÁöÁ¤µÈ °ü°è¿¡ Æ÷ÇԵǴ ÁöÁ¤µÈ À̸§ÀÇ ·ÑÀÇ °ªÀ» ÃëµæÇÕ´Ï´Ù.

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

getAllRoles

RoleResult  getAllRoles(String  theRelId)
                       throws IllegalArgumentException,

                              RelationNotFoundException,

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

ÆÄ¶ó¹ÌÅÍ:
theRelId - °ü°è ID
¹Ýȯ°ª:
RoleResult ¿ÀºêÁ§Æ®. Ãëµæ¿¡ ¼º°øÇÑ ·ÑÀÇ RoleList ¿Í Àо ¼ö ¾ø¾ú´ø ·ÑÀÇ RoleUnresolvedList¸¦ Æ÷ÇÔÇÑ´Ù
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationNotFoundException - ÁöÁ¤µÈ ID ¿¡ ´ëÀÀÇÏ´Â °ü°è°¡ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì
RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ MBean Server ¿¡ µî·ÏµÇÁö ¾ÊÀº °æ¿ì

getRoleCardinality

Integer  getRoleCardinality(String  theRelId,
                           String  theRoleName)
                           throws IllegalArgumentException,

                                  RelationNotFoundException,

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

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

setRole

void setRole(String  theRelId,
             Role  theRole)
             throws RelationServiceNotRegisteredException,

                    IllegalArgumentException,

                    RelationNotFoundException,

                    RoleNotFoundException,

                    InvalidRoleValueException,

                    RelationTypeNotFoundException 
ÁöÁ¤µÈ °ü°è³»ÀÇ ÁöÁ¤µÈ ·ÑÀ» ¼³Á¤ÇÕ´Ï´Ù.

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

°ü°è ¼­ºñ½º´Â °ü°èÀÇ Á¤ÇÕ¼ºÀ» È®º¸Çϱâ À§ÇØ, ÂüÁ¶ ´ë»óÀÇ MBean µî·Ï ÇØÁ¦¸¦ ó¸®ÇÏ´Â °ÍÀ¸·Î½á, º¯°æÀ» ÃßÀûÇÕ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelId - °ü°è ID
theRole - ¼³Á¤µÇ´Â ·Ñ (À̸§°ú »õ·Î¿î °ª)
¿¹¿Ü:
RelationServiceNotRegisteredException - °ü°è ¼­ºñ½º°¡ MBean Server ¿¡ µî·ÏµÇÁö ¾ÊÀº °æ¿ì
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationNotFoundException - ÁöÁ¤µÈ ID ¿¡ ´ëÀÀÇÏ´Â °ü°è°¡ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì
RoleNotFoundException - ´ÙÀ½ÀÇ Á¶°ÇÀÌ ¼º¸³ÇÏ´Â °æ¿ì:

- ³»ºÎ °ü°è

¶ÇÇÑ

- ·ÑÀÌ Á¸ÀçÇÏÁö ¾Ê´ÂÁö, ±âÀÔ ºÒ°¡

InvalidRoleValueException - ·Ñ¿¡ ´ëÇØ¼­ Á¦°øµÈ ³»ºÎ °ü°è ¹× °ªÀÌ ¹«È¿ÀÎ °æ¿ì:

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

¶Ç´Â

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

¶Ç´Â

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

¶Ç´Â

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

RelationTypeNotFoundException - ¹ÌÁöÀÇ °ü°èÇüÀÇ °æ¿ì
°ü·Ã Ç׸ñ:
getRole(java.lang.String, java.lang.String)

setRoles

RoleResult  setRoles(String  theRelId,
                    RoleList  theRoleList)
                    throws RelationServiceNotRegisteredException,

                           IllegalArgumentException,

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

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

°ü°è ¼­ºñ½º´Â °ü°èÀÇ Á¤ÇÕ¼ºÀ» È®º¸Çϱâ À§ÇØ, ÂüÁ¶ ´ë»óÀÇ MBean µî·Ï ÇØÁ¦¸¦ ó¸®ÇÏ´Â °ÍÀ¸·Î½á, º¯°æÀ» ÃßÀûÇÕ´Ï´Ù.

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

getReferencedMBeans

Map  getReferencedMBeans(String  theRelId)
                        throws IllegalArgumentException,

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

ÆÄ¶ó¹ÌÅÍ:
theRelId - °ü°è ID
¹Ýȯ°ª:
HashMap ¸ÅÇÎ:

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

¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationNotFoundException - ÁöÁ¤µÈ °ü°è ID ¿¡ ´ëÀÀÇÏ´Â °ü°è°¡ Á¸ÀçÇÏÁö ¾Ê´Â °æ¿ì

getRelationTypeName

String  getRelationTypeName(String  theRelId)
                           throws IllegalArgumentException,

                                  RelationNotFoundException 
ÁöÁ¤µÈ °ü°èÀÇ °ü°èÇüÀÇ À̸§À» µ¹·ÁÁÝ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
theRelId - °ü°è ID
¹Ýȯ°ª:
°ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø °ü°èÇüÀÇ À̸§
¿¹¿Ü:
IllegalArgumentException - ÆÄ¶ó¹ÌÅͰ¡ null °æ¿ì
RelationNotFoundException - ÁöÁ¤µÈ °ü°è 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 µµ ÂüÁ¶ÇϽʽÿÀ.