Module jp.ecuacion.splib.web
Package jp.ecuacion.splib.web.bean

Class HtmlItem

java.lang.Object
jp.ecuacion.splib.web.bean.HtmlItem
Direct Known Subclasses:
HtmlItemNumber, HtmlItemString
public class HtmlItem extends Object
Stores attributes of an html component which control the behaviors of the component in html pages.

HtmlItem is a kind of "item"s. See naming-convention.md

  • Field Details

    • itemPropertyPath

      @Nonnull protected String itemPropertyPath
      Is the ID string of htmlItem.

      rootRecordName part (= far left part) can be omitted. Namely it can be "name" or "dept.name" when the propertyPath with rootRecordName added (= also called "recordPropertyPath") is "acc.name" or "acc.dept.name" where "acc" is the rootRecordName.

    • itemNameKeyClass

      protected String itemNameKeyClass
      Is a class part (= left part) of itemNameKey. (like "acc" from itemNameKey: "acc.name")

      The display name can be obtained by referring item_names.properties with it.

    • itemNameKeyField

      protected String itemNameKeyField
      Is a field part (= right part) of itemNameKey. (like "name" from itemNameKey: "acc.name")

      The display name can be obtained by referring item_names.properties with it.

    • isNotEmpty

      protected HtmlItem.HtmlItemConditionContainer<Boolean> isNotEmpty
      Shows whether the field allows empty.

      When this value is true, required validation is executed on server side, and shows "required" mark on the component in the html page.

      It doesn't depend on the data type.

      The default value is preset: false. So the value becomes false if you don't set this value.

    • isNotEmptyOnSearch

      protected HtmlItem.HtmlItemConditionContainer<Boolean> isNotEmptyOnSearch

  • Constructor Details

    • HtmlItem

      public HtmlItem(@RequireNonempty String itemPropertyPath)
      Constructs a new instance with itemPropertyPath.

      Generally propertyPath starts with a rootRecord (a record field name which is directly defined in a form), which should be like user.name or user.dept.name. (It's called recordPropertyPath in the library.)
      But here you need to set itemPropertyPath, which is a propertyPath with rootRecordName + "." removed at the start part of it.

      You cannot set recordPropertyPath here. Setting it is considered as a duplication of rootRecordName.

      Parameters:
      itemPropertyPath - itemPropertyPath

  • Method Details

    • getItemPropertyPath

      public String getItemPropertyPath()

    • itemNameKey

      public HtmlItem itemNameKey(@RequireNonempty String itemNameKey)
      Sets itemNameKey and returns this for method chain.

      The format of itemNameKey is the same as itemNameKey, which is like "acc.name", always has one dot (not more than one) in the middle of the string.
      But the argument of the method can be like "name". In that case itemNameKeyClass is used instead. When itemNameKeyClass is null, rootRecordName is used instead.

      Parameters:
      itemNameKey - itemNameKey
      Returns:
      HtmlItem

    • getItemNameKey

      public String getItemNameKey(String rootRecordName)
      Returns itemNameKey value.

      Its value is null means the item's original itemNameKey is equal to itemNameKey.

      Returns:
      itemNameKeyFieldForName

    • required

      @Deprecated public HtmlItem required()
      Deprecated.
      Sets required = true.
      Returns:
      HtmlItem

    • required

      @Deprecated public HtmlItem required(boolean isRequired)
      Deprecated.
      Sets required.
      Returns:
      HtmlItem

    • required

      @Deprecated public HtmlItem required(HtmlItem.HtmlItemConditionKeyEnum authKind, String authString, boolean isRequired)
      Deprecated.
      Sets isRequired with the conditions of HtmlItemConditionKeyEnum, authString.

      When you set multiple conditions to it, the order matters. First condition prioritized.

      Parameters:
      authKind - authKind
      authString - authString
      isRequired - isRequired
      Returns:
      HtmlItem

    • requiredOnSearch

      @Deprecated public HtmlItem requiredOnSearch(boolean isRequired)
      Deprecated.
      Sets required.
      Returns:
      HtmlItem

    • requiredOnSearch

      @Deprecated public HtmlItem requiredOnSearch(HtmlItem.HtmlItemConditionKeyEnum authKind, String authString, boolean isRequired)
      Deprecated.
      Sets isRequiredOnSearch with the conditions of HtmlItemConditionKeyEnum, authString.

      When you set multiple conditions to it, the order matters. First condition prioritized.

      Parameters:
      authKind - authKind
      authString - authString
      isRequired - isRequired
      Returns:
      HtmlItem

    • getRequiredOnSearch

      @Deprecated public boolean getRequiredOnSearch(String loginState, SplibSecurityUtil.RolesAndAuthoritiesBean bean)
      Deprecated.
      Obtains isNotEmpty.
      Parameters:
      loginState - loginState
      bean - bean
      Returns:
      boolean

    • notEmpty

      public HtmlItem notEmpty()
      Sets isNotEmpty == true, which means you want the item to be not empty.
      Returns:
      HtmlItem

    • isNotEmpty

      public HtmlItem isNotEmpty(boolean isNotEmpty)
      Sets isNotEmpty.

      Set true when you want to the item is not empty.

      Parameters:
      isNotEmpty - isNotEmpty
      Returns:
      HtmlItem

    • isNotEmpty

      public HtmlItem isNotEmpty(HtmlItem.HtmlItemConditionKeyEnum authKind, String authString, boolean isNotEmpty)
      Sets isNotEmpty with the conditions of HtmlItemConditionKeyEnum, authString.

      When you set multiple conditions to it, the order matters. First condition prioritized.

      Parameters:
      authKind - authKind
      authString - authString
      isNotEmpty - isNotEmpty
      Returns:
      HtmlItem

    • getIsNotEmpty

      public boolean getIsNotEmpty(String loginState, SplibSecurityUtil.RolesAndAuthoritiesBean bean)
      Obtains isNotEmpty.
      Parameters:
      loginState - loginState
      bean - bean
      Returns:
      boolean

    • notEmptyOnSearch

      public HtmlItem notEmptyOnSearch()
      Sets required.
      Returns:
      HtmlItem

    • isNotEmptyOnSearch

      public HtmlItem isNotEmptyOnSearch(boolean isRequired)
      Sets required.
      Returns:
      HtmlItem

    • isNotEmptyOnSearch

      public HtmlItem isNotEmptyOnSearch(HtmlItem.HtmlItemConditionKeyEnum authKind, String authString, boolean isRequired)
      Sets isRequiredOnSearch with the conditions of HtmlItemConditionKeyEnum, authString.

      When you set multiple conditions to it, the order matters. First condition prioritized.

      Parameters:
      authKind - authKind
      authString - authString
      isRequired - isRequired
      Returns:
      HtmlItem

    • getIsNotEmptyOnSearch

      public boolean getIsNotEmptyOnSearch(String loginState, SplibSecurityUtil.RolesAndAuthoritiesBean bean)
      Obtains isNotEmpty.
      Parameters:
      loginState - loginState
      bean - bean
      Returns:
      boolean