oracle.syndicate.client.handler
Interface SyndicatorRequestHandler

All Known Implementing Classes:

FileSyndicatorRequestHandler

public interface SyndicatorRequestHandler

SyndicatorRequestHandlers are the components invoked when message pushed from the syndicator are received by the client. Classes implementing this inteface must have a public empty constructor so that they can be instantied by reflection. Initialization parameters/property can be set using the set property API.

Since:

release specific (what release of product did this appear in)

Method Summary

SAXPackageHandler	getSAXPackageHandler(javax.servlet.http.HttpServletRequest request, java.lang.String sbtID) Returns the SAX-based packgae handler to be used when a new packages is received.
SyndicateSubscription	releaseSAXPackageHandler(SAXPackageHandler sph, SyndicatePackage pkg) Releases the saxPackage handler once the content package processing has been completed.
void	releaseSAXPackageHandlerAfterFailure(SAXPackageHandler sph, java.lang.Throwable t) Releases the saxPackage handler in the case the update failed .
void	setProperty(java.lang.String propName, java.lang.String propValue) Sets a property for the SyndicatorRequestHandler

Method Detail

setProperty

public void setProperty(java.lang.String propName,
                        java.lang.String propValue)

Sets a property for the SyndicatorRequestHandler

getSAXPackageHandler

public SAXPackageHandler getSAXPackageHandler(javax.servlet.http.HttpServletRequest request,
                                              java.lang.String sbtID)
                                       throws SyndicateException

Returns the SAX-based packgae handler to be used when a new packages is received. A new instance of the SAXPackageHandler must be returned for each call to work in a concurrent scenario.

releaseSAXPackageHandler

public SyndicateSubscription releaseSAXPackageHandler(SAXPackageHandler sph,
SyndicatePackage pkg)
                                               throws SyndicateException

Releases the saxPackage handler once the content package processing has been completed. Resources associated with SAXPackageHandler can then be released.

Parameters:

sph - the SAXPackageHandler to be released

pkg - the package structure which was successfully processed

releaseSAXPackageHandlerAfterFailure

public void releaseSAXPackageHandlerAfterFailure(SAXPackageHandler sph,
                                                 java.lang.Throwable t)
                                          throws SyndicateException

Releases the saxPackage handler in the case the update failed . Resources associated with SAXPackageHandler can then be released.

Parameters:

sph - the SAXPackageHandler to be released

t - the exception which caused the package processing error