Seção	Descrição	Data Prevista	Data Completada	Criadores(es)	Revisor/data
1	Requirements	22/05/98	22/05/98	Amauri, Ivan, Roger
2	Design Description	22/05/98	22/05/98	Amauri, Ivan, Roger
3	External Interfaces	22/05/98	22/05/98	Amauri, Ivan, Roger
4	Functional Capabilities List	22/05/98	22/05/98	Amauri, Ivan, Roger
5	Unit Code	22/05/98	22/05/98	Amauri, Ivan, Roger
6	Unit Test Plan	22/05/98	22/05/98	Amauri, Ivan, Roger
7	Test Case Results	22/05/98	22/05/98	Amauri, Ivan, Roger
8	Build Procedures	22/05/98	22/05/98	Amauri, Ivan, Roger
9	Problems Reports	22/05/98	22/05/98	Amauri, Ivan, Roger
10	Notes	22/05/98	22/05/98	Amauri, Ivan, Roger
11	Reviewers	22/05/98	22/05/98	Amauri, Ivan, Roger

 

1- Requirements

O ambiente de programação utilizado nesta unit é o JDK (1.1.5), utilizando-se o compilador javac e algum editor de textos ASCII.
O protocolo: FTP RFC959.

2- Design Description

 A comunicação entre cliente e servidor é feita seguindo-se o padrão entre ftp's: primeiro um número que é universal e seguindo-o uma string, para facilitar o entendimento do usuário. Tal string conterá frases de uma linguagem qualquer -- neste ftp, por exemplo, português -- sendo o número o que será realmente utilizado pelo software.

O servidor fica em um loop aguardando novas conecções ftp que serão passadas para threads responsáveis pelo atendimento. Passa-se, então, a aguardar que o cliente envie os comandos USER e PASS -- necessáriamente -- para que se possa efetuar o login. Tendo sido efetuado, fica-se aguardando por comandos do cliente.

Cada comando corresponde a uma classe, ou seja, se o servidor não encontrar algum comando solicitado é porque a classe correspondente não está implementada. Com isso,teremos grande liberdade, uma vez que inclusões de novos comandos não exigirá mudanças no código do servidor,  já que será necessário somente criar novas classes. Tudo isto é possível pois o servidor tem um método chamado start( ), que será o responsável pela execução da classe correspondente ao comando solicitado.

Já o cliente é basicamente um parser que irá identificar o que o cliente está requisitando, incluindo  todo o tratamento de erros. O comando será enviado ao servidor, passando-se a aguardar resposta que será impressa no standard output.

A comunicação entre cliente e servidor é feita por meio de sockets, sendo que existe um para leitura e outro para escrita.
 

Deve-se manter o servidor executando em background; irá ser passado como parâmetro (parâmetros errados levarão a ocorrência de erro) a porta em que iremos realizar futuras conecções e o diretório que irá ser assumido como raiz.
java ftpServer <porta> <diretório raiz>
java ftpServer 21 c:\users

Ao cliente deve ser passado a máquina onde está sendo exeutado o servidor e a respectiva porta.
java Client <host> <porta>
java Client tubaina 21

O programa implementa um servidor e um cliente FTP. O usuário terá acesso aos comandos:
 
• ls: mostra o conteúdo do diretório atual do servidor;
• pwd: mostra o diretório corrente do servidor;
• syst: mostra informações da máquina em que está sendo executado o servidor;
• cd: vai para o diretório especificado no servidor;
• lls: mostra o conteúdo do diretório atual do cliente;
• lcd: vai para o diretório especificado no cliente;
• put: grava um arquivo no diretório corrente do servidor;
• mput: grava todos os arquivos que atendem a um certo padrão de nome no servidor;
• get: obtém um arquivo do diretório corrente do servidor;
• mget: obtém todos os arquivos que atendem a um certo padrão de nome do servidor;
O  ftp server aceita dois logins: anonymous e ftp, que irá trabalhar somente no modo binário(bin).

A implementação foi feita em JAVA:

Códigos do Servidor:

ftpServer.java
CWDcomm.java
NLSTcomm.java
PASScomm.java
PWDcomm.java
QUITcomm.java
RETRcomm.java
STORcomm.java
SYSTcomm.java
XPWDcomm.java
ftpFunc.java
ftpState.java
 

Códigos do Cliente:

Client.java
 

Foram testados cada módulo separadamente. O que foi implementado funciona corretamente se forem seguidos os passos corretamente -- deve-se observar que nem todos os limites de erro estão sendo verificados.

 testes.

Para gerar o executável basta o comando abaixo:
javac *.java
, no diretório com os arquivos '.java'.

Foi encontrada uma dificuldade inicial no entendimento do padrão estabelecido para o ftp, devido à grande variedade de menssagens envolvidas e ao esquema de duas conexões diferentes, comando e dado, para a transferência de dados.
Por falta de tempo, não foi implementado o comando PORT, portanto para se estabelecer a conexão de dados foi fixada a porta 2222, o que faz com que o servidor funcione parcialmente, ou seja, não irá estabelecer uma conexão de dados com clientes que não o desenvolvido por esta unit até este momento.
Não foi possível fazer bind na mesma porta da conexão de comandos.
O diretório raiz, com o programa rodando em cima do ambiente MS-DOS, não foi possível, o seguinte código retorna null no programa:
File uga = new File("c:\\");
String[] buga = uga.list();
//Da' pau, buga == null...

 É importante observar que o servidor funciona com um cliente ftp normal (a menos da mudança efetuada pelo fato de não termos implementado o comando PORT), assim como o cliente funciona com um servidor ftp normal, uma vez que atendem parcialmente à especificação oficial do File Tranfer Protocol (FTP).