Home | History | Annotate | Download | only in print 
      1 /*
      2  * Copyright (C) 2013 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.print;
     18 
     19 import android.annotation.NonNull;
     20 import android.os.Parcel;
     21 import android.os.Parcelable;
     22 
     23 import com.android.internal.util.Preconditions;
     24 
     25 import java.util.UUID;
     26 
     27 /**
     28  * This class represents the id of a print job.
     29  */
     30 public final class PrintJobId implements Parcelable {
     31     private final @NonNull String mValue;
     32 
     33     /**
     34      * Creates a new instance.
     35      *
     36      * @hide
     37      */
     38     public PrintJobId() {
     39         this(UUID.randomUUID().toString());
     40     }
     41 
     42     /**
     43      * Creates a new instance.
     44      *
     45      * @param value The internal value.
     46      *
     47      * @hide
     48      */
     49     public PrintJobId(@NonNull String value) {
     50         mValue = value;
     51     }
     52 
     53     @Override
     54     public int hashCode() {
     55         final int prime = 31;
     56         int result = 1;
     57         result = prime * result + mValue.hashCode();
     58         return result;
     59     }
     60 
     61     @Override
     62     public boolean equals(Object obj) {
     63         if (this == obj) {
     64             return true;
     65         }
     66         if (obj == null) {
     67             return false;
     68         }
     69         if (getClass() != obj.getClass()) {
     70             return false;
     71         }
     72         PrintJobId other = (PrintJobId) obj;
     73         if (!mValue.equals(other.mValue)) {
     74             return false;
     75         }
     76         return true;
     77     }
     78 
     79     @Override
     80     public void writeToParcel(Parcel parcel, int flags) {
     81         parcel.writeString(mValue);
     82     }
     83 
     84     @Override
     85     public int describeContents() {
     86         return 0;
     87     }
     88 
     89     /**
     90      * Flattens this id to a string.
     91      *
     92      * @return The flattened id.
     93      *
     94      * @hide
     95      */
     96     public @NonNull String flattenToString() {
     97         return mValue;
     98     }
     99 
    100     /**
    101      * Unflattens a print job id from a string.
    102      *
    103      * @param string The string.
    104      * @return The unflattened id, or null if the string is malformed.
    105      *
    106      * @hide
    107      */
    108     public static @NonNull PrintJobId unflattenFromString(@NonNull String string) {
    109         return new PrintJobId(string);
    110     }
    111 
    112     public static final Parcelable.Creator<PrintJobId> CREATOR =
    113             new Parcelable.Creator<PrintJobId>() {
    114         @Override
    115         public PrintJobId createFromParcel(Parcel parcel) {
    116             return new PrintJobId(Preconditions.checkNotNull(parcel.readString()));
    117         }
    118 
    119         @Override
    120         public PrintJobId[] newArray(int size) {
    121             return new PrintJobId[size];
    122         }
    123     };
    124 }
    125