KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > sun > enterprise > management > agent > MEJB


1 /*
2  * The contents of this file are subject to the terms
3  * of the Common Development and Distribution License
4  * (the License). You may not use this file except in
5  * compliance with the License.
6  *
7  * You can obtain a copy of the license at
8  * https://glassfish.dev.java.net/public/CDDLv1.0.html or
9  * glassfish/bootstrap/legal/CDDLv1.0.txt.
10  * See the License for the specific language governing
11  * permissions and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL
14  * Header Notice in each file and include the License file
15  * at glassfish/bootstrap/legal/CDDLv1.0.txt.
16  * If applicable, add the following below the CDDL Header,
17  * with the fields enclosed by brackets [] replaced by
18  * you own identifying information:
19  * "Portions Copyrighted [year] [name of copyright owner]"
20  *
21  * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
22  */
23
24 package com.sun.enterprise.management.agent;
25
26
27 // java import
28 import java.util.Set JavaDoc;
29 import java.io.ObjectInputStream JavaDoc;
30 import javax.management.*;
31 import java.rmi.RemoteException JavaDoc;
32 import javax.management.j2ee.Management JavaDoc;
33
34
35 /* Combines the Management interface and the remaining javax.management.MBeanServer interface methods
36  * with the exception of deserialize which does not return a valid RMI-IIOP type.
37  * The MEJB interface also includes registerAppClient which faclitates the registration of an AppClient MO
38  * from a the AppContainer
39  *
40  * @author Hans Hrasna
41  */
42 public interface MEJB extends Management JavaDoc {
43
44     /**
45      * Gets the names of MBeans controlled by the MBean server. This method
46      * enables any of the following to be obtained: The names of all MBeans,
47      * the names of a set of MBeans specified by pattern matching on the
48      * <CODE>ObjectName</CODE> and/or a Query expression, a specific MBean name (equivalent to
49      * testing whether an MBean is registered). When the object name is
50      * null or no domain and key properties are specified, all objects are selected (and filtered if a
51      * query is specified). It returns the set of ObjectNames for the MBeans
52      * selected.
53      *
54      * @param name The object name pattern identifying the MBeans to be retrieved. If
55      * null or no domain and key properties are specified, all the MBeans registered will be retrieved.
56      * @param query The query expression to be applied for selecting MBeans. If null
57      * no query expression will be applied for selecting MBeans.
58      *
59      * @return A set containing the ObjectNames for the MBeans selected.
60      * If no MBean satisfies the query, an empty list is returned.
61      *
62      */
63     Set JavaDoc queryNames(ObjectName name, QueryExp query) throws RemoteException JavaDoc ;
64   
65 }
66
Popular Tags