Package com.atlassian.confluence.labels

Class LabelParser

java.lang.Object

com.atlassian.confluence.labels.LabelParser

public class LabelParser
extends Object

The Label parser understands the formatting of label strings.

The following are considered valid label strings.

• my:label

  : a user label owned by the currently logged in user. If no user is logged in, this defaults to the global label of the same name..

• label

  : a global label.

• ~username:label

  : a user label owned by the specified user.

Field Summary

Fields

Modifier and Type	Field	Description
static String	GLOBAL_LABEL_PREFIX
static char[]	INVALID_CHARACTERS	Deprecated. since 5.10.
static int	MAX_LABEL_NAME_LENGTH
static int	MAX_LABEL_PREFIX_LENGTH
static String	NAMESPACE_DELIMITER
static String	PERSONAL_LABEL_PREFIX
static String	TEAM_LABEL_PREFIX
static String	USER_LABEL_PREFIX

Constructor Summary

Constructors

Constructor	Description
LabelParser()

Method Summary

Modifier and Type	Method	Description
static ParsedLabelName	create(Label label)
static ParsedLabelName	create(String labelName, String userName)
static String	getInvalidCharactersAsString()
static boolean	isLabelOwnedByUser(String labelString, com.atlassian.user.User user)	Returns true if the label is a personal label and is owned by the specified user, false otherwise.
static boolean	isPersonalLabel(String labelString)	Returns true if the label is a personal label, false otherwise.
static boolean	isValidLabelLength(ParsedLabelName labelName)
static boolean	isValidNameLength(ParsedLabelName labelName)
static boolean	isValidPrefixLength(ParsedLabelName labelName)
static @Nullable ParsedLabelName	parse(@NonNull String labelString, @Nullable com.atlassian.user.User user)
static ParsedLabelName	parse(String labelString)	Deprecated. since 6.0.
static String	render(Label label)
static String	render(ParsedLabelName parsedLabelName)
static String	render(ParsedLabelName parsedLabelName, boolean ignoreCurrentUser)
static String	render(ParsedLabelName parsedLabelName, com.atlassian.user.User currentUser)	The pure render function without side effects

Methods inherited from class java.lang.Object

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

Field Detail

INVALID_CHARACTERS

@Deprecated
public static final char[] INVALID_CHARACTERS

Deprecated.

since 5.10. Use INVALID_LABEL_CHARACTERS

MAX_LABEL_NAME_LENGTH

public static final int MAX_LABEL_NAME_LENGTH

See Also:

Constant Field Values

MAX_LABEL_PREFIX_LENGTH

public static final int MAX_LABEL_PREFIX_LENGTH

See Also:

Constant Field Values

NAMESPACE_DELIMITER

public static final String NAMESPACE_DELIMITER

See Also:

Constant Field Values

PERSONAL_LABEL_PREFIX

public static final String PERSONAL_LABEL_PREFIX

TEAM_LABEL_PREFIX

public static final String TEAM_LABEL_PREFIX

GLOBAL_LABEL_PREFIX

public static final String GLOBAL_LABEL_PREFIX

USER_LABEL_PREFIX

public static final String USER_LABEL_PREFIX

See Also:

Constant Field Values

Constructor Detail

LabelParser

public LabelParser()

Method Detail

isValidLabelLength

public static boolean isValidLabelLength(ParsedLabelName labelName)

isValidNameLength

public static boolean isValidNameLength(ParsedLabelName labelName)

isValidPrefixLength

public static boolean isValidPrefixLength(ParsedLabelName labelName)

isPersonalLabel

public static boolean isPersonalLabel(String labelString)

Returns true if the label is a personal label, false otherwise.

Parameters:

labelString - a string representation of exactly one label, optionally including a namespace. E.g. "my:favourite", "team:confluence" or "blah". Should not be null.

Returns:

true if the label is a personal label, false otherwise.

isLabelOwnedByUser

public static boolean isLabelOwnedByUser(String labelString,
                                         com.atlassian.user.User user)

Returns true if the label is a personal label and is owned by the specified user, false otherwise. Returns false, if the specified labelString is not a personal or user label (as no other label types have user ownership).

Parameters:

labelString - must be user label or personal label

user - user to check against

Returns:

true if the label is a personal label and is owned by the specified user, false otherwise.

parse

public static @Nullable ParsedLabelName parse(@NonNull String labelString,
                                              @Nullable com.atlassian.user.User user)

Since:

6.0

parse

@Deprecated
public static ParsedLabelName parse(String labelString)

Deprecated.

since 6.0. Use parse(String, User) instead.

getInvalidCharactersAsString

public static String getInvalidCharactersAsString()

create

public static ParsedLabelName create(String labelName,
                                     String userName)

create

public static ParsedLabelName create(Label label)

render

public static String render(Label label)

render

public static String render(ParsedLabelName parsedLabelName)

render

public static String render(ParsedLabelName parsedLabelName,
                            boolean ignoreCurrentUser)

render

public static String render(ParsedLabelName parsedLabelName,
                            com.atlassian.user.User currentUser)

The pure render function without side effects

Since:

7.7.0