Object HttpRequest

http request message object

Inheritance

Constructor

HttpRequest

HttpRequest constructor to create a new HttpRequest object

1
new HttpRequest();

constant

TEXT

Specify message type 1, representing a text type

1
const HttpRequest.TEXT = 1;

BINARY

Specify message type 2, representing a binary type

1
const HttpRequest.BINARY = 2;

Member attribute

response

HttpResponse , get response message object

1
readonly HttpResponse HttpRequest.response;

method

String, query and set request method

1
String HttpRequest.method;

address

String, query and set request address

1
String HttpRequest.address;

queryString

String, query and set request query string

1
String HttpRequest.queryString;

cookies

HttpCollection , get a container containing message cookies

1
readonly HttpCollection HttpRequest.cookies;

form

HttpCollection , get the container containing the message form

1
readonly HttpCollection HttpRequest.form;

query

HttpCollection , Get the container containing the message query

1
readonly HttpCollection HttpRequest.query;

protocol

String, protocol version information, the allowed format is: HTTP/#.#

1
String HttpRequest.protocol;

headers

HttpCollection , the container that contains the http header in the message, read-only attribute

1
readonly HttpCollection HttpRequest.headers;

keepAlive

Boolean, query and set whether to stay connected

1
Boolean HttpRequest.keepAlive;

upgrade

Boolean, query and set whether it is an upgrade agreement

1
Boolean HttpRequest.upgrade;

maxHeadersCount

Integer, query and set the maximum number of request headers, the default is 128

1
Integer HttpRequest.maxHeadersCount;

maxBodySize

Integer, query and set the maximum body size, in MB, the default is 64

1
Integer HttpRequest.maxBodySize;

socket

Stream , query the source socket of the current object

1
readonly Stream HttpRequest.socket;

value

String, the basic content of the message

1
String HttpRequest.value;

params

NArray, the basic parameters of the message

1
readonly NArray HttpRequest.params;

type

Integer, message type

1
Integer HttpRequest.type;

data

Value, query message data

1
readonly Value HttpRequest.data;

body

SeekableStream , a stream object containing the message data part

1
SeekableStream HttpRequest.body;

length

Long, the length of the message data part

1
readonly Long HttpRequest.length;

stream

Stream , the stream object when querying the message readFrom

1
readonly Stream HttpRequest.stream;

lastError

String, the last error of querying and setting message processing

1
String HttpRequest.lastError;

Member function

hasHeader

Check if there is a message header for the specified key

1
Boolean HttpRequest.hasHeader(String name);

Call parameters:

• name : String, specify the key to check

Return result:

• Boolean , returns whether the key value exists

firstHeader

Query the first message header of the specified key

1
String HttpRequest.firstHeader(String name);

Call parameters:

• name : String, specify the key to query

Return result:

• String , returns the value corresponding to the key value, or undefined if it does not exist

allHeader

Query all message headers of the specified key

1
NObject HttpRequest.allHeader(String name = "");

Call parameters:

• name : String, specify the key value to be queried, pass an empty string to return the result of all key values

Return result:

• NObject , returns an array of all values ​​corresponding to the key value, or null if the data does not exist

addHeader

Add a message header, adding data does not modify the message header of the existing key

1
HttpRequest.addHeader(Object map);

Call parameters:

• map : Object, specifies the key-value data dictionary to be added

Add a set of message headers with the specified name, add data without modifying the existing header of the key value

1
2
HttpRequest.addHeader(String name,
    Array values);

Call parameters:

• name : String, specify the key to add
• values : Array, specifies a set of data to be added

Add a message header, adding data does not modify the message header of the existing key

1
2
HttpRequest.addHeader(String name,
    String value);

Call parameters:

• name : String, specify the key to add
• value : String, specify the data to be added

setHeader

Set a message header, the setting data will modify the first value corresponding to the key value, and clear the remaining message headers of the same key value

1
HttpRequest.setHeader(Object map);

Call parameters:

• map : Object, specifies the key-value data dictionary to be set

Set a group of message headers with the specified name, the setting data will modify the value corresponding to the key value, and clear the remaining message headers of the same key value

1
2
HttpRequest.setHeader(String name,
    Array values);

Call parameters:

• name : String, specify the key to be set
• values : Array, specify a set of data to be set

Set a message header, the setting data will modify the first value corresponding to the key value, and clear the remaining message headers of the same key value

1
2
HttpRequest.setHeader(String name,
    String value);

Call parameters:

• name : String, specify the key to be set
• value : String, specify the data to be set

removeHeader

Delete all message headers for the specified key

1
HttpRequest.removeHeader(String name);

Call parameters:

• name : String, specify the key to delete

read

Read the data of the specified size from the stream, this method is an alias for the corresponding method of body

1
Buffer HttpRequest.read(Integer bytes = -1) async;

Call parameters:

• bytes : Integer, specifies the amount of data to be read, the default is to read data blocks of random size, the size of the data read depends on the device

Return result:

• Buffer , returns the data read from the stream, or null if no data is readable, or the connection is interrupted

readAll

Read all the remaining data from the stream, this method is an alias for the corresponding method of body

1
Buffer HttpRequest.readAll() async;

Return result:

• Buffer , returns the data read from the stream, or null if no data is readable, or the connection is interrupted

write

Write the given data, this method is an alias for the corresponding method of body

1
HttpRequest.write(Buffer data) async;

Call parameters:

• data : Buffer , given the data to be written

json

Write the given data in JSON encoding

1
Value HttpRequest.json(Value data);

Call parameters:

• data : Value, given the data to be written

Return result:

• Value , this method does not return data

Parse the data in the message in JSON encoding

1
Value HttpRequest.json();

Return result:

• Value , return the parsed result

end

Set the current message processing to end, the Chain processor will not continue the subsequent transaction

1
HttpRequest.end();

isEnded

Check if the current message is over

1
Boolean HttpRequest.isEnded();

Return result:

• Boolean , return true at the end

clear

Clear the content of the message

1
HttpRequest.clear();

sendTo

Send formatted messages to the given stream object

1
HttpRequest.sendTo(Stream stm) async;

Call parameters:

• stm : Stream , specify the stream object to receive formatted messages

readFrom

Read the formatted message from the given cache stream object and parse the fill object

1
HttpRequest.readFrom(Stream stm) async;

Call parameters:

• stm : Stream , specify a stream object to read formatted messages

toString

Returns the string representation of the object, generally returns "[Native Object]", the object can be reimplemented according to its own characteristics

1
String HttpRequest.toString();

Return result:

• String , returns a string representation of the object

toJSON

Returns the JSON format representation of the object, generally returns a collection of readable attributes defined by the object

1
Value HttpRequest.toJSON(String key = "");

Call parameters:

• key : String, unused

Return result:

• Value , returns a value containing JSON serializable