Vincular um contato

Você pode vincular um contato em seu aplicativo com um contato no aplicativo de contatos do aparelho BlackBerry. Você pode decidir como interagir com o usuário do aparelho BlackBerry ao vincular um contato. As etapas que seguem descrevem uma possível abordagem.
Antes de começar:
  • Crie os contatos em seu aplicativo criando e instanciando uma classe que implemente a interface LinkableContact.
  • Defina uma classe que estenda LinkedContactInfoProvider e registre a classe com seu aplicativo. Para obter mais informações, consulte Criar um provedor de informações para um contato vinculado.
  1. Importe as classes e interfaces necessárias.
    import net.rim.blackberry.api.pdap.*;
    import net.rim.blackberry.api.pdap.contactlinking.*;
    import javax.microedition.pim.*;
  2. Verifique se há um contato no aplicativo de contatos (um objeto BlackBerryContact) que seja um candidato à vinculação com seu contato. O método LinkedContactUtilities.getContactLinkCandidate() retorna um BlackBerryContact se encontrar um contato no aplicativo de contatos que tenha o mesmo endereço de e-mail ou número de telefone que o LinkableContact que é passado a ele. Se não houver nenhum contato correspondente, o método retorna null.
    BlackBerryContact bbContact = 
        LinkedContactUtilities.getContactLinkCandidate(linkableContact);
  3. Se uma correspondência for encontrada, vincule seu contato com o BlackBerryContact.
    bbContact = LinkedContactUtilities.linkContact(bbContact, linkableContact);
  4. Se nenhuma correspondência for encontrada, solicite ao usuário que selecione um contato no aplicativo de contatos para vincular ao contato selecionado.
    BlackBerryContactList contacts = null;
    try
    {
        contacts = (BlackBerryContactList) PIM.getInstance().
            openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE);
    }
    catch(PIMException e)
    {
        ContactLinkingDemo.errorDialog("Couldn't open contacts list.");   
        return;                 
    }
    Object choice = contacts.choose();
    if(choice instanceof BlackBerryContact)
    {
        bbContact = (BlackBerryContact)choice;
    }
  5. Verifique se o contato selecionado no aplicativo de contatos já está vinculado a um contato em seu aplicativo.
    LinkedContactUtilities.isContactLinked(bbContact, 
        linkableContact.getApplicationID())
    
  6. Se o contato selecionado no aplicativo de contatos ainda não estiver vinculado, vincule-o ao contato em seu aplicativo.
    bbContact = LinkedContactUtilities.linkContact(bbContact, linkableContact);
    

Exemplo de código: Vincular um contato

Para consultar um exemplo dessa abordagem para vincular um contato, consulte linkContact() no aplicativo de exemplo Contact Linking Demo incluído no BlackBerry Java SDK.

Próximo tópico: Remover um vínculo

Estas informações foram úteis? Gostaríamos de receber seus comentários.