123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121 |
|
/*******************************************************************************
copyright: Copyright (c) 2004 Kris Bell. All rights reserved
license: BSD style: $(LICENSE)
version: Initial release: January 2006
author: Kris
*******************************************************************************/
module tango.net.http.HttpPost;
public import tango.net.Uri;
private import tango.io.model.IConduit;
private import tango.net.http.HttpClient,
tango.net.http.HttpHeaders;
/*******************************************************************************
Supports the basic needs of a client sending POST requests to a
HTTP server. The following is a usage example:
---
// open a web-page for posting (see HttpGet for simple reading)
auto post = new HttpPost ("http://yourhost/yourpath");
// send, retrieve and display response
Cout (cast(char[]) post.write("posted data", "text/plain"));
---
*******************************************************************************/
class HttpPost : HttpClient
{
/***********************************************************************
Create a client for the given URL. The argument should be
fully qualified with an "http:" or "https:" scheme, or an
explicit port should be provided.
***********************************************************************/
this (char[] url)
{
this (new Uri(url));
}
/***********************************************************************
Create a client with the provided Uri instance. The Uri should
be fully qualified with an "http:" or "https:" scheme, or an
explicit port should be provided.
***********************************************************************/
this (Uri uri)
{
super (HttpClient.Post, uri);
// enable header duplication
getResponseHeaders.retain (true);
}
/***********************************************************************
Send query params only
***********************************************************************/
void[] write ()
{
return write (null);
}
/***********************************************************************
Send raw data via the provided pump, and no query
params. You have full control over headers and so
on via this method.
***********************************************************************/
void[] write (Pump pump)
{
auto buffer = super.open (pump);
try {
// check return status for validity
auto status = super.getStatus;
if (status is HttpResponseCode.OK ||
status is HttpResponseCode.Created ||
status is HttpResponseCode.Accepted)
buffer.load (getResponseHeaders.getInt (HttpHeader.ContentLength));
} finally {close;}
return buffer.slice;
}
/***********************************************************************
Send content and no query params. The contentLength header
will be set to match the provided content, and contentType
set to the given type.
***********************************************************************/
void[] write (void[] content, char[] type)
{
auto headers = super.getRequestHeaders;
headers.add (HttpHeader.ContentType, type);
headers.addInt (HttpHeader.ContentLength, content.length);
return write ((OutputBuffer b){b.append(content);});
}
}
|