org.sourceid.saml20.service.impl.proxy
Class ArtifactPersistenceSvcProxy

java.lang.Object
  extended by org.sourceid.saml20.service.impl.proxy.ArtifactPersistenceSvcProxy
All Implemented Interfaces:
ArtifactPersistenceService

public class ArtifactPersistenceSvcProxy
extends java.lang.Object
implements ArtifactPersistenceService

Chooses between an in-memory implementation or a multicast implementation at runtime depending on the configuration of the PingFederate server.

Author:
Brian Campbell

Nested Class Summary
 
Nested classes/interfaces inherited from interface org.sourceid.saml20.service.ArtifactPersistenceService
ArtifactPersistenceService.Handle, ArtifactPersistenceService.Message
 
Constructor Summary
ArtifactPersistenceSvcProxy()
           
 
Method Summary
 ArtifactPersistenceService.Message retrieveAndRemoveArtifact(byte[] messageHandle)
          Retrieves (and removes from the underlying storage mechanism) the protocol message associated to the given message handle.
 ArtifactPersistenceService.Handle saveArtifact(ArtifactPersistenceService.Message msg, int timeoutSeconds)
          Saves a protocol message associated to a byte array message handle for retrieval later (usually a very short time later) via artifact.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ArtifactPersistenceSvcProxy

public ArtifactPersistenceSvcProxy()
                            throws java.lang.IllegalAccessException,
                                   java.lang.InstantiationException
Throws:
java.lang.IllegalAccessException
java.lang.InstantiationException
Method Detail

saveArtifact

public ArtifactPersistenceService.Handle saveArtifact(ArtifactPersistenceService.Message msg,
                                                      int timeoutSeconds)
                                               throws ArtifactPersistenceServiceException
Description copied from interface: ArtifactPersistenceService
Saves a protocol message associated to a byte array message handle for retrieval later (usually a very short time later) via artifact.

Specified by:
saveArtifact in interface ArtifactPersistenceService
Parameters:
msg - the protocol xml message.
timeoutSeconds - the number of seconds after which the message/artifact are no longer valid.
Returns:
a Handle object that contains the message handle byte array as well as the endpoint index. This object will be used to create the full artifact string value.
Throws:
ArtifactPersistenceServiceException - for any unexpected runtime problem that the implementation cannot handle.

retrieveAndRemoveArtifact

public ArtifactPersistenceService.Message retrieveAndRemoveArtifact(byte[] messageHandle)
                                                             throws ArtifactPersistenceServiceException
Description copied from interface: ArtifactPersistenceService
Retrieves (and removes from the underlying storage mechanism) the protocol message associated to the given message handle.

Specified by:
retrieveAndRemoveArtifact in interface ArtifactPersistenceService
Parameters:
messageHandle - the 20 bytes that reference a specific protocol message.
Returns:
the Message object that is referred to by the messageHandle.
Throws:
ArtifactPersistenceServiceException - for any unexpected runtime problem that the implementation cannot handle.


Copyright 2007 Ping Identity Corp. All rights reserved.