AdroitLogic UltraESB v1.7.0

Deprecated API


Contents
Deprecated Methods
org.adroitlogic.ultraesb.api.Mediation.addPreemptiveBasicAuthentication(Message, String, String)
          From v1.7,0 replaced by HTTPSupport.addPreemptiveBasicAuthentication(Message, String, String) Adds an HTTP transport header for pre-emptive basic authentication for this message. Note: Pre-emptive basic authentication will perform better than basic authentication after an initial request fails with an HTTP 401 authentication required response. However, basic authentication will not be secure as digest authentication or other such mechanisms. It is reccomended that basic authentication if used, should be over an SSL secured connection - in which case the authentication security would be acceptable 
org.adroitlogic.ultraesb.api.Mediation.addPreemptiveBasicAuthentication(Message, String, String, String, boolean)
          From v1.7,0 replaced by HTTPSupport.addPreemptiveBasicAuthentication(Message, String, String, String, boolean) Adds an HTTP transport header for pre-emptive basic authentication for this message. Note: Pre-emptive basic authentication will perform better than basic authentication after an initial request fails with an HTTP 401 authentication required response. However, basic authentication will not be secure as digest authentication or other such mechanisms. It is reccomended that basic authentication if used, should be over an SSL secured connection - in which case the authentication security would be acceptable 
org.adroitlogic.ultraesb.api.Mediation.convertFromFI(Message)
          From v1.7,0 replaced by XMLSupport.convertFromFI(Message) or SOAPSupport.convertFromFI(Message) Convert the payload of the current message from a FastInfoset binary to an XML message (Note the XML payload is still kept as a RawFileMessage by default and maybe converted into a DOM message if required) 
org.adroitlogic.ultraesb.api.Mediation.convertJSONToStream(Message, Object)
          From v1.7,0 replaced by JSONSupport.convertJSONToStream(Message, Object) Convert an untyped Object (e.g. Map holding a JSON payload) to a streamed (file based) message 
org.adroitlogic.ultraesb.api.Mediation.convertSOAPToJSONStream(Message)
          From v1.7,0 replaced by SOAPSupport.convertSOAPToJSONStream(Message) or JSONSupport.convertSOAPToJSONStream(Message) Convert the current SOAP message payload (which maybe available as any format such as raw file or DOM etc) into a file based JSON stream 
org.adroitlogic.ultraesb.api.Mediation.convertSOAPToJSONStream(Message, QName, boolean)
          From v1.7,0 replaced by SOAPSupport.convertSOAPToJSONStream(Message, javax.xml.namespace.QName, boolean) or JSONSupport.convertSOAPToJSONStream(Message, javax.xml.namespace.QName, boolean) Convert the current SOAP message payload (which maybe available as any format such as raw file or DOM etc) into a file based JSON stream 
org.adroitlogic.ultraesb.api.Mediation.convertToDOM(Message)
          From v1.7,0 replaced by XMLSupport.convertToDOM(Message) Convert the current message into a DOMMessage 
org.adroitlogic.ultraesb.api.Mediation.convertToFI(Message)
          From v1.7,0 replaced by XMLSupport.convertToFI(Message) or SOAPSupport.convertToFI(Message) Convert the XML message into a FastInfoset binary message 
org.adroitlogic.ultraesb.api.Mediation.convertToTypedJSON(Message, Class)
          From v1.7,0 replaced by JSONSupport.convertToTypedJSON(Message, Class) Convert the current message into a Typed JSON Object 
org.adroitlogic.ultraesb.api.Mediation.convertToUntypedJSON(Message)
          From v1.7,0 replaced by JSONSupport.convertToUntypedJSON(Message) Convert the current message into an untyped JSON MapMessage 
org.adroitlogic.ultraesb.api.Mediation.convertXMLToJSONStream(Message)
          From v1.7,0 replaced by XMLSupport.convertXMLToJSONStream(Message) or JSONSupport.convertXMLToJSONStream(Message) Convert the current XML message payload (which maybe available as any format such as raw file or DOM etc) into a file based JSON stream 
org.adroitlogic.ultraesb.api.Mediation.convertXMLToJSONStream(Message, QName, boolean)
          From v1.7,0 replaced by XMLSupport.convertXMLToJSONStream(Message, javax.xml.namespace.QName, boolean) or JSONSupport.convertXMLToJSONStream(Message, javax.xml.namespace.QName, boolean) Convert the current XML message payload (which maybe available as any format such as raw file or DOM etc) into a file based JSON stream 
org.adroitlogic.ultraesb.api.Mediation.createDOMDocument()
          From v1.7,0 replaced by XMLSupport.createDOMDocument() Create a new DOM Document object and return 
org.adroitlogic.ultraesb.api.Mediation.extractAsNodeListUsingXPath(Message, String, String[][])
          From v1.7,0 replaced by XMLSupport.extractAsNodeListUsingXPath(Message, String, String[][]) Evaluate the given XPath expression against the XML payload, and return result as a NodeList This method converts the current payload into a DOMMessage 
org.adroitlogic.ultraesb.api.Mediation.extractAsStringUsingXPath(Message, String, String[][])
          From v1.7,0 replaced by XMLSupport.extractAsStringUsingXPath(Message, String, String[][]) or SOAPSupport.extractAsStringUsingXPath(Message, String, String[][]) Evaluate the given XPath expression against the XML payload, and return result as a String This method converts the current payload into a DOMMessage 
org.adroitlogic.ultraesb.api.Mediation.filter(Message, String, String[][])
          From v1.7,0 replaced by XMLSupport.filter(Message, String, String[][]) or SOAPSupport.filter(Message, String, String[][]) Evaluate the given boolean XPath expression over the XML payload 
org.adroitlogic.ultraesb.api.Mediation.filter(Message, String, String[][], String)
          From v1.7,0 replaced by XMLSupport.filter(Message, String, String[][], String) or SOAPSupport.filter(Message, String, String[][], String) Evaluate the given XPath expression over the XML payload and compare the resulting String value with the regular expression for a match. This method converts the current payload into a DOMMessage 
org.adroitlogic.ultraesb.api.Mediation.getCookie(Message, String)
          From v1.7,0 replaced by HTTPSupport.getCookie(Message, String) Return the value of the cookie with the given name 
org.adroitlogic.ultraesb.api.Mediation.getDateFromISO8601String(String)
          From v1.7,0 replaced by DateSupport.getDateFromISO8601String(String) Returns a java.util.Date from an ISO8601 compliant date string yyyy-MM-dd 
org.adroitlogic.ultraesb.api.Mediation.getDateFromUTCString(String)
          From v1.7,0 replaced by DateSupport.getDateFromUTCString(String) Returns a java.util.Date from a UTC date string of the form yyyy-MM-dd'T'HH:mm:ss'Z' 
org.adroitlogic.ultraesb.api.Mediation.getDistributedCache()
          From v1.7,0 replaced by CachingSupport.getDistributedCache() Applicable only when the clustering is enabled and deployed as a cluster. Characteristics of the cache returned by this method is equal to the cache that of Mediation.getLocalCache() but this replicates the content across the nodes in the cluster.

Not like the local equivalent to which you can put any thing, this only accepts Serializable content as both key and value of the entries in the cache. This is because the content you put has to be serialized as the cache needs to replicate the content using RMI.

If the node is starting up later in the cluster, (i.e. it joins a cluster with a state) the node bootstraps the cache content from one of its arbitrarily selected peers. 

org.adroitlogic.ultraesb.api.Mediation.getDistributedPermanentCache()
          From v1.7,0 replaced by CachingSupport.getDistributedPermanentCache() Applicable only when the clustering is enabled and deployed as a cluster. Characteristics of the cache returned by this method is equal to the cache that of Mediation.getLocalPermanentCache() but this replicates the content across the nodes in the cluster.

Not like the local equivalent to which you can put any thing, this only accepts Serializable content as both key and value of the entries in the cache. This is because the content you put has to be serialized as the cache needs to replicate the content using RMI.

You should take extra care about the content life cycle, as the cache doesn't expire the entries that you put. If the node is starting up later in the cluster, (i.e. it joins a cluster with a state) the node bootstraps the cache content from one of its arbitrarily selected peers. Because of the above bootstrap, not like in the local equivalent unless the complete cluster goes off the content will be preserved even on a System/JVM restart on a single node, as it will bootstrap it's cache content from a peer in the cluster. 

org.adroitlogic.ultraesb.api.Mediation.getDistributedPersistentCache()
          From v1.7,0 replaced by CachingSupport.getDistributedPersistentCache() Applicable only when the clustering is enabled and deployed as a cluster. Characteristics of the cache returned by this method is equal to the cache that of Mediation.getLocalPersistentCache() but this replicates the content across the nodes in the cluster.

Not like the local equivalent to which you can put any thing, this only accepts Serializable content as both key and value of the entries in the cache. This is because the content you put has to be serialized as the cache needs to replicate the content using RMI.

You should take extra care about the content life cycle, as the cache doesn't expire the entries that you put. If the node is starting up later in the cluster, (i.e. it joins a cluster with a state) the node bootstraps the cache content from one of its arbitrarily selected peers. 

org.adroitlogic.ultraesb.api.Mediation.getISO8601FormattedString(Date)
          From v1.7,0 replaced by DateSupport.getISO8601FormattedString(java.util.Date) Returns an ISO8601 compliant date string as yyyy-MM-dd 
org.adroitlogic.ultraesb.api.Mediation.getJvmRoute(Message)
          From v1.7,0 replaced by HTTPSupport.getJvmRoute(Message) Return the jvmRoute from the JSESSIONID cookie or jsessionid URL parameter of an HTTP/S request 
org.adroitlogic.ultraesb.api.Mediation.getLocalCache()
          From v1.7,0 replaced by CachingSupport.getLocalCache() Gets the Cache instance which is available locally in the node, and expires it's entries in a given time. It also has a time to live and nothing is guaranteed to be present in this cache. If you need your content to be present through out the session, use the Mediation.getLocalPermanentCache() to get the cache which will give you the permanent cache.

This cache overflows the content to disk in case of exceeding the in-memory cache size, which defaults to 10000 entries. How ever after storing another 1000 entries in the disk, the cache will permanently overflow, which sniffs something wrong in your mediation, as the content in this cache is automatically cleared in the expiration time. 

org.adroitlogic.ultraesb.api.Mediation.getLocalPermanentCache()
          From v1.7,0 replaced by CachingSupport.getLocalPermanentCache() Gets the Cache instance which is available locally in the node, and keeps its contents in the cache within a session. The contents in this cache will never be expired but they are not persisted, so they will be lost at a System/JVM restart. If you want content to be available across JVM sessions, use Mediation.getLocalPersistentCache() instead.

You should be using this with care, as the content life cycle is not managed by the cache it is your responsibility to manage the cache content life cycle. Otherwise you might get into a resource exhaustion. This cache overflows the content to disk in case of exceeding the in-memory cache size, which defaults to 1000 entries, while there is no limit to the content which will be overflowed to disk 

org.adroitlogic.ultraesb.api.Mediation.getLocalPersistentCache()
          From v1.7,0 replaced by CachingSupport.getLocalPersistentCache() Gets the Cache instance which is available locally in the node, and keeps its contents in the cache forever across the sessions. In other words the content will be persisted to the disk.

Once again you should be extra careful about the usage, as the content will be there even after a system/JVM restart. It is possible to crash the disk space and the data persisted in the disk be lost and the cache is not handling that case as it really cannot do anything for the data corruption. This cache by default keeps only 100 entries in-memory and it off-loads the content to disk and loads the content from disk depending on the demand for those entries.

You could treat this as a NO-SQL persistent store, available locally in your node. If you want the content to be available among the cluster in the case of a clustered deployment, use the Mediation.getDistributedPersistentCache() 

org.adroitlogic.ultraesb.api.Mediation.getSoapAction(Message)
          From v1.7,0 replaced by SOAPSupport.getSoapAction(Message) Return the SOAPAction transport header 
org.adroitlogic.ultraesb.api.Mediation.getSoapAddressingAction(Message)
          From v1.7,0 replaced by SOAPSupport.getSoapAddressingAction(Message) Get the WSA Action header 
org.adroitlogic.ultraesb.api.Mediation.getSoapAddressingFaultTo(Message)
          From v1.7,0 replaced by SOAPSupport.getSoapAddressingFaultTo(Message) Get the WSA FaultTo header 
org.adroitlogic.ultraesb.api.Mediation.getSoapAddressingFrom(Message)
          From v1.7,0 replaced by SOAPSupport.getSoapAddressingFrom(Message) Get the WSA From header 
org.adroitlogic.ultraesb.api.Mediation.getSoapAddressingMessageID(Message)
          From v1.7,0 replaced by SOAPSupport.getSoapAddressingMessageID(Message) Get the WSA MessageID header 
org.adroitlogic.ultraesb.api.Mediation.getSoapAddressingReplyTo(Message)
          From v1.7,0 replaced by SOAPSupport.getSoapAddressingReplyTo(Message) Get the WSA ReplyTo header 
org.adroitlogic.ultraesb.api.Mediation.getSoapAddressingTo(Message)
          From v1.7,0 replaced by SOAPSupport.getSoapAddressingTo(Message) Get the WSA To header 
org.adroitlogic.ultraesb.api.Mediation.getSoapFaultCode(Message)
          From v1.7,0 replaced by SOAPSupport.getSoapFaultCode(Message) Extract the SOAP 1.1 Fault/faultcode or SOAP 1.2 Fault/Code/Value if exists 
org.adroitlogic.ultraesb.api.Mediation.getSoapFaultDetail(Message)
          From v1.7,0 replaced by SOAPSupport.getSoapFaultDetail(Message) Extract the SOAP 1.1 detail or SOAP 1.2 Detail if exists 
org.adroitlogic.ultraesb.api.Mediation.getSoapFaultString(Message)
          From v1.7,0 replaced by SOAPSupport.getSoapFaultString(Message) Extract the SOAP 1.1 Fault/faultstring or SOAP 1.2 Reason/Text if exists 
org.adroitlogic.ultraesb.api.Mediation.getSoapHeaderAsString(Message, String, String)
          From v1.7,0 replaced by SOAPSupport.getSoapHeaderAsString(Message, String, String) Extract the SOAP 1.1/1.2 header value as a String 
org.adroitlogic.ultraesb.api.Mediation.getSoapHeadersAsStrings(Message)
          From v1.7,0 replaced by SOAPSupport.getSoapHeadersAsStrings(Message) Extract the SOAP 1.1/1.2 header values as a Strings 
org.adroitlogic.ultraesb.api.mediation.SOAPSupport.getSoapHeadersAsStrings(Message)
          Extract the SOAP 1.1/1.2 header values as a Strings 
org.adroitlogic.ultraesb.api.Mediation.getSQLDateFromISO8601String(String)
          From v1.7,0 replaced by DateSupport.getSQLDateFromISO8601String(String) Returns a java.sql.Date from an ISO8601 compliant date string yyyy-MM-dd 
org.adroitlogic.ultraesb.api.Mediation.getSQLDateFromUTCString(String)
          From v1.7,0 replaced by DateSupport.getSQLDateFromUTCString(String) Returns a java.sql.Date from a UTC date string of the form yyyy-MM-dd'T'HH:mm:ss'Z' 
org.adroitlogic.ultraesb.api.Mediation.getUTFFormattedString(Date)
          From v1.7,0 replaced by DateSupport.getUTFFormattedString(java.util.Date) Returns a UTC formatted date string as yyyy-MM-dd'T'HH:mm:ss'Z' 
org.adroitlogic.ultraesb.api.Mediation.isHessian(Message)
          From v1.7,0 replaced by HTTPSupport.isHessian(Message) Check the message content type to see if it indicates a Hessian message 
org.adroitlogic.ultraesb.api.Mediation.isPermitted(String, Map)
          From v1.7,0 replaced by XACMLSupport.isPermitted(String, java.util.Map) Is message allowed permission by the XACML processor bean selected. 
org.adroitlogic.ultraesb.api.Mediation.isPermitted(String, Message)
          From v1.7,0 replaced by XACMLSupport.isPermitted(String, Message) Is message allowed permission by the XACML processor bean selected. Automatically maps the following HTTP related transport properties to the specified attribute names action-id -> msg.getMessageProperty(HttpConstants.METHOD) subject-id -> msg.getMessageProperty(HttpConstants.USERNAME) role -> msg.getMessageProperty(HttpConstants.USERROLES) as a String[] client-dn -> msg.getMessageProperty(HttpConstants.SSL_CLIENT_DN) resource-id -> msg.getMessageProperty(HttpConstants.SERVICE_URL) 
org.adroitlogic.ultraesb.api.Mediation.isPermitted(String, String, Map, Message)
          From v1.7,0 replaced by XACMLSupport.isPermitted(String, String, java.util.Map, Message) Is message allowed permission by the XACML processor bean selected. 
org.adroitlogic.ultraesb.api.Mediation.isSoap(Message)
          From v1.7,0 replaced by SOAPSupport.isSoap(Message) Check the message content type to see if it indicates a SOAP 1.1 or 1.2 message serialized as XML 
org.adroitlogic.ultraesb.api.Mediation.mergeXMLAttachmentsUnderElement(Message, String)
          From v1.7,0 replaced by XMLSupport.mergeXMLAttachmentsUnderElement(Message, String) Replace the current XML payload with a top level element as specified, and merge the payloads from the current body, and attachments underneath that 
org.adroitlogic.ultraesb.api.Mediation.mergeXMLAttachmentsUnderElement(Message, String, String)
          From v1.7,0 replaced by XMLSupport.mergeXMLAttachmentsUnderElement(Message, String, String) Replace the current XML payload with a top level element as specified, and merge the payloads from the current body, and attachments underneath that 
org.adroitlogic.ultraesb.api.Mediation.processBasicJSONDataServiceRequest(Message, String, String)
          From v1.7,0 replaced by JSONSupport.processBasicJSONDataServiceRequest(Message, String, String) Process request message as a basic JSON data service request. The response would be generated by executing the specified queries of the JSON Data Service bean definition 
org.adroitlogic.ultraesb.api.Mediation.remove(Message, String, String[][])
          From v1.7,0 replaced by XMLSupport.remove(Message, String, String[][]) or SOAPSupport.remove(Message, String, String[][]) Remove the XPath expression specified node from the XML payload. This method converts the current payload of the message into a DOMMessage 
org.adroitlogic.ultraesb.api.Mediation.retainElementAsPayload(Message, String, String[][])
          From v1.7,0 replaced by XMLSupport.retainElementAsPayload(Message, String, String[][]) Replace the current XML payload with the resulting element from the XPath expression result 
org.adroitlogic.ultraesb.api.Mediation.setCookie(Message, String, String)
          From v1.7,0 replaced by HTTPSupport.setCookie(Message, String, String) Set a HTTP cookie on the message 
org.adroitlogic.ultraesb.api.Mediation.setCookie(Message, String, String, String, int)
          From v1.7,0 replaced by HTTPSupport.setCookie(Message, String, String, String, int) Set a HTTP cookie on the message 
org.adroitlogic.ultraesb.api.Mediation.setCookie(Message, String, String, String, String, int, boolean)
          From v1.7,0 replaced by HTTPSupport.setCookie(Message, String, String, String, String, int, boolean) Set a HTTP cookie on the message 
org.adroitlogic.ultraesb.api.Mediation.setPayloadToSOAP11Fault(Message, String, String, String)
          From v1.7,0 replaced by SOAPSupport.setPayloadToSOAP11Fault(Message, String, String, String) Set the payload of the current message to a SOAP 1.1 fault message with the given code, faultString and detail 
org.adroitlogic.ultraesb.api.Mediation.setPayloadToSOAP12Fault(Message, String, String, String)
          From v1.7,0 replaced by SOAPSupport.setPayloadToSOAP12Fault(Message, String, String, String) Set the payload of the current message to a SOAP 1.2 fault message with the given code, reason and detail 
org.adroitlogic.ultraesb.api.Mediation.splitAndProcess(Message, String, String[][], String, boolean)
          From v1.7,0 replaced by XMLSupport.splitAndProcess(Message, String, String[][], String, boolean) or SOAPSupport.splitAndProcess(Message, String, String[][], String, boolean) Split current message into multiple messages using the given XPath expression, and hand over each such message to the given sequence 
org.adroitlogic.ultraesb.api.Mediation.transform(Message, String)
          From v1.7,0 replaced by XMLSupport.transform(Message, String) SOAPSupport.transform(Message, String) Transform the message payload by XSLT (without any parameters), assuming a non DOM result and assuming that the complete message payload will be used as the source of the transformation, and the result will replace the complete message payload 
org.adroitlogic.ultraesb.api.Mediation.transform(Message, String, String, String[][])
          From v1.7,0 replaced by XMLSupport.transform(Message, String, String, String[][]) SOAPSupport.transform(Message, String, String, String[][]) Transform the message payload by XSLT (without any parameters), assuming a non DOM result 
org.adroitlogic.ultraesb.api.Mediation.transform(Message, String, String, String[][], boolean, Map)
          From v1.7,0 replaced by XMLSupport.transform(Message, String, String, String[][], boolean, java.util.Map) or SOAPSupport.transform(Message, String, String, String[][], boolean, java.util.Map) Transform the message payload by XSLT 
org.adroitlogic.ultraesb.api.Mediation.validate(Message, String)
          From v1.7,0 replaced by SOAPSupport.validate(Message, String) or XMLSupport.validate(Message, String) Validate the current message against one single schema 
org.adroitlogic.ultraesb.api.Mediation.validate(Message, String[])
          From v1.7,0 replaced by SOAPSupport.validate(Message, String[]) or XMLSupport.validate(Message, String[]) Validate the current message against one or more schemas 
org.adroitlogic.ultraesb.api.Mediation.validate(Message, String[], String, String[][])
          From v1.7,0 replaced by SOAPSupport.validate(Message, String[], String, String[][]) or XMLSupport.validate(Message, String[], String, String[][]) Validate the current message - or an element of it selected via an XPath expression - against one or more schemas 
 


Copyright (c) 2010-2012 AdroitLogic Private Ltd. All rights reserved.