From 7e44ce0e437a40670372d9accc6bad94848d35f5 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sat, 15 Aug 2026 00:00:58 -0500 Subject: [PATCH 1/2] Document Apache HTTP entity implementation Refs #258 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../EntityDeserializer.xml | 22 +++++++++---------- .../EntitySerializer.xml | 22 +++++++++---------- ...xContentLengthStrategy+InterfaceConsts.xml | 6 ++--- .../LaxContentLengthStrategy.xml | 10 ++++----- ...tContentLengthStrategy+InterfaceConsts.xml | 6 ++--- .../StrictContentLengthStrategy.xml | 10 ++++----- docs/xml/ns-Org.Apache.Http.Impl.Entity.xml | 2 +- 7 files changed, 39 insertions(+), 39 deletions(-) diff --git a/docs/xml/Org.Apache.Http.Impl.Entity/EntityDeserializer.xml b/docs/xml/Org.Apache.Http.Impl.Entity/EntityDeserializer.xml index 08937f7e9..6c0f5e201 100644 --- a/docs/xml/Org.Apache.Http.Impl.Entity/EntityDeserializer.xml +++ b/docs/xml/Org.Apache.Http.Impl.Entity/EntityDeserializer.xml @@ -26,7 +26,7 @@ - To be added. + Deserializes an HTTP message body into an HTTP entity by using a content-length strategy. @@ -57,8 +57,8 @@ - To be added. - To be added. + The strategy used to determine the message body length. + Initializes an entity deserializer that uses the specified content-length strategy. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -111,10 +111,10 @@ - To be added. - To be added. - To be added. - To be added. + The buffer from which to read the entity data. + The HTTP message that contains the entity headers. + Deserializes the entity in an HTTP message from an input buffer. + The entity deserialized from the message and input buffer. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -144,10 +144,10 @@ - To be added. - To be added. - To be added. - To be added. + The buffer from which to read the entity data. + The HTTP message that contains the entity headers. + Creates a basic HTTP entity from an HTTP message and its input buffer. + The basic HTTP entity deserialized from the message and input buffer. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Impl.Entity/EntitySerializer.xml b/docs/xml/Org.Apache.Http.Impl.Entity/EntitySerializer.xml index 615c61ad5..fc0fe446f 100644 --- a/docs/xml/Org.Apache.Http.Impl.Entity/EntitySerializer.xml +++ b/docs/xml/Org.Apache.Http.Impl.Entity/EntitySerializer.xml @@ -26,7 +26,7 @@ - To be added. + Serializes an HTTP entity to an HTTP message by using a content-length strategy. @@ -57,8 +57,8 @@ - To be added. - To be added. + The strategy used to determine the message body length. + Initializes an entity serializer that uses the specified content-length strategy. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -111,10 +111,10 @@ - To be added. - To be added. - To be added. - To be added. + The buffer to which entity data is written. + The HTTP message that contains the entity headers. + Creates the output stream used to serialize an HTTP entity. + The output stream to which the entity data is written. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -176,10 +176,10 @@ - To be added. - To be added. - To be added. - To be added. + The buffer to which entity data is written. + The HTTP message that contains the entity headers. + The HTTP entity to serialize. + Serializes an HTTP entity to an output buffer. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy+InterfaceConsts.xml b/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy+InterfaceConsts.xml index 6f450a647..218064c4b 100644 --- a/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy+InterfaceConsts.xml +++ b/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy+InterfaceConsts.xml @@ -12,7 +12,7 @@ - To be added. + Defines content-length sentinel values used by this strategy. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -39,7 +39,7 @@ -2 - To be added. + Indicates that the message uses chunked transfer coding. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -66,7 +66,7 @@ -1 - To be added. + Indicates that the message uses identity transfer coding. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy.xml b/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy.xml index 5acced710..b2f4f8fb1 100644 --- a/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy.xml +++ b/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy.xml @@ -35,7 +35,7 @@ - To be added. + Determines an HTTP message body length while tolerating malformed content-length headers and unsupported transfer codings. @@ -63,7 +63,7 @@ - To be added. + Initializes a new instance of the class. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -118,9 +118,9 @@ - To be added. - To be added. - To be added. + The HTTP message whose body length is determined. + Determines the body length of an HTTP message using lax transfer rules. + The body length, or a sentinel value that indicates chunked or identity transfer coding. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy+InterfaceConsts.xml b/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy+InterfaceConsts.xml index 6a8e79c0d..7eda51910 100644 --- a/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy+InterfaceConsts.xml +++ b/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy+InterfaceConsts.xml @@ -12,7 +12,7 @@ - To be added. + Defines content-length sentinel values used by this strategy. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -39,7 +39,7 @@ -2 - To be added. + Indicates that the message uses chunked transfer coding. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -66,7 +66,7 @@ -1 - To be added. + Indicates that the message uses identity transfer coding. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy.xml b/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy.xml index b9439a390..1d3b65ff3 100644 --- a/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy.xml +++ b/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy.xml @@ -35,7 +35,7 @@ - To be added. + Determines an HTTP message body length by strictly applying HTTP transfer rules. @@ -63,7 +63,7 @@ - To be added. + Initializes a new instance of the class. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -118,9 +118,9 @@ - To be added. - To be added. - To be added. + The HTTP message whose body length is determined. + Determines the body length of an HTTP message using strict transfer rules. + The body length, or a sentinel value that indicates chunked or identity transfer coding. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/ns-Org.Apache.Http.Impl.Entity.xml b/docs/xml/ns-Org.Apache.Http.Impl.Entity.xml index 483ef33df..5dd5155a0 100644 --- a/docs/xml/ns-Org.Apache.Http.Impl.Entity.xml +++ b/docs/xml/ns-Org.Apache.Http.Impl.Entity.xml @@ -1,6 +1,6 @@ - To be added. + Provides implementations for serializing and deserializing HTTP message entities. From 465b16bc0d4da56ec58eb5973895e71029994e63 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sat, 15 Aug 2026 00:11:47 -0500 Subject: [PATCH 2/2] Use HTTP transfer encoding terminology Refs #258 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../LaxContentLengthStrategy+InterfaceConsts.xml | 4 ++-- .../Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy.xml | 4 ++-- .../StrictContentLengthStrategy+InterfaceConsts.xml | 4 ++-- .../StrictContentLengthStrategy.xml | 2 +- 4 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy+InterfaceConsts.xml b/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy+InterfaceConsts.xml index 218064c4b..15dbea575 100644 --- a/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy+InterfaceConsts.xml +++ b/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy+InterfaceConsts.xml @@ -39,7 +39,7 @@ -2 - Indicates that the message uses chunked transfer coding. + Indicates that the message uses chunked transfer encoding. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -66,7 +66,7 @@ -1 - Indicates that the message uses identity transfer coding. + Indicates that the message uses identity transfer encoding. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy.xml b/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy.xml index b2f4f8fb1..716eaa091 100644 --- a/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy.xml +++ b/docs/xml/Org.Apache.Http.Impl.Entity/LaxContentLengthStrategy.xml @@ -35,7 +35,7 @@ - Determines an HTTP message body length while tolerating malformed content-length headers and unsupported transfer codings. + Determines an HTTP message body length while tolerating malformed content-length headers and unsupported transfer encodings. @@ -120,7 +120,7 @@ The HTTP message whose body length is determined. Determines the body length of an HTTP message using lax transfer rules. - The body length, or a sentinel value that indicates chunked or identity transfer coding. + The body length, or a sentinel value that indicates chunked or identity transfer encoding. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy+InterfaceConsts.xml b/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy+InterfaceConsts.xml index 7eda51910..b607a461e 100644 --- a/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy+InterfaceConsts.xml +++ b/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy+InterfaceConsts.xml @@ -39,7 +39,7 @@ -2 - Indicates that the message uses chunked transfer coding. + Indicates that the message uses chunked transfer encoding. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -66,7 +66,7 @@ -1 - Indicates that the message uses identity transfer coding. + Indicates that the message uses identity transfer encoding. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy.xml b/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy.xml index 1d3b65ff3..e8acdd055 100644 --- a/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy.xml +++ b/docs/xml/Org.Apache.Http.Impl.Entity/StrictContentLengthStrategy.xml @@ -120,7 +120,7 @@ The HTTP message whose body length is determined. Determines the body length of an HTTP message using strict transfer rules. - The body length, or a sentinel value that indicates chunked or identity transfer coding. + The body length, or a sentinel value that indicates chunked or identity transfer encoding. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.