summaryrefslogtreecommitdiff
path: root/platform/platform-impl/src/com/intellij/openapi/components/impl/stores/StreamProvider.java
blob: cf49b927ad0e8de0af77f82f28b6a8125dc0eb68 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
package com.intellij.openapi.components.impl.stores;

import com.intellij.openapi.components.RoamingType;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;

import java.io.IOException;
import java.io.InputStream;
import java.util.Collection;
import java.util.Collections;

public abstract class StreamProvider {
  public static final StreamProvider[] EMPTY_ARRAY = new StreamProvider[0];

  public boolean isEnabled() {
    return true;
  }

  /**
   * If true, special version file per storage file will keep version of component.
   * On load remote data will be ignored if local version of component is higher.
   * If your storage is always in connected state (for example, git provides you local working copy), you don't need it.
   */
  public boolean isVersioningRequired() {
    return false;
  }

  /**
   * fileSpec Only main fileSpec, not version
   */
  public boolean isApplicable(@NotNull String fileSpec, @NotNull RoamingType roamingType) {
    return true;
  }

  /**
   * @param fileSpec
   * @param content bytes of content, size of array is not actual size of data, you must use {@code size}
   * @param size actual size of data
   * @param roamingType
   * @param async
   */
  public abstract void saveContent(@NotNull String fileSpec, @NotNull byte[] content, int size, @NotNull RoamingType roamingType, boolean async) throws IOException;

  @Nullable
  public abstract InputStream loadContent(@NotNull String fileSpec, @NotNull RoamingType roamingType) throws IOException;

  @NotNull
  public Collection<String> listSubFiles(@NotNull String fileSpec, @NotNull RoamingType roamingType) {
    return Collections.emptyList();
  }

  /**
   * Delete file or directory
   */
  public abstract void delete(@NotNull String fileSpec, @NotNull RoamingType roamingType);
}