|
WebObjects 5.2 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.lang.Throwable | +--java.lang.Exception | +--java.lang.RuntimeException | +--com.webobjects.foundation.NSKeyValueCoding.UnknownKeyException
Instances of the NSKeyValueCoding.UnknownKeyException class are created and thrown when an unknown key is encountered during key-value coding.
For example, suppose an Employee object receives a valueForKey
message with "partNumber" as the key. The Employee class does not
declare a method or instance variable for "partNumber", so
valueForKey
throws an UnknownKeyException.
An NSKeyValueCoding.UnknownKeyException
has a user info dictionary containing entries for the object
for which key-value coding failed (TargetObjectUserInfoKey)
and the unknown key (UnknownUserInfoKey). For the Employee/partNumber
example, the TargetObjectUserInfoKey
entry would contain
the Employee object and the UnknownUserInfoKey
would contain the string "partNumber".
object()
,
key()
,
NSKeyValueCoding.valueForKey(java.lang.String)
,
NSKeyValueCoding
,
NSKeyValueCoding.ErrorHandling
, Serialized FormField Summary | |
static String |
TargetObjectUserInfoKey
Deprecated. this user info dictionary entry should be accessed using the object method. |
static String |
UnknownUserInfoKey
Deprecated. this user info dictionary entry should be accessed using the key method. |
Constructor Summary | |
NSKeyValueCoding.UnknownKeyException(String message,
NSDictionary userInfo)
Deprecated. Use NSKeyValueCoding.UnknownKeyException(java.lang.String, java.lang.Object, java.lang.String) instead. |
|
NSKeyValueCoding.UnknownKeyException(String message,
Object object,
String key)
Creates and returns a new UnknownKeyException with message
as the message and a user info dictionary specifying object
for the TargetObjectUserInfoKey and key for the
UnknownUserInfoKey. |
Method Summary | |
String |
key()
This method returns the key that NSKeyValueCoding operations were using at the time of the error, or null if it is unavailable. |
Object |
object()
This method returns the value that NSKeyValueCoding operations were using at the time of the error, or null if it is unavailable. |
NSDictionary |
userInfo()
Deprecated. The object and key methods should be used instead |
Methods inherited from class java.lang.Throwable |
fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace, toString |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
public static final String TargetObjectUserInfoKey
object()
public static final String UnknownUserInfoKey
key()
Constructor Detail |
public NSKeyValueCoding.UnknownKeyException(String message, Object object, String key)
UnknownKeyException
with message
as the message and a user info dictionary specifying object
for the TargetObjectUserInfoKey and key
for the
UnknownUserInfoKey.message
- the message created and returnobject
- object specified for the TargetObjectUserInfoKey. It may be null
key
- identifies the property of an object. It may be null
object()
,
key()
public NSKeyValueCoding.UnknownKeyException(String message, NSDictionary userInfo)
NSKeyValueCoding.UnknownKeyException(java.lang.String, java.lang.Object, java.lang.String)
instead.
message
- A message or summary associated with the new exceptionuserInfo
- the user info dictionary containing more information about the errorNSKeyValueCoding.UnknownKeyException(String, Object, String)
,
TargetObjectUserInfoKey
,
UnknownUserInfoKey
Method Detail |
public String key()
null
if it is unavailable.
This is equivalent to getting the UnknownUserInfoKey
entry from the userInfo dictionary.UnknownUserInfoKey
public Object object()
null
if it is unavailable.
This is equivalent to getting the TargetObjectUserInfoKey
entry from the userInfo dictionary.TargetObjectUserInfoKey
public NSDictionary userInfo()
object
and key
methods should be used instead
object()
,
key()
|
Last updated Fri Feb 21 13:15:00 PST 2003. | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |