pivot.web
Class PostQuery

java.lang.Object
  extended by pivot.util.concurrent.Task<V>
      extended by pivot.io.IOTask<V>
          extended by pivot.web.Query<java.net.URL>
              extended by pivot.web.PostQuery

public class PostQuery
extends Query<java.net.URL>

Executes an HTTP POST operation.

Author:
gbrown

Nested Class Summary
 
Nested classes/interfaces inherited from class pivot.web.Query
Query.ArgumentsDictionary, Query.Method, Query.RequestPropertiesDictionary, Query.ResponsePropertiesDictionary
 
Nested classes/interfaces inherited from class pivot.io.IOTask
IOTask.MonitoredInputStream, IOTask.MonitoredOutputStream
 
Field Summary
 
Fields inherited from class pivot.web.Query
DEFAULT_PORT
 
Fields inherited from class pivot.io.IOTask
bytesReceived, bytesSent
 
Fields inherited from class pivot.util.concurrent.Task
abort, timeout
 
Constructor Summary
PostQuery(java.lang.String hostname, int port, java.lang.String path, boolean secure)
           
PostQuery(java.lang.String hostname, java.lang.String path)
           
 
Method Summary
 java.net.URL execute()
          Synchronously executes the POST operation.
 java.lang.Object getValue()
          Returns the value that will be POSTed to the server when the query is executed.
 void setValue(java.lang.Object value)
          Sets the value that will be POSTed to the server when the query is executed.
 
Methods inherited from class pivot.web.Query
execute, getArguments, getBytesExpected, getBytesReceived, getBytesSent, getHostname, getHostnameVerifier, getLocation, getPath, getPort, getQueryListeners, getRequestProperties, getResponseProperties, getSerializer, isSecure, setHostnameVerifier, setSerializer
 
Methods inherited from class pivot.util.concurrent.Task
abort, execute, getDispatcher, getFault, getResult, getTimeout, isPending, setTimeout
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PostQuery

public PostQuery(java.lang.String hostname,
                 java.lang.String path)

PostQuery

public PostQuery(java.lang.String hostname,
                 int port,
                 java.lang.String path,
                 boolean secure)
Method Detail

getValue

public java.lang.Object getValue()
Returns the value that will be POSTed to the server when the query is executed.


setValue

public void setValue(java.lang.Object value)
Sets the value that will be POSTed to the server when the query is executed.

Parameters:
value - The value to POST to the server.

execute

public java.net.URL execute()
                     throws QueryException
Synchronously executes the POST operation.

Specified by:
execute in class Task<java.net.URL>
Returns:
A URL that uniquely identifies the location of the resource created on the server by the operation, or null if the server did not return a location.
Throws:
QueryException