Package com.polarion.alm.shared.api.model.rp

Class RichPageReference

java.lang.Object

com.polarion.alm.shared.api.model.ModelEntityReferenceBase<T,R>

com.polarion.alm.shared.api.model.ModelObjectReferenceBase<T,R>

com.polarion.alm.shared.api.model.ModelObjectReferenceWithUpdatable<RichPage,UpdatableRichPage,RichPageReference>

com.polarion.alm.shared.api.model.rp.RichPageReference

All Implemented Interfaces:

com.google.gwt.user.client.rpc.IsSerializable, HasProjectId, HasRelativePath, ModelEntityReference, ModelObjectReference, ReferenceWithUpdatable<UpdatableRichPage>, HasNameAndSpaceReference, HasPortalLink, Serializable

public final class RichPageReference
extends ModelObjectReferenceWithUpdatable<RichPage,UpdatableRichPage,RichPageReference>
implements HasPortalLink, HasNameAndSpaceReference, HasProjectId

Since:

3.9.0

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final String	HOME	Name of the Home page.

Constructor Summary

Constructors

Constructor	Description
RichPageReference(SpaceReference spaceReference, String name)
RichPageReference(SpaceReference spaceReference, String name, String requestedRevision, String actualRevision)

Method Summary

Modifier and Type	Method	Description
RichPageLinkBuilder	createLink(SharedContext context)	Creates portal link.
boolean	equals(Object obj)
static RichPageReference	fromPath(String path)	The path is trimmed before parsing, so it can contain spaces at the start or end. The path can be obtained using toPath(), but this method works in more user friendly way by filling some missing parts with defaults.
static RichPageReference	fromRelativePath(String baseProjectId, String path)	The path is trimmed before parsing, so it can contain spaces at the start or end. The path can be obtained using toRelativePath(String), but this method works in more user friendly way by filling some missing parts with defaults.
static RichPageReference	fromSpaceRelativePath(SpaceReference baseSpace, String path)	The path is trimmed before parsing, so it can contain spaces at the start or end. The path can be obtained using toSpaceRelativePath(SpaceReference), but this method works in more user friendly way by filling some missing parts with defaults.
RichPageReference	getCurrent()	Returns the reference to current revision of the object, in other words reference without requested revision and actual revision.
RichPage	getFromRevision(ReadOnlyTransaction transaction, String revision)
RichPageReference	getWithRevision(String requestedRevision)	Returns the reference to the same object, but with different ModelObjectReference.requestedRevision(), the ModelObjectReference.actualRevision() of the returned reference is null.
int	hashCode()
boolean	isProjectHomePage()
boolean	isRepositoryHomePage()
boolean	isSpaceHomePage()
String	name()
PrototypeEnum	prototype()
Scope	scope()
SpaceReference	spaceReference()
String	toPath()	Returns unique string identifying the referenced page, the ModelObjectReferenceBase.requestedRevision() and ModelObjectReferenceBase.actualRevision() are ignored. The fromPath(String) can be used to get the reference from the returned path.
String	toRelativePath(String baseProjectId)	Returns unique relative path identifying the referenced page relative to the given project or global scope, the ModelObjectReferenceBase.requestedRevision() and ModelObjectReferenceBase.actualRevision() are ignored. The fromRelativePath(String, String) can be used to get the reference from the returned path.
String	toSpaceRelativePath(SpaceReference baseSpace)	Returns unique path identifying the referenced page relative to the given project, the ModelObjectReferenceBase.requestedRevision() and ModelObjectReferenceBase.actualRevision() are ignored. The fromSpaceRelativePath(SpaceReference, String) can be used to get the reference from the returned path.

Methods inherited from class com.polarion.alm.shared.api.model.ModelObjectReferenceWithUpdatable

getUpdatable

Methods inherited from class com.polarion.alm.shared.api.model.ModelObjectReferenceBase

actualRevision, get, getCurrent, getOriginal, projectId, requestedRevision, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.polarion.alm.shared.api.model.HasProjectId

projectId

Field Details

HOME

public static final String HOME

Name of the Home page.

Since:

3.9.1

See Also:

• Constant Field Values

Constructor Details

RichPageReference

public RichPageReference(@NotNull
 SpaceReference spaceReference,
 @NotNull
 String name,
 @Nullable
 String requestedRevision,
 @Nullable
 String actualRevision)

Throws:

IllegalArgumentException - when name is empty string

RichPageReference

public RichPageReference(@NotNull
 SpaceReference spaceReference,
 @NotNull
 String name)

Throws:

IllegalArgumentException - when name is empty string

Since:

3.9.1

Method Details

fromPath

@NotNull
public static RichPageReference fromPath(@NotNull
 String path)

The path is trimmed before parsing, so it can contain spaces at the start or end.

The path can be obtained using toPath(), but this method works in more user friendly way by filling some missing parts with defaults.

fromSpaceRelativePath

@NotNull
public static RichPageReference fromSpaceRelativePath(@Nullable
 SpaceReference baseSpace,
 @NotNull
 String path)

The path is trimmed before parsing, so it can contain spaces at the start or end.

The path can be obtained using toSpaceRelativePath(SpaceReference), but this method works in more user friendly way by filling some missing parts with defaults. The baseSpace used in both calls must be the same.

Parameters:

baseSpace - - when null, then this method works same as fromPath(String)

Since:

3.9.1

fromRelativePath

@NotNull
public static RichPageReference fromRelativePath(@Nullable
 String baseProjectId,
 @NotNull
 String path)

The path is trimmed before parsing, so it can contain spaces at the start or end.

The path can be obtained using toRelativePath(String), but this method works in more user friendly way by filling some missing parts with defaults. The baseProjectId used in both calls must be the same.

Parameters:

baseProjectId - - null means global scope

Since:

3.9.1

getFromRevision

@NotNull
public RichPage getFromRevision(@NotNull
 ReadOnlyTransaction transaction,
 @Nullable
 String revision)

Specified by:

getFromRevision in interface ModelObjectReference

Specified by:

getFromRevision in class ModelObjectReferenceBase<RichPage,RichPageReference>

revision - - null means current revision

getCurrent

@NotNull
public RichPageReference getCurrent()

Description copied from interface: ModelObjectReference

Returns the reference to current revision of the object, in other words reference without requested revision and actual revision. It is shortcut for calling ModelObjectReference.getWithRevision(String) with null

Specified by:

getCurrent in interface ModelObjectReference

Overrides:

getCurrent in class ModelObjectReferenceBase<RichPage,RichPageReference>

getWithRevision

@NotNull
public RichPageReference getWithRevision(@Nullable
 String requestedRevision)

Description copied from interface: ModelObjectReference

Returns the reference to the same object, but with different ModelObjectReference.requestedRevision(), the ModelObjectReference.actualRevision() of the returned reference is null.

Specified by:

getWithRevision in interface ModelObjectReference

Specified by:

getWithRevision in class ModelObjectReferenceBase<RichPage,RichPageReference>

See Also:

• which is shortcut for calling this method with null

spaceReference

@NotNull
public SpaceReference spaceReference()

Specified by:

spaceReference in interface HasNameAndSpaceReference

name

@NotNull
public String name()

Specified by:

name in interface HasNameAndSpaceReference

hashCode

public int hashCode()

Overrides:

hashCode in class ModelObjectReferenceBase<RichPage,RichPageReference>

equals

public boolean equals(Object obj)

Overrides:

equals in class ModelObjectReferenceBase<RichPage,RichPageReference>

createLink

@NotNull
public RichPageLinkBuilder createLink(@NotNull
 SharedContext context)

Description copied from interface: HasPortalLink

Creates portal link.

Specified by:

createLink in interface HasPortalLink

scope

@NotNull
public Scope scope()

Specified by:

scope in interface ModelObjectReference

toPath

@NotNull
public String toPath()

Returns unique string identifying the referenced page, the ModelObjectReferenceBase.requestedRevision() and ModelObjectReferenceBase.actualRevision() are ignored.

The fromPath(String) can be used to get the reference from the returned path.

Specified by:

toPath in interface ModelEntityReference

Specified by:

toPath in interface ModelObjectReference

See Also:

• ModelObjectSelector.path(String)

toSpaceRelativePath

@NotNull
public String toSpaceRelativePath(@Nullable
 SpaceReference baseSpace)

Returns unique path identifying the referenced page relative to the given project, the ModelObjectReferenceBase.requestedRevision() and ModelObjectReferenceBase.actualRevision() are ignored.

The fromSpaceRelativePath(SpaceReference, String) can be used to get the reference from the returned path. The baseSpace used in both calls must be the same.

Specified by:

toSpaceRelativePath in interface HasNameAndSpaceReference

Parameters:

baseSpace - - when null, then the returned path is same as from toPath().

Since:

3.9.1

toRelativePath

@NotNull
public String toRelativePath(@Nullable
 String baseProjectId)

Returns unique relative path identifying the referenced page relative to the given project or global scope, the ModelObjectReferenceBase.requestedRevision() and ModelObjectReferenceBase.actualRevision() are ignored.

The fromRelativePath(String, String) can be used to get the reference from the returned path. The baseProjectId used in both calls must be the same.

Specified by:

toRelativePath in interface HasRelativePath

Parameters:

baseProjectId - - null means global scope

Since:

3.9.1

prototype

@NotNull
public PrototypeEnum prototype()

Specified by:

prototype in interface ModelObjectReference

isRepositoryHomePage

public boolean isRepositoryHomePage()

Since:

3.10.1

isProjectHomePage

public boolean isProjectHomePage()

Since:

3.10.1

isSpaceHomePage

public boolean isSpaceHomePage()

Returns:

true if page is Home page for any space, global or project, default or named

Since:

3.10.1