Class EclibItem

java.lang.Object
jp.ecuacion.lib.core.item.EclibItem
public class EclibItem extends Object
Stores item attributes.

To understand details on item, see naming-convention.md

  • Field Details

    • itemPropertyPath

      @Nonnull protected String itemPropertyPath
      Is the ID string of an item.

      rootRecordName part (= far left part) can be omitted. Namely it can be "name" or "dept.name" when the propertyPath with rootRecordName (= 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")

      It is set by itemNameKey(String) and only when its argument contains ".".

      The itemNameKeyClass obtained from @ItemNameKeyClass is not stored in it because the value from @ItemNameKeyClass is a default value when this field is null.

    • itemNameKeyField

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

    • showsValue

      protected boolean showsValue
      Is false when the value should not be open to public (like password).

      Default value is true.

  • Constructor Details

    • EclibItem

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

      You cannot set recordPropertyPath here. Setting it caauses a duplication of rootRecordName and it cannot be found.

      Parameters:
      itemPropertyPath - itemPropertyPath

  • Method Details

    • itemNameKey

      public EclibItem 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", itemNameKeyField only. In that case the value of itemnameKeyClass is determined by the rule written at getItemNameKey(rootRecordName) javadoc.

      Parameters:
      itemNameKey - itemNameKey
      Returns:
      Item

    • getItemPropertyPath

      public String getItemPropertyPath()

    • setsItemNameKeyClassExplicitly

      public boolean setsItemNameKeyClassExplicitly()
      Returns whether the itemNameKeyClass is set explicitly.
      Returns:
      boolean

    • getItemNameKey

      @Nonnull public String getItemNameKey(@Nullable String defaultItemNameKeyClass)
      Returns itemNameKey value.

      There can be 5 candidates for itemNameKeyClass. Candidates are ordered by their priority. They are adopted only when they are not empty. The last one is never null.
      1: itemNameKeyClass part of itemNameKey set by itemNameKey(itemNameKey)
      2: itemNameKeyClass part of itemPropertyPath set by constructor
      3: itemNameKeyClassFromAnnotation set by setItemNameKeyClassFromAnnotation(String)
      4: defaultItemNameKeyClass, the argument of this method
      5: uncapitalized className (always set by EclibItemContainer#getItem(String))

    • getItemNameKey

      @Nonnull public String getItemNameKey()
      Returns itemNameKey value.

      See getItemNameKey(@Nullable String defaultItemNameKeyClass) with defaultItemNameKeyClass = null.

    • hideValue

      public EclibItem hideValue()
      Hides value from error messages and so on.

    • getShowsValue

      public boolean getShowsValue()

    • setItemNameKeyClassFromAnnotation

      public void setItemNameKeyClassFromAnnotation(String itemNameKeyClas)

    • setItemNameKeyClassFromClassName

      public void setItemNameKeyClassFromClassName(String itemNameKeyClassFromClassName)