KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > objectweb > petals > jbi > management > service > 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 JavaDoc;
26
27 import javax.management.ObjectName JavaDoc;
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 JavaDoc installSharedLibrary(URI JavaDoc 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 JavaDoc loadNewInstaller(URI JavaDoc installationRoot, JBIDescriptor descriptor)
76         throws PetalsException;
77 }
78
Popular Tags