/**
* Constructor.
*
* @param session Session object for this service
* @param urlname URLName object to be used for this service
*/
protected Service(Session session, URLName urlname) {
this.session = session;
debug = session.getDebug();
url = urlname;
/*
* Initialize the URLName with default values.
* The URLName will be updated when connect is called.
*/
String protocol = null;
String host = null;
int port = -1;
String user = null;
String password = null;
String file = null;
// get whatever information we can from the URL
// XXX - url should always be non-null here, Session
// passes it into the constructor
if (url != null) {
protocol = url.getProtocol();
host = url.getHost();
port = url.getPort();
user = url.getUsername();
password = url.getPassword();
file = url.getFile();
}
// try to get protocol-specific default properties
if (protocol != null) {
if (host == null) host = session.getProperty("mail." + protocol + ".host");
if (user == null) user = session.getProperty("mail." + protocol + ".user");
}
// try to get mail-wide default properties
if (host == null) host = session.getProperty("mail.host");
if (user == null) user = session.getProperty("mail.user");
// try using the system username
if (user == null) {
try {
user = System.getProperty("user.name");
} catch (SecurityException sex) {
// XXX - it's not worth creating a MailLogger just for this
// logger.log(Level.CONFIG, "Can't get user.name property", sex);
}
}
url = new URLName(protocol, host, port, file, user, password);
// create or choose the appropriate event queue
String scope = session.getProperties().getProperty("mail.event.scope", "folder");
Executor executor = (Executor) session.getProperties().get("mail.event.executor");
if (scope.equalsIgnoreCase("application")) q = EventQueue.getApplicationEventQueue(executor);
else if (scope.equalsIgnoreCase("session")) q = session.getEventQueue();
else // if (scope.equalsIgnoreCase("store") ||
// scope.equalsIgnoreCase("folder"))
q = new EventQueue(executor);
}
/**
* Return a URLName representing this service. The returned URLName does <em>not</em> include the
* password field.
*
* <p>Subclasses should only override this method if their URLName does not follow the standard
* format.
*
* <p>The implementation in the Service class returns (usually a copy of) the <code>url</code>
* field with the password and file information stripped out.
*
* @return the URLName representing this service
* @see URLName
*/
public synchronized URLName getURLName() {
if (url != null && (url.getPassword() != null || url.getFile() != null))
return new URLName(
url.getProtocol(),
url.getHost(),
url.getPort(),
null /* no file */,
url.getUsername(),
null /* no password */);
else return url;
}
/**
* Similar to connect(host, user, password) except a specific port can be specified.
*
* @param host the host to connect to
* @param port the port to connect to (-1 means the default port)
* @param user the user name
* @param password this user's password
* @exception AuthenticationFailedException for authentication failures
* @exception MessagingException for other failures
* @exception IllegalStateException if the service is already connected
* @see #connect(java.lang.String, java.lang.String, java.lang.String)
* @see javax.mail.event.ConnectionEvent
*/
public synchronized void connect(String host, int port, String user, String password)
throws MessagingException {
// see if the service is already connected
if (isConnected()) throw new IllegalStateException("already connected");
PasswordAuthentication pw;
boolean connected = false;
boolean save = false;
String protocol = null;
String file = null;
// get whatever information we can from the URL
// XXX - url should always be non-null here, Session
// passes it into the constructor
if (url != null) {
protocol = url.getProtocol();
if (host == null) host = url.getHost();
if (port == -1) port = url.getPort();
if (user == null) {
user = url.getUsername();
if (password == null) // get password too if we need it
password = url.getPassword();
} else {
if (password == null && user.equals(url.getUsername()))
// only get the password if it matches the username
password = url.getPassword();
}
file = url.getFile();
}
// try to get protocol-specific default properties
if (protocol != null) {
if (host == null) host = session.getProperty("mail." + protocol + ".host");
if (user == null) user = session.getProperty("mail." + protocol + ".user");
}
// try to get mail-wide default properties
if (host == null) host = session.getProperty("mail.host");
if (user == null) user = session.getProperty("mail.user");
// try using the system username
if (user == null) {
try {
user = System.getProperty("user.name");
} catch (SecurityException sex) {
// XXX - it's not worth creating a MailLogger just for this
// logger.log(Level.CONFIG, "Can't get user.name property", sex);
}
}
// if we don't have a password, look for saved authentication info
if (password == null && url != null) {
// canonicalize the URLName
setURLName(new URLName(protocol, host, port, file, user, null));
pw = session.getPasswordAuthentication(getURLName());
if (pw != null) {
if (user == null) {
user = pw.getUserName();
password = pw.getPassword();
} else if (user.equals(pw.getUserName())) {
password = pw.getPassword();
}
} else save = true;
}
// try connecting, if the protocol needs some missing
// information (user, password) it will not connect.
// if it tries to connect and fails, remember why for later.
AuthenticationFailedException authEx = null;
try {
connected = protocolConnect(host, port, user, password);
} catch (AuthenticationFailedException ex) {
authEx = ex;
}
// if not connected, ask the user and try again
if (!connected) {
InetAddress addr;
try {
addr = InetAddress.getByName(host);
} catch (UnknownHostException e) {
addr = null;
}
pw = session.requestPasswordAuthentication(addr, port, protocol, null, user);
if (pw != null) {
user = pw.getUserName();
password = pw.getPassword();
// have the service connect again
connected = protocolConnect(host, port, user, password);
}
}
// if we're not connected by now, we give up
if (!connected) {
if (authEx != null) throw authEx;
else if (user == null)
throw new AuthenticationFailedException("failed to connect, no user name specified?");
else if (password == null)
throw new AuthenticationFailedException("failed to connect, no password specified?");
else throw new AuthenticationFailedException("failed to connect");
}
setURLName(new URLName(protocol, host, port, file, user, password));
if (save)
session.setPasswordAuthentication(getURLName(), new PasswordAuthentication(user, password));
// set our connected state
setConnected(true);
// finally, deliver the connection event
notifyConnectionListeners(ConnectionEvent.OPENED);
}