Package com.webobjects.foundation

Provides a set of robust and mature core classes, including utility, collection, key-value coding, time and date, notification, and debug logging classes.

See:
Description

Interface Summary

NSArray.Operator	Objects implementing NSArray.Operator are used to perform operations on an array's elements.
NSCoding	The NSCoding interface declares the methods that a class must implement so that instances of that class can be encoded and decoded.
NSDisposable	The NSDisposable interface declares one method, dispose, in which an object prepares for destruction.
NSKeyValueCoding	The NSKeyValueCoding interface defines a data transport mechanism in which the properties of an object are accessed indirectly by name (or key), rather than directly through invocation of an accessor method or as instance variables.
NSKeyValueCoding.ErrorHandling	The NSKeyValueCoding.ErrorHandling interface declares an API for handling errors that occur during key-value coding.
NSKeyValueCodingAdditions	The NSKeyValueCodingAdditions interface defines an extension to the basic NSKeyValueCoding interface.
NSLocking	The NSLocking interface declares the elementary methods adopted by classes that define lock objects.
NSValidation	The NSValidation interface defines a validation mechanism in which the properties of an object are validated indirectly by name (or key), rather than directly through invocation of an specific validation method.

Class Summary

NSArray	NSArray and its subclass NSMutableArray manage ordered collections of objects.
NSBundle	An NSBundle represents a location in the file system that groups code and resources that can be used in a program.
NSCoder	NSCoder is an abstract class that declares the API used by concrete subclasses to transfer objects and other data items between memory and some other format.
NSCoding.Support	NSCoding.Support is an abstract class that defines a mechanism for one class to provide NSCoding behavior on behalf of another class.
NSComparator	NSComparator is an abstract class that defines an API for comparing two objects for the purpose of sorting them.
NSData	NSData and its subclass NSMutableData provide data objects, object-oriented wrappers for byte buffers.
NSDelayedCallbackCenter	An NSDelayedCallbackCenter object (also called a delayed callback center) provides a way to guarantee that particular methods are invoked after an event has ended.
NSDictionary	The NSDictionary class declares an API for objects that manage immutable associations of keys and values.
NSDisposableRegistry	A NSDisposableRegistry object is a registry of NSDisposable objects that should be disposed when the registry is disposed.
NSKeyValueCoding.DefaultImplementation	The NSKeyValueCoding.DefaultImplementation class provides the WebObjects default implementations of the NSKeyValueCoding and NSKeyValueCoding.ErrorHandling interfaces.
NSKeyValueCoding.Null	NSKeyValueCoding.Null is a final class that defines a unique object used to represent null values in collection objects, such as NSArrays, which do not allow null values.
NSKeyValueCoding.Utility	The NSKeyValueCoding.Utility class is a convenience that allows you to access the properties of NSKeyValueCoding objects and non-NSKeyValueCoding objects using the same code.
NSKeyValueCoding.ValueAccessor	NSKeyValueCoding.ValueAccessor is an abstract class that establishes a mechanism by which NSKeyValueCoding can operate on object's package access instance variables.
NSKeyValueCodingAdditions.DefaultImplementation	The NSKeyValueCodingAdditions.DefaultImplementation class provides default implementations of the NSKeyValueCodingAdditions interface.
NSKeyValueCodingAdditions.Utility	The NSKeyValueCodingAdditions.Utility class is a convenience that allows one to access the properties of NSKeyValueCodingAdditions objects and non-NSKeyValueCodingAdditions objects using the same code.
NSLock	An NSLock object is used to coordinate the operation of multiple threads of execution within the same application.
NSLog	NSLog is a static class that is used to access the WebObjects Foundation logging system.
NSLog.Log4JLogger	NSLog.Log4JLogger is a concrete subclass of NSLog.Logger.
NSLog.Logger	NSLog.Logger is an abstract class that specifies the core functionality for NSLog.
NSLog.PrintStreamLogger	NSLog.PrintStreamLogger is a concrete subclass of NSLog.Logger.
NSMultiReaderLock	The NSMultiReaderLock class provides reader and writer locks.
NSMutableArray	The NSMutableArray class provides facilities for managing a mutable collection of objects.
NSMutableData	The NSMutableData class declares the programmatic interface to an object that contains modifiable data in the form of bytes.
NSMutableDictionary	The NSMutableDictionary class adds methods to insert, modify, and remove elements to the API of its parent class NSDictionary.
NSMutableRange	An NSMutableRange is an object representing a range that can be changed.
NSMutableSet	NSMutableSet provides support for the mathematical concept of a set which, unlike its parent NSSet, may have members added or removed after its creation.
NSNotification	NSNotification objects encapsulate information so that it can be broadcast to other objects by an NSNotificationCenter object.
NSNotificationCenter	An NSNotificationCenter object (or simply, notification center) is essentially a notification dispatch table.
NSNumberFormatter	NSNumberFormatter converts between java.lang.Number and textual representations of numeric values.
NSPathUtilities	This class provides static methods that are useful when working with paths.
NSProperties	This class extends Java's properties mechanism to merge application properties with the standard system properties available using the java.lang.System.getProperties method.
NSPropertyListSerialization	This class provides static methods that convert between property lists and their string representations, which can be either strings or NSData objects.
NSRange	An NSRange represents a range, a measurement of a segment of something linear, such as a byte stream.
NSRecursiveLock	NSRecursiveLock defines a lock that may be acquired multiple times by the same thread without causing a deadlock (a situation where a thread is permanently blocked waiting for itself to relinquish a lock).
NSSelector	An NSSelector object specifies a method signature (a method's name and parameter list).
NSSet	NSSet declares an API for an object that manages a collection of objects similar to a mathematical set.
NSSocketUtilities	This class provides an easy way to get a TCP socket (java.net.Socket) with a connection timeout.
NSTimestamp	NSTimestamp objects represent a particular instant in time.
NSTimestamp.IntRef	Deprecated. in the Java Foundation framework.
NSTimestampFormatter	Instances of NSTimestampFormatter format NSTimestamps into their textual representations and convert textual representations of dates and times into NSTimestamps.
NSTimeZone	NSTimeZone defines the behavior of time zones for different geopolitical regions.
NSUndoManager	NSUndoManager is a general-purpose recorder of operations for undo and redo.
NSValidation.DefaultImplementation	The methods in the NSValidation.DefaultImplementation class are just like the methods defined by the NSValidation interface, except they are static methods and they take an additional argument, which is the object on which the default implementation should operate.
NSValidation.Utility	This class is a convenience that allows you to access the properties of NSValidation objects and non-NSValidation objects using the same code.

Exception Summary

NSComparator.ComparisonException	Instances of the NSComparator.ComparisonException class are created and thrown when an error condition is encountered during the comparison of two objects.
NSForwardException	NSForwardException objects (or forwarded exceptions) are wrappers for Throwable objects which are not RuntimeExceptions.
NSKeyValueCoding.UnknownKeyException	Instances of the NSKeyValueCoding.UnknownKeyException class are created and thrown when an unknown key is encountered during key-value coding.
NSValidation.ValidationException	Instances of the NSValidation.ValidationException class are created and thrown when an error condition is encountered during the validation of an object that implements NSValidation.

Package com.webobjects.foundation Description

Provides a set of robust and mature core classes, including utility, collection, key-value coding, time and date, notification, and debug logging classes.

Introduction

The Foundation framework defines a base layer of classes written in Java. In addition to providing a set of useful primitive object classes, it introduces several paradigms that define functionality not covered by the Java language. The Foundation framework is designed with these goals in mind:

• Provide a small set of basic utility classes
• Simplifies software development by introducing consistent conventions for things such as notifications, object persistence, key-value coding, and validation.

Foundation Framework Classes

The Foundation framework consists of several related groups of classes as well as a few individual classes:

• Data storage. NSData provides object-oriented storage for arrays of bytes. NSArray, NSDictionary, and NSSet provide storage for objects of any class.
• Dates and times. The NSTimestamp and NSTimeZone classes store times and dates. They offer methods for calculating date and time differences, for displaying dates and times in many formats, and for adjusting times and dates based on location in the world. The NSTimestampFormatter class converts dates to user-presentable strings and back.
• Application coordination and timing. NSNotification and NSNotificationCenter provide systems that an object can use to notify all interested observers of changes that occur. NSDelayedCallbackCenter coordinates events.
• Object distribution and persistence. The data that an object contains can be represented in an architecture-independent way using NSCoder and its subclasses, which also stores class information along with the data. The resulting representations are used for archiving and object distribution.
• Object disposal. The NSDisposable interface together with the NSDisposableRegistry ensure that unused objects are collected by Java's garbage collector.
• Key-value coding. The NSKeyValueCoding and NSKeyValueCodingAdditions interfaces along with their support classes provide a consistent way for objects to receive and return values for keys.
• Validation. The NSValidation interface and support classes define and implement a consistent validation mechanism.
• Locking of objects. The NSLock, NSRecursiveLock, and NSMultiReaderLock classes together with the NSLocking interface coordinate the locking of objects or graphs of objects.
• Operating system services. Several classes are designed to insulate you from the idiosyncracies of various operating systems. NSPathUtilities provides a consistent interface for working with file system paths. NSBundle accesses the application's resources.
• Other utility classes. NSRange specifies a range of values. NSComparator defines inequality relationships between objects for sorting. NSUndoManager manages an application's undo function. NSForwardException wraps exceptions into a subclass of Java's RuntimeException. NSPropertyListSerialization converts between property lists and byte arrays.