com.sapportals.wcm.rfadapter

Class LinkDataPack

java.lang.Object

com.sapportals.wcm.rfadapter.DataPack

com.sapportals.wcm.rfadapter.LinkDataPack

public final class LinkDataPack
extends DataPack

combines all information needed to create an internal or external link in an ICollection. This class is immutable. If the target resource is itself a link, the data pack will use the IResource.getTargetResource() method to retrieve the target of that link. This target will then be used as target for the newly created link. This is only applicable, if the link to be created is of LinkType.INTERNAL

Property Summary

Type	Property and Description
boolean	generateDisplayName returns false if it is an LinkType.INTERNAL For these internal links, the default link generation must not create a displayname property, if the target has a displayname, because the link should show its targets displayname as displayname.

Constructor Summary

Constructors

Constructor and Description
LinkDataPack(IPropertyMap properties, IResource target) Convenience constructor to create a link of type LinkType.INTERNAL.
LinkDataPack(String name, IPropertyMap properties, IResource target) Convenience constructor to create a link of type LinkType.INTERNAL.
LinkDataPack(String name, IPropertyMap properties, LinkType type, URL target, IResourceContext context) standard constructor for this class.

Method Summary

Modifier and Type	Method and Description
DataPack	add(IProperty property) creates a new DataPack object that is a 1:1 copy of this instance but with the given parameter as additional property.
boolean	generateDisplayNameProperty() returns false if it is an LinkType.INTERNAL For these internal links, the default link generation must not create a displayname property, if the target has a displayname, because the link should show its targets displayname as displayname.
DataPack	modify(IProperty property) creates a new DataPack object that is a 1:1 copy of this instance but with the given parameter as additional or modified property.
URL	target()
LinkType	type()

Methods inherited from class com.sapportals.wcm.rfadapter.DataPack

addProperty, modifyProperty, name, properties

Methods inherited from class java.lang.Object

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

Property Detail

generateDisplayName

public boolean generateDisplayNameProperty

returns false if it is an LinkType.INTERNAL For these internal links, the default link generation must not create a displayname property, if the target has a displayname, because the link should show its targets displayname as displayname. For external links, a displayname property is wanted, because the external link cannot be used as a displayname-provider.

Overrides:

generateDisplayNameProperty in class DataPack

Constructor Detail

LinkDataPack

public LinkDataPack(String name,
                    IPropertyMap properties,
                    LinkType type,
                    URL target,
                    IResourceContext context)

standard constructor for this class. Other constructors will call this one internally

Parameters:

name - the name the link should have, must not be null

properties - properties to be set for the link, might be null

type - specifies if a link to an object within the repository framework LinkType.INTERNAL or to an object outside the framework, LinkType.EXTERNAL, should be created. Must not be null

target - the adress of the object the link should point at. Must not be null

context - no description

LinkDataPack

public LinkDataPack(String name,
                    IPropertyMap properties,
                    IResource target)
             throws ResourceException

Convenience constructor to create a link of type LinkType.INTERNAL. The needed URL object will be created using the given target's RID

Parameters:

name - the name the link should have, must not be null

properties - properties to be set for the link, might be null

target - the IResource the link should point at, must not be null

Throws:

ResourceException - if the target's RID is not retrievable

LinkDataPack

public LinkDataPack(IPropertyMap properties,
                    IResource target)
             throws ResourceException

Convenience constructor to create a link of type LinkType.INTERNAL. The needed URL object will be created using the given target's RID, the name of the link will be the name of the target

Parameters:

properties - properties to be set for the link, might be null

target - the IResource the link should point at, must not be null

Throws:

ResourceException - if the target's RID is not retrievable

Method Detail

generateDisplayNameProperty

public boolean generateDisplayNameProperty()

returns false if it is an LinkType.INTERNAL For these internal links, the default link generation must not create a displayname property, if the target has a displayname, because the link should show its targets displayname as displayname. For external links, a displayname property is wanted, because the external link cannot be used as a displayname-provider.

Overrides:

generateDisplayNameProperty in class DataPack

type

public LinkType type()

target

public URL target()

modify

public DataPack modify(IProperty property)

Description copied from class: DataPack

creates a new DataPack object that is a 1:1 copy of this instance but with the given parameter as additional or modified property. If the property is null, all values will be equal.

Specified by:

modify in class DataPack

Parameters:

property - the property to modify for the new datapack, might be null

Returns:

a new DataPack object

add

public DataPack add(IProperty property)

Description copied from class: DataPack

creates a new DataPack object that is a 1:1 copy of this instance but with the given parameter as additional property. If the property is null, all values will be equal.

Specified by:

add in class DataPack

Parameters:

property - the property to add for the new datapack, might be null

Returns:

a new DataPack object