IDEA-253069 don't show diff editors in the Reader Mode
[idea/community.git] / platform / projectModel-api / src / com / intellij / openapi / roots / ModuleRootManager.java
1 /*
2  * Copyright 2000-2016 JetBrains s.r.o.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 package com.intellij.openapi.roots;
17
18 import com.intellij.openapi.module.Module;
19 import org.jetbrains.annotations.ApiStatus;
20 import org.jetbrains.annotations.NotNull;
21
22 /**
23  * Interface for getting information about the contents and dependencies of a module.
24  *
25  * @author dsl
26  * @see CompilerModuleExtension
27  */
28 @ApiStatus.NonExtendable
29 public abstract class ModuleRootManager implements ModuleRootModel, ProjectModelElement {
30   /**
31    * Returns the module root manager instance for the specified module.
32    *
33    * @param module the module for which the root manager is requested.
34    * @return the root manager instance.
35    */
36   public static ModuleRootManager getInstance(@NotNull Module module) {
37     return module.getComponent(ModuleRootManager.class);
38   }
39
40   /**
41    * Returns the file index for the current module.
42    *
43    * @return the file index instance.
44    */
45   @NotNull
46   public abstract ModuleFileIndex getFileIndex();
47
48   /**
49    * Returns the interface for modifying the set of roots for this module. Must be called in a read action.
50    * !!!!! WARNING !!!!!: This model MUST be either committed {@link ModifiableRootModel#commit()} or disposed {@link ModifiableRootModel#dispose()}
51    *
52    * @return the modifiable root model.
53    */
54   @NotNull
55   public abstract ModifiableRootModel getModifiableModel();
56
57   /**
58    * Returns the list of modules on which the current module directly depends. The method does not traverse
59    * the entire dependency structure - dependencies of dependency modules are not included in the returned list.
60    *
61    * @return the list of module direct dependencies.
62    */
63   public abstract Module @NotNull [] getDependencies();
64
65   /**
66    * Returns the list of modules on which the current module directly depends. The method does not traverse
67    * the entire dependency structure - dependencies of dependency modules are not included in the returned list.
68    *
69    * @param includeTests whether test-only dependencies should be included
70    * @return the list of module direct dependencies.
71    */
72   public abstract Module @NotNull [] getDependencies(boolean includeTests);
73
74   /**
75    * Checks if the current module directly depends on the specified module.
76    *
77    * @param module the module to check.
78    * @return true if {@code module} is contained in the list of dependencies for the current module, false otherwise.
79    */
80   public abstract boolean isDependsOn(@NotNull Module module);
81 }