diff --git a/mozilla/directory/java-sdk/relnotes.htm b/mozilla/directory/java-sdk/relnotes.htm new file mode 100644 index 00000000000..2ad0d6bb85b --- /dev/null +++ b/mozilla/directory/java-sdk/relnotes.htm @@ -0,0 +1,506 @@ + + + + + + Java 4.0 BETA Release Notes + + + +
+

+BETA
+Netscape Directory SDK 4.0 for Java 
+Release Notes

+ +
Last Updated: July 27 +
For the latest version of the release notes, click +here.
+ +

These release notes apply +to the Netscape Directory SDK 4.0 for Java. Please read these notes before +using the product. +

+ +
Here +is a summary of new features: +

+Changes to  Java LDAP +API

+ + +New asynchronous Java LDAP +API +

This new API works at a +low level, close to the LDAP protocol, providing a means for mutiplexing +LDAP operations from the same thread. See  the +Internet +Draft on the LDAP API Asynchronous Extension. +

+ +


The JNDI service provider +is implemented more efficiently on top of the asynchronous JAVA LDAP API.  +For more information on JNDI, see the +java.sun +website.   Removed asynch +I-D doc link from here. Here should come a reference to the JNDI SP relese +notes file. +

Simple Authentication +and Security Layer (SASL) API changes +

     +The new SASL API is rewritten including  new  SASL interface +classes.  For more information, see the  Simple +Authentication and Security Layer (SASL). +

+


INSTALLING +THE NETSCAPE DIRECTORY SDK FOR JAVA +
Which +packages should we mention? +

Follow these instructions +to install the Netscape Directory SDK: +

+ +
UPDATING +JAVA CLASSES IN NETSCAPE COMMUNICATOR +

Netscape Communicator 4.5 +and earlier contain older versions of the Netscape LDAP Java classes. You +can obtain the latest classes +WHERE? +
Replace +the old file  (Example:  <JDK_root>/Program +Files/Netscape/Communicator/Program/Java/classes/ldap10.jar) with +the new JAR file. +
+


+
BUGS +FIXED SINCE 3.10 +
355365  LDAPSearchResults.getCount() +returns 0 for synchronous search +
342196    +SmartUpdate for java LDAP SDK doesn't work for Comm 4.5 +
346367    +-1 incorrectly encoded in BERIntegral +
357382    +Can't compile JNDI SP with JDK 1.2 +
357361    +Filter code doesn't work with JDK 1.2 +
351004    +Applet in Communicator can't fetch error string +
313834    +"rejects" file on import (e.g. LDAPModify) contains binary +
339833    +RFE: smarter failover +
325394   getCount() +after sorting throws exception +
330523   DN.equals() +does not normalize +
354615   DN.contains() +implemented and documented incorrectly +
339633    +The SDK should catch Exception, +not Throwable +
352056   LDAPModify +should support LDIF version 1 +
351022   LDAPCompareAttrNames +should +allow specifying a locale +
350624    +LDAPSearch aborts on size +limit exception +
350998    +Search timeout not handled correctly +
350997   LDAPSchemaElement +needs +modify() method +
350996   LDAPBasePropertySupport +should enable referrals +
350995   LDAPBasePropertySupport +should +enable referrals +
347586    +Schema interpretations are specific to Netscape +
357772   LDAPFilter +gets array bounds exception +
357526    +Syntactically incorrect filter is causing disconnect +
355904    +Cannot set cache after LDAPConnection +is connected +
355942   LDAPCache +changes contents of attributes to return +
354503    +The SDK calls Thread.stop()/suspend()/resume() +
355215    +VLV controls don't support optional context field +
354347    +SDK doesn't support all schema options of RFC 2252 +
353306    +LDAP Beans don't handle referrals +
353305    +LDAPIsMember doesn't handle dynamic groups +
353187    +Ensure that SDK works with Java 2 +
351926    +Must call System.exit() to shutdown SDK +
351719    +LDAPModificationSet has no toString method +
339632    +The SDK should not use Thread.stop() +
329534   getCount +doesnt work in asynchronous search +
330261   StringIndexOutOfBoundsException +if searched for backslash "\ +
116611    +SASLMechanismFactory is missing getMechanisms method +
353307   LDAPGetEntries +should allow choice of attributes to return +
353308   LDAPModificationSet +is +missing a toString method +
358370    +Incorrect tag written for UTCTime BER +
358371    +Missing and incorrect javadocs for BER +
356470    +Should support latest LDIF specification +
324606    +RFE: get attribute values as vector +
354682    +Should treat null +for filter as meaning objectclass=* +
354997    +Unneeded public add +methods in LDAPSchema +
339831    +RFE: connection pool support
+ +
GETTING +STARTED +

The Netscape Directory SDK +for Java includes the classes for the Lightweight Directory Access Protocol +(LDAP) Application Programming Interface (API). You can use these classes +to write your own application to connect to, search, and update LDAP servers +on the Internet. +

After installing the SDK, +read the documentation in the doc +directory and look at the samples in the examples +directory. +

Reading the Online Documentation +
The Netscape Directory +SDK for Java includes documentation in HTML format. To read this documentation: +

    +
  1. +Start Netscape Navigator or +Communicator.
  2. + +
  3. +Open the file named index.htm +in the doc +directory.
  4. +
+Compiling the Examples +
The Netscape Directory +SDK for Java also includes sample applications that you can modify, compile, +and run. The samples are in the examples +directory. +

Each application is an example +that shows how you can use the classes to search or update an LDAP server. +

For more information on +these sample clients, see the README +file in the examples +directory. +

Exploring +the SDK +

The Netscape Directory SDK +for Java contains the following directories: +

+ +
REPORTING +PROBLEMS +

Please submit your problem +via the DevEdge Bug Report +Form +

+


ACCESSING +THE DIRECTORY DEVELOPERS NEWSGROUP +

If you have additional questions +or need more information about the LDAP Java SDK, see the Directory +Developers newsgroup. +

+


+
Contains OROMatcher(TM) regular expression software from ORO Java Software.
+(C) Copyright 1997 by ORO Java Software.
+Redistribution separate from Netscape JAVA LDAP SDK or direct use
+of OROMatcher interfaces requires a license from ORO Java Software.
+OROMatcher(TM) is a trademark of Original Reusable Objects, Inc.
+ +
For more Internet development +resources, try Netscape +TechSearch
+ +
+
+ + + + + + + + + + + +
DevEdge +Online FAQ +
Developer +Response Center +
Join +DevEdge Program
Copyright +© 1999 Netscape +Communications Corporation. +
This site powered by: Netscape +Enterprise Server and Netscape +Compass Server.
+ + +