feat: rename modules

devkit-utils/build.gradle.kts → common-toolbox/build.gradle.kts

@@ -64,14 +64,14 @@ tasks.test {
 
 publishing {
     publications {
-        create<MavenPublication>("devkitUtils") {
+        create<MavenPublication>("commonToolbox") {
             groupId = group.toString()
-            artifactId = "devkit-utils"
+            artifactId = "common-toolbox"
             version = artefactVersion
 
             pom {
                 name = "OnixByte Common Toolbox"
-                description = "The utils module of JDevKit."
+                description = "The utils module of OnixByte toolbox."
                 url = projectUrl
 
                 licenses {
@@ -82,8 +82,8 @@ publishing {
                 }
 
                 scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                     url = projectGithubUrl
                 }
 
@@ -107,7 +107,7 @@ publishing {
             from(components["java"])
 
             signing {
-                sign(publishing.publications["devkitUtils"])
+                sign(publishing.publications["commonToolbox"])
             }
         }
 
@@ -122,4 +122,4 @@ publishing {
             }
         }
     }
-}
+}

devkit-utils/src/main/java/com/onixbyte/devkit/utils/AesUtil.java → common-toolbox/src/main/java/com/onixbyte/common/util/AesUtil.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import javax.crypto.Cipher;
 import javax.crypto.spec.IvParameterSpec;

devkit-utils/src/main/java/com/onixbyte/devkit/utils/Base64Util.java → common-toolbox/src/main/java/com/onixbyte/common/util/Base64Util.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.nio.charset.Charset;
 import java.nio.charset.StandardCharsets;
@@ -209,4 +209,4 @@ public static String decodeUrlComponents(String value) {
 
     private static Base64.Decoder urlDecoder;
 
-}
+}

devkit-utils/src/main/java/com/onixbyte/devkit/utils/BoolUtil.java → common-toolbox/src/main/java/com/onixbyte/common/util/BoolUtil.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.util.Arrays;
 import java.util.Objects;

devkit-utils/src/main/java/com/onixbyte/devkit/utils/BranchUtil.java → common-toolbox/src/main/java/com/onixbyte/common/util/BranchUtil.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.util.Objects;
 import java.util.function.BooleanSupplier;

devkit-utils/src/main/java/com/onixbyte/devkit/utils/CollectionUtil.java → common-toolbox/src/main/java/com/onixbyte/common/util/CollectionUtil.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.util.ArrayList;
 import java.util.Collection;

devkit-utils/src/main/java/com/onixbyte/devkit/utils/HashUtil.java → common-toolbox/src/main/java/com/onixbyte/common/util/HashUtil.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.nio.charset.Charset;
 import java.nio.charset.StandardCharsets;

devkit-utils/src/main/java/com/onixbyte/devkit/utils/MapUtil.java → common-toolbox/src/main/java/com/onixbyte/common/util/MapUtil.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.util.Map;
 

devkit-utils/src/main/java/com/onixbyte/devkit/utils/ObjectMapAdapter.java → common-toolbox/src/main/java/com/onixbyte/common/util/ObjectMapAdapter.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.util.Map;
 

devkit-utils/src/main/java/com/onixbyte/devkit/utils/RangeUtil.java → common-toolbox/src/main/java/com/onixbyte/common/util/RangeUtil.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.util.stream.IntStream;
 

devkit-utils/src/test/java/com/onixbyte/devkit/utils/AesUtilTest.java → common-toolbox/src/test/java/com/onixbyte/common/util/AesUtilTest.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import org.junit.jupiter.api.Test;
 

devkit-utils/src/test/java/com/onixbyte/devkit/utils/Base64UtilTest.java → common-toolbox/src/test/java/com/onixbyte/common/util/Base64UtilTest.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import org.junit.jupiter.api.Test;
 

devkit-utils/src/test/java/com/onixbyte/devkit/utils/BoolUtilTest.java → common-toolbox/src/test/java/com/onixbyte/common/util/BoolUtilTest.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import org.junit.jupiter.api.Test;
 

devkit-utils/src/test/java/com/onixbyte/devkit/utils/BranchUtilTest.java → common-toolbox/src/test/java/com/onixbyte/common/util/BranchUtilTest.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import org.junit.jupiter.api.Test;
 

devkit-utils/src/test/java/com/onixbyte/devkit/utils/CollectionUtilTest.java → common-toolbox/src/test/java/com/onixbyte/common/util/CollectionUtilTest.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import org.junit.jupiter.api.Test;
 

devkit-utils/src/test/java/com/onixbyte/devkit/utils/HashUtilTest.java → common-toolbox/src/test/java/com/onixbyte/common/util/HashUtilTest.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import org.junit.jupiter.api.Test;
 

devkit-utils/src/test/java/com/onixbyte/devkit/utils/RangeUtilTest.java → common-toolbox/src/test/java/com/onixbyte/common/util/RangeUtilTest.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import org.junit.jupiter.api.Test;
 

key-pair-loader/build.gradle.kts → crypto-toolbox/build.gradle.kts

@@ -68,9 +68,9 @@ tasks.test {
 
 publishing {
     publications {
-        create<MavenPublication>("keyPairLoader") {
+        create<MavenPublication>("cryptoToolbox") {
             groupId = group.toString()
-            artifactId = "key-pair-loader"
+            artifactId = "crypto-toolbox"
             version = artefactVersion
 
             pom {
@@ -87,8 +87,8 @@ publishing {
                 }
 
                 scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                     url = projectGithubUrl
                 }
 
@@ -112,7 +112,7 @@ publishing {
             from(components["java"])
 
             signing {
-                sign(publishing.publications["keyPairLoader"])
+                sign(publishing.publications["cryptoToolbox"])
             }
         }
 
@@ -127,4 +127,4 @@ publishing {
             }
         }
     }
-}
+}

crypto-toolbox/src/main/java/com/onixbyte/crypto/PrivateKeyLoader.java

@@ -0,0 +1,40 @@
+/*
+ * Copyright (C) 2024-2025 OnixByte.
+ *
+ * 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.onixbyte.crypto;
+
+import java.security.PrivateKey;
+
+/**
+ * The {@code PrivateKeyLoader} interface provides utility methods for loading keys pairs from
+ * PEM-formatted key text. This class supports loading both private and public keys.
+ *
+ * @author zihluwang
+ * @author siujamo
+ * @version 2.0.0
+ * @since 1.6.0
+ */
+public interface PrivateKeyLoader {
+
+    /**
+     * Load private key from pem-formatted key text.
+     *
+     * @param pemKeyText pem-formatted key text
+     * @return loaded private key
+     */
+    PrivateKey loadPrivateKey(String pemKeyText);
+}

crypto-toolbox/src/main/java/com/onixbyte/crypto/PublicKeyLoader.java

@@ -0,0 +1,75 @@
+/*
+ * Copyright (C) 2024-2025 OnixByte.
+ *
+ * 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.onixbyte.crypto;
+
+import com.onixbyte.crypto.exception.KeyLoadingException;
+
+import java.security.PublicKey;
+import java.security.interfaces.ECPublicKey;
+import java.security.interfaces.RSAPublicKey;
+
+/**
+ *
+ * @author siujamo
+ * @version 3.0.0
+ */
+public interface PublicKeyLoader {
+
+    /**
+     * Load public key from pem-formatted key text.
+     *
+     * @param pemKeyText pem-formatted key text
+     * @return loaded private key
+     */
+    PublicKey loadPublicKey(String pemKeyText);
+
+    /**
+     * Loads an EC public key using the provided x and y coordinates together with the curve name.
+     * <p>
+     * This default implementation throws a {@link KeyLoadingException} to signify that this key
+     * loader does not support loading an EC public key. Implementing classes are expected to
+     * override this method to supply their own loading logic.
+     *
+     * @param xHex      the hexadecimal string representing the x coordinate of the EC point
+     * @param yHex      the hexadecimal string representing the y coordinate of the EC point
+     * @param curveName the name of the elliptic curve
+     * @return the loaded {@link ECPublicKey} instance
+     * @throws KeyLoadingException if loading is not supported or fails
+     */
+    default ECPublicKey loadPublicKey(String xHex, String yHex, String curveName) {
+        throw new KeyLoadingException("This key loader does not support loading an EC public key.");
+    }
+
+    /**
+     * Loads an RSA public key using the provided modulus and exponent.
+     * <p>
+     * This default implementation throws a {@link KeyLoadingException} to signify that this key
+     * loader does not support loading an RSA public key. Implementing classes are expected to
+     * override this method to supply their own loading logic.
+     *
+     * @param modulus  the modulus value of the RSA public key, usually represented in hexadecimal
+     *                 or Base64 string format
+     * @param exponent the public exponent value of the RSA public key, usually represented in
+     *                 hexadecimal or Base64 string format
+     * @return the loaded {@link RSAPublicKey} instance
+     * @throws KeyLoadingException if loading is not supported or fails
+     */
+    default RSAPublicKey loadPublicKey(String modulus, String exponent) {
+        throw new KeyLoadingException("This key loader does not support loading an RSA public key.");
+    }
+}