/**
     * Returns the path to an alternate POM file.
     *
     * @return an {@link Optional} containing the path to the alternate POM file, or empty if not specified
     */
    @Nonnull
    Optional<String> alternatePomFile();

    /**
     * Indicates whether Maven should operate in non-recursive mode (i.e., not build child modules).
     *

    }

    /**
     * Reads an unsigned byte value.
     * @return the unsigned byte value as an integer
     * @throws IOException if an I/O error occurs
     */
    public int readUnsignedByte() throws IOException {
        return readByte() & 0xff;
    }

    /**
     * Reads an unsigned 32-bit integer value.
     * @return the unsigned integer value as a long

    /**
     * Creates an {@link java.io.OutputStream} for writing to a file
     * on an SMB server addressed by the URL parameter. See {@link
     * jcifs.smb1.smb1.SmbFile} for a detailed description and examples of
     * the smb URL syntax.
     *
     * @param url An smb URL string representing the file to write to
     * @throws SmbException if an SMB error occurs

    /** The line that has been read */
    protected String line = EMPTY;

    /**
     * Returns an {@link Iterable} that wraps a {@link LineIterator} for use in enhanced for-loops.
     *
     * @param reader
     *            The {@link Reader} to read strings from. Must not be {@literal null}.
     * @return An {@link Iterable} that wraps a {@link LineIterator}.
     */

## An app with callbacks { #an-app-with-callbacks }

Let's see all this with an example.

Imagine you develop an app that allows creating invoices.

These invoices will have an `id`, `title` (optional), `customer`, and `total`.

The user of your API (an external developer) will create an invoice in your API with a POST request.

Then your API will (let's imagine):

    protected final boolean includeObject;

    /**
     * Returns an {@link Iterable} that wraps a {@link ClassIterator} for use in a for-each statement.
     *
     * @param clazz the class (must not be {@literal null})
     * @return an {@link Iterable} wrapping a {@link ClassIterator}
     */
    public static Iterable<Class<?>> iterable(final Class<?> clazz) {

import java.util.Iterator;
import java.util.NoSuchElementException;

import org.codelibs.core.exception.ClUnsupportedOperationException;

/**
 * Adaptor that makes an array into an {@link Iterator}.
 * <p>
 * Usage example:
 * </p>
 *
 * <pre>
 * import static org.codelibs.core.collection.ArrayIterator.*;
 *
 * String[] array = ...;
 * for (String element : iterable(array)) {

    /**
     * Sets a converter for dates.
     *
     * @param pattern
     *            The date pattern. Must not be {@literal null} or an empty string.
     * @param propertyNames
     *            The property names to which this converter will be applied. Each element must not be {@literal null} or an empty string.
     * @return This instance itself
     * @see DateConverter
     */

    }

    /**
     * Returns <code>true</code> if the class loader <code>other</code> is an ancestor of the class loader <code>cl</code>.
     *
     * @param cl
     *            the class loader
     * @param other
     *            the class loader to check as ancestor
     * @return <code>true</code> if <code>other</code> is an ancestor of <code>cl</code>
     */

But because of our changes in `GzipRequest.body`, the request body will be automatically decompressed when it is loaded by **FastAPI** when needed.

## Accessing the request body in an exception handler { #accessing-the-request-body-in-an-exception-handler }

/// tip