Ответ 1
Кажется, ваша библиотека выполняет вызовы, подобные базам данных. Если это так, то я бы сделал именно то, что реализовано с помощью спецификации JPA 2.
Что я имею в виду, посмотрите на метод find() в JPA API и верните именно то, что они там делают.
/**
* Find by primary key.
* @param entityClass
* @param primaryKey
* @return the found entity instance or null
* if the entity does not exist
* @throws IllegalStateException if this EntityManager has been closed.
* @throws IllegalArgumentException if the first argument does
* not denote an entity type or the second
* argument is not a valid type for that
* entity primary key
*/
public <T> T find(Class<T> entityClass, Object primaryKey);
Вы видите здесь в find, который, как мне кажется, похож на ваш метод getCustomer(), он вернет null, если ни один не найден, и бросает только IllegalArgumentException, если аргумент недействителен.
Если метод find() не близок к тому, что вы хотите с помощью getCustomer(), вы должны реализовать то же поведение, что getSingleResult():
/**
* Execute a SELECT query that returns a single result.
* @return the result
* @throws EntityNotFoundException if there is no result
* @throws NonUniqueResultException if more than one result
* @throws IllegalStateException if called for a Java
* Persistence query language UPDATE or DELETE statement
*/
public Object getSingleResult();
Что будет бросать EntityNotFoundException, если результат не найден, NonUniqueResultException, если найдено несколько экземпляров, или IllegalStateException, если SQL неверен.
Вы должны решить, какое поведение наиболее подходит для вас.
То же самое относится к getResultList():
/**
* Execute a SELECT query and return the query results
* as a List.
* @return a list of the results
* @throws IllegalStateException if called for a Java
* Persistence query language UPDATE or DELETE statement
*/
public List getResultList();
getResultList() будет возвращать null, если ни один не найден, и исключает только исключение, если SQL является незаконным.
Следуя этому поведению, вы становитесь последовательным, и ваши пользователи получат представление о том, как работает библиотека.
Альтернативное поведение - вернуть пустую коллекцию вместо null. Вот как Google Guava внедрили свой API, и это действительно является предпочтительным. Тем не менее, мне нравится согласованность и по-прежнему думаю, что вы должны реализовать библиотеку как можно ближе к standard.
Ресурсы
Джошуа Блох сделал видео, объясняющее, как создать хороший API и почему это важно.