--- old/src/java.desktop/share/classes/javax/print/event/PrintJobEvent.java 2017-07-16 16:18:40.000000000 -0700 +++ new/src/java.desktop/share/classes/javax/print/event/PrintJobEvent.java 2017-07-16 16:18:40.000000000 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2003, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -28,98 +28,95 @@ import javax.print.DocPrintJob; /** - * - * Class {@code PrintJobEvent} encapsulates common events a print job - * reports to let a listener know of progress in the processing of the - * {@link DocPrintJob}. - * + * Class {@code PrintJobEvent} encapsulates common events a print job reports to + * let a listener know of progress in the processing of the {@link DocPrintJob}. */ - public class PrintJobEvent extends PrintEvent { - private static final long serialVersionUID = -1711656903622072997L; + /** + * Use serialVersionUID from JDK 1.4 for interoperability. + */ + private static final long serialVersionUID = -1711656903622072997L; + + /** + * The reason of this event. + */ + private int reason; + + /** + * The job was canceled by the + * {@link javax.print.PrintService PrintService}. + */ + public static final int JOB_CANCELED = 101; - private int reason; + /** + * The document is completely printed. + */ + public static final int JOB_COMPLETE = 102; - /** - * The job was canceled by the {@link javax.print.PrintService PrintService}. - */ - public static final int JOB_CANCELED = 101; - - /** - * The document cis completely printed. - */ - public static final int JOB_COMPLETE = 102; - - /** - * The print service reports that the job cannot be completed. - * The application must resubmit the job. - */ - - public static final int JOB_FAILED = 103; - - /** - * The print service indicates that a - possibly transient - problem - * may require external intervention before the print service can - * continue. One example of an event that can - * generate this message is when the printer runs out of paper. - */ - public static final int REQUIRES_ATTENTION = 104; - - /** - * Not all print services may be capable of delivering interesting - * events, or even telling when a job is complete. This message indicates - * the print job has no further information or communication - * with the print service. This message should always be delivered - * if a terminal event (completed/failed/canceled) is not delivered. - * For example, if messages such as JOB_COMPLETE have NOT been received - * before receiving this message, the only inference that should be drawn - * is that the print service does not support delivering such an event. - */ - public static final int NO_MORE_EVENTS = 105; - - /** - * The job is not necessarily printed yet, but the data has been transferred - * successfully from the client to the print service. The client may - * free data resources. - */ - public static final int DATA_TRANSFER_COMPLETE = 106; + /** + * The print service reports that the job cannot be completed. The + * application must resubmit the job. + */ + public static final int JOB_FAILED = 103; - /** + /** + * The print service indicates that a - possibly transient - problem may + * require external intervention before the print service can continue. One + * example of an event that can generate this message is when the printer + * runs out of paper. + */ + public static final int REQUIRES_ATTENTION = 104; + + /** + * Not all print services may be capable of delivering interesting events, + * or even telling when a job is complete. This message indicates the print + * job has no further information or communication with the print service. + * This message should always be delivered if a terminal event + * (completed/failed/canceled) is not delivered. For example, if messages + * such as {@code JOB_COMPLETE} have NOT been received before receiving this + * message, the only inference that should be drawn is that the print + * service does not support delivering such an event. + */ + public static final int NO_MORE_EVENTS = 105; + + /** + * The job is not necessarily printed yet, but the data has been transferred + * successfully from the client to the print service. The client may free + * data resources. + */ + public static final int DATA_TRANSFER_COMPLETE = 106; + + /** * Constructs a {@code PrintJobEvent} object. * - * @param source a {@code DocPrintJob} object - * @param reason an int specifying the reason. - * @throws IllegalArgumentException if {@code source} is - * {@code null}. + * @param source a {@code DocPrintJob} object + * @param reason an int specifying the reason + * @throws IllegalArgumentException if {@code source} is {@code null} */ - public PrintJobEvent( DocPrintJob source, int reason) { super(source); this.reason = reason; - } + } /** * Gets the reason for this event. - * @return reason int. + * + * @return reason int */ public int getPrintEventType() { return reason; } /** - * Determines the {@code DocPrintJob} to which this print job - * event pertains. - * - * @return the {@code DocPrintJob} object that represents the - * print job that reports the events encapsulated by this - * {@code PrintJobEvent}. + * Determines the {@code DocPrintJob} to which this print job event + * pertains. * + * @return the {@code DocPrintJob} object that represents the print job that + * reports the events encapsulated by this {@code PrintJobEvent} */ public DocPrintJob getPrintJob() { return (DocPrintJob) getSource(); } - - }