This patch will allow custom HTTP headers to be added as contextual properties. For example, the developer could set the header(s) like this:

Client client = Client.getInstance(soap)
Map m = new HashMap();
m.put("routing.key", "target");
m.put("test-header", new String[]{"test1", "test2"} );
client.setProperty(CommonsHttpMessageSender.HTTP_HEADERS, m );

this would produce the following headers:

routing.key: target
test-header: test1
test-header: test2

The map can have either (String, String) or (String, String[]) since we are allowed to have headers with the same name.

Map headersMap = (Map) context.getContextualProperty(HTTP_HEADERS);
if (headersMap != null) {
for (Iterator iter = headersMap.entrySet().iterator(); iter.hasNext() { Map.Entry entry = (Entry) iter.next(); postMethod.addRequestHeader(entry.getKey().toString(), entry.getValue().toString()); }
}

I like the Object.toString()! That could come in handy.

Is the support for several headers (so checking for instanceof Object[]) with the same name not desirable?

Just curious if the String[] idea was a bad one.