让表示层(JSF)处理来自服务层(EJB)的业务异常

Question

更新所提供实体的EJB方法(使用CMT):

@Override
@SuppressWarnings("unchecked")
public boolean update(Entity entity) throws OptimisticLockException {
    // Code to merge the entity.
    return true;
}

如果检测到并发更新，将抛出javax.persistence.OptimisticLockException，该更新将由调用者(托管bean)精确处理。

public void onRowEdit(RowEditEvent event) {
    try {
        service.update((Entity) event.getObject())
    } catch(OptimisticLockException e) {
        // Add a user-friendly faces message.
    }
}

但是这样做会使javax.persistence API对表示层的额外依赖成为强制性的，这是一种导致紧耦合的设计气味。

应该在哪个异常中包装它，以便紧耦合问题可以完全省略?或者是否有一种标准方法来处理这种异常，而这种异常又不会导致在表示层上强制执行任何服务层依赖关系?

_{顺便说一下，我发现在EJB(在服务层本身)中捕获这个异常，然后向客户机(JSF)返回一个标志值是很笨拙的。}

创建一个自定义服务层特定的运行时异常，用@ApplicationException和rollback=true注释。

@ApplicationException(rollback=true)
public abstract class ServiceException extends RuntimeException {}

为一般业务异常创建一些具体的子类，例如约束违反、必需的实体，当然还有乐观锁。

public class DuplicateEntityException extends ServiceException {}

public class EntityNotFoundException extends ServiceException {}

public class EntityAlreadyModifiedException extends ServiceException {}

有些可以直接抛出。

public void register(User user) {
    if (findByEmail(user.getEmail()) != null) {
        throw new DuplicateEntityException();
    }
    // ...
}

public void addToOrder(OrderItem item, Long orderId) {
    Order order = orderService.getById(orderId);
    if (order == null) {
        throw new EntityNotFoundException();
    }
    // ...
}

其中一些需要全局拦截器。

@Interceptor
public class ExceptionInterceptor implements Serializable {
    @AroundInvoke
    public Object handle(InvocationContext context) throws Exception {
        try {
            return context.proceed();
        }
        catch (javax.persistence.EntityNotFoundException e) { // Can be thrown by Query#getSingleResult().
            throw new EntityNotFoundException(e);
        }
        catch (OptimisticLockException e) {
            throw new EntityAlreadyModifiedException(e);
        }
    }
}

在ejb-jar.xml中注册为默认拦截器(在所有ejb上)。

<interceptors>
    <interceptor>
        <interceptor-class>com.example.service.ExceptionInterceptor</interceptor-class>
    </interceptor>
</interceptors>
<assembly-descriptor>
    <interceptor-binding>
        <ejb-name>*</ejb-name>
        <interceptor-class>com.example.service.ExceptionInterceptor</interceptor-class>
    </interceptor-binding>
</assembly-descriptor>

作为一般提示，在JSF中还可以有一个全局异常处理程序，它只添加一个faces消息。从这个启动示例开始时，您可以在YourExceptionHandler#handle()方法中执行以下操作:

if (exception instanceof EntityAlreadyModifiedException) { // Unwrap if necessary.
    // Add FATAL faces message and return.
}
else {
    // Continue as usual.
}