1   /*
2    * Copyright 2021 LINE Corporation
3    *
4    * LINE Corporation licenses this file to you under the Apache License,
5    * version 2.0 (the "License"); you may not use this file except in compliance
6    * with the License. You may obtain a copy of the License at:
7    *
8    *   https://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, WITHOUT
12   * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
13   * License for the specific language governing permissions and limitations
14   * under the License.
15   */
16  package com.linecorp.centraldogma.client;
17  
18  import java.util.List;
19  import java.util.concurrent.CompletableFuture;
20  
21  import com.linecorp.centraldogma.common.Change;
22  import com.linecorp.centraldogma.common.PathPattern;
23  import com.linecorp.centraldogma.common.Revision;
24  
25  /**
26   * Prepares to send a {@link CentralDogma#getDiff(String, String, Revision, Revision, PathPattern)} request
27   * to the Central Dogma repository.
28   */
29  public final class DiffFilesRequest {
30  
31      private final CentralDogmaRepository centralDogmaRepo;
32      private final PathPattern pathPattern;
33  
34      DiffFilesRequest(CentralDogmaRepository centralDogmaRepo, PathPattern pathPattern) {
35          this.centralDogmaRepo = centralDogmaRepo;
36          this.pathPattern = pathPattern;
37      }
38  
39      /**
40       * Retrieves the diffs of the files matched by the given path pattern between two {@link Revision}s.
41       *
42       * @return a {@link List} of the {@link Change}s that contain the diffs between the files matched by the
43       *         given {@link PathPattern} between two revisions.
44       */
45      public CompletableFuture<List<Change<?>>> get(Revision from, Revision to) {
46          return centralDogmaRepo.centralDogma().getDiff(centralDogmaRepo.projectName(),
47                                                         centralDogmaRepo.repositoryName(),
48                                                         from, to, pathPattern);
49      }
50  }