Для чего нужен Base64?

# Base64: назначение и практическое применение

Base64 — это алгоритм кодирования, который преобразует бинарные данные в текстовый формат, используя только 64 "безопасных" символа (A-Z, a-z, 0-9, +, /). Это необходимо, когда нужно передать бинарные данные через системы, которые работают только с текстом.

Почему Base64 нужен?

Проблема: бинарные данные и текстовые протоколы

Представь, что ты хочешь передать изображение через email или HTTP:

Исходное изображение (бинарное):
FF D8 FF E0 00 10 4A 46 49 46 00 01 01 00 00 01 00 01 00 00

Email протокол работает с ASCII текстом. Если передать бинарные байты напрямую, они могут быть интерпретированы как управляющие команды, и данные повредятся.

Base64 решает эту проблему — кодирует бинарные данные в безопасный текстовый формат.

Применение в Java

1. Кодирование и декодирование

import java.util.Base64;

public class Base64Example {
  
  // Кодирование
  public static void encode() {
    String original = "Hello, World!";
    String encoded = Base64.getEncoder().encodeToString(original.getBytes());
    System.out.println(encoded); // SGVsbG8sIFdvcmxkIQ==
  }
  
  // Декодирование
  public static void decode() {
    String encoded = "SGVsbG8sIFdvcmxkIQ==";
    String decoded = new String(Base64.getDecoder().decode(encoded));
    System.out.println(decoded); // Hello, World!
  }
}

2. Практическое применение: передача файлов в API

Когда нужно передать файл через JSON, его кодируют в Base64:

@RestController
public class FileController {
  
  @PostMapping("/upload")
  public ResponseEntity<?> uploadFile(
      @RequestParam String fileName,
      @RequestParam String fileContentBase64) {
    
    byte[] decodedFile = Base64.getDecoder().decode(fileContentBase64);
    Files.write(Paths.get("/uploads/" + fileName), decodedFile);
    
    return ResponseEntity.ok("File uploaded");
  }
}

Клиент:

public void sendFile(File file) {
  byte[] fileContent = Files.readAllBytes(file.toPath());
  String encoded = Base64.getEncoder().encodeToString(fileContent);
  
  Map<String, String> payload = Map.of(
    "fileName", file.getName(),
    "fileContentBase64", encoded
  );
  
  // POST в API
  restTemplate.postForObject("/api/upload", payload, String.class);
}

3. URL-Safe Base64

Стандартный Base64 использует + и /, которые имеют специальное значение в URL. Для URL нужен URL-safe вариант:

public class UrlSafeBase64Example {
  
  public static void example() {
    String original = "key=value&token=abc123+/";
    
    // Стандартный Base64
    String standard = Base64.getEncoder().encodeToString(original.getBytes());
    System.out.println(standard); // a2V5PXZhbHVlJnRva2VuPWFiYzEyMysvLw==
    
    // URL-Safe Base64 (+ становится -, / становится _)
    String urlSafe = Base64.getUrlEncoder().encodeToString(original.getBytes());
    System.out.println(urlSafe); // a2V5PXZhbHVlJnRva2VuPWFiYzEyMy1fLw==
  }
}

4. Аутентификация: Basic Auth

HTTP Basic Authentication использует Base64 для кодирования credentials:

@RestTemplate
public class BasicAuthExample {
  
  public static void main(String[] args) {
    String username = "user";
    String password = "pass";
    
    // Кодируем "user:pass"
    String credentials = username + ":" + password;
    String encoded = Base64.getEncoder()
      .encodeToString(credentials.getBytes());
    
    System.out.println(encoded); // dXNlcjpwYXNz
    
    // Отправляем в заголовке
    HttpHeaders headers = new HttpHeaders();
    headers.set("Authorization", "Basic " + encoded);
    // Сервер декодирует и проверяет credentials
  }
}

На сервере:

@RestController
public class SecureController {
  
  @GetMapping("/secure")
  public ResponseEntity<?> secureEndpoint(
      @RequestHeader("Authorization") String authHeader) {
    
    if (authHeader != null && authHeader.startsWith("Basic ")) {
      String encoded = authHeader.substring(6);
      String decoded = new String(Base64.getDecoder().decode(encoded));
      String[] parts = decoded.split(":");
      String username = parts[0];
      String password = parts[1];
      
      // Проверь credentials
      if (validateCredentials(username, password)) {
        return ResponseEntity.ok("Authenticated");
      }
    }
    
    return ResponseEntity.status(401).build();
  }
}

5. JWT (JSON Web Tokens)

JWT состоит из трёх частей, разделённых точками, каждая закодирована в Base64:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.
eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.
SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Декодируем вторую часть (payload):

public class JwtExample {
  
  public static void decode() {
    String jwt = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...";
    String[] parts = jwt.split("\\.");
    
    String payload = new String(Base64.getDecoder().decode(parts[1]));
    System.out.println(payload); 
    // {"sub":"1234567890","name":"John Doe","iat":1516239022}
  }
}

6. Передача бинарных данных в XML/JSON

@Data
public class DocumentDto {
  private String name;
  private String contentBase64; // Документ в Base64
}

@Service
public class DocumentService {
  
  public DocumentDto getDocument(Long id) {
    Document doc = documentRepository.findById(id).orElseThrow();
    
    DocumentDto dto = new DocumentDto();
    dto.setName(doc.getName());
    // Кодируем бинарное содержимое в Base64
    dto.setContentBase64(
      Base64.getEncoder().encodeToString(doc.getContent())
    );
    
    return dto;
  }
}

Когда использовать Base64

✓ Передача файлов через JSON/REST API ✓ HTTP Basic Authentication ✓ JWT токены ✓ Встраивание изображений в Data URLs ✓ Передача бинарных данных через текстовые протоколы (email, SMTP) ✓ URL-safe кодирование параметров

✗ Для шифрования (Base64 — это кодирование, не шифрование!) ✗ Для компрессии (размер увеличивается на 33%) ✗ Когда можно передать файл напрямую (это неэффективно)

Важное: Base64 не безопасен!

// НЕПРАВИЛЬНО: думать, что Base64 шифрует
String secret = "my-password";
String encoded = Base64.getEncoder().encodeToString(secret.getBytes());
// Это просто кодирование, любой может легко декодировать!

// ПРАВИЛЬНО: для безопасности используй шифрование
String encrypted = encryptWithAES(secret);

Итог

Base64 — это вспомогательный инструмент для преобразования бинарных данных в текстовый формат, совместимый с текстовыми протоколами. Это не шифрование и не компрессия. Java предоставляет встроенный java.util.Base64 для кодирования и декодирования. Использование Base64 критично для HTTP Basic Auth, JWT, передачи файлов через REST API и других сценариев, где нужно безопасно передать бинарные данные через текстовые протоколы.