Comparator Reflector

Composição

• ComparatorReflector : Classe principal.
• ComparatorReflectorException Exceção (derivada de RuntimeException) criada para tratar de eventuais problemas e exceções que aparecam na classe principal.

Composition

• ComparatorReflector: Principal Class.
• ComparatorReflectorException : Exception (derivated from RuntimeException) created to treat eveltuals problems that show in principal class.

Origem

Origin

Requisito

Requirement

Como Funciona

A classe ComparatorReflector faz uso pesada da API de Reflection; mais exatamente das classes java.lang.Class e java.lang.reflect.Method para descobrir os métodos getters de beanClass relacionado a attributes. Por exemplo: Para os atributos chamados name e date, busca-se pelos métodos chamados getName e getDate. Se algum destes método não existirem, ou não forem públicos, ou não retornarem uma prmitiva ou instancia de java.lang.Comparable é disparada uma ComparatorReflectorException. Este métodos getters são adicionados a um array de java.lang.reflect.Method, de acordo com a ordem dos atributos

No método compare() as duas instancias de beanClass são comparadas para cada método getter dos atributos selecionados. Os valores destes métodos são convertidos para instâncias da interface java.lang.Comparable. Daí é usado o método compareTo() desta. Se o valor obtido for diferente de zero, é retornado este valor. Se for zero é sinal de que os valores destes atributos são iguais para ambos os objetos, e portanto passa-se para o próximo método getter.

Com a classe java.util.Collections são feitas as buscas e ordenações. Todas as Cheked Exceptions são capturadas para dispararem uma ComparatorReflectorException com uma mensagem explicando o que disparou tal exceção.

How It Works

ComparatorReflector class uses heavly Reflection API, more exactly from java.lang.Class and java.lang.reflect.Method classes to find beanClass getters methods related to attributes. For example: To find a attributes called name and date, it finds for methods called getName and getDate. If any of these methods do not exist, or they are not public or they do no return a primitive or a java.lang.Comparable instance, it is thrown a ComparatorReflectorException. These getters methods are added to a java.lang.reflect.Method array, according order of attributes.

In compare() method, both instance of beanClass are compared according selected attributes getter methods. Values from these methods are convert to java.lang.Comparable instances. So it use compareTo() from Comparable. If value got was zero, it return this value. If this value was zero, it means that attribute value are equals in both objects, so it go to next getter method.

All searches and ordinations are done with java.util.Collections class. All Cheked Exceptions are caught to trhow a ComparatorReflectorException. with a message explaining what threw this exception.

Modo de Usar

Nos exemplos a seguir, o beanClass chama-se myClass (original, não?? ;-)) e o attributesName chama-se names (trata-se de um array de String). comparator é o nome da instancia de ComparatorReflector usada.

Usage

In following examples, beanClass is called myClass (original, is not it? ;-)) and attributesName is called names (it is a String array). comparator is instance ComparatorReflector name.

Criar um ComparatorReflector

Create a ComparatorReflector

        ComparatorReflector comparator = new ComparatorReflector(myClass, names);
                        

        ComparatorReflector comparator = new ComparatorReflector(myClass);
        comparator.setAttributes(names);
                        

        ComparatorReflector comparator = new ComparatorReflector();
        comparator.setBeanClass(myClass);
        comparator.setAttributeName(names);
                        

Criar Lista ordenada

Create a sorted List

        List lista = comparator.getSortedList(collection);
                        

Achar máximo (ou mínimo) em uma Coleção

Find maximum (or minimum) in a Collection

        Object objMax = comparator.getMax(collection);
        Object objMin = comparator.getMin(collection);
                        

Achar por um ou vários objectBeans de uma Coleção que tenha o mesmo attributeBean de um outro objectBean

Find for one or more objectBeans from a Collection that had same attributeBean of another objectBean

        Object myObj = new MyClass();
        myObj.setName("myName");
        Collection searchedObjects = comparator.search(collection, myObj);
                        

Achar por um ou mais objectBeans de uma Coleção que tenha o mesmo attributeBean de um outro objectBean

Find for one or more objetcBeans from a Collection that has same attributeBean like another objectBean

        Collections searchedObjects = comparator.searchByAttribute(collection, myObj);
                        

Downloads

API

Contato

Contact

Agradecimentos

Thanks

Contribuições

Contribuitions

Copyrigth