core/java/android/print/PrintJobInfo.java - platform/frameworks/base - Git at Google

 /*
  * Copyright (C) 2013 The Android Open Source Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */

 package android.print;

 import android.os.Parcel;
 import android.os.Parcelable;

 import java.util.Arrays;

 /**
  * This class represents the description of a print job.
  */
 public final class PrintJobInfo implements Parcelable {

     /**
      * Constant for matching any print job state.
      *
      * @hide
      */
     public static final int STATE_ANY = -1;

     /**
      * Constant for matching any print job state.
      *
      * @hide
      */
     public static final int STATE_ANY_VISIBLE_TO_CLIENTS = -2;

     /**
      * Constant for matching any active print job state.
      *
      * @hide
      */
     public static final int STATE_ANY_ACTIVE = -3;

     /**
      * Constant for matching any scheduled, i.e. delivered to a print
      * service, print job state.
      *
      * @hide
      */
     public static final int STATE_ANY_SCHEDULED = -4;

     /**
      * Print job state: The print job is being created but not yet
      * ready to be printed.
      * <p>
      * Next valid states: {@link #STATE_QUEUED}
      * </p>
      */
     public static final int STATE_CREATED = 1;

     /**
      * Print job state: The print jobs is created, it is ready
      * to be printed and should be processed.
      * <p>
      * Next valid states: {@link #STATE_STARTED}, {@link #STATE_FAILED},
      * {@link #STATE_CANCELED}
      * </p>
      */
     public static final int STATE_QUEUED = 2;

     /**
      * Print job state: The print job is being printed.
      * <p>
      * Next valid states: {@link #STATE_COMPLETED}, {@link #STATE_FAILED},
      * {@link #STATE_CANCELED}, {@link #STATE_BLOCKED}
      * </p>
      */
     public static final int STATE_STARTED = 3;

     /**
      * Print job state: The print job is blocked.
      * <p>
      * Next valid states: {@link #STATE_FAILED}, {@link #STATE_CANCELED},
      * {@link #STATE_STARTED}
      * </p>
      */
     public static final int STATE_BLOCKED = 4;

     /**
      * Print job state: The print job was successfully printed.
      * This is a terminal state.
      * <p>
      * Next valid states: None
      * </p>
      */
     public static final int STATE_COMPLETED = 5;

     /**
      * Print job state: The print job was printing but printing failed.
      * This is a terminal state.
      * <p>
      * Next valid states: None
      * </p>
      */
     public static final int STATE_FAILED = 6;

     /**
      * Print job state: The print job was canceled.
      * This is a terminal state.
      * <p>
      * Next valid states: None
      * </p>
      */
     public static final int STATE_CANCELED = 7;

     /** The unique print job id. */
     private PrintJobId mId;

     /** The human readable print job label. */
     private String mLabel;

     /** The unique id of the printer. */
     private PrinterId mPrinterId;

     /** The name of the printer - internally used */
     private String mPrinterName;

     /** The state of the print job. */
     private int mState;

     /** The id of the app that created the job. */
     private int mAppId;

     /** Optional tag assigned by a print service.*/
     private String mTag;

     /** The wall time when the print job was created. */
     private long mCreationTime;

     /** How many copies to print. */
     private int mCopies;

     /** Reason for the print job being in its current state. */
     private String mStateReason;

     /** The pages to print */
     private PageRange[] mPageRanges;

     /** The print job attributes size. */
     private PrintAttributes mAttributes;

     /** Information about the printed document. */
     private PrintDocumentInfo mDocumentInfo;

     /** Whether we are trying to cancel this print job. */
     private boolean mCanceling;

     /** @hide*/
     public PrintJobInfo() {
         /* do nothing */
     }

     /** @hide */
     public PrintJobInfo(PrintJobInfo other) {
         mId = other.mId;
         mLabel = other.mLabel;
         mPrinterId = other.mPrinterId;
         mPrinterName = other.mPrinterName;
         mState = other.mState;
         mAppId = other.mAppId;
         mTag = other.mTag;
         mCreationTime = other.mCreationTime;
         mCopies = other.mCopies;
         mStateReason = other.mStateReason;
         mPageRanges = other.mPageRanges;
         mAttributes = other.mAttributes;
         mDocumentInfo = other.mDocumentInfo;
         mCanceling = other.mCanceling;
     }

     private PrintJobInfo(Parcel parcel) {
         mId = parcel.readParcelable(null);
         mLabel = parcel.readString();
         mPrinterId = parcel.readParcelable(null);
         mPrinterName = parcel.readString();
         mState = parcel.readInt();
         mAppId = parcel.readInt();
         mTag = parcel.readString();
         mCreationTime = parcel.readLong();
         mCopies = parcel.readInt();
         mStateReason = parcel.readString();
         if (parcel.readInt() == 1) {
             Parcelable[] parcelables = parcel.readParcelableArray(null);
             mPageRanges = new PageRange[parcelables.length];
             for (int i = 0; i < parcelables.length; i++) {
                 mPageRanges[i] = (PageRange) parcelables[i];
             }
         }
         if (parcel.readInt() == 1) {
             mAttributes = PrintAttributes.CREATOR.createFromParcel(parcel);
         }
         if (parcel.readInt() == 1) {
             mDocumentInfo = PrintDocumentInfo.CREATOR.createFromParcel(parcel);
         }
         mCanceling = (parcel.readInt() == 1);
     }

     /**
      * Gets the unique print job id.
      *
      * @return The id.
      */
     public PrintJobId getId() {
         return mId;
     }

     /**
      * Sets the unique print job id.
      *
      * @param The job id.
      *
      * @hide
      */
     public void setId(PrintJobId id) {
         this.mId = id;
     }

     /**
      * Gets the human readable job label.
      *
      * @return The label.
      */
     public String getLabel() {
         return mLabel;
     }

     /**
      * Sets the human readable job label.
      *
      * @param label The label.
      *
      * @hide
      */
     public void setLabel(String label) {
         mLabel = label;
     }

     /**
      * Gets the unique target printer id.
      *
      * @return The target printer id.
      */
     public PrinterId getPrinterId() {
         return mPrinterId;
     }

     /**
      * Sets the unique target pritner id.
      *
      * @param printerId The target printer id.
      *
      * @hide
      */
     public void setPrinterId(PrinterId printerId) {
         mPrinterId = printerId;
     }

     /**
      * Gets the name of the target printer.
      *
      * @return The printer name.
      *
      * @hide
      */
     public String getPrinterName() {
         return mPrinterName;
     }

     /**
      * Sets the name of the target printer.
      *
      * @param printerName The printer name.
      *
      * @hide
      */
     public void setPrinterName(String printerName) {
         mPrinterName = printerName;
     }

     /**
      * Gets the current job state.
      *
      * @return The job state.
      */
     public int getState() {
         return mState;
     }

     /**
      * Sets the current job state.
      *
      * @param state The job state.
      *
      * @hide
      */
     public void setState(int state) {
         mState = state;
     }

     /**
      * Sets the owning application id.
      *
      * @return The owning app id.
      *
      * @hide
      */
     public int getAppId() {
         return mAppId;
     }

     /**
      * Sets the owning application id.
      *
      * @param appId The owning app id.
      *
      * @hide
      */
     public void setAppId(int appId) {
         mAppId = appId;
     }

     /**
      * Gets the optional tag assigned by a print service.
      *
      * @return The tag.
      *
      * @hide
      */
     public String getTag() {
         return mTag;
     }

     /**
      * Sets the optional tag assigned by a print service.
      *
      * @param tag The tag.
      *
      * @hide
      */
     public void setTag(String tag) {
         mTag = tag;
     }

     /**
      * Gets the wall time in millisecond when this print job was created.
      *
      * @return The creation time in milliseconds.
      */
     public long getCreationTime() {
         return mCreationTime;
     }

     /**
      * Sets the wall time in milliseconds when this print job was created.
      *
      * @param creationTime The creation time in milliseconds.
      *
      * @hide
      */
     public void setCreationTime(long creationTime) {
         if (creationTime < 0) {
             throw new IllegalArgumentException("creationTime must be non-negative.");
         }
         mCreationTime = creationTime;
     }

     /**
      * Gets the number of copies.
      *
      * @return The number of copies or zero if not set.
      */
     public int getCopies() {
         return mCopies;
     }

     /**
      * Sets the number of copies.
      *
      * @param copyCount The number of copies.
      *
      * @hide
      */
     public void setCopies(int copyCount) {
         if (copyCount < 1) {
             throw new IllegalArgumentException("Copies must be more than one.");
         }
         mCopies = copyCount;
     }

     /**
      * Gets the reason for the print job being in the current state.
      *
      * @return The reason, or null if there is no reason or the
      * reason is unknown.
      *
      * @hide
      */
     public String getStateReason() {
         return mStateReason;
     }

     /**
      * Sets the reason for the print job being in the current state.
      *
      * @param stateReason The reason, or null if there is no reason
      * or the reason is unknown.
      *
      * @hide
      */
     public void setStateReason(String stateReason) {
         mStateReason = stateReason;
     }

     /**
      * Gets the included pages.
      *
      * @return The included pages or <code>null</code> if not set.
      */
     public PageRange[] getPages() {
         return mPageRanges;
     }

     /**
      * Sets the included pages.
      *
      * @param pageRanges The included pages.
      *
      * @hide
      */
     public void setPages(PageRange[] pageRanges) {
         mPageRanges = pageRanges;
     }

     /**
      * Gets the print job attributes.
      *
      * @return The attributes.
      */
     public PrintAttributes getAttributes() {
         return mAttributes;
     }

     /**
      * Sets the print job attributes.
      *
      * @param attributes The attributes.
      *
      * @hide
      */
     public void setAttributes(PrintAttributes attributes) {
         mAttributes = attributes;
     }

     /**
      * Gets the info describing the printed document.
      *
      * @return The document info.
      *
      * @hide
      */
     public PrintDocumentInfo getDocumentInfo() {
         return mDocumentInfo;
     }

     /**
      * Sets the info describing the printed document.
      *
      * @param info The document info.
      *
      * @hide
      */
     public void setDocumentInfo(PrintDocumentInfo info) {
         mDocumentInfo = info;
     }

     /**
      * Gets whether this print is being cancelled.
      *
      * @return True if the print job is being cancelled.
      *
      * @hide
      */
     public boolean isCancelling() {
         return mCanceling;
     }

     /**
      * Sets whether this print is being cancelled.
      *
      * @param cancelling True if the print job is being cancelled.
      *
      * @hide
      */
     public void setCancelling(boolean cancelling) {
         mCanceling = cancelling;
     }

     @Override
     public int describeContents() {
         return 0;
     }

     @Override
     public void writeToParcel(Parcel parcel, int flags) {
         parcel.writeParcelable(mId, flags);
         parcel.writeString(mLabel);
         parcel.writeParcelable(mPrinterId, flags);
         parcel.writeString(mPrinterName);
         parcel.writeInt(mState);
         parcel.writeInt(mAppId);
         parcel.writeString(mTag);
         parcel.writeLong(mCreationTime);
         parcel.writeInt(mCopies);
         parcel.writeString(mStateReason);
         if (mPageRanges != null) {
             parcel.writeInt(1);
             parcel.writeParcelableArray(mPageRanges, flags);
         } else {
             parcel.writeInt(0);
         }
         if (mAttributes != null) {
             parcel.writeInt(1);
             mAttributes.writeToParcel(parcel, flags);
         } else {
             parcel.writeInt(0);
         }
         if (mDocumentInfo != null) {
             parcel.writeInt(1);
             mDocumentInfo.writeToParcel(parcel, flags);
         } else {
             parcel.writeInt(0);
         }
         parcel.writeInt(mCanceling ? 1 : 0);
     }

     @Override
     public String toString() {
         StringBuilder builder = new StringBuilder();
         builder.append("PrintJobInfo{");
         builder.append("label: ").append(mLabel);
         builder.append(", id: ").append(mId);
         builder.append(", state: ").append(stateToString(mState));
         builder.append(", printer: " + mPrinterId);
         builder.append(", tag: ").append(mTag);
         builder.append(", creationTime: " + mCreationTime);
         builder.append(", copies: ").append(mCopies);
         builder.append(", attributes: " + (mAttributes != null
                 ? mAttributes.toString() : null));
         builder.append(", documentInfo: " + (mDocumentInfo != null
                 ? mDocumentInfo.toString() : null));
         builder.append(", cancelling: " + mCanceling);
         builder.append(", pages: " + (mPageRanges != null
                 ? Arrays.toString(mPageRanges) : null));
         builder.append("}");
         return builder.toString();
     }

     /** @hide */
     public static String stateToString(int state) {
         switch (state) {
             case STATE_CREATED: {
                 return "STATE_CREATED";
             }
             case STATE_QUEUED: {
                 return "STATE_QUEUED";
             }
             case STATE_STARTED: {
                 return "STATE_STARTED";
             }
             case STATE_BLOCKED: {
                 return "STATE_BLOCKED";
             }
             case STATE_FAILED: {
                 return "STATE_FAILED";
             }
             case STATE_COMPLETED: {
                 return "STATE_COMPLETED";
             }
             case STATE_CANCELED: {
                 return "STATE_CANCELED";
             }
             default: {
                 return "STATE_UNKNOWN";
             }
         }
     }

     /**
      * Builder for creating a {@link PrintJobInfo}.
      */
     public static final class Builder {
         private final PrintJobInfo mPrototype;

         /**
          * Constructor.
          *
          * @param prototype Prototype to use as a starting point.
          * Can be null.
          */
         public Builder(PrintJobInfo prototype) {
             mPrototype = (prototype != null)
                     ? new PrintJobInfo(prototype)
                     : new PrintJobInfo();
         }

         /**
          * Sets the number of copies.
          *
          * @param copies The number of copies.
          */
         public void setCopies(int copies) {
             mPrototype.mCopies = copies;
         }

         /**
          * Sets the print job attributes.
          *
          * @param attributes The attributes.
          */
         public void setAttributes(PrintAttributes attributes) {
             mPrototype.mAttributes = attributes;
         }

         /**
          * Sets the included pages.
          *
          * @param pages The included pages.
          */
         public void setPages(PageRange[] pages) {
             mPrototype.mPageRanges = pages;
         }

         /**
          * Puts an advanced (printer specific) option.
          *
          * @param key The option key.
          * @param value The option value.
          */
         public void putAdvancedOption(String key, String value) {

         }

         /**
          * Puts an advanced (printer specific) option.
          *
          * @param key The option key.
          * @param value The option value.
          */
         public void putAdvancedOption(String key, int value) {

         }

         /**
          * Creates a new {@link PrintJobInfo} instance.
          *
          * @return The new instance.
          */
         public PrintJobInfo build() {
             return mPrototype;
         }
     }

     public static final Parcelable.Creator<PrintJobInfo> CREATOR =
             new Creator<PrintJobInfo>() {
         @Override
         public PrintJobInfo createFromParcel(Parcel parcel) {
             return new PrintJobInfo(parcel);
         }

         @Override
         public PrintJobInfo[] newArray(int size) {
             return new PrintJobInfo[size];
         }
     };
 }
	/*
	* Copyright (C) 2013 The Android Open Source Project
	*
	* Licensed under the Apache License, Version 2.0 (the "License");
	* you may not use this file except in compliance with the License.
	* You may obtain a copy of the License at
	*
	* http://www.apache.org/licenses/LICENSE-2.0
	*
	* Unless required by applicable law or agreed to in writing, software
	* distributed under the License is distributed on an "AS IS" BASIS,
	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	* See the License for the specific language governing permissions and
	* limitations under the License.
	*/

	package android.print;

	import android.os.Parcel;
	import android.os.Parcelable;

	import java.util.Arrays;

	/**
	* This class represents the description of a print job.
	*/
	public final class PrintJobInfo implements Parcelable {

	/**
	* Constant for matching any print job state.
	*
	* @hide
	*/
	public static final int STATE_ANY = -1;

	/**
	* Constant for matching any print job state.
	*
	* @hide
	*/
	public static final int STATE_ANY_VISIBLE_TO_CLIENTS = -2;

	/**
	* Constant for matching any active print job state.
	*
	* @hide
	*/
	public static final int STATE_ANY_ACTIVE = -3;

	/**
	* Constant for matching any scheduled, i.e. delivered to a print
	* service, print job state.
	*
	* @hide
	*/
	public static final int STATE_ANY_SCHEDULED = -4;

	/**
	* Print job state: The print job is being created but not yet
	* ready to be printed.
	* <p>
	* Next valid states: {@link #STATE_QUEUED}
	* </p>
	*/
	public static final int STATE_CREATED = 1;

	/**
	* Print job state: The print jobs is created, it is ready
	* to be printed and should be processed.
	* <p>
	* Next valid states: {@link #STATE_STARTED}, {@link #STATE_FAILED},
	* {@link #STATE_CANCELED}
	* </p>
	*/
	public static final int STATE_QUEUED = 2;

	/**
	* Print job state: The print job is being printed.
	* <p>
	* Next valid states: {@link #STATE_COMPLETED}, {@link #STATE_FAILED},
	* {@link #STATE_CANCELED}, {@link #STATE_BLOCKED}
	* </p>
	*/
	public static final int STATE_STARTED = 3;

	/**
	* Print job state: The print job is blocked.
	* <p>
	* Next valid states: {@link #STATE_FAILED}, {@link #STATE_CANCELED},
	* {@link #STATE_STARTED}
	* </p>
	*/
	public static final int STATE_BLOCKED = 4;

	/**
	* Print job state: The print job was successfully printed.
	* This is a terminal state.
	* <p>
	* Next valid states: None
	* </p>
	*/
	public static final int STATE_COMPLETED = 5;

	/**
	* Print job state: The print job was printing but printing failed.
	* This is a terminal state.
	* <p>
	* Next valid states: None
	* </p>
	*/
	public static final int STATE_FAILED = 6;

	/**
	* Print job state: The print job was canceled.
	* This is a terminal state.
	* <p>
	* Next valid states: None
	* </p>
	*/
	public static final int STATE_CANCELED = 7;

	/** The unique print job id. */
	private PrintJobId mId;

	/** The human readable print job label. */
	private String mLabel;

	/** The unique id of the printer. */
	private PrinterId mPrinterId;

	/** The name of the printer - internally used */
	private String mPrinterName;

	/** The state of the print job. */
	private int mState;

	/** The id of the app that created the job. */
	private int mAppId;

	/** Optional tag assigned by a print service.*/
	private String mTag;

	/** The wall time when the print job was created. */
	private long mCreationTime;

	/** How many copies to print. */
	private int mCopies;

	/** Reason for the print job being in its current state. */
	private String mStateReason;

	/** The pages to print */
	private PageRange[] mPageRanges;

	/** The print job attributes size. */
	private PrintAttributes mAttributes;

	/** Information about the printed document. */
	private PrintDocumentInfo mDocumentInfo;

	/** Whether we are trying to cancel this print job. */
	private boolean mCanceling;

	/** @hide*/
	public PrintJobInfo() {
	/* do nothing */
	}

	/** @hide */
	public PrintJobInfo(PrintJobInfo other) {
	mId = other.mId;
	mLabel = other.mLabel;
	mPrinterId = other.mPrinterId;
	mPrinterName = other.mPrinterName;
	mState = other.mState;
	mAppId = other.mAppId;
	mTag = other.mTag;
	mCreationTime = other.mCreationTime;
	mCopies = other.mCopies;
	mStateReason = other.mStateReason;
	mPageRanges = other.mPageRanges;
	mAttributes = other.mAttributes;
	mDocumentInfo = other.mDocumentInfo;
	mCanceling = other.mCanceling;
	}

	private PrintJobInfo(Parcel parcel) {
	mId = parcel.readParcelable(null);
	mLabel = parcel.readString();
	mPrinterId = parcel.readParcelable(null);
	mPrinterName = parcel.readString();
	mState = parcel.readInt();
	mAppId = parcel.readInt();
	mTag = parcel.readString();
	mCreationTime = parcel.readLong();
	mCopies = parcel.readInt();
	mStateReason = parcel.readString();
	if (parcel.readInt() == 1) {
	Parcelable[] parcelables = parcel.readParcelableArray(null);
	mPageRanges = new PageRange[parcelables.length];
	for (int i = 0; i < parcelables.length; i++) {
	mPageRanges[i] = (PageRange) parcelables[i];
	}
	}
	if (parcel.readInt() == 1) {
	mAttributes = PrintAttributes.CREATOR.createFromParcel(parcel);
	}
	if (parcel.readInt() == 1) {
	mDocumentInfo = PrintDocumentInfo.CREATOR.createFromParcel(parcel);
	}
	mCanceling = (parcel.readInt() == 1);
	}

	/**
	* Gets the unique print job id.
	*
	* @return The id.
	*/
	public PrintJobId getId() {
	return mId;
	}

	/**
	* Sets the unique print job id.
	*
	* @param The job id.
	*
	* @hide
	*/
	public void setId(PrintJobId id) {
	this.mId = id;
	}

	/**
	* Gets the human readable job label.
	*
	* @return The label.
	*/
	public String getLabel() {
	return mLabel;
	}

	/**
	* Sets the human readable job label.
	*
	* @param label The label.
	*
	* @hide
	*/
	public void setLabel(String label) {
	mLabel = label;
	}

	/**
	* Gets the unique target printer id.
	*
	* @return The target printer id.
	*/
	public PrinterId getPrinterId() {
	return mPrinterId;
	}

	/**
	* Sets the unique target pritner id.
	*
	* @param printerId The target printer id.
	*
	* @hide
	*/
	public void setPrinterId(PrinterId printerId) {
	mPrinterId = printerId;
	}

	/**
	* Gets the name of the target printer.
	*
	* @return The printer name.
	*
	* @hide
	*/
	public String getPrinterName() {
	return mPrinterName;
	}

	/**
	* Sets the name of the target printer.
	*
	* @param printerName The printer name.
	*
	* @hide
	*/
	public void setPrinterName(String printerName) {
	mPrinterName = printerName;
	}

	/**
	* Gets the current job state.
	*
	* @return The job state.
	*/
	public int getState() {
	return mState;
	}

	/**
	* Sets the current job state.
	*
	* @param state The job state.
	*
	* @hide
	*/
	public void setState(int state) {
	mState = state;
	}

	/**
	* Sets the owning application id.
	*
	* @return The owning app id.
	*
	* @hide
	*/
	public int getAppId() {
	return mAppId;
	}

	/**
	* Sets the owning application id.
	*
	* @param appId The owning app id.
	*
	* @hide
	*/
	public void setAppId(int appId) {
	mAppId = appId;
	}

	/**
	* Gets the optional tag assigned by a print service.
	*
	* @return The tag.
	*
	* @hide
	*/
	public String getTag() {
	return mTag;
	}

	/**
	* Sets the optional tag assigned by a print service.
	*
	* @param tag The tag.
	*
	* @hide
	*/
	public void setTag(String tag) {
	mTag = tag;
	}

	/**
	* Gets the wall time in millisecond when this print job was created.
	*
	* @return The creation time in milliseconds.
	*/
	public long getCreationTime() {
	return mCreationTime;
	}

	/**
	* Sets the wall time in milliseconds when this print job was created.
	*
	* @param creationTime The creation time in milliseconds.
	*
	* @hide
	*/
	public void setCreationTime(long creationTime) {
	if (creationTime < 0) {
	throw new IllegalArgumentException("creationTime must be non-negative.");
	}
	mCreationTime = creationTime;
	}

	/**
	* Gets the number of copies.
	*
	* @return The number of copies or zero if not set.
	*/
	public int getCopies() {
	return mCopies;
	}

	/**
	* Sets the number of copies.
	*
	* @param copyCount The number of copies.
	*
	* @hide
	*/
	public void setCopies(int copyCount) {
	if (copyCount < 1) {
	throw new IllegalArgumentException("Copies must be more than one.");
	}
	mCopies = copyCount;
	}

	/**
	* Gets the reason for the print job being in the current state.
	*
	* @return The reason, or null if there is no reason or the
	* reason is unknown.
	*
	* @hide
	*/
	public String getStateReason() {
	return mStateReason;
	}

	/**
	* Sets the reason for the print job being in the current state.
	*
	* @param stateReason The reason, or null if there is no reason
	* or the reason is unknown.
	*
	* @hide
	*/
	public void setStateReason(String stateReason) {
	mStateReason = stateReason;
	}

	/**
	* Gets the included pages.
	*
	* @return The included pages or <code>null</code> if not set.
	*/
	public PageRange[] getPages() {
	return mPageRanges;
	}

	/**
	* Sets the included pages.
	*
	* @param pageRanges The included pages.
	*
	* @hide
	*/
	public void setPages(PageRange[] pageRanges) {
	mPageRanges = pageRanges;
	}

	/**
	* Gets the print job attributes.
	*
	* @return The attributes.
	*/
	public PrintAttributes getAttributes() {
	return mAttributes;
	}

	/**
	* Sets the print job attributes.
	*
	* @param attributes The attributes.
	*
	* @hide
	*/
	public void setAttributes(PrintAttributes attributes) {
	mAttributes = attributes;
	}

	/**
	* Gets the info describing the printed document.
	*
	* @return The document info.
	*
	* @hide
	*/
	public PrintDocumentInfo getDocumentInfo() {
	return mDocumentInfo;
	}

	/**
	* Sets the info describing the printed document.
	*
	* @param info The document info.
	*
	* @hide
	*/
	public void setDocumentInfo(PrintDocumentInfo info) {
	mDocumentInfo = info;
	}

	/**
	* Gets whether this print is being cancelled.
	*
	* @return True if the print job is being cancelled.
	*
	* @hide
	*/
	public boolean isCancelling() {
	return mCanceling;
	}

	/**
	* Sets whether this print is being cancelled.
	*
	* @param cancelling True if the print job is being cancelled.
	*
	* @hide
	*/
	public void setCancelling(boolean cancelling) {
	mCanceling = cancelling;
	}

	@Override
	public int describeContents() {
	return 0;
	}

	@Override
	public void writeToParcel(Parcel parcel, int flags) {
	parcel.writeParcelable(mId, flags);
	parcel.writeString(mLabel);
	parcel.writeParcelable(mPrinterId, flags);
	parcel.writeString(mPrinterName);
	parcel.writeInt(mState);
	parcel.writeInt(mAppId);
	parcel.writeString(mTag);
	parcel.writeLong(mCreationTime);
	parcel.writeInt(mCopies);
	parcel.writeString(mStateReason);
	if (mPageRanges != null) {
	parcel.writeInt(1);
	parcel.writeParcelableArray(mPageRanges, flags);
	} else {
	parcel.writeInt(0);
	}
	if (mAttributes != null) {
	parcel.writeInt(1);
	mAttributes.writeToParcel(parcel, flags);
	} else {
	parcel.writeInt(0);
	}
	if (mDocumentInfo != null) {
	parcel.writeInt(1);
	mDocumentInfo.writeToParcel(parcel, flags);
	} else {
	parcel.writeInt(0);
	}
	parcel.writeInt(mCanceling ? 1 : 0);
	}

	@Override
	public String toString() {
	StringBuilder builder = new StringBuilder();
	builder.append("PrintJobInfo{");
	builder.append("label: ").append(mLabel);
	builder.append(", id: ").append(mId);
	builder.append(", state: ").append(stateToString(mState));
	builder.append(", printer: " + mPrinterId);
	builder.append(", tag: ").append(mTag);
	builder.append(", creationTime: " + mCreationTime);
	builder.append(", copies: ").append(mCopies);
	builder.append(", attributes: " + (mAttributes != null
	? mAttributes.toString() : null));
	builder.append(", documentInfo: " + (mDocumentInfo != null
	? mDocumentInfo.toString() : null));
	builder.append(", cancelling: " + mCanceling);
	builder.append(", pages: " + (mPageRanges != null
	? Arrays.toString(mPageRanges) : null));
	builder.append("}");
	return builder.toString();
	}

	/** @hide */
	public static String stateToString(int state) {
	switch (state) {
	case STATE_CREATED: {
	return "STATE_CREATED";
	}
	case STATE_QUEUED: {
	return "STATE_QUEUED";
	}
	case STATE_STARTED: {
	return "STATE_STARTED";
	}
	case STATE_BLOCKED: {
	return "STATE_BLOCKED";
	}
	case STATE_FAILED: {
	return "STATE_FAILED";
	}
	case STATE_COMPLETED: {
	return "STATE_COMPLETED";
	}
	case STATE_CANCELED: {
	return "STATE_CANCELED";
	}
	default: {
	return "STATE_UNKNOWN";
	}
	}
	}

	/**
	* Builder for creating a {@link PrintJobInfo}.
	*/
	public static final class Builder {
	private final PrintJobInfo mPrototype;

	/**
	* Constructor.
	*
	* @param prototype Prototype to use as a starting point.
	* Can be null.
	*/
	public Builder(PrintJobInfo prototype) {
	mPrototype = (prototype != null)
	? new PrintJobInfo(prototype)
	: new PrintJobInfo();
	}

	/**
	* Sets the number of copies.
	*
	* @param copies The number of copies.
	*/
	public void setCopies(int copies) {
	mPrototype.mCopies = copies;
	}

	/**
	* Sets the print job attributes.
	*
	* @param attributes The attributes.
	*/
	public void setAttributes(PrintAttributes attributes) {
	mPrototype.mAttributes = attributes;
	}

	/**
	* Sets the included pages.
	*
	* @param pages The included pages.
	*/
	public void setPages(PageRange[] pages) {
	mPrototype.mPageRanges = pages;
	}

	/**
	* Puts an advanced (printer specific) option.
	*
	* @param key The option key.
	* @param value The option value.
	*/
	public void putAdvancedOption(String key, String value) {

	}

	/**
	* Puts an advanced (printer specific) option.
	*
	* @param key The option key.
	* @param value The option value.
	*/
	public void putAdvancedOption(String key, int value) {

	}

	/**
	* Creates a new {@link PrintJobInfo} instance.
	*
	* @return The new instance.
	*/
	public PrintJobInfo build() {
	return mPrototype;
	}
	}

	public static final Parcelable.Creator<PrintJobInfo> CREATOR =
	new Creator<PrintJobInfo>() {
	@Override
	public PrintJobInfo createFromParcel(Parcel parcel) {
	return new PrintJobInfo(parcel);
	}

	@Override
	public PrintJobInfo[] newArray(int size) {
	return new PrintJobInfo[size];
	}
	};
	}