/******************************************************************************* * * Copyright (c) 2004-2010 Oracle Corporation. * * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at * http://www.eclipse.org/legal/epl-v10.html * * Contributors: * * Michael B. Donohue * * *******************************************************************************/ package hudson.model; import hudson.diagnosis.OldDataMonitor; import hudson.model.Queue.Task; import hudson.model.queue.FoldableAction; import hudson.util.XStream2; import org.kohsuke.stapler.export.Exported; import org.kohsuke.stapler.export.ExportedBean; import com.thoughtworks.xstream.converters.UnmarshallingContext; import java.util.ArrayList; import java.util.LinkedHashMap; import java.util.List; import java.util.Map; @ExportedBean public class CauseAction implements FoldableAction, RunAction { /** * @deprecated since 2009-02-28 */ @Deprecated // there can be multiple causes, so this is deprecated private transient Cause cause; private List<Cause> causes = new ArrayList<Cause>(); @Exported(visibility = 2) public List<Cause> getCauses() { return causes; } public CauseAction(Cause c) { this.causes.add(c); } public CauseAction(CauseAction ca) { this.causes.addAll(ca.causes); } public String getDisplayName() { return "Cause"; } public String getIconFileName() { // no icon return null; } public String getUrlName() { return "cause"; } /** * Get list of causes with duplicates combined into counters. * * @return Map of Cause to number of occurrences of that Cause */ public Map<Cause, Integer> getCauseCounts() { Map<Cause, Integer> result = new LinkedHashMap<Cause, Integer>(); for (Cause c : causes) { Integer i = result.get(c); result.put(c, i == null ? 1 : i.intValue() + 1); } return result; } /** * @deprecated as of 1.288 but left here for backward compatibility. */ public String getShortDescription() { if (causes.isEmpty()) { return "N/A"; } return causes.get(0).getShortDescription(); } public void onLoad() { // noop } public void onBuildComplete() { // noop } /** * When hooked up to build, notify {@link Cause}s. */ public void onAttached(Run owner) { if (owner instanceof AbstractBuild) {// this should be always true but being defensive here AbstractBuild b = (AbstractBuild) owner; for (Cause c : causes) { c.onAddedTo(b); } } } public void foldIntoExisting(hudson.model.Queue.Item item, Task owner, List<Action> otherActions) { CauseAction existing = item.getAction(CauseAction.class); if (existing != null) { existing.causes.addAll(this.causes); return; } // no CauseAction found, so add a copy of this one item.getActions().add(new CauseAction(this)); } public static class ConverterImpl extends XStream2.PassthruConverter<CauseAction> { public ConverterImpl(XStream2 xstream) { super(xstream); } @Override protected void callback(CauseAction ca, UnmarshallingContext context) { // if we are being read in from an older version if (ca.cause != null) { if (ca.causes == null) { ca.causes = new ArrayList<Cause>(); } ca.causes.add(ca.cause); OldDataMonitor.report(context, "1.288"); } } } }