blob: ab633886d95b362ff0e68dd17bffc41154527465 [file] [log] [blame]
david_williamse073de12007-04-28 04:01:44 +00001<?xml version="1.0" encoding="UTF-8"?>
2
3<xsd:schema xmlns="http://www.w3.org/2001/XMLSchema"
4 targetNamespace="http://java.sun.com/xml/ns/javaee"
5 xmlns:javaee="http://java.sun.com/xml/ns/javaee"
6 xmlns:xsd="http://www.w3.org/2001/XMLSchema"
7 elementFormDefault="qualified"
8 attributeFormDefault="unqualified"
9 version="2.1">
10 <xsd:annotation>
11 <xsd:documentation>
12 @(#)jsp_2_1.xsds 1.5 08/11/05
13 </xsd:documentation>
14 </xsd:annotation>
15
16 <xsd:annotation>
17 <xsd:documentation>
18
19 Copyright 2003-2005 Sun Microsystems, Inc.
20 4150 Network Circle
21 Santa Clara, California 95054
22 U.S.A
23 All rights reserved.
24
25 Sun Microsystems, Inc. has intellectual property rights
26 relating to technology described in this document. In
27 particular, and without limitation, these intellectual
28 property rights may include one or more of the U.S. patents
29 listed at http://www.sun.com/patents and one or more
30 additional patents or pending patent applications in the
31 U.S. and other countries.
32
33 This document and the technology which it describes are
34 distributed under licenses restricting their use, copying,
35 distribution, and decompilation. No part of this document
36 may be reproduced in any form by any means without prior
37 written authorization of Sun and its licensors, if any.
38
39 Third-party software, including font technology, is
40 copyrighted and licensed from Sun suppliers.
41
42 Sun, Sun Microsystems, the Sun logo, Solaris, Java, J2EE,
43 JavaServer Pages, Enterprise JavaBeans and the Java Coffee
44 Cup logo are trademarks or registered trademarks of Sun
45 Microsystems, Inc. in the U.S. and other countries.
46
47 Federal Acquisitions: Commercial Software - Government Users
48 Subject to Standard License Terms and Conditions.
49
50 </xsd:documentation>
51 </xsd:annotation>
52
53 <xsd:annotation>
54 <xsd:documentation>
55
56 This is the XML Schema for the JSP 2.1 deployment descriptor
57 types. The JSP 2.1 schema contains all the special
58 structures and datatypes that are necessary to use JSP files
59 from a web application.
60
61 The contents of this schema is used by the web-app_2_5.xsd
62 file to define JSP specific content.
63
64 </xsd:documentation>
65 </xsd:annotation>
66
67 <xsd:annotation>
68 <xsd:documentation>
69
70 The following conventions apply to all Java EE
71 deployment descriptor elements unless indicated otherwise.
72
73 - In elements that specify a pathname to a file within the
74 same JAR file, relative filenames (i.e., those not
75 starting with "/") are considered relative to the root of
76 the JAR file's namespace. Absolute filenames (i.e., those
77 starting with "/") also specify names in the root of the
78 JAR file's namespace. In general, relative names are
79 preferred. The exception is .war files where absolute
80 names are preferred for consistency with the Servlet API.
81
82 </xsd:documentation>
83 </xsd:annotation>
84
85 <xsd:include schemaLocation="javaee_5.xsd"/>
86
87
88<!-- **************************************************** -->
89
90 <xsd:complexType name="jsp-configType">
91 <xsd:annotation>
92 <xsd:documentation>
93
94 The jsp-configType is used to provide global configuration
95 information for the JSP files in a web application. It has
96 two subelements, taglib and jsp-property-group.
97
98 </xsd:documentation>
99 </xsd:annotation>
100
101 <xsd:sequence>
102 <xsd:element name="taglib"
103 type="javaee:taglibType"
104 minOccurs="0"
105 maxOccurs="unbounded"/>
106 <xsd:element name="jsp-property-group"
107 type="javaee:jsp-property-groupType"
108 minOccurs="0"
109 maxOccurs="unbounded"/>
110 </xsd:sequence>
111 <xsd:attribute name="id" type="xsd:ID"/>
112 </xsd:complexType>
113
114<!-- **************************************************** -->
115
116 <xsd:complexType name="jsp-fileType">
117 <xsd:annotation>
118 <xsd:documentation>
119
120 The jsp-file element contains the full path to a JSP file
121 within the web application beginning with a `/'.
122
123 </xsd:documentation>
124 </xsd:annotation>
125
126 <xsd:simpleContent>
127 <xsd:restriction base="javaee:pathType"/>
128 </xsd:simpleContent>
129 </xsd:complexType>
130
131<!-- **************************************************** -->
132
133 <xsd:complexType name="jsp-property-groupType">
134 <xsd:annotation>
135 <xsd:documentation>
136
137 The jsp-property-groupType is used to group a number of
138 files so they can be given global property information.
139 All files so described are deemed to be JSP files. The
140 following additional properties can be described:
141
142 - Control whether EL is ignored.
143 - Control whether scripting elements are invalid.
144 - Indicate pageEncoding information.
145 - Indicate that a resource is a JSP document (XML).
146 - Prelude and Coda automatic includes.
147 - Control whether the character sequence #{ is allowed
148 when used as a String literal.
149 - Control whether template text containing only
150 whitespaces must be removed from the response output.
151
152 </xsd:documentation>
153 </xsd:annotation>
154
155 <xsd:sequence>
156 <xsd:group ref="javaee:descriptionGroup"/>
157 <xsd:element name="url-pattern"
158 type="javaee:url-patternType"
159 maxOccurs="unbounded"/>
160 <xsd:element name="el-ignored"
161 type="javaee:true-falseType"
162 minOccurs="0">
163 <xsd:annotation>
164 <xsd:documentation>
165
166 Can be used to easily set the isELIgnored
167 property of a group of JSP pages. By default, the
168 EL evaluation is enabled for Web Applications using
169 a Servlet 2.4 or greater web.xml, and disabled
170 otherwise.
171
172 </xsd:documentation>
173 </xsd:annotation>
174 </xsd:element>
175 <xsd:element name="page-encoding"
176 type="javaee:string"
177 minOccurs="0">
178 <xsd:annotation>
179 <xsd:documentation>
180
181 The valid values of page-encoding are those of the
182 pageEncoding page directive. It is a
183 translation-time error to name different encodings
184 in the pageEncoding attribute of the page directive
185 of a JSP page and in a JSP configuration element
186 matching the page. It is also a translation-time
187 error to name different encodings in the prolog
188 or text declaration of a document in XML syntax and
189 in a JSP configuration element matching the document.
190 It is legal to name the same encoding through
191 mulitple mechanisms.
192
193 </xsd:documentation>
194 </xsd:annotation>
195 </xsd:element>
196 <xsd:element name="scripting-invalid"
197 type="javaee:true-falseType"
198 minOccurs="0">
199 <xsd:annotation>
200 <xsd:documentation>
201
202 Can be used to easily disable scripting in a
203 group of JSP pages. By default, scripting is
204 enabled.
205
206 </xsd:documentation>
207 </xsd:annotation>
208 </xsd:element>
209 <xsd:element name="is-xml"
210 type="javaee:true-falseType"
211 minOccurs="0">
212 <xsd:annotation>
213 <xsd:documentation>
214
215 If true, denotes that the group of resources
216 that match the URL pattern are JSP documents,
217 and thus must be interpreted as XML documents.
218 If false, the resources are assumed to not
219 be JSP documents, unless there is another
220 property group that indicates otherwise.
221
222 </xsd:documentation>
223 </xsd:annotation>
224 </xsd:element>
225 <xsd:element name="include-prelude"
226 type="javaee:pathType"
227 minOccurs="0"
228 maxOccurs="unbounded">
229 <xsd:annotation>
230 <xsd:documentation>
231
232 The include-prelude element is a context-relative
233 path that must correspond to an element in the
234 Web Application. When the element is present,
235 the given path will be automatically included (as
236 in an include directive) at the beginning of each
237 JSP page in this jsp-property-group.
238
239 </xsd:documentation>
240 </xsd:annotation>
241 </xsd:element>
242 <xsd:element name="include-coda"
243 type="javaee:pathType"
244 minOccurs="0"
245 maxOccurs="unbounded">
246 <xsd:annotation>
247 <xsd:documentation>
248
249 The include-coda element is a context-relative
250 path that must correspond to an element in the
251 Web Application. When the element is present,
252 the given path will be automatically included (as
253 in an include directive) at the end of each
254 JSP page in this jsp-property-group.
255
256 </xsd:documentation>
257 </xsd:annotation>
258 </xsd:element>
259 <xsd:element name="deferred-syntax-allowed-as-literal"
260 type="javaee:true-falseType"
261 minOccurs="0">
262 <xsd:annotation>
263 <xsd:documentation>
264
265 The character sequence #{ is reserved for EL expressions.
266 Consequently, a translation error occurs if the #{
267 character sequence is used as a String literal, unless
268 this element is enabled (true). Disabled (false) by
269 default.
270
271 </xsd:documentation>
272 </xsd:annotation>
273 </xsd:element>
274 <xsd:element name="trim-directive-whitespaces"
275 type="javaee:true-falseType"
276 minOccurs="0">
277 <xsd:annotation>
278 <xsd:documentation>
279
280 Indicates that template text containing only whitespaces
281 must be removed from the response output. It has no
282 effect on JSP documents (XML syntax). Disabled (false)
283 by default.
284
285 </xsd:documentation>
286 </xsd:annotation>
287 </xsd:element>
288 </xsd:sequence>
289 <xsd:attribute name="id" type="xsd:ID"/>
290 </xsd:complexType>
291
292<!-- **************************************************** -->
293
294 <xsd:complexType name="taglibType">
295 <xsd:annotation>
296 <xsd:documentation>
297
298 The taglibType defines the syntax for declaring in
299 the deployment descriptor that a tag library is
300 available to the application. This can be done
301 to override implicit map entries from TLD files and
302 from the container.
303
304 </xsd:documentation>
305 </xsd:annotation>
306
307 <xsd:sequence>
308 <xsd:element name="taglib-uri"
309 type="javaee:string">
310 <xsd:annotation>
311 <xsd:documentation>
312
313 A taglib-uri element describes a URI identifying a
314 tag library used in the web application. The body
315 of the taglib-uri element may be either an
316 absolute URI specification, or a relative URI.
317 There should be no entries in web.xml with the
318 same taglib-uri value.
319
320 </xsd:documentation>
321 </xsd:annotation>
322 </xsd:element>
323
324 <xsd:element name="taglib-location"
325 type="javaee:pathType">
326 <xsd:annotation>
327 <xsd:documentation>
328
329 the taglib-location element contains the location
330 (as a resource relative to the root of the web
331 application) where to find the Tag Library
332 Description file for the tag library.
333
334 </xsd:documentation>
335 </xsd:annotation>
336 </xsd:element>
337
338 </xsd:sequence>
339 <xsd:attribute name="id" type="xsd:ID"/>
340 </xsd:complexType>
341
342</xsd:schema>
343