184 lines
7.1 KiB
HTML
184 lines
7.1 KiB
HTML
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
|
<LINK rel="stylesheet" type="text/css" href="../../../rzahg/ic.css">
|
||
|
|
|
||
|
|
<title>Deprecated Version 5.1 items</title>
|
||
|
|
</head>
|
||
|
|
|
||
|
|
<BODY>
|
||
|
|
<!-- Java sync-link -->
|
||
|
|
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
|
||
|
|
|
||
|
|
<h3><A NAME="migdep"></A>Deprecated Version 5.1 items</h3>
|
||
|
|
|
||
|
|
<p>This document summarizes deprecated features in Version 5.1. A deprecated class or interface is
|
||
|
|
supported for at least two full product releases, or three full years (whichever is longer) before it is
|
||
|
|
removed from the product.</p>
|
||
|
|
|
||
|
|
|
||
|
|
<p>Use the following information to calculate the earliest release when the item might be removed, according to the
|
||
|
|
deprecation policy.</p>
|
||
|
|
|
||
|
|
<p><strong>Installation and migration tools</strong></p>
|
||
|
|
<blockquote>
|
||
|
|
|
||
|
|
|
||
|
|
<p>The currently packaged version of JDOM in WebSphere Application Server will not be packaged in future releases of WebSphere Application Server. JDOM is a Java representation of an XML document that provides an API for efficient reading, manipulating and writing documentation.</p>
|
||
|
|
|
||
|
|
<p><strong>Recommended migration action:</strong> Go to <a href="http://www.jdom.org">JDOM</a> <img src="www.gif" width="18" height="15" align="absbottom" alt="Link outside Information Center" border="0">, obtain the latest copy of JDOM, and bundle it inside your application.</p>
|
||
|
|
<p><strong>Note:</strong> Customers running WSADIE V4.1 applications need to migrate them to WSADIE V5.0.</p>
|
||
|
|
</blockquote>
|
||
|
|
|
||
|
|
<p><strong>Servers and clustering features </strong></p>
|
||
|
|
<blockquote>
|
||
|
|
<p>No deprecated features.</p>
|
||
|
|
</blockquote>
|
||
|
|
|
||
|
|
<p><strong>Application programming model and container support features</strong></p>
|
||
|
|
<ul>
|
||
|
|
<li><p>Bean Scripting Framework (BSF), which is a JSP execution and debugging
|
||
|
|
function, is being deprecated in WebSphere Application Server Version 5.1.</p>
|
||
|
|
|
||
|
|
<p><strong>Recommended migration action:</strong> If you use the JavaScript,
|
||
|
|
Tcl, and Python languages, the functionality needs to be rearchitected.
|
||
|
|
If you use BSF scripting in your own custom applications, they are unaffected.
|
||
|
|
Custom scripts that are written for the WebSphere Application Server administrative console
|
||
|
|
are also unaffected.</p>
|
||
|
|
<p>BSF functionality continues to exist in WebSphere Application Server Version 5.1 but will be fully deprecated in a future version of the application server, according to the deprecation policy. If you debug JSPs, you might have to restart the application server during JavaScript debugging sessions.</p></li>
|
||
|
|
|
||
|
|
|
||
|
|
<li><p>Data access programming interfaces in com.ibm.websphere.rsadapter.</p>
|
||
|
|
<p>Relational resource adapter interface: com.ibm.websphere.rsadapter</p>
|
||
|
|
<p>Methods have been deprecated in these types:</p>
|
||
|
|
<pre>
|
||
|
|
com.ibm.websphere.rsadapter.OracleDataStoreHelper
|
||
|
|
public void doSpecialBLobWork(ResultSet rset, InputStream[] data,
|
||
|
|
String[] blobColumnNames)
|
||
|
|
public String assembleSqlString(String[] blobColumnNames,
|
||
|
|
StringBuffer whereClause, String[] varValues, String tableName)
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
<p><strong>Recommended migration action:</strong> These relational resource adapter deprecated methods do not impact
|
||
|
|
the application.</p>
|
||
|
|
<p><strong>Note: </strong>You do not need to implement these deprecated methods in their subclasses if you have the
|
||
|
|
subclass of OracleDataStoreHelper class. These deprecated methods are not called by the WebSphere Application
|
||
|
|
Server run-time environment.</p>
|
||
|
|
</li>
|
||
|
|
|
||
|
|
<li><p>Web container API modifications:</p>
|
||
|
|
<p><strong>Note: </strong>There are no declared deprecations. A Java API has changed between versions 1.3 and 1.4.</p>
|
||
|
|
<ul>
|
||
|
|
<li>Old method signature:
|
||
|
|
<pre>
|
||
|
|
public String getStackTrace();
|
||
|
|
// returns a String representation of the exception stack
|
||
|
|
</pre>
|
||
|
|
</li>
|
||
|
|
<li>New method signature (J2SE<sup>(TM)</sup> 1.4 in WebSphere Application Server Version 5.1):
|
||
|
|
<pre>
|
||
|
|
public StackTraceElement[] getStackTrace();
|
||
|
|
// returns an array of stack trace elements
|
||
|
|
</pre>
|
||
|
|
</li>
|
||
|
|
<li>WebSphere Application Server Version 5.1 replacement method (a replacement method that supports the old
|
||
|
|
functionality is provided):
|
||
|
|
<pre>
|
||
|
|
public String getStackTraceAsString();
|
||
|
|
// returns a String representation of the Exception Stack
|
||
|
|
</pre>
|
||
|
|
<p>See <a href="wappmig.htm">Migrate Web applications</a> for more information.</p>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>Web services gateway customization API
|
||
|
|
<p><strong>Recommended migration action:</strong> No action is required at this time. However, use of Java API for XML-based Remote Procedure Call (JAX-RPC) handlers is recommended over Web services gateway-specific interfaces, such as filters, where possible. The Web services gateway API will be replaced in a future release. </p>
|
||
|
|
</li>
|
||
|
|
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p><strong>Application services features</strong></p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><p>Data access binaries -- Common Connector Framework:</p>
|
||
|
|
<p>The following .jar files are deprecated in Version 5.1:</p>
|
||
|
|
<ul>
|
||
|
|
<li>ccf.jar</li>
|
||
|
|
<li>ccf2.jar</li>
|
||
|
|
<li>recjava.jar</li>
|
||
|
|
<li>eablib.jar</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p><strong>Recommended migration action:</strong> The J2EE Connector
|
||
|
|
Architecture solution should be used instead of the Common Connector Framework.</p>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p><strong>Security features </strong></p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><p>Security programming interfaces:
|
||
|
|
<ul>
|
||
|
|
<li>The API is being deprecated for the following interface:
|
||
|
|
<pre>
|
||
|
|
com.ibm.websphere.security.auth.WSPrincipal.getCredential()
|
||
|
|
</pre>
|
||
|
|
<p><strong>Recommended migration action:</strong> Obtain the Subject
|
||
|
|
that contains the WSCredential using one of the following methods:</p>
|
||
|
|
<ul>
|
||
|
|
<li>The RunAs Subject is the Subject used for outbound requests.</li>
|
||
|
|
<li>The Caller subject is the Subject that represents the authenticated caller
|
||
|
|
for the current request. </li>
|
||
|
|
<li>The methods to use to get the runAs and caller subjects are as follows:
|
||
|
|
<pre>com.ibm.websphere.security.auth.WSSubject.getRunAsSubject()</pre>
|
||
|
|
<pre>com.ibm.websphere.security.auth.WSSubject.getCallerSubject()</pre>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li> The following interface is being deprecated:
|
||
|
|
<pre>
|
||
|
|
com.ibm.websphere.security.auth.WSSecurityContext
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
<p><strong>Recommended migration action:</strong> Use JAAS for any authentication-related functionality.</p>
|
||
|
|
</li>
|
||
|
|
<li>The following exception is being deprecated:
|
||
|
|
<pre>
|
||
|
|
com.ibm.websphere.security.auth.WSSecurityContextException
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
<p><strong>Recommended migration action:</strong> Use JAAS for any authentication-related functionality.</p>
|
||
|
|
</li>
|
||
|
|
<li>The following class is being deprecated:
|
||
|
|
<pre>
|
||
|
|
com.ibm.websphere.security.auth.WSSecurityContextResult
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
<p><strong>Recommended migration action:</strong> Use JAAS for any authentication related functionality.</p>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p><strong>Environment features</strong></p>
|
||
|
|
<blockquote>
|
||
|
|
<p>No deprecated features.</p>
|
||
|
|
</blockquote>
|
||
|
|
<p><strong>System administration features </strong></p>
|
||
|
|
<blockquote>
|
||
|
|
<p>No deprecated features.</p>
|
||
|
|
</blockquote>
|
||
|
|
<p><strong>Performance features </strong></p>
|
||
|
|
<blockquote>
|
||
|
|
<p>No deprecated features.</p>
|
||
|
|
</blockquote>
|
||
|
|
<p><strong>Problem determination features</strong></p>
|
||
|
|
<blockquote>
|
||
|
|
<p>No deprecated features.</p>
|
||
|
|
</blockquote>
|
||
|
|
|
||
|
|
</body>
|
||
|
|
</html>
|
||
|
|
|