IBM WebSphere Application ServerTM
Release 5

Deprecated API











Deprecated Classes
com.ibm.websphere.servlet.cache.ConfigElement
This Class represents a variable specified in the cachespec.xml document. If an application uses its own Id or MetaDataGenerator, this class can be used to read the cache policies defined in the Application Assembly Tool (WAS 4.x and higher), or in the cachespec.xml file (WAS 5.0 and higher). It stores all the data specified in the xml file for this variable. The variable may be: <ul> <li>a request parameter, (a String defined externally by a client), <li>a request attribute (java object, attached to a ServletRequest object previously in a servlet/JSP), <li>a session parameter (java object attached an HttpSession object) </ul> For example, a request parameter defined so in cachespec.xml<br><br> &lt;request&gt; <br> &lt;parameter id="cityname" data_id="city" required="true" /&gt;<br> &lt;/request&gt; <br><br> would generate a ConfigElement object where<ul> <li>id returns "cityname", <li> method returns null, <li>dataId returns "city", <li>invalidate returns null, <li>required returns TRUE, <li>and type returns ConfigElement.RequestParameter. </ul>
com.ibm.websphere.rsadapter.DB2390DataStoreHelper
-- Please use the DB2DataStoreHelper or DB2UniversalDataStoreHelper class instead of this class. <code>DB2390DataStoreHelper</code> is a <code>DataStoreHelper</code> implementation customized for the DB2 database running on z/OS. When mapping a <code>SQLException</code>, the <code>SQLException</code> mappings from the <code>DB2DataStoreHelper</code> are searched first, and subsequently, if no match is found, the <code>SQLException</code> mappings from the <code>GenericDataStoreHelper</code> are searched. If you have additional requirements for DB2 on z/OS, consider subclassing this implementation.
com.ibm.websphere.servlet.cache.DynamicCacheAccessor
Should use com.ibm.websphere.cache.DynamicCacheAccessor
com.ibm.websphere.management.exception.InvalidDocumentURIException
Should use com.ibm.websphere.management.exception.DocumentNotFoundException
com.ibm.websphere.security.SSOAuthenticator
As of WAS 4.0, replaced by FormBasedLogin. Custom Login implementation should be modified to use FormBasedLogin (in WAS 4.0), the Servlet filter (Servelt 2.3 Spec.in WAS 5.0), and JAAS Programming model (in WAS 5.0).
com.ibm.websphere.pmi.stat.StatsUtil
No replacement. This class is for WebSphere internal use only.
com.ibm.websphere.userprofile.UserProfileManager
Userprofile API is deprecated in current release
com.ibm.websphere.servlet.session.UserTransactionWrapper
Store UserTransaction object directly into httpsession
com.ibm.websphere.security.auth.WSSecurityContextException
This class is being deprecated in favor of using JAAS.
com.ibm.websphere.security.auth.WSSecurityContextResult
This class is being deprecated in favor of using JAAS.






Deprecated Interfaces
com.ibm.websphere.servlet.cache.CacheConfig
com.ibm.websphere.security.CustomRegistry
As of WAS 5.0, replaced by UserRegistry interface. Implementations using CustomRegistry interface are supported by WAS 5.0 both at compile time and at runtime. UserRegistry interface is both the plug-in point for custom developed user registry, it is also the runtime user registry interface. Moreover, improvements have been made to the UserRegistry interface and all CustomRegistry implementation should be migrated to use the UserRegistry interface.
com.ibm.websphere.userprofile.UserProfile
Userprofile API is deprecated in current release
com.ibm.websphere.security.auth.WSSecurityContext
This class is being deprecated in favor of using JAAS.




Deprecated Fields
com.ibm.websphere.naming.PROPS.INITIAL_CONTEXT_FACTORY_LEGACY
In WebSphere version 4.0, this factory was replaced by {@link #INITIAL_CONTEXT_FACTORY} and will be removed some time in the future.
com.ibm.websphere.management.NotificationConstants.TYPE_AGENT_DISCOVERED
Replaced by TYPE_DISCOVERY_AGENT_FOUND












































































Deprecated Methods
com.ibm.websphere.rsadapter.OracleDataStoreHelper.addNewMap(java.util.Map)
Use <code>setUserDefinedMap</code> instead.
com.ibm.websphere.rsadapter.OracleDataStoreHelper.assembleSqlString(java.lang.String[],java.lang.StringBuffer,java.lang.String[],java.lang.String)
com.ibm.websphere.rsadapter.WSCallHelper.createDataStoreHelper(java.lang.String)
- please use getDataStoreHelper instead of this method
com.ibm.websphere.rsadapter.OracleDataStoreHelper.doSpecialBLobWork(java.sql.ResultSet,java.io.InputStream[],java.lang.String[])
com.ibm.websphere.pmi.PmiJmxTest.findConfig(javax.management.ObjectName)
Use com.ibm.websphere.pmi.client.PmiClient.findConfig()
com.ibm.websphere.pmi.PmiJmxTest.findConfig(java.lang.String)
Use com.ibm.websphere.pmi.client.PmiClient.findConfig()
com.ibm.websphere.security.auth.WSSecurityContextResult.getCredential()
Use getSubject() instead, the WSCredential will be in the public credential list of the Subject.
com.ibm.websphere.management.application.client.AppDeploymentController.getDefaultTaskInfo(com.ibm.websphere.management.application.client.AppDeploymentInfo)
Returns the default task info objects that are used to create the default tasks during app preparation.
com.ibm.websphere.management.application.client.AppDeploymentController.getDefaultTaskInfo(com.ibm.websphere.management.application.client.AppDeploymentInfo,java.util.Hashtable)
Returns the default task info objects that are used to create the default tasks during app preparation.
com.ibm.websphere.security.SSOAuthenticator.getLTPACookieValue(org.omg.SecurityLevel2.Credentials)
Replaced by servlet filter.
com.ibm.websphere.security.auth.WSSecurityContextException.getMinorString()
Use getCause() to get the originating exception.
com.ibm.websphere.pmi.client.PmiClient.getNLSValue(java.lang.String)
Replaced by getNLSValue (key, moduleID)
com.ibm.websphere.management.application.client.AppDeploymentController.getTaskInfo()
Returns AppDeploymentTaskInfo instance for current task.
com.ibm.websphere.management.application.client.AppDeploymentController.getTaskInfo(java.lang.String)
Returns AppDeploymentTaskInfo instance for given task.
com.ibm.websphere.security.SSOAuthenticator.login(java.lang.String,java.lang.String,javax.servlet.http.HttpServletRequest,javax.servlet.http.HttpServletResponse)
Replaced by JAAS programming model LoginContext login.
com.ibm.websphere.security.SSOAuthenticator.login(java.lang.String,java.lang.String,javax.servlet.http.HttpServletRequest,javax.servlet.http.HttpServletResponse,boolean)
Replaced by JAAS programming model LoginContext login.
com.ibm.websphere.security.SSOAuthenticator.logout(javax.servlet.http.HttpServletRequest,javax.servlet.http.HttpServletResponse)
Replaced by JAAS programming model LoginContext logout.
com.ibm.websphere.rsadapter.GenericDataStoreHelper.mapException(com.ibm.ws.rsadapter.exceptions.DataStoreAdapterException)
com.ibm.websphere.pmi.stat.StatsUtil.pdTypeToString(int)
No replacement.
com.ibm.websphere.pmi.PmiDataInfo)">com.ibm.websphere.pmi.stat.StatsUtil.pmiDataInfoToTclAttrString(com.ibm.websphere.pmi.PmiDataInfo)
No replacement.
com.ibm.websphere.pmi.stat.StatsUtil.pmiDescriptorToTclAttrString(java.lang.String,com.ibm.ws.pmi.server.DataDescriptor,java.lang.String,java.lang.String)
No replacement.
com.ibm.websphere.pmi.stat.StatsUtil.pmiDescriptorToTclAttrString(com.ibm.ws.pmi.server.DataDescriptor,java.lang.String,java.lang.String)
No replacement.
com.ibm.websphere.security.auth.WSLoginFailedException.printStackTrace(java.io.PrintStream)
<p> Formats and prints all the exceptions added to the ArrayList using the addException API. The output will be printed to the PrintStream passed in. </p>
com.ibm.websphere.security.auth.WSLoginFailedException.printStackTrace(java.io.PrintWriter)
<p> Formats and prints all the exceptions added to the ArrayList using the addException API. The output will be printed to the PrintWriter passed in. </p>
com.ibm.websphere.security.WSSecurityException.printStackTrace(java.io.PrintStream)
<p> Formats and prints all the exceptions added to the ArrayList using the addException API. Te output will be printed to the PrintStream passed in. </p>
com.ibm.websphere.security.WSSecurityException.printStackTrace(java.io.PrintWriter)
<p> Formats and prints all the exceptions added to the ArrayList using the addException API. The output will be printed to the PrintWriter passed in. </p>
com.ibm.websphere.rsadapter.GenericDataStoreHelper.processSQL(java.lang.String,int)
: please don't implement this method.
com.ibm.websphere.rsadapter.GenericDataStoreHelper.processSQL(java.lang.String,int,boolean,boolean)
: please don't implement this method.
com.ibm.websphere.pmi.stat.StatsUtil.statisticToTclAttrString(com.ibm.websphere.pmi.stat.Statistic,long,java.lang.String,com.ibm.ws.pmi.server.DataDescriptor,java.lang.String,java.lang.String)
No replacement.
com.ibm.websphere.pmi.stat.StatsUtil.statisticToTclAttrString(com.ibm.websphere.pmi.stat.Statistic,long,com.ibm.ws.pmi.server.DataDescriptor,java.lang.String,java.lang.String)
No replacement.
com.ibm.websphere.pmi.stat.StatsUtil.statsToTclAttrString(com.ibm.websphere.pmi.stat.Stats,com.ibm.ws.pmi.server.DataDescriptor,java.lang.String,java.lang.String)
No replacement.
com.ibm.websphere.pmi.stat.StatsUtil.statsToTclAttrString(java.lang.String,com.ibm.websphere.pmi.stat.Stats,com.ibm.ws.pmi.server.DataDescriptor,java.lang.String,java.lang.String)
No replacement.
com.ibm.websphere.security.CustomRegistry.checkPassword(java.lang.String,java.lang.String)
As of WAS 5.0, replaced by UserRegistry checkPassword(String, String).
com.ibm.websphere.rsadapter.WSRdbRecord.getBigDecimal(int,int)
use getBigDecimal(int parameterIndex) or getBigDecimal(String parameterName)
com.ibm.websphere.security.auth.WSPrincipal.getCredential()
Use com.ibm.websphere.security.auth.WSSubject.getRunAsSubject() or com.ibm.websphere.security.auth.WSSubject.getCallerSubject() methods.
com.ibm.websphere.cache.Cache.getEntry(java.lang.String)
com.ibm.websphere.security.CustomRegistry.getGroupDisplayName(java.lang.String)
As of WAS 5.0, replaced by UserRegistry getGroupDisplayName(String).
com.ibm.websphere.security.CustomRegistry.getGroups()
As of WAS 5.0, replaced by UserRegistry getGroups(String, int).
com.ibm.websphere.security.CustomRegistry.getGroups(java.lang.String)
As of WAS 5.0, replaced by UserRegistry getGroups(String, int).
com.ibm.websphere.security.CustomRegistry.getGroupSecurityName(java.lang.String)
As of WAS 5.0, replaced by UserRegistry getGroupSecurityName(String).
com.ibm.websphere.security.CustomRegistry.getGroupsForUser(java.lang.String)
As of WAS 5.0, replaced by UserRegistry getGroupsForUser(String).
com.ibm.websphere.appprofile.accessintent.ReadAheadHint.getNextItem()
com.ibm.websphere.appprofile.accessintent.AccessIntent.getPessimisticUpdateHintExclusive()
com.ibm.websphere.appprofile.accessintent.AccessIntent.getPessimisticUpdateHintNoCollision()
com.ibm.websphere.appprofile.accessintent.AccessIntent.getPessimisticUpdateHintWeakestLockAtLoad()
com.ibm.websphere.security.CustomRegistry.getRealm()
As of WAS 5.0, replaced by UserRegistry getRealm().
com.ibm.websphere.servlet.cache.ServletCacheRequest)">com.ibm.websphere.servlet.cache.IdGenerator.getSharingPolicy(com.ibm.websphere.servlet.cache.ServletCacheRequest)
com.ibm.websphere.security.CustomRegistry.getUniqueGroupId(java.lang.String)
As of WAS 5.0, replaced by UserRegistry getUniqueGroupId(String).
com.ibm.websphere.security.CustomRegistry.getUniqueGroupIds(java.lang.String)
As of WAS 5.0, replaced by UserRegistry getUniqueGroupIds(String).
com.ibm.websphere.security.CustomRegistry.getUniqueUserId(java.lang.String)
As of WAS 5.0, replaced by UserRegistry getUniqueUserId(String).
com.ibm.websphere.security.CustomRegistry.getUniqueUserIds(java.lang.String)
As of WAS 5.0, UserRegistry has no corresponding function.
com.ibm.websphere.security.CustomRegistry.getUserDisplayName(java.lang.String)
As of WAS 5.0, replaced by UserRegistry getUserDisplayName(String).
com.ibm.websphere.security.CustomRegistry.getUsers()
As of WAS 5.0, replaced by UserRegistry getUsers(String, int).
com.ibm.websphere.security.CustomRegistry.getUsers(java.lang.String)
As of WAS 5.0, replaced by UserRegistry getUsers(String, int).
com.ibm.websphere.security.CustomRegistry.getUserSecurityName(java.lang.String)
As of WAS 5.0, replaced by UserRegistry getUserSecurityName(String).
com.ibm.websphere.security.CustomRegistry.getUsersForGroup(java.lang.String)
As of WAS 5.0, replaced by UserRegistry getUsersForGroup(String, int).
com.ibm.websphere.security.UserRegistry.getUsersForGroup(java.lang.String,int)
This method will be deprecated in future.
com.ibm.websphere.cache.Cache.getValue(java.lang.String,boolean)
com.ibm.websphere.cache.Cache.getValue(java.lang.Object,boolean)
com.ibm.websphere.servlet.cache.CacheConfig)">com.ibm.websphere.servlet.cache.IdGenerator.initialize(com.ibm.websphere.servlet.cache.CacheConfig)
This method is called once on servlet initialization, and should take configuration values from its CacheConfig argurment and store them locally. Additional config information from user applications or other sources may be read here as well.
com.ibm.websphere.security.CustomRegistry.initialize(java.util.Properties)
As of WAS 5.0, replaced by UserRegistry initialize(java.util.Properties).
com.ibm.websphere.servlet.cache.CacheConfig)">com.ibm.websphere.servlet.cache.MetaDataGenerator.initialize(com.ibm.websphere.servlet.cache.CacheConfig)
Initialize is called once on servlet initialization, and should take configuration values from its CacheConfig argurment and store them locally. Additional config information from user applications or other sources may be read here as well.
com.ibm.websphere.security.auth.WSSecurityContext.initSecContext(com.ibm.websphere.security.cred.WSCredential,java.lang.String,java.lang.String)
Use WSSecurityContext.initSecContext(Subject subject, String targetServerName, String realm);
com.ibm.websphere.management.application.AppManagement.installStandaloneRAR(java.lang.String,java.util.Hashtable,java.lang.String)
Use ConfigService instead. Installs a standalone RAR file. This method creates a J2CResourceAdapter in the resources.xml file in the scope specified by the properties. The user has to manually extract the RAR file at the destination location.
com.ibm.websphere.security.CustomRegistry.isValidGroup(java.lang.String)
As of WAS 5.0, replaced by UserRegistry isValidGroup(String).
com.ibm.websphere.security.CustomRegistry.isValidUser(java.lang.String)
As of WAS 5.0, replaced by UserRegistry isValidUser(String).
java.security.cert.X509Certificate)">com.ibm.websphere.security.CustomRegistry.mapCertificate(java.security.cert.X509Certificate)
As of WAS 5.0, replaced by UserRegistry mapCertificate(X509Certificate[]).
com.ibm.websphere.rsadapter.DataStoreHelper.mapException(com.ibm.ws.rsadapter.exceptions.DataStoreAdapterException)
com.ibm.websphere.management.application.AppManagement.moveModule(java.lang.String,java.util.Hashtable,java.lang.String,javax.management.ObjectName,java.lang.String)
Replaced by setModuleInfo Moves a module from server-server, server-cluster, cluster-server, cluster-cluster.
com.ibm.websphere.rsadapter.DataStoreHelper.processSQL(java.lang.String,int)
: please don't implement this method.
com.ibm.websphere.rsadapter.DataStoreHelper.processSQL(java.lang.String,int,boolean,boolean)
please don't implement this method.
com.ibm.websphere.management.AdminClient.removeNotificationListenerExtended(javax.management.NotificationListener)
as of 5.0.1, use {@link #removeNotificationListenerExtended(ObjectName,NotificationListener)}
com.ibm.websphere.management.AdminService.removeNotificationListenerExtended(javax.management.NotificationListener)
as of 5.0.1, use {@link #removeNotificationListenerExtended(ObjectName,NotificationListener)}
com.ibm.websphere.appprofile.accessintent.ReadAheadHint.resetCursor()









Deprecated Constructors
com.ibm.ras.RASTraceEvent.RASTraceEvent(long,java.lang.String,java.lang.String[])
Use {@link #RASTraceEvent(long, String, Object[]) RASTraceEvent} instead.
com.ibm.ras.RASTraceEvent.RASTraceEvent(long,java.lang.String,java.lang.String[],java.lang.String,java.lang.String,com.ibm.ras.RASITraceLogger,java.lang.String,java.lang.String,java.lang.Throwable)
Use {@link #RASTraceEvent(long, String, Object[], String, String, RASITraceLogger, String, String, Throwable) RASTraceEvent} instead.
com.ibm.ras.RASEvent.RASEvent(long,java.lang.String,java.lang.String[])
Use {@link #RASEvent(long, String, Object[]) RASEvent} instead.
com.ibm.websphere.security.SSOAuthenticator.SSOAuthenticator()
As of WAS 4.0, replaced by JAAS programming model in WAS 5.0.
com.ibm.websphere.ras.Manager.Manager()
com.ibm.ras.RASMessageEvent.RASMessageEvent(long,java.lang.String,java.lang.String[],java.lang.String)
Use {@link #RASMessageEvent(long, String, Object[], String) RASMessageEvent} instead.
com.ibm.ras.RASMessageEvent.RASMessageEvent(long,java.lang.String,java.lang.String[],java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.Throwable)
Use {@link #RASMessageEvent(long, String, Object[], String, String, String, String, String, String, String, String, Throwable) RASMessageEvent} instead.


IBM WebSphere Application ServerTM
Release 5

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.