| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public final class AttributeSetUtilities extends Object
Class AttributeSetUtilities provides static methods for manipulating AttributeSets.
An unmodifiable view U of an AttributeSet S 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 an UnmodifiableSetException. 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, a null reference 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. IllegalArgumentException and NullPointerException are examples of typical and acceptable run time exceptions for such cases.
Method Summary | |
---|---|
static AttributeSet |
synchronizedView(AttributeSet attributeSet) Creates a synchronized view of the given attribute set. |
static DocAttributeSet |
synchronizedView(DocAttributeSet attributeSet) Creates a synchronized view of the given doc attribute set. |
static PrintJobAttributeSet |
synchronizedView(PrintJobAttributeSet attributeSet) Creates a synchronized view of the given print job attribute set. |
static PrintRequestAttributeSet |
synchronizedView(PrintRequestAttributeSet attributeSet) Creates a synchronized view of the given print request attribute set. |
static PrintServiceAttributeSet |
synchronizedView(PrintServiceAttributeSet attributeSet) Creates a synchronized view of the given print service attribute set. |
static AttributeSet |
unmodifiableView(AttributeSet attributeSet) Creates an unmodifiable view of the given attribute set. |
static DocAttributeSet |
unmodifiableView(DocAttributeSet attributeSet) Creates an unmodifiable view of the given doc attribute set. |
static PrintJobAttributeSet |
unmodifiableView(PrintJobAttributeSet attributeSet) Creates an unmodifiable view of the given print job attribute set. |
static PrintRequestAttributeSet |
unmodifiableView(PrintRequestAttributeSet attributeSet) Creates an unmodifiable view of the given print request attribute set. |
static PrintServiceAttributeSet |
unmodifiableView(PrintServiceAttributeSet attributeSet) Creates an unmodifiable view of the given print service attribute set. |
static Class |
verifyAttributeCategory(Object object, Class interfaceName) Verify that the given object is a java.lang.Class that implements the given interface, which is assumed to be interface javax.print.attribute.Attribute or a subinterface thereof. |
static Attribute |
verifyAttributeValue(Object object, Class interfaceName) Verify that the given object is an instance of the given interface, which is assumed to be interface javax.print.attribute.Attribute or a subinterface thereof. |
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. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static AttributeSet synchronizedView(AttributeSet attributeSet)
attributeSet
- Underlying attribute set.attributeSet
.public static DocAttributeSet synchronizedView(DocAttributeSet attributeSet)
attributeSet
- Underlying doc attribute set.attributeSet
.public static PrintJobAttributeSet synchronizedView(PrintJobAttributeSet attributeSet)
attributeSet
- Underlying print job attribute set.attributeSet
.public static PrintRequestAttributeSet synchronizedView(PrintRequestAttributeSet attributeSet)
attributeSet
- Underlying print request attribute set.attributeSet
.public static PrintServiceAttributeSet synchronizedView(PrintServiceAttributeSet attributeSet)
attributeSet
- Underlying print service attribute set.attributeSet
.public static AttributeSet unmodifiableView(AttributeSet attributeSet)
attributeSet
- Underlying attribute set.attributeSet
.public static DocAttributeSet unmodifiableView(DocAttributeSet attributeSet)
attributeSet
- Underlying doc attribute set.attributeSet
.public static PrintJobAttributeSet unmodifiableView(PrintJobAttributeSet attributeSet)
attributeSet
- Underlying print job attribute set.attributeSet
.public static PrintRequestAttributeSet unmodifiableView(PrintRequestAttributeSet attributeSet)
attributeSet
- Underlying print request attribute set.attributeSet
.public static PrintServiceAttributeSet unmodifiableView(PrintServiceAttributeSet attributeSet)
attributeSet
- Underlying print service attribute set.attributeSet
.public static Class verifyAttributeCategory(Object object, Class interfaceName)
object
- Object to test.interfaceName
- Interface the object must implement.object
is a {@link java.lang.Class Class}
that implements interfaceName
,
object
is returned downcast to type {@link
java.lang.Class Class}; otherwise an exception is thrown.public static Attribute verifyAttributeValue(Object object, Class interfaceName)
object
- Object to test.interfaceName
- Interface of which the object must be an instance.object
is an instance of
interfaceName
, object
is returned
downcast to type {@link Attribute Attribute}; otherwise an
exception is thrown.public static void verifyCategoryForValue(Class category, Attribute attribute)
category
- Attribute category to test.attribute
- Attribute value to test.
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |