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.DataDirectDataStoreHelper
Please use the ConnectJDBCDataStoreHelper instead.
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, you should 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.auth.MapCredentialFailedException
com.ibm.websphere.security.auth.MapCredentialNotSupportedException
com.ibm.websphere.rsadapter.MSSQLDataStoreHelper
Please use the ConnectJDBCDataStoreHelper instead.
com.ibm.websphere.rsadapter.SequeLinkDataStoreHelper
Please use the Connect JDBC driver instead.
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.WebSphereBaseTrustAssociationInterceptor
As of 5.1.1, replaced by the new com.ibm.wsspi.security.tai.TrustAssociationInterceptor interface. Implementation using this class are supported by 5.1.1 both at compile time and runtime. Improvement has been made to com.ibm.wsspi.security.tai.TrustAssociationInterceptor and current implementations of this class should be migrated to use the new interface.






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.security.TrustAssociationInterceptor
As of 5.1.1, replaced by the new com.ibm.wsspi.security.tai.TrustAssociationInterceptor interface. Implementation using this interface are supported by 5.1.1 both at compile time and runtime. Improvement has been made to com.ibm.wsspi.security.tai.TrustAssociationInterceptor and current implementations of this interface should be migrated to use the new interface.
com.ibm.websphere.userprofile.UserProfile
Userprofile API is deprecated in current release




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.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.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.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.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.security.CustomRegistry.initialize(java.util.Properties)
As of WAS 5.0, replaced by UserRegistry initialize(java.util.Properties).
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.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.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).
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, you should use {@link #removeNotificationListenerExtended(ObjectName,NotificationListener)}
com.ibm.websphere.management.AdminService.removeNotificationListenerExtended(javax.management.NotificationListener)
as of 5.0.1, you should use {@link #removeNotificationListenerExtended(ObjectName,NotificationListener)}
com.ibm.websphere.appprofile.accessintent.ReadAheadHint.resetCursor()









Deprecated Constructors
com.ibm.ras.RASEvent.RASEvent(long,java.lang.String,java.lang.String[])
Use {@link #RASEvent(long, String, Object[]) RASEvent} instead.
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.
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.websphere.ras.Manager.Manager()
com.ibm.websphere.security.SSOAuthenticator.SSOAuthenticator()
As of WAS 4.0, replaced by JAAS programming model in WAS 5.0.


IBM WebSphere Application ServerTM
Release 5