/*
 * Copyright (C) 2016 TIBCO Jaspersoft Corporation. All rights reserved.
 * http://community.jaspersoft.com/project/mobile-sdk-android
 *
 * Unless you have purchased a commercial license agreement from TIBCO Jaspersoft,
 * the following license terms apply:
 *
 * This program is part of TIBCO Jaspersoft Mobile SDK for Android.
 *
 * TIBCO Jaspersoft Mobile SDK is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * TIBCO Jaspersoft Mobile SDK is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with TIBCO Jaspersoft Mobile SDK for Android. If not, see
 * <http://www.gnu.org/licenses/lgpl>.
 */

package com.jaspersoft.android.sdk.service.rx.auth;

import com.jaspersoft.android.sdk.network.AnonymousClient;
import com.jaspersoft.android.sdk.network.Credentials;
import com.jaspersoft.android.sdk.service.auth.AuthorizationService;
import com.jaspersoft.android.sdk.service.exception.ServiceException;
import com.jaspersoft.android.sdk.service.internal.Preconditions;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.TestOnly;
import rx.Observable;
import rx.functions.Func0;


/**
 * The corresponding service allows to perform authorization related tasks by wrapping one in Rx {@link Observable}
 *
 * <pre>
 * {@code
 *
 *  Server server = Server.builder()
 *          .withBaseUrl("http://mobiledemo2.jaspersoft.com/jasperserver-pro/")
 *          .build();
 *
 *  AnonymousClient anonymousClient = server.newClient().create();
 *
 *  Credentials credentials = SpringCredentials.builder()
 *          .withPassword("phoneuser")
 *          .withUsername("phoneuser")
 *          .withOrganization("organization_1")
 *          .build();
 *
 *  RxAuthorizationService service = RxAuthorizationService.newService(anonymousClient);
 *  service.authorize(credentials).subscribe(
 *          new Action1<Credentials>() {
 *              @
 *              public void call(Credentials credentials) {
 *                  // success
 *              }
 *          },
 *          new Action1<Throwable>() {
 *              @
 *              public void call(Throwable throwable) {
 *                  // handle API exception
 *              }
 *          }
 *  );
 *
 * }
 * </pre>
 *
 * @author Tom Koptel
 * @since 2.3
 */
public class RxAuthorizationService {
    private final AuthorizationService mSyncDelegate;

    @TestOnly
    RxAuthorizationService(AuthorizationService service) {
        mSyncDelegate = service;
    }

    /**
     * Performs authorize call on basis of passed credentials
     *
     * @param credentials user sensitive data
     * @return observable that emits credentials use has supplied if operation was successful
     */
    @NotNull
    public Observable<Credentials> authorize(@NotNull final Credentials credentials) {
        return Observable.defer(new Func0<Observable<Credentials>>() {
            @Override
            public Observable<Credentials> call() {
                try {
                    mSyncDelegate.authorize(credentials);
                    return Observable.just(credentials);
                } catch (ServiceException e) {
                    return Observable.error(e);
                }
            }
        });
    }

    /**
     * Factory method to create new service
     *
     * @param client anonymous network client
     * @return instance of newly created service
     */
    @NotNull
    public static RxAuthorizationService newService(@NotNull AnonymousClient client) {
        Preconditions.checkNotNull(client, "Client should not be null");
        AuthorizationService service = AuthorizationService.newService(client);
        return new RxAuthorizationService(service);
    }

    /**
     * Provides synchronous counterpart of service
     *
     * @return wrapped version of service {@link AuthorizationService}
     */
    public AuthorizationService toBlocking() {
        return mSyncDelegate;
    }
}