/*
* Copyright 2006-2010 Daniel Henninger. All rights reserved.
*
* This software is published under the terms of the GNU Public License (GPL),
* a copy of which is included in this distribution.
*/
package net.sf.kraken.protocols.oscar;
import net.kano.joscar.snaccmd.FullUserInfo;
import net.kano.joscar.snaccmd.conn.SetExtraInfoCmd;
import net.sf.kraken.BaseTransport;
import net.sf.kraken.registration.Registration;
import net.sf.kraken.session.TransportSession;
import net.sf.kraken.type.PresenceType;
import net.sf.kraken.type.TransportLoginStatus;
import net.sf.kraken.type.TransportType;
import org.jivesoftware.util.LocaleUtils;
import org.xmpp.packet.JID;
/**
* OSCAR Transport Interface.
*
* This handles the bulk of the XMPP work via BaseTransport and provides
* some gateway specific interactions.
*
* @author Daniel Henninger
*/
public class OSCARTransport extends BaseTransport<OSCARBuddy> {
/**
* @see net.sf.kraken.BaseTransport#getTerminologyUsername()
*/
@Override
public String getTerminologyUsername() {
return LocaleUtils.getLocalizedString("gateway."+getType().toString()+".username", "kraken");
}
/**
* @see net.sf.kraken.BaseTransport#getTerminologyPassword()
*/
@Override
public String getTerminologyPassword() {
return LocaleUtils.getLocalizedString("gateway."+getType().toString()+".password", "kraken");
}
/**
* @see net.sf.kraken.BaseTransport#getTerminologyNickname()
*/
@Override
public String getTerminologyNickname() {
return null;
}
/**
* @see net.sf.kraken.BaseTransport#getTerminologyRegistration()
*/
@Override
public String getTerminologyRegistration() {
return LocaleUtils.getLocalizedString("gateway."+getType().toString()+".registration", "kraken");
}
/**
* @see net.sf.kraken.BaseTransport#isPasswordRequired()
*/
@Override
public Boolean isPasswordRequired() { return true; }
/**
* @see net.sf.kraken.BaseTransport#isNicknameRequired()
*/
@Override
public Boolean isNicknameRequired() { return false; }
/**
* @see net.sf.kraken.BaseTransport#isUsernameValid(String)
*/
@Override
public Boolean isUsernameValid(String username) {
if (getType() == TransportType.icq) {
return username.matches("\\d+");
}
else {
// Any e-mail address will do. Don't bother to check. See
// http://www.regular-expressions.info/email.html
return username.trim().length() > 0;
}
}
/**
* Handles creating an OSCAR session and triggering a login.
*
* @param registration Registration information to be used to log in.
* @param jid JID that is logged into the transport.
* @param presenceType Type of presence.
* @param verboseStatus Longer status description.
*/
@Override
public TransportSession<OSCARBuddy> registrationLoggedIn(Registration registration, JID jid, PresenceType presenceType, String verboseStatus, Integer priority) {
TransportSession<OSCARBuddy> session = new OSCARSession(registration, jid, this, priority);
session.setLoginStatus(TransportLoginStatus.LOGGING_IN);
session.logIn(presenceType, verboseStatus);
return session;
}
/**
* Handles logging out of a Yahoo session.
*
* @param session The session to be disconnected.
*/
@Override
public void registrationLoggedOut(TransportSession<OSCARBuddy> session) {
session.setLoginStatus(TransportLoginStatus.LOGGING_OUT);
session.logOut();
}
/**
* Converts an XMPP status to an ICQ status.
*
* @param xmppStatus XMPP presence type.
* @return ICQ user status.
*/
public long convertXMPPStatusToICQ(PresenceType xmppStatus) {
if (xmppStatus == PresenceType.available) {
return FullUserInfo.ICQSTATUS_DEFAULT;
}
else if (xmppStatus == PresenceType.away) {
return FullUserInfo.ICQSTATUS_AWAY;
}
else if (xmppStatus == PresenceType.xa) {
return FullUserInfo.ICQSTATUS_NA;
}
else if (xmppStatus == PresenceType.dnd) {
return FullUserInfo.ICQSTATUS_DND;
}
else if (xmppStatus == PresenceType.chat) {
return FullUserInfo.ICQSTATUS_FFC;
}
else if (xmppStatus == PresenceType.unavailable) {
return SetExtraInfoCmd.ICQSTATUS_NONE;
}
else {
return FullUserInfo.ICQSTATUS_DEFAULT;
}
}
/**
* Converts an ICQ status to an XMPP status.
*
* @param icqStatus ICQ status constant.
* @return XMPP status.
*/
public PresenceType convertICQStatusToXMPP(long icqStatus) {
if (icqStatus == FullUserInfo.ICQSTATUS_DEFAULT) {
return PresenceType.available;
}
else if (icqStatus == FullUserInfo.ICQSTATUS_AWAY) {
return PresenceType.away;
}
else if (icqStatus == FullUserInfo.ICQSTATUS_DND) {
return PresenceType.dnd;
}
else if (icqStatus == FullUserInfo.ICQSTATUS_FFC) {
return PresenceType.chat;
}
else if (icqStatus == FullUserInfo.ICQSTATUS_INVISIBLE) {
return PresenceType.available;
}
else if (icqStatus == FullUserInfo.ICQSTATUS_NA) {
return PresenceType.xa;
}
else if (icqStatus == FullUserInfo.ICQSTATUS_OCCUPIED) {
return PresenceType.dnd;
}
else {
return PresenceType.unknown;
}
}
}