2362N/A * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved. 0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 0N/A * This code is free software; you can redistribute it and/or modify it 0N/A * under the terms of the GNU General Public License version 2 only, as 2362N/A * published by the Free Software Foundation. Oracle designates this 0N/A * particular file as subject to the "Classpath" exception as provided 2362N/A * by Oracle in the LICENSE file that accompanied this code. 0N/A * This code is distributed in the hope that it will be useful, but WITHOUT 0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 0N/A * version 2 for more details (a copy is included in the LICENSE file that 0N/A * accompanied this code). 0N/A * You should have received a copy of the GNU General Public License version 0N/A * 2 along with this work; if not, write to the Free Software Foundation, 0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 2362N/A * or visit www.oracle.com if you need additional information or have any 0N/A * A RelationSupport object is used internally by the Relation Service to 0N/A * represent simple relations (only roles, no properties or methods), with an 0N/A * unlimited number of roles, of any relation type. As internal representation, 0N/A * it is not exposed to the user. 0N/A * <P>RelationSupport class conforms to the design patterns of standard MBean. So 0N/A * the user can decide to instantiate a RelationSupport object himself as 0N/A * a MBean (as it follows the MBean design patterns), to register it in the 0N/A * MBean Server, and then to add it in the Relation Service. 0N/A * <P>The user can also, when creating his own MBean relation class, have it 0N/A * extending RelationSupport, to retrieve the implementations of required 0N/A * interfaces (see below). 0N/A * <P>It is also possible to have in a user relation MBean class a member 0N/A * being a RelationSupport object, and to implement the required interfaces by 0N/A * delegating all to this member. 0N/A * <P> RelationSupport implements the Relation interface (to be handled by the 0N/A * Relation Service). 0N/A * Returns an internal flag specifying if the object is still handled by 0N/A * the Relation Service. 0N/A * @return a Boolean equal to {@link Boolean#TRUE} if the object 0N/A * is still handled by the Relation Service and {@link 0N/A * Boolean#FALSE} otherwise. 0N/A * <p>Specifies whether this relation is handled by the Relation 0N/A * <P>BEWARE, this method has to be exposed as the Relation Service will 0N/A * access the relation through its management interface. It is RECOMMENDED 0N/A * NOT to use this method. Using it does not affect the registration of the 0N/A * relation object in the Relation Service, but will provide wrong 0N/A * information about it! 0N/A * @param flag whether the relation is handled by the Relation Service. 0N/A * @exception IllegalArgumentException if null parameter