er.extensions.foundation

Class ERXUtilities

java.lang.Object

er.extensions.foundation.ERXUtilities

public class ERXUtilities
extends Object

Diverse collection of utility methods for handling everything from EOF to foundation. In the future this class will most likely be split into more meaning full groups of utility methods.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ERXUtilities.BooleanCallback Generic boolean callback interface with a context object.
static interface	ERXUtilities.BooleanOperation Useful interface for binding objects to WOComponent bindings where you want to delay the evaluation of the boolean operation until valueForBinding is actually called.
static interface	ERXUtilities.Callback Generic callback interface with a context object.
static interface	ERXUtilities.Operation Useful interface for binding objects to WOComponent bindings where you want to delay the evaluation of the operation until valueForBinding is actually called.

Constructor Summary

Constructors

Constructor and Description
ERXUtilities()

Method Summary

Modifier and Type	Method and Description
static NSArray	allFrameworkNames() Utility method to get all of the framework names that have been loaded into the application.
static com.webobjects.eoaccess.EOEntity	caseInsensitiveEntityNamed(String entityName) Finds an entity given a case insensitive search of all the entity names.
static <T> T	deepClone(T obj, boolean onlyCollections) Returns a deep clone of the given object.
static NSArray	deletedObjectsPKeys(com.webobjects.eocontrol.EOEditingContext ec) Utility method for returning all of the primary keys for all of the objects that are marked for deletion in the editing context.
static void	deleteObjects(com.webobjects.eocontrol.EOEditingContext ec, NSArray objects) Simple utility method for deleting an array of objects from an editing context.
static void	deplicateRelationshipFromEO(com.webobjects.eocontrol.EOEnterpriseObject r1, String relationshipName) Copies a relationship from one EO to another using the name of the relationship
static NSArray	entitiesForModelGroup(com.webobjects.eoaccess.EOModelGroup group) Simple utility method for getting all of the entities for all of the models of a given model group.
static String	escapeApostrophe(String aString) Gets rid of all ' from a String.
static NSDictionary	relationshipEntityWithEntityAndKeyPath(com.webobjects.eoaccess.EOEntity srcentity, String keyPath)
static com.webobjects.eocontrol.EOEnterpriseObject	relationshipObjectWithObjectAndKeyPath(com.webobjects.eocontrol.EOEnterpriseObject object, String keyPath)
static com.webobjects.eoaccess.EORelationship	relationshipWithObjectAndKeyPath(com.webobjects.eocontrol.EOEnterpriseObject object, String keyPath) Traverses a key path to return the last EORelationship object.
static void	replicateDataFromEOToEO(com.webobjects.eocontrol.EOEnterpriseObject r1, com.webobjects.eocontrol.EOEnterpriseObject r2, NSArray attributeNames) Copies values from one EO to another using an array of Attributes
static void	replicateRelationshipFromEOToEO(com.webobjects.eocontrol.EOEnterpriseObject r1, com.webobjects.eocontrol.EOEnterpriseObject r2, String relationshipName) Copies a relationship from one EO to another using the name of the relationship
static String	stackTrace() Generates a string representation of the current stacktrace.
static String	stackTrace(Throwable t) Converts a throwable's stacktrace into a string representation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ERXUtilities

public ERXUtilities()

Method Detail

deletedObjectsPKeys

public static NSArray deletedObjectsPKeys(com.webobjects.eocontrol.EOEditingContext ec)

Utility method for returning all of the primary keys for all of the objects that are marked for deletion in the editing context.

Parameters:

ec - editing context

Returns:

an array containing all of the dictionaries of primary keys for all of the objects marked for deletion

relationshipWithObjectAndKeyPath

public static com.webobjects.eoaccess.EORelationship relationshipWithObjectAndKeyPath(com.webobjects.eocontrol.EOEnterpriseObject object,
                                                                                      String keyPath)

Traverses a key path to return the last EORelationship object.

Note: that this method uses the object and not the model to traverse the key path, this has the added benefit of handling EOF inheritance

Parameters:

object - enterprise object to find the relationship off of

keyPath - key path used to find the relationship

Returns:

relationship object corresponding to the last property key of the key path.

relationshipEntityWithEntityAndKeyPath

public static NSDictionary relationshipEntityWithEntityAndKeyPath(com.webobjects.eoaccess.EOEntity srcentity,
                                                                  String keyPath)

relationshipObjectWithObjectAndKeyPath

public static com.webobjects.eocontrol.EOEnterpriseObject relationshipObjectWithObjectAndKeyPath(com.webobjects.eocontrol.EOEnterpriseObject object,
                                                                                                 String keyPath)

deleteObjects

public static void deleteObjects(com.webobjects.eocontrol.EOEditingContext ec,
                                 NSArray objects)

Simple utility method for deleting an array of objects from an editing context.

Parameters:

ec - editing context to have objects deleted from

objects - objects to be deleted.

allFrameworkNames

public static NSArray allFrameworkNames()

Utility method to get all of the framework names that have been loaded into the application.

Returns:

array containing all of the framework names

entitiesForModelGroup

public static NSArray entitiesForModelGroup(com.webobjects.eoaccess.EOModelGroup group)

Simple utility method for getting all of the entities for all of the models of a given model group.

Parameters:

group - eo model group

Returns:

array of all entities for a given model group.

caseInsensitiveEntityNamed

public static com.webobjects.eoaccess.EOEntity caseInsensitiveEntityNamed(String entityName)

Finds an entity given a case insensitive search of all the entity names.

Note: The current implementation caches the entity-entity name pair in an insensitive manner. This means that all of the models should be loaded before this method is called.

stackTrace

public static String stackTrace()

Generates a string representation of the current stacktrace.

Returns:

current stacktrace.

stackTrace

public static String stackTrace(Throwable t)

Converts a throwable's stacktrace into a string representation.

Parameters:

t - throwable to print to a string

Returns:

string representation of stacktrace

escapeApostrophe

public static String escapeApostrophe(String aString)

Gets rid of all ' from a String.

Parameters:

aString - string to check

Returns:

string without '

replicateDataFromEOToEO

public static void replicateDataFromEOToEO(com.webobjects.eocontrol.EOEnterpriseObject r1,
                                           com.webobjects.eocontrol.EOEnterpriseObject r2,
                                           NSArray attributeNames)

Copies values from one EO to another using an array of Attributes

replicateRelationshipFromEOToEO

public static void replicateRelationshipFromEOToEO(com.webobjects.eocontrol.EOEnterpriseObject r1,
                                                   com.webobjects.eocontrol.EOEnterpriseObject r2,
                                                   String relationshipName)

Copies a relationship from one EO to another using the name of the relationship

deplicateRelationshipFromEO

public static void deplicateRelationshipFromEO(com.webobjects.eocontrol.EOEnterpriseObject r1,
                                               String relationshipName)

Copies a relationship from one EO to another using the name of the relationship

deepClone

public static <T> T deepClone(T obj,
                              boolean onlyCollections)

Returns a deep clone of the given object. A deep clone will attempt to clone any contained values (in the case of an NSArray or NSDictionary) as well as the value itself.

Parameters:

obj - the object to clone

onlyCollections - if true, only collections will be cloned, not individual values

Returns:

a deep clone of obj