Package Summary  Overview Summary

class:AttributeSetUtilities [NONE]


  • public final class AttributeSetUtilities
    extends Object
    
    Class AttributeSetUtilities provides static methods for manipulating AttributeSets.
    • Methods for creating unmodifiable and synchronized views of attribute sets.
    • operations useful for building implementations of interface AttributeSet
    An unmodifiable view U of an 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 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:unmodifiableView(javax.print.attribute.AttributeSet) [NONE]

  • unmodifiableView

    public 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 attributeSet is null

method:unmodifiableView(javax.print.attribute.DocAttributeSet) [NONE]

  • unmodifiableView

    public 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 attributeSet is null

method:unmodifiableView(javax.print.attribute.PrintRequestAttributeSet) [NONE]

  • unmodifiableView

    public 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 attributeSet is null

method:unmodifiableView(javax.print.attribute.PrintJobAttributeSet) [NONE]

  • unmodifiableView

    public 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 attributeSet is null

method:unmodifiableView(javax.print.attribute.PrintServiceAttributeSet) [NONE]

  • unmodifiableView

    public 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 attributeSet is null

method:synchronizedView(javax.print.attribute.AttributeSet) [NONE]

  • synchronizedView

    public 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 attributeSet is null

method:synchronizedView(javax.print.attribute.DocAttributeSet) [NONE]

  • synchronizedView

    public 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 attributeSet is null

method:synchronizedView(javax.print.attribute.PrintRequestAttributeSet) [NONE]

  • synchronizedView

    public 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 attributeSet is null

method:synchronizedView(javax.print.attribute.PrintJobAttributeSet) [NONE]

  • synchronizedView

    public 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 attributeSet is null

method:synchronizedView(javax.print.attribute.PrintServiceAttributeSet) [NONE]

  • synchronizedView

    public 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 attributeSet is null

method:verifyAttributeCategory(java.lang.Object,java.lang.Class) [NONE]

  • verifyAttributeCategory

    public static Class<?> verifyAttributeCategory​(Object object,
                                                   Class<?> interfaceName)
    Verify that the given object is a Class that implements the given interface, which is assumed to be interface Attribute or a subinterface thereof.
    Parameters:
    object - Object to test
    interfaceName - interface the object must implement
    Returns:
    if object is a Class that implements interfaceName, object is returned downcast to type Class; otherwise an exception is thrown
    Throws:
    NullPointerException - if object is null
    ClassCastException - if object is not a Class that implements interfaceName

method:verifyAttributeValue(java.lang.Object,java.lang.Class) [NONE]

  • verifyAttributeValue

    public 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 Attribute or a subinterface thereof.
    Parameters:
    object - Object to test
    interfaceName - interface of which the object must be an instance
    Returns:
    if object is an instance of interfaceName, object is returned downcast to type Attribute; otherwise an exception is thrown
    Throws:
    NullPointerException - if object is null
    ClassCastException - if object is not an instance of interfaceName

method:verifyCategoryForValue(java.lang.Class,javax.print.attribute.Attribute) [NONE]

  • verifyCategoryForValue

    public 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 category or attribute are null
    IllegalArgumentException - if the category is not equal to the category of the attribute

© 2018 Oracle Corporation and/or its affiliates