*
     * This method handles the complete search workflow including parameter processing,
     * query execution, result formatting, and logging. It supports automatic retry
     * with escaped queries if the initial search fails.
     *
     * @param searchRequestParams The search request parameters
     * @param data The search render data to populate with results
     * @param userBean Optional user information for permission checking
     */

    }

    /**
     * Tests the isCredentialTypeCorrect method with a valid byte array.
     *
     * @throws PACDecodingException if the PAC decoding fails.
     */
    @Test
    void testIsCredentialTypeCorrectWithValidData() throws PACDecodingException {
        // A byte array with a length less than 32 should be correct.
        byte[] validData = new byte[31];

            extraSteps = extraBuildSteps,
            preSteps = preBuildSteps,
        )

        failureConditions {
            // JavaExecDebugIntegrationTest.debug session fails without debugger might cause JVM crash
            // Some soak tests produce OOM exceptions
            // There are also random worker crashes for some tests.
            // We have test-retry to handle the crash in tests

    }

    /**
     * Encodes a wide string pointer in NDR format.
     *
     * @param buf the NDR buffer
     * @param str the string to encode (can be null)
     * @throws NdrException if encoding fails
     */
    private void encodeWideStringPointer(NdrBuffer buf, String str) throws NdrException {
        if (str == null || str.isEmpty()) {
            buf.enc_ndr_long(0); // NULL pointer
        } else {

                SEVERE,
                String.format(Locale.ROOT, "Caught an exception in %s.  Shutting down.", t),
                e);
      } catch (Throwable errorInLogging) { // sneaky checked exception
        // If logging fails, e.g. due to missing memory, at least try to log the
        // message and the cause for the failed logging.
        System.err.println(e.getMessage());
        System.err.println(errorInLogging.getMessage());
      } finally {

 */
package org.codelibs.fess.exception;

/**
 * Exception thrown when there are issues with search query processing.
 *
 * This exception is typically thrown when query parsing, serialization,
 * or processing fails during search operations. It extends FessSystemException
 * to provide specific handling for search query-related errors.
 */
public class SearchQueryException extends FessSystemException {

        return new DefaultPooledObject<>(obj);
    }

    /**
     * Destroys a pooled object and notifies the destroy listener if set.
     * @param p The pooled object to destroy
     * @throws Exception if destruction fails
     */
    @Override
    public void destroyObject(final PooledObject<T> p) throws Exception {
        if (onDestroyListener != null) {
            onDestroyListener.onDestroy(p);
        }
    }

    /**

     * @param bufferIndex the starting position in the buffer
     * @param compound whether this is part of a compound chain
     * @return decoded length
     * @throws SMBProtocolDecodingException if decoding fails
     */
    public int decode(final byte[] buffer, int bufferIndex, final boolean compound) throws SMBProtocolDecodingException {
        final int start = this.headerStart = bufferIndex;

  @Override
  protected Collection<Integer> getValueNotInPopulatedMap() throws UnsupportedOperationException {
    return Lists.newArrayList(0);
  }

  /**
   * The version of this test supplied by {@link MapInterfaceTest} fails for this particular Map
   * implementation, because {@code map.get()} returns a view collection that changes in the course
   * of a call to {@code remove()}. Thus, the expectation doesn't hold that {@code map.remove(x)}

         *
         * @param notification the witness notification
         */
        void onWitnessNotification(WitnessNotification notification);

        /**
         * Called when a witness registration fails.
         *
         * @param registration the failed registration
         * @param error the error that occurred
         */
        void onRegistrationFailed(WitnessRegistration registration, Exception error);