Interface FormService

  • All Known Implementing Classes:
    FormServiceImpl

    public interface FormService
    Form service API.

    This service API is designed to support the public facing Form APIs

    Author:
    Gavin Cornwell
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      Form getForm​(Item item)
      Returns a form representation of the given item, all known fields for the item are included.
      Form getForm​(Item item, java.util.List<java.lang.String> fields)
      Returns a form representation of the given item consisting only of the given fields.
      Form getForm​(Item item, java.util.List<java.lang.String> fields, java.util.List<java.lang.String> forcedFields)
      Returns a form representation of the given item consisting only of the given fields.
      Form getForm​(Item item, java.util.List<java.lang.String> fields, java.util.List<java.lang.String> forcedFields, java.util.Map<java.lang.String,​java.lang.Object> context)
      Returns a form representation of the given item consisting only of the given fields.
      Form getForm​(Item item, java.util.List<java.lang.String> fields, java.util.Map<java.lang.String,​java.lang.Object> context)
      Returns a form representation of the given item consisting only of the given fields.
      Form getForm​(Item item, java.util.Map<java.lang.String,​java.lang.Object> context)
      Returns a form representation of the given item, all known fields for the item are included.
      java.lang.Object saveForm​(Item item, FormData data)
      Persists the given form representation for the given item.
    • Method Detail

      • getForm

        Form getForm​(Item item)
        Returns a form representation of the given item, all known fields for the item are included.
        Parameters:
        item - The item to get a form for
        Returns:
        The Form representation
      • getForm

        Form getForm​(Item item,
                     java.util.Map<java.lang.String,​java.lang.Object> context)
        Returns a form representation of the given item, all known fields for the item are included.
        Parameters:
        item - The item to get a form for
        context - Map representing optional context that can be used during retrieval of the form
        Returns:
        The Form representation
      • getForm

        Form getForm​(Item item,
                     java.util.List<java.lang.String> fields)
        Returns a form representation of the given item consisting only of the given fields.
        Parameters:
        item - The item to get a form for
        fields - Restricted list of fields to include, null indicates all possible fields for the item should be included
        Returns:
        The Form representation
      • getForm

        Form getForm​(Item item,
                     java.util.List<java.lang.String> fields,
                     java.util.Map<java.lang.String,​java.lang.Object> context)
        Returns a form representation of the given item consisting only of the given fields.
        Parameters:
        item - The item to get a form for
        fields - Restricted list of fields to include, null indicates all possible fields for the item should be included
        context - Map representing optional context that can be used during retrieval of the form
        Returns:
        The Form representation
      • getForm

        Form getForm​(Item item,
                     java.util.List<java.lang.String> fields,
                     java.util.List<java.lang.String> forcedFields)
        Returns a form representation of the given item consisting only of the given fields.
        Parameters:
        item - The item to get a form for
        fields - Restricted list of fields to include, null indicates all possible fields for the item should be included
        forcedFields - List of field names from 'fields' list that should be forcibly included, it is up to the form processor implementation to determine how to enforce this
        Returns:
        The Form representation
      • getForm

        Form getForm​(Item item,
                     java.util.List<java.lang.String> fields,
                     java.util.List<java.lang.String> forcedFields,
                     java.util.Map<java.lang.String,​java.lang.Object> context)
        Returns a form representation of the given item consisting only of the given fields.
        Parameters:
        item - The item to get a form for
        fields - Restricted list of fields to include, null indicates all possible fields for the item should be included
        forcedFields - List of field names from 'fields' list that should be forcibly included, it is up to the form processor implementation to determine how to enforce this
        context - Map representing optional context that can be used during retrieval of the form
        Returns:
        The Form representation
      • saveForm

        java.lang.Object saveForm​(Item item,
                                  FormData data)
        Persists the given form representation for the given item.
        Parameters:
        item - The item to persist the form for
        data - An object representing the form data to persist
        Returns:
        The object persisted