Examples of javax.naming.directory.DirContext

javax.naming.directory.DirContext
This is the main interface to a directory service.
A DirContext is the interface through which a client interacts with a particular concrete directory service provider. The API provides methods for searching, reading and writing attributes of directory entries.

The name of a directory entry is taken as relative to the context receiving the method invocation. Names cannot be null and the empty name has a special meaning of the context itself.

In this interface there are duplicated methods that take either a String or Name parameter. This is simply a convenience and the behavior of each method is identical.

The semantics of a name in a DirContext is exactly equivalent to that of a name in a regular naming Context.
Attribute storage models
JNDI supports two logical models of attribute storage:
- Type A : where an attribute operation on a named object is equivalent to a lookup in the DirContext on the given name followed by application of the operation to the resulting empty DirContext. Think of this as attributes being stored on the object itself.
- Type B : where an attribute operation on a named object is equivalent to a lookup on that name in the parent DirContext followed by application of the operation on the parent DirContext providing the name as an argument. Think of this as the attributes being stored in the parent context.
  In this model objects that are not DirContext can have attributes, provided their parents are DirContext.
The directory service provider can implement either of these logical models, and the client is expeced to know which model it is dealing with.
Attribute Name aliasing
Directory service providers are free to implement attribute name alising. If the service employs alising then the list of attribute names that are returned as a result of API calls to get a named attribute, or search for a set of attributes may include attributes whose name was not in the search list. Implmentations should not rely on the preservation of attribute names.
Searching and operational attributes
Some directory service providers support "operational attributes" on objects. These are attributes that are computed by the provider, or have other special semantics to the directory service. The directory service defines which attributes are operational.

The API calls for searching for attributes, and those for getting named attributes using a list of names are defined to interpret the null argument to match all non-operational attributes.

It is therefore possible to get a specific named attribute that is not returned in a global retrieval of all object attributes.
Conditions
Some APIs require that the name resolves to another DirContext and not an object. In such cases, if this postcondition is not met then the method should throw a NotContextException. Other methods can resolve to be either objects or DirContext.

Service providers must not modify collection parameters such as Attribute, SearchControl or arrays. Similarly, clients are expected not to modify the collections while the service provider iterates over such collections -- the service provider should be given exclusive control of the collection until the method returns.

APIs that return collections are safe -- that is, the service provider will not modify collections that are returned to clients.
Exceptions
Any method may throw a NamingException (or subclass) as defined by the exception descriptions.

    {
        Vector permissions = new Vector();


        try
        {
            DirContext ctx = LDAPUserManager.bindAsAdmin();


            String baseSearch = LDAPSecurityConstants.getBaseSearch();
            String filter = "(objectClass=turbinePermission)";


            /*
             * Create the default search controls.
             */
            SearchControls ctls = new SearchControls();


            NamingEnumeration answer = ctx.search(baseSearch, filter, ctls);


            while (answer.hasMore())
            {
                SearchResult sr = (SearchResult) answer.next();
                Attributes attribs = sr.getAttributes();

View Full Code Here

    {
        Hashtable permissions = new Hashtable();


        try
        {
            DirContext ctx = LDAPUserManager.bindAsAdmin();


            String baseSearch = LDAPSecurityConstants.getBaseSearch();
            String filter = "(& ";


            filter += "(objectClass=turbineRole)";
            filter += "(turbineRoleName=" + role.getName() + ")";
            filter += ")";


            /*
             * Create the default search controls.
             */
            SearchControls ctls = new SearchControls();


            NamingEnumeration answer = ctx.search(baseSearch, filter, ctls);


            while (answer.hasMore())
            {
                SearchResult sr = (SearchResult) answer.next();
                Attributes attribs = sr.getAttributes();

View Full Code Here


            attrs.put(new BasicAttribute("objectClass", "turbineGroup"));
            attrs.put(new BasicAttribute("turbineGroupName", groupName));


            // Connect to LDAP.
            DirContext ctx = LDAPUserManager.bindAsAdmin();


            // Add the group in LDAP.
            ctx.bind(dn, null, attrs);


            // Add the group to system-wide cache.
            getAllGroups().add(group);


            return group;

View Full Code Here


            attrs.put(new BasicAttribute("objectClass", "turbineRole"));
            attrs.put(new BasicAttribute("turbineRoleName", roleName));


            // Connect to LDAP.
            DirContext ctx = LDAPUserManager.bindAsAdmin();


            // Add the role in LDAP.
            ctx.bind(dn, null, attrs);


            // Add the role to system-wide cache.
            getAllRoles().add(role);


            return role;

View Full Code Here

            Attributes attrs = new BasicAttributes();


            attrs.put(new BasicAttribute("objectClass", "turbinePermission"));
            attrs.put(new BasicAttribute("turbinePermissionName", permName));


            DirContext ctx = LDAPUserManager.bindAsAdmin();


            // Add the permission in LDAP.
            ctx.bind(dn, null, attrs);


            // add the permission to system-wide cache
            getAllPermissions().add(permission);


            return permission;

View Full Code Here


            // Make the distinguished name.
            String dn = "turbineGroupName=" + groupName + ","
                    + LDAPSecurityConstants.getBaseSearch();


            DirContext ctx = LDAPUserManager.bindAsAdmin();


            // Remove the group from LDAP.
            ctx.unbind(dn);


            // Remove the group from system-wide cache.
            getAllGroups().remove(group);
        }
        catch (NamingException ex)

View Full Code Here


            // Make the distinguished name.
            String dn = "turbineRoleName=" + roleName + ","
                    + LDAPSecurityConstants.getBaseSearch();


            DirContext ctx = LDAPUserManager.bindAsAdmin();


            // Remove the role from LDAP.
            ctx.unbind(dn);


            // Remove the role from system-wide cache.
            getAllRoles().remove(role);
        }
        catch (NamingException ex)

View Full Code Here


            // Make the distinguished name.
            String dn = "turbinePermissionName=" + permName + ","
                    + LDAPSecurityConstants.getBaseSearch();


            DirContext ctx = LDAPUserManager.bindAsAdmin();


            // Remove the permission in LDAP.
            ctx.unbind(dn);


            // Remove the permission from system-wide cache.
            getAllPermissions().remove(permission);
        }
        catch (NamingException ex)

View Full Code Here

    public User retrieve(String username)
            throws UnknownEntityException, DataBackendException
    {
        try
        {
            DirContext ctx = bindAsAdmin();


            /*
             * Define the search.
             */
            String userBaseSearch = LDAPSecurityConstants.getBaseSearch();
            String filter = LDAPSecurityConstants.getNameAttribute();


            filter = "(" + filter + "=" + username + ")";


            /*
             * Create the default search controls.
             */
            SearchControls ctls = new SearchControls();


            NamingEnumeration answer =
                    ctx.search(userBaseSearch, filter, ctls);


            if (answer.hasMore())
            {
                SearchResult sr = (SearchResult) answer.next();
                Attributes attribs = sr.getAttributes();

View Full Code Here

    public User retrieveById(Object key)
            throws UnknownEntityException, DataBackendException
    {
        try
        {
            DirContext ctx = bindAsAdmin();


            /*
             * Define the search.
             */
            StringBuffer userBaseSearch = new StringBuffer();
            userBaseSearch.append(LDAPSecurityConstants.getUserIdAttribute());
            userBaseSearch.append("=");
            userBaseSearch.append(String.valueOf(key));
            userBaseSearch.append(",");
            userBaseSearch.append(LDAPSecurityConstants.getBaseSearch());


            /*
             * Create the default search controls.
             */
            NamingEnumeration answer =
                    ctx.search(userBaseSearch.toString(), (Attributes)null);


            if (answer.hasMore())
            {
                SearchResult sr = (SearchResult) answer.next();
                Attributes attribs = sr.getAttributes();

View Full Code Here

0 1 2 3 4 5 6 7 8 9

TOP

Related Classes of javax.naming.directory.DirContext

com.cloud.configuration.ConfigurationManagerImpl

com.springsource.insight.plugin.ldap.DirContextSearchCollectionAspectTest

com.stimulus.archiva.security.realm.ADAction

com.sun.enterprise.security.auth.realm.ldap.LDAPRealm

com.sun.messaging.jmq.jmsserver.auth.ldap.LdapUserRepository

de.sub.goobi.helper.ldap.Ldap

fr.norsys.mapper.console.service.LdapTreeBuilderImpl

fr.norsys.mapper.console.service.LDAPViewerImpl

fr.norsys.mapper.console.service.LDAPViewerTest

fr.norsys.mapper.console.service.ValidationHelperImpl

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.