Added a custom query parameter, deferred, to the credential endpoint

and the batch credential endpoint.

This query parameter is not a standardized one. It was added only for
testing the deferred issuance flow.

Author: TakahikoKawasaki

src/main/java/com/authlete/jaxrs/server/api/vci/BatchCredentialEndpoint.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2023 Authlete, Inc.
+ * Copyright (C) 2023-2024 Authlete, Inc.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -23,6 +23,7 @@
 import javax.ws.rs.HeaderParam;
 import javax.ws.rs.POST;
 import javax.ws.rs.Path;
+import javax.ws.rs.QueryParam;
 import javax.ws.rs.WebApplicationException;
 import javax.ws.rs.core.Context;
 import javax.ws.rs.core.HttpHeaders;
@@ -50,6 +51,7 @@ public Response post(
             @Context HttpServletRequest request,
             @HeaderParam(HttpHeaders.AUTHORIZATION) String authorization,
             @HeaderParam("DPoP") String dpop,
+            @QueryParam("deferred") String deferred,
             String requestContent)
     {
         final AuthleteApi api = AuthleteApiFactory.getDefaultApi();
@@ -74,6 +76,17 @@ public Response post(
         // Prepare credential issuance orders.
         CredentialIssuanceOrder[] orders = prepareOrders(introspection, infos, headers);
 
+        // Defer the issuance if it is explicitly requested.
+        // Note that the 'deferred' query parameter is not a standardized one.
+        boolean issuanceDeferred = Boolean.parseBoolean(deferred);
+        if (issuanceDeferred)
+        {
+            for (CredentialIssuanceOrder order : orders)
+            {
+                order.setIssuanceDeferred(issuanceDeferred);
+            }
+        }
+
         // Issue credentials and return a batch credential response.
         return issue(api, orders, accessToken, headers);
     }

src/main/java/com/authlete/jaxrs/server/api/vci/CredentialEndpoint.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2023 Authlete, Inc.
+ * Copyright (C) 2023-2024 Authlete, Inc.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -23,6 +23,7 @@
 import javax.ws.rs.HeaderParam;
 import javax.ws.rs.POST;
 import javax.ws.rs.Path;
+import javax.ws.rs.QueryParam;
 import javax.ws.rs.WebApplicationException;
 import javax.ws.rs.core.Context;
 import javax.ws.rs.core.HttpHeaders;
@@ -51,6 +52,7 @@ public Response post(
             @Context HttpServletRequest request,
             @HeaderParam(HttpHeaders.AUTHORIZATION) String authorization,
             @HeaderParam("DPoP") String dpop,
+            @QueryParam("deferred") String deferred,
             String requestContent)
     {
         final AuthleteApi api = AuthleteApiFactory.getDefaultApi();
@@ -76,6 +78,14 @@ public Response post(
         CredentialIssuanceOrder order =
                 prepareOrder(OrderContext.SINGLE, introspection, info, headers);
 
+        // Defer the issuance if it is explicitly requested.
+        // Note that the 'deferred' query parameter is not a standardized one.
+        boolean issuanceDeferred = Boolean.parseBoolean(deferred);
+        if (issuanceDeferred)
+        {
+            order.setIssuanceDeferred(issuanceDeferred);
+        }
+
         // Issue a credential and return a credential response.
         return issue(api, order, accessToken, headers);
     }