001: /*
002: * JOnAS: Java(TM) Open Application Server
003: * Copyright (C) 1999 Bull S.A.
004: * Contact: jonas-team@objectweb.org
005: *
006: * This library is free software; you can redistribute it and/or
007: * modify it under the terms of the GNU Lesser General Public
008: * License as published by the Free Software Foundation; either
009: * version 2.1 of the License, or any later version.
010: *
011: * This library is distributed in the hope that it will be useful,
012: * but WITHOUT ANY WARRANTY; without even the implied warranty of
013: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
014: * Lesser General Public License for more details.
015: *
016: * You should have received a copy of the GNU Lesser General Public
017: * License along with this library; if not, write to the Free Software
018: * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
019: * USA
020: *
021: * Initial developer(s): ____________________________________.
022: * Contributor(s): Michel Bruno and Guillaume Riviere
023: *
024: * --------------------------------------------------------------------------
025: * $Id: ResourceServiceImplMBean.java 5699 2004-10-29 23:33:37Z ehardesty $
026: * --------------------------------------------------------------------------
027: */
028:
029: package org.objectweb.jonas.resource;
030:
031: import java.rmi.RemoteException;
032:
033: import java.util.List;
034: import java.util.Set;
035:
036: /**
037: * MBean Interface for Resource Service Management
038: * MBean type: Standard
039: * MBean model: Inheritance (ResourceServiceImpl)
040: */
041: public interface ResourceServiceImplMBean {
042:
043: /**
044: * Deploy an RAR, used by the JMX Management.
045: * @param fileName the fileName of the rar which must be be deployed.
046: * @return The ObjectName of the MBean associated to the deployed J2EE Application
047: * @throws RemoteException if rmi call failed.
048: * @throws ResourceServiceException if the deployment of the RAR failed.
049: */
050: String deployRarMBean(String fileName) throws RemoteException,
051: ResourceServiceException;
052:
053: /**
054: * Undeploy an RAR, used by the JMX Management.
055: * @param fileName the fileName of the rar which must be be undeployed.
056: * @throws RemoteException if rmi call failed.
057: * @throws ResourceServiceException if the undeployment of the RAR failed.
058: */
059: void unDeployRarMBean(String fileName) throws RemoteException,
060: ResourceServiceException;
061:
062: /**
063: * @return current number of rars deployed in the JOnAS server
064: */
065: Integer getCurrentNumberOfResource();
066:
067: /**
068: * @return current number of rars deployed in the JOnAS server
069: */
070: Integer getCurrentNumberOfRars();
071:
072: /**
073: * @return the list of RAR files deployed
074: * @throws Exception if error retrieving the list
075: */
076: List getDeployedRars() throws Exception;
077:
078: /**
079: * @return the list of RAR files found in JONAS_BASE/rars and in JONAS_BASE/rars/autoload
080: * @throws Exception if error retrieving the list
081: */
082: List getInstalledRars() throws Exception;
083:
084: /**
085: * This method is added temporarily. It will disapear when Rars will have their associated MBeans
086: * (when Rars will become manageable)
087: * @return the names of the rars currently deployed in the JOnAS server
088: */
089: Set getRarNames();
090:
091: /**
092: * Test if the specified filename is already deployed or not
093: * @param fileName the name of the rar file.
094: * @return true if the rar is deployed, else false.
095: */
096: boolean isRarLoaded(String fileName);
097:
098: /**
099: * Return the list of installed RAR container ready to deploy.
100: *
101: * @return The list of deployable RAR container
102: * @throws Exception if error retrieving the list
103: */
104: List getDeployableRars() throws Exception;
105:
106: /**
107: * Return the list of "autoload" directories for RAR containers.
108: * @return The list of all "autoload" directories
109: */
110: List getAutoloadDirectories();
111:
112: /**
113: * Return the Rars directory.
114: * @return The Rars directory
115: */
116: String getRarsDirectory();
117:
118: }
|