Home | History | Annotate | Download | only in media 
      1 /*
      2  * Copyright (C) 2017 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 package android.media;
     18 
     19 import android.annotation.NonNull;
     20 import android.annotation.Nullable;
     21 
     22 import android.hardware.cas.V1_0.Status;
     23 
     24 /**
     25  * Base class for MediaCas runtime exceptions
     26  */
     27 public class MediaCasStateException extends IllegalStateException {
     28     private final int mErrorCode;
     29     private final String mDiagnosticInfo;
     30 
     31     private MediaCasStateException(int err, @Nullable String msg, @Nullable String diagnosticInfo) {
     32         super(msg);
     33         mErrorCode = err;
     34         mDiagnosticInfo = diagnosticInfo;
     35     }
     36 
     37     static void throwExceptionIfNeeded(int err) {
     38         throwExceptionIfNeeded(err, null /* msg */);
     39     }
     40 
     41     static void throwExceptionIfNeeded(int err, @Nullable String msg) {
     42         if (err == Status.OK) {
     43             return;
     44         }
     45         if (err == Status.BAD_VALUE) {
     46             throw new IllegalArgumentException();
     47         }
     48 
     49         String diagnosticInfo = "";
     50         switch (err) {
     51         case Status.ERROR_CAS_UNKNOWN:
     52             diagnosticInfo = "General CAS error";
     53             break;
     54         case Status.ERROR_CAS_NO_LICENSE:
     55             diagnosticInfo = "No license";
     56             break;
     57         case Status.ERROR_CAS_LICENSE_EXPIRED:
     58             diagnosticInfo = "License expired";
     59             break;
     60         case Status.ERROR_CAS_SESSION_NOT_OPENED:
     61             diagnosticInfo = "Session not opened";
     62             break;
     63         case Status.ERROR_CAS_CANNOT_HANDLE:
     64             diagnosticInfo = "Unsupported scheme or data format";
     65             break;
     66         case Status.ERROR_CAS_INVALID_STATE:
     67             diagnosticInfo = "Invalid CAS state";
     68             break;
     69         case Status.ERROR_CAS_INSUFFICIENT_OUTPUT_PROTECTION:
     70             diagnosticInfo = "Insufficient output protection";
     71             break;
     72         case Status.ERROR_CAS_TAMPER_DETECTED:
     73             diagnosticInfo = "Tamper detected";
     74             break;
     75         case Status.ERROR_CAS_DECRYPT_UNIT_NOT_INITIALIZED:
     76             diagnosticInfo = "Not initialized";
     77             break;
     78         case Status.ERROR_CAS_DECRYPT:
     79             diagnosticInfo = "Decrypt error";
     80             break;
     81         default:
     82             diagnosticInfo = "Unknown CAS state exception";
     83             break;
     84         }
     85         throw new MediaCasStateException(err, msg,
     86                 String.format("%s (err=%d)", diagnosticInfo, err));
     87     }
     88 
     89     /**
     90      * Retrieve the associated error code
     91      *
     92      * @hide
     93      */
     94     public int getErrorCode() {
     95         return mErrorCode;
     96     }
     97 
     98     /**
     99      * Retrieve a developer-readable diagnostic information string
    100      * associated with the exception. Do not show this to end-users,
    101      * since this string will not be localized or generally comprehensible
    102      * to end-users.
    103      */
    104     @NonNull
    105     public String getDiagnosticInfo() {
    106         return mDiagnosticInfo;
    107     }
    108 }
    109