Lines Matching refs:relation
26 package javax.management.relation;
35 * The Relation Service is in charge of creating and deleting relation types
60 * unregistration of an MBean referenced in a relation, if an immediate
74 * unregistration of an MBean referenced in a relation, if an immediate
91 * Creates a relation type (RelationTypeSupport object) with given
95 * @param relationTypeName name of the relation type
100 * <P>- there is already a relation type with that name
111 * Adds given object as a relation type. The object is expected to
114 * @param relationTypeObj relation type object (implementing the
120 * @exception InvalidRelationTypeException if there is already a relation
128 * Retrieves names of all known relation types.
130 * @return ArrayList of relation type names (Strings)
135 * Retrieves list of role infos (RoleInfo objects) of a given relation
138 * @param relationTypeName name of relation type
143 * @exception RelationTypeNotFoundException if there is no relation type
151 * Retrieves role info for given role of a given relation type.
153 * @param relationTypeName name of relation type
159 * @exception RelationTypeNotFoundException if the relation type is not
162 * relation type.
171 * Removes given relation type from Relation Service.
172 * <P>The relation objects of that type will be removed from the
175 * @param relationTypeName name of the relation type to be removed
180 * @exception RelationTypeNotFoundException If there is no relation type
193 * Creates a simple relation (represented by a RelationSupport object) of
194 * given relation type, and adds it in the Relation Service.
200 * @param relationId relation identifier, to identify uniquely the relation
202 * @param relationTypeName name of the relation type (has to be created
204 * @param roleList role list to initialize roles of the relation (can
211 * that does not exist in the relation type
212 * @exception InvalidRelationIdException if relation id already used
213 * @exception RelationTypeNotFoundException if relation type not known in
237 * Server) as a relation in the Relation Service.
238 * <P>To be added as a relation, the MBean must conform to the
243 * <P>- have a relation id that is unique and unused in current Relation Service
244 * <P>- have for relation type a relation type created in the Relation
246 * <P>- have roles conforming to the role info provided in the relation
249 * @param relationObjectName ObjectName of the relation MBean to be added.
257 * <P>- no relation identifier in MBean
258 * <P>- the relation identifier is already used in the Relation Service
266 * <P>- no relation type name in MBean
267 * <P>- the relation type name in MBean does not correspond to a relation
278 * that does not exist in the relation type
292 * If the relation is represented by an MBean (created by the user and
293 * added as a relation in the Relation Service), returns the ObjectName of
296 * @param relationId relation id identifying the relation
298 * @return ObjectName of the corresponding relation MBean, or null if
299 * the relation is not an MBean.
302 * @exception RelationNotFoundException there is no relation associated
310 * Returns the relation id associated to the given ObjectName if the
311 * MBean has been added as a relation in the Relation Service.
313 * @param objectName ObjectName of supposed relation
315 * @return relation id (String) or null (if the ObjectName is not a
316 * relation handled by the Relation Service)
324 * Checks if there is a relation identified in Relation Service with given
325 * relation id.
327 * @param relationId relation id identifying the relation
329 * @return boolean: true if there is a relation, false else
337 * Returns all the relation ids for all the relations handled by the
345 * Checks if given Role can be read in a relation of the given type.
348 * @param relationTypeName name of the relation type
357 * @exception RelationTypeNotFoundException if the relation type is not
366 * Checks if given Role can be set in a relation of given type.
369 * @param relationTypeName name of relation type
384 * @exception RelationTypeNotFoundException if unknown relation type
393 * Sends a notification (RelationNotification) for a relation creation.
395 * <P>- RelationNotification.RELATION_BASIC_CREATION if the relation is an
397 * <P>- RelationNotification.RELATION_MBEAN_CREATION if the relation is a
398 * MBean added as a relation.
403 * @param relationId relation identifier of the updated relation
406 * @exception RelationNotFoundException if there is no relation for given
407 * relation id
415 * given relation. The notification type is:
416 * <P>- RelationNotification.RELATION_BASIC_UPDATE if the relation is an
418 * <P>- RelationNotification.RELATION_MBEAN_UPDATE if the relation is a
419 * MBean added as a relation.
421 * <P>It is called in relation MBean setRole() (for given role) and
427 * @param relationId relation identifier of the updated relation
432 * @exception RelationNotFoundException if there is no relation for given
433 * relation id
442 * Sends a notification (RelationNotification) for a relation removal.
444 * <P>- RelationNotification.RELATION_BASIC_REMOVAL if the relation is an
446 * <P>- RelationNotification.RELATION_MBEAN_REMOVAL if the relation is a
447 * MBean added as a relation.
451 * @param relationId relation identifier of the updated relation
453 * to be unregistered due to relation removal (can be null)
456 * @exception RelationNotFoundException if there is no relation for given
457 * relation id
466 * role in given relation.
467 * <P>It is called in relation MBean setRole() (for given role) and
476 * @param relationId relation identifier of the updated relation
483 * @exception RelationNotFoundException if no relation for given id.
493 * Removes given relation from the Relation Service.
495 * <P>- RelationNotification.RELATION_BASIC_REMOVAL if the relation was
497 * <P>- RelationNotification.RELATION_MBEAN_REMOVAL if the relation is
499 * <P>For MBeans referenced in such relation, nothing will be done,
501 * @param relationId relation id of the relation to be removed
506 * @exception RelationNotFoundException if no relation corresponding to
507 * given relation id
519 * an MBean referenced in a relation (if the flag is set to true), or not
524 * reused and assigned to another MBean referenced in a relation, calling
532 * references less than the minimum degree, the relation has to be removed.
534 * reference is still in the cardinality range, keep the relation and
550 * of that type will be considered in the search. Else all relation types
556 * @return an HashMap, where the keys are the relation ids of the relations
559 * roles in the same relation).
570 * Retrieves the MBeans associated to given one in a relation.
576 * relation types are considered.
583 * of the relation ids of the relations where the key MBean is
596 * Returns the relation ids for relations of the given type.
598 * @param relationTypeName relation type name
600 * @return an ArrayList of relation ids.
603 * @exception RelationTypeNotFoundException if there is no relation type
611 * Retrieves role value for given role name in given relation.
613 * @param relationId relation id
621 * @exception RelationNotFoundException if no relation with given id
637 * Retrieves values of roles with given names in given relation.
639 * @param relationId relation id
649 * @exception RelationNotFoundException if no relation with given id
660 * Returns all roles present in the relation.
662 * @param relationId relation id
669 * @exception RelationNotFoundException if no relation for given id
682 * @param relationId relation id
688 * @exception RelationNotFoundException if no relation with given id
698 * Sets the given role in given relation.
700 * provided in relation's relation type
704 * @param relationId relation id
710 * @exception RelationNotFoundException if no relation with given id
712 * <P>- internal relation
715 * @exception InvalidRoleValueException if internal relation and value
727 * @exception RelationTypeNotFoundException if unknown relation type
741 * Sets the given roles in given relation.
743 * provided in relation's relation type
747 * @param relationId relation id
757 * @exception RelationNotFoundException if no relation with given id
768 * Retrieves MBeans referenced in the various roles of the relation.
770 * @param relationId relation id
777 * @exception RelationNotFoundException if no relation for given
778 * relation id
785 * Returns name of associated relation type for given relation.
787 * @param relationId relation id
789 * @return the name of the associated relation type.
792 * @exception RelationNotFoundException if no relation for given
793 * relation id