/**
 * A utility class for building query strings with proper escaping and parameters.
 * This class provides methods to construct search queries from various parameters,
 * handle special characters, and format the final query string for search operations.
 */
public class QueryStringBuilder {

    private static final String OR_ALT = " || ";

    private static final String OR = " OR ";

      Set<Feature<?>> newFeatures,
      Object source)
      throws ConflictingRequirementsException {
    if (!disjoint(newFeatures, earlierFeatures)) {
      throw new ConflictingRequirementsException(
          String.format(
              Locale.ROOT,
              "Annotation requires to be %s features that earlier "
                  + "annotations required to be %s.",
              newRequirement,
              earlierRequirement),

        // Should be valid base64
        assertTrue(encryptedStr.matches("^[A-Za-z0-9+/]*={0,2}$"), "Should be valid Base64 format");

        // Decrypt from string
        char[] decrypted = storage.decryptFromString(encryptedStr);
        assertArrayEquals(plaintext, decrypted, "Decrypted string should match original");

        // Clean up

 */
package org.codelibs.fess.app.service;

import java.nio.charset.StandardCharsets;
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.ZoneOffset;
import java.time.format.DateTimeFormatter;
import java.util.Base64;
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.stream.Collectors;

Você o coloca em cima de uma função. Como um chapéu decorativo (acho que é daí que vem o termo).

Um "decorador" pega a função abaixo e faz algo com ela.

Em nosso caso, este decorador informa ao **FastAPI** que a função abaixo corresponde a **rota** `/` com uma **operação** `get`.

É o "**decorador de rota**".

///

Você também pode usar as outras operações:

* `@app.post()`
* `@app.put()`

          }
          else -> throw AssertionError("unsupported hashAlgorithm: ${pin.hashAlgorithm}")
        }
      }
    }

    // If we couldn't find a matching pin, format a nice exception.
    val message =
      buildString {
        append("Certificate pinning failure!")
        append("\n  Peer certificate chain:")
        for (element in peerCertificates) {

            // This test verifies the actual behavior
            assertThrows(NullPointerException.class, () -> notification.toString());
        }

        @ParameterizedTest
        @DisplayName("Should format different oplock levels correctly")
        @CsvSource({ "0, 0", "1, 1", "2, 2", "8, 8", "255, -1" // byte 255 is -1 when printed as signed
        })

            }
        }, "keyMatchHelper");

        // Execute without setting session ID
        String result = crawlJob.execute();

        assertNotNull(crawlJob.sessionId);
        // Check format: yyyyMMddHHmmss
        assertEquals(14, crawlJob.sessionId.length());
        assertTrue(crawlJob.sessionId.matches("\\d{14}"));
        assertTrue(result.contains("Session Id: " + crawlJob.sessionId));
    }

            }
        });
    }

    /**
     * Creates an edit body from an elevate word entity for API responses.
     * Processes permissions and converts them to a readable format.
     *
     * @param entity the elevate word entity to convert
     * @return edit body containing the entity data
     */
    protected EditBody createEditBody(final ElevateWord entity) {

        int expectedRawSize = Smb2Constants.SMB2_HEADER_LENGTH + 32 + 64;
        int expectedSize = (expectedRawSize + 7) & ~7;
        assertEquals(expectedSize, size);

        // Test wire format writing
        byte[] buffer = new byte[512];
        int bytesWritten = request.writeBytesWireFormat(buffer, 64);

        // Verify all fields in the buffer