1 /* 2 * JBoss, Home of Professional Open Source 3 * Copyright 2005, JBoss Inc., and individual contributors as indicated 4 * by the @authors tag. See the copyright.txt in the distribution for a 5 * full listing of individual contributors. 6 * 7 * This is free software; you can redistribute it and/or modify it 8 * under the terms of the GNU Lesser General Public License as 9 * published by the Free Software Foundation; either version 2.1 of 10 * the License, or (at your option) any later version. 11 * 12 * This software is distributed in the hope that it will be useful, 13 * but WITHOUT ANY WARRANTY; without even the implied warranty of 14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 15 * Lesser General Public License for more details. 16 * 17 * You should have received a copy of the GNU Lesser General Public 18 * License along with this software; if not, write to the Free 19 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 20 * 02110-1301 USA, or see the FSF site: http://www.fsf.org. 21 */ 22 package org.jboss.deployment; 23 24 import java.net.URL; 25 26 /** 27 * The interface which a deployer must implement. 28 * 29 * <p>Clients should use the MainDeployer to deploy URLs. 30 * 31 * @jmx:mbean 32 * 33 * @version <tt>$Revision: 57108 $</tt> 34 * @author <a HREF="mailto:jason@planet57.com">Jason Dillon</a> 35 */ 36 public interface Deployer 37 { 38 /** 39 * Deploys a package identified by a URL 40 * 41 * @param url an <code>URL</code> value 42 * 43 * @throws DeploymentException Failed to deploy URL. 44 * 45 * @jmx:managed-operation 46 */ 47 void deploy(URL url) throws DeploymentException; 48 49 /** 50 * Undeploys a package identified by a URL 51 * 52 * @param url an <code>URL</code> value 53 * 54 * @throws DeploymentException Failed to undeploy URL. 55 * 56 * @jmx:managed-operation 57 */ 58 void undeploy(URL url) throws DeploymentException; 59 60 /** 61 * Tells you if a packaged identified by a URL is deployed. 62 * 63 * @param url an <code>URL</code> value 64 * @return a <code>boolean</code> value 65 * 66 * @jmx:managed-operation 67 */ 68 boolean isDeployed(URL url); 69 } 70