com.aemo.msats.ws

Class NMIDetail

java.lang.Object

com.aemo.msats.ws.NMIDetail

public class NMIDetail
extends java.lang.Object

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

Constructor Summary

Constructors

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

Method Summary

Methods

Modifier and Type	Method and Description
void	doNmiDetail(java.lang.String dataFilename, java.lang.String requestContentType) Make a request to the NMI Detail web service by POSTing an aseXML file from the inbox.
java.lang.String	doNmiDetail(java.lang.String transactionId, java.lang.String nmi, java.lang.String checksum, java.lang.String type, java.lang.String reason) Make a GET request to the NMI Detail web service to fetch details for a specific NMI.
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

NMIDetail

public NMIDetail()
          throws ApplicationException

Construct an instance of this class.

Throws:

ApplicationException - if the instance cannot be initialised.

Method Detail

doNmiDetail

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

Make a request to the NMI Detail web service by POSTing an aseXML file from the inbox. The file should contain a single, valid NMIStandingDataRequest 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.

doNmiDetail

public java.lang.String doNmiDetail(java.lang.String transactionId,
                           java.lang.String nmi,
                           java.lang.String checksum,
                           java.lang.String type,
                           java.lang.String reason)
                             throws ApplicationException

Make a GET request to the NMI Detail web service to fetch details for a specific NMI.

Parameters:

transactionId - identifies requestor's transaction.

nmi - identifies which NMI to fetch details for.

checksum - verifies the NMI value.

type -

reason -

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.