java 19 lines · 5 steps

Building URIs safely with UriComponentsBuilder in Spring

How Spring's fluent builder assembles an encoded search URL from query, paging, and optional parameters.

Explained by highlit

Spring Intermediate url-building builder-pattern encoding optional query-parameters

1public URI buildSearchUri(String query, int page, int size, List<String> tags) {
  UriComponentsBuilder builder = UriComponentsBuilder
          .fromUriString("https://api.example.com")
          .path("/v2/products/search")
          .queryParam("q", query)
          .queryParam("page", page)
          .queryParam("size", size)
          .queryParam("sort", "relevance,desc");
9 
  if (tags != null && !tags.isEmpty()) {
      builder.queryParam("tag", tags.toArray());
  }
13 
  return builder
          .queryParamIfPresent("currency", Optional.ofNullable(defaultCurrency))
          .encode(StandardCharsets.UTF_8)
          .build()
          .toUri();
19}

01 / 01

STEP 01

Walkthrough

Space play ←→ step click any line

Three takeaways

1A fluent builder lets you compose a URL declaratively instead of concatenating fragile strings.
2Encoding once at build time via encode() prevents malformed URLs from unescaped user input.
3queryParamIfPresent and Optional express conditional parameters without scattering null checks.

Related explainers

java

@Component
@Converter
public class EncryptedStringConverter implements AttributeConverter<String, String> {

Transparent column encryption in Spring & JPA

encryption aes-gcm jpa-converter

Advanced 10 steps

java

package com.acme.billing.config;
 
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.boot.context.properties.ConfigurationProperties;

Feature-flagged beans with Spring @ConditionalOnProperty

feature-flags conditional-beans strategy-pattern

Intermediate 5 steps

java

public static Map<String, String> parseCookieHeader(String header) {
    Map<String, String> cookies = new LinkedHashMap<>();
    if (header == null || header.isBlank()) {
        return cookies;

Parsing an HTTP Cookie header in Java

string-parsing http url-decoding

Intermediate 6 steps

java

public class TimedSocketReader {
 
    private static final int READ_TIMEOUT_MS = 5_000;
    private static final int CONNECT_TIMEOUT_MS = 3_000;

Reading a socket with connect and read timeouts

sockets timeouts io

Intermediate 8 steps

java

public final class EncodingDetector {
 
    public enum Encoding {
        UTF_8, UTF_16LE, UTF_16BE, UTF_32LE, UTF_32BE, ASCII, UNKNOWN

Detecting text encoding from raw bytes in Java

byte-manipulation encoding-detection bitwise-operations

Intermediate 8 steps

java

public final class ImportOrganizer {
 
    private static final Pattern IMPORT_LINE =
            Pattern.compile("^import\\s+(static\\s+)?([\\w.]+(?:\\.\\*)?)\\s*;\\s*$");