01: /*
02: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
03: *
04: * Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
05: *
06: * The contents of this file are subject to the terms of either the GNU
07: * General Public License Version 2 only ("GPL") or the Common
08: * Development and Distribution License("CDDL") (collectively, the
09: * "License"). You may not use this file except in compliance with the
10: * License. You can obtain a copy of the License at
11: * http://www.netbeans.org/cddl-gplv2.html
12: * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
13: * specific language governing permissions and limitations under the
14: * License. When distributing the software, include this License Header
15: * Notice in each file and include the License file at
16: * nbbuild/licenses/CDDL-GPL-2-CP. Sun designates this
17: * particular file as subject to the "Classpath" exception as provided
18: * by Sun in the GPL Version 2 section of the License file that
19: * accompanied this code. If applicable, add the following below the
20: * License Header, with the fields enclosed by brackets [] replaced by
21: * your own identifying information:
22: * "Portions Copyrighted [year] [name of copyright owner]"
23: *
24: * Contributor(s):
25: *
26: * The Original Software is NetBeans. The Initial Developer of the Original
27: * Software is Nokia. Portions Copyright 2005 Nokia. All Rights Reserved.
28: *
29: * If you wish your version of this file to be governed by only the CDDL
30: * or only the GPL Version 2, indicate your decision by adding
31: * "[Contributor] elects to include this software in this distribution
32: * under the [CDDL or GPL Version 2] license." If you do not indicate a
33: * single choice of license, a recipient has the option to distribute
34: * your version of this file under either the CDDL, the GPL Version 2 or
35: * to extend the choice of license to its licensees as provided above.
36: * However, if you add GPL Version 2 code and therefore, elected the GPL
37: * Version 2 license, then the option applies only if the new code is
38: * made subject to such option by the copyright holder.
39: */
40: package org.netbeans;
41:
42: import java.io.File;
43: import java.io.IOException;
44: import java.util.jar.Manifest;
45:
46: /**
47: * Allows creation of custom modules. The factories are searched in
48: * the default lookup (org.openide.util.Lookup.getDefault()). If there is one
49: * it is used - if there are more of them arbitrary one is used (so please make
50: * sure that there is only one present in the installation). If there is none
51: * in the default lookup the system will use an instance of this class.
52: *
53: * @author David Strupl
54: */
55: public class ModuleFactory {
56:
57: /**
58: * This method creates a "standard" module. Standard modules can be
59: * disabled, reloaded, autoloaded (loaded only when needed).
60: * @see StandardModule
61: */
62: public Module create(File jar, Object history, boolean reloadable,
63: boolean autoload, boolean eager, ModuleManager mgr,
64: Events ev) throws IOException {
65: return new StandardModule(mgr, ev, jar, history, reloadable,
66: autoload, eager);
67: }
68:
69: /**
70: * This method creates a "fixed" module. Fixed modules cannot be
71: * realoaded, are always enabled and are typically present on the
72: * classpath.
73: * @see FixedModule
74: * @since 2.7
75: */
76: public Module createFixed(Manifest mani, Object history,
77: ClassLoader loader, boolean autoload, boolean eager,
78: ModuleManager mgr, Events ev) throws InvalidException {
79: return new FixedModule(mgr, ev, mani, history, loader,
80: autoload, eager);
81: }
82:
83: /**
84: * Allows specifying different parent classloader of all modules classloaders.
85: */
86: public ClassLoader getClasspathDelegateClassLoader(
87: ModuleManager mgr, ClassLoader del) {
88: return del;
89: }
90:
91: /**
92: * If this method returns true the parent the original classpath
93: * classloader will be removed from the parent classloaders of a module classloader.
94: */
95: public boolean removeBaseClassLoader() {
96: return false;
97: }
98:
99: }
|