...
Info | ||
---|---|---|
| ||
You can only produce to endpoints generated by the HTTP4 component. Therefore it should never be used as input into your Camel Routes. To bind/expose an HTTP endpoint via a HTTP server as input to a Camel route, use the Jetty Component instead. |
HttpComponent Options
...
Name | Default Value | Description |
---|---|---|
| | The maximum number of connections. |
| | The maximum number of connections per route. |
| | Camel 2.11.2/2.12.0: |
...
To |
...
use |
...
a |
...
custom |
...
|
...
. |
...
By |
...
default |
...
the |
...
|
...
is |
...
used |
...
which |
...
is |
...
an |
...
in-memory |
...
only |
...
cookie |
...
store. |
...
Notice |
...
if |
...
|
...
then |
...
the |
...
cookie |
...
store |
...
is |
...
forced |
...
to |
...
be |
...
a |
...
noop |
...
cookie |
...
store |
...
as |
...
cookies |
...
shouldn't |
...
be |
...
stored |
...
as |
...
we |
...
are |
...
just |
...
bridging |
...
(eg |
...
acting |
...
as |
...
a |
...
proxy). |
...
| | Reference to a |
...
in |
...
the |
...
...
. | ||
| | To use a custom |
...
. | ||
| | To use a custom |
...
. | ||
| | Camel 2.9.2: |
...
To |
...
use |
...
a |
...
custom |
...
|
...
when |
...
executing |
...
requests. |
...
| | Camel 2.8: |
...
To |
...
use |
...
a |
...
custom |
...
|
...
. See Using the JSSE Configuration Utility. Important: Only one instance of |
...
is |
...
supported |
...
per |
...
HttpComponent. |
...
If |
...
you |
...
need |
...
to |
...
use |
...
2 |
...
or |
...
more |
...
different |
...
instances, |
...
you |
...
need |
...
to |
...
define |
...
a |
...
new |
...
HttpComponent |
...
per |
...
instance |
...
you |
...
need. |
...
See |
...
further |
...
below |
...
for |
...
more |
...
details. |
...
| | Camel 2.7: |
...
You |
...
can |
...
refer |
...
to |
...
a |
...
different |
...
|
...
instance |
...
in |
...
the |
...
...
such |
...
as |
...
|
...
or |
...
|
...
. | ||
| | Camel 2.11.0: |
...
The |
...
time |
...
for |
...
connection |
...
to |
...
live, |
...
the |
...
time |
...
unit |
...
is |
...
millisecond, |
...
the |
...
default |
...
value |
...
is |
...
always |
...
keep |
...
alive. |
...
| | Camel 2.11.3/2.12.2: |
...
If |
...
this |
...
option |
...
is |
...
true, |
...
camel-http4 |
...
sends |
...
preemptive |
...
basic |
...
authentication |
...
to |
...
the |
...
server. |
...
HttpEndpoint Options
...
Name | Default Value | Description |
---|---|---|
| | Option to disable throwing the |
| | If true, HttpProducer will ignore the |
...
Exchange.HTTP_URI |
...
header, |
...
and |
...
use |
...
the |
...
endpoint's |
...
URI |
...
for |
...
request. |
...
You |
...
may |
...
also |
...
set |
...
the |
...
throwExcpetionOnFailure |
...
to |
...
be |
...
false |
...
to |
...
let |
...
the |
...
HttpProducer |
...
send |
...
all |
...
fault |
...
responses |
...
back. |
...
Also |
...
if |
...
set |
...
to |
...
true |
...
HttpProducer |
...
and |
...
CamelServlet |
...
will |
...
skip |
...
the |
...
gzip |
...
processing |
...
if |
...
the |
...
content-encoding |
...
is |
...
"gzip". |
...
| | Camel 2.11.2/2.12.0: |
...
Whether |
...
to |
...
clear |
...
expired |
...
cookies |
...
before |
...
sending |
...
the |
...
HTTP |
...
request. |
...
This |
...
ensures |
...
the |
...
cookies |
...
store |
...
does |
...
not |
...
keep |
...
growing |
...
by |
...
adding |
...
new |
...
cookies |
...
which |
...
is |
...
newer |
...
removed |
...
when |
...
they |
...
are |
...
expired. |
...
| | Camel 2.11.2/2.12.0: |
...
To |
...
use |
...
a |
...
custom |
...
|
...
. |
...
By |
...
default |
...
the |
...
|
...
is |
...
used |
...
which |
...
is |
...
an |
...
in-memory |
...
only |
...
cookie |
...
store. |
...
Notice |
...
if |
...
|
...
then |
...
the |
...
cookie |
...
store |
...
is |
...
forced |
...
to |
...
be |
...
a |
...
noop |
...
cookie |
...
store |
...
as |
...
cookies |
...
shouldn't |
...
be |
...
stored |
...
as |
...
we |
...
are |
...
just |
...
bridging |
...
(eg |
...
acting |
...
as |
...
a |
...
proxy). |
...
| | DefaultHttpBinding will copy the request input stream into a stream cache and put it into the message body if this option is false to support multiple reads, otherwise DefaultHttpBinding will set the request input stream directly in the message body. |
| | Camel 2.10.4: |
...
Reference |
...
to |
...
a |
...
instance |
...
of |
...
|
...
in |
...
the |
...
...
. |
...
It will |
...
be |
...
used |
...
to |
...
apply |
...
the |
...
custom |
...
headerFilterStrategy |
...
on |
...
the |
...
new |
...
create |
...
HttpEndpoint. |
...
| | Deprecated and will be removed in Camel 3.0: |
...
Reference |
...
to |
...
a |
...
|
...
in |
...
the |
...
...
. |
...
Use |
...
the | ||
| | To use a custom |
...
. | ||
| | Deprecated and will be removed in Camel 3.0: |
...
Reference |
...
to |
...
a |
...
|
...
in |
...
the |
...
...
. |
...
Use |
...
the |
...
|
...
option |
...
instead. |
...
| | Reference to a |
...
in |
...
the |
...
...
. | ||
| | Deprecated and will be removed in Camel 3.0: |
...
Camel |
...
2.9.2: |
...
Reference |
...
to |
...
a |
...
custom |
...
|
...
in |
...
the |
...
...
. |
...
Use |
...
the |
...
|
...
option |
...
instead. |
...
| | Camel 2.9.2: |
...
To |
...
use |
...
a |
...
custom |
...
|
...
when |
...
executing |
...
requests. |
...
|
...
| Setting options on the BasicHttpParams. For instance |
...
will |
...
set |
...
the |
...
|
...
to |
...
5 |
...
seconds. |
...
Look |
...
on |
...
the |
...
setter |
...
methods |
...
of |
...
the |
...
following |
...
parameter |
...
beans |
...
for |
...
a |
...
complete |
...
reference: |
...
AuthParamBean, ClientParamBean, ConnConnectionParamBean, ConnRouteParamBean, CookieSpecParamBean, HttpConnectionParamBean and HttpProtocolParamBean | ||
| | To use a custom |
...
. | ||
| | If enabled and an Exchange failed processing on the consumer side, and if the caused |
...
content |
...
type |
...
(for |
...
example |
...
using |
...
...
or |
...
...
Camel |
...
components). |
...
On |
...
the |
...
producer |
...
side |
...
the |
...
exception |
...
will |
...
be |
...
deserialized |
...
and |
...
thrown |
...
as |
...
is, |
...
instead |
...
of |
...
the |
...
|
...
. |
...
The |
...
caused |
...
exception |
...
is |
...
required |
...
to |
...
be |
...
serialized. |
...
| | Deprecated and will be removed in Camel 3.0: |
...
Camel |
...
2.8: |
...
Reference |
...
to |
...
a |
...
|
...
in |
...
the |
...
...
. |
...
Important: |
...
Only |
...
one |
...
instance |
...
of |
...
|
...
is |
...
supported |
...
per |
...
HttpComponent. |
...
If |
...
you |
...
need |
...
to |
...
use |
...
2 |
...
or |
...
more |
...
different |
...
instances, |
...
you |
...
need |
...
to |
...
define |
...
a |
...
new |
...
HttpComponent |
...
per |
...
instance |
...
you |
...
need. |
...
See |
...
further |
...
below |
...
for |
...
more |
...
details. |
...
See |
...
...
...
...
...
...
. |
...
Use |
...
the |
...
|
...
option |
...
instead. |
...
| | Camel 2.11.1: |
...
Reference |
...
to |
...
a |
...
|
...
in |
...
the |
...
...
. |
...
Important: |
...
Only |
...
one |
...
instance |
...
of |
...
|
...
is |
...
supported |
...
per |
...
HttpComponent. |
...
If |
...
you |
...
need |
...
to |
...
use |
...
2 |
...
or |
...
more |
...
different |
...
instances, |
...
you |
...
need |
...
to |
...
define |
...
a |
...
new |
...
HttpComponent |
...
per |
...
instance |
...
you |
...
need. |
...
See |
...
further |
...
below |
...
for |
...
more |
...
details. |
...
See |
...
...
...
...
...
...
. | ||
| | Camel 2.7: |
...
You |
...
can |
...
refer |
...
to |
...
a |
...
different |
...
|
...
instance |
...
in |
...
the |
...
...
such |
...
as |
...
|
...
or |
...
|
...
. | ||
| | Camel 2.11: |
...
Producer |
...
only |
...
Refers |
...
to |
...
a |
...
custom |
...
|
...
which |
...
allows |
...
you |
...
to |
...
rewrite |
...
urls |
...
when |
...
you |
...
bridge/proxy |
...
endpoints. |
...
See |
...
more |
...
details |
...
at |
...
...
and |
...
...
...
...
...
...
...
...
...
...
...
...
...
...
. |
...
The following authentication options can also be set on the HttpEndpoint:
Setting Basic Authentication and Proxy
Before Camel 2.8.0
...
Name | Default Value | Description |
---|---|---|
| | Username for authentication. |
| | Password for authentication. |
| | The domain name for authentication. |
| | The host name authentication. |
| | The proxy host name |
| | The proxy port number |
| | Username for proxy authentication |
| | Password for proxy authentication |
| | The proxy domain name |
| | The proxy Nt host name |
...
Since Camel 2.8.0
...
...
|| Name || Default Value || Description ||
| {{authUsername}} | {{null}} | Username for authentication |
| {{authPassword}} | {{null}} | Password for authentication |
| {{authDomain}} | {{null}} | The domain name for authentication |
| {{authHost}} | {{null}} | The host name authentication |
| {{proxyAuthHost}} | {{null}} | The proxy host name |
| {{proxyAuthPort}} | {{null}} | The proxy port number |
| {{proxyAuthScheme}} | {{null}} | The proxy scheme, will fallback and use the scheme from the endpoint if not configured. |
| {{proxyAuthUsername}} | {{null}} | Username for proxy authentication |
| {{proxyAuthPassword}} | {{null}} | Password for proxy authentication |
| {{proxyAuthDomain}} | {{null}} | The proxy domain name |
| {{proxyAuthNtHost}} | {{null}} | The proxy Nt host name |
Name | Default Value | Description |
---|---|---|
| | Username for authentication |
| | Password for authentication |
| | The domain name for authentication |
| | The host name authentication |
| | The proxy host name |
| | The proxy port number |
| | The proxy scheme, will fallback and use the scheme from the endpoint if not configured. |
| | Username for proxy authentication |
| | Password for proxy authentication |
| | The proxy domain name |
| | The proxy Nt host name |
Message Headers
Name | Type | Description |
---|---|---|
| | URI to call. Will override existing URI set directly on the endpoint. |
| | Request URI's path, the header will be used to build the request URI with the HTTP_URI. |
| | URI parameters. Will override existing URI parameters set directly on the endpoint. |
| | The HTTP response code from the external server. Is 200 for OK. |
| | Character encoding. |
| | The HTTP content type. Is set on both the IN and OUT message to provide a content type, such as |
| | The HTTP content encoding. Is set on both the IN and OUT message to provide a content encoding, such as |
Message Headers
...
Message Body
Camel will store the HTTP response from the external server on the OUT body. All headers from the IN message will be copied to the OUT message, so headers are preserved during routing. Additionally Camel will add the HTTP response headers as well to the OUT message headers.
...