Source

java.lang.Object
- java.util.Observable
- - lumis.doui.source.Source<F>

Type Parameters:

F - the interface all fields of this source must implement.

Direct Known Subclasses:

TabularSource
```
@StableMinor(version="12.4",
             sinceVersion="4.0")
public abstract class Source<F extends ISourceField>
extends Observable
```
The base implementation of a doui data source.

Since:

4.0.0

Version:

$Revision: 23905 $ $Date: 2020-06-16 15:29:26 +0000 (Tue, 16 Jun 2020) $

Field Summary

Fields
Modifier and Type	Field and Description
`protected String`	`addInterfaceId`
`protected String`	`administrationInterfaceId`
`protected String`	`connectionId`
`protected String`	`detailsInterfaceId`
`protected String`	`editInterfaceId`
`protected List<F>`	`fields` A unmodifiable list of this source's fields.
`protected Map<String,F>`	`fieldsMap` A map of field id to the `ISourceField` instance.
`protected String`	`id`
`protected F`	`introductionSourceField`
`protected F`	`keywordsSourceField`
`protected boolean`	`load`
`protected String`	`metaDataSourceId`
`protected Map<String,Object>`	`parameters`
`protected F`	`primaryNameSourceField`
`protected String`	`readData`
`static String`	`SOURCE_READ_DATA_ALWAYS`
`static String`	`SOURCE_READ_DATA_NEVER`
`static String`	`SOURCE_READ_DATA_ON_DEMAND`
`protected ISourceContext`	`sourceContext`
`protected Node`	`sourceDefinitionNode`

Constructor Summary

Constructors
Constructor and Description

Source(Node sourceDefinitionNode, ISourceContext sourceContext)

Constructors
Constructor and Description
`Source(Node sourceDefinitionNode, ISourceContext sourceContext)`

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`ISourceAddDataResult`	`addData(Object data)` Adds a data in the persistence this source represents.
`void`	`applyPostLoadFilters()` Apply the filters specified in this source to its data.
`protected abstract void`	`convertDataToDefinedDataTypes()` Converts the data in this source to the values that should be used according to its fields definitions.
`protected F`	`createCustomSourceField(Node fieldNode)` Factory method for creating a custom source field.
`protected ISourceFilter`	`createDefaultCompositeFilterInstance()` Creates and returns a source filter instance to be used as default to `filters` nodes.
`protected ISourceFilter`	`createDefaultFilterInstance()` Creates and returns a source filter instance to be used as default to `filter` nodes.
`protected Collection<IPortalEvent>`	`createRenderDataChangedEvent(PortalEventOperationType operationType, Collection<String> itemIds)` Returns the render data changed event to be sent by `sendRenderDataChangedNotification(PortalEventOperationType, Collection)`.
`protected F`	`createSourceField(Node fieldNode)` Factory method for creating a source field instance that corresponds to the field node given.
`ISourceFilter`	`createSourceFilter(Node filterNode)` Creates a source filter for the given filter definition node.
`void`	`deleteDataByItemIds(Collection<String> itemIds)` Deletes data from the persistence this source represents.
`void`	`deleteDataByItemIds(String... itemIds)` Deletes the data with the given item identifiers.
`protected ISourceAddDataResult`	`doAddData(IParameters data)` Adds the data to the persistence.
`protected void`	`doDeleteDataByItemIds(Collection<String> itemIds)` Deletes the data in the persistence.
`protected ISourceUpdateDataResult`	`doUpdateData(IParameters data)` Updates the data in the persistence.
`String`	`getAddInterfaceId()` Returns the default add interface id for this source.
`String`	`getAdministrationInterfaceId()` Returns the main administration interface id for this source.
`<S extends Source<?>> ISourceBigDataPersister<S>`	`getBigDataPersister()` Returns the ISourceBigDataPersister implementation to be used for this source.
`ISourceData`	`getData()` Returns this source's data.
`<S extends Source> IDataProvider<S>`	`getDataProvider()` Returns the data provider for this source.
`protected <S extends Source<?>> ISourceBigDataPersister<S>`	`getDefaultBigDataPersister()` Returns the default ISourceBigDataPersister implementation to be used for this source if the big data persisting is not disabled and no specific persister class is configured for this source.
`protected abstract String`	`getDefaultProviderClass()` Abstract method that returns the default data provider class name.
`Node`	`getDefinitionNode()` Deprecated. This method may not be public in the future.
`String`	`getDetailsInterfaceId()` Returns the default details interface id for this source.
`boolean`	`getDistinct()` Returns the distinct property of the source.
`DouiContext`	`getDouiContext()` Returns this source's doui context.
`DouiHyperlinkItemParameterField`	`getDouiHyperlinkItemParameterField()` Returns the information about the field that is associated with the item id page parameter.
`String`	`getEditInterfaceId()` Returns the default edit interface id for this source.
`F`	`getField(String fieldId)` Returns the field with the given id.
`List<F>`	`getFields()` Returns a unmodifiable list of the fields in this source.
`ISourceFilter`	`getFilter()` Returns the filter for this source.
`Node`	`getFiltersNode()` Returns the "filters" node of the source.
`Collection<String>`	`getHyperlinkDefaultParameters()` Returns the default parameters that should be used when creating a hyperlink url from this source.
`String`	`getId()` Returns the source id.
`F`	`getIntroductionField()` Returns the field that is the introduction of this source.
`F`	`getIntroductionImageField()` Returns the field that is the introduction image of this source.
`F`	`getKeywordsField()`
`boolean`	`getLoad()` Returns the load property.
`String`	`getMetaDataSourceId()` Returns the metaDataId.
`Class<?>`	`getParameterClass(String parameterName)` Returns the class given a parameter name.
`Object`	`getParameterValue(String parameterName)` Returns a parameter value previously set.
`F`	`getPrimaryNameField()` Returns the field that is the primary name of this source.
`F`	`getPublishStartDateField()` Returns the field that is the publish start date of this source.
`String`	`getReadData()`
`SourceContainer`	`getSourceContainer()` Returns this source's container.
`ISourceContext`	`getSourceContext()` Returns this source's context.
`ITransaction`	`getTransaction()` Returns the transaction for this source.
`protected String`	`getUpdateDataItemId(IParameters data)` Returns the item identifier of a data being updated.
`protected boolean`	`isAdministrationInterface(IServiceInterface serviceInterface)` Returns true if the given service interface is the main administration interface for this source.
`boolean`	`isDetails()` Returns whether this source is the main source for a details interface, intended for obtaining the detailed information of a data.
`boolean`	`isRenderDataChangedNotificationEnabled()` Returns whether render data changed notification is enabled for operations done by this source object.
`void`	`load()` This is where the actual loading of the source data takes place.
`protected void`	`postAddFieldData(SourcePostAddDataEvent event)` Called after data is added in the persistence.
`protected void`	`postDeleteFieldData(SourcePostDeleteDataEvent event)` Called after fields data are deleted from the persistence.
`protected void`	`postProcessSource()` Executes the post load processors associated with the current source.
`protected void`	`postUpdateFieldData(SourcePostUpdateDataEvent event)` Called after data is updated in the persistence.
`protected void`	`preAddFieldData(SourcePreAddDataEvent event)` Called before data is added in the persistence.
`protected void`	`preDeleteFieldData(SourcePreDeleteDataEvent event)` Called before fields data are deleted from the persistence.
`protected void`	`preUpdateFieldData(SourcePreUpdateDataEvent event)` Called before data is updated in the persistence.
`List<ISourceData>`	`readData(Collection<String> itemIds)` Returns the data corresponding to the given `itemIds`.
`List<ISourceData>`	`readData(String... itemIds)` Returns the data corresponding to the given `itemIds`.
`protected void`	`readFieldsIntoFieldsMap()` Reads this source's fields into the `fieldsMap`.
`void`	`scheduleIndexData(Collection<String> itemIds)` Schedules the indexing of the data that corresponds to the specified item identifiers.
`void`	`scheduleIndexData(String... itemIds)` This method is a convenience overload that calls `scheduleIndexData(Collection)`.
`protected void`	`sendPostAddDataNotification(SourcePostAddDataEvent event)` Called after data is added in the persistence.
`protected void`	`sendPostDeleteDataNotification(SourcePostDeleteDataEvent event)` Called after data is deleted from the persistence.
`protected void`	`sendPostUpdateDataNotification(SourcePostUpdateDataEvent event)` Called after data is updated in the persistence.
`protected void`	`sendPreAddDataNotification(SourcePreAddDataEvent event)` Called before data is added in the persistence.
`protected void`	`sendPreDeleteDataNotification(SourcePreDeleteDataEvent event)` Called before data is deleted from the persistence.
`protected void`	`sendPreUpdateDataNotification(SourcePreUpdateDataEvent event)` Called before data is updated in the persistence.
`protected void`	`sendRenderDataChangedNotification(PortalEventOperationType operationType, Collection<String> itemIds)` Sends a render data changed notification for the specified item identifiers.
`protected void`	`sendRenderDataChangedNotification(PortalEventOperationType operationType, String... itemIds)` This method is a convenience overload that calls `sendRenderDataChangedNotification(PortalEventOperationType, Collection)`.
`void`	`setLoad(boolean load)` Sets the property indicating whether this source must be loaded by its data provider.
`void`	`setParameterValue(String parameterName, Object value)` Deprecated. Since 7.1.0 replaced by `setParameterValue(String, Object, String)` to allow proper conversion of value to string. This method is kept only for backwards compatibility with callers and is no longer called by the portal container. The `final` modifier has been applied to this method to force overriding methods to be adjusted to override the correct method instead of being silently ignored.
`void`	`setParameterValue(String parameterName, Object value, String valueAsString)` Sets a parameter value in this source.
`void`	`setReadData(String loadType)` Returns the load type of the source.
`void`	`setRenderDataChangedNotificationEnabled(boolean renderDataChangedNotificationEnabled)` Sets whether render data changed notification will be generated by this source object on corresponding operations.
`ISourceUpdateDataResult`	`updateData(Object data)` Updates a data in the persistence this source represents.
`protected boolean`	`valueChanged(String parameterName, String newValueAsString)` Returns true if the current value of the parameter changed from the previous value.

Methods inherited from class java.util.Observable
addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - SOURCE_READ_DATA_ON_DEMAND
```
public static final String SOURCE_READ_DATA_ON_DEMAND
```
    See Also:
    
    Constant Field Values
  - SOURCE_READ_DATA_NEVER
```
public static final String SOURCE_READ_DATA_NEVER
```
    See Also:
    
    Constant Field Values
  - SOURCE_READ_DATA_ALWAYS
```
public static final String SOURCE_READ_DATA_ALWAYS
```
    See Also:
    
    Constant Field Values
  - id
```
protected final String id
```
  - metaDataSourceId
```
protected final String metaDataSourceId
```
  - connectionId
```
protected final String connectionId
```
  - parameters
```
protected final Map<String,Object> parameters
```
  - sourceContext
```
protected final ISourceContext sourceContext
```
  - sourceDefinitionNode
```
protected final Node sourceDefinitionNode
```
  - administrationInterfaceId
```
protected final String administrationInterfaceId
```
  - addInterfaceId
```
protected final String addInterfaceId
```
  - editInterfaceId
```
protected final String editInterfaceId
```
  - detailsInterfaceId
```
protected final String detailsInterfaceId
```
  - fieldsMap
```
protected final Map<String,F extends ISourceField> fieldsMap
```
    A map of field id to the ISourceField instance. Changes to this map automatically reflects in the fields list. The fields list has the order the entries were put in this map.
    
    Since:
    
    4.0.4
    
    See Also:
    
    fields
  - fields
```
protected final List<F extends ISourceField> fields
```
    A unmodifiable list of this source's fields. This list automatically reflects the changes done in fieldsMap. The order of fields in this list is the same as the order the fields were put in fieldsMap.
    
    Since:
    
    4.0.4
    
    See Also:
    
    fieldsMap
  - load
```
protected boolean load
```
  - readData
```
protected String readData
```
  - primaryNameSourceField
```
protected F extends ISourceField primaryNameSourceField
```
  - introductionSourceField
```
protected F extends ISourceField introductionSourceField
```
  - keywordsSourceField
```
protected F extends ISourceField keywordsSourceField
```
- Constructor Detail
  - Source
```
public Source(Node sourceDefinitionNode,
              ISourceContext sourceContext)
       throws PortalException
```
    Throws:
    
    PortalException
- Method Detail
  - isAdministrationInterface
```
protected boolean isAdministrationInterface(IServiceInterface serviceInterface)
```
    Returns true if the given service interface is the main administration interface for this source.
    
    Parameters:
    
    serviceInterface - the service interface.
    
    Returns:
    
    true if the given service interface is the main administration interface for this source, false otherwise.
    
    Since:
    
    4.0.6
  - readFieldsIntoFieldsMap
```
protected void readFieldsIntoFieldsMap()
                                throws PortalException
```
    Reads this source's fields into the fieldsMap. The order the source fields are put in the map will define the order the fields will be in the fields list. This order may affect some field processing.
    
    Throws:
    
    PortalException - if an error was found while reading the source's fields into the fields map.
    
    Since:
    
    4.0.4
  - createCustomSourceField
```
protected F createCustomSourceField(Node fieldNode)
                             throws PortalException
```
    Factory method for creating a custom source field. A source field is a field whose class name is specified in its definition.
    
    Parameters:
    
    fieldNode - the field definition.
    
    Returns:
    
    the field instance, or null if the field is not a custom source field.
    
    Throws:
    
    PortalException
    
    Since:
    
    4.0.6
  - createSourceField
```
protected F createSourceField(Node fieldNode)
                       throws PortalException
```
    Factory method for creating a source field instance that corresponds to the field node given. This method instantiate and returns the source field, without initializing it.
    
    Parameters:
    
    fieldNode - the field node.
    
    Returns:
    
    the ISourceField created, or null if no field should be created for this node.
    
    Throws:
    
    PortalException
    
    Since:
    
    4.0.4
    
    See Also:
    
    createCustomSourceField(Node)
  - createSourceFilter
```
public ISourceFilter createSourceFilter(Node filterNode)
                                 throws PortalException
```
    Creates a source filter for the given filter definition node. The node may be a filters or filter node.
    
    Parameters:
    
    filterNode - the filter definition node.
    
    Returns:
    
    the source filter.
    
    Throws:
    
    PortalException
    
    Since:
    
    4.0.5
  - createDefaultFilterInstance
```
protected ISourceFilter createDefaultFilterInstance()
```
    Creates and returns a source filter instance to be used as default to filter nodes.
    
    Returns:
    
    the created instance.
    
    Since:
    
    4.0.5
  - createDefaultCompositeFilterInstance
```
protected ISourceFilter createDefaultCompositeFilterInstance()
```
    Creates and returns a source filter instance to be used as default to filters nodes.
    
    Returns:
    
    the created instance.
    
    Since:
    
    4.0.5
  - getFilter
```
public ISourceFilter getFilter()
```
    Returns the filter for this source. The filter must be initialized with the appropriated parameters before each use.
    
    Returns:
    
    the filter or null if this source has no filter.
    
    Since:
    
    4.0.5
  - getId
```
public String getId()
```
    Returns the source id.
    
    Returns:
    
    Since:
    
    4.0.11
  - getParameterClass
```
public Class<?> getParameterClass(String parameterName)
```
    Returns the class given a parameter name.
    The class is determined by the field type where the fieldId equals the parameter name.
    
    Parameters:
    
    parameterName -
    
    Returns:
    
    Since:
    
    4.0.11
  - setParameterValue
```
@Deprecated
public final void setParameterValue(String parameterName,
                                                Object value)
```
    Deprecated. Since 7.1.0 replaced by setParameterValue(String, Object, String) to allow proper conversion of value to string. This method is kept only for backwards compatibility with callers and is no longer called by the portal container. The final modifier has been applied to this method to force overriding methods to be adjusted to override the correct method instead of being silently ignored.
    
    Sets the parameter value of the source.
    
    Parameters:
    
    parameterName -
    
    value -
    
    Since:
    
    4.0.11
  - setParameterValue
```
public void setParameterValue(String parameterName,
                              Object value,
                              String valueAsString)
```
    Sets a parameter value in this source.
    The source's parameter values usually affect which or how data is loaded on it.
    
    Parameters:
    
    parameterName - the parameter name.
    
    value - the value.
    
    valueAsString - the value converted to string. It is important that the string corresponds to the value, such as when another equivalent value is set its string is also equivalent to this one, and when another value is different its string is also different of this one.
    
    Since:
    
    7.1.0
  - getParameterValue
```
public Object getParameterValue(String parameterName)
```
    Returns a parameter value previously set.
    
    Parameters:
    
    parameterName -
    
    Returns:
    
    Since:
    
    4.0.11
  - valueChanged
```
protected boolean valueChanged(String parameterName,
                               String newValueAsString)
```
    Returns true if the current value of the parameter changed from the previous value.
    
    Parameters:
    
    parameterName - the parameter name.
    
    newValueAsString - the new value converted to String.
    
    Returns:
    
    true if the value changed, false otherwise.
    
    Since:
    
    7.1.0
    
    See Also:
    
    setParameterValue(String, Object, String)
  - getDefinitionNode
```
@Deprecated
public Node getDefinitionNode()
```
    Deprecated. This method may not be public in the future.
    
    Returns:
    
    Since:
    
    4.0.4
  - getAdministrationInterfaceId
```
public String getAdministrationInterfaceId()
```
    Returns the main administration interface id for this source.
    
    Returns:
    
    the main administration interface id for this source. It may be null if the source does not have a main administration interface.
    
    Since:
    
    4.0.4
  - getAddInterfaceId
```
public String getAddInterfaceId()
```
    Returns the default add interface id for this source.
    
    Returns:
    
    the default add interface id for this source. It may be null if the source does not have a default add interface.
    
    Since:
    
    6.0.0
  - getEditInterfaceId
```
public String getEditInterfaceId()
```
    Returns the default edit interface id for this source.
    
    Returns:
    
    the default edit interface id for this source. It may be null if the source does not have a default edit interface.
    
    Since:
    
    6.0.0
  - getDetailsInterfaceId
```
public String getDetailsInterfaceId()
```
    Returns the default details interface id for this source.
    
    Returns:
    
    the default details interface id for this source. It may be null if the source does not have a default details interface.
    
    Since:
    
    6.0.0
  - getDataProvider
```
public <S extends Source> IDataProvider<S> getDataProvider()
                                                    throws PortalException
```
    Returns the data provider for this source.
    
    Type Parameters:
    
    S -
    
    Returns:
    
    Throws:
    
    PortalException
    
    Since:
    
    4.0.11
  - getDefaultProviderClass
```
protected abstract String getDefaultProviderClass()
                                           throws PortalException
```
    Abstract method that returns the default data provider class name.
    
    Returns:
    
    Throws:
    
    PortalException
    
    Since:
    
    4.0.11
  - getData
```
public ISourceData getData()
                    throws PortalException
```
    Returns this source's data.
    
    Returns:
    
    this source's data.
    
    Throws:
    
    PortalException
    
    Since:
    
    4.0.4
  - setLoad
```
public void setLoad(boolean load)
```
    Sets the property indicating whether this source must be loaded by its data provider.
    
    Parameters:
    
    load -
    
    Since:
    
    4.0.11
  - getLoad
```
public boolean getLoad()
```
    Returns the load property.
    The doui framework uses this to determine whether the source should be loaded or not.
    
    Returns:
    
    Since:
    
    4.0.11
  - getTransaction
```
public ITransaction getTransaction()
                            throws PortalException
```
    Returns the transaction for this source.
    
    Returns:
    
    the transaction for this source.
    
    Throws:
    
    PortalException
    
    Since:
    
    4.0.4
  - load
```
public void load()
          throws PortalException
```
    This is where the actual loading of the source data takes place.
    The data provider is called by the source to load its data. After data is loaded, all data conversion is performed and observers are notified.
    
    Throws:
    
    PortalException
    
    Since:
    
    4.0.11
  - postProcessSource
```
protected void postProcessSource()
                          throws PortalException
```
    Executes the post load processors associated with the current source. Note: this task was previously executed by the SourceContainer.
    
    Throws:
    
    PortalException
    
    Since:
    
    4.0.6
  - convertDataToDefinedDataTypes
```
protected abstract void convertDataToDefinedDataTypes()
                                               throws PortalException
```
    Converts the data in this source to the values that should be used according to its fields definitions.
    
    Throws:
    
    PortalException
    
    Since:
    
    4.0.4
  - getReadData
```
public String getReadData()
```
    Returns:
    
    Returns the loadType.
  - setReadData
```
public void setReadData(String loadType)
```
    Returns the load type of the source.
    
    Parameters:
    
    loadType - The loadType to set.
  - getFiltersNode
```
public Node getFiltersNode()
                    throws PortalException
```
    Returns the "filters" node of the source.
    A null value is returned if no filters are specified.
    
    Returns:
    
    Throws:
    
    PortalException
    
    Since:
    
    4.0.11
  - applyPostLoadFilters
```
public void applyPostLoadFilters()
                          throws PortalException
```
    Apply the filters specified in this source to its data. This is an utility method for data providers that does not support filtering during the source load operation. After loading the source's data without filtering it, the data provider may call this method for the source to remove data that does not attend to the filters specified.
    Data providers that may provide significant quantity of data should implement its own filtering during load instead of using this method, to prevent unnecessary use of server's memory and cpu.
    
    Throws:
    
    UnsupportedOperationException - if the source's implementation for this method does not support the filters specified.
    
    PortalException
    
    See Also:
    
    IDataProvider#loadData(lumis.portal.SessionConfig, Source, lumis.util.ITransaction)
  - getSourceContext
```
public ISourceContext getSourceContext()
```
    Returns this source's context.
    
    Returns:
    
    this source's context.
  - getDouiContext
```
public DouiContext getDouiContext()
```
    Returns this source's doui context.
    
    Returns:
    
    this source's doui context. May be null if this source does not belong to a doui context.
  - getSourceContainer
```
public SourceContainer getSourceContainer()
```
    Returns this source's container.
    
    Returns:
    
    this source's container. May be null if this source does not belong to a source container.
  - getDistinct
```
public boolean getDistinct()
                    throws PortalException
```
    Returns the distinct property of the source.
    The data provider reads this property to determine how to retrieve data.
    
    Returns:
    
    Throws:
    
    PortalException
    
    Since:
    
    4.0.11
  - getMetaDataSourceId
```
public String getMetaDataSourceId()
```
    Returns the metaDataId.
    
    Returns:
    
    Returns the metaDataId.
  - getField
```
public F getField(String fieldId)
```
    Returns the field with the given id.
    
    Parameters:
    
    fieldId - the field's id.
    
    Returns:
    
    the field with the given id, or null if there is no field with such id.
    
    Since:
    
    4.0.4
  - getFields
```
public List<F> getFields()
```
    Returns a unmodifiable list of the fields in this source.
    
    Returns:
    
    a unmodifiable list of the fields in this source.
    
    Since:
    
    4.0.4
  - getPrimaryNameField
```
public F getPrimaryNameField()
```
    Returns the field that is the primary name of this source.
    
    Returns:
    
    the field that is the primary name of this source, or null if this source has no primary name field.
    
    Since:
    
    4.0.4
  - getIntroductionField
```
public F getIntroductionField()
```
    Returns the field that is the introduction of this source.
    
    Returns:
    
    the field that is the introduction of this source, or null if this source has no introduction field.
    
    Since:
    
    4.0.4
  - getIntroductionImageField
```
public F getIntroductionImageField()
```
    Returns the field that is the introduction image of this source.
    
    Returns:
    
    the field that is the introduction image of this source, or null if this source has no introduction image field.
    
    Since:
    
    8.1.0
  - getPublishStartDateField
```
public F getPublishStartDateField()
```
    Returns the field that is the publish start date of this source.
    
    Returns:
    
    the field that is the publish start date of this source, or null if this source has no publish start date field.
    
    Since:
    
    8.1.0
  - getKeywordsField
```
public F getKeywordsField()
```
  - getDouiHyperlinkItemParameterField
```
public DouiHyperlinkItemParameterField getDouiHyperlinkItemParameterField()
```
    Returns the information about the field that is associated with the item id page parameter.
    
    Returns:
    
    the information about the field that is associated with the item id page parameter.
    
    Since:
    
    4.0.6
    
    See Also:
    
    PageConfig.PAGE_PARAMETER_ITEMID, DouiHyperlinkItemParameterField
  - getHyperlinkDefaultParameters
```
public Collection<String> getHyperlinkDefaultParameters()
```
    Returns the default parameters that should be used when creating a hyperlink url from this source.
    
    Returns:
    
    a collection with the default parameter names.
    
    Since:
    
    4.2.0
  - isDetails
```
public boolean isDetails()
```
    Returns whether this source is the main source for a details interface, intended for obtaining the detailed information of a data.
    
    Returns:
    
    true if this source is a details source, false otherwise.
    
    Since:
    
    7.0.1
  - getBigDataPersister
```
public <S extends Source<?>> ISourceBigDataPersister<S> getBigDataPersister()
```
    Returns the ISourceBigDataPersister implementation to be used for this source.
    
    Returns:
    
    the ISourceBigDataPersister implementation.
    
    Since:
    
    8.1.0
  - getDefaultBigDataPersister
```
protected <S extends Source<?>> ISourceBigDataPersister<S> getDefaultBigDataPersister()
```
    Returns the default ISourceBigDataPersister implementation to be used for this source if the big data persisting is not disabled and no specific persister class is configured for this source.
    This method is called by getBigDataPersister() when the default is to be used.
    
    Returns:
    
    the default ISourceBigDataPersister implementation.
    
    Since:
    
    8.1.0
  - isRenderDataChangedNotificationEnabled
```
public boolean isRenderDataChangedNotificationEnabled()
```
    Returns whether render data changed notification is enabled for operations done by this source object.
    
    Returns:
    
    true if render data changed notification is enabled, false otherwise.
    
    Since:
    
    10.4.0
    
    See Also:
    
    setRenderDataChangedNotificationEnabled(boolean)
  - setRenderDataChangedNotificationEnabled
```
public void setRenderDataChangedNotificationEnabled(boolean renderDataChangedNotificationEnabled)
```
    Sets whether render data changed notification will be generated by this source object on corresponding operations.
    By default render data changed notification is enabled.
    
    Parameters:
    
    renderDataChangedNotificationEnabled - true to enable render data changed notification on this source object or false to disable it.
    
    Since:
    
    10.4.0
    
    See Also:
    
    isRenderDataChangedNotificationEnabled()
  - readData
```
public final List<ISourceData> readData(String... itemIds)
                                 throws PortalException
```
    Returns the data corresponding to the given itemIds.
    This method is a convenience overload that calls readData(Collection).
    
    Parameters:
    
    itemIds - the item identifiers of the data to be returned.
    
    Returns:
    
    a list of ISourceData objects that corresponds to the given itemIds. If no data is found, an empty list is returned.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
  - readData
```
public List<ISourceData> readData(Collection<String> itemIds)
                           throws PortalException
```
    Returns the data corresponding to the given itemIds.
    The implementation of this method in Source throws an UnsupportedOperationException. This method should be overridden by source implementations that provides this functionality.
    
    Parameters:
    
    itemIds - the item identifiers of the data to be returned.
    
    Returns:
    
    a list of ISourceData objects that corresponds to the given itemIds. If no data is found, an empty list is returned.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
  - sendRenderDataChangedNotification
```
protected final void sendRenderDataChangedNotification(PortalEventOperationType operationType,
                                                       String... itemIds)
                                                throws PortalException
```
    This method is a convenience overload that calls sendRenderDataChangedNotification(PortalEventOperationType, Collection).
    
    Parameters:
    
    operationType - the operation type for the notification.
    
    itemIds - the item identifiers.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    sendRenderDataChangedNotification(PortalEventOperationType, Collection)
  - sendRenderDataChangedNotification
```
protected void sendRenderDataChangedNotification(PortalEventOperationType operationType,
                                                 Collection<String> itemIds)
                                          throws PortalException
```
    Sends a render data changed notification for the specified item identifiers.
    If isRenderDataChangedNotificationEnabled() is false, this method does nothing.
    This method calls createRenderDataChangedEvent(PortalEventOperationType, Collection) to create the event to be sent.
    This method should be called when data is added, modified or removed so the corresponding caches may be expired.
    
    Parameters:
    
    operationType - the operation type for the notification.
    
    itemIds - the item identifiers.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    isRenderDataChangedNotificationEnabled(), createRenderDataChangedEvent(PortalEventOperationType, Collection)
  - createRenderDataChangedEvent
```
protected Collection<IPortalEvent> createRenderDataChangedEvent(PortalEventOperationType operationType,
                                                                Collection<String> itemIds)
                                                         throws PortalException
```
    Returns the render data changed event to be sent by sendRenderDataChangedNotification(PortalEventOperationType, Collection).
    
    Parameters:
    
    operationType - the operation type for the notification.
    
    itemIds - the item identifiers.
    
    Returns:
    
    the event to be sent, or null to nothing be sent.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
  - scheduleIndexData
```
public final void scheduleIndexData(String... itemIds)
                             throws PortalException
```
    This method is a convenience overload that calls scheduleIndexData(Collection).
    
    Parameters:
    
    itemIds - the item identifiers.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    scheduleIndexData(Collection)
  - scheduleIndexData
```
public void scheduleIndexData(Collection<String> itemIds)
                       throws PortalException
```
    Schedules the indexing of the data that corresponds to the specified item identifiers. Due to the non-transactional nature of big data, this method must schedule the actual indexing for after the transaction commit.
    This method is called by the source's standard operations that add/update/delete data. So typically, this method is only needed to be called from outside the source when the data is changed outside it or something else make it necessary to re-index the data.
    The implementation of this method in Source uses readData(Collection) to read the data to be indexed and getBigDataPersister() to apply it to the big data.
    
    Parameters:
    
    itemIds - the item identifiers.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
  - addData
```
public ISourceAddDataResult addData(Object data)
                             throws PortalException
```
    Adds a data in the persistence this source represents.
    The implementation of this method in Source does the following:
    1. Calls sendPreAddDataNotification(SourcePreAddDataEvent).
    2. Calls preAddFieldData(SourcePreAddDataEvent).
    3. Calls doAddData(IParameters), method to be implemented by sources that supports this operation.
    4. Calls postAddFieldData(SourcePostAddDataEvent).
    5. Calls sendPostAddDataNotification(SourcePostAddDataEvent).
    6. Sends the render data changed notification.
    7. Schedules the indexing of the data.
    Parameters:
    
    data - the acceptable types of data object depends on the source implementation. The default Source implementation expects an object compatible with IParameters.asParameters(Object).
    
    Returns:
    
    a result object with information about the added data.
    
    Throws:
    
    UnsupportedOperationException - if add operation is not supported on this source.
    
    PortalException
    
    Since:
    
    10.4.0
  - sendPreAddDataNotification
```
protected void sendPreAddDataNotification(SourcePreAddDataEvent event)
                                   throws PortalException
```
    Called before data is added in the persistence.
    The default implementation of this method notifies observers of the event using portal event manager.
    
    Parameters:
    
    event - the event that contains information about the add operation.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    addData(Object), IPortalEventManager.notifyObservers(IPortalEvent)
  - sendPostAddDataNotification
```
protected void sendPostAddDataNotification(SourcePostAddDataEvent event)
                                    throws PortalException
```
    Called after data is added in the persistence.
    The default implementation of this method notifies observers of the event using portal event manager.
    
    Parameters:
    
    event - the event that contains information about the add operation.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    addData(Object), IPortalEventManager.notifyObservers(IPortalEvent)
  - preAddFieldData
```
protected void preAddFieldData(SourcePreAddDataEvent event)
                        throws PortalException
```
    Called before data is added in the persistence.
    The default implementation of this method calls ISourceField.preAdd(SourcePreAddDataEvent) on each field of this source.
    
    Parameters:
    
    event - the event that contains information about the add operation.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    addData(Object)
  - postAddFieldData
```
protected void postAddFieldData(SourcePostAddDataEvent event)
                         throws PortalException
```
    Called after data is added in the persistence.
    The default implementation of this method calls ISourceField.postAdd(SourcePostAddDataEvent) on each field of this source.
    
    Parameters:
    
    event - the event that contains information about the add operation.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    addData(Object)
  - doAddData
```
protected ISourceAddDataResult doAddData(IParameters data)
                                  throws PortalException
```
    Adds the data to the persistence.
    This method is called by addData(Object) and is to be overridden by sources that supports add operation and uses the default addData implementation.
    The implementation of this method in Source throws UnsupportedOperationException.
    
    Parameters:
    
    data - the data given to addData(Object), converted to IParameters if necessary.
    
    Returns:
    
    the result object to be returned by addData(Object).
    
    Throws:
    
    UnsupportedOperationException - if add operation is not supported on this source.
    
    PortalException
    
    Since:
    
    10.4.0
  - updateData
```
public ISourceUpdateDataResult updateData(Object data)
                                   throws PortalException
```
    Updates a data in the persistence this source represents.
    The implementation of this method in Source does the following:
    1. Calls sendPreUpdateDataNotification(SourcePreUpdateDataEvent).
    2. Calls preUpdateFieldData(SourcePreUpdateDataEvent).
    3. Calls doUpdateData(IParameters), method to be implemented by sources that supports this operation.
    4. Calls postUpdateFieldData(SourcePostUpdateDataEvent).
    5. Calls sendPostUpdateDataNotification(SourcePostUpdateDataEvent).
    6. Sends the render data changed notification.
    7. Schedules the indexing of the data.
    Parameters:
    
    data - the acceptable types of data object depends on the source implementation. The default Source implementation expects an object compatible with IParameters.asParameters(Object).
    
    Returns:
    
    a result object with information about the updated data.
    
    Throws:
    
    UnsupportedOperationException - if update operation is not supported on this source.
    
    PortalException
    
    Since:
    
    10.4.0
  - getUpdateDataItemId
```
protected String getUpdateDataItemId(IParameters data)
```
    Returns the item identifier of a data being updated.
    
    Parameters:
    
    data - the data.
    
    Returns:
    
    the item identifier.
    
    Since:
    
    10.4.0
  - sendPreUpdateDataNotification
```
protected void sendPreUpdateDataNotification(SourcePreUpdateDataEvent event)
                                      throws PortalException
```
    Called before data is updated in the persistence.
    The default implementation of this method notifies observers of the event using portal event manager.
    
    Parameters:
    
    event - the event that contains information about the update operation.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    updateData(Object), IPortalEventManager.notifyObservers(IPortalEvent)
  - sendPostUpdateDataNotification
```
protected void sendPostUpdateDataNotification(SourcePostUpdateDataEvent event)
                                       throws PortalException
```
    Called after data is updated in the persistence.
    The default implementation of this method notifies observers of the event using portal event manager.
    
    Parameters:
    
    event - the event that contains information about the update operation.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    updateData(Object), IPortalEventManager.notifyObservers(IPortalEvent)
  - preUpdateFieldData
```
protected void preUpdateFieldData(SourcePreUpdateDataEvent event)
                           throws PortalException
```
    Called before data is updated in the persistence.
    The default implementation of this method calls ISourceField.preUpdate(SourcePreUpdateDataEvent) on each field of this source.
    
    Parameters:
    
    event - the event that contains information about the update operation.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    updateData(Object)
  - postUpdateFieldData
```
protected void postUpdateFieldData(SourcePostUpdateDataEvent event)
                            throws PortalException
```
    Called after data is updated in the persistence.
    The default implementation of this method calls ISourceField#postUpdate(SourcePreUpdateDataEvent) on each field of this source.
    
    Parameters:
    
    event - the event that contains information about the update operation.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    updateData(Object)
  - doUpdateData
```
protected ISourceUpdateDataResult doUpdateData(IParameters data)
                                        throws PortalException
```
    Updates the data in the persistence.
    This method is called by updateData(Object) and is to be overridden by sources that supports update operation and uses the default updateData implementation.
    The implementation of this method in Source throws UnsupportedOperationException.
    
    Parameters:
    
    data - the data given to updateData(Object), converted to IParameters if necessary.
    
    Returns:
    
    the result object to be returned by updateData(Object).
    
    Throws:
    
    UnsupportedOperationException - if update operation is not supported on this source.
    
    PortalException
    
    Since:
    
    10.4.0
  - deleteDataByItemIds
```
public final void deleteDataByItemIds(String... itemIds)
                               throws PortalException
```
    Deletes the data with the given item identifiers.
    This method is a convenience overload that calls deleteDataByItemIds(Collection).
    
    Parameters:
    
    itemIds - the item identifiers of data to be deleted.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    deleteDataByItemIds(Collection)
  - deleteDataByItemIds
```
public void deleteDataByItemIds(Collection<String> itemIds)
                         throws PortalException
```
    Deletes data from the persistence this source represents.
    The implementation of this method in Source does the following:
    1. Sends the render data changed notification.
    2. Using a source instance created from the source definition at service level:
      
      Calls sendPreDeleteDataNotification(SourcePreDeleteDataEvent).
      
      Calls preDeleteFieldData(SourcePreDeleteDataEvent).
      
      Calls doDeleteDataByItemIds(Collection), method to be implemented by sources that supports this operation.
      
      Calls postDeleteFieldData(SourcePostDeleteDataEvent).
      
      Calls sendPostDeleteDataNotification(SourcePostDeleteDataEvent).
    3. Schedules the indexing of the data.
    Parameters:
    
    itemIds - the item identifiers of data to be deleted.
    
    Throws:
    
    UnsupportedOperationException - if delete operation is not supported on this source.
    
    PortalException
    
    Since:
    
    10.4.0
  - sendPreDeleteDataNotification
```
protected void sendPreDeleteDataNotification(SourcePreDeleteDataEvent event)
                                      throws PortalException
```
    Called before data is deleted from the persistence.
    The default implementation of this method notifies observers of the event using portal event manager.
    
    Parameters:
    
    event - the event that contains information about the delete operation.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    deleteDataByItemIds(Collection), IPortalEventManager.notifyObservers(IPortalEvent)
  - sendPostDeleteDataNotification
```
protected void sendPostDeleteDataNotification(SourcePostDeleteDataEvent event)
                                       throws PortalException
```
    Called after data is deleted from the persistence.
    The default implementation of this method notifies observers of the event using portal event manager.
    
    Parameters:
    
    event - the event that contains information about the delete operation.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    deleteDataByItemIds(Collection), IPortalEventManager.notifyObservers(IPortalEvent)
  - preDeleteFieldData
```
protected void preDeleteFieldData(SourcePreDeleteDataEvent event)
                           throws PortalException
```
    Called before fields data are deleted from the persistence.
    The default implementation of this method calls ISourceField.preDelete(SourcePreDeleteDataEvent) on each field of this source.
    
    Parameters:
    
    event - the event that contains information about the delete operation.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    deleteDataByItemIds(Collection)
  - postDeleteFieldData
```
protected void postDeleteFieldData(SourcePostDeleteDataEvent event)
                            throws PortalException
```
    Called after fields data are deleted from the persistence.
    The default implementation of this method calls ISourceField.preDelete(SourcePreDeleteDataEvent) on each field of this source.
    
    Parameters:
    
    event - the event that contains information about the delete operation.
    
    Throws:
    
    PortalException
    
    Since:
    
    10.4.0
    
    See Also:
    
    deleteDataByItemIds(Collection)
  - doDeleteDataByItemIds
```
protected void doDeleteDataByItemIds(Collection<String> itemIds)
                              throws PortalException
```
    Deletes the data in the persistence.
    This method is called by deleteDataByItemIds(Collection) and is to be overridden by sources that supports delete operation and uses the default deleteData implementation.
    The implementation of this method in Source throws UnsupportedOperationException.
    
    Parameters:
    
    itemIds - the item identifiers of data to be deleted.
    
    Throws:
    
    UnsupportedOperationException - if delete operation is not supported on this source.
    
    PortalException
    
    Since:
    
    10.4.0

Class Source<F extends ISourceField>

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.util.Observable

Methods inherited from class java.lang.Object

Field Detail

SOURCE_READ_DATA_ON_DEMAND

SOURCE_READ_DATA_NEVER

SOURCE_READ_DATA_ALWAYS

id

metaDataSourceId

connectionId

parameters

sourceContext

sourceDefinitionNode

administrationInterfaceId

addInterfaceId

editInterfaceId

detailsInterfaceId

fieldsMap

fields

load

readData

primaryNameSourceField

introductionSourceField

keywordsSourceField

Constructor Detail

Source

Method Detail

isAdministrationInterface

readFieldsIntoFieldsMap

createCustomSourceField

createSourceField

createSourceFilter

createDefaultFilterInstance

createDefaultCompositeFilterInstance

getFilter

getId

getParameterClass

setParameterValue

setParameterValue

getParameterValue

valueChanged

getDefinitionNode

getAdministrationInterfaceId

getAddInterfaceId

getEditInterfaceId

getDetailsInterfaceId

getDataProvider

getDefaultProviderClass

getData

setLoad

getLoad

getTransaction

load

postProcessSource

convertDataToDefinedDataTypes

getReadData

setReadData

getFiltersNode

applyPostLoadFilters

getSourceContext

getDouiContext

getSourceContainer

getDistinct

getMetaDataSourceId

getField

getFields

getPrimaryNameField

getIntroductionField

getIntroductionImageField

getPublishStartDateField

getKeywordsField

getDouiHyperlinkItemParameterField

getHyperlinkDefaultParameters

isDetails

getBigDataPersister

getDefaultBigDataPersister

isRenderDataChangedNotificationEnabled