Java Doc for VishnuComm.java in  » Science » Cougaar12_4 » org » cougaar » lib » vishnu » client » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Hides whether we're running internally or externally from callers.

Knows about command-to-URL mapping, e.g. postCancel becomes a URL calling the php script postcancel.php.

Uses an internalBuffer to write to when we're running internally. It holds the same bytes as are sent to the web server when running externally.

Called by various methods in InternalMode, after having asked scheduler to parse data in the buffer.

URL encodes the data

Calls postToURL with URL header and data

bogus is sent first because user would not arrive at php with value if it was sent first.

Post data to the URL
If readResponse is true, read the response back from the URL and return it.

 Does most of the work of posting, the other signature does the serializing.
 If running internally, just appends the data to the buffer.

 sets Problem name used by Vishnu
 Appends the machine name to divide the name space of problems 
 automatically.

 Tells the scheduler to start.
 bogus is sent first because user would not arrive 

 at php with it's value if it was sent first.

calls postCancel and postClear if running externally

Called by various methods in InternalMode, after having asked scheduler to parse data in the buffer.
See Also:   InternalMode.prepareScheduler

 Get the answer back from the web site/scheduler 
 Called by XMLResultHandler
 Calls readXML with the assignment handler
 

Should only be done once, when the plugin loads.

This is an insurance policy against the case where someone starts a society and runs it, but never starts a scheduler, or otherwise gets a problem into the state of "processing" but not "complete." Once in the "processing" state, the scheduler will not accept new jobs for this problem, effectively blocking it for all time. bogus is sent first because user would not arrive at php with value if it was sent first. No idea why.

Calls postToURL with URL header
See Also:   VishnuComm.postToURL

 Tells database or scheduler to forget all data associated with the problem
 Calls postToURL with URL header
 

URL encodes the data

Calls postToURL with URL header and data
See Also:   VishnuComm.postToURL
Parameters:
  data - to send to URL

URL encodes the data

Calls postToURL with URL header and data

bogus is sent first because user would not arrive at php with value if it was sent first. No idea why.

See Also:   VishnuComm.postToURL
Parameters:
  data - to send to URL

Post data to the URL
If readResponse is true, read the response back from the URL and return it.

If writeXMLToFile is set, will write a copy of what is sent to the URL to a file named ClusterName_type_number, where type is problem (the problem definition) or data (the tasks and resources), and number is a counter that keeps the file names unique

What's written to the file is human readable, whereas if writeEncodedXMLToFile is set, a different file is written, named ClusterName_encoded_number. This file contains exactly what is sent to the web server, after URL encoding has been performed.

Does the work of serialization here, by calling DomUtil function getDocAsArray, and lets the other signature do actual posting.
See Also:   VishnuDomUtil.getDocAsArray
Parameters:
  doc - - DOM doc to send to URL
Parameters:
  postData - - true if posting data

 Does most of the work of posting, the other signature does the serializing.
 If running internally, just appends the data to the buffer. Otherwise tries to
 to either post data or post the problem
 Only called by other serializeAndPost
 

 sets Problem name used by Vishnu
 Appends the machine name to divide the name space of problems 
 automatically.
 For example, if there were an expander in the
 AsmaraTFSP cluster, run on a machine named pumpernickle, 
 the problem name would be 
 AsmaraTFSP_pumpernickle
 

 Tells the scheduler to start.
 bogus is sent first because user would not arrive 

 at php with it's value if it was sent first.  No idea why.  

 BOZO - Still a problem???
 Calls postToURL with URL header
 

 Polls the scheduler for it's status
 Only uses in external mode
 Sleeps between polls
 Calls postToURL with URL header