Contactos
O livro de endereços a que esta caixa de correio escreve.
Ferramentas de contactos
| Ferramenta | O que faz |
|---|---|
| listContacts | As pessoas a quem esta caixa de correio escreve, da correspondência mais recente para a mais antiga. Pesquise por nome ou endereço, restrinja a uma audiência, ou separe os que alguém adicionou dos que foram registados. |
| getContact | Um contacto por endereço de email, com as notas por inteiro e todas as audiências em que está. |
| createContact | Adiciona um contacto à mão. Um contacto por endereço, pelo que um endereço já existente é recusado em vez de ser escrito duas vezes. O novo contacto entra na audiência predefinida. |
| updateContact | Altera o nome de um contacto ou as notas guardadas sobre ele. Passar null limpa um campo, omiti-lo deixa-o como está. |
| deleteContact | Apaga um contacto definitivamente. As notas vão com ele, e também todas as audiências em que estava. |
Os contactos pertencem à CAIXA DE CORREIO e não a quem os guardou, pelo que um colega com a mesma função lê e escreve no mesmo livro. Um contacto é registado automaticamente da primeira vez que sai uma mensagem para um endereço a partir do compositor da aplicação; correio que chega de um endereço não escreve nada.
O endereço é a identidade e não existe id. Por isso, o updateContact não o pode alterar, e mudar alguém para um novo endereço é um createContact e um deleteContact. O createContact não aceita source: tudo o que é criado aqui é manual, e um envio nunca o faz regredir para auto.
Nada disto envia seja o que for nem subscreve ninguém a nada, e o deleteContact não cancela a subscrição de ninguém, porque esta caixa de correio não guarda qualquer estado de subscrição. Um endereço a que a caixa de correio continue a escrever é registado de novo no envio seguinte, sem notas e sem audiências.