com.veriplace.web
Class WaitingException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by com.veriplace.client.VeriplaceException
              extended by com.veriplace.web.WaitingException
All Implemented Interfaces:
java.io.Serializable

public class WaitingException
extends VeriplaceException

Indicates that Veriplace has started an asynchronous request which may take some time. To avoid leaving the user hanging on a partially rendered page, the application may want to display a "please wait" page, which should have an automatic refresh to the callback URL that is contained in the exception, and then stop handling the current HTTP request. (This is highly recommended in order to support users who access your application through a mobile phone web gateway, since such gateways often have a short timeout and will abandon a request if it appears to be stalled.) If this is not a concern, you can simply repeat the previous method call, which will either return successfully if the request has completed or throw another WaitingException if you still need to wait.

This behavior can be handled automatically by a StatusViewRenderer, which is the default.

Since:
2.0
See Also:
Serialized Form

Constructor Summary
WaitingException(java.lang.String callbackUrl)
           
 
Method Summary
 java.lang.String getCallbackUrl()
           
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

WaitingException

public WaitingException(java.lang.String callbackUrl)
Method Detail

getCallbackUrl

public java.lang.String getCallbackUrl()