com.blazebit.persistence.ObjectBuilder Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of blaze-persistence-entity-view-api-jar Show documentation

There is a newer version: 1.6.14

Show newest version

/*
 * Copyright 2014 - 2019 Blazebit.
 *
 * 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 com.blazebit.persistence;

import java.util.List;

/**
 * An object build provides the select clause expressions that should be used by a {@link FullQueryBuilder} and provides methods for
 * transforming tuples into the target type T.
 *
 * @param  The type that this builder produces
 * @author Christian Beikov
 * @since 1.0.0
 */
public interface ObjectBuilder {

    /**
     * Applies the select items necessary for this object builder to work.
     *
     * @param selectBuilder The selectBuilder on which to apply the selects
     * @param  The type of the select builder
     */
    // TODO: Create a special subtype "ObjectBuilderTarget" that extends SelectBuilder & FetchBuilder
    public > void applySelects(X selectBuilder);

    /**
     * Builds an object of the target type T from the given tuple.
     *
     * @param tuple The result tuple
     * @return The target object
     */
    public T build(Object[] tuple);

    /**
     * Transforms the given list and returns the result.
     *
     * @param list The list to be transformed
     * @return The resulting list
     */
    public List buildList(List list);
}