/*
 * Copyright (C) 2008-2010 Nokia Corporation.
 * Copyright (C) 2006, 2007, 2008 OpenedHand Ltd.
 * Copyright (C) 2013 Cable Television Laboratories, Inc.
 *
 * Author: Zeeshan Ali (Khattak) <zeeshanak@gnome.org>
 *                               <zeeshan.ali@nokia.com>
 *         Jorn Baayen <jorn.baayen@gmail.com>
 *         Craig Pratt <craig@ecaspia.com>
 *
 * This file is part of Rygel.
 *
 * Rygel 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 2.1 of the License, or (at your option) any later version.
 *
 * Rygel 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 this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 */

public errordomain Rygel.HTTPRequestError {
    UNACCEPTABLE = Soup.Status.NOT_ACCEPTABLE,
    BAD_REQUEST = Soup.Status.BAD_REQUEST,
    NOT_FOUND = Soup.Status.NOT_FOUND,
    INTERNAL_SERVER_ERROR = Soup.Status.INTERNAL_SERVER_ERROR
}

/**
 * Base class for HTTP client requests.
 */
public abstract class Rygel.HTTPRequest : GLib.Object, Rygel.StateMachine {
    public unowned HTTPServer http_server;
    private MediaContainer root_container;
    public unowned Soup.Server server;
    public Soup.Message msg;

    public Cancellable cancellable { get; set; }

    protected HTTPItemURI uri;
    public MediaObject object;

    internal ClientHacks hack;

    public HTTPRequest (HTTPServer   http_server,
                        Soup.Server  server,
                        Soup.Message msg) {
        this.http_server = http_server;
        this.cancellable = new Cancellable ();
        this.root_container = http_server.root_container;
        this.server = server;
        this.msg = msg;

        try {
            this.hack = ClientHacks.create (msg);
        } catch (Error error) { }
    }

    public async void run () {
        this.server.pause_message (this.msg);

        try {
            this.uri = new HTTPItemURI.from_string (this.msg.uri.path,
                                                    this.http_server);

            yield this.find_item ();

            yield this.handle ();
        } catch (Error error) {
            this.handle_error (error);
        }

        // break probable cyclic references
        this.cancellable = null;
    }

    protected abstract async void handle () throws Error;

    protected virtual async void find_item () throws Error {
        // Fetch the requested item
        var media_object = yield this.root_container.find_object
                                        (this.uri.item_id, null);

        if (media_object == null ||
            !((media_object is MediaContainer &&
               this.uri.resource_name != null) ||
              (media_object is MediaFileItem))) {
            throw new HTTPRequestError.NOT_FOUND
                                        (_("Requested item “%s” not found"),
                                         this.uri.item_id);
        }

        this.object = media_object;
    }

    protected void handle_error (Error error) {
        warning ("%s", error.message);
        this.server.unpause_message (this.msg);

        uint status;
        if (error is HTTPRequestError) {
            status = error.code;
        } else {
            status = Soup.Status.NOT_FOUND;
        }

        this.end (status, error.message);
    }

    protected void end (uint status, string ? reason = null) {
        if (status != Soup.Status.NONE) {
            if (reason == null) {
                this.msg.set_status (status);
            } else {
                this.msg.set_status_full (status, reason);
            }
        }

        this.completed ();
    }
}
