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 µµ ÂüÁ¶ÇϽʽÿÀ.