Deprecated API

Deprecated Classes

com.webobjects.eoaccess.EOSQLQualifier
The class EOSQLQualifier is deprecated. Use EOAdaptorChannel.evaluateExpression() or EOFetchSpecification.setHints() instead.

com.webobjects.foundation.NSTimestamp.IntRef
in the Java Foundation framework. NSTimestamp.IntRef objects act as a containers to hold the values returned by NSTimestamp's gregorianUnitsSinceTimestamp method and consist solely of an instance variable, value.

com.webobjects.woextensions.WOAppleScript
The WOAppleScript component is deprecated.

com.webobjects.woextensions.WOTableString
WOTableString is no longer supported

Deprecated Fields

com.webobjects.foundation.NSValidation.ValidationException.AdditionalExceptionsKey
Use NSValidation.ValidationException.additionalExceptions()

com.webobjects.foundation.NSKeyValueCoding.UnknownKeyException.TargetObjectUserInfoKey
this user info dictionary entry should be accessed using the object method.

com.webobjects.foundation.NSKeyValueCoding.UnknownKeyException.UnknownUserInfoKey
this user info dictionary entry should be accessed using the key method.

com.webobjects.foundation.NSValidation.ValidationException.ValidatedKeyUserInfoKey
Use NSValidation.ValidationException.key()

com.webobjects.foundation.NSValidation.ValidationException.ValidatedObjectUserInfoKey
User NSValidation.ValidationException.object()

Deprecated Methods

com.webobjects.foundation.NSBundle.allBundles()
The only non-framework bundle that an application can access without using deprecated APIs is the main bundle. Use mainBundle instead.

com.webobjects.foundation.NSBundle.allFrameworks()
Use frameworkBundles instead

com.webobjects.eoapplication.EOUserInterfaceParameters.allowsIcons()
This method has no effect any more.

com.webobjects.foundation.NSProperties.arrayForKey(String)
Instead, find the system property using System.getProperty and convert the property to a string using NSPropertyListSerialization.arrayForString.

com.webobjects.eointerface.cocoa.EOCocoaTableViewPlugin.associationForColumnAtIndex(int)
in the Java EOInterface Cocoa Framework. Don't use this method.

com.webobjects.foundation.NSNumberFormatter.attributedStringForNil()
Use NSNumberFormatter.stringForNull().

com.webobjects.foundation.NSNumberFormatter.attributedStringForNotANumber()
Use NSNumberFormatter.stringForNotANumber().

com.webobjects.foundation.NSNumberFormatter.attributedStringForZero()
Use NSNumberFormatter.stringForZero().

com.webobjects.directtoweb.D2WMasterDetailPage.backAction()

com.webobjects.foundation.NSProperties.booleanForKey(String)
Instead, find the system property using System.getProperty and convert it to a boolean using NSPropertyListSerialization.booleanForString.

com.webobjects.foundation.NSBundle.bundlePath()
You should not need to know the file system path to the bundle directory.

com.webobjects.foundation.NSBundle.bundleWithPath(String)
To access a bundle that was loaded when the application started, use bundleForName or bundleForClass instead

com.webobjects.jdbcadaptor.JDBCPlugIn.canDescribeStoredProcedure(String)

com.webobjects.eoaccess.EOAdaptorContext.canNestTransactions()
Nested transactions are not supported.

com.webobjects.eoapplication.EOInterfaceController.collectChangesFromServer()
Use EOApplication.sharedApplication().collectChangesFromServer() instead. Updates the client application's enterprise objects to reflect the changes sent to the server from other client applications. Note that this affects all enterprise objects on the client side, not only the ones for the interface controller.

com.webobjects.appserver.WOHTTPConnection.connectTimeout()
There will be a connection only after a sendRequest has been executed. Thus, it would make more sense to control the send timeout using setSendTimeout.

com.webobjects.appserver.WOContext.contextWithRequest(WORequest)
use WOContext(WORequest aRequest) instead

com.webobjects.jdbcadaptor.JDBCPlugIn.createAttributeForRow(NSDictionary)

com.webobjects.foundation.NSTimestamp.currentTimeIntervalSinceReferenceDate()
Use (System.currentTimeMillis() / 1000) instead

com.webobjects.jdbcadaptor.JDBCPlugIn.databaseInformation()

com.webobjects.foundation.NSProperties.dataForKey(String)
Instead, find the system property using System.getProperty, convert the property to a property list using NSPropertyListSerialization.propertyListFromString, and convert the property list to an NSData object using NSPropertyListSerialization.dataFromPropertyList.

com.webobjects.foundation.NSPropertyListSerialization.dataFromPropertyList(Object)
Use dataFromPropertyList(Object object, String encoding) instead.

com.webobjects.foundation.NSData.dataWithContentsOfFile(File)

com.webobjects.foundation.NSData.dataWithContentsOfFile(String)

com.webobjects.foundation.NSData.dataWithContentsOfMappedFile(File)

com.webobjects.foundation.NSTimestamp.dayOfCommonEra()
Use GregorianCalendar instead.

com.webobjects.foundation.NSTimestamp.dayOfMonth()
Use GregorianCalendar instead.

com.webobjects.foundation.NSTimestamp.dayOfWeek()
Use GregorianCalendar instead.

com.webobjects.foundation.NSTimestamp.dayOfYear()
Use GregorianCalendar instead.

com.webobjects.appserver.WODirectAction.debugString(String)
use NSLog instead.

com.webobjects.appserver.WOComponent.debugString(String)
debugString is no longer supported

com.webobjects.appserver.WOApplication.debugString(String)
use NSLog instead.

com.webobjects.appserver.WOSession.debugString(String)
use com.webobjects.foundation.NSLog instead

com.webobjects.foundation.NSTimeZone.defaultTimeZone()
Use getDefault instead.

com.webobjects.eointerface.EODisplayGroup.delete()
Deprecated. Use deleteSelection instead.

com.webobjects.foundation.NSProperties.dictionaryForKey(String)
Instead, find the system property using System.getProperty and convert the property to an NSDictionary using NSPropertyListSerialization.dictionaryForString

com.webobjects.appserver.WODisplayGroup.Delegate.displayGroupShouldRedisplayForChangesInEditingContext(WODisplayGroup, NSNotification)
No longer important for WebObjects applications. No user code should implement or depend upon this, and any implementations or references to this method may be eliminated freely.

com.webobjects.foundation.NSTimestamp.distantFuture()
Use NSTimestamp.DistantFuture instead

com.webobjects.foundation.NSTimestamp.distantPast()
Use NSTimestamp.DistantPast

com.webobjects.appserver.WOAdaptor.doesBusyRunOnce()
This method will never be called and should not be used or overridden.

com.webobjects.foundation.NSProperties.doubleForKey(String)
Instead, find the system property using System.getProperty and convert the property to a double.

com.webobjects.foundation.NSTimestamp.earlierTimestamp(NSTimestamp)
Use before instead

com.webobjects.appserver.WODisplayGroup.editingContextPresentErrorMessage(EOEditingContext, String)
Use NSLog instead. No user code should implement or depend upon this.

com.webobjects.appserver.WODisplayGroup.endEditing()
No longer important for WebObjects applications. No user code should depend upon this, and any references to this method may be eliminated freely.

com.webobjects.foundation.NSValidation.ValidationException.exceptionAddingEntriesToUserInfo(Object, String)
Use NSValidation.ValidationException.exceptionWithObjectAndKey(java.lang.Object, java.lang.String)

com.webobjects.appserver.WOHTTPConnection.expectContentLengthHeader(boolean, int)
If you are using HTTP/1.1, there is no need to tell the receiver whether to expect content length since it follows RFC 2616 (HTTP/1.1).

com.webobjects.appserver.WOSession.expirationDateForIDCookies()
this method is deprecated should not be used

com.webobjects.foundation.NSPathUtilities.fileExistsAtPath(String)
Use (new File(aString)).exists()

com.webobjects.foundation.NSProperties.floatForKey(String)
Instead, find the system property using System.getProperty and and convert the property to a float.

com.webobjects.foundation.NSNumberFormatter.format()
Use NSNumberFormatter.pattern().

com.webobjects.foundation.NSArray.getObjects(Object[])
use public Object[] objects() instead

com.webobjects.foundation.NSArray.getObjects(Object[], NSRange)
use public Object[] objects() in NSRange instead

com.webobjects.foundation.NSTimestamp.gregorianUnitsSinceTimestamp(NSTimestamp.IntRef, NSTimestamp.IntRef, NSTimestamp.IntRef, NSTimestamp.IntRef, NSTimestamp.IntRef, NSTimestamp.IntRef, NSTimestamp)

com.webobjects.foundation.NSTimestamp.hourOfDay()
Use GregorianCalendar instead.

com.webobjects.foundation.NSBundle.infoDictionary()
Do not use this method.

com.webobjects.appserver.WODisplayGroup.inQueryMode()
No longer important for WebObjects applications. No user code should implement or depend upon this, and any implementations or references to this method may be eliminated freely.

com.webobjects.foundation.NSProperties.integerForKey(String)
Instead, find the system property using System.getProperty and convert it to an integer using NSPropertyListSerialization.intForString.

com.webobjects.appserver.WOHTTPConnection.isConnected()
This is meaningless since there will not be a connection before sendRequest is executed.

com.webobjects.foundation.NSTimeZone.isEqualToTimeZone(NSTimeZone)
Use equals.

com.webobjects.appserver.WORequest.isFromClientComponent()
isFromClientComponent() is deprecated as the Client Side Components Feature are not supported anymore

com.webobjects.directtoweb.D2WComponent.isLiveAssistantEnabled()

com.webobjects.directtoweb.D2W.isLiveAssistantEnabled()

com.webobjects.foundation.NSTimestamp.laterTimestamp(NSTimestamp)
Use after instead

com.webobjects.foundation.NSBundle.load()
Don't use this method. Dynamic loading is no longer supported.

com.webobjects.eoapplication.EOArchive.loadArchiveNamed(String, Object, String)
Use loadArchiveNamed(String, Object, String, NSDisposableRegistry) instead. Attempts to load an archive and returns whether the archive was loaded successfully.

com.webobjects.directtoweb.D2WComponent.localContext()

com.webobjects.directtoweb.D2WStatelessComponent.localContext()

com.webobjects.foundation.NSNumberFormatter.localizesFormat()
Use NSNumberFormatter.localizesPattern().

com.webobjects.foundation.NSRange.locationInRange(int)
Use NSRange.containsLocation(int)

com.webobjects.appserver.WOApplication.lock()
synchronized(WOApplication.application()) should be used instead.

com.webobjects.foundation.NSLock.lockBeforeDate(NSTimestamp)

com.webobjects.foundation.NSRecursiveLock.lockBeforeDate(NSTimestamp)
Use NSRecursiveLock.tryLock(NSTimestamp)

com.webobjects.appserver.WOStatisticsStore.logFileRotationFrequencyInDays()
Use logFileRotationFrequency() instead.

com.webobjects.appserver.WOComponent.logString(String)
logString is no longer supported.

com.webobjects.appserver.WOApplication.logString(String)
Use NSLog instead

com.webobjects.appserver.WOSession.logString(String)
use com.webobjects.foundation.NSLog instead

com.webobjects.foundation.NSProperties.longForKey(String)
Instead, find the system property using System.getProperty and and convert the property to a long.

com.webobjects.foundation.NSTimestamp.microsecondOfSecond()
Do not use this method. Java typically uses milliseconds, not microseconds.

com.webobjects.foundation.NSTimestamp.millisecondsToTimeInterval(long)
Use (milliseconds / 1000) instead

com.webobjects.foundation.NSTimestamp.minuteOfHour()
Use GregorianCalendar instead.

com.webobjects.appserver.WOApplication.monitorHost()
monitorHost no longer supported

com.webobjects.foundation.NSTimestamp.monthOfYear()
Use GregorianCalendar instead.

com.webobjects.foundation.NSTimeZone.name()
Use getID.

com.webobjects.foundation.NSNumberFormatter.negativeFormat()
Use NSNumberFormatter.negativePattern().

com.webobjects.eoaccess.EOAttribute.newValueForBytesString(byte[], int)

com.webobjects.foundation.NSBundle.pathForResource(String, String)
Use resourcePathForLocalizedResourceNamed instead.

com.webobjects.foundation.NSBundle.pathForResource(String, String, String)
Don't use this method. Use resourcePathForLocalizedResourceNamed instead.

com.webobjects.foundation.NSPathUtilities.pathIsAbsolute(String)
Use (new File(aString)).isAbsolute().

com.webobjects.foundation.NSPathUtilities.pathIsEqualToString(String, String)
This method should not be used.

com.webobjects.foundation.NSBundle.pathsForResources(String, String)
Don't use this method. Use resourcePathsForResources instead.

com.webobjects.foundation.NSSocketUtilities.pollingInterval()
This method always returns 0.

com.webobjects.foundation.NSNumberFormatter.positiveFormat()
Use NSNumberFormatter.positivePattern().

com.webobjects.eoaccess.EOAdaptorChannel.primaryKeyForNewRowWithEntity(EOEntity)
Use the plural version, primaryKeysForNewRowsWithEntity instead.

com.webobjects.appserver.WOApplication.printsHTMLParserDiagnostics()
See com.webobjects.foundation.NSLog

com.webobjects.foundation.NSPropertyListSerialization.propertyListFromData(NSData)
Use propertyListFromData(NSData data, String encoding)

com.webobjects.appserver.WODisplayGroup.redisplay()
Invoke willChange directly.

com.webobjects.foundation.NSMutableArray.replaceObjectAtIndex(int, Object)
This method was provided for backward compatibility only.

com.webobjects.foundation.NSBundle.resourcePath()
Don't use this method. Resources are now accessed using the bytesForResourcePath and inputStreamForResourcePath methods.

com.webobjects.appserver.WOAdaptor.runOnce()
This method will never be called and should not be used or overridden.

com.webobjects.eocontrol.EOEditingContext.saveChanges(Object)
Use EOEditingContext.saveChanges() instead.

com.webobjects.foundation.NSTimestamp.secondOfMinute()
Use GregorianCalendar instead.

com.webobjects.eoapplication.EOUserInterfaceParameters.setAllowsIcons(boolean)
This method has no effect any more.

com.webobjects.foundation.NSNumberFormatter.setAttributedStringForNil(String)
Use NSNumberFormatter.setStringForNull(java.lang.String).

com.webobjects.foundation.NSNumberFormatter.setAttributedStringForNotANumber(String)
Use NSNumberFormatter.setStringForNotANumber(java.lang.String).

com.webobjects.foundation.NSNumberFormatter.setAttributedStringForZero(String)
Use NSNumberFormatter.setStringForZero(java.lang.String).

com.webobjects.appserver.WOHTTPConnection.setConnectTimeout(int)
There will be a connection only after a sendRequest has been executed. Thus, it would make more sense to control the send timeout using setSendTimeout.

com.webobjects.foundation.NSTimestamp.setDate(int)
NSTimestamp objects are immutable.

com.webobjects.foundation.NSTimeZone.setDefaultTimeZone(NSTimeZone)
Use setDefault instead.

com.webobjects.foundation.NSNumberFormatter.setFormat(String)
Use NSNumberFormatter.setPattern(java.lang.String).

com.webobjects.foundation.NSTimestamp.setHours(int)
NSTimestamp objects are immutable.

com.webobjects.appserver.WODisplayGroup.setInQueryMode(boolean)
No longer important for WebObjects applications. No user code should implement or depend upon this, and any implementations or references to this method may be eliminated freely.

com.webobjects.directtoweb.D2W.setLiveAssistantEnabled(boolean)

com.webobjects.foundation.NSNumberFormatter.setLocalizesFormat(boolean)
Use NSNumberFormatter.setLocalizesPattern(boolean).

com.webobjects.appserver.WOStatisticsStore.setLogFile(String, double)
Use setLogFile(String path, long milliseconds) instead

com.webobjects.foundation.NSTimestamp.setMinutes(int)
NSTimestamp objects are immutable.

com.webobjects.appserver.WOApplication.setMonitorHost(String)
monitorHost no longer supported

com.webobjects.foundation.NSTimestamp.setMonth(int)
NSTimestamp objects are immutable.

com.webobjects.foundation.NSTimestamp.setNanos(int)
NSTimestamp objects are immutable.

com.webobjects.foundation.NSNumberFormatter.setNegativeFormat(String)
Use NSNumberFormatter.setNegativePattern(java.lang.String)

com.webobjects.foundation.NSSocketUtilities.setPollingInterval(int)
This method no longer does anything, and should not be used.

com.webobjects.foundation.NSNumberFormatter.setPositiveFormat(String)
Use NSNumberFormatter.setPositivePattern(java.lang.String).

com.webobjects.appserver.WOApplication.setPrintsHTMLParserDiagnostics(boolean)
See com.webobjects.foundation.NSLog

com.webobjects.foundation.NSTimestamp.setSeconds(int)
NSTimestamp objects are immutable.

com.webobjects.appserver.WOApplication.setSocketCacheSize(Number)
setSocketCacheSize no longer supported

com.webobjects.appserver.WOApplication.setSocketMonitorSleepTime(Number)
setSocketMonitorSleepTime no longer supported

com.webobjects.foundation.NSTimestamp.setTime(long)
NSTimestamp objects are immutable.

com.webobjects.appserver.WORedirect.setURL(String)
: setURL is a deprecated method use instead setUrl.

com.webobjects.eoaccess.EOSQLExpression.setUseQuotedExternalNames(boolean)
This static method is inappropriate in Java. Subclasses should implement their own policy on quoting identifiers.

com.webobjects.eoaccess.EOAttribute.setValueClassName(String)

com.webobjects.appserver.WOApplication.setWorkerThreadCount(Number)
setWorkerThreadCount no longer supported

com.webobjects.foundation.NSTimestamp.setYear(int)
NSTimestamp objects are immutable.

com.webobjects.appserver.WOApplication.sharedEditingContext()
EOSharedEditingContext.defaultSharedEditingContext() should be directly used instead.

com.webobjects.appserver.WOApplication.socketCacheSize()
socketCacheSize no longer supported

com.webobjects.appserver.WOApplication.socketMonitorSleepTime()
socketMonitorSleepTime no longer supported

com.webobjects.foundation.NSArray.sortedArrayUsingSelector(NSSelector)
use sortedArrayUsingComparator instead

com.webobjects.jdbcadaptor.JDBCPlugIn.sqlStatementForGettingProcedureNames()

com.webobjects.jdbcadaptor.JDBCPlugIn.sqlStatementForGettingTableNames()

com.webobjects.jdbcadaptor.JDBCPlugIn.sqlStatementForTableNamed(String)

com.webobjects.jdbcadaptor.JDBCPlugIn.storedProcedureNamed(String, JDBCChannel, NSDictionary)

com.webobjects.foundation.NSPathUtilities.stringByStandardizingPath(String)
This method should not be used.

com.webobjects.foundation.NSProperties.stringForKey(String)
Use System.getProperty(java.lang.String).

com.webobjects.foundation.NSTimestamp.timeIntervalSinceNow()
Use getTime and calculate the delta from System.currentTimeMillis instead

com.webobjects.foundation.NSTimestamp.timeIntervalSinceReferenceDate()
Use (getTime() / 1000) instead.

com.webobjects.foundation.NSTimestamp.timeIntervalSinceTimestamp(NSTimestamp)
Use getTime and calculate the delta instead

com.webobjects.foundation.NSTimestamp.timeIntervalToMilliseconds(long)
Use (timeInterval * 1000) instead

com.webobjects.appserver.WOSession.timeOutForIDCookies()
this method is deprecated should not be used

com.webobjects.foundation.NSTimestamp.timestampByAddingTimeInterval(long)
Use (new NSTimestamp((interval * 1000) + oldTs.getTime(), oldTs.getNanos())) instead.

com.webobjects.foundation.NSTimestamp.timeZone()
Deprecated in the Java Foundation framework. Do not use this method. All NSTimestamps are in UTC.

com.webobjects.directtoweb.D2W.traceRuleFiringEnabled()

com.webobjects.directtoweb.D2W.traceRuleModificationsEnabled()

com.webobjects.eoaccess.EOAdaptorContext.transactionNestingLevel()
Use hasOpenTransaction instead.

com.webobjects.eocontrol.EOEditingContext.tryToSaveChanges()
Use EOEditingContext.saveChanges() instead.

com.webobjects.appserver.WOApplication.unlock()
synchronized(WOApplication.application()) should be used instead.

com.webobjects.foundation.NSPathUtilities.URLWithPath(String)
Use new URL("file://" + aString).

com.webobjects.eoaccess.EOSQLExpression.useQuotedExternalNames()
This static method is inappropriate in Java. Subclasses should implement their own policy on quoting identifiers.

com.webobjects.foundation.NSValidation.ValidationException.userInfo()
Access the individual entries using the NSValidation.ValidationException.key() and NSValidation.ValidationException.object() methods.

com.webobjects.foundation.NSKeyValueCoding.UnknownKeyException.userInfo()
The object and key methods should be used instead

com.webobjects.directtoweb.Assignment.value(D2WContext)

com.webobjects.eoaccess.EOAttribute.valueClassName()

com.webobjects.directtoweb.D2W.visibleEntityNames()

com.webobjects.appserver.WOApplication.workerThreadCount()
workerThreadCount no longer supported

com.webobjects.foundation.NSData.writeToFile(String)

com.webobjects.foundation.NSData.writeToURL(URL, boolean)

com.webobjects.foundation.NSTimestamp.yearOfCommonEra()
Use GregorianCalendar instead.

Deprecated Constructors

com.webobjects.eocontrol.EOCustomObject(EOEditingContext, EOClassDescription, EOGlobalID)
the default or 0 argument constructor should be used instead

com.webobjects.eocontrol.EOGenericRecord(EOEditingContext, EOClassDescription, EOGlobalID)
the default or 0 argument constructor should be used instead

com.webobjects.foundation.NSData(File)

com.webobjects.foundation.NSData(String)

com.webobjects.foundation.NSData(URL)

com.webobjects.foundation.NSKeyValueCoding.UnknownKeyException(String, NSDictionary)
Use NSKeyValueCoding.UnknownKeyException.NSKeyValueCoding.UnknownKeyException(java.lang.String, java.lang.Object, java.lang.String) instead.

com.webobjects.foundation.NSMutableData(File)

com.webobjects.foundation.NSMutableData(String)

com.webobjects.foundation.NSMutableData(URL)

com.webobjects.foundation.NSValidation.ValidationException(String, NSDictionary)
Use NSValidation.ValidationException.NSValidation.ValidationException(String, Object, String)

com.webobjects.appserver.WOComponent()
use WOComponent(WOContext aContext) instead. Using this constructor will slow down your application considerably.

com.webobjects.appserver.WOHTTPConnection(String, int, int)
Use setReceiveTimeout, setSendTimeout to control the timeout after creating an instance.