}

    /**
     * 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

        log(Level.DEBUG, message, error);
    }

    /**
     * Logs an info message without an associated exception.
     *
     * @param message the info message to be logged
     */
    default void info(@Nonnull String message) {
        log(Level.INFO, message);
    }

    /**
     * Logs an info message with an associated exception.
     *
     * @param message the info message to be logged

    /**
     * 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

## 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):

    /**
     * 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

            !item.equals(item.toString()));
      }
    }
  }

  /**
   * Class used to test whether equals() correctly handles an instance of an incompatible class.
   * Since it is a private inner class, the invoker can never pass in an instance to the tester
   */
  private enum NotAnInstance {
    EQUAL_TO_NOTHING;
  }

// SASLprep fails, the method returns an error.
func (x *XDGSCRAMClient) Begin(userName, password, authzID string) (err error) {
	x.Client, err = x.NewClient(userName, password, authzID)
	if err != nil {
		return err
	}
	x.ClientConversation = x.NewConversation()
	return nil
}

// Step takes a string provided from a server (or just an empty string for the

 * </ul>
 *
 * <p>When an instance of ContentCache is created with a byte array, the content is cached in memory.
 * When an instance is created with a File object, the content is cached in the specified file.
 *
 * <p>The {@code close()} method deletes the file if the content is cached in a file.
 *
 * <p>The {@code getInputStream()} method provides an InputStream to read the cached content.