diff --git a/core/src/main/java/hudson/tasks/MailAddressResolver.java b/core/src/main/java/hudson/tasks/MailAddressResolver.java new file mode 100644 index 0000000000..f4653d06ff --- /dev/null +++ b/core/src/main/java/hudson/tasks/MailAddressResolver.java @@ -0,0 +1,146 @@ +package hudson.tasks; + +import hudson.ExtensionPoint; +import hudson.Plugin; +import hudson.scm.SCM; +import hudson.scm.CVSSCM; +import hudson.scm.SubversionSCM; +import hudson.model.User; +import hudson.model.AbstractProject; + +import java.util.List; +import java.util.Map; +import java.util.HashMap; +import java.util.regex.Pattern; +import java.util.concurrent.CopyOnWriteArrayList; + +/** + * Infers e-mail addresses for the user when none is specified. + * + *
+ * This is an extension point of Hudson. Plugins tha contribute new implementation + * of this class must register it to {@link #LIST}. The typical way to do this is: + * + *
+ * class PluginImpl extends {@link Plugin} {
+ * public void start() {
+ * ...
+ * MailAddressResolver.LIST.add(new MyMailAddressResolver());
+ * }
+ * }
+ *
+ *
+ * @author Kohsuke Kawaguchi
+ * @sine 1.192
+ */
+public abstract class MailAddressResolver implements ExtensionPoint {
+ /**
+ * Infers e-mail address of the given user.
+ *
+ * + * This method is called when a {@link User} without explicitly configured e-mail + * address is used, as an attempt to infer e-mail address. + * + *
+ * The normal strategy is to look at {@link User#getProjects() the projects that the user + * is participating}, then use the repository information to infer the e-mail address. + * + *
+ * When multiple resolvers are installed, they are consulted in order and + * the search will be over when an address is inferred by someone. + * + *
+ * Since {@link MailAddressResolver} is singleton, this method can be invoked concurrently
+ * from multiple threads.
+ *
+ * @return
+ * null if the inference failed.
+ */
+ public abstract String findMailAddressFor(User u);
+
+ public static String resolve(User u) {
+ for (MailAddressResolver r : LIST) {
+ String email = r.findMailAddressFor(u);
+ if(email!=null) return email;
+ }
+ return null;
+ }
+
+
+ /**
+ * All registered {@link MailAddressResolver} implementations.
+ */
+ public static final List
+ * Since this has low UI visibility, we are open to having a large number of rules here.
+ * If you'd like to add one, please contribute more rules.
+ */
+ public static class DefaultAddressResolver extends MailAddressResolver {
+ public String findMailAddressFor(User u) {
+ for (AbstractProject,?> p : u.getProjects()) {
+ SCM scm = p.getScm();
+ if (scm instanceof CVSSCM) {
+ CVSSCM cvsscm = (CVSSCM) scm;
+
+ String s = findMailAddressFor(u,cvsscm.getCvsRoot());
+ if(s!=null) return s;
+ }
+ if (scm instanceof SubversionSCM) {
+ SubversionSCM svn = (SubversionSCM) scm;
+ for (SubversionSCM.ModuleLocation loc : svn.getLocations()) {
+ String s = findMailAddressFor(u,loc.remote);
+ if(s!=null) return s;
+ }
+ }
+ }
+
+ // didn't hit any known rules
+ return null;
+ }
+
+ /**
+ *
+ * @param scm
+ * String that represents SCM connectivity.
+ */
+ protected String findMailAddressFor(User u, String scm) {
+ for (Map.Entry