com.blazebit.persistence.view.metamodel.PluralAttribute 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.view.metamodel;

import java.util.Comparator;
import java.util.Map;

/**
 * Instances of the type {@linkplain PluralAttribute} represent collection-valued attributes.
 *
 * @param  The type of the declaring entity view
 * @param  The type of the represented collection
 * @param  The element type of the represented collection
 * @author Christian Beikov
 * @since 1.0.0
 */
public interface PluralAttribute extends Attribute {

    /**
     * Returns the collection type.
     *
     * @return The collection type
     */
    public CollectionType getCollectionType();

    /**
     * Returns the type representing the element type of the collection.
     *
     * @return The element type
     * @since 1.2.0
     */
    public Type getElementType();

    /**
     * Returns the inheritance subtypes that should be considered for the elements of this plural attribute.
     * When the element type of the attribute is not a subview, this returns an empty set.
     *
     * @return The inheritance subtypes or an empty set
     * @since 1.2.0
     */
    public Map, String> getElementInheritanceSubtypeMappings();
    
    /**
     * Returns whether this collection is indexed or not.
     * 
     * @return true if the collection is indexed, false otherwise
     */
    public boolean isIndexed();
    
    /**
     * Returns whether this collection is ordered or not.
     * 
     * @return true if the collection is ordered, false otherwise
     */
    public boolean isOrdered();
    
    /**
     * Returns whether this collection is sorted or not.
     * 
     * @return true if the collection is sorted, false otherwise
     */
    public boolean isSorted();

    /**
     * Returns whether this collection is forcefully deduplicated on load or not.
     *
     * @return true if the collection is forcefully deduplicated on load, false otherwise
     * @since 1.3.0
     */
    public boolean isForcedUnique();
    
    /**
     * Returns the comparator that should be used for sorting.
     * Returns null if no sorting is used or the natural sort order should be used.
     * 
     * @return the comparator that should be used for sorting
     */
    public Comparator getComparator();
    
    /**
     * Returns the comparator class that should be used for sorting.
     * Returns null if no sorting is used or the natural sort order should be used.
     * 
     * @return the comparator class that should be used for sorting
     */
    public Class> getComparatorClass();

    /**
     * The different collection types.
     */
    public static enum CollectionType {

        /**
         * Collection-valued attribute.
         */
        COLLECTION,
        /**
         * List-valued attribute.
         */
        LIST,
        /**
         * Map-valued attribute.
         */
        MAP,
        /**
         * Set-valued attribute.
         */
        SET;
    }
}