david_williams | e073de1 | 2007-04-28 04:01:44 +0000 | [diff] [blame] | 1 | <?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 | |