* and committing changes to the search index.
 */
public interface IndexUpdateCallback {

    /**
     * Stores a document in the search index with the specified parameters and data.
     *
     * @param paramMap the data store parameters containing configuration and metadata
     * @param dataMap the document data to be indexed as key-value pairs
     */

    protected ShutdownListener shutdownListener;

    /**
     * Default constructor.
     */
    public JobExecutor() {
        // Default constructor
    }

    /**
     * Executes a script with the specified script type and content.
     *
     * @param scriptType the type of script to execute
     * @param script the script content to execute
     * @return the result of script execution
     */

 *
 * @deprecated use {@code org.apache.maven.api.services.ModelBuilder} instead
 */
@Deprecated(since = "4.0.0")
public interface ModelProblemCollector {

    /**
     * Adds the specified problem.
     *
     * @param req must not be null
     */
    void add(ModelProblemCollectorRequest req);

 *
 * @since 4.0.0
 */
@Experimental
public class MavenExecutionException extends MavenException {

    /**
     * Constructs a new MavenExecutionException with the specified cause.
     *
     * @param cause The underlying exception that caused the execution failure
     */
    public MavenExecutionException(Throwable cause) {
        super(cause);
    }

 * model inheritance.
 *
 * @deprecated use {@code org.apache.maven.api.services.ModelBuilder} instead
 */
@Deprecated(since = "4.0.0")
public interface UrlNormalizer {

    /**
     * Normalizes the specified URL.
     *
     * @param url The URL to normalize, may be {@code null}.
     * @return The normalized URL or {@code null} if the input was {@code null}.
     */
    String normalize(String url);

 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */
package org.apache.maven.plugin.version;

/**
 * Resolves a version for a plugin.
 *
 * @since 3.0
 */
public interface PluginVersionResolver {

    /**
     * Resolves the version for the specified request.
     *

     * <code>smb://</code> resource <code>true</code> is always returned. If
     * this <code>SmbResource</code> is a traditional file or directory, it will
     * be queried for on the specified server as expected.
     *
     * @return <code>true</code> if the resource exists or is alive or
     *         <code>false</code> otherwise
     * @throws CIFSException if an error occurs accessing the resource
     */

    protected boolean disableRoleQuery = false;

    /** The default field to search in when no specific field is specified. */
    protected String defaultField = null;

    /**
     * Constructs a new QueryContext with the specified query string.
     * Processes special query prefixes (allinurl:, allintitle:) and initializes
     * request-scoped attributes for highlighting and field logging.

    private MessageDigest digest;
    private byte[] macSigningKey;
    private boolean bypass = false;
    private int updates;
    private int signSequence;

    /**
     * Constructs a new signing digest with the specified MAC signing key.
     *
     * @param macSigningKey the MAC signing key for message authentication
     * @param bypass whether to bypass MAC signing
     * @throws SmbException if MD5 algorithm is not available
     */

        }
    }

    /**
     * Get the action role.
     * @return The action role.
     */
    protected abstract String getActionRole();

    /**
     * Writes data to the specified file path.
     *
     * @param path the file path to write to
     * @param data the data to write
     */
    protected void write(final String path, final byte[] data) {
        validateFilePath(path);