Java/Spring URI 처리 완벽 가이드: RFC 표준부터 실무 함정까지

// Java
String encoded = URLEncoder.encode("hello world", StandardCharsets.UTF_8);
System.out.println(encoded); // 출력: hello+world

// JavaScript
const encoded = encodeURIComponent("hello world");
console.log(encoded); // 출력: hello%20world

// Backend - 캐시 키 생성
String cacheKey = "search:" + URLEncoder.encode("안녕 하세요", UTF_8);
// 결과: search:안녕+하세요

// Frontend - 캐시 조회 요청
const cacheKey = "search:" + encodeURIComponent("안녕 하세요");
// 결과: search:안녕%20하세요

URI uri = new URI("myapp://user_profile?version=1.0");
System.out.println(uri.getHost()); // 출력: null ❌

// ✅ 정상: 언더스코어 없음
new URI("myapp://userprofile?version=1.0").getHost();   // "userprofile"

// ❌ 문제: 언더스코어 포함
new URI("myapp://user_profile?version=1.0").getHost();  // null

URI uri = new URI("myapp://user_profile?version=1.0");
uri.getHost();       // null
uri.getAuthority();  // "user_profile" ✅
uri.toString();      // "myapp://user_profile?version=1.0" ✅

// URL에서 특정 파라미터를 제거하는 확장함수
private fun String.removeDebugParameter(): String = 
    UriComponentsBuilder.fromUri(URI(this))  // ⚠️ 여기가 문제!
        .replaceQueryParam("debug", null)
        .build()
        .toUriString()

// 테스트
"myapp://home?debug=true&version=1.0".removeDebugParameter()
// 기대: myapp://home?version=1.0
// 실제: myapp://home?version=1.0 ✅

"myapp://user_profile?debug=true&version=1.0".removeDebugParameter()
// 기대: myapp://user_profile?version=1.0
// 실제: myapp://?version=1.0 ❌ (host가 사라짐!)

// UriComponentsBuilder.uri() 메서드 내부
public UriComponentsBuilder uri(URI uri) {
    this.host = uri.getHost();  // null이 반환됨!
    // uri.getAuthority()는 참조하지 않음
    ...
}

public class URIEncoder {
    
    /**
     * JavaScript의 encodeURIComponent와 동일하게 동작하는 인코딩.
     */
    public static String encodeURIComponent(String value) {
        if (value == null) return null;
        
        return URLEncoder.encode(value, StandardCharsets.UTF_8)
                .replace("+", "%20")   // 공백
                .replace("%7E", "~")   // 틸드
                .replace("%21", "!")   // 느낌표
                .replace("%27", "'")   // 작은따옴표
                .replace("%28", "(")   // 여는 괄호
                .replace("%29", ")");  // 닫는 괄호
    }
}

// ❌ 위험: java.net.URI를 경유하면 정보 누락 가능
UriComponentsBuilder.fromUri(new URI(urlString))  

// ✅ 권장: 문자열을 직접 파싱 (RFC 3986 정규식 사용)
UriComponentsBuilder.fromUriString(urlString)

// 쿼리 파라미터 추가
String url = UriComponentsBuilder.fromUriString("https://api.example.com/search")
        .queryParam("q", "hello world")        // 자동으로 %20 인코딩
        .queryParam("name", "홍길동")           // 한글 자동 인코딩
        .build()
        .toUriString();
// 결과: https://api.example.com/search?q=hello%20world&name=%ED%99%8D%EA%B8%B8%EB%8F%99

URI uri = new URI("myapp://user_profile?version=1.0");

// 방어적 코딩
String host = uri.getHost();
if (host == null) {
    host = uri.getAuthority();  // fallback
}

// 방법 1: 수동 치환
function encodeFormData(value) {
    return encodeURIComponent(value).replace(/%20/g, '+');
}

// 방법 2: URLSearchParams 사용
const params = new URLSearchParams();
params.append('message', 'hello world');
console.log(params.toString()); // message=hello+world

// ❌ 잘못된 예: 이미 인코딩된 문자열을 다시 인코딩
String alreadyEncoded = "hello%20world";
URLEncoder.encode(alreadyEncoded, UTF_8); // "hello%2520world" (% → %25)

// 딥링크 생성 예시
String innerUrl = "https://site.com/search?q=" + URIEncoder.encodeURIComponent("hello world");
// 결과: "https://site.com/search?q=hello%20world"

String deepLink = "myapp://webview?link=" + URIEncoder.encodeURIComponent(innerUrl);
// 결과: "myapp://webview?link=https%3A%2F%2Fsite.com%2Fsearch%3Fq%3Dhello%2520world"
//                                                               ↑ %20 → %2520

// Java URLDecoder: '+'를 공백으로 해석
URLDecoder.decode("hello+world", UTF_8);   // "hello world" ✅
URLDecoder.decode("hello%20world", UTF_8); // "hello world" ✅

// JavaScript decodeURIComponent: '+'를 그대로 유지
decodeURIComponent("hello+world");   // "hello+world" ⚠️
decodeURIComponent("hello%20world"); // "hello world" ✅

// ✅ 이것만 기억하세요
UriComponentsBuilder.fromUriString(url)  // java.net.URI를 거치지 않음!
        .queryParam("key", "value")
        .build()
        .toUriString();