EncDecExtensions.java
/**
* Copyright (C) 2024 Christopher J. Stehno
*
* Licensed 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 io.github.cjstehno.ersatz.encdec;
import groovy.lang.Closure;
import groovy.lang.DelegatesTo;
import space.jasan.support.groovy.closure.ConsumerWithDelegate;
import static groovy.lang.Closure.DELEGATE_FIRST;
/**
* Groovy extensions for the encoder and decoder functionality.
*/
public class EncDecExtensions {
/**
* Used to configure a request cookie with a configuration closure.
*
* @param type the type of object being extended
* @param closure the configuration closure
* @return the configured cookie
*/
public static Cookie cookie(
final Cookie type,
@DelegatesTo(value = Cookie.class, strategy = DELEGATE_FIRST) final Closure closure
) {
return Cookie.cookie(ConsumerWithDelegate.create(closure));
}
/**
* Creates a response encoder container configured by the provided closure.
*
* @param type the type of object being extended
* @param closure the configuration closure
* @return the configured response encoders
*/
public static ResponseEncoders encoders(
final ResponseEncoders type,
@DelegatesTo(value = ResponseEncoders.class, strategy = DELEGATE_FIRST) final Closure closure
) {
return ResponseEncoders.encoders(ConsumerWithDelegate.create(closure));
}
/**
* Creates a request decoder container configured by the provided closure.
*
* @param type the type of object being extended
* @param closure the configuration closure
* @return the configured request decoders
*/
public static RequestDecoders decoders(
final RequestDecoders type,
@DelegatesTo(value = RequestDecoders.class, strategy = DELEGATE_FIRST) final Closure closure
) {
return RequestDecoders.decoders(ConsumerWithDelegate.create(closure));
}
/**
* Creates and configures a multipart request object using the Groovy DSL closure (delegated to an instance of MultipartRequestContent).
*
* @param type the type of object being extended
* @param closure the configuration closure
* @return a configured instance of MultipartRequestContent
*/
public static MultipartRequestContent multipartRequest(
final MultipartRequestContent type,
@DelegatesTo(value = MultipartRequestContent.class, strategy = DELEGATE_FIRST) final Closure closure
) {
return MultipartRequestContent.multipartRequest(ConsumerWithDelegate.create(closure));
}
/**
* Creates a new multipart response content object with the optional boundary (random default) and a Closure used to configure the parts.
*
* @param type the type of object being extended
* @param closure the configuration closure (Delegates to MultipartContent instance)
* @return a reference to this MultipartResponseContent instance
*/
public static MultipartResponseContent multipartResponse(
final MultipartResponseContent type,
final @DelegatesTo(value = MultipartResponseContent.class, strategy = DELEGATE_FIRST) Closure closure
) {
return MultipartResponseContent.multipartResponse(ConsumerWithDelegate.create(closure));
}
}