* be used to decide whether to apply a test to a given class-under-test.
 *
 * <p>This is needed because annotations can't implement interfaces, which is also why reflection is
 * used to extract values from the properties of the various annotations.
 *
 * @author George van den Driessche
 */
@Target(value = {ElementType.ANNOTATION_TYPE})
@Retention(value = RetentionPolicy.RUNTIME)
@Documented
@GwtCompatible

         * This constructor parses the URL to extract bucket and object names.
         *
         * @param url The storage URL to connect to
         */
        protected StorageURLConnection(final URL url) {
            super(url);
            // Extract bucket name from host
            bucketName = url.getHost() != null ? url.getHost() : StringUtil.EMPTY;

      try {
        return extract();
      } finally {
        monitor.leave();
      }
    } else {
      return null;
    }
  }

  @CanIgnoreReturnValue
  @Override
  public E take() throws InterruptedException {
    Monitor monitor = this.monitor;
    monitor.enterWhen(notEmpty);
    try {
      return extract();
    } finally {
      monitor.leave();
    }

import org.codelibs.fess.crawler.exception.ExtractException;

import com.google.common.base.Charsets;

import jakarta.annotation.PostConstruct;
import jakarta.annotation.PreDestroy;

/**
 * Extract a text by using external http server.
 */
public class ApiExtractor extends AbstractExtractor {

    private static final Logger logger = LogManager.getLogger(ApiExtractor.class);

    /** The URL of the API endpoint. */

     * Extracts URLs from HTML tag attributes using XPath.
     *
     * @param url the base URL for resolving relative URLs
     * @param document the document to extract URLs from
     * @param xpath the XPath expression to select elements
     * @param attr the attribute name to extract URLs from
     * @param encoding the character encoding to use
     * @return a list of extracted URLs

     */
    @Override
    public ExtractData getText(final InputStream in, final Map<String, String> params) {
        if (in == null) {
            throw new CrawlerSystemException("Microsoft Visio input stream is null. Cannot extract text from null input.");
        }
        try {
            @SuppressWarnings("resource")
            final VisioTextExtractor visioTextExtractor = new VisioTextExtractor(in);

            assertTrue("Error message should mention ZIP archive", e.getMessage().contains("ZIP archive"));
            assertTrue("Error message should indicate failure",
                    e.getMessage().contains("Failed to extract") || e.getMessage().contains("No entries could be processed"));
        }
    }

    /**
     * Test that TarExtractor handles invalid archive gracefully.

                        } catch (final Exception e) {
                            failedEntries++;
                            if (logger.isDebugEnabled()) {
                                logger.debug("Failed to extract content from archive entry: {}", filename, e);
                            }
                        }
                    }
                }
            }
        } catch (final MaxLengthExceededException e) {

    }

    /**
     * Gets a typed value from a document map with a default value.
     *
     * @param <T> the type to convert the value to
     * @param doc the document map to extract the value from
     * @param key the key to look up in the document map
     * @param clazz the class type to convert the value to
     * @param defaultValue the default value to return if the key is not found or conversion fails

Declare the **query parameters** that you need in a **Pydantic model**, and then declare the parameter as `Query`:

{* ../../docs_src/query_param_models/tutorial001_an_py310.py hl[9:13,17] *}

**FastAPI** will **extract** the data for **each field** from the **query parameters** in the request and give you the Pydantic model you defined.

## Check the Docs { #check-the-docs }

You can see the query parameters in the docs UI at `/docs`: