Package de.hybris.platform.integrationservices.item

Interface IntegrationItem

  • All Known Implementing Classes:
    DefaultIntegrationItem
    public interface IntegrationItem
    Representation of a data item sent into the integration services or sent out of the integration services. Integration item must correspond to one of the IntegrationObjectItemModel definitions. If IntegrationObjectItemModel represents a type of the data structures, then the IntegrationItem is a particular instance of that type carrying particular data values.

    • Method Detail

      • getIntegrationObjectCode

        java.lang.String getIntegrationObjectCode()
        Retrieves code of the IntegrationObjectModel this item belongs to.
        Returns:
        value of the integration object code

      • getIntegrationKey

        java.lang.String getIntegrationKey()
        Retrieves integration key value for this item.
        Returns:
        calculated integration key value for the item content.

      • setAttribute

        boolean setAttribute​(java.lang.String attribute,
                     java.lang.Object value)
        Sets value of an attribute in this item.
        Parameters:
        attribute - name of the attribute whose value needs to be set.
        value - a value for the attribute. In order to set a value for a localized attribute, LocalizedValue should be passed as the value.
        Returns:
        true, if the value was successfully set, or false, if the specified attribute does not exist for this item.

      • getAttribute

        java.lang.Object getAttribute​(java.lang.String name)
        Retrieves value of an attribute.
        Parameters:
        name - name of the attribute to read.
        Returns:
        value for the specified attribute in this item or null, if the attribute has not been set yet or does not exist.

      • getLocalizedAttribute

        java.lang.String getLocalizedAttribute​(java.lang.String attribute,
                                       java.util.Locale lang)
        Reads value of a localized attribute. This method should ensure the specified attribute is indeed localized. Otherwise, the implementations should not return a value or indicate the problem by throwing an exception.
        Parameters:
        attribute - name of the attribute to read
        lang - language, for which the attribute should be read
        Returns:
        value of the specified attribute in the specified language or null, if either the attribute or the language does not have a value set.

      • getLocalizedAttribute

        java.lang.String getLocalizedAttribute​(java.lang.String attribute,
                                       java.lang.String lang)
        Reads value of a localized attribute.
        Parameters:
        attribute - name of the attribute to read
        lang - ISO code of the language, e.g. 'en' or 'es_CO', for which the attribute should be read. This is the value that can be read from Locale as Locale.toLanguageTag()
        Returns:
        value of the specified attribute in the specified language or null, if either the attribute or the language does not have a value set.

      • getReferencedItem

        IntegrationItem getReferencedItem​(java.lang.String attribute)
        Retrieves an integration item referenced by specified attribute. It does the same as calling getAttribute(String) but there is no need to cast result of that call to IntegrationItem.
        Parameters:
        attribute - name of the attribute, whose value is a nested IntegrationItem
        Returns:
        the referenced item or null, if this item does not contain the referenced item for the specified attribute name.

      • getReferencedItems

        java.util.Collection<IntegrationItem> getReferencedItems​(java.lang.String attribute)
        Retrieves multiple integration items referenced by specified attribute. It does the same as calling getAttribute(String) but there is no need to cast result of that call to Collection<IntegrationItem>.
        Parameters:
        attribute - name of the attribute, whose value is a collection of nested IntegrationItems
        Returns:
        the referenced items. if this item does not contain referenced items for the specified attribute name, an empty collection is returned. If the attribute references a single instance of an IntegrationItem instead of a collection, then a collection with that single item will be returned.