1. /*

  2.  * @(#)AttributeException.java	1.4 03/12/19

  3.  *

  4.  * Copyright 2004 Sun Microsystems, Inc. All rights reserved.

  5.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  6.  */

  7. 

  8. package javax.print;

  9. 

  10. import javax.print.attribute.Attribute;

  11. 

  12. /**

  13.  * Interface AttributeException is a mixin interface which a subclass of

  14.  * {@link 

  15.  * PrintException PrintException} can implement to report an error condition 

  16.  * involving one or more printing attributes that a particular Print 

  17.  * Service instance does not support. Either the attribute is not supported at 

  18.  * all, or the attribute is supported but the particular specified value is not 

  19.  * supported. The Print Service API does not define any print exception 

  20.  * classes that implement interface AttributeException, that being left to the 

  21.  * Print Service implementor's discretion. 

  22.  *

  23.  */

  24. 

  25. public interface AttributeException {

  26. 

  27. 

  28.     /**

  29.      * Returns the array of printing attribute classes for which the Print 

  30.      * Service instance does not support the attribute at all, or null if  

  31.      * there are no such attributes. The objects in the returned array are  

  32.      * classes that extend the base interface

  33.      * {@link javax.print.attribute.Attribute Attribute}. 

  34.      * 

  35.      * @return unsupported attribute classes

  36.      */

  37.     public Class[] getUnsupportedAttributes();

  38. 

  39.     /**

  40.      * Returns the array of printing attributes for which the Print Service 

  41.      * instance supports the attribute but does not support that particular 

  42.      * value of the attribute, or null if there are no such attribute values. 

  43.      * 

  44.      * @return unsupported attribute values

  45.      */

  46.     public Attribute[] getUnsupportedValues();

  47. 

  48.     }