/**
* Copyright 2005-2011 Noelios Technologies.
*
* The contents of this file are subject to the terms of one of the following
* open source licenses: LGPL 3.0 or LGPL 2.1 or CDDL 1.0 or EPL 1.0 (the
* "Licenses"). You can select the license that you prefer but you may not use
* this file except in compliance with one of these Licenses.
*
* You can obtain a copy of the LGPL 3.0 license at
* http://www.opensource.org/licenses/lgpl-3.0.html
*
* You can obtain a copy of the LGPL 2.1 license at
* http://www.opensource.org/licenses/lgpl-2.1.php
*
* You can obtain a copy of the CDDL 1.0 license at
* http://www.opensource.org/licenses/cddl1.php
*
* You can obtain a copy of the EPL 1.0 license at
* http://www.opensource.org/licenses/eclipse-1.0.php
*
* See the Licenses for the specific language governing permissions and
* limitations under the Licenses.
*
* Alternatively, you can obtain a royalty free commercial license with less
* limitations, transferable or non-transferable, directly at
* http://www.noelios.com/products/restlet-engine
*
* Restlet is a registered trademark of Noelios Technologies.
*/
package org.restlet.ext.sip.internal;
import static org.restlet.engine.header.HeaderUtils.isComma;
import static org.restlet.engine.header.HeaderUtils.isLinearWhiteSpace;
import static org.restlet.engine.header.HeaderUtils.isSemiColon;
import java.io.IOException;
import org.restlet.data.Parameter;
import org.restlet.data.Reference;
import org.restlet.engine.header.HeaderReader;
import org.restlet.engine.header.HeaderUtils;
import org.restlet.engine.header.PreferenceReader;
import org.restlet.ext.sip.Address;
import org.restlet.ext.sip.ContactInfo;
/**
* Contact header reader.
*
* @author Thierry Boileau
*/
public class ContactInfoReader extends HeaderReader<ContactInfo> {
/**
* Constructor.
*
* @param header
* The header to read.
*/
public ContactInfoReader(String header) {
super(header);
}
/**
* Handle a given parameters. By default, it simply adds the parameter to
* the address's parameter list.
*
* @param address
* The address object to update.
* @param param
* The parameter.
*/
public void addParameter(Address address, Parameter param) {
address.getParameters().add(param);
}
/**
* Reads the next reference. The first character must be a '<'.
*
* @return The next reference.
* @throws IOException
*/
private String readReference() throws IOException {
String result = null;
int next = read();
// First character must be a "<"
if (next == '<') {
StringBuilder buffer = new StringBuilder();
while (result == null) {
next = read();
if (next == '>') {
// End of URL
result = buffer.toString();
} else if (next == -1) {
throw new IOException(
"Unexpected end of reference. Please check your value");
} else {
buffer.append((char) next);
}
}
} else {
throw new IOException("A reference must start with a '<' character");
}
return result;
}
@Override
public ContactInfo readValue() throws IOException {
ContactInfo result = null;
skipSpaces();
if (peek() != -1) {
result = new ContactInfo();
if (peek() == '"') {
result.setDisplayName(readQuotedString());
skipSpaces();
result.setReference(new Reference(readReference()));
} else if (peek() == '<') {
result.setReference(new Reference(readReference()));
} else if (HeaderUtils.isTokenChar(peek())) {
// Read value until end or value or parameter separator
StringBuilder sb = null;
int next = read();
while ((next != -1) && !isComma(next) && !isSemiColon(next)) {
if (sb == null) {
sb = new StringBuilder();
}
sb.append((char) next);
next = read();
}
// Remove trailing spaces
if (sb != null) {
for (int i = sb.length() - 1; (i >= 0)
&& isLinearWhiteSpace(sb.charAt(i)); i--) {
sb.deleteCharAt(i);
}
}
// Unread the separator
if (isComma(next) || isSemiColon(next)) {
unread();
}
// The last token is the reference
int index = sb.lastIndexOf(" ");
if (index != -1) {
if (sb.charAt(index + 1) == '<') {
if (sb.charAt(sb.length() - 1) == '>') {
result.setReference(new Reference(sb.substring(
index + 2, sb.length() - 1)));
} else {
throw new IOException(
"Unexpected end of reference. Please check your value");
}
}
result.setDisplayName(sb.substring(0, index).trim());
} else {
result.setReference(new Reference(sb.toString()));
}
}
}
// Read address parameters.
if (skipParameterSeparator()) {
Parameter param = readParameter();
while (param != null) {
if ("q".equals(param.getName())) {
result.setQuality(PreferenceReader.readQuality(param
.getValue()));
} else if ("expires".equals(param.getName())) {
result.setExpires(param.getValue());
} else {
addParameter(result, param);
}
if (skipParameterSeparator()) {
param = readParameter();
} else {
param = null;
}
}
}
return result;
}
}