Entity Provider for java.nio.file.Path

jaxrs-spec/src/main/asciidoc/chapters/appendix/_change-log.adoc

@@ -1,6 +1,6 @@
 ////
 *******************************************************************
-* Copyright (c) 2019, 2024 Eclipse Foundation
+* Copyright (c) 2019 Eclipse Foundation
 *
 * This specification document is made available under the terms
 * of the Eclipse Foundation Specification License v1.0, which is
@@ -12,6 +12,8 @@
 [[change-log]]
 == Change Log
 
+include::_changes-since-4.0-release.adoc[]
+
 include::_changes-since-3.1-release.adoc[]
 
 include::_changes-since-3.0-release.adoc[]

jaxrs-spec/src/main/asciidoc/chapters/appendix/_changes-since-4.0-release.adoc

@@ -0,0 +1,14 @@
+////
+*******************************************************************
+* Copyright (c) 2024 Eclipse Foundation
+*
+* This specification document is made available under the terms
+* of the Eclipse Foundation Specification License v1.0, which is
+* available at https://www.eclipse.org/legal/efsl.php.
+*******************************************************************
+////
+
+[[changes-since-4.0-release]]
+=== Changes Since 4.0 Release
+
+* <<standard_entity_providers>>: Added entity provider for `java.nio.file.Path`

jaxrs-spec/src/main/asciidoc/chapters/providers/_entity_providers.adoc

@@ -1,6 +1,6 @@
 ////
 *******************************************************************
-* Copyright (c) 2019, 2021 Eclipse Foundation
+* Copyright (c) 2019 Eclipse Foundation
 *
 * This specification document is made available under the terms
 * of the Eclipse Foundation Specification License v1.0, which is
@@ -138,6 +138,8 @@ type combinations:
   All media types (`\*/*`).
 `java.io.File`::
   All media types (`\*/*`).
+`java.nio.file.Path`::
+  All media types (`\*/*`).
 `jakarta.activation.DataSource`::
   All media types (`\*/*`).
 `javax.xml.transform.Source`::

jaxrs-tck/src/main/java/ee/jakarta/tck/ws/rs/jaxrs21/ee/sse/sseeventsink/MBWCheckResource.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2017, 2020 Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2017 Oracle and/or its affiliates. All rights reserved.
  *
  * This program and the accompanying materials are made available under the
  * terms of the Eclipse Public License v. 2.0, which is available at
@@ -133,6 +133,28 @@ public void sendFile(@Context SseEventSink sink, @Context Sse sse) {
     }
   }
 
+  @GET
+  @Path("path")
+  @Produces(MediaType.SERVER_SENT_EVENTS)
+  public void sendPath(@Context SseEventSink sink, @Context Sse sse) {
+    java.nio.file.Path p;
+    try (SseEventSink s = sink) {
+      try {
+        p = Files.createTempFile("tck", "temppath");
+        Files.write(p, MESSAGE.getBytes(), StandardOpenOption.CREATE,
+            StandardOpenOption.APPEND);
+        p.toFile().deleteOnExit();
+        s.send(sse.newEventBuilder().data(p).mediaType(MediaType.WILDCARD_TYPE)
+            .build());
+      } catch (IOException e) {
+        s.send(sse.newEvent(e.getMessage()));
+        throw new RuntimeException(e); // log to server log
+      }
+    } catch (IOException e) {
+      LOG.log(Level.WARNING, "Failed to close SseEventSink", e);
+    }
+  }
+
   @GET
   @Path("inputstream")
   @Produces(MediaType.SERVER_SENT_EVENTS)

jaxrs-tck/src/main/java/ee/jakarta/tck/ws/rs/spec/filter/interceptor/JAXRSClientIT.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2013, 2021 Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2013 Oracle and/or its affiliates. All rights reserved.
  *
  * This program and the accompanying materials are made available under the
  * terms of the Eclipse Public License v. 2.0, which is available at
@@ -22,6 +22,7 @@
 import java.io.IOException;
 import java.io.InputStreamReader;
 import java.io.InputStream;
+import java.nio.file.Files;
 
 import javax.xml.namespace.QName;
 
@@ -548,7 +549,7 @@ public void fileReaderContainerInterceptorTest() throws Fault {
   @Test
   @Tag("xml_binding")
   public void fileReaderNoInterceptorTest() throws Fault {
-    setProperty(Property.REQUEST, buildRequest(Request.POST, "postfile"));
+    setProperty(Property.REQUEST, buildRequest(Request.POST, "postpath"));
     setRequestContentEntity(content);
     setProperty(Property.SEARCH_STRING, content);
     invoke();
@@ -620,6 +621,110 @@ public void fileWriterClientInterceptorTest() throws Fault {
     logMsg("JAXRS called registered writer interceptor for file provider");
   }
 
+  // ------------------------- Path -----------------------------------
+
+  /*
+   * @testName: pathReaderContainerInterceptorTest
+   * 
+   * @assertion_ids: JAXRS:SPEC:84;
+   * 
+   * @test_Strategy: JAX-RS implementations are REQUIRED to call registered
+   * interceptors when mapping representations to Java types and vice versa.
+   */
+  @Test
+  @Tag("xml_binding")
+  public void pathReaderContainerInterceptorTest() throws Fault {
+    addInterceptors(EntityReaderInterceptor.class);
+    setProperty(Property.REQUEST, buildRequest(Request.POST, "postpath"));
+    setRequestContentEntity(content);
+    setProperty(Property.SEARCH_STRING,
+        EntityReaderInterceptor.class.getName());
+    setProperty(Property.UNEXPECTED_RESPONSE_MATCH, Resource.DIRECTION);
+    invoke();
+    logMsg("JAXRS called registered reader interceptor for path provider");
+  }
+
+  /*
+   * @testName: pathReaderNoInterceptorTest
+   * 
+   * @assertion_ids: JAXRS:SPEC:84;
+   * 
+   * @test_Strategy: JAX-RS implementations are REQUIRED to call registered
+   * interceptors when mapping representations to Java types and vice versa.
+   */
+  @Test
+  @Tag("xml_binding")
+  public void pathReaderNoInterceptorTest() throws Fault {
+    setProperty(Property.REQUEST, buildRequest(Request.POST, "postpath"));
+    setRequestContentEntity(content);
+    setProperty(Property.SEARCH_STRING, content);
+    invoke();
+  }
+
+  /*
+   * @testName: pathWriterContainerInterceptorTest
+   * 
+   * @assertion_ids: JAXRS:SPEC:84;
+   * 
+   * @test_Strategy: JAX-RS implementations are REQUIRED to call registered
+   * interceptors when mapping representations to Java types and vice versa.
+   */
+  @Test
+  @Tag("xml_binding")
+  public void pathWriterContainerInterceptorTest() throws Fault {
+    addInterceptors(EntityWriterInterceptor.class);
+    setProperty(Property.REQUEST, buildRequest(Request.GET, "getpath"));
+    setProperty(Property.SEARCH_STRING,
+        EntityWriterInterceptor.class.getName());
+    setProperty(Property.SEARCH_STRING, Resource.DIRECTION);
+    invoke();
+    logMsg("JAXRS called registered writer interceptor for path provider");
+  }
+
+  /*
+   * @testName: pathWriterNoInterceptorTest
+   * 
+   * @assertion_ids: JAXRS:SPEC:84;
+   * 
+   * @test_Strategy: JAX-RS implementations are REQUIRED to call registered
+   * interceptors when mapping representations to Java types and vice versa.
+   */
+  @Test
+  @Tag("xml_binding")
+  public void pathWriterNoInterceptorTest() throws Fault {
+    setProperty(Property.REQUEST, buildRequest(Request.GET, "getpath"));
+    setProperty(Property.SEARCH_STRING, Resource.getName());
+    invoke();
+  }
+
+  /*
+   * @testName: pathWriterClientInterceptorTest
+   * 
+   * @assertion_ids: JAXRS:SPEC:84;
+   * 
+   * @test_Strategy: JAX-RS implementations are REQUIRED to call registered
+   * interceptors when mapping representations to Java types and vice versa.
+   */
+  @Test
+  @Tag("xml_binding")
+  public void pathWriterClientInterceptorTest() throws Fault {
+    try {
+      java.nio.file.Path path = Files.createTempFile("temp", "tmp");
+      Files.writeString(path, content);
+      setRequestContentEntity(path);
+    } catch (IOException e) {
+      throw new Fault(e);
+    }
+    addProvider(EntityWriterInterceptor.class);
+    addInterceptors(EntityWriterInterceptor.class);
+    setProperty(Property.REQUEST, buildRequest(Request.POST, "poststring"));
+    setProperty(Property.SEARCH_STRING,
+        EntityWriterInterceptor.class.getName());
+    setProperty(Property.UNEXPECTED_RESPONSE_MATCH, Resource.DIRECTION);
+    invoke();
+    logMsg("JAXRS called registered writer interceptor for path provider");
+  }
+
   // ------------------------- DataSource -----------------------------------
 
   /*

jaxrs-tck/src/main/java/ee/jakarta/tck/ws/rs/spec/filter/interceptor/Resource.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2013, 2021 Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2013 Oracle and/or its affiliates. All rights reserved.
  *
  * This program and the accompanying materials are made available under the
  * terms of the Eclipse Public License v. 2.0, which is available at
@@ -23,6 +23,7 @@
 import java.io.InputStream;
 import java.io.InputStreamReader;
 import java.io.Reader;
+import java.nio.file.Files;
 import java.util.List;
 
 import javax.xml.namespace.QName;
@@ -133,6 +134,21 @@ public Response postFile(File file) throws IOException {
     return buildResponse(text);
   }
 
+  @GET
+  @Path("getpath")
+  public Response getPath() throws IOException {
+    java.nio.file.Path path = Files.createTempFile("filter", "tmp");
+    Files.writeString(path, getName());
+    return buildResponse(path);
+  }
+
+  @POST
+  @Path("postpath")
+  public Response postPath(java.nio.file.Path path) throws IOException {
+    String text = Files.readString(path);
+    return buildResponse(text);
+  }
+
   @GET
   @Path("getdatasource")
   public Response getDataSource() {

jaxrs-tck/src/main/java/ee/jakarta/tck/ws/rs/spec/provider/overridestandard/JAXRSClientIT.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2012, 2021 Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2012 Oracle and/or its affiliates. All rights reserved.
  *
  * This program and the accompanying materials are made available under the
  * terms of the Eclipse Public License v. 2.0, which is available at
@@ -82,7 +82,7 @@ void setPropertyAndInvokeEncoded(String resourceMethod) throws Fault {
   }
 
   String[] methodsAll = { "bytearray", "string", "inputstream", "reader",
-      "file", "datasource", "source", "jaxb", "streamingoutput" };
+      "file", "path", "datasource", "source", "jaxb", "streamingoutput" };
 
 
   @Deployment(testable = false)
@@ -94,7 +94,7 @@ public static WebArchive createDeployment() throws IOException{
       AbstractProvider.class, TckBooleanProvider.class, 
       TckByteArrayProvider.class, TckCharacterProvider.class, 
       TckDataSourceProvider.class, TckDataSourceProvider.class, 
-      TckFileProvider.class, TckInputStreamProvider.class, 
+      TckFileProvider.class, TckPathProvider.class, TckInputStreamProvider.class, 
       TckJaxbProvider.class, TckMapProvider.class, 
       TckNumberProvider.class, TckReaderProvider.class, 
       TckSourceProvider.class, TckStreamingOutputProvider.class, 
@@ -195,6 +195,22 @@ public void readWriteFileProviderTest() throws Fault {
     setPropertyAndInvoke("file", MediaType.APPLICATION_XML_TYPE);
   }
 
+  /*
+   * @testName: readWritePathProviderTest
+   * 
+   * @assertion_ids: JAXRS:SPEC:35
+   * 
+   * @test_Strategy: An implementation MUST support application-provided entity
+   * providers and MUST use those in preference to its own pre-packaged
+   * providers when either could handle the same request.
+   * 
+   */
+  @Test
+  @Tag("xml_binding")
+  public void readWritePathProviderTest() throws Fault {
+    setPropertyAndInvoke("path", MediaType.APPLICATION_XML_TYPE);
+  }
+
   /*
    * @testName: readWriteDataSourceProviderTest
    * 

jaxrs-tck/src/main/java/ee/jakarta/tck/ws/rs/spec/provider/overridestandard/Resource.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2012, 2021 Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2012 Oracle and/or its affiliates. All rights reserved.
  *
  * This program and the accompanying materials are made available under the
  * terms of the Eclipse Public License v. 2.0, which is available at
@@ -63,6 +63,12 @@ public File file(File file) {
     return file;
   }
 
+  @Path("path")
+  @POST
+  public java.nio.file.Path path(java.nio.file.Path path) {
+    return path;
+  }
+
   @Path("datasource")
   @POST
   public DataSource datasource(DataSource datasource) {

jaxrs-tck/src/main/java/ee/jakarta/tck/ws/rs/spec/provider/overridestandard/TSAppConfig.java

@@ -29,6 +29,7 @@ public java.util.Set<java.lang.Class<?>> getClasses() {
     resources.add(TckByteArrayProvider.class);
     resources.add(TckDataSourceProvider.class);
     resources.add(TckFileProvider.class);
+    resources.add(TckPathProvider.class);
     resources.add(TckInputStreamProvider.class);
     resources.add(TckJaxbProvider.class);
     resources.add(TckMapProvider.class);