com.cybersource.ws.client

Class XMLClient

java.lang.Object

com.cybersource.ws.client.XMLClient

public class XMLClient
extends Object

Containing runTransaction() methods that accept the requests in the form of a Document object.

Constructor Summary

Constructors

Constructor and Description
XMLClient()

Method Summary

Modifier and Type	Method and Description
static String	getEffectiveNamespaceURI(Properties props, String merchantID) Returns the effective namespace URI for the specified merchant id.
static Document	runTransaction(Document request, Properties props) Runs a transaction.
static Document	runTransaction(Document request, Properties props, Logger _logger, boolean prepare, boolean logTranStart) Runs a transaction.

Methods inherited from class java.lang.Object

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

Constructor Detail

XMLClient

public XMLClient()

Method Detail

runTransaction

public static Document runTransaction(Document request,
                                      Properties props)
                               throws FaultException,
                                      ClientException

Runs a transaction.

Parameters:

request - request to send.

props - properties the client needs to run the transaction. See README for more information.

Throws:

FaultException - if a fault occurs.

ClientException - if any other exception occurs.

runTransaction

public static Document runTransaction(Document request,
                                      Properties props,
                                      Logger _logger,
                                      boolean prepare,
                                      boolean logTranStart)
                               throws FaultException,
                                      ClientException

Runs a transaction.

Parameters:

request - request to send.

props - properties the client needs to run the transaction. See README for more information.

_logger - Logger object to used for logging.

prepare - Flag as to whether or not the logger's prepare() method should be called.

logTranStart - Flag as to whether or not the logger's logTransactionStart() method should be called.

Throws:

FaultException - if a fault occurs.

ClientException - if any other exception occurs.

getEffectiveNamespaceURI

public static String getEffectiveNamespaceURI(Properties props,
                                              String merchantID)
                                       throws ClientException

Returns the effective namespace URI for the specified merchant id. Refer to MerchantConfig.getProperty() for the search behavior. This method is provided so that the nvpSample application can dynamically plug the correct namespace URI into the nvpSample XML inputs. You do not need to call it if you have the namespace URI hardcoded in your XML documents.

Parameters:

props - Properties object to look up the properties in.

merchantID - merchant ID whose effective namespace URI is wanted. It may be null, in which case, the generic effective namespace URI is returned.

Throws:

ClientException - if a ConfigException occurs. Call getInnerException() to get at the ConfigException.