- java.lang.Object
- 
- javax.print.attribute.AttributeSetUtilities
 
- 
 public final class AttributeSetUtilities extends Object ClassAttributeSetUtilitiesprovides static methods for manipulatingAttributeSets.- Methods for creating unmodifiable and synchronized views of attribute sets.
- operations useful for building implementations of interface
   AttributeSet
 AttributeSetS provides a client with "read-only" access to S. Query operations on U "read through" to S; thus, changes in S are reflected in U. However, any attempt to modify U, results in anUnmodifiableSetException. The unmodifiable view object U will be serializable if the attribute set object S is serializable.A synchronized view V of an attribute set S provides a client with synchronized (multiple thread safe) access to S. Each operation of V is synchronized using V itself as the lock object and then merely invokes the corresponding operation of S. In order to guarantee mutually exclusive access, it is critical that all access to S is accomplished through V. The synchronized view object V will be serializable if the attribute set object S is serializable. As mentioned in the package description of javax.print, anullreference parameter to methods is incorrect unless explicitly documented on the method as having a meaningful interpretation. Usage to the contrary is incorrect coding and may result in a run time exception either immediately or at some later time.IllegalArgumentExceptionandNullPointerExceptionare examples of typical and acceptable run time exceptions for such cases.
- 
- 
Method SummaryAll Methods Static Methods Concrete Methods Modifier and Type Method Description static AttributeSetsynchronizedView(AttributeSet attributeSet)Creates a synchronized view of the given attribute set.static DocAttributeSetsynchronizedView(DocAttributeSet attributeSet)Creates a synchronized view of the given doc attribute set.static PrintJobAttributeSetsynchronizedView(PrintJobAttributeSet attributeSet)Creates a synchronized view of the given print job attribute set.static PrintRequestAttributeSetsynchronizedView(PrintRequestAttributeSet attributeSet)Creates a synchronized view of the given print request attribute set.static PrintServiceAttributeSetsynchronizedView(PrintServiceAttributeSet attributeSet)Creates a synchronized view of the given print service attribute set.static AttributeSetunmodifiableView(AttributeSet attributeSet)Creates an unmodifiable view of the given attribute set.static DocAttributeSetunmodifiableView(DocAttributeSet attributeSet)Creates an unmodifiable view of the given doc attribute set.static PrintJobAttributeSetunmodifiableView(PrintJobAttributeSet attributeSet)Creates an unmodifiable view of the given print job attribute set.static PrintRequestAttributeSetunmodifiableView(PrintRequestAttributeSet attributeSet)Creates an unmodifiable view of the given print request attribute set.static PrintServiceAttributeSetunmodifiableView(PrintServiceAttributeSet attributeSet)Creates an unmodifiable view of the given print service attribute set.static Class<?>verifyAttributeCategory(Object object, Class<?> interfaceName)static AttributeverifyAttributeValue(Object object, Class<?> interfaceName)Verify that the given object is an instance of the given interface, which is assumed to be interfaceAttributeor a subinterface thereof.static voidverifyCategoryForValue(Class<?> category, Attribute attribute)Verify that the given attribute category object is equal to the category of the given attribute value object.
 
- 
- 
- 
Method Detail- 
unmodifiableViewpublic static AttributeSet unmodifiableView(AttributeSet attributeSet) Creates an unmodifiable view of the given attribute set.- Parameters:
- attributeSet- underlying attribute set
- Returns:
- unmodifiable view of attributeSet
- Throws:
- NullPointerException- if- attributeSetis- null
 
 - 
unmodifiableViewpublic static DocAttributeSet unmodifiableView(DocAttributeSet attributeSet) Creates an unmodifiable view of the given doc attribute set.- Parameters:
- attributeSet- underlying doc attribute set
- Returns:
- unmodifiable view of attributeSet
- Throws:
- NullPointerException- if- attributeSetis- null
 
 - 
unmodifiableViewpublic static PrintRequestAttributeSet unmodifiableView(PrintRequestAttributeSet attributeSet) Creates an unmodifiable view of the given print request attribute set.- Parameters:
- attributeSet- underlying print request attribute set
- Returns:
- unmodifiable view of attributeSet
- Throws:
- NullPointerException- if- attributeSetis- null
 
 - 
unmodifiableViewpublic static PrintJobAttributeSet unmodifiableView(PrintJobAttributeSet attributeSet) Creates an unmodifiable view of the given print job attribute set.- Parameters:
- attributeSet- underlying print job attribute set
- Returns:
- unmodifiable view of attributeSet
- Throws:
- NullPointerException- if- attributeSetis- null
 
 - 
unmodifiableViewpublic static PrintServiceAttributeSet unmodifiableView(PrintServiceAttributeSet attributeSet) Creates an unmodifiable view of the given print service attribute set.- Parameters:
- attributeSet- underlying print service attribute set
- Returns:
- unmodifiable view of attributeSet
- Throws:
- NullPointerException- if- attributeSetis- null
 
 - 
synchronizedViewpublic static AttributeSet synchronizedView(AttributeSet attributeSet) Creates a synchronized view of the given attribute set.- Parameters:
- attributeSet- underlying attribute set
- Returns:
- synchronized view of attributeSet
- Throws:
- NullPointerException- if- attributeSetis- null
 
 - 
synchronizedViewpublic static DocAttributeSet synchronizedView(DocAttributeSet attributeSet) Creates a synchronized view of the given doc attribute set.- Parameters:
- attributeSet- underlying doc attribute set
- Returns:
- synchronized view of attributeSet
- Throws:
- NullPointerException- if- attributeSetis- null
 
 - 
synchronizedViewpublic static PrintRequestAttributeSet synchronizedView(PrintRequestAttributeSet attributeSet) Creates a synchronized view of the given print request attribute set.- Parameters:
- attributeSet- underlying print request attribute set
- Returns:
- synchronized view of attributeSet
- Throws:
- NullPointerException- if- attributeSetis- null
 
 - 
synchronizedViewpublic static PrintJobAttributeSet synchronizedView(PrintJobAttributeSet attributeSet) Creates a synchronized view of the given print job attribute set.- Parameters:
- attributeSet- underlying print job attribute set
- Returns:
- synchronized view of attributeSet
- Throws:
- NullPointerException- if- attributeSetis- null
 
 - 
synchronizedViewpublic static PrintServiceAttributeSet synchronizedView(PrintServiceAttributeSet attributeSet) Creates a synchronized view of the given print service attribute set.- Parameters:
- attributeSet- underlying print service attribute set
- Returns:
- synchronized view of attributeSet
- Throws:
- NullPointerException- if- attributeSetis- null
 
 - 
verifyAttributeCategorypublic static Class<?> verifyAttributeCategory(Object object, Class<?> interfaceName) Verify that the given object is aClassthat implements the given interface, which is assumed to be interfaceAttributeor a subinterface thereof.- Parameters:
- object-- Objectto test
- interfaceName- interface the object must implement
- Returns:
- if objectis aClassthat implementsinterfaceName,objectis returned downcast to typeClass; otherwise an exception is thrown
- Throws:
- NullPointerException- if- objectis- null
- ClassCastException- if- objectis not a- Classthat implements- interfaceName
 
 - 
verifyAttributeValuepublic static Attribute verifyAttributeValue(Object object, Class<?> interfaceName) Verify that the given object is an instance of the given interface, which is assumed to be interfaceAttributeor a subinterface thereof.- Parameters:
- object-- Objectto test
- interfaceName- interface of which the object must be an instance
- Returns:
- if objectis an instance ofinterfaceName,objectis returned downcast to typeAttribute; otherwise an exception is thrown
- Throws:
- NullPointerException- if- objectis- null
- ClassCastException- if- objectis not an instance of- interfaceName
 
 - 
verifyCategoryForValuepublic static void verifyCategoryForValue(Class<?> category, Attribute attribute) Verify that the given attribute category object is equal to the category of the given attribute value object. If so, this method returns doing nothing. If not, this method throws an exception.- Parameters:
- category- attribute category to test
- attribute- attribute value to test
- Throws:
- NullPointerException- if the- categoryor- attributeare- null
- IllegalArgumentException- if the- categoryis not equal to the category of the- attribute
 
 
- 
 
-