er.extensions.eof

Class ERXQuery.Record

java.lang.Object

er.extensions.eof.ERXQuery.Record

All Implemented Interfaces:

com.webobjects.foundation.NSKeyValueCoding, com.webobjects.foundation.NSKeyValueCodingAdditions

Enclosing class:

ERXQuery

public static class ERXQuery.Record
extends Object
implements com.webobjects.foundation.NSKeyValueCoding, com.webobjects.foundation.NSKeyValueCodingAdditions

Convenience class for fetching data into records conforming to key value coding. What is special about this record is its handling of key-value-coding. For example, when fetching keys that represent a key path to another object, i.e. "a.b.c", then the records fetched end up with C objects as values for the key named "a.b.c". If you use regular dictionaries to fetch these records then you would have to use valueForKey() or objectForKey() to retrieve the C object stored under the key "a.b.c". You would then be able to apply a key path to C. For example, instead of this boilerplate:

 String name = "";
 C c = null;
 Object value = rec.objectForKey("a.b.c");
 if (value != NSKeyValueCoding.NullValue) {
     c = (C) value;
     name = (String) c.valueForKeyPath("x.y.name");
 }
 

you can use regular valueForKeyPath() like this:

 String name = (String) rec.valueForKeyPath("a.b.c.x.y.name");
 

Values of NSKeyValueCoding.NullValue are automatically translated to null and you can use the valueForKeyPathWithDefault() method to translate null to a default value and get rid of casting the value like this:

 String name = rec.valueForKeyPathWithDefault("a.b.c.x.y.name", "");
 

Nested Class Summary

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

com.webobjects.foundation.NSKeyValueCodingAdditions.DefaultImplementation, com.webobjects.foundation.NSKeyValueCodingAdditions.Utility

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCoding

com.webobjects.foundation.NSKeyValueCoding._BooleanFieldBinding, com.webobjects.foundation.NSKeyValueCoding._BooleanMethodBinding, com.webobjects.foundation.NSKeyValueCoding._FieldBinding, com.webobjects.foundation.NSKeyValueCoding._ForwardingBinding, com.webobjects.foundation.NSKeyValueCoding._KeyBinding, com.webobjects.foundation.NSKeyValueCoding._KeyBindingCreation, com.webobjects.foundation.NSKeyValueCoding._MethodBinding, com.webobjects.foundation.NSKeyValueCoding._NumberFieldBinding, com.webobjects.foundation.NSKeyValueCoding._NumberMethodBinding, com.webobjects.foundation.NSKeyValueCoding._ReflectionKeyBindingCreation, com.webobjects.foundation.NSKeyValueCoding.ErrorHandling, com.webobjects.foundation.NSKeyValueCoding.MapImplementation, com.webobjects.foundation.NSKeyValueCoding.Null<T>, com.webobjects.foundation.NSKeyValueCoding.UnknownKeyException, com.webobjects.foundation.NSKeyValueCoding.ValueAccessor

Field Summary

Fields inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

_CLASS, _KeyPathSeparatorChar, KeyPathSeparator

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding

NullValue

Constructor Summary

Constructors

Constructor and Description
Record(com.webobjects.eocontrol.EOEditingContext context, NSMutableDictionary<String,Object> row)

Method Summary

Modifier and Type	Method and Description
void	takeValueForKey(Object value, String key)
void	takeValueForKeyPath(Object value, String keyPath)
String	toString()
Object	valueForKey(String key)
Object	valueForKeyPath(String keyPath)
<V> V	valueForKeyPathWithDefault(String keyPath, V defaultValue)

Methods inherited from class java.lang.Object

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

Constructor Detail

Record

public Record(com.webobjects.eocontrol.EOEditingContext context,
              NSMutableDictionary<String,Object> row)

Method Detail

takeValueForKey

public void takeValueForKey(Object value,
                            String key)

Specified by:

takeValueForKey in interface com.webobjects.foundation.NSKeyValueCoding

valueForKey

public Object valueForKey(String key)

Specified by:

valueForKey in interface com.webobjects.foundation.NSKeyValueCoding

takeValueForKeyPath

public void takeValueForKeyPath(Object value,
                                String keyPath)

Specified by:

takeValueForKeyPath in interface com.webobjects.foundation.NSKeyValueCodingAdditions

valueForKeyPath

public Object valueForKeyPath(String keyPath)

Specified by:

valueForKeyPath in interface com.webobjects.foundation.NSKeyValueCodingAdditions

valueForKeyPathWithDefault

public <V> V valueForKeyPathWithDefault(String keyPath,
                                        V defaultValue)

toString

public String toString()

Overrides:

toString in class Object