Interface semper.transfer.TransferServiceInterface 
All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface semper.transfer.TransferServiceInterface

public interface TransferServiceInterface
extends Object
This interface defines all the generic transfer services that a transfer operation should typically provide.
Version:
$Revision: 1.6 $ $Date: 1996/10/25 11:01:26 $
Author:
Christian Thiel ([email protected]), Ferdinando Loiacono ([email protected])

Method Index

o errorHandler()
Error handling -- this is just a place holder....
o receiveContainer(String, String, int, int, String)
Service for receiving a container.
o sanity_check(Node, int)
This method provides a "sanity check" of a received container.
o send(String, String, int, String, Vector)
Transparent service for sending a text item with some security attributes.
o sendContainer(String, String, int, int, Node)
Service for sending a container.
o storeContainer(int)
Service for storing a container in the archive.

Methods

o sendContainer 
  public abstract void sendContainer(String localadress,
                                     String remoteadress,
                                     int BusinessSessionId,
                                     int ContainerID,
                                     Node rootNode) throws TransferServiceException
Service for sending a container.
Parameters:
localadress - sender's address
remoteadress - receiver's address
BusinessSessionId - unique identifier of the business session
ContainerID - unique identifier of a container in a business session
rootNode - is a refernece to the root of the container
Returns:
ErrorStatus Flag of the container root
Throws: TransferServiceException
An error occured during the transfer.
See Also:
Manager, Operation
o send 
  public abstract void send(String localadress,
                            String remoteadress,
                            int BusinessSessionId,
                            String Content,
                            Vector ListSecAttr) throws TransferServiceException
Transparent service for sending a text item with some security attributes. This will be implemented via a single node container and this service can be used by all the service blocks in the transfer layer.
Parameters:
localadress - sender's address.
remoteadress - receiver's address.
BusinessSessionId - unique identifier of the business session.
Content - Data string.
ListSecAttr - Security attributes.
Returns:
none
Throws: TransferServiceException
An error occured during the transfer.
See Also:
Manager, Operation
o receiveContainer 
  public abstract void receiveContainer(String localaddress,
                                        String remoteaddress,
                                        int BusinessSessionId,
                                        int ContainerID,
                                        String linearizedObject) throws TransferServiceException
Service for receiving a container. This method will be called by the Commerce Layer entity that is expecting a container. Note that this implies a synchronised communication between the CL entities, i.e. the CL entity on the receiver side will know from the local business application that a new business session was started, and that a transfer of a container is expected. An asynchronus model of the communication will be supported as well, i.e. a container can be received and passed to the CL entity on the recipient side even if this entity is not expecting for the container. This service still has to be defined.
Parameters:
localadress - receiver's address.
remoteadress - sender's address.
BusinessSessionId - unique identifier of the business session
ContainerID - ID of container.
linearizedObject - String containing a serialized object.
Returns:
none
Throws: TransferServiceException
An error occured during the transfer.
o storeContainer 
  public abstract String storeContainer(int ContainerID)
Service for storing a container in the archive. Everytime a container is sent, a copy of the sent container is also stored in the archive.
Parameters:
ContainerID - Distinguished name of the container.
Returns:
a handle to the stored container object. The type returned should really be an archive handle (for the moment it is a string)
o errorHandler 
  public abstract String errorHandler() throws TransferServiceException
Error handling -- this is just a place holder....
Throws: TransferServiceException
An error was encountered.
o sanity_check 
  public abstract String sanity_check(Node rootNode,
                                      int TemplateID) throws TransferServiceException
This method provides a "sanity check" of a received container.
Parameters:
Node - Start node for the check.
TemplateID - Container id.
Throws: TransferServiceException
An error was encountered during the check. 
All Packages  Class Hierarchy  This Package  Previous  Next  Index