package com.google.android.gms.common.api;

import android.app.Activity;
import android.content.Context;
import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
import android.view.View;
import com.google.android.gms.common.ConnectionResult;

import java.util.concurrent.TimeUnit;
import java.util.logging.Handler;

/**
 * The main entry point for Google Play services integration.
 * <p/>
 * GoogleApiClient is used with a variety of static methods. Some of these methods require that
 * GoogleApiClient be connected, some will queue up calls before GoogleApiClient is connected;
 * check the specific API documentation to determine whether you need to be connected.
 * <p/>
 * Before any operation is executed, the GoogleApiClient must be connected using the
 * {@link #connect()} method. The client is not considered connected until the
 * {@link ConnectionCallbacks#onConnected(Bundle)} callback has been called.
 * <p/>
 * When your app is done using this client, call {@link #disconnect()}, even if the async result
 * from {@link #connect()} has not yet been delivered.
 * <p/>
 * You should instantiate a client object in your Activity's {@link Activity#onCreate(Bundle)}
 * method and then call {@link #connect()} in {@link Activity#onStart()} and {@link #disconnect()}
 * in {@link Activity#onStop()}, regardless of the state.
 */
public interface GoogleApiClient {
    /**
     * Connects the client to Google Play services. Blocks until the connection either succeeds or
     * fails. This is not allowed on the UI thread.
     *
     * @return the result of the connection
     */
    public ConnectionResult blockingConnect();

    /**
     * Connects the client to Google Play services. Blocks until the connection is set or failed or
     * has timed out. This is not allowed on the UI thread.
     *
     * @param timeout the maximum time to wait
     * @param unit    the time unit of the {@code timeout} argument
     * @return the result of the connection
     */
    public ConnectionResult blockingConnect(long timeout, TimeUnit unit);

    /**
     * Clears the account selected by the user and reconnects the client asking the user to pick an
     * account again if {@link Builder#useDefaultAccount()} was set.
     *
     * @return the pending result is fired once the default account has been cleared, but before
     * the client is reconnected - for that {@link ConnectionCallbacks} can be used.
     */
    public PendingResult<Status> clearDefaultAccountAndReconnect();

    /**
     * Connects the client to Google Play services. This method returns immediately, and connects
     * to the service in the background. If the connection is successful,
     * {@link ConnectionCallbacks#onConnected(Bundle)} is called and enqueued items are executed.
     * On a failure, {@link OnConnectionFailedListener#onConnectionFailed(ConnectionResult)} is
     * called.
     */
    public void connect();

    /**
     * Closes the connection to Google Play services. No calls can be made using this client after
     * calling this method. Any method calls that haven't executed yet will be canceled. That is
     * {@link ResultCallback#onResult(Result)} won't be called, if connection to the service hasn't
     * been established yet all calls already made will be canceled.
     *
     * @see #connect()
     */
    public void disconnect();

    /**
     * Checks if the client is currently connected to the service, so that requests to other
     * methods will succeed. Applications should guard client actions caused by the user with a
     * call to this method.
     *
     * @return {@code true} if the client is connected to the service.
     */
    public boolean isConnected();

    /**
     * Checks if the client is attempting to connect to the service.
     *
     * @return {@code true} if the client is attempting to connect to the service.
     */
    public boolean isConnecting();

    /**
     * Returns {@code true} if the specified listener is currently registered to receive connection
     * events.
     *
     * @param listener The listener to check for.
     * @return {@code true} if the specified listener is currently registered to receive connection
     * events.
     * @see #registerConnectionCallbacks(ConnectionCallbacks)
     * @see #unregisterConnectionCallbacks(ConnectionCallbacks)
     */
    public boolean isConnectionCallbacksRegistered(ConnectionCallbacks listener);

    /**
     * Returns {@code true} if the specified listener is currently registered to receive connection
     * failed events.
     *
     * @param listener The listener to check for.
     * @return {@code true} if the specified listener is currently registered to receive connection
     * failed events.
     * @see #registerConnectionFailedListener(OnConnectionFailedListener)
     * @see #unregisterConnectionFailedListener(OnConnectionFailedListener)
     */
    public boolean isConnectionFailedListenerRegistered(OnConnectionFailedListener listener);

    /**
     * Closes the current connection to Google Play services and creates a new connection.
     * <p/>
     * This method closes the current connection then returns immediately and reconnects to the
     * service in the background.
     * <p/>
     * After calling this method, your application will receive
     * {@link ConnectionCallbacks#onConnected(Bundle)} if the connection is successful, or
     * {@link OnConnectionFailedListener#onConnectionFailed(ConnectionResult)} if the connection
     * failed.
     *
     * @see #connect()
     * @see #disconnect()
     */
    public void reconnect();

    /**
     * Registers a listener to receive connection events from this {@link GoogleApiClient}. If the
     * service is already connected, the listener's {@link ConnectionCallbacks#onConnected(Bundle)}
     * method will be called immediately. Applications should balance calls to this method with
     * calls to {@link #unregisterConnectionCallbacks(ConnectionCallbacks)} to avoid leaking
     * resources.
     * <p/>
     * If the specified listener is already registered to receive connection events, this method
     * will not add a duplicate entry for the same listener, but will still call the listener's
     * {@link ConnectionCallbacks#onConnected(Bundle)} method if currently connected.
     * <p/>
     * Note that the order of messages received here may not be stable, so clients should not rely
     * on the order that multiple listeners receive events in.
     *
     * @param listener the listener where the results of the asynchronous {@link #connect()} call
     *                 are delivered.
     */
    public void registerConnectionCallbacks(ConnectionCallbacks listener);

    /**
     * Registers a listener to receive connection failed events from this {@link GoogleApiClient}.
     * Unlike {@link #registerConnectionCallbacks(ConnectionCallbacks)}, if the service is not
     * already connected, the listener's
     * {@link OnConnectionFailedListener#onConnectionFailed(ConnectionResult)} method will not be
     * called immediately. Applications should balance calls to this method with calls to
     * {@link #unregisterConnectionFailedListener(OnConnectionFailedListener)} to avoid leaking
     * resources.
     * <p/>
     * If the specified listener is already registered to receive connection failed events, this
     * method will not add a duplicate entry for the same listener.
     * <p/>
     * Note that the order of messages received here may not be stable, so clients should not rely
     * on the order that multiple listeners receive events in.
     *
     * @param listener the listener where the results of the asynchronous {@link #connect()} call
     *                 are delivered.
     */
    public void registerConnectionFailedListener(OnConnectionFailedListener listener);

    /**
     * Disconnects the client and stops automatic lifecycle management. Use this before creating a
     * new client (which might be necessary when switching accounts, changing the set of used APIs
     * etc.).
     * <p/>
     * This method must be called from the main thread.
     *
     * @param lifecycleActivity the activity managing the client's lifecycle.
     * @throws IllegalStateException if called from outside of the main thread.
     * @see Builder#enableAutoManage(FragmentActivity, int, OnConnectionFailedListener)
     */
    public void stopAutoManager(FragmentActivity lifecycleActivity) throws IllegalStateException;

    /**
     * Removes a connection listener from this {@link GoogleApiClient}. Note that removing a
     * listener does not generate any callbacks.
     * <p/>
     * If the specified listener is not currently registered to receive connection events, this
     * method will have no effect.
     *
     * @param listener the listener to unregister.
     */
    public void unregisterConnectionCallbacks(ConnectionCallbacks listener);

    /**
     * Removes a connection failed listener from the {@link GoogleApiClient}. Note that removing a
     * listener does not generate any callbacks.
     * <p/>
     * If the specified listener is not currently registered to receive connection failed events,
     * this method will have no effect.
     *
     * @param listener the listener to unregister.
     */
    public void unregisterConnectionFailedListener(OnConnectionFailedListener listener);

    /**
     * Builder to configure a {@link GoogleApiClient}.
     */
    public class Builder {
        /**
         * Builder to help construct the {@link GoogleApiClient} object.
         *
         * @param context The context to use for the connection.
         */
        public Builder(Context context) {

        }

        /**
         * Builder to help construct the {@link GoogleApiClient} object.
         *
         * @param context                  The context to use for the connection.
         * @param connectedListener        The listener where the results of the asynchronous
         *                                 {@link #connect()} call are delivered.
         * @param connectionFailedListener The listener which will be notified if the connection
         *                                 attempt fails.
         */
        public Builder(Context context, ConnectionCallbacks connectedListener,
                OnConnectionFailedListener connectionFailedListener) {
            this(context);
            addConnectionCallbacks(connectedListener);
            addOnConnectionFailedListener(connectionFailedListener);
        }

        /**
         * Specify which Apis are requested by your app. See {@link Api} for more information.
         *
         * @param api     The Api requested by your app.
         * @param options Any additional parameters required for the specific AP
         * @see Api
         */
        public <O extends Api.ApiOptions.HasOptions> Builder addApi(Api<O> api, O options) {
            // TODO
            return this;
        }

        /**
         * Specify which Apis are requested by your app. See {@link Api} for more information.
         *
         * @param api The Api requested by your app.
         * @see Api
         */
        public Builder addApi(Api<? extends Api.ApiOptions.NotRequiredOptions> api) {
            // TODO
            return this;
        }

        /**
         * Registers a listener to receive connection events from this {@link GoogleApiClient}.
         * Applications should balance calls to this method with calls to
         * {@link #unregisterConnectionCallbacks(ConnectionCallbacks)} to avoid
         * leaking resources.
         * <p/>
         * If the specified listener is already registered to receive connection events, this
         * method will not add a duplicate entry for the same listener.
         * <p/>
         * Note that the order of messages received here may not be stable, so clients should not
         * rely on the order that multiple listeners receive events in.
         *
         * @param listener the listener where the results of the asynchronous {@link #connect()}
         *                 call are delivered.
         */
        public Builder addConnectionCallbacks(ConnectionCallbacks listener) {
            // TODO
            return this;
        }

        /**
         * Adds a listener to register to receive connection failed events from this
         * {@link GoogleApiClient}. Applications should balance calls to this method with calls to
         * {@link #unregisterConnectionFailedListener(OnConnectionFailedListener)} to avoid
         * leaking resources.
         * <p/>
         * If the specified listener is already registered to receive connection failed events,
         * this method will not add a duplicate entry for the same listener.
         * <p/>
         * Note that the order of messages received here may not be stable, so clients should not
         * rely on the order that multiple listeners receive events in.
         *
         * @param listener the listener where the results of the asynchronous {@link #connect()}
         *                 call are delivered.
         */
        public Builder addOnConnectionFailedListener(OnConnectionFailedListener listener) {
            // TODO
            return this;
        }

        /**
         * Specify the OAuth 2.0 scopes requested by your app. See
         * {@link com.google.android.gms.common.Scopes} for more information.
         *
         * @param scope The OAuth 2.0 scopes requested by your app.
         * @see com.google.android.gms.common.Scopes
         */
        public Builder addScope(Scope scope) {
            // TODO
            return this;
        }

        /**
         * Builds a new {@link GoogleApiClient} object for communicating with the Google APIs.
         *
         * @return The {@link GoogleApiClient} object.
         */
        public GoogleApiClient build() {
            return null; // TODO
        }

        public Builder enableAutoManage(FragmentActivity fragmentActivity, int cliendId,
                OnConnectionFailedListener unresolvedConnectionFailedListener)
                throws NullPointerException, IllegalArgumentException, IllegalStateException {
            // TODO
            return this;
        }

        /**
         * Specify an account name on the device that should be used. If this is never called, the
         * client will use the current default account for Google Play services for this
         * application.
         *
         * @param accountName The account name on the device that should be used by
         *                    {@link GoogleApiClient}.
         */
        public Builder setAccountName(String accountName) {
            // TODO
            return this;
        }

        /**
         * Specifies the part of the screen at which games service popups (for example,
         * "welcome back" or "achievement unlocked" popups) will be displayed using gravity.
         *
         * @param gravityForPopups The gravity which controls the placement of games service popups.
         */
        public Builder setGravityForPopups(int gravityForPopups) {
            // TODO
            return this;
        }

        /**
         * Sets a {@link Handler} to indicate which thread to use when invoking callbacks. Will not
         * be used directly to handle callbacks. If this is not called then the application's main
         * thread will be used.
         */
        public Builder setHandler(Handler handler) {
            // TODO
            return this;
        }

        /**
         * Sets the {@link View} to use as a content view for popups.
         *
         * @param viewForPopups The view to use as a content view for popups. View cannot be null.
         */
        public Builder setViewForPopups(View viewForPopups) {
            // TODO
            return this;
        }

        /**
         * Specify that the default account should be used when connecting to services.
         */
        public Builder useDefaultAccount() {
            // TODO
            return this;
        }
    }

    /**
     * Provides callbacks that are called when the client is connected or disconnected from the 
     * service. Most applications implement {@link #onConnected(Bundle)} to start making requests.
     */
    public interface ConnectionCallbacks {
        /**
         * A suspension cause informing that the service has been killed.
         */
        int CAUSE_SERVICE_DISCONNECTED = 1;
        /**
         * A suspension cause informing you that a peer device connection was lost.
         */
        int CAUSE_NETWORK_LOST = 2;

        /**
         * After calling {@link #connect()}, this method will be invoked asynchronously when the
         * connect request has successfully completed. After this callback, the application can
         * make requests on other methods provided by the client and expect that no user
         * intervention is required to call methods that use account and scopes provided to the
         * client constructor.
         * <p/>
         * Note that the contents of the {@code connectionHint} Bundle are defined by the specific
         * services. Please see the documentation of the specific implementation of
         * {@link GoogleApiClient} you are using for more information.
         *
         * @param connectionHint Bundle of data provided to clients by Google Play services. May
         *                       be null if no content is provided by the service.
         */
        void onConnected(Bundle connectionHint);

        /**
         * Called when the client is temporarily in a disconnected state. This can happen if there
         * is a problem with the remote service (e.g. a crash or resource problem causes it to be
         * killed by the system). When called, all requests have been canceled and no outstanding
         * listeners will be executed. GoogleApiClient will automatically attempt to restore the
         * connection. Applications should disable UI components that require the service, and wait
         * for a call to {@link #onConnected(Bundle)} to re-enable them.
         *
         * @param cause The reason for the disconnection. Defined by constants {@code CAUSE_*}.
         */
        void onConnectionSuspended(int cause);
    }

    /**
     * Provides callbacks for scenarios that result in a failed attempt to connect the client to
     * the service. See {@link ConnectionResult} for a list of error codes and suggestions for
     * resolution.
     */
    public interface OnConnectionFailedListener {
        /**
         * Called when there was an error connecting the client to the service.
         *
         * @param result A {@link ConnectionResult} that can be used for resolving the error, and
         *               deciding what sort of error occurred. To resolve the error, the resolution
         *               must be started from an activity with a non-negative {@code requestCode}
         *               passed to {@link ConnectionResult#startResolutionForResult(Activity, int)}.
         *               Applications should implement {@link Activity#onActivityResult} in their
         *               Activity to call {@link #connect()} again if the user has resolved the
         *               issue (resultCode is {@link Activity#RESULT_OK}).
         */
        void onConnectionFailed(ConnectionResult result);
    }
}