ExceptionUtil (JOSM)

java.lang.Object
- org.openstreetmap.josm.tools.ExceptionUtil

public final class ExceptionUtil
extends Object

Constructor Summary

Constructors
Modifier Constructor and Description

private ExceptionUtil()

Constructors
Modifier	Constructor and Description
`private`	`ExceptionUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static String`	`explainBadRequest(OsmApiException e)` Explains a `OsmApiException` which was thrown because of a bad request.
`static String`	`explainBandwidthLimitExceeded(OsmApiException e)` Explains a `OsmApiException` which was thrown because of bandwidth limit exceeded (HTTP error 509)
`static String`	`explainChangesetClosedException(ChangesetClosedException e)` Explains an exception thrown during upload because the changeset which data is uploaded to is already closed.
`static String`	`explainClientTimeout(OsmApiException e)` Explains an OSM API exception because of a client timeout (HTTP 408).
`static String`	`explainConflict(OsmApiException e)` Explains an error due to a 409 conflict
`static String`	`explainException(Exception e)` Explains an `Exception` to the user.
`static String`	`explainFailedAuthorisation(OsmApiException e)`
`static String`	`explainFailedBasicAuthentication(OsmApiException e)`
`static String`	`explainFailedOAuthAuthentication(OsmApiException e)`
`static String`	`explainFailedOAuthAuthorisation(OsmApiException e)`
`static String`	`explainGeneric(Exception e)` Explains an exception with a generic message dialog
`static String`	`explainGenericOsmApiException(OsmApiException e)` Replies a generic error message for an OSM API exception
`static String`	`explainGoneForUnknownPrimitive(OsmApiException e)` explains the case of an error due to a delete request on an already deleted `OsmPrimitive`, i.e.
`static String`	`explainInternalServerError(OsmTransferException e)` Explains a `OsmApiException` which was thrown because of an internal server error in the OSM API server..
`static String`	`explainMissingOAuthAccessTokenException(MissingOAuthAccessTokenException e)`
`static String`	`explainNestedIllegalDataException(OsmTransferException e)` Explains a `IllegalDataException` which has caused an `OsmTransferException`.
`static String`	`explainNestedIOException(OsmTransferException e)` Explains a `IOException` which has caused an `OsmTransferException`.
`static String`	`explainNestedSocketException(OsmTransferException e)` Explains a `SocketException` which has caused an `OsmTransferException`.
`static String`	`explainNestedUnknownHostException(OsmTransferException e)` Explains a `UnknownHostException` which has caused an `OsmTransferException`.
`static String`	`explainNotFound(OsmApiException e)` Explains a `OsmApiException` which was thrown because a resource wasn't found.
`static String`	`explainOfflineAccessException(OsmTransferException e)` Explains a `OfflineAccessException` which has caused an `OsmTransferException`.
`static String`	`explainOsmApiInitializationException(OsmApiInitializationException e)` handles an exception caught during OSM API initialization
`static String`	`explainOsmTransferException(OsmTransferException e)` Explains an `OsmTransferException` to the user.
`static String`	`explainPreconditionFailed(OsmApiException e)` Explains an upload error due to a violated precondition, i.e.
`static String`	`explainSecurityException(OsmTransferException e)` Explains a `SecurityException` which has caused an `OsmTransferException`.
`static <T> T`	`getNestedException(Exception e, Class<T> nestedClass)` Replies the first nested exception of type `nestedClass` (including the root exception `e`) or null, if no such exception is found.
`static Pair<OsmPrimitive,Collection<OsmPrimitive>>`	`parsePreconditionFailed(String msg)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ExceptionUtil
```
private ExceptionUtil()
```
- Method Detail
  - explainOsmApiInitializationException
```
public static String explainOsmApiInitializationException(OsmApiInitializationException e)
```
    handles an exception caught during OSM API initialization
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainMissingOAuthAccessTokenException
```
public static String explainMissingOAuthAccessTokenException(MissingOAuthAccessTokenException e)
```
  - parsePreconditionFailed
```
public static Pair<OsmPrimitive,Collection<OsmPrimitive>> parsePreconditionFailed(String msg)
```
  - explainPreconditionFailed
```
public static String explainPreconditionFailed(OsmApiException e)
```
    Explains an upload error due to a violated precondition, i.e. a HTTP return code 412
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainFailedBasicAuthentication
```
public static String explainFailedBasicAuthentication(OsmApiException e)
```
  - explainFailedOAuthAuthentication
```
public static String explainFailedOAuthAuthentication(OsmApiException e)
```
  - explainFailedAuthorisation
```
public static String explainFailedAuthorisation(OsmApiException e)
```
  - explainFailedOAuthAuthorisation
```
public static String explainFailedOAuthAuthorisation(OsmApiException e)
```
  - explainClientTimeout
```
public static String explainClientTimeout(OsmApiException e)
```
    Explains an OSM API exception because of a client timeout (HTTP 408).
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainGenericOsmApiException
```
public static String explainGenericOsmApiException(OsmApiException e)
```
    Replies a generic error message for an OSM API exception
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainConflict
```
public static String explainConflict(OsmApiException e)
```
    Explains an error due to a 409 conflict
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainChangesetClosedException
```
public static String explainChangesetClosedException(ChangesetClosedException e)
```
    Explains an exception thrown during upload because the changeset which data is uploaded to is already closed.
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainGeneric
```
public static String explainGeneric(Exception e)
```
    Explains an exception with a generic message dialog
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainSecurityException
```
public static String explainSecurityException(OsmTransferException e)
```
    Explains a SecurityException which has caused an OsmTransferException. This is most likely happening when user tries to access the OSM API from within an applet which wasn't loaded from the API server.
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainNestedSocketException
```
public static String explainNestedSocketException(OsmTransferException e)
```
    Explains a SocketException which has caused an OsmTransferException. This is most likely because there's not connection to the Internet or because the remote server is not reachable.
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainNestedIOException
```
public static String explainNestedIOException(OsmTransferException e)
```
    Explains a IOException which has caused an OsmTransferException. This is most likely happening when the communication with the remote server is interrupted for any reason.
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainNestedIllegalDataException
```
public static String explainNestedIllegalDataException(OsmTransferException e)
```
    Explains a IllegalDataException which has caused an OsmTransferException. This is most likely happening when JOSM tries to load data in an unsupported format.
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainOfflineAccessException
```
public static String explainOfflineAccessException(OsmTransferException e)
```
    Explains a OfflineAccessException which has caused an OsmTransferException. This is most likely happening when JOSM tries to access OSM API or JOSM website while in offline mode.
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
    
    Since:
    
    7434
  - explainInternalServerError
```
public static String explainInternalServerError(OsmTransferException e)
```
    Explains a OsmApiException which was thrown because of an internal server error in the OSM API server..
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainBadRequest
```
public static String explainBadRequest(OsmApiException e)
```
    Explains a OsmApiException which was thrown because of a bad request.
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainBandwidthLimitExceeded
```
public static String explainBandwidthLimitExceeded(OsmApiException e)
```
    Explains a OsmApiException which was thrown because of bandwidth limit exceeded (HTTP error 509)
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainNotFound
```
public static String explainNotFound(OsmApiException e)
```
    Explains a OsmApiException which was thrown because a resource wasn't found.
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainNestedUnknownHostException
```
public static String explainNestedUnknownHostException(OsmTransferException e)
```
    Explains a UnknownHostException which has caused an OsmTransferException. This is most likely happening when there is an error in the API URL or when local DNS services are not working.
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - getNestedException
```
public static <T> T getNestedException(Exception e,
                                       Class<T> nestedClass)
```
    Replies the first nested exception of type nestedClass (including the root exception e) or null, if no such exception is found.
    
    Type Parameters:
    
    T - nested exception type
    
    Parameters:
    
    e - the root exception
    
    nestedClass - the type of the nested exception
    
    Returns:
    
    the first nested exception of type nestedClass (including the root exception e) or null, if no such exception is found.
    
    Since:
    
    8470
  - explainOsmTransferException
```
public static String explainOsmTransferException(OsmTransferException e)
```
    Explains an OsmTransferException to the user.
    
    Parameters:
    
    e - the OsmTransferException
    
    Returns:
    
    The HTML formatted error message to display
  - explainGoneForUnknownPrimitive
```
public static String explainGoneForUnknownPrimitive(OsmApiException e)
```
    explains the case of an error due to a delete request on an already deleted OsmPrimitive, i.e. a HTTP response code 410, where we don't know which OsmPrimitive is causing the error.
    
    Parameters:
    
    e - the exception
    
    Returns:
    
    The HTML formatted error message to display
  - explainException
```
public static String explainException(Exception e)
```
    Explains an Exception to the user.
    
    Parameters:
    
    e - the Exception
    
    Returns:
    
    The HTML formatted error message to display

Class ExceptionUtil

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ExceptionUtil

Method Detail

explainOsmApiInitializationException

explainMissingOAuthAccessTokenException

parsePreconditionFailed

explainPreconditionFailed

explainFailedBasicAuthentication

explainFailedOAuthAuthentication

explainFailedAuthorisation

explainFailedOAuthAuthorisation

explainClientTimeout

explainGenericOsmApiException

explainConflict

explainChangesetClosedException

explainGeneric

explainSecurityException

explainNestedSocketException

explainNestedIOException

explainNestedIllegalDataException

explainOfflineAccessException

explainInternalServerError

explainBadRequest

explainBandwidthLimitExceeded

explainNotFound

explainNestedUnknownHostException

getNestedException

explainOsmTransferException

explainGoneForUnknownPrimitive

explainException