com.cybersource.ws.client
Class XMLClient

java.lang.Object
  com.cybersource.ws.client.XMLClient

public class XMLClient
extends java.lang.Object

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

Constructor Summary

XMLClient()

Method Summary

static java.lang.String	getEffectiveNamespaceURI(java.util.Properties props, java.lang.String merchantID) Returns the effective namespace URI for the specified merchant id.
static org.w3c.dom.Document	runTransaction(org.w3c.dom.Document request, java.util.Properties props) Runs a transaction.
static org.w3c.dom.Document	runTransaction(org.w3c.dom.Document request, java.util.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

getEffectiveNamespaceURI

public static java.lang.String getEffectiveNamespaceURI(java.util.Properties props,
                                                        java.lang.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.

runTransaction

public static org.w3c.dom.Document runTransaction(org.w3c.dom.Document request,
                                                  java.util.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 org.w3c.dom.Document runTransaction(org.w3c.dom.Document request,
                                                  java.util.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.