ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzatz_5.4.0.1/51/migration/migdep.htm

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>