X-Git-Url: https://gerrit.simantics.org/r/gitweb?p=simantics%2Fplatform.git;a=blobdiff_plain;f=bundles%2Forg.simantics.db%2Fsrc%2Forg%2Fsimantics%2Fdb%2Ffunction%2FDbFunction.java;fp=bundles%2Forg.simantics.db%2Fsrc%2Forg%2Fsimantics%2Fdb%2Ffunction%2FDbFunction.java;h=75b685f74f782499b9b0290bbc654d642b9a8b9c;hp=f9e2059bde4c26b9d168c92990f4970b0d67f3e1;hb=0ae2b770234dfc3cbb18bd38f324125cf0faca07;hpb=24e2b34260f219f0d1644ca7a138894980e25b14 diff --git a/bundles/org.simantics.db/src/org/simantics/db/function/DbFunction.java b/bundles/org.simantics.db/src/org/simantics/db/function/DbFunction.java index f9e2059bd..75b685f74 100644 --- a/bundles/org.simantics.db/src/org/simantics/db/function/DbFunction.java +++ b/bundles/org.simantics.db/src/org/simantics/db/function/DbFunction.java @@ -1,88 +1,88 @@ -/******************************************************************************* - * Copyright (c) 2016 Association for Decentralized Information Management - * in Industry THTH ry. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Eclipse Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/epl-v10.html - * - * Contributors: - * Semantum Oy - initial API and implementation - *******************************************************************************/ -package org.simantics.db.function; - -import java.util.Objects; - -import org.simantics.db.exception.DatabaseException; - -/** - * Represents a function that accepts one argument and produces a result that - * can throw database exceptions. - * - * @param the type of the first argument to the function - * @param the type of the second argument to the function - * @param the type of the result of the function - * - * @since 1.22.1 & 1.24.0 - */ -@FunctionalInterface -public interface DbFunction { - - /** - * Applies this function to the given argument. - * - * @param t the function argument - * @return the function result - */ - R apply(T t) throws DatabaseException; - - /** - * Returns a composed function that first applies the {@code before} - * function to its input, and then applies this function to the result. - * If evaluation of either function throws an exception, it is relayed to - * the caller of the composed function. - * - * @param the type of input to the {@code before} function, and to the - * composed function - * @param before the function to apply before this function is applied - * @return a composed function that first applies the {@code before} - * function and then applies this function - * @throws NullPointerException if before is null - * - * @see #andThen(DbFunction) - */ - default DbFunction compose(DbFunction before) { - Objects.requireNonNull(before); - return (V v) -> apply(before.apply(v)); - } - - /** - * Returns a composed function that first applies this function to - * its input, and then applies the {@code after} function to the result. - * If evaluation of either function throws an exception, it is relayed to - * the caller of the composed function. - * - * @param the type of output of the {@code after} function, and of the - * composed function - * @param after the function to apply after this function is applied - * @return a composed function that first applies this function and then - * applies the {@code after} function - * @throws NullPointerException if after is null - * - * @see #compose(DbFunction) - */ - default DbFunction andThen(DbFunction after) { - Objects.requireNonNull(after); - return (T t) -> after.apply(apply(t)); - } - - /** - * Returns a function that always returns its input argument. - * - * @param the type of the input and output objects to the function - * @return a function that always returns its input argument - */ - static DbFunction identity() { - return t -> t; - } -} +/******************************************************************************* + * Copyright (c) 2016 Association for Decentralized Information Management + * in Industry THTH ry. + * All rights reserved. This program and the accompanying materials + * are made available under the terms of the Eclipse Public License v1.0 + * which accompanies this distribution, and is available at + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * Semantum Oy - initial API and implementation + *******************************************************************************/ +package org.simantics.db.function; + +import java.util.Objects; + +import org.simantics.db.exception.DatabaseException; + +/** + * Represents a function that accepts one argument and produces a result that + * can throw database exceptions. + * + * @param the type of the first argument to the function + * @param the type of the second argument to the function + * @param the type of the result of the function + * + * @since 1.22.1 & 1.24.0 + */ +@FunctionalInterface +public interface DbFunction { + + /** + * Applies this function to the given argument. + * + * @param t the function argument + * @return the function result + */ + R apply(T t) throws DatabaseException; + + /** + * Returns a composed function that first applies the {@code before} + * function to its input, and then applies this function to the result. + * If evaluation of either function throws an exception, it is relayed to + * the caller of the composed function. + * + * @param the type of input to the {@code before} function, and to the + * composed function + * @param before the function to apply before this function is applied + * @return a composed function that first applies the {@code before} + * function and then applies this function + * @throws NullPointerException if before is null + * + * @see #andThen(DbFunction) + */ + default DbFunction compose(DbFunction before) { + Objects.requireNonNull(before); + return (V v) -> apply(before.apply(v)); + } + + /** + * Returns a composed function that first applies this function to + * its input, and then applies the {@code after} function to the result. + * If evaluation of either function throws an exception, it is relayed to + * the caller of the composed function. + * + * @param the type of output of the {@code after} function, and of the + * composed function + * @param after the function to apply after this function is applied + * @return a composed function that first applies this function and then + * applies the {@code after} function + * @throws NullPointerException if after is null + * + * @see #compose(DbFunction) + */ + default DbFunction andThen(DbFunction after) { + Objects.requireNonNull(after); + return (T t) -> after.apply(apply(t)); + } + + /** + * Returns a function that always returns its input argument. + * + * @param the type of the input and output objects to the function + * @return a function that always returns its input argument + */ + static DbFunction identity() { + return t -> t; + } +}