*
     * @param file The file, must not be {@code null}.
     * @deprecated Use {@link #FileSource(Path)} instead.
     */
    @Deprecated
    public FileSource(File file) {
        this(Objects.requireNonNull(file, "file cannot be null").toPath());
    }

    /**
     * Creates a new source backed by the specified file.
     *
     * @param path The file, must not be {@code null}.

     */
    public SmbAuthenticationHolder() {
        super();
    }

    /**
     * Adds an SMB authentication configuration to the holder.
     *
     * @param auth the SMB authentication configuration to add
     */
    public void add(final SmbAuthentication auth) {
        authMap.put(auth.getPathPrefix(), auth);
    }

    /**

    public CrawlJob() {
        super();
    }

    /**
     * Sets the namespace for the crawling session.
     * The namespace is used to organize and identify crawling activities.
     *
     * @param namespace the namespace identifier for the crawling session
     * @return this CrawlJob instance for method chaining
     */
    public CrawlJob namespace(final String namespace) {
        this.namespace = namespace;

import java.util.Map;
import java.util.Set;
import org.jspecify.annotations.Nullable;

/**
 * A base implementation of {@link NetworkConnections} for undirected networks.
 *
 * @author James Sexton
 * @param <N> Node parameter type
 * @param <E> Edge parameter type
 */
abstract class AbstractUndirectedNetworkConnections<N, E> implements NetworkConnections<N, E> {
  /** Keys are edges incident to the origin node, values are the node at the other end. */

     * filtering there (although attributes are largely ignored by servers
     * they are filtered locally by the default accept method).
     *
     * @param wildcard the wildcard pattern for matching file names (e.g., "*.txt")
     * @param attributes the DOS file attributes to match (e.g., ATTR_DIRECTORY)
     */
    public DosFileFilter(final String wildcard, final int attributes) {
        this.wildcard = wildcard;

Por exemplo para declarar um valor de metadado `title` para o parâmetro de rota `item_id` você pode digitar:

{* ../../docs_src/path_params_numeric_validations/tutorial001_py310.py hl[8] *}

/// note | Nota

Um parâmetro de rota é sempre obrigatório, como se fizesse parte da rota.

Então, você deve declará-lo com `...` para marcá-lo como obrigatório.

    private final String[] values;

    /**
     * Constructs a new RequestParameter with the specified name and values.
     *
     * @param name the name of the parameter, must not be null
     * @param values the array of values for this parameter, can be null or empty
     */
    public RequestParameter(final String name, final String[] values) {
        this.name = name;

import java.util.List;
import java.util.SortedSet;
import org.junit.Ignore;

/**
 * Testers for {@link SortedSetMultimap#asMap}.
 *
 * @author Louis Wasserman
 * @param <K> The key type of the tested multimap.
 * @param <V> The value type of the tested multimap.
 */
@GwtCompatible
@Ignore("test runners must not instantiate and run this directly, only via suites we build")

 */
public class SmbComDeleteDirectory extends ServerMessageBlock {

    /**
     * Creates a new SMB1 delete directory request.
     *
     * @param config the CIFS configuration
     * @param path the path of the directory to delete
     */
    public SmbComDeleteDirectory(final Configuration config, final String path) {
        super(config, SMB_COM_DELETE_DIRECTORY, path);
    }

    private Credentials creds;

    /**
     * Constructs a CIFS context wrapper with custom credentials.
     *
     * @param delegate the context to wrap
     * @param creds
     *            Credentials to use
     */
    public CIFSContextCredentialWrapper(final AbstractCIFSContext delegate, final Credentials creds) {
        super(delegate);