com.novell.nds.dirxml.driver
Interface DNConverter

public interface DNConverter

Interface for converting eDirectory object DNs from one format to another. This is designed to be used only in stylesheet rules, which are passed a stylesheet parameter that is an implementation by the DirXML engine of this interface.

The reason for restricting the use of this interface to stylesheets is because certain types of DN conversions (from unqualified names to qualified names) require getting the qualification information from eDirectory. Drivers running under the Remote Loader do not have access to this information and so could not use this class.

Method Summary

String

convert(String srcDN, String fromFormat, String toFormat) Convert the Distinguished Name (DN) of an eDirectory object from one format to another.

Method Detail

convert

public String convert(String srcDN,
                      String fromFormat,
                      String toFormat)

Convert the Distinguished Name (DN) of an eDirectory object from one format to another.

Valid values for parameters fromFormat and toFormat are:

• "slash"
• "dot"
• "ldap"
• "qualified-slash"
• "qualified-dot"

If an invalid format parameter value is passed to this method the input DN is returned unchanged. If name qualification information is needed and cannot be obtained then the input DN is returned unchanged.

Parameters:

srcDN - The DN to convert

fromFormat - The format of the DN argument

toFormat - The output format from the method.