This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

View | Details | Raw Unified | Return to bug 148177
Collapse All | Expand All

(-)a/j2eeserver/api/doc/overview.html (-92 lines)
Removed Link Here
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
<html>
3
<head>
4
<!--
5
   - DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
6
   -
7
   - Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
8
   -
9
   - The contents of this file are subject to the terms of either the GNU
10
   - General Public License Version 2 only ("GPL") or the Common
11
   - Development and Distribution License("CDDL") (collectively, the
12
   - "License"). You may not use this file except in compliance with the
13
   - License. You can obtain a copy of the License at
14
   - http://www.netbeans.org/cddl-gplv2.html
15
   - or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
16
   - specific language governing permissions and limitations under the
17
   - License.  When distributing the software, include this License Header
18
   - Notice in each file and include the License file at
19
   - nbbuild/licenses/CDDL-GPL-2-CP.  Sun designates this
20
   - particular file as subject to the "Classpath" exception as provided
21
   - by Sun in the GPL Version 2 section of the License file that
22
   - accompanied this code. If applicable, add the following below the
23
   - License Header, with the fields enclosed by brackets [] replaced by
24
   - your own identifying information:
25
   - "Portions Copyrighted [year] [name of copyright owner]"
26
   -
27
   - Contributor(s):
28
   -
29
   - The Original Software is NetBeans. The Initial Developer of the Original
30
   - Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
31
   - Microsystems, Inc. All Rights Reserved.
32
   -
33
   - If you wish your version of this file to be governed by only the CDDL
34
   - or only the GPL Version 2, indicate your decision by adding
35
   - "[Contributor] elects to include this software in this distribution
36
   - under the [CDDL or GPL Version 2] license." If you do not indicate a
37
   - single choice of license, a recipient has the option to distribute
38
   - your version of this file under either the CDDL, the GPL Version 2 or
39
   - to extend the choice of license to its licensees as provided above.
40
   - However, if you add GPL Version 2 code and therefore, elected the GPL
41
   - Version 2 license, then the option applies only if the new code is
42
   - made subject to such option by the copyright holder.
43
  -->
44
</head>
45
<body>
46
J2EE Server Module provides support for development of J2EE modules and
47
framework for J2EE server management and for J2EE deployment in IDE.
48
49
There are two separate api/spi sets in j2eeserver. The devmodules
50
api/spi is for j2ee development modules (web, j2ee app, etc). The
51
plugins api/spi is for server plugins.
52
<h2> devmodules
53
</h2>
54
The spi classes are to be subclassed by dev modules and to be provided
55
as cookies on the development nodes. The api classes are to be used to
56
add actions/properties/additional cookies to those nodes.
57
<h2> plugins
58
</h2>
59
60
A jsr88 plugin needs to be wrapped in a module with an entry in the
61
/J2EE/DeploymentPlugins folder in the default filesystem, so the server
62
registry can pick it up. In addition to that plugin is also
63
required to provide a J2EE Platform. In order to do it, plugin must implement the 
64
{@link org.netbeans.modules.j2ee.deployment.plugins.spi.J2eePlatformImpl} 
65
interface and register it via the
66
{@link org.netbeans.modules.j2ee.deployment.plugins.spi.J2eePlatformFactory} 
67
whose instance must be registered in the module 
68
<a href="org/netbeans/modules/j2ee/deployment/plugins/api/doc-files/plugin-layer-file.html">layer file</a>.
69
70
Plugin may also provide some additional functionality outside the
71
deployment spec through use of the
72
api/spi classes.&nbsp; These additional functionality neeed to be
73
declared through the plugin module 
74
<a href="org/netbeans/modules/j2ee/deployment/plugins/api/doc-files/plugin-layer-file.html">layer file</a>.
75
<h2> test plugin
76
</h2>
77
The j2eeserver/test directory contains the source to a sample plugin
78
containing both jsr88 classes and the wrapper to install this into the
79
registry.
80
<h2> user view and design
81
</h2>
82
<p>Documents are available <a href="http://j2eeserver.netbeans.org">online</a>.
83
</p>
84
85
<p>Additional Information:
86
<ul>
87
<li><a href="architecture-summary.html">Architecture Summary</a></li>
88
<li><a href="apichanges.html">API Changes</a></li>
89
</ul>
90
</p>
91
</body>
92
</html>
(-)a/j2eeserver/arch.xml (-1 / +14 lines)
Lines 70-79 Link Here
70
70
71
<answer id="arch-overall">
71
<answer id="arch-overall">
72
72
73
<p>
74
There are two separate api/spi sets in j2eeserver. The devmodules
75
api/spi is for j2ee development modules (web, j2ee app, etc). The
76
plugins api/spi is for server plugins.
77
</p>
78
79
<api name="J2EEServer-devmodules" type="export" category="friend" group="java">
80
The spi classes are to be subclassed by dev modules and to be provided
81
as cookies on the development nodes. The api classes are to be used to
82
add actions/properties/additional cookies to those nodes.
83
</api>
84
73
<api name="J2EEServerAPI" type="export" category="friend" group="java">
85
<api name="J2EEServerAPI" type="export" category="friend" group="java">
74
  J2EE Server module serves as an integration point between two kinds of netbeans modules:
86
  J2EE Server module serves as an integration point between two kinds of netbeans modules:
75
  <ul>
87
  <ul>
76
    <li><b>server plugins</b> (or simply plugins) that integrate various J2EE servers in IDE, and</li>
88
    <li><b>server plugins</b> (or simply plugins) that integrate various J2EE servers in IDE
89
    </li>
77
    <li><b>devmodules</b> - netbeans modules that provide support for development
90
    <li><b>devmodules</b> - netbeans modules that provide support for development
78
    of J2EE modules (web module, EJB module, J2EE Application, etc.) and need to deploy 
91
    of J2EE modules (web module, EJB module, J2EE Application, etc.) and need to deploy 
79
    and debug them on J2EE servers.</li>
92
    and debug them on J2EE servers.</li>
(-)a/j2eeserver/nbproject/project.properties (-1 lines)
Lines 41-47 Link Here
41
javac.source=1.6
41
javac.source=1.6
42
spec.version.base=1.64.0
42
spec.version.base=1.64.0
43
43
44
javadoc.overview=${basedir}/api/doc/overview.html
45
javadoc.arch=${basedir}/arch.xml
44
javadoc.arch=${basedir}/arch.xml
46
javadoc.apichanges=${basedir}/apichanges.xml
45
javadoc.apichanges=${basedir}/apichanges.xml
47
javadoc.docfiles=${basedir}/api/doc
46
javadoc.docfiles=${basedir}/api/doc

Return to bug 148177