public interface ArtifactInstaller extends Service {
    /**
     * @param request {@link ArtifactInstallerRequest}
     * @throws ArtifactInstallerException in case of an error
     * @throws IllegalArgumentException in case {@code request} is {@code null}
     */
    void install(@Nonnull ArtifactInstallerRequest request);

    /**
     * @param session the repository session
     * @param artifact the {@link ProducedArtifact} to install

     *
     * @param context the upgrade context
     * @param pomMap map of all POM files in the project
     * @return the result of the upgrade operation
     */
    protected abstract UpgradeResult doApply(UpgradeContext context, Map<Path, Document> pomMap);

    /**
     * Gets the upgrade options from the context.
     *
     * @param context the upgrade context
     * @return the upgrade options

        return roleList;
    }

    /**
     * Gets a role by its ID.
     * @param id The ID of the role.
     * @return An optional entity of the role.
     */
    public OptionalEntity<Role> getRole(final String id) {
        return roleBhv.selectByPK(id);
    }

    /**
     * Stores a role.
     * @param role The role to store.
     */
    public void store(final Role role) {

     * the path merely indicates where the artifact would eventually be stored.
     *
     * @param session The session to use, must not be {@code null}.
     * @param local The local repository, must not be {@code null}.
     * @param artifact The artifact for which to determine the path, must not be {@code null}.
     * @param remote – The source repository of the artifact, must not be {@code null}.

     *
     * @param request The index request.
     * @return Future for the index response.
     */
    @Override
    public ActionFuture<IndexResponse> index(final IndexRequest request) {
        return client.index(request);
    }

    /**
     * Executes an index request asynchronously.
     *
     * @param request The index request.
     * @param listener The response listener.
     */

        return redirectWith(getClass(), moreUrl("list/" + encodeId(form.path)));
    }

    /**
     * Updates the tags for a storage object in the storage system.
     *
     * @param objectName the name of the object to update tags for
     * @param tagItems the map of tag items from the form
     * @throws StorageException if the tag update fails
     */

     * Sets the cookie name.
     *
     * @param name the name
     */
    public void setName(final String name) {
        this.name = name;
    }

    /**
     * Gets the cookie value.
     *
     * @return the value
     */
    public String getValue() {
        return value;
    }

    /**
     * Sets the cookie value.
     *
     * @param value the value
     */

     *
     * @param content
     */
    void debug(CharSequence content);

    /**
     * Send a message (and accompanying exception) to the user in the <b>debug</b> error level.<br>
     * The error's stacktrace will be output when this error level is enabled.
     *
     * @param content
     * @param error
     */
    void debug(CharSequence content, Throwable error);

            }, () -> asListHtml(dictId));
        }
    }

    /**
     * Validate the protected word string.
     * @param action The action.
     * @param values The values.
     * @param propertyName The property name.
     * @param hook The error hook.
     */
    private static void validateProtwordsString(final FessBaseAction action, final String values, final String propertyName,

     */
    String getFullUNCPath();

    /**
     * Sets the path to the resource.
     *
     * @param path the path to set
     */
    void setPath(String path);

    /**
     * Sets the full UNC path components.
     *
     * @param domain the domain name
     * @param server the server name
     * @param fullPath the full UNC path
     */
    void setFullUNCPath(String domain, String server, String fullPath);