com.sapportals.wcm.rendering.collection

Class ComponentFactory

java.lang.Object

com.sapportals.wcm.rendering.collection.ComponentFactory

All Implemented Interfaces:

IClassLoaderRegistryListener, IFactoryInfoProvider

Deprecated.

As of NetWeaver 7.1

public final class ComponentFactory
extends Object
implements IFactoryInfoProvider, IClassLoaderRegistryListener

Since:

EP5 SP6 and EP6 SP1 The ComponentFactory is a singleton factory, that allows other classes to retrieve instances of IComponents. When the factory is called for the first time or when it receives a ConfigEvent , it reads out information from the config framework. This information allows a mapping of a descriptive name ("alias") to a java-class. This allows a usage of the descriptive name throughout the configuration of the other parts of the rendering framework. If a mapping points to a not-existing or non-loadable class or if the class found does not implement the needed interface, an error message is written in the log.files, stating the name of the alias and the mapped java-class.

Nested Class Summary

Nested classes/interfaces inherited from interface com.sapportals.wcm.rendering.base.IFactoryInfoProvider

IFactoryInfoProvider.MappingInformation

Field Summary

Fields

Modifier and Type	Field and Description
static String	COMPONENT_PAGER Deprecated. key to retrieve a pager class instance from the factory using the factory's getComponent method and stating this constant as alias-parameter
static String	COMPONENT_PATH Deprecated. key to retrieve a path class instance (a.k.a.
static String	COMPONENT_SORT_HEADER Deprecated. key to retrieve a sort header class instance from the factory using the factory's getComponent method and stating this constant as alias-parameter
static String	DATA_KEY_PAGER_DATA Deprecated. key to use when transferring data to an IComponent instance using its setData method.
static String	DATA_KEY_PARENT Deprecated. key to use when transferring data to an IComponent instance using its setData method.
static String	DATA_KEY_RESOURCE_LIST Deprecated. key to use when transferring data to an IComponent instance using its setData method.
static String	DATA_KEY_RID_LIST Deprecated. key to use when transferring data to an IComponent instance using its setData method.
static String	DATA_KEY_SEARCH_SESSION Deprecated. key to use when transferring data to an IComponent instance using its setData method.
static String	DATA_KEY_SORT_DATA Deprecated. key to use when transferring data to an IComponent instance using its setData method.
static String	LINE_BREAK Deprecated. constant used to separate debugging information

Method Summary

Modifier and Type	Method and Description
boolean	checkComponentAlias(String alias) Deprecated. As of NetWeaver 7.1
void	classLoaderAdded(String id, ClassLoader newLoader) Deprecated. As of NetWeaver 7.1
void	classLoaderReplaced(String id, ClassLoader newLoader, ClassLoader oldLoader) Deprecated. As of NetWeaver 7.1
String	createLinkID(IComponent component, ArrayList values) Deprecated. As of NetWeaver 7.1
String	createStaticLinkID(IComponent component, ArrayList values, String id) Deprecated. As of NetWeaver 7.1
IComponentEvent	decodeEvent(ICollectionRenderer renderer, IProxy proxy, com.sapportals.htmlb.event.Event event, Map values) Deprecated. As of NetWeaver 7.1
IComponent	getComponent(IProxy proxy, IResource res, IFlavor impFlavor, String alias) Deprecated. As of NetWeaver 7.1
IComponent	getComponent(String alias, IProxy proxy) Deprecated. As of NetWeaver 7.1
IComponent	getComponent(String alias, IProxy proxy, ICollectionRenderer renderer) Deprecated. As of NetWeaver 7.1
IComponent	getComponent(String alias, IProxy proxy, ICollectionRenderer renderer, IResource res, IFlavor flavor) Deprecated. As of NetWeaver 7.1
IComponent	getComponent(String alias, IProxy proxy, IFlavor flavor) Deprecated. As of NetWeaver 7.1
String	getFactoryName() Deprecated. As of NetWeaver 7.1
static ComponentFactory	getInstance() Deprecated. As of NetWeaver 7.1
long	getLastReloadTime() Deprecated. As of NetWeaver 7.1
List	getMappings(Locale locale) Deprecated. As of NetWeaver 7.1
List	getPresentConfiguration(IResourceContext context) Deprecated. As of NetWeaver 7.1
String	getPresentConfiguration(IResourceContext context, String style, boolean showJavaClassNames) Deprecated. As of NetWeaver 7.1
Status	getStatus() Deprecated. As of NetWeaver 7.1

Methods inherited from class java.lang.Object

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

Field Detail

LINE_BREAK

public static final String LINE_BREAK

Deprecated.

constant used to separate debugging information

COMPONENT_PAGER

public static final String COMPONENT_PAGER

Deprecated.

key to retrieve a pager class instance from the factory using the factory's getComponent method and stating this constant as alias-parameter

See Also:

Constant Field Values

COMPONENT_PATH

public static final String COMPONENT_PATH

Deprecated.

key to retrieve a path class instance (a.k.a. "breadcrumb") from the factory using the factory's getComponent method and stating this constant as alias-parameter

See Also:

Constant Field Values

COMPONENT_SORT_HEADER

public static final String COMPONENT_SORT_HEADER

Deprecated.

key to retrieve a sort header class instance from the factory using the factory's getComponent method and stating this constant as alias-parameter

See Also:

Constant Field Values

DATA_KEY_SORT_DATA

public static final String DATA_KEY_SORT_DATA

Deprecated.

key to use when transferring data to an IComponent instance using its setData method. It is used as the key for a Map entry that must be of class SortDefinition.

See Also:

Constant Field Values

DATA_KEY_PAGER_DATA

public static final String DATA_KEY_PAGER_DATA

Deprecated.

key to use when transferring data to an IComponent instance using its setData method. It is used as the key for a Map entry that must be of class PagerData.

See Also:

Constant Field Values

DATA_KEY_RESOURCE_LIST

public static final String DATA_KEY_RESOURCE_LIST

Deprecated.

key to use when transferring data to an IComponent instance using its setData method. It is used as the key for a Map entry that must be of class IResourceList.

See Also:

Constant Field Values

DATA_KEY_RID_LIST

public static final String DATA_KEY_RID_LIST

Deprecated.

key to use when transferring data to an IComponent instance using its setData method. It is used as the key for a Map entry that must be of class IRidList.

See Also:

Constant Field Values

DATA_KEY_SEARCH_SESSION

public static final String DATA_KEY_SEARCH_SESSION

Deprecated.

key to use when transferring data to an IComponent instance using its setData method. It is used as the key for a Map entry that must be of class ISearchSession.

See Also:

Constant Field Values

DATA_KEY_PARENT

public static final String DATA_KEY_PARENT

Deprecated.

key to use when transferring data to an IComponent instance using its setData method. It is used as the key for a Map entry that must be of class ICollection.

See Also:

Constant Field Values

Method Detail

getInstance

public static ComponentFactory getInstance()

Deprecated. As of NetWeaver 7.1

Gets the instance attribute of the ComponentFactory class.

Returns:

the only available instance of this factory in the VM.

getComponent

public IComponent getComponent(String alias,
                               IProxy proxy,
                               ICollectionRenderer renderer)

Deprecated. As of NetWeaver 7.1

returns a new instance of an IComponent that is defined for the given alias or null, if no component is defined for the given alias. The components attributes alias, flavor, proxy, renderer, resource, startUri will be set with the values obtained from the given parameters.

getComponent

public IComponent getComponent(IProxy proxy,
                               IResource res,
                               IFlavor impFlavor,
                               String alias)

Deprecated. As of NetWeaver 7.1

getComponent

public IComponent getComponent(String alias,
                               IProxy proxy,
                               ICollectionRenderer renderer,
                               IResource res,
                               IFlavor flavor)

Deprecated. As of NetWeaver 7.1

getComponent

public IComponent getComponent(String alias,
                               IProxy proxy)

Deprecated. As of NetWeaver 7.1

returns a new instance of an IComponent that is defined for the given alias or null, if no component is defined for the given alias. The components attributes alias, proxy, resource, startUri will be set with the values obtained from the given parameters.

getComponent

public IComponent getComponent(String alias,
                               IProxy proxy,
                               IFlavor flavor)

Deprecated. As of NetWeaver 7.1

decodeEvent

public IComponentEvent decodeEvent(ICollectionRenderer renderer,
                                   IProxy proxy,
                                   com.sapportals.htmlb.event.Event event,
                                   Map values)
                            throws WcmException

Deprecated. As of NetWeaver 7.1

creates a new IComponent from the component's alias found inside the given event and let's it fire the returned IComponentEvent or null. If the id of the Htmlb-Component that fired the Event was not created using the factory's createLinkID or createStaticLinkID, this method might throw an WcmException or simply return null. Otherwise, a new Component instance is created, its attributes alias, proxy, renderer are set with the parameters given and its decodeEvent method is called, using again the given parameters. The created instance of the IComponent will not be reused by the factory in later calls.

Throws:

WcmException

createLinkID

public String createLinkID(IComponent component,
                           ArrayList values)
                    throws WcmException

Deprecated. As of NetWeaver 7.1

creates a unique ID that also holds the given IComponent's alias and all the entries of the given ArrayList. It also adds a String obtained from IDCounter.currentID(). Therefore, the ID created by this method cannot be reproduced at a later time. If you need to access the htmlb-Component inside your IComponent after an http-request-cycle, use the factory's createStaticLinkID method. None of the given parameters must be null.

Throws:

WcmException - if the creation of the linkID failed. This exception might wrap a WdfException.

createStaticLinkID

public String createStaticLinkID(IComponent component,
                                 ArrayList values,
                                 String id)
                          throws WcmException

Deprecated. As of NetWeaver 7.1

creates a unique ID that also holds the given IComponent's alias and all the entries of the given ArrayList. It also adds the id-parameter given. Therefore, the ID created by this method can be reproduced at a later time. Note that if you create two htmlb-Components within the same IComponent and the same ArrayList and id, there will be a NonUniqueIDException thrown when rendering the html-page. None of the given parameters must be null.

Throws:

WcmException - if the creation of the linkID failed. This exception might wrap a WdfException.

getPresentConfiguration

public String getPresentConfiguration(IResourceContext context,
                                      String style,
                                      boolean showJavaClassNames)

Deprecated. As of NetWeaver 7.1

returns a string representation of the structure of all defined groupcommands with their children.

Parameters:

context - the current context of the user, sets e.g. the language of the labels for the commands

style - currently not used

showJavaClassNames - flag to show (true) or hide (false) java class names in the returned string

Returns:

a String with line breaks and indentions to show the structure of all configured commands

getPresentConfiguration

public List getPresentConfiguration(IResourceContext context)

Deprecated. As of NetWeaver 7.1

returns a list of setting information of the groupcommands. GroupCommands are free to add information to this list. When using this list a type check should be done before casting to String to avoid ClassCastException s.

Parameters:

context - Description of the param

Returns:

a list containing information provided by the factory's groupcommands.

getFactoryName

public String getFactoryName()

Deprecated. As of NetWeaver 7.1

Specified by:

getFactoryName in interface IFactoryInfoProvider

Returns:

a human-readable name of the factory, must not be null

getMappings

public List getMappings(Locale locale)

Deprecated. As of NetWeaver 7.1

Specified by:

getMappings in interface IFactoryInfoProvider

Parameters:

locale - defines the language to use, if the factory offers translated information, must not be null

Returns:

a list that must only contain IFactoryInfoProvider.MappingInformation, must not be null

getStatus

public Status getStatus()

Deprecated. As of NetWeaver 7.1

Specified by:

getStatus in interface IFactoryInfoProvider

Returns:

the aggregated status of the factory. If, e.g., there have been errors creating a class defined in the config, the factory should return Status.ERROR

getLastReloadTime

public long getLastReloadTime()

Deprecated. As of NetWeaver 7.1

Specified by:

getLastReloadTime in interface IFactoryInfoProvider

Returns:

the time of the last reload of the config by this factory. Expects a format such as returned by System.currentTimeMillis(). An implementing class might also return -1 to indicate, that no information is available.

checkComponentAlias

public boolean checkComponentAlias(String alias)

Deprecated. As of NetWeaver 7.1

Checks if a component with the given alias exists

Parameters:

alias -

Returns:

true if a component with the given alias exists, otherwise false

classLoaderAdded

public void classLoaderAdded(String id,
                             ClassLoader newLoader)

Deprecated. As of NetWeaver 7.1

Description copied from interface: IClassLoaderRegistryListener

Notify a subscriber for newly added class loader

Specified by:

classLoaderAdded in interface IClassLoaderRegistryListener

Parameters:

id - the ID of the application being registered with CRT

newLoader - the class loader of the application

classLoaderReplaced

public void classLoaderReplaced(String id,
                                ClassLoader newLoader,
                                ClassLoader oldLoader)

Deprecated. As of NetWeaver 7.1

Description copied from interface: IClassLoaderRegistryListener

Notify a subscriber whenever a registered class loader is replaced.

Specified by:

classLoaderReplaced in interface IClassLoaderRegistryListener

Parameters:

id - the ID of the application being registered with CRT

newLoader - the new class loader

oldLoader - the old class loader