use header::{Header, HeaderFormat};
use std::fmt::{mod, Show};
use super::util::from_one_raw_str;

/// The `Location` header.
///
/// The Location response-header field is used to redirect the recipient to
/// a location other than the Request-URI for completion of the request or identification
/// of a new resource. For 201 (Created) responses, the Location is that of the new
/// resource which was created by the request. For 3xx responses, the location SHOULD
/// indicate the server's preferred URI for automatic redirection to the resource.
/// The field value consists of a single absolute URI.
///
/// Currently is just a String, but it should probably become a better type,
/// like url::Url or something.
#[deriving(Clone, PartialEq, Show)]
pub struct Location(pub String);

impl Header for Location {
    fn header_name(_: Option<Location>) -> &'static str {
        "Location"
    }

    fn parse_header(raw: &[Vec<u8>]) -> Option<Location> {
        from_one_raw_str(raw).map(|s| Location(s))
    }
}

impl HeaderFormat for Location {
    fn fmt_header(&self, fmt: &mut fmt::Formatter) -> fmt::Result {
        let Location(ref value) = *self;
        value.fmt(fmt)
    }
}

bench_header!(bench, Location, { vec![b"http://foo.com/hello:3000".to_vec()] })

