Fix HTML validation warnings. Project: http://git-wip-us.apache.org/repos/asf/incubator-juneau/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-juneau/commit/18feb674 Tree: http://git-wip-us.apache.org/repos/asf/incubator-juneau/tree/18feb674 Diff: http://git-wip-us.apache.org/repos/asf/incubator-juneau/diff/18feb674
Branch: refs/heads/master Commit: 18feb6740d05e5ac3f790b13587b5d5d9ce82ced Parents: 3a38534 baf2ba9 Author: jamesbognar <[email protected]> Authored: Wed Aug 10 21:29:12 2016 -0400 Committer: jamesbognar <[email protected]> Committed: Wed Aug 10 21:29:45 2016 -0400 ---------------------------------------------------------------------- .../.settings/org.eclipse.wst.html.core.prefs | 43 ++++++++++ .../java/org/apache/juneau/client/package.html | 20 ++--- .../.settings/org.eclipse.wst.html.core.prefs | 43 ++++++++++ .../.settings/org.eclipse.wst.xml.core.prefs | 18 ++++ .../.settings/org.eclipse.wst.html.core.prefs | 43 ++++++++++ .../.settings/org.eclipse.wst.html.core.prefs | 43 ++++++++++ .../.settings/org.eclipse.wst.html.core.prefs | 43 ++++++++++ .../.settings/org.eclipse.wst.html.core.prefs | 43 ++++++++++ .../org/apache/juneau/server/jaxrs/package.html | 11 ++- .../java/org/apache/juneau/server/package.html | 90 ++++++++++---------- .../juneau/server/remoteable/package.html | 22 ++--- 11 files changed, 348 insertions(+), 71 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/18feb674/juneau-client/.settings/org.eclipse.wst.html.core.prefs ---------------------------------------------------------------------- diff --cc juneau-client/.settings/org.eclipse.wst.html.core.prefs index 0000000,0000000..ee1e1ce new file mode 100644 --- /dev/null +++ b/juneau-client/.settings/org.eclipse.wst.html.core.prefs @@@ -1,0 -1,0 +1,43 @@@ ++attrDuplicate=2 ++attrInvalidName=2 ++attrInvalidValue=2 ++attrNameMismatch=2 ++attrNamesToIgnore= ++attrUndefName=2 ++attrUndefValue=2 ++attrValueEqualsMissing=2 ++attrValueMismatch=1 ++attrValueUnclosed=2 ++cdataInvalidContent=2 ++cdataUnclosed=1 ++commentInvalidContent=2 ++commentUnclosed=1 ++docDoctypeUnclosed=1 ++docDuplicateTag=1 ++docInvalidChar=2 ++docInvalidContent=2 ++eclipse.preferences.version=1 ++elemCoexistence=2 ++elemDuplicate=2 ++elemEndInvalidCase=1 ++elemInvalidContent=2 ++elemInvalidDirective=1 ++elemInvalidEmptyTag=2 ++elemInvalidName=1 ++elemInvalidText=2 ++elemMissingEnd=2 ++elemMissingStart=2 ++elemStartInvalidCase=2 ++elemUnclosedEndTag=1 ++elemUnclosedStartTag=1 ++elemUnknownName=2 ++elemUnnecessaryEnd=2 ++elementNamesToIgnore=jc,jd,jt,jk,js,jf,jsf,jsm,ja,xt,xa,xc,xs,mk,mv,cc,cs,ck,ce,cv,l,properties ++ignoreAttrNames=false ++ignoreElementNames=true ++piInvalidContent=2 ++piUnclosed=1 ++piUndefined=2 ++refInvalidContent=2 ++resourceNotFound=2 ++use-project-settings=true http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/18feb674/juneau-client/src/main/java/org/apache/juneau/client/package.html ---------------------------------------------------------------------- diff --cc juneau-client/src/main/java/org/apache/juneau/client/package.html index 7f1ef7f,7f1ef7f..c5d2478 --- a/juneau-client/src/main/java/org/apache/juneau/client/package.html +++ b/juneau-client/src/main/java/org/apache/juneau/client/package.html @@@ -215,11 -215,11 +215,11 @@@ <p> The simplest way to enable SSL support in the client is to use the {@link org.apache.juneau.client.RestClient#enableSSL(SSLOpts)} method and one of the predefined {@link org.apache.juneau.client.SSLOpts} instances: -- <ul> -- <li>{@link org.apache.juneau.client.SSLOpts#DEFAULT} - Normal certificate and hostname validation. -- <li>{@link org.apache.juneau.client.SSLOpts#LAX} - Allows for self-signed certificates. -- </ul> </p> ++ <ul> ++ <li>{@link org.apache.juneau.client.SSLOpts#DEFAULT} - Normal certificate and hostname validation. ++ <li>{@link org.apache.juneau.client.SSLOpts#LAX} - Allows for self-signed certificates. ++ </ul> <h6 class='topic'>Example:</h6> <p class='bcode'> <jc>// Create a client that ignores self-signed or otherwise invalid certificates.</jc> @@@ -451,7 -451,7 +451,7 @@@ <jk>throw new</jk> RestCallException(<js>"Expected a redirect URI during OIDC authentication: "</js> + response.getStatusLine()); <jc>// Handle Bearer Challenge</jc> -- HttpGet method = <jk>new</jk> HttpGet(redirectUri + <js>"&prompt=none"</js>); ++ HttpGet method = <jk>new</jk> HttpGet(redirectUri + <js>"&prompt=none"</js>); addDefaultOidcHeaders(method); response = client.execute(method); @@@ -466,7 -466,7 +466,7 @@@ <jk>if</jk> (! <js>"true"</js>.equals(loginRequired)) <jk>throw new</jk> RestCallException(<js>"X-JSA-LOGIN-REQUIRED header not found on response during OIDC authentication phase 2: "</js> + response.getStatusLine()); -- method = <jk>new</jk> HttpGet(redirectUri + <js>"&prompt=none"</js>); ++ method = <jk>new</jk> HttpGet(redirectUri + <js>"&prompt=none"</js>); addDefaultOidcHeaders(method); response = client.execute(method); @@@ -796,11 -796,11 +796,11 @@@ </p> <p> The requirements for a method to be callable through a remoteable service are: -- <ul class='spaced-list'> -- <li>The method must be public. -- <li>The parameter and return types must be <a href='../../../../org/apache/juneau/package-summary.html#PojoCategories'><u>serializable and parsable</u></a>. -- </ul> </p> ++ <ul class='spaced-list'> ++ <li>The method must be public. ++ <li>The parameter and return types must be <a href='../../../../org/apache/juneau/package-summary.html#PojoCategories'>serializable and parsable</a>. ++ </ul> <p> One significant feature is that the remoteable services servlet is a full-blown REST interface. Therefore, in cases where the interface classes are not available on the client side, http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/18feb674/juneau-microservice-template/.settings/org.eclipse.wst.html.core.prefs ---------------------------------------------------------------------- diff --cc juneau-microservice-template/.settings/org.eclipse.wst.html.core.prefs index 0000000,0000000..ee1e1ce new file mode 100644 --- /dev/null +++ b/juneau-microservice-template/.settings/org.eclipse.wst.html.core.prefs @@@ -1,0 -1,0 +1,43 @@@ ++attrDuplicate=2 ++attrInvalidName=2 ++attrInvalidValue=2 ++attrNameMismatch=2 ++attrNamesToIgnore= ++attrUndefName=2 ++attrUndefValue=2 ++attrValueEqualsMissing=2 ++attrValueMismatch=1 ++attrValueUnclosed=2 ++cdataInvalidContent=2 ++cdataUnclosed=1 ++commentInvalidContent=2 ++commentUnclosed=1 ++docDoctypeUnclosed=1 ++docDuplicateTag=1 ++docInvalidChar=2 ++docInvalidContent=2 ++eclipse.preferences.version=1 ++elemCoexistence=2 ++elemDuplicate=2 ++elemEndInvalidCase=1 ++elemInvalidContent=2 ++elemInvalidDirective=1 ++elemInvalidEmptyTag=2 ++elemInvalidName=1 ++elemInvalidText=2 ++elemMissingEnd=2 ++elemMissingStart=2 ++elemStartInvalidCase=2 ++elemUnclosedEndTag=1 ++elemUnclosedStartTag=1 ++elemUnknownName=2 ++elemUnnecessaryEnd=2 ++elementNamesToIgnore=jc,jd,jt,jk,js,jf,jsf,jsm,ja,xt,xa,xc,xs,mk,mv,cc,cs,ck,ce,cv,l,properties ++ignoreAttrNames=false ++ignoreElementNames=true ++piInvalidContent=2 ++piUnclosed=1 ++piUndefined=2 ++refInvalidContent=2 ++resourceNotFound=2 ++use-project-settings=true http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/18feb674/juneau-microservice-template/.settings/org.eclipse.wst.xml.core.prefs ---------------------------------------------------------------------- diff --cc juneau-microservice-template/.settings/org.eclipse.wst.xml.core.prefs index 0000000,0000000..f4c656f new file mode 100644 --- /dev/null +++ b/juneau-microservice-template/.settings/org.eclipse.wst.xml.core.prefs @@@ -1,0 -1,0 +1,18 @@@ ++attributeHasNoValue=2 ++eclipse.preferences.version=1 ++endTagWithAttributes=2 ++honourAllSchemaLocations=true ++indicateNoGrammar=-1 ++indiciateNoDocumentElement=-1 ++markupValidation=false ++missingClosingBracket=2 ++missingClosingQuote=2 ++missingEndTag=2 ++missingQuotes=2 ++missingStartTag=2 ++missingTagName=2 ++namespaceInPITarget=2 ++use-project-settings=true ++whitespaceAtStart=2 ++whitespaceBeforeTagName=2 ++xinclude=false http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/18feb674/juneau-microservice/.settings/org.eclipse.wst.html.core.prefs ---------------------------------------------------------------------- diff --cc juneau-microservice/.settings/org.eclipse.wst.html.core.prefs index 0000000,0000000..ee1e1ce new file mode 100644 --- /dev/null +++ b/juneau-microservice/.settings/org.eclipse.wst.html.core.prefs @@@ -1,0 -1,0 +1,43 @@@ ++attrDuplicate=2 ++attrInvalidName=2 ++attrInvalidValue=2 ++attrNameMismatch=2 ++attrNamesToIgnore= ++attrUndefName=2 ++attrUndefValue=2 ++attrValueEqualsMissing=2 ++attrValueMismatch=1 ++attrValueUnclosed=2 ++cdataInvalidContent=2 ++cdataUnclosed=1 ++commentInvalidContent=2 ++commentUnclosed=1 ++docDoctypeUnclosed=1 ++docDuplicateTag=1 ++docInvalidChar=2 ++docInvalidContent=2 ++eclipse.preferences.version=1 ++elemCoexistence=2 ++elemDuplicate=2 ++elemEndInvalidCase=1 ++elemInvalidContent=2 ++elemInvalidDirective=1 ++elemInvalidEmptyTag=2 ++elemInvalidName=1 ++elemInvalidText=2 ++elemMissingEnd=2 ++elemMissingStart=2 ++elemStartInvalidCase=2 ++elemUnclosedEndTag=1 ++elemUnclosedStartTag=1 ++elemUnknownName=2 ++elemUnnecessaryEnd=2 ++elementNamesToIgnore=jc,jd,jt,jk,js,jf,jsf,jsm,ja,xt,xa,xc,xs,mk,mv,cc,cs,ck,ce,cv,l,properties ++ignoreAttrNames=false ++ignoreElementNames=true ++piInvalidContent=2 ++piUnclosed=1 ++piUndefined=2 ++refInvalidContent=2 ++resourceNotFound=2 ++use-project-settings=true http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/18feb674/juneau-samples/.settings/org.eclipse.wst.html.core.prefs ---------------------------------------------------------------------- diff --cc juneau-samples/.settings/org.eclipse.wst.html.core.prefs index 0000000,0000000..ee1e1ce new file mode 100644 --- /dev/null +++ b/juneau-samples/.settings/org.eclipse.wst.html.core.prefs @@@ -1,0 -1,0 +1,43 @@@ ++attrDuplicate=2 ++attrInvalidName=2 ++attrInvalidValue=2 ++attrNameMismatch=2 ++attrNamesToIgnore= ++attrUndefName=2 ++attrUndefValue=2 ++attrValueEqualsMissing=2 ++attrValueMismatch=1 ++attrValueUnclosed=2 ++cdataInvalidContent=2 ++cdataUnclosed=1 ++commentInvalidContent=2 ++commentUnclosed=1 ++docDoctypeUnclosed=1 ++docDuplicateTag=1 ++docInvalidChar=2 ++docInvalidContent=2 ++eclipse.preferences.version=1 ++elemCoexistence=2 ++elemDuplicate=2 ++elemEndInvalidCase=1 ++elemInvalidContent=2 ++elemInvalidDirective=1 ++elemInvalidEmptyTag=2 ++elemInvalidName=1 ++elemInvalidText=2 ++elemMissingEnd=2 ++elemMissingStart=2 ++elemStartInvalidCase=2 ++elemUnclosedEndTag=1 ++elemUnclosedStartTag=1 ++elemUnknownName=2 ++elemUnnecessaryEnd=2 ++elementNamesToIgnore=jc,jd,jt,jk,js,jf,jsf,jsm,ja,xt,xa,xc,xs,mk,mv,cc,cs,ck,ce,cv,l,properties ++ignoreAttrNames=false ++ignoreElementNames=true ++piInvalidContent=2 ++piUnclosed=1 ++piUndefined=2 ++refInvalidContent=2 ++resourceNotFound=2 ++use-project-settings=true http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/18feb674/juneau-server-test/.settings/org.eclipse.wst.html.core.prefs ---------------------------------------------------------------------- diff --cc juneau-server-test/.settings/org.eclipse.wst.html.core.prefs index 0000000,0000000..ee1e1ce new file mode 100644 --- /dev/null +++ b/juneau-server-test/.settings/org.eclipse.wst.html.core.prefs @@@ -1,0 -1,0 +1,43 @@@ ++attrDuplicate=2 ++attrInvalidName=2 ++attrInvalidValue=2 ++attrNameMismatch=2 ++attrNamesToIgnore= ++attrUndefName=2 ++attrUndefValue=2 ++attrValueEqualsMissing=2 ++attrValueMismatch=1 ++attrValueUnclosed=2 ++cdataInvalidContent=2 ++cdataUnclosed=1 ++commentInvalidContent=2 ++commentUnclosed=1 ++docDoctypeUnclosed=1 ++docDuplicateTag=1 ++docInvalidChar=2 ++docInvalidContent=2 ++eclipse.preferences.version=1 ++elemCoexistence=2 ++elemDuplicate=2 ++elemEndInvalidCase=1 ++elemInvalidContent=2 ++elemInvalidDirective=1 ++elemInvalidEmptyTag=2 ++elemInvalidName=1 ++elemInvalidText=2 ++elemMissingEnd=2 ++elemMissingStart=2 ++elemStartInvalidCase=2 ++elemUnclosedEndTag=1 ++elemUnclosedStartTag=1 ++elemUnknownName=2 ++elemUnnecessaryEnd=2 ++elementNamesToIgnore=jc,jd,jt,jk,js,jf,jsf,jsm,ja,xt,xa,xc,xs,mk,mv,cc,cs,ck,ce,cv,l,properties ++ignoreAttrNames=false ++ignoreElementNames=true ++piInvalidContent=2 ++piUnclosed=1 ++piUndefined=2 ++refInvalidContent=2 ++resourceNotFound=2 ++use-project-settings=true http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/18feb674/juneau-server/.settings/org.eclipse.wst.html.core.prefs ---------------------------------------------------------------------- diff --cc juneau-server/.settings/org.eclipse.wst.html.core.prefs index 0000000,0000000..ee1e1ce new file mode 100644 --- /dev/null +++ b/juneau-server/.settings/org.eclipse.wst.html.core.prefs @@@ -1,0 -1,0 +1,43 @@@ ++attrDuplicate=2 ++attrInvalidName=2 ++attrInvalidValue=2 ++attrNameMismatch=2 ++attrNamesToIgnore= ++attrUndefName=2 ++attrUndefValue=2 ++attrValueEqualsMissing=2 ++attrValueMismatch=1 ++attrValueUnclosed=2 ++cdataInvalidContent=2 ++cdataUnclosed=1 ++commentInvalidContent=2 ++commentUnclosed=1 ++docDoctypeUnclosed=1 ++docDuplicateTag=1 ++docInvalidChar=2 ++docInvalidContent=2 ++eclipse.preferences.version=1 ++elemCoexistence=2 ++elemDuplicate=2 ++elemEndInvalidCase=1 ++elemInvalidContent=2 ++elemInvalidDirective=1 ++elemInvalidEmptyTag=2 ++elemInvalidName=1 ++elemInvalidText=2 ++elemMissingEnd=2 ++elemMissingStart=2 ++elemStartInvalidCase=2 ++elemUnclosedEndTag=1 ++elemUnclosedStartTag=1 ++elemUnknownName=2 ++elemUnnecessaryEnd=2 ++elementNamesToIgnore=jc,jd,jt,jk,js,jf,jsf,jsm,ja,xt,xa,xc,xs,mk,mv,cc,cs,ck,ce,cv,l,properties ++ignoreAttrNames=false ++ignoreElementNames=true ++piInvalidContent=2 ++piUnclosed=1 ++piUndefined=2 ++refInvalidContent=2 ++resourceNotFound=2 ++use-project-settings=true http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/18feb674/juneau-server/src/main/java/org/apache/juneau/server/jaxrs/package.html ---------------------------------------------------------------------- diff --cc juneau-server/src/main/java/org/apache/juneau/server/jaxrs/package.html index 5fc4d22,5fc4d22..1cfada1 --- a/juneau-server/src/main/java/org/apache/juneau/server/jaxrs/package.html +++ b/juneau-server/src/main/java/org/apache/juneau/server/jaxrs/package.html @@@ -60,13 -60,13 +60,13 @@@ Defines an API and default provides for using Juneau serializers and parsers as JAX-RS providers. </p> --<a name='TOC'></a><h5 class='toc'>Table of Contents</h5> ++<a id='TOC'></a><h5 class='toc'>Table of Contents</h5> <ol class='toc'> <li><p><a class='doclink' href='#BaseProvider'>Juneau JAX-RS Provider</a></p> </ol> <!-- ======================================================================================================== --> --<a name="BaseProvider"></a> ++<a id="BaseProvider"></a> <h2 class='topic' onclick='toggle(this)'>1 - Juneau JAX-RS Provider</h2> <div class='topic'> <p> @@@ -254,7 -254,7 +254,6 @@@ In these examples, note that the <jsf>SERIALIZER_useIndentation</jsf> and <jsf>LAX_MODE</jsf> settings cause the output to be readable instead of condensed. </p> -- </p> <p class='bcode'> C:\>curl.exe -H "Accept: text/json" -X GET http://localhost:9080/sample/wink/helloworld <ja>{ @@@ -307,7 -307,7 +306,7 @@@ </p> <p class='bcode'> C:\>curl.exe -H "Accept: application/x-www-form-urlencoded" -X GET http://localhost:9080/sample/wink/helloworld -- <ja>text='Hello+world'&author='John+Smith'</ja> ++ <ja>text='Hello+world'&author='John+Smith'</ja> </p> <p class='bcode'> C:\>curl.exe -H "Accept: text/xml+schema" -X GET http://localhost:9080/sample/wink/helloworld @@@ -330,8 -330,8 +329,8 @@@ stackTracet â²[Ljava/lang/StackTraceElement;xpq t /com.ibm.sample.jaxrs.HelloWorldResource$Messageur â²[Ljava.lang.Sta lineNumberL â«declaringClassq ~ â LfileNameq ~ â L methodNameq ~ â xp â¦Ã¡t âjava.io.ObjectOutputStreamt â¨ObjectOutputStream.javat âwriteObject0sq ~ â âº[t âjava.io.Obje -- 3org.apache.juneau.serializer.OutputStreamSerializert âOutputStreamSerializer.javat serializesq ~ â ^t &com.ib -- &t /org.apache.wink.server.handlers.AbstractHandlert ¶AbstractHandler.javat â«handleResponsesq ~ â ât 5org.apache. ++ 3org.apache.juneau.serializer.OutputStreamSerializert âOutputStreamSerializer.javat serializesq ~ â ^t &com.ib ++ &t /org.apache.wink.server.handlers.AbstractHandlert ¶AbstractHandler.javat â«handleResponsesq ~ â ât 5org.apache. sq ~ â Ct 5org.apache.wink.server.handlers.AbstractHandlersChaint âAbstractHandlersChain.javat doChainsq ~ â 't â handlesq ~ â â¬t 5org.apache.wink.server.handlers.ResponseHandlersChaint âResponseHandlersChain.javat â handlesq ~ â«handleResponsesq ~ â ât 5org.apache.wink.server.handlers.ResponseHandlersChaint âResponseHandlersChain.javat â ha http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/18feb674/juneau-server/src/main/java/org/apache/juneau/server/package.html ---------------------------------------------------------------------- diff --cc juneau-server/src/main/java/org/apache/juneau/server/package.html index a498e78,a498e78..8eb9783 --- a/juneau-server/src/main/java/org/apache/juneau/server/package.html +++ b/juneau-server/src/main/java/org/apache/juneau/server/package.html @@@ -60,7 -60,7 +60,7 @@@ Defines an API for defining REST resources as servlets. </p> --<a name='TOC'></a><h5 class='toc'>Table of Contents</h5> ++<a id='TOC'></a><h5 class='toc'>Table of Contents</h5> <ol class='toc'> <li><p><a class='doclink' href='#Intro'>Introduction</a></p> <li><p><a class='doclink' href='#HelloWorldResource'>Hello World Example</a></p> @@@ -109,7 -109,7 +109,7 @@@ </ol> <!-- ======================================================================================================== --> --<a name="Intro"></a> ++<a id="Intro"></a> <h2 class='topic' onclick='toggle(this)'>1 - Introduction</h2> <div class='topic'> <p> @@@ -171,7 -171,7 +171,7 @@@ <li>Ability to pass HTTP header values as URL GET parameters (e.g. <l>&Accept=text/xml</l>). <li>Ability to pass HTTP content on PUT/POST requests as a URL GET parameter (e.g. <l>&content={foo:"bar"}</l>). <li>Ability to simulate non-GET requests using a <l>&method</l> GET parameter (e.g. <l>&method=POST</l>). -- <li>Ability to force <ss>"text/plain"</ss> on response using GET parameter <l>&plainText=true</l>. ++ <li>Ability to force <js>"text/plain"</js> on response using GET parameter <l>&plainText=true</l>. </ul> <br> <li>Ability to implement overloaded HTTP methods through the use of the <l>&method</l> attribute (e.g. <l>&method=FOO</l>). @@@ -190,7 -190,7 +190,7 @@@ </div> <!-- ======================================================================================================== --> --<a name="HelloWorldResource"></a> ++<a id="HelloWorldResource"></a> <h2 class='topic' onclick='toggle(this)'>2 - Hello World Example</h2> <div class='topic'> <p> @@@ -315,7 -315,7 +315,7 @@@ </div> <!-- ======================================================================================================== --> --<a name="ClassHierarchy"></a> ++<a id="ClassHierarchy"></a> <h2 class='topic' onclick='toggle(this)'>3 - Class Hierarchy</h2> <div class='topic'> <p> @@@ -381,7 -381,7 +381,7 @@@ </div> <!-- ======================================================================================================== --> --<a name="RestResources"></a> ++<a id="RestResources"></a> <h2 class='topic' onclick='toggle(this)'>4 - REST Servlets</h2> <div class='topic'> <p> @@@ -420,6 -420,6 +420,7 @@@ <td class='code'>application/json</td> <td>{@link org.apache.juneau.json.JsonSerializer.Simple}</td> </tr> ++ <tr> <td class='code'>application/json+schema<br>text/json+schema</td> <td class='code'>application/json</td> <td>{@link org.apache.juneau.json.JsonSchemaSerializer}</td> @@@ -525,7 -525,7 +526,7 @@@ </ul> <!-- ======================================================================================================== --> -- <a name="RestResources.MethodSignature"></a> ++ <a id="RestResources.MethodSignature"></a> <h3 class='topic' onclick='toggle(this)'>4.1 - REST Java Method Signature</h3> <div class='topic'> <p> @@@ -679,7 -679,7 +680,7 @@@ </ul> <!-- ======================================================================================================== --> -- <a name="RestResources.MethodSignature.Path"></a> ++ <a id="RestResources.MethodSignature.Path"></a> <h4 class='topic' onclick='toggle(this)'>4.1.1 - Path</h4> <div class='topic'> <p> @@@ -780,7 -780,7 +781,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.MethodSignature.Matchers"></a> ++ <a id="RestResources.MethodSignature.Matchers"></a> <h4 class='topic' onclick='toggle(this)'>4.1.2 - Matchers</h4> <div class='topic'> <p> @@@ -824,7 -824,7 +825,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.RequestContent"></a> ++ <a id="RestResources.RequestContent"></a> <h3 class='topic' onclick='toggle(this)'>4.2 - Request Content</h3> <div class='topic'> <p> @@@ -864,7 -864,7 +865,7 @@@ </p> <!-- ======================================================================================================== --> -- <a name="RestResources.RequestContent.FormPosts"></a> ++ <a id="RestResources.RequestContent.FormPosts"></a> <h4 class='topic' onclick='toggle(this)'>4.2.1 - Form Posts</h4> <div class='topic'> <p> @@@ -873,7 -873,7 +874,7 @@@ <p> The best way to handle a form post is by using an input bean. The samples include a <l>UrlEncodedFormResource</l> class that takes in URL-Encoded -- form post of the form <l>"aString=foo&aNumber=123&aDate=2001-07-04T15:30:45Z"</l>. ++ form post of the form <l>"aString=foo&aNumber=123&aDate=2001-07-04T15:30:45Z"</l>. The code is shown here: </p> <p class='bcode'> @@@ -922,7 -922,7 +923,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.RequestContent"></a> ++ <a id="RestResources.RequestContent"></a> <h4 class='topic' onclick='toggle(this)'>4.2.2 - Multipart Form Posts</h4> <div class='topic'> <p> @@@ -962,7 -962,7 +963,7 @@@ <ja>@Override</ja> <jc>/* RestMatcher */</jc> <jk>public boolean</jk> matches(RestRequest req) { String contentType = req.getContentType(); -- <jk>return</jk> contentType != <jk>null</jk> && contentType.startsWith(<js>"multipart/form-data"</js>); ++ <jk>return</jk> contentType != <jk>null</jk> && contentType.startsWith(<js>"multipart/form-data"</js>); } } </p> @@@ -970,7 -970,7 +971,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.ResponseContent"></a> ++ <a id="RestResources.ResponseContent"></a> <h3 class='topic' onclick='toggle(this)'>4.3 - Response Content</h3> <div class='topic'> <p> @@@ -1012,7 -1012,7 +1013,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.OptionsPages"></a> ++ <a id="RestResources.OptionsPages"></a> <h3 class='topic' onclick='toggle(this)'>4.4 - OPTIONS Pages</h3> <div class='topic'> <p> @@@ -1316,7 -1316,7 +1317,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.Serializers"></a> ++ <a id="RestResources.Serializers"></a> <h3 class='topic' onclick='toggle(this)'>4.5 - Serializers</h3> <div class='topic'> <p> @@@ -1377,7 -1377,7 +1378,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.Parsers"></a> ++ <a id="RestResources.Parsers"></a> <h3 class='topic' onclick='toggle(this)'>4.6 - Parsers</h3> <div class='topic'> <p> @@@ -1434,7 -1434,7 +1435,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.Properties"></a> ++ <a id="RestResources.Properties"></a> <h3 class='topic' onclick='toggle(this)'>4.7 - Properties</h3> <div class='topic'> <p> @@@ -1529,7 -1529,7 +1530,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.Transforms"></a> ++ <a id="RestResources.Transforms"></a> <h3 class='topic' onclick='toggle(this)'>4.8 - Transforms</h3> <div class='topic'> <p> @@@ -1584,7 -1584,7 +1585,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.Guards"></a> ++ <a id="RestResources.Guards"></a> <h3 class='topic' onclick='toggle(this)'>4.9 - Guards</h3> <div class='topic'> <p> @@@ -1647,7 -1647,7 +1648,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.Converters"></a> ++ <a id="RestResources.Converters"></a> <h3 class='topic' onclick='toggle(this)'>4.10 - Converters</h3> <div class='topic'> <p> @@@ -1744,7 -1744,7 +1745,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.Children"></a> ++ <a id="RestResources.Children"></a> <h3 class='topic' onclick='toggle(this)'>4.11 - Child Resources</h3> <div class='topic'> <p> @@@ -1869,8 -1869,8 +1870,9 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.Labels"></a> ++ <a id="RestResources.Labels"></a> <h3 class='topic' onclick='toggle(this)'>4.12 - Localized Messages</h3> ++ <div class='topic'> <p> The {@link org.apache.juneau.server.annotation.RestResource#messages @RestResource.messages()} annotation can be used to associate a resource bundle with a servlet class. </p> @@@ -1912,7 -1912,7 +1914,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.Encoders"></a> ++ <a id="RestResources.Encoders"></a> <h3 class='topic' onclick='toggle(this)'>4.13- Encoders</h3> <div class='topic'> <p> @@@ -1941,7 -1941,7 +1943,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.SvlVars"></a> ++ <a id="RestResources.SvlVars"></a> <h3 class='topic' onclick='toggle(this)'>4.14 - SVL Vars</h3> <div class='topic'> <p> @@@ -2242,7 -2242,7 +2244,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.StaticFiles"></a> ++ <a id="RestResources.StaticFiles"></a> <h3 class='topic' onclick='toggle(this)'>4.15 - Static Files</h3> <div class='topic'> <p> @@@ -2284,7 -2284,7 +2286,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.Listeners"></a> ++ <a id="RestResources.Listeners"></a> <h3 class='topic' onclick='toggle(this)'>4.16 - Listener Methods</h3> <div class='topic'> <p> @@@ -2307,7 -2307,7 +2309,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.Stylesheet"></a> ++ <a id="RestResources.Stylesheet"></a> <h3 class='topic' onclick='toggle(this)'>4.17 - Stylesheet</h3> <div class='topic'> <p> @@@ -2362,7 -2362,7 +2364,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.Headers"></a> ++ <a id="RestResources.Headers"></a> <h3 class='topic' onclick='toggle(this)'>4.18 - Default Headers</h3> <div class='topic'> <p> @@@ -2402,7 -2402,7 +2404,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.Errors"></a> ++ <a id="RestResources.Errors"></a> <h3 class='topic' onclick='toggle(this)'>4.19 - Handling Errors / Logging</h3> <div class='topic'> <p> @@@ -2467,7 -2467,7 +2469,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.ConfigFile"></a> ++ <a id="RestResources.ConfigFile"></a> <h3 class='topic' onclick='toggle(this)'>4.20 - Configuration Files</h3> <div class='topic'> <p> @@@ -2638,7 -2638,7 +2640,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.Inheritence"></a> ++ <a id="RestResources.Inheritence"></a> <h3 class='topic' onclick='toggle(this)'>4.21 - Annotation Inheritence</h3> <div class='topic'> <p> @@@ -2777,7 -2777,7 +2779,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.HttpStatusCodes"></a> ++ <a id="RestResources.HttpStatusCodes"></a> <h3 class='topic' onclick='toggle(this)'>4.22 - HTTP Status Codes</h3> <div class='topic'> <p> @@@ -2835,7 -2835,7 +2837,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.OverloadedHttpMethods"></a> ++ <a id="RestResources.OverloadedHttpMethods"></a> <h3 class='topic' onclick='toggle(this)'>4.23 - Overloaded HTTP Methods</h3> <div class='topic'> <p> @@@ -2857,7 -2857,7 +2859,7 @@@ <p class='bcode'> <ja>@RestResource</ja>( properties={ -- <jc>// Allow &method parameter on BAR requests</jc> ++ <jc>// Allow &method parameter on BAR requests</jc> <ja>@Property</ja>(name=<jsf>REST_allowMethodParam</jsf>, value=<js>"BAR"</js>) }, ) @@@ -2865,7 -2865,7 +2867,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.BuildInParams"></a> ++ <a id="RestResources.BuildInParams"></a> <h3 class='topic' onclick='toggle(this)'>4.24 - Built-In Parameters</h3> <div class='topic'> <p> @@@ -2925,7 -2925,7 +2927,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.CustomSerializersParsers"></a> ++ <a id="RestResources.CustomSerializersParsers"></a> <h3 class='topic' onclick='toggle(this)'>4.25 - Defining your own serializers/parsers</h3> <div class='topic'> <p> @@@ -3046,7 -3046,7 +3048,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.ResponseHandlers"></a> ++ <a id="RestResources.ResponseHandlers"></a> <h3 class='topic' onclick='toggle(this)'>4.26 - Response Handlers</h3> <div class='topic'> <p> @@@ -3089,7 -3089,7 +3091,7 @@@ </div> <!-- ======================================================================================================== --> -- <a name="RestResources.OtherNotes"></a> ++ <a id="RestResources.OtherNotes"></a> <h3 class='topic' onclick='toggle(this)'>4.27 - Other Notes</h3> <div class='topic'> <ul class='spaced-list'> @@@ -3114,7 -3114,7 +3116,7 @@@ </div> <!-- ======================================================================================================== --> --<a name="Osgi"></a> ++<a id="Osgi"></a> <h2 class='topic' onclick='toggle(this)'>5 - Using with OSGi</h2> <div class='topic'> <p> @@@ -3181,7 -3181,7 +3183,7 @@@ </div> <!-- ======================================================================================================== --> --<a name="PojosConvertableFromString"></a> ++<a id="PojosConvertableFromString"></a> <h2 class='topic' onclick='toggle(this)'>6 - POJOs Convertable From Strings</h2> <div class='topic'> <p> @@@ -3210,7 -3210,7 +3212,7 @@@ </div> <!-- ======================================================================================================== --> --<a name="AddressBookResource"></a> ++<a id="AddressBookResource"></a> <h2 class='topic' onclick='toggle(this)'>7 - Address Book Resource</h2> <div class='topic'> <p> @@@ -3591,7 -3591,7 +3593,7 @@@ <ck>getCognosData</ck> = <cv>Get data in Cognos/XML format</cv> <ck>getCognosData.res.200.content</ck> = <cv>DataSet</cv> -- <ck>otherNotes</ck> = <cv>GZip support enabled. Public methods can be invoked by using the &Method URL parameter. 'text/cognos+xml' support available under root resource only</cv> ++ <ck>otherNotes</ck> = <cv>GZip support enabled. Public methods can be invoked by using the &Method URL parameter. 'text/cognos+xml' support available under root resource only</cv> </p> </div> http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/18feb674/juneau-server/src/main/java/org/apache/juneau/server/remoteable/package.html ---------------------------------------------------------------------- diff --cc juneau-server/src/main/java/org/apache/juneau/server/remoteable/package.html index 1f7ab39,1f7ab39..6a1305b --- a/juneau-server/src/main/java/org/apache/juneau/server/remoteable/package.html +++ b/juneau-server/src/main/java/org/apache/juneau/server/remoteable/package.html @@@ -60,7 -60,7 +60,7 @@@ Defines an API for remote proxy interfaces (e.g. Remoteable Services). </p> --<a name='TOC'></a><h5 class='toc'>Table of Contents</h5> ++<a id='TOC'></a><h5 class='toc'>Table of Contents</h5> <ol class='toc'> <li><p><a class='doclink' href='#Intro'>Remoteable Services</a></p> <li><p><a class='doclink' href='#Client'>Client Side</a></p> @@@ -69,7 -69,7 +69,7 @@@ </ol> <!-- ======================================================================================================== --> --<a name="Intro"></a> ++<a id="Intro"></a> <h2 class='topic' onclick='toggle(this)'>1 - Remoteable Services</h2> <div class='topic'> <p> @@@ -114,15 -114,15 +114,15 @@@ </p> <p> The requirements for a method to be callable through the remoteable service are: -- <ul class='spaced-list'> -- <li>The method must be public. -- <li>The parameter and return types must be <a href='../../core/package-summary.html#PojoCategories'><u>serializable and parsable</u></a>. -- </ul> </p> ++ <ul class='spaced-list'> ++ <li>The method must be public. ++ <li>The parameter and return types must be <a href='../../core/package-summary.html#PojoCategories'>serializable and parsable</a>. ++ </ul> </div> <!-- ======================================================================================================== --> --<a name="Client"></a> ++<a id="Client"></a> <h2 class='topic' onclick='toggle(this)'>2 - Client Side</h2> <div class='topic'> <p> @@@ -162,7 -162,7 +162,7 @@@ </div> <!-- ======================================================================================================== --> --<a name="Server"></a> ++<a id="Server"></a> <h2 class='topic' onclick='toggle(this)'>3 - Server Side</h2> <div class='topic'> <p> @@@ -299,15 -299,15 +299,15 @@@ </p> <img class='bordered' src="doc-files/6.png"> <p> -- When specifying the POST body as a <code>&content</code> parameter, the method arguments should be in UON notation. ++ When specifying the POST body as a <code>&content</code> parameter, the method arguments should be in UON notation. See {@link org.apache.juneau.urlencoding.UonSerializer} for more information about this encoding. -- Usually you can also pass in JSON if you specify <code>&Content-Type=text/json</code> in the URL parameters ++ Usually you can also pass in JSON if you specify <code>&Content-Type=text/json</code> in the URL parameters but passing in unencoded JSON in a URL may not work in all browsers. Therefore, UON is preferred. </p> </div> <!-- ======================================================================================================== --> --<a name="RemoteableAnnotation"></a> ++<a id="RemoteableAnnotation"></a> <h2 class='topic' onclick='toggle(this)'>4 - @Remoteable Annotation</h2> <div class='topic'> <p>
