* @return a non-null string describing the source location
     */
    @Nonnull
    String getLocation();

    /**
     * Resolves a new source relative to this one.
     * <p>
     * The resolution strategy depends on the source type:
     * <ul>
     *   <li>File sources resolve against their parent directory</li>
     *   <li>URL sources resolve against their base URL</li>

        generator = new TestThumbnailGenerator();
        Map<String, Object> docMap = new HashMap<>();
        docMap.put("id", "doc123");

        // Since createTask depends on FessConfig, it may not work properly
        // in unit tests without full container
        try {
            generator.createTask("/path/to/thumb.jpg", docMap);
        } catch (Exception e) {

 *
 * @since 4.0.0
 */
@Experimental
@Immutable
public interface BuilderProblem {

    /**
     * Gets the hint about the source of the problem. While the syntax of this hint is unspecified and depends on the
     * creator of the problem, the general expectation is that the hint provides sufficient information to the user to

    # - - - - - - - - - -/

    # /- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    # o isAvailableDatabaseDependency: (NotRequired - Default false)
    #   [true]
    #     Generate the method that depends on the database. e.g. cb.lockWithRR() at DB2.
    #
    #; isAvailableDatabaseDependency = false
    # - - - - - - - - - -/

    # /- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

 * </p>
 *
 * <p>
 * The class also provides methods to set and get the charset name used for encoding and decoding the text content.
 * </p>
 *
 * <p>
 * It depends on CrawlerContainer to get ExtractorFactory.
 * </p>
 */
public class TextTransformer extends AbstractTransformer {
    private static final Logger logger = LogManager.getLogger(TextTransformer.class);

    /**

            getMockRequest().addHeader("X-Roles", System.currentTimeMillis() / 1000 + "\nrole3,role4");

            Set<String> roleSet = roleQueryHelper.build(SearchRequestType.SEARCH);
            // The role set size depends on configuration and implementation
            assertTrue(roleSet.size() >= 0);
        } catch (Exception e) {
            // Expected due to missing dependencies in test environment
            assertTrue(true);

replication failures are picked up by the scanner which runs at a one minute frequency, each time scanning up to a sixteenth of the namespace. Object versions marked `PENDING` or `FAILED` are re-queued for replication.

Replication speed depends on the cluster load, number of objects in the object store as well as storage speed. In addition, any bandwidth limits set via `mc admin bucket remote add` could also contribute to replication speed. The number of workers used for replication defaults...

    assertThrows(NoSuchElementException.class, iter::peek);
  }


  @J2ktIncompatible // weak references, details of GC
  @GwtIncompatible // weak references
  @AndroidIncompatible // depends on details of GC
  public void testFreesNextReference() {
    Iterator<Object> itr =
        new AbstractIterator<Object>() {
          @Override
          public Object computeNext() {

   * {@code co.uk}, {@code google.invalid}, or {@code blogspot.com}.
   *
   * <p>This method can be used to determine whether it will probably be possible to set cookies on
   * the domain, though even that depends on individual browsers' implementations of cookie
   * controls. See <a href="http://www.ietf.org/rfc/rfc2109.txt">RFC 2109</a> for details.
   *
   * @since 6.0
   */
  public boolean isUnderPublicSuffix() {

At some point, you will probably end up writing many different programs that depend on **different packages**. And some of these projects you work on will depend on **different versions** of the same package. 😱

For example, you could create a project called `philosophers-stone`, this program depends on another package called **`harry`, using the version `1`**. So, you need to install `harry`.

```mermaid