Class ParamValueDAO

java.lang.Object
ru.bgcrm.dao.CommonDAO
org.bgerp.dao.param.ParamValueDAO
Direct Known Subclasses:
ParamValueDAO

public class ParamValueDAO extends CommonDAO
Parameter values DAO. The primary required public methods are sorted alphabetically. Dependency methods even public, called by those, are placed directly after the first usage.
  • Field Details

    • DIRECTORY_TYPE_PARAMETER

      public static final String DIRECTORY_TYPE_PARAMETER
      See Also:
    • TABLE_NAMES

      public static final String[] TABLE_NAMES
  • Constructor Details

    • ParamValueDAO

      public ParamValueDAO(Connection con)
    • ParamValueDAO

      public ParamValueDAO(Connection con, boolean history, int userId)
  • Method Details

    • copyParam

      public void copyParam(int fromObjectId, int toObjectId, int paramId) throws SQLException, BGException
      Копирует параметр с объекта на объект.
      Parameters:
      fromObjectId - object ID исходного.
      toObjectId - object ID целевого.
      paramId - коды параметра.
      Throws:
      SQLException
      BGException
    • copyParam

      public void copyParam(int fromObjectId, int fromParamId, int toObjectId, int toParamId) throws SQLException, BGException
      Копирует параметр с объекта на объект. Параметры должны быть одного типа.
      Parameters:
      fromObjectId - object ID исходного.
      fromParamId - param ID исходного.
      toObjectId - object ID целевого
      toParamId - param ID целевого.
      Throws:
      SQLException
      BGException
    • copyParams

      public void copyParams(int fromObjectId, int toObjectId, String copyMapping) throws SQLException, BGException
      Копирует параметры с объекта на другой объект по указанной конфигурации.
      Parameters:
      fromObjectId - исходный объект.
      toObjectId - целевой объект.
      copyMapping - конфигурация.
      Throws:
      SQLException
      BGException
    • copyParams

      public void copyParams(int fromObjectId, int toObjectId, Collection<Integer> paramIds) throws SQLException, BGException
      Копирует параметры с объекта на объект
      Parameters:
      fromObjectId - object ID исходного.
      toObjectId - object ID целевого.
      paramIds - коды параметров.
      Throws:
      SQLException
      BGException
    • deleteParams

      public void deleteParams(String objectType, int id) throws SQLException
      Удаляет параметры объекта.
      Parameters:
      objectType - тип объекта.
      id - object ID.
      Throws:
      SQLException
    • getParamAddress

      public ParameterAddressValue getParamAddress(int id, int paramId, int position) throws SQLException
      Возвращает адресный параметр объекта.
      Parameters:
      id - - код объекта.
      paramId - - param ID.
      position - - позиция, начиная от 1, если в параметре установлены несколько значений.
      Returns:
      Throws:
      SQLException
    • getParameterAddressValueFromRs

      public static ParameterAddressValue getParameterAddressValueFromRs(ResultSet rs) throws SQLException
      Throws:
      SQLException
    • getParameterAddressValueFromRs

      public static ParameterAddressValue getParameterAddressValueFromRs(ResultSet rs, String prefix) throws SQLException
      Throws:
      SQLException
    • getParamAddress

      public SortedMap<Integer,ParameterAddressValue> getParamAddress(int id, int paramId) throws SQLException
      Возвращает значения адресного параметра объекта.
      Parameters:
      id - - код объекта.
      paramId - - param ID.
      Returns:
      ключ - позиция, значение - значение на позиции.
      Throws:
      SQLException
    • getParamAddressExt

      public SortedMap<Integer,ParameterAddressValue> getParamAddressExt(int id, int paramId, boolean loadDirs) throws SQLException
      Возвращает значения адресного параметра объекта.
      Parameters:
      id - - код объекта.
      paramId - - param ID.
      loadDirs - - признак необходимости загрузить справочники, чтобы был корректно заполнен ParameterAddressValue.getHouse()/
      Returns:
      ключ - позиция, значение - значение на позиции.
      Throws:
      SQLException
    • getParamAddressExt

      public SortedMap<Integer,ParameterAddressValue> getParamAddressExt(int id, int paramId, boolean loadDirs, String formatName) throws SQLException
      Возвращает значения адресного параметра объекта.
      Parameters:
      id - - код объекта.
      paramId - - param ID.
      loadDirs - - признак необходимости загрузить справочники, чтобы был корректно заполнен ParameterAddressValue.getHouse().
      formatName - - наименование формата адреса из конфигурации, с помощью которого форматировать значение адреса.
      Returns:
      ключ - позиция, значение - значение на позиции.
      Throws:
      SQLException
    • getParameterAddressValueFromRs

      public static ParameterAddressValue getParameterAddressValueFromRs(ResultSet rs, String prefix, boolean loadDirs, String formatName) throws SQLException
      Throws:
      SQLException
    • getParamBlob

      public String getParamBlob(int id, int paramId) throws SQLException
      Selects a value for parameter type 'blob'.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      Throws:
      SQLException
    • getParamDate

      public Date getParamDate(int id, int paramId) throws SQLException
      Selects a value for parameter type 'date'.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      Throws:
      SQLException
    • getParamDateTime

      public Date getParamDateTime(int id, int paramId) throws SQLException
      Selects a value for parameter type 'datetime'.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      Throws:
      SQLException
    • getParamEmail

      public ParameterEmailValue getParamEmail(int id, int paramId, int position) throws SQLException
      Selects a value for parameter type 'email'.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      Throws:
      SQLException
    • getParamEmail

      public SortedMap<Integer,ParameterEmailValue> getParamEmail(int id, int paramId) throws SQLException
      Selects values for parameter type 'email'.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      key - param value position, value - a value itself.
      Throws:
      SQLException
    • getParamFile

      public FileData getParamFile(int id, int paramId, int position) throws SQLException
      Selects a value for parameter type 'file'.
      Parameters:
      id - object ID.
      paramId - param ID.
      position - position number for multiple values.
      Returns:
      Throws:
      SQLException
    • getParamFile

      public SortedMap<Integer,FileData> getParamFile(int id, int paramId) throws SQLException
      Selects values for parameter type 'file'.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      map with key equals value's position.
      Throws:
      SQLException
    • getParamList

      public Set<Integer> getParamList(int id, int paramId) throws SQLException
      Selects a parameter value with type 'list'.
      Parameters:
      id - object ID.
      paramId -
      Returns:
      Set с кодами значений.
      Throws:
      SQLException
    • getParamListWithTitles

      @Deprecated public List<IdTitle> getParamListWithTitles(int id, int paramId) throws SQLException
      Deprecated.
      Selects a parameter value with type 'list' с наименованиями значений.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      Throws:
      SQLException
    • getParamListWithComments

      public Map<Integer,String> getParamListWithComments(int id, int paramId) throws SQLException
      Selects a parameter value with type 'list' с комментариями значений.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      ключ - код значения, значение - комментарий.
      Throws:
      SQLException
    • getParamListWithTitlesAndComments

      @Deprecated public List<IdTitleComment> getParamListWithTitlesAndComments(int id, int paramId) throws SQLException
      Deprecated.
      Selects a parameter value with type 'list' с наименованиями значений и примечаниями.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      Throws:
      SQLException
    • getParamListCount

      public Map<Integer,BigDecimal> getParamListCount(int id, int paramId) throws SQLException
      Selects a parameter value with type 'listcount'.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      a map with key equals value IDs and values counts.
      Throws:
      SQLException
    • getParamListCountWithTitles

      @Deprecated public List<IdTitle> getParamListCountWithTitles(int id, int paramId) throws SQLException
      Deprecated.
      Selects a parameter value with type 'listcount' с наименованиями значений.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      Throws:
      SQLException
    • getParamMoney

      public BigDecimal getParamMoney(int id, int paramId) throws SQLException
      Selects a parameter value with type 'money'.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      the value or null.
      Throws:
      SQLException
    • getParamPhone

      public ParameterPhoneValue getParamPhone(int id, int paramId) throws SQLException
      Selects a parameter value with type 'phone'.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      the value or null.
      Throws:
      SQLException
    • getParamPhoneValueItemFromRs

      public static ParameterPhoneValueItem getParamPhoneValueItemFromRs(ResultSet rs) throws SQLException
      Throws:
      SQLException
    • getParamText

      public String getParamText(int id, int paramId) throws SQLException
      Selects a value of parameter with type 'text'.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      Throws:
      SQLException
    • getParamTree

      public Set<String> getParamTree(int id, int paramId) throws SQLException
      Selects a parameter value with type 'tree'.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      набор значений.
      Throws:
      SQLException
    • getParamTreeWithTitles

      @Deprecated public List<IdStringTitle> getParamTreeWithTitles(int id, int paramId) throws SQLException
      Deprecated.
      Значения параметра объекта типа 'tree' с текстовыми наименованиями.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      Throws:
      SQLException
    • getParamTreeCount

      public Map<String,BigDecimal> getParamTreeCount(int id, int paramId) throws SQLException
      Selects parameter values with type 'treecount'.
      Parameters:
      id - object ID.
      paramId - param ID.
      Returns:
      map with a key equal to the parameter value ID, and the value - value amount (count).
      Throws:
      SQLException
    • isParameterFilled

      public boolean isParameterFilled(int id, Parameter param) throws Exception
      Проверяет заполненость параметра для объекта с кодом id.
      Parameters:
      id - object ID.
      param - параметр.
      Returns:
      Throws:
      Exception
    • objectIdInvert

      public void objectIdInvert(String objectType, int currentObjectId) throws SQLException
      Переносит параметры при с кода объекта на -код объекта. Используется при преобразовании не созданного до конца процесса с отрицательным кодом в созданный.
      Parameters:
      objectType -
      currentObjectId -
      Throws:
      SQLException
    • parameters

      public Map<Integer,ParameterValuePair> parameters(Id object) throws SQLException
      Loads parameters for Customer, Process, User or AddressHouse.
      Parameters:
      object - customer or process.
      Returns:
      Throws:
      SQLException
    • updateParamAddress

      public void updateParamAddress(int id, int paramId, int position, ParameterAddressValue value) throws SQLException
      Updates, appends and deletes an address parameter value.
      Parameters:
      id - - entity ID.
      paramId - - param ID.
      position - - starting from 1 value's position, 0 - appends a value with position MAX+1.
      value - - the value, null - delete value from the position if position > 0, else delete all the values.
      Throws:
      SQLException
    • updateParamsAddressOnHouseUpdate

      public void updateParamsAddressOnHouseUpdate(int houseId) throws SQLException
      Обновляет строки адресных параметров для дома. Используется после изменений в адресных справочников, для генерации корректных строк с адресными параметрами.
      Parameters:
      houseId - код дома.
      Throws:
      SQLException
    • updateParamBlob

      public void updateParamBlob(int id, int paramId, String value) throws SQLException
      Устанавливает значение параметра типа 'blob'.
      Parameters:
      id - object ID.
      paramId - param ID.
      value - значение, null или пустая строка - удалить значение.
      Throws:
      SQLException
    • updateParamDate

      public void updateParamDate(int id, int paramId, Date value) throws SQLException
      Устанавливает значение параметра типа 'date'.
      Parameters:
      id - object ID.
      paramId - param ID.
      value - значение, null - удаление.
      Throws:
      SQLException
    • updateParamDateTime

      public void updateParamDateTime(int id, int paramId, Date value) throws SQLException
      Устанавливает значение параметра типа 'datetime'.
      Parameters:
      id - object ID.
      paramId - param ID.
      value - значение, null - удаление.
      Throws:
      SQLException
    • updateParamEmail

      public void updateParamEmail(int id, int paramId, int position, ParameterEmailValue value) throws SQLException
      Обновляет/добавляет/удаляет значения параметра типа EMail.
      Parameters:
      id - - код сущности в БД.
      paramId - - param ID.
      position - - позиция значения, начинается с 1, 0 - добавить новое значение с позицией MAX+1.
      value - - значение, null - удаление параметра на указанной позиции, если position>0; иначе - удаление всех значений.
      Throws:
      SQLException
    • updateParamFile

      public void updateParamFile(int id, int paramId, int position, FileData fileData) throws Exception
      Updates parameter with type 'file'.
      Parameters:
      id - object ID.
      paramId - param ID.
      position - position for multiple values, when is 0 - adding with new positions.
      fileData - value for the given position, if null - removes a value from the position or all values with position == -1.
      Throws:
      Exception
    • updateParamFile

      @Deprecated public void updateParamFile(int id, int paramId, int position, String comment, FileData fileData) throws Exception
      Deprecated.
      Throws:
      Exception
      See Also:
    • updateParamList

      public void updateParamList(int id, int paramId, Set<Integer> values) throws SQLException
      Устанавливает значения параметра типа 'list' с пустыми примечениями.
      Parameters:
      id - object ID.
      paramId - param ID.
      values - набор с кодами значений.
      Throws:
      SQLException
    • updateParamListWithComments

      public void updateParamListWithComments(int id, int paramId, Map<Integer,String> values) throws SQLException
      Устанавливает значения параметра типа 'list' с примечаниями.
      Parameters:
      id - object ID.
      paramId - param ID.
      values - ключ - значение параметра, значение - текстовое примечание.
      Throws:
      SQLException
    • updateParamList

      @Deprecated public void updateParamList(int id, int paramId, Map<Integer,String> values) throws SQLException
      Deprecated.
      Throws:
      SQLException
    • updateParamListCount

      public void updateParamListCount(int id, int paramId, Map<Integer,?> values) throws SQLException
      Sets values for parameter with type 'listcount'.
      Parameters:
      id - entity ID.
      paramId - param ID.
      values - map with key = value ID, and values with possible types: String, BigDecimal.
      Throws:
      SQLException
    • updateParamListCount

      @Deprecated public void updateParamListCount(int id, int paramId, Map<Integer,Double> values, Map<Integer,String> valuesComments) throws SQLException
      Deprecated.
      Использовать updateParamListCount(int, int, Map).
      Throws:
      SQLException
    • updateParamMoney

      public void updateParamMoney(int id, int paramId, BigDecimal value) throws SQLException
      Updates parameter with type 'money'.
      Parameters:
      id - object ID.
      paramId - param ID.
      value - the value, when null - delete.
      Throws:
      SQLException
    • updateParamMoney

      public void updateParamMoney(int id, int paramId, String value) throws SQLException
      Updates parameter with type 'money'.
      Parameters:
      id - object ID.
      paramId - param ID.
      value - the value, when null or a blank string - delete.
      Throws:
      SQLException
    • updateParamPhone

      public void updateParamPhone(int id, int paramId, ParameterPhoneValue value) throws SQLException
      Sets values for parameter with type 'phone'.
      Parameters:
      id - object ID.
      paramId - param ID.
      value - the values, null or empty itemList - delete values.
      Throws:
      SQLException
    • updateParamText

      public void updateParamText(int id, int paramId, String value) throws SQLException
      Sets a value for parameter with type 'text'.
      Parameters:
      id - object ID.
      paramId - param ID.
      value - the value, null or emtpy string - delete value.
      Throws:
      SQLException
    • updateParamTree

      public void updateParamTree(int id, int paramId, Set<String> values) throws SQLException
      Sets values for parameter with type 'tree'.
      Parameters:
      id - object ID.
      paramId - param ID.
      values - the values, null or empty set - delete values.
      Throws:
      SQLException
    • updateParamTreeCount

      public void updateParamTreeCount(int id, int paramId) throws SQLException
      Throws:
      SQLException
    • updateParamTreeCount

      public void updateParamTreeCount(int id, int paramId, Map<String,BigDecimal> values) throws SQLException
      Sets values for parameter with type 'treecount'.
      Parameters:
      id - object ID.
      paramId - param ID.
      values - the values map (key - treecount value ID, value - 'count'), null or emtpy map - delete values.
      Throws:
      SQLException
    • loadParameters

      public List<ParameterValuePair> loadParameters(List<Parameter> paramList, int id) throws SQLException
      Loads parameter's values.
      Parameters:
      paramList - parameters list.
      id - entity id.
      Throws:
      SQLException
    • loadParameters

      public List<ParameterValuePair> loadParameters(List<Parameter> paramList, int id, boolean offEncryption) throws SQLException
      Loads parameter's values.
      Parameters:
      paramList - parameters list.
      id - entity id.
      offEncryption - decrypt pseudo encrypted values.
      Throws:
      SQLException
    • loadParameterValue

      @Deprecated public void loadParameterValue(ParameterValuePair param, int objectId, boolean offEncription) throws Exception
      Deprecated.
      Throws:
      Exception
    • searchObjectByParameterPhone

      @Deprecated public Set<Integer> searchObjectByParameterPhone(int parameterId, ParameterPhoneValue parameterPhoneValue) throws SQLException
      Deprecated.
      Throws:
      SQLException
      See Also:
    • searchObjectByParameterAddress

      @Deprecated public Set<Integer> searchObjectByParameterAddress(int parameterId, ParameterAddressValue parameterAddressValue) throws SQLException
      Deprecated.
      Throws:
      SQLException
      See Also:
    • searchObjectByParameterText

      @Deprecated public Set<Integer> searchObjectByParameterText(int parameterId, String parameterTextValue) throws SQLException
      Deprecated.
      Throws:
      SQLException
      See Also:
    • searchObjectByParameterList

      @Deprecated public Set<Integer> searchObjectByParameterList(int parameterId, int value) throws Exception
      Deprecated.
      Throws:
      Exception
      See Also: