Clean up javadocs. Project: http://git-wip-us.apache.org/repos/asf/incubator-juneau/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-juneau/commit/0d913b38 Tree: http://git-wip-us.apache.org/repos/asf/incubator-juneau/tree/0d913b38 Diff: http://git-wip-us.apache.org/repos/asf/incubator-juneau/diff/0d913b38
Branch: refs/heads/master Commit: 0d913b38fb2cbb2d3e04faf7883e0ac8c046e05e Parents: b59ffb4 Author: JamesBognar <[email protected]> Authored: Mon Jun 26 22:38:04 2017 -0400 Committer: JamesBognar <[email protected]> Committed: Mon Jun 26 22:38:04 2017 -0400 ---------------------------------------------------------------------- .../apache/juneau/jena/RdfCommonContext.java | 100 +- .../java/org/apache/juneau/jena/RdfParser.java | 12 +- .../apache/juneau/jena/RdfParserBuilder.java | 55 +- .../apache/juneau/jena/RdfParserContext.java | 19 +- .../juneau/jena/RdfSerializerBuilder.java | 61 +- .../juneau/jena/RdfSerializerContext.java | 19 +- .../org/apache/juneau/jena/annotation/Rdf.java | 5 +- .../java/org/apache/juneau/jena/package.html | 182 ++- .../apache/juneau/transforms/DateSwapTest.java | 4 +- .../java/org/apache/juneau/BeanContext.java | 263 +++- .../org/apache/juneau/BeanDictionaryList.java | 16 +- .../org/apache/juneau/BeanDictionaryMap.java | 6 +- .../main/java/org/apache/juneau/BeanMap.java | 114 +- .../java/org/apache/juneau/BeanMapEntry.java | 25 +- .../main/java/org/apache/juneau/BeanMeta.java | 28 +- .../org/apache/juneau/BeanMetaExtended.java | 7 +- .../org/apache/juneau/BeanMetaFiltered.java | 4 +- .../org/apache/juneau/BeanPropertyMeta.java | 50 +- .../java/org/apache/juneau/BeanSession.java | 29 +- .../main/java/org/apache/juneau/ClassMeta.java | 24 +- .../main/java/org/apache/juneau/CoreObject.java | 4 +- .../org/apache/juneau/CoreObjectBuilder.java | 121 +- .../java/org/apache/juneau/PropertyStore.java | 176 ++- .../java/org/apache/juneau/annotation/Bean.java | 11 +- .../juneau/annotation/BeanConstructor.java | 3 +- .../apache/juneau/annotation/BeanProperty.java | 31 +- .../apache/juneau/annotation/NameProperty.java | 5 +- .../juneau/annotation/ParentProperty.java | 1 + .../org/apache/juneau/annotation/Produces.java | 6 +- .../org/apache/juneau/csv/CsvParserContext.java | 6 +- .../apache/juneau/csv/CsvSerializerContext.java | 6 +- .../apache/juneau/doc-files/AddressBook.html | 3 +- .../main/java/org/apache/juneau/dto/Link.java | 3 +- .../org/apache/juneau/dto/atom/AtomBuilder.java | 15 +- .../org/apache/juneau/dto/atom/Category.java | 17 +- .../java/org/apache/juneau/dto/atom/Common.java | 17 +- .../org/apache/juneau/dto/atom/CommonEntry.java | 16 +- .../org/apache/juneau/dto/atom/Content.java | 16 +- .../java/org/apache/juneau/dto/atom/Entry.java | 17 +- .../java/org/apache/juneau/dto/atom/Feed.java | 17 +- .../org/apache/juneau/dto/atom/Generator.java | 17 +- .../java/org/apache/juneau/dto/atom/Icon.java | 17 +- .../java/org/apache/juneau/dto/atom/Id.java | 17 +- .../java/org/apache/juneau/dto/atom/Link.java | 17 +- .../java/org/apache/juneau/dto/atom/Logo.java | 23 +- .../java/org/apache/juneau/dto/atom/Person.java | 17 +- .../java/org/apache/juneau/dto/atom/Source.java | 17 +- .../java/org/apache/juneau/dto/atom/Text.java | 17 +- .../java/org/apache/juneau/dto/atom/Utils.java | 15 +- .../org/apache/juneau/dto/atom/package.html | 6 +- .../org/apache/juneau/dto/cognos/package.html | 6 + .../java/org/apache/juneau/dto/html5/A.java | 11 +- .../java/org/apache/juneau/dto/html5/Abbr.java | 12 +- .../org/apache/juneau/dto/html5/Address.java | 12 +- .../java/org/apache/juneau/dto/html5/Area.java | 12 +- .../org/apache/juneau/dto/html5/Article.java | 12 +- .../java/org/apache/juneau/dto/html5/Aside.java | 12 +- .../java/org/apache/juneau/dto/html5/Audio.java | 12 +- .../java/org/apache/juneau/dto/html5/B.java | 12 +- .../java/org/apache/juneau/dto/html5/Base.java | 12 +- .../java/org/apache/juneau/dto/html5/Bdi.java | 12 +- .../java/org/apache/juneau/dto/html5/Bdo.java | 12 +- .../org/apache/juneau/dto/html5/Blockquote.java | 12 +- .../java/org/apache/juneau/dto/html5/Body.java | 12 +- .../java/org/apache/juneau/dto/html5/Br.java | 12 +- .../org/apache/juneau/dto/html5/Button.java | 12 +- .../org/apache/juneau/dto/html5/Canvas.java | 12 +- .../org/apache/juneau/dto/html5/Caption.java | 12 +- .../java/org/apache/juneau/dto/html5/Cite.java | 12 +- .../java/org/apache/juneau/dto/html5/Code.java | 12 +- .../java/org/apache/juneau/dto/html5/Col.java | 12 +- .../org/apache/juneau/dto/html5/Colgroup.java | 12 +- .../java/org/apache/juneau/dto/html5/Data.java | 12 +- .../org/apache/juneau/dto/html5/Datalist.java | 12 +- .../java/org/apache/juneau/dto/html5/Dd.java | 12 +- .../java/org/apache/juneau/dto/html5/Del.java | 12 +- .../java/org/apache/juneau/dto/html5/Dfn.java | 12 +- .../java/org/apache/juneau/dto/html5/Div.java | 12 +- .../java/org/apache/juneau/dto/html5/Dl.java | 12 +- .../java/org/apache/juneau/dto/html5/Dt.java | 12 +- .../java/org/apache/juneau/dto/html5/Em.java | 12 +- .../java/org/apache/juneau/dto/html5/Embed.java | 12 +- .../org/apache/juneau/dto/html5/Fieldset.java | 14 +- .../org/apache/juneau/dto/html5/Figcaption.java | 12 +- .../org/apache/juneau/dto/html5/Figure.java | 12 +- .../org/apache/juneau/dto/html5/Footer.java | 15 +- .../java/org/apache/juneau/dto/html5/Form.java | 12 +- .../java/org/apache/juneau/dto/html5/H1.java | 12 +- .../java/org/apache/juneau/dto/html5/H2.java | 12 +- .../java/org/apache/juneau/dto/html5/H3.java | 12 +- .../java/org/apache/juneau/dto/html5/H4.java | 12 +- .../java/org/apache/juneau/dto/html5/H5.java | 12 +- .../java/org/apache/juneau/dto/html5/H6.java | 12 +- .../java/org/apache/juneau/dto/html5/Head.java | 12 +- .../org/apache/juneau/dto/html5/Header.java | 12 +- .../java/org/apache/juneau/dto/html5/Hr.java | 12 +- .../java/org/apache/juneau/dto/html5/Html.java | 12 +- .../juneau/dto/html5/HtmlBeanDictionary.java | 12 +- .../apache/juneau/dto/html5/HtmlBuilder.java | 11 +- .../apache/juneau/dto/html5/HtmlElement.java | 11 +- .../juneau/dto/html5/HtmlElementContainer.java | 11 +- .../juneau/dto/html5/HtmlElementMixed.java | 11 +- .../juneau/dto/html5/HtmlElementRawText.java | 11 +- .../juneau/dto/html5/HtmlElementText.java | 11 +- .../juneau/dto/html5/HtmlElementVoid.java | 11 +- .../java/org/apache/juneau/dto/html5/I.java | 12 +- .../org/apache/juneau/dto/html5/Iframe.java | 12 +- .../java/org/apache/juneau/dto/html5/Img.java | 11 +- .../java/org/apache/juneau/dto/html5/Input.java | 12 +- .../java/org/apache/juneau/dto/html5/Ins.java | 12 +- .../java/org/apache/juneau/dto/html5/Kbd.java | 12 +- .../org/apache/juneau/dto/html5/Keygen.java | 12 +- .../java/org/apache/juneau/dto/html5/Label.java | 12 +- .../org/apache/juneau/dto/html5/Legend.java | 14 +- .../java/org/apache/juneau/dto/html5/Li.java | 12 +- .../java/org/apache/juneau/dto/html5/Link.java | 12 +- .../java/org/apache/juneau/dto/html5/Main.java | 12 +- .../java/org/apache/juneau/dto/html5/Map.java | 12 +- .../java/org/apache/juneau/dto/html5/Mark.java | 12 +- .../java/org/apache/juneau/dto/html5/Meta.java | 12 +- .../java/org/apache/juneau/dto/html5/Meter.java | 12 +- .../java/org/apache/juneau/dto/html5/Nav.java | 12 +- .../org/apache/juneau/dto/html5/Noscript.java | 12 +- .../org/apache/juneau/dto/html5/Object2.java | 12 +- .../java/org/apache/juneau/dto/html5/Ol.java | 12 +- .../org/apache/juneau/dto/html5/Optgroup.java | 12 +- .../org/apache/juneau/dto/html5/Option.java | 12 +- .../org/apache/juneau/dto/html5/Output.java | 12 +- .../java/org/apache/juneau/dto/html5/P.java | 12 +- .../java/org/apache/juneau/dto/html5/Param.java | 12 +- .../java/org/apache/juneau/dto/html5/Pre.java | 12 +- .../org/apache/juneau/dto/html5/Progress.java | 12 +- .../java/org/apache/juneau/dto/html5/Q.java | 12 +- .../java/org/apache/juneau/dto/html5/Rb.java | 12 +- .../java/org/apache/juneau/dto/html5/Rp.java | 12 +- .../java/org/apache/juneau/dto/html5/Rt.java | 12 +- .../java/org/apache/juneau/dto/html5/Rtc.java | 12 +- .../java/org/apache/juneau/dto/html5/Ruby.java | 12 +- .../java/org/apache/juneau/dto/html5/S.java | 12 +- .../java/org/apache/juneau/dto/html5/Samp.java | 12 +- .../org/apache/juneau/dto/html5/Script.java | 12 +- .../org/apache/juneau/dto/html5/Section.java | 12 +- .../org/apache/juneau/dto/html5/Select.java | 12 +- .../java/org/apache/juneau/dto/html5/Small.java | 12 +- .../org/apache/juneau/dto/html5/Source.java | 12 +- .../java/org/apache/juneau/dto/html5/Span.java | 12 +- .../org/apache/juneau/dto/html5/Strong.java | 12 +- .../java/org/apache/juneau/dto/html5/Style.java | 12 +- .../java/org/apache/juneau/dto/html5/Sub.java | 12 +- .../java/org/apache/juneau/dto/html5/Sup.java | 12 +- .../java/org/apache/juneau/dto/html5/Table.java | 12 +- .../java/org/apache/juneau/dto/html5/Tbody.java | 12 +- .../java/org/apache/juneau/dto/html5/Td.java | 12 +- .../org/apache/juneau/dto/html5/Template.java | 12 +- .../org/apache/juneau/dto/html5/Textarea.java | 12 +- .../java/org/apache/juneau/dto/html5/Tfoot.java | 12 +- .../java/org/apache/juneau/dto/html5/Th.java | 12 +- .../java/org/apache/juneau/dto/html5/Thead.java | 12 +- .../java/org/apache/juneau/dto/html5/Time.java | 12 +- .../java/org/apache/juneau/dto/html5/Title.java | 12 +- .../java/org/apache/juneau/dto/html5/Tr.java | 12 +- .../java/org/apache/juneau/dto/html5/Track.java | 12 +- .../java/org/apache/juneau/dto/html5/U.java | 12 +- .../java/org/apache/juneau/dto/html5/Ul.java | 12 +- .../java/org/apache/juneau/dto/html5/Var.java | 12 +- .../java/org/apache/juneau/dto/html5/Video.java | 12 +- .../java/org/apache/juneau/dto/html5/Wbr.java | 12 +- .../org/apache/juneau/dto/html5/package.html | 3 +- .../apache/juneau/dto/jsonschema/JsonType.java | 16 +- .../juneau/dto/jsonschema/JsonTypeArray.java | 17 +- .../apache/juneau/dto/jsonschema/Schema.java | 41 +- .../juneau/dto/jsonschema/SchemaArray.java | 17 +- .../apache/juneau/dto/jsonschema/SchemaMap.java | 22 +- .../juneau/dto/jsonschema/SchemaProperty.java | 17 +- .../jsonschema/SchemaPropertySimpleArray.java | 16 +- .../apache/juneau/dto/jsonschema/SchemaRef.java | 16 +- .../apache/juneau/dto/jsonschema/package.html | 25 +- .../org/apache/juneau/dto/swagger/Contact.java | 15 +- .../dto/swagger/ExternalDocumentation.java | 15 +- .../apache/juneau/dto/swagger/HeaderInfo.java | 15 +- .../org/apache/juneau/dto/swagger/Info.java | 15 +- .../org/apache/juneau/dto/swagger/Items.java | 15 +- .../org/apache/juneau/dto/swagger/License.java | 15 +- .../apache/juneau/dto/swagger/Operation.java | 15 +- .../juneau/dto/swagger/ParameterInfo.java | 15 +- .../apache/juneau/dto/swagger/ResponseInfo.java | 15 +- .../apache/juneau/dto/swagger/SchemaInfo.java | 15 +- .../juneau/dto/swagger/SecurityScheme.java | 15 +- .../org/apache/juneau/dto/swagger/Swagger.java | 15 +- .../juneau/dto/swagger/SwaggerBuilder.java | 27 +- .../juneau/dto/swagger/SwaggerElement.java | 15 +- .../java/org/apache/juneau/dto/swagger/Tag.java | 15 +- .../java/org/apache/juneau/dto/swagger/Xml.java | 15 +- .../org/apache/juneau/dto/swagger/package.html | 3 +- .../juneau/html/HtmlDocSerializerContext.java | 28 +- .../apache/juneau/html/HtmlParserContext.java | 15 +- .../org/apache/juneau/html/HtmlSerializer.java | 21 +- .../juneau/html/HtmlSerializerBuilder.java | 25 +- .../juneau/html/HtmlSerializerContext.java | 30 +- .../java/org/apache/juneau/html/package.html | 3 + .../java/org/apache/juneau/http/Accept.java | 12 +- .../org/apache/juneau/http/AcceptCharset.java | 6 +- .../org/apache/juneau/http/AcceptEncoding.java | 6 +- .../org/apache/juneau/http/AcceptLanguage.java | 6 +- .../org/apache/juneau/http/AcceptRanges.java | 6 +- .../main/java/org/apache/juneau/http/Age.java | 6 +- .../main/java/org/apache/juneau/http/Allow.java | 6 +- .../org/apache/juneau/http/Authorization.java | 6 +- .../org/apache/juneau/http/CacheControl.java | 6 +- .../java/org/apache/juneau/http/Connection.java | 6 +- .../java/org/apache/juneau/http/Constants.java | 6 +- .../org/apache/juneau/http/ContentEncoding.java | 6 +- .../apache/juneau/http/ContentEncodingEnum.java | 6 +- .../org/apache/juneau/http/ContentLanguage.java | 6 +- .../org/apache/juneau/http/ContentLength.java | 6 +- .../org/apache/juneau/http/ContentLocation.java | 6 +- .../org/apache/juneau/http/ContentRange.java | 6 +- .../org/apache/juneau/http/ContentType.java | 14 +- .../main/java/org/apache/juneau/http/Date.java | 6 +- .../main/java/org/apache/juneau/http/ETag.java | 6 +- .../org/apache/juneau/http/EntityValidator.java | 6 +- .../java/org/apache/juneau/http/Expect.java | 6 +- .../java/org/apache/juneau/http/Expires.java | 6 +- .../main/java/org/apache/juneau/http/From.java | 6 +- .../java/org/apache/juneau/http/HeaderDate.java | 6 +- .../juneau/http/HeaderEntityValidator.java | 6 +- .../juneau/http/HeaderEntityValidatorArray.java | 6 +- .../java/org/apache/juneau/http/HeaderEnum.java | 9 +- .../org/apache/juneau/http/HeaderInteger.java | 6 +- .../apache/juneau/http/HeaderRangeArray.java | 6 +- .../org/apache/juneau/http/HeaderString.java | 6 +- .../apache/juneau/http/HeaderStringArray.java | 6 +- .../java/org/apache/juneau/http/HeaderUri.java | 6 +- .../main/java/org/apache/juneau/http/Host.java | 6 +- .../java/org/apache/juneau/http/HttpMethod.java | 6 +- .../java/org/apache/juneau/http/IfMatch.java | 6 +- .../org/apache/juneau/http/IfModifiedSince.java | 6 +- .../org/apache/juneau/http/IfNoneMatch.java | 6 +- .../java/org/apache/juneau/http/IfRange.java | 6 +- .../apache/juneau/http/IfUnmodifiedSince.java | 6 +- .../org/apache/juneau/http/LastModified.java | 6 +- .../java/org/apache/juneau/http/Location.java | 6 +- .../org/apache/juneau/http/MaxForwards.java | 6 +- .../java/org/apache/juneau/http/MediaType.java | 8 +- .../org/apache/juneau/http/MediaTypeRange.java | 6 +- .../java/org/apache/juneau/http/Pragma.java | 6 +- .../apache/juneau/http/ProxyAuthenticate.java | 6 +- .../apache/juneau/http/ProxyAuthorization.java | 6 +- .../main/java/org/apache/juneau/http/Range.java | 6 +- .../java/org/apache/juneau/http/Referer.java | 6 +- .../java/org/apache/juneau/http/RetryAfter.java | 6 +- .../java/org/apache/juneau/http/Server.java | 6 +- .../org/apache/juneau/http/StringRange.java | 6 +- .../main/java/org/apache/juneau/http/TE.java | 6 +- .../java/org/apache/juneau/http/Trailer.java | 6 +- .../apache/juneau/http/TransferEncoding.java | 6 +- .../java/org/apache/juneau/http/Upgrade.java | 6 +- .../java/org/apache/juneau/http/UserAgent.java | 6 +- .../main/java/org/apache/juneau/http/Vary.java | 6 +- .../main/java/org/apache/juneau/http/Via.java | 6 +- .../java/org/apache/juneau/http/Warning.java | 6 +- .../org/apache/juneau/http/WwwAuthenticate.java | 6 +- .../java/org/apache/juneau/ini/ConfigFile.java | 61 +- .../apache/juneau/ini/ConfigFileBuilder.java | 27 +- .../java/org/apache/juneau/ini/package.html | 80 +- .../apache/juneau/internal/IdentityList.java | 8 +- .../org/apache/juneau/internal/KeywordSet.java | 6 +- .../org/apache/juneau/internal/StringUtils.java | 4 +- .../java/org/apache/juneau/json/JsonParser.java | 57 +- .../apache/juneau/json/JsonParserContext.java | 15 +- .../org/apache/juneau/json/JsonSerializer.java | 30 +- .../juneau/json/JsonSerializerBuilder.java | 4 +- .../juneau/json/JsonSerializerContext.java | 12 +- .../java/org/apache/juneau/json/JsonWriter.java | 2 +- .../org/apache/juneau/json/annotation/Json.java | 3 +- .../java/org/apache/juneau/json/package.html | 178 +-- .../juneau/msgpack/MsgPackInputStream.java | 2 +- .../juneau/msgpack/MsgPackOutputStream.java | 2 +- .../juneau/msgpack/MsgPackParserContext.java | 11 +- .../msgpack/MsgPackSerializerContext.java | 14 +- .../java/org/apache/juneau/parser/Parser.java | 17 +- .../org/apache/juneau/parser/ParserBuilder.java | 8 +- .../org/apache/juneau/parser/ParserGroup.java | 12 +- .../java/org/apache/juneau/parser/package.html | 15 +- .../java/org/apache/juneau/remoteable/Body.java | 26 +- .../org/apache/juneau/remoteable/FormData.java | 21 +- .../apache/juneau/remoteable/FormDataIfNE.java | 7 +- .../org/apache/juneau/remoteable/Header.java | 24 +- .../apache/juneau/remoteable/HeaderIfNE.java | 7 +- .../java/org/apache/juneau/remoteable/Path.java | 24 +- .../org/apache/juneau/remoteable/Query.java | 25 +- .../org/apache/juneau/remoteable/QueryIfNE.java | 7 +- .../apache/juneau/remoteable/RemoteMethod.java | 13 +- .../juneau/remoteable/RemoteMethodArg.java | 7 +- .../apache/juneau/remoteable/Remoteable.java | 8 +- .../juneau/remoteable/RemoteableMeta.java | 7 +- .../juneau/remoteable/RemoteableMethodMeta.java | 7 +- .../apache/juneau/remoteable/RequestBean.java | 9 +- .../juneau/serializer/SerializerBuilder.java | 38 +- .../juneau/serializer/SerializerContext.java | 16 +- .../juneau/serializer/SerializerGroup.java | 15 +- .../juneau/serializer/SerializerSession.java | 12 +- .../juneau/serializer/WriterSerializer.java | 6 +- .../org/apache/juneau/serializer/package.html | 22 +- .../juneau/soap/SoapXmlSerializerBuilder.java | 2 +- .../juneau/soap/SoapXmlSerializerContext.java | 14 +- .../java/org/apache/juneau/svl/VarResolver.java | 5 +- .../java/org/apache/juneau/svl/package.html | 75 +- .../java/org/apache/juneau/svl/vars/IfVar.java | 6 +- .../org/apache/juneau/transform/PojoSwap.java | 51 +- .../apache/juneau/transform/SurrogateSwap.java | 9 +- .../org/apache/juneau/transform/package.html | 45 +- .../apache/juneau/transforms/CalendarSwap.java | 2 +- .../org/apache/juneau/transforms/DateSwap.java | 2 +- .../apache/juneau/transforms/ReaderSwap.java | 2 +- .../org/apache/juneau/uon/UonParserBuilder.java | 2 +- .../org/apache/juneau/uon/UonParserContext.java | 13 +- .../apache/juneau/uon/UonSerializerBuilder.java | 2 +- .../apache/juneau/uon/UonSerializerContext.java | 38 +- .../java/org/apache/juneau/uon/UonWriter.java | 2 +- .../java/org/apache/juneau/uon/package.html | 173 +-- .../juneau/urlencoding/UrlEncodingContext.java | 2 +- .../urlencoding/UrlEncodingParserBuilder.java | 4 +- .../UrlEncodingSerializerBuilder.java | 14 +- .../org/apache/juneau/urlencoding/package.html | 173 +-- .../main/java/org/apache/juneau/utils/Args.java | 2 +- .../org/apache/juneau/utils/MessageBundle.java | 18 +- .../org/apache/juneau/utils/ObjectUtils.java | 24 +- .../apache/juneau/utils/PojoIntrospector.java | 25 +- .../java/org/apache/juneau/utils/PojoQuery.java | 51 +- .../java/org/apache/juneau/utils/PojoRest.java | 52 +- .../apache/juneau/utils/PojoRestException.java | 9 +- .../org/apache/juneau/utils/SearchArgs.java | 8 +- .../org/apache/juneau/xml/NamespaceFactory.java | 4 +- .../org/apache/juneau/xml/XmlParserBuilder.java | 12 +- .../org/apache/juneau/xml/XmlParserContext.java | 15 +- .../org/apache/juneau/xml/XmlSerializer.java | 2 +- .../apache/juneau/xml/XmlSerializerBuilder.java | 14 +- .../apache/juneau/xml/XmlSerializerContext.java | 16 +- .../java/org/apache/juneau/xml/XmlUtils.java | 17 +- .../java/org/apache/juneau/xml/XmlWriter.java | 2 +- .../org/apache/juneau/xml/annotation/Xml.java | 8 +- .../java/org/apache/juneau/xml/package.html | 244 ++-- juneau-core/src/main/javadoc/overview.html | 1269 ++++++++++------- .../juneau/examples/rest/TempDirResource.java | 4 +- .../juneau/microservice/Microservice.java | 42 +- .../apache/juneau/microservice/Resource.java | 12 +- .../juneau/microservice/ResourceGroup.java | 12 +- .../juneau/microservice/RestMicroservice.java | 23 +- .../org/apache/juneau/microservice/package.html | 162 ++- .../resources/DirectoryResource.java | 15 +- .../resources/LogEntryFormatter.java | 10 +- .../microservice/resources/LogParser.java | 8 +- .../microservice/resources/LogsResource.java | 4 +- .../eclipse-preferences/user-dictionary.txt | 55 + .../juneau/rest/client/AllowAllRedirects.java | 5 +- .../juneau/rest/client/NameValuePairs.java | 4 +- .../juneau/rest/client/ResponsePattern.java | 34 +- .../org/apache/juneau/rest/client/RestCall.java | 354 +++-- .../juneau/rest/client/RestCallException.java | 15 +- .../juneau/rest/client/RestCallInterceptor.java | 5 +- .../juneau/rest/client/RestCallLogger.java | 18 +- .../apache/juneau/rest/client/RestClient.java | 230 ++-- .../juneau/rest/client/RestClientBuilder.java | 133 +- .../juneau/rest/client/RestRequestEntity.java | 1 + .../org/apache/juneau/rest/client/RetryOn.java | 6 +- .../org/apache/juneau/rest/client/SSLOpts.java | 16 +- .../rest/client/SimpleX509TrustManager.java | 2 +- .../org/apache/juneau/rest/client/package.html | 231 ++-- .../org/apache/juneau/rest/jaxrs/package.html | 38 +- .../java/org/apache/juneau/rest/CallMethod.java | 27 +- .../java/org/apache/juneau/rest/CallRouter.java | 8 +- .../org/apache/juneau/rest/ReaderResource.java | 8 +- .../java/org/apache/juneau/rest/Redirect.java | 10 +- .../org/apache/juneau/rest/RequestBody.java | 31 +- .../org/apache/juneau/rest/RequestFormData.java | 52 +- .../org/apache/juneau/rest/RequestHeaders.java | 32 +- .../apache/juneau/rest/RequestPathMatch.java | 21 +- .../org/apache/juneau/rest/RequestQuery.java | 78 +- .../org/apache/juneau/rest/ResponseHandler.java | 43 +- .../org/apache/juneau/rest/RestCallHandler.java | 33 +- .../java/org/apache/juneau/rest/RestConfig.java | 159 ++- .../org/apache/juneau/rest/RestContext.java | 117 +- .../org/apache/juneau/rest/RestConverter.java | 18 +- .../org/apache/juneau/rest/RestException.java | 6 +- .../java/org/apache/juneau/rest/RestGuard.java | 23 +- .../apache/juneau/rest/RestInfoProvider.java | 120 +- .../java/org/apache/juneau/rest/RestLogger.java | 16 +- .../org/apache/juneau/rest/RestMatcher.java | 15 +- .../juneau/rest/RestMatcherReflecting.java | 5 +- .../java/org/apache/juneau/rest/RestParam.java | 6 +- .../org/apache/juneau/rest/RestRequest.java | 71 +- .../juneau/rest/RestResourceResolver.java | 3 +- .../org/apache/juneau/rest/RestResponse.java | 175 +-- .../org/apache/juneau/rest/RestServlet.java | 53 +- .../apache/juneau/rest/RestServletDefault.java | 35 +- .../java/org/apache/juneau/rest/RestUtils.java | 2 +- .../org/apache/juneau/rest/StreamResource.java | 9 +- .../org/apache/juneau/rest/UrlPathPattern.java | 7 +- .../org/apache/juneau/rest/annotation/Body.java | 4 +- .../apache/juneau/rest/annotation/FormData.java | 28 +- .../juneau/rest/annotation/HasFormData.java | 12 +- .../apache/juneau/rest/annotation/HasQuery.java | 10 +- .../apache/juneau/rest/annotation/Header.java | 4 +- .../apache/juneau/rest/annotation/HtmlDoc.java | 70 +- .../apache/juneau/rest/annotation/Inherit.java | 2 +- .../apache/juneau/rest/annotation/Messages.java | 4 +- .../apache/juneau/rest/annotation/Method.java | 4 +- .../juneau/rest/annotation/MethodSwagger.java | 41 +- .../juneau/rest/annotation/Parameter.java | 40 +- .../org/apache/juneau/rest/annotation/Path.java | 19 +- .../juneau/rest/annotation/PathRemainder.java | 4 +- .../juneau/rest/annotation/Properties.java | 14 +- .../apache/juneau/rest/annotation/Property.java | 4 +- .../apache/juneau/rest/annotation/Query.java | 36 +- .../juneau/rest/annotation/ResourceSwagger.java | 24 +- .../apache/juneau/rest/annotation/Response.java | 9 +- .../juneau/rest/annotation/RestMethod.java | 161 ++- .../juneau/rest/annotation/RestResource.java | 210 +-- .../juneau/rest/converters/Introspectable.java | 19 +- .../juneau/rest/converters/Queryable.java | 51 +- .../juneau/rest/converters/Traversable.java | 5 +- .../rest/jena/RestServletJenaDefault.java | 35 +- .../org/apache/juneau/rest/jena/package.html | 2 - .../juneau/rest/labels/BeanDescription.java | 5 +- .../rest/labels/ChildResourceDescriptions.java | 3 +- .../juneau/rest/labels/NameDescription.java | 5 + .../rest/matchers/MultipartFormDataMatcher.java | 2 +- .../rest/matchers/UrlEncodedFormMatcher.java | 2 +- .../java/org/apache/juneau/rest/package.html | 1291 +++++++++++------- .../remoteable/RemoteableServiceProperties.java | 9 +- .../rest/remoteable/RemoteableServlet.java | 12 +- .../apache/juneau/rest/remoteable/package.html | 85 +- .../juneau/rest/response/DefaultHandler.java | 4 +- .../rest/response/InputStreamHandler.java | 3 +- .../juneau/rest/response/StreamableHandler.java | 3 +- .../juneau/rest/response/WritableHandler.java | 3 +- .../response/ZipFileListResponseHandler.java | 12 +- .../juneau/rest/vars/LocalizationVar.java | 2 +- .../org/apache/juneau/rest/vars/RequestVar.java | 2 +- .../juneau/rest/vars/ServletInitParamVar.java | 2 +- .../apache/juneau/rest/vars/UrlEncodeVar.java | 3 +- .../org/apache/juneau/rest/vars/UrlVar.java | 5 +- .../org/apache/juneau/rest/vars/WidgetVar.java | 4 +- .../apache/juneau/rest/widget/QueryWidget.java | 8 +- .../org/apache/juneau/rest/widget/Widget.java | 4 +- 446 files changed, 7376 insertions(+), 4855 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/0d913b38/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfCommonContext.java ---------------------------------------------------------------------- diff --git a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfCommonContext.java b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfCommonContext.java index 2405235..eeadd03 100644 --- a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfCommonContext.java +++ b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfCommonContext.java @@ -48,22 +48,30 @@ public interface RdfCommonContext { * <p> * Can be any of the following: * <ul class='spaced-list'> - * <li><js>"RDF/XML"</js> - * <li><js>"RDF/XML-ABBREV"</js> - * <li><js>"N-TRIPLE"</js> - * <li><js>"N3"</js> - General name for the N3 writer. + * <li> + * <js>"RDF/XML"</js> + * <li> + * <js>"RDF/XML-ABBREV"</js> + * <li> + * <js>"N-TRIPLE"</js> + * <li> + * <js>"N3"</js> - General name for the N3 writer. * Will make a decision on exactly which writer to use (pretty writer, plain writer or simple writer) when * created. * Default is the pretty writer but can be overridden with system property * <code>com.hp.hpl.jena.n3.N3JenaWriter.writer</code>. - * <li><js>"N3-PP"</js> - Name of the N3 pretty writer. + * <li> + * <js>"N3-PP"</js> - Name of the N3 pretty writer. * The pretty writer uses a frame-like layout, with prefixing, clustering like properties and embedding * one-referenced bNodes. - * <li><js>"N3-PLAIN"</js> - Name of the N3 plain writer. + * <li> + * <js>"N3-PLAIN"</js> - Name of the N3 plain writer. * The plain writer writes records by subject. - * <li><js>"N3-TRIPLES"</js> - Name of the N3 triples writer. + * <li> + * <js>"N3-TRIPLES"</js> - Name of the N3 triples writer. * This writer writes one line per statement, like N-Triples, but does N3-style prefixing. - * <li><js>"TURTLE"</js> - Turtle writer. + * <li> + * <js>"TURTLE"</js> - Turtle writer. * http://www.dajobe.org/2004/01/turtle/ * </ul> */ @@ -118,11 +126,14 @@ public interface RdfCommonContext { * <p> * Possible values: * <ul class='spaced-list'> - * <li><js>"lax"</js> - The rules for RDF URI references only, which does permit spaces although the use of spaces + * <li> + * <js>"lax"</js> - The rules for RDF URI references only, which does permit spaces although the use of spaces * is not good practice. - * <li><js>"strict"</js> - Sets the IRI engine with rules for valid IRIs, XLink and RDF; it does not permit spaces + * <li> + * <js>"strict"</js> - Sets the IRI engine with rules for valid IRIs, XLink and RDF; it does not permit spaces * in IRIs. - * <li><js>"iri"</js> - Sets the IRI engine to IRI + * <li> + * <js>"iri"</js> - Sets the IRI engine to IRI * (<a class="doclink" href="http://www.ietf.org/rfc/rfc3986.txt";>RFC 3986</a>, * <a class="doclink" href="http://www.ietf.org/rfc/rfc3987.txt";>RFC 3987</a>). * </ul> @@ -153,10 +164,14 @@ public interface RdfCommonContext { * <p> * See also: * <ul class='spaced-list'> - * <li><a class="doclink" href="http://jena.sourceforge.net/javadoc/com/hp/hpl/jena/rdf/arp/ARPOptions.html#setDefaultErrorMode()">ARPOptions.setDefaultErrorMode()</a> - * <li><a class="doclink" href="http://jena.sourceforge.net/javadoc/com/hp/hpl/jena/rdf/arp/ARPOptions.html#setLaxErrorMode()">ARPOptions.setLaxErrorMode()</a> - * <li><a class="doclink" href="http://jena.sourceforge.net/javadoc/com/hp/hpl/jena/rdf/arp/ARPOptions.html#setStrictErrorMode()">ARPOptions.setStrictErrorMode()</a> - * <li><a class="doclink" href="http://jena.sourceforge.net/javadoc/com/hp/hpl/jena/rdf/arp/ARPOptions.html#setStrictErrorMode(int)">ARPOptions.setStrictErrorMode(int)</a> + * <li> + * <a class="doclink" href="http://jena.sourceforge.net/javadoc/com/hp/hpl/jena/rdf/arp/ARPOptions.html#setDefaultErrorMode()">ARPOptions.setDefaultErrorMode()</a> + * <li> + * <a class="doclink" href="http://jena.sourceforge.net/javadoc/com/hp/hpl/jena/rdf/arp/ARPOptions.html#setLaxErrorMode()">ARPOptions.setLaxErrorMode()</a> + * <li> + * <a class="doclink" href="http://jena.sourceforge.net/javadoc/com/hp/hpl/jena/rdf/arp/ARPOptions.html#setStrictErrorMode()">ARPOptions.setStrictErrorMode()</a> + * <li> + * <a class="doclink" href="http://jena.sourceforge.net/javadoc/com/hp/hpl/jena/rdf/arp/ARPOptions.html#setStrictErrorMode(int)">ARPOptions.setStrictErrorMode(int)</a> * </ul> */ public static final String RDF_arp_errorMode = "Rdf.jena.rdfXml.error-mode"; @@ -174,7 +189,8 @@ public interface RdfCommonContext { * <p> * See also: * <ul class='spaced-list'> - * <li><a class="doclink" href="http://jena.sourceforge.net/javadoc/com/hp/hpl/jena/rdf/arp/ARPOptions.html#setEmbedding(boolean)">ARPOptions.setEmbedding(boolean)</a> + * <li> + * <a class="doclink" href="http://jena.sourceforge.net/javadoc/com/hp/hpl/jena/rdf/arp/ARPOptions.html#setEmbedding(boolean)">ARPOptions.setEmbedding(boolean)</a> * </ul> */ public static final String RDF_arp_embedding = "Rdf.jena.rdfXml.embedding"; @@ -199,8 +215,10 @@ public interface RdfCommonContext { * <p> * See also: * <ul class='spaced-list'> - * <li><a class="doclink" href="http://jena.sourceforge.net/javadoc/com/hp/hpl/jena/rdf/arp/ARPErrorNumbers.html";>ARPErrorNumbers</a> - * <li><a class="doclink" href="http://jena.sourceforge.net/javadoc/com/hp/hpl/jena/rdf/arp/ARPOptions.html#setErrorMode(int,%20int)">ARPOptions.setErrorMode(int, int)</a> + * <li> + * <a class="doclink" href="http://jena.sourceforge.net/javadoc/com/hp/hpl/jena/rdf/arp/ARPErrorNumbers.html";>ARPErrorNumbers</a> + * <li> + * <a class="doclink" href="http://jena.sourceforge.net/javadoc/com/hp/hpl/jena/rdf/arp/ARPOptions.html#setErrorMode(int,%20int)">ARPOptions.setErrorMode(int, int)</a> * </ul> */ public static final String RDF_arp_err_ = "Rdf.jena.rdfXml.ERR_"; @@ -282,12 +300,18 @@ public interface RdfCommonContext { * <p> * A comma separate list of options: * <ul class='spaced-list'> - * <li><js>"same-document"</js> - Same-document references (e.g. <js>""</js> or <js>"#foo"</js>) - * <li><js>"network"</js> - Network paths (e.g. <js>"//example.org/foo"</js> omitting the URI scheme) - * <li><js>"absolute"</js> - Absolute paths (e.g. <js>"/foo"</js> omitting the scheme and authority) - * <li><js>"relative"</js> - Relative path not beginning in <js>"../"</js> - * <li><js>"parent"</js> - Relative path beginning in <js>"../"</js> - * <li><js>"grandparent"</js> - Relative path beginning in <js>"../../"</js> + * <li> + * <js>"same-document"</js> - Same-document references (e.g. <js>""</js> or <js>"#foo"</js>) + * <li> + * <js>"network"</js> - Network paths (e.g. <js>"//example.org/foo"</js> omitting the URI scheme) + * <li> + * <js>"absolute"</js> - Absolute paths (e.g. <js>"/foo"</js> omitting the scheme and authority) + * <li> + * <js>"relative"</js> - Relative path not beginning in <js>"../"</js> + * <li> + * <js>"parent"</js> - Relative path beginning in <js>"../"</js> + * <li> + * <js>"grandparent"</js> - Relative path beginning in <js>"../../"</js> * </ul> * <p> * The default value is <js>"same-document, absolute, relative, parent"</js>. @@ -307,9 +331,12 @@ public interface RdfCommonContext { * <p> * Possible values: * <ul class='spaced-list'> - * <li><js>"true"</js> - Add XML Declaration to the output. - * <li><js>"false"</js> - Don't add XML Declaration to the output. - * <li><js>"default"</js> - Only add an XML Declaration when asked to write to an <code>OutputStreamWriter</code> + * <li> + * <js>"true"</js> - Add XML Declaration to the output. + * <li> + * <js>"false"</js> - Don't add XML Declaration to the output. + * <li> + * <js>"default"</js> - Only add an XML Declaration when asked to write to an <code>OutputStreamWriter</code> * that uses some encoding other than <code>UTF-8</code> or <code>UTF-16</code>. * In this case the encoding is shown in the XML declaration. * </ul> @@ -515,13 +542,18 @@ public interface RdfCommonContext { * <p> * Possible values: * <ul class='spaced-list'> - * <li><js>"DEFAULT"</js> - Default format. The default is an RDF Sequence container. - * <li><js>"SEQ"</js> - RDF Sequence container. - * <li><js>"BAG"</js> - RDF Bag container. - * <li><js>"LIST"</js> - RDF List container. - * <li><js>"MULTI_VALUED"</js> - Multi-valued properties. - * </ul> - * <p> + * <li> + * <js>"DEFAULT"</js> - Default format. The default is an RDF Sequence container. + * <li> + * <js>"SEQ"</js> - RDF Sequence container. + * <li> + * <js>"BAG"</js> - RDF Bag container. + * <li> + * <js>"LIST"</js> - RDF List container. + * <li> + * <js>"MULTI_VALUED"</js> - Multi-valued properties. + * </ul> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>If you use <js>"BAG"</js> or <js>"MULTI_VALUED"</js>, the order of the elements in the collection will get http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/0d913b38/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfParser.java ---------------------------------------------------------------------- diff --git a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfParser.java b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfParser.java index 33f74c1..fe4f0ab 100644 --- a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfParser.java +++ b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfParser.java @@ -40,10 +40,14 @@ import com.hp.hpl.jena.util.iterator.*; * <p> * The following direct subclasses are provided for language-specific parsers: * <ul class='spaced-list'> - * <li>{@link RdfParser.Xml} - RDF/XML and RDF/XML-ABBREV. - * <li>{@link RdfParser.NTriple} - N-TRIPLE. - * <li>{@link RdfParser.Turtle} - TURTLE. - * <li>{@link RdfParser.N3} - N3. + * <li> + * {@link RdfParser.Xml} - RDF/XML and RDF/XML-ABBREV. + * <li> + * {@link RdfParser.NTriple} - N-TRIPLE. + * <li> + * {@link RdfParser.Turtle} - TURTLE. + * <li> + * {@link RdfParser.N3} - N3. * </ul> * * <h5 class='section'>Additional information:</h5> http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/0d913b38/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfParserBuilder.java ---------------------------------------------------------------------- diff --git a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfParserBuilder.java b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfParserBuilder.java index 8003b0d..252fbd0 100644 --- a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfParserBuilder.java +++ b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfParserBuilder.java @@ -66,7 +66,7 @@ public class RdfParserBuilder extends ParserBuilder { * </ul> * <p> * If <jk>true</jk>, whitespace in text elements will be automatically trimmed. - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_trimWhitespace</jsf>, value)</code>. @@ -91,25 +91,33 @@ public class RdfParserBuilder extends ParserBuilder { * <p> * Can be any of the following: * <ul class='spaced-list'> - * <li><js>"RDF/XML"</js> - * <li><js>"RDF/XML-ABBREV"</js> - * <li><js>"N-TRIPLE"</js> - * <li><js>"N3"</js> - General name for the N3 writer. + * <li> + * <js>"RDF/XML"</js> + * <li> + * <js>"RDF/XML-ABBREV"</js> + * <li> + * <js>"N-TRIPLE"</js> + * <li> + * <js>"N3"</js> - General name for the N3 writer. * Will make a decision on exactly which writer to use (pretty writer, plain writer or simple writer) when * created. * Default is the pretty writer but can be overridden with system property * <code>com.hp.hpl.jena.n3.N3JenaWriter.writer</code>. - * <li><js>"N3-PP"</js> - Name of the N3 pretty writer. + * <li> + * <js>"N3-PP"</js> - Name of the N3 pretty writer. * The pretty writer uses a frame-like layout, with prefixing, clustering like properties and embedding * one-referenced bNodes. - * <li><js>"N3-PLAIN"</js> - Name of the N3 plain writer. + * <li> + * <js>"N3-PLAIN"</js> - Name of the N3 plain writer. * The plain writer writes records by subject. - * <li><js>"N3-TRIPLES"</js> - Name of the N3 triples writer. + * <li> + * <js>"N3-TRIPLES"</js> - Name of the N3 triples writer. * This writer writes one line per statement, like N-Triples, but does N3-style prefixing. - * <li><js>"TURTLE"</js> - Turtle writer. + * <li> + * <js>"TURTLE"</js> - Turtle writer. * http://www.dajobe.org/2004/01/turtle/ * </ul> - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_language</jsf>, value)</code>. @@ -176,7 +184,7 @@ public class RdfParserBuilder extends ParserBuilder { * <li><b>Data type:</b> {@link Namespace} * <li><b>Default:</b> <code>{j:<js>'http://www.apache.org/juneau/'</js>}</code> * </ul> - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_juneauNs</jsf>, value)</code>. @@ -198,7 +206,7 @@ public class RdfParserBuilder extends ParserBuilder { * <li><b>Data type:</b> {@link Namespace} * <li><b>Default:</b> <code>{j:<js>'http://www.apache.org/juneaubp/'</js>}</code> * </ul> - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_juneauBpNs</jsf>, value)</code>. @@ -223,7 +231,7 @@ public class RdfParserBuilder extends ParserBuilder { * <p> * When specified, namespaces defined using {@link XmlNs} and {@link Xml} will be inherited by the RDF parsers. * Otherwise, namespaces will be defined using {@link RdfNs} and {@link Rdf}. - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_useXmlNamespaces</jsf>, value)</code>. @@ -248,19 +256,24 @@ public class RdfParserBuilder extends ParserBuilder { * <p> * Possible values: * <ul class='spaced-list'> - * <li><js>"DEFAULT"</js> - Default format. The default is an RDF Sequence container. - * <li><js>"SEQ"</js> - RDF Sequence container. - * <li><js>"BAG"</js> - RDF Bag container. - * <li><js>"LIST"</js> - RDF List container. - * <li><js>"MULTI_VALUED"</js> - Multi-valued properties. + * <li> + * <js>"DEFAULT"</js> - Default format. The default is an RDF Sequence container. + * <li> + * <js>"SEQ"</js> - RDF Sequence container. + * <li> + * <js>"BAG"</js> - RDF Bag container. + * <li> + * <js>"LIST"</js> - RDF List container. + * <li> + * <js>"MULTI_VALUED"</js> - Multi-valued properties. * </ul> - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>If you use <js>"BAG"</js> or <js>"MULTI_VALUED"</js>, the order of the elements in the collection will get * lost. * </ul> - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_collectionFormat</jsf>, value)</code>. @@ -315,7 +328,7 @@ public class RdfParserBuilder extends ParserBuilder { * <jc>// Parse back into a bean array</jc> * b = p.parse(rdfXml, MyBean[].<jk>class</jk>); * </p> - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_looseCollections</jsf>, value)</code>. http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/0d913b38/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfParserContext.java ---------------------------------------------------------------------- diff --git a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfParserContext.java b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfParserContext.java index fb083da..cadfa62 100644 --- a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfParserContext.java +++ b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfParserContext.java @@ -28,16 +28,21 @@ import org.apache.juneau.xml.*; * * <h6 class='topic' id='ConfigProperties'>Configurable properties inherited by the RDF parsers</h6> * <ul class='doctree'> - * <li class='jc'><a class="doclink" href="../BeanContext.html#ConfigProperties">BeanContext</a> + * <li class='jc'> + * <a class="doclink" href="../BeanContext.html#ConfigProperties">BeanContext</a> * - Properties associated with handling beans on serializers and parsers. - * <ul> - * <li class='jc'><a class="doclink" href="../parser/ParserContext.html#ConfigProperties">ParserContext</a> - * - Configurable properties common to all parsers. * <ul> - * <li class='jic'><a class="doclink" href="RdfCommonContext.html#ConfigProperties">RdfCommonContext</a> - * - Configurable properties common to the RDF serializers and parsers. + * <li class='jc'> + * <a class="doclink" href="../parser/ParserContext.html#ConfigProperties">ParserContext</a> + * - Configurable properties common to all parsers. + * <ul> + * <li class='jic'> + * <a class="doclink" href="RdfCommonContext.html#ConfigProperties">RdfCommonContext</a> + * - Configurable properties common to the RDF serializers and parsers. + * </ul> + * </li> * </ul> - * </ul> + * </li> * </ul> */ public final class RdfParserContext extends ParserContext implements RdfCommonContext { http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/0d913b38/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfSerializerBuilder.java ---------------------------------------------------------------------- diff --git a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfSerializerBuilder.java b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfSerializerBuilder.java index 85484e7..879466b 100644 --- a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfSerializerBuilder.java +++ b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfSerializerBuilder.java @@ -66,25 +66,33 @@ public class RdfSerializerBuilder extends SerializerBuilder { * <p> * Can be any of the following: * <ul class='spaced-list'> - * <li><js>"RDF/XML"</js> - * <li><js>"RDF/XML-ABBREV"</js> - * <li><js>"N-TRIPLE"</js> - * <li><js>"N3"</js> - General name for the N3 writer. + * <li> + * <js>"RDF/XML"</js> + * <li> + * <js>"RDF/XML-ABBREV"</js> + * <li> + * <js>"N-TRIPLE"</js> + * <li> + * <js>"N3"</js> - General name for the N3 writer. * Will make a decision on exactly which writer to use (pretty writer, plain writer or simple writer) when * created. * Default is the pretty writer but can be overridden with system property * <code>com.hp.hpl.jena.n3.N3JenaWriter.writer</code>. - * <li><js>"N3-PP"</js> - Name of the N3 pretty writer. + * <li> + * <js>"N3-PP"</js> - Name of the N3 pretty writer. * The pretty writer uses a frame-like layout, with prefixing, clustering like properties and embedding * one-referenced bNodes. - * <li><js>"N3-PLAIN"</js> - Name of the N3 plain writer. + * <li> + * <js>"N3-PLAIN"</js> - Name of the N3 plain writer. * The plain writer writes records by subject. - * <li><js>"N3-TRIPLES"</js> - Name of the N3 triples writer. + * <li> + * <js>"N3-TRIPLES"</js> - Name of the N3 triples writer. * This writer writes one line per statement, like N-Triples, but does N3-style prefixing. - * <li><js>"TURTLE"</js> - Turtle writer. + * <li> + * <js>"TURTLE"</js> - Turtle writer. * http://www.dajobe.org/2004/01/turtle/ * </ul> - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_language</jsf>, value)</code>. @@ -152,7 +160,7 @@ public class RdfSerializerBuilder extends SerializerBuilder { * <li><b>Data type:</b> {@link Namespace} * <li><b>Default:</b> <code>{j:<js>'http://www.apache.org/juneau/'</js>}</code> * </ul> - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_juneauNs</jsf>, value)</code>. @@ -175,7 +183,7 @@ public class RdfSerializerBuilder extends SerializerBuilder { * <li><b>Data type:</b> {@link Namespace} * <li><b>Default:</b> <code>{j:<js>'http://www.apache.org/juneaubp/'</js>}</code> * </ul> - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_juneauBpNs</jsf>, value)</code>. @@ -201,7 +209,7 @@ public class RdfSerializerBuilder extends SerializerBuilder { * <p> * When specified, namespaces defined using {@link XmlNs} and {@link Xml} will be inherited by the RDF serializers. * Otherwise, namespaces will be defined using {@link RdfNs} and {@link Rdf}. - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_useXmlNamespaces</jsf>, value)</code>. @@ -225,7 +233,7 @@ public class RdfSerializerBuilder extends SerializerBuilder { * <li><b>Default:</b> <jk>false</jk> * <li><b>Session-overridable:</b> <jk>true</jk> * </ul> - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_addLiteralTypes</jsf>, value)</code>. @@ -256,7 +264,7 @@ public class RdfSerializerBuilder extends SerializerBuilder { * <p> * If disabled, the parser has to search through the model to find any resources without incoming predicates to * identify root notes, which can introduce a considerable performance degradation. - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_addRootProperty</jsf>, value)</code>. @@ -285,7 +293,7 @@ public class RdfSerializerBuilder extends SerializerBuilder { * <p> * If enabled, then the data structure will first be crawled looking for namespaces that will be encountered before * the root element is serialized. - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_autoDetectNamespaces</jsf>, value)</code>. @@ -311,7 +319,7 @@ public class RdfSerializerBuilder extends SerializerBuilder { * </ul> * <p> * The default list of namespaces associated with this serializer. - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_namespaces</jsf>, values)</code>. @@ -337,19 +345,24 @@ public class RdfSerializerBuilder extends SerializerBuilder { * <p> * Possible values: * <ul class='spaced-list'> - * <li><js>"DEFAULT"</js> - Default format. The default is an RDF Sequence container. - * <li><js>"SEQ"</js> - RDF Sequence container. - * <li><js>"BAG"</js> - RDF Bag container. - * <li><js>"LIST"</js> - RDF List container. - * <li><js>"MULTI_VALUED"</js> - Multi-valued properties. + * <li> + * <js>"DEFAULT"</js> - Default format. The default is an RDF Sequence container. + * <li> + * <js>"SEQ"</js> - RDF Sequence container. + * <li> + * <js>"BAG"</js> - RDF Bag container. + * <li> + * <js>"LIST"</js> - RDF List container. + * <li> + * <js>"MULTI_VALUED"</js> - Multi-valued properties. * </ul> - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>If you use <js>"BAG"</js> or <js>"MULTI_VALUED"</js>, the order of the elements in the collection will get * lost. * </ul> - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_collectionFormat</jsf>, value)</code>. @@ -404,7 +417,7 @@ public class RdfSerializerBuilder extends SerializerBuilder { * <jc>// Parse back into a bean array</jc> * b = p.parse(rdfXml, MyBean[].<jk>class</jk>); * </p> - * <p> + * * <h5 class='section'>Notes:</h5> * <ul> * <li>This is equivalent to calling <code>property(<jsf>RDF_looseCollections</jsf>, value)</code>. http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/0d913b38/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfSerializerContext.java ---------------------------------------------------------------------- diff --git a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfSerializerContext.java b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfSerializerContext.java index 1c3e794..fb47c8f 100644 --- a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfSerializerContext.java +++ b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/RdfSerializerContext.java @@ -28,16 +28,21 @@ import org.apache.juneau.xml.*; * * <h6 class='topic' id='ConfigProperties'>Configurable properties inherited by the RDF serializers</h6> * <ul class='doctree'> - * <li class='jc'><a class="doclink" href="../BeanContext.html#ConfigProperties">BeanContext</a> + * <li class='jc'> + * <a class="doclink" href="../BeanContext.html#ConfigProperties">BeanContext</a> * - Properties associated with handling beans on serializers and parsers. - * <ul> - * <li class='jc'><a class="doclink" href="../serializer/SerializerContext.html#ConfigProperties">SerializerContext</a> - * - Configurable properties common to all serializers. * <ul> - * <li class='jc'><a class="doclink" href="RdfCommonContext.html#ConfigProperties">RdfCommonContext</a> - * - Configurable properties common to the RDF serializers and parsers. + * <li class='jc'> + * <a class="doclink" href="../serializer/SerializerContext.html#ConfigProperties">SerializerContext</a> + * - Configurable properties common to all serializers. + * <ul> + * <li class='jc'> + * <a class="doclink" href="RdfCommonContext.html#ConfigProperties">RdfCommonContext</a> + * - Configurable properties common to the RDF serializers and parsers. + * </ul> + * </li> * </ul> - * </ul> + * </li> * </ul> */ public final class RdfSerializerContext extends SerializerContext implements RdfCommonContext { http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/0d913b38/juneau-core-rdf/src/main/java/org/apache/juneau/jena/annotation/Rdf.java ---------------------------------------------------------------------- diff --git a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/annotation/Rdf.java b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/annotation/Rdf.java index e916bdb..f4821a5 100644 --- a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/annotation/Rdf.java +++ b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/annotation/Rdf.java @@ -25,7 +25,7 @@ import org.apache.juneau.jena.*; * Can be applied to Java packages, types, fields, and methods. * <p> * Can be used for the following: - * <ul class='spaced-list'> + * <ul> * <li>Override the default behavior of how collections and arrays are serialized. * </ul> */ @@ -62,7 +62,8 @@ public @interface Rdf { * <p> * Has the following effects on the following serializers: * <ul class='spaced-list'> - * <li>{@link RdfSerializer} - Will be rendered as the value of the <js>"rdf:about"</js> attribute + * <li> + * {@link RdfSerializer} - Will be rendered as the value of the <js>"rdf:about"</js> attribute * for the bean. * </ul> */ http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/0d913b38/juneau-core-rdf/src/main/java/org/apache/juneau/jena/package.html ---------------------------------------------------------------------- diff --git a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/package.html b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/package.html index 522be72..34ef9e7 100644 --- a/juneau-core-rdf/src/main/java/org/apache/juneau/jena/package.html +++ b/juneau-core-rdf/src/main/java/org/apache/juneau/jena/package.html @@ -100,32 +100,36 @@ Juneau can serialize and parse instances of any of the following POJO types: </p> <ul class='spaced-list'> - <li>Java primitive objects (e.g. <code>String</code>, <code>Integer</code>, <code>Boolean</code>, + <li> + Java primitive objects (e.g. <code>String</code>, <code>Integer</code>, <code>Boolean</code>, <code>Float</code>). - <li>Java collections framework objects (e.g. <code>HashSet</code>, <code>TreeMap</code>) containing anything on + <li> + Java collections framework objects (e.g. <code>HashSet</code>, <code>TreeMap</code>) containing anything on this list. - <li>Multi-dimensional arrays of any type on this list. - <li>Java Beans with properties of any type on this list. - <li>Classes with standard transformations to and from <code>Strings</code> (e.g. classes containing + <li> + Multi-dimensional arrays of any type on this list. + <li> + Java Beans with properties of any type on this list. + <li> + Classes with standard transformations to and from <code>Strings</code> (e.g. classes containing <code>toString()</code>, <code>fromString()</code>, <code>valueOf()</code>, <code>constructor(String)</code>). </ul> <p> In addition to the types shown above, Juneau includes the ability to define 'swaps' to transform non-standard object and property types to serializable forms (e.g. to transform <code>Calendars</code> to and from <code>ISO8601</code> strings, or <code>byte[]</code> arrays to and from base-64 encoded strings). - <br> - These can be associated with serializers/parsers, or can be associated with classes or bean properties through + <br>These can be associated with serializers/parsers, or can be associated with classes or bean properties through type and method annotations. </p> <p> Refer to <a href='../../../../overview-summary.html#Core.PojoCategories' class='doclink'>POJO Categories</a> for a complete definition of supported POJOs. </p> + <h6 class='topic'>Prerequisites</h6> <p> Juneau uses the Jena library for these formats. - <br> - The predefined serializers and parsers convert POJOs to and from RDF models and then uses Jena to convert + <br>The predefined serializers and parsers convert POJOs to and from RDF models and then uses Jena to convert them to and from the various RDF languages. </p> <p> @@ -186,8 +190,7 @@ <div class='topic'> <p> The {@link org.apache.juneau.jena.RdfSerializer} class is the top-level class for all Jena-based serializers. - <br> - Language-specific serializers are defined as inner subclasses of the <code>RdfSerializer</code> class: + <br>Language-specific serializers are defined as inner subclasses of the <code>RdfSerializer</code> class: </p> <ul> <li>{@link org.apache.juneau.jena.RdfSerializer.Xml} @@ -212,8 +215,7 @@ </p> <p> For brevity, the examples will use public fields instead of getters/setters to reduce the size of the examples. - <br> - In the real world, you'll typically want to use standard bean getters and setters. + <br>In the real world, you'll typically want to use standard bean getters and setters. </p> <p> To start off simple, we'll begin with the following simplified bean and build it up. @@ -272,10 +274,8 @@ </p> <p> Notice that we've taken an arbitrary POJO and converted it to RDF. - <br> - The Juneau serializers and parsers are designed to work with arbitrary POJOs without requiring any annotations. - <br> - That being said, several annotations are provided to customize how POJOs are handled to produce usable RDF. + <br>The Juneau serializers and parsers are designed to work with arbitrary POJOs without requiring any annotations. + <br>That being said, several annotations are provided to customize how POJOs are handled to produce usable RDF. </p> <!-- ======================================================================================================== --> @@ -284,8 +284,7 @@ <div class='topic'> <p> You'll notice in the previous example that Juneau namespaces are used to represent bean property names. - <br> - These are used by default when namespaces are not explicitly specified. + <br>These are used by default when namespaces are not explicitly specified. </p> <p> The <code>juneau</code> namespace is used for generic names for objects that don't have namespaces @@ -297,11 +296,9 @@ </p> <p> The easiest way to specify namespaces is through annotations. - <br> - In this example, we're going to associate the prefix <code>'per'</code> to our bean class and all properties + <br>In this example, we're going to associate the prefix <code>'per'</code> to our bean class and all properties of this class. - <br> - We do this by adding the following annotation to our class: + <br>We do this by adding the following annotation to our class: </p> <p class='bcode'> <ja>@Rdf</ja>(prefix=<js>"per"</js>) @@ -347,10 +344,8 @@ <p> Namespace auto-detection ({@link org.apache.juneau.xml.XmlSerializerContext#XML_autoDetectNamespaces}) is enabled on serializers by default. - <br> - This causes the serializer to make a first-pass over the data structure to look for namespaces. - <br> - In high-performance environments, you may want to consider disabling auto-detection and providing an + <br>This causes the serializer to make a first-pass over the data structure to look for namespaces. + <br>In high-performance environments, you may want to consider disabling auto-detection and providing an explicit list of namespaces to the serializer to avoid this scanning step. </p> <p class='bcode'> @@ -375,16 +370,13 @@ <p> Bean properties of type <code>java.net.URI</code> or <code>java.net.URL</code> have special meaning to the RDF serializer. - <br> - They are interpreted as resource identifiers. + <br>They are interpreted as resource identifiers. </p> <p> In the following code, we're adding 2 new properties. - <br> - The first property is annotated with <ja>@BeanProperty</ja> to identify that this property is the resource + <br>The first property is annotated with <ja>@BeanProperty</ja> to identify that this property is the resource identifier for this bean. - <br> - The second un-annotated property is interpreted as a reference to another resource. + <br>The second un-annotated property is interpreted as a reference to another resource. </p> <p class='bcode'> <jk>public class</jk> Person { @@ -485,25 +477,26 @@ <p> The {@link org.apache.juneau.annotation.Bean} and {@link org.apache.juneau.annotation.BeanProperty} annotations are used to customize the behavior of beans across the entire framework. - <br> - In addition to using them to identify the resource URI for the bean shown above, they have various other + <br>In addition to using them to identify the resource URI for the bean shown above, they have various other uses: </p> <ul class='spaced-list'> - <li>Hiding bean properties. - <li>Specifying the ordering of bean properties. - <li>Overriding the names of bean properties. - <li>Associating transforms at both the class and property level (to convert non-serializable POJOs to + <li> + Hiding bean properties. + <li> + Specifying the ordering of bean properties. + <li> + Overriding the names of bean properties. + <li> + Associating transforms at both the class and property level (to convert non-serializable POJOs to serializable forms). </ul> <p> For example, we now add a <code>birthDate</code> property, and associate a swap with it to transform it to an ISO8601 date-time string in GMT time. - <br> - By default, <code>Calendars</code> are treated as beans by the framework, which is usually not how you want + <br>By default, <code>Calendars</code> are treated as beans by the framework, which is usually not how you want them serialized. - <br> - Using swaps, we can convert them to standardized string forms. + <br>Using swaps, we can convert them to standardized string forms. </p> <p class='bcode'> <jk>public class</jk> Person { @@ -556,8 +549,7 @@ <div class='topic'> <p> Collections and arrays are converted to RDF sequences. - <br> - In our example, let's add a list-of-beans property to our sample class: + <br>In our example, let's add a list-of-beans property to our sample class: </p> <p class='bcode'> <jk>public class</jk> Person { @@ -652,27 +644,22 @@ <div class='topic'> <p> For all RDF languages, the POJO objects get broken down into simple triplets. - <br> - Unfortunately, for tree-structured data like the POJOs shown above, this causes the root node of the tree + <br>Unfortunately, for tree-structured data like the POJOs shown above, this causes the root node of the tree to become lost. - <br> - There is no easy way to identify that <code>person/1</code> is the root node in our tree once in triplet + <br>There is no easy way to identify that <code>person/1</code> is the root node in our tree once in triplet form, and in some cases it's impossible. </p> <p> By default, the {@link org.apache.juneau.jena.RdfParser} class handles this by scanning all the nodes and identifying the nodes without incoming references. - <br> - However, this is inefficient, especially for large models. - <br> - And in cases where the root node is referenced by another node in the model by URL, it's not possible to + <br>However, this is inefficient, especially for large models. + <br>And in cases where the root node is referenced by another node in the model by URL, it's not possible to locate the root at all. </p> <p> To resolve this issue, the property {@link org.apache.juneau.jena.RdfSerializerContext#RDF_addRootProperty} was introduced. - <br> - When enabled, this adds a special <code>root</code> attribute to the root node to make it easy to locate + <br>When enabled, this adds a special <code>root</code> attribute to the root node to make it easy to locate by the parser. </p> <p> @@ -784,24 +771,20 @@ <div class='topic'> <p> The RDF serializer is designed to be used against tree structures. - <br> - It expects that there not be loops in the POJO model (e.g. children with references to parents, etc...). - <br> - If you try to serialize models with loops, you will usually cause a <code>StackOverflowError</code> to + <br>It expects that there not be loops in the POJO model (e.g. children with references to parents, etc...). + <br>If you try to serialize models with loops, you will usually cause a <code>StackOverflowError</code> to be thrown (if {@link org.apache.juneau.serializer.SerializerContext#SERIALIZER_maxDepth} is not reached first). </p> <p> If you still want to use the XML serializer on such models, Juneau provides the {@link org.apache.juneau.serializer.SerializerContext#SERIALIZER_detectRecursions} setting. - <br> - It tells the serializer to look for instances of an object in the current branch of the tree and skip + <br>It tells the serializer to look for instances of an object in the current branch of the tree and skip serialization when a duplicate is encountered. </p> <p> Recursion detection introduces a performance penalty of around 20%. - <br> - For this reason the setting is disabled by default. + <br>For this reason the setting is disabled by default. </p> </div> @@ -814,8 +797,10 @@ See the following classes for all configurable properties that can be used on this serializer: </p> <ul class='spaced-list'> - <li>{@link org.apache.juneau.BeanContext} - Bean context properties. - <li>{@link org.apache.juneau.jena.RdfSerializerContext} - Serializer context properties. + <li> + {@link org.apache.juneau.BeanContext} - Bean context properties. + <li> + {@link org.apache.juneau.jena.RdfSerializerContext} - Serializer context properties. </ul> </div> @@ -825,10 +810,11 @@ <h3 class='topic' onclick='toggle(this)'>2.9 - Other notes</h3> <div class='topic'> <ul class='spaced-list'> - <li>Like all other Juneau serializers, the RDF serializer is thread safe and maintains an internal cache of - bean classes encountered. - For performance reasons, it's recommended that serializers be reused whenever possible instead of always - creating new instances. + <li> + Like all other Juneau serializers, the RDF serializer is thread safe and maintains an internal cache of + bean classes encountered. + For performance reasons, it's recommended that serializers be reused whenever possible instead of always + creating new instances. </ul> </div> </div> @@ -840,8 +826,7 @@ <div class='topic'> <p> The {@link org.apache.juneau.jena.RdfParser} class is the top-level class for all Jena-based parsers. - <br> - Language-specific parsers are defined as inner subclasses of the <code>RdfParser</code> class: + <br>Language-specific parsers are defined as inner subclasses of the <code>RdfParser</code> class: </p> <ul> <li>{@link org.apache.juneau.jena.RdfParser.Xml} @@ -929,16 +914,14 @@ <div class='topic'> <p> The RDF parser is not limited to parsing back into the original bean classes. - <br> - If the bean classes are not available on the parsing side, the parser can also be used to parse into a + <br>If the bean classes are not available on the parsing side, the parser can also be used to parse into a generic model consisting of <code>Maps</code>, <code>Collections</code>, and primitive objects. </p> <p> You can parse into any <code>Map</code> type (e.g. <code>HashMap</code>, <code>TreeMap</code>), but using {@link org.apache.juneau.ObjectMap} is recommended since it has many convenience methods for converting values to various types. - <br> - The same is true when parsing collections. You can use any Collection (e.g. <code>HashSet</code>, + <br>The same is true when parsing collections. You can use any Collection (e.g. <code>HashSet</code>, <code>LinkedList</code>) or array (e.g. <code>Object[]</code>, <code>String[]</code>, <code>String[][]</code>), but using {@link org.apache.juneau.ObjectList} is recommended. </p> @@ -975,32 +958,27 @@ <p> However, there are caveats when parsing into generic models due to the nature of RDF. - <br> - Watch out for the following: + <br>Watch out for the following: </p> <ul class='spaced-list'> - <li>The ordering of entries are going to be inconsistent. - <br><br> - <li>Bean URIs are always going to be denoted with the key <js>"uri"</js>. - <br> - Therefore, you cannot have a bean with a URI property and a separate property named <js>"uri"</js>. - <br> - The latter will overwrite the former. - <br> - This isn't a problem when parsing into beans instead of generic POJO models. - <li>All values are strings. - <br> - This normally isn't a problem when using <code>ObjectMap</code> and <code>ObjectList</code> since + <li> + The ordering of entries are going to be inconsistent. + <li> + Bean URIs are always going to be denoted with the key <js>"uri"</js>. + <br>Therefore, you cannot have a bean with a URI property and a separate property named <js>"uri"</js>. + <br>The latter will overwrite the former. + <br>This isn't a problem when parsing into beans instead of generic POJO models. + <li> + All values are strings. + <br>This normally isn't a problem when using <code>ObjectMap</code> and <code>ObjectList</code> since various methods are provided for converting to the correct type anyway. - <li>The results may not be what is expected if there are lots of URL reference loops in the RDF model. - <br> - As nodes are processed from the root node down through the child nodes, the parser keeps + <li> + The results may not be what is expected if there are lots of URL reference loops in the RDF model. + <br>As nodes are processed from the root node down through the child nodes, the parser keeps track of previously processed parent URIs and handles them accordingly. - <br> - If it finds that the URI has previously been processed, it handles it as a normal URI string and doesn't + <br>If it finds that the URI has previously been processed, it handles it as a normal URI string and doesn't process further. - <br> - However, depending on how complex the reference loops are, the parsed data may end up having the + <br>However, depending on how complex the reference loops are, the parsed data may end up having the same data in it, but structured differently from the original POJO. </ul> <p> @@ -1036,8 +1014,7 @@ </p> <p> As a general rule, parsing into beans is often more efficient than parsing into generic models. - <br> - And working with beans is often less error prone than working with generic models. + <br>And working with beans is often less error prone than working with generic models. </p> </div> @@ -1050,8 +1027,10 @@ See the following classes for all configurable properties that can be used on this parser: </p> <ul class='spaced-list'> - <li>{@link org.apache.juneau.BeanContext} - Bean context properties. - <li>{@link org.apache.juneau.jena.RdfParserContext} - Parser context properties. + <li> + {@link org.apache.juneau.BeanContext} - Bean context properties. + <li> + {@link org.apache.juneau.jena.RdfParserContext} - Parser context properties. </ul> </div> @@ -1060,7 +1039,8 @@ <h3 class='topic' onclick='toggle(this)'>3.3 - Other notes</h3> <div class='topic'> <ul class='spaced-list'> - <li>Like all other Juneau parsers, the RDF parser is thread safe and maintains an internal cache of bean + <li> + Like all other Juneau parsers, the RDF parser is thread safe and maintains an internal cache of bean classes encountered. For performance reasons, it's recommended that parser be reused whenever possible instead of always creating new instances. http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/0d913b38/juneau-core-test/src/test/java/org/apache/juneau/transforms/DateSwapTest.java ---------------------------------------------------------------------- diff --git a/juneau-core-test/src/test/java/org/apache/juneau/transforms/DateSwapTest.java b/juneau-core-test/src/test/java/org/apache/juneau/transforms/DateSwapTest.java index 40225ec..482047a 100755 --- a/juneau-core-test/src/test/java/org/apache/juneau/transforms/DateSwapTest.java +++ b/juneau-core-test/src/test/java/org/apache/juneau/transforms/DateSwapTest.java @@ -48,10 +48,10 @@ public class DateSwapTest { final DateSwap.ISO8601DT dateSwap = new DateSwap.ISO8601DT(); // this works - final String sValue = data.getString("birthday"); //$NON-NLS-1$ + final String sValue = data.getString("birthday"); dateSwap.unswap(null, sValue, data.getBeanSession().getClassMeta(Date.class)); // this does not work - data.get(dateSwap, "birthday"); //$NON-NLS-1$ + data.get(dateSwap, "birthday"); } public static class A {
