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 Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
28 * Microsystems, Inc. All Rights Reserved.
29 *
30 * If you wish your version of this file to be governed by only the CDDL
31 * or only the GPL Version 2, indicate your decision by adding
32 * "[Contributor] elects to include this software in this distribution
33 * under the [CDDL or GPL Version 2] license." If you do not indicate a
34 * single choice of license, a recipient has the option to distribute
35 * your version of this file under either the CDDL, the GPL Version 2 or
36 * to extend the choice of license to its licensees as provided above.
37 * However, if you add GPL Version 2 code and therefore, elected the GPL
38 * Version 2 license, then the option applies only if the new code is
39 * made subject to such option by the copyright holder.
40 */
41 package org.netbeans.modules.j2ee.deployment.devmodules.spi;
42
43 import java.util.HashSet;
44 import java.util.Set;
45 import org.netbeans.modules.j2ee.deployment.common.api.ConfigurationException;
46 import org.netbeans.modules.j2ee.deployment.common.api.Datasource;
47
48 /**
49 * This interface must be implemented by J2EE Application support and an instance
50 * added into project lookup.
51 *
52 * @author sherold
53 *
54 * @since 1.23
55 */
56 public abstract class J2eeApplicationProvider extends
57 J2eeModuleProvider {
58
59 /**
60 * Returns the provider for the child module specified by given URI.
61 *
62 * @param uri the child module URI within the J2EE application.
63 *
64 * @return J2eeModuleProvider object
65 */
66 public abstract J2eeModuleProvider getChildModuleProvider(String uri);
67
68 /**
69 * Returns list of providers of every child J2EE module of this J2EE app.
70 *
71 * @return array of J2eeModuleProvider objects.
72 */
73 public abstract J2eeModuleProvider[] getChildModuleProviders();
74
75 /**
76 * Overrides the <code>J2eeModuleProvider's</code> implementation so that
77 * the data sources from the child modules are returned
78 *
79 * @throws ConfigurationException when an error occured while retrieving
80 * module data sources.
81 */
82 public Set<Datasource> getModuleDatasources()
83 throws ConfigurationException {
84
85 Set<Datasource> projectDS = new HashSet<Datasource>();
86
87 for (J2eeModuleProvider modProvider : getChildModuleProviders()) {
88 projectDS.addAll(modProvider.getModuleDatasources());
89 }
90
91 return projectDS;
92 }
93
94 }
|