001package org.cache2k.configuration;
002
003/*
004 * #%L
005 * cache2k API
006 * %%
007 * Copyright (C) 2000 - 2016 headissue GmbH, Munich
008 * %%
009 * Licensed under the Apache License, Version 2.0 (the "License");
010 * you may not use this file except in compliance with the License.
011 * You may obtain a copy of the License at
012 * 
013 *      http://www.apache.org/licenses/LICENSE-2.0
014 * 
015 * Unless required by applicable law or agreed to in writing, software
016 * distributed under the License is distributed on an "AS IS" BASIS,
017 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
018 * See the License for the specific language governing permissions and
019 * limitations under the License.
020 * #L%
021 */
022
023import java.util.Collection;
024
025/**
026 * Collection of customizations. The order of inserting is preserved. The first element inserted
027 * is returned first by the iteration. Duplicate entries will be rejected.
028 *
029 * <p>Typically the implementation {@link DefaultCustomizationCollection} will be used.
030 *
031 * @author Jens Wilke
032 * @see DefaultCustomizationCollection
033 */
034public interface CustomizationCollection<T> extends Collection<CustomizationSupplier<T>> {
035
036  /**
037   * Adds a customization to the collection.
038   *
039   * @return alsways {@code true}
040   * @throws IllegalArgumentException if the entry is already existing.
041   */
042  @Override
043  boolean add(CustomizationSupplier<T> e);
044
045  /**
046   * Adds all customizations to the collection.
047   *
048   * @return alsways {@code true}
049   * @throws IllegalArgumentException if an entry is already existing.
050   */
051  @Override
052  boolean addAll(Collection<? extends CustomizationSupplier<T>> c);
053
054}