com.intellij.openapi.diff.DiffRequestFactory.java Source code

Introduction

Here is the source code for com.intellij.openapi.diff.DiffRequestFactory.java

Source

/*
 * Copyright 2000-2014 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.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.intellij.openapi.diff;

import com.intellij.openapi.components.ServiceManager;
import com.intellij.openapi.fileTypes.FileType;
import com.intellij.openapi.project.Project;
import com.intellij.openapi.vfs.VirtualFile;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;

/**
 * Allows to initiate 3-way merge operations for multiple versions of content of a particular virtual file.
 * @deprecated use {@link com.intellij.diff.DiffRequestFactory} instead
 */
@Deprecated
public abstract class DiffRequestFactory {
    public static DiffRequestFactory getInstance() {
        return ServiceManager.getService(DiffRequestFactory.class);
    }

    /**
     * Creates a request for a merge operation. To execute the request, obtain the diff tool instance by calling
     * {@link com.intellij.openapi.diff.DiffManager#getDiffTool()} and then call {@link DiffTool#show(DiffRequest)}.
     *
     * @param leftText                 First of the changed versions of the content (to be displayed in the left pane).
     * @param rightText                Second of the changed versions of the content (to be displayed in the right pane).
     * @param originalContent          The version of the content before changes.
     * @param file                     The file which is being merged.
     * @param project                  The project in the context of which the operation is executed.
     * @param okButtonPresentation     Parameter ignored.
     * @param cancelButtonPresentation Parameter ignored.
     * @return The merge operation request.
     */
    public abstract MergeRequest createMergeRequest(@NotNull String leftText, @NotNull String rightText,
            @NotNull String originalContent, @NotNull VirtualFile file, @Nullable Project project,
            @Nullable ActionButtonPresentation okButtonPresentation,
            @Nullable ActionButtonPresentation cancelButtonPresentation);

    public abstract MergeRequest create3WayDiffRequest(@NotNull String leftText, @NotNull String rightText,
            @NotNull String originalContent, @Nullable Project project,
            @Nullable ActionButtonPresentation okButtonPresentation,
            @Nullable ActionButtonPresentation cancelButtonPresentation);

    public abstract MergeRequest create3WayDiffRequest(@NotNull String leftText, @NotNull String rightText,
            @NotNull String originalContent, @Nullable FileType type, @Nullable Project project,
            @Nullable ActionButtonPresentation okButtonPresentation,
            @Nullable ActionButtonPresentation cancelButtonPresentation);
}