1   /*
2    * Copyright 2019 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.server.mirror;
17  
18  import static com.google.common.base.Preconditions.checkArgument;
19  import static java.util.Objects.requireNonNull;
20  
21  import java.util.regex.Matcher;
22  import java.util.regex.Pattern;
23  
24  /**
25   * A utility class for creating a mirroring task.
26   */
27  public final class MirrorUtil {
28  
29      private static final Pattern MIRROR_ID_PATTERN =
30              Pattern.compile("^[a-zA-Z](?:[a-zA-Z0-9-_.]{0,61}[a-zA-Z0-9])?$");
31  
32      /**
33       * Validates the specified {@code id} as a mirror ID.
34       */
35      public static void validateMirrorId(String id) {
36          final Matcher matcher = MIRROR_ID_PATTERN.matcher(id);
37          checkArgument(matcher.matches(),
38                        "invalid mirror ID: %s (expected: %s)",
39                        id, MIRROR_ID_PATTERN.pattern());
40      }
41  
42      /**
43       * Normalizes the specified {@code path}. A path which starts and ends with {@code /} would be returned.
44       * Also, it would not have consecutive {@code /}.
45       */
46      public static String normalizePath(String path) {
47          requireNonNull(path, "path");
48          if (path.isEmpty()) {
49              return "/";
50          }
51  
52          if (!path.startsWith("/")) {
53              path = '/' + path;
54          }
55  
56          if (!path.endsWith("/")) {
57              path += '/';
58          }
59  
60          return path.replaceAll("//+", "/");
61      }
62  
63      private MirrorUtil() {}
64  }