* and {@link State#TERMINATED} states are terminal states, once a service enters either of these
 * states it cannot ever leave them.
 *
 * <p>Implementors of this interface are strongly encouraged to extend one of the abstract classes
 * in this package which implement this interface and make the threading and state management
 * easier.
 *
 * @author Jesse Wilson
 * @author Luke Sandberg

     */
    public void addShutdownListener(final ShutdownListener listener) {
        shutdownListener = listener;
    }

    /**
     * Interface for listening to shutdown events.
     */
    public interface ShutdownListener {
        /**
         * Called when the job executor is shutting down.
         */
        void onShutdown();
    }

 *
 * @see FinalizableReferenceQueue
 * @author Bob Lee
 * @since 2.0
 */
@DoNotMock("Use an instance of one of the Finalizable*Reference classes")
@J2ktIncompatible
@GwtIncompatible
public interface FinalizableReference {
  /**
   * Invoked on a background thread after the referent has been garbage collected unless security
   * restrictions prevented starting a background thread, in which case this method is invoked when

                throw new QueryParseException(e);
            }
        };
    }

    /**
     * Interface for query filters that can modify or transform queries.
     * Filters are applied in the order they are added to the parser.
     */
    public interface Filter {
        /**
         * Parses and potentially modifies the query string.
         *

import com.google.common.eventbus.outside.DeepInterfaceTest.SubscriberClass;
import java.util.ArrayList;
import java.util.List;

public class DeepInterfaceTest extends AbstractEventBusTest<SubscriberClass> {
  interface Interface1 {
    @Subscribe
    void annotatedIn1(Object o);

    @Subscribe
    void annotatedIn1And2(Object o);

    @Subscribe
    void annotatedIn1And2AndClass(Object o);

  }

  @Override
  public Set<Feature<? super Set>> getImpliedFeatures() {
    return implied;
  }

  @Retention(RetentionPolicy.RUNTIME)
  @Inherited
  @TesterAnnotation
  public @interface Require {
    SetFeature[] value() default {};

    SetFeature[] absent() default {};
  }

        public boolean isSkipClass(Class<?> clazz) {
            return false;
        }

        @Override
        public String toInterfaceClassName(String className) {
            return className + "Interface";
        }

        @Override
        public String toImplementationClassName(String className) {
            return className + "Impl";
        }

        @Override

 * due to eviction resulting from timed expiration, exceeding a maximum size, or garbage collection.
 *
 * <p>An instance may be called concurrently by multiple threads to process different entries.
 * Implementations of this interface should avoid performing blocking calls or synchronizing on
 * shared resources.
 *
 * @param <K> the most general type of keys this listener can listen for; for example {@code Object}
 *     if any key is acceptable

          progressListener.update(totalBytesRead, responseBody.contentLength(), bytesRead == -1);
          return bytesRead;
        }
      };
    }
  }

  interface ProgressListener {
    void update(long bytesRead, long contentLength, boolean done);
  }

   * null} if no replacement should be made. This method is intended for use in tests through the
   * {@code EscaperAsserts} class; production users of {@link CharEscaper} should limit themselves
   * to its public interface.
   *
   * @param c the character to escape if necessary
   * @return the replacement string, or {@code null} if no escaping was needed
   */