Trabalhos de MAC 441/5714

Datas de Entrega dos Trabalhos:

• Fase 1:  28/4
• Fase 2:  02/6
• Fase 3:  4/07

Sistema de Webmail

Fase 1: 

From: Laura Rios <laura@oara.sf.ca.us>
To: steve@ntecom.za
Subject: Sara is two!
Mime-Version: 1.0
Content-Type: multipart/mixed; boundary="--Snip snip snip"

--Snip snip snip
Content-Type: text/enriched; charset="us-ascii"

Hi, Steve.  Sara had her second birthday yesterday.  Can you believe it?
She is so <bold>big</bold>!  Now if we can just live through the
"terrible twos" for a year, <italic>sigh</italic>.


Here are a few words from her.  I've also scanned in a picture of her
party.  Tell your boss thanks for letting us keep in touch by email.


Laura

--Snip snip snip
Content-type: audio/basic
Content-transfer-encoding: base64
Content-description: Sara says "I love you, Steve" (awww)

/Xr++/hoX2lqeXt8d/7z8/D5+PLw7/b+9fD09319/vz5f3j//Pz9fHp7fvrs9Wz/eH59d

/////////////////y8=

--Snip snip snip
Content-type: image/gif
Content-transfer-encoding: base64
Content-description: Cutting the cake, sort of

R0lGODdhQAHIAKMAAAAAAP+2bQAAACQAAAAASEgAAAAkSEgkJG0kJJEkAABIkZFIJCRttrZt

l7Vry4B9aM+yKjifMosAADs=

--Snip snip snip--

Epílogo: Qualquer texto colocado aqui deve ser ignorado.

Mensagens podem ser criadas através do método:

umaMensagem := Mensagem de:umUsuario comConteudo:umConteudo.

Mensagens válidas contêm um campo From:, um campo Date: e ao menos um campo To: ou Bcc: ou Cc:. O método de:comConteudo: deve produzir um erro caso o conteudo passado como parâmetro seja inválido. Os atributos manipulados pelos métodos abaixo são instâncias de Atributo.

"Devolve o atributo obrigatório Date:, presente em qualquer cabeçalho."
umaMensagem date.

"Idem para o atributo obrigatório From:"
umaMensagem from.

"Idem para o atributo obrigatório To:. Este método devolve uma OrderedCollection já que uma mensagem de e-mail pode conter múltiplas instâncias de To: em seu cabeçalho."
umaMensagem to.

"Idem para o atributo Bcc:. Este método também devolve uma OrderedCollection."
umaMensagem bcc.

"Idem para o atributo cc:. Este método também devolve uma OrderedCollection."
umaMensagem cc.

"Devolve a coleção de atributos cuja chave é Receive, na ordem em que aparecem no cabeçalho."
umaMensagem atributosComChave: 'Receive'.

"Devolve a coleção de conteúdos que são filhos desta mensagem, ou uma coleção vazia caso não haja nenhum."
umaMensagem conteudos.

"Devolve o corpo desta mensagem (i.e., tudo o que não for o cabeçalho desta mensagem)."
umaMensagem corpo.

"Devolve o remetente associado a esta Mensagem."
umaMensagem remetente.

"Devolve esta mensagem em formato texto (com cabeçalho e tudo)."
umaMensagem asString.

"Devolve se esta mensagem está marcada como lida (true) ou não lida (false)."
umaMensagem lida.

"Modifica o estado desta mensagem para lida ou não lida. Aceita true ou false."
umaMensagem lida: umBooleano.

Conteudo: Generalização de Mensagem, representa o conteúdo de um e-mail. Conteúdos são compostos por um cabeçalho (uma coleção de atributos no estilo chave:valor) e por um corpo de texto. O corpo de texto pode representar subconteúdos, caso o Conteudo seja multiparte. A classe Conteudo pode ser implementada como uma superclasse de Mensagem, ou não. A interface de conteúdo inclui os métodos atributosComChave:, conteudos, corpo e asString de Mensagem (com semântica idêntica), mais os seguintes métodos:

"Adiciona outroConteudo como subconteúdo de umConteudo."
umConteudo adicionaConteudo: outroConteudo.

"Remove o subconteúdo outroConteudo de umConteudo."
umConteudo removeConteudo: outroConteudo.

"Faz de umaString o novo corpo de umConteudo. Se umConteudo for multiparte, umaString deve ser interpretada como um conteúdo multiparte. Se umaString for um conteudo multiparte mal-formado, este método deve produzir um erro."
umConteudo corpo: umaString.

"Adiciona o atributo umAtributo ao cabeçalho."
umConteudo adicionaAtributo: umAtributo.

"Remove o atributo umAtributo do cabeçalho."
umConteudo removeAtributo: umAtributo.

"Devolve uma OrderedCollection com todos os atributos do cabeçalho deste Conteudo."
umConteudo todosAtributos.

Além disso, a classe conteúdo disponibiliza um método que permite instanciar novos conteúdos a partir de uma representação textual. Esse método chama-se 'com:'. Exemplo:

"Cria uma stream de leitura num arquivo que contém uma mensagem"
readStream := CrLfFileStream fileNamed: '/home/giuliano/Maildir/cur/1144263147.000001.mbox:2,S'
readStream converter: (Latin1TextConverter new).

"Instancia um conteúdo a partir dessa mensagem."
novoConteudo := Conteudo com: (aReadStream contents).

"Cria um clone de 'novoConteudo'".
conteudoClone := Conteudo com: (novoConteudo asString).

"Cria uma mensagem cujo conteúdo é o dado por novoConteudo"
umaMensagem := [Mensagem de:umUsuario comConteudo:novoConteudo]
                    ifError: [:err :rcvr |
                                ('ConteudoInvalido' = err) ifTrue:
                                [Transcript show: (rcvr ultimoErro). nil]]

Atributo: Um par chave-valor. Atributos são imutáveis, e criados pelo método:

umAtributo := Atributo novoComChave: umaChave eValor: umValor.

Além disso, atributos disponibilizam sua chave e valor por meio dos métodos chave e valor.

Dicas:

Dicas e pacotes úteis que discutimos na aula de 10/04:

- Vassili's RegEx (Categoria VB- na imagem 3.8).
- Regular Expression Plug-in (está no SqueakMap).
- Small Compiler Compiler (SmaCC, também no SqueakMap).
- Recomendo o uso da CrLfFileStream para a leitura de arquivos pré-gravados. Não esqueçam de instalar o Latin1TextConverter na stream (método converter:), ou algumas surpresas desagradáveis podem ocorrrer.
- As classes mais importantes para manipulação do sistema de arquivos são FileDirectory e DirectoryEntry.

Nesta fase, vocês deverão implementar as funcionalidades mais fundamentais da interface do sistema de Web Mail. A interface deve, obrigatoriamente, ser uma interface Web baseada no Seaside. Tanto o projeto quanto a implementação são livres. Deve ser possível, no entanto:

1. Visualizar todas as pastas criadas;
2. criar novas pastas e remover pastas antigas;
3. criar e enviar novas mensagens;
4. apagar mensagens antigas;
5. pegar mensagens de uma conta POP3 por meio de um botão ou link;
6. responder a qualquer mensagem;
7. listar as mensagens guardadas por pasta, exibindo X mensagens por página (X é um número fixo);
8. abrir mensagens guardadas para visualização (basta mostrar o corpo completo do conteúdo-raiz, não precisam se preocupar com attachments ainda);
9. inspecionar de forma menos crua os principais campos da mensagem (From:, To:, CC:, Date:, Subject:).

1. Visualização de mensagens enviadas (vale 0,25 ponto extra);
2. demarcação de mensagens como lidas/não-lidas (vale 0,75 ponto extra);
3. configuração do número de mensagens listadas por página no requisito 7 (vale 0,5 ponto extra);
4. acesso à representação textual da mensagem em sua íntegra; cabeçalho incluso (vale 0,25 ponto extra);
5. <coloque seu requisito aqui - envie uma proposta para mim> (vale X,X ponto(s) extra(s)).

A interface que esperamos para esta fase é algo bem simples. Para os pouco criativos, há algumas sugestões de interfaces disponíveis (modo de visualização de mensagem, modo de edição, modo de listagem). Nesta fase, vocês não devem se preocupar com gerenciamento de sessões/usuários/login, com anexos (attachments) e nem com a edição de rascunhos (mensagens criadas e não-enviadas). O sistema deve usar um usuário padrão, bem como uma conta POP e uma conta SMTP padrão. Para tanto, vocês devem incluir em WebMail os seguintes métodos provisórios:

“Inicializa o Maildir do usuário padrão.”
webMail inicializaUsuarioPadrao.
“Registra umaContaSMTP como a conta SMTP padrão, que será usada para o envio de e-mails”
webMail contaSMTPPadrao: umaContaSMTP.
“Registra umaContaPOP3 como conta a conta POP3 padrão, que será usada para a checagem de mensagens.”
webMail contaPOP3Padrao: umaContaPOP3.

Esses métodos serão úteis apenas para esta fase.

Fase 3:

• Tornar o sistema de Web Mail multiusuário. Isso envolve, essencialmente:

1. Adicionar uma tela de autenticação ao sistema. A identificação do usuário deve ser feita mediante a apresentação de um login e de uma senha. Exemplo de tela de autenticação.
   
2. Adicionar um botão (ou link) de logout, facilmente acessível, à interface do sistema. O botão de logout deve encerrar a sessão em curso. Exemplo de botão de logout na tela de listagem de mensagens.
   
   O sistema não pode apresentar restrições com relação ao número de usuários simultâneos (não vale entregar um sistema que só funcione com um usuário por vez).
   
   Nós não vamos tratar da adição de novos usuários. Usuários serão adicionados diretamente ao núcleo, por meio do método usuarioComLogin:umLogin. O login em umLogin deve identificar o usuário na tela de autenticação. Nós também não vamos tratar da remoção de usuários.
   
   Vocês devem adicionar um método de instância senha: à classe Usuario. O método deve receber uma ByteString contendo a senha do usuário em questão. Não se preocupem com a codificação de caracteres - certifiquem-se apenas de que senhas aceitas por [A-Za-z]+ funcionem.

• Permitir que o usuário gerencie suas contas POP/SMTP. O usuário deve ser capaz de adicionar/remover contas POP/SMTP, idealmente por meio de uma interface especial acessível por meio de um botão. Exemplo de botão 'configurações' na tela de listagem de mensagens. A interface de configuração também deve permitir que o usuário especifique quais contas POP incluir na operação de checagem de caixas postais. Exemplo de interface de configuração.
• Permitir o uso de múltiplas contas SMTP. Na fase anterior, o método WebMail>>contaSMTPPadrao: umaContaSMTP era usado para definir a conta SMTP padrão utilizada por todas as operações de envio. Nesta fase, vocês deverão permitir que o usuário escolha qual conta SMTP usar a cada envio. Isso pode ser feito com a adição de uma listbox à tela de envio de mensagens, ou de alguma outra forma qualquer. 
• As configurações acessíveis por meio da interface de configuração devem ser persistidas.

• Download de algumas formas restritas de anexos (2,5). Este extra envolve a implementação de um mecanismo que permita que algumas formas restritas de attachments sejam baixadas. Vocês podem assumir que o e-mail vai obedecer ao seguinte formato: 
• O primeiro conteúdo é o conteúdo a ser mostrado na área de texto. Esse conteúdo será do tipo text/plain.
• Os conteúdos subseqüentes compõem a lista de anexos que podem ser baixados. Os anexos apresentam as seguintes restrições:

1. Codificados em base 64.
2. Atributo Content-Disposition no formato:
   
   Content-Disposition: <algo>; filename="<filename>"
   
   Exemplo:
   
   Content-Disposition: attachment; filename="redball.gif"
   
   Vocês deverão mostrar a lista de attachments numa área especial com links (de onde eles podem ser baixados). Deve ser possível abrir os anexos baixados nos programas de origem; isto é, eles devem ser decodificados corretamente. E-mail exemplo. Exemplo de tela de visualização.

• Visualização de imagens gif e jpeg na própria interface do sistema de Web Mail (1,0) - prá quem implementou o primeiro extra, este aqui vem quase de graça.
• Visualização de e-mails html (Content-Type: multipart/related) que contenham imagens gif e jpeg (2,0) - prá quem implementou o primeiro extra, este aqui também vem quase de graça.

Formato de entrega:

Usando o Monticello:

Referências:

• Man pages do QMail (boa introdução).
• MuttWiki/MuttFAQ/Maildir - organização de pastas no Maildir.