|
JSIP API v1.2 November 2006 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface CallInfoHeader
The Call-Info header field provides additional information about the caller or callee, depending on whether it is found in a request or response. The purpose of the URI is described by the "purpose" parameter. The "icon" purpose designates an image suitable as an iconic representation of the caller or callee. The "info" purpose describes the caller or callee in general, for example, through a web page. The "card" purpose provides a business card, for example, in vCard or LDIF formats.
Use of the Call-Info header field can pose a security risk. If a callee fetches the URIs provided by a malicious caller, the callee may be at risk for displaying inappropriate or offensive content, dangerous or illegal content, and so on. Therefore, it is RECOMMENDED that a User Agent only render the information in the Call-Info header field if it can verify the authenticity of the element that originated the header field and trusts that element. This need not be the peer User Agent; a proxy can insert this header field into requests.
For Example:
Call-Info: http://jcp.org/duke/photo.jpg;
purpose=icon, http://jcp.org/duke/; purpose=info
Field Summary | |
---|---|
static java.lang.String |
NAME
Name of CallInfoHeader |
Method Summary | |
---|---|
URI |
getInfo()
Gets the URI that represents the location of the info of the caller or callee. |
java.lang.String |
getPurpose()
Gets the purpose of the information supplied in this CallInfoHeader. |
void |
setInfo(URI info)
Sets the Information parameter of this CallInfoHeader. |
void |
setPurpose(java.lang.String purpose)
Sets the purpose parameter of the info of this CallInfoHeader. |
Methods inherited from interface javax.sip.header.Parameters |
---|
getParameter, getParameterNames, removeParameter, setParameter |
Methods inherited from interface javax.sip.header.Header |
---|
clone, equals, getName, hashCode, toString |
Field Detail |
---|
static final java.lang.String NAME
Method Detail |
---|
void setInfo(URI info)
info
- the new URI value of the location of the information.URI getInfo()
void setPurpose(java.lang.String purpose) throws java.text.ParseException
purpose
- - the new string value of the purpose of this info.
java.text.ParseException
- which signals that an error has been reached
unexpectedly while parsing the purpose value.java.lang.String getPurpose()
|
JSIP API v1.2 November 2006 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |