Module  java.xml.ws
软件包  javax.xml.ws.soap

Class MTOMFeature


  • public final class MTOMFeature
extends WebServiceFeature
    此功能表示使用具有Web服务的MTOM。 此功能可以在创建SEI代理的过程中使用，并Dispatch个在客户端实例和Endpoint个在服务器端实例。 此功能不能用于客户端上的Service实例创建。

    以下描述了此功能对启用或禁用的影响：

    • ENABLED：在此模式下，MTOM将被启用。 接收方必须同时接受非优化消息和优化消息，并且发送方可以发送优化消息或非优化消息。 发送方使用的启发式方法来确定是否使用优化是实现特定的。
    • 禁用：在此模式下，MTOM将被禁用

    threshold属性可用于设置用于确定二进制数据何时应为XOP编码的阈值。

    从以下版本开始：
    1.6，JAX-WS 2.1

    • 字段详细信息

      • threshold

        protected int threshold
        MTOM阈值属性。 当启用MTOM时，此属性作为提示，以字节为单位的二进制数据应以附件形式发送。 该属性的值必须始终为> = 0。默认值为0。

    • 构造方法详细信息

      • MTOMFeature

        public MTOMFeature​()
        创建一个MTOMFeature 。 创建的实例将被启用。

      • MTOMFeature

        public MTOMFeature​(boolean enabled)
        创建一个 MTOMFeature 。
        参数
        enabled - 指定是否启用此功能

      • MTOMFeature

        public MTOMFeature​(int threshold)
        创建一个MTOMFeature 。 创建的实例将被启用。
        参数
        threshold - 作为附件发送二进制数据的大小（以字节为单位）。
        异常
        WebServiceException - 如果阈值为<0

      • MTOMFeature

        public MTOMFeature​(boolean enabled,
                   int threshold)
        创建一个 MTOMFeature 。
        参数
        enabled - 指定是否启用此功能
        threshold - 作为附件发送二进制数据的大小（以字节为单位）。
        异常
        WebServiceException - 如果阈值为<0

    • 方法详细信息

      • getID

        public String getID​()
        获取此WebServiceFeature的唯一标识符。
        Specified by:
        getID在 WebServiceFeature
        结果
        该功能的唯一标识符。

      • getThreshold

        public int getThreshold​()
        获取用于确定二进制数据何时作为附件发送的阈值。
        结果
        当前阈值大小（以字节计）