Interface AccountingAnswer

  • All Superinterfaces:
    Cloneable, DiameterMessage

    public interface AccountingAnswer
    extends DiameterMessage
    Defines an interface representing the Accounting-Answer command. From the Diameter Base Protocol (rfc6733.txt) specification:
     9.7.2.  Accounting-Answer
     
        The Accounting-Answer (ACA) command, indicated by the Command Code
        field set to 271 and the Command Flags' 'R' bit cleared, is used to
        acknowledge an Accounting-Request command.  The Accounting-Answer
        command contains the same Session-Id as the corresponding request.
     
        Only the target Diameter server, known as the home Diameter server,
        SHOULD respond with the Accounting-Answer command.
     
        In addition to the AVPs listed below, Accounting-Answer messages
        SHOULD include service-specific accounting AVPs.
     
        Message Format
     
           <Accounting-Answer> ::= < Diameter Header: 271, PXY >
                     < Session-Id >
                     { Result-Code }
                     { Origin-Host }
                     { Origin-Realm }
                     { Accounting-Record-Type }
                     { Accounting-Record-Number }
                     [ Acct-Application-Id ]
                     [ Vendor-Specific-Application-Id ]
                     [ User-Name ]
                     [ Accounting-Sub-Session-Id ]
                     [ Accounting-Session-Id ]
                     [ Acct-Multi-Session-Id ]
                     [ Error-Message ]
                     [ Error-Reporting-Host ]
                     [ Failed-AVP ]
                     [ Acct-Interim-Interval ]
                     [ Accounting-Realtime-Required ]
                     [ Origin-State-Id ]
                     [ Event-Timestamp ]
                   * [ Proxy-Info ]
                   * [ AVP ]
     
     
    • Method Detail

      • hasSessionId

        boolean hasSessionId()
        Returns true if the Session-Id AVP is present in the message.
      • getSessionId

        String getSessionId()
        Returns the value of the Session-Id AVP, of type UTF8String.
        Specified by:
        getSessionId in interface DiameterMessage
        Returns:
        the value of the Session-Id AVP or null if it has not been set on this message
      • removeSessionId

        void removeSessionId()
        Removes the Session-Id AVP from the message. If the Session-Id AVP is not present, this method returns silently.
      • hasResultCode

        boolean hasResultCode()
        Returns true if the Result-Code AVP is present in the message.
      • getResultCode

        long getResultCode()
        Returns the value of the Result-Code AVP, of type Unsigned32. Use hasResultCode() to check the existence of this AVP.
        Returns:
        the value of the Result-Code AVP
        Throws:
        IllegalStateException - if the Result-Code AVP has not been set on this message
      • setResultCode

        void setResultCode​(long resultCode)
        Sets the value of the Result-Code AVP, of type Unsigned32.
      • removeResultCode

        void removeResultCode()
        Removes the Result-Code AVP from the message. If the Result-Code AVP is not present, this method returns silently.
      • hasOriginHost

        boolean hasOriginHost()
        Returns true if the Origin-Host AVP is present in the message.
      • getOriginHost

        DiameterIdentity getOriginHost()
        Returns the value of the Origin-Host AVP, of type DiameterIdentity.
        Specified by:
        getOriginHost in interface DiameterMessage
        Returns:
        the value of the Origin-Host AVP or null if it has not been set on this message
      • removeOriginHost

        void removeOriginHost()
        Removes the Origin-Host AVP from the message. If the Origin-Host AVP is not present, this method returns silently.
      • hasOriginRealm

        boolean hasOriginRealm()
        Returns true if the Origin-Realm AVP is present in the message.
      • getOriginRealm

        DiameterIdentity getOriginRealm()
        Returns the value of the Origin-Realm AVP, of type DiameterIdentity.
        Specified by:
        getOriginRealm in interface DiameterMessage
        Returns:
        the value of the Origin-Realm AVP or null if it has not been set on this message
      • removeOriginRealm

        void removeOriginRealm()
        Removes the Origin-Realm AVP from the message. If the Origin-Realm AVP is not present, this method returns silently.
      • hasAccountingRecordType

        boolean hasAccountingRecordType()
        Returns true if the Accounting-Record-Type AVP is present in the message.
      • getAccountingRecordType

        AccountingRecordType getAccountingRecordType()
        Returns the value of the Accounting-Record-Type AVP, of type Enumerated.
        Returns:
        the value of the Accounting-Record-Type AVP or null if it has not been set on this message
      • setAccountingRecordType

        void setAccountingRecordType​(AccountingRecordType accountingRecordType)
        Sets the value of the Accounting-Record-Type AVP, of type Enumerated.
        Throws:
        NullPointerException - if accountingRecordType is null.
      • removeAccountingRecordType

        void removeAccountingRecordType()
        Removes the Accounting-Record-Type AVP from the message. If the Accounting-Record-Type AVP is not present, this method returns silently.
      • hasAccountingRecordNumber

        boolean hasAccountingRecordNumber()
        Returns true if the Accounting-Record-Number AVP is present in the message.
      • getAccountingRecordNumber

        long getAccountingRecordNumber()
        Returns the value of the Accounting-Record-Number AVP, of type Unsigned32. Use hasAccountingRecordNumber() to check the existence of this AVP.
        Returns:
        the value of the Accounting-Record-Number AVP
        Throws:
        IllegalStateException - if the Accounting-Record-Number AVP has not been set on this message
      • setAccountingRecordNumber

        void setAccountingRecordNumber​(long accountingRecordNumber)
        Sets the value of the Accounting-Record-Number AVP, of type Unsigned32.
      • removeAccountingRecordNumber

        void removeAccountingRecordNumber()
        Removes the Accounting-Record-Number AVP from the message. If the Accounting-Record-Number AVP is not present, this method returns silently.
      • hasAcctApplicationId

        boolean hasAcctApplicationId()
        Returns true if the Acct-Application-Id AVP is present in the message.
      • getAcctApplicationId

        long getAcctApplicationId()
        Returns the value of the Acct-Application-Id AVP, of type Unsigned32. Use hasAcctApplicationId() to check the existence of this AVP.
        Returns:
        the value of the Acct-Application-Id AVP
        Throws:
        IllegalStateException - if the Acct-Application-Id AVP has not been set on this message
      • setAcctApplicationId

        void setAcctApplicationId​(long acctApplicationId)
        Sets the value of the Acct-Application-Id AVP, of type Unsigned32.
      • removeAcctApplicationId

        void removeAcctApplicationId()
        Removes the Acct-Application-Id AVP from the message. If the Acct-Application-Id AVP is not present, this method returns silently.
      • hasVendorSpecificApplicationId

        boolean hasVendorSpecificApplicationId()
        Returns true if the Vendor-Specific-Application-Id AVP is present in the message.
      • getVendorSpecificApplicationId

        VendorSpecificApplicationId getVendorSpecificApplicationId()
        Returns the value of the Vendor-Specific-Application-Id AVP, of type Grouped.
        Returns:
        the value of the Vendor-Specific-Application-Id AVP or null if it has not been set on this message
      • setVendorSpecificApplicationId

        void setVendorSpecificApplicationId​(VendorSpecificApplicationId vendorSpecificApplicationId)
        Sets the value of the Vendor-Specific-Application-Id AVP, of type Grouped.
        Throws:
        NullPointerException - if vendorSpecificApplicationId is null.
      • removeVendorSpecificApplicationId

        void removeVendorSpecificApplicationId()
        Removes the Vendor-Specific-Application-Id AVP from the message. If the Vendor-Specific-Application-Id AVP is not present, this method returns silently.
      • hasUserName

        boolean hasUserName()
        Returns true if the User-Name AVP is present in the message.
      • getUserName

        String getUserName()
        Returns the value of the User-Name AVP, of type UTF8String.
        Returns:
        the value of the User-Name AVP or null if it has not been set on this message
      • setUserName

        void setUserName​(String userName)
        Sets the value of the User-Name AVP, of type UTF8String.
        Throws:
        NullPointerException - if userName is null.
      • removeUserName

        void removeUserName()
        Removes the User-Name AVP from the message. If the User-Name AVP is not present, this method returns silently.
      • hasAccountingSubSessionId

        boolean hasAccountingSubSessionId()
        Returns true if the Accounting-Sub-Session-Id AVP is present in the message.
      • getAccountingSubSessionId

        long getAccountingSubSessionId()
        Returns the value of the Accounting-Sub-Session-Id AVP, of type Unsigned64. Use hasAccountingSubSessionId() to check the existence of this AVP.
        Returns:
        the value of the Accounting-Sub-Session-Id AVP
        Throws:
        IllegalStateException - if the Accounting-Sub-Session-Id AVP has not been set on this message
      • setAccountingSubSessionId

        void setAccountingSubSessionId​(long accountingSubSessionId)
        Sets the value of the Accounting-Sub-Session-Id AVP, of type Unsigned64.
      • removeAccountingSubSessionId

        void removeAccountingSubSessionId()
        Removes the Accounting-Sub-Session-Id AVP from the message. If the Accounting-Sub-Session-Id AVP is not present, this method returns silently.
      • hasAccountingSessionId

        boolean hasAccountingSessionId()
        Returns true if the Accounting-Session-Id AVP is present in the message.
      • getAccountingSessionId

        byte[] getAccountingSessionId()
        Returns the value of the Accounting-Session-Id AVP, of type OctetString.
        Returns:
        the value of the Accounting-Session-Id AVP or null if it has not been set on this message
      • setAccountingSessionId

        void setAccountingSessionId​(byte[] accountingSessionId)
        Sets the value of the Accounting-Session-Id AVP, of type OctetString.
        Throws:
        NullPointerException - if accountingSessionId is null.
      • removeAccountingSessionId

        void removeAccountingSessionId()
        Removes the Accounting-Session-Id AVP from the message. If the Accounting-Session-Id AVP is not present, this method returns silently.
      • hasAcctMultiSessionId

        boolean hasAcctMultiSessionId()
        Returns true if the Acct-Multi-Session-Id AVP is present in the message.
      • getAcctMultiSessionId

        String getAcctMultiSessionId()
        Returns the value of the Acct-Multi-Session-Id AVP, of type UTF8String.
        Returns:
        the value of the Acct-Multi-Session-Id AVP or null if it has not been set on this message
      • setAcctMultiSessionId

        void setAcctMultiSessionId​(String acctMultiSessionId)
        Sets the value of the Acct-Multi-Session-Id AVP, of type UTF8String.
        Throws:
        NullPointerException - if acctMultiSessionId is null.
      • removeAcctMultiSessionId

        void removeAcctMultiSessionId()
        Removes the Acct-Multi-Session-Id AVP from the message. If the Acct-Multi-Session-Id AVP is not present, this method returns silently.
      • hasErrorMessage

        boolean hasErrorMessage()
        Returns true if the Error-Message AVP is present in the message.
      • getErrorMessage

        String getErrorMessage()
        Returns the value of the Error-Message AVP, of type UTF8String.
        Returns:
        the value of the Error-Message AVP or null if it has not been set on this message
      • setErrorMessage

        void setErrorMessage​(String errorMessage)
        Sets the value of the Error-Message AVP, of type UTF8String.
        Throws:
        NullPointerException - if errorMessage is null.
      • removeErrorMessage

        void removeErrorMessage()
        Removes the Error-Message AVP from the message. If the Error-Message AVP is not present, this method returns silently.
      • hasErrorReportingHost

        boolean hasErrorReportingHost()
        Returns true if the Error-Reporting-Host AVP is present in the message.
      • getErrorReportingHost

        DiameterIdentity getErrorReportingHost()
        Returns the value of the Error-Reporting-Host AVP, of type DiameterIdentity.
        Returns:
        the value of the Error-Reporting-Host AVP or null if it has not been set on this message
      • setErrorReportingHost

        void setErrorReportingHost​(DiameterIdentity errorReportingHost)
        Sets the value of the Error-Reporting-Host AVP, of type DiameterIdentity.
        Throws:
        NullPointerException - if errorReportingHost is null.
      • removeErrorReportingHost

        void removeErrorReportingHost()
        Removes the Error-Reporting-Host AVP from the message. If the Error-Reporting-Host AVP is not present, this method returns silently.
      • hasFailedAvp

        boolean hasFailedAvp()
        Returns true if the Failed-AVP AVP is present in the message.
      • getFailedAvp

        FailedAvp getFailedAvp()
        Returns the value of the Failed-AVP AVP, of type Grouped.
        Returns:
        the value of the Failed-AVP AVP or null if it has not been set on this message
      • setFailedAvp

        void setFailedAvp​(FailedAvp failedAvp)
        Sets the value of the Failed-AVP AVP, of type Grouped.
        Throws:
        NullPointerException - if failedAvp is null.
      • removeFailedAvp

        void removeFailedAvp()
        Removes the Failed-AVP AVP from the message. If the Failed-AVP AVP is not present, this method returns silently.
      • hasAcctInterimInterval

        boolean hasAcctInterimInterval()
        Returns true if the Acct-Interim-Interval AVP is present in the message.
      • getAcctInterimInterval

        long getAcctInterimInterval()
        Returns the value of the Acct-Interim-Interval AVP, of type Unsigned32. Use hasAcctInterimInterval() to check the existence of this AVP.
        Returns:
        the value of the Acct-Interim-Interval AVP
        Throws:
        IllegalStateException - if the Acct-Interim-Interval AVP has not been set on this message
      • setAcctInterimInterval

        void setAcctInterimInterval​(long acctInterimInterval)
        Sets the value of the Acct-Interim-Interval AVP, of type Unsigned32.
      • removeAcctInterimInterval

        void removeAcctInterimInterval()
        Removes the Acct-Interim-Interval AVP from the message. If the Acct-Interim-Interval AVP is not present, this method returns silently.
      • hasAccountingRealtimeRequired

        boolean hasAccountingRealtimeRequired()
        Returns true if the Accounting-Realtime-Required AVP is present in the message.
      • getAccountingRealtimeRequired

        AccountingRealtimeRequired getAccountingRealtimeRequired()
        Returns the value of the Accounting-Realtime-Required AVP, of type Enumerated.
        Returns:
        the value of the Accounting-Realtime-Required AVP or null if it has not been set on this message
      • setAccountingRealtimeRequired

        void setAccountingRealtimeRequired​(AccountingRealtimeRequired accountingRealtimeRequired)
        Sets the value of the Accounting-Realtime-Required AVP, of type Enumerated.
        Throws:
        NullPointerException - if accountingRealtimeRequired is null.
      • removeAccountingRealtimeRequired

        void removeAccountingRealtimeRequired()
        Removes the Accounting-Realtime-Required AVP from the message. If the Accounting-Realtime-Required AVP is not present, this method returns silently.
      • hasOriginStateId

        boolean hasOriginStateId()
        Returns true if the Origin-State-Id AVP is present in the message.
      • getOriginStateId

        long getOriginStateId()
        Returns the value of the Origin-State-Id AVP, of type Unsigned32. Use hasOriginStateId() to check the existence of this AVP.
        Returns:
        the value of the Origin-State-Id AVP
        Throws:
        IllegalStateException - if the Origin-State-Id AVP has not been set on this message
      • setOriginStateId

        void setOriginStateId​(long originStateId)
        Sets the value of the Origin-State-Id AVP, of type Unsigned32.
      • removeOriginStateId

        void removeOriginStateId()
        Removes the Origin-State-Id AVP from the message. If the Origin-State-Id AVP is not present, this method returns silently.
      • hasEventTimestamp

        boolean hasEventTimestamp()
        Returns true if the Event-Timestamp AVP is present in the message.
      • getEventTimestamp

        Date getEventTimestamp()
        Returns the value of the Event-Timestamp AVP, of type Time.
        Returns:
        the value of the Event-Timestamp AVP or null if it has not been set on this message
      • setEventTimestamp

        void setEventTimestamp​(Date eventTimestamp)
        Sets the value of the Event-Timestamp AVP, of type Time.
        Throws:
        NullPointerException - if eventTimestamp is null.
      • removeEventTimestamp

        void removeEventTimestamp()
        Removes the Event-Timestamp AVP from the message. If the Event-Timestamp AVP is not present, this method returns silently.
      • getProxyInfos

        ProxyInfo[] getProxyInfos()
        Returns the set of Proxy-Info AVPs. The returned array contains the AVPs in the order they appear in the message. A return value of null implies that no Proxy-Info AVPs have been set. The elements in the given array are ProxyInfo objects.
      • setProxyInfo

        void setProxyInfo​(ProxyInfo proxyInfo)
        Sets a single Proxy-Info AVP in the message, of type Grouped.
        Throws:
        NullPointerException - if proxyInfo is null.
      • setProxyInfos

        void setProxyInfos​(ProxyInfo[] proxyInfos)
        Sets the set of Proxy-Info AVPs, with all the values in the given array. The AVPs will be added to message in the order in which they appear in the array. Note: the array must not be altered by the caller following this call, and getProxyInfos() is not guaranteed to return the same array instance, e.g. an "==" check would fail.
        Throws:
        NullPointerException - if proxyInfos is null.
      • removeProxyInfos

        void removeProxyInfos()
        Removes all Proxy-Info AVPs from the message. If no Proxy-Info AVPs are 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 message. 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 message 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 message. If no extension AVPs are present, this method returns silently.