com.atlassian.jira.util
Class JiraEntityUtils

java.lang.Object
  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	createEntityMap(List 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) This method will return the project relevant to a given entity.
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

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 createEntityMap(List 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