import org.apache.maven.settings.Settings;
import org.apache.maven.settings.building.SettingsProblemCollector;

/**
 * Validate a model settings
 *
 * @deprecated since 4.0.0, use {@code org.apache.maven.impl.DefaultSettingsValidator} instead
 */
@Deprecated(since = "4.0.0")
public interface SettingsValidator {

    /**
     * Validate the specified settings.
     *

import org.apache.maven.toolchain.model.PersistedToolchains;

/**
 * Handles serialization of toolchains into some kind of textual format like XML.
 *
 * @deprecated since 4.0.0, use {@code org.apache.maven.api.services.xml.ToolchainsXmlFactory} instead
 */
@Deprecated(since = "4.0.0")
public interface ToolchainsWriter {

    /**

 * i.e. <code>reportPlugins</code> and <code>outputDirectory</code> parameters.
 *
 * @deprecated since maven 4.0, this interface is not used anymore and is only here for compatibility
 */
@Deprecated
public interface ReportingConverter {

    /**
     * Converts values from model's reporting section into the configuration for Maven Site Plugin 3.x.
     *

 * explicitly order implementations using Sisu priorities.
 *
 * @since 4.0.0
 * @deprecated since 4.0.0, use {@code maven-api-impl} jar instead
 */
@Deprecated(since = "4.0.0")
public interface MavenArtifactRelocationSource {
    /**
     * Returns {@link Artifact} instance where to relocate to, or {@code null}.
     *

那你可以宣告一個 `alias`，實際上就會用這個別名來讀取參數值：

{* ../../docs_src/query_params_str_validations/tutorial009_an_py310.py hl[9] *}

## 棄用參數 { #deprecating-parameters }

現在假設你不再喜歡這個參數了。

你必須暫時保留它，因為還有用戶端在用，但你希望文件能清楚標示它是<dfn title="過時，不建議使用">已棄用</dfn>。

接著把參數 `deprecated=True` 傳給 `Query`：

{* ../../docs_src/query_params_str_validations/tutorial010_an_py310.py hl[19] *}

文件會這樣顯示：

        setId_Terms(idList, opLambda);
    }

    @Deprecated
    public BsRelatedContentCQ addOrderBy_Id_Asc() {
        regOBA("_id");
        return this;
    }

    @Deprecated
    public BsRelatedContentCQ addOrderBy_Id_Desc() {
        regOBD("_id");
        return this;
    }

/**
 * Public API for a toolchain-aware plugin to get expected toolchain instance.
 *
 * @since 2.0.9
 * @deprecated Use {@link org.apache.maven.api.services.ToolchainManager} instead.
 */
@Deprecated(since = "4.0.0")
public interface ToolchainManager {

    // NOTE: Some plugins like Surefire access this field directly!
    @Deprecated
    String ROLE = ToolchainManager.class.getName();

    /**

pkg p2, func F //deprecated
pkg p2, func F() string
pkg p2, func G() Twoer
pkg p2, func NewError(string) error
pkg p2, type Twoer interface { PackageTwoMeth }
pkg p2, type Twoer interface, PackageTwoMeth //deprecated

 */
@Deprecated
public interface ResolutionListener {
    String ROLE = ResolutionListener.class.getName();

    int TEST_ARTIFACT = 1;

    int PROCESS_CHILDREN = 2;

    int FINISH_PROCESSING_CHILDREN = 3;

    int INCLUDE_ARTIFACT = 4;

    int OMIT_FOR_NEARER = 5;

    int UPDATE_SCOPE = 6;

    @Deprecated
    int MANAGE_ARTIFACT = 7;

  @Override
  void writeChars(String s);

  @Override
  void writeUTF(String s);

  /**
   * @deprecated This method is dangerous as it discards the high byte of every character. For
   *     UTF-8, use {@code write(s.getBytes(StandardCharsets.UTF_8))}.
   */
  @Deprecated
  @Override
  void writeBytes(String s);

  /** Returns the contents that have been written to this instance, as a byte array. */