java/src/main/com/google/appengine/tools/admin/HttpIoException.java

   1 // Copyright 2011 Google Inc. All Rights Reserved.
   2
   3 package com.google.appengine.tools.admin;
   4
   5 /**
   6  * A subclass of IOException that also carries the HTTP status code that
   7  * generated the exception.
   8  *
   9  *
  10  */
  11 class HttpIoException extends RemoteIOException {
  12   /**
  13    * Constructs an HttpIoException (a subclass of IOException that carries
  14    * the HTTP status code).
  15    *
  16    * @param responseCode The HTTP response code.
  17    */
  18   HttpIoException(int responseCode) {
  19     super(null, null);
  20     this.responseCode = responseCode;
  21   }
  22
  23   /**
  24    * Constructs an HttpIoException (a subclass of IOException that carries
  25    * the HTTP status code).
  26    *
  27    * @param message The exception's detail message.
  28    * @param responseCode The HTTP response code.
  29    */
  30   HttpIoException(String message, int responseCode) {
  31     super(message, null);
  32     this.responseCode = responseCode;
  33   }
  34
  35   /**
  36    * Constructs an HttpIoException (a subclass of IOException that carries
  37    * the HTTP status code).
  38    *
  39    * @param message The exception's detail message.
  40    * @param responseCode The HTTP response code.
  41    * @param cause Another exception that caused this one, or null if none.
  42    */
  43   HttpIoException(String message, int responseCode, Throwable cause) {
  44     super(message, cause);
  45     this.responseCode = responseCode;
  46   }
  47
  48   /**
  49    * Returns The HTTP response code.
  50    */
  51   int getResponseCode() {
  52     return responseCode;
  53   }
  54
  55   /**
  56    * Returns true if this HTTP status should be counted against the SLA. Currently, we consider
  57    * that if the status is in the 500 range it is a server and should count against the SLA, but
  58    * otherwise it is likely to be a problem with the user's environment and should not.
  59    */
  60   boolean isSlaError() {
  61     return responseCode >= 500 && responseCode < 600;
  62   }
  63
  64   private int responseCode;
  65 }