com.nomagic.magicdraw.hyperlinks

Class HyperlinkUtils

java.lang.Object

com.nomagic.magicdraw.hyperlinks.HyperlinkUtils

@OpenApiAll
public class HyperlinkUtils
extends java.lang.Object

Hyperlink utilities.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HyperlinkUtils.DisplayableHyperlinkText Value holder for hyperlink text

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	HYPERLINK_MODEL_ACTIVE_TAG
static java.lang.String	HYPERLINK_MODEL_TAG
static java.lang.String	HYPERLINK_OWNER
static java.lang.String	HYPERLINK_TEXT_ACTIVE_TAG
static java.lang.String	HYPERLINK_TEXT_TAG

Constructor Summary

Constructors

Constructor and Description
HyperlinkUtils()

Method Summary

Modifier and Type	Method and Description
static boolean	addHyperlink(Element element, Hyperlink hyperlink) Adds given hyperlink as tagged value to the element.
static Hyperlink	createHyperlink(java.lang.String text, java.lang.String url) Creates hyperlink from given string url in the given project.
static Hyperlink	createHyperlink(java.lang.String text, java.lang.String url, Project context) Creates hyperlink from given string url in the given project.
static com.nomagic.magicdraw.hyperlinks.ElementHyperlink	findHyperlinkToElement(Element owner, Element hyperlinkedElement) Finds hyperlink to a given element on the given element (owner).
static Hyperlink	getActiveHyperlink(Element element) Returns active hyperlink of the element
static java.util.Collection<Hyperlink>	getAllHyperlinks(Element element) Returns hyperlinks of the element.
static java.util.Map<Element,Hyperlink>	getAllHyperlinksToElement(BaseElement targetElement) Collects information about all hyperlinks pointing to the given target element.
static HyperlinkUtils.DisplayableHyperlinkText	getDisplayableHyperlinkText(Hyperlink hyperlink) Return information about hyperlink text.
static javax.swing.Icon	getIcon(Hyperlink hyperlink) Return hyperlink icon
(package private) static Slot	getMainSlot(Element owner)
static java.lang.String	getURL(BaseElement element) Get URL of mdel:// protocol for a given element.
static java.lang.String	getURLWithVersion(BaseElement element) Get URL of mdel:// protocol for a given element.
static boolean	hasHyperlink(Element element) Check if element has hyperlink(s).
(package private) static boolean	hasHyperlinkSlot(InstanceSpecification element)
static boolean	isActiveHyperlink(Element element, Hyperlink hyperlink) Check given hyperlink is marked as active on the given element
static void	makeActive(Element element, Hyperlink hyperlink) Make given hyperlink as active on a given element
static void	removeActive(Element element) Remove active hyperlink from a given element
static void	removeHyperlink(Element element, Hyperlink hyperlink) Remove given hyperlink from the element.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

HYPERLINK_TEXT_TAG

public static final java.lang.String HYPERLINK_TEXT_TAG

See Also:

Constant Field Values

HYPERLINK_TEXT_ACTIVE_TAG

public static final java.lang.String HYPERLINK_TEXT_ACTIVE_TAG

See Also:

Constant Field Values

HYPERLINK_MODEL_TAG

public static final java.lang.String HYPERLINK_MODEL_TAG

See Also:

Constant Field Values

HYPERLINK_MODEL_ACTIVE_TAG

public static final java.lang.String HYPERLINK_MODEL_ACTIVE_TAG

See Also:

Constant Field Values

HYPERLINK_OWNER

public static final java.lang.String HYPERLINK_OWNER

See Also:

Constant Field Values

Constructor Detail

HyperlinkUtils

public HyperlinkUtils()

Method Detail

getURL

public static java.lang.String getURL(BaseElement element)

Get URL of mdel:// protocol for a given element.

Parameters:

element - the given element

Returns:

URL of element.

getURLWithVersion

public static java.lang.String getURLWithVersion(BaseElement element)

Get URL of mdel:// protocol for a given element. If project is remote project - include project version number, if project is local - method is equivalent to getURL(BaseElement).

Parameters:

element - the given element

Returns:

URL of element.

getAllHyperlinks

@Nonnull
public static java.util.Collection<Hyperlink> getAllHyperlinks(@Nonnull
                                                                        Element element)

Returns hyperlinks of the element.

Parameters:

element - given element

Returns:

a collection of all hyperlinks

getAllHyperlinksToElement

@Nonnull
public static java.util.Map<Element,Hyperlink> getAllHyperlinksToElement(@Nonnull
                                                                                  BaseElement targetElement)

Collects information about all hyperlinks pointing to the given target element.

Parameters:

targetElement - targetElement

Returns:

information about hyperlinks

removeActive

public static void removeActive(@Nonnull
                                Element element)

Remove active hyperlink from a given element

Parameters:

element - element

makeActive

public static void makeActive(@Nonnull
                              Element element,
                              @Nonnull
                              Hyperlink hyperlink)

Make given hyperlink as active on a given element

Parameters:

element - given element

hyperlink - given hyperlink

createHyperlink

@Nonnull
public static Hyperlink createHyperlink(@CheckForNull
                                                 java.lang.String text,
                                                 @CheckForNull
                                                 java.lang.String url,
                                                 @CheckForNull
                                                 Project context)

Creates hyperlink from given string url in the given project.

Parameters:

text - given text

url - hyperlink url

context - project as context

Returns:

hyperlink

createHyperlink

@Nonnull
public static Hyperlink createHyperlink(@CheckForNull
                                                 java.lang.String text,
                                                 @CheckForNull
                                                 java.lang.String url)

Creates hyperlink from given string url in the given project.

Parameters:

text - given text

url - hyperlink url

Returns:

hyperlink

getActiveHyperlink

@CheckForNull
public static Hyperlink getActiveHyperlink(@Nonnull
                                                         Element element)

Returns active hyperlink of the element

Parameters:

element - given element

Returns:

active hyperlink

hasHyperlink

public static boolean hasHyperlink(@Nonnull
                                   Element element)

Check if element has hyperlink(s).

Parameters:

element - element

Returns:

true if element has at least one hyperlink

isActiveHyperlink

public static boolean isActiveHyperlink(@Nonnull
                                        Element element,
                                        @Nonnull
                                        Hyperlink hyperlink)

Check given hyperlink is marked as active on the given element

Parameters:

element - element

hyperlink - hyperlink

Returns:

true if hyperlink is active

findHyperlinkToElement

@CheckForNull
public static com.nomagic.magicdraw.hyperlinks.ElementHyperlink findHyperlinkToElement(@Nonnull
                                                                                                     Element owner,
                                                                                                     @Nonnull
                                                                                                     Element hyperlinkedElement)

Finds hyperlink to a given element on the given element (owner).

Parameters:

owner - owner of the hyperlink

hyperlinkedElement - element to which hyperlink is created

Returns:

element hyperlink if found, null otherwise

getIcon

@CheckForNull
public static javax.swing.Icon getIcon(Hyperlink hyperlink)

Return hyperlink icon

Parameters:

hyperlink - hyperlink

Returns:

hyperlink icon

getDisplayableHyperlinkText

@Nonnull
public static HyperlinkUtils.DisplayableHyperlinkText getDisplayableHyperlinkText(@CheckForNull
                                                                                           Hyperlink hyperlink)

Return information about hyperlink text.

Parameters:

hyperlink - hyperlink

Returns:

hyperlink text information

removeHyperlink

public static void removeHyperlink(@Nonnull
                                   Element element,
                                   @Nonnull
                                   Hyperlink hyperlink)

Remove given hyperlink from the element.

Parameters:

element - element

hyperlink - hyperlink

addHyperlink

public static boolean addHyperlink(@Nonnull
                                   Element element,
                                   @Nonnull
                                   Hyperlink hyperlink)

Adds given hyperlink as tagged value to the element. Checks if has tagDefinition, taggedValue, taggedValue value

Parameters:

element - element

hyperlink - hyperlink to add

Returns:

true if hyperlink was added, false if such hyperlink already exist on the element

hasHyperlinkSlot

static boolean hasHyperlinkSlot(@CheckForNull
                                InstanceSpecification element)

getMainSlot

@CheckForNull
static Slot getMainSlot(@Nonnull
                                      Element owner)