/* * Copyright (c) 2002, 2008, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation.  Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package com.sun.jmx.interceptor;  import java.io.ObjectInputStream;import javax.management.InstanceNotFoundException;import javax.management.MBeanException;import javax.management.MBeanServer;import javax.management.ObjectName;import javax.management.OperationsException;import javax.management.ReflectionException;import javax.management.loading.ClassLoaderRepository; /** * <p>This interface specifies the behavior to be implemented by an * MBean Server Interceptor.  An MBean Server Interceptor has * essentially the same interface as an MBean Server.  An MBean Server * forwards received requests to its default interceptor, which may * handle them itself or forward them to other interceptors.  The * default interceptor may be changed via the {@link * com.sun.jmx.mbeanserver.SunJmxMBeanServer#setMBeanServerInterceptor} * method.</p> * * <p>The initial default interceptor provides the standard MBean * Server behavior.  It handles a collection of named MBeans, each * represented by a Java object.  A replacement default interceptor * may build on this behavior, for instance by adding logging or * security checks, before forwarding requests to the initial default * interceptor.  Or, it may route each request to one of a number of * sub-interceptors, for instance based on the {@link ObjectName} in * the request.</p> * * <p>An interceptor, default or not, need not implement MBeans as * Java objects, in the way that the initial default interceptor does. * It may instead implement <em>virtual MBeans</em>, which do not * exist as Java objects when they are not in use.  For example, these * MBeans could be implemented by forwarding requests to a database, * or to a remote MBean server, or by performing system calls to query * or modify system resources.</p> * * @since 1.5 */public interface MBeanServerInterceptor extends MBeanServer {    /**     * This method should never be called.     * Usually hrows UnsupportedOperationException.     */    public Object instantiate(String className)            throws ReflectionException, MBeanException;    /**     * This method should never be called.     * Usually throws UnsupportedOperationException.     */    public Object instantiate(String className, ObjectName loaderName)            throws ReflectionException, MBeanException,            InstanceNotFoundException;    /**     * This method should never be called.     * Usually throws UnsupportedOperationException.     */    public Object instantiate(String className, Object[] params,            String[] signature) throws ReflectionException, MBeanException;     /**     * This method should never be called.     * Usually throws UnsupportedOperationException.     */    public Object instantiate(String className, ObjectName loaderName,            Object[] params, String[] signature)            throws ReflectionException, MBeanException,            InstanceNotFoundException;     /**     * This method should never be called.     * Usually throws UnsupportedOperationException.     */    @Deprecated    public ObjectInputStream deserialize(ObjectName name, byte[] data)            throws InstanceNotFoundException, OperationsException;     /**     * This method should never be called.     * Usually throws UnsupportedOperationException.     */    @Deprecated    public ObjectInputStream deserialize(String className, byte[] data)            throws OperationsException, ReflectionException;     /**     * This method should never be called.     * Usually hrows UnsupportedOperationException.     */    @Deprecated    public ObjectInputStream deserialize(String className,            ObjectName loaderName, byte[] data)            throws InstanceNotFoundException, OperationsException,            ReflectionException;     /**     * This method should never be called.     * Usually throws UnsupportedOperationException.     */    public ClassLoaderRepository getClassLoaderRepository(); }