Package jcifs.smb

Class SmbFileOutputStream

  • All Implemented Interfaces:
    java.io.Closeable, java.io.Flushable, java.lang.AutoCloseable

    public class SmbFileOutputStream
    extends java.io.OutputStream
    This OutputStream can write bytes to a file on an SMB file server.
    • Constructor Summary

      Constructors 
      Constructor Description
      SmbFileOutputStream​(java.lang.String url)
      Creates an OutputStream for writing to a file on an SMB server addressed by the URL parameter.
      SmbFileOutputStream​(java.lang.String url, boolean append)
      Creates an OutputStream for writing bytes to a file on an SMB server addressed by the URL parameter.
      SmbFileOutputStream​(java.lang.String url, int shareAccess)
      Creates an OutputStream for writing bytes to a file on an SMB server addressed by the SmbFile parameter.
      SmbFileOutputStream​(SmbFile file)
      Creates an OutputStream for writing bytes to a file on an SMB server represented by the SmbFile parameter.
      SmbFileOutputStream​(SmbFile file, boolean append)
      Creates an OutputStream for writing bytes to a file on an SMB server addressed by the SmbFile parameter.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void close()
      Closes this output stream and releases any system resources associated with it.
      boolean isOpen()  
      void write​(byte[] b)
      Writes b.length bytes from the specified byte array to this file output stream.
      void write​(byte[] b, int off, int len)
      Writes len bytes from the specified byte array starting at offset off to this file output stream.
      void write​(int b)
      Writes the specified byte to this file output stream.
      void writeDirect​(byte[] b, int off, int len, int flags)
      Just bypasses TransWaitNamedPipe - used by DCERPC bind.
      • Methods inherited from class java.io.OutputStream

        flush, nullOutputStream
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • SmbFileOutputStream

        public SmbFileOutputStream​(java.lang.String url)
                            throws SmbException,
                                   java.net.MalformedURLException,
                                   java.net.UnknownHostException
        Creates an OutputStream for writing to a file on an SMB server addressed by the URL parameter. See SmbFile for a detailed description and examples of the smb URL syntax.
        Parameters:
        url - An smb URL string representing the file to write to
        Throws:
        SmbException
        java.net.MalformedURLException
        java.net.UnknownHostException
      • SmbFileOutputStream

        public SmbFileOutputStream​(SmbFile file)
                            throws SmbException,
                                   java.net.MalformedURLException,
                                   java.net.UnknownHostException
        Creates an OutputStream for writing bytes to a file on an SMB server represented by the SmbFile parameter. See SmbFile for a detailed description and examples of the smb URL syntax.
        Parameters:
        file - An SmbFile specifying the file to write to
        Throws:
        SmbException
        java.net.MalformedURLException
        java.net.UnknownHostException
      • SmbFileOutputStream

        public SmbFileOutputStream​(java.lang.String url,
                                   boolean append)
                            throws SmbException,
                                   java.net.MalformedURLException,
                                   java.net.UnknownHostException
        Creates an OutputStream for writing bytes to a file on an SMB server addressed by the URL parameter. See SmbFile for a detailed description and examples of the smb URL syntax. If the second argument is true, then bytes will be written to the end of the file rather than the beginning.
        Parameters:
        url - An smb URL string representing the file to write to
        append - Append to the end of file
        Throws:
        SmbException
        java.net.MalformedURLException
        java.net.UnknownHostException
      • SmbFileOutputStream

        public SmbFileOutputStream​(SmbFile file,
                                   boolean append)
                            throws SmbException,
                                   java.net.MalformedURLException,
                                   java.net.UnknownHostException
        Creates an OutputStream for writing bytes to a file on an SMB server addressed by the SmbFile parameter. See SmbFile for a detailed description and examples of the smb URL syntax. If the second argument is true, then bytes will be written to the end of the file rather than the beginning.
        Parameters:
        file - An SmbFile representing the file to write to
        append - Append to the end of file
        Throws:
        SmbException
        java.net.MalformedURLException
        java.net.UnknownHostException
      • SmbFileOutputStream

        public SmbFileOutputStream​(java.lang.String url,
                                   int shareAccess)
                            throws SmbException,
                                   java.net.MalformedURLException,
                                   java.net.UnknownHostException
        Creates an OutputStream for writing bytes to a file on an SMB server addressed by the SmbFile parameter. See SmbFile for a detailed description and examples of the smb URL syntax.

        The second parameter specifies how the file should be shared. If SmbFile.FILE_NO_SHARE is specified the client will have exclusive access to the file. An additional open command from jCIFS or another application will fail with the "file is being accessed by another process" error. The FILE_SHARE_READ, FILE_SHARE_WRITE, and FILE_SHARE_DELETE may be combined with the bitwise OR '|' to specify that other peocesses may read, write, and/or delete the file while the jCIFS user has the file open.

        Parameters:
        url - An smb URL representing the file to write to
        shareAccess - File sharing flag: SmbFile.FILE_NOSHARE or any combination of SmbFile.FILE_READ, SmbFile.FILE_WRITE, and SmbFile.FILE_DELETE
        Throws:
        SmbException
        java.net.MalformedURLException
        java.net.UnknownHostException
    • Method Detail

      • close

        public void close()
                   throws java.io.IOException
        Closes this output stream and releases any system resources associated with it.
        Specified by:
        close in interface java.lang.AutoCloseable
        Specified by:
        close in interface java.io.Closeable
        Overrides:
        close in class java.io.OutputStream
        Throws:
        java.io.IOException - if a network error occurs
      • write

        public void write​(int b)
                   throws java.io.IOException
        Writes the specified byte to this file output stream.
        Specified by:
        write in class java.io.OutputStream
        Throws:
        java.io.IOException - if a network error occurs
      • write

        public void write​(byte[] b)
                   throws java.io.IOException
        Writes b.length bytes from the specified byte array to this file output stream.
        Overrides:
        write in class java.io.OutputStream
        Throws:
        java.io.IOException - if a network error occurs
      • isOpen

        public boolean isOpen()
      • write

        public void write​(byte[] b,
                          int off,
                          int len)
                   throws java.io.IOException
        Writes len bytes from the specified byte array starting at offset off to this file output stream.
        Overrides:
        write in class java.io.OutputStream
        Parameters:
        b - The array
        Throws:
        java.io.IOException - if a network error occurs
      • writeDirect

        public void writeDirect​(byte[] b,
                                int off,
                                int len,
                                int flags)
                         throws java.io.IOException
        Just bypasses TransWaitNamedPipe - used by DCERPC bind.
        Throws:
        java.io.IOException