¿Cómo uso Throwables.propagateIfInstanceOf() de Google Guava?

Question

The javadoc example

try { 
    someMethodThatCouldThrowAnything(); 
    } catch (IKnowWhatToDoWithThisException e) { 
    handle(e); 
    } catch (Throwable t) { 
    Throwables.propagateIfInstanceOf(t, IOException.class); 
    Throwables.propagateIfInstanceOf(t, SQLException.class); 
    throw Throwables.propagate(t); 
    } 

no es muy concreto. ¿Cómo se vería un programa real? Realmente no entiendo el propósito de los métodos Throwables.propagateIfInstanceOf(Throwable, Class), propagate(), propagateIfPossible(). ¿Cuándo los uso?

Answer 1

El propósito de estos métodos es proporcionar una forma conveniente de tratar con las excepciones marcadas.

Throwables.propagate() es una abreviatura para el idioma común de la excepción comprobada retrowing envuelta en la casilla no marcada (para evitar declararlo en la cláusula throws del método).

Throwables.propagateIfInstanceOf() se utiliza para retromar excepciones marcadas como si sus tipos están declarados en la cláusula throws del método.

En otras palabras, el código en cuestión

public void doSomething() 
    throws IOException, SQLException { 

    try { 
     someMethodThatCouldThrowAnything(); 
    } catch (IKnowWhatToDoWithThisException e) { 
     handle(e); 
    } catch (Throwable t) { 
     Throwables.propagateIfInstanceOf(t, IOException.class); 
     Throwables.propagateIfInstanceOf(t, SQLException.class); 
     throw Throwables.propagate(t); 
    } 
} 

es una abreviatura para el siguiente código:

public void doSomething() 
    throws IOException, SQLException { 

    try { 
     someMethodThatCouldThrowAnything(); 
    } catch (IKnowWhatToDoWithThisException e) { 
     handle(e); 
    } catch (SQLException ex) { 
     throw ex; 
    } catch (IOException ex) { 
     throw ex; 
    } catch (Throwable t) { 
     throw new RuntimeException(t); 
    } 
} 

Ver también:

• Checked versus unchecked exceptions
• The case against checked exceptions

Answer 2

He revisado la documentación de Guava Throwables y no los he encontrado realmente útiles. Usar throw new RuntimeException (e) es más simple de comprender que Throwables.propagate(), en el escenario en el que desea lanzar una excepción no verificada que envuelve una excepción marcada.

Answer 3

Un escenario que puedo proporcionarle a cualquiera que lo encuentre útil es que si tiene un método que envuelve las excepciones lanzadas, esto puede usarse para desenvolver/convertir la causa en una excepción específica.

Ejemplo: el método get en Guava's LoadingCache ajusta todas las excepciones marcadas en ExecutionException. La documentación indica que la excepción puede inspeccionarse usando getCause().

Aquí Throwables.propagateIfInstanceOf puede usarse para lanzar excepciones específicas para el método de llamada de manejar, si sabemos que cache.get() arrojará esas excepciones (quizá específicas para LoadingCache, pero si el valor es misisng, la memoria caché intenta cargar un valor que puede tirar excepciones marcadas).

public String getCacheValue(String key) throws SQLException{ 
    try{ 
     return cache.get(key); 
    }catch(ExecutedException ex){ 
     Throwables.propagateIfInstanceOf(ex.getCause(), SQLException.class); 
     Throwables.propagate(ex); 
    } 
}