* In most cases, the exact pages to be printed will be generated by a device
* driver and this attribute would not be required. However, when printing an
* archived document which has already been formatted, the end user may elect to
* print just a subset of the pages contained in the document. In this case, if
* a page range of "n-m" is specified, the first page
* to be printed will be page n. All subsequent pages of the document
* will be printed through and including page m.
*
* If a PageRanges attribute is not specified for a print job, all pages of
* the document will be printed. In other words, the default value for the
* PageRanges attribute is always {{1, Integer.MAX_VALUE}}.
*
* The effect of a PageRanges attribute on a multidoc print job (a job with * multiple documents) depends on whether all the docs have the same page ranges * specified or whether different docs have different page ranges specified, and * on the (perhaps defaulted) value of the {@link MultipleDocumentHandling * MultipleDocumentHandling} attribute. *
*
*
*
*
* IPP Compatibility: The PageRanges attribute's canonical array form
* gives the lower and upper bound for each range of pages to be included in
* and IPP "page-ranges" attribute. See class {@link
* javax.print.attribute.SetOfIntegerSyntax SetOfIntegerSyntax} for an
* explanation of canonical array form. The category name returned by
* getName() gives the IPP attribute name.
*
*
* @author David Mendenhall
* @author Alan Kaminsky
*/
public final class PageRanges extends SetOfIntegerSyntax
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute {
private static final long serialVersionUID = 8639895197656148392L;
/**
* Construct a new page ranges attribute with the given members. The
* members are specified in "array form;" see class {@link
* javax.print.attribute.SetOfIntegerSyntax SetOfIntegerSyntax} for an
* explanation of array form.
*
* @param members Set members in array form.
*
* @exception NullPointerException
* (unchecked exception) Thrown if members is null or
* any element of members is null.
* @exception IllegalArgumentException
* (unchecked exception) Thrown if any element of
* members is not a length-one or length-two array. Also
* thrown if members is a zero-length array or if any
* member of the set is less than 1.
*/
public PageRanges(int[][] members) {
super (members);
if (members == null) {
throw new NullPointerException("members is null");
}
myPageRanges();
}
/**
* Construct a new page ranges attribute with the given members in
* string form.
* See class {@link javax.print.attribute.SetOfIntegerSyntax
* SetOfIntegerSyntax}
* for explanation of the syntax.
*
* @param members Set members in string form.
*
* @exception NullPointerException
* (unchecked exception) Thrown if members is null or
* any element of members is null.
* @exception IllegalArgumentException
* (Unchecked exception) Thrown if members does not
* obey the proper syntax. Also
* thrown if the constructed set-of-integer is a
* zero-length array or if any
* member of the set is less than 1.
*/
public PageRanges(String members) {
super(members);
if (members == null) {
throw new NullPointerException("members is null");
}
myPageRanges();
}
private void myPageRanges() {
int[][] myMembers = getMembers();
int n = myMembers.length;
if (n == 0) {
throw new IllegalArgumentException("members is zero-length");
}
int i;
for (i = 0; i < n; ++ i) {
if (myMembers[i][0] < 1) {
throw new IllegalArgumentException("Page value < 1 specified");
}
}
}
/**
* Construct a new page ranges attribute containing a single integer. That
* is, only the one page is to be printed.
*
* @param member Set member.
*
* @exception IllegalArgumentException
* (Unchecked exception) Thrown if member is less than
* 1.
*/
public PageRanges(int member) {
super (member);
if (member < 1) {
throw new IllegalArgumentException("Page value < 1 specified");
}
}
/**
* Construct a new page ranges attribute containing a single range of
* integers. That is, only those pages in the one range are to be printed.
*
* @param lowerBound Lower bound of the range.
* @param upperBound Upper bound of the range.
*
* @exception IllegalArgumentException
* (Unchecked exception) Thrown if a null range is specified or if a
* non-null range is specified with lowerBound less than
* 1.
*/
public PageRanges(int lowerBound, int upperBound) {
super (lowerBound, upperBound);
if (lowerBound > upperBound) {
throw new IllegalArgumentException("Null range specified");
} else if (lowerBound < 1) {
throw new IllegalArgumentException("Page value < 1 specified");
}
}
/**
* Returns whether this page ranges attribute is equivalent to the passed
* in object. To be equivalent, all of the following conditions must be
* true:
*
object is not null.
* object is an instance of class PageRanges.
* object's members
* are the same.
* object is equivalent to this page ranges
* attribute, false otherwise.
*/
public boolean equals(Object object) {
return (super.equals(object) && object instanceof PageRanges);
}
/**
* Get the printing attribute class which is to be used as the "category"
* for this printing attribute value.
* * For class PageRanges, the category is class PageRanges itself. * * @return Printing attribute class (category), an instance of class * {@link java.lang.Class java.lang.Class}. */ public final Class getCategory() { return PageRanges.class; } /** * Get the name of the category of which this attribute value is an * instance. *
* For class PageRanges, the category name is "page-ranges".
*
* @return Attribute category name.
*/
public final String getName() {
return "page-ranges";
}
}