Interface QosInformation

  • All Superinterfaces:
    Cloneable, DiameterAvp, GroupedAvp

    public interface QosInformation
    extends GroupedAvp
    Defines an interface representing the QoS-Information grouped AVP type. From the Diameter Rf Reference Point Protocol Details (3GPP TS 32.299 V10.0.0) specification:
     5.3.16  QoS-Information AVP (All access types)
     The QoS-Information AVP (AVP code 1016) is of type Grouped, and it defines the QoS information for resources requested by the UE, an IP-CAN bearer, PCC rule, QCI or APN. When this AVP is sent from the PCEF to the PCRF, it indicates the requested QoS information associated with resources requested by the UE, an IP CAN bearer or the subscribed QoS information at APN level. When this AVP is sent from the PCRF to the PCEF, it indicates the authorized QoS for:
     -   an IP CAN bearer (when appearing at CCA or RAR command level or 
     -   a service flow (when included within the PCC rule) or 
     -   a QCI (when appearing at CCA or RAR command level with the QoS-Class-Identifier AVP and the Maximum-Requested-Bandwidth-UL AVP and/or the Maximum-Requested-Bandwidth-DL AVP) or
     -   an APN (when appearing at CCA or RAR command level with APN-Aggregate-Max-Bitrate-DL and APN-Aggregate-Max-Bitrate-DL).
     The QoS class identifier identifies a set of IP-CAN specific QoS parameters that define QoS, excluding the applicable bitrates and ARP. It is applicable both for uplink and downlink direction.
     
             QoS-Information ::= < AVP Header: 1016 >
                                 [ QoS-Class-Identifier ]
                                 [ Max-Requested-Bandwidth-UL ]
                                 [ Max-Requested-Bandwidth-DL ]                            
                                 [ Guaranteed-Bitrate-UL ]
                                 [ Guaranteed-Bitrate-DL ]
                                 [ Bearer-Identifier ]
                                 [ Allocation-Retention-Priority]
                                 [ APN-Aggregate-Max-Bitrate-UL]
                                 [ APN-Aggregate-Max-Bitrate-DL]
                               * [AVP]
     
    • Method Detail

      • hasQosClassIdentifier

        boolean hasQosClassIdentifier()
        Returns true if the QoS-Class-Identifier AVP is present in the QoS-Information AVP.
      • getQosClassIdentifier

        QosClassIdentifier getQosClassIdentifier()
        Returns the value of the QoS-Class-Identifier AVP, of type Enumerated.
        Returns:
        the value of the QoS-Class-Identifier AVP, or null if it has not been set.
      • setQosClassIdentifier

        void setQosClassIdentifier​(QosClassIdentifier qosClassIdentifier)
        Sets the value of the QoS-Class-Identifier AVP, of type Enumerated.
        Throws:
        NullPointerException - if qosClassIdentifier is null.
      • removeQosClassIdentifier

        void removeQosClassIdentifier()
        Removes the QoS-Class-Identifier AVP from the QoS-Information AVP. If the QoS-Class-Identifier AVP is not present, this method returns silently.
      • hasMaxRequestedBandwidthUl

        boolean hasMaxRequestedBandwidthUl()
        Returns true if the Max-Requested-Bandwidth-UL AVP is present in the QoS-Information AVP.
      • getMaxRequestedBandwidthUl

        long getMaxRequestedBandwidthUl()
        Returns the value of the Max-Requested-Bandwidth-UL AVP, of type Unsigned32. Use hasMaxRequestedBandwidthUl() to check the existence of this AVP.
        Returns:
        the value of the Max-Requested-Bandwidth-UL AVP
        Throws:
        IllegalStateException - if the Max-Requested-Bandwidth-UL AVP has not been set.
      • setMaxRequestedBandwidthUl

        void setMaxRequestedBandwidthUl​(long maxRequestedBandwidthUl)
        Sets the value of the Max-Requested-Bandwidth-UL AVP, of type Unsigned32.
      • removeMaxRequestedBandwidthUl

        void removeMaxRequestedBandwidthUl()
        Removes the Max-Requested-Bandwidth-UL AVP from the QoS-Information AVP. If the Max-Requested-Bandwidth-UL AVP is not present, this method returns silently.
      • hasMaxRequestedBandwidthDl

        boolean hasMaxRequestedBandwidthDl()
        Returns true if the Max-Requested-Bandwidth-DL AVP is present in the QoS-Information AVP.
      • getMaxRequestedBandwidthDl

        long getMaxRequestedBandwidthDl()
        Returns the value of the Max-Requested-Bandwidth-DL AVP, of type Unsigned32. Use hasMaxRequestedBandwidthDl() to check the existence of this AVP.
        Returns:
        the value of the Max-Requested-Bandwidth-DL AVP
        Throws:
        IllegalStateException - if the Max-Requested-Bandwidth-DL AVP has not been set.
      • setMaxRequestedBandwidthDl

        void setMaxRequestedBandwidthDl​(long maxRequestedBandwidthDl)
        Sets the value of the Max-Requested-Bandwidth-DL AVP, of type Unsigned32.
      • removeMaxRequestedBandwidthDl

        void removeMaxRequestedBandwidthDl()
        Removes the Max-Requested-Bandwidth-DL AVP from the QoS-Information AVP. If the Max-Requested-Bandwidth-DL AVP is not present, this method returns silently.
      • hasGuaranteedBitrateUl

        boolean hasGuaranteedBitrateUl()
        Returns true if the Guaranteed-Bitrate-UL AVP is present in the QoS-Information AVP.
      • getGuaranteedBitrateUl

        long getGuaranteedBitrateUl()
        Returns the value of the Guaranteed-Bitrate-UL AVP, of type Unsigned32. Use hasGuaranteedBitrateUl() to check the existence of this AVP.
        Returns:
        the value of the Guaranteed-Bitrate-UL AVP
        Throws:
        IllegalStateException - if the Guaranteed-Bitrate-UL AVP has not been set.
      • setGuaranteedBitrateUl

        void setGuaranteedBitrateUl​(long guaranteedBitrateUl)
        Sets the value of the Guaranteed-Bitrate-UL AVP, of type Unsigned32.
      • removeGuaranteedBitrateUl

        void removeGuaranteedBitrateUl()
        Removes the Guaranteed-Bitrate-UL AVP from the QoS-Information AVP. If the Guaranteed-Bitrate-UL AVP is not present, this method returns silently.
      • hasGuaranteedBitrateDl

        boolean hasGuaranteedBitrateDl()
        Returns true if the Guaranteed-Bitrate-DL AVP is present in the QoS-Information AVP.
      • getGuaranteedBitrateDl

        long getGuaranteedBitrateDl()
        Returns the value of the Guaranteed-Bitrate-DL AVP, of type Unsigned32. Use hasGuaranteedBitrateDl() to check the existence of this AVP.
        Returns:
        the value of the Guaranteed-Bitrate-DL AVP
        Throws:
        IllegalStateException - if the Guaranteed-Bitrate-DL AVP has not been set.
      • setGuaranteedBitrateDl

        void setGuaranteedBitrateDl​(long guaranteedBitrateDl)
        Sets the value of the Guaranteed-Bitrate-DL AVP, of type Unsigned32.
      • removeGuaranteedBitrateDl

        void removeGuaranteedBitrateDl()
        Removes the Guaranteed-Bitrate-DL AVP from the QoS-Information AVP. If the Guaranteed-Bitrate-DL AVP is not present, this method returns silently.
      • hasBearerIdentifier

        boolean hasBearerIdentifier()
        Returns true if the Bearer-Identifier AVP is present in the QoS-Information AVP.
      • getBearerIdentifier

        byte[] getBearerIdentifier()
        Returns the value of the Bearer-Identifier AVP, of type OctetString.
        Returns:
        the value of the Bearer-Identifier AVP, or null if it has not been set.
      • setBearerIdentifier

        void setBearerIdentifier​(byte[] bearerIdentifier)
        Sets the value of the Bearer-Identifier AVP, of type OctetString.
        Throws:
        NullPointerException - if bearerIdentifier is null.
      • removeBearerIdentifier

        void removeBearerIdentifier()
        Removes the Bearer-Identifier AVP from the QoS-Information AVP. If the Bearer-Identifier AVP is not present, this method returns silently.
      • hasAllocationRetentionPriority

        boolean hasAllocationRetentionPriority()
        Returns true if the Allocation-Retention-Priority AVP is present in the QoS-Information AVP.
      • getAllocationRetentionPriority

        AllocationRetentionPriority getAllocationRetentionPriority()
        Returns the value of the Allocation-Retention-Priority AVP, of type Grouped.
        Returns:
        the value of the Allocation-Retention-Priority AVP, or null if it has not been set.
      • setAllocationRetentionPriority

        void setAllocationRetentionPriority​(AllocationRetentionPriority allocationRetentionPriority)
        Sets the value of the Allocation-Retention-Priority AVP, of type Grouped.
        Throws:
        NullPointerException - if allocationRetentionPriority is null.
      • removeAllocationRetentionPriority

        void removeAllocationRetentionPriority()
        Removes the Allocation-Retention-Priority AVP from the QoS-Information AVP. If the Allocation-Retention-Priority AVP is not present, this method returns silently.
      • hasApnAggregateMaxBitrateUl

        boolean hasApnAggregateMaxBitrateUl()
        Returns true if the APN-Aggregate-Max-Bitrate-UL AVP is present in the QoS-Information AVP.
      • getApnAggregateMaxBitrateUl

        long getApnAggregateMaxBitrateUl()
        Returns the value of the APN-Aggregate-Max-Bitrate-UL AVP, of type Unsigned32. Use hasApnAggregateMaxBitrateUl() to check the existence of this AVP.
        Returns:
        the value of the APN-Aggregate-Max-Bitrate-UL AVP
        Throws:
        IllegalStateException - if the APN-Aggregate-Max-Bitrate-UL AVP has not been set.
      • setApnAggregateMaxBitrateUl

        void setApnAggregateMaxBitrateUl​(long apnAggregateMaxBitrateUl)
        Sets the value of the APN-Aggregate-Max-Bitrate-UL AVP, of type Unsigned32.
      • removeApnAggregateMaxBitrateUl

        void removeApnAggregateMaxBitrateUl()
        Removes the APN-Aggregate-Max-Bitrate-UL AVP from the QoS-Information AVP. If the APN-Aggregate-Max-Bitrate-UL AVP is not present, this method returns silently.
      • hasApnAggregateMaxBitrateDl

        boolean hasApnAggregateMaxBitrateDl()
        Returns true if the APN-Aggregate-Max-Bitrate-DL AVP is present in the QoS-Information AVP.
      • getApnAggregateMaxBitrateDl

        long getApnAggregateMaxBitrateDl()
        Returns the value of the APN-Aggregate-Max-Bitrate-DL AVP, of type Unsigned32. Use hasApnAggregateMaxBitrateDl() to check the existence of this AVP.
        Returns:
        the value of the APN-Aggregate-Max-Bitrate-DL AVP
        Throws:
        IllegalStateException - if the APN-Aggregate-Max-Bitrate-DL AVP has not been set.
      • setApnAggregateMaxBitrateDl

        void setApnAggregateMaxBitrateDl​(long apnAggregateMaxBitrateDl)
        Sets the value of the APN-Aggregate-Max-Bitrate-DL AVP, of type Unsigned32.
      • removeApnAggregateMaxBitrateDl

        void removeApnAggregateMaxBitrateDl()
        Removes the APN-Aggregate-Max-Bitrate-DL AVP from the QoS-Information AVP. If the APN-Aggregate-Max-Bitrate-DL AVP is not present, this method returns silently.
      • getExtensionAvps

        DiameterAvp[] getExtensionAvps()
        Returns the set of extension AVPs. The returned array contains the extension AVPs in the order they appear in the QoS-Information AVP. A return value of null implies that no extensions AVPs have been set.
      • setExtensionAvps

        void setExtensionAvps​(DiameterAvp[] avps)
                       throws AvpNotAllowedException
        Sets the set of extension AVPs with all the values in the given array. The AVPs will be added to QoS-Information AVP in the order in which they appear in the array. Note: the array must not be altered by the caller following this call, and getExtensionAvps() is not guaranteed to return the same array instance, e.g. an "==" check would fail.
        Throws:
        AvpNotAllowedException - if an AVP is encountered of a type already known to this class (i.e. an AVP for which get/set methods already appear in this class)
        NullPointerException - if avps is null.
      • removeExtensionAvps

        void removeExtensionAvps()
        Removes all extension AVPs from the QoS-Information AVP. If no extension AVPs are present, this method returns silently.