/*
 * Copyright © 2018, 2021 Apple Inc. and the ServiceTalk project authors
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package io.servicetalk.transport.api;

import io.servicetalk.concurrent.GracefulAutoCloseable;
import io.servicetalk.concurrent.api.ListenableAsyncCloseable;

import java.net.SocketAddress;

import static io.servicetalk.concurrent.internal.FutureUtils.awaitTermination;

/**
 * Context for servers.
 */
public interface ServerContext extends ServerListenContext, ListenableAsyncCloseable, GracefulAutoCloseable {

    /**
     * Listen address for the server associated with this context.
     *
     * @return Address which the associated server is listening at.
     */
    SocketAddress listenAddress();

    /**
     * Returns {@link ExecutionContext} used by this server.
     *
     * @return {@link ExecutionContext} used by this server.
     */
    ExecutionContext<?> executionContext();

    /**
     * Blocks and awaits shutdown of the server this {@link ServerContext} represents.
     * <p>
     * This method will return when {@link #onClose()} terminates either successfully or unsuccessfully.
     */
    default void awaitShutdown() {
        awaitTermination(onClose().toFuture());
    }

    @Override
    default void close() throws Exception {
        awaitTermination(closeAsync().toFuture());
    }

    @Override
    default void closeGracefully() throws Exception {
        awaitTermination(closeAsyncGracefully().toFuture());
    }
}
