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:
        getIDWebServiceFeature
        结果
        该功能的唯一标识符。
      • getThreshold

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