Interface SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder

  • All Superinterfaces:
    org.apache.camel.builder.EndpointProducerBuilder, org.apache.camel.EndpointProducerResolver
    All Known Subinterfaces:
    SftpEndpointBuilderFactory.AdvancedSftpEndpointBuilder
    Enclosing interface:
    SftpEndpointBuilderFactory

    public static interface SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder
    extends org.apache.camel.builder.EndpointProducerBuilder
    Advanced builder for endpoint producers for the SFTP component.
    • Method Detail

      • fastExistsCheck

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder fastExistsCheck​(boolean fastExistsCheck)
        If set this option to be true, camel-ftp will use the list file directly to check if the file exists. Since some FTP server may not support to list the file directly, if the option is false, camel-ftp will use the old way to list the directory and check if the file exists. This option also influences readLock=changed to control whether it performs a fast check to update file information or not. This can be used to speed up the process if the FTP server has a lot of files. The option is a: boolean type. Default: false Group: common (advanced)
      • fastExistsCheck

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder fastExistsCheck​(String fastExistsCheck)
        If set this option to be true, camel-ftp will use the list file directly to check if the file exists. Since some FTP server may not support to list the file directly, if the option is false, camel-ftp will use the old way to list the directory and check if the file exists. This option also influences readLock=changed to control whether it performs a fast check to update file information or not. This can be used to speed up the process if the FTP server has a lot of files. The option will be converted to a boolean type. Default: false Group: common (advanced)
      • allowNullBody

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder allowNullBody​(boolean allowNullBody)
        Used to specify if a null body is allowed during file writing. If set to true then an empty file will be created, when set to false, and attempting to send a null body to the file component, a GenericFileWriteException of 'Cannot write null body to file.' will be thrown. If the fileExist option is set to 'Override', then the file will be truncated, and if set to append the file will remain unchanged. The option is a: boolean type. Default: false Group: producer (advanced)
      • allowNullBody

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder allowNullBody​(String allowNullBody)
        Used to specify if a null body is allowed during file writing. If set to true then an empty file will be created, when set to false, and attempting to send a null body to the file component, a GenericFileWriteException of 'Cannot write null body to file.' will be thrown. If the fileExist option is set to 'Override', then the file will be truncated, and if set to append the file will remain unchanged. The option will be converted to a boolean type. Default: false Group: producer (advanced)
      • disconnectOnBatchComplete

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder disconnectOnBatchComplete​(boolean disconnectOnBatchComplete)
        Whether or not to disconnect from remote FTP server right after a Batch upload is complete. disconnectOnBatchComplete will only disconnect the current connection to the FTP server. The option is a: boolean type. Default: false Group: producer (advanced)
      • disconnectOnBatchComplete

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder disconnectOnBatchComplete​(String disconnectOnBatchComplete)
        Whether or not to disconnect from remote FTP server right after a Batch upload is complete. disconnectOnBatchComplete will only disconnect the current connection to the FTP server. The option will be converted to a boolean type. Default: false Group: producer (advanced)
      • eagerDeleteTargetFile

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder eagerDeleteTargetFile​(boolean eagerDeleteTargetFile)
        Whether or not to eagerly delete any existing target file. This option only applies when you use fileExists=Override and the tempFileName option as well. You can use this to disable (set it to false) deleting the target file before the temp file is written. For example you may write big files and want the target file to exists during the temp file is being written. This ensure the target file is only deleted until the very last moment, just before the temp file is being renamed to the target filename. This option is also used to control whether to delete any existing files when fileExist=Move is enabled, and an existing file exists. If this option copyAndDeleteOnRenameFails false, then an exception will be thrown if an existing file existed, if its true, then the existing file is deleted before the move operation. The option is a: boolean type. Default: true Group: producer (advanced)
      • eagerDeleteTargetFile

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder eagerDeleteTargetFile​(String eagerDeleteTargetFile)
        Whether or not to eagerly delete any existing target file. This option only applies when you use fileExists=Override and the tempFileName option as well. You can use this to disable (set it to false) deleting the target file before the temp file is written. For example you may write big files and want the target file to exists during the temp file is being written. This ensure the target file is only deleted until the very last moment, just before the temp file is being renamed to the target filename. This option is also used to control whether to delete any existing files when fileExist=Move is enabled, and an existing file exists. If this option copyAndDeleteOnRenameFails false, then an exception will be thrown if an existing file existed, if its true, then the existing file is deleted before the move operation. The option will be converted to a boolean type. Default: true Group: producer (advanced)
      • keepLastModified

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder keepLastModified​(boolean keepLastModified)
        Will keep the last modified timestamp from the source file (if any). Will use the Exchange.FILE_LAST_MODIFIED header to located the timestamp. This header can contain either a java.util.Date or long with the timestamp. If the timestamp exists and the option is enabled it will set this timestamp on the written file. Note: This option only applies to the file producer. You cannot use this option with any of the ftp producers. The option is a: boolean type. Default: false Group: producer (advanced)
      • keepLastModified

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder keepLastModified​(String keepLastModified)
        Will keep the last modified timestamp from the source file (if any). Will use the Exchange.FILE_LAST_MODIFIED header to located the timestamp. This header can contain either a java.util.Date or long with the timestamp. If the timestamp exists and the option is enabled it will set this timestamp on the written file. Note: This option only applies to the file producer. You cannot use this option with any of the ftp producers. The option will be converted to a boolean type. Default: false Group: producer (advanced)
      • moveExistingFileStrategy

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder moveExistingFileStrategy​(Object moveExistingFileStrategy)
        Strategy (Custom Strategy) used to move file with special naming token to use when fileExist=Move is configured. By default, there is an implementation used if no custom strategy is provided. The option is a: org.apache.camel.component.file.strategy.FileMoveExistingStrategy type. Group: producer (advanced)
      • moveExistingFileStrategy

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder moveExistingFileStrategy​(String moveExistingFileStrategy)
        Strategy (Custom Strategy) used to move file with special naming token to use when fileExist=Move is configured. By default, there is an implementation used if no custom strategy is provided. The option will be converted to a org.apache.camel.component.file.strategy.FileMoveExistingStrategy type. Group: producer (advanced)
      • sendNoop

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder sendNoop​(boolean sendNoop)
        Whether to send a noop command as a pre-write check before uploading files to the FTP server. This is enabled by default as a validation of the connection is still valid, which allows to silently re-connect to be able to upload the file. However if this causes problems, you can turn this option off. The option is a: boolean type. Default: true Group: producer (advanced)
      • sendNoop

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder sendNoop​(String sendNoop)
        Whether to send a noop command as a pre-write check before uploading files to the FTP server. This is enabled by default as a validation of the connection is still valid, which allows to silently re-connect to be able to upload the file. However if this causes problems, you can turn this option off. The option will be converted to a boolean type. Default: true Group: producer (advanced)
      • autoCreate

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder autoCreate​(boolean autoCreate)
        Automatically create missing directories in the file's pathname. For the file consumer, that means creating the starting directory. For the file producer, it means the directory the files should be written to. The option is a: boolean type. Default: true Group: advanced
      • autoCreate

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder autoCreate​(String autoCreate)
        Automatically create missing directories in the file's pathname. For the file consumer, that means creating the starting directory. For the file producer, it means the directory the files should be written to. The option will be converted to a boolean type. Default: true Group: advanced
      • bulkRequests

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder bulkRequests​(String bulkRequests)
        Specifies how many requests may be outstanding at any one time. Increasing this value may slightly improve file transfer speed but will increase memory usage. The option will be converted to a java.lang.Integer type. Group: advanced
      • compression

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder compression​(int compression)
        To use compression. Specify a level from 1 to 10. Important: You must manually add the needed JSCH zlib JAR to the classpath for compression support. The option is a: int type. Group: advanced
      • existDirCheckUsingLs

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder existDirCheckUsingLs​(boolean existDirCheckUsingLs)
        Whether to check for existing directory using LS command or CD. By default LS is used which is safer as otherwise Camel needs to change the directory back after checking. However LS has been reported to cause a problem on windows system in some situations and therefore you can disable this option to use CD. The option is a: boolean type. Default: true Group: advanced
      • existDirCheckUsingLs

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder existDirCheckUsingLs​(String existDirCheckUsingLs)
        Whether to check for existing directory using LS command or CD. By default LS is used which is safer as otherwise Camel needs to change the directory back after checking. However LS has been reported to cause a problem on windows system in some situations and therefore you can disable this option to use CD. The option will be converted to a boolean type. Default: true Group: advanced
      • maximumReconnectAttempts

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder maximumReconnectAttempts​(int maximumReconnectAttempts)
        Specifies the maximum reconnect attempts Camel performs when it tries to connect to the remote FTP server. Use 0 to disable this behavior. The option is a: int type. Group: advanced
      • maximumReconnectAttempts

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder maximumReconnectAttempts​(String maximumReconnectAttempts)
        Specifies the maximum reconnect attempts Camel performs when it tries to connect to the remote FTP server. Use 0 to disable this behavior. The option will be converted to a int type. Group: advanced
      • serverAliveCountMax

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder serverAliveCountMax​(int serverAliveCountMax)
        Sets the number of keep-alive messages which may be sent without receiving any messages back from the server. If this threshold is reached while keep-alive messages are being sent, the connection will be disconnected. The default value is one. The option is a: int type. Default: 1 Group: advanced
      • serverAliveCountMax

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder serverAliveCountMax​(String serverAliveCountMax)
        Sets the number of keep-alive messages which may be sent without receiving any messages back from the server. If this threshold is reached while keep-alive messages are being sent, the connection will be disconnected. The default value is one. The option will be converted to a int type. Default: 1 Group: advanced
      • serverAliveInterval

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder serverAliveInterval​(int serverAliveInterval)
        Sets the interval (millis) to send a keep-alive message. If zero is specified, any keep-alive message must not be sent. The default interval is zero. The option is a: int type. Group: advanced
      • serverAliveInterval

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder serverAliveInterval​(String serverAliveInterval)
        Sets the interval (millis) to send a keep-alive message. If zero is specified, any keep-alive message must not be sent. The default interval is zero. The option will be converted to a int type. Group: advanced
      • soTimeout

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder soTimeout​(int soTimeout)
        Sets the so timeout FTP and FTPS Only for Camel 2.4. SFTP for Camel 2.14.3/2.15.3/2.16 onwards. Is the SocketOptions.SO_TIMEOUT value in millis. Recommended option is to set this to 300000 so as not have a hanged connection. On SFTP this option is set as timeout on the JSCH Session instance. The option is a: int type. Default: 5m Group: advanced
      • soTimeout

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder soTimeout​(String soTimeout)
        Sets the so timeout FTP and FTPS Only for Camel 2.4. SFTP for Camel 2.14.3/2.15.3/2.16 onwards. Is the SocketOptions.SO_TIMEOUT value in millis. Recommended option is to set this to 300000 so as not have a hanged connection. On SFTP this option is set as timeout on the JSCH Session instance. The option will be converted to a int type. Default: 5m Group: advanced
      • stepwise

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder stepwise​(boolean stepwise)
        Sets whether we should stepwise change directories while traversing file structures when downloading files, or as well when uploading a file to a directory. You can disable this if you for example are in a situation where you cannot change directory on the FTP server due security reasons. Stepwise cannot be used together with streamDownload. The option is a: boolean type. Default: true Group: advanced
      • stepwise

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder stepwise​(String stepwise)
        Sets whether we should stepwise change directories while traversing file structures when downloading files, or as well when uploading a file to a directory. You can disable this if you for example are in a situation where you cannot change directory on the FTP server due security reasons. Stepwise cannot be used together with streamDownload. The option will be converted to a boolean type. Default: true Group: advanced
      • synchronous

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder synchronous​(boolean synchronous)
        Sets whether synchronous processing should be strictly used, or Camel is allowed to use asynchronous processing (if supported). The option is a: boolean type. Default: false Group: advanced
      • throwExceptionOnConnectFailed

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder throwExceptionOnConnectFailed​(boolean throwExceptionOnConnectFailed)
        Should an exception be thrown if connection failed (exhausted) By default exception is not thrown and a WARN is logged. You can use this to enable exception being thrown and handle the thrown exception from the org.apache.camel.spi.PollingConsumerPollStrategy rollback method. The option is a: boolean type. Default: false Group: advanced
      • throwExceptionOnConnectFailed

        default SftpEndpointBuilderFactory.AdvancedSftpEndpointProducerBuilder throwExceptionOnConnectFailed​(String throwExceptionOnConnectFailed)
        Should an exception be thrown if connection failed (exhausted) By default exception is not thrown and a WARN is logged. You can use this to enable exception being thrown and handle the thrown exception from the org.apache.camel.spi.PollingConsumerPollStrategy rollback method. The option will be converted to a boolean type. Default: false Group: advanced