mirror of https://github.com/DanilaFe/abacus
45 lines
1.7 KiB
Kotlin
45 lines
1.7 KiB
Kotlin
package org.nwapw.abacus.function
|
|
|
|
import org.nwapw.abacus.context.MutableEvaluationContext
|
|
import org.nwapw.abacus.context.PluginEvaluationContext
|
|
import org.nwapw.abacus.exception.DomainException
|
|
|
|
/**
|
|
* A class that can be applied to arguments.
|
|
*
|
|
* Applicable is a class that represents something that can be applied to one or more
|
|
* arguments of the same type, and returns a single value from that application.
|
|
* @param <T> the type of the parameters passed to this applicable.
|
|
* @param <O> the return type of the applicable.
|
|
*/
|
|
interface Applicable<in T : Any, out O : Any> {
|
|
|
|
/**
|
|
* Checks if the given applicable can be used with the given parameters.
|
|
* @param params the parameter array to verify for compatibility.
|
|
* @return whether the array can be used with applyInternal.
|
|
*/
|
|
fun matchesParams(context: PluginEvaluationContext, params: Array<out T>): Boolean
|
|
|
|
/**
|
|
* Applies the applicable object to the given parameters,
|
|
* without checking for compatibility.
|
|
* @param params the parameters to apply to.
|
|
* @return the result of the application.
|
|
*/
|
|
fun applyInternal(context: PluginEvaluationContext, params: Array<out T>): O
|
|
|
|
/**
|
|
* If the parameters can be used with this applicable, returns
|
|
* the result of the application of the applicable to the parameters.
|
|
* Otherwise, returns null.
|
|
* @param params the parameters to apply to.
|
|
* @return the result of the operation, or null if parameters do not match.
|
|
*/
|
|
fun apply(context: PluginEvaluationContext, vararg params: T): O {
|
|
if (!matchesParams(context, params))
|
|
throw DomainException("parameters do not match function requirements.")
|
|
return applyInternal(context, params)
|
|
}
|
|
|
|
} |