: iClient(&aClient), iServerName(aServerName), iServerAddress(), iServerPort(aServerPort),

iConnectionClose(true), iSendDefaultRequestHeaders(true)

{

resetState();

: iClient(&aClient), iServerName(NULL), iServerAddress(aServerAddress), iServerPort(aServerPort),

iConnectionClose(true), iSendDefaultRequestHeaders(true)

{

resetState();

{

iState = eIdle;

iStatusCode = 0;

iContentLength = kNoContentLengthHeader;

iBodyLengthConsumed = 0;

iContentLengthPtr = kContentLengthPrefix;

iHttpResponseTimeout = kHttpResponseTimeout;

{

iClient->stop();

resetState();

const char* aContentType, int aContentLength, const byte aBody[])

{

if (iState == eReadingBody)

{

flushClientRx();

resetState();

}

tHttpState initialState = iState;

if ((eIdle != iState) && (eRequestStarted != iState))

{

return HTTP_ERROR_API;

}

if (iConnectionClose || !iClient->connected())

{

if (iServerName)

{

if (!iClient->connect(iServerName, iServerPort) > 0)

{

#ifdef LOGGING

Serial.println("Connection failed");

#endif

return HTTP_ERROR_CONNECTION_FAILED;

}

}

else

{

if (!iClient->connect(iServerAddress, iServerPort) > 0)

{

#ifdef LOGGING

Serial.println("Connection failed");

#endif

return HTTP_ERROR_CONNECTION_FAILED;

}

}

}

else

{

#ifdef LOGGING

Serial.println("Connection already open");

#endif

}

// Now we're connected, send the first part of the request

int ret = sendInitialHeaders(aURLPath, aHttpMethod);

if (HTTP_SUCCESS == ret)

{

if (aContentType)

{

sendHeader(HTTP_HEADER_CONTENT_TYPE, aContentType);

}

if (aContentLength > 0)

{

sendHeader(HTTP_HEADER_CONTENT_LENGTH, aContentLength);

}

bool hasBody = (aBody && aContentLength > 0);

if (initialState == eIdle || hasBody)

{

// This was a simple version of the API, so terminate the headers now

finishHeaders();

}

// else we'll call it in endRequest or in the first call to print, etc.

if (hasBody)

{

write(aBody, aContentLength);

}

}

return ret;

{

#ifdef LOGGING

Serial.println("Connected");

#endif

// Send the HTTP command, i.e. "GET /somepath/ HTTP/1.0"

iClient->print(aHttpMethod);

iClient->print(" ");

iClient->print(aURLPath);

iClient->println(" HTTP/1.1");

if (iSendDefaultRequestHeaders)

{

// The host header, if required

if (iServerName)

{

iClient->print("Host: ");

iClient->print(iServerName);

if (iServerPort != kHttpPort)

{

iClient->print(":");

iClient->print(iServerPort);

}

iClient->println();

}

// And user-agent string

sendHeader(HTTP_HEADER_USER_AGENT, kUserAgent);

}

if (iConnectionClose)

{

// Tell the server to

// close this connection after we're done

sendHeader(HTTP_HEADER_CONNECTION, "close");

}

// Everything has gone well

iState = eRequestStarted;

return HTTP_SUCCESS;

{

iClient->print(aHeaderName);

iClient->print(": ");

iClient->println(aHeaderValue);

{

iClient->print(aHeaderName);

iClient->print(": ");

iClient->println(aHeaderValue);

{

// Send the initial part of this header line

iClient->print("Authorization: Basic ");

// Now Base64 encode "aUser:aPassword" and send that

// This seems trickier than it should be but it's mostly to avoid either

// (a) some arbitrarily sized buffer which hopes to be big enough, or

// (b) allocating and freeing memory

// ...so we'll loop through 3 bytes at a time, outputting the results as we

// go.

// In Base64, each 3 bytes of unencoded data become 4 bytes of encoded data

unsigned char input[3];

unsigned char output[5]; // Leave space for a '\0' terminator so we can easily print

int userLen = strlen(aUser);

int passwordLen = strlen(aPassword);

int inputOffset = 0;

for (int i = 0; i < (userLen+1+passwordLen); i++)

{

// Copy the relevant input byte into the input

if (i < userLen)

{

input[inputOffset++] = aUser[i];

}

else if (i == userLen)

{

input[inputOffset++] = ':';

}

else

{

input[inputOffset++] = aPassword[i-(userLen+1)];

}

// See if we've got a chunk to encode

if ( (inputOffset == 3) || (i == userLen+passwordLen) )

{

// We've either got to a 3-byte boundary, or we've reached then end

b64_encode(input, inputOffset, output, 4);

// NUL-terminate the output string

output[4] = '\0';

// And write it out

iClient->print((char*)output);

inputOffset = 0;

}

}

// And end the header we've sent

iClient->println();

{

iClient->println();

iState = eRequestSent;

{

while (iClient->available())

{

iClient->read();

}

{

if (iState < eRequestSent)

{

// We still need to finish off the headers

finishHeaders();

}

// else the end of headers has already been sent, so nothing to do here

{

if (iState < eRequestSent)

{

return HTTP_ERROR_API;

}

// The first line will be of the form Status-Line:

// HTTP-Version SP Status-Code SP Reason-Phrase CRLF

// Where HTTP-Version is of the form:

// HTTP-Version = "HTTP" "/" 1*DIGIT "." 1*DIGIT

int c = '\0';

do

{

// Make sure the status code is reset, and likewise the state. This

// lets us easily cope with 1xx informational responses by just

// ignoring them really, and reading the next line for a proper response

iStatusCode = 0;

iState = eRequestSent;

unsigned long timeoutStart = millis();

// Psuedo-regexp we're expecting before the status-code

const char* statusPrefix = "HTTP/*.* ";

const char* statusPtr = statusPrefix;

// Whilst we haven't timed out & haven't reached the end of the headers

while ((c != '\n') &&

( (millis() - timeoutStart) < iHttpResponseTimeout ))

{

if (available())

{

c = read();

if (c != -1)

{

switch(iState)

{

case eRequestSent:

// We haven't reached the status code yet

if ( (*statusPtr == '*') || (*statusPtr == c) )

{

// This character matches, just move along

statusPtr++;

if (*statusPtr == '\0')

{

// We've reached the end of the prefix

iState = eReadingStatusCode;

}

}

else

{

return HTTP_ERROR_INVALID_RESPONSE;

}

break;

case eReadingStatusCode:

if (isdigit(c))

{

// This assumes we won't get more than the 3 digits we

// want

iStatusCode = iStatusCode*10 + (c - '0');

}

else

{

// We've reached the end of the status code

// We could sanity check it here or double-check for ' '

// rather than anything else, but let's be lenient

iState = eStatusCodeRead;

}

break;

case eStatusCodeRead:

// We're just waiting for the end of the line now

break;

default:

break;

};

// We read something, reset the timeout counter

timeoutStart = millis();

}

}

else

{

// We haven't got any data, so let's pause to allow some to

// arrive

delay(kHttpWaitForDataDelay);

}

}

if ( (c == '\n') && (iStatusCode < 200 && iStatusCode != 101) )

{

// We've reached the end of an informational status line

c = '\0'; // Clear c so we'll go back into the data reading loop

}

}

// If we've read a status code successfully but it's informational (1xx)

// loop back to the start

while ( (iState == eStatusCodeRead) && (iStatusCode < 200 && iStatusCode != 101) );

if ( (c == '\n') && (iState == eStatusCodeRead) )

{

// We've read the status-line successfully

return iStatusCode;

}

else if (c != '\n')

{

// We must've timed out before we reached the end of the line

return HTTP_ERROR_TIMED_OUT;

}

else

{

// This wasn't a properly formed status line, or at least not one we

// could understand

return HTTP_ERROR_INVALID_RESPONSE;

}

{

// Just keep reading until we finish reading the headers or time out

unsigned long timeoutStart = millis();

// Whilst we haven't timed out & haven't reached the end of the headers

while ((!endOfHeadersReached()) &&

( (millis() - timeoutStart) < iHttpResponseTimeout ))

{

if (available())

{

(void)readHeader();

// We read something, reset the timeout counter

timeoutStart = millis();

}

else

{

// We haven't got any data, so let's pause to allow some to

// arrive

delay(kHttpWaitForDataDelay);

}

}

if (endOfHeadersReached())

{

// Success

return HTTP_SUCCESS;

}

else

{

// We must've timed out

return HTTP_ERROR_TIMED_OUT;

}

{

// skip the response headers, if they haven't been read already

if (!endOfHeadersReached())

{

skipResponseHeaders();

}

return iContentLength;

{

int bodyLength = contentLength();

String response;

if (bodyLength > 0)

{

// try to reserve bodyLength bytes

if (response.reserve(bodyLength) == 0) {

// String reserve failed

return String((const char*)NULL);

}

}

// keep on timedRead'ing, until:

// - we have a content length: body length equals consumed or no bytes

// available

// - no content length: no bytes are available

while (iBodyLengthConsumed != bodyLength)

{

int c = timedRead();

if (c == -1) {

// read timed out, done

break;

}

if (!response.concat((char)c)) {

// adding char failed

return String((const char*)NULL);

}

}

if (bodyLength > 0 && (unsigned int)bodyLength != response.length()) {

// failure, we did not read in reponse content length bytes

return String((const char*)NULL);

}

return response;

{

if (endOfHeadersReached() && (contentLength() != kNoContentLengthHeader))

{

// We've got to the body and we know how long it will be

return (iBodyLengthConsumed >= contentLength());

}

return false;

{

int ret = iClient->read();

if (ret >= 0)

{

if (endOfHeadersReached() && iContentLength > 0)

{

// We're outputting the body now and we've seen a Content-Length header

// So keep track of how many bytes are left

iBodyLengthConsumed++;

}

}

return ret;

{

// clear the currently store header line

iHeaderLine = "";

while (!endOfHeadersReached())

{

// read a byte from the header

int c = readHeader();

if (c == '\r' || c == '\n')

{

if (iHeaderLine.length())

{

// end of the line, all done

break;

}

else

{

// ignore any CR or LF characters

continue;

}

}

// append byte to header line

iHeaderLine += (char)c;

}

return (iHeaderLine.length() > 0);

{

int colonIndex = iHeaderLine.indexOf(':');

if (colonIndex == -1)

{

return "";

}

return iHeaderLine.substring(0, colonIndex);

{

int colonIndex = iHeaderLine.indexOf(':');

int startIndex = colonIndex + 1;

if (colonIndex == -1)

{

return "";

}

// trim any leading whitespace

while (startIndex < (int)iHeaderLine.length() && isSpace(iHeaderLine[startIndex]))

{

startIndex++;

}

return iHeaderLine.substring(startIndex);

{

int ret =iClient->read(buf, size);

if (endOfHeadersReached() && iContentLength > 0)

{

// We're outputting the body now and we've seen a Content-Length header

// So keep track of how many bytes are left

if (ret >= 0)

{

iBodyLengthConsumed += ret;

}

}

return ret;

{

char c = read();

if (endOfHeadersReached())

{

// We've passed the headers, but rather than return an error, we'll just

// act as a slightly less efficient version of read()

return c;

}

// Whilst reading out the headers to whoever wants them, we'll keep an

// eye out for the "Content-Length" header

switch(iState)

{

case eStatusCodeRead:

// We're at the start of a line, or somewhere in the middle of reading

// the Content-Length prefix

if (*iContentLengthPtr == c)

{

// This character matches, just move along

iContentLengthPtr++;

if (*iContentLengthPtr == '\0')

{

// We've reached the end of the prefix

iState = eReadingContentLength;

// Just in case we get multiple Content-Length headers, this

// will ensure we just get the value of the last one

iContentLength = 0;

iBodyLengthConsumed = 0;

}

}

else if ((iContentLengthPtr == kContentLengthPrefix) && (c == '\r'))

{

// We've found a '\r' at the start of a line, so this is probably

// the end of the headers

iState = eLineStartingCRFound;

}

else

{

// This isn't the Content-Length header, skip to the end of the line

iState = eSkipToEndOfHeader;

}

break;

case eReadingContentLength:

if (isdigit(c))

{

iContentLength = iContentLength*10 + (c - '0');

}

else

{

// We've reached the end of the content length

// We could sanity check it here or double-check for "\r\n"

// rather than anything else, but let's be lenient

iState = eSkipToEndOfHeader;

}

break;

case eLineStartingCRFound:

if (c == '\n')

{

iState = eReadingBody;

}

break;

default:

// We're just waiting for the end of the line now

break;

};

if ( (c == '\n') && !endOfHeadersReached() )

{

// We've got to the end of this line, start processing again

iState = eStatusCodeRead;

iContentLengthPtr = kContentLengthPrefix;

}

// And return the character read to whoever wants it

return c;