1.8 JNDI Object Naming

This section covers the following topics:

The naming convention for object names followed by Novell’s JNDI service providers is not the same as that of traditional NetWare names. For example, to specify the complete name and path of a file on a NetWare server you would use the following form:

   MY_SERVER/SYS:PUBLIC\MYFILE

With Novell’s JNDI service providers, assuming the initial context is the NetWareInitialContext, the same file's path would be

   Servers/MY_SERVER/FileSystem/SYS/PUBLIC/MYFILE

Names used in JNDI naming conventions include Trees, Servers, Bindery, FileSystem, and NCPExtensions. These names are keywords that must be used in name strings at their appropriate location. Novell’s JNDI service providers use these keywords to resolve names to the proper objects.

The naming convention that you use depends on your initial context factory (see Initial Context), which determines what namespace you are using. See the following table to find a list of object names for a given namespace.

Namespace

Initial context factory

Supported naming conventions

See section

File system

FS_INITIAL_CONTEXT_FACTORY

My_Server/...

File System Namespace

NDS

NDS_INITIAL_CONTEXT_FACTORY

My_Tree/...

NDS Namespace

NetWare

NW_INITIAL_CONTEXT_FACTORY

Servers/..., Trees/...

NetWare Namespace

Server

SERVER_INITIAL_CONTEXT_FACTORY

My_Server/...

Server Namespace

1.8.1 NetWare Namespace

Use NetWare object names relative to the NetWare initial context (NW_INITIAL_CONTEXT_FACTORY), which could be thought of as the root of Novell’s NetWare naming systems.

  • Server Objects

    Servers/My_Server - A server

  • Bindery Objects

    Servers/My_Server/Bindery - The bindery root

    Servers/My_Server/Bindery/A-SERVER+4 - A bindery object (server)

  • File System Objects

    Servers/My_Server/FileSystem - The file system root

    Servers/My_Server/FileSystem/My_Volume - A file system volume

    Servers/My_Server/FileSystem/My_Volume/My_Dir/my_file.txt - A file

  • NCPExtensions Objects

    Servers/My_Server/NCPExtensions - The NCPExtensions root

    Servers/My_Server/NCPExtensions/SNMP - An NCPExtensions object

  • NDS Objects

    Trees/My_Tree - The root of the tree

    Trees/My_Tree/My_Org - An organization in the tree

    Trees/My_Tree/O=My_Org - An organization in the tree

    Trees/My_Tree/My_Org_Unit.My_Org - An organizational unit within the organization

    Trees/My_Tree/OU=My_Org_Unit.O=My_Org - An organizational unit within the organization

    Trees/My_Tree/My_User.My_Org_Unit.My_Org - A user in the organizational unit

    Trees/My_Tree/CN=My_User.OU=My_Org_Unit.O=My_Org - A user in the organizational unit

    NDS names have the following properties:

    • The names are in partial dot form (separated by dots instead of slashes).
    • The names can be typed or untyped.
    • The specification of the object name after the tree name is with the leaf object on the left.

      For example:

         My_User.My_Org_Unit.My_Org

      not

         My_Org.My_Org_Unit.My_User

1.8.2 NDS Namespace

Use NDS object names relative to the NDS initial context (NDS_INITIAL_CONTEXT_FACTORY), which could be thought of as the root of Novell’s NDS naming systems.

  • Server Objects

    My_Tree/CN=My_Server.O=My_Org - A server

  • Bindery Objects

    My_Tree/CN=My_Server.O=My_Org/Bindery - The bindery root

    My_Tree/CN=My_Server.O=My_Org/Bindery/A-SERVER+4 - A bindery object

  • File System Objects

    My_Tree/CN=My_Server.O=My_Org/FileSystem - A file sytem root

    My_Tree/CN=My_Server.O=My_Org/FileSystem/My_Volume - A file system volume

    My_Tree/CN=My_Server.O=My_Org/FileSystem/My_Volume/My_Dir/my_file.txt - A file system file

  • NCPExtensions Objects

    My_Tree/CN=My_Server.O=My_Org/NCPExtensions - The NCPExtensions root

    My_Tree/CN=My_Server.O=My_Org/NCPExtensions/SNMP - An NCPExtensions object

  • NDS Objects

    My_Tree - The root of the tree

    My_Tree/My_Org - An organization in the tree

    My_Tree/O=My_Org - An organization in the tree

    My_Tree/My_Org_Unit.My_Org - An organizational unit within the organization

    My_Tree/OU=My_Org_Unit.O=My_Org - An organizational unit within the organization

    My_Tree/My_User.My_Org_Unit.My_Org - A user in the organizational unit

    My_Tree/CN=My_User.OU=My_Org_Unit.O=My_Org- A user in the organizational unit

    NDS object names have the following properties:

    • The names are in partial dot form (separated by dots instead of slashes).
    • The names can be typed or untyped.
    • The specification of the object name after the tree name is from left to right with the leaf object on the left.

      For example:

         My_User.My_Org_Unit.My_Org

      not

         My_Org.My_Org_Unit.My_User

1.8.3 Server Namespace

Use Server object names relative to the ServerDirContext (SERVER_INITIAL_CONTEXT_FACTORY), which could be thought of as the root of Novell’s Server naming system.

  • Server Objects

    My_Server - A server object.

  • Bindery Objects

    My_Server/Bindery - The bindery root

    My_Server/Bindery/A-SERVER+4 - A bindery object (server)

  • File System Objects

    My_Server/FileSystem - The file system root

    My_Server/FileSystem/My_Volume - A file system volume

    My_Server/FileSystem/My_Volume/My_Dir/my_file.txt - A file

  • NCPExtensions Objects

    My_Server/NCPExtensions - The NCPExtensions root

    My_Server/NCPExtensions/SNMP - An NCPExtensions object

  • NDS Objects

    You can get NDS objects directly from NDSInitialContext (See NDS Namespace for how this is done).

    To get NDS objects in indirectly you must first federate into the bindery, then use the extended tree name obtained by calling list() to federate into the NDS namespace. An example of this is as follows:

       My_Server/Bindery/<tree name>+<extension>+278>/

1.8.4 File System Namespace

Use File System object names relative to the FileSystem initial context (FS_INITIAL_CONTEXT_FACTORY), which could be thought of as the root of Novell’s File System naming system.

  • File System Objects

    My_Server - The file system root

    My_Server/My_Volume - A file system volume

    My_Server/My_Volume/My_Dir/my_file.txt - A file