Interface SessionTerminationRequest
-
- All Superinterfaces:
Cloneable
,DiameterMessage
public interface SessionTerminationRequest extends DiameterMessage
Defines an interface representing the Session-Termination-Request command. From the Diameter Base Protocol (rfc6733.txt) specification:8.4.1. Session-Termination-Request The Session-Termination-Request (STR), indicated by the Command Code set to 275 and the Command Flags' 'R' bit set, is sent by a Diameter client or by a Diameter proxy to inform the Diameter server that an authenticated and/or authorized session is being terminated. Message Format <Session-Termination-Request> ::= < Diameter Header: 275, REQ, PXY > < Session-Id > { Origin-Host } { Origin-Realm } { Destination-Realm } { Auth-Application-Id } { Termination-Cause } [ User-Name ] [ Destination-Host ] * [ Class ] [ Origin-State-Id ] * [ Proxy-Info ] * [ Route-Record ] * [ AVP ]
-
-
Field Summary
Fields Modifier and Type Field Description static int
commandCode
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description long
getAuthApplicationId()
Returns the value of the Auth-Application-Id AVP, of type Unsigned32.byte[][]
getClassAvps()
Returns the set of Class AVPs.DiameterIdentity
getDestinationHost()
Returns the value of the Destination-Host AVP, of type DiameterIdentity.DiameterIdentity
getDestinationRealm()
Returns the value of the Destination-Realm AVP, of type DiameterIdentity.DiameterAvp[]
getExtensionAvps()
Returns the set of extension AVPs.DiameterIdentity
getOriginHost()
Returns the value of the Origin-Host AVP, of type DiameterIdentity.DiameterIdentity
getOriginRealm()
Returns the value of the Origin-Realm AVP, of type DiameterIdentity.long
getOriginStateId()
Returns the value of the Origin-State-Id AVP, of type Unsigned32.ProxyInfo[]
getProxyInfos()
Returns the set of Proxy-Info AVPs.DiameterIdentity[]
getRouteRecords()
Returns the set of Route-Record AVPs.String
getSessionId()
Returns the value of the Session-Id AVP, of type UTF8String.TerminationCause
getTerminationCause()
Returns the value of the Termination-Cause AVP, of type Enumerated.String
getUserName()
Returns the value of the User-Name AVP, of type UTF8String.boolean
hasAuthApplicationId()
Returns true if the Auth-Application-Id AVP is present in the message.boolean
hasDestinationHost()
Returns true if the Destination-Host AVP is present in the message.boolean
hasDestinationRealm()
Returns true if the Destination-Realm AVP is present in the message.boolean
hasOriginHost()
Returns true if the Origin-Host AVP is present in the message.boolean
hasOriginRealm()
Returns true if the Origin-Realm AVP is present in the message.boolean
hasOriginStateId()
Returns true if the Origin-State-Id AVP is present in the message.boolean
hasSessionId()
Returns true if the Session-Id AVP is present in the message.boolean
hasTerminationCause()
Returns true if the Termination-Cause AVP is present in the message.boolean
hasUserName()
Returns true if the User-Name AVP is present in the message.void
removeAuthApplicationId()
Removes the Auth-Application-Id AVP from the message.void
removeClassAvps()
Removes all Class AVPs from the message.void
removeDestinationHost()
Removes the Destination-Host AVP from the message.void
removeDestinationRealm()
Removes the Destination-Realm AVP from the message.void
removeExtensionAvps()
Removes all extension AVPs from the message.void
removeOriginHost()
Removes the Origin-Host AVP from the message.void
removeOriginRealm()
Removes the Origin-Realm AVP from the message.void
removeOriginStateId()
Removes the Origin-State-Id AVP from the message.void
removeProxyInfos()
Removes all Proxy-Info AVPs from the message.void
removeRouteRecords()
Removes all Route-Record AVPs from the message.void
removeSessionId()
Removes the Session-Id AVP from the message.void
removeTerminationCause()
Removes the Termination-Cause AVP from the message.void
removeUserName()
Removes the User-Name AVP from the message.void
setAuthApplicationId(long authApplicationId)
Sets the value of the Auth-Application-Id AVP, of type Unsigned32.void
setClassAvp(byte[] classAvp)
Sets a single Class AVP in the message, of type OctetString.void
setClassAvps(byte[][] classAvps)
Sets the set of Class AVPs, with all the values in the given array.void
setDestinationHost(DiameterIdentity destinationHost)
Sets the value of the Destination-Host AVP, of type DiameterIdentity.void
setDestinationRealm(DiameterIdentity destinationRealm)
Sets the value of the Destination-Realm AVP, of type DiameterIdentity.void
setExtensionAvps(DiameterAvp[] avps)
Sets the set of extension AVPs with all the values in the given array.void
setOriginHost(DiameterIdentity originHost)
Sets the value of the Origin-Host AVP, of type DiameterIdentity.void
setOriginRealm(DiameterIdentity originRealm)
Sets the value of the Origin-Realm AVP, of type DiameterIdentity.void
setOriginStateId(long originStateId)
Sets the value of the Origin-State-Id AVP, of type Unsigned32.void
setProxyInfo(ProxyInfo proxyInfo)
Sets a single Proxy-Info AVP in the message, of type Grouped.void
setProxyInfos(ProxyInfo[] proxyInfos)
Sets the set of Proxy-Info AVPs, with all the values in the given array.void
setRouteRecord(DiameterIdentity routeRecord)
Sets a single Route-Record AVP in the message, of type DiameterIdentity.void
setRouteRecords(DiameterIdentity[] routeRecords)
Sets the set of Route-Record AVPs, with all the values in the given array.void
setSessionId(String sessionId)
Sets the value of the Session-Id AVP, of type UTF8String.void
setTerminationCause(TerminationCause terminationCause)
Sets the value of the Termination-Cause AVP, of type Enumerated.void
setUserName(String userName)
Sets the value of the User-Name AVP, of type UTF8String.-
Methods inherited from interface org.jainslee.resources.diameter.base.DiameterMessage
clone, getAvps, getCommand, getHeader
-
-
-
-
Field Detail
-
commandCode
static final int commandCode
- See Also:
- Constant Field Values
-
-
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 interfaceDiameterMessage
- Returns:
- the value of the Session-Id AVP or null if it has not been set on this message
-
setSessionId
void setSessionId(String sessionId)
Sets the value of the Session-Id AVP, of type UTF8String.- Specified by:
setSessionId
in interfaceDiameterMessage
- Throws:
NullPointerException
- ifsessionId
isnull
.
-
removeSessionId
void removeSessionId()
Removes the Session-Id AVP from the message. If the Session-Id 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 interfaceDiameterMessage
- Returns:
- the value of the Origin-Host AVP or null if it has not been set on this message
-
setOriginHost
void setOriginHost(DiameterIdentity originHost)
Sets the value of the Origin-Host AVP, of type DiameterIdentity.- Specified by:
setOriginHost
in interfaceDiameterMessage
- Throws:
NullPointerException
- iforiginHost
isnull
.
-
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 interfaceDiameterMessage
- Returns:
- the value of the Origin-Realm AVP or null if it has not been set on this message
-
setOriginRealm
void setOriginRealm(DiameterIdentity originRealm)
Sets the value of the Origin-Realm AVP, of type DiameterIdentity.- Specified by:
setOriginRealm
in interfaceDiameterMessage
- Throws:
NullPointerException
- iforiginRealm
isnull
.
-
removeOriginRealm
void removeOriginRealm()
Removes the Origin-Realm AVP from the message. If the Origin-Realm AVP is not present, this method returns silently.
-
hasDestinationRealm
boolean hasDestinationRealm()
Returns true if the Destination-Realm AVP is present in the message.
-
getDestinationRealm
DiameterIdentity getDestinationRealm()
Returns the value of the Destination-Realm AVP, of type DiameterIdentity.- Specified by:
getDestinationRealm
in interfaceDiameterMessage
- Returns:
- the value of the Destination-Realm AVP or null if it has not been set on this message
-
setDestinationRealm
void setDestinationRealm(DiameterIdentity destinationRealm)
Sets the value of the Destination-Realm AVP, of type DiameterIdentity.- Specified by:
setDestinationRealm
in interfaceDiameterMessage
- Throws:
NullPointerException
- ifdestinationRealm
isnull
.
-
removeDestinationRealm
void removeDestinationRealm()
Removes the Destination-Realm AVP from the message. If the Destination-Realm AVP is not present, this method returns silently.
-
hasAuthApplicationId
boolean hasAuthApplicationId()
Returns true if the Auth-Application-Id AVP is present in the message.
-
getAuthApplicationId
long getAuthApplicationId()
Returns the value of the Auth-Application-Id AVP, of type Unsigned32. UsehasAuthApplicationId()
to check the existence of this AVP.- Returns:
- the value of the Auth-Application-Id AVP
- Throws:
IllegalStateException
- if the Auth-Application-Id AVP has not been set on this message
-
setAuthApplicationId
void setAuthApplicationId(long authApplicationId)
Sets the value of the Auth-Application-Id AVP, of type Unsigned32.
-
removeAuthApplicationId
void removeAuthApplicationId()
Removes the Auth-Application-Id AVP from the message. If the Auth-Application-Id AVP is not present, this method returns silently.
-
hasTerminationCause
boolean hasTerminationCause()
Returns true if the Termination-Cause AVP is present in the message.
-
getTerminationCause
TerminationCause getTerminationCause()
Returns the value of the Termination-Cause AVP, of type Enumerated.- Returns:
- the value of the Termination-Cause AVP or null if it has not been set on this message
-
setTerminationCause
void setTerminationCause(TerminationCause terminationCause)
Sets the value of the Termination-Cause AVP, of type Enumerated.- Throws:
NullPointerException
- ifterminationCause
isnull
.
-
removeTerminationCause
void removeTerminationCause()
Removes the Termination-Cause AVP from the message. If the Termination-Cause 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
- ifuserName
isnull
.
-
removeUserName
void removeUserName()
Removes the User-Name AVP from the message. If the User-Name AVP is not present, this method returns silently.
-
hasDestinationHost
boolean hasDestinationHost()
Returns true if the Destination-Host AVP is present in the message.
-
getDestinationHost
DiameterIdentity getDestinationHost()
Returns the value of the Destination-Host AVP, of type DiameterIdentity.- Specified by:
getDestinationHost
in interfaceDiameterMessage
- Returns:
- the value of the Destination-Host AVP or null if it has not been set on this message
-
setDestinationHost
void setDestinationHost(DiameterIdentity destinationHost)
Sets the value of the Destination-Host AVP, of type DiameterIdentity.- Specified by:
setDestinationHost
in interfaceDiameterMessage
- Throws:
NullPointerException
- ifdestinationHost
isnull
.
-
removeDestinationHost
void removeDestinationHost()
Removes the Destination-Host AVP from the message. If the Destination-Host AVP is not present, this method returns silently.
-
getClassAvps
byte[][] getClassAvps()
Returns the set of Class AVPs. The returned array contains the AVPs in the order they appear in the message. A return value of null implies that no Class AVPs have been set. The elements in the given array are byte[] objects.
-
setClassAvp
void setClassAvp(byte[] classAvp)
Sets a single Class AVP in the message, of type OctetString.- Throws:
NullPointerException
- ifclassAvp
isnull
.
-
setClassAvps
void setClassAvps(byte[][] classAvps)
Sets the set of Class 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 getClassAvps() is not guaranteed to return the same array instance, e.g. an "==" check would fail.- Throws:
NullPointerException
- ifclassAvps
isnull
.
-
removeClassAvps
void removeClassAvps()
Removes all Class AVPs from the message. If no Class AVPs are 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. UsehasOriginStateId()
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.
-
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
- ifproxyInfo
isnull
.
-
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
- ifproxyInfos
isnull
.
-
removeProxyInfos
void removeProxyInfos()
Removes all Proxy-Info AVPs from the message. If no Proxy-Info AVPs are present, this method returns silently.
-
getRouteRecords
DiameterIdentity[] getRouteRecords()
Returns the set of Route-Record AVPs. The returned array contains the AVPs in the order they appear in the message. A return value of null implies that no Route-Record AVPs have been set. The elements in the given array are DiameterIdentity objects.
-
setRouteRecord
void setRouteRecord(DiameterIdentity routeRecord)
Sets a single Route-Record AVP in the message, of type DiameterIdentity.- Throws:
NullPointerException
- ifrouteRecord
isnull
.
-
setRouteRecords
void setRouteRecords(DiameterIdentity[] routeRecords)
Sets the set of Route-Record 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 getRouteRecords() is not guaranteed to return the same array instance, e.g. an "==" check would fail.- Throws:
NullPointerException
- ifrouteRecords
isnull
.
-
removeRouteRecords
void removeRouteRecords()
Removes all Route-Record AVPs from the message. If no Route-Record 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
- ifavps
isnull
.
-
removeExtensionAvps
void removeExtensionAvps()
Removes all extension AVPs from the message. If no extension AVPs are present, this method returns silently.
-
-