com.aemo.msats.ws

Class MSATSLimits

java.lang.Object

com.aemo.msats.ws.MSATSLimits

public class MSATSLimits
extends java.lang.Object

This class provides a wrapper method for each variant of the MSATS Limits web service.

Constructor Summary

Constructors

Constructor and Description
MSATSLimits() Construct an instance of this class.

Method Summary

Methods

Modifier and Type	Method and Description
void	doMSATSLimits(java.lang.String dataFilename, java.lang.String requestContentType) Make a request to the MSATS Limits web service by POSTing an aseXML file from the inbox.
java.lang.String	doMSATSLimitsTransid(java.lang.String transactionId) Make a GET request to the MSATS Limits web service.
java.lang.String	getResponse() This method provides the web service response as a string.
java.lang.String	getResponseCharset() Reports the character set from the Content-Type header.
int	getResponseCode() Report the HTTP response code.
java.lang.String	getResponseFilename() Reports the filename from the Content-Disposition header.
java.lang.String	getResponseReason() Report the HTTP response reason.
java.lang.String	getResponseType() Reports the mime-type from the Content-Type header.
void	writeResponse() Write the web service response to a file.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MSATSLimits

public MSATSLimits()
            throws ApplicationException

Construct an instance of this class.

Throws:

ApplicationException - if the instance cannot be initialised.

Method Detail

doMSATSLimits

public void doMSATSLimits(java.lang.String dataFilename,
                 java.lang.String requestContentType)
                   throws ApplicationException

Make a request to the MSATS Limits web service by POSTing an aseXML file from the inbox. The file should contain a single, valid ReportRequest transaction. If the web service request is successful, the response file is written to the outbox.

Parameters:

dataFilename - is the file to post from the inbox.

requestContentType - defines the file type as XML or ZIP.

Throws:

ApplicationException - when something goes wrong.

doMSATSLimitsTransid

public java.lang.String doMSATSLimitsTransid(java.lang.String transactionId)
                                      throws ApplicationException

Make a GET request to the MSATS Limits web service.

Parameters:

transactionId - identifies requestor's transaction.

Returns:

the XML web service response

Throws:

ApplicationException - when something goes wrong.

getResponseCode

public int getResponseCode()

Report the HTTP response code. A value of 200 indicates a successful web service request. Other values indicate an error.

Returns:

the HTTP response code.

getResponseReason

public java.lang.String getResponseReason()

Report the HTTP response reason.

Returns:

the HTTP response reason.

getResponseType

public java.lang.String getResponseType()

Reports the mime-type from the Content-Type header. If a Content-Type header was not provided then a default value of 'text/xml' is returned.

Returns:

the character set from the Content-Type header.

getResponseCharset

public java.lang.String getResponseCharset()

Reports the character set from the Content-Type header. If no character set was specified then a default value of 'UTF-8' is returned.

Returns:

the character set from the Content-Type header.

getResponseFilename

public java.lang.String getResponseFilename()

Reports the filename from the Content-Disposition header.

Returns:

the filename from the Content-Disposition header.

writeResponse

public void writeResponse()
                   throws ApplicationException

Write the web service response to a file. The file type is is specified by the Content-Type header. The filename is specified by the Content-Disposition header and is located in the outbox directory specified by the client configuration properties file.

Throws:

ApplicationException - if an error occurs while writing the file.

getResponse

public java.lang.String getResponse()
                             throws ApplicationException

This method provides the web service response as a string. If the response was a zip file, the string value of the first zip entry is returned.

Returns:

the web service response string value.

Throws:

ApplicationException - if the response type was zip and the response could not be unzipped.