Documentation change for new JSONP TCK (#343)
diff --git a/tck/tck-docs/JSONP2.1-ReleaseNotes.html b/tck/tck-docs/JSONP2.1-ReleaseNotes.html new file mode 100644 index 0000000..4a6421c --- /dev/null +++ b/tck/tck-docs/JSONP2.1-ReleaseNotes.html
@@ -0,0 +1,108 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<!-- + + Copyright (c) 2021 Oracle and/or its affiliates. All rights reserved. + + This program and the accompanying materials are made available under the + terms of the Eclipse Public License v. 2.0, which is available at + http://www.eclipse.org/legal/epl-2.0. + + This Source Code may also be made available under the following Secondary + Licenses when the conditions for such availability set forth in the + Eclipse Public License v. 2.0 are satisfied: GNU General Public License, + version 2 with the GNU Classpath Exception, which is available at + https://www.gnu.org/software/classpath/license.html. + + SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0 + +--> +<html> + <head> + <meta http-equiv="content-type" content="text/html; charset=windows-1252"> + <title>Jakarta JSON Processing TCK Release Notes</title> + <style type="text/css"> +<!-- +body { background-color: #ffffdd; color: #000000} +pre { background-color: #eeeeee; color: #000099; font-size: smaller} +code { color: #000099; font-size: smaller} +h1 { color: #000099} +h2 { color: #000099} +h3 { color: #000099; text-decoration: underline} +h4 { font-style: italic; color: #000099} +.tabletitle { font-style: italic; color: #ffffcc; font-size: small; font-variant: small-caps} +.subtitle { font-style: italic; color: #ffffcc; font-variant: small-caps} +.emphasize { font-style: italic; color: #000099} +.step { font-weight: bold} +.note { background-color: #fffff0; border-bottom-width: thin; border-top-width: thin; border-top-style: inset; border-bottom-style: inset; font-size: -10%;} +th { background-color: #eeeeee; padding-left: 2pt; padding-right: 2pt;} +--> +</style></head> + <body> + <div align="center"> + <h1>Jakarta EE JSON Processing Technology Compatibility Kit, Version 2.1</h1> + <h2> <em class="emphasize">Release Notes, December 2021</em></h2> + <h2><em class="emphasize"></em></h2> + </div> + <h2><a name="kit_contents">Kit Contents</a></h2> + <p>The Jakarta EE JSON Processing, Version 2.1 Technology Compatibility Kit + (TCK) includes the following items:</p> + <ul> + <li> + <p><strong>Jakarta EE JSON Processing TCK tests signature, API, and + pluggability tests:</strong></p> + </li> + <ul type="square"> + <li> + <p>A <strong>signature test</strong> that checks that all of the + public APIs are supported in the Jakarta EE JSON Processing Version + 2.1 implementation that is being tested</p> + </li> + <li> + <p><strong>API tests</strong> for all of the public APIs under the <code>jakarta.json</code>, + <code>jakarta.json.spi</code>, <code>jakarta.json.stream</code> + package</p> + </li> + <li> + <p><strong>Pluggability tests</strong> for testing the SPI provider + interface for supplying your own JsonProvider</p> + </li> + </ul> + </ul> + <hr> + <h2>Jakarta EE JSON Processing TCK Facts</h2> + <blockquote> + <p>The test suite bundle contains the following:</p> + <ul> + <li>187 total tests</li> + </ul> + </blockquote> + <hr> + <h2><a name="platform">Platform Notes</a></h2> + <p>The Jakarta EE JSON Processing TCK tests have been built with JDK 11 + and tested with Java<font size="-2"><sup>TM</sup></font> Platform, + Standard Edition 11+</p> + <p>The Jakarta EE JSON Processing TCK tests have been run on the following + platforms:</p> + <ul> + <li>CentOS 7</li> + <li>Alpine Linux v3.12</li> + </ul> + <p>The Jakarta EE JSON Processing TCK tests have been run against the + following Jakarta EE JSON Processing 2.1 Compatible Implementations:</p> + <ul> + <li>Jakarta EE JSON Processing Compatible Implementation Version 2.1.0</li> + </ul> + <hr> + <h2><a name="install_setup_run">Installing, Setting Up, and Running the + JSON-P TCK</a></h2> + <p>Refer to the <cite><a href="html-usersguide/title.html">JSON-P TCK 2.0 + User's Guide</a></cite> (or <a href="./pdf-usersguide/Jakarta-JSON-Processing-TCK-Users-Guide.pdf" + + title="Jakarta EE JSON Processing 2.1 TCK User's Guide (PDF)">PDF</a>) + for complete instructions on installing, setting up, and running the + JSON-P TCK. </p> + <hr> + <p><cite><small>Copyright � 2013, 2021 Oracle and/or its affiliates. All + rights reserved.</small></cite></p> + </body> +</html>
diff --git a/tck/tck-docs/LICENSE_EFTL.md b/tck/tck-docs/LICENSE_EFTL.md new file mode 100644 index 0000000..a210682 --- /dev/null +++ b/tck/tck-docs/LICENSE_EFTL.md
@@ -0,0 +1,83 @@ +# Eclipse Foundation Technology Compatibility Kit License - v 1.0 + +Copyright (c) 2018, Eclipse Foundation, Inc. and its licensors. + +Redistribution and use in binary form is permitted provided that the +following conditions are met: + +1. Use of the Technology Compatibility Kit accompanying this license + (the "TCK") and its documentation is permitted solely for the + purpose of testing compatibility of an implementation (the + "Product") of a specification (the "Specification") made available + by the Eclipse Foundation, Inc. ("Eclipse"). + +2. Only those modifications expressly permitted by the TCK and its + documentation are permitted. Except in these limited circumstances, + no modifications to the TCK are permitted under this license. + +3. A Product will be deemed to be "compatible" with the Specification + if it fully and completely meets and satisfies all requirements of + the TCK. + +4. Before any claim of compatibility (or any similar claim suggesting + compatibility) is made based on the TCK, the testing party must: + + a. use the TCK to demonstrate that the Product fully and + completely meets and satisfies all requirements of the TCK; + + b. make TCK test results showing full and complete satisfaction of + all requirements of the TCK publicly available on the testing + party's website and send a link to such test results to Eclipse + at [tck@eclipse.org](mailto:tck@eclipse.org); and + + c. comply with any requirements stated in the Specification with + regard to subsetting, supersetting, modifying or extending the + Specification in any Product claimed to be compatible with the + Specification. + +5. The test results must be continuously available and the link must + be live for at least as long as the Product is available in the + marketplace. + +6. The TCK may not be used as a basis for any statements of partial + compatibility. The TCK may only be used as a basis for true, + factual statements of full compatibility of Products that fully + meet and satisfy all requirements of the TCK. + +7. A determination that a Product is compatible with the TCK does not, + in itself, give rise to the right to use any name, mark, logo + associated with the TCK, Eclipse, or Eclipse's contributors or + licensors. + +8. Upon the request of Eclipse, a tester will retract any statements + of compatibility (or any similar claim suggesting compatibility) + which Eclipse reasonably determines to be false or misleading or in + violation of the terms of this license. + +9. Redistribution of the TCK must be under this Eclipse Foundation + Technology Compatibility Kit License and must reproduce the above + copyright notice, this list of conditions and the following + disclaimer in the documentation and/or other materials provided + with the distribution. + +10. Neither the name, trademarks or logos of Eclipse, nor the names, + trademarks or logos of its contributors or licensors may be used to + endorse or promote products tested with this software without + specific prior written permission. + +11. The source code for the TCK accompanying this license is available + from Eclipse. + +TO THE EXTENT PERMITTED BY APPLICABLE LAW, THIS SOFTWARE IS PROVIDED ON +AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER +EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR +CONDITIONS OF TITLE, NON- INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR +A PARTICULAR PURPOSE. TO THE EXTENT PERMITTED BY APPLICABLE LAW, +NEITHER THE COPYRIGHT OWNER OR ANY CONTRIBUTORS SHALL HAVE ANY +LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), +HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, +STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING +IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE +EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES.
diff --git a/tck/tck-docs/TCK-Exclude-List.txt b/tck/tck-docs/TCK-Exclude-List.txt new file mode 100644 index 0000000..9989db2 --- /dev/null +++ b/tck/tck-docs/TCK-Exclude-List.txt
@@ -0,0 +1,17 @@ +# +# Copyright (c) 2021 Oracle and/or its affiliates. All rights reserved. +# +# This program and the accompanying materials are made available under the +# terms of the Eclipse Public License v. 2.0, which is available at +# http://www.eclipse.org/legal/epl-2.0. +# +# This Source Code may also be made available under the following Secondary +# Licenses when the conditions for such availability set forth in the +# Eclipse Public License v. 2.0 are satisfied: GNU General Public License, +# version 2 with the GNU Classpath Exception, which is available at +# https://www.gnu.org/software/classpath/license.html. +# +# SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0 +# + +
diff --git a/tck/tck-docs/assertions/JSONP2.0JavadocAssertions.html b/tck/tck-docs/assertions/JSONP2.0JavadocAssertions.html new file mode 100644 index 0000000..3560fd9 --- /dev/null +++ b/tck/tck-docs/assertions/JSONP2.0JavadocAssertions.html
@@ -0,0 +1,2659 @@ +<!-- + + Copyright (c) 2018, 2020 Oracle and/or its affiliates. All rights reserved. + + This program and the accompanying materials are made available under the + terms of the Eclipse Public License v. 2.0, which is available at + http://www.eclipse.org/legal/epl-2.0. + + This Source Code may also be made available under the following Secondary + Licenses when the conditions for such availability set forth in the + Eclipse Public License v. 2.0 are satisfied: GNU General Public License, + version 2 with the GNU Classpath Exception, which is available at + https://www.gnu.org/software/classpath/license.html. + + SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0 + +--> +<html xmlns:Assertions="http://invalid.domain.com/CTS/XMLassertions"> +<head> +<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> + +<title>JavaDoc Assertion Detail</title> +</head> +<body bgcolor="white"> +<br> +<CENTER> +<h2> Jakarta JSON Processing - 2.0<br> + JavaDoc Assertion Detail + </h2> +</CENTER> +<TABLE width="900" border="1" frame="box" cellpadding="5"> +<TH bgcolor="#BFBFBF"><FONT size="1PT">Totals</FONT></TH><TH bgcolor="#BFBFBF"><FONT size="1PT">Total</FONT></TH><TH bgcolor="#BFBFBF"><FONT size="1PT">Active</FONT></TH><TH bgcolor="#BFBFBF"><FONT size="1PT">Deprecated</FONT></TH><TH bgcolor="#BFBFBF"><FONT size="1PT">Removed</FONT></TH> +<tr> +<TD align="center" valign="center"><font size="2PT"> + # of Assertions + </font></TD><TD align="center" valign="center"><font size="2PT">412</font></TD><TD align="center" valign="center"><font size="2PT">282</font></TD><TD align="center" valign="center"><font size="2PT">0</font></TD><TD align="center" valign="center"><font size="2PT">130</font></TD> +</tr> +<tr> +<TD align="center" valign="center"><font size="2PT"> + # of Required Assertions + </font></TD><TD align="center" valign="center"><font size="2PT">412</font></TD><TD align="center" valign="center"><font size="2PT">282</font></TD><TD align="center" valign="center"><font size="2PT">0</font></TD><TD align="center" valign="center"><font size="2PT">130</font></TD> +</tr> +<tr> +<TD align="center" valign="center"><font size="2PT"> + # of Optional Assertions + </font></TD><TD align="center" valign="center"><font size="2PT">0</font></TD><TD align="center" valign="center"><font size="2PT">0</font></TD><TD align="center" valign="center"><font size="2PT">0</font></TD><TD align="center" valign="center"><font size="2PT">0</font></TD> +</tr> +</TABLE> +<br> +<TABLE width="900" border="1" frame="box" cellpadding="1" summary="Javadoc Assertions"> +<TH bgcolor="#BFBFBF"><FONT size="1PT">ID</FONT></TH><TH bgcolor="#BFBFBF"><FONT size="1PT">Return</FONT></TH><TH bgcolor="#BFBFBF"><FONT size="1PT">Method/Field</FONT></TH><TH bgcolor="#BFBFBF"><FONT size="1PT">Description</FONT></TH><TH bgcolor="#BFBFBF"><FONT size="1PT">Required</FONT></TH><TH bgcolor="#BFBFBF"><FONT size="1PT">Deprecated</FONT></TH><TH bgcolor="#BFBFBF"><FONT size="1PT">Testable</FONT></TH> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:6"></a><font size="1PT">JSONP:JAVADOC:6</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a value to the array.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:8"></a><font size="1PT">JSONP:JAVADOC:8</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a value to the array as a JsonString.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:10"></a><font size="1PT">JSONP:JAVADOC:10</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + BigDecimal + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a value to the array as a JsonNumber.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:12"></a><font size="1PT">JSONP:JAVADOC:12</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + BigInteger + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a value to the array as a JsonNumber.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:14"></a><font size="1PT">JSONP:JAVADOC:14</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a value to the array as a JsonNumber.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:16"></a><font size="1PT">JSONP:JAVADOC:16</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + long + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a value to the array as a JsonNumber.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:18"></a><font size="1PT">JSONP:JAVADOC:18</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + double + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a value to the array as a JsonNumber.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:21"></a><font size="1PT">JSONP:JAVADOC:21</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + boolean + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a JsonValue#TRUE or JsonValue#FALSE value to the array.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:25"></a><font size="1PT">JSONP:JAVADOC:25</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.addNull<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Adds a JsonValue#NULL value to the array.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:37"></a><font size="1PT">JSONP:JAVADOC:37</font></TD><TD align="center" valign="center"><font size="1PT">JsonException</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonException.JsonException<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Constructs a new runtime exception with the specified detail message. The cause is not initialized, and may subsequently be initialized by a call to #initCause.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:38"></a><font size="1PT">JSONP:JAVADOC:38</font></TD><TD align="center" valign="center"><font size="1PT">JsonException</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonException.JsonException<br> + + ( + String + ,<br>Throwable + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Constructs a new runtime exception with the specified detail message and cause. Note that the detail message associated with cause is not automatically incorporated in this runtime exception's detail message.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:40"></a><font size="1PT">JSONP:JAVADOC:40</font></TD><TD align="center" valign="center"><font size="1PT">BigDecimal</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonNumber.bigDecimalValue<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns this JSON number as a BigDecimal object.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:41"></a><font size="1PT">JSONP:JAVADOC:41</font></TD><TD align="center" valign="center"><font size="1PT">BigInteger</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonNumber.bigIntegerValue<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns this JSON number as a BigInteger object. This is a a convenience method for bigDecimalValue().toBigInteger(). Note that this conversion can lose information about the overall magnitude and precision of the number value as well as return a result with the opposite sign.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:42"></a><font size="1PT">JSONP:JAVADOC:42</font></TD><TD align="center" valign="center"><font size="1PT">BigInteger</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonNumber.bigIntegerValueExact<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns this JSON number as a BigInteger object. This is a convenience method for bigDecimalValue().toBigIntegerExact().</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:44"></a><font size="1PT">JSONP:JAVADOC:44</font></TD><TD align="center" valign="center"><font size="1PT">double</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonNumber.doubleValue<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns this JSON number as a double. This is a a convenience method for bigDecimalValue().doubleValue(). Note that this conversion can lose information about the overall magnitude and precision of the number value as well as return a result with the opposite sign.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:45"></a><font size="1PT">JSONP:JAVADOC:45</font></TD><TD align="center" valign="center"><font size="1PT">int</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonNumber.intValue<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns this JSON number as an int. Note that this conversion can lose information about the overall magnitude and precision of the number value as well as return a result with the opposite sign.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:46"></a><font size="1PT">JSONP:JAVADOC:46</font></TD><TD align="center" valign="center"><font size="1PT">int</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonNumber.intValueExact<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns this JSON number as an int.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:48"></a><font size="1PT">JSONP:JAVADOC:48</font></TD><TD align="center" valign="center"><font size="1PT">long</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonNumber.longValue<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns this JSON number as a long. Note that this conversion can lose information about the overall magnitude and precision of the number value as well as return a result with the opposite sign.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:49"></a><font size="1PT">JSONP:JAVADOC:49</font></TD><TD align="center" valign="center"><font size="1PT">long</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonNumber.longValueExact<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns this JSON number as a long.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:51"></a><font size="1PT">JSONP:JAVADOC:51</font></TD><TD align="center" valign="center"><font size="1PT">boolean</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonNumber.isIntegral<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns true if this JSON number is a integral number. This method semantics are defined using bigDecimalValue().scale(). If the scale is zero, then it is considered integral type. This integral type information can be used to invoke an appropriate accessor method to obtain a numeric value as in the following example: JsonNumber num = ... if (num.isIntegral()) { num.longValue(); // or other methods to get integral value } else { num.doubleValue(); // or other methods to get decimal number value }</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:58"></a><font size="1PT">JSONP:JAVADOC:58</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObjectBuilder.add<br> + + ( + String + ,<br>JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a name/JsonValue pair to the JSON object associated with this object builder. If the object contains a mapping for the specified name, this method replaces the old value with the specified value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:61"></a><font size="1PT">JSONP:JAVADOC:61</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObjectBuilder.add<br> + + ( + String + ,<br>String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a name/JsonString pair to the JSON object associated with this object builder. If the object contains a mapping for the specified name, this method replaces the old value with the specified value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:64"></a><font size="1PT">JSONP:JAVADOC:64</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObjectBuilder.add<br> + + ( + String + ,<br>BigInteger + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a name/JsonNumber pair to the JSON object associated with this object builder. If the object contains a mapping for the specified name, this method replaces the old value with the specified value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:67"></a><font size="1PT">JSONP:JAVADOC:67</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObjectBuilder.add<br> + + ( + String + ,<br>BigDecimal + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a name/JsonNumber pair to the JSON object associated with this object builder. If the object contains a mapping for the specified name, this method replaces the old value with the specified value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:70"></a><font size="1PT">JSONP:JAVADOC:70</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObjectBuilder.add<br> + + ( + String + ,<br>int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a name/JsonNumber pair to the JSON object associated with this object builder. If the object contains a mapping for the specified name, this method replaces the old value with the specified value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:73"></a><font size="1PT">JSONP:JAVADOC:73</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObjectBuilder.add<br> + + ( + String + ,<br>long + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a name/JsonNumber pair to the JSON object associated with this object builder. If the object contains a mapping for the specified name, this method replaces the old value with the specified value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:76"></a><font size="1PT">JSONP:JAVADOC:76</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObjectBuilder.add<br> + + ( + String + ,<br>double + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a name/JsonNumber pair to the JSON object associated with this object builder. If the object contains a mapping for the specified name, this method replaces the old value with the specified value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:80"></a><font size="1PT">JSONP:JAVADOC:80</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObjectBuilder.add<br> + + ( + String + ,<br>boolean + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a name/JsonValue#TRUE or name/JsonValue#FALSE pair to the JSON object associated with this object builder. If the object contains a mapping for the specified name, this method replaces the old value with the specified value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:86"></a><font size="1PT">JSONP:JAVADOC:86</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObjectBuilder.addNull<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a name/JsonValue#NULL pair to the JSON object associated with this object builder where the value is null. If the object contains a mapping for the specified name, this method replaces the old value with null.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:96"></a><font size="1PT">JSONP:JAVADOC:96</font></TD><TD align="center" valign="center"><font size="1PT">void</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonReader.close<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Closes this reader and frees any resources associated with the reader. This method closes the underlying input source.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:97"></a><font size="1PT">JSONP:JAVADOC:97</font></TD><TD align="center" valign="center"><font size="1PT">JsonReader</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createReader<br> + + ( + Reader + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON reader from a character stream.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:101"></a><font size="1PT">JSONP:JAVADOC:101</font></TD><TD align="center" valign="center"><font size="1PT">String</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonString.getString<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns the JSON string value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:102"></a><font size="1PT">JSONP:JAVADOC:102</font></TD><TD align="center" valign="center"><font size="1PT">ValueType</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonValue.getValueType<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns the value type of this JSON value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:103"></a><font size="1PT">JSONP:JAVADOC:103</font></TD><TD align="center" valign="center"><font size="1PT">ValueType</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonValue.ValueType.valueOf<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:104"></a><font size="1PT">JSONP:JAVADOC:104</font></TD><TD align="center" valign="center"><font size="1PT">ValueType[]</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonValue.ValueType.values<br> +</font></TD><TD align="left" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:105"></a><font size="1PT">JSONP:JAVADOC:105</font></TD><TD align="center" valign="center"><font size="1PT">void</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonWriter.close<br> +</font></TD><TD align="left" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:106"></a><font size="1PT">JSONP:JAVADOC:106</font></TD><TD align="center" valign="center"><font size="1PT">JsonWriter</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createWriter<br> + + ( + Writer + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON writer to write a JSON JsonObject object or JsonArray array structure to the specified character stream.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:107"></a><font size="1PT">JSONP:JAVADOC:107</font></TD><TD align="center" valign="center"><font size="1PT">void</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonWriter.writeArray<br> + + ( + JsonArray + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes the specified JSON JsonArray array to the output source. This method needs to be called only once for a writer instance.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:110"></a><font size="1PT">JSONP:JAVADOC:110</font></TD><TD align="center" valign="center"><font size="1PT">void</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonWriter.writeObject<br> + + ( + JsonObject + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes the specified JSON JsonObject object to the output source. This method needs to be called only once for a writer instance.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:115"></a><font size="1PT">JSONP:JAVADOC:115</font></TD><TD align="center" valign="center"><font size="1PT">void</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.close<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Closes this generator and frees any resources associated with it. This method closes the underlying output source.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:117"></a><font size="1PT">JSONP:JAVADOC:117</font></TD><TD align="center" valign="center"><font size="1PT">void</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.close<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Closes this parser and frees any resources associated with the parser. This method closes the underlying input source.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:120"></a><font size="1PT">JSONP:JAVADOC:120</font></TD><TD align="center" valign="center"><font size="1PT">boolean</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.isIntegralNumber<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns true if the JSON number at the current parser state is a integral number. A BigDecimal may be used to store the value internally and this method semantics are defined using its scale(). If the scale is zero, then it is considered integral type. This integral type information can be used to invoke an appropriate accessor method to obtain a numeric value as in the following example: JsonParser parser = ... if (parser.isIntegralNumber()) { parser.getInt(); // or other methods to get integral value } else { parser.getBigDecimal(); }</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:122"></a><font size="1PT">JSONP:JAVADOC:122</font></TD><TD align="center" valign="center"><font size="1PT">String</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.getString<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a String for the name in a name/value pair, for a string value or a number value. This method should only be called when the parser state is Event#KEY_NAME, Event#VALUE_STRING, or Event#VALUE_NUMBER.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:128"></a><font size="1PT">JSONP:JAVADOC:128</font></TD><TD align="center" valign="center"><font size="1PT">Event</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.Event.valueOf<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:129"></a><font size="1PT">JSONP:JAVADOC:129</font></TD><TD align="center" valign="center"><font size="1PT">Event[]</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.Event.values<br> +</font></TD><TD align="left" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:131"></a><font size="1PT">JSONP:JAVADOC:131</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createGenerator<br> + + ( + Writer + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON generator for writing JSON to a character stream.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:133"></a><font size="1PT">JSONP:JAVADOC:133</font></TD><TD align="center" valign="center"><font size="1PT">JsonParser</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createParser<br> + + ( + Reader + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON parser from a character stream.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:144"></a><font size="1PT">JSONP:JAVADOC:144</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createGenerator<br> + + ( + Writer + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON generator for writing JSON text to a character stream.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:146"></a><font size="1PT">JSONP:JAVADOC:146</font></TD><TD align="center" valign="center"><font size="1PT">JsonParser</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createParser<br> + + ( + Reader + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON parser from a character stream.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:152"></a><font size="1PT">JSONP:JAVADOC:152</font></TD><TD align="center" valign="center"><font size="1PT">JsonProvider</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.provider<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON provider object. The provider is loaded using the ServiceLoader#load(Class) method. If there are no available service providers, this method returns the default service provider. Users are recommended to cache the result of this method.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:162"></a><font size="1PT">JSONP:JAVADOC:162</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGeneratorFactory.createGenerator<br> + + ( + Writer + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON generator to write JSON text to a character stream. The generator is configured with the factory configuration.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:163"></a><font size="1PT">JSONP:JAVADOC:163</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGeneratorFactory.createGenerator<br> + + ( + OutputStream + ,<br>Charset + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON generator to write JSON text to a byte stream. Characters written to the stream are encoded into bytes using the specified charset. The generator is configured with the factory's configuration.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:164"></a><font size="1PT">JSONP:JAVADOC:164</font></TD><TD align="center" valign="center"><font size="1PT">JsonParser</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParserFactory.createParser<br> + + ( + Reader + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON parser from a character stream.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:165"></a><font size="1PT">JSONP:JAVADOC:165</font></TD><TD align="center" valign="center"><font size="1PT">JsonParser</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParserFactory.createParser<br> + + ( + InputStream + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON parser from the specified byte stream. The character encoding of the stream is determined as specified in RFC 7159.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:166"></a><font size="1PT">JSONP:JAVADOC:166</font></TD><TD align="center" valign="center"><font size="1PT">JsonParser</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParserFactory.createParser<br> + + ( + JsonObject + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON parser from the specified JSON object.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:167"></a><font size="1PT">JSONP:JAVADOC:167</font></TD><TD align="center" valign="center"><font size="1PT">JsonParser</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParserFactory.createParser<br> + + ( + JsonArray + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON parser from the specified JSON array.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:168"></a><font size="1PT">JSONP:JAVADOC:168</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createGenerator<br> + + ( + OutputStream + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON generator for writing JSON to a byte stream.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:172"></a><font size="1PT">JSONP:JAVADOC:172</font></TD><TD align="center" valign="center"><font size="1PT">JsonParser</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createParser<br> + + ( + InputStream + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON parser from a byte stream. The character encoding of the stream is determined as specified in RFC 7159.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:178"></a><font size="1PT">JSONP:JAVADOC:178</font></TD><TD align="center" valign="center"><font size="1PT">JsonReader</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createReader<br> + + ( + InputStream + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON reader from a byte stream. The character encoding of the stream is determined as described in RFC 7159.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:181"></a><font size="1PT">JSONP:JAVADOC:181</font></TD><TD align="center" valign="center"><font size="1PT">JsonStructure</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonReader.read<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a JSON array or object that is represented in the input source. This method needs to be called only once for a reader instance.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:184"></a><font size="1PT">JSONP:JAVADOC:184</font></TD><TD align="center" valign="center"><font size="1PT">JsonArray</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonReader.readArray<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a JSON array that is represented in the input source. This method needs to be called only once for a reader instance.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:185"></a><font size="1PT">JSONP:JAVADOC:185</font></TD><TD align="center" valign="center"><font size="1PT">JsonObject</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonReader.readObject<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a JSON object that is represented in the input source. This method needs to be called only once for a reader instance.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:187"></a><font size="1PT">JSONP:JAVADOC:187</font></TD><TD align="center" valign="center"><font size="1PT">JsonWriter</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createWriter<br> + + ( + OutputStream + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON writer to write a JSON JsonObject object or JsonArray array structure to the specified byte stream. Characters written to the stream are encoded into bytes using UTF-8 encoding.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:191"></a><font size="1PT">JSONP:JAVADOC:191</font></TD><TD align="center" valign="center"><font size="1PT">void</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonWriter.write<br> + + ( + JsonStructure + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes the specified JSON JsonObject object or JsonArray array to the output source. This method needs to be called only once for a writer instance.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:192"></a><font size="1PT">JSONP:JAVADOC:192</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createGenerator<br> + + ( + OutputStream + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON generator for writing JSON text to a byte stream.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:196"></a><font size="1PT">JSONP:JAVADOC:196</font></TD><TD align="center" valign="center"><font size="1PT">JsonParser</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createParser<br> + + ( + InputStream + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON parser from the specified byte stream. The character encoding of the stream is determined as defined in RFC 7159 .</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:200"></a><font size="1PT">JSONP:JAVADOC:200</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGeneratorFactory.createGenerator<br> + + ( + OutputStream + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON generator to write JSON text to a byte stream. Characters written to the stream are encoded into bytes using UTF-8 encoding. The generator is configured with the factory's configuration.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:201"></a><font size="1PT">JSONP:JAVADOC:201</font></TD><TD align="center" valign="center"><font size="1PT">JsonParser</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParserFactory.createParser<br> + + ( + InputStream + ,<br>Charset + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON parser from the specified byte stream. The bytes of the stream are decoded to characters using the specified charset.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:215"></a><font size="1PT">JSONP:JAVADOC:215</font></TD><TD align="center" valign="center"><font size="1PT">String</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonNumber.toString<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a JSON text representation of the JSON number. The representation is equivalent to BigDecimal#toString().</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:235"></a><font size="1PT">JSONP:JAVADOC:235</font></TD><TD align="center" valign="center"><font size="1PT">BigDecimal</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.getBigDecimal<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a JSON number as a BigDecimal. The BigDecimal is created using new BigDecimal(getString()). This method should only called when the parser state is Event#VALUE_NUMBER.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:237"></a><font size="1PT">JSONP:JAVADOC:237</font></TD><TD align="center" valign="center"><font size="1PT">int</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.getInt<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a JSON number as an integer. The returned value is equal to new BigDecimal(getString()).intValue(). Note that this conversion can lose information about the overall magnitude and precision of the number value as well as return a result with the opposite sign. This method should only be called when the parser state is Event#VALUE_NUMBER.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:239"></a><font size="1PT">JSONP:JAVADOC:239</font></TD><TD align="center" valign="center"><font size="1PT">long</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.getLong<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a JSON number as a long. The returned value is equal to new BigDecimal(getString()).longValue(). Note that this conversion can lose information about the overall magnitude and precision of the number value as well as return a result with the opposite sign. This method is only called when the parser state is Event#VALUE_NUMBER.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:250"></a><font size="1PT">JSONP:JAVADOC:250</font></TD><TD align="center" valign="center"><font size="1PT">boolean</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonNumber.equals<br> + + ( + Object + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Compares the specified object with this JsonNumber object for equality. Returns true if and only if the type of the specified object is also JsonNumber and their #bigDecimalValue() objects are equal</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:251"></a><font size="1PT">JSONP:JAVADOC:251</font></TD><TD align="center" valign="center"><font size="1PT">int</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonNumber.hashCode<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns the hash code value for this JsonNumber object. The hash code of a JsonNumber object is defined as the hash code of its #bigDecimalValue() object.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:254"></a><font size="1PT">JSONP:JAVADOC:254</font></TD><TD align="center" valign="center"><font size="1PT">boolean</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonString.equals<br> + + ( + Object + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Compares the specified object with this JsonString for equality. Returns true if and only if the specified object is also a JsonString, and their #getString() objects are equal.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:255"></a><font size="1PT">JSONP:JAVADOC:255</font></TD><TD align="center" valign="center"><font size="1PT">int</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonString.hashCode<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns the hash code value for this JsonString object. The hash code of a JsonString object is defined to be its #getString() object's hash code.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:262"></a><font size="1PT">JSONP:JAVADOC:262</font></TD><TD align="center" valign="center"><font size="1PT">int</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArray.getInt<br> + + ( + int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">A convenience method for getJsonNumber(index).intValue().</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:263"></a><font size="1PT">JSONP:JAVADOC:263</font></TD><TD align="center" valign="center"><font size="1PT">String</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArray.getString<br> + + ( + int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">A convenience method for getJsonString(index).getString().</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:264"></a><font size="1PT">JSONP:JAVADOC:264</font></TD><TD align="center" valign="center"><font size="1PT">int</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObject.getInt<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">A convenience method for getJsonNumber(name).intValue()</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:265"></a><font size="1PT">JSONP:JAVADOC:265</font></TD><TD align="center" valign="center"><font size="1PT">String</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObject.getString<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">A convenience method for getJsonString(name).getString()</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:278"></a><font size="1PT">JSONP:JAVADOC:278</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerationException</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerationException.JsonGenerationException<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Constructs a new runtime exception with the specified detail message. The cause is not initialized, and may subsequently be initialized by a call to #initCause.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:279"></a><font size="1PT">JSONP:JAVADOC:279</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerationException</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerationException.JsonGenerationException<br> + + ( + String + ,<br>Throwable + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Constructs a new runtime exception with the specified detail message and cause. Note that the detail message associated with cause is not automatically incorporated in this runtime exception's detail message.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:285"></a><font size="1PT">JSONP:JAVADOC:285</font></TD><TD align="center" valign="center"><font size="1PT">JsonParsingException</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParsingException.JsonParsingException<br> + + ( + String + ,<br>JsonLocation + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Constructs a new runtime exception with the specified detail message. The cause is not initialized, and may subsequently be initialized by a call to #initCause.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:286"></a><font size="1PT">JSONP:JAVADOC:286</font></TD><TD align="center" valign="center"><font size="1PT">JsonParsingException</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParsingException.JsonParsingException<br> + + ( + String + ,<br>Throwable + ,<br>JsonLocation + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Constructs a new runtime exception with the specified detail message and cause. Note that the detail message associated with cause is not automatically incorporated in this runtime exception's detail message.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:288"></a><font size="1PT">JSONP:JAVADOC:288</font></TD><TD align="center" valign="center"><font size="1PT">String</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonValue.toString<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns JSON text for this JSON value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:289"></a><font size="1PT">JSONP:JAVADOC:289</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.writeEnd<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Writes the end of the current context. If the current context is an array context, this method writes the end-of-array character (']'). If the current context is an object context, this method writes the end-of-object character ('}'). After writing the end of the current context, the parent context becomes the new current context. If parent context is field context, it is closed.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:291"></a><font size="1PT">JSONP:JAVADOC:291</font></TD><TD align="center" valign="center"><font size="1PT">void</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.flush<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Flushes the underlying output source. If the generator has saved any characters in a buffer, writes them immediately to the underlying output source before flushing it.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:292"></a><font size="1PT">JSONP:JAVADOC:292</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + String + ,<br>JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes a JSON name/value pair in the current object context.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:295"></a><font size="1PT">JSONP:JAVADOC:295</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + String + ,<br>String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes a JSON name/string value pair in the current object context. The specified value is written as JSON string value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:298"></a><font size="1PT">JSONP:JAVADOC:298</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + String + ,<br>BigInteger + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes a JSON name/number value pair in the current object context. The specified value is written as a JSON number value. The string new BigDecimal(value).toString() is used as the text value for writing.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:301"></a><font size="1PT">JSONP:JAVADOC:301</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + String + ,<br>BigDecimal + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes a JSON name/number value pair in the current object context. The specified value is written as a JSON number value. The specified value's toString() is used as the text value for writing.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:304"></a><font size="1PT">JSONP:JAVADOC:304</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + String + ,<br>int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes a JSON name/number value pair in the current object context. The specified value is written as a JSON number value. The string new BigDecimal(value).toString() is used as the text value for writing.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:307"></a><font size="1PT">JSONP:JAVADOC:307</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + String + ,<br>long + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes a JSON name/number value pair in the current object context. The specified value is written as a JSON number value. The string new BigDecimal(value).toString() is used as the text value for writing.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:310"></a><font size="1PT">JSONP:JAVADOC:310</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + String + ,<br>double + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes a JSON name/number value pair in the current object context. The specified value is written as a JSON number value. The string BigDecimal.valueOf(double).toString() is used as the text value for writing.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:314"></a><font size="1PT">JSONP:JAVADOC:314</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + String + ,<br>boolean + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes a JSON name/boolean value pair in the current object context. If value is true, it writes the JSON true value, otherwise it writes the JSON false value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:317"></a><font size="1PT">JSONP:JAVADOC:317</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes the specified value as a JSON value within the current array, field or root context.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:319"></a><font size="1PT">JSONP:JAVADOC:319</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes the specified value as a JSON string value within the current array, field or root context.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:321"></a><font size="1PT">JSONP:JAVADOC:321</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + BigDecimal + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes the specified value as a JSON number value within the current array, field or root context. The specified value's toString() is used as the the text value for writing.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:323"></a><font size="1PT">JSONP:JAVADOC:323</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + BigInteger + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes the specified value as a JSON number value within the current array, field or root context. The string new BigDecimal(value).toString() is used as the text value for writing.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:325"></a><font size="1PT">JSONP:JAVADOC:325</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes the specified value as a JSON number value within the current array, field or root context. The string new BigDecimal(value).toString() is used as the text value for writing.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:327"></a><font size="1PT">JSONP:JAVADOC:327</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + long + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes the specified value as a JSON number value within the current array, field or root context. The string new BigDecimal(value).toString() is used as the text value for writing.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:329"></a><font size="1PT">JSONP:JAVADOC:329</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + double + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes the specified value as a JSON number value within the current array, field or root context. The string BigDecimal.valueOf(value).toString() is used as the text value for writing.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:332"></a><font size="1PT">JSONP:JAVADOC:332</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.write<br> + + ( + boolean + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes a JSON true or false value within the current array, field or root context. If value is true, this method writes the JSON true value, otherwise it writes the JSON false value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:334"></a><font size="1PT">JSONP:JAVADOC:334</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.writeNull<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes a JSON name/null value pair in an current object context.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:337"></a><font size="1PT">JSONP:JAVADOC:337</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.writeNull<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Writes a JSON null value within the current array, field or root context.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:339"></a><font size="1PT">JSONP:JAVADOC:339</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.writeStartArray<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Writes the JSON start array character. It starts a new child array context within which JSON values can be written to the array. This method is valid only in an array context, field context or in no context (when a context is not yet started). This method can only be called once in no context.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:340"></a><font size="1PT">JSONP:JAVADOC:340</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.writeStartArray<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes the JSON name/start array character pair with in the current object context. It starts a new child array context within which JSON values can be written to the array.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:341"></a><font size="1PT">JSONP:JAVADOC:341</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.writeStartObject<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Writes the JSON start object character. It starts a new child object context within which JSON name/value pairs can be written to the object. This method is valid only in an array context, field context or in no context (when a context is not yet started). This method can only be called once in no context.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:342"></a><font size="1PT">JSONP:JAVADOC:342</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.writeStartObject<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes the JSON name/start object character pair in the current object context. It starts a new child object context within which JSON name/value pairs can be written to the object.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:375"></a><font size="1PT">JSONP:JAVADOC:375</font></TD><TD align="center" valign="center"><font size="1PT">boolean</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.hasNext<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns true if there are more parsing states. This method returns false if the parser reaches the end of the JSON text.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:376"></a><font size="1PT">JSONP:JAVADOC:376</font></TD><TD align="center" valign="center"><font size="1PT">Event</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.next<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns the event for the next parsing state.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:383"></a><font size="1PT">JSONP:JAVADOC:383</font></TD><TD align="center" valign="center"><font size="1PT">CharSequence</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonString.getChars<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns the char sequence for the JSON String value</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:400"></a><font size="1PT">JSONP:JAVADOC:400</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + JsonObjectBuilder + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a JsonObject from an object builder to the array.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:401"></a><font size="1PT">JSONP:JAVADOC:401</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + JsonArrayBuilder + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a JsonArray from an array builder to the array.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:402"></a><font size="1PT">JSONP:JAVADOC:402</font></TD><TD align="center" valign="center"><font size="1PT">JsonArray</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.build<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns the current array.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:403"></a><font size="1PT">JSONP:JAVADOC:403</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createArrayBuilder<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON array builder</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:404"></a><font size="1PT">JSONP:JAVADOC:404</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObjectBuilder.add<br> + + ( + String + ,<br>JsonObjectBuilder + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a name/JsonObject pair to the JSON object associated with this object builder. The value JsonObject is built from the specified object builder. If the object contains a mapping for the specified name, this method replaces the old value with the JsonObject from the specified object builder.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:406"></a><font size="1PT">JSONP:JAVADOC:406</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObjectBuilder.add<br> + + ( + String + ,<br>JsonArrayBuilder + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a name/JsonArray pair to the JSON object associated with this object builder. The value JsonArray is built from the specified array builder. If the object contains a mapping for the specified name, this method replaces the old value with the JsonArray from the specified array builder.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:408"></a><font size="1PT">JSONP:JAVADOC:408</font></TD><TD align="center" valign="center"><font size="1PT">JsonObject</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObjectBuilder.build<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns the JSON object associated with this object builder. The iteration order for the JsonObject is based on the order in which name/value pairs are added to the object using this builder.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:409"></a><font size="1PT">JSONP:JAVADOC:409</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createObjectBuilder<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON object builder</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:416"></a><font size="1PT">JSONP:JAVADOC:416</font></TD><TD align="center" valign="center"><font size="1PT">JsonGeneratorFactory</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createGeneratorFactory<br> + + ( + Map + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a generator factory for creating JsonGenerator objects. The factory is configured with the specified map of provider specific configuration properties. Provider implementations should ignore any unsupported configuration properties specified in the map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:417"></a><font size="1PT">JSONP:JAVADOC:417</font></TD><TD align="center" valign="center"><font size="1PT">JsonParserFactory</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createParserFactory<br> + + ( + Map + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a parser factory for creating JsonParser objects. The factory is configured with the specified map of provider specific configuration properties. Provider implementations should ignore any unsupported configuration properties specified in the map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:419"></a><font size="1PT">JSONP:JAVADOC:419</font></TD><TD align="center" valign="center"><font size="1PT">JsonReader</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonReaderFactory.createReader<br> + + ( + Reader + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON reader from a character stream. The reader is configured with the factory configuration.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:420"></a><font size="1PT">JSONP:JAVADOC:420</font></TD><TD align="center" valign="center"><font size="1PT">JsonReader</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonReaderFactory.createReader<br> + + ( + InputStream + ,<br>Charset + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON reader from a byte stream. The bytes of the stream are decoded to characters using the specified charset. The reader is configured with the factory configuration.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:422"></a><font size="1PT">JSONP:JAVADOC:422</font></TD><TD align="center" valign="center"><font size="1PT">JsonWriter</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonWriterFactory.createWriter<br> + + ( + Writer + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON writer to write a JSON JsonObject object or JsonArray array structure to the specified character stream. The writer is configured with the factory configuration.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:423"></a><font size="1PT">JSONP:JAVADOC:423</font></TD><TD align="center" valign="center"><font size="1PT">JsonWriter</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonWriterFactory.createWriter<br> + + ( + OutputStream + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON writer to write a JSON JsonObject object or JsonArray array structure to the specified byte stream. Characters written to the stream are encoded into bytes using UTF-8 encoding. The writer is configured with the factory configuration.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:424"></a><font size="1PT">JSONP:JAVADOC:424</font></TD><TD align="center" valign="center"><font size="1PT">JsonWriter</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonWriterFactory.createWriter<br> + + ( + OutputStream + ,<br>Charset + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON writer to write a JSON JsonObject object or JsonArray array structure to the specified byte stream. Characters written to the stream are encoded into bytes using the specified charset. The writer is configured with the factory configuration.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:425"></a><font size="1PT">JSONP:JAVADOC:425</font></TD><TD align="center" valign="center"><font size="1PT">JsonGeneratorFactory</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createGeneratorFactory<br> + + ( + Map + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a generator factory for creating JsonGenerator instances. The factory is configured with the specified map of provider specific configuration properties. Provider implementations should ignore any unsupported configuration properties specified in the map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:426"></a><font size="1PT">JSONP:JAVADOC:426</font></TD><TD align="center" valign="center"><font size="1PT">JsonParserFactory</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createParserFactory<br> + + ( + Map + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a parser factory for creating JsonParser instances. The factory is configured with the specified map of provider specific configuration properties. Provider implementations should ignore any unsupported configuration properties specified in the map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:427"></a><font size="1PT">JSONP:JAVADOC:427</font></TD><TD align="center" valign="center"><font size="1PT">Map</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGeneratorFactory.getConfigInUse<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a read-only map of supported provider specific configuration properties that are used to configure the JSON generators. If there are any specified configuration properties that are not supported by the provider, they won't be part of the returned map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:428"></a><font size="1PT">JSONP:JAVADOC:428</font></TD><TD align="center" valign="center"><font size="1PT">Map</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParserFactory.getConfigInUse<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a read-only map of supported provider specific configuration properties that are used to configure the JSON parsers. If there are any specified configuration properties that are not supported by the provider, they won't be part of the returned map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:429"></a><font size="1PT">JSONP:JAVADOC:429</font></TD><TD align="center" valign="center"><font size="1PT">JsonReader</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonReaderFactory.createReader<br> + + ( + InputStream + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON reader from a byte stream. The character encoding of the stream is determined as described in RFC 7159. The reader is configured with the factory configuration.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:430"></a><font size="1PT">JSONP:JAVADOC:430</font></TD><TD align="center" valign="center"><font size="1PT">boolean</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArray.getBoolean<br> + + ( + int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the boolean value at the specified position. If the value at the specified position is JsonValue.TRUE this method returns true. If the value at the specified position is JsonValue.FALSE this method returns false.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:433"></a><font size="1PT">JSONP:JAVADOC:433</font></TD><TD align="center" valign="center"><font size="1PT">boolean</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArray.getBoolean<br> + + ( + int + ,<br>boolean + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the boolean value at the specified position. If the value at the specified position is JsonValue.TRUE this method returns true. If the value at the specified position is JsonValue.FALSE this method returns false. Otherwise this method returns the specified default value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:434"></a><font size="1PT">JSONP:JAVADOC:434</font></TD><TD align="center" valign="center"><font size="1PT">int</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArray.getInt<br> + + ( + int + ,<br>int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the int value of the JsonNumber at the specified position. If the value at that position is a JsonNumber, this method returns jakarta.json.JsonNumber#intValue(). Otherwise this method returns the specified default value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:435"></a><font size="1PT">JSONP:JAVADOC:435</font></TD><TD align="center" valign="center"><font size="1PT">String</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArray.getString<br> + + ( + int + ,<br>String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the String value of JsonString at the specified position in this JSON array values. If JsonString is found, its jakarta.json.JsonString#getString() is returned. Otherwise, the specified default value is returned.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:436"></a><font size="1PT">JSONP:JAVADOC:436</font></TD><TD align="center" valign="center"><font size="1PT">boolean</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObject.getBoolean<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the boolean value of the associated mapping for the specified name. If the associated mapping is JsonValue.TRUE, then returns true. If the associated mapping is JsonValue.FALSE, then returns false.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:439"></a><font size="1PT">JSONP:JAVADOC:439</font></TD><TD align="center" valign="center"><font size="1PT">boolean</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObject.getBoolean<br> + + ( + String + ,<br>boolean + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the boolean value of the associated mapping for the specified name. If the associated mapping is JsonValue.TRUE, then returns true. If the associated mapping is JsonValue.FALSE, then returns false. Otherwise, the specified default value is returned.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:441"></a><font size="1PT">JSONP:JAVADOC:441</font></TD><TD align="center" valign="center"><font size="1PT">int</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObject.getInt<br> + + ( + String + ,<br>int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the int value of the associated JsonNumber mapping for the specified name. If JsonNumber is found, then its jakarta.json.JsonNumber#intValue() is returned. Otherwise, the specified default value is returned.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:443"></a><font size="1PT">JSONP:JAVADOC:443</font></TD><TD align="center" valign="center"><font size="1PT">String</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObject.getString<br> + + ( + String + ,<br>String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the string value of the associated JsonString mapping for the specified name. If JsonString is found, then its jakarta.json.JsonString#getString() is returned. Otherwise, the specified default value is returned.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:445"></a><font size="1PT">JSONP:JAVADOC:445</font></TD><TD align="center" valign="center"><font size="1PT">JsonBuilderFactory</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createBuilderFactory<br> + + ( + Map + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a builder factory for creating JsonArrayBuilder and JsonObjectBuilder objects. The factory is configured with the specified map of provider specific configuration properties. Provider implementations should ignore any unsupported configuration properties specified in the map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:449"></a><font size="1PT">JSONP:JAVADOC:449</font></TD><TD align="center" valign="center"><font size="1PT">JsonReaderFactory</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createReaderFactory<br> + + ( + Map + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a reader factory for creating JsonReader objects. The factory is configured with the specified map of provider specific configuration properties. Provider implementations should ignore any unsupported configuration properties specified in the map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:452"></a><font size="1PT">JSONP:JAVADOC:452</font></TD><TD align="center" valign="center"><font size="1PT">JsonWriterFactory</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createWriterFactory<br> + + ( + Map + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a writer factory for creating JsonWriter objects. The factory is configured with the specified map of provider specific configuration properties. Provider implementations should ignore any unsupported configuration properties specified in the map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:453"></a><font size="1PT">JSONP:JAVADOC:453</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonBuilderFactory.createArrayBuilder<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonArrayBuilder instance that is used to build JsonArray</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:454"></a><font size="1PT">JSONP:JAVADOC:454</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonBuilderFactory.createObjectBuilder<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonObjectBuilder instance that is used to build JsonObject.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:455"></a><font size="1PT">JSONP:JAVADOC:455</font></TD><TD align="center" valign="center"><font size="1PT">Map</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonBuilderFactory.getConfigInUse<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns read-only map of supported provider specific configuration properties that are used to configure the created JSON builders. If there are any specified configuration properties that are not supported by the provider, they won't be part of the returned map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:459"></a><font size="1PT">JSONP:JAVADOC:459</font></TD><TD align="center" valign="center"><font size="1PT">Map</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonReaderFactory.getConfigInUse<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns read-only map of supported provider specific configuration properties that are used to configure the created JSON readers. If there are any specified configuration properties that are not supported by the provider, they won't be part of the returned map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:463"></a><font size="1PT">JSONP:JAVADOC:463</font></TD><TD align="center" valign="center"><font size="1PT">Map</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonWriterFactory.getConfigInUse<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns read-only map of supported provider specific configuration properties that are used to configure the created JSON writer objects. If there are any specified configuration properties that are not supported by the provider, they won't be part of the returned map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:464"></a><font size="1PT">JSONP:JAVADOC:464</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createArrayBuilder<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON array builder.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:465"></a><font size="1PT">JSONP:JAVADOC:465</font></TD><TD align="center" valign="center"><font size="1PT">JsonBuilderFactory</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createBuilderFactory<br> + + ( + Map + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a builder factory for creating JsonArrayBuilder and JsonObjectBuilder objects. The factory is configured with the specified map of provider specific configuration properties. Provider implementations should ignore any unsupported configuration properties specified in the map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:466"></a><font size="1PT">JSONP:JAVADOC:466</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createObjectBuilder<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON object builder.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:467"></a><font size="1PT">JSONP:JAVADOC:467</font></TD><TD align="center" valign="center"><font size="1PT">JsonReader</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createReader<br> + + ( + Reader + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON reader from a character stream.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:468"></a><font size="1PT">JSONP:JAVADOC:468</font></TD><TD align="center" valign="center"><font size="1PT">JsonReader</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createReader<br> + + ( + InputStream + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON reader from a byte stream. The character encoding of the stream is determined as described in RFC 7159.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:469"></a><font size="1PT">JSONP:JAVADOC:469</font></TD><TD align="center" valign="center"><font size="1PT">JsonReaderFactory</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createReaderFactory<br> + + ( + Map + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a reader factory for creating JsonReader objects. The factory is configured with the specified map of provider specific configuration properties. Provider implementations should ignore any unsupported configuration properties specified in the map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:470"></a><font size="1PT">JSONP:JAVADOC:470</font></TD><TD align="center" valign="center"><font size="1PT">JsonWriter</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createWriter<br> + + ( + Writer + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON writer to write a JSON JsonObject object or JsonArray array structure to the specified character stream.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:471"></a><font size="1PT">JSONP:JAVADOC:471</font></TD><TD align="center" valign="center"><font size="1PT">JsonWriter</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createWriter<br> + + ( + OutputStream + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON writer to write a JSON JsonObject object or JsonArray array structure to the specified byte stream. Characters written to the stream are encoded into bytes using UTF-8 encoding.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:472"></a><font size="1PT">JSONP:JAVADOC:472</font></TD><TD align="center" valign="center"><font size="1PT">JsonWriterFactory</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createWriterFactory<br> + + ( + Map + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a writer factory for creating JsonWriter objects. The factory is configured with the specified map of provider specific configuration properties. Provider implementations should ignore any unsupported configuration properties specified in the map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:474"></a><font size="1PT">JSONP:JAVADOC:474</font></TD><TD align="center" valign="center"><font size="1PT">long</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonLocation.getColumnNumber<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Return the column number (starts with 1 for the first column) for the current JSON event in the input source.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:475"></a><font size="1PT">JSONP:JAVADOC:475</font></TD><TD align="center" valign="center"><font size="1PT">long</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonLocation.getLineNumber<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Return the line number (starts with 1 for the first line) for the current JSON event in the input source.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:476"></a><font size="1PT">JSONP:JAVADOC:476</font></TD><TD align="center" valign="center"><font size="1PT">long</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonLocation.getStreamOffset<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Return the stream offset into the input source this location is pointing to. If the input source is a file or a byte stream then this is the byte offset into that stream, but if the input source is a character media then the offset is the character offset. Returns -1 if there is no offset available.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:477"></a><font size="1PT">JSONP:JAVADOC:477</font></TD><TD align="center" valign="center"><font size="1PT">JsonLocation</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.getLocation<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Return the location that corresponds to the parser's current state in the JSON input source. The location information is only valid in the current parser state (or until the parser is advanced to a next state).</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:478"></a><font size="1PT">JSONP:JAVADOC:478</font></TD><TD align="center" valign="center"><font size="1PT">JsonLocation</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParsingException.getLocation<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Return the location of the incorrect JSON.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:481"></a><font size="1PT">JSONP:JAVADOC:481</font></TD><TD align="center" valign="center"><font size="1PT">List</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArray.getValuesAs<br> + + ( + Class + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns a list view of the specified type for the array. This method does not verify if there is a value of wrong type in the array. Providing this typesafe view dynamically may cause a program fail with a ClassCastException, if there is a value of wrong type in this array. Unfortunately, the exception can occur at any time after this method returns.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:490"></a><font size="1PT">JSONP:JAVADOC:490</font></TD><TD align="center" valign="center"><font size="1PT">JsonArray</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArray.getJsonArray<br> + + ( + int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the array value at the specified position in this array. This is a convenience method for (JsonArray)get(index).</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:493"></a><font size="1PT">JSONP:JAVADOC:493</font></TD><TD align="center" valign="center"><font size="1PT">JsonNumber</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArray.getJsonNumber<br> + + ( + int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the number value at the specified position in this array. This is a convenience method for (JsonNumber)get(index).</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:496"></a><font size="1PT">JSONP:JAVADOC:496</font></TD><TD align="center" valign="center"><font size="1PT">JsonObject</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArray.getJsonObject<br> + + ( + int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the object value at the specified position in this array. This is a convenience method for (JsonObject)get(index).</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:499"></a><font size="1PT">JSONP:JAVADOC:499</font></TD><TD align="center" valign="center"><font size="1PT">JsonString</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArray.getJsonString<br> + + ( + int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the string value at ths specified position in this array. This is a convenience method for (JsonString)get(index).</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:506"></a><font size="1PT">JSONP:JAVADOC:506</font></TD><TD align="center" valign="center"><font size="1PT">boolean</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArray.isNull<br> + + ( + int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns true if the value at the specified location in this array is JsonValue.NULL.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:527"></a><font size="1PT">JSONP:JAVADOC:527</font></TD><TD align="center" valign="center"><font size="1PT">JsonArray</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObject.getJsonArray<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the array value to which the specified name is mapped. This is a convenience method for (JsonArray)get(name) to get the value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:529"></a><font size="1PT">JSONP:JAVADOC:529</font></TD><TD align="center" valign="center"><font size="1PT">JsonNumber</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObject.getJsonNumber<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the number value to which the specified name is mapped. This is a convenience method for (JsonNumber)get(name) to get the value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:531"></a><font size="1PT">JSONP:JAVADOC:531</font></TD><TD align="center" valign="center"><font size="1PT">JsonObject</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObject.getJsonObject<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the object value to which the specified name is mapped. This is a convenience method for (JsonObject)get(name) to get the value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:533"></a><font size="1PT">JSONP:JAVADOC:533</font></TD><TD align="center" valign="center"><font size="1PT">JsonString</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObject.getJsonString<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the string value to which the specified name is mapped. This is a convenience method for (JsonString)get(name) to get the value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:539"></a><font size="1PT">JSONP:JAVADOC:539</font></TD><TD align="center" valign="center"><font size="1PT">boolean</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObject.isNull<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns true if the associated value for the specified name is JsonValue.NULL.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:572"></a><font size="1PT">JSONP:JAVADOC:572</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createArrayBuilder<br> + + ( + JsonArray + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON array builder, initialized with the specified array</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:573"></a><font size="1PT">JSONP:JAVADOC:573</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createArrayBuilder<br> + + ( + Collection + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON array builder, initialized with the specified array</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:574"></a><font size="1PT">JSONP:JAVADOC:574</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatch</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createDiff<br> + + ( + JsonStructure + ,<br>JsonStructure + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Generates a JSON Patch (RFC 6902) from the source and target JsonStructure. The generated JSON Patch need not be unique.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:575"></a><font size="1PT">JSONP:JAVADOC:575</font></TD><TD align="center" valign="center"><font size="1PT">JsonMergePatch</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createMergeDiff<br> + + ( + JsonValue + ,<br>JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Generates a JSON Merge Patch (RFC 7396) from the source and target JsonValues which when applied to the source, yields the target.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:576"></a><font size="1PT">JSONP:JAVADOC:576</font></TD><TD align="center" valign="center"><font size="1PT">JsonMergePatch</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createMergePatch<br> + + ( + JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates JSON Merge Patch (RFC 7396) from specified JsonValue.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:577"></a><font size="1PT">JSONP:JAVADOC:577</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createObjectBuilder<br> + + ( + JsonObject + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON object builder, initialized with the specified object.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:578"></a><font size="1PT">JSONP:JAVADOC:578</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createObjectBuilder<br> + + ( + Map + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON object builder, initialized with the specified object.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:579"></a><font size="1PT">JSONP:JAVADOC:579</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatch</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createPatch<br> + + ( + JsonArray + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON Patch (RFC 6902) from the specified operations.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:580"></a><font size="1PT">JSONP:JAVADOC:580</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createPatchBuilder<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON Patch builder (RFC 6902).</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:581"></a><font size="1PT">JSONP:JAVADOC:581</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createPatchBuilder<br> + + ( + JsonArray + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON Patch builder (RFC 6902), initialized with the specified operations.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:582"></a><font size="1PT">JSONP:JAVADOC:582</font></TD><TD align="center" valign="center"><font size="1PT">JsonPointer</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createPointer<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates JSON Pointer (RFC 6901) from given jsonPointer string. An empty jsonPointer string defines a reference to the target itself. If the jsonPointer string is non-empty, it must be a sequence of '/' prefixed tokens.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:583"></a><font size="1PT">JSONP:JAVADOC:583</font></TD><TD align="center" valign="center"><font size="1PT">JsonString</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createValue<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonString.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:584"></a><font size="1PT">JSONP:JAVADOC:584</font></TD><TD align="center" valign="center"><font size="1PT">JsonNumber</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createValue<br> + + ( + int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonNumber.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:585"></a><font size="1PT">JSONP:JAVADOC:585</font></TD><TD align="center" valign="center"><font size="1PT">JsonNumber</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createValue<br> + + ( + long + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonNumber.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:586"></a><font size="1PT">JSONP:JAVADOC:586</font></TD><TD align="center" valign="center"><font size="1PT">JsonNumber</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createValue<br> + + ( + double + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonNumber.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:587"></a><font size="1PT">JSONP:JAVADOC:587</font></TD><TD align="center" valign="center"><font size="1PT">JsonNumber</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createValue<br> + + ( + BigDecimal + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonNumber.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:588"></a><font size="1PT">JSONP:JAVADOC:588</font></TD><TD align="center" valign="center"><font size="1PT">JsonNumber</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.Json.createValue<br> + + ( + BigInteger + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonNumber.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:589"></a><font size="1PT">JSONP:JAVADOC:589</font></TD><TD align="center" valign="center"><font size="1PT">List</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArray.getValuesAs<br> + + ( + Function + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns a list view for the array. The value and the type of the elements in the list is specified by the func argument. This method can be used to obtain a list of the unwrapped types, such as List strings = ary1.getValuesAs(JsonString::getString); List ints = ary2.getValuesAs(JsonNumber::intValue); or a list of simple projections, such as List stringsizes = ary1.getValueAs((JsonString v)->v.getString().length();</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:590"></a><font size="1PT">JSONP:JAVADOC:590</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + int + ,<br>JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Inserts a value to the array at the specified position. Shifts the value currently at that position (if any) and any subsequent values to the right (adds one to their indices). Index starts with 0.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:591"></a><font size="1PT">JSONP:JAVADOC:591</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + int + ,<br>String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a value to the array as a JsonString at the specified position. Shifts the value currently at that position (if any) and any subsequent values to the right (adds one to their indices). Index starts with 0.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:592"></a><font size="1PT">JSONP:JAVADOC:592</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + int + ,<br>BigDecimal + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a value to the array as a JsonNumber at the specified position. Shifts the value currently at that position (if any) and any subsequent values to the right (adds one to their indices). Index starts with 0.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:593"></a><font size="1PT">JSONP:JAVADOC:593</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + int + ,<br>BigInteger + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a value to the array as a JsonNumber at the specified position. Shifts the value currently at that position (if any) and any subsequent values to the right (adds one to their indices). Index starts with 0.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:594"></a><font size="1PT">JSONP:JAVADOC:594</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + int + ,<br>int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a value to the array as a JsonNumber at the specified position. Shifts the value currently at that position (if any) and any subsequent values to the right (adds one to their indices). Index starts with 0.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:595"></a><font size="1PT">JSONP:JAVADOC:595</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + int + ,<br>long + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a value to the array as a JsonNumber at the specified position. Shifts the value currently at that position (if any) and any subsequent values to the right (adds one to their indices). Index starts with 0.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:596"></a><font size="1PT">JSONP:JAVADOC:596</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + int + ,<br>double + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a value to the array as a JsonNumber at the specified position. Shifts the value currently at that position (if any) and any subsequent values to the right (adds one to their indices). Index starts with 0.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:597"></a><font size="1PT">JSONP:JAVADOC:597</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + int + ,<br>boolean + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a JsonValue#TRUE or JsonValue#FALSE value to the array at the specified position. Shifts the value currently at that position (if any) and any subsequent values to the right (adds one to their indices). Index starts with 0.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:598"></a><font size="1PT">JSONP:JAVADOC:598</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + int + ,<br>JsonObjectBuilder + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a JsonObject from an object builder to the array at the specified position. Shifts the value currently at that position (if any) and any subsequent values to the right (adds one to their indices). Index starts with 0.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:599"></a><font size="1PT">JSONP:JAVADOC:599</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.add<br> + + ( + int + ,<br>JsonArrayBuilder + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a JsonArray from an array builder to the array at the specified position. Shifts the value currently at that position (if any) and any subsequent values to the right (adds one to their indices). Index starts with 0.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:600"></a><font size="1PT">JSONP:JAVADOC:600</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.addAll<br> + + ( + JsonArrayBuilder + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds all elements of the array in the specified array builder to the array.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:601"></a><font size="1PT">JSONP:JAVADOC:601</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.addNull<br> + + ( + int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a JsonValue#NULL value to the array at the specified position. Shifts the value currently at that position (if any) and any subsequent values to the right (adds one to their indices). Index starts with 0.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:602"></a><font size="1PT">JSONP:JAVADOC:602</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.remove<br> + + ( + int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Remove the value in the array at the specified position. Shift any subsequent values to the left (subtracts one from their indices.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:603"></a><font size="1PT">JSONP:JAVADOC:603</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.set<br> + + ( + int + ,<br>JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Replaces a value in the array with the specified value at the specified position.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:604"></a><font size="1PT">JSONP:JAVADOC:604</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.set<br> + + ( + int + ,<br>String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Replaces a value in the array with the specified value as a JsonString at the specified position.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:605"></a><font size="1PT">JSONP:JAVADOC:605</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.set<br> + + ( + int + ,<br>BigDecimal + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Replaces a value in the array with the specified value as a JsonNumber at the specified position.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:606"></a><font size="1PT">JSONP:JAVADOC:606</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.set<br> + + ( + int + ,<br>BigInteger + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Replaces a value in the array with the specified value as a JsonNumber at the specified position.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:607"></a><font size="1PT">JSONP:JAVADOC:607</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.set<br> + + ( + int + ,<br>int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Replaces a value in the array with the specified value as a JsonNumber at the specified position.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:608"></a><font size="1PT">JSONP:JAVADOC:608</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.set<br> + + ( + int + ,<br>long + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Replaces a value in the array with the specified value as a JsonNumber at the specified position.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:609"></a><font size="1PT">JSONP:JAVADOC:609</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.set<br> + + ( + int + ,<br>double + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Replaces a value in the array with the specified value as a JsonNumber at the specified position.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:610"></a><font size="1PT">JSONP:JAVADOC:610</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.set<br> + + ( + int + ,<br>boolean + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Replaces a value in the array with a JsonValue#TRUE or JsonValue#FALSE value at the specified position.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:611"></a><font size="1PT">JSONP:JAVADOC:611</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.set<br> + + ( + int + ,<br>JsonObjectBuilder + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Replaces a value in the array with the specified value as a JsonObject from an object builder at the specified position.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:612"></a><font size="1PT">JSONP:JAVADOC:612</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.set<br> + + ( + int + ,<br>JsonArrayBuilder + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Replaces a value in the array with the specified value as a JsonArray from an array builder at the specified position.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:613"></a><font size="1PT">JSONP:JAVADOC:613</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonArrayBuilder.setNull<br> + + ( + int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Replaces a value in the array with a JsonValue#NULL value at the specified position.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:614"></a><font size="1PT">JSONP:JAVADOC:614</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonBuilderFactory.createArrayBuilder<br> + + ( + JsonArray + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonArrayBuilder instance, initialized with an array.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:615"></a><font size="1PT">JSONP:JAVADOC:615</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonBuilderFactory.createObjectBuilder<br> + + ( + JsonObject + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonObjectBuilder instance, initialized with an object.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:616"></a><font size="1PT">JSONP:JAVADOC:616</font></TD><TD align="center" valign="center"><font size="1PT">JsonValue</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonMergePatch.apply<br> + + ( + JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Applies the JSON Merge Patch to the specified target. The target is not modified by the patch.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:617"></a><font size="1PT">JSONP:JAVADOC:617</font></TD><TD align="center" valign="center"><font size="1PT">JsonValue</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonMergePatch.toJsonValue<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns the JsonMergePatch as JsonValue.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:618"></a><font size="1PT">JSONP:JAVADOC:618</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObjectBuilder.addAll<br> + + ( + JsonObjectBuilder + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds all name/value pairs in the JSON object associated with the specified object builder to the JSON object associated with this object builder. The newly added name/value pair will replace any existing name/value pair with the same name.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:619"></a><font size="1PT">JSONP:JAVADOC:619</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonObjectBuilder.remove<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Remove the name/value pair from the JSON object associated with this object builder if it is present.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:620"></a><font size="1PT">JSONP:JAVADOC:620</font></TD><TD align="center" valign="center"><font size="1PT">JsonStructure</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatch.apply<br> + + ( + JsonStructure + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Applies the patch operations to the specified target. The target is not modified by the patch.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:621"></a><font size="1PT">JSONP:JAVADOC:621</font></TD><TD align="center" valign="center"><font size="1PT">JsonArray</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatch.toJsonArray<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns the JsonPatch as JsonArray.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:622"></a><font size="1PT">JSONP:JAVADOC:622</font></TD><TD align="center" valign="center"><font size="1PT">Operation</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatch.Operation.fromOperationName<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the enum constant with the specified name.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:623"></a><font size="1PT">JSONP:JAVADOC:623</font></TD><TD align="center" valign="center"><font size="1PT">String</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatch.Operation.operationName<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns enum constant name as lower case string.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:624"></a><font size="1PT">JSONP:JAVADOC:624</font></TD><TD align="center" valign="center"><font size="1PT">Operation</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatch.Operation.valueOf<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:625"></a><font size="1PT">JSONP:JAVADOC:625</font></TD><TD align="center" valign="center"><font size="1PT">Operation[]</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatch.Operation.values<br> +</font></TD><TD align="left" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:626"></a><font size="1PT">JSONP:JAVADOC:626</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.add<br> + + ( + String + ,<br>JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds an "add" JSON Patch operation.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:627"></a><font size="1PT">JSONP:JAVADOC:627</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.add<br> + + ( + String + ,<br>String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds an "add" JSON Patch operation.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:628"></a><font size="1PT">JSONP:JAVADOC:628</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.add<br> + + ( + String + ,<br>int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds an "add" JSON Patch operation.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:629"></a><font size="1PT">JSONP:JAVADOC:629</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.add<br> + + ( + String + ,<br>boolean + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds an "add" JSON Patch operation.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:630"></a><font size="1PT">JSONP:JAVADOC:630</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatch</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.build<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns the JSON Patch.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:631"></a><font size="1PT">JSONP:JAVADOC:631</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.copy<br> + + ( + String + ,<br>String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a "copy" JSON Patch operation.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:632"></a><font size="1PT">JSONP:JAVADOC:632</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.move<br> + + ( + String + ,<br>String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a "move" JSON Patch operation.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:633"></a><font size="1PT">JSONP:JAVADOC:633</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.remove<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a "remove" JSON Patch operation.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:634"></a><font size="1PT">JSONP:JAVADOC:634</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.replace<br> + + ( + String + ,<br>JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a "replace" JSON Patch operation.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:635"></a><font size="1PT">JSONP:JAVADOC:635</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.replace<br> + + ( + String + ,<br>String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a "replace" JSON Patch operation.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:636"></a><font size="1PT">JSONP:JAVADOC:636</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.replace<br> + + ( + String + ,<br>int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a "replace" JSON Patch operation.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:637"></a><font size="1PT">JSONP:JAVADOC:637</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.replace<br> + + ( + String + ,<br>boolean + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a "replace" JSON Patch operation.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:638"></a><font size="1PT">JSONP:JAVADOC:638</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.test<br> + + ( + String + ,<br>JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a "test" JSON Patch operation.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:639"></a><font size="1PT">JSONP:JAVADOC:639</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.test<br> + + ( + String + ,<br>String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a "test" JSON Patch operation.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:640"></a><font size="1PT">JSONP:JAVADOC:640</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.test<br> + + ( + String + ,<br>int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a "test" JSON Patch operation.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:641"></a><font size="1PT">JSONP:JAVADOC:641</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPatchBuilder.test<br> + + ( + String + ,<br>boolean + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds a "test" JSON Patch operation.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:642"></a><font size="1PT">JSONP:JAVADOC:642</font></TD><TD align="center" valign="center"><font size="1PT">JsonStructure</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPointer.add<br> + + ( + JsonStructure + ,<br>JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Adds or replaces a value at the referenced location in the specified target with the specified value. If the reference is the target (empty JSON Pointer string), the specified value, which must be the same type as specified target, is returned. If the reference is an array element, the specified value is inserted into the array, at the referenced index. The value currently at that location, and any subsequent values, are shifted to the right (adds one to the indices). Index starts with 0. If the reference is specified with a "-", or if the index is equal to the size of the array, the value is appended to the array. If the reference is a name/value pair of a JsonObject, and the referenced value exists, the value is replaced by the specified value. If the value does not exist, a new name/value pair is added to the object.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:643"></a><font size="1PT">JSONP:JAVADOC:643</font></TD><TD align="center" valign="center"><font size="1PT">JsonValue</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPointer.getValue<br> + + ( + JsonStructure + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Returns the value at the referenced location in the specified target.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:644"></a><font size="1PT">JSONP:JAVADOC:644</font></TD><TD align="center" valign="center"><font size="1PT">JsonStructure</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPointer.remove<br> + + ( + JsonStructure + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Removes the value at the reference location in the specified target.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:645"></a><font size="1PT">JSONP:JAVADOC:645</font></TD><TD align="center" valign="center"><font size="1PT">JsonStructure</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonPointer.replace<br> + + ( + JsonStructure + ,<br>JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Replaces the value at the referenced location in the specified target with the specified value.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:646"></a><font size="1PT">JSONP:JAVADOC:646</font></TD><TD align="center" valign="center"><font size="1PT">JsonValue</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonReader.readValue<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a JSON value that is represented in the input source. This method needs to be called only once for a reader instance.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:647"></a><font size="1PT">JSONP:JAVADOC:647</font></TD><TD align="center" valign="center"><font size="1PT">JsonValue</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonStructure.getValue<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Get the value referenced by the provided JSON Pointer in the JsonStructure.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:648"></a><font size="1PT">JSONP:JAVADOC:648</font></TD><TD align="center" valign="center"><font size="1PT">JsonArray</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonValue.asJsonArray<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Return the JsonValue as a JsonArray</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:649"></a><font size="1PT">JSONP:JAVADOC:649</font></TD><TD align="center" valign="center"><font size="1PT">JsonObject</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonValue.asJsonObject<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Return the JsonValue as a JsonObject</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:650"></a><font size="1PT">JSONP:JAVADOC:650</font></TD><TD align="center" valign="center"><font size="1PT">void</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.JsonWriter.write<br> + + ( + JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes the specified JsonValue to the output source. method needs to be called only once for a write instance.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:651"></a><font size="1PT">JSONP:JAVADOC:651</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createArrayBuilder<br> + + ( + JsonArray + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON array builder, initialized with the specified array.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:652"></a><font size="1PT">JSONP:JAVADOC:652</font></TD><TD align="center" valign="center"><font size="1PT">JsonArrayBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createArrayBuilder<br> + + ( + Collection + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON array builder, initialized with the specified collection.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:653"></a><font size="1PT">JSONP:JAVADOC:653</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatch</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createDiff<br> + + ( + JsonStructure + ,<br>JsonStructure + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Generates a JSON Patch (RFC 6902) from the source and target JsonStructure. The generated JSON Patch need not be unique.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:654"></a><font size="1PT">JSONP:JAVADOC:654</font></TD><TD align="center" valign="center"><font size="1PT">JsonMergePatch</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createMergeDiff<br> + + ( + JsonValue + ,<br>JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Generates a JSON Merge Patch (RFC 7396) from the source and target JsonValues which when applied to the source, yields the target.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:655"></a><font size="1PT">JSONP:JAVADOC:655</font></TD><TD align="center" valign="center"><font size="1PT">JsonMergePatch</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createMergePatch<br> + + ( + JsonValue + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates JSON Merge Patch (RFC 7396) from specified JsonValue.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:656"></a><font size="1PT">JSONP:JAVADOC:656</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createObjectBuilder<br> + + ( + JsonObject + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON object builder, initialized with the specified object.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:657"></a><font size="1PT">JSONP:JAVADOC:657</font></TD><TD align="center" valign="center"><font size="1PT">JsonObjectBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createObjectBuilder<br> + + ( + Map + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON object builder, initialized with the specified Map.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:658"></a><font size="1PT">JSONP:JAVADOC:658</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatch</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createPatch<br> + + ( + JsonArray + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON Patch (RFC 6902) from the specified operations.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:659"></a><font size="1PT">JSONP:JAVADOC:659</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createPatchBuilder<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON Patch builder (RFC 6902).</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:660"></a><font size="1PT">JSONP:JAVADOC:660</font></TD><TD align="center" valign="center"><font size="1PT">JsonPatchBuilder</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createPatchBuilder<br> + + ( + JsonArray + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JSON Patch builder (RFC 6902), initialized with the specified operations.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:661"></a><font size="1PT">JSONP:JAVADOC:661</font></TD><TD align="center" valign="center"><font size="1PT">JsonPointer</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createPointer<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates JSON Pointer (RFC 6901) from given jsonPointer string. An empty jsonPointer string defines a reference to the target itself. If the jsonPointer string is non-empty, it must be a sequence of '/' prefixed tokens.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:662"></a><font size="1PT">JSONP:JAVADOC:662</font></TD><TD align="center" valign="center"><font size="1PT">JsonString</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createValue<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonString.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:663"></a><font size="1PT">JSONP:JAVADOC:663</font></TD><TD align="center" valign="center"><font size="1PT">JsonNumber</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createValue<br> + + ( + int + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonNumber.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:664"></a><font size="1PT">JSONP:JAVADOC:664</font></TD><TD align="center" valign="center"><font size="1PT">JsonNumber</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createValue<br> + + ( + long + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonNumber.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:665"></a><font size="1PT">JSONP:JAVADOC:665</font></TD><TD align="center" valign="center"><font size="1PT">JsonNumber</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createValue<br> + + ( + double + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonNumber.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:666"></a><font size="1PT">JSONP:JAVADOC:666</font></TD><TD align="center" valign="center"><font size="1PT">JsonNumber</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createValue<br> + + ( + BigDecimal + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonNumber.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:667"></a><font size="1PT">JSONP:JAVADOC:667</font></TD><TD align="center" valign="center"><font size="1PT">JsonNumber</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.spi.JsonProvider.createValue<br> + + ( + BigInteger + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Creates a JsonNumber.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:668"></a><font size="1PT">JSONP:JAVADOC:668</font></TD><TD align="center" valign="center"><font size="1PT">Collector</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonCollectors.groupingBy<br> + + ( + Function + ,<br>Collector + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Constructs a java.util.stream.Collector that implements a "group by" operation on the input JsonValue elements. A classifier function maps the input JsonValues to keys, and the JsonValues are partitioned into groups according to the value of the key. A reduction operation is performed on the JsonValues in each group, using the downstream Collector. For each group, the key and the results of the reduction operation become the name/value pairs of the resultant JsonObject.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:669"></a><font size="1PT">JSONP:JAVADOC:669</font></TD><TD align="center" valign="center"><font size="1PT">Collector</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonCollectors.groupingBy<br> + + ( + Function + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Constructs a java.util.stream.Collector that implements a "group by" operation on the input JsonValue elements. A classifier function maps the input JsonValues to keys, and the JsonValues are partitioned into groups according to the value of the key. The JsonValues in each group are added to a JsonArray. The key and the JsonArray in each group becomes the name/value pair of the resultant JsonObject.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:670"></a><font size="1PT">JSONP:JAVADOC:670</font></TD><TD align="center" valign="center"><font size="1PT">Collector</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonCollectors.toJsonArray<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Constructs a java.util.stream.Collector that accumulates the input JsonValue elements into a JsonArray.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:671"></a><font size="1PT">JSONP:JAVADOC:671</font></TD><TD align="center" valign="center"><font size="1PT">Collector</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonCollectors.toJsonObject<br> + + ( + Function + ,<br>Function + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Constructs a java.util.stream.Collector that accumulates the input JsonValue elements into a JsonObject. The name/value pairs of the JsonObject are computed by applying the provided mapping functions.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:672"></a><font size="1PT">JSONP:JAVADOC:672</font></TD><TD align="center" valign="center"><font size="1PT">JsonGenerator</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonGenerator.writeKey<br> + + ( + String + ) + </font></TD><TD align="left" valign="center"><font size="1PT">Writes the JSON name with a colon. It starts a field context, in which valid options are writing a value, starting an object or an array. Writing value closes field context, if object or array is started after field name, field context will be closed after object/array close.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:673"></a><font size="1PT">JSONP:JAVADOC:673</font></TD><TD align="center" valign="center"><font size="1PT">JsonArray</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.getArray<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a JsonArray and advance the parser to the the corresponding END_ARRAY.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:674"></a><font size="1PT">JSONP:JAVADOC:674</font></TD><TD align="center" valign="center"><font size="1PT">Stream</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.getArrayStream<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a stream of the JsonArray elements. The parser state must be START_ARRAY. The elements are read lazily, on an as-needed basis, as required by the stream operations. If the stream operations do not consume all of the array elements, skipArray can be used to skip the unprocessed array elements.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:675"></a><font size="1PT">JSONP:JAVADOC:675</font></TD><TD align="center" valign="center"><font size="1PT">JsonObject</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.getObject<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a JsonObject and advances the parser to the corresponding END_OBJECT.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:676"></a><font size="1PT">JSONP:JAVADOC:676</font></TD><TD align="center" valign="center"><font size="1PT">Stream</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.getObjectStream<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a stream of the JsonObject's name/value pairs. The parser state must be START_OBJECT. The name/value pairs are read lazily, on an as-needed basis, as required by the stream operations. If the stream operations do not consume all of the object's name/value pairs, skipObject can be used to skip the unprocessed elements.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:677"></a><font size="1PT">JSONP:JAVADOC:677</font></TD><TD align="center" valign="center"><font size="1PT">JsonValue</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.getValue<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a JsonValue at the current parser position. If the parser state is START_ARRAY, the behavior is the same as #getArray. If the parser state is START_OBJECT, the behavior is the same as #getObject. For all other cases, if applicable, the JSON value is read and returned.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:678"></a><font size="1PT">JSONP:JAVADOC:678</font></TD><TD align="center" valign="center"><font size="1PT">Stream</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.getValueStream<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Returns a stream of JsonValue from a sequence of JSON values. The values are read lazily, on an as-needed basis, as needed by the stream operations.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:679"></a><font size="1PT">JSONP:JAVADOC:679</font></TD><TD align="center" valign="center"><font size="1PT">void</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.skipArray<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Advance the parser to END_ARRAY. If the parser is in array context, i.e. it has previously encountered a START_ARRAY without encountering the corresponding END_ARRAY, the parser is advanced to the corresponding END_ARRAY. If the parser is not in any array context, nothing happens.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +<TR> +<TD align="center" valign="center"><a name="JSONP:JAVADOC:680"></a><font size="1PT">JSONP:JAVADOC:680</font></TD><TD align="center" valign="center"><font size="1PT">void</font></TD><TD align="left" valign="center"><font size="1PT">jakarta.json.stream.JsonParser.skipObject<br> +</font></TD><TD align="left" valign="center"><font size="1PT">Advance the parser to END_OBJECT. If the parser is in object context, i.e. it has previously encountered a START_OBJECT without encountering the corresponding END_OBJECT, the parser is advanced to the corresponding END_OBJECT. If the parser is not in any object context, nothing happens.</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD><TD align="center" valign="center"><font size="1PT"> +<br> +</font></TD><TD align="center" valign="center"><font size="1PT">true</font></TD> +</TR> +</TABLE> +</body> +</html>
diff --git a/tck/tck-docs/index.html b/tck/tck-docs/index.html new file mode 100644 index 0000000..12d35eb --- /dev/null +++ b/tck/tck-docs/index.html
@@ -0,0 +1,79 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<!-- + + Copyright (c) 2021 Oracle and/or its affiliates. All rights reserved. + + This program and the accompanying materials are made available under the + terms of the Eclipse Public License v. 2.0, which is available at + http://www.eclipse.org/legal/epl-2.0. + + This Source Code may also be made available under the following Secondary + Licenses when the conditions for such availability set forth in the + Eclipse Public License v. 2.0 are satisfied: GNU General Public License, + version 2 with the GNU Classpath Exception, which is available at + https://www.gnu.org/software/classpath/license.html. + + SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0 + +--> +<html> + <head> + <meta http-equiv="content-type" content="text/html; charset=windows-1252"> + <title>Welcome to the Jakarta EE JSON Processing TCK</title> + <style type="text/css"> +<!-- +pre { background-color: #eeeeee; color: #000099} +code { color: #000099} +h1 { color: #000099} +h2 { color: #000099} +h3 { color: #000099; text-decoration: underline} +h4 { font-style: italic; color: #000099} +.tabletitle { font-style: italic; color: #ffffcc; font-size: small; font-variant: small-caps} +.subtitle { font-style: italic; color: #ffffcc; font-variant: small-caps} +.emphasize { font-style: italic; color: #000099} +--> +</style> + </head> + <body vlink="#840084" text="#000000" link="#0000ff" bgcolor="#ffffdd" alink="#0000ff"> + <div align="Center"> + <h1>Welcome to the Jakarta EE JSON Processing TCK, Version 2.1</h1> + <h2> + <span class="emphasize">Your Starting Point</span></h2> + </div> + <hr> + <h2>Guide to Jakarta EE JSON Processing TCK 2.1 Documentation</h2> + <p>The Jakarta EE JSON Processing TCK 2.1 documentation includes the + following:</p> + <ul> + <li>The <em><a href="JSONP2.1-ReleaseNotes.html">Jakarta EE JSON + Processing TCK Release Notes</a></em> provides the information on + the test harness, the test suite and the platforms tested. + <ul> + <li>If needed, updated Release Notes may be updated at the Jakarta EE + Specification web site for Jakarta EE JSON Processing: <a href="https://jakarta.ee/specifications/jsonp/2.1/">https://jakarta.ee/specifications/jsonp/2.1/</a></li> + </ul> + </li> + <li>The <em><a href="tck-docs/userguide/target/generated-docs/toc.html">Jakarta EE JSON Processing + Technology Compatibility Kit, Version 2.1 User's Guide</a></em> (or + <a href="tck-docs/userguide/target/generated-docs/Jakarta-JSON-Processing-TCK-Users-Guide.pdf" + + title="Jakarta EE JSON Processing TCK 2.1 User's Guide (PDF)">PDF</a>) + provides the information that you need to install, set up, and run the + Jakarta EE JSON Processing TCK, Version 2.1. In addition, the guide + provides the rules you must comply with to pass the Jakarta EE JSON + Processing TCK.</li> + <li>The <a href="assertions/JSONP2.0JavadocAssertions.html">Javadoc + Assertion List</a> lists all the javadoc assertions that are tested by + the Jakarta EE JSON Processing 2.0 TCK.</li> + </ul> + <hr> + <p><cite><small></small></cite></p> + <address><small> + Copyright � 2013, 2021 Oracle and/or its affiliates. All rights + reserved. + </small></address> + <cite> + <p></p> + </cite> + </body> +</html>
diff --git a/tck/tck-docs/userguide/README.md b/tck/tck-docs/userguide/README.md new file mode 100644 index 0000000..05bacb8 --- /dev/null +++ b/tck/tck-docs/userguide/README.md
@@ -0,0 +1,77 @@ +# A JBake project template + +## About JBake + +JBake is a static site generator, it's inspired from jekyll and written +in java. The basic idea is to have templates for the structure of the +page, and the body generated from asciidoc content. + +## Pre requisites + +- Maven +- JDK11+ + +Deploying to Github will require password less authentication. + +This is done by exporting your SSH public key into your Github account. + +## Build the site locally + +The site is generated under target/staging. + +Open file:///PATH_TO_PROJECT_DIR/target/staging in a browser to view the site. + +``` +mvn generate-resources +``` + +Or you can invoke the JBake plugin directly. + +``` +mvn jbake:build +``` + +### Rebuild the site on changes + +``` +mvn jbake:watch +``` + +If you keep this command running, changes to the sources will be +detected and the site will be rendered incrementally. + +This is convenient when writing content. + +### Serve the site locally + +``` +mvn jbake:serve +``` + +If a webserver is required (e.g. absolute path are used), this command +will start a webserver (jetty) at http://localhost:8820. It will also +watch for changes and rebuild incrementally. + +## Deploy the site to Github Pages + +``` +mvn deploy +``` + +## Produce a zip file for download + +To produce a zip file containing the generated html files, use: + +``` +mvn package +``` + +When making a release on GitHub, this zip file should be added to the release. + +## Links + +- [JBake maven plugin documentation](https://github.com/Blazebit/jbake-maven-plugin) +- [JBake documentation](http://jbake.org/docs/2.5.1) +- [Freemarker documentation](http://freemarker.org/docs) +- [AsciiDoc User Guide](http://asciidoc.org/userguide.html) +- [Asciidoctor quick reference](http://asciidoctor.org/docs/asciidoc-syntax-quick-reference)
diff --git a/tck/tck-docs/userguide/pom.xml b/tck/tck-docs/userguide/pom.xml new file mode 100644 index 0000000..3244c08 --- /dev/null +++ b/tck/tck-docs/userguide/pom.xml
@@ -0,0 +1,258 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + + Copyright (c) 2017, 2021 Oracle and/or its affiliates. All rights reserved. + + This program and the accompanying materials are made available under the + terms of the Eclipse Public License v. 2.0, which is available at + http://www.eclipse.org/legal/epl-2.0. + + This Source Code may also be made available under the following Secondary + Licenses when the conditions for such availability set forth in the + Eclipse Public License v. 2.0 are satisfied: GNU General Public License, + version 2 with the GNU Classpath Exception, which is available at + https://www.gnu.org/software/classpath/license.html. + + SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0 + +--> + +<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> + <modelVersion>4.0.0</modelVersion> + <parent> + <groupId>org.eclipse.ee4j</groupId> + <artifactId>project</artifactId> + <version>1.0.5</version> + </parent> + <groupId>org.glassfish</groupId> + <artifactId>tck_jsonp</artifactId> + <packaging>pom</packaging> + <version>2.1.0</version> + <name>Eclipse Foundation Technology Compatibility Kit User's Guide for Jakarta JSON Processing for Jakarta EE, Release 2.1</name> + + <properties> + <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> + <site.output.dir>${project.build.directory}/staging</site.output.dir> + <maven.site.skip>true</maven.site.skip> + <asciidoctorj.version>2.4.2</asciidoctorj.version> + <asciidoctorj.diagram.version>2.1.0</asciidoctorj.diagram.version> + <asciidoctorj.maven.plugin.version>2.1.0</asciidoctorj.maven.plugin.version> + <asciidoctorj.pdf.version>1.5.3</asciidoctorj.pdf.version> + <jbake.maven.plugin.version>0.3.3</jbake.maven.plugin.version> + <freemarker.version>2.3.30</freemarker.version> + <!-- status: DRAFT, BETA, etc., or blank for final --> + <status></status> + <doc.pdf>Jakarta-JSON-Processing-TCK-Users-Guide.pdf</doc.pdf> + <maven.deploy.skip>true</maven.deploy.skip> + </properties> + + <distributionManagement> + <site> + <url>scm:git:git@github.com:eclipse-ee4j/jsonp.git</url> + </site> + </distributionManagement> + + <build> + <defaultGoal>package</defaultGoal> + <plugins> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-clean-plugin</artifactId> + <configuration> + <filesets> + <fileset> + <directory>src/main/jbake/content</directory> + <includes> + <include>toc.adoc</include> + </includes> + </fileset> + </filesets> + </configuration> + </plugin> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-enforcer-plugin</artifactId> + <executions> + <execution> + <id>enforce-versions</id> + <goals> + <goal>enforce</goal> + </goals> + <configuration> + <rules> + <requireJavaVersion> + <version>[11,)</version> + <message>You need JDK11 or newer</message> + </requireJavaVersion> + </rules> + </configuration> + </execution> + </executions> + </plugin> + <plugin> + <groupId>org.glassfish.doc</groupId> + <artifactId>glassfish-doc-maven-plugin</artifactId> + <executions> + <execution> + <id>generate-toc</id> + <phase>generate-resources</phase> + <goals> + <goal>toc</goal> + </goals> + <configuration> + <chapterPatterns> + [0-9]+\s.*,Preface.*,Part\s.* + </chapterPatterns> + </configuration> + </execution> + <execution> + <id>generate-book</id> + <phase>generate-resources</phase> + <goals> + <goal>book</goal> + </goals> + </execution> + </executions> + </plugin> + <plugin> + <groupId>org.jbake</groupId> + <artifactId>jbake-maven-plugin</artifactId> + <configuration> + <outputDirectory>${site.output.dir}</outputDirectory> + <properties> + <status>${status}</status> + </properties> + </configuration> + <executions> + <execution> + <id>build-site</id> + <phase>generate-resources</phase> + <goals> + <goal>generate</goal> + </goals> + </execution> + </executions> + </plugin> + <plugin> + <groupId>org.asciidoctor</groupId> + <artifactId>asciidoctor-maven-plugin</artifactId> + <configuration> + <sourceDirectory>${project.build.directory}/book</sourceDirectory> + <sourceDocumentName>book.adoc</sourceDocumentName> + <!-- XXX - below depends on running jbake first --> + <imagesDir>${project.build.directory}/staging/</imagesDir> + <backend>pdf</backend> + <outputFile>${doc.pdf}</outputFile> + <attributes> + <pdf-stylesdir>${project.basedir}/src/theme</pdf-stylesdir> + <pdf-style>jakartaee</pdf-style> + <doctype>book</doctype> + <status>${status}</status> + <compat-mode /> + <data-uri /> + <icons>font</icons> + <pagenums /> + <toc /> + <icons>font</icons> + <sectanchors>true</sectanchors> + <idprefix /> + <idseparator>-</idseparator> + <docinfo1>true</docinfo1> + <embedAssets>true</embedAssets> + </attributes> + </configuration> + <executions> + <execution> + <id>generate-pdf-doc</id> + <phase>generate-resources</phase> + <goals> + <goal>process-asciidoc</goal> + </goals> + </execution> + </executions> + </plugin> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-scm-publish-plugin</artifactId> + <executions> + <execution> + <id>deploy-site</id> + <phase>deploy</phase> + <goals> + <goal>publish-scm</goal> + </goals> + <configuration> + <scmBranch>gh-pages</scmBranch> + <skipDeletedFiles>false</skipDeletedFiles> + <checkinComment>Update site</checkinComment> + </configuration> + </execution> + </executions> + </plugin> + </plugins> + + <pluginManagement> + <plugins> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-clean-plugin</artifactId> + <version>3.1.0</version> + </plugin> + <plugin> + <groupId>org.glassfish.doc</groupId> + <artifactId>glassfish-doc-maven-plugin</artifactId> + <version>1.3</version> + </plugin> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-enforcer-plugin</artifactId> + <version>3.0.0-M3</version> + </plugin> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-assembly-plugin</artifactId> + <version>3.3.0</version> + </plugin> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-scm-publish-plugin</artifactId> + <version>3.1.0</version> + </plugin> + <plugin> + <groupId>org.jbake</groupId> + <artifactId>jbake-maven-plugin</artifactId> + <version>${jbake.maven.plugin.version}</version> + <dependencies> + <dependency> + <groupId>org.asciidoctor</groupId> + <artifactId>asciidoctorj</artifactId> + <version>${asciidoctorj.version}</version> + </dependency> + <dependency> + <groupId>org.asciidoctor</groupId> + <artifactId>asciidoctorj-diagram</artifactId> + <version>${asciidoctorj.diagram.version}</version> + </dependency> + <dependency> + <groupId>org.freemarker</groupId> + <artifactId>freemarker</artifactId> + <version>${freemarker.version}</version> + </dependency> + </dependencies> + </plugin> + <plugin> + <groupId>org.asciidoctor</groupId> + <artifactId>asciidoctor-maven-plugin</artifactId> + <version>${asciidoctorj.maven.plugin.version}</version> + <dependencies> + <dependency> + <groupId>org.asciidoctor</groupId> + <artifactId>asciidoctorj-pdf</artifactId> + <version>${asciidoctorj.pdf.version}</version> + </dependency> + </dependencies> + </plugin> + </plugins> + </pluginManagement> + </build> +</project>
diff --git a/tck/tck-docs/userguide/src/main/jbake/assets/README.md b/tck/tck-docs/userguide/src/main/jbake/assets/README.md new file mode 100644 index 0000000..f8f962c --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/assets/README.md
@@ -0,0 +1,4 @@ +# About + +The {{site.title}} project contains the [AsciiDoc](http://asciidoc.org/) +source code for the ...
diff --git a/tck/tck-docs/userguide/src/main/jbake/assets/_config.yml b/tck/tck-docs/userguide/src/main/jbake/assets/_config.yml new file mode 100644 index 0000000..3c06c69 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/assets/_config.yml
@@ -0,0 +1,13 @@ +remote_theme: jakartaee/jekyll-theme-jakarta-ee + +title: [tck_jsonp_v2_1] +description: [Oracle Technology Compatibility Kit User's Guide for Java API for JSON Processing 2.1 for Technology Licensees, Release 2.1] + +# sidebar links url +links: + source: https://github.com/eclipse-ee4j/jsonp + download: https://github.com/eclipse-ee4j/jsonp/releases/tag/2.1.0-RELEASE + #mailinglist: https://javaee.groups.io/g/tck_jsonp_v1_1 + #javadocs: + docs: https://eclipse-ee4j.github.io/jsonp + #faq:
diff --git a/tck/tck-docs/userguide/src/main/jbake/assets/css/style.css b/tck/tck-docs/userguide/src/main/jbake/assets/css/style.css new file mode 100644 index 0000000..182f755 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/assets/css/style.css
@@ -0,0 +1,313 @@ +/* CSS */ +/*! normalize.css v3.0.2 | MIT License | git.io/normalize */ +/** 1. Set default font family to sans-serif. 2. Prevent iOS text size adjust after orientation change, without disabling user zoom. */ +html { font-family: sans-serif; /* 1 */ -ms-text-size-adjust: 100%; /* 2 */ -webkit-text-size-adjust: 100%; /* 2 */ } + +/* HTML5 display definitions ========================================================================== */ +/** Correct `block` display not defined for any HTML5 element in IE 8/9. Correct `block` display not defined for `details` or `summary` in IE 10/11 and Firefox. Correct `block` display not defined for `main` in IE 11. */ +article, aside, details, figcaption, figure, footer, header, hgroup, main, menu, nav, section, summary { display: block; } + +/** 1. Correct `inline-block` display not defined in IE 8/9. 2. Normalize vertical alignment of `progress` in Chrome, Firefox, and Opera. */ +audio, canvas, progress, video { display: inline-block; /* 1 */ vertical-align: baseline; /* 2 */ } + +/** Prevent modern browsers from displaying `audio` without controls. Remove excess height in iOS 5 devices. */ +audio:not([controls]) { display: none; height: 0; } + +/** Address `[hidden]` styling not present in IE 8/9/10. Hide the `template` element in IE 8/9/11, Safari, and Firefox < 22. */ +[hidden], template { display: none; } + +/* Links ========================================================================== */ +/** Remove the gray background color from active links in IE 10. */ +a { background-color: transparent; } + +/** Improve readability when focused and also mouse hovered in all browsers. */ +a:active, a:hover { outline: 0; } + +/* Text-level semantics ========================================================================== */ +/** Address styling not present in IE 8/9/10/11, Safari, and Chrome. */ +abbr[title] { border-bottom: 1px dotted; } + +/** Address style set to `bolder` in Firefox 4+, Safari, and Chrome. */ +b, strong { font-weight: bold; } + +/** Address styling not present in Safari and Chrome. */ +dfn { font-style: italic; } + +/** Address variable `h1` font-size and margin within `section` and `article` contexts in Firefox 4+, Safari, and Chrome. */ +h1 { font-size: 2em; margin: 0.67em 0; } + +/** Address styling not present in IE 8/9. */ +mark { background: #ff0; color: #000; } + +/** Address inconsistent and variable font size in all browsers. */ +small { font-size: 80%; } + +/** Prevent `sub` and `sup` affecting `line-height` in all browsers. */ +sub, sup { font-size: 75%; line-height: 0; position: relative; vertical-align: baseline; } + +sup { top: -0.5em; } + +sub { bottom: -0.25em; } + +/* Embedded content ========================================================================== */ +/** Remove border when inside `a` element in IE 8/9/10. */ +img { border: 0; } + +/** Correct overflow not hidden in IE 9/10/11. */ +svg:not(:root) { overflow: hidden; } + +/* Grouping content ========================================================================== */ +/** Address margin not present in IE 8/9 and Safari. */ +figure { margin: 1em 40px; } + +/** Address differences between Firefox and other browsers. */ +hr { box-sizing: content-box; height: 0; } + +/** Contain overflow in all browsers. */ +pre { overflow: auto; } + +/** Address odd `em`-unit font size rendering in all browsers. */ +code, kbd, pre, samp { font-family: monospace, monospace; font-size: 1em; } + +/* Forms ========================================================================== */ +/** Known limitation: by default, Chrome and Safari on OS X allow very limited styling of `select`, unless a `border` property is set. */ +/** 1. Correct color not being inherited. Known issue: affects color of disabled elements. 2. Correct font properties not being inherited. 3. Address margins set differently in Firefox 4+, Safari, and Chrome. */ +button, input, optgroup, select, textarea { color: inherit; /* 1 */ font: inherit; /* 2 */ margin: 0; /* 3 */ } + +/** Address `overflow` set to `hidden` in IE 8/9/10/11. */ +button { overflow: visible; } + +/** Address inconsistent `text-transform` inheritance for `button` and `select`. All other form control elements do not inherit `text-transform` values. Correct `button` style inheritance in Firefox, IE 8/9/10/11, and Opera. Correct `select` style inheritance in Firefox. */ +button, select { text-transform: none; } + +/** 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio` and `video` controls. 2. Correct inability to style clickable `input` types in iOS. 3. Improve usability and consistency of cursor style between image-type `input` and others. */ +button, html input[type="button"], input[type="reset"], input[type="submit"] { -webkit-appearance: button; /* 2 */ cursor: pointer; /* 3 */ } + +/** Re-set default cursor for disabled elements. */ +button[disabled], html input[disabled] { cursor: default; } + +/** Remove inner padding and border in Firefox 4+. */ +button::-moz-focus-inner, input::-moz-focus-inner { border: 0; padding: 0; } + +/** Address Firefox 4+ setting `line-height` on `input` using `!important` in the UA stylesheet. */ +input { line-height: normal; } + +/** It's recommended that you don't attempt to style these elements. Firefox's implementation doesn't respect box-sizing, padding, or width. 1. Address box sizing set to `content-box` in IE 8/9/10. 2. Remove excess padding in IE 8/9/10. */ +input[type="checkbox"], input[type="radio"] { box-sizing: border-box; /* 1 */ padding: 0; /* 2 */ } + +/** Fix the cursor style for Chrome's increment/decrement buttons. For certain `font-size` values of the `input`, it causes the cursor style of the decrement button to change from `default` to `text`. */ +input[type="number"]::-webkit-inner-spin-button, input[type="number"]::-webkit-outer-spin-button { height: auto; } + +/** 1. Address `appearance` set to `searchfield` in Safari and Chrome. 2. Address `box-sizing` set to `border-box` in Safari and Chrome (include `-moz` to future-proof). */ +input[type="search"] { -webkit-appearance: textfield; /* 1 */ /* 2 */ box-sizing: content-box; } + +/** Remove inner padding and search cancel button in Safari and Chrome on OS X. Safari (but not Chrome) clips the cancel button when the search input has padding (and `textfield` appearance). */ +input[type="search"]::-webkit-search-cancel-button, input[type="search"]::-webkit-search-decoration { -webkit-appearance: none; } + +/** Define consistent border, margin, and padding. */ +fieldset { border: 1px solid #c0c0c0; margin: 0 2px; padding: 0.35em 0.625em 0.75em; } + +/** 1. Correct `color` not being inherited in IE 8/9/10/11. 2. Remove padding so people aren't caught out if they zero out fieldsets. */ +legend { border: 0; /* 1 */ padding: 0; /* 2 */ } + +/** Remove default vertical scrollbar in IE 8/9/10/11. */ +textarea { overflow: auto; } + +/** Don't inherit the `font-weight` (applied by a rule above). NOTE: the default cannot safely be changed in Chrome and Safari on OS X. */ +optgroup { font-weight: bold; } + +/* Tables ========================================================================== */ +/** Remove most spacing between table cells. */ +table { border-collapse: collapse; border-spacing: 0; } + +td, th { padding: 0; } + +/* LAYOUT STYLES */ + +p { margin-top: 0; } + +code, pre { margin-bottom: 30px; font-family: Monaco, "Bitstream Vera Sans Mono", "Lucida Console", Terminal, monospace; font-size: 13px; color: #222; } + +code { padding: 0 3px; background-color: #f2f8fc; border: solid 1px #dbe7f3; } + +pre { padding: 20px; overflow: auto; text-shadow: none; background: #fff; border: solid 1px #f2f2f2; } + +pre code { padding: 0; color: #2879d0; background-color: #fff; border: none; } + +ul, ol, dl { margin-bottom: 20px; } + +/* COMMON STYLES */ + +td.halign-right { text-align: right; } + +td.halign-center { text-align: center; } + +form { padding: 20px; background: #f2f2f2; } + +h2 { + font-size: 2em; + line-height: 1.2em; + font-weight: 200; + letter-spacing: 0; +} + +h3 { + font-size: 1.4em; + line-height: 1.2em; + font-weight: normal; + letter-spacing: 0; +} + +.sect1 { + margin-left: 4%; + margin-right: 4%; + font: 13px/20px Arial, Helvetica, sans-serif +} + +a:link { + text-decoration: none; + color: #09569d; +} + +#preamble hr{ + margin-left: 0%; + margin-right: 0%; +} + +#preamble .sectionbody table { + font-weight: 200; + margin-left: 4%; + margin-right: 4%; +} + +hr { + margin-bottom: 12px; +} + +table.tableblock.frame-all.grid-all.spread { + font-size: 12px; +} + +code { + font-size:.9em; + border: 1px solid #eaeaea; + background-color: #f6f6f6; + border-radius: 3px; + padding: 1px; + padding-left:2px; + padding-right:2px; +} + +pre.prettyprint.highlight { + border: 1px solid #eaeaea; + background-color: #f6f6f6; + border-radius: 4px; + padding: 8px; + padding-top:4px; + padding-bottom:4px; +} + +.language-oac_no_warn { + font-size:.9em; + color:#222; + background-color: transparent; +} + +#doc-title { + margin-left: 4%; +} + +#top-nav { + margin-left: 4%; + font-size: 12px; +} + +#bottom-nav { + margin-left: 4%; + font-size: 12px; +} + +.vector-font { + color:grey; + font-size: 20px; +} + +#copyright { + padding-top: 10px; + padding-bottom: 4px; + display: table; + margin:0 auto; + color: grey; + font-size: 12px; + vertical-align: middle; +} + +.beta {color: #FF0000} + +/* GENERAL ELEMENT TYPE STYLES */ + +/* #Media Queries +================================================== */ +/* Smaller than standard 960 (devices and browsers) */ +/* Tablet Portrait size to standard 960 (devices and browsers) */ +@media only screen and (min-width: 768px) and (max-width: 959px) { .inner { width: 740px; } + header h1, header h2 { width: 340px; } + header h1 { font-size: 60px; } + header h2 { font-size: 30px; } +} +/* All Mobile Sizes (devices and browser) */ +@media only screen and (max-width: 767px) { .inner { width: 93%; } + header { padding: 20px 0; } + header .inner { position: relative; } + header h1, header h2 { width: 100%; } + header h1 { font-size: 48px; } + header h2 { font-size: 24px; } + header a.button { position: relative; display: inline-block; width: auto; height: auto; padding: 5px 10px; margin-top: 15px; font-size: 13px; line-height: 1; color: #2879d0; text-align: center; background-color: #9ddcff; background-image: none; border-radius: 5px; -moz-border-radius: 5px; -webkit-border-radius: 5px; } + header a.button small { display: inline; font-size: 13px; } +} +/* Mobile Landscape Size to Tablet Portrait (devices and browsers) */ +/* Mobile Portrait Size to Mobile Landscape Size (devices and browsers) */ + +header h1 { padding-top: 14px; font-size: 2em; font-weight: 200; line-height: 1.4; color: #FFFFFF; letter-spacing: 0px; border-bottom: 0px; } + +header h2 { font-size: 1.2em; margin-top: 0; margin-bottom: 0; font-weight: 200; line-height: .8; color: #ec7D11; letter-spacing: 0; } + +//header a.button { background: transparent url(../images/logo.png) 0 0 no-repeat; padding-left: 32px; } + +header a:hover { text-decoration: none; } + +/* Admonition (Note) block */ +.admonitionblock > table { + border: 0; + background: none; + width: 100%; + table-layout: auto; + margin-bottom: 10.5px; +} +.admonitionblock > table td.icon { + text-align: center; + width: 60px; +} +.admonitionblock > table td.icon img { + max-width: none; +} +.admonitionblock > table td.icon .title { + text-transform: uppercase; +} +.admonitionblock > table td.content { + padding-left: 1em; + padding-right: 1em; + border-left: 3px solid #ddd; +} +.admonitionblock > table td.content > :last-child > :last-child { + margin-bottom: 0; +} +.admonitionblock td.icon [class^="fa icon-"]:before { + font-size: 2.5em; + text-shadow: 1px 1px 2px rgba(0, 0, 0, 0.5); + cursor: default; +} +.admonitionblock td.icon .icon-note:before { + content: "\f05a"; + color: #5bc0de; +}
diff --git a/tck/tck-docs/userguide/src/main/jbake/assets/img/eclipse_foundation_logo_tiny.png b/tck/tck-docs/userguide/src/main/jbake/assets/img/eclipse_foundation_logo_tiny.png new file mode 100644 index 0000000..ee830ae --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/assets/img/eclipse_foundation_logo_tiny.png Binary files differ
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/README b/tck/tck-docs/userguide/src/main/jbake/content/README new file mode 100644 index 0000000..05fa2c2 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/README
@@ -0,0 +1,77 @@ +The file attributes.conf defines several attributes (variables) that +need to be customized for each technology. + +The *.adoc files should not be modified. + +The following "include" files should be customized as necessary +for the specific technology: + +- rules.inc + + Additional compatibility rules needed by some technologies. + The rules in rules.adoc should NOT be changed. + +- defns.inc + + Additional definitions needed by additional compatibility + rules in rules.inc. + +- config.inc + + Detailed instructions for configuring the TCK, included in + Chapter 4. Unfortunately, these are sections 4.1 - 4.3, + so even if the TCK doesn't require 3 sections you need to + make up something, or else change the sections to "N/A". + +- packages.inc + + A simple list of Jakarta EE package names for the technology. + +- tck-packages.inc + + A list of additional software packages included in the TCK. + +- req-software.inc + + A list of software required in addition to the TCK and CI. + +- install-server.inc + + Steps to install the Jakarta EE CI, if needed. + For standalone technologies, no server may be required, + and this file can be empty. + This is used in install.adoc in section 3.2. + +- install-server-vi.inc + + Steps to install a Vendor's web server, if needed. + For standalone technologies, no web server may be required, + and this file can be empty. + This is used in install.adoc in section 3.2. + +- using-examples.inc + + Command line examples showing how to run the TCK. + +- using.inc + + Optional additional instructions for running the TCK. + +- debug-tips.inc + + Technology-specific troubleshooting tips for Chapter 6. + If this isn't needed, it can be an empty file, but toc.adoc + will need to be fixed. + +- rebuild.inc + + Special instructions for rebuilding the WAR files used by some TCKs. + If needed, customize it appropriately and define the "rebuild" + attribute in attributes.conf. + +- title.inc + Add acronym references as required do distinguish between legacy and + current APIs. + +Note that this template is NOT sufficient for the Jakarta EE platform +or Jakarta EE Web Profile.
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/attributes.conf b/tck/tck-docs/userguide/src/main/jbake/content/attributes.conf new file mode 100644 index 0000000..aca3910 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/attributes.conf
@@ -0,0 +1,35 @@ +:TechnologyFullName: Jakarta JSON Processing +:TechnologyShortName: JSON Processing +:LegacyAcronym: JSONP +:ReleaseDate: December 2021 +:CopyrightDates: 2017, 2021 +:TechnologyVersion: 2.1 +:TechnologyRI: Eclipse JSON Processing 2.1.0 +:TechnologyRIURL: https://projects.eclipse.org/projects/ee4j.jsonp +:SpecificationURL: https://jakarta.ee/specifications/jsonp/2.1/ +:TCKInquiryList: mailto:jsonp-dev@eclipse.org[jsonp-dev@eclipse.org] +:SpecificationInquiryList: mailto:jsonp-dev@eclipse.org[jsonp-dev@eclipse.org] +:techID: JSONP +// Define this attribute (uncomment it) if the TCK includes no API tests. (Rare.) +// :no-api-tests: +// Define this attribute (uncomment it) if the TCK includes end-to-end tests. +// :end-to-end-tests: +// Define this attribute (uncomment it) if subsets of the API are allowed. +// (Common Annotations only) +// :subset-allowed: +// +// The environment variable used to specify the home directory +// for the technology. Used in config.inc. +:TechnologyHomeEnv: JSONP_HOME +// Java SE version required. +:SEversion: 11 +:JakartaEEVersion: 10.0 +:jteFileName: <TS_HOME>/bin/ts.jte +:excludeListFileName: tck-docs/TCK-Exclude-List.txt +:TCKPackageName: jakarta-jsonp-tck-2.1.0.zip +// Directory names used in examples in using.adoc. +:sigTestDirectoryExample: jakarta/jsonp/tck/signaturetest/jsonp +:singleTestDirectoryExample: jakarta/jsonp/tck/api/jsoncoding +:subsetTestDirectoryExample: jakarta/jsonp/tck/api/ +// Define this attribute (uncomment it) if the TCK needs the rebuild appendix. +// :rebuild:
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/config.adoc b/tck/tck-docs/userguide/src/main/jbake/content/config.adoc new file mode 100644 index 0000000..5b0ec59 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/config.adoc
@@ -0,0 +1,200 @@ +type=page +status=published +title=Setup and Configuration +next=using.html +prev=install.html +~~~~~~ +include::attributes.conf[] +Setup and Configuration +======================= + +[[GBFVV]] + + + +[[setup-and-configuration]] +4 Setup and Configuration +------------------------- + + +[NOTE] +==== +The Jakarta EE Specification process provides for any number of compatible implementations. +As additional implementations become available, refer to project or product documentation from +those vendors for specific TCK setup and operational guidance. + +==== + +This chapter describes how to set up the {TechnologyShortName} TCK . +Before proceeding with the instructions in +this chapter, be sure to install all required software, as described in +link:install.html#GBFTP[Chapter 3, "Installation."] + +After completing the instructions in this chapter, proceed to +link:using.html#GBFWO[Chapter 5, "Executing Tests,"] for instructions on +running the {TechnologyShortName} TCK. + +[NOTE] +==== +The {TechnologyShortName} TCK is not depended on any particular build +tool to run the tests. It will be convenient and advisable to create a +Apache Maven project to setup and run the TCK. +This chapter will henceforth use instructions and steps to provide setup +with Apache Maven as a build tool. +==== + +/////////////////////////////////////////////////////////////////////// +NOTE TO WRITERS: +The following sections should be customized for the technology. +This text was originally from the JAX-RS TCK. Most references +to JAX-RS have been parameterized to serve as a simple starting +point for customization. There are still many details that will +need to be changed or removed. The major sections 4.1, 4.2, and +4.3 should be preserved. If their titles are changed, the links +at the top of config.adoc will need to be changed as well as well +as toc.adoc. +/////////////////////////////////////////////////////////////////////// + +[[GBFVU]][[configuring-your-environment-to-run-the-tck-against-the-reference-implementation]] + +4.1 Configuring Your Environment to Run the TCK Against the Compatible Implementation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +After configuring your environment as described in this section, +continue with the instructions in link:#GBFUY[Section 4.6, "Using the +JavaTest Harness Software."] + + +[NOTE] +======================================================================= + +In these instructions, variables in angle brackets need to be expanded +for each platform. For example, `<JAVA_HOME>` becomes `$JAVA_HOME` on +Solaris/Linux and `%JAVA_HOME%` on Windows. In addition, the forward +slashes (`/`) used in all of the examples need to be replaced with +backslashes (`\`) for Windows. Finally, be sure to use the appropriate +separator for your operating system when specifying multiple path +entries (`;` on Windows, `:` on UNIX/Linux). + +On Windows, you must escape any backslashes with an extra backslash in +path separators used in any of the following properties, or use forward +slashes as a path separator instead. + +======================================================================= + + +1. Set the following environment variables in your shell environment: + a. `JAVA_HOME` to the directory in which Java SE 8 or 11 is installed + b. `M2_HOME` to the directory in which the Apache Maven build tool is installed. + c. +{TechnologyHomeEnv}+ to the directory in which the {TechnologyShortName} + {TechnologyVersion} CI has been installed + d. `PATH` to include the following directories: `JAVA_HOME/bin`, + and `M2_HOME/bin` +2. Set the following System properties: + a. `jakarta.json.provider` property is set to run the {TechnologyShortName} TCK + pluggability tests to test the SPI provider interface. + This property should only be set when running the pluggability tests. All other tests use the + provider supplied with the {TechnologyShortName} {TechnologyVersion} implementation under test. + b. `jimage.dir` property is set to extract the JDK9+ modules for running the signature tests. + +3. Set the below jars to the classpath + a. JAR file for the {TechnologyShortName} {TechnologyVersion} API. + + `jakarta.json-2.1.0.jar`. + c. JUnit 5 jars (5.7.2+) + Maven cordinates : ++ +[source,oac_no_warn] +---- + <dependency> + <groupId>org.junit</groupId> + <artifactId>junit-bom</artifactId> + <version>5.7.2</version> + <type>pom</type> + <scope>import</scope> + </dependency> +---- ++ + d. sigtest-maven-plugin (1.4) to run the signature tests. + Maven cordinates : ++ +[source,oac_no_warn] +---- + <dependency> + <groupId>org.netbeans.tools</groupId> + <artifactId>sigtest-maven-plugin</artifactId> + <version>1.4</version> + </dependency> +---- ++ + + +[[GCLHU]][[configuring-your-environment-to-repackage-and-run-the-tck-against-the-vendor-implementation]] + +4.2 Configuring Your Environment to Repackage and Run the TCK Against the Vendor Implementation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +After configuring your environment as described in this section, +continue with the instructions in link:#GBFWO[Chapter 5, "Executing Tests."] + + + +[NOTE] +======================================================================= + +In these instructions, variables in angle brackets need to be expanded +for each platform. For example, `<JAVA_HOME>` becomes `$JAVA_HOME` on +Solaris/Linux and `%JAVA_HOME%` on Windows. In addition, the forward +slashes (`/`) used in all of the examples need to be replaced with +backslashes (`\`) for Windows. Finally, be sure to use the appropriate +separator for your operating system when specifying multiple path +entries (`;` on Windows, `:` on UNIX/Linux). + +On Windows, you must escape any backslashes with an extra backslash in +path separators used in any of the following properties, or use forward +slashes as a path separator instead. + +======================================================================= + + + +1. Set the following environment variables in your shell environment: + a. `JAVA_HOME` to the directory in which Java SE 8 or 11 is installed + b. `M2_HOME` to the directory in which the Apache Maven build tool is installed. + c. +{TechnologyHomeEnv}+ to the directory in which the {TechnologyShortName} + {TechnologyVersion} CI has been installed + d. `PATH` to include the following directories: `JAVA_HOME/bin`, + and `M2_HOME/bin` +2. Set the following System properties: + a. `jakarta.json.provider` property is set to run the {TechnologyShortName} TCK + pluggability tests to test the SPI provider interface. + This property should only be set when running the pluggability tests. All other tests use the + provider supplied with the {TechnologyShortName} {TechnologyVersion} implementation under test. + b. jimage.dir property is set to extract the JDK9+ modules for running the signature tests. + +3. Set the below jars to the classpath + a. JAR file for the {TechnologyShortName} {TechnologyVersion} API. + + `jakarta.json-2.1.0.jar`. + c. JUnit 5 jars (5.7.2+) + Maven cordinates : ++ +[source,oac_no_warn] +---- + <dependency> + <groupId>org.junit</groupId> + <artifactId>junit-bom</artifactId> + <version>5.7.2</version> + <type>pom</type> + <scope>import</scope> + </dependency> +---- ++ + + +[[GHGDG]][[publishing-the-test-applications]] + +4.3 Publishing the Test Applications +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Not needed for the {TechnologyShortName} TCK. + +
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/debug-tips.inc b/tck/tck-docs/userguide/src/main/jbake/content/debug-tips.inc new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/debug-tips.inc
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/debug.adoc b/tck/tck-docs/userguide/src/main/jbake/content/debug.adoc new file mode 100644 index 0000000..3aebb42 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/debug.adoc
@@ -0,0 +1,72 @@ +type=page +status=published +title=Debugging Test Problems +next=faq.html +prev=using.html +~~~~~~ +include::attributes.conf[] +Debugging Test Problems +======================= + +[[GBFUV]] + + +[[debugging-test-problems]] +6 Debugging Test Problems +------------------------- + +There are a number of reasons that tests can fail to execute properly. +This chapter provides some approaches for dealing with these failures. +Please note that most of these suggestions are only relevant when +running the test harness in GUI mode. + +This chapter includes the following topics: + +* link:#GBFYP[Overview] +* link:#GBFVF[Test Tree] +* link:#GBFWI[Folder Information] +* link:#GBFVP[Test Information] +* link:#GBFVZ[Report Files] +* link:#GBFYF[Configuration Failures] + +[[GBFYP]][[overview]] + +6.1 Overview +~~~~~~~~~~~~ + +The goal of a test run is for all tests in the test suite that are not +filtered out to have passing results. If the root test suite folder +contains tests with errors or failing results, you must troubleshoot and +correct the cause to satisfactorily complete the test run. + +* Errors: Tests with errors could not be executed by the Junit +framework. These errors usually occur because the test environment is not +properly configured. +* Failures: Tests that fail were executed but had failing results. + + +For every test run, the Junit framework creates a set of report files +in the target directory. + + +If a large number of tests failed, you should read +link:#GBFYF[Configuration Failures] to see if a +configuration issue is the cause of the failures. + + +If a large number of tests failed, you should read +link:#GBFYF[Configuration Failures] to see if a +configuration issue is the cause of the failures. + + + +[[GBFYF]][[configuration-failures]] + +6.2 Configuration Failures +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Configuration failures are easily recognized because many tests fail the +same way. When all your tests begin to fail, you may want to stop the +run immediately and start viewing individual test output. + +include::debug-tips.inc[]
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/defns.inc b/tck/tck-docs/userguide/src/main/jbake/content/defns.inc new file mode 100644 index 0000000..038db2d --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/defns.inc
@@ -0,0 +1,46 @@ +// NOTE TO WRITERS: +// Most technologies will only need the compatibility rules in rules.adoc. +// Some technologies will need additional definitions to go with additional +// rules. If they're needed, remove the comment characters below +// and update the definitions as appropriate. +// +// The first block below is additional definitions needed by +// Jakarta XML Web Services. +// +// The second block below is additional defintions needed by +// Jakarta Server Pages. +// +// NOTE: This set of examples is NOT complete, but should be. +// +// +// Jakarta XML Web Services +// +// |Development Kit |A software product that implements or incorporates a +// Compiler, a Schema Compiler, a Schema Generator, a Java-to-WSDL Tool, a +// WSDL-to-Java Tool, and/or an RMI Compiler. +// +// |Java-to-WSDL Output |Output of a Java-to-WSDL Tool that is required for +// Web service deployment and invocation. +// +// |Java-to-WSDL Tool |A software development tool that implements or +// incorporates a function that generates web service endpoint descriptions +// in WSDL and XML schema format from Source Code as specified by the +// Jakarta XML Web Services Specification. +// +// |WSDL-to-Java Output |Output of a WSDL-to-Java tool that is required for +// Web service deployment and invocation. +// +// |WSDL-to-Java Tool |A software development tool that implements or +// incorporates a function that generates web service interfaces for +// clients and endpoints from a WSDL description as specified by the +// Jakarta XML Web Services Specification. +// +// +// Jakarta Server Pages +// +// |Jakarta Server Page |A text-based document that uses Jakarta Server +// Pages technology. +// +// |Jakarta Server Page Implementation Class |A program constructed by +// transforming the Jakarta Server Page text into a Java language program +// using the transformation rules described in the Specifications.
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/faq.adoc b/tck/tck-docs/userguide/src/main/jbake/content/faq.adoc new file mode 100644 index 0000000..f076a9e --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/faq.adoc
@@ -0,0 +1,62 @@ +type=page +status=published +title=Appendix A: Frequently Asked Questions +next=rebuild.html +prev=debug.html +~~~~~~ +include::attributes.conf[] +Appendix A: Frequently Asked Questions +====================================== + +[[GBFYD]] + + +[[a-frequently-asked-questions]] +A Frequently Asked Questions +---------------------------- + +This appendix contains the following questions. + +* link:#GBFYQ[Where do I start to debug a test failure?] +* link:#GBFYR[How do I restart a crashed test run?] +* link:#GBFWU[What would cause tests be added to the exclude list?] + +[[GBFYQ]][[a.1-where-do-i-start-to-debug-a-test-failure]] + +A.1 Where do I start to debug a test failure? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +From the JavaTest GUI, you can view recently run tests using the Test +Results Summary, by selecting the red Failed tab or the blue Error tab. +See link:debug.html#GBFUV[Chapter 6, "Debugging Test Problems,"] for more +information. + +[[GBFYR]][[a.2-how-do-i-restart-a-crashed-test-run]] + +A.2 How do I restart a crashed test run? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +If you need to restart a test run, you can figure out which test crashed +the test suite by looking at the `harness.trace` file. The +`harness.trace` file is in the report directory that you supplied to the +JavaTest GUI or parameter file. Examine this trace file, then change the +JavaTest GUI initial files to that location or to a directory location +below that file, and restart. This will overwrite only `.jtr` files that +you rerun. As long as you do not change the value of the GUI work +directory, you can continue testing and then later compile a complete +report to include results from all such partial runs. + +[[GBFWU]][[a.3-what-would-cause-tests-be-added-to-the-exclude-list]] + +A.3 What would cause tests be added to the exclude list? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The JavaTest exclude file (+{excludeListFileName}+) contains all tests that are not +required to be run. The following is a list of reasons for a test to be +included in the Exclude List: + +* An error in a Compatible Implementation that does not allow the test to +execute properly has been discovered. +* An error in the specification that was used as the basis of the test +has been discovered. +* An error in the test has been discovered.
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/install-server-vi.inc b/tck/tck-docs/userguide/src/main/jbake/content/install-server-vi.inc new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/install-server-vi.inc
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/install-server.inc b/tck/tck-docs/userguide/src/main/jbake/content/install-server.inc new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/install-server.inc
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/install.adoc b/tck/tck-docs/userguide/src/main/jbake/content/install.adoc new file mode 100644 index 0000000..5a2a40d --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/install.adoc
@@ -0,0 +1,91 @@ +type=page +status=published +title=Installation +next=config.html +prev=rules.html +~~~~~~ +include::attributes.conf[] +Installation +============ + +[[GBFTP]] + + +[[installation]] +3 Installation +-------------- + +This chapter explains how to install the {TechnologyFullName} TCK software. + +After installing the software according to the instructions in this +chapter, proceed to link:config.html#GBFVV[Chapter 4, "Setup and +Configuration,"] for instructions on configuring your test environment. + +[NOTE] +======================================================================= + +Although the {TechnologyShortName} {TechnologyVersion} TCK is not +depended on any particular build tool, it is convenient to install +Apache Maven {MavenVersion} for setup and execution of tests. +Any other build tools like Gradle and JUnit 5 Console Runner can also +be used that is Jupiter API compatible. + +======================================================================= + +[[GBFUD]][[obtaining-the-reference-implementation]] + +3.1 Obtaining a Compatible Implementation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Each compatible implementation (CI) will provide instructions for obtaining +their implementation. +{TechnologyRI} is a compatible implementation which may be obtained +from {TechnologyRIURL} + +[[GBFTS]][[installing-the-software]] + +3.2 Installing the Software +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Before you can run the {TechnologyShortName} TCK tests, you must +install and set up the following software components: + +include::req-software.inc[] +* Java SE {SEversion} +* A CI for {TechnologyShortName} {TechnologyVersion}, one example is {TechnologyRI} +* The {TechnologyShortName} {TechnologyVersion} Vendor Implementation (VI) +* Any Jupiter API compatible test runner (eg. Apache Maven {MavenVersion}) + +Follow these steps: + +. Install the Java SE {SEversion} software, if it is not already installed. + +Download and install the Java SE {SEversion} software from +http://www.oracle.com/technetwork/java/javase/downloads/index.html. +Refer to the installation instructions that accompany the software for +additional information. + +. Install the build tool that will be used to run the TCK, if it is not already installed. + +It will be convenient to use Apache Maven {MavenVersion} for running the tests. The test kit +is not depended on Maven, any build tool compatible with Jupiter API is suffitient. + +. Install the {TechnologyShortName} TCK {TechnologyVersion} software. + a. Copy or download the {TechnologyShortName} TCK software to your + local system. + + You can obtain the {TechnologyShortName} TCK software from the + Jakarta EE site {SpecificationURL}. + b. Use the `unzip` command to extract the bundle in the directory of + your choice: + + +unzip {TCKPackageName}+ + + +include::install-server.inc[] +. Install a {TechnologyShortName} {TechnologyVersion} Compatible +Implementation. + +A Compatible Implementation is used to validate your initial +configuration and setup of the {TechnologyShortName} TCK +{TechnologyVersion} tests, which are explained further in +link:config.html#GBFVV[Chapter 4, "Setup and Configuration."] + +The Compatible Implementations for {TechnologyShortName} are listed on +the Jakarta EE Specifications web site: {SpecificationURL}. +include::install-server-vi.inc[] +. Install the {TechnologyShortName} VI to be tested. + +Follow the installation instructions for the particular VI under test.
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/intro.adoc b/tck/tck-docs/userguide/src/main/jbake/content/intro.adoc new file mode 100644 index 0000000..bc2ad0e --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/intro.adoc
@@ -0,0 +1,313 @@ +type=page +status=published +title=Introduction +next=rules.html +prev=preface.html +~~~~~~ +include::attributes.conf[] +Introduction +============ + +[[GBFOW]] + + +[[introduction]] +1 Introduction +-------------- + +This chapter provides an overview of the principles that apply +generally to all Technology Compatibility Kits (TCKs) and describes the +{TechnologyFullName} TCK ({TechnologyShortName} {TechnologyVersion} TCK). +It also includes a high level listing +of what is needed to get up and running with the {TechnologyShortName} +TCK. + +This chapter includes the following topics: + +* link:#GBFTK[Compatibility Testing] +* link:#GBFQR[About the TCK] +* link:#GBFQW[Getting Started With the TCK] + +[[GBFTK]][[compatibility-testing]] + +1.1 Compatibility Testing +~~~~~~~~~~~~~~~~~~~~~~~~~ + +Compatibility testing differs from traditional product testing in a +number of ways. The focus of compatibility testing is to test those +features and areas of an implementation that are likely to differ across +other implementations, such as those features that: + +* Rely on hardware or operating system-specific behavior +* Are difficult to port +* Mask or abstract hardware or operating system behavior + +Compatibility test development for a given feature relies on a complete +specification and compatible implementation (CI) for that feature. +Compatibility testing is not primarily concerned with robustness, +performance, nor ease of use. + +[[GBFQN]][[why-compatibility-testing-is-important]] + +1.1.1 Why Compatibility Testing is Important +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Jakarta platform compatibility is important to different groups involved +with Jakarta technologies for different reasons: + +* Compatibility testing ensures that the Jakarta platform does not become +fragmented as it is ported to different operating systems and hardware +environments. +* Compatibility testing benefits developers working in the Jakarta +programming language, allowing them to write applications once and then +to deploy them across heterogeneous computing environments without +porting. +* Compatibility testing allows application users to obtain applications +from disparate sources and deploy them with confidence. +* Conformance testing benefits Jakarta platform implementors by ensuring a +level playing field for all Jakarta platform ports. + +[[GBFPR]][[tck-compatibility-rules]] + +1.1.2 TCK Compatibility Rules +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Compatibility criteria for all technology implementations are embodied +in the TCK Compatibility Rules that apply to a specified technology. +Each TCK tests for adherence to these Rules as described in +link:rules.html#GBFSN[Chapter 2, "Procedure for Certification."] + +[[GBFPW]][[tck-overview]] + +1.1.3 TCK Overview +^^^^^^^^^^^^^^^^^^ + +A TCK is a set of tools and tests used to verify that a vendor's compatible +implementation of a Jakarta EE technology conforms to the applicable +specification. All tests in the TCK are based on the written +specifications for the Jakarta EE platform. A TCK tests compatibility of a +vendor's compatible implementation of the technology to the applicable +specification of the technology. Compatibility testing is a means of +ensuring correctness, completeness, and consistency across all +implementations developed by technology licensees. + +The set of tests included with each TCK is called the test suite. Most +tests in a TCK's test suite are self-checking, but some tests may +require tester interaction. Most tests return either a Pass or Fail +status. For a given platform to be certified, all of the required tests +must pass. The definition of required tests may change from platform to +platform. + +The definition of required tests will change over time. Before your +final certification test pass, be sure to download the latest version +of this TCK. + +[[GBFPB]][[java-community-process-jcp-program-and-compatibility-testing]] + +1.1.4 Jakarta EE Specification Process (JESP) Program and Compatibility Testing +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The Jakarta EE Specification Process (JESP) program is the formalization of the +open process that has been used since 2019 to develop and revise Jakarta EE +technology specifications in cooperation with the international Jakarta EE +community. The JESP program specifies that the following three major +components must be included as deliverables in a final Jakarta EE technology +release under the direction of the responsible Expert Group: + +* Technology Specification +* Compatible Implementation (CI) +* Technology Compatibility Kit (TCK) + +For further information about the JESP program, go to Jakarta EE Specification +Process community page https://jakarta.ee/specifications. + +[[GBFQR]][[about-the-tck]] + +1.2 About the TCK +~~~~~~~~~~~~~~~~~ + +The {TechnologyShortName} TCK {TechnologyVersion} is designed as a +portable, configurable, automated test suite for verifying the +compatibility of a vendor's implementation of the +{TechnologyShortName} {TechnologyVersion} Specification. + +[[GBFQV]][[tck-specifications-and-requirements]] + +1.2.1 TCK Specifications and Requirements +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +This section lists the applicable requirements and specifications. + +* Specification Requirements: Software requirements for a +{TechnologyShortName} implementation are described in detail in the +{TechnologyShortName} {TechnologyVersion} Specification. Links to the +{TechnologyShortName} specification and other product information can +be found at {SpecificationURL}. +* {TechnologyShortName} Version: The {TechnologyShortName} {TechnologyVersion} TCK +is based on the {TechnologyShortName} +Specification, Version {TechnologyVersion}. +* Compatible Implementation: One {TechnologyShortName} +{TechnologyVersion} Compatible Implementation, {TechnologyRI} is +available from the Eclipse EE4J project +(https://projects.eclipse.org/projects/ee4j). See the CI documentation page at +{TechnologyRIURL} for more information. + +See the {TechnologyShortName} TCK Release Notes for more specific +information about Java SE version requirements, supported platforms, +restrictions, and so on. + +[[GBFSQ]][[tck-components]] + +1.2.2 TCK Components +^^^^^^^^^^^^^^^^^^^^ + +The {TechnologyShortName} TCK {TechnologyVersion} includes the +following components: + +* {TechnologyShortName} TCK signature tests; check that all public APIs +are supported and/or defined as specified in the {TechnologyShortName} +Version {TechnologyVersion} implementation under test. +* If applicable, an exclude list, which provides a list of tests that your +implementation is not required to pass. +ifndef::no-api-tests[] +* API tests for all of the {TechnologyShortName} API in all related packages: +include::packages.inc[] +endif::no-api-tests[] +ifdef::end-to-end-tests[] +* End-to-end tests that demonstrate compliance with the {TechnologyFullName} +Specification. +endif::end-to-end-tests[] + +The {TechnologyShortName} TCK tests run on the following platforms: + +include::platforms.inc[] + + + +[[GBFRA]][[tck-compatibility-test-suite]] + +1.2.3 TCK Compatibility Test Suite +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The test suite is the collection of tests used by the JavaTest harness +to test a particular technology implementation. In this case, it is the +collection of tests used by the {TechnologyShortName} TCK +{TechnologyVersion} to test a {TechnologyShortName} {TechnologyVersion} +implementation. The tests are designed to verify that a vendor's +runtime implementation of the technology complies with the appropriate +specification. The individual tests correspond to assertions of the +specification. + +The tests that make up the TCK compatibility test suite are precompiled +and indexed within the TCK test directory structure. When a test run is +started, the JavaTest harness scans through the set of tests that are +located under the directories that have been selected. While scanning, +the JavaTest harness selects the appropriate tests according to any +matches with the filters you are using and queues them up for execution. + +[[GBFSH]][[exclude-lists]] + +1.2.4 Exclude Lists +^^^^^^^^^^^^^^^^^^^ + +Each version of a TCK includes an Exclude List contained in a `TCK-Exclude-List.txt` +file. +This is a list of test file URLs that identify tests which do not +have to be run for the specific version of the TCK being used. +Whenever tests are run, the Junit framework automatically excludes +these tests from being executed as those are disabled using '@Disabled' tag in JUnit. + +A vendor's compatible implementation is not required to pass or run any test on the Exclude List. +The Exclude List file, +{excludeListFileName}+, is documented in the +{TechnologyShortName} TCK. Please note this file is not parsed to exclude any test and is only +for documentation purpose. + + +[NOTE] +======================================================================= + +From time to time, updates to the Exclude List are made available. +The exclude list is included in the TCK ZIP archive. +Each time an update is approved and released, the version number +will be incremented. +You should always make sure you are using an up-to-date copy of the +Exclude List before running the {TechnologyShortName} TCK to verify your +implementation. + +======================================================================= + + +A test might be in the Exclude List for reasons such as: + +* An error in an underlying implementation API has been discovered which +does not allow the test to execute properly. +* An error in the specification that was used as the basis of the test +has been discovered. +* An error in the test itself has been discovered. +* The test fails due to a bug in the tools used to run the test. + +In addition, all tests are run against the compatible implementations. +Any tests that fail when run on a compatible Jakarta platform are put on the +Exclude List. Any test that is not specification-based, or for which the +specification is vague, may be excluded. Any test that is found to be +implementation dependent (based on a particular thread scheduling model, +based on a particular file system behavior, and so on) may be excluded. + + +[NOTE] +======================================================================= + +Vendors are not permitted to alter or modify Exclude Lists. Changes to +an Exclude List can only be made by using the procedure described in +link:rules.html#CJAJEAEI[Section 2.3.1, "TCK Test Appeals Steps."] + +======================================================================= + + +[[GBFRR]][[tck-configuration]] + +1.2.5 TCK Configuration +^^^^^^^^^^^^^^^^^^^^^^^ + +You need to set several variables in your test environment, +and run the {TechnologyShortName} tests, as described in +link:config.html#GBFVV[Chapter 4, "Setup and Configuration."] + +include::intro.inc[] + +[[GBFQW]][[getting-started-with-the-tck]] + +[NOTE] +==== +The Jakarta EE Specification Process support multiple compatible implementations. +These instructions explain how to get started with the {TechnologyRI} CI. +If you are using another compatible implementation, refer to material provided +by that implementation for specific instructions and procedures. + +==== + +1.3 Getting Started With the TCK +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This section provides an general overview of what needs to be done to +install, set up, test, and use the {TechnologyShortName} TCK. These +steps are explained in more detail in subsequent chapters of this +guide. + +1. Make sure that the following software has been correctly installed +on the system hosting the JavaTest harness: +include::req-software.inc[] +* Java SE {SEversion} +* A CI for {TechnologyShortName} {TechnologyVersion}. One example is {TechnologyRI}. +* The {TechnologyShortName} {TechnologyVersion} Vendor Implementation (VI) + +See the documentation for each of these software applications for +installation instructions. See link:install.html#GBFTP[Chapter 3, +"Installation,"] for instructions on installing the {TechnologyShortName} TCK. +2. Set up the {TechnologyShortName} TCK software. + +See link:config.html#GBFVV[Chapter 4, "Setup and Configuration,"] for +details about the following steps. + a. Set up your shell environment. + b. Set the required System properties. +3. Test the {TechnologyShortName} {TechnologyVersion} implementation. + +Test the {TechnologyShortName} implementation installation by running +the test suite. See link:using.html#GBFWO[Chapter 5, "Executing Tests."]
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/intro.inc b/tck/tck-docs/userguide/src/main/jbake/content/intro.inc new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/intro.inc
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/packages.inc b/tck/tck-docs/userguide/src/main/jbake/content/packages.inc new file mode 100644 index 0000000..ec1f4cb --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/packages.inc
@@ -0,0 +1,5 @@ +** `jakarta.json` + +** `jakarta.json.spi` + +** `jakarta.json.stream`
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/platforms.inc b/tck/tck-docs/userguide/src/main/jbake/content/platforms.inc new file mode 100644 index 0000000..236beed --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/platforms.inc
@@ -0,0 +1 @@ +* CentOS Linux 7 \ No newline at end of file
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/preface.adoc b/tck/tck-docs/userguide/src/main/jbake/content/preface.adoc new file mode 100644 index 0000000..7a5b1ec --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/preface.adoc
@@ -0,0 +1,141 @@ +type=page +status=published +title=Preface +next=intro.html +prev=title.html +~~~~~~ +include::attributes.conf[] +Preface +======= + +[[TCJRS00001]][[GBFTI]] + + +[[preface]] +Preface +------- + +This guide describes how to install, configure, and run the Technology +Compatibility Kit (TCK) that is used to test the {TechnologyFullName} +({TechnologyShortName} {TechnologyVersion}) technology. + +The {TechnologyShortName} TCK is a portable, configurable automated +test suite for verifying the compatibility of a vendor's +implementation of the {TechnologyShortName} {TechnologyVersion} +Specification (hereafter referred to as the vendor implementation or VI). +The {TechnologyShortName} TCK uses the Junit framework to run the test suite + + +[NOTE] +======================================================================= + +Note All references to specific Web URLs are given for the sake of your +convenience in locating the resources quickly. These references are +always subject to changes that are in many cases beyond the control of +the authors of this guide. + +======================================================================= + +Jakarta EE is a community sponsored and community run program. +Organizations contribute, along side individual contributors who use, evolve +and assist others. +Commercial support is not available through the Eclipse Foundation resources. +Please refer to the Eclipse EE4J project site +(https://projects.eclipse.org/projects/ee4j). +There, you will find additional details as well as a list of all the associated sub-projects +(Implementations and APIs), that make up Jakarta EE and define these specifications. +If you have questions about this Specification you may +send inquiries to {SpecificationInquiryList}. +If you have questions about this TCK, you may send inquiries to +{TCKInquiryList}. + +[[TCJRS00034]][[GBFUS]] + + +[[who-should-use-this-book]] +Who Should Use This Book +~~~~~~~~~~~~~~~~~~~~~~~~ + +This guide is for vendors that implement the {TechnologyShortName} +{TechnologyVersion} technology to assist them in running the test suite +that verifies compatibility of their implementation of the +{TechnologyShortName} {TechnologyVersion} Specification. + + +[[TCJRS00035]][[GBFPO]] + + +[[before-you-read-this-book]] +Before You Read This Book +~~~~~~~~~~~~~~~~~~~~~~~~~ + +You should be familiar with the {TechnologyShortName} +{TechnologyVersion}, version {TechnologyVersion} Specification, +which can be found at {SpecificationURL}. + +[[TCJRS00036]][[GBFWF]] + + +[[typographic-conventions]] +Typographic Conventions +~~~~~~~~~~~~~~~~~~~~~~~ + +The following table describes the typographic conventions that are used +in this book. + +[width="100%",cols="15%,40%,45%",options="header",] +|======================================================================= +|Convention |Meaning |Example +|*Boldface* |Boldface type indicates graphical user interface elements +associated with an action, terms defined in text, or what you type, +contrasted with onscreen computer output. a| +From the *File* menu, select *Open Project*. + +A *cache* is a copy that is stored locally. + +`machine_name% *su*` + +`Password:` + +|`Monospace` |Monospace type indicates the names of files and +directories, commands within a paragraph, URLs, code in examples, text +that appears on the screen, or text that you enter. a| +Edit your `.login` file. + +Use `ls` `-a` to list all files. + +`machine_name% you have mail.` + +|_Italic_ |Italic type indicates book titles, emphasis, or placeholder +variables for which you supply particular values. a| +Read Chapter 6 in the _User's Guide_. + +Do _not_ save the file. + +The command to remove a file is `rm` _filename_. + +|======================================================================= + + +[[TCJRS00037]][[FWBSD]] + + +[[shell-prompts-in-command-examples]] +Shell Prompts in Command Examples +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The following table shows the default UNIX system prompt and superuser +prompt for the C shell, Bourne shell, and Korn shell. + +[width="100%",cols="50%,50%",options="header",] +|===================================================== +|Shell |Prompt +|C shell |`machine_name%` +|C shell for superuser |`machine_name#` +|Bourne shell and Korn shell |`$` + +|Bourne shell and Korn shell for superuser |`#` + +|Bash shell |`shell_name-shell_version$` +|Bash shell for superuser |`shell_name-shell_version#` +|===================================================== + + +
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/rebuild.adoc b/tck/tck-docs/userguide/src/main/jbake/content/rebuild.adoc new file mode 100644 index 0000000..e4021cf --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/rebuild.adoc
@@ -0,0 +1,20 @@ +type=page +status=published +title=Appendix B: Rebuild Rules +prev=faq.html +~~~~~~ +include::attributes.conf[] + +Appendix B: Rebuild Rules +========================= + + +ifdef::rebuild[] +include::rebuild.inc[] +endif::rebuild[] +ifndef::rebuild[] + +<<< +Appendix B is not used for the {TechnologyShortName} TCK. + +endif::rebuild[]
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/rebuild.inc b/tck/tck-docs/userguide/src/main/jbake/content/rebuild.inc new file mode 100644 index 0000000..3fa38ef --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/rebuild.inc
@@ -0,0 +1,7 @@ +/////////////////////////////////////////////////////////////////////// +NOTE TO WRITERS: +The following sections should be customized for the technology. +See the JAXRS for an example of this include file +/////////////////////////////////////////////////////////////////////// + +[[GCLIZ]]
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/req-software.inc b/tck/tck-docs/userguide/src/main/jbake/content/req-software.inc new file mode 100644 index 0000000..48014f5 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/req-software.inc
@@ -0,0 +1,10 @@ +/////////////////////////////////////////////////////////////////////// +NOTE TO WRITERS: +This is a list of software required in addition to the TCK and the RI. +For many Java EE APIs, the Java EE RI will be required, as described below. +For standalone technologies, no other software may be required, and the +below line can be removed. + +This is used in intro.adoc in section 1.3 and install.adoc in section 3.2. +/////////////////////////////////////////////////////////////////////// +
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/rules.adoc b/tck/tck-docs/userguide/src/main/jbake/content/rules.adoc new file mode 100644 index 0000000..f6b08ce --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/rules.adoc
@@ -0,0 +1,403 @@ +type=page +status=published +title=Procedure for Certification +next=install.html +prev=intro.html +~~~~~~ +include::attributes.conf[] +Procedure for Certification +=========================== + +[[GBFSN]] + + +[[procedure-for-certification]] +2 Procedure for Certification +----------------------------- + +This chapter describes the compatibility testing procedure and +compatibility requirements for {TechnologyFullName}. +This chapter contains the following sections: + +* link:#CJAFFDGI[Certification Overview] +* link:#CJAFGIGG[Compatibility Requirements] +* link:#CJAIIBDJ[Test Appeals Process] +* link:#CJAJECIE[Specifications for {TechnologyFullName}] +* link:#CJABAHGI[Libraries for {TechnologyFullName}] + +[[CJAFFDGI]][[certification-overview]] + +2.1 Certification Overview +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The certification process for {technologyShortName} {TechnologyVersion} +consists of the following activities: + +* Install the appropriate version of the Technology Compatibility Kit +(TCK) and execute it in accordance with the instructions in this User's +Guide. +* Ensure that you meet the requirements outlined in +link:#CJAFGIGG[Compatibility Requirements] below. +* Certify to the Eclipse Foundation that you have finished +testing and that you meet all of the compatibility requirements, +as required by the Eclipse Foundation TCK License. + +[[CJAFGIGG]][[compatibility-requirements]] + +2.2 Compatibility Requirements +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The compatibility requirements for {TechnologyShortName} +{TechnologyVersion} consist of meeting the requirements set forth by +the rules and associated definitions contained in this section. + +[[sthref4]][[definitions]] + +2.2.1 Definitions +^^^^^^^^^^^^^^^^^ + +These definitions are for use only with these compatibility requirements +and are not intended for any other purpose. + +[[sthref5]][[sthref6]] + +Table 2-1 Definitions + +[width="100%",cols="25%,75%",options="header",] +|======================================================================= +|Term |Definition +|API Definition Product |A Product for which the only Java class files +contained in the product are those corresponding to the application +programming interfaces defined by the Specifications, and which is +intended only as a means for formally specifying the application +programming interfaces defined by the Specifications. + +|Computational Resource a| +A piece of hardware or software that may vary in quantity, existence, or +version, which may be required to exist in a minimum quantity and/or at +a specific or minimum revision level so as to satisfy the requirements +of the Test Suite. + +Examples of computational resources that may vary in quantity are RAM +and file descriptors. + +Examples of computational resources that may vary in existence (that is, +may or may not exist) are graphics cards and device drivers. + +Examples of computational resources that may vary in version are +operating systems and device drivers. + +|Configuration Descriptor |Any file whose format is well defined by a +specification and which contains configuration information for a set of +Java classes, archive, or other feature defined in the specification. + +|Conformance Tests |All tests in the Test Suite for an indicated +Technology Under Test, as released and distributed by the +Eclipse Foundation, excluding those tests on the +published Exclude List for the Technology Under Test. + +|Container |An implementation of the associated Libraries, as specified +in the Specifications, and a version of a Java Platform, Standard +Edition Runtime Product, as specified in the Specifications, or a later +version of a Java Platform, Standard Edition Runtime Product that also +meets these compatibility requirements. + +|Documented |Made technically accessible and made known to users, +typically by means such as marketing materials, product documentation, +usage messages, or developer support programs. + +|Exclude List |The most current list of tests, released and distributed by the +Eclipse Foundation, that are not required to be passed to certify +conformance. The Jakarta EE Specification Committee may add to the Exclude List for that +Test Suite as needed at any time, in which case the updated TCK version +supplants any previous Exclude Lists for that Test Suite. + +|Libraries a| +The class libraries, as specified through the Jakarta EE Specification Process +(JESP), for the Technology Under Test. + +The Libraries for {TechnologyFullName} are listed at the end of this chapter. + +|Location Resource a| +A location of classes or native libraries that are components of the +test tools or tests, such that these classes or libraries may be +required to exist in a certain location in order to satisfy the +requirements of the test suite. + +For example, classes may be required to exist in directories named in a +CLASSPATH variable, or native libraries may be required to exist in +directories named in a PATH variable. + +|Maintenance Lead |The corresponding Jakarta EE Specification Project +is responsible for maintaining the Specification, and the TCK for the +Technology. The Specification Project Team will propose revisions and +updates to the Jakarta EE Specification Committee which will approve +and release new versions of the specification and TCK. + +|Operating Mode a| +Any Documented option of a Product that can be changed by a user in +order to modify the behavior of the Product. + +For example, an Operating Mode can be binary (enable/disable +optimization), an enumeration (select from a list of protocols), or a +range (set the maximum number of active threads). + +Note that an Operating Mode may be selected by a command line switch, an +environment variable, a GUI user interface element, a configuration or +control file, etc. + +|Product |A vendor's product in which the Technology Under Test is +implemented or incorporated, and that is subject to compatibility +testing. + +|Product Configuration a| +A specific setting or instantiation of an Operating Mode. + +For example, a Product supporting an Operating Mode that permits user +selection of an external encryption package may have a Product +Configuration that links the Product to that encryption package. + +|Rebuildable Tests |Tests that must be built using an +implementation-specific mechanism. This mechanism must produce +specification-defined artifacts. Rebuilding and running these tests +against a known compatible implementation verifies that the mechanism generates +compatible artifacts. + +|Resource |A Computational Resource, a Location Resource, or a Security +Resource. + +|Rules |These definitions and rules in this Compatibility Requirements +section of this User's Guide. + +|Runtime |The Containers specified in the Specifications. + +|Security Resource a| +A security privilege or policy necessary for the proper execution of the +Test Suite. + +For example, the user executing the Test Suite will need the privilege +to access the files and network resources necessary for use of the +Product. + +|Specifications a| +The documents produced through the Jakarta EE Specification Process (JESP) +that define a particular Version of a Technology. + +The Specifications for the Technology Under Test are referenced later in +this chapter. + +|Technology |Specifications and one or more compatible implementations produced +through the Jakarta EE Specification Process (JESP). + +|Technology Under Test |Specifications and a compatible implementation +for {TechnologyFullName} Version {TechnologyVersion}. + +|Test Suite |The requirements, tests, and testing tools distributed by +the Maintenance Lead as applicable to a given Version of the Technology. + +|Version |A release of the Technology, as produced through the +Jakarta EE Specification Process (JESP). + +include::defns.inc[] +|======================================================================= + + +[[sthref7]][[rules-for-products]] + +2.2.2 Rules for {TechnologyFullName} Products +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The following rules apply for each version of an operating system, +software component, and hardware platform Documented as supporting the +Product: + +*{techID}1* The Product must be able to satisfy all applicable compatibility +requirements, including passing all Conformance Tests, in every Product +Configuration and in every combination of Product Configurations, except +only as specifically exempted by these Rules. + +For example, if a Product provides distinct Operating Modes to optimize +performance, then that Product must satisfy all applicable compatibility +requirements for a Product in each Product Configuration, and +combination of Product Configurations, of those Operating Modes. + +*{techID}1.1* If an Operating Mode controls a Resource necessary for the +basic execution of the Test Suite, testing may always use a Product +Configuration of that Operating Mode providing that Resource, even if +other Product Configurations do not provide that Resource. +Notwithstanding such exceptions, each Product must have at least one set +of Product Configurations of such Operating Modes that is able to pass +all the Conformance Tests. + +For example, a Product with an Operating Mode that controls a security +policy (i.e., Security Resource) which has one or more Product +Configurations that cause Conformance Tests to fail may be tested using +a Product Configuration that allows all Conformance Tests to pass. + +*{techID}1.2* A Product Configuration of an Operating Mode that causes the +Product to report only version, usage, or diagnostic information is +exempted from these compatibility rules. + +*{techID}1.3* An API Definition Product is exempt from all functional +testing requirements defined here, except the signature tests. + +*{techID}2* Some Conformance Tests may have properties that may be changed. +Properties that can be changed are identified in the configuration +interview. Properties that can be changed are identified in the JavaTest +Environment (.jte) files in the Test Suite +installation. Apart from changing such properties and other allowed +modifications described in this User's Guide (if any), no source or +binary code for a Conformance Test may be altered in any way without +prior written permission. Any such allowed alterations to the +Conformance Tests will be provided via the Jakarta EE Specification Project +website and apply to all vendor compatible implementations. + +*{techID}3* The testing tools supplied as part of the Test Suite or as +updated by the Maintenance Lead must be used to certify compliance. + +*{techID}4* The Exclude List associated with the Test Suite cannot be +modified. + +*{techID}5* The Maintenance Lead can define exceptions to these Rules. Such +exceptions would be made available as above, and will apply to all vendor implementations. + +*{techID}6* All hardware and software component additions, deletions, and +modifications to a Documented supporting hardware/software platform, +that are not part of the Product but required for the Product to satisfy +the compatibility requirements, must be Documented and available to +users of the Product. + +For example, if a patch to a particular version of a supporting +operating system is required for the Product to pass the Conformance +Tests, that patch must be Documented and available to users of the +Product. + +*{techID}7* The Product must contain the full set of public and protected +classes and interfaces for all the Libraries. Those classes and +interfaces must contain exactly the set of public and protected methods, +constructors, and fields defined by the Specifications for those +Libraries. No subsetting, supersetting, or modifications of the public +and protected API of the Libraries are allowed except only as +specifically exempted by these Rules. + +*{techID}7.1* If a Product includes Technologies in addition to the +Technology Under Test, then it must contain the full set of combined +public and protected classes and interfaces. The API of the Product +must contain the union of the included Technologies. No further +modifications to the APIs of the included Technologies are allowed. + +ifdef::subset-allowed[] +*{techID}7.2* The Product may contain a subset of the classes and +interfaces for the Libraries. +endif::subset-allowed[] + +*{techID}8* Except for tests specifically required by this TCK to be rebuilt +(if any), the binary Conformance Tests supplied as part of the Test +Suite or as updated by the Maintenance Lead must be used to certify +compliance. + +*{techID}9* The functional programmatic behavior of any binary class or +interface must be that defined by the Specifications. + +include::rules.inc[] + +[[CJAIIBDJ]][[test-appeals-process]] + +2.3 Test Appeals Process +~~~~~~~~~~~~~~~~~~~~~~~~ + +Jakarta has a well established process for managing challenges to its +TCKs. Any implementor may submit a challenge to one or more tests in the +{TechnologyShortName} TCK as it relates to their implementation. Implementor +means the entity as a whole in charge of producing the final certified release. +*Challenges filed should represent the consensus of that entity*. + +2.3.1 Valid Challenges +^^^^^^^^^^^^^^^^^^^^^^ +Any test case (e.g., test class, @Test method), test case configuration (e.g., deployment descriptor), test beans, annotations, and other resources considered part of the TCK may be challenged. + +The following scenarios are considered in scope for test challenges: + +* Claims that a test assertion conflicts with the specification. +* Claims that a test asserts requirements over and above that of the specification. +* Claims that an assertion of the specification is not sufficiently implementable. +* Claims that a test is not portable or depends on a particular implementation. + +2.3.2 Invalid Challenges +^^^^^^^^^^^^^^^^^^^^^^^^ +The following scenarios are considered out of scope for test challenges and will be immediately closed if filed: + +* Challenging an implementation’s claim of passing a test. Certification is an honor system and these issues must be raised directly with the implementation. +* Challenging the usefulness of a specification requirement. The challenge process cannot be used to bypass the specification process and raise in question the need or relevance of a specification requirement. +* Claims the TCK is inadequate or missing assertions required by the specification. See the Improvement section, which is outside the scope of test challenges. +* Challenges that do not represent a consensus of the implementing community will be closed until such time that the community does agree or agreement cannot be made. The test challenge process is not the place for implementations to initiate their own internal discussions. +* Challenges to tests that are already excluded for any reason. +* Challenges that an excluded test should not have been excluded and should be re-added should be opened as a new enhancement request + +Test challenges must be made in writing via the {TechnologyShortName} specification project issue tracker +as described in link:#CJAJEAEI[Section 2.3.3, "TCK Test Appeals Steps."] + +All tests found to be invalid will be placed on the Exclude List +for that version of the {TechnologyShortName} TCK. + + +[[CJAJEAEI]][[tck-test-appeals-steps]] + +2.3.3 TCK Test Appeals Steps +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +1. Challenges should be filed via the {TechnologyFullName} specification project’s issue tracker using the label `challenge` and include the following information: +* The relevant specification version and section number(s) +* The coordinates of the challenged test(s) +* The exact TCK and exclude list versions +* The implementation being tested, including name and company +* The full test name +* A full description of why the test is invalid and what the correct behavior is believed to be +* Any supporting material; debug logs, test output, test logs, run scripts, etc. + + + +2. Specification project evaluates the challenge. + +Challenges can be resolved by a specification project lead, or a project challenge triage team, after a consensus of the specification project committers is reached or attempts to gain consensus fails. +Specification projects may exercise lazy consensus, voting or any practice that follows the principles of Eclipse Foundation Development Process. +The expected timeframe for a response is two weeks or less. +If consensus cannot be reached by the specification project for a prolonged period of time, the default recommendation is to exclude the tests and address the dispute in a future revision of the specification. + +3. Accepted Challenges. + +A consensus that a test produces invalid results will result in the exclusion of that test from certification requirements, and an immediate update and release of an official distribution of the TCK including the new exclude list. The associated `challenge` issue must be closed with an `accepted` label to indicate it has been resolved. + +4. Rejected Challenges and Remedy. + +When a`challenge` issue is rejected, it must be closed with a label of `invalid` to indicate it has been rejected. +There appeal process for challenges rejected on technical terms is outlined in Escalation Appeal. +If, however, an implementer feels the TCK challenge process was not followed, an appeal issue should be filed with specification project’s TCK issue tracker using the label `challenge-appeal`. +A project lead should escalate the issue with the Jakarta EE Specification Committee via email (jakarta.ee-spec@eclipse.org). +The committee will evaluate the matter purely in terms of due process. +If the appeal is accepted, the original TCK challenge issue will be reopened and a label of `appealed-challenge` added, along with a discussion of the appeal decision, and the `challenge-appeal` issue with be closed. +If the appeal is rejected, the `challenge-appeal` issue should closed with a label of `invalid`. + +5. Escalation Appeal. + +If there is a concern that a TCK process issue has not been resolved satisfactorily, the +https://www.eclipse.org/projects/dev_process/#6_5_Grievance_Handling[Eclipse Development Process Grievance Handling] procedure should be followed to escalate the resolution. Note that this is not a mechanism to attempt to handle implementation specific issues. + + +[[CJAJECIE]][[specifications-for-technology]] + +2.4 Specifications for {TechnologyFullName} +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The {TechnologyFullName} specification is available from the specification +project web-site: {SpecificationURL}. + +[[CJABAHGI]][[libraries-for-technology]] + +2.5 Libraries for {TechnologyFullName} +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The following is a list of the packages comprising the required class +libraries for {TechnologyShortName} {TechnologyVersion}: + +include::packages.inc[] + +For the latest list of packages, also see: + +{SpecificationURL}
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/rules.inc b/tck/tck-docs/userguide/src/main/jbake/content/rules.inc new file mode 100644 index 0000000..b5a250f --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/rules.inc
@@ -0,0 +1,78 @@ +/////////////////////////////////////////////////////////////////////// +NOTE TO WRITERS: +Most technologies will only need the compatibility rules in rules.adoc. +Some technologies will need additional rules. If they're needed, +remove the comment block delimiters below and update the rules as +appropriate. You may need to adjust the rule numbers to avoid gaps. + +The first comment block below is additional rules needed by JPA. + +The second comment block below is additional rules needed by +JSP and Servlet. (And EJB, if it had a standalone TCK.) + +The third comment block below is additional rules that apply +to any technology that defines deployment descriptors. + +The fourth comment block is special rules that apply only to JSP. + +NOTE: This set of examples is NOT complete, but should be. +/////////////////////////////////////////////////////////////////////// + +/////////////////////////////////////////////////////////////////////// +*{techID}10* The Runtime must report an error when processing a +Configuration Descriptor that does not conform to the Specifications. + +*{techID}11* An error must be reported when processing a configuration +descriptor that includes a Java Persistence QL expression that does not +conform to the Specifications. + +*{techID}12* The presence of an XML comment in a Configuration +Descriptor, when processed by the Runtime, must not cause the +functional programmatic behavior of the Runtime to vary from the +functional programmatic behavior of the Runtime in the absence of that +comment. +/////////////////////////////////////////////////////////////////////// + +/////////////////////////////////////////////////////////////////////// +*{techID}10* Each Container must make technically accessible all Java SE +Runtime interfaces and functionality, as defined by the Specifications, +to programs running in the Container, except only as specifically +exempted by these Rules. + +*{techID}10.1* Containers may impose security constraints, as defined by +the Specifications. +/////////////////////////////////////////////////////////////////////// + +/////////////////////////////////////////////////////////////////////// +*{techID}11* A Deployment Tool must report an error when processing a +Configuration Descriptor that does not conform to the Specifications. + +*{techID}12* The presence of an XML comment in a Configuration +Descriptor, when processed by a Deployment Tool, must not cause the +functional programmatic behavior of the Deployment Tool to vary from +the functional programmatic behavior of the Deployment Tool in the +absence of that comment. +/////////////////////////////////////////////////////////////////////// + +/////////////////////////////////////////////////////////////////////// +*{techID}11* A web Container must report an error, as defined by the +Specifications, when processing a JSP Page that does not conform to the +Specifications. + +*{techID}12* The presence of a Java language comment or Java language +directive in a JSP Page that specifies ”java” as the scripting +language, when processed by a web Container, must not cause the +functional programmatic behavior of that JSP Page to vary from the +functional programmatic behavior of that JSP Page in the absence of +that Java language comment or Java language directive. + +*{techID}13* The contents of any fixed template data (defined by the +Specifications) in a JSP Page, when processed by a web Container, must +not affect the functional programmatic behavior of that JSP Page, +except as defined by the Specifications. + +*{techID}14* The functional programmatic behavior of a JSP Page that +specifies ”java” as the scripting language must be equivalent to the +functional programmatic behavior of the JSP Page Implementation Class +constructed from that JSP Page. +///////////////////////////////////////////////////////////////////////
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/tck-packages.inc b/tck/tck-docs/userguide/src/main/jbake/content/tck-packages.inc new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/tck-packages.inc
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/title.adoc b/tck/tck-docs/userguide/src/main/jbake/content/title.adoc new file mode 100644 index 0000000..ec9d735 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/title.adoc
@@ -0,0 +1,40 @@ +type=page +status=published +title=TCK User's Guide for Technology Implementors +next=preface.html +prev=toc.html +~~~~~~ +include::attributes.conf[] + +TCK User's Guide for {TechnologyFullName}, Release {TechnologyVersion} for Jakarta EE +===================================================================================== + +[[eclipse-foundation]] +Eclipse Foundation +------------------ + +Technology Compatibility Kit User's Guide for {TechnologyFullName} + +Release {TechnologyVersion} for Jakarta EE + +{ReleaseDate} + +[[sthref1]] + +''''' + +Technology Compatibility Kit User's Guide for {TechnologyFullName}, +Release {TechnologyVersion} for Jakarta EE + +Copyright © {CopyrightDates} Oracle and/or its affiliates. All rights reserved. + +This program and the accompanying materials are made available under +the terms of the Eclipse Public License v. 2.0, which is available at +http://www.eclipse.org/legal/epl-2.0. + +SPDX-License-Identifier: EPL-2.0 + +Oracle and Java are registered trademarks of Oracle and/or its +affiliates. Other names may be trademarks of their respective owners. + +include::title.inc[]
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/title.inc b/tck/tck-docs/userguide/src/main/jbake/content/title.inc new file mode 100644 index 0000000..25bf47e --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/title.inc
@@ -0,0 +1,11 @@ +/////////////////////////////////////////////////////////////////////// +NOTE TO WRITERS: +This is included at the tail end of the Title page. +The following section should be customized for the technology. +This is provided to allow each technology to customize legacy acronym names +that are used in this TCK. +Be sure to customize LegacyAcronym in attributes.conf +Add additional lines as needed for acronyms found in your TCK user guide. +/////////////////////////////////////////////////////////////////////// + +References in this document to {LegacyAcronym} refer to the {TechnologyFullName} unless otherwise noted.
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/toc.adoc b/tck/tck-docs/userguide/src/main/jbake/content/toc.adoc new file mode 100644 index 0000000..178975c --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/toc.adoc
@@ -0,0 +1,90 @@ +type=page +status=published +title=TCK User's Guide for Technology Implementors +next=title.html +~~~~~~ +include::attributes.conf[] +TCK User's Guide for Technology Implementors +============================================ + +[[contents]] +Contents +-------- + +* link:title.html#eclipse-foundation[Eclipse Foundation] + +link:preface.html#GBFTI[Preface] +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +** link:preface.html#GBFUS[Who Should Use This Book] +** link:preface.html#GBFPO[Before You Read This Book] +** link:preface.html#GBFWF[Typographic Conventions] +** link:preface.html#FWBSD[Shell Prompts in Command Examples] + +link:intro.html#GBFOW[1 Introduction] +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +** link:intro.html#GBFTK[1.1 Compatibility Testing] +*** link:intro.html#GBFQN[1.1.1 Why Compatibility Testing is Important] +*** link:intro.html#GBFPR[1.1.2 TCK Compatibility Rules] +*** link:intro.html#GBFPW[1.1.3 TCK Overview] +*** link:intro.html#GBFPB[1.1.4 Jakarta EE Specification Process (JESP) Program and Compatibility Testing] +** link:intro.html#GBFQR[1.2 About the TCK] +*** link:intro.html#GBFQV[1.2.1 TCK Specifications and Requirements] +*** link:intro.html#GBFSQ[1.2.2 TCK Components] +*** link:intro.html#GBFRA[1.2.3 TCK Compatibility Test Suite] +*** link:intro.html#GBFSH[1.2.4 Exclude Lists] +*** link:intro.html#GBFRR[1.2.5 TCK Configuration] +** link:intro.html#GBFQW[1.3 Getting Started With the TCK] + +[[procedure-for-certification]] +link:rules.html#GBFSN[2 Procedure for Certification] +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +** link:rules.html#CJAFFDGI[2.1 Certification Overview] +** link:rules.html#CJAFGIGG[2.2 Compatibility Requirements] +*** link:rules.html#definitions[2.2.1 Definitions] +*** link:rules.html#sthref7[2.2.2 Rules for {TechnologyFullName} Products] +** link:rules.html#CJAIIBDJ[2.3 Test Appeals Process] +*** link:rules.html#[2.3.1 Valid Challenges] +*** link:rules.html#[2.3.2 Invalid Challenges] +*** link:rules.html#CJAJEAEI[2.3.3 TCK Test Appeals Steps] +** link:rules.html#CJAJECIE[2.4 Specifications for {TechnologyFullName}] +** link:rules.html#CJABAHGI[2.5 Libraries for {TechnologyFullName}] + +link:install.html#GBFTP[3 Installation] +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +** link:install.html#GBFUD[3.1 Obtaining a Compatible Implementation] +** link:install.html#GBFTS[3.2 Installing the Software] + +[[setup-and-configuration]] +link:config.html#GBFVV[4 Setup and Configuration] +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +** link:config.html#GBFVU[4.1 Configuring Your Environment to Run the TCK Against the Compatible Implementation] +** link:config.html#GCLHU[4.2 Configuring Your Environment to Repackage and Run the TCK Against the Vendor Implementation] +** link:config.html#GHGDG[4.3 Publishing the Test Applications] + +[[executing-tests]] +link:using.html#GBFWO[5 Executing Tests] +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +** link:using.html#GBFUZ[5.1 Starting the tests] +*** link:using.html#GBFVW[5.1.1 To Start JavaTest in Command-Line Mode] +** link:using.html#GBFWM[5.2 Running a Subset of the Tests] +*** link:using.html#GBFWK[5.2.1 To Run a Subset of Tests in Command-Line Mode] +** link:using.html#GCLRR[5.3 Running the TCK Against another CI] +** link:using.html#GCLRZ[5.4 Running the TCK Against a Vendor's Implementation] +** link:using.html#GBFVK[5.5 Test Reports] + +[[debugging-test-problems]] +link:debug.html#GBFUV[6 Debugging Test Problems] +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +** link:debug.html#GBFYP[6.1 Overview] +** link:debug.html#GBFYF[6.2 Configuration Failures] +* link:faq.html#GBFYD[A Frequently Asked Questions] +** link:faq.html#GBFYQ[A.1 Where do I start to debug a test failure?] +** link:faq.html#GBFYR[A.2 How do I restart a crashed test run?] +** link:faq.html#GBFWU[A.3 What would cause tests be added to the exclude list?]
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/using-examples.inc b/tck/tck-docs/userguide/src/main/jbake/content/using-examples.inc new file mode 100644 index 0000000..9837b8a --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/using-examples.inc
@@ -0,0 +1,50 @@ +/////////////////////////////////////////////////////////////////////// +NOTE TO WRITERS: +These CLI examples can be customized as necessary. +/////////////////////////////////////////////////////////////////////// + +1. Change to any subdirectory under `<TS_HOME>/src/com/sun/ts/tests`. +2. Start JavaTest using the following command: ++ +-- +[source,oac_no_warn] +---- +ant runclient +---- +-- + +[[GCMCU]] + +Example 5-1 {TechnologyShortName} TCK Signature Tests + +To run the {TechnologyShortName} TCK signature tests, enter the +following commands: + +[source,subs="attributes"] +---- +mvn verify -Dit.test=jakarta.jsonp.tck.signaturetest.** +---- + +[[GCMBV]] + + +Example 5-2 Single Test Directory + +To run a single test directory, enter the following commands: + +[source,subs="attributes"] +---- +mvn verify -Dit.test={singleTestDirectoryExample}.** +---- + +[[GCMCA]] + + +Example 5-3 Subset of Test Directories + +To run a subset of test directories, enter the following commands: + +[source,subs="attributes"] +---- +mvn verify -Dit.test={subsetTestDirectoryExample}.** +----
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/using.adoc b/tck/tck-docs/userguide/src/main/jbake/content/using.adoc new file mode 100644 index 0000000..6fc99dd --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/using.adoc
@@ -0,0 +1,146 @@ +type=page +status=published +title=Executing Tests +next=debug.html +prev=config.html +~~~~~~ +include::attributes.conf[] +Executing Tests +=============== + +[[GBFWO]] + + +[[executing-tests]] +5 Executing Tests +----------------- + +The {TechnologyShortName} TCK uses the Junit +framework to execute the tests. + +This chapter includes the following topics: + +* link:#GBFUZ[Starting the tests] +* link:#GBFWM[Running a Subset of the Tests] +* link:#GCLRR[Running the TCK Against your selected CI] +* link:#GCLRZ[Running the TCK Against a Vendor's Implementation] +* link:#GBFVK[Test Reports] + + +[NOTE] +======================================================================= + +The instructions in this chapter assume that you have installed and +configured your test environment as described in +link:install.html#GBFTP[Chapter 3, "Installation,"] and +link:config.html#GBFVV[Chapter 4, "Setup and Configuration,"], +respectively. + +======================================================================= + +ifdef::rebuild[] +As explained in link:rebuild.html#GCLIZ[Appendix B, "Packaging the +Test Applications in Servlet-Compliant WAR +Files With VI-Specific Information,"] the {TechnologyShortName} TCK +introduces the concept of repackaging the TCK tests. +endif::rebuild[] + + +[[GBFUZ]][[starting-javatest]] + +5.1 Starting the tests +~~~~~~~~~~~~~~~~~~~~~~ + +The {TechnologyShortName} TCK can be run from the command line +in your shell environment by executing the TCK jar. + + +[NOTE] +======================================================================= + +The `mvn` command referenced in the following +two procedures and elsewhere in this guide is the Apache Maven +build tool, which will need to be downloaded separately. + +======================================================================= + + +[[GBFVW]][[to-start-javatest-in-command-line-mode]] + +5.1.1 To Start JavaTest in Command-Line Mode +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +include::using-examples.inc[] + +[[GBFWM]][[running-a-subset-of-the-tests]] + +5.2 Running a Subset of the Tests +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Use the following modes to run a subset of the tests: + +* link:#GBFWK[Section 5.2.1, "To Run a Subset of Tests in Command-Line Mode"] + + +[[GBFWK]][[to-run-a-subset-of-tests-in-command-line-mode]] + +5.2.1 To Run a Subset of Tests in Command-Line Mode +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Start the test run by executing the following command: + + +[source,subs="attributes"] +---- +mvn verify -Dit.test={subsetTestDirectoryExample}.** +---- + +The tests in the directory and its subdirectories are run. + + +[[GCLRR]][[running-the-tck-against-the-ri]] + +5.3 Running the TCK Against another CI +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Some test scenarios are designed to ensure that the configuration and deployment of +all the prebuilt {TechnologyShortName} TCK tests against one Compatible +Implementation are successful operating with other compatible implementations, and that the TCK is ready for +compatibility testing against the Vendor and Compatible Implementations. + +1. Verify that you have followed the configuration instructions in +link:config.html#GBFVU[Section 4.1, "Configuring Your Environment to Run +the TCK Against the Compatible Implementation."] +2. If required, verify that you have completed the steps in +link:config.html#GCLIW[Section 4.3.2, "Deploying the Prebuilt Archives."] +3. Run the tests, as described in link:#GBFUZ[Section 5.1, "Starting +the tests,"] and, if desired, link:#GBFWM[Section 5.2, "Running a Subset +of the Tests."] + +[[GCLRZ]][[running-the-tck-against-a-vendors-implementation]] + +5.4 Running the TCK Against a Vendor's Implementation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This test scenario is one of the compatibility test phases that all +Vendors must pass. + +1. Verify that you have followed the configuration instructions in +link:config.html#GCLHU[Section 4.2, "Configuring Your Environment to +Repackage and Run the TCK Against the Vendor Implementation."] +2. If required, verify that you have completed the steps in +link:config.html#GCLIL[Section 4.3.3, "Deploying the +Test Applications Against the Vendor Implementation."] +3. Run the tests, as described in link:#GBFUZ[Section 5.1, "Starting +JavaTest,"] and, if desired, link:#GBFWM[Section 5.2, "Running a Subset +of the Tests."] + +[[GBFVK]][[test-reports]] + +5.5 Test Reports +~~~~~~~~~~~~~~~~ + +A set of report files is created for every test run. These report files +can be found in the target directory that the test is run. After a test run is +completed, the Junit framework writes reports for the test run. + +
diff --git a/tck/tck-docs/userguide/src/main/jbake/content/using.inc b/tck/tck-docs/userguide/src/main/jbake/content/using.inc new file mode 100644 index 0000000..1b35fd4 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/content/using.inc
@@ -0,0 +1,118 @@ +/////////////////////////////////////////////////////////////////////// +NOTE TO WRITERS: +This include file allows for additional instructions for running the TCK. +/////////////////////////////////////////////////////////////////////// + + +[[sthref9]][[running-the-pluggability-tests]] + +5.6 Running the Pluggability Tests +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Use the following modes to run the pluggability tests: + +* link:#BCGFHIDI[Section 5.6.1, "To Run the Pluggability Tests in GUI +Mode"] +* link:#BCGEGBGE[Section 5.6.2, "To Run the Pluggability Tests in +Command-Line Mode"] + +[[BCGFHIDI]][[to-run-the-pluggability-tests-in-gui-mode]] + +5.6.1 To Run the Pluggability Tests in GUI Mode +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +When running JavaTest in GUI mode as described above, you are prompted +to specify whether you want to run all or a subset of the test suite. +Since the pluggability tests must be run separately from +the other tests, select Yes. Select the tests you want to run from the +displayed test tree, then select Next. You can select entire branches +of the test tree, or use Ctrl+Click or Shift+Click to select multiple +tests or ranges of tests, respectively. Select all tests except +pluggability tests by unchecking the pluggability tests. + +After running the other tests, run the pluggability tests, which +require a separate test run: + +1. If the JavaTest GUI is running, exit the GUI. +2. Change to the `<TS_HOME>/bin` directory and reconfigure environment +to use the `JsonProvider` class that is supplied with the test suite and +restart the JavaTest GUI: + +[source,oac_no_warn] +---- +cd <TS_HOME>/bin +ant enable.alternate.jsonp.provider +ant gui +---- +3. Select Configure, then select Edit Configuration. +4. Select Tests to Run. +5. Select the tests you want to run from the displayed test tree, then +select Next. + +Select the pluggability tests only by unchecking all of the other tests. +6. Select Done. +7. Select Run Tests, then select Start. +8. Exit the JavaTest GUI when finished. +9. Disable the alternate JSON provider that you enabled in Step 2, +before you initiated the test run for the pluggability tests: + +[source,oac_no_warn] +---- +cd <TS_HOME>/bin +ant disable.alternate.jsonp.provider +---- + +[[BCGEGBGE]][[to-run-the-pluggability-tests-in-command-line-mode]] + +5.6.2 To Run the Pluggability Tests in Command-Line Mode +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +There are two ways to run the pluggability tests from the command line. +It is highly recommended to use the first method, since it automatically +calls the Ant targets to enable and disable the test provider. If you +choose to use the second method, you will need to execute those Ant +targets manually before and after you run the tests. + +The first method is by executing the `run.pluggability` target in Ant: + +1. Execute the `run.pluggability` target using Ant: + +[source,oac_no_warn] +---- +cd <TS_HOME>/bin +ant run.pluggability +---- +The `run.pluggability` target calls Ant targets that enable the test +provider, run the pluggability tests, then disable the test provider. + +The pluggability tests can also be run an alternate way, albeit one that +requires more manual intervention: + +1. Execute the `enable.alternate.jsonp.provider` target using Ant: + +[source,oac_no_warn] +---- +cd <TS_HOME>/bin +ant enable.alternate.jsonp.provider +---- +The `enable.alternate.jsonp.provider` target enables the alternate test +provider. +2. Change to the `<TS_HOME/src/com/sun/ts/tests/jsonp/pluggability>` +directory: + +[source,oac_no_warn] +---- +cd <TS_HOME/src/com/sun/ts/tests/jsonp/pluggability> +---- +3. Start the pluggability test run by executing the following command: + +[source,oac_no_warn] +---- +ant runclient +---- +This will run just the pluggability tests under the +<`TS_HOME/src/com/sun/ts/tests/jsonp/pluggability` directory, using a +test-supplied `JsonProvider Class` for testing the SPI. All +`JsonProvider` method calls will be invoked and verified by the tests to +ensure SPI layer is working. +4. Execute the `disable.alternate.jsonp.provider` target using Ant: + +[source,oac_no_warn] +---- +cd <TS_HOME>/bin +ant disable.alternate.jsonp.provider +---- +The `disable.alternate.jsonp.provider` target disables the alternate +test provider.
diff --git a/tck/tck-docs/userguide/src/main/jbake/jbake.properties b/tck/tck-docs/userguide/src/main/jbake/jbake.properties new file mode 100644 index 0000000..05c7056 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/jbake.properties
@@ -0,0 +1,24 @@ +# +# Copyright (c) 2021 Oracle and/or its affiliates. All rights reserved. +# +# This program and the accompanying materials are made available under the +# terms of the Eclipse Public License v. 2.0, which is available at +# http://www.eclipse.org/legal/epl-2.0. +# +# This Source Code may also be made available under the following Secondary +# Licenses when the conditions for such availability set forth in the +# Eclipse Public License v. 2.0 are satisfied: GNU General Public License, +# version 2 with the GNU Classpath Exception, which is available at +# https://www.gnu.org/software/classpath/license.html. +# +# SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0 +# + +site.host=http://jbake.org +render.tags=false +render.sitemap=false +render.archive=false +render.feed=false +render.index=false +asciidoctor.option.safe=0 +asciidoctor.attributes.export=true \ No newline at end of file
diff --git a/tck/tck-docs/userguide/src/main/jbake/templates/footer.ftl b/tck/tck-docs/userguide/src/main/jbake/templates/footer.ftl new file mode 100644 index 0000000..236b646 --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/templates/footer.ftl
@@ -0,0 +1,44 @@ +<#-- a footer template fragment included in the page template --> +<hr /> + +<table width="90%" id="bottom-nav" cellspacing="0" cellpadding="0"> + <colgroup> + <col width="12%"/> + <col width="12%"/> + <col width="*"/> + </colgroup> + <tr> + <#if content.prev??> + <td align="left"> + <a href="${content.prev}"> + <span class=" vector-font"><i class="fa fa-arrow-circle-left" aria-hidden="true"></i></span> + <span style="position:relative;top:-2px;">Previous</span> + </a> + </td> + </#if> + + <#if content.next??> + <td align="left"> + <a href="${content.next}"> + <span class="vector-font"><i class="fa fa-arrow-circle-right vector-font" aria-hidden="true"></i></span> + <span style="position:relative;top:-2px;">Next</span> + </a> + </td> + </#if> + + <td align="right"> + <a href="toc.html"> + <span class="vector-font"><i class="fa fa-list vector-font" aria-hidden="true"></i></span> + <span style="position:relative;top:-2px;">Contents</span> + </a> + </td> + </tr> +</table> + +<span id="copyright"> + <img src="img/eclipse_foundation_logo_tiny.png" height="20px" alt="Eclipse Foundation Logo" align="top"/> + <span >Copyright © 2017, 2021 Oracle and/or its affiliates. All rights reserved.</span> +</span> + +</body> +</html>
diff --git a/tck/tck-docs/userguide/src/main/jbake/templates/header.ftl b/tck/tck-docs/userguide/src/main/jbake/templates/header.ftl new file mode 100644 index 0000000..50b72ae --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/templates/header.ftl
@@ -0,0 +1,54 @@ +<!DOCTYPE html> +<#-- a header template fragment included in the page template --> +<html lang="en"> + <head> + <meta charset="utf-8"/> + <title><#if (content.title)??><#escape x as x?xml>${content.title}</#escape></#if></title> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + <link href="<#if (content.rootpath)??>${content.rootpath}<#else></#if>css/style.css" rel="stylesheet"> + <script src="https://use.fontawesome.com/96c4d89611.js"></script> + </head> + <body> +<table id="doc-title" cellspacing="0" cellpadding="0"> + <tr> + <td align="left" valign="top"> + <b>${content.title}</b><br /> + </td> + </tr> +</table> +<hr /> + +<table width="90%" id="top-nav" cellspacing="0" cellpadding="0"> + <colgroup> + <col width="12%"/> + <col width="12%"/> + <col width="*"/> + </colgroup> + <tr> + <#if content.prev??> + <td align="left"> + <a href="${content.prev}"> + <span class="vector-font"><i class="fa fa-arrow-circle-left" aria-hidden="true"></i></span> + <span style="position:relative;top:-2px;">Previous</span> + </a> + </td> + </#if> + + <#if content.next??> + <td align="left"> + <a href="${content.next}"> + <span class=" vector-font"><i class="fa fa-arrow-circle-right vector-font" aria-hidden="true"></i></span> + <span style="position:relative;top:-2px;">Next</span> + </a> + </td> + </#if> + + <td align="right"> + <a href="toc.html"> + <span class=" vector-font"><i class="fa fa-list vector-font" aria-hidden="true"></i></span> + <span style="position:relative;top:-2px;">Contents</span> + </a> + </td> + </tr> +</table> +
diff --git a/tck/tck-docs/userguide/src/main/jbake/templates/menu.ftl b/tck/tck-docs/userguide/src/main/jbake/templates/menu.ftl new file mode 100644 index 0000000..888c03d --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/templates/menu.ftl
@@ -0,0 +1 @@ +<#-- a menu bar template fragment included in the page template --> \ No newline at end of file
diff --git a/tck/tck-docs/userguide/src/main/jbake/templates/page.ftl b/tck/tck-docs/userguide/src/main/jbake/templates/page.ftl new file mode 100644 index 0000000..eca51db --- /dev/null +++ b/tck/tck-docs/userguide/src/main/jbake/templates/page.ftl
@@ -0,0 +1,8 @@ +<#-- a top level page layout template --> + +<#include "header.ftl"> +<#include "menu.ftl"> + +${content.body} + +<#include "footer.ftl"> \ No newline at end of file
diff --git a/tck/tck-docs/userguide/src/theme/jakartaee-theme.yml b/tck/tck-docs/userguide/src/theme/jakartaee-theme.yml new file mode 100644 index 0000000..6092a2f --- /dev/null +++ b/tck/tck-docs/userguide/src/theme/jakartaee-theme.yml
@@ -0,0 +1,299 @@ +# +# Following is the asciidoctor-pdf default theme [1], with small +# customizations, mostly for header and footer, marked "EE". +# +# [1] https://github.com/asciidoctor/asciidoctor-pdf/blob/master/data/themes/default-theme.yml +# +font: + catalog: + # Noto Serif supports Latin, Latin-1 Supplement, Latin Extended-A, Greek, Cyrillic, Vietnamese & an assortment of symbols + Noto Serif: + normal: notoserif-regular-subset.ttf + bold: notoserif-bold-subset.ttf + italic: notoserif-italic-subset.ttf + bold_italic: notoserif-bold_italic-subset.ttf + # M+ 1mn supports ASCII and the circled numbers used for conums + M+ 1mn: + normal: mplus1mn-regular-ascii-conums.ttf + bold: mplus1mn-bold-ascii.ttf + italic: mplus1mn-italic-ascii.ttf + bold_italic: mplus1mn-bold_italic-ascii.ttf + # M+ 1p supports Latin, Latin-1 Supplement, Latin Extended, Greek, Cyrillic, Vietnamese, Japanese & an assortment of symbols + # It also provides arrows for ->, <-, => and <= replacements in case these glyphs are missing from font + M+ 1p Fallback: + normal: mplus1p-regular-fallback.ttf + bold: mplus1p-regular-fallback.ttf + italic: mplus1p-regular-fallback.ttf + bold_italic: mplus1p-regular-fallback.ttf + fallbacks: + - M+ 1p Fallback +page: + background_color: ffffff + layout: portrait + margin: [0.5in, 0.67in, 0.67in, 0.67in] + # margin_inner and margin_outer keys are used for recto/verso print margins when media=prepress + margin_inner: 0.75in + margin_outer: 0.59in + #size: A4 # EE + size: Letter # EE +base: + align: justify + # color as hex string (leading # is optional) + font_color: 333333 + # color as RGB array + #font_color: [51, 51, 51] + # color as CMYK array (approximated) + #font_color: [0, 0, 0, 0.92] + #font_color: [0, 0, 0, 92%] + font_family: Noto Serif + # choose one of these font_size/line_height_length combinations + #font_size: 14 + #line_height_length: 20 + #font_size: 11.25 + #line_height_length: 18 + #font_size: 11.2 + #line_height_length: 16 + font_size: 10.5 + #line_height_length: 15 + # correct line height for Noto Serif metrics + line_height_length: 12 + #font_size: 11.25 + #line_height_length: 18 + line_height: $base_line_height_length / $base_font_size + font_size_large: round($base_font_size * 1.25) + font_size_small: round($base_font_size * 0.85) + font_size_min: $base_font_size * 0.75 + font_style: normal + border_color: eeeeee + border_radius: 4 + border_width: 0.5 +# FIXME vertical_rhythm is weird; we should think in terms of ems +#vertical_rhythm: $base_line_height_length * 2 / 3 +# correct line height for Noto Serif metrics (comes with built-in line height) +vertical_rhythm: $base_line_height_length +horizontal_rhythm: $base_line_height_length +# QUESTION should vertical_spacing be block_spacing instead? +vertical_spacing: $vertical_rhythm +link: + font_color: 428bca +# literal is currently used for inline monospaced in prose and table cells +literal: + font_color: b12146 + font_family: M+ 1mn +menu_caret_content: " <font size=\"1.15em\"><color rgb=\"b12146\">\u203a</color></font> " +heading: + align: left + #font_color: 181818 + font_color: $base_font_color + font_family: $base_font_family + font_style: bold + # h1 is used for part titles (book doctype) or the doctitle (article doctype) + #h1_font_size: floor($base_font_size * 2.6) # EE + h1_font_size: floor($base_font_size * 2.5) # EE, squeeze title onto one line + # h2 is used for chapter titles (book doctype only) + h2_font_size: floor($base_font_size * 2.15) + h3_font_size: round($base_font_size * 1.7) + h4_font_size: $base_font_size_large + h5_font_size: $base_font_size + h6_font_size: $base_font_size_small + #line_height: 1.4 + # correct line height for Noto Serif metrics (comes with built-in line height) + line_height: 1 + margin_top: $vertical_rhythm * 0.4 + margin_bottom: $vertical_rhythm * 0.9 +title_page: + align: right + logo: + top: 10% + title: + top: 55% + font_size: $heading_h1_font_size + font_color: 999999 + line_height: 0.9 + subtitle: + font_size: $heading_h3_font_size + font_style: bold_italic + line_height: 1 + authors: + margin_top: $base_font_size * 1.25 + font_size: $base_font_size_large + font_color: 181818 + revision: + margin_top: $base_font_size * 1.25 +block: + margin_top: 0 + margin_bottom: $vertical_rhythm +caption: + align: left + font_size: $base_font_size * 0.95 + font_style: italic + # FIXME perhaps set line_height instead of / in addition to margins? + margin_inside: $vertical_rhythm / 3 + #margin_inside: $vertical_rhythm / 4 + margin_outside: 0 +lead: + font_size: $base_font_size_large + line_height: 1.4 +abstract: + font_color: 5c6266 + font_size: $lead_font_size + line_height: $lead_line_height + font_style: italic + first_line_font_style: bold + title: + align: center + font_color: $heading_font_color + font_family: $heading_font_family + font_size: $heading_h4_font_size + font_style: $heading_font_style +admonition: + column_rule_color: $base_border_color + column_rule_width: $base_border_width + padding: [0, $horizontal_rhythm, 0, $horizontal_rhythm] + #icon: + # tip: + # name: fa-lightbulb-o + # stroke_color: 111111 + # size: 24 + label: + text_transform: uppercase + font_style: bold +blockquote: + font_color: $base_font_color + font_size: $base_font_size_large + border_color: $base_border_color + border_width: 5 + # FIXME disable negative padding bottom once margin collapsing is implemented + padding: [0, $horizontal_rhythm, $block_margin_bottom * -0.75, $horizontal_rhythm + $blockquote_border_width / 2] + cite_font_size: $base_font_size_small + cite_font_color: 999999 +# code is used for source blocks (perhaps change to source or listing?) +code: + font_color: $base_font_color + font_family: $literal_font_family + font_size: ceil($base_font_size) + padding: $code_font_size + line_height: 1.25 + # line_gap is an experimental property to control how a background color is applied to an inline block element + line_gap: 3.8 + background_color: f5f5f5 + border_color: cccccc + border_radius: $base_border_radius + border_width: 0.75 +conum: + font_family: M+ 1mn + font_color: $literal_font_color + font_size: $base_font_size + line_height: 4 / 3 +example: + border_color: $base_border_color + border_radius: $base_border_radius + border_width: 0.75 + background_color: ffffff + # FIXME reenable padding bottom once margin collapsing is implemented + padding: [$vertical_rhythm, $horizontal_rhythm, 0, $horizontal_rhythm] +image: + align: left +prose: + margin_top: $block_margin_top + margin_bottom: $block_margin_bottom +sidebar: + background_color: eeeeee + border_color: e1e1e1 + border_radius: $base_border_radius + border_width: $base_border_width + # FIXME reenable padding bottom once margin collapsing is implemented + padding: [$vertical_rhythm, $vertical_rhythm * 1.25, 0, $vertical_rhythm * 1.25] + title: + align: center + font_color: $heading_font_color + font_family: $heading_font_family + font_size: $heading_h4_font_size + font_style: $heading_font_style +thematic_break: + border_color: $base_border_color + border_style: solid + border_width: $base_border_width + margin_top: $vertical_rhythm * 0.5 + margin_bottom: $vertical_rhythm * 1.5 +description_list: + term_font_style: bold + term_spacing: $vertical_rhythm / 4 + description_indent: $horizontal_rhythm * 1.25 +outline_list: + indent: $horizontal_rhythm * 1.5 + #marker_font_color: 404040 + # NOTE outline_list_item_spacing applies to list items that do not have complex content + item_spacing: $vertical_rhythm / 2 +table: + background_color: $page_background_color + #head_background_color: <hex value> + #head_font_color: $base_font_color + head_font_style: bold + #body_background_color: <hex value> + body_stripe_background_color: f9f9f9 + foot_background_color: f0f0f0 + border_color: dddddd + border_width: $base_border_width + cell_padding: 3 +toc: + indent: $horizontal_rhythm + line_height: 1.4 + dot_leader: + #content: ". " + font_color: a9a9a9 + #levels: 2 3 +# NOTE in addition to footer, header is also supported +footer: + font_size: $base_font_size_small + # NOTE if background_color is set, background and border will span width of page + #border_color: dddddd # EE + #border_width: 0.25 # EE + height: $base_line_height_length * 2.5 + line_height: 1 + padding: [$base_line_height_length / 2, 1, 0, 1] + vertical_align: top + #image_vertical_align: <alignment> or <number> + # additional attributes for content: + # * {page-count} + # * {page-number} + # * {document-title} + # * {document-subtitle} + # * {chapter-title} + # * {section-title} + # * {section-or-chapter-title} + recto: + #columns: "<50% =0% >50%" + right: + #content: '{page-number}' # EE + #content: '{section-or-chapter-title} | {page-number}' + #content: '{document-title} | {page-number}' + content: '{document-title}{nbsp}{nbsp}{nbsp} *{page-number}*' # EE + #center: + # content: '{page-number}' + left: # EE + content: '{status}' # EE + verso: + #columns: $footer_recto_columns + left: + #content: $footer_recto_right_content # EE + #content: '{page-number} | {chapter-title}' + content: '*{page-number}* {nbsp}{nbsp}{nbsp}{document-title}' # EE + #center: + # content: '{page-number}' + right: # EE + content: '{status}' # EE +header: # EE + font_size: $base_font_size_small # EE + border_color: dddddd # EE + border_width: 0.25 # EE + height: $base_line_height_length * 2.5 # EE + line_height: 1 # EE + padding: [$base_line_height_length / 2, 1, 0, 1] # EE + vertical_align: top # EE + recto: # EE + right: # EE + content: '{section-or-chapter-title}' # EE + verso: # EE + left: # EE + content: '{section-or-chapter-title}' # EE