return asJson(new ApiDocsResponse().renderData(renderData).status(Status.OK).result());
        } catch (final InvalidQueryException e) {
            if (logger.isDebugEnabled()) {
                logger.debug("Invalid query: {}", body.q, e);
            }
            throwValidationErrorApi(e.getMessageCode());
        } catch (final ResultOffsetExceededException e) {
            if (logger.isDebugEnabled()) {

    // thread because the task will block on the task latch after unblocking
    // the run latch.
    exec.execute(task);
    runLatch.await();
    assertEquals(1, listenerLatch.getCount());
    assertFalse(task.isDone());
    assertFalse(task.isCancelled());

    // Finish the task by unblocking the task latch.  Then wait for the
    // listener to be called by blocking on the listener latch.
    taskLatch.countDown();

                try {
                    trans.ensureConnected();
                } catch (final IOException e) {
                    removeTransport(trans);
                    throw e;
                }
                return trans.acquire();
            } catch (final IOException e) {
                final String hostAddress = addr.getHostAddress();

                logger.info("Backup file uploaded successfully and queued for import: fileName={}, tempFile={}", fileName,
                        tempFile.getAbsolutePath());
            }
        } catch (final IOException e) {
            logger.warn("Failed to upload backup file: fileName={}, error={}", fileName, e.getMessage(), e);
            if (tempFile.exists() && !tempFile.delete()) {

    try {
      getMap().replace(k3(), null);
    } catch (NullPointerException tolerated) {
      // permitted not to throw because it would be a no-op
    }
    expectUnchanged();
  }

  @MapFeature.Require(value = SUPPORTS_PUT, absent = ALLOWS_NULL_KEY_QUERIES)
  public void testReplace_absentNullKeyUnsupported() {
    try {
      getMap().replace(null, v3());
    } catch (NullPointerException tolerated) {

        try {
            final URLConnection connection = url.openConnection();
            connection.setUseCaches(false);
            return connection.getInputStream();
        } catch (final IOException e) {
            throw new IORuntimeException(e);
        }
    }

    /**
     * Returns a {@link URLConnection} object that represents a connection to the remote object referred to by the URL.

## Atualizações parciais com `PATCH` { #partial-updates-with-patch }

Você também pode usar a operação <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PATCH" class="external-link" target="_blank">HTTP `PATCH`</a> para atualizar parcialmente os dados.

Isso significa que você pode enviar apenas os dados que deseja atualizar, deixando o restante intacto.

/// note | Nota

            fail("Expected CrawlerSystemException");
        } catch (final CrawlerSystemException e) {
            // Verify it's exactly CrawlerSystemException, not a subclass
            assertEquals("Should throw CrawlerSystemException", CrawlerSystemException.class, e.getClass());
        } catch (final Exception e) {
            fail("Should throw CrawlerSystemException, not " + e.getClass().getName());

        } catch (final IOException ioe) {
            log.warn("sendrecv failed", ioe);
            try {
                disconnect(true);
            } catch (final IOException ioe2) {
                ioe.addSuppressed(ioe2);
                log.info("disconnect failed", ioe2);
            }
            throw ioe;
        } catch (final InterruptedException ie) {

     *
     * @param <REQ> The type of the request
     * @param <REP> The type of the response
     * @param message The error message describing the batch operation failure
     * @param allResults List of results from all attempted requests in the batch
     */
    public <REQ extends Request<?>, REP extends Result<REQ>> BatchRequestException(
            String message, List<RequestResult<REQ, REP>> allResults) {