/**
         * Constructor.
         * @param nameId The name ID.
         * @param sessionIndex The session index.
         * @param nameIdFormat The name ID format.
         * @param nameidNameQualifier The name ID name qualifier.
         * @param nameidSPNameQualifier The name ID SP name qualifier.
         * @param groups The groups.
         * @param roles The roles.
         */

     * This method configures wildcard searches for term and queries fields, and sets up ordering.
     *
     * @param cb the condition bean for building the query
     * @param relatedQueryPager the pager containing search parameters
     */
    protected void setupListCondition(final RelatedQueryCB cb, final RelatedQueryPager relatedQueryPager) {

    }

    /**
     * Executes the fuzzy query command to convert a Lucene FuzzyQuery into an OpenSearch QueryBuilder.
     *
     * @param context the query context containing search configuration
     * @param query the Lucene query to convert (must be a FuzzyQuery)
     * @param boost the boost factor to apply to the query
     * @return OpenSearch QueryBuilder for fuzzy matching

   *
   * <p><b>Note:</b> this method is now unnecessary and should be treated as deprecated; use the
   * equivalent {@link Long#compareUnsigned(long, long)} method instead.
   *
   * @param a the first unsigned {@code long} to compare
   * @param b the second unsigned {@code long} to compare
   * @return a negative value if {@code a} is less than {@code b}; a positive value if {@code a} is
   *     greater than {@code b}; or zero if they are equal

 */
public abstract class PreparedStatementUtil {

    /**
     * Do not instantiate.
     */
    protected PreparedStatementUtil() {
    }

    /**
     * Executes the query.
     *
     * @param ps
     *            {@link PreparedStatement}. Must not be {@literal null}.
     * @return {@link ResultSet}
     * @throws SQLRuntimeException
     *             If a {@link SQLException} occurs.
     */

   * lies outside that, then {@link #escapeUnsafe} is called, otherwise no escaping is performed.
   *
   * @param replacementMap a map of characters to their escaped representations
   * @param safeMin the lowest character value in the safe range
   * @param safeMax the highest character value in the safe range
   * @param unsafeReplacement the default replacement for unsafe characters or null if no default
   *     replacement is required
   */

    /**
     * Sets up the search conditions for listing related content entities.
     * Configures wildcard searches for term and content fields, and sets up ordering.
     *
     * @param cb the condition bean for building the query
     * @param relatedContentPager the pager containing search parameters
     */
    protected void setupListCondition(final RelatedContentCB cb, final RelatedContentPager relatedContentPager) {

     * Constructs a UnicodeString with zero termination option.
     *
     * @param zterm whether the string should be zero terminated
     */
    public UnicodeString(final boolean zterm) {
        this.zterm = zterm;
    }

    /**
     * Constructs a UnicodeString by wrapping an existing unicode_string.
     *
     * @param rus wrapped string
     * @param zterm whether the string should be zero terminated
     */

    ProjectBuilderResult build(ProjectBuilderRequest request) throws ProjectBuilderException;

    /**
     * Creates a {@link org.apache.maven.api.Project} from a POM file.
     *
     * @param session the {@link Session}, must not be {@code null}
     * @param source The {@link Source}, must not be {@code null}
     * @throws ProjectBuilderException if the project cannot be created

  }

  /**
   * Waits for the {@link Service} to reach the {@linkplain State#RUNNING running state} for no more
   * than the given time.
   *
   * @param timeout the maximum time to wait
   * @param unit the time unit of the timeout argument
   * @throws TimeoutException if the service has not reached the given state within the deadline