org.dellroad.querystream.jpa.FromValue Maven / Gradle / Ivy

Go to download

/*
 * Copyright (C) 2018 Archie L. Cobbs. All rights reserved.
 */

package org.dellroad.querystream.jpa;

import java.util.Map;
import java.util.function.Consumer;
import java.util.function.Function;

import javax.persistence.FlushModeType;
import javax.persistence.LockModeType;
import javax.persistence.criteria.Expression;
import javax.persistence.criteria.From;
import javax.persistence.criteria.JoinType;
import javax.persistence.criteria.Selection;
import javax.persistence.metamodel.SingularAttribute;

import org.dellroad.querystream.jpa.querytype.SearchType;

/**
 * A {@link FromStream} that is guaranteed to return at most a single result.
 */
public interface FromValue> extends PathValue, FromStream {

// Narrowing overrides (FromStream)

    @Override
    default  FromValue> join(SingularAttribute attribute) {
        return this.join(attribute, JoinType.INNER);
    }

    @Override
    default  FromValue> join(SingularAttribute attribute, JoinType joinType) {
        if (attribute == null)
            throw new IllegalArgumentException("null attribute");
        if (!attribute.isAssociation())
            throw new IllegalArgumentException("attribute is not an association: " + attribute);
        if (joinType == null)
            throw new IllegalArgumentException("null joinType");
        QueryStreamImpl.checkOffsetLimit(this, "join()");
        return new FromValueImpl<>(this.getEntityManager(), new SearchType<>(attribute.getJavaType()),
           (builder, query) -> this.configure(builder, query).join(attribute, joinType), QueryInfo.of(this));
    }

// Narrowing overrides (QueryStream)

    @Override
    FromValue bind(Ref ref);

    @Override
    FromValue peek(Consumer peeker);

    @Override
    > FromValue bind(Ref ref, Function refFunction);

    @Override
    FromValue filter(SingularAttribute attribute);

    @Override
    FromValue filter(Function> predicateBuilder);

    @Override
    FromValue withFlushMode(FlushModeType flushMode);

    @Override
    FromValue withLockMode(LockModeType lockMode);

    @Override
    FromValue withHint(String name, Object value);

    @Override
    FromValue withHints(Map hints);

    @Override
    FromValue withLoadGraph(String name);

    @Override
    FromValue withFetchGraph(String name);
}