From 829594f79d3c8af7277e7149632e2a1a401053d1 Mon Sep 17 00:00:00 2001
From: kzhsw <120431159+kzhsw@users.noreply.github.com>
Date: Fri, 2 Feb 2024 14:23:11 +0800
Subject: [PATCH] Create S3Escaper.java

---
 src/main/java/kzhsw/S3Escaper.java | 105 +++++++++++++++++++++++++++++
 1 file changed, 105 insertions(+)
 create mode 100644 src/main/java/kzhsw/S3Escaper.java

diff --git a/src/main/java/kzhsw/S3Escaper.java b/src/main/java/kzhsw/S3Escaper.java
new file mode 100644
index 0000000..6b8f5af
--- /dev/null
+++ b/src/main/java/kzhsw/S3Escaper.java
@@ -0,0 +1,105 @@
+/*
+ * MinIO Java SDK for Amazon S3 Compatible Cloud Storage, (C) 2016 MinIO, Inc.
+ *
+ * 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 kzhsw;
+
+import com.google.common.escape.Escaper;
+import com.google.common.net.UrlEscapers;
+
+public class S3Escaper {
+  private static final Escaper ESCAPER = UrlEscapers.urlPathSegmentEscaper();
+
+  /** Returns S3 encoded string. */
+  public static String encode(String str) {
+    if (str == null) {
+      return "";
+    }
+
+    return ESCAPER
+        .escape(str)
+        .replaceAll("\\!", "%21")
+        .replaceAll("\\$", "%24")
+        .replaceAll("\\&", "%26")
+        .replaceAll("\\'", "%27")
+        .replaceAll("\\(", "%28")
+        .replaceAll("\\)", "%29")
+        .replaceAll("\\*", "%2A")
+        .replaceAll("\\+", "%2B")
+        .replaceAll("\\,", "%2C")
+        .replaceAll("\\/", "%2F")
+        .replaceAll("\\:", "%3A")
+        .replaceAll("\\;", "%3B")
+        .replaceAll("\\=", "%3D")
+        .replaceAll("\\@", "%40")
+        .replaceAll("\\[", "%5B")
+        .replaceAll("\\]", "%5D");
+  }
+
+  public static String encodeOptimized(String str) {
+    if (str == null) {
+      return "";
+    }
+
+    str = ESCAPER.escape(str);
+    StringBuilder encoded = new StringBuilder(str.length() + Math.max(str.length >> 3, 4));
+
+    for (char ch : str.toCharArray()) {
+        switch (ch) {
+            case '!': encoded.append("%21"); break;
+            case '$': encoded.append("%24"); break;
+            case '&': encoded.append("%26"); break;
+            case '\'': encoded.append("%27"); break;
+            case '(': encoded.append("%28"); break;
+            case ')': encoded.append("%29"); break;
+            case '*': encoded.append("%2A"); break;
+            case '+': encoded.append("%2B"); break;
+            case ',': encoded.append("%2C"); break;
+            case '/': encoded.append("%2F"); break;
+            case ':': encoded.append("%3A"); break;
+            case ';': encoded.append("%3B"); break;
+            case '=': encoded.append("%3D"); break;
+            case '@': encoded.append("%40"); break;
+            case '[': encoded.append("%5B"); break;
+            case ']': encoded.append("%5D"); break;
+            default: encoded.append(ch);
+        }
+    }
+
+    return encoded.toString();
+  }
+
+  /** Returns S3 encoded string of given path where multiple '/' are trimmed. */
+  public static String encodePath(String path) {
+    final StringBuilder encodedPath = new StringBuilder();
+    for (String pathSegment : path.split("/")) {
+      if (!pathSegment.isEmpty()) {
+        if (encodedPath.length() > 0) {
+          encodedPath.append("/");
+        }
+        encodedPath.append(S3Escaper.encode(pathSegment));
+      }
+    }
+
+    if (path.startsWith("/")) {
+      encodedPath.insert(0, "/");
+    }
+    if (path.endsWith("/")) {
+      encodedPath.append("/");
+    }
+
+    return encodedPath.toString();
+  }
+}