home *** CD-ROM | disk | FTP | other *** search
/ Internet Magazine 2003 October / INTERNET108.ISO / pc / software / windows / building / xmlspy / xmlspyentcomplete5.exe / Data1.cab / _5C197140EA7D4275BF7073CAD8B0FAB6 < prev    next >
Encoding:
Text File  |  2002-09-03  |  11.6 KB  |  415 lines
  1. <!-- edited with XML Spy v5 beta 3 U (http://www.xmlspy.com) by John D Judy (Altova, Inc.) -->
  2. <!--
  3.  
  4.    This is the DTD defining the JavaServer Pages 1.2 Tag Library
  5.    descriptor (.tld) (XML) file format/syntax.
  6.  
  7.    A Tag Library is a JAR file containing a valid instance of a Tag Library
  8.    Descriptor (taglib.tld) file in the META-INF subdirectory, along with the
  9.    appropriate implementing classes, and other resources required to
  10.    implement the tags defined therein.
  11.  
  12.    Use is subject to license terms.
  13.   -->
  14. <!NOTATION WEB-JSPTAGLIB.1_2 PUBLIC
  15.           "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN">
  16. <!--
  17. This is the XML DTD for the JSP 1.2 Tag Library Descriptor.
  18. All JSP 1.2 tag library descriptors must include a DOCTYPE
  19. of the following form:
  20.  
  21.   <!DOCTYPE taglib
  22.         PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
  23.     "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
  24.  
  25. -->
  26. <!--
  27. The taglib tag is the document root, it defines:
  28.  
  29. tlib-version    the version of the tag library implementation
  30.  
  31. jsp-version    the version of JSP the tag library depends upon
  32.  
  33. short-name    a simple default short name that could be used by
  34.         a JSP authoring tool to create names with a mnemonic
  35.         value; for example, the it may be used as the prefered
  36.         prefix value in taglib directives
  37.  
  38. uri        a uri uniquely identifying this taglib
  39.  
  40. display-name    the display-name element contains a short name that
  41.                 is intended to be displayed by tools
  42. small-icon      optional small-icon that can be used by tools
  43.  
  44. large-icon      optional large-icon that can be used by tools
  45.  
  46. description    a simple string describing the "use" of this taglib,
  47.         should be user discernable
  48.  
  49. validator       optional TagLibraryValidator information
  50.  
  51. listener        optional event listener specification
  52.  
  53.  
  54. -->
  55. <!ELEMENT taglib (tlib-version, jsp-version, short-name, uri?, display-name?, small-icon?, large-icon?, description?, validator?, listener*, tag+)>
  56. <!ATTLIST taglib
  57.     id ID #IMPLIED
  58.     xmlns CDATA #FIXED "http://java.sun.com/JSP/TagLibraryDescriptor"
  59. >
  60. <!--
  61. Describes this version (number) of the taglibrary (dewey decimal)
  62.  
  63. #PCDATA ::= [0-9]*{ "."[0-9] }0..3
  64. -->
  65. <!ELEMENT tlib-version (#PCDATA)>
  66. <!--
  67. Describes the JSP version (number) this taglibrary requires in
  68. order to function (dewey decimal)
  69.  
  70. The default is 1.2
  71.  
  72. #PCDATA ::= [0-9]*{ "."[0-9] }0..3
  73. -->
  74. <!ELEMENT jsp-version (#PCDATA)>
  75. <!--
  76. Defines a short (default) short-name to be used for tags and
  77. variable names used/created by this tag library.  Do not use
  78. white space, and do not start with digits or underscore.
  79.  
  80. #PCDATA ::= NMTOKEN
  81. -->
  82. <!ELEMENT short-name (#PCDATA)>
  83. <!--
  84. Defines a public URI that uniquely identifies this version of
  85. the taglibrary.  Leave it empty if it does not apply.
  86. -->
  87. <!ELEMENT uri (#PCDATA)>
  88. <!--
  89. Defines an arbitrary text string descirbing the tag library
  90. -->
  91. <!ELEMENT description (#PCDATA)>
  92. <!--
  93.  
  94. Defines an optional validator that can be used to
  95. validate the conformance of a JSP page to using this tag library.
  96. -->
  97. <!ELEMENT validator (validator-class, init-param*, description?)>
  98. <!--
  99.  
  100. Defines the TagLibraryValidator class that can be used to
  101. validate the conformance of a JSP page to using this tag library.
  102. -->
  103. <!ELEMENT validator-class (#PCDATA)>
  104. <!--
  105.  
  106. The init-param element contains a name/value pair as an
  107. initialization param
  108. -->
  109. <!ELEMENT init-param (param-name, param-value, description?)>
  110. <!--
  111.  
  112. The param-name element contains the name of a parameter.
  113. -->
  114. <!ELEMENT param-name (#PCDATA)>
  115. <!--
  116.  
  117. The param-value element contains the value of a parameter.
  118. -->
  119. <!ELEMENT param-value (#PCDATA)>
  120. <!--
  121.  
  122. Defines an optional event listener object to be instantiated and
  123. registered automatically.
  124. -->
  125. <!ELEMENT listener (listener-class)>
  126. <!--
  127.  
  128. The listener-class element declares a class in the application that
  129. must be registered as a web application listener bean.  See the
  130. Servlet 2.3 specification for details.
  131. -->
  132. <!ELEMENT listener-class (#PCDATA)>
  133. <!--
  134. The tag defines a unique tag in this tag library.  It has one
  135. attribute, id.
  136.  
  137. The tag element may have several subelements defining:
  138.  
  139. name              The unique action name
  140.  
  141. tag-class         The tag handler class implementing
  142.                   javax.servlet.jsp.tagext.Tag
  143.  
  144. tei-class         An optional subclass of
  145.                   javax.servlet.jsp.tagext.TagExtraInfo
  146.  
  147. body-content      The body content type
  148.  
  149. display-name      A short name that is intended to be displayed
  150.                   by tools
  151.  
  152. small-icon        Optional small-icon that can be used by tools
  153.  
  154. large-icon        Optional large-icon that can be used by tools
  155.  
  156. description       Optional tag-specific information
  157.  
  158. variable          Optional scripting variable information
  159.  
  160. attribute         All attributes of this action
  161.  
  162. example           Optional informal description of an example of a
  163.                   use of this tag
  164.  
  165. -->
  166. <!ELEMENT tag (name, tag-class, tei-class?, body-content?, display-name?, small-icon?, large-icon?, description?, variable*, attribute*, example?)>
  167. <!--
  168. Defines the subclass of javax.serlvet.jsp.tagext.Tag that implements
  169. the request time semantics for this tag. (required)
  170.  
  171. #PCDATA ::= fully qualified Java class name
  172. -->
  173. <!ELEMENT tag-class (#PCDATA)>
  174. <!--
  175. Defines the subclass of javax.servlet.jsp.tagext.TagExtraInfo for
  176. this tag. (optional)
  177.  
  178. If this is not given, the class is not consulted at translation time.
  179.  
  180. #PCDATA ::= fully qualified Java class name
  181. -->
  182. <!ELEMENT tei-class (#PCDATA)>
  183. <!--
  184. Provides a hint as to the content of the body of this tag. Primarily
  185. intended for use by page composition tools.
  186.  
  187. There are currently three values specified:
  188.  
  189. tagdependent    The body of the tag is interpreted by the tag
  190.         implementation itself, and is most likely in a
  191.         different "langage", e.g embedded SQL statements.
  192.  
  193. JSP        The body of the tag contains nested JSP syntax
  194.  
  195. empty        The body must be empty
  196.  
  197. The default (if not defined) is JSP
  198.  
  199. #PCDATA ::=  tagdependent | JSP | empty
  200.  
  201. -->
  202. <!ELEMENT body-content (#PCDATA)>
  203. <!--
  204.  
  205. The display-name element contains a short name that is intended
  206. to be displayed by tools.
  207. -->
  208. <!ELEMENT display-name (#PCDATA)>
  209. <!--
  210.  
  211. The large-icon element contains the name of a file containing a large
  212. (32 x 32) icon image.  The file name is a relative path within the
  213. tag library.  The image must be either in the JPEG or GIF format, and
  214. the file name must end with the suffix ".jpg" or ".gif" respectively.
  215. The icon can be used by tools.
  216. -->
  217. <!ELEMENT large-icon (#PCDATA)>
  218. <!--
  219.  
  220. The small-icon element contains the name of a file containing a large
  221. (32 x 32) icon image.  The file name is a relative path within the
  222. tag library.  The image must be either in the JPEG or GIF format, and
  223. the file name must end with the suffix ".jpg" or ".gif" respectively.
  224. The icon can be used by tools.
  225. -->
  226. <!ELEMENT small-icon (#PCDATA)>
  227. <!--
  228.  
  229. The example element contains an informal description of an example
  230. of the use of a tag.
  231. -->
  232. <!ELEMENT example (#PCDATA)>
  233. <!--
  234.  
  235. The variable tag provides information on the scripting variables
  236. defined by this tag.  It is a (translation time) error for a tag
  237. that has one or more variable subelements to have a TagExtraInfo
  238. class that returns a non-null object.
  239.  
  240. The subelements of variable are of the form:
  241.  
  242. name-given               The variable name as a constant
  243.  
  244. name-from-attribute      The name of an attribute whose (translation
  245.                          time) value will give the name of the
  246.                          variable.  One of name-given or
  247.                          name-from-attribute is required.
  248.  
  249. variable-class           Name of the class of the variable.
  250.                          java.lang.String is default.
  251.  
  252. declare                  Whether the variable is declared or not.
  253.                          True is the default.
  254.  
  255. scope                    The scope of the scripting varaible
  256.                          defined.  NESTED is default.
  257.  
  258. description              Optional description of this variable
  259.  
  260. -->
  261. <!ELEMENT variable ((name-given | name-from-attribute), variable-class?, declare?, scope?, description?)>
  262. <!--
  263.  
  264. The name for the scripting variable.  One of name-given or
  265. name-from-attribute is required.
  266. -->
  267. <!ELEMENT name-given (#PCDATA)>
  268. <!--
  269.  
  270. The name of an attribute whose (translation-time) value will give
  271. the name of the variable.  One of name-given or name-from-attribute
  272. is required.
  273. -->
  274. <!ELEMENT name-from-attribute (#PCDATA)>
  275. <!--
  276.  
  277. The optional name of the class for the scripting variable.  The
  278. default is java.lang.String.
  279. -->
  280. <!ELEMENT variable-class (#PCDATA)>
  281. <!--
  282.  
  283. Whether the scripting variable is to be defined or not.  See
  284. TagExtraInfo for details.  This element is optional and "true"
  285. is the default.
  286. -->
  287. <!ELEMENT declare (#PCDATA)>
  288. <!--
  289.  
  290. The scope of the scripting variable.  See TagExtraInfo for details.
  291. The element is optional and "NESTED" is the default.  Other legal
  292. values are "AT_BEGIN" and "AT_END".
  293. -->
  294. <!ELEMENT scope (#PCDATA)>
  295. <!--
  296.  
  297. The attribute tag defines an attribute for the nesting tag
  298.  
  299. An attribute definition is composed of:
  300.     
  301. - the attributes name (required)
  302. - if the attribute is required or optional (optional)
  303. - if the attributes value may be dynamically calculated at runtime
  304.   by a scriptlet expression (optional)
  305. - the type of the attributes value (optional)
  306. - an informal description of the meaning of the attribute (optional)
  307.  
  308. -->
  309. <!--
  310. The attribute tag defines an attribute for the nesting tag
  311.  
  312. An attribute definition is composed of:
  313.  
  314. - the attributes name (required)
  315.  
  316. - if the attribute is required or optional (optional)
  317.  
  318. - if the attributes value may be dynamically calculated at runtime
  319.   by a scriptlet expression (optional)
  320.  
  321. - the type of the attributes value (optional)
  322.  
  323. - an informal description of the meaning of the attribute (optional)
  324. -->
  325. <!ELEMENT attribute (name, required?, rtexprvalue?, type?, description?)>
  326. <!--
  327. Defines the canonical name of a tag or attribute being defined
  328.  
  329. #PCDATA ::= NMTOKEN
  330. -->
  331. <!ELEMENT name (#PCDATA)>
  332. <!--
  333. Defines if the nesting attribute is required or optional.
  334.  
  335. #PCDATA ::= true | false | yes | no
  336.  
  337. If not present then the default is "false", i.e the attribute
  338. is optional.
  339. -->
  340. <!ELEMENT required (#PCDATA)>
  341. <!--
  342. Defines if the nesting attribute can have scriptlet expressions as
  343. a value, i.e the value of the attribute may be dynamically calculated
  344. at request time, as opposed to a static value determined at translation
  345. time.
  346.  
  347. #PCDATA ::= true | false | yes | no
  348.  
  349. If not present then the default is "false", i.e the attribute
  350. has a static value
  351. -->
  352. <!ELEMENT rtexprvalue (#PCDATA)>
  353. <!--
  354.  
  355. Defines the Java type of the attributes value.  For static values
  356. (those determined at translation time) the type is always
  357. java.lang.String.
  358. -->
  359. <!ELEMENT type (#PCDATA)>
  360. <!-- ID attributes -->
  361. <!ATTLIST tlib-version
  362.     id ID #IMPLIED
  363. >
  364. <!ATTLIST jsp-version
  365.     id ID #IMPLIED
  366. >
  367. <!ATTLIST short-name
  368.     id ID #IMPLIED
  369. >
  370. <!ATTLIST uri
  371.     id ID #IMPLIED
  372. >
  373. <!ATTLIST description
  374.     id ID #IMPLIED
  375. >
  376. <!ATTLIST example
  377.     id ID #IMPLIED
  378. >
  379. <!ATTLIST tag
  380.     id ID #IMPLIED
  381. >
  382. <!ATTLIST tag-class
  383.     id ID #IMPLIED
  384. >
  385. <!ATTLIST tei-class
  386.     id ID #IMPLIED
  387. >
  388. <!ATTLIST body-content
  389.     id ID #IMPLIED
  390. >
  391. <!ATTLIST attribute
  392.     id ID #IMPLIED
  393. >
  394. <!ATTLIST name
  395.     id ID #IMPLIED
  396. >
  397. <!ATTLIST required
  398.     id ID #IMPLIED
  399. >
  400. <!ATTLIST rtexprvalue
  401.     id ID #IMPLIED
  402. >
  403. <!ATTLIST param-name
  404.     id ID #IMPLIED
  405. >
  406. <!ATTLIST param-value
  407.     id ID #IMPLIED
  408. >
  409. <!ATTLIST listener
  410.     id ID #IMPLIED
  411. >
  412. <!ATTLIST listener-class
  413.     id ID #IMPLIED
  414. >
  415.