Module  java.desktop
软件包  javax.print.attribute.standard

Class JobKOctets

  • All Implemented Interfaces:
    Serializable ， Cloneable ， Attribute ， PrintJobAttribute ， PrintRequestAttribute 

    public final class JobKOctets
extends IntegerSyntax
implements PrintRequestAttribute, PrintJobAttribute
    JobKOctets类是一个整数值打印属性类，用于指定以K个八位字节为单位的文档的总大小，即以作业中请求处理的1024个八位字节为单位。 值必须向上舍入，所以1到1024个八位字节之间的作业必须表示为1K个八位字节，1025到2048必须是2K字节等。对于多点打印作业（具有多个文档的作业），JobKOctets值通过将单个文档的大小以八位字节相加，然后舍入到下一个K个八位字节值来计算。

    JobKOctets属性描述作业的大小。 这个属性不是一个计数器; 如果已知的话，它是有用的路由和调度信息。 如果打印请求中未提供JobKOctets属性的值，打印机可能会尝试计算。 即使客户端确实为打印请求中的JobKOctets属性提供了一个值，如果打印机能够计算比客户端提供的值更准确的值，打印机也可以选择更改该值。 打印机可能能够在作业提交时间或任何稍后的时间点确定JobKOctets属性的正确值。

    JobKOctets值不能包括由Copies属性指定的份数所贡献的乘数， 而不考虑设备是否可以处理多个副本而不会在作业或文档数据上进行多次传递，而与输出是否整理无关。 。 因此，该值与实现无关，并且指示与K个八位字节中独立于副本数量测量的文档的大小。

    JobKOctets值也不得包含乘法因子，因为嵌入在文档数据中的拷贝指令。 如果文档数据实际上包含文档数据的复制，则此值将包括此类复制。 换句话说，该值始终是源文档数据的大小，而不是要生成的硬拷贝输出的度量。

    根据文档的DocFlavor指定的打印数据表示类来计算文档的大小 ，如下表所示。

    Table showing computation of doc sizes Representation Class Document Size byte[] Length of the byte array java.io.InputStream Number of bytes read from the stream char[] Length of the character array x 2 java.lang.String Length of the string x 2 java.io.Reader Number of characters read from the stream x 2 java.net.URL Number of bytes read from the file at the given URL address java.awt.image.renderable.RenderableImage Implementation dependent* java.awt.print.Printable Implementation dependent* java.awt.print.Pageable Implementation dependent*

    *在这些情况下，打印服务本身会生成发送到打印机的打印数据。 如果打印服务支持JobKOctets属性，对于这些情况，打印服务本身必须计算打印数据的大小，替换客户指定的任何JobKOctets值。

    IPP兼容性：整数值给出IPP整数值。 由getName()返回的类别名称提供IPP属性名称。

    另请参见：
    JobKOctetsSupported ， JobKOctetsProcessed ， JobImpressions ， JobMediaSheets ， Serialized Form

    • 构造方法详细信息

      • JobKOctets

        public JobKOctets​(int value)
        构造具有给定整数值的新作业K个八位字节属性。
        参数
        value - 整数值。
        异常
        IllegalArgumentException - （未检查异常）如果 value小于0，则抛出。

    • 方法详细信息

      • equals

        public boolean equals​(Object object)
        返回此作业K octets属性是否等同于传入的对象。 要相等的，所有以下条件必须为真：
        1. object不为空。
        2. object是JobKOctets类的一个实例。
        3. 该作业K字节属性值和object的值相等。
        重写：
        equals在 IntegerSyntax
        参数
        object - 要比较的对象。
        结果
        如果 object相当于此作业K字节属性， object真，否则为false。
        另请参见：
        Object.hashCode() ， HashMap

      • getCategory

        public final Class<? extends Attribute> getCategory​()
        获取要用作此打印属性值的“类别”的打印属性类。

        对于JobKOctets类，该类别是JobKOctets类。

        Specified by:
        getCategory在接口 Attribute
        结果
        打印属性类（category），一个java.lang.Class类的实例。

      • getName

        public final String getName​()
        获取此属性值是一个实例的类别的名称。

        对于JobKOctets类，类别名称为"job-k-octets" 。

        Specified by:
        getName在接口 Attribute
        结果
        属性类别名称。