EntityUtils.java

/*
 * Copyright 2004-2009 the original author or authors.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 *      http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.compass.sample.petclinic.util;

import java.util.Collection;
import java.util.Iterator;

import org.compass.sample.petclinic.Entity;
import org.springframework.orm.ObjectRetrievalFailureException;

/**
 * Utility methods for handling entities.
 * Separate from the Entity class mainly because of dependency
 * on the ORM-associated ObjectRetrievalFailureException.
 *
 * @author Juergen Hoeller
 * @since 29.10.2003
 * @see org.springframework.samples.petclinic.Entity
 */
public abstract class EntityUtils {

    /**
     * Look up the entity of the given class with the given id
     * in the given collection.
     * @param entities the collection to search
     * @param entityClass the entity class to look up
     * @param entityId the entity id to look up
     * @return the found entity
     * @throws ObjectRetrievalFailureException if the entity was not found
     */
    public static Entity getById(Collection entities, Class entityClass, int entityId)
        throws ObjectRetrievalFailureException {

        for (Iterator it = entities.iterator(); it.hasNext();) {
            Entity entity = (Entity) it.next();
            if (entity.getId().intValue() == entityId && entityClass.isInstance(entity)) {
                return entity;
            }
        }
        throw new ObjectRetrievalFailureException(entityClass, new Integer(entityId));
    }

}