blob: 02ff65b21c330f4427280fa1d61f88c2dd47faf6 [file] [log] [blame]
ndaib94eb262004-10-13 15:55:37 +00001<?xml version='1.0' encoding='UTF-8'?>
2<!-- Schema file written by PDE -->
3<schema targetNamespace="org.eclipse.wst.server.core">
4<annotation>
5 <appInfo>
6 <meta.schema plugin="org.eclipse.wst.server.core" id="serverTypes" name="Server Types"/>
7 </appInfo>
8 <documentation>
9 This extension point is used to provide support for a new server type.
10 </documentation>
11 </annotation>
12
13 <element name="extension">
14 <complexType>
15 <sequence>
deboerf5c03a12006-11-29 15:15:35 +000016 <element ref="serverType" minOccurs="1" maxOccurs="unbounded"/>
ndaib94eb262004-10-13 15:55:37 +000017 </sequence>
18 <attribute name="point" type="string" use="required">
19 <annotation>
20 <documentation>
21 a fully qualified identifier of the target extension point
22 </documentation>
23 </annotation>
24 </attribute>
25 <attribute name="id" type="string">
26 <annotation>
27 <documentation>
28 an optional identifier of the extension instance
29 </documentation>
30 </annotation>
31 </attribute>
32 <attribute name="name" type="string">
33 <annotation>
34 <documentation>
35 an optional name of the extension instance
36 </documentation>
37 </annotation>
38 </attribute>
39 </complexType>
40 </element>
41
42 <element name="serverType">
deboerfc22f1a2007-10-17 21:59:55 +000043 <annotation>
44 <appInfo>
45 <meta.element labelAttribute="id"/>
46 </appInfo>
47 </annotation>
ndaib94eb262004-10-13 15:55:37 +000048 <complexType>
ndaib94eb262004-10-13 15:55:37 +000049 <attribute name="id" type="string" use="required">
50 <annotation>
51 <documentation>
deboer3010e342005-05-11 16:08:22 +000052 unique identifier for the server type
ndaib94eb262004-10-13 15:55:37 +000053 </documentation>
54 </annotation>
55 </attribute>
ndaib94eb262004-10-13 15:55:37 +000056 <attribute name="name" type="string" use="required">
57 <annotation>
58 <documentation>
59 a translatable name used to identify this server type
60 </documentation>
deboer7502f5e2005-04-22 15:55:23 +000061 <appInfo>
62 <meta.attribute translatable="true"/>
63 </appInfo>
ndaib94eb262004-10-13 15:55:37 +000064 </annotation>
65 </attribute>
66 <attribute name="description" type="string" use="required">
67 <annotation>
68 <documentation>
69 a translatable description of this server type
70 </documentation>
deboer7502f5e2005-04-22 15:55:23 +000071 <appInfo>
72 <meta.attribute translatable="true"/>
73 </appInfo>
ndaib94eb262004-10-13 15:55:37 +000074 </annotation>
75 </attribute>
deboerda1df6a2004-12-03 13:35:32 +000076 <attribute name="class" type="string" use="required">
ndaib94eb262004-10-13 15:55:37 +000077 <annotation>
78 <documentation>
deboer3010e342005-05-11 16:08:22 +000079 specifies the fully qualified name of the Java class that extends &lt;samp&gt;org.eclipse.wst.server.core.model.ServerDelegate&lt;/samp&gt;.
deboer9534e5a2006-04-28 04:25:20 +000080Server instances of this type will delegate to instances of this class. Delegates must also have a public 0-arg constructor
ndaib94eb262004-10-13 15:55:37 +000081 </documentation>
deboer616c3a12005-03-08 16:28:10 +000082 <appInfo>
83 <meta.attribute kind="java" basedOn="org.eclipse.wst.server.core.model.ServerDelegate"/>
84 </appInfo>
ndaib94eb262004-10-13 15:55:37 +000085 </annotation>
86 </attribute>
deboerda1df6a2004-12-03 13:35:32 +000087 <attribute name="behaviourClass" type="string">
ndaib94eb262004-10-13 15:55:37 +000088 <annotation>
89 <documentation>
deboer3010e342005-05-11 16:08:22 +000090 specifies the fully qualified name of the Java class that implements &lt;samp&gt;org.eclipse.wst.server.core.model.ServerBehaviourDelegate&lt;/samp&gt;.
deboer9534e5a2006-04-28 04:25:20 +000091Server instances of this type will delegate to instances of this class. Delegates must also have a public 0-arg constructor
ndaib94eb262004-10-13 15:55:37 +000092 </documentation>
deboer616c3a12005-03-08 16:28:10 +000093 <appInfo>
94 <meta.attribute kind="java" basedOn="org.eclipse.wst.server.core.model.ServerBehaviourDelegate"/>
95 </appInfo>
ndaib94eb262004-10-13 15:55:37 +000096 </annotation>
97 </attribute>
deboerda1df6a2004-12-03 13:35:32 +000098 <attribute name="hasConfiguration" type="boolean">
ndaib94eb262004-10-13 15:55:37 +000099 <annotation>
100 <documentation>
deboerda1df6a2004-12-03 13:35:32 +0000101 true if this server has server configuration files
102 </documentation>
103 </annotation>
104 </attribute>
105 <attribute name="runtimeTypeId" type="string" use="required">
106 <annotation>
107 <documentation>
deboer9534e5a2006-04-28 04:25:20 +0000108 the runtime type id that this server type corresponds to
ndaib94eb262004-10-13 15:55:37 +0000109 </documentation>
110 </annotation>
111 </attribute>
ndaib94eb262004-10-13 15:55:37 +0000112 <attribute name="launchConfigId" type="string">
113 <annotation>
114 <documentation>
115 the launch configuration id for the launch configuration that is able to start this server
116 </documentation>
117 </annotation>
118 </attribute>
deboer357b2882006-03-29 20:14:36 +0000119 <attribute name="supportsRemoteHosts" type="boolean">
ndaib94eb262004-10-13 15:55:37 +0000120 <annotation>
121 <documentation>
deboerda1df6a2004-12-03 13:35:32 +0000122 true if this server type can work with remote host names, false if this server type can only work on localhost. if unspecified, false is assumed
ndaib94eb262004-10-13 15:55:37 +0000123 </documentation>
124 </annotation>
125 </attribute>
deboer357b2882006-03-29 20:14:36 +0000126 <attribute name="runtime" type="boolean">
ndaib94eb262004-10-13 15:55:37 +0000127 <annotation>
128 <documentation>
deboer9534e5a2006-04-28 04:25:20 +0000129 true if this server requires a runtime, and false otherwise
ndaib94eb262004-10-13 15:55:37 +0000130 </documentation>
131 </annotation>
132 </attribute>
ndaib94eb262004-10-13 15:55:37 +0000133 <attribute name="launchModes" type="string">
134 <annotation>
135 <documentation>
deboer9534e5a2006-04-28 04:25:20 +0000136 a comma separated list of the launch modes that this server supports
ndaib94eb262004-10-13 15:55:37 +0000137 </documentation>
138 </annotation>
139 </attribute>
ndaib94eb262004-10-13 15:55:37 +0000140 <attribute name="initialState" type="string">
141 <annotation>
142 <documentation>
143 the intial state of the server, either &quot;started&quot;, or &quot;stopped&quot;. if this attribute is not specified, the server state will be &quot;unknown&quot;
144 </documentation>
145 </annotation>
146 </attribute>
deboerda1df6a2004-12-03 13:35:32 +0000147 <attribute name="startTimeout" type="string">
148 <annotation>
149 <documentation>
deboer2a9c3f42007-10-29 01:05:36 +0000150 the timeout value (in ms) that the tool will wait for the server to be started. The default is 2 minutes
deboerda1df6a2004-12-03 13:35:32 +0000151 </documentation>
152 </annotation>
153 </attribute>
154 <attribute name="stopTimeout" type="string">
155 <annotation>
156 <documentation>
deboer2a9c3f42007-10-29 01:05:36 +0000157 the timeout value (in ms) that the tool will wait for the server to be stopped. The default is 2 minutes
deboerda1df6a2004-12-03 13:35:32 +0000158 </documentation>
159 </annotation>
160 </attribute>
deboer357b2882006-03-29 20:14:36 +0000161 <attribute name="startBeforePublish" type="boolean">
deboer7502f5e2005-04-22 15:55:23 +0000162 <annotation>
163 <documentation>
164 boolean value &quot;true&quot; or &quot;false&quot; to specify whether the server needs to be started for publishing to occur. If &quot;true&quot;, the server will be started on every call to publish() before executing the publish code
165 </documentation>
166 </annotation>
167 </attribute>
ndaib94eb262004-10-13 15:55:37 +0000168 </complexType>
169 </element>
170
171 <annotation>
172 <appInfo>
lmandel5773ece2005-11-29 06:02:22 +0000173 <meta.section type="since"/>
174 </appInfo>
175 <documentation>
176 1.0
177 </documentation>
178 </annotation>
179
180 <annotation>
181 <appInfo>
ndaib94eb262004-10-13 15:55:37 +0000182 <meta.section type="examples"/>
183 </appInfo>
184 <documentation>
deboer3010e342005-05-11 16:08:22 +0000185 The following is an example of a server type extension point:
186
deboer3010e342005-05-11 16:08:22 +0000187&lt;pre&gt;
lmandeleef96112005-12-09 22:43:22 +0000188 &lt;extension
189 point=&quot;org.eclipse.wst.server.core.serverTypes&quot;&gt;
190 &lt;serverType
191 id=&quot;com.example.serverType&quot;
192 name=&quot;%serverTypeName&quot;
193 description=&quot;%serverTypeDescription&quot;
194 supportsRemoteHosts=&quot;true&quot;
195 runtime=&quot;true&quot;
196 initialState=&quot;stopped&quot;
197 hasConfiguration=&quot;true&quot;
198 launchConfigId=&quot;com.example.launchConfigurationType&quot;
199 runtimeTypeId=&quot;com.example.runtime&quot;
200 class=&quot;com.example.ExampleServerDelegate&quot;
201 behaviourClass=&quot;com.example.ExampleServerBehaviourDelegate&quot;/&gt;
deboer3010e342005-05-11 16:08:22 +0000202 &lt;/extension&gt;
203&lt;/pre&gt;
ndaib94eb262004-10-13 15:55:37 +0000204 </documentation>
205 </annotation>
206
207 <annotation>
208 <appInfo>
209 <meta.section type="apiInfo"/>
210 </appInfo>
211 <documentation>
lmandeleef96112005-12-09 22:43:22 +0000212 Value of the attribute &lt;b&gt;class&lt;/b&gt; must be a fully qualified name of a Java class that extends the abstract class &lt;code&gt;org.eclipse.wst.server.core.model.ServerDelegate&lt;/code&gt; and has a public 0-arg constructor.
deboer3010e342005-05-11 16:08:22 +0000213
lmandeleef96112005-12-09 22:43:22 +0000214Value of the attribute &lt;b&gt;behaviourClass&lt;/b&gt; must be a fully qualified name of a Java class that extends the abstract class &lt;code&gt;org.eclipse.wst.server.core.model.ServerBehaviourDelegate&lt;/code&gt; and has a public 0-arg constructor.
215 </documentation>
216 </annotation>
deboer357b2882006-03-29 20:14:36 +0000217
lmandeleef96112005-12-09 22:43:22 +0000218 <annotation>
219 <appInfo>
220 <meta.section type="implementation"/>
221 </appInfo>
222 <documentation>
223
ndaib94eb262004-10-13 15:55:37 +0000224 </documentation>
225 </annotation>
226
227 <annotation>
228 <appInfo>
229 <meta.section type="copyright"/>
230 </appInfo>
231 <documentation>
deboer3010e342005-05-11 16:08:22 +0000232 Copyright (c) 2000, 2005 IBM Corporation and others.&lt;br&gt;
233All rights reserved. This program and the accompanying materials are made
234available under the terms of the Eclipse Public License v1.0 which accompanies
235this distribution, and is available at
deboerdf10c152005-02-17 18:24:46 +0000236&lt;a href=&quot;http://www.eclipse.org/legal/epl-v10.html&quot;&gt;http://www.eclipse.org/legal/epl-v10.html&lt;/a&gt;
ndaib94eb262004-10-13 15:55:37 +0000237 </documentation>
238 </annotation>
239
240</schema>