FormPoster (Oracle WebCenter Sites Java API Reference)

java.lang.Object
- COM.FutureTense.Util.FormPoster

Deprecated.
Use HttpAccess APIs instead
```
public class FormPoster
extends Object
```
This class allows for the construction and posting of multipart mime encoded messages much as would be sent from a web browser posting the results of an HTML form

Version:

$Revision: 62 $

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`Connect` Deprecated. CONNECT action
`static String`	`Delete` Deprecated. DELETE action
`static int`	`ERRORBADRESPONSE` Deprecated. Error server response did not contain handshake code
`static int`	`ERRORFILEIO` Deprecated. File I/O error
`static int`	`ERRORGENERAL` Deprecated. General error
`static int`	`ERRORILLEGALDATAFORACTION` Deprecated. File data used with Get Method error
`static int`	`ERRORNETDISCONNECT` Deprecated. Error network disconnected
`static int`	`ERRORNOCONSERVER` Deprecated. Error can't connect to server
`static int`	`ERRORNOTAUTHENTICATED` Deprecated. Server certificate does not match what is expected
`static int`	`ERRORNOURLPARAM` Deprecated. Error bad URL input params
`static int`	`ERROROUTOFMEMORY` Deprecated. Error - out of memory reading a server response
`static int`	`ERRORSUCCESS` Deprecated. Error success
`static int`	`ERRORTIMEOUT` Deprecated. Error network timeout forced
`static String`	`Get` Deprecated. GET action
`static String`	`Head` Deprecated. HEAD action
`static String`	`HTTP_ACCEPT_CHARSET` Deprecated.
`static String`	`HTTP_ACCEPT_LANGUAGE` Deprecated.
`static String`	`HTTP_ACCEPT_MIME_TYPES` Deprecated.
`static String`	`HTTP_CONNECTION` Deprecated.
`static String`	`HTTP_CONTENT_LENGTH` Deprecated.
`static String`	`HTTP_CONTENT_TYPE` Deprecated.
`static String`	`HTTP_CONTENT_TYPE_CHARSET` Deprecated.
`static String`	`HTTP_EXPIRES` Deprecated.
`static String`	`HTTP_LAST_MODIFIED` Deprecated.
`static String`	`HTTP_POST_FORMMULTIPART` Deprecated.
`static String`	`HTTP_POST_FORMURLENCODED` Deprecated.
`static String`	`HTTP_REFERER` Deprecated.
`static String`	`HTTP_SET_COOKIE` Deprecated.
`static String`	`HTTP_USER_AGENT` Deprecated.
`static int`	`HTTPRESPONSENOPAGEFOUND` Deprecated.
`static int`	`HTTPRESPONSENOSERVICE` Deprecated.
`static int`	`HTTPRESPONSENOTOK` Deprecated. HTTP Errors...
`static int`	`HTTPRESPONSEOK` Deprecated. HTTP Success
`static int`	`HTTPRESPONSETIMEOUT` Deprecated.
`static int`	`HTTPVERSION10` Deprecated. HTTP 1.0 flag
`static int`	`HTTPVERSION11` Deprecated. HTTP 1.1 flag
`protected boolean`	`m_bFileDataAdded` Deprecated.
`protected byte[]`	`m_byUserBodyData` Deprecated.
`protected Object`	`m_byUserBodyStream` Deprecated.
`protected int`	`m_byUserContentLength` Deprecated.
`protected COM.FutureTense.Util.CookieWrapper[]`	`m_Cookies` Deprecated.
`protected int`	`m_nLastError` Deprecated.
`protected StringBuffer`	`m_sbUserTextParams` Deprecated.
`protected FTValList`	`m_vlHeaderInfo` Deprecated.
`static String`	`Options` Deprecated. PUT action
`static String`	`PATH_INFO` Deprecated.
`static String`	`Post` Deprecated. POST action
`static String`	`Put` Deprecated. PUT action
`static String`	`REMOTE_ADDR` Deprecated.
`static String`	`REMOTE_HOST` Deprecated.
`static String`	`Trace` Deprecated. TRACE action
`static String`	`X_CSRF_TOKEN` Deprecated.

Constructor Summary

Constructors
Constructor and Description

FormPoster()
Deprecated.

Construct a new object for post

FormPoster(boolean panicOnProblem)
Deprecated.

Constructors
Constructor and Description
`FormPoster()` Deprecated. Construct a new object for post
`FormPoster(boolean panicOnProblem)` Deprecated.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`protected static void`	`addCookieToVector(Vector vCookies, String sName, String sValue)` Deprecated.
`boolean`	`addFile(String sParamName, String sValue, String sFileName)` Deprecated. Add a file (upload file path spec) to data for multipart post, as in INPUT TYPE=FILE
`boolean`	`addFile(String sParamName, String sValue, String sFileName, String sMIMEType)` Deprecated. Add a file (upload file path spec) to data for multipart post, as in INPUT TYPE=FILE Allow specifing of mime type string.
`boolean`	`addFileData(String sParamName, String sFileName, byte[] byData)` Deprecated. Add file (upload) data via a byte array for multipart post, as in INPUT TYPE=FILE
`boolean`	`addFileData(String sParamName, String sFileName, byte[] byData, String sMIMEType)` Deprecated. Add file (upload) data via a byte array for multipart post, as in INPUT TYPE=FILE
`boolean`	`addFileData(String sParamName, String sFileName, InputStream is)` Deprecated. Add file (upload) data via a InputStream object for multipart post, as in INPUT TYPE=FILE
`boolean`	`addFileData(String sParamName, String sFileName, InputStream is, String sMIMEType)` Deprecated. Add file (upload) data via a InputStream object for multipart post, as in INPUT TYPE=FILE
`boolean`	`addTextValue(String sParamName, String sValue)` Deprecated. Adds a name/value pair to the MIME message we're assembling.
`boolean`	`addURL(String sParamName, String sURL)` Deprecated. Add a url ("http://" or "https://") to data for multipart post, as in INPUT TYPE=FILE
`protected void`	`buildCookieArray()` Deprecated.
`byte[]`	`cleanRawResponse()` Deprecated. Fetch the raw bytes from the output stream and remove the HTTP header.
`byte[]`	`cleanRawResponse(boolean bRemoveStatus)` Deprecated. Fetch the raw bytes from the output stream and remove the HTTP header.
`String`	`cleanResponse()` Deprecated. Fetch the string from the output stream and remove the HTTP header.
`String`	`cleanResponse(boolean bRemoveStatus)` Deprecated. Fetch the string from the output stream and remove the HTTP header.
`protected boolean`	`doAuthentication()` Deprecated.
`void`	`dumpMsg(String msg)` Deprecated. Send a String message to stdout or a log file if one was selected via setLog.
`FTValList`	`findAllCookies()` Deprecated. Find the cookies in the post response
`static FTValList`	`findAllCookies(String sData)` Deprecated. Find all cookie values in the HTTP response
`static COM.FutureTense.Util.CookieWrapper[]`	`getCookieArray(String sData)` Deprecated. Find all cookie values in the HTTP response
`FTValList`	`getCookies()` Deprecated. Return FTValList containing all cookie names/values
`int`	`getHTTPStatusCode()` Deprecated. Fetch the HTTP status from the response
`String`	`getHTTPStatusText()` Deprecated. Fetch the HTTP status text from the response
`int`	`getLastError()` Deprecated. Retrieve the last error code set
`String`	`getLastErrorStr()` Deprecated. Retrieve any coded message from the status code object
`String`	`getLastErrorText()` Deprecated. Retrieve the text represenation of the error returned by getLastError()
`String`	`getOutputFileSpec()` Deprecated. Fetch the file spec where the post output has been written
`byte[]`	`getRawResponse()` Deprecated. Fetch the raw bytes from the output stream
`String`	`getResponse()` Deprecated. Returns `String` response from the server after we post() our request.
`String`	`getResponseEncoding()` Deprecated. Method to get the character encoding of the response if known
`javax.servlet.http.Cookie[]`	`getServletCookies()` Deprecated. Get HTTPServlet cookies
`protected String`	`getStatusRecordToken(int nCount)` Deprecated.
`String`	`getX_CSRF_TOKEN_VALUE()` Deprecated.
`protected void`	`init()` Deprecated.
`void`	`login(boolean login, COM.FutureTense.Util.ftStatusCode status, String user, String pass)` Deprecated. Login or logout Set the url first in the FormPoster otherwise it will attempt to default to a NAS 2.1 style URL
`boolean`	`post()` Deprecated. Send this record via an HTTP POST.
`protected FTValList`	`postProcessMIMEHeader(String sHeader)` Deprecated. Called to post-process a mime header once the postconnector reads it
`protected static void`	`processCookie(int nIndex, String sData, Vector vCookies)` Deprecated.
`protected byte[]`	`readStream(InputStream is)` Deprecated.
`void`	`registerMIMENotifier(COM.FutureTense.Interfaces.IMIMENotifier mn)` Deprecated. Register an object that supports the IMIMENotifier interface so that it will be called with MIME header information.
`void`	`reset()` Deprecated. Reset to reuse for a new post
`protected static String`	`sanitizeString(String sIn)` Deprecated. Clean a string by only returning a printable substring
`void`	`setAction(String sAction)` Deprecated. Sets the action for this request.
`void`	`setAutenticationParameters(String sEntity, String sIssuer)` Deprecated. Set the certificate parameters to be used to authenticate the server.
`void`	`setBodyData(byte[] data)` Deprecated. Pass a prebuilt MIME body for posting
`void`	`setBodyStream(Object is, int length)` Deprecated. Pass a prebuilt MIME body for posting
`void`	`setCharacterEncoding(String sEncoding)` Deprecated. Set the character encoding for the string data contained in the MIME request message body Ignored when the transmission method is Get
`void`	`setCookies(javax.servlet.http.Cookie[] c)` Deprecated. Use these cookies in the future
`void`	`setCookies(Map cookiesMap)` Deprecated. Use these cookies in the future
`void`	`setDump(boolean dumpOutput)` Deprecated. Control status logging info; default is false
`boolean`	`setEncodeURL(String sURL)` Deprecated. Set the URL to post to.
`void`	`setHeaderInformation(FTValList vlHeaderInfo)` Deprecated. Use the header information supplied
`void`	`setHTTPVersion(int nVersion)` Deprecated. Set the HTTP protocol version to use.
`void`	`setLog(COM.FutureTense.Util.LogFile logFile)` Deprecated. Supply a logging object if desired for special log types; not required, output will stream to default location based on invocation environment
`void`	`setLog(String logdir)` Deprecated. Provide a standard ascii file dump location for logging in absense of LogFile object
`void`	`setOutputDirectory(String sDir)` Deprecated. Set the directory where the post results output file should be written.
`void`	`setOutputStream(OutputStream os)` Deprecated. Set an output stream to be used for capturing the response.
`void`	`setPort(int nPort)` Deprecated. Set the port to be used to connect to the remote http server
`void`	`setProxy(String sHost)` Deprecated. Set the proxy host if needed to post thru a fire wall
`void`	`setProxyPassword(String p)` Deprecated. Specify a proxy server password if needed to push data thru a firewall
`void`	`setProxyPort(int nPort)` Deprecated. Specify a proxy server port if needed to push data thru a firewall
`void`	`setProxyUser(String u)` Deprecated. Specify a proxy server user if needed to push data thru a firewall
`void`	`setSecureProtocol(boolean bSecure)` Deprecated. Communicate in secure (https) mode.
`void`	`setTimeout(int milliseconds)` Deprecated. Set a network socket connection timeout, in milliseconds.
`boolean`	`setURL(String sURL)` Deprecated. Set the URL to post to.
`void`	`setX_CSRF_TOKEN_VALUE(String xCSRFTOKENVALUE)` Deprecated.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - ERRORSUCCESS
```
public static final int ERRORSUCCESS
```
    Deprecated.
    
    Error success
    
    See Also:
    
    Constant Field Values
  - ERRORNOCONSERVER
```
public static final int ERRORNOCONSERVER
```
    Deprecated.
    
    Error can't connect to server
    
    See Also:
    
    Constant Field Values
  - ERRORNETDISCONNECT
```
public static final int ERRORNETDISCONNECT
```
    Deprecated.
    
    Error network disconnected
    
    See Also:
    
    Constant Field Values
  - ERRORNOURLPARAM
```
public static final int ERRORNOURLPARAM
```
    Deprecated.
    
    Error bad URL input params
    
    See Also:
    
    Constant Field Values
  - ERRORTIMEOUT
```
public static final int ERRORTIMEOUT
```
    Deprecated.
    
    Error network timeout forced
    
    See Also:
    
    Constant Field Values
  - ERRORBADRESPONSE
```
public static final int ERRORBADRESPONSE
```
    Deprecated.
    
    Error server response did not contain handshake code
    
    See Also:
    
    Constant Field Values
  - ERRORNOTAUTHENTICATED
```
public static final int ERRORNOTAUTHENTICATED
```
    Deprecated.
    
    Server certificate does not match what is expected
    
    See Also:
    
    Constant Field Values
  - ERROROUTOFMEMORY
```
public static final int ERROROUTOFMEMORY
```
    Deprecated.
    
    Error - out of memory reading a server response
    
    See Also:
    
    Constant Field Values
  - ERRORGENERAL
```
public static final int ERRORGENERAL
```
    Deprecated.
    
    General error
    
    See Also:
    
    Constant Field Values
  - ERRORFILEIO
```
public static final int ERRORFILEIO
```
    Deprecated.
    
    File I/O error
    
    See Also:
    
    Constant Field Values
  - ERRORILLEGALDATAFORACTION
```
public static final int ERRORILLEGALDATAFORACTION
```
    Deprecated.
    
    File data used with Get Method error
    
    See Also:
    
    Constant Field Values
  - HTTPVERSION10
```
public static final int HTTPVERSION10
```
    Deprecated.
    
    HTTP 1.0 flag
    
    See Also:
    
    Constant Field Values
  - HTTPVERSION11
```
public static final int HTTPVERSION11
```
    Deprecated.
    
    HTTP 1.1 flag
    
    See Also:
    
    Constant Field Values
  - Post
```
public static final String Post
```
    Deprecated.
    
    POST action
    
    See Also:
    
    Constant Field Values
  - Get
```
public static final String Get
```
    Deprecated.
    
    GET action
    
    See Also:
    
    Constant Field Values
  - Connect
```
public static final String Connect
```
    Deprecated.
    
    CONNECT action
    
    See Also:
    
    Constant Field Values
  - Delete
```
public static final String Delete
```
    Deprecated.
    
    DELETE action
    
    See Also:
    
    Constant Field Values
  - Head
```
public static final String Head
```
    Deprecated.
    
    HEAD action
    
    See Also:
    
    Constant Field Values
  - Options
```
public static final String Options
```
    Deprecated.
    
    PUT action
    
    See Also:
    
    Constant Field Values
  - Put
```
public static final String Put
```
    Deprecated.
    
    PUT action
    
    See Also:
    
    Constant Field Values
  - Trace
```
public static final String Trace
```
    Deprecated.
    
    TRACE action
    
    See Also:
    
    Constant Field Values
  - HTTPRESPONSEOK
```
public static final int HTTPRESPONSEOK
```
    Deprecated.
    
    HTTP Success
    
    See Also:
    
    Constant Field Values
  - HTTPRESPONSENOTOK
```
public static final int HTTPRESPONSENOTOK
```
    Deprecated.
    
    HTTP Errors... and up
    
    See Also:
    
    Constant Field Values
  - HTTPRESPONSENOPAGEFOUND
```
public static final int HTTPRESPONSENOPAGEFOUND
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTPRESPONSETIMEOUT
```
public static final int HTTPRESPONSETIMEOUT
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTPRESPONSENOSERVICE
```
public static final int HTTPRESPONSENOSERVICE
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTP_ACCEPT_LANGUAGE
```
public static final String HTTP_ACCEPT_LANGUAGE
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTP_REFERER
```
public static final String HTTP_REFERER
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - REMOTE_HOST
```
public static final String REMOTE_HOST
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - REMOTE_ADDR
```
public static final String REMOTE_ADDR
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTP_CONNECTION
```
public static final String HTTP_CONNECTION
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - PATH_INFO
```
public static final String PATH_INFO
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTP_USER_AGENT
```
public static final String HTTP_USER_AGENT
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTP_ACCEPT_MIME_TYPES
```
public static final String HTTP_ACCEPT_MIME_TYPES
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTP_ACCEPT_CHARSET
```
public static final String HTTP_ACCEPT_CHARSET
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - X_CSRF_TOKEN
```
public static final String X_CSRF_TOKEN
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTP_SET_COOKIE
```
public static final String HTTP_SET_COOKIE
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTP_CONTENT_TYPE_CHARSET
```
public static final String HTTP_CONTENT_TYPE_CHARSET
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTP_CONTENT_TYPE
```
public static final String HTTP_CONTENT_TYPE
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTP_CONTENT_LENGTH
```
public static final String HTTP_CONTENT_LENGTH
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTP_EXPIRES
```
public static final String HTTP_EXPIRES
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTP_LAST_MODIFIED
```
public static final String HTTP_LAST_MODIFIED
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTP_POST_FORMMULTIPART
```
public static final String HTTP_POST_FORMMULTIPART
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - HTTP_POST_FORMURLENCODED
```
public static final String HTTP_POST_FORMURLENCODED
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - m_nLastError
```
protected int m_nLastError
```
    Deprecated.
  - m_byUserBodyData
```
protected byte[] m_byUserBodyData
```
    Deprecated.
  - m_byUserBodyStream
```
protected Object m_byUserBodyStream
```
    Deprecated.
  - m_byUserContentLength
```
protected int m_byUserContentLength
```
    Deprecated.
  - m_Cookies
```
protected COM.FutureTense.Util.CookieWrapper[] m_Cookies
```
    Deprecated.
  - m_vlHeaderInfo
```
protected FTValList m_vlHeaderInfo
```
    Deprecated.
  - m_sbUserTextParams
```
protected StringBuffer m_sbUserTextParams
```
    Deprecated.
  - m_bFileDataAdded
```
protected boolean m_bFileDataAdded
```
    Deprecated.
- Constructor Detail
  - FormPoster
```
public FormPoster()
```
    Deprecated.
    
    Construct a new object for post
  - FormPoster
```
public FormPoster(boolean panicOnProblem)
```
    Deprecated.
- Method Detail
  - init
```
protected void init()
```
    Deprecated.
  - getServletCookies
```
public javax.servlet.http.Cookie[] getServletCookies()
```
    Deprecated.
    
    Get HTTPServlet cookies
    
    Returns:
    
    HTTPServlet cookies
  - getCookies
```
public FTValList getCookies()
```
    Deprecated.
    
    Return FTValList containing all cookie names/values
    
    Returns:
    
    FTValList - FTValList containing cookie names/values
  - setCookies
```
public void setCookies(javax.servlet.http.Cookie[] c)
```
    Deprecated.
    
    Use these cookies in the future
    
    Parameters:
    
    c - cookie array, null to clear
  - setCookies
```
public void setCookies(Map cookiesMap)
```
    Deprecated.
    
    Use these cookies in the future
    
    Parameters:
    
    cookiesMap - - Map containing cookie name/value pairs
  - setHeaderInformation
```
public void setHeaderInformation(FTValList vlHeaderInfo)
```
    Deprecated.
    
    Use the header information supplied
    
    Parameters:
    
    vlHeaderInfo - - vallist containing header information
  - setBodyData
```
public void setBodyData(byte[] data)
```
    Deprecated.
    
    Pass a prebuilt MIME body for posting
    
    Parameters:
    
    data - a data
  - setBodyStream
```
public void setBodyStream(Object is,
                          int length)
```
    Deprecated.
    
    Pass a prebuilt MIME body for posting
    
    Parameters:
    
    is - mime body
    
    length - length of body
  - reset
```
public void reset()
```
    Deprecated.
    
    Reset to reuse for a new post
  - login
```
public void login(boolean login,
                  COM.FutureTense.Util.ftStatusCode status,
                  String user,
                  String pass)
```
    Deprecated.
    
    Login or logout Set the url first in the FormPoster otherwise it will attempt to default to a NAS 2.1 style URL
    
    Parameters:
    
    login - - TRUE login otherwise logout
    
    status - - optional if specified return status will be set
    
    user - - username to use to log in
    
    pass - - password to use to log in
  - setDump
```
public void setDump(boolean dumpOutput)
```
    Deprecated.
    
    Control status logging info; default is false
    
    Parameters:
    
    dumpOutput - whether to dump output msgs
  - setOutputDirectory
```
public void setOutputDirectory(String sDir)
```
    Deprecated.
    
    Set the directory where the post results output file should be written. Mutually exclusive with setOutputStream.
    
    Parameters:
    
    sDir - - directory path. If null, no output file written
  - setOutputStream
```
public void setOutputStream(OutputStream os)
```
    Deprecated.
    
    Set an output stream to be used for capturing the response. Mutually exclusive with setOutputDirectory.
    
    Parameters:
    
    os - output stream (not closed)
  - setCharacterEncoding
```
public void setCharacterEncoding(String sEncoding)
```
    Deprecated.
    
    Set the character encoding for the string data contained in the MIME request message body Ignored when the transmission method is Get
    
    Parameters:
    
    sEncoding - character encoding
  - getOutputFileSpec
```
public String getOutputFileSpec()
```
    Deprecated.
    
    Fetch the file spec where the post output has been written
    
    Returns:
    
    String
  - getResponse
```
public String getResponse()
```
    Deprecated.
    
    Returns String response from the server after we post() our request.
    
    Returns:
    
    String response
  - getRawResponse
```
public byte[] getRawResponse()
```
    Deprecated.
    
    Fetch the raw bytes from the output stream
    
    Returns:
    
    byte[] response
  - getResponseEncoding
```
public final String getResponseEncoding()
```
    Deprecated.
    
    Method to get the character encoding of the response if known
    
    Returns:
    
    character encoding or null if not text or unknown
    
    Since:
    
    6.0
  - cleanRawResponse
```
public byte[] cleanRawResponse(boolean bRemoveStatus)
```
    Deprecated.
    
    Fetch the raw bytes from the output stream and remove the HTTP header. Optionally remove the trailing status code.
    
    Parameters:
    
    bRemoveStatus - boolean flag
    
    Returns:
    
    byte[] response
  - cleanRawResponse
```
public byte[] cleanRawResponse()
```
    Deprecated.
    
    Fetch the raw bytes from the output stream and remove the HTTP header.
    
    Returns:
    
    byte[] response
  - getLastError
```
public int getLastError()
```
    Deprecated.
    
    Retrieve the last error code set
    
    Returns:
    
    int error code
  - getLastErrorText
```
public String getLastErrorText()
```
    Deprecated.
    
    Retrieve the text represenation of the error returned by getLastError()
    
    Returns:
    
    String
  - getLastErrorStr
```
public String getLastErrorStr()
```
    Deprecated.
    
    Retrieve any coded message from the status code object
    
    Returns:
    
    String
  - getStatusRecordToken
```
protected String getStatusRecordToken(int nCount)
```
    Deprecated.
  - getHTTPStatusCode
```
public int getHTTPStatusCode()
```
    Deprecated.
    
    Fetch the HTTP status from the response
    
    Returns:
    
    int
  - getHTTPStatusText
```
public String getHTTPStatusText()
```
    Deprecated.
    
    Fetch the HTTP status text from the response
    
    Returns:
    
    String
  - setLog
```
public void setLog(COM.FutureTense.Util.LogFile logFile)
```
    Deprecated.
    
    Supply a logging object if desired for special log types; not required, output will stream to default location based on invocation environment
    
    Parameters:
    
    logFile - an object which can construct a logging output
  - setLog
```
public void setLog(String logdir)
```
    Deprecated.
    
    Provide a standard ascii file dump location for logging in absense of LogFile object
    
    Parameters:
    
    logdir - path to log directory and 'wwwresponse.log' will be appended to create a logfile
  - setAction
```
public void setAction(String sAction)
               throws Exception
```
    Deprecated.
    
    Sets the action for this request. Either FormPoster.Get or FormPoster.Post
    
    Parameters:
    
    sAction - action
    
    Throws:
    
    Exception - if invalid action
  - readStream
```
protected byte[] readStream(InputStream is)
                     throws IOException
```
    Deprecated.
    
    Throws:
    
    IOException
  - addURL
```
public boolean addURL(String sParamName,
                      String sURL)
```
    Deprecated.
    
    Add a url ("http://" or "https://") to data for multipart post, as in INPUT TYPE=FILE
    
    Parameters:
    
    sParamName - - the parameter name
    
    sURL - - URL to fetch
    
    Returns:
    
    boolean value
  - addFileData
```
public boolean addFileData(String sParamName,
                           String sFileName,
                           byte[] byData)
```
    Deprecated.
    
    Add file (upload) data via a byte array for multipart post, as in INPUT TYPE=FILE
    
    Parameters:
    
    sParamName - - the parameter name
    
    sFileName - - desired name of the file on the target (ie foo.txt)
    
    byData - byte array containing file data
    
    Returns:
    
    boolean value
  - addFileData
```
public boolean addFileData(String sParamName,
                           String sFileName,
                           byte[] byData,
                           String sMIMEType)
```
    Deprecated.
    
    Add file (upload) data via a byte array for multipart post, as in INPUT TYPE=FILE
    
    Parameters:
    
    sParamName - - the parameter name
    
    sFileName - - desired name of the file on the target (ie foo.txt)
    
    byData - byte array containing file data
    
    sMIMEType - MIME type of the data
    
    Returns:
    
    boolean value
  - addFileData
```
public boolean addFileData(String sParamName,
                           String sFileName,
                           InputStream is,
                           String sMIMEType)
```
    Deprecated.
    
    Add file (upload) data via a InputStream object for multipart post, as in INPUT TYPE=FILE
    
    Parameters:
    
    sParamName - - the parameter name
    
    sFileName - - desired name of the file on the target (ie foo.txt)
    
    is - - the object from where the file data will be read
    
    sMIMEType - MIME type of the data
    
    Returns:
    
    boolean value
  - addFileData
```
public boolean addFileData(String sParamName,
                           String sFileName,
                           InputStream is)
```
    Deprecated.
    
    Add file (upload) data via a InputStream object for multipart post, as in INPUT TYPE=FILE
    
    Parameters:
    
    sParamName - - the parameter name
    
    sFileName - - desired name of the file on the target (ie foo.txt)
    
    is - - the object from where the file data will be read
    
    Returns:
    
    boolean value
  - addFile
```
public boolean addFile(String sParamName,
                       String sValue,
                       String sFileName)
```
    Deprecated.
    
    Add a file (upload file path spec) to data for multipart post, as in INPUT TYPE=FILE
    
    Parameters:
    
    sParamName - - the parameter name
    
    sValue - - value of the parameter (usually the file name)
    
    sFileName - - name of the file to add
    
    Returns:
    
    boolean value
  - addFile
```
public boolean addFile(String sParamName,
                       String sValue,
                       String sFileName,
                       String sMIMEType)
```
    Deprecated.
    
    Add a file (upload file path spec) to data for multipart post, as in INPUT TYPE=FILE Allow specifing of mime type string.
    
    Parameters:
    
    sParamName - - the parameter name
    
    sValue - - value of the parameter (usually the file name)
    
    sFileName - - name of the file to add
    
    sMIMEType - - MIME type string
    
    Returns:
    
    boolean value
  - addTextValue
```
public boolean addTextValue(String sParamName,
                            String sValue)
```
    Deprecated.
    
    Adds a name/value pair to the MIME message we're assembling.
    
    Parameters:
    
    sParamName - - name of the parameter
    
    sValue - - value string of the parameter
    
    Returns:
    
    boolean status
  - setEncodeURL
```
public boolean setEncodeURL(String sURL)
```
    Deprecated.
    
    Set the URL to post to.
    
    Parameters:
    
    sURL - a URL
    
    Returns:
    
    true if URL is legal, false otherwise. (URL exceptions are captured and just return false)
  - setURL
```
public boolean setURL(String sURL)
```
    Deprecated.
    
    Set the URL to post to.
    
    Parameters:
    
    sURL - a URL
    
    Returns:
    
    true if URL is legal, false otherwise. (URL exceptions are captured and just return false)
  - setProxy
```
public void setProxy(String sHost)
```
    Deprecated.
    
    Set the proxy host if needed to post thru a fire wall
    
    Parameters:
    
    sHost - host
  - setProxyPort
```
public void setProxyPort(int nPort)
```
    Deprecated.
    
    Specify a proxy server port if needed to push data thru a firewall
    
    Parameters:
    
    nPort - port
  - setProxyUser
```
public void setProxyUser(String u)
```
    Deprecated.
    
    Specify a proxy server user if needed to push data thru a firewall
    
    Parameters:
    
    u - username
  - setProxyPassword
```
public void setProxyPassword(String p)
```
    Deprecated.
    
    Specify a proxy server password if needed to push data thru a firewall
    
    Parameters:
    
    p - password
  - setTimeout
```
public void setTimeout(int milliseconds)
```
    Deprecated.
    
    Set a network socket connection timeout, in milliseconds. Specify 0 for no timeout.
    
    Parameters:
    
    milliseconds - timeout in milliseconds
  - setSecureProtocol
```
public void setSecureProtocol(boolean bSecure)
```
    Deprecated.
    
    Communicate in secure (https) mode.
    
    Parameters:
    
    bSecure - If set after URL is set, will override the default which was determined from the URL protocol
  - setPort
```
public void setPort(int nPort)
```
    Deprecated.
    
    Set the port to be used to connect to the remote http server
    
    Parameters:
    
    nPort - port. If set after URL is set, will override the default which was determined from the URL protocol
  - setHTTPVersion
```
public void setHTTPVersion(int nVersion)
                    throws Exception
```
    Deprecated.
    
    Set the HTTP protocol version to use.
    
    Parameters:
    
    nVersion - protocol. Input should be one of: FormPoster.HTTPVERSION10 or FormPoster.HTTPVERSION11
    
    Throws:
    
    Exception - if invalid http version
  - post
```
public boolean post()
```
    Deprecated.
    
    Send this record via an HTTP POST.
    
    Returns:
    
    boolean
  - doAuthentication
```
protected boolean doAuthentication()
```
    Deprecated.
  - dumpMsg
```
public void dumpMsg(String msg)
```
    Deprecated.
    
    Send a String message to stdout or a log file if one was selected via setLog.
    
    Parameters:
    
    msg - - the message to display
  - sanitizeString
```
protected static String sanitizeString(String sIn)
```
    Deprecated.
    
    Clean a string by only returning a printable substring
    
    Parameters:
    
    sIn - - the string to be cleaned
    
    Returns:
    
    String - the sanitized string
  - addCookieToVector
```
protected static void addCookieToVector(Vector vCookies,
                                        String sName,
                                        String sValue)
```
    Deprecated.
  - processCookie
```
protected static void processCookie(int nIndex,
                                    String sData,
                                    Vector vCookies)
```
    Deprecated.
  - buildCookieArray
```
protected void buildCookieArray()
```
    Deprecated.
  - findAllCookies
```
public FTValList findAllCookies()
```
    Deprecated.
    
    Find the cookies in the post response
    
    Returns:
    
    FTValList - FTValList object containing all cookie names and values
  - getCookieArray
```
public static COM.FutureTense.Util.CookieWrapper[] getCookieArray(String sData)
```
    Deprecated.
    
    Find all cookie values in the HTTP response
    
    Parameters:
    
    sData - data - HTTP response string
    
    Returns:
    
    Cookie[] - array of cookie objects
  - findAllCookies
```
public static FTValList findAllCookies(String sData)
```
    Deprecated.
    
    Find all cookie values in the HTTP response
    
    Parameters:
    
    sData - data - HTTP response string
    
    Returns:
    
    FTValList - FTValList object containing all cookie names and values
  - cleanResponse
```
public String cleanResponse(boolean bRemoveStatus)
```
    Deprecated.
    
    Fetch the string from the output stream and remove the HTTP header. Optionally remove the trailing status code.
    
    Parameters:
    
    bRemoveStatus - - TRUE remove status, FALSE otherwise
    
    Returns:
    
    String response
  - cleanResponse
```
public String cleanResponse()
```
    Deprecated.
    
    Fetch the string from the output stream and remove the HTTP header.
    
    Returns:
    
    String response
  - setAutenticationParameters
```
public void setAutenticationParameters(String sEntity,
                                       String sIssuer)
```
    Deprecated.
    
    Set the certificate parameters to be used to authenticate the server. Will NOT be used if the protocol is not required to be secured.
    
    Parameters:
    
    sEntity - String expected name of the entity
    
    sIssuer - String expected certificate issuer name (ie verisign)
  - postProcessMIMEHeader
```
protected FTValList postProcessMIMEHeader(String sHeader)
```
    Deprecated.
    
    Called to post-process a mime header once the postconnector reads it
    
    Parameters:
    
    sHeader - String MIME header
    
    Returns:
    
    a FTValList
  - registerMIMENotifier
```
public void registerMIMENotifier(COM.FutureTense.Interfaces.IMIMENotifier mn)
```
    Deprecated.
    
    Register an object that supports the IMIMENotifier interface so that it will be called with MIME header information. This method is only applicable when the post output is written to a disk or output stream.
    
    Parameters:
    
    mn - IMIMENotifer object which supports IMIMENotifier
  - getX_CSRF_TOKEN_VALUE
```
public String getX_CSRF_TOKEN_VALUE()
```
    Deprecated.
  - setX_CSRF_TOKEN_VALUE
```
public void setX_CSRF_TOKEN_VALUE(String xCSRFTOKENVALUE)
```
    Deprecated.

Class FormPoster

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ERRORSUCCESS

ERRORNOCONSERVER

ERRORNETDISCONNECT

ERRORNOURLPARAM

ERRORTIMEOUT

ERRORBADRESPONSE

ERRORNOTAUTHENTICATED

ERROROUTOFMEMORY

ERRORGENERAL

ERRORFILEIO

ERRORILLEGALDATAFORACTION

HTTPVERSION10

HTTPVERSION11

Post

Get

Connect

Delete

Head

Options

Put

Trace

HTTPRESPONSEOK

HTTPRESPONSENOTOK

HTTPRESPONSENOPAGEFOUND

HTTPRESPONSETIMEOUT

HTTPRESPONSENOSERVICE

HTTP_ACCEPT_LANGUAGE

HTTP_REFERER

REMOTE_HOST

REMOTE_ADDR

HTTP_CONNECTION

PATH_INFO

HTTP_USER_AGENT

HTTP_ACCEPT_MIME_TYPES

HTTP_ACCEPT_CHARSET

X_CSRF_TOKEN

HTTP_SET_COOKIE

HTTP_CONTENT_TYPE_CHARSET

HTTP_CONTENT_TYPE

HTTP_CONTENT_LENGTH

HTTP_EXPIRES

HTTP_LAST_MODIFIED

HTTP_POST_FORMMULTIPART

HTTP_POST_FORMURLENCODED

m_nLastError

m_byUserBodyData

m_byUserBodyStream

m_byUserContentLength

m_Cookies

m_vlHeaderInfo

m_sbUserTextParams

m_bFileDataAdded

Constructor Detail

FormPoster

FormPoster

Method Detail

init

getServletCookies

getCookies

setCookies

setCookies

setHeaderInformation

setBodyData

setBodyStream

reset

login

setDump

setOutputDirectory

setOutputStream

setCharacterEncoding

getOutputFileSpec

getResponse

getRawResponse

getResponseEncoding