feat: add null checks to FriendlyIds utility methods

Author: mariuszs

friendly-id-openfeign/src/test/java/com/devskiller/friendly_id/openfeign/FriendlyIdEncoderTest.java

@@ -21,9 +21,8 @@ void shouldEncodeUuidAsFriendlyId() {
 		String expectedFriendlyId = toFriendlyId(uuid);
 
 		String[] capturedValue = new String[1];
-		Encoder delegateEncoder = (object, bodyType, template) -> {
-			capturedValue[0] = (String) object;
-		};
+		Encoder delegateEncoder = (object, bodyType, template)
+				-> capturedValue[0] = (String) object;
 		FriendlyIdEncoder encoder = new FriendlyIdEncoder(delegateEncoder);
 		RequestTemplate template = new RequestTemplate();
 
@@ -42,9 +41,8 @@ void shouldEncodeFriendlyIdValueObjectAsString() {
 		String expectedString = friendlyId.toString();
 
 		String[] capturedValue = new String[1];
-		Encoder delegateEncoder = (object, bodyType, template) -> {
-			capturedValue[0] = (String) object;
-		};
+		Encoder delegateEncoder = (object, bodyType, template)
+				-> capturedValue[0] = (String) object;
 		FriendlyIdEncoder encoder = new FriendlyIdEncoder(delegateEncoder);
 		RequestTemplate template = new RequestTemplate();
 
@@ -61,9 +59,8 @@ void shouldDelegateOtherTypes() {
 		String regularString = "test";
 
 		String[] capturedValue = new String[1];
-		Encoder delegateEncoder = (object, bodyType, template) -> {
-			capturedValue[0] = (String) object;
-		};
+		Encoder delegateEncoder = (object, bodyType, template)
+				-> capturedValue[0] = (String) object;
 		FriendlyIdEncoder encoder = new FriendlyIdEncoder(delegateEncoder);
 		RequestTemplate template = new RequestTemplate();
 

friendly-id-samples/friendly-id-contracts/src/main/java/com/devskiller/friendly_id/sample/contracts/SecurityConfig.java

@@ -4,6 +4,7 @@
 import org.springframework.context.annotation.Configuration;
 import org.springframework.security.config.annotation.web.builders.HttpSecurity;
 import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
+import org.springframework.security.config.annotation.web.configurers.AbstractHttpConfigurer;
 import org.springframework.security.web.SecurityFilterChain;
 
 @Configuration
@@ -18,7 +19,7 @@ SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
 						.requestMatchers(org.springframework.http.HttpMethod.POST, "/items").authenticated()
 						.anyRequest().permitAll()
 				)
-				.csrf(csrf -> csrf.disable())
+				.csrf(AbstractHttpConfigurer::disable)
 				.httpBasic(basic -> {})
 				.build();
 	}

friendly-id-samples/friendly-id-spring-boot-jpa-demo/src/main/java/com/devskiller/friendly_id/sample/jpa/FriendlyIdJpaDemoApplication.java

@@ -73,23 +73,23 @@ public CommandLineRunner initData(ProductRepository repository) {
 			repository.save(keyboard);
 			System.out.println("Created product: Mechanical Keyboard with ID: " + keyboard.getId());
 
-			System.out.println("""
-
+			System.out.printf("""
+					
 					========================================
 					Demo ready!
 					========================================
 					REST API: http://localhost:8080/api/products
 					H2 Console: http://localhost:8080/h2-console
-					  JDBC URL: jdbc:h2:mem:friendlyid_demo
-					  Username: sa
-					  Password: (empty)
+					JDBC URL: jdbc:h2:mem:friendlyid_demo
+					Username: sa
+					Password: (empty)
 					========================================
-
+					
 					Try these commands:
-					  curl http://localhost:8080/api/products
-					  curl http://localhost:8080/api/products/%s
-
-					""".formatted(laptop.getId()));
+					curl http://localhost:8080/api/products
+					curl http://localhost:8080/api/products/%s
+					
+					%n""", laptop.getId());
 		};
 	}
 }

friendly-id/src/main/java/com/devskiller/friendly_id/FriendlyIds.java

@@ -1,5 +1,6 @@
 package com.devskiller.friendly_id;
 
+import java.util.Objects;
 import java.util.UUID;
 
 /**
@@ -42,10 +43,12 @@ public static String createFriendlyId() {
 	/**
 	 * Encodes a UUID to FriendlyId string.
 	 *
-	 * @param uuid UUID to be encoded
+	 * @param uuid UUID to be encoded, must not be null
 	 * @return FriendlyId encoded UUID
+	 * @throws NullPointerException if uuid is null
 	 */
 	public static String toFriendlyId(UUID uuid) {
+		Objects.requireNonNull(uuid, "UUID cannot be null");
 		return Url62.encode(uuid);
 	}
 
@@ -58,11 +61,13 @@ public static String toFriendlyId(UUID uuid) {
 	 *   <li>FriendlyId format (up to 22 chars): decoded from Base62</li>
 	 * </ul>
 	 *
-	 * @param value UUID or FriendlyId string
+	 * @param value UUID or FriendlyId string, must not be null
 	 * @return parsed UUID
+	 * @throws NullPointerException if value is null
 	 * @throws IllegalArgumentException if value is not a valid UUID or FriendlyId
 	 */
 	public static UUID toUuid(String value) {
+		Objects.requireNonNull(value, "Value cannot be null");
 		if (isStandardUuidFormat(value)) {
 			return UUID.fromString(value);
 		}