Interface ISimpleFileStorageAppSoap

All Known Implementing Classes:
SimpleFileStorageAppSoap, SimpleFileStorageAppSoapMockStub, SimpleFileStorageAppSoapStub

public interface ISimpleFileStorageAppSoap
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    endFileUpload(String sessionId, String fileStorageId)
    Closes and saves uploaded file.
    long
    getSize(String sessionId, String fileStorageId)
    Returns size of the specified temporary storage file in bytes.
    byte[]
    read(String sessionId, String fileStorageId, int offset, int length)
    Reads from file a specified a number of bytes from the offset specified.
    byte[]
    read2(String sessionId, String fileStorageId, long offset, int length)
    Reads from file a specified a number of bytes from the offset specified.
    Opens a new file descriptor for uploading and returns the temporary storage id.
    void
    write(String sessionId, String fileStorageId, byte[] data)
    Appends data to the file being uploaded.
  • Method Details

    • startFileUpload

      String startFileUpload(String sessionId) throws RemoteException
      Opens a new file descriptor for uploading and returns the temporary storage id.
      Parameters:
      sessionId - User session id.
      Returns:
      File storage id.
      Throws:
      InvalidSessionFault - when the specified session id is invalid.
      SystemFault - when an unexpected system level error is encountered.
      RemoteException
      Since:
      4.1
    • write

      void write(String sessionId, String fileStorageId, byte[] data) throws RemoteException
      Appends data to the file being uploaded.
      Parameters:
      sessionId - User session id.
      fileStorageId - Id of temporary file storage for the file being uploaded.
      data - Data to be uploaded.
      Throws:
      InvalidSessionFault - when the specified session id is invalid.
      SystemFault - when an unexpected system level error is encountered.
      IllegalArgumentFault - when the specified fileStorageId is invalid.
      RemoteException
      Since:
      4.1
    • endFileUpload

      void endFileUpload(String sessionId, String fileStorageId) throws RemoteException
      Closes and saves uploaded file.
      Parameters:
      sessionId - User session id.
      fileStorageId - Id of temporary file storage for the file to finish uploading.
      Throws:
      InvalidSessionFault - when the specified session id is invalid.
      SystemFault - when an unexpected system level error is encountered.
      IllegalArgumentFault - when the specified fileStorageId is invalid.
      RemoteException
      Since:
      4.1
    • getSize

      long getSize(String sessionId, String fileStorageId) throws RemoteException
      Returns size of the specified temporary storage file in bytes.
      Parameters:
      sessionId - User session id.
      fileStorageId - Id of temporary file storage.
      Returns:
      File size in number of bytes.
      Throws:
      InvalidSessionFault - when the specified session id is invalid.
      SystemFault - when an unexpected system level error is encountered.
      IllegalArgumentFault - when the specified fileStorageId is invalid.
      RemoteException
      Since:
      4.1
    • read

      byte[] read(String sessionId, String fileStorageId, int offset, int length) throws RemoteException
      Reads from file a specified a number of bytes from the offset specified.
      Parameters:
      sessionId - User session id.
      fileStorageId - Id of temporary file storage
      offset - Offset within file from where to read.
      length - Number of bytes to read.
      Returns:
      Data read from the file as a byte array. Returns null on file end.
      Throws:
      InvalidSessionFault - when the specified session id is invalid.
      SystemFault - when an unexpected system level error is encountered.
      PermissionDeniedFault - when the user doesn't have permission to view the file
      IllegalArgumentFault - when the specified fileStorageId is invalid.
      RemoteException
      Since:
      4.1
    • read2

      byte[] read2(String sessionId, String fileStorageId, long offset, int length) throws RemoteException
      Reads from file a specified a number of bytes from the offset specified.
      Parameters:
      sessionId - User session id.
      fileStorageId - Id of temporary file storage
      offset - Offset within file from where to read (long).
      length - Number of bytes to read.
      Returns:
      Data read from the file as a byte array. Returns null on file end.
      Throws:
      InvalidSessionFault - when the specified session id is invalid.
      SystemFault - when an unexpected system level error is encountered.
      PermissionDeniedFault - when the user doesn't have permission to view the file
      IllegalArgumentFault - when the specified fileStorageId is invalid.
      RemoteException
      Since:
      16.3