Использовать FTP

IRISпредоставляет класс%Net.FtpSession,Вы можете использовать его из InterSystems «Настроить сеанс с FTP-сервером в IRIS».

Установить FTP-сессию

Чтобы Установить FTP-сессию, выполните следующие действия:

1. создавать%Net.FtpSessionПример。
2. При желании вы можете установить свойства этого экземпляра для управления общим поведением сеанса:

• Timeout Таймаут указывает время в секундах ожидания ответа от FTP-сервера.
• SSLConfigurationУказывает активацию соединенияSSL/TLSКонфигурация(если есть)。еслиFTPИспользование сервераHTTPS,Пожалуйста, используйте эту опцию.
• TranslateTableУказывает таблицу перевода, которая будет использоваться при чтении или записи содержимого файла.。
• UsePASVдавать возможностьPASVмодель。
• когдаFTPИспользование сервераhttpsчас,SSLCheckServerIdentityПрименимый。По умолчанию,когда%Net.FtpSessionПримерподключиться кSSL/TLSсерверчас,Он проверяет, соответствует ли имя сервера Сертификата DNS-имени, используемому для подключения к серверу. Если эти имена не совпадают,Соединение не разрешено.

Чтобы отключить эту проверку,пожалуйста ВоляSSLCheckServerIdentityСвойство настроено на0。

1. вызовConnect()способ подключения к определенномуFTPсервер。
2. вызовascii()илиbinary()метод Воляпередача инфекциимодель Установить отдельнодляASCIIмодельилидвоичныймодель。Для просмотракогда前передача инфекциимодель,Проверьте значение атрибута Type экземпляра.

Уведомление：%Net.FtpSessionизкаждыйметод Все возвращают одинаковый статус,Этот статус следует проверить. Эти методы также устанавливают значения свойств, предоставляющих полезную информацию о состоянии сеанса:

• Если в настоящее время подключено,ноCONNECTEDдляTRUE,В противном случае ЛОЖЬ.
• ReturnCodeСодержит последний раз сFTPсерверкоммуникациячасизкод возврата。
• ReturnMessageСодержит последний раз сFTPсерверкоммуникациячасизответное сообщение。

Status()методвозвращаться(по ссылке)FTPсерверизсостояние。

Таблица преобразования команд

%Net.FtpSessionсуществоватьFTPсервер Проверьте имя файла наипутьчас,использоватьRFC 2640введено виз Техническая автоматическая обработкахарактерустановить преобразование。когда%Net.FtpSessionПримерподключиться кFTPсерверчас,этовстречаиспользоватьFeatсообщение для подтверждениясерверлииспользоватьUTF-8характер。еслида,это Воля Связь по командному каналу переключается наUTF-8,чтобы все имена файлов и пути корректно работали сUTF-8взаимное преобразование。

еслисервер Не поддерживаетсяFEATЗаказили О поддержке не сообщаетсяUTF-8,%Net.FtpSessionПример ВоляиспользоватьRAWмодельи читатьилиписатьRAWбайт。

в редких случаях,При необходимости укажите таблицу преобразования, которую следует использовать.,пожалуйстанастраивать%Net.FtpSessionПримеризCommandTranslateTableсвойство。Обычно,Не должно быть необходимости использовать этот атрибут.

FTP-файл и системные методы

После установки FTP-сессии,Вот и всевызоввстреча话ПримеризметодвыполнитьFTPЗадача。%Net.FtpSessionПредоставьте следующие файлы для чтения и записи.изметод：

Delete()

Удалить файлы.

Retrieve()

Копирование файлов с FTP-сервера на InterSystems IRISв потоке,и возвращает поток по ссылке. Чтобы использовать этот поток,пожалуйстаиспользоватьстандартный потокметод：Write()、WriteLine()、Read()、ReadLine()、Rewind()、MoveToEnd()иClear()。Достаточно хорошоиспользоватьпотокизSizeсвойство。

RetryRetrieve()

Разрешить извлечение файла продолжить,потому чтодля Данныйизпотокда由начальство一次использоватьRetrieve()создаватьиз。

Store()

Запишите содержимое потока IRIS в файл на FTP-сервере.

Append()

Добавляет содержимое потока в конец указанного файла.

Rename()

Переименуйте файл.

также,%Net.FtpSessionОбеспечивает навигациюи ИсправлятьFTPсерверначальствоизфайловая системаизметод：GetDirectory()、SetDirectory()、SetToParentDirectory()иMakeDirectory()。

Для проверки содержимого файловой системы,пожалуйстаиспользоватьlist()илиNameList()метод。

• List()создавать一个поток,Содержит список всех файлов, имена которых соответствуют заданному шаблону.,и возвращает поток по ссылке.
• NameList()создаватьмассив имен файловпо ссылкевозвращаться该数组。

Достаточно хорошоиспользоватьChangeUser()метод Изменятьдлядругие пользователи；Это быстрее, чем выйти из системы и войти снова.。использоватьLogout()метод Выйти。

System()методвозвращаться(по ссылке)О хостингеFTPсерверизтип компьютераизинформация。

Size()иMDTM()метод分别возвращаться文件изразмери Исправлятьчасмежду。

использовать УниверсальныйsendCommand()метод КFTPсервер发送Закази читать响应。этотметод Доступно для отправки%Net.FtpSessionКоманды, явно не поддерживаемые в。

Загрузка больших файлов с использованием связанных потоков

Если вы хотите загрузить большой файл,пожалуйстаучитыватьиспользоватьпоток接口изLinkToFile()метод。То есть,Вместо создания потока и чтения в него файла,而дасоздаватьпоток并Воляэто связано с файлом。существоватьвызов%Net.FtpSessionизStore()методчасиспользоватьэтот链接поток。

Method SendLargeFile(ftp As %Net.FtpSession, dir As %String, filename As %String)
{
    Set filestream=##class(%FileBinaryStream).%New()
    Set sc=filestream.LinkToFile(dir_filename)
    If $$$ISERR(sc) {do $System.Status.DisplayError(sc) quit }
    
    //Загруженный файл Воля имеет то же имя, что и исходный файл
    Set newname=filename

    Set sc=ftp.Store(newname,filestream)
    If $$$ISERR(sc) {do $System.Status.DisplayError(sc) quit }
}

Настройте обратный вызов, выданный FTP-сервером

Можно настроитьFTPсервергенерироватьизперезвонить。Например,делая,Может предоставлять пользователям информацию о том, что сервер все еще обрабатывает большие переводы.,или разрешить пользователю прервать передачу.

Чтобы настроить обратные вызовы FTP:

1. создавать%Net.FtpCallbackиз Подкласс。
2. в этом подклассе,выполнитьRetrieveCallback()метод,Этот метод вызывается периодически при получении данных с FTP-сервера.
3. БолеевыполнитьStoreCallback()метод,Этот метод вызывается периодически, когда данные Воля записываются на FTP-сервер.
4. создаватьFTPвстреча话час(нравиться“Установить FTP-сессию”как сказано в),Воляперезвонить Свойство настроено наравныйиз Подкласс%Net.FtpCallback。