com.atlassian.jira.util
Class JiraEntityUtils

java.lang.Object
  extended by com.atlassian.jira.util.JiraEntityUtils

public class JiraEntityUtils
extends Object


Field Summary
static org.apache.commons.collections.Transformer GENERIC_VALUE_TO_ID_TRANSFORMER
          Transformer for turning GenericValue objects into thier Long ids.
static org.apache.commons.collections.Transformer GV_TO_ID_TRANSFORMER
           
 
Method Summary
static Map<Object,Object> createEntityMap(List<org.ofbiz.core.entity.GenericValue> entities, String key, String value)
          Convert any list of entities into a sequenced hash map with two fields.
static org.ofbiz.core.entity.GenericValue getProject(org.ofbiz.core.entity.GenericValue entity)
          Deprecated. Work with Project, Issue and Comment objects instead. Since v5.0.
static Collection transforToIdsCollection(Collection genericValues)
          Creates a new collection of IDs from given collection of generic values.
static List updateDependentEntities(org.ofbiz.core.entity.GenericValue issue, Collection newEntities, String relationType, String changeItemField)
          Deprecated. please use updateDependentEntitiesCheckId(org.ofbiz.core.entity.GenericValue, java.util.Collection, String, String) instead, as it compares ids rather than GenericValues
static List updateDependentEntitiesCheckId(org.ofbiz.core.entity.GenericValue issue, Collection newEntities, String relationType, String changeItemField)
          Slightly changed from updateDependentEntities(org.ofbiz.core.entity.GenericValue, java.util.Collection, String, String) to cope with GV components that have different representation of null and empty strings (eg.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

GV_TO_ID_TRANSFORMER

public static final org.apache.commons.collections.Transformer GV_TO_ID_TRANSFORMER

GENERIC_VALUE_TO_ID_TRANSFORMER

public static final org.apache.commons.collections.Transformer GENERIC_VALUE_TO_ID_TRANSFORMER
Transformer for turning GenericValue objects into thier Long ids. Use with CollectionUtils.collect(java.util.Collection, org.apache.commons.collections.Transformer) etc.

Method Detail

transforToIdsCollection

public static Collection transforToIdsCollection(Collection genericValues)
Creates a new collection of IDs from given collection of generic values.

Parameters:
genericValues - a collection of generic values [GenericValue]
Returns:
a collection of IDs [Long]

getProject

public static org.ofbiz.core.entity.GenericValue getProject(org.ofbiz.core.entity.GenericValue entity)
                                                     throws DataAccessException
Deprecated. Work with Project, Issue and Comment objects instead. Since v5.0.

This method will return the project relevant to a given entity.

For example if you pass in an issue, it will get the related project. If you pass in an action, it will find the issue, and then get the project for it.

Parameters:
entity - Entity to determine the project from
Returns:
Project GenericValue if it can be found, otherwise null
Throws:
DataAccessException - in the event of some datalayer problem.

updateDependentEntitiesCheckId

public static List updateDependentEntitiesCheckId(org.ofbiz.core.entity.GenericValue issue,
                                                  Collection newEntities,
                                                  String relationType,
                                                  String changeItemField)
                                           throws org.ofbiz.core.entity.GenericEntityException
Slightly changed from updateDependentEntities(org.ofbiz.core.entity.GenericValue, java.util.Collection, String, String) to cope with GV components that have different representation of null and empty strings (eg. Oracle) - JRA-12130 Update the dependent entities of this issue (for example versions, fix versions or components)

Parameters:
issue - The issue to update entities for
newEntities - The list of new dependent entities (GenericValue's)
relationType - The dependency (association) type to look at, from IssueRelationConstants
changeItemField - The fieldname of the change items generated
Returns:
A list of change items or an empty list if nothing was changed
Throws:
org.ofbiz.core.entity.GenericEntityException - If something real bad happens

updateDependentEntities

public static List updateDependentEntities(org.ofbiz.core.entity.GenericValue issue,
                                           Collection newEntities,
                                           String relationType,
                                           String changeItemField)
                                    throws org.ofbiz.core.entity.GenericEntityException
Deprecated. please use updateDependentEntitiesCheckId(org.ofbiz.core.entity.GenericValue, java.util.Collection, String, String) instead, as it compares ids rather than GenericValues

Update the dependent entities of this issue (for example versions, fix versions or components)

Parameters:
issue - The issue to update entities for
newEntities - The list of new dependent entities
relationType - The dependency (association) type to look at, from IssueRelationConstants
changeItemField - The fieldname of the change items generated
Returns:
A list of change items or an empty list if nothing was changed
Throws:
org.ofbiz.core.entity.GenericEntityException - If something real bad happens

createEntityMap

public static Map<Object,Object> createEntityMap(List<org.ofbiz.core.entity.GenericValue> entities,
                                                 String key,
                                                 String value)
Convert any list of entities into a sequenced hash map with two fields.

This is most useful for creating ordered maps used to create select boxes in the web interface. (ie createEntityMap(entities, "id", "name") to create an id to name map.

Parameters:
entities - list of GenericValues
key - the element to use as the key
value - the element to use as the value
Returns:
Map iterated in the entities order with key and value pairs as defined by key and value parameters


Copyright © 2002-2014 Atlassian. All Rights Reserved.