Module java.desktop
Package javax.print.attribute.standard

Class JobKOctets

java.lang.Object
javax.print.attribute.IntegerSyntax
javax.print.attribute.standard.JobKOctets
所有已实现的接口:
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指定的打印数据表示类来计算的，如下表所示。

显示文档大小计算的表
表示类 文档大小
byte[] 字节数组的长度
java.io.InputStream 从流中读取的字节数
char[] 字符数组的长度 x 2
java.lang.String 字符串的长度 x 2
java.io.Reader 从流中读取的字符数 x 2
java.net.URL 从给定URL地址的文件中读取的字节数
java.awt.image.renderable.RenderableImage 实现相关*
java.awt.print.Printable 实现相关*
java.awt.print.Pageable 实现相关*

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

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

参见:

  • Constructor Details

    • JobKOctets

      public JobKOctets(int value)
      使用给定的整数值构造一个新的作业K八位字节属性。
      参数:
      value - 整数值
      抛出:
      IllegalArgumentException - 如果value为负

  • Method Details

    • equals

      public boolean equals(Object object)
      返回此作业K八位字节属性是否等同于传入的对象。要等同，必须满足以下所有条件:
      1. object不是null。
      2. object是JobKOctets类的实例。
      3. 此作业K八位字节属性的值和object的值相等。
      覆盖:
      equals 在类 IntegerSyntax中
      参数:
      object - 要比较的Object
      返回:
      如果object等同于此作业K八位字节属性，则返回true，否则返回false
      参见:

    • getCategory

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

      对于类JobKOctets，类别是JobKOctets本身。

      指定者:
      getCategory 在接口 Attribute中
      返回:
      打印属性类（类别），是java.lang.Class类的实例

    • getName

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

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

      指定者:
      getName 在接口 Attribute中
      返回:
      属性类别名称