InstallationService


1   /**
2    * PETALS - PETALS Services Platform.
3    * Copyright (c) 2005 Fossil E-Commerce, http://www.fossilec.com/
4    *
5    * This library is free software; you can redistribute it and/or
6    * modify it under the terms of the GNU Lesser General Public
7    * License as published by the Free Software Foundation; either
8    * version 2.1 of the License, or (at your option) any later version.
9    * This library is distributed in the hope that it will be useful,
10   * but WITHOUT ANY WARRANTY; without even the implied warranty of
11   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12   * Lesser General Public License for more details.
13   *
14   * You should have received a copy of the GNU Lesser General Public
15   * License along with this library; if not, write to the Free Software
16   * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
17   *
18   * -------------------------------------------------------------------------
19   * $Id: InstallationService.java 154 2006-03-27 15:30:10Z alouis $
20   * -------------------------------------------------------------------------
21   */
22  
23  package org.objectweb.petals.jbi.management.service;
24  
25  import java.net.URI  ;
26  
27  import javax.management.ObjectName  ;
28  
29  import org.objectweb.petals.PetalsException;
30  import org.objectweb.petals.PetalsLifeCycle;
31  import org.objectweb.petals.tools.jbicommon.descriptor.JBIDescriptor;
32  
33  /**
34   * This custom interface add methods used by reinstallation tasks of the
35   * SystemState service.
36   * 
37   * @author alouis
38   * 
39   */
40  public interface InstallationService extends
41          javax.jbi.management.InstallationServiceMBean, PetalsLifeCycle {
42  
43      /**
44       * Install a shared library to the Petals platform. Installation steps :
45       * create the sl classloader, register sl to the loaded sl list
46       * 
47       * @param installationRoot
48       *            <code>URI</code> representing the install folder of the
49       *            shared lib, must be non-null
50       * @param descriptor
51       *            the shared lib <code>JBIDescriptor</code>, must be non-null
52       * @return return the slName
53       * @throws PetalsException
54       *             if error occurs during URL creation for classloader or during
55       *             classloader creation.
56       */
57      String   installSharedLibrary(URI   installationRoot, JBIDescriptor descriptor)
58          throws PetalsException;
59  
60      /**
61       * Install a component to the Petals platform. Installation steps : create
62       * component and installation contexts, create and register a new
63       * InstallerMBean for the component, register component to the loaded
64       * component list
65       * 
66       * @param installationRoot
67       *            <code>URI</code> representing the install folder of the
68       *            component
69       * @param descriptor
70       *            the comp <code>JBIDescriptor</code>
71       * @return the new InstallerMBean name
72       * @throws PetalsException
73       *             if an error occurs during the installation process
74       */
75      ObjectName   loadNewInstaller(URI   installationRoot, JBIDescriptor descriptor)
76          throws PetalsException;
77  }
78
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags