net.sourceforge.plantuml.sequencediagram.SequenceDiagram Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of plantuml-asl Show documentation
Show all versions of plantuml-asl Show documentation
PlantUML is a component that allows to quickly write diagrams from text.
The newest version!
// THIS FILE HAS BEEN GENERATED BY A PREPROCESSOR.
/* +=======================================================================
* |
* | PlantUML : a free UML diagram generator
* |
* +=======================================================================
*
* (C) Copyright 2009-2024, Arnaud Roques
*
* Project Info: https://plantuml.com
*
* If you like this project or if you find it useful, you can support us at:
*
* https://plantuml.com/patreon (only 1$ per month!)
* https://plantuml.com/liberapay (only 1€ per month!)
* https://plantuml.com/paypal
*
*
* PlantUML is free software; you can redistribute it and/or modify it
* under the terms of the Apache Software License.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* PlantUML can occasionally display sponsored or advertising messages. Those
* messages are usually generated on welcome or error images and never on
* functional diagrams.
* See https://plantuml.com/professional if you want to remove them
*
* Images (whatever their format : PNG, SVG, EPS...) generated by running PlantUML
* are owned by the author of their corresponding sources code (that is, their
* textual description in PlantUML language). Those images are not covered by
* this APACHE license.
*
* The generated images can then be used without any reference to the APACHE license.
* It is not even necessary to stipulate that they have been generated with PlantUML,
* although this will be appreciated by the PlantUML team.
*
* There is an exception : if the textual description in PlantUML language is also covered
* by any license, then the generated images are logically covered
* by the very same license.
*
* This is the IGY distribution (Install GraphViz by Yourself).
* You have to install GraphViz and to setup the GRAPHVIZ_DOT environment variable
* (see https://plantuml.com/graphviz-dot )
*
* Icons provided by OpenIconic : https://useiconic.com/open
* Archimate sprites provided by Archi : http://www.archimatetool.com
* Stdlib AWS provided by https://github.com/milo-minderbinder/AWS-PlantUML
* Stdlib Icons provided https://github.com/tupadr3/plantuml-icon-font-sprites
* ASCIIMathML (c) Peter Jipsen http://www.chapman.edu/~jipsen
* ASCIIMathML (c) David Lippman http://www.pierce.ctc.edu/dlippman
* CafeUndZopfli ported by Eugene Klyuchnikov https://github.com/eustas/CafeUndZopfli
* Brotli (c) by the Brotli Authors https://github.com/google/brotli
* Themes (c) by Brett Schwarz https://github.com/bschwarz/puml-themes
* Twemoji (c) by Twitter at https://twemoji.twitter.com/
*
*/
package net.sourceforge.plantuml.sequencediagram;
import java.io.IOException;
import java.io.OutputStream;
import java.text.DecimalFormat;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.EnumSet;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import java.util.Set;
import java.util.Stack;
import net.atmp.ImageBuilder;
import net.sourceforge.plantuml.FileFormat;
import net.sourceforge.plantuml.FileFormatOption;
import net.sourceforge.plantuml.OptionFlags;
import net.sourceforge.plantuml.UmlDiagram;
import net.sourceforge.plantuml.abel.EntityPortion;
import net.sourceforge.plantuml.command.CommandExecutionResult;
import net.sourceforge.plantuml.core.DiagramDescription;
import net.sourceforge.plantuml.core.ImageData;
import net.sourceforge.plantuml.core.UmlSource;
import net.sourceforge.plantuml.klimt.Fashion;
import net.sourceforge.plantuml.klimt.color.HColor;
import net.sourceforge.plantuml.klimt.creole.Display;
import net.sourceforge.plantuml.klimt.drawing.UGraphic;
import net.sourceforge.plantuml.klimt.shape.TextBlock;
import net.sourceforge.plantuml.log.Logme;
import net.sourceforge.plantuml.sequencediagram.graphic.FileMaker;
import net.sourceforge.plantuml.sequencediagram.graphic.SequenceDiagramFileMakerPuma2;
import net.sourceforge.plantuml.sequencediagram.graphic.SequenceDiagramTxtMaker;
import net.sourceforge.plantuml.sequencediagram.teoz.SequenceDiagramFileMakerTeoz;
import net.sourceforge.plantuml.skin.ColorParam;
import net.sourceforge.plantuml.skin.UmlDiagramType;
import net.sourceforge.plantuml.skin.rose.Rose;
import net.sourceforge.plantuml.stereo.Stereotype;
import net.sourceforge.plantuml.style.ClockwiseTopRightBottomLeft;
import net.sourceforge.plantuml.xmi.SequenceDiagramXmiMaker;
public class SequenceDiagram extends UmlDiagram {
private boolean hideUnlinkedData;
public final boolean isHideUnlinkedData() {
return hideUnlinkedData;
}
public final void setHideUnlinkedData(boolean hideUnlinkedData) {
this.hideUnlinkedData = hideUnlinkedData;
}
private final List participantsList = new ArrayList<>();
private final List events = new ArrayList<>();
private final Map participantEnglobers2 = new HashMap();
private final Rose skin2 = new Rose();
public SequenceDiagram(UmlSource source, Map skinParam) {
super(source, UmlDiagramType.SEQUENCE, skinParam);
}
@Deprecated
public Participant getOrCreateParticipant(String code) {
return getOrCreateParticipant(code, Display.getWithNewlines(code));
}
public Participant getOrCreateParticipant(String code, Display display) {
Participant result = participantsget(code);
if (result == null) {
result = new Participant(ParticipantType.PARTICIPANT, code, display, hiddenPortions, 0,
getSkinParam().getCurrentStyleBuilder());
addWithOrder(result);
participantEnglobers2.put(result, participantEnglober);
}
return result;
}
private Participant participantsget(String code) {
for (Participant p : participantsList)
if (p.getCode().equals(code))
return p;
return null;
}
private EventWithDeactivate lastEventWithDeactivate;
public EventWithDeactivate getLastEventWithDeactivate() {
for (int i = events.size() - 1; i >= 0; i--)
if (events.get(i) instanceof EventWithDeactivate)
return (EventWithDeactivate) events.get(i);
return null;
}
public EventWithNote getLastEventWithNote() {
for (int i = events.size() - 1; i >= 0; i--)
if (events.get(i) instanceof EventWithNote)
return (EventWithNote) events.get(i);
return null;
}
public Participant createNewParticipant(ParticipantType type, String code, Display display, int order) {
if (participantsget(code) != null)
throw new IllegalArgumentException();
if (Display.isNull(display)) {
// display = Arrays.asList(code);
display = Display.getWithNewlines(code);
}
final Participant result = new Participant(type, code, display, hiddenPortions, order,
getSkinParam().getCurrentStyleBuilder());
addWithOrder(result);
participantEnglobers2.put(result, participantEnglober);
return result;
}
private void addWithOrder(final Participant result) {
for (int i = 0; i < participantsList.size(); i++)
if (result.getOrder() < participantsList.get(i).getOrder()) {
participantsList.add(i, result);
return;
}
participantsList.add(result);
}
public Collection participants() {
return Collections.unmodifiableCollection(participantsList);
}
public boolean participantsContainsKey(String code) {
return participantsget(code) != null;
}
public CommandExecutionResult addMessage(AbstractMessage m) {
if (m.isParallel())
m.setParallelBrother(getLastAbstractMessage());
lastEventWithDeactivate = m;
lastDelay = null;
events.add(m);
if (pendingCreate != null) {
if (m.compatibleForCreate(pendingCreate.getParticipant()) == false)
return CommandExecutionResult.error("After create command, you have to send a message to \""
+ pendingCreate.getParticipant() + "\"");
m.addLifeEvent(pendingCreate);
pendingCreate = null;
}
return CommandExecutionResult.ok();
}
private AbstractMessage getLastAbstractMessage() {
for (int i = events.size() - 1; i >= 0; i--)
if (events.get(i) instanceof AbstractMessage)
return (AbstractMessage) events.get(i);
return null;
}
public void addNote(Note n, boolean tryMerge) {
// this.lastEventWithDeactivate = null;
if (tryMerge && events.size() > 0) {
final Event last = events.get(events.size() - 1);
if (last instanceof Note) {
final Notes notes = new Notes((Note) last, n);
events.set(events.size() - 1, notes);
return;
}
if (last instanceof Notes) {
((Notes) last).add(n);
return;
}
}
events.add(n);
}
public void newpage(Display strings) {
if (ignoreNewpage)
return;
events.add(new Newpage(strings));
}
private boolean ignoreNewpage = false;
public void ignoreNewpage() {
this.ignoreNewpage = true;
}
private int autonewpage = -1;
public final int getAutonewpage() {
return autonewpage;
}
public void setAutonewpage(int autonewpage) {
this.autonewpage = autonewpage;
}
public void divider(Display strings) {
events.add(new Divider(strings, getSkinParam().getCurrentStyleBuilder()));
}
public void hspace() {
events.add(new HSpace(25));
}
public void hspace(int pixel) {
events.add(new HSpace(pixel));
}
private Delay lastDelay;
public void delay(Display strings) {
final Delay delay = new Delay(strings, getSkinParam().getCurrentStyleBuilder());
events.add(delay);
lastDelay = delay;
}
public List events() {
return Collections.unmodifiableList(events);
}
private FileMaker getSequenceDiagramPngMaker(int index, FileFormatOption fileFormatOption) {
final FileFormat fileFormat = fileFormatOption.getFileFormat();
// ::comment when __CORE__
if (fileFormat == FileFormat.ATXT || fileFormat == FileFormat.UTXT)
return new SequenceDiagramTxtMaker(this, fileFormat);
if (fileFormat.name().startsWith("XMI"))
return new SequenceDiagramXmiMaker(this, fileFormat);
if (modeTeoz())
return new SequenceDiagramFileMakerTeoz(this, skin2, fileFormatOption, index);
return new SequenceDiagramFileMakerPuma2(this, skin2, fileFormatOption);
}
private boolean modeTeoz() {
return OptionFlags.FORCE_TEOZ || getPragma().useTeozLayout();
}
@Override
public ImageBuilder createImageBuilder(FileFormatOption fileFormatOption) throws IOException {
return super.createImageBuilder(fileFormatOption).annotations(false);
// they are managed in the SequenceDiagramFileMaker* classes
}
@Override
protected ImageData exportDiagramInternal(OutputStream os, int index, FileFormatOption fileFormat)
throws IOException {
final FileMaker sequenceDiagramPngMaker = getSequenceDiagramPngMaker(index, fileFormat);
return sequenceDiagramPngMaker.createOne(os, index, fileFormat.isWithMetadata());
}
@Override
final public void exportDiagramGraphic(UGraphic ug, FileFormatOption fileFormatOption) {
final FileMaker sequenceDiagramPngMaker = getSequenceDiagramPngMaker(0, fileFormatOption);
sequenceDiagramPngMaker.createOneGraphic(ug);
}
@Override
final protected TextBlock getTextMainBlock(FileFormatOption fileFormatOption) {
throw new UnsupportedOperationException();
}
// support for CommandReturn
private final Stack activationState = new Stack<>();
public AbstractMessage getActivatingMessage() {
if (activationState.empty())
return null;
return activationState.peek();
}
private LifeEvent pendingCreate = null;
public String activate(Participant p, LifeEventType lifeEventType, HColor backcolor) {
return activate(p, lifeEventType, backcolor, null);
}
public String activate(Participant p, LifeEventType lifeEventType, HColor backcolor, HColor linecolor) {
if (lastDelay != null)
return "You cannot Activate/Deactivate just after a ...";
final LifeEvent lifeEvent = new LifeEvent(p, lifeEventType, new Fashion(backcolor, linecolor));
events.add(lifeEvent);
if (lifeEventType == LifeEventType.CREATE) {
pendingCreate = lifeEvent;
return null;
}
if (lastEventWithDeactivate == null) {
if (lifeEventType == LifeEventType.ACTIVATE) {
p.incInitialLife(new Fashion(backcolor, linecolor));
return null;
}
if (p.getInitialLife() == 0)
return "You cannot deactivate here";
return null;
}
if (lifeEventType == LifeEventType.ACTIVATE && lastEventWithDeactivate instanceof AbstractMessage)
activationState.push((AbstractMessage) lastEventWithDeactivate);
else if (lifeEventType == LifeEventType.DEACTIVATE && activationState.empty() == false)
activationState.pop();
final boolean ok = lastEventWithDeactivate.addLifeEvent(lifeEvent);
if (lastEventWithDeactivate instanceof AbstractMessage) {
final AbstractMessage lastMessage = (AbstractMessage) lastEventWithDeactivate;
lifeEvent.setMessage(lastMessage);
}
if (ok)
return null;
return "Activate/Deactivate already done on " + p.getCode();
}
private final List openGroupings = new ArrayList<>();
public boolean grouping(String title, String comment, GroupingType type, HColor backColorGeneral,
HColor backColorElement, boolean parallel) {
if (type != GroupingType.START && openGroupings.size() == 0)
return false;
if (backColorGeneral == null)
backColorGeneral = getSkinParam().getHtmlColor(ColorParam.sequenceGroupBodyBackground, null, false);
final GroupingStart top = openGroupings.size() > 0 ? openGroupings.get(0) : null;
final Grouping g = type == GroupingType.START
? new GroupingStart(title, comment, backColorGeneral, backColorElement, top,
getSkinParam().getCurrentStyleBuilder())
: new GroupingLeaf(title, comment, type, backColorGeneral, backColorElement, top,
getSkinParam().getCurrentStyleBuilder());
events.add(g);
if (type == GroupingType.START) {
if (parallel)
((GroupingStart) g).goParallel();
openGroupings.add(0, (GroupingStart) g);
} else if (type == GroupingType.END) {
openGroupings.remove(0);
lastEventWithDeactivate = (GroupingLeaf) g;
}
return true;
}
public DiagramDescription getDescription() {
return new DiagramDescription("(" + participantsList.size() + " participants)");
}
private final AutoNumber autoNumber = new AutoNumber();
public final void autonumberGo(DottedNumber startingNumber, int increment, DecimalFormat decimalFormat) {
autoNumber.go(startingNumber, increment, decimalFormat);
}
public final void autonumberStop() {
autoNumber.stop();
}
public final AutoNumber getAutoNumber() {
return autoNumber;
}
// public final void autonumberResume(DecimalFormat decimalFormat) {
// autoNumber.resume(decimalFormat);
// }
//
// public final void autonumberResume(int increment, DecimalFormat
// decimalFormat) {
// autoNumber.resume(increment, decimalFormat);
// }
public String getNextMessageNumber() {
return autoNumber.getNextMessageNumber();
}
public boolean isShowFootbox() {
if (getSkinParam().strictUmlStyle())
return false;
final String footbox = getSkinParam().getValue("footbox");
if (footbox == null)
return showFootbox;
if (footbox.equalsIgnoreCase("hide"))
return false;
return true;
}
private boolean showFootbox = true;
public void setShowFootbox(boolean footbox) {
this.showFootbox = footbox;
}
private ParticipantEnglober participantEnglober;
public void boxStart(Display comment, HColor color, Stereotype stereotype) {
if (participantEnglober == null)
this.participantEnglober = ParticipantEnglober.build(comment, color, stereotype);
else
this.participantEnglober = participantEnglober.newChild(comment, color, stereotype);
}
public void endBox() {
if (participantEnglober == null)
throw new IllegalStateException();
this.participantEnglober = participantEnglober.getParent();
}
public boolean isBoxPending() {
return participantEnglober != null;
}
@Override
public int getNbImages() {
// ::comment when __CORE__
try {
// The DEBUG StringBounder is ok just to compute the number of pages here.
return getSequenceDiagramPngMaker(1, new FileFormatOption(FileFormat.DEBUG)).getNbPages();
} catch (Throwable t) {
Logme.error(t);
return 1;
// ::comment when __CORE__
}
}
public void removeHiddenParticipants() {
for (Participant p : new ArrayList<>(participantsList))
if (isAlone(p))
remove(p);
}
private void remove(Participant p) {
final boolean ok = participantsList.remove(p);
if (ok == false)
throw new IllegalArgumentException();
participantEnglobers2.remove(p);
}
private boolean isAlone(Participant p) {
for (Event ev : events)
if (ev.dealWith(p))
return false;
return true;
}
public void putParticipantInLast(String code) {
final Participant p = Objects.requireNonNull(participantsget(code), code);
final boolean ok = participantsList.remove(p);
assert ok;
addWithOrder(p);
participantEnglobers2.put(p, participantEnglober);
}
public ParticipantEnglober getEnglober(Participant p) {
return participantEnglobers2.get(p);
}
private boolean autoactivate;
public final void setAutoactivate(boolean autoactivate) {
this.autoactivate = autoactivate;
}
public final boolean isAutoactivate() {
return autoactivate;
}
public boolean hasUrl() {
for (Participant p : participantsList)
if (p.getUrl() != null)
return true;
for (Event ev : events)
if (ev.hasUrl())
return true;
if (getLegend().isNull() == false && getLegend().hasUrl())
return true;
return false;
}
public void addReference(Reference ref) {
events.add(ref);
}
@Override
public boolean isOk() {
if (participantsList.size() == 0)
return false;
return true;
}
@Override
public String checkFinalError() {
if (this.isHideUnlinkedData())
this.removeHiddenParticipants();
return super.checkFinalError();
}
private final Set hiddenPortions = EnumSet.noneOf(EntityPortion.class);
public void hideOrShow(Set portions, boolean show) {
if (show)
hiddenPortions.removeAll(portions);
else
hiddenPortions.addAll(portions);
}
public Display manageVariable(Display labels) {
return labels.replace("%autonumber%", autoNumber.getCurrentMessageNumber(false));
}
private final List linkAnchors = new ArrayList<>();
public CommandExecutionResult linkAnchor(String anchor1, String anchor2, String message) {
this.linkAnchors.add(new LinkAnchor(anchor1, anchor2, message));
return CommandExecutionResult.ok();
}
public List getLinkAnchors() {
return Collections.unmodifiableList(linkAnchors);
}
@Override
public ClockwiseTopRightBottomLeft getDefaultMargins() {
return modeTeoz() // this is for backward compatibility
? ClockwiseTopRightBottomLeft.same(5)
: ClockwiseTopRightBottomLeft.topRightBottomLeft(5, 5, 5, 0);
}
}