content: /*
   * Copyright (C) 2020 ActiveJ LLC.
   *
   * 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 io.activej.inject.module;
  
  import io.activej.inject.Key;
  import io.activej.inject.KeyPattern;
  import io.activej.inject.Scope;
  import io.activej.inject.binding.Binding;
  import io.activej.inject.binding.BindingGenerator;
  import io.activej.inject.binding.BindingTransformer;
  import io.activej.inject.binding.Multibinder;
  import io.activej.inject.util.Trie;
  
  import java.util.Map;
  import java.util.Set;
  import java.util.function.UnaryOperator;
  
  import static io.activej.inject.Qualifiers.isUnique;
  import static java.util.stream.Collectors.toSet;
  
  /**
   * A module is an object, that provides certain sets of bindings, transformers, generators or multibinders
   * arranged by keys in certain data structures.
   *
   * @see AbstractModule
   */
  public interface Module {
  	Trie<Scope, Map<Key<?>, Set<Binding<?>>>> getBindings();
  
  	default Trie<Scope, Set<Key<?>>> getExports() {
  		return getBindings().map(map -> map.keySet().stream().filter(key -> !isUnique(key.getQualifier())).collect(toSet()));
  	}
  
  	default Trie<Scope, Set<Key<?>>> getImports() {
  		return Modules.getImports(getBindings());
  	}
  
  	Map<KeyPattern<?>, Set<BindingGenerator<?>>> getBindingGenerators();
  
  	Map<KeyPattern<?>, Set<BindingTransformer<?>>> getBindingTransformers();
  
  	Map<Key<?>, Multibinder<?>> getMultibinders();
  
  	default Module combineWith(Module another) {
  		return Modules.combine(this, another);
  	}
  
  	default Module overrideWith(Module another) {
  		return Modules.override(this, another);
  	}
  
  	default Module transformWith(UnaryOperator<Module> fn) {
  		return fn.apply(this);
  	}
  
  	/**
  	 * Returns an empty {@link Module module}.
  	 */
  	static Module empty() {
  		return Modules.EMPTY;
  	}
  
  	/**
  	 * Creates a {@link Module module} out of given binding graph trie
  	 */
  	static Module of(Trie<Scope, Map<Key<?>, Set<Binding<?>>>> bindings) {
  		return new SimpleModule(bindings, Map.of(), Map.of(), Map.of());
  	}
  
  	/**
  	 * Creates a {@link Module module} out of given binding graph trie, transformers, generators and multibinders
  	 */
  	static Module of(
  		Trie<Scope, Map<Key<?>, Set<Binding<?>>>> bindings,
  		Map<KeyPattern<?>, Set<BindingTransformer<?>>> transformers,
  		Map<KeyPattern<?>, Set<BindingGenerator<?>>> generators,
  		Map<Key<?>, Multibinder<?>> multibinders
  	) {
  		return new SimpleModule(bindings, transformers, generators, multibinders);
  	}
  }
  