[
https://issues.apache.org/jira/browse/MRESOLVER-600?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17881171#comment-17881171
]
ASF GitHub Bot commented on MRESOLVER-600:
------------------------------------------
doddi commented on code in PR #576:
URL: https://github.com/apache/maven-resolver/pull/576#discussion_r1756127626
##########
maven-resolver-spi/src/main/java/org/eclipse/aether/spi/connector/transport/http/RFC9457/RFC9457Reporter.java:
##########
@@ -0,0 +1,77 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.eclipse.aether.spi.connector.transport.http.RFC9457;
+
+import java.io.IOException;
+
+/**
+ * A reporter for RFC 9457 messages.
+ * RFC 9457 is a standard for reporting problems in HTTP responses as a JSON
object.
+ * There are members specified in the RFC but none of those appear to be
required,
+ * @see <a href=https://www.rfc-editor.org/rfc/rfc9457#section-3-7>rfc9457
section 3.7</a>
+ * Given the JSON fields are not mandatory, this reporter simply extracts the
body of the
+ * response without validation.
+ * A RFC 9457 message is detected by the content type
"application/problem+json".
+ *
+ * @param <T> The type of the response.
+ * @param <E> The base exception type to throw if the response is not a
RFC9457 message.
+ */
+public abstract class RFC9457Reporter<T, E extends Exception> {
+ protected abstract boolean isRFC9457Message(T response);
+
+ protected abstract int getStatusCode(T response);
+
+ protected abstract String getReasonPhrase(T response);
+
+ protected abstract String getBody(T response) throws IOException;
+
+ protected boolean hasRFC9457ContentType(String contentType) {
+ return "application/problem+json".equals(contentType);
+ }
+
+ /**
+ * Generates a {@link HttpRFC9457Exception} if the response type is a RFC
9457 message.
+ * Otherwise, it throws the base exception
+ *
+ * @param response The response to check for RFC 9457 messages.
+ * @param baseException The base exception to throw if the response is not
a RFC 9457 message.
+ */
+ public void generateException(T response, BiConsumerChecked<Integer,
String, E> baseException)
+ throws E, HttpRFC9457Exception {
+ int statusCode = getStatusCode(response);
+ String reasonPhrase = getReasonPhrase(response);
+
+ if (isRFC9457Message(response)) {
+ String body;
+ try {
+ body = getBody(response);
+ } catch (IOException ignore) {
+ // No body found but it is representing a RFC 9457 message due
to the content type.
+ throw new HttpRFC9457Exception(statusCode, reasonPhrase, new
RFC9457Payload());
+ }
+
+ if (body != null && !body.isEmpty()) {
+ RFC9457Payload rfc9457Payload = RFC9457Parser.parse(body);
+ throw new HttpRFC9457Exception(statusCode, reasonPhrase,
rfc9457Payload);
+ }
+ throw new HttpRFC9457Exception(statusCode, reasonPhrase, new
RFC9457Payload());
Review Comment:
https://github.com/apache/maven-resolver/pull/576/commits/dad87aa411c953d36f685cce013bb3fa88474d50
##########
maven-resolver-transport-apache/src/test/java/org/eclipse/aether/transport/apache/ApacheTransporterTest.java:
##########
@@ -44,7 +44,8 @@
class ApacheTransporterTest extends HttpTransporterTest {
public ApacheTransporterTest() {
- super(() -> new ApacheTransporterFactory(standardChecksumExtractor(),
new TestPathProcessor()));
+ super(() -> new ApacheTransporterFactory(
+ standardChecksumExtractor(), new TestPathProcessor(), new
ApacheRFC9457Reporter()));
Review Comment:
https://github.com/apache/maven-resolver/pull/576/commits/dad87aa411c953d36f685cce013bb3fa88474d50
##########
maven-resolver-transport-jetty/src/test/java/org/eclipse/aether/transport/jetty/JettyTransporterTest.java:
##########
@@ -59,6 +59,7 @@ protected void testRetryHandler_explicitCount_positive() {}
protected void
testPut_Authenticated_ExpectContinueRejected_ExplicitlyConfiguredHeader() {}
public JettyTransporterTest() {
- super(() -> new JettyTransporterFactory(standardChecksumExtractor(),
new TestPathProcessor()));
+ super(() -> new JettyTransporterFactory(
+ standardChecksumExtractor(), new TestPathProcessor(), new
JettyRFC9457Reporter()));
Review Comment:
https://github.com/apache/maven-resolver/pull/576/commits/dad87aa411c953d36f685cce013bb3fa88474d50
> Implement RFC 9457
> ------------------
>
> Key: MRESOLVER-600
> URL: https://issues.apache.org/jira/browse/MRESOLVER-600
> Project: Maven Resolver
> Issue Type: New Feature
> Components: Resolver
> Reporter: Mark Dodgson
> Priority: Minor
>
> HTTP1.1 [RFC
> 9112|https://www.rfc-editor.org/rfc/rfc9112.html#name-status-line] section 4
> defines the response status code to optionally include a text description
> (human readable) of the reason for the status code.
> There is an additional [RFC9457|https://www.rfc-editor.org/rfc/rfc9457] which
> makes use of the body to inform of a reason for the error response allowing
> for easier investigation.
> h2. Why is this important
> [RFC9113|https://www.rfc-editor.org/rfc/rfc9113] is the HTTP2 protocol
> standard and the response status only considers the [status
> code|https://www.rfc-editor.org/rfc/rfc9113#name-response-pseudo-header-fiel]
> and not the reason phrase, as such important information can be lost in
> helping the client determine a route cause of a failure.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
