As interfaces de uma entidade

A interface das inst�ncias � a interface comum a todos os elementos da cole��o de objetos. Exemplo: interface ContaCorrente, no caso de uma cole��o de contas correntes.

A interface home tem um papel duplo: de f�brica (factory) que sabe criar novos elementos para a cole��o de objetos (exemplo: cria��o de uma nova ContaCorrente) e de buscador (finder) capaz de encontrar elementos com determinadas propriedades (exemplo: buscar ContaCorrente pelo nome do titular). Tanto o EJB como o CCM usam o termo home para a interface usada para fabrica��o e busca de elementos da cole��o (inst�ncias do componente). Pode-se considerar que a interface home � a interface de uma cole��o de objetos e que a interface das inst�ncias � a interface de cada elemento da cole��o.

A pr�tica usual em EJB e CCM � dar � interface home o nome da interface das inst�ncias, com o sufixo Home. Este � um exemplo bem simples, em IDL, de interface de inst�ncia (Customer) e sua correspondente interface home (CustomerHome):

    interface Customer {
        long getId();
        string getName();
        string getPhone();
        void setPhone(in string phone);
    };

    interface CustomerHome {
        Customer create(in long id, in string name, in string phone) raises(CreateException);
        void remove(in long id) raises(RemoveException);
        Customer findById(in long id) raises(NotFoundException);
        CustomerList findByName(in string name);
        CustomerList findByPhone(in string phone);
    };