| <!-- |
| ! Licensed to the Apache Software Foundation (ASF) under one |
| ! or more contributor license agreements. See the NOTICE file |
| ! distributed with this work for additional information |
| ! regarding copyright ownership. The ASF licenses this file |
| ! to you under the Apache License, Version 2.0 (the |
| ! "License"); you may not use this file except in compliance |
| ! with the License. You may obtain a copy of the License at |
| ! |
| ! http://www.apache.org/licenses/LICENSE-2.0 |
| ! |
| ! Unless required by applicable law or agreed to in writing, software |
| ! distributed under the License is distributed on an "AS IS" BASIS, |
| ! WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| ! See the License for the specific language governing permissions and |
| ! limitations under the License. |
| !--> |
| <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN"> |
| |
| <html> |
| <head> |
| <title>Release Notes for the net.jini.entry package |
| </title> |
| </head> |
| |
| <body text="black" bgcolor="white" link="#9b37cc" vlink="#cc1877" alink="white"> |
| <center> |
| <h1><code>net.jini.entry</code> package<br> |
| Apache River v3.0.0 Release Notes</h1> |
| </center> |
| <hr> |
| <ul> |
| <H3>Description</H3> |
| |
| The <a |
| href="../api/net/jini/entry/package-summary.html"><code>net.jini.entry</code> |
| package</a> provides classes that are useful when handling or implementing |
| entries. |
| |
| <p> |
| <H3>Changes since the v2.2.0 release</H3> |
| |
| <dl> |
| |
| <dt><b>None</b></dt> |
| |
| </dl> |
| <H3>Changes since the v2.1.1 release</H3> |
| |
| <dl> |
| |
| <dt><b>None</b> |
| |
| </dl> |
| |
| <H3>Changes since the v2.0.1 release</H3> |
| |
| <dl> |
| |
| <dt><b>The API Documentation is Now the Formal Specification</b> |
| <dd> |
| |
| Previously, the formal specification for the <code>net.jini.entry</code> |
| package was a separate document. With this release, the formal specification |
| is the revised API Documentation. As part of this change the specification |
| language was generally cleaned up and made tighter.<p> |
| |
| <dt><b>Behavior of Various <code>AbstractEntry</code> Methods Clarified</b> |
| <dd> |
| |
| The previous versions of the specification for <code><a |
| href="../api/net/jini/entry/AbstractEntry.html">net.jini.entry.AbstractEntry</a></code> |
| did not specify how the static <code>equals</code>, <code>hashCode</code>, |
| and <code>toString</code> methods behaved if passed <code>null</code> |
| values. This version of the specification specifies that : |
| |
| <ul> |
| <li> <code>equals</code> should return <code>true</code> if both |
| arguments are <code>null</code>, and <code>false</code> if |
| only one argument is <code>null</code>. |
| <li> <code>hashCode</code> should return <code>0</code> if passed |
| <code>null</code>. |
| <li> <code>toString</code> should return <code>"null"</code> if |
| passed <code>null</code>. |
| </ul> |
| <p> |
| Note: Previously our implementation of <code>AbstractEntry</code> would |
| throw a <code>NullPointerException</code> if any of these methods were |
| passed a <code>null</code> value. |
| <p> |
| |
| Also, the specification of the static <code>toString</code> method was |
| changed to require that the returned string include the name of the |
| argument's class. |
| |
| <dt><b> <code>UnusableEntriesException</code> Added</b> |
| <dd> |
| |
| The <code><a |
| href="../api/net/jini/entry/UnusableEntriesException.html">net.jini.entry.UnusableEntriesException</a></code> |
| class was added. <code>UnusableEntriesException</code> can be used by |
| methods that normally return a collection of entries when one or more of |
| the entries can't be unmarshalled. |
| |
| </dl> |
| |
| <p> |
| |
| <hr> |
| Licensed to the Apache Software Foundation (ASF) under one |
| or more contributor license agreements. See the NOTICE file |
| distributed with this work for additional information |
| regarding copyright ownership. The ASF licenses this file |
| to you under the Apache License, Version 2.0 (the |
| "License"); you may not use this file except in compliance |
| with the License. You may obtain a copy of the License at |
| <ul> |
| <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a> |
| </ul> |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| |
| </body> |
| </html> |