httpPut

Home > Books > NetKernel API and Services Reference > Accessor Listing > HTTP Client Services > httpPut

Module

urn:org:ten60:netkernel:ext:http:client

The httpPut accessor is exported by the urn:org:ten60:netkernel:ext:http:client module. Import this module to gain access to the accessor.

Syntax

URI

active:httpPut

Argument	Rules	Description
url	Mandatory	the URL to issue the request to.
config	Optional	an optional config resource
state	Optional	an optional state resource
arg	Mandatory	an argument to send to the remote server

Example Usage

DPML

<instr>
  <type>httpPut</type>
  <url>http://www.1060research.com</url>
  <state>var:mystate</state>
  <arg>myImage.png</arg>
</instr>

NetKernel Foundation API

req=context.createSubRequest("active:httpPut");
req.addArgument("url", [resource representation, aspect, or URI] );
req.addArgument("arg", [resource representation, aspect, or URI] );
result=context.issueSubRequest(req);

Purpose

Issues an HTTP PUT request for the given url.

The optional state argument is used to store client-side state information.

The arg argument is added to the request body and sent as the PUT resource to the url.

Client-Side State

Interactions with the remote server are stateless unless a resource is provided as the optional state argument. Please refer to the httpState guide for details.

Header field interpretation

See httpGet for more details.

Config

Configuration information is provided as the config argument. If this is missing the service will request configuration information from the address ffcpl:/etc/HTTPClientConfig.xml. If this is missing the following default is used:

<config>
  <proxyHost>proxy.mydomain.com</proxyHost>
  <proxyPort>80</proxyPort>
  <followRedirects>true</followRedirects>
  <retryAttempts>3</retryAttempts>
  <maxConnectionsPerHost>4</maxConnectionsPerHost>
  <maxTotalConnections>10</maxTotalConnections>
  <maxAcceptableContentLength>-1</maxAcceptableContentLength>
  <stateExpirationTime>600</stateExpirationTime>
  <connectTimeout>2000</connectTimeout>
  <timeout>5000</timeout>
</config>

Each configuration element is optional, if not specified the default values (above) will be used. The parameters are as follows:

proxyHost	hostname of proxy server
proxyPort	port of proxy server
followRedirects	follow HTTP redirect response codes
retryAttempts	number of attempts to make connection before failing
maxConnectionsPerHost	maximum simultaneous connections to make to a single host
maxTotalConneciton	max total connections
maxAcceptableConentLength	largest resource to handle in response, -1 indicates accept any size.
stateExpirationTime	time for client side state to be valid.
connectTimeout	time to allow for a connection to be established with server before failing
timeout	time to allow an established connection to remain idle before failing

Proxy settings will be taken from the global system proxy settings if they are not specified in the config.

Requesting an HTTPResponseCode

If the accessor is requested to return an HTTPResponseCodeAspect aspect (see NKFRequest) then the accessor will always return a HTTPResponseCodeAspect containing the HTTP code and body response - this can be valuable for testing purposes.

Example

<instr>
  <type>httpPut</type>
  <url>http://www.someserver.com/images/myPicture.gif</url>
  <arg>somePicture.gif</arg>
  <target>this:response</target>
</instr>