Interface Notificator

  • All Known Implementing Classes:
    NotificatorAdapter

    public interface Notificator
    Custom notificator interface. Implement it to provide new notification facilities. Plugin developers are encouraged to extend NotificatorAdapter class, as it makes the plugin more robust in case of new notification events.
    • Method Detail

      • notifyBuildStarted

        void notifyBuildStarted​(@NotNull
                                SRunningBuild build,
                                @NotNull
                                java.util.Set<SUser> users)
        Called when new build started.
        Parameters:
        build - started build.
        users - users to be notified.
      • notifyBuildSuccessful

        void notifyBuildSuccessful​(@NotNull
                                   SRunningBuild build,
                                   @NotNull
                                   java.util.Set<SUser> users)
        Called when build finished successfully.
        Parameters:
        build - finished build.
        users - users to be notified.
      • notifyBuildFailed

        void notifyBuildFailed​(@NotNull
                               SRunningBuild build,
                               @NotNull
                               java.util.Set<SUser> users)
        Called when build failed.
        Parameters:
        build - finished build
        users - users to be notified.
      • notifyBuildFailedToStart

        void notifyBuildFailedToStart​(@NotNull
                                      SRunningBuild build,
                                      @NotNull
                                      java.util.Set<SUser> users)
        Called when build failed with internal error, i.e. could not actually start.
        Parameters:
        build - failed build
        users - users to be notified
        Since:
        6.0
      • notifyLabelingFailed

        void notifyLabelingFailed​(@NotNull
                                  Build build,
                                  @NotNull
                                  VcsRoot root,
                                  @NotNull
                                  java.lang.Throwable exception,
                                  @NotNull
                                  java.util.Set<SUser> users)
        Called when labeling failed for the build.
        Parameters:
        build - finished build.
        root - problem root.
        exception - cause.
        users - users to be notified.
      • notifyBuildFailing

        void notifyBuildFailing​(@NotNull
                                SRunningBuild build,
                                @NotNull
                                java.util.Set<SUser> users)
        Called when the first failed message occurred.
        Parameters:
        build - running build.
        users - users to be notified.
      • notifyBuildProbablyHanging

        void notifyBuildProbablyHanging​(@NotNull
                                        SRunningBuild build,
                                        @NotNull
                                        java.util.Set<SUser> users)
        Called when build is not sending messages to server for some time.
        Parameters:
        build - running build.
        users - users to be notified.
      • notifyResponsibleChanged

        void notifyResponsibleChanged​(@NotNull
                                      SBuildType buildType,
                                      @NotNull
                                      java.util.Set<SUser> users)
        Called when responsibility for configuration changed.
        Parameters:
        buildType - configuration.
        users - users to be notified.
      • notifyResponsibleAssigned

        void notifyResponsibleAssigned​(@NotNull
                                       SBuildType buildType,
                                       @NotNull
                                       java.util.Set<SUser> users)
        Called when responsibility for the build type is assigned on certain users.
        Parameters:
        buildType - configuration.
        users - users to be notified.
        Since:
        5.0
      • notifyResponsibleChanged

        void notifyResponsibleChanged​(@Nullable
                                      TestNameResponsibilityEntry oldValue,
                                      @NotNull
                                      TestNameResponsibilityEntry newValue,
                                      @NotNull
                                      SProject project,
                                      @NotNull
                                      java.util.Set<SUser> users)
        Called when responsibility for the test changed.
        Parameters:
        oldValue - old responsibility entry (nullable).
        newValue - new responsibility entry.
        project - the project.
        users - users to be notified.
        Since:
        5.0
      • notifyResponsibleAssigned

        void notifyResponsibleAssigned​(@Nullable
                                       TestNameResponsibilityEntry oldValue,
                                       @NotNull
                                       TestNameResponsibilityEntry newValue,
                                       @NotNull
                                       SProject project,
                                       @NotNull
                                       java.util.Set<SUser> users)
        Called when responsibility for the test is assigned on certain users.
        Parameters:
        oldValue - old responsibility entry (nullable).
        newValue - new responsibility entry.
        project - the project.
        users - users to be notified.
        Since:
        5.0
      • notifyResponsibleChanged

        void notifyResponsibleChanged​(@NotNull
                                      java.util.Collection<TestName> testNames,
                                      @NotNull
                                      ResponsibilityEntry entry,
                                      @NotNull
                                      SProject project,
                                      @NotNull
                                      java.util.Set<SUser> users)
        Called when responsibility for several tests at once is changed.
        Parameters:
        testNames - the collection of test names
        entry - new responsibility entry for each test
        project - the project
        users - users to be notified
        Since:
        6.0
      • notifyResponsibleAssigned

        void notifyResponsibleAssigned​(@NotNull
                                       java.util.Collection<TestName> testNames,
                                       @NotNull
                                       ResponsibilityEntry entry,
                                       @NotNull
                                       SProject project,
                                       @NotNull
                                       java.util.Set<SUser> users)
        Called when responsibility for several tests at once is assigned.
        Parameters:
        testNames - the collection of test names
        entry - new responsibility entry for each test
        project - the project
        users - users to be notified
        Since:
        6.0
      • notifyBuildProblemResponsibleAssigned

        void notifyBuildProblemResponsibleAssigned​(@NotNull
                                                   java.util.Collection<BuildProblemInfo> buildProblems,
                                                   @NotNull
                                                   ResponsibilityEntry entry,
                                                   @NotNull
                                                   SProject project,
                                                   @NotNull
                                                   java.util.Set<SUser> users)
        Called when responsibility for several build problems is assigned.
        Parameters:
        buildProblems - affected build problems
        entry - new responsibility entry
        project - corresponding project
        users - users to be notified
        Since:
        8.0
      • notifyBuildProblemResponsibleChanged

        void notifyBuildProblemResponsibleChanged​(@NotNull
                                                  java.util.Collection<BuildProblemInfo> buildProblems,
                                                  @NotNull
                                                  ResponsibilityEntry entry,
                                                  @NotNull
                                                  SProject project,
                                                  @NotNull
                                                  java.util.Set<SUser> users)
        Called when responsibility for several build problems is changed.
        Parameters:
        buildProblems - affected build problems
        entry - new responsibility entry
        project - corresponding project
        users - users to be notified
        Since:
        8.0
      • notifyTestsMuted

        void notifyTestsMuted​(@NotNull
                              java.util.Collection<STest> tests,
                              @NotNull
                              MuteInfo muteInfo,
                              @NotNull
                              java.util.Set<SUser> users)
        Called when a set of tests are unmuted (with same mute properties). All tests are in the same project.
        Parameters:
        tests - the unmuted tests
        muteInfo - the mute info on the moment of unmute
        users - users to be notified
        Since:
        6.5
      • notifyTestsUnmuted

        void notifyTestsUnmuted​(@NotNull
                                java.util.Collection<STest> tests,
                                @NotNull
                                MuteInfo muteInfo,
                                @Nullable
                                SUser user,
                                @NotNull
                                java.util.Set<SUser> users)
        Called when a set of tests are unmuted (with same mute properties). All tests are in the same project.
        Parameters:
        tests - the unmuted tests
        user - user who performed the action (if known)
        users - users to be notified
        Since:
        6.5 (updated in 7.0)
      • notifyBuildProblemsMuted

        void notifyBuildProblemsMuted​(@NotNull
                                      java.util.Collection<BuildProblemInfo> buildProblems,
                                      @NotNull
                                      MuteInfo muteInfo,
                                      @NotNull
                                      java.util.Set<SUser> users)
        Called when a set of build problems are muted (with same mute properties). All problems belong the same project.
        Parameters:
        buildProblems - the muted problems
        muteInfo - mute info
        users - users to be notified
        Since:
        8.0
      • notifyBuildProblemsUnmuted

        void notifyBuildProblemsUnmuted​(@NotNull
                                        java.util.Collection<BuildProblemInfo> buildProblems,
                                        @NotNull
                                        MuteInfo muteInfo,
                                        @Nullable
                                        SUser user,
                                        @NotNull
                                        java.util.Set<SUser> users)
        Called when a set of build problems are unmuted (with same mute properties). All problems belong the same project.
        Parameters:
        buildProblems - the unmuted problems
        user - user who performed the action (if known)
        users - users to be notified
        Since:
        8.0
      • notifyQueuedBuildWaitingForApproval

        void notifyQueuedBuildWaitingForApproval​(@NotNull
                                                 SQueuedBuild queuedBuild,
                                                 @NotNull
                                                 java.util.Set<SUser> users)
        Called when a build that requires approval from the user is added into the build queue.
        Parameters:
        queuedBuild - queued build
        users - users to be notified
        Since:
        2022.1
      • getNotificatorType

        @NotNull
        @NonNls
        java.lang.String getNotificatorType()
        Unique type of the notificator.
        Returns:
        notificator unique key.
      • getDisplayName

        @NotNull
        java.lang.String getDisplayName()
        Notificator display name.
        Returns:
        notificator display name.