}

  /** Factory for byte or char sinks. */
  interface SinkFactory<S, T> extends SourceSinkFactory<S, T> {

    /** Creates a new sink. */
    S createSink() throws IOException;

    /** Gets the current content of the created sink. */
    T getSinkContents() throws IOException;
  }

  /** Factory for {@link ByteSource} instances. */
  interface ByteSourceFactory extends SourceFactory<ByteSource, byte[]> {}

     * @param maxItems maximum number of items to return
     * @return list of storage items
     */
    List<StorageItem> listObjects(String prefix, int maxItems);

    /**
     * Gets tags/metadata for an object.
     *
     * @param objectName the name/path of the object
     * @return map of tag key-value pairs
     */
    Map<String, String> getObjectTags(String objectName);

    /**

         * repository never uses timestamps in the filename of a snapshot artifact. The discrepancy gets notable when a
         * remotely resolved snapshot artifact gets passed into pathOf(). So producing a proper local artifact path
         * using DefaultRepositoryLayout requires us to enforce usage of the artifact's base version. This

     * File internal information class constant.
     */
    byte FILE_INTERNAL_INFO = 0x6;

    /**
     * File rename information class constant.
     */
    byte FILE_RENAME_INFO = 10;

    /**
     * Gets the file information level/class for this file information object.
     *
     * @return the file information class
     */
    byte getFileInformationLevel();

     * @param data The data to store in the cache, may be {@code null}.
     */
    void put(RepositoryRequest request, Object key, Object data);

    /**
     * Gets the specified data from the cache. <strong>Warning:</strong> The cache will directly return the saved
     * reference. If the cached data is to be modified after its retrieval, the caller is responsible to create a copy

     *
     * @param terminal the terminal to get the icon for
     * @return the Unicode character if supported, otherwise the ASCII fallback
     */
    public String getIcon(Terminal terminal) {
        Charset charset = getTerminalCharset(terminal);
        return charset.newEncoder().canEncode(unicodeChar) ? String.valueOf(unicodeChar) : asciiFallback;
    }

    /**
     * Gets the charset used by the terminal for output.

        super(message, cause);
        this.url = url;
        this.abort = abort;
    }

    /**
     * Gets the URL where the crawling error occurred.
     *
     * @return the URL associated with this exception
     */
    public String getUrl() {
        return url;
    }

    /**

            } else if (v == version) {
                return matcher.group(3);
            }
            return null;
        }).filter(s -> s != null).toArray(n -> new String[n]);
    }

    /**
     * Gets the major version number of the current Java runtime.
     * For Java 8 and below, returns the minor version (e.g., 8 for Java 1.8).
     * For Java 9 and above, returns the major version (e.g., 11 for Java 11).
     *

 *
 * @deprecated since 4.0.0, use {@link org.apache.maven.api.services} instead
 */
@Deprecated(since = "4.0.0")
public interface Source {

    /**
     * Gets a byte stream to the source contents. Closing the returned stream is the responsibility of the caller.
     *
     * @return A byte stream to the source contents, never {@code null}.
     * @throws IOException in case of IO issue

     * @param location The location to report for this use, may be {@code null}.
     */
    public StringSettingsSource(CharSequence settings, String location) {
        super(settings, location);
    }

    /**
     * Gets the character sequence of this settings source.
     *
     * @return The underlying character stream, never {@code null}.
     * @deprecated instead use {@link #getContent()}
     */
    @Deprecated