i18n: templates (fix more clients) (IDEA-249136)
[idea/community.git] / platform / projectModel-api / src / com / intellij / openapi / roots / FileIndex.java
1 /*
2  * Copyright 2000-2017 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.project.Project;
19 import com.intellij.openapi.vfs.VirtualFile;
20 import com.intellij.openapi.vfs.VirtualFileFilter;
21 import org.jetbrains.annotations.ApiStatus;
22 import org.jetbrains.annotations.NotNull;
23 import org.jetbrains.annotations.Nullable;
24 import org.jetbrains.jps.model.module.JpsModuleSourceRootType;
25
26 import java.util.Set;
27
28 /**
29  * Provides information about files contained in a project or module.
30  * In this interface and its inheritors, methods checking specific file status ("isX", "getX") should be used from a read action.
31  * Iteration methods ("iterateX") may be called outside of a read action (since iteration can take a long time),
32  * but they should be prepared to project model being changed in the middle of the iteration.
33  *
34  * @see ProjectRootManager#getFileIndex()
35  * @see ModuleRootManager#getFileIndex()
36  */
37 @ApiStatus.NonExtendable
38 public interface FileIndex {
39   /**
40    * Processes all files and directories under content roots skipping excluded and ignored files and directories.
41    *
42    * @return false if files processing was stopped ({@link ContentIterator#processFile(VirtualFile)} returned false)
43    */
44   boolean iterateContent(@NotNull ContentIterator processor);
45
46   /**
47    * Same as {@link #iterateContent(ContentIterator)} but allows to pass {@code filter} to
48    * provide filtering in condition for directories.
49    * <p>
50    * If {@code filter} returns false on a directory, the directory won't be processed, but iteration will go on.
51    * <p>
52    * {@code null} filter means that all directories should be processed.
53    *
54    * @return false if files processing was stopped ({@link ContentIterator#processFile(VirtualFile)} returned false)
55    */
56   boolean iterateContent(@NotNull ContentIterator processor, @Nullable VirtualFileFilter filter);
57
58   /**
59    * Processes all files and directories in the content under directory {@code dir} (including the directory itself) skipping excluded
60    * and ignored files and directories. Does nothing if {@code dir} is not in the content.
61    *
62    * @return false if files processing was stopped ({@link ContentIterator#processFile(VirtualFile)} returned false)
63    */
64   boolean iterateContentUnderDirectory(@NotNull VirtualFile dir, @NotNull ContentIterator processor);
65
66   /**
67    * Same as {@link #iterateContentUnderDirectory(VirtualFile, ContentIterator)} but allows to pass additional {@code customFilter} to
68    * the iterator, in case you need to skip some file system branches using your own logic. If {@code customFilter} returns false on
69    * a directory, it won't be processed, but iteration will go on.
70    * <p>
71    * {@code null} filter means that all directories should be processed.
72    */
73   boolean iterateContentUnderDirectory(@NotNull VirtualFile dir,
74                                        @NotNull ContentIterator processor,
75                                        @Nullable VirtualFileFilter customFilter);
76
77   /**
78    * Returns {@code true} if {@code fileOrDir} is a file or directory under a content root of this project or module and not excluded or
79    * ignored.
80    */
81   boolean isInContent(@NotNull VirtualFile fileOrDir);
82
83   /**
84    * @deprecated name of this method is unclear, use {@link #isInSourceContent(VirtualFile)} instead and add {@code !file.isDirectory()} check
85    * if you want to accept files only.
86    */
87   @Deprecated
88   boolean isContentSourceFile(@NotNull VirtualFile file);
89
90   /**
91    * Returns {@code true} if {@code fileOrDir} is a file or directory located under a sources, tests or resources root and not excluded or ignored.
92    */
93   boolean isInSourceContent(@NotNull VirtualFile fileOrDir);
94
95   /**
96    * Returns true if {@code fileOrDir} is a file or directory located under a test sources or resources root and not excluded or ignored.
97    * <p>
98    * Use this method when you really need to check whether the file is under test roots according to project configuration.
99    * <p>
100    * If you want to determine whether file should be considered as test (e.g. for implementing SearchScope)
101    * you'd better use {@link TestSourcesFilter#isTestSources(VirtualFile, Project)} instead
102    * which includes {@link ProjectFileIndex#isInTestSourceContent(VirtualFile)} invocation.
103    *
104    * @see TestSourcesFilter#isTestSources(VirtualFile, Project)
105    */
106   boolean isInTestSourceContent(@NotNull VirtualFile fileOrDir);
107
108   /**
109    * Returns {@code true} if {@code fileOrDir} is a file or directory located under a source root of type from {@code rootTypes} set and not excluded or ignored
110    */
111   boolean isUnderSourceRootOfType(@NotNull VirtualFile fileOrDir, @NotNull Set<? extends JpsModuleSourceRootType<?>> rootTypes);
112 }