C/С++ Программирование на языке высокого уровня

Метод

Описание

BOOL Start()

Активирует FTP сервер. Он открывает "слушающий" сокет (порт 21) для ожидания соединений.

void Stop()

Останавливает сервер и разрывает все соединения клиентов путём прекращения всех запущенных потоков.

BOOL IsActive()

Активен ли FTP сервер?

void SetMaxUsers(int nValue)

Устанавливает максимальное количество пользователей.

void SetPort(int nValue)

Устанавливает слушающий порт для нового соединения.

void SetTimeout(int nValue)

Устанавливает тайм-аут для соединения (в мс).
Если клиент не пришлёт никакой команды через nValue мс, то сервер закроет соединение.

void SetWelcomeMessage(LPCTSTR lpszText)

Устанавливает текст, который будет показан, когда пользователь залогинится.

void SetSecurityMode(BOOL bBlockSpecific)

Устанавливает режим доступа (security).
Их всего два:
Первый проверяет список заблокированных IP адресов, а второй разрешает соединения только с IP адресами которые присутствуют в списке только разрешённых адресов.

void Initialize(CFTPEventSink *pEventSink)

Устанавливает приёмник событий.
Приёмник событий, это окно (или класс) который принимает события сгенерированные FTP сервером.
Более детальную информацию см. в CFTPEventSink.

Событие

Описание

void OnFTPUserConnected(DWORD nThreadID, LPCTSTR lpszUser, LPCSTR lpszAddress);

Клиент успешно соединился.

void OnFTPUserDisconnected(DWORD nThreadID, LPCTSTR lpszUser);

Клиент завершил соединение.

void OnFTPStatusChange(int nType, LPCTSTR lpszText);

Состояние FTP сервера изменилось (файл скачан/закачан).

void OnFTPReceivedBytesChange(int nBytes);

Изменилось количество принятых байт.

void OnFTPSentBytesChange(int nBytes);

Изменилось количество переданных байт.

void OnFTPStatisticChange(int nType, int nValue);

Статистика изменилась, например количество принятых или переданных файлов.

Другие вспомогательные классы:

CUserManager

Класс CUserManager обрабатывает всё, что связано с пользователями и файлами. Он проверяет подключённых пользователей на права доступа и преобразует удалённый и локальный пути. CUserManager использует Сериализацию для хранения и загрузки пользовательских настроек.

CSecurityManager

FTP сервер может хранить список IP адресов, которым запрещено соединение с сервером. Так же сервер может блокировать все адреса, заисключением тех, которые разрешены. CSecurityManager управляет этими двумя списками и следит за хранением и загрузкой их с диска.

CListenSocket

Этот сокет является частью CFTPServer и аксептит входящие соединения. Когда клиент коннектится к серверу, то CListenSocket аксептит соединение и создаёт новый поток (CConnectThread), который полностью заботится о соединение между клиентом и сервером. После того, как поток создан, CListenSocket вернётся в ожидающее состояние.

CConnectThread

Этот поток обрабатывает соединение между сервером и клиентом используя CConnectSocket.

CConnectSocket

Этот класс сокета обрабатывает все входящие команды FTP и отправляет обратно клиенту ответы.

CDataSocket

Когда необходимо отправить или принять данные, то в CConnectSocket создаётся CDataSocket. Класс CDataSocket передаёт эти данные (такие как список директорий и файлов) на отдельном порту.