avoid `try {fail();} catch(Throwable){}` antipattern
[idea/community.git] / platform / lang-api / src / com / intellij / facet / ModifiableFacetModel.java
index 7d8dea27612d6ac0cd90e806a5b1733d3ce30e83..0944f436bebcc9685d2abcfa25883e7aee00168f 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * Copyright 2000-2007 JetBrains s.r.o.
+ * Copyright 2000-2009 JetBrains s.r.o.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
 
 package com.intellij.facet;
 
-import org.jetbrains.annotations.Nullable;
-import org.jetbrains.annotations.NotNull;
 import com.intellij.openapi.Disposable;
+import com.intellij.openapi.roots.ProjectModelExternalSource;
+import org.jetbrains.annotations.ApiStatus;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
 
-/**
- * @author nik
- */
+@ApiStatus.NonExtendable
 public interface ModifiableFacetModel extends FacetModel {
 
-  void addFacet(Facet facet);
-  void removeFacet(Facet facet);
+  void addFacet(Facet<?> facet);
+  void addFacet(Facet<?> facet, @Nullable ProjectModelExternalSource externalSource);
+  void removeFacet(Facet<?> facet);
+
+  /**
+   * Replaces {@code original} facet by {@code replacement}. The only difference with {@code removeFacet(original); addFacet(replacement); }
+   * is that this method preserves order of facets in internal structures to avoid modifications of *.iml files.
+   */
+  @ApiStatus.Internal
+  void replaceFacet(@NotNull Facet<?> original, @NotNull Facet<?> replacement);
 
-  void rename(Facet facet, String newName);
+  void rename(Facet<?> facet, String newName);
 
   @Nullable
-  String getNewName(Facet facet);
+  String getNewName(Facet<?> facet);
 
   void commit();
 
   boolean isModified();
 
-  boolean isNewFacet(Facet facet);
-  
-  String getFacetName(Facet facet);
+  boolean isNewFacet(Facet<?> facet);
 
-  void addListener(@NotNull Listener listener, @Nullable Disposable parentDisposable);
+  void addListener(@NotNull Listener listener, @NotNull Disposable parentDisposable);
 
+  @FunctionalInterface
   interface Listener {
     void onChanged();
   }