X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=blobdiff_plain;f=restconf%2Frestconf-nb%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Frestconf%2Fserver%2Fapi%2FRestconfServer.java;fp=restconf%2Frestconf-nb%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Frestconf%2Fserver%2Fapi%2FRestconfServer.java;h=c4d637d95ae760a037ddc70b3268a3a9b13abfbe;hb=2bb148284126ce63c972814689bd3da46c5cd348;hp=0586fd20e5bac14f0c27446d7de6ed520903c01a;hpb=dfdc06ff80f68824c7fe0157d1eca3ea607c4b4a;p=netconf.git diff --git a/restconf/restconf-nb/src/main/java/org/opendaylight/restconf/server/api/RestconfServer.java b/restconf/restconf-nb/src/main/java/org/opendaylight/restconf/server/api/RestconfServer.java index 0586fd20e5..c4d637d95a 100644 --- a/restconf/restconf-nb/src/main/java/org/opendaylight/restconf/server/api/RestconfServer.java +++ b/restconf/restconf-nb/src/main/java/org/opendaylight/restconf/server/api/RestconfServer.java @@ -12,7 +12,6 @@ import org.eclipse.jdt.annotation.NonNullByDefault; import org.eclipse.jdt.annotation.Nullable; import org.opendaylight.restconf.api.ApiPath; import org.opendaylight.restconf.api.FormattableBody; -import org.opendaylight.restconf.api.QueryParameters; import org.opendaylight.restconf.common.errors.RestconfFuture; import org.opendaylight.restconf.nb.rfc8040.legacy.NormalizedNodePayload; import org.opendaylight.yangtools.yang.common.Empty; @@ -30,107 +29,110 @@ public interface RestconfServer { * @return A {@link RestconfFuture} of the operation */ @SuppressWarnings("checkstyle:abbreviationAsWordInName") - RestconfFuture dataDELETE(ApiPath identifier); + RestconfFuture dataDELETE(ServerRequest request, ApiPath identifier); /** * Return the content of the datastore. * - * @param params {@link DataGetParams} for this request + * @param request {@link ServerRequest} for this request * @return A {@link RestconfFuture} of the {@link DataGetResult} content */ - RestconfFuture dataGET(QueryParameters params); + RestconfFuture dataGET(ServerRequest request); /** * Return the content of a data resource. * + * @param request {@link ServerRequest} for this request * @param identifier resource identifier - * @param params {@link DataGetParams} for this request * @return A {@link RestconfFuture} of the {@link DataGetResult} content */ - RestconfFuture dataGET(ApiPath identifier, QueryParameters params); + RestconfFuture dataGET(ServerRequest request, ApiPath identifier); /** * Partially modify the target data resource, as defined in * RFC8040, section 4.6.1. * + * @param request {@link ServerRequest} for this request * @param body data node for put to config DS * @return A {@link RestconfFuture} of the operation */ - RestconfFuture dataPATCH(ResourceBody body); + RestconfFuture dataPATCH(ServerRequest request, ResourceBody body); /** * Partially modify the target data resource, as defined in * RFC8040, section 4.6.1. * + * @param request {@link ServerRequest} for this request * @param identifier resource identifier * @param body data node for put to config DS * @return A {@link RestconfFuture} of the operation */ - RestconfFuture dataPATCH(ApiPath identifier, ResourceBody body); + RestconfFuture dataPATCH(ServerRequest request, ApiPath identifier, ResourceBody body); /** * Ordered list of edits that are applied to the datastore by the server, as defined in * RFC8072, section 2. * - * @param params query parameters + * @param request {@link ServerRequest} for this request * @param body YANG Patch body * @return A {@link RestconfFuture} of the {@link DataYangPatchResult} content */ - RestconfFuture dataPATCH(QueryParameters params, PatchBody body); + RestconfFuture dataPATCH(ServerRequest request, PatchBody body); /** * Ordered list of edits that are applied to the datastore by the server, as defined in * RFC8072, section 2. * + * @param request {@link ServerRequest} for this request * @param identifier path to target - * @param params query parameters * @param body YANG Patch body * @return A {@link RestconfFuture} of the {@link DataYangPatchResult} content */ - RestconfFuture dataPATCH(ApiPath identifier, QueryParameters params, PatchBody body); + RestconfFuture dataPATCH(ServerRequest request, ApiPath identifier, PatchBody body); - RestconfFuture dataPOST(QueryParameters params, ChildBody body); + RestconfFuture dataPOST(ServerRequest request, ChildBody body); /** * Create or invoke a operation, as described in * RFC8040 section 4.4. * + * @param request {@link ServerRequest} for this request * @param identifier path to target - * @param params query parameters * @param body body of the post request */ - RestconfFuture dataPOST(ApiPath identifier, QueryParameters params, DataPostBody body); + RestconfFuture dataPOST(ServerRequest request, ApiPath identifier, DataPostBody body); /** * Replace the data store, as described in * RFC8040 section 4.5. * + * @param request {@link ServerRequest} for this request * @param body data node for put to config DS - * @param params query parameters * @return A {@link RestconfFuture} completing with {@link DataPutResult} */ - RestconfFuture dataPUT(QueryParameters params, ResourceBody body); + RestconfFuture dataPUT(ServerRequest request, ResourceBody body); /** * Create or replace a data store resource, as described in * RFC8040 section 4.5. * + * @param request {@link ServerRequest} for this request * @param identifier resource identifier - * @param params query parameters * @param body data node for put to config DS * @return A {@link RestconfFuture} completing with {@link DataPutResult} */ - RestconfFuture dataPUT(ApiPath identifier, QueryParameters params, ResourceBody body); + RestconfFuture dataPUT(ServerRequest request, ApiPath identifier, ResourceBody body); /** * Return the set of supported RPCs supported by - * {@link #operationsPOST(URI, ApiPath, QueryParameters, OperationInputBody)}, + * {@link #operationsPOST(ServerRequest, URI, ApiPath, OperationInputBody)}, * as expressed in the ietf-restconf.yang * {@code container operations} statement. * + * @param request {@link ServerRequest} for this request * @return A {@link RestconfFuture} completing with an {@link FormattableBody} */ - RestconfFuture operationsGET(); + RestconfFuture operationsGET(ServerRequest request); /* * Return the details about a particular operation supported by @@ -138,42 +140,44 @@ public interface RestconfServer { * ietf-restconfig.yang * {@code container operations} statement. * + * @param request {@link ServerRequest} for this request * @param operation An operation * @return A {@link RestconfFuture} completing with an {@link FormattableBody} */ - RestconfFuture operationsGET(ApiPath operation); + RestconfFuture operationsGET(ServerRequest request, ApiPath operation); /** * Invoke an RPC operation, as defined in * RFC8040 Operation Resource. * + * @param request {@link ServerRequest} for this request * @param restconfURI Base URI of the request * @param operation {@code } path, really an {@link ApiPath} to an {@code rpc} - * @param params query parameters * @param body RPC operation * @return A {@link RestconfFuture} completing with {@link InvokeResult} */ // FIXME: 'operation' should really be an ApiIdentifier with non-null module, but we also support yang-ext:mount, // and hence it is a path right now - RestconfFuture operationsPOST(URI restconfURI, ApiPath operation, QueryParameters params, + RestconfFuture operationsPOST(ServerRequest request, URI restconfURI, ApiPath operation, OperationInputBody body); /** * Return the revision of {@code ietf-yang-library} module implemented by this server, as defined in * RFC8040 {+restconf}/yang-library-version. * + * @param request {@link ServerRequest} for this request * @return A {@link RestconfFuture} completing with {@link NormalizedNodePayload} containing a single * {@code yang-library-version} leaf element. */ - // FIXME: this is a simple encoding-variadic return, similar to how OperationsContent is handled use a common - // construct for both cases -- in this case it carries a yang.common.Revision - RestconfFuture yangLibraryVersionGET(); + RestconfFuture yangLibraryVersionGET(ServerRequest request); - RestconfFuture modulesYangGET(String fileName, @Nullable String revision); + RestconfFuture modulesYangGET(ServerRequest request, String fileName, @Nullable String revision); - RestconfFuture modulesYangGET(ApiPath mountPath, String fileName, @Nullable String revision); + RestconfFuture modulesYangGET(ServerRequest request, ApiPath mountPath, String fileName, + @Nullable String revision); - RestconfFuture modulesYinGET(String fileName, @Nullable String revision); + RestconfFuture modulesYinGET(ServerRequest request, String fileName, @Nullable String revision); - RestconfFuture modulesYinGET(ApiPath mountPath, String fileName, @Nullable String revision); + RestconfFuture modulesYinGET(ServerRequest request, ApiPath mountPath, String fileName, + @Nullable String revision); }